PINE64 - User contributions [en]

User talk:NilsBe

2023-02-22T14:58:57Z

NilsBe: /* Bouffalo Lab */

I want to contribute to the documentation of the [[ox64]]

starting first here on this kind of sandbox and when the content is sufficient then transfer it to [[ox64/Development]]

=== First Steps ===

The USB is not working at the moment (except powering up the device), therefore connecting the ox64 to a computer will not be useful for the first development steps.

To connect the device with a computer the UART Pins are used.

OX64 has

=== Tools ===

[[https://pypi.org/project/bflb-mcu-tool/ python tool to flash the ox64]]

=== Some References ===

[[https://www.blaatschaap.be/booting-linux-on-an-ox64-bl808-board/ Blog "BlaatSchaap": "Booting Linux on an OX64 BL808 board"]]

=== Bouffalo Lab ===

{| class="wikitable"
|+ table of BL chips
|-
! Name !! Description !! Pine64 Devices !! other Devices
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=1 BL602/604]] || 32-bit RISC-V CPU, 276KB RAM, 128KB ROM || [[PineCone]] ||
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=2 BL702/704/706]] || 32-bit RISC-V CPU, 276KB RAM, 128KB ROM || [[Pinecil]] || [[https://www.lcsc.com/product-detail/Development-Boards-Kits_Bouffalo-Lab-BL702C-A0-IoT-DVK_C5122692.html DevKit]]
|-
| BL702L/704L || || ||
|-
| BL808 || 32-bit RISC-V (M0), 64-bit RISC-V (D0), 32-bit RISC-V CPU (LP) || [[Ox64]] || [[https://wiki.sipeed.com/hardware/en/maix/m1s/m1s_dock.html Sipeed M1s Dock]]
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=11 BL606P]] || 32-bit RISC-V CPU (M0), 64th RISC-V CPU (D0) || ||
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=21 BL616/618]] || 32-bit RISC CPU, 532KB SRAM, 128KB ROM || || [[https://wiki.sipeed.com/hardware/en/maixzero/m0s/m0s.html Sipeed M0s Module]]
|}

Bouffalo Website:

Bouffalo GitHub: https://github.com/bouffalolab

Bouffalo Lab Company Profile: https://pitchbook.com/profiles/company/264875-05

User talk:NilsBe

2023-02-22T14:53:44Z

NilsBe: /* Bouffalo Lab */

I want to contribute to the documentation of the [[ox64]]

starting first here on this kind of sandbox and when the content is sufficient then transfer it to [[ox64/Development]]

=== First Steps ===

The USB is not working at the moment (except powering up the device), therefore connecting the ox64 to a computer will not be useful for the first development steps.

To connect the device with a computer the UART Pins are used.

OX64 has

=== Tools ===

[[https://pypi.org/project/bflb-mcu-tool/ python tool to flash the ox64]]

=== Some References ===

[[https://www.blaatschaap.be/booting-linux-on-an-ox64-bl808-board/ Blog "BlaatSchaap": "Booting Linux on an OX64 BL808 board"]]

=== Bouffalo Lab ===

{| class="wikitable"
|+ table of BL chips
|-
! Name !! Description !! Pine64 Devices !! other Devices
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=1 BL602/604]] || 32-bit RISC-V CPU, 276KB RAM, 128KB ROM || [[PineCone]] ||
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=2 BL702/704/706]] || 32-bit RISC-V CPU, 276KB RAM, 128KB ROM || [[Pinecil]] || [[https://www.lcsc.com/product-detail/Development-Boards-Kits_Bouffalo-Lab-BL702C-A0-IoT-DVK_C5122692.html DevKit]]
|-
| BL702L/704L || || ||
|-
| BL808 || 32-bit RISC-V (M0), 64-bit RISC-V (D0), 32-bit RISC-V CPU (LP) || [[Ox64]] || [[https://wiki.sipeed.com/hardware/en/maix/m1s/m1s_dock.html Sipeed M1s Dock]]
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=11 BL606P]] || 32-bit RISC-V CPU (M0), 64th RISC-V CPU (D0) || ||
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=21 BL616/618]] || 32-bit RISC CPU, 532KB SRAM, 128KB ROM || ||
|}

Bouffalo Website:

Bouffalo GitHub: https://github.com/bouffalolab

Bouffalo Lab Company Profile: https://pitchbook.com/profiles/company/264875-05

User talk:NilsBe

2023-02-22T14:50:12Z

NilsBe: /* Bouffalo Lab */

I want to contribute to the documentation of the [[ox64]]

starting first here on this kind of sandbox and when the content is sufficient then transfer it to [[ox64/Development]]

=== First Steps ===

The USB is not working at the moment (except powering up the device), therefore connecting the ox64 to a computer will not be useful for the first development steps.

To connect the device with a computer the UART Pins are used.

OX64 has

=== Tools ===

[[https://pypi.org/project/bflb-mcu-tool/ python tool to flash the ox64]]

=== Some References ===

[[https://www.blaatschaap.be/booting-linux-on-an-ox64-bl808-board/ Blog "BlaatSchaap": "Booting Linux on an OX64 BL808 board"]]

=== Bouffalo Lab ===

{| class="wikitable"
|+ table of BL chips
|-
! Name !! Description !! Pine64 Devices !! other Devices
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=1 BL602/604]] || 32-bit RISC-V CPU, 276KB RAM, 128KB ROM || [[PineCone]] ||
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=2 BL702/704/706]] || 32-bit RISC-V CPU, 276KB RAM, 128KB ROM || [[Pinecil]] || [[https://www.lcsc.com/product-detail/Development-Boards-Kits_Bouffalo-Lab-BL702C-A0-IoT-DVK_C5122692.html DevKit]]
|-
| BL702L/704L || || ||
|-
| BL808 || 32-bit RISC-V (M0), 64-bit RISC-V (D0), 32-bit RISC-V CPU (LP) || [[Ox64]] || [[https://wiki.sipeed.com/hardware/en/maix/m1s/m1s_dock.html Sipeed M1s Dock]]
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=11 BL606P]] || 32-bit RISC-V CPU (M0), 64th RISC-V CPU (D0) || ||
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=21 BL616/618]] || 32-bit RISC CPU, 532KB SRAM, 128KB ROM || ||
|}

Bouffalo Website:

Bouffalo GitHub: https://github.com/bouffalolab

Ox64

2023-02-22T14:34:39Z

NilsBe: /* CPU Architecture */

[[File:Ox64_board.jpg|400px|thumb|right|The Ox64]]

The '''Ox64''' is a RISC-V based Single Board Computer powered by Bouffalo Lab BL808 C906 64-Bit RISC-V CPU, 32-Bit CPU, embedded 64MB PSRAM memory and build-on 3 radio RF (Wifi, BT, Zigbee). It provides breadboard friendly form factor, MicroSD Card slot, USB 2.0, and many other peripheral interfaces for makers to integrate with sensors and other devices.

[[File:RISC-V.png|600px|]]

== Software Releases ==

=== Quick Links to the Source of OS Images Build ===

There is a community effort to bring updated kernels, peripherals and buildroot - Lots of communication happening in the #ox64-nutcracker channel.

* [https://github.com/openbouffalo/buildroot_bouffalo buildroot] bringing all the work below together with a bootable kernel and updated filesystem images for SD cards
* [https://github.com/smaeul/u-boot/tree/bl808 U-Boot] and [https://github.com/smaeul/opensbi/tree/bl808 OpenSBI] work by Smauel
* [https://github.com/arm000/linux-bl808/tree/linux-next/mboxic Kernel] IRQChip, SDCard, and (WIP) USB by arm000, Alexander Horner and others
* [https://github.com/openbouffalo/OBLFR OpenBouffalo Firmware] low_load drivers by Fishwaldo and others

Original Linux Images provided by Bouffalo - Very basic '''alpha build''' which are only fit for board bring up and testing purposes.

* [https://github.com/bouffalolab/bl808_linux Linux for BL808]
* [https://wiki.pine64.org/wiki/File:Linux_BL808.pdf Installation Instructions for Linux on BL808 (Chinese)]
* [https://wiki.pine64.org/wiki/File:Linux_BL808_en.pdf Installation Instructions for Linux on BL808 (English Auto-Translation)]
* Toolchain:
** elf_newlib_toolchain/bin/riscv64-unknown-elf-gcc (Xuantie-900 elf newlib gcc Toolchain V2.2.5 B-20220323) 10.2.0
** linux_toolchain/bin/riscv64-unknown-linux-gnu-gcc (Xuantie-900 linux-5.10.4 glibc gcc Toolchain V2.2.4 B-20211227) 10.2.0
** cmake version 3.19.3

=== Software Development Kits ===
* [https://github.com/bouffalolab/bl_mcu_sdk BL808 MCU SDK]
* [https://dev.bouffalolab.com/download BLDevCube Flashing Tool for Windows, macOS and Ubuntu x64]
* [https://wiki.pine64.org/wiki/File:Ox64_BL808UART_connect.pdf Ox64 UART Flashing Guide] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/bl808_demo_event.bin BL808 Demo Firmware: bl808_demo_event.bin] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/whole_flash_data.bin BL808 UART Log Firmware: whole_flash_data.bin] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/BL808.DVK.Quick.Start.pdf BL808 DVK Quick Start]
* [https://github.com/bouffalolab/bl808_linux/tree/main/opensbi-0.6-808 OpenSBI for BL808]
* [https://github.com/bouffalolab/bl808-pac Rust Peripheral Access Crate (PAC) for BL808]
* [https://github.com/bouffalolab/bl808-pac/blob/main/bl808.svd System View Description (SVD) for BL808]

== SoC and Memory Specification ==
* Based on [https://en.bouffalolab.com/product/ Bouffalo Lab BL808]
[[File:Bouffalo_Lab_icon.png|right]]
[[File:BL808_Block_Diagram.jpg|600px]]

=== CPU Architecture ===
[[File:T-Head.png|right|200px]]

[https://www.t-head.cn/product/c906?lang=en T-Head C906 480MHz 64-bit RISC-V CPU]:
* Supports RISC-V RV64IMAFCV instruction architecture
* Five-stage single-issue sequentially executed pipeline
* Level-1 instruction and data cache of Harvard architecture, with a size of 32 KB and a cache line of 64B
* Sv39 memory management unit, realizing the conversion of virtual and real addresses and memory management
* jTLB that supports 128 entries
* Supports AXI 4.0 128-bit master interface
* Supports core local interrupt (CLINT) and platform-level interrupt controller (PLIC)
* With 80 external interrupt sources, 3 bits for configuring interrupt priority
* Supports BHT (8K) and BTB
* Compatible with RISC-V PMP, 8 configurable areas
* Supports hardware performance monitor (HPM) units

[https://www.t-head.cn/product/e907?lang=en T-Head E907 320MHz 32-bit RISC-V CPU]:
* Supports RISC-V RV32IMAFCP instruction set
* Supports RISC-V 32-bit/16-bit mixed instruction set
* Supports RISC-V machine mode and user mode
* Thirty-two 32-bit integer general purpose registers (GPR) and thirty-two 32-bit/64-bit floating-point GPRs
* Integer (5-stage)/floating-point (7-stage), single-issue, sequentially executed pipeline
* Supports AXI 4.0 main device interface and AHB 5.0 peripheral interface
* 32K instruction cache, two-way set associative structure
* 16K data cache, two-way set associative structure

[https://www.t-head.cn/product/e902?lang=en T-Head E902 150MHz 32-bit RISC-V CPU]:

=== System Memory ===
* Embedded 64MB PSRAM

== Board Features ==

=== Network ===
* 2.4GHz 1T1R WiFi 802.11 b/g/n
* Bluetooth 5.2
* Zigbee
* 10/100Mbps Ethernet (optional, on expansion board)

=== Storage ===
* on-board 16Mb (2MB) or 128Mb (16MB) XSPI NOR flash memory
* microSD - supports SDHC and SDXC (only 128Mb version)

=== Expansion Ports ===
* USB 2.0 OTG port
* 26 GPIO Pins, including SPI, I2C and UART functionality. Possible I2S and GMII expansion
* Dual lane MiPi CSI port, located at USB-C port, for camera module

=== Audio ===
* mic (optional, on camera module)
* speaker (optional, on camera module)

== Board Information, Schematics and Certifications ==
[[file:0x64pinout.png|500px|thumb|Pinout of the production version]]

* Baseboard Dimensions: 51mm x 21mm x 19mm x 3.5mm (Breadboard friendly)
* Input Power: 5V 0.5A microUSB or USB-C port

Production version schematic:

* [https://files.pine64.org/doc/ox64/PINE64_Ox64-Schematic-202221018.pdf Ox64 Schematic 20221018 v1.1]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Top-20221018.pdf Ox64 PCB Component placement(ToP) 20221018 v1.1]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Bottom-20221018.pdf Ox64 PCB Component placement(Bottom) 20221018 v1.1]

Prototype (dispatched to developers) schematic:
* [https://files.pine64.org/doc/ox64/PINE64_Ox64-Schematic-202221007.pdf Ox64 Schematic 20221007 v1.0]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Top-20221007.pdf Ox64 PCB Component placement(ToP) 20221007 v1.0]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Bottom-20221007.pdf Ox64 PCB Component placement(Bottom) 20221007 v1.0]

Certifications:
* Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary.
* Not yet available

== Datasheets for Components and Peripherals ==

Bouffalo BL808 SoC information:
* [https://files.pine64.org/doc/datasheet/ox64/BL808_DS_en_1.1(open).pdf Bouffalo Lab BL808 SoC Datasheet]
* [https://raw.githubusercontent.com/bouffalolab/bl_docs/main/BL808_RM/en/BL808_RM_en_1.2.pdf Bouffalo Lab BL808 SoC Reference Manual]

SPI NOR Flash information:
* [https://files.pine64.org/doc/datasheet/ox64/gd25lq16e_rev1.2_20210108.pdf GigaDevice 16Mb XSPI-Flash Datasheet]
* [https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf GigaDevice 128Mb XSPI-Flash Datasheet]

Power Regulator information:
* [https://files.pine64.org/doc/datasheet/ox64/IA2014-03.pdf Innovation Analog Tech IA2014 Step_down Converter Datasheet]

MicroSD socket information:
* [https://files.pine64.org/doc/datasheet/ox64/TF%20PUSH%20type%20socket%20specification.pdf Push type microSD socket specification]

== Compatible UARTs when in bootloader mode ==

When the Ox64 is in bootloader mode, some UARTs are unable to communicate with it. When this is the case, utilities such as BLDevCube are unable to actually program the device. If you see "Shake hand fail" and an empty ack, and your device is in bootloader mode, then it is likely an incompatible UART.

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)
* 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 [https://github.com/blackmagic-debug/blackmagic/tree/main/src/platforms/blackpillv2 Black Magic Debug] firmware
* STM32F103C8T6 BluePill - running Black Magic Debug.
* 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.

== Resources ==
* A video on how to connect to, flash and boot the Ox64 as at 2023-02 (15min) can be found [https://youtube.com/watch?v=czRtF-UNiEY here].
* [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff First Batch of Ox64 won't appear as USB Serial Port]
* [https://gist.github.com/lupyuen/2087e9b3fb40aab5e0795bb02a265a3b First Batch of Ox64 tested OK with CH340C/G]
* [https://www.robertlipe.com/bl808-not-symmetric/ First thoughts on the (a)symmetry of Bouffalo Labs BL808 as in Pine64’s Ox64]
* [https://thelittleengineerthatcould.blogspot.com/2022/12/the-8-linux-computer-part-2.html The $8 linux computer (with picoprobe-rp2040 programming instructions)]
* [https://github.com/p4ddy1/pine_ox64/blob/main/build_toolchain_macos.md Building the Xuantie GNU Toolchain for Ox64 on macOS and Apple Silicon]

Git repositories:
* [https://github.com/bouffalolab/bl808-pac Official Bouffalo BL-808 site]
* [https://github.com/sfranzyshen/arduino-bl808 Community made Arduino Core specifically for the Bouffalo Labs BL808 RISC-V MCU] (Initial development has been postponed until further notice.)

== Development Efforts ==
* [https://twitter.com/gamelaster/status/1583916501400068096 Ox64 boots Linux successfully]
* [https://twitter.com/btashton/status/1586381334439923713?t=w5xRRUR74HGK2O1Zg_aFyw&s=19 Brennan Ashton is porting Apache NuttX RTOS and OpenAMP (Asymmetric Multiprocessing) to BL808]
* [https://twitter.com/thanos_engine/status/1585153938092761093 Phone Concept for BL808]

[[Category:Ox64]] [[Category:Bouffalo BL808]]

User talk:NilsBe

2023-02-22T14:16:00Z

NilsBe: /* Bouffalo Lab */

User talk:NilsBe

2023-02-22T11:29:07Z

NilsBe: /* Bouffalo Lab */

I want to contribute to the documentation of the [[ox64]]

starting first here on this kind of sandbox and when the content is sufficient then transfer it to [[ox64/Development]]

=== First Steps ===

The USB is not working at the moment (except powering up the device), therefore connecting the ox64 to a computer will not be useful for the first development steps.

To connect the device with a computer the UART Pins are used.

OX64 has

=== Tools ===

[[https://pypi.org/project/bflb-mcu-tool/ python tool to flash the ox64]]

=== Some References ===

[[https://www.blaatschaap.be/booting-linux-on-an-ox64-bl808-board/ Blog "BlaatSchaap": "Booting Linux on an OX64 BL808 board"]]

=== Bouffalo Lab ===

{| class="wikitable"
|+ table of BL chips
|-
! Name !! Description !! Pine64 Devices !! other Devices
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=1 BL602/604]] || 32-bit RISC-V CPU, 276KB RAM, 128KB ROM || [[PineCone]] ||
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=2 BL702/704/706]] || 32-bit RISC-V CPU, 276KB RAM, 128KB ROM || [[Pinecil]] || [[https://www.lcsc.com/product-detail/Development-Boards-Kits_Bouffalo-Lab-BL702C-A0-IoT-DVK_C5122692.html DevKit]]
|-
| BL702L/704L || || ||
|-
| BL808 || || [[Ox64]] || [[https://wiki.sipeed.com/hardware/en/maix/m1s/m1s_dock.html Sipeed M1s Dock]]
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=11 BL606P]] || 32-bit RISC-V CPU (M0), 64th RISC-V CPU (D0) || ||
|-
| [[https://en.bouffalolab.com/product/?type=detail&id=21 BL616/618]] || 32-bit RISC CPU, 532KB SRAM, 128KB ROM || ||
|}

User talk:NilsBe

2023-02-20T19:21:28Z

NilsBe: /* Bouffalo Lab */

User talk:NilsBe

2023-02-20T15:25:26Z

NilsBe:

User talk:NilsBe

2023-02-19T19:47:33Z

NilsBe:

Ox64

2023-02-19T19:29:24Z

NilsBe: /* Resources */

[[File:Ox64_board.jpg|400px|thumb|right|The Ox64]]

The '''Ox64''' is a RISC-V based Single Board Computer powered by Bouffalo Lab BL808 C906 64-Bit RISC-V CPU, 32-Bit CPU, embedded 64MB PSRAM memory and build-on 3 radio RF (Wifi, BT, Zigbee). It provides breadboard friendly form factor, MicroSD Card slot, USB 2.0, and many other peripheral interfaces for makers to integrate with sensors and other devices.

[[File:RISC-V.png|600px|]]

== Software Releases ==

=== Quick Links to the Source of OS Images Build ===

There is a community effort to bring updated kernels, peripherals and buildroot - Lots of communication happening in the #ox64-nutcracker channel.

* [https://github.com/openbouffalo/buildroot_bouffalo buildroot] bringing all the work below together with a bootable kernel and updated filesystem images for SD cards
* [https://github.com/smaeul/u-boot/tree/bl808 U-Boot] and [https://github.com/smaeul/opensbi/tree/bl808 OpenSBI] work by Smauel
* [https://github.com/arm000/linux-bl808/tree/linux-next/mboxic Kernel] IRQChip, SDCard, and (WIP) USB by arm000, Alexander Horner and others
* [https://github.com/openbouffalo/OBLFR OpenBouffalo Firmware] low_load drivers by Fishwaldo and others

Original Linux Images provided by Bouffalo - Very basic '''alpha build''' which are only fit for board bring up and testing purposes.

* [https://github.com/bouffalolab/bl808_linux Linux for BL808]
* [https://wiki.pine64.org/wiki/File:Linux_BL808.pdf Installation Instructions for Linux on BL808 (Chinese)]
* [https://wiki.pine64.org/wiki/File:Linux_BL808_en.pdf Installation Instructions for Linux on BL808 (English Auto-Translation)]
* Toolchain:
** elf_newlib_toolchain/bin/riscv64-unknown-elf-gcc (Xuantie-900 elf newlib gcc Toolchain V2.2.5 B-20220323) 10.2.0
** linux_toolchain/bin/riscv64-unknown-linux-gnu-gcc (Xuantie-900 linux-5.10.4 glibc gcc Toolchain V2.2.4 B-20211227) 10.2.0
** cmake version 3.19.3

=== Software Development Kits ===
* [https://github.com/bouffalolab/bl_mcu_sdk BL808 MCU SDK]
* [https://dev.bouffalolab.com/download BLDevCube Flashing Tool for Windows, macOS and Ubuntu x64]
* [https://wiki.pine64.org/wiki/File:Ox64_BL808UART_connect.pdf Ox64 UART Flashing Guide] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/bl808_demo_event.bin BL808 Demo Firmware: bl808_demo_event.bin] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/whole_flash_data.bin BL808 UART Log Firmware: whole_flash_data.bin] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/BL808.DVK.Quick.Start.pdf BL808 DVK Quick Start]
* [https://github.com/bouffalolab/bl808_linux/tree/main/opensbi-0.6-808 OpenSBI for BL808]
* [https://github.com/bouffalolab/bl808-pac Rust Peripheral Access Crate (PAC) for BL808]
* [https://github.com/bouffalolab/bl808-pac/blob/main/bl808.svd System View Description (SVD) for BL808]

== SoC and Memory Specification ==
* Based on [https://en.bouffalolab.com/product/ Bouffalo Lab BL808]
[[File:Bouffalo_Lab_icon.png|right]]
[[File:BL808_Block_Diagram.jpg|600px]]

=== CPU Architecture ===
[[File:T-Head.png|right|200px]]

[https://www.t-head.cn/product/c906?lang=en T-Head C906 480MHz 64-bit RISC-V CPU]:
* Supports RISC-V RV64IMAFCV instruction architecture
* Five-stage single-issue sequentially executed pipeline
* Level-1 instruction and data cache of Harvard architecture, with a size of 32 KB and a cache line of 64B
* Sv39 memory management unit, realizing the conversion of virtual and real addresses and memory management
* jTLB that supports 128 entries
* Supports AXI 4.0 128-bit master interface
* Supports core local interrupt (CLINT) and platform-level interrupt controller (PLIC)
* With 80 external interrupt sources, 3 bits for configuring interrupt priority
* Supports BHT (8K) and BTB
* Compatible with RISC-V PMP, 8 configurable areas
* Supports hardware performance monitor (HPM) units

[https://www.t-head.cn/product/e907?lang=en T-Head E907 320MHz 32-bit RISC-V CPU]:
* Supports RISC-V RV32IMAFCP instruction set
* Supports RISC-V 32-bit/16-bit mixed instruction set
* Supports RISC-V machine mode and user mode
* Thirty-two 32-bit integer general purpose registers (GPR) and thirty-two 32-bit/64-bit floating-point GPRs
* Integer (5-stage)/floating-point (7-stage), single-issue, sequentially executed pipeline
* Supports AXI 4.0 main device interface and AHB 5.0 peripheral interface
* 32K instruction cache, two-way set associative structure
* 16K data cache, two-way set associative structure

=== System Memory ===
* Embedded 64MB PSRAM

== Board Features ==

=== Network ===
* 2.4GHz 1T1R WiFi 802.11 b/g/n
* Bluetooth 5.2
* Zigbee
* 10/100Mbps Ethernet (optional, on expansion board)

=== Storage ===
* on-board 16Mb (2MB) or 128Mb (16MB) XSPI NOR flash memory
* microSD - supports SDHC and SDXC (only 128Mb version)

=== Expansion Ports ===
* USB 2.0 OTG port
* 26 GPIO Pins, including SPI, I2C and UART functionality. Possible I2S and GMII expansion
* Dual lane MiPi CSI port, located at USB-C port, for camera module

=== Audio ===
* mic (optional, on camera module)
* speaker (optional, on camera module)

== Board Information, Schematics and Certifications ==
[[file:0x64pinout.png|500px|thumb|Pinout of the production version]]

* Baseboard Dimensions: 51mm x 21mm x 19mm x 3.5mm (Breadboard friendly)
* Input Power: 5V 0.5A microUSB or USB-C port

Production version schematic:

* [https://files.pine64.org/doc/ox64/PINE64_Ox64-Schematic-202221018.pdf Ox64 Schematic 20221018 v1.1]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Top-20221018.pdf Ox64 PCB Component placement(ToP) 20221018 v1.1]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Bottom-20221018.pdf Ox64 PCB Component placement(Bottom) 20221018 v1.1]

Prototype (dispatched to developers) schematic:
* [https://files.pine64.org/doc/ox64/PINE64_Ox64-Schematic-202221007.pdf Ox64 Schematic 20221007 v1.0]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Top-20221007.pdf Ox64 PCB Component placement(ToP) 20221007 v1.0]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Bottom-20221007.pdf Ox64 PCB Component placement(Bottom) 20221007 v1.0]

Certifications:
* Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary.
* Not yet available

== Datasheets for Components and Peripherals ==

Bouffalo BL808 SoC information:
* [https://files.pine64.org/doc/datasheet/ox64/BL808_DS_en_1.1(open).pdf Bouffalo Lab BL808 SoC Datasheet]
* [https://raw.githubusercontent.com/bouffalolab/bl_docs/main/BL808_RM/en/BL808_RM_en_1.2.pdf Bouffalo Lab BL808 SoC Reference Manual]

SPI NOR Flash information:
* [https://files.pine64.org/doc/datasheet/ox64/gd25lq16e_rev1.2_20210108.pdf GigaDevice 16Mb XSPI-Flash Datasheet]
* [https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf GigaDevice 128Mb XSPI-Flash Datasheet]

Power Regulator information:
* [https://files.pine64.org/doc/datasheet/ox64/IA2014-03.pdf Innovation Analog Tech IA2014 Step_down Converter Datasheet]

MicroSD socket information:
* [https://files.pine64.org/doc/datasheet/ox64/TF%20PUSH%20type%20socket%20specification.pdf Push type microSD socket specification]

== Compatible UARTs when in bootloader mode ==

When the Ox64 is in bootloader mode, some UARTs are unable to communicate with it. When this is the case, utilities such as BLDevCube are unable to actually program the device. If you see "Shake hand fail" and an empty ack, and your device is in bootloader mode, then it is likely an incompatible UART.

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)
* 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 [https://github.com/blackmagic-debug/blackmagic/tree/main/src/platforms/blackpillv2 Black Magic Debug] firmware
* STM32F103C8T6 BluePill - running Black Magic Debug.
* 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.

== Resources ==
* A video on how to connect to, flash and boot the Ox64 as at 2023-02 (15min) can be found [https://youtube.com/watch?v=czRtF-UNiEY here].
* [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff First Batch of Ox64 won't appear as USB Serial Port]
* [https://gist.github.com/lupyuen/2087e9b3fb40aab5e0795bb02a265a3b First Batch of Ox64 tested OK with CH340C/G]
* [https://www.robertlipe.com/bl808-not-symmetric/ First thoughts on the (a)symmetry of Bouffalo Labs BL808 as in Pine64’s Ox64]
* [https://thelittleengineerthatcould.blogspot.com/2022/12/the-8-linux-computer-part-2.html The $8 linux computer (with picoprobe-rp2040 programming instructions)]
* [https://github.com/p4ddy1/pine_ox64/blob/main/build_toolchain_macos.md Building the Xuantie GNU Toolchain for Ox64 on macOS and Apple Silicon]

Git repositories:
* [https://github.com/bouffalolab/bl808-pac Official Bouffalo BL-808 site]
* [https://github.com/sfranzyshen/arduino-bl808 Community made Arduino Core specifically for the Bouffalo Labs BL808 RISC-V MCU] (Initial development has been postponed until further notice.)

== Development Efforts ==
* [https://twitter.com/gamelaster/status/1583916501400068096 Ox64 boots Linux successfully]
* [https://twitter.com/btashton/status/1586381334439923713?t=w5xRRUR74HGK2O1Zg_aFyw&s=19 Brennan Ashton is porting Apache NuttX RTOS and OpenAMP (Asymmetric Multiprocessing) to BL808]
* [https://twitter.com/thanos_engine/status/1585153938092761093 Phone Concept for BL808]

[[Category:Ox64]] [[Category:Bouffalo BL808]]

User talk:NilsBe

2023-02-19T18:00:06Z

NilsBe:

User talk:NilsBe

2023-02-19T17:48:06Z

NilsBe: Created page with "i want to contribute to the documentation of the ox64 starting first here on this kind of sandbox and when the content is sufficient then transfer it to ox64/Development"

i want to contribute to the documentation of the [[ox64]]

starting first here on this kind of sandbox and when the content is sufficient then transfer it to [[ox64/Development]]

Ox64

2023-02-16T22:27:25Z

NilsBe: /* Storage */

[[File:Ox64_board.jpg|400px|thumb|right|The Ox64]]

The '''Ox64''' is a RISC-V based Single Board Computer powered by Bouffalo Lab BL808 C906 64-Bit RISC-V CPU, 32-Bit CPU, embedded 64MB PSRAM memory and build-on 3 radio RF (Wifi, BT, Zigbee). It provides breadboard friendly form factor, MicroSD Card slot, USB 2.0, and many other peripheral interfaces for makers to integrate with sensors and other devices.

[[File:RISC-V.png|600px|]]

== Software Releases ==

=== Quick Links to the Source of OS Images Build ===

There is a community effort to bring updated kernels, peripherals and buildroot - Lots of communication happening in the #ox64-nutcracker channel.

* [https://github.com/openbouffalo/buildroot_bouffalo buildroot] bringing all the work below together with a bootable kernel and updated filesystem images for SD cards
* [https://github.com/smaeul/u-boot/tree/bl808 U-Boot] and [https://github.com/smaeul/opensbi/tree/bl808 OpenSBI] work by Smauel
* [https://github.com/arm000/linux-bl808/tree/linux-next/mboxic Kernel] IRQChip, SDCard, and (WIP) USB by arm000, Alexander Horner and others
* [https://github.com/openbouffalo/OBLFR OpenBouffalo Firmware] low_load drivers by Fishwaldo and others

Original Linux Images provided by Bouffalo - Very basic '''alpha build''' which are only fit for board bring up and testing purposes.

* [https://github.com/bouffalolab/bl808_linux Linux for BL808]
* [https://wiki.pine64.org/wiki/File:Linux_BL808.pdf Installation Instructions for Linux on BL808 (Chinese)]
* [https://wiki.pine64.org/wiki/File:Linux_BL808_en.pdf Installation Instructions for Linux on BL808 (English Auto-Translation)]
* Toolchain:
** elf_newlib_toolchain/bin/riscv64-unknown-elf-gcc (Xuantie-900 elf newlib gcc Toolchain V2.2.5 B-20220323) 10.2.0
** linux_toolchain/bin/riscv64-unknown-linux-gnu-gcc (Xuantie-900 linux-5.10.4 glibc gcc Toolchain V2.2.4 B-20211227) 10.2.0
** cmake version 3.19.3

=== Software Development Kits ===
* [https://github.com/bouffalolab/bl_mcu_sdk BL808 MCU SDK]
* [https://dev.bouffalolab.com/download BLDevCube Flashing Tool for Windows, macOS and Ubuntu x64]
* [https://wiki.pine64.org/wiki/File:Ox64_BL808UART_connect.pdf Ox64 UART Flashing Guide] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/bl808_demo_event.bin BL808 Demo Firmware: bl808_demo_event.bin] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/whole_flash_data.bin BL808 UART Log Firmware: whole_flash_data.bin] [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff (Notes)]
* [https://github.com/lupyuen/lupyuen.github.io/releases/download/ox64/BL808.DVK.Quick.Start.pdf BL808 DVK Quick Start]
* [https://github.com/bouffalolab/bl808_linux/tree/main/opensbi-0.6-808 OpenSBI for BL808]
* [https://github.com/bouffalolab/bl808-pac Rust Peripheral Access Crate (PAC) for BL808]
* [https://github.com/bouffalolab/bl808-pac/blob/main/bl808.svd System View Description (SVD) for BL808]

== SoC and Memory Specification ==
* Based on [https://en.bouffalolab.com/product/ Bouffalo Lab BL808]
[[File:Bouffalo_Lab_icon.png|right]]
[[File:BL808_Block_Diagram.jpg|600px]]

=== CPU Architecture ===
[[File:T-Head.png|right|200px]]

[https://www.t-head.cn/product/c906?lang=en T-Head C906 480MHz 64-bit RISC-V CPU]:
* Supports RISC-V RV64IMAFCV instruction architecture
* Five-stage single-issue sequentially executed pipeline
* Level-1 instruction and data cache of Harvard architecture, with a size of 32 KB and a cache line of 64B
* Sv39 memory management unit, realizing the conversion of virtual and real addresses and memory management
* jTLB that supports 128 entries
* Supports AXI 4.0 128-bit master interface
* Supports core local interrupt (CLINT) and platform-level interrupt controller (PLIC)
* With 80 external interrupt sources, 3 bits for configuring interrupt priority
* Supports BHT (8K) and BTB
* Compatible with RISC-V PMP, 8 configurable areas
* Supports hardware performance monitor (HPM) units

[https://www.t-head.cn/product/e907?lang=en T-Head E907 320MHz 32-bit RISC-V CPU]:
* Supports RISC-V RV32IMAFCP instruction set
* Supports RISC-V 32-bit/16-bit mixed instruction set
* Supports RISC-V machine mode and user mode
* Thirty-two 32-bit integer general purpose registers (GPR) and thirty-two 32-bit/64-bit floating-point GPRs
* Integer (5-stage)/floating-point (7-stage), single-issue, sequentially executed pipeline
* Supports AXI 4.0 main device interface and AHB 5.0 peripheral interface
* 32K instruction cache, two-way set associative structure
* 16K data cache, two-way set associative structure

=== System Memory ===
* Embedded 64MB PSRAM

== Board Features ==

=== Network ===
* 2.4GHz 1T1R WiFi 802.11 b/g/n
* Bluetooth 5.2
* Zigbee
* 10/100Mbps Ethernet (optional, on expansion board)

=== Storage ===
* on-board 16Mb (2MB) or 128Mb (16MB) XSPI NOR flash memory
* microSD - supports SDHC and SDXC (only 128Mb version)

=== Expansion Ports ===
* USB 2.0 OTG port
* 26 GPIO Pins, including SPI, I2C and UART functionality. Possible I2S and GMII expansion
* Dual lane MiPi CSI port, located at USB-C port, for camera module

=== Audio ===
* mic (optional, on camera module)
* speaker (optional, on camera module)

== Board Information, Schematics and Certifications ==
[[file:0x64pinout.png|500px|thumb|Pinout of the production version]]

* Baseboard Dimensions: 51mm x 21mm x 19mm x 3.5mm (Breadboard friendly)
* Input Power: 5V 0.5A microUSB or USB-C port

Production version schematic:

* [https://files.pine64.org/doc/ox64/PINE64_Ox64-Schematic-202221018.pdf Ox64 Schematic 20221018 v1.1]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Top-20221018.pdf Ox64 PCB Component placement(ToP) 20221018 v1.1]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Bottom-20221018.pdf Ox64 PCB Component placement(Bottom) 20221018 v1.1]

Prototype (dispatched to developers) schematic:
* [https://files.pine64.org/doc/ox64/PINE64_Ox64-Schematic-202221007.pdf Ox64 Schematic 20221007 v1.0]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Top-20221007.pdf Ox64 PCB Component placement(ToP) 20221007 v1.0]
* [https://files.pine64.org/doc/ox64/PINE64_Ox64_PCB_Placement-Bottom-20221007.pdf Ox64 PCB Component placement(Bottom) 20221007 v1.0]

Certifications:
* Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary.
* Not yet available

== Datasheets for Components and Peripherals ==

Bouffalo BL808 SoC information:
* [https://files.pine64.org/doc/datasheet/ox64/BL808_DS_en_1.1(open).pdf Bouffalo Lab BL808 SoC Datasheet]
* [https://raw.githubusercontent.com/bouffalolab/bl_docs/main/BL808_RM/en/BL808_RM_en_1.2.pdf Bouffalo Lab BL808 SoC Reference Manual]

SPI NOR Flash information:
* [https://files.pine64.org/doc/datasheet/ox64/gd25lq16e_rev1.2_20210108.pdf GigaDevice 16Mb XSPI-Flash Datasheet]
* [https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf GigaDevice 128Mb XSPI-Flash Datasheet]

Power Regulator information:
* [https://files.pine64.org/doc/datasheet/ox64/IA2014-03.pdf Innovation Analog Tech IA2014 Step_down Converter Datasheet]

MicroSD socket information:
* [https://files.pine64.org/doc/datasheet/ox64/TF%20PUSH%20type%20socket%20specification.pdf Push type microSD socket specification]

== Compatible UARTs when in bootloader mode ==

When the Ox64 is in bootloader mode, some UARTs are unable to communicate with it. When this is the case, utilities such as BLDevCube are unable to actually program the device. If you see "Shake hand fail" and an empty ack, and your device is in bootloader mode, then it is likely an incompatible UART.

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)
* 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 [https://github.com/blackmagic-debug/blackmagic/tree/main/src/platforms/blackpillv2 Black Magic Debug] firmware
* STM32F103C8T6 BluePill - running Black Magic Debug.
* 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.

== Resources ==
* A video on how to connect to, flash and boot the Ox64 as at 2023-02 (15min) can be found [https://youtube.com/watch?v=czRtF-UNiEY here].
* [https://gist.github.com/lupyuen/7a0c697b89abccda8e38b33dfe5ebaff First Batch of Ox64 won't appear as USB Serial Port]
* [https://gist.github.com/lupyuen/2087e9b3fb40aab5e0795bb02a265a3b First Batch of Ox64 tested OK with CH340C/G]
* [https://www.robertlipe.com/bl808-not-symmetric/ First thoughts on the (a)symmetry of Bouffalo Labs BL808 as in Pine64’s Ox64]
* [https://thelittleengineerthatcould.blogspot.com/2022/12/the-8-linux-computer-part-2.html The $8 linux computer (with picoprobe-rp2040 programming instructions)]
* [https://github.com/p4ddy1/pine_ox64/blob/main/build_toolchain_macos.md Building the Xuantie GNU Toolchain for Ox64 on macOS and Apple Silicon]

Git repositories:
* [https://github.com/bouffalolab/bl808-pac Official Bouffalo BL-808 site]
* [https://github.com/sfranzyshen/arduino-bl808 Community made Arduino Core specifically for the Bouffalo Labs BL808 RISC-V MCU]

== Development Efforts ==
* [https://twitter.com/gamelaster/status/1583916501400068096 Ox64 boots Linux successfully]
* [https://twitter.com/btashton/status/1586381334439923713?t=w5xRRUR74HGK2O1Zg_aFyw&s=19 Brennan Ashton is porting Apache NuttX RTOS and OpenAMP (Asymmetric Multiprocessing) to BL808]
* [https://twitter.com/thanos_engine/status/1585153938092761093 Phone Concept for BL808]

[[Category:Ox64]] [[Category:Bouffalo BL808]]