Converted adoc to markdown

content/documentation/Clusterboard/Further_information/Specifications.adoc → content/documentation/Clusterboard/Further_information/Specifications.md

@@ -12,8 +12,8 @@ menu:
 These are the Clusterboard specifications:
 
 * Standard mITX form-factor (167 mm x 170 mm)
-* Built-in eight-port Gigabit Ethernet switch, using RTL8370N ASIC; the switch is unmanaged although the ASIC provides management functions, see https://forum.pine64.org/showthread.php?tid=13181[this forum thread] for further information
-* Seven internal Gigabit Ethernet ports, one for each SOPINE module, connected to the built-in switch using https://datasheet.lcsc.com/szlcsc/Realtek-Semicon-RTL8211EG-VB-CG_C69264.pdf[RTL8211E] PHYs
+* Built-in eight-port Gigabit Ethernet switch, using RTL8370N ASIC; the switch is unmanaged although the ASIC provides management functions, see [this forum thread](https://forum.pine64.org/showthread.php?tid=13181) for further information
+* Seven internal Gigabit Ethernet ports, one for each SOPINE module, connected to the built-in switch using [RTL8211E](https://datasheet.lcsc.com/szlcsc/Realtek-Semicon-RTL8211EG-VB-CG_C69264.pdf) PHYs
 * One connector for an eMMC module, for the first SOPINE module
 * Seven USB 2.0 ports, one for each SOPINE module
 * GPIO pins exposed for each SOPINE module, including the UARTs
@@ -24,5 +24,5 @@ These are the Clusterboard specifications:
 
 Please note than only one power input may be used at once. The barrel-style jack is additionally protected by a built-in 15 A polyfuse.
 
-NOTE: No batteries for RTC backup should be installed unless certain hardware modifications are applied to the Clusterboard. Internal circuitry of the Clusterboard and SOPINE modules will eventually attempt to charge the batteries, which will result in damage to the batteries and the Clusterboard. Keep in mind that rechargeable batteries cannot be used because there is no charging circuitry for them on the Clusterboard. Please see https://forum.pine64.org/showthread.php?tid=5849&page=2[this forum thread] and https://ericdraken.com/a64-reset-problem/[this article] for further information.
-
+**📌 NOTE**\
+No batteries for RTC backup should be installed unless certain hardware modifications are applied to the Clusterboard. Internal circuitry of the Clusterboard and SOPINE modules will eventually attempt to charge the batteries, which will result in damage to the batteries and the Clusterboard. Keep in mind that rechargeable batteries cannot be used because there is no charging circuitry for them on the Clusterboard. Please see [this forum thread](https://forum.pine64.org/showthread.php?tid=5849&page=2) and [this article](https://ericdraken.com/a64-reset-problem/) for further information.

content/documentation/Clusterboard/Schematics.md

@@ -0,0 +1,19 @@
+---
+title: "Schematics"
+draft: false
+menu:
+  docs:
+    title:
+    parent: "Clusterboard"
+    identifier: "Clusterboard/Schematics"
+    weight: 
+---
+
+* [Clusterboard version 2.2 Schematic Capture source file](https://files.pine64.org/doc/clusterboard/PINE64%20CLUSTER%20BOARD_2_2.DSN)
+* [Clusterboard version 2.2 Schematic Capture PDF file](https://files.pine64.org/doc/clusterboard/PINE64%20CLUSTER%20BOARD_2_2_Schematic.pdf)
+* [Clusterboard version 2.2 PCB Job source file](https://files.pine64.org/doc/clusterboard/PINE64%20CLUSTER%20BOARD_2_2.brd)
+* [Clusterboard version 2.2 PCB Gerber file](https://files.pine64.org/doc/clusterboard/PINE64%20CLUSTER%20BOARD%20V2.2-gerber.rar)
+* [Clusterboard version 2.2 PCB Layout PDF file](https://files.pine64.org/doc/clusterboard/PINE64%20CLUSTER%20BOARD_2_2_PCB.pdf)
+* [Clusterboard 20pins header definition](https://files.pine64.org/doc/clusterboard/clusterboard_20pins_header.jpg)
+* [Clusterboard 3D drawing in Fusion360](https://myhub.autodesk360.com/ue2b2f72e/g/shares/SH56a43QTfd62c1cd96840f4ec37c60bcf12)
+* [Clusterboard PDF drawing](https://myhub.autodesk360.com/ue2b2f72e/g/shares/SH56a43QTfd62c1cd968cd6bc203ac753401?viewState=NoIgbgDAdAjCA0ICGBmARgEwGZIOwGMBaDFADgFNCAWfAJi2o1IFZDmlTSIA2DW8-FTQgAukA)

content/documentation/Ox64/Development_Efforts.md

@@ -0,0 +1,14 @@
+---
+title: "Development Efforts"
+draft: false
+menu:
+  docs:
+    title:
+    parent: "Ox64"
+    identifier: "Ox64/Development_Efforts"
+    weight: 3
+---
+
+* [Ox64 boots Linux successfully](https://twitter.com/gamelaster/status/1583916501400068096)
+* [Brennan Ashton is porting Apache NuttX RTOS and OpenAMP (Asymmetric Multiprocessing) to BL808](https://twitter.com/btashton/status/1586381334439923713?t=w5xRRUR74HGK2O1Zg_aFyw&s=19)
+* [Phone Concept for BL808](https://twitter.com/thanos_engine/status/1585153938092761093)

content/documentation/Ox64/Features.adoc → content/documentation/Ox64/Features.md

@@ -9,26 +9,25 @@ menu:
     weight: 1
 ---
 
-== Network
+## Network
 
 * 2.4 GHz 1T1R WiFi 802.11 b/g/n
 * Bluetooth 5.2
 * Zigbee
 * 10/100 Mbit/s Ethernet (optional, on expansion board)
 
-== Storage
+## Storage
 
 * On-board 16 Mbit (2 MB) or 128 Mbit (16 MB) XSPI NOR flash memory
 * MicroSD - supports SDHC and SDXC (only on the 128 Mb version)
 
-== Expansion Ports
+## Expansion Ports
 
 * USB 2.0 OTG port
 * 26 GPIO pins, including SPI, I~2~C and UART functionality, possible I~2~S and GMII expansion
 * Dual-lane MiPi CSI port, located at USB-C port, for camera module
 
-== Audio
+## Audio
 
 * Microphone (optional, on the camera module)
 * Speaker (optional, on the camera module)
-

content/documentation/Ox64/Further_information/Compatible_UARTs.adoc → content/documentation/Ox64/Further_information/Compatible_UARTs.md

@@ -13,12 +13,12 @@ When the Ox64 is in bootloader mode, some UARTs are unable to communicate with i
 
 The below devices have been tested and verified as working:
 
-* Raspberry Pi Pico - running the following https://github.com/sanjay900/ox64-uart/releases/tag/v1.1[UART firmware] (GP4 and GP5 are used for port 0, GP12 and GP13 for port 1)
-* Compiled binary for Pi Pico and connectivity diagram is https://github.com/Kris-Sekula/Pine64_Ox64_SBC/tree/main/uart[here]
-* ESP32 with CP210x - bridge the EN pin to ground to disable the ESP32 itself, and then connect the TX on the esp32 to 14 on the Ox64 and RX to pin 15. Note that only baud rate 115200 works, and this doesn't seem to work for everyone)
+* Raspberry Pi Pico - running the following [UART firmware](https://github.com/sanjay900/ox64-uart/releases/tag/v1.1) (GP4 and GP5 are used for port 0, GP12 and GP13 for port 1)
+* Compiled binary for Pi Pico and connectivity diagram is [here](https://github.com/Kris-Sekula/Pine64_Ox64_SBC/tree/main/uart)
+* ESP32 with CP210x - bridge the EN pin to ground to disable the ESP32 itself, and then connect the TX on the esp32 to 14 on the Ox64 and RX to pin 15. Note that only baud rate 115200 works, and this doesn’t seem to work for everyone)
 * Stand-alone CP2102 dongle works at 115200 baud. Brand used was HiLetgo.
 * STM32F401 BlackPill - running the Black Magic Debug firmware
 * STM32F103C8T6 BluePill - running Black Magic Debug.
-* STM32F103C8T6 BluePill - running link:/documentation/Ox64/Software/Flashing/#optional_preparing_serial_uart_adapter_stm32f103c8t6[BluePill Serial Monster] 
+* STM32F103C8T6 BluePill - running [BluePill Serial Monster](/documentation/Ox64/Software/Flashing/#optional_preparing_serial_uart_adapter_stm32f103c8t6) 
 * Some UART adapters based on the FT232H (note that the FT232RL does not work, and neither does the Pine 64 JTAG)
-* Some CH340G based adapters work and some don't.
+* Some CH340G based adapters work and some don’t.

content/documentation/Ox64/Further_information/Datasheets.md

@@ -0,0 +1,29 @@
+---
+title: "Datasheets"
+draft: false
+menu:
+  docs:
+    title:
+    parent: "Ox64/Further_information"
+    identifier: "Ox64/Further_information/Datasheets"
+    weight: 
+---
+
+Bouffalo BL808 SoC information:
+
+* [Bouffalo Lab BL808 SoC Datasheet](https://raw.githubusercontent.com/bouffalolab/bl_docs/main/BL808_DS/en/BL808_DS_1.2_en.pdf)
+* [Bouffalo Lab BL808 SoC Reference Manual](https://files.pine64.org/doc/datasheet/ox64/BL808_RM_en_1.0(open).pdf)
+
+SPI NOR Flash information:
+
+* [GigaDevice 16Mb XSPI-Flash Datasheet](https://files.pine64.org/doc/datasheet/ox64/gd25lq16e_rev1.2_20210108.pdf)
+* [GigaDevice 128Mb XSPI-Flash Datasheet](https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf)
+* [Winbond 128Mb QSPI-Flash Datasheet](https://wiki.pine64.org/images/5/5d/W25Q128JW_RevB_11042019-1761358.pdf) (W25Q128JWSQ)
+
+Power Regulator information:
+
+* [Innovation Analog Tech IA2014 Step_down Converter Datasheet](https://files.pine64.org/doc/datasheet/ox64/IA2014-03.pdf)
+
+MicroSD socket information:
+
+* [Push type microSD socket specification](https://files.pine64.org/doc/datasheet/ox64/TF%20PUSH%20type%20socket%20specification.pdf)

content/documentation/Ox64/Further_information/Resources.md

@@ -0,0 +1,40 @@
+---
+title: "Resources"
+draft: false
+menu:
+  docs:
+    title:
+    parent: "Ox64/Further_information"
+    identifier: "Ox64/Further_information/Resources"
+    weight: 
+---
+
+* [Ox64 SBC - Connecting, Flashing and Booting Linux! ($8 from Pine64)](https://www.youtube.com/watch?v=czRtF-UNiEY): A short video on how to connect to the Ox64, flash and boot
+* [#24.5 Ox64 Pine64 $8 Risc-V SBC - Programming and Booting Linux](https://www.youtube.com/watch?v=vPAk5sq_Ilc): Another video that covers soldering pins, connecting via Pi Pico and flashing Linux and U-Boot
+* [First batch of Ox64 won’t appear as USB serial port](https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff)
+* [First batch of Ox64 tested OK with CH340C/G](https://gist.github.com/lupyuen/2087e9b3fb40aab5e0795bb02a265a3b)
+* [https://www.robertlipe.com/bl808-not-symmetric/(First thoughts on the (a)symmetry of Bouffalo Labs BL808 as in Pine64 Ox64)
+* [The $8 linux computer (with picoprobe-rp2040 programming instructions)](https://thelittleengineerthatcould.blogspot.com/2022/12/the-8-linux-computer-part-2.html)
+* [Building the Xuantie GNU Toolchain for Ox64 on macOS and Apple Silicon](https://github.com/p4ddy1/pine_ox64/blob/main/build_toolchain_macos.md)
+
+Ox64 BL808 RISC-V SBC articles by [Lup Yuen LEE](https://lupyuen.codeberg.page/):
+
+* [Booting Linux and (maybe) Apache NuttX RTOS](https://lupyuen.codeberg.page/articles/ox64.html)
+* [Starting Apache NuttX real-time operating system](https://lupyuen.codeberg.page/articles/ox2.html)
+* [Sv39 Memory Management Unit](https://lupyuen.codeberg.page/articles/mmu.html)
+* [NuttX Apps and Initial RAM Disk](https://lupyuen.codeberg.page/articles/app.html)
+* [UART Interrupt and Platform-Level Interrupt Controller (PLIC)](https://lupyuen.codeberg.page/articles/plic2.html)
+* [Fixing the UART Interrupt and Platform-Level Interrupt Controller](https://lupyuen.codeberg.page/articles/plic3.html)
+* [$8 RISC-V SBC on a Real-Time Operating System: Ox64 + NuttX](https://www.hackster.io/lupyuen/8-risc-v-sbc-on-a-real-time-operating-system-ox64-nuttx-474358)
+* [Nim on a Real-Time Operating System: Apache NuttX RTOS + Ox64 BL808 SBC](https://lupyuen.codeberg.page/articles/nim.html)
+* [Emulate Ox64 BL808 in the Web Browser: Experiments with TinyEMU RISC-V Emulator and Apache NuttX RTOS](https://lupyuen.codeberg.page/articles/tinyemu2.html)
+* [Automated Testing with Ox64 BL808 Emulator (Apache NuttX RTOS)](https://lupyuen.codeberg.page/articles/tinyemu3.html)
+* [QuickJS JavaScript Engine on a Real-Time Operating System (Apache NuttX RTOS)](https://lupyuen.codeberg.page/articles/quickjs.html)
+* [Coding Ox64 BL808 SBC the Drag-n-Drop Way](https://lupyuen.codeberg.page/articles/quickjs2.html)
+* [Rust Apps on Ox64 BL808 RISC-V SBC and Apache NuttX RTOS](https://lupyuen.codeberg.page/articles/rust5.html)
+* [Adventures of Ox64 BL808 RISC-V SBC with Apache NuttX RTOS](https://youtu.be/Eoy-X4ouuLI)
+
+Git repositories:
+
+* [Official Bouffalo BL-808 site](https://github.com/bouffalolab/bl808-pac)
+* [Community made Arduino Core specifically for the Bouffalo Labs BL808 RISC-V MCU](https://github.com/sfranzyshen/arduino-bl808) (initial development has been postponed until further notice.)