Converted adoc to md

content/documentation/Accessories/Cases/Model_A_Acrylic_Open_Enclosure.adoc → content/documentation/Accessories/Cases/Model_A_Acrylic_Open_Enclosure.md

@@ -9,25 +9,24 @@ menu:
     weight: 
 ---
 
-The *"Model A" Acrylic Open Enclosure* is a case for "Model A" sized single-board computers (Pine A64, ROCKPro64, Quartz64 Model A) sold by PINE64, available from https://pine64.com/product/pine-a64-rockpro64-acrylic-open-enclosure/[the official store].
+The **"Model A" Acrylic Open Enclosure** is a case for "Model A" sized single-board computers (Pine A64, ROCKPro64, Quartz64 Model A) sold by PINE64, available from [the official store](https://pine64.com/product/pine-a64-rockpro64-acrylic-open-enclosure/).
 
 {{< figure src="/documentation/images/Model_a_acrylic_case_with_pine_a64.jpg" title="A Pine A64 mounted in the &quot;Model A&quot; Acrylic Open Enclosure. The text on the top is &quot;PINE64&quot; nowadays." >}}
 
-== Installation
+## Installation
 
-Please refer to https://files.pine64.org/doc/guide/PINE64_Acrylic_Open_Enclosure_Installation_Guide.pdf[the official instructions] for assembling the case.
+Please refer to [the official instructions](https://files.pine64.org/doc/guide/PINE64_Acrylic_Open_Enclosure_Installation_Guide.pdf) for assembling the case.
 
 For the Quartz64 Model A, you may need to file down the inner corner of one of the mounting posts for the little mic connector on the bottom of the board to clear it.
 
-== Mods
+## Mods
 
-=== 3D-Printable Top With Fan and PCIe Cutout
+### 3D-Printable Top With Fan and PCIe Cutout
 
-{{< figure src="/documentation/images/Model_a_top_render.png" title="Non-artist's impression of the replacement top plate" >}}
+{{< figure src="/documentation/images/Model_a_top_render.png" title="Non-artist’s impression of the replacement top plate" >}}
 
-User:CounterPillow has created an alternate 3D-printable top plate which allows for the mounting of a 40mmx40mmx10mm fan, as well as allowing for PCIe cards to be mounted while the case is assembled. The STL and STEP files are available under https://wiki.pine64.org/wiki/File:Model_A_acrylic_case_top_plate_with_fan_cutout.zip[] free of charge, licensed as CC-BY 4.0.
+User:CounterPillow has created an alternate 3D-printable top plate which allows for the mounting of a 40mmx40mmx10mm fan, as well as allowing for PCIe cards to be mounted while the case is assembled. The STL and STEP files are available under [https://wiki.pine64.org/wiki/File:Model_A_acrylic_case_top_plate_with_fan_cutout.zip](https://wiki.pine64.org/wiki/File:Model_A_acrylic_case_top_plate_with_fan_cutout.zip) free of charge, licensed as CC-BY 4.0.
 
-A fan is mounted to it using self-tapping fan screws usually shipped with computer fans; put the fan on the underside of the plate, and screw in the self-tapping screws from the top side. You can either have the fan exhaust air through the top, or blow it onto the SoC's heatsink. The latter configuration appears to work better, but precise measurements haven't been made yet.
-
-Recommended printing material is PETG for its structural rigidity. However, PLA will likely work fine as well, and is easier to print. A 0.6mm nozzle was used for test prints, but any nozzle should work. Depending on the layer height you choose, your print may come out slightly thicker or thinner; this is no problem though. It's recommended to enable the advanced "Detect Thin Walls" option in slic3r to get a cleaner g-code result around the fan holes.
+A fan is mounted to it using self-tapping fan screws usually shipped with computer fans; put the fan on the underside of the plate, and screw in the self-tapping screws from the top side. You can either have the fan exhaust air through the top, or blow it onto the SoC’s heatsink. The latter configuration appears to work better, but precise measurements haven’t been made yet.
 
+Recommended printing material is PETG for its structural rigidity. However, PLA will likely work fine as well, and is easier to print. A 0.6mm nozzle was used for test prints, but any nozzle should work. Depending on the layer height you choose, your print may come out slightly thicker or thinner; this is no problem though. It’s recommended to enable the advanced "Detect Thin Walls" option in slic3r to get a cleaner g-code result around the fan holes.

content/documentation/Accessories/Wifi_remote_i2c.adoc → content/documentation/Accessories/Wifi_remote_i2c.md

@@ -11,53 +11,52 @@ menu:
 
 {{< figure src="/documentation/images/PMWF01A_Description.jpg" title="PMWF01A: Wifi Remote I2c Module" >}}
 
-== Quick Start Guide
+## Quick Start Guide
 
-=== Hardware Setup
+### Hardware Setup
 {{< figure src="/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-1.jpg" title="Hardware Setup" >}}
 
 * Make sure that the driver for USB/UART Programming/Console Adapter (PMPROG01) is properly install and the PC is detected it as Comm Port.
-* The USB/UART Bridge is base on http://www.silabs.com/products/interface/usb-bridges/classic-usb-bridges/Pages/usb-to-uart-bridge.aspx[Silicon Lab CP2012 chipset].
-* USB/UART Programming/Console Adapter (PMPROG01) driver can be https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx[Download here]
+* The USB/UART Bridge is base on [Silicon Lab CP2012 chipset](http://www.silabs.com/products/interface/usb-bridges/classic-usb-bridges/Pages/usb-to-uart-bridge.aspx).
+* USB/UART Programming/Console Adapter (PMPROG01) driver can be [Download here](https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx)
 * Connect the USB/UART Programming/Console Adapter (PMPROG01) to the Wifi Remote I2c Device.
 * You can power-up the WiFI Remote I2c module through the USB Bus for configuration and programming.
 
 {{< figure src="/documentation/images/Wr_USB_Adpt_5v.jpg" width="100" >}}
 
 Place the jumper J2 on USB/UART Programming/Console Adapter (PMPROG01) to 5V output selection.
 
-=== Setting Configuration
+### Setting Configuration
 
 {{< figure src="/documentation/images/Wr_Termite2.JPG" title="Termite Setup Screen" >}}
 {{< figure src="/documentation/images/Wr_cfghelp_scr.JPG" title="Help Command" >}}
 
 * For windows system, you can use terminal emulator program Termite to configure the device.
-* Termite can be downloaded at http://www.compuphase.com/software_termite.htm[CompuPhase Website ]
+* Termite can be downloaded at [CompuPhase Website ](http://www.compuphase.com/software_termite.htm)
 * Make sure the 'Port' setting is refer to the USB/UART Programming/Console Adapter (PMPROG01)'s Virtual Comm Port.
 * Follow the setting according to the setup screen capture. (57600Baud 8-N-1)
 * Once Termite configuration is done, press 'OK' to save the setting.
 * On the Wifi Remote I2c Device, Press the configuration button to allow the device to go into configuration mode.
 {{< figure src="/documentation/images/Wr_Config_Mode_Sw.jpg" >}}
 Press Config Mode button to go into configuration mode
-
 * Type 'help' to show the command available for configuration.
 * Type 'show' to list out current configuration.
-* We will use PineA64 as our Wifi Remote I2c module's server.
-* To Set the PineA64's IP address in to the device, enter (we will be using IP address 192.168.0.230 as example)
+* We will use PineA64 as our Wifi Remote I2c module’s server.
+* To Set the PineA64’s IP address in to the device, enter (we will be using IP address 192.168.0.230 as example)
    server 192.168.0.230
 * To configure the Wifi AP SSID and Password, (eg SSID=TestingWifi and Password=12345 )
    wifi TestingWifi 12345
 * The SSID and password are case sensitive. Please make sure it is input correctly.
 * Once configuration is done, type 'exit' to exit configuration mode and allow the device to reboot.
-* Please make sure your network is has DHCP server. The WiFi Remote i2c module will be running on DHCP mode and will requesting a IP address from your network's DHCP server.
+* Please make sure your network is has DHCP server. The WiFi Remote i2c module will be running on DHCP mode and will requesting a IP address from your network’s DHCP server.
 * After reboot, the Red LED indicator will start to blink in fast blinking mode.
 * Once the WiFi Remote I2c module connected to the WiFi Access Point, the LED indicator will go into slow blinking mode.
 * The hardware configuration is done.
 * The next step will be configure the PineWifiServer into your PineA64 board.
 
-=== Setup the PineWifiServer
+### Setup the PineWifiServer
 
-* link:/documentation/Accessories/Wifi_remote_i2c#download[Download the PineWifiServer from the Download Section]
+* [Download the PineWifiServer from the Download Section](/documentation/Accessories/Wifi_remote_i2c#download)
 * Copy PineWifiServer xxxxxxxx.gz  into your PineA64 with linux on it. (where xxxxxxxx is the version number)
 * Unzip the file using gunzip.
 * Add Execution flag on both of the file by
@@ -75,9 +74,9 @@ Press Config Mode button to go into configuration mode
 * To exit the console, type 'exit'.
 * Please take note that you are only allow one login simultaneously. The second telnet login will be rejected.
 
-=== Running the WifiAppDemo
+### Running the WifiAppDemo
 
-* link:/documentation/Accessories/Wifi_remote_i2c#download[Download the PineWifiServer from the Download Section]
+* [Download the PineWifiServer from the Download Section](/documentation/Accessories/Wifi_remote_i2c#download)
 * Copy WifiAppDemo xxxxxxxx.gz into your same PineA64 board that currently running with PineWifiServer. (where xxxxxxxx is the version number)
 * Unzip both of the file using gunzip.
 * Add Execution flag on both of the file by
@@ -93,28 +92,28 @@ Press Config Mode button to go into configuration mode
 
 Example of screen shot with WifiAppDemo polling multiple Wifi Remote I2c with Ambient Light Sensor and Humidity/Temperature Sensor connected on it. The speed for each round of polling is 1 second per poll.
 
-== Firmware Upgrade
+## Firmware Upgrade
 
-=== Hardware Setup
+### Hardware Setup
 {{< figure src="/documentation/images/Wr_Programming_Mode_Jumper.jpg" width="100" >}}
 
 Short Jumper S2 on the WiFI Remote I2c module (before power up the board) to allow the board to go in to firmware programming mode.
 
 {{< figure src="/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-1.jpg" title="Hardware Setup" >}}
 
 * Make sure that the driver for USB/UART Programming/Console Adapter (PMPROG01) is properly install and the PC is detected it as Comm Port.
-* The USB/UART Bridge is base on http://www.silabs.com/products/interface/usb-bridges/classic-usb-bridges/Pages/usb-to-uart-bridge.aspx[Silicon Lab CP2012 chipset].
-* USB/UART Programming/Console Adapter (PMPROG01) driver can be https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx[Download here]
+* The USB/UART Bridge is base on [Silicon Lab CP2012 chipset](http://www.silabs.com/products/interface/usb-bridges/classic-usb-bridges/Pages/usb-to-uart-bridge.aspx).
+* USB/UART Programming/Console Adapter (PMPROG01) driver can be [Download here](https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx)
 * Connect the USB/UART Programming/Console Adapter (PMPROG01) to the Wifi Remote I2c Device.
 * You can power-up the WiFI Remote I2c module through the USB Bus for configuration and programming.
 
 {{< figure src="/documentation/images/Wr_USB_Adpt_5v.jpg" width="100" >}}
 Place the jumper J2 on USB/UART Programming/Console Adapter (PMPROG01) to 5V output selection.
 
-=== Software Setup
+### Software Setup
 
-* Download the firmware from the link:/documentation/Accessories/Wifi_remote_i2c#download[download section] and unzip the file.
-* Download the windows Python base Flash Download Tools by Espressif from http://espressif.com/en/products/hardware/esp8266ex/resources[Espressif website].
+* Download the firmware from the [download section](/documentation/Accessories/Wifi_remote_i2c#download) and unzip the file.
+* Download the windows Python base Flash Download Tools by Espressif from [Espressif website](http://espressif.com/en/products/hardware/esp8266ex/resources).
 * Setup the ESP Flash Download tools according to the screen short.
 
 {{< figure src="/documentation/images/Esp_prog_tool.JPG" width="400" >}}
@@ -123,7 +122,7 @@ Place the jumper J2 on USB/UART Programming/Console Adapter (PMPROG01) to 5V out
 * Once the ESP Flash Download tool and hardware is setup properly, press the 'Start' button to start the firmware uploading process.
 * After uploading is done, power off and on again the WiFi Remote I2c module to restart the system.
 
-== Technical Specification
+## Technical Specification
 
 * Dimension: 47.00mm x 34.00mm
 * Input Voltage: 5V
@@ -132,28 +131,27 @@ Place the jumper J2 on USB/UART Programming/Console Adapter (PMPROG01) to 5V out
 * Output power of PA for 802.11b: 19.5dBm-21.5dBm
 * Recieived Sensitivity at DSSS, 1Mbps: -98dBm
 
-== I/O Pin Out
+## I/O Pin Out
 
 {{< figure src="/documentation/images/IO_Pin.JPG" >}}
 
-== Download
-
-=== Program/Driver
-* http://www.compuphase.com/software_termite.htm[Termite a simple RS232 terminal]
-* http://espressif.com/en/products/hardware/esp8266ex/resources[Flash Download Tools v2.4] Under Tools Section
-* https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx[Silicon Lab CP2102 Virtual COM Port Driver]
-* http://files.pine64.org/doc/POT/WifiAppDemo.gz[WifiAppDemo.gz]
-* http://files.pine64.org/doc/POT/PineWifiServer.gz[PineWifiServer.gz]
-* http://files.pine64.org/doc/POT/PMWF01A%20Firmware.zip[PMWF01A Firmware]
-* http://files.pine64.org/doc/POT/PMWF01A%20Firmware%20Source.zip[PMWF01A Firmware Source]
-* http://files.pine64.org/doc/POT/PineWifiRemoteI2c%20Server%20Source.tar.gz[PineWifiRemoteI2c Server Source.tar.gz]
-
-=== Datasheet/Related Information
-
-* http://www.te.com/commerce/DocumentDelivery/DDEController?Action=srchrtrv&DocNm=PCJ_series_relay_data_sheet_E&DocType=DS&DocLang=EN[TE PCJ-105D3M Relay Datasheet]
-* https://drive.google.com/file/d/0B0cEs0lxTtL3SDdCcWd0LVI2bk0/view?usp=sharing[ESP8266 Datasheet]
-* http://bbs.espressif.com/[ESP8266 forum]
-* http://espressif.com/en/products/hardware/esp8266ex/resources[ESP8266 Flash Download Tools, Please refer to the Tools section]
-* http://espressif.com/en/products/hardware/esp8266ex/resources[ESP8266 Resources]
-* https://www.silabs.com/Support%20Documents/TechnicalDocs/CP2102-9.pdf[CP2102 Datasheet]
-
+## Download
+
+### Program/Driver
+* [Termite a simple RS232 terminal](http://www.compuphase.com/software_termite.htm)
+* [Flash Download Tools v2.4](http://espressif.com/en/products/hardware/esp8266ex/resources) Under Tools Section
+* [Silicon Lab CP2102 Virtual COM Port Driver](https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx)
+* [WifiAppDemo.gz](http://files.pine64.org/doc/POT/WifiAppDemo.gz)
+* [PineWifiServer.gz](http://files.pine64.org/doc/POT/PineWifiServer.gz)
+* [PMWF01A Firmware](http://files.pine64.org/doc/POT/PMWF01A%20Firmware.zip)
+* [PMWF01A Firmware Source](http://files.pine64.org/doc/POT/PMWF01A%20Firmware%20Source.zip)
+* [PineWifiRemoteI2c Server Source.tar.gz](http://files.pine64.org/doc/POT/PineWifiRemoteI2c%20Server%20Source.tar.gz)
+
+### Datasheet/Related Information
+
+* [TE PCJ-105D3M Relay Datasheet](http://www.te.com/commerce/DocumentDelivery/DDEController?Action=srchrtrv&DocNm=PCJ_series_relay_data_sheet_E&DocType=DS&DocLang=EN)
+* [ESP8266 Datasheet](https://drive.google.com/file/d/0B0cEs0lxTtL3SDdCcWd0LVI2bk0/view?usp=sharing)
+* [ESP8266 forum](http://bbs.espressif.com/)
+* [ESP8266 Flash Download Tools, Please refer to the Tools section](http://espressif.com/en/products/hardware/esp8266ex/resources)
+* [ESP8266 Resources](http://espressif.com/en/products/hardware/esp8266ex/resources)
+* [CP2102 Datasheet](https://www.silabs.com/Support%20Documents/TechnicalDocs/CP2102-9.pdf)

content/documentation/Clusterboard/Accessories.md

@@ -0,0 +1,16 @@
+---
+title: "Accessories"
+draft: false
+menu:
+  docs:
+    title:
+    parent: "Clusterboard"
+    identifier: "Clusterboard/Accessories"
+    weight: 
+---
+
+* To operate this board you will need a power supply, Pine advises a "5V 15A power supply with 6.3mm OD/3.0mm ID barrel type DC Jack" which is also available in the store ([EU](https://pine64.com/product/clusterboard-eu-power-supply/) / [US](https://pine64.com/product/clusterboard-us-power-supply/) versions). There are other ways to power this board, but they are not described here yet.
+* The board works best when it is protected by a (mITX)case, and has some airflow provided by a fan.
+* Each SOPINE module can use cooling, both by a casefan, and by using heatsinks on the individual modules. At least the A64 could use some cooling.
+* The first slot can use a eMMC module, which are in the store in [16GB](https://pine64.com/product/16gb-emmc-module/) / [32GB](https://pine64.com/product/32gb-emmc-module/) / [64GB](https://pine64.com/product/64gb-emmc-module/) / [128GB](https://pine64.com/product/128gb-emmc-module/) sizes. The modules can be used as a USB stick using a [USB adapter](https://pine64.com/product/usb-adapter-for-emmc-module/). (The eMMC is also readable with the Hardkernel [eMMC to microSD](https://www.hardkernel.com/shop/emmc-module-reader-board-for-os-upgrade/) converter.)
+* Two AA batteries, to allow the SOPINE nodes to retain the RTC (Real Time Clock) time and date information when the power is disconnected.

content/documentation/Clusterboard/Installation.adoc → content/documentation/Clusterboard/Installation.md

@@ -13,19 +13,21 @@ To install a cluster it is important to know the IP addresses of each module, so
 
 Each module may be plugged into the Clusterboard individually or consecutively, which makes it easy to assign a hostname to each module separately. It is also possible to manually edit the hostname in the OS image of each module before the first boot.
 
-TIP: The board has no hotplug functionality, so make sure you only plug/unplug the modules while the power is disconnected from the clusterboard.
+**💡 TIP**\
+The board has no hotplug functionality, so make sure you only plug/unplug the modules while the power is disconnected from the clusterboard.
 
-TIP: No management features are available on the switch ship, so there is no VLAN support.
+**💡 TIP**\
+No management features are available on the switch ship, so there is no VLAN support.
 
-== Serial console
+## Serial console
 
 To boot use the serial console connect the pins to UART0 on the GPIO header and connect using baud 115200
 
 * Pin 6: GND
 * Pin 7: RTX
 * Pin 8: TXD
 
-The pinouts are available in https://forum.pine64.org/showthread.php?tid=8058[this forum thread].
-
-TIP: Do not connect the GND connector until the power is on as it can provide power and prevent the board from booting.
+The pinouts are available in [this forum thread](https://forum.pine64.org/showthread.php?tid=8058).
 
+**💡 TIP**\
+Do not connect the GND connector until the power is on as it can provide power and prevent the board from booting.