PINE64 - User contributions [en]

PineTab-V Releases

2023-08-23T11:40:07Z

Fishwaldo: /* Linux */

This page contains a list of all available releases and tools for the [[PineTab-V]] in alphabetical order.

== Factory releases ==

The PineTab-V ships with ''Factory Test Code''. The factory test reference source code can be found here:

* [https://files.pine64.org/SDK/PineTab-V/PineTab-V_factorytestcode_SDK-20230725.tar.gz PineTab-V_factorytestcode_SDK-20230725.tar.gz] from ''pine64.org'' (8.36GB, MD5 of the TAR-GZip file: ''3e35e2760d82155b024f7601ac2b1275'')

Community releases:

* [https://pine64.my-ho.st:8443/pinetabv/factoryimage/ sdcard.img] pre-built image from the community member Fishwaldo derived from the factory SDK. Note: Use ''dd'' to write it to microSD card or the eMMC.

== Linux ==

=== Gentoo ===

A Gentoo overlay is available [https://gitlab.com/bingch/gentoo-overlay here], it shares most ebuilds for [https://wiki.gentoo.org/wiki/Embedded_Handbook/Boards/StarFive_VisionFive_2 StarFive VisionFive 2] except the kernel source ebuild contains patches from the above factory SDK.

=== KDE Plasma Yocto ===

A KDE Plasma Yocto Image from the community member Fishwaldo. Based on the Star64 images developed [https://github.com/Fishwaldo/meta-pine64 here]. Please see this [https://github.com/Fishwaldo/meta-pine64/issues/12 issue] for known problems.

==== Download ====

* https://github.com/Fishwaldo/meta-pine64/releases/

{| class="wikitable"
!colspan="2" style="background: #a7d7f9;"| Default credentials
|-
! Root
| <code>root/pine64</code>
|-
! Default user
| <code>pine64/pine64</code>
|}

==== Notes ====
* Use ''dd'' or ''Balena Etcher'' to copy to a microSD card and then insert the microSD card into your PineTab-V and boot

[[Category:PineTab-V]]

PineTab-V

2023-08-04T10:02:54Z

Fishwaldo: /* Releases */

[[File:pinetabv_1.jpg|250px|thumb|right|The PineTab-V with the detachable keyboard attached]]

The '''PineTab-V''' is ''PINE64's'' first RISC-V tablet. It is based on the JH7110 64-bit RISC-V SoC. The packaging is very similar to ARM-based [[PineTab2]].

== Introduction ==
In late 2022, PINE64 announced plans to help grow the RISC-V hardware ecosystem alongside the existing ARM-based device line-up. The PineTab-V is an experimental device, which ships without an OS and without any promises. The JH7110 RISC-V SoC, and the RISC-V architecture in more general, is currently best described as having limited Linux support. You can think of it as a convenient development platform targeted at those of you interested in bringing Linux support to JH7110 and, by extension, the entire RISC-V ecosystem.

== State of the software ==

The PineTab-V is an experimental device and lacks dedicated working software – it should therefore only be purchased by people interested in helping with the bring-up process of Linux and BSDs on the RISC-V architecture.

{{Warning|Do not buy the device unless you intend to use it for operating system development purposes.}}

== Releases ==

The PineTab-V ships with ''Factory Test Code''. The factory test reference source code can be found here:

* [https://files.pine64.org/SDK/PineTab-V/PineTab-V_factorytestcode_SDK-20230725.tar.gz PineTab-V_factorytestcode_SDK-20230725.tar.gz] from ''pine64.org'' (8.36GB, MD5 of the TAR-GZip file: ''3e35e2760d82155b024f7601ac2b1275'')
* [https://pine64.my-ho.st:8443/pinetabv/factoryimage/ sdcard.img] pre-built image from the factory SDK. Use ''dd'' to write it to microSD card or the eMMC.

* A KDE Plasma Yocto Image is available [https://pine64.my-ho.st:8443/pinetabv/ here]. use dd or balenaetcher to copy to a SD card and insert into your PTV and boot. Based on the Star64 images developed [https://github.com/Fishwaldo/meta-pine64 here]. Please see this [https://github.com/Fishwaldo/meta-pine64/issues/12 issue] for known problems. (login root/pine64, pine64/pine64)

== Variants ==

There are currently two variants of the PineTab-V:

* PineTab-V – 4GB RAM and 64GB eMMC storage
* PineTab-V – 8GB RAM and 128GB eMMC storage

== Features ==
[[File:pinetabv_2.jpg|250px|thumb|right|Front- and backside of the PineTab-V]]
[[File:pinetabv_3.jpg|250px|thumb|right|Backside of the PineTab-V]]

Chassis:

* Dimensions: 242mm x 161mm x 9mm
* Weight: 520 grams (without keyboard), 990 grams (includes keyboard)
* Build: Metal and Plastic
* Color: Matte Black

Display:

* Type: HD IPS capacitive touchscreen, 16.7M colors
* Size: 10.1 inches
* Resolution: 1280×800 pixels, 16:10 ratio

Platform:

* Chipset: StarFive JH7110
* CPU: 64-bit Quad-core 1.5 GHz SiFive U74 RISC-V
* GPU: Imagination Technology BXE-4-32

Memory:

* Internal Flash Memory: 64GB (variant 1) or 128GB (variant 2) eMMC module
* System Memory: 4GB (variant 1) or 8GB (variant 2) LPDDR4 SDRAM
* Expansion: micro SD Card support SDHC and SDXC, up to 2TB

Camera:

* Main Camera: Single 5MP, LED Flash (chipset: Omnivision OV5648)
* Selfie Camera: Single 2MP (chipset: Galaxycore GC02M2)

Sound:

* Loudspeaker: Yes, stereo
* 3.5mm jack with mic: Yes, stereo
* Sound IC: [http://everest-semi.com/pdf/ES8316%20PB.pdf ES8316]

Wireless:

* Chipset: Realtek RTL8852BU
* WLAN: Wi-Fi 802.11 ax/ac/b/g/n, dual-band, hotspot
* Bluetooth: 5.2, A2DP

I/O:

* 1x USB 3.0 Type-C port (front side 3.0, rear side 2.0)
* 1x USB 2.0 Type-C port (also use as charging and debug port)
* 1x USB 2.0 Pogo keyboard port
* 1x microHDMI HD Video output

Battery:

* Removable Li-Po 6000mAh battery
* Charging: 15W – 5V 3A
* Model 30100140 from [https://zgszjjy.com/ zgszjjy]
* Charge IC: [https://www.ti.com/product/BQ25890H BQ25890H]
* Fuel Guage: [http://en.cellwise-semi.com/Public/assests/menu/20230314/64102656c943b.pdf CW2015CHBD]

[[File:PineTab-V-PCB.jpg|thumb|right|PineTab-V Board]]

== Schematics and certifications ==

PineTab-V mainboard schematic:

* [https://files.pine64.org/doc/PineTab/PineTab-V_Schematic_Ver1-20230614.pdf PineTab-V mainboard Released Schematic-20230614 ver 1.0]
* [https://files.pine64.org/doc/PineTab/PineTab-V_comp_ref_top-20230614.pdf PineTab-V PCB Component Reference location v1.0 (top layer)]
* [https://files.pine64.org/doc/PineTab/PineTab-V_comp_ref_bottom-20230614.pdf PineTab-V PCB Component Reference location v1.0 (bottom layer)]
* [https://files.pine64.org/doc/PineTab/pinetab2-V_uart_console_schematic-20221107.pdf PineTab2/PineTab-V UART Dongle Schematic-20221107]

PineTab-V certifications:
* TODO

== Tutorials ==

=== Connecting the UART adapter ===

[[File:PineTab2 USB UARTv2.jpg|thumb|right|300px|UART Adapter]]

The UART serves as a console for early boot and kernel messages, and also offers access to a root shell in the factory test image. The UART adapter allows access to the UART through the USB 2.0 Type-C port:
* Insert the UART adapter face-up in the USB 2.0 Type-C port (the USB port furthest from the power button).
* Connect a USB cable from another computer to the port on the adapter marked "DEBUG". The green LED on the adapter should light up. The other adapter port can be connected to USB power if you don't want to run the tablet on its battery.
* In a terminal window on the other computer, use ''tio'', ''screen'', ''minicom'', or another application that supports serial port communication to connect via USB serial at 115200 bit/s 8N1 (8 data bits, no parity, 1 stop bit):
*: <code>tio /dev/ttyUSB0</code>
*: <code>screen /dev/ttyUSB0 115200</code>
*: <code>minicom -D /dev/ttyUSB0 -b 115200</code>
** Install one of the above from your distribution's package manager if none are already installed.
** The device may have a different name, particularly if multiple USB serial devices are connected. On macOS it will have a name like <code>/dev/tty.usbserial-''nnnn''</code>.
** If ''Permission denied'' is reported, you may need to be added to the group that can access the port with a command like <code>sudo usermod -a -G dialout $USER</code>. Then log out and log back in or use a command like <code>newgrp dialout</code> to create a new shell in that group.
** Ubuntu-based distro users may encounter the error, "cannot open /dev/ttyUSB0: No such file or directory". If this occurs, check the output of <code>sudo dmesg --follow</code> and unplug/replug the USB to look for any errors. If you see an error like, "usb 1-1: usbfs: interface 0 claimed by ch341 while 'brltty' sets config #1", then the brltty service is likely conflicting with this device. Brltty provides access to blind users who use a braille display; if you do not need this service, try disabling it using these commands:
**: <code>sudo systemctl stop brltty-udev.service</code>
**: <code>sudo systemctl mask brltty-udev.service</code>
**: <code>sudo systemctl stop brltty.service</code>
**: <code>sudo systemctl mask brltty.service</code>

== Frequently asked questions ==

'''What is the Performance of the PineTab2 compared to the PineTab-V?'''

The PineTab2 is notably faster than the PineTab-V. You can see this by [https://github.com/ThomasKaiser/sbc-bench/blob/master/Results.md comparing the Quartz64 sbc-bench results to the Star64 ones]. Performance should not be a factor of consideration when purchasing a PineTab-V.

== External resources ==

* PINE64: Introduction of the PineTab-V, [https://www.pine64.org/2023/04/01/march-update-tablet-bonanza/ March Update: Tablet Bonanza!]
* PINE64: Launch of the PineTab-V [https://www.pine64.org/2023/04/10/pinetab-v-and-pinetab2-launch/ PineTab-V and PineTab2 launch]

PineTab-V

2023-08-04T09:31:09Z

Fishwaldo: /* Releases */

[[File:pinetabv_1.jpg|250px|thumb|right|The PineTab-V with the detachable keyboard attached]]

The '''PineTab-V''' is ''PINE64's'' first RISC-V tablet. It is based on the JH7110 64-bit RISC-V SoC. The packaging is very similar to ARM-based [[PineTab2]].

== Introduction ==
In late 2022, PINE64 announced plans to help grow the RISC-V hardware ecosystem alongside the existing ARM-based device line-up. The PineTab-V is an experimental device, which ships without an OS and without any promises. The JH7110 RISC-V SoC, and the RISC-V architecture in more general, is currently best described as having limited Linux support. You can think of it as a convenient development platform targeted at those of you interested in bringing Linux support to JH7110 and, by extension, the entire RISC-V ecosystem.

== State of the software ==

The PineTab-V is an experimental device and lacks dedicated working software – it should therefore only be purchased by people interested in helping with the bring-up process of Linux and BSDs on the RISC-V architecture.

{{Warning|Do not buy the device unless you intend to use it for operating system development purposes.}}

== Releases ==

The PineTab-V ships with ''Factory Test Code''. The factory test reference source code can be found here:

* [https://files.pine64.org/SDK/PineTab-V/PineTab-V_factorytestcode_SDK-20230725.tar.gz PineTab-V_factorytestcode_SDK-20230725.tar.gz] from ''pine64.org'' (8.36GB, MD5 of the TAR-GZip file: ''3e35e2760d82155b024f7601ac2b1275'')
* [https://pine64.my-ho.st:8443/pinetabv/factoryimage/ sdcard.img] pre-built image from the factory SDK. Use ''dd'' to write it to microSD card or the eMMC.

* A KDE Plasma Yocto Image is available [https://pine64.my-ho.st:8443/pinetabv/ here]. use dd or balenaetcher to copy to a SD card and insert into your PTV and boot. Based on the Star64 images developed [https://github.com/Fishwaldo/meta-pine64 here]. Please see this [https://github.com/Fishwaldo/meta-pine64/issues/12 issue] for known problems.

== Variants ==

There are currently two variants of the PineTab-V:

* PineTab-V – 4GB RAM and 64GB eMMC storage
* PineTab-V – 8GB RAM and 128GB eMMC storage

== Features ==
[[File:pinetabv_2.jpg|250px|thumb|right|Front- and backside of the PineTab-V]]
[[File:pinetabv_3.jpg|250px|thumb|right|Backside of the PineTab-V]]

Chassis:

* Dimensions: 242mm x 161mm x 9mm
* Weight: 520 grams (without keyboard), 990 grams (includes keyboard)
* Build: Metal and Plastic
* Color: Matte Black

Display:

* Type: HD IPS capacitive touchscreen, 16.7M colors
* Size: 10.1 inches
* Resolution: 1280×800 pixels, 16:10 ratio

Platform:

* Chipset: StarFive JH7110
* CPU: 64-bit Quad-core 1.5 GHz SiFive U74 RISC-V
* GPU: Imagination Technology BXE-4-32

Memory:

* Internal Flash Memory: 64GB (variant 1) or 128GB (variant 2) eMMC module
* System Memory: 4GB (variant 1) or 8GB (variant 2) LPDDR4 SDRAM
* Expansion: micro SD Card support SDHC and SDXC, up to 2TB

Camera:

* Main Camera: Single 5MP, LED Flash (chipset: Omnivision OV5648)
* Selfie Camera: Single 2MP (chipset: Galaxycore GC02M2)

Sound:

* Loudspeaker: Yes, stereo
* 3.5mm jack with mic: Yes, stereo
* Sound IC: [http://everest-semi.com/pdf/ES8316%20PB.pdf ES8316]

Wireless:

* Chipset: Realtek RTL8852BU
* WLAN: Wi-Fi 802.11 ax/ac/b/g/n, dual-band, hotspot
* Bluetooth: 5.2, A2DP

I/O:

* 1x USB 3.0 Type-C port (front side 3.0, rear side 2.0)
* 1x USB 2.0 Type-C port (also use as charging and debug port)
* 1x USB 2.0 Pogo keyboard port
* 1x microHDMI HD Video output

Battery:

* Removable Li-Po 6000mAh battery
* Charging: 15W – 5V 3A
* Model 30100140 from [https://zgszjjy.com/ zgszjjy]
* Charge IC: [https://www.ti.com/product/BQ25890H BQ25890H]
* Fuel Guage: [http://en.cellwise-semi.com/Public/assests/menu/20230314/64102656c943b.pdf CW2015CHBD]

[[File:PineTab-V-PCB.jpg|thumb|right|PineTab-V Board]]

== Schematics and certifications ==

PineTab-V mainboard schematic:

* [https://files.pine64.org/doc/PineTab/PineTab-V_Schematic_Ver1-20230614.pdf PineTab-V mainboard Released Schematic-20230614 ver 1.0]
* [https://files.pine64.org/doc/PineTab/PineTab-V_comp_ref_top-20230614.pdf PineTab-V PCB Component Reference location v1.0 (top layer)]
* [https://files.pine64.org/doc/PineTab/PineTab-V_comp_ref_bottom-20230614.pdf PineTab-V PCB Component Reference location v1.0 (bottom layer)]
* [https://files.pine64.org/doc/PineTab/pinetab2-V_uart_console_schematic-20221107.pdf PineTab2/PineTab-V UART Dongle Schematic-20221107]

PineTab-V certifications:
* TODO

== Tutorials ==

=== Connecting the UART adapter ===

[[File:PineTab2 USB UARTv2.jpg|thumb|right|300px|UART Adapter]]

The UART serves as a console for early boot and kernel messages, and also offers access to a root shell in the factory test image. The UART adapter allows access to the UART through the USB 2.0 Type-C port:
* Insert the UART adapter face-up in the USB 2.0 Type-C port (the USB port furthest from the power button).
* Connect a USB cable from another computer to the port on the adapter marked "DEBUG". The green LED on the adapter should light up. The other adapter port can be connected to USB power if you don't want to run the tablet on its battery.
* In a terminal window on the other computer, use ''tio'', ''screen'', ''minicom'', or another application that supports serial port communication to connect via USB serial at 115200 bit/s 8N1 (8 data bits, no parity, 1 stop bit):
*: <code>tio /dev/ttyUSB0</code>
*: <code>screen /dev/ttyUSB0 115200</code>
*: <code>minicom -D /dev/ttyUSB0 -b 115200</code>
** Install one of the above from your distribution's package manager if none are already installed.
** The device may have a different name, particularly if multiple USB serial devices are connected. On macOS it will have a name like <code>/dev/tty.usbserial-''nnnn''</code>.
** If ''Permission denied'' is reported, you may need to be added to the group that can access the port with a command like <code>sudo usermod -a -G dialout $USER</code>. Then log out and log back in or use a command like <code>newgrp dialout</code> to create a new shell in that group.
** Ubuntu-based distro users may encounter the error, "cannot open /dev/ttyUSB0: No such file or directory". If this occurs, check the output of <code>sudo dmesg --follow</code> and unplug/replug the USB to look for any errors. If you see an error like, "usb 1-1: usbfs: interface 0 claimed by ch341 while 'brltty' sets config #1", then the brltty service is likely conflicting with this device. Brltty provides access to blind users who use a braille display; if you do not need this service, try disabling it using these commands:
**: <code>sudo systemctl stop brltty-udev.service</code>
**: <code>sudo systemctl mask brltty-udev.service</code>
**: <code>sudo systemctl stop brltty.service</code>
**: <code>sudo systemctl mask brltty.service</code>

== Frequently asked questions ==

'''What is the Performance of the PineTab2 compared to the PineTab-V?'''

The PineTab2 is notably faster than the PineTab-V. You can see this by [https://github.com/ThomasKaiser/sbc-bench/blob/master/Results.md comparing the Quartz64 sbc-bench results to the Star64 ones]. Performance should not be a factor of consideration when purchasing a PineTab-V.

== External resources ==

* PINE64: Introduction of the PineTab-V, [https://www.pine64.org/2023/04/01/march-update-tablet-bonanza/ March Update: Tablet Bonanza!]
* PINE64: Launch of the PineTab-V [https://www.pine64.org/2023/04/10/pinetab-v-and-pinetab2-launch/ PineTab-V and PineTab2 launch]

PineTab-V

2023-08-03T17:11:13Z

Fishwaldo: update some of the chip-sets used.

[[File:pinetabv_1.jpg|250px|thumb|right|The PineTab-V with the detachable keyboard attached]]

The '''PineTab-V''' is ''PINE64's'' first RISC-V tablet. It is based on the JH7110 64-bit RISC-V SoC. The packaging is very similar to ARM-based [[PineTab2]].

== Introduction ==
In late 2022, PINE64 announced plans to help grow the RISC-V hardware ecosystem alongside the existing ARM-based device line-up. The PineTab-V is an experimental device, which ships without an OS and without any promises. The JH7110 RISC-V SoC, and the RISC-V architecture in more general, is currently best described as having limited Linux support. You can think of it as a convenient development platform targeted at those of you interested in bringing Linux support to JH7110 and, by extension, the entire RISC-V ecosystem.

== State of the software ==

The PineTab-V is an experimental device and lacks dedicated working software – it should therefore only be purchased by people interested in helping with the bring-up process of Linux and BSDs on the RISC-V architecture.

{{Warning|Do not buy the device unless you intend to use it for operating system development purposes.}}

== Releases ==

The PineTab-V ships with ''Factory Test Code''. The factory test reference source code can be found here:

* [https://files.pine64.org/SDK/PineTab-V/PineTab-V_factorytestcode_SDK-20230725.tar.gz PineTab-V_factorytestcode_SDK-20230725.tar.gz] from ''pine64.org'' (8.36GB, MD5 of the TAR-GZip file: ''3e35e2760d82155b024f7601ac2b1275'')
* [https://pine64.my-ho.st:8443/pinetabv/factoryimage/ sdcard.img] pre-built image from the factory SDK. Use ''dd'' to write it to microSD card or the eMMC.

== Variants ==

There are currently two variants of the PineTab-V:

* PineTab-V – 4GB RAM and 64GB eMMC storage
* PineTab-V – 8GB RAM and 128GB eMMC storage

== Features ==
[[File:pinetabv_2.jpg|250px|thumb|right|Front- and backside of the PineTab-V]]
[[File:pinetabv_3.jpg|250px|thumb|right|Backside of the PineTab-V]]

Chassis:

* Dimensions: 242mm x 161mm x 9mm
* Weight: 520 grams (without keyboard), 990 grams (includes keyboard)
* Build: Metal and Plastic
* Color: Matte Black

Display:

* Type: HD IPS capacitive touchscreen, 16.7M colors
* Size: 10.1 inches
* Resolution: 1280×800 pixels, 16:10 ratio

Platform:

* Chipset: StarFive JH7110
* CPU: 64-bit Quad-core 1.5 GHz SiFive U74 RISC-V
* GPU: Imagination Technology BXE-4-32

Memory:

* Internal Flash Memory: 64GB (variant 1) or 128GB (variant 2) eMMC module
* System Memory: 4GB (variant 1) or 8GB (variant 2) LPDDR4 SDRAM
* Expansion: micro SD Card support SDHC and SDXC, up to 2TB

Camera:

* Main Camera: Single 5MP, LED Flash (chipset: Omnivision OV5648)
* Selfie Camera: Single 2MP (chipset: Galaxycore GC02M2)

Sound:

* Loudspeaker: Yes, stereo
* 3.5mm jack with mic: Yes, stereo
* Sound IC: [http://everest-semi.com/pdf/ES8316%20PB.pdf ES8316]

Wireless:

* Chipset: Realtek RTL8852BU
* WLAN: Wi-Fi 802.11 ax/ac/b/g/n, dual-band, hotspot
* Bluetooth: 5.2, A2DP

I/O:

* 1x USB 3.0 Type-C port (front side 3.0, rear side 2.0)
* 1x USB 2.0 Type-C port (also use as charging and debug port)
* 1x USB 2.0 Pogo keyboard port
* 1x microHDMI HD Video output

Battery:

* Removable Li-Po 6000mAh battery
* Charging: 15W – 5V 3A
* Model 30100140 from [https://zgszjjy.com/ zgszjjy]
* Charge IC: [https://www.ti.com/product/BQ25890H BQ25890H]
* Fuel Guage: [http://en.cellwise-semi.com/Public/assests/menu/20230314/64102656c943b.pdf CW2015CHBD]

[[File:PineTab-V-PCB.jpg|thumb|right|PineTab-V Board]]

== Schematics and certifications ==

PineTab-V mainboard schematic:

* [https://files.pine64.org/doc/PineTab/PineTab-V_Schematic_Ver1-20230614.pdf PineTab-V mainboard Released Schematic-20230614 ver 1.0]

PineTab-V certifications:
* TODO

== Tutorials ==

=== Connecting the UART adapter ===

[[File:PineTab2 USB UARTv2.jpg|thumb|right|300px|UART Adapter]]

The UART serves as a console for early boot and kernel messages, and also offers access to a root shell in the factory test image. The UART adapter allows access to the UART through the USB 2.0 Type-C port:
* Insert the UART adapter face-up in the USB 2.0 Type-C port (the USB port furthest from the power button).
* Connect a USB cable from another computer to the port on the adapter marked "DEBUG". The green LED on the adapter should light up. The other adapter port can be connected to USB power if you don't want to run the tablet on its battery.
* In a terminal window on the other computer, use ''tio'', ''screen'', ''minicom'', or another application that supports serial port communication to connect via USB serial at 115200 bit/s 8N1 (8 data bits, no parity, 1 stop bit):
*: <code>tio /dev/ttyUSB0</code>
*: <code>screen /dev/ttyUSB0 115200</code>
*: <code>minicom -D /dev/ttyUSB0 -b 115200</code>
** Install one of the above from your distribution's package manager if none are already installed.
** The device may have a different name, particularly if multiple USB serial devices are connected. On macOS it will have a name like <code>/dev/tty.usbserial-''nnnn''</code>.
** If ''Permission denied'' is reported, you may need to be added to the group that can access the port with a command like <code>sudo usermod -a -G dialout $USER</code>. Then log out and log back in or use a command like <code>newgrp dialout</code> to create a new shell in that group.
** Ubuntu-based distro users may encounter the error, "cannot open /dev/ttyUSB0: No such file or directory". If this occurs, check the output of <code>sudo dmesg --follow</code> and unplug/replug the USB to look for any errors. If you see an error like, "usb 1-1: usbfs: interface 0 claimed by ch341 while 'brltty' sets config #1", then the brltty service is likely conflicting with this device. Brltty provides access to blind users who use a braille display; if you do not need this service, try disabling it using these commands:
**: <code>sudo systemctl stop brltty-udev.service</code>
**: <code>sudo systemctl mask brltty-udev.service</code>
**: <code>sudo systemctl stop brltty.service</code>
**: <code>sudo systemctl mask brltty.service</code>

== Frequently asked questions ==

'''What is the Performance of the PineTab2 compared to the PineTab-V?'''

The PineTab2 is notably faster than the PineTab-V. You can see this by [https://github.com/ThomasKaiser/sbc-bench/blob/master/Results.md comparing the Quartz64 sbc-bench results to the Star64 ones]. Performance should not be a factor of consideration when purchasing a PineTab-V.

== External resources ==

* PINE64: Introduction of the PineTab-V, [https://www.pine64.org/2023/04/01/march-update-tablet-bonanza/ March Update: Tablet Bonanza!]
* PINE64: Launch of the PineTab-V [https://www.pine64.org/2023/04/10/pinetab-v-and-pinetab2-launch/ PineTab-V and PineTab2 launch]

PineTab-V

2023-07-30T06:56:49Z

Fishwaldo: add link to compiled image from factory sdk

STAR64

2023-05-25T10:00:12Z

Fishwaldo: instructions to reset the eeprom

[[File:Star64.jpg|400px|thumb|right|The STAR64]]

The '''Star64''' is a RISC-V based Single Board Computer powered by StarFive JH7110 Quad-Core SiFive U74 64-Bit CPU, Imagination Technology BX-4-32 GPU and supports up to 8GB 1866MHz LPDDR4 memory. It provides an eMMC module socket, MicroSD Card slot, PCI-e, Pi-2 Bus, USB 3.0, and many other peripheral interfaces for makers to integrate with sensors and other devices.

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

== Software releases ==

The releases are still in '''alpha''' state and are only fit for testing purposes.

* [https://github.com/Fishwaldo/meta-pine64 A Set of Images built with Yocto for commandline, weston and plasma - Where possible, GPU/VPU acceleration is enabled.]

== SoC and Memory Specification ==
* Based on [https://www.starfivetech.com/en/site/soc StarFive JH7110]
[[File:StarFive.jpg|right]]
[[File:JH7110_Block_Diagram.png|800px]]

=== CPU Architecture ===
* [https://www.sifive.com/cores/u74 Quad-core U74 up to 1.5GHz CPU]
[[File:SiFive.jpg|right|200px]]
* Fully compliant with the RISC-V ISA specification
* 64-bit RISC-V Application Core
* 32KB L1 I-cache with ECC
* 32KB L1 D-cache with ECC
* 8 Region Physical Memory Protection
* Virtual Memory support with up to 47 Physical Address bits
* Integrated up to 2MB L2 Cache with ECC
* includes RV64IMAC S7 monitor core, 16 KB L1 I-Cache with ECC, 8 KB DTIM with ECC
* 32-bit RISC-V CPU core (E24) for real time control, support RV32IMFC RISC-V ISA

=== GPU Architecture ===
* [https://www.imaginationtech.com/product/img-bxe-4-32-mc4/ Imagination Technology BXE-4-32 up to 600Mhz GPU]
[[File:imgtech.png|right|200px]]
* Support OpenCL 3.0
* Support OpenGL ES 3.2
* Support Vulkan 1.2
* Tile-based deferred rendering architecture for 3D graphics workloads, with concurrent processing of multiple tiles
* Support for GPU visualization, up to 8 virtual GPUs
* On fly frame buffer compression and decompression (TFBC) algorithm
* Performance: 128 FP32 FLOPs/Clock, 256 FP16 FLOPs/Clock

=== System Memory ===
* LPDDR4 RAM Memory Variants: 2GB, 4GB and 8GB.

== Board Features ==

=== Video ===
* Digital Video output up to 4K@30Hz
* 4K HDR @ 60fps
* H.264/AVC Base/Main/High/High10 profile @ level 5.1; up to 4K×2K @ 60fps
* H.265/HEVC Main/Main10 profile @ level 5.1 High-tier; up to 4K×2K @ 60fps

=== Audio ===
* 3.5mm audio Jack

=== Network ===
* Single or Dual 10/100/1000Mbps Ethernet
* 2.4GHz/5Ghz MIMO WiFi 802.11 b/g/n/ac with Bluetooth 5.2

=== Storage ===
* on-board 128Mbit (16MByte) XSPI NOR flash memory - bootable
* microSD - bootable, supports SDHC and SDXC and storage up to 256GB
* eMMC - bootable (optional eMMC Module)
* 1× USB3.0 Dedicated Host port
* 3× USB2.0 Host port

=== Expansion Ports ===
* PCIe 2.0 ×1 lane
* 2×20 pins "Pi2" GPIO Header
** The JH7110 SoC supports full multiplexing of its GPIO pins. This means any non-power/ground pin can be configured to any function outlined in Table 4-2 of the SoC datasheet.
* 4 lane MiPi DSI port for LCD panel
* 4 lane MiPi CSI port for camera module

== Board Information, Schematics and Certifications ==
* Model "A" Baseboard Dimensions: 133mm×80mm×19mm
* Input Power: DC 12V @ 3A 5.5mmOD/2.1mmID center-positive Barrel DC Jack connector
* Schematic:
** [https://files.pine64.org/doc/star64/Star64_Schematic_V1.1_20230504.pdf STAR64 Schematic 20230504 v1.1 (Production Released version)]
** [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf STAR64 Schematic 20220721 v1.0 (Prototype Board)]
* Certifications:
** Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary. However, PINE64 still submits the SBC for FCC, CE, and ROHS certifications and obtain the certificates to prove that the SBC board can pass the testing. Please note, a final commercial product needs to perform its own testing and obtain its own certificate.
** Not yet available

== Datasheets for Components and Peripherals ==
* Star64 JH7110 SoC information:
** [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Product_Brief.pdf StarFive JH7110 SoC Product Brief]
** [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Datasheet.pdf StarFive JH7110 SoC Datasheet]
** [https://doc-en.rvspace.org/JH7110/TRM/ StarFive JH7110 SoC Technical Reference Manual]
* X-Power PMU information:
** [https://files.pine64.org/doc/datasheet/star64/AXP15060%20datasheet%20V0.1.pdf X-Power AXP15060 Datasheet V0.1]
* LPDDR4 (200 Balls) SDRAM:
** [https://files.pine64.org/doc/datasheet/rockpro64/SM512M32Z01MD2BNP(200BALL).pdf Micron LPDDR4 Mobile LPDDR4 Datasheet]
* eMMC information:
** [https://files.pine64.org/doc/rock64/PINE64_eMMC_Module_20170719.pdf PINE64 eMMC module schematic]
** [https://files.pine64.org/doc/rock64/usb%20emmc%20module%20adapter%20v2.pdf PINE64 USB adapter for eMMC module V2 schematic]
** [https://files.pine64.org/doc/rock64/USB%20adapter%20for%20eMMC%20module%20PCB.tar PINE64 USB adapter for eMMC module PCB in JPEG]
** [https://files.pine64.org/doc/datasheet/pine64/E-00517%20FORESEE_eMMC_NCEMAM8B-16G%20SPEC.pdf 16GB Foresee eMMC Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/SDINADF4-16-128GB-H%20data%20sheet%20v1.13.pdf 32GB/64GB/128GB SanDisk eMMC Datasheet]
* SPI NOR Flash information:
** [https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf GigaDevice 128Mb XSPI-Flash Datasheet]
* Ethernet related info:
** TBA
* WiFi/BT module info:
** [https://files.pine64.org/doc/datasheet/star64/Fn-Link_6252B-UUB_datasheet_V1.1_20220329.pdf Fn-Link 6252B 11AC Dual Band 2T2R WiFi + Bluetooth5.2 Datasheet]

== Bringup Notes ==

# The USB over-current protection is not wired up correctly to the USB ports on Star64. The default Starfive Kernel will disable USB on boot as it belives the ports are overcurrent. This ugly hack works around it: https://github.com/Fishwaldo/Star64_linux/commit/2634a13ecfa1fa5c232ec2b9f6a6b6b0d9d66898
# The Wifi Chip (RTL8852BU) is not supported in the kernel. There is a Vendor Driver that is imported in the kernel at https://github.com/Fishwaldo/Star64_linux/tree/Star64_devel/drivers/staging/rtl8852bu but it really needs a cleanup. It does BUG_ON at boot, but wifi is confirmed working.
# HDMI can be finicky. 4K Monitors are known to have a issue. This is also relevant for VisionFive2
# Some kernels/distributions do not detect the total memory correctly. This is due to the way u-boot is configured. Currently, u-boot reads the memory from the eeprom on the Star64, and updates the dtb file before booting the kernel. Distributions that boot differently may not get the updated dtb file with the correct memory entry. You can work around this by recompiling the DTB with the correct memory for your board
# VisionFive2 Kernels will only offer limited functionality on the Star64 - Mainly USB, Wifi and PCI will not work.
# The 4-pin 12 volt JST-XH-4A connector found on the Star64 is incompatible with the dual SATA power adapter intended for the ROCKPro64. The connector on the Star64 is rotated 180 degrees to the one on the ROCKPro64, resulting in the cable receiving +12V where GND is expected and vice versa. The cable's internal circuitry ends up shorting in this configuration.

== Potential Issues ==
If you get the following error in u-boot (or your 8Gb board is only detected as 4Gb) the possible problem is a empty, or corrupt eeprom:
<pre>
Not a StarFive EEPROM data format - magic error
EEPROM dump: (0x100 bytes)
00: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
10: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
20: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
30: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
80: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
90: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
A0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
B0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
C0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
D0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
E0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
F0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
</pre>
Then from within u-boot execute the following commands:
<pre>
mac initilize
mac product_id <PRODUCTID>
mac write_eeprom
</pre>

Set ProductID to either:
* For 8Gb Models: STAR64V1-2310-D008E000-01234567
* for 4Gb Models: STAR64V1-2310-D004E000-01234567

You can replace the last 8 digits with a random number if you wish.
If these commands fail, please join the #star64 channel in the Pine64 community for more assistance.

== Prototype Bringup Notes ==

Note: This section is relevant to the original prototype (v1.0) that a few developers received.

# The [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf schematic] has several discrepancies with actual board labels.
# The serial console can be found with TXD on pin 8 and RXD on pin 10; a convention common to Pi-style boards. Use the 40pin header pinouts in color on page one and not the schematic prose.
# If you have only a single core running and no PCI card present, it appears to power up via the +5V/GND lines from the USB serial adapter pins.
# It will not boot from a VisionFive R1 uSD card.
# The boot device switch labels and the silk screen are inverted. "0" means "On".
# 2021.10-00001-gdbdaad919b will attempt to boot from SPI, but it appears blank. If you let it for many minutes, the device will eventually time out and boot OpenSBI v1.0 from (SPI?). This will fail, but only after self-identifying as a VisionFive R2, complete with five cores and 4 GB of RAM, before failing. A "press any key" timeout is offered, but I've been unable to make it stop. It will eventually crash with:

Loading Environment from SPIFlash... SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
*** Warning - bad CRC, using default environment

Not a StarFive EEPROM data format - magic error

[[Category:STAR64]] [[Category:StarFive JH7110]]

STAR64

2023-04-29T09:06:43Z

Fishwaldo: /* Bringup Notes */

[[File:Star64.jpg|400px|thumb|right|The STAR64]]

The '''Star64''' is a RISC-V based Single Board Computer powered by StarFive JH7110 Quad-Core SiFive U74 64-Bit CPU, Imagination Technology BX-4-32 GPU and supports up to 8GB 1866MHz LPDDR4 memory. It provides an eMMC module socket, MicroSD Card slot, PCI-e, Pi-2 Bus, USB 3.0, and many other peripheral interfaces for makers to integrate with sensors and other devices.

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

== Software releases ==

The releases are still in '''alpha''' state and are only fit for testing purposes.

* [https://github.com/Fishwaldo/meta-pine64 A Set of Images built with Yocto for commandline, weston and plasma - Where possible, GPU/VPU acceleration is enabled.]

== SoC and Memory Specification ==
* Based on [https://www.starfivetech.com/en/site/soc StarFive JH7110]
[[File:StarFive.jpg|right]]
[[File:JH7110_Block_Diagram.png|800px]]

=== CPU Architecture ===
* [https://www.sifive.com/cores/u74 Quad-core U74 up to 1.5GHz CPU]
[[File:SiFive.jpg|right|200px]]
* Fully compliant with the RISC-V ISA specification
* 64-bit RISC-V Application Core
* 32KB L1 I-cache with ECC
* 32KB L1 D-cache with ECC
* 8 Region Physical Memory Protection
* Virtual Memory support with up to 47 Physical Address bits
* Integrated up to 2MB L2 Cache with ECC
* includes RV64IMAC S7 monitor core, 16 KB L1 I-Cache with ECC, 8 KB DTIM with ECC
* 32-bit RISC-V CPU core (E24) for real time control, support RV32IMFC RISC-V ISA

=== GPU Architecture ===
* [https://www.imaginationtech.com/product/img-bxe-4-32-mc4/ Imagination Technology BXE-4-32 up to 600Mhz GPU]
[[File:imgtech.png|right|200px]]
* Support OpenCL 3.0
* Support OpenGL ES 3.2
* Support Vulkan 1.2
* Tile-based deferred rendering architecture for 3D graphics workloads, with concurrent processing of multiple tiles
* Support for GPU visualization, up to 8 virtual GPUs
* On fly frame buffer compression and decompression (TFBC) algorithm
* Performance: 128 FP32 FLOPs/Clock, 256 FP16 FLOPs/Clock

=== System Memory ===
* LPDDR4 RAM Memory Variants: 2GB, 4GB and 8GB.

== Board Features ==

=== Video ===
* Digital Video output up to 4K@30Hz
* 4K HDR @ 60fps
* H.264/AVC Base/Main/High/High10 profile @ level 5.1; up to 4K×2K @ 60fps
* H.265/HEVC Main/Main10 profile @ level 5.1 High-tier; up to 4K×2K @ 60fps

=== Audio ===
* 3.5mm audio Jack

=== Network ===
* Single or Dual 10/100/1000Mbps Ethernet
* 2.4GHz/5Ghz MIMO WiFi 802.11 b/g/n/ac with Bluetooth 5.2

=== Storage ===
* on-board 128Mbit (16MByte) XSPI NOR flash memory - bootable
* microSD - bootable, supports SDHC and SDXC and storage up to 256GB
* eMMC - bootable (optional eMMC Module)
* 1× USB3.0 Dedicated Host port
* 3× USB2.0 Host port

=== Expansion Ports ===
* PCIe 2.0 ×1 lane
* 2×20 pins "Pi2" GPIO Header
** The JH7110 SoC supports full multiplexing of its GPIO pins. This means any non-power/ground pin can be configured to any function outlined in Table 4-2 of the SoC datasheet.
* 4 lane MiPi DSI port for LCD panel
* 4 lane MiPi CSI port for camera module

== Board Information, Schematics and Certifications ==
* Model "A" Baseboard Dimensions: 133mm×80mm×19mm
* Input Power: DC 12V @ 3A 5.5mmOD/2.1mmID center-positive Barrel DC Jack connector
* Schematic:
** [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf STAR64 Schematic 20220721 v1.0 (Prototype Board)]
* Certifications:
** Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary. However, PINE64 still submits the SBC for FCC, CE, and ROHS certifications and obtain the certificates to prove that the SBC board can pass the testing. Please note, a final commercial product needs to perform its own testing and obtain its own certificate.
** Not yet available

== Datasheets for Components and Peripherals ==
* Star64 JH7110 SoC information:
** [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Product_Brief.pdf StarFive JH7110 SoC Product Brief]
** [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Datasheet.pdf StarFive JH7110 SoC Datasheet]
* X-Power PMU information:
** [https://files.pine64.org/doc/datasheet/star64/AXP15060%20datasheet%20V0.1.pdf X-Power AXP15060 Datasheet V0.1]
* LPDDR4 (200 Balls) SDRAM:
** [https://files.pine64.org/doc/datasheet/rockpro64/SM512M32Z01MD2BNP(200BALL).pdf Micron LPDDR4 Mobile LPDDR4 Datasheet]
* eMMC information:
** [https://files.pine64.org/doc/rock64/PINE64_eMMC_Module_20170719.pdf PINE64 eMMC module schematic]
** [https://files.pine64.org/doc/rock64/usb%20emmc%20module%20adapter%20v2.pdf PINE64 USB adapter for eMMC module V2 schematic]
** [https://files.pine64.org/doc/rock64/USB%20adapter%20for%20eMMC%20module%20PCB.tar PINE64 USB adapter for eMMC module PCB in JPEG]
** [https://files.pine64.org/doc/datasheet/pine64/E-00517%20FORESEE_eMMC_NCEMAM8B-16G%20SPEC.pdf 16GB Foresee eMMC Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/SDINADF4-16-128GB-H%20data%20sheet%20v1.13.pdf 32GB/64GB/128GB SanDisk eMMC Datasheet]
* SPI NOR Flash information:
** [https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf GigaDevice 128Mb XSPI-Flash Datasheet]
* Ethernet related info:
** TBA
* WiFi/BT module info:
** [https://files.pine64.org/doc/datasheet/star64/Fn-Link_6252B-UUB_datasheet_V1.1_20220329.pdf Fn-Link 6252B 11AC Dual Band 2T2R WiFi + Bluetooth5.2 Datasheet]

== Bringup Notes ==

# The USB over-current protection is not wired up correctly to the USB ports on Star64. The default Starfive Kernel will disable USB on boot as it belives the ports are overcurrent. This ugly hack works around it: https://github.com/Fishwaldo/Star64_linux/commit/2634a13ecfa1fa5c232ec2b9f6a6b6b0d9d66898
# The Wifi Chip (RTL8852BU) is not supported in the kernel. There is a Vendor Driver that is imported in the kernel at https://github.com/Fishwaldo/Star64_linux/tree/Star64_devel/drivers/staging/rtl8852bu but it really needs a cleanup. It does BUG_ON at boot, but wifi is confirmed working.
# HDMI can be finicky. 4K Monitors are known to have a issue. This is also relevant for VisionFive2
# Some kernels/distributions do not detect the total memory correctly. This is due to the way u-boot is configured. Currently, u-boot reads the memory from the eeprom on the Star64, and updates the dtb file before booting the kernel. Distributions that boot differently may not get the updated dtb file with the correct memory entry. You can work around this by recompiling the DTB with the correct memory for your board
# VisionFive2 Kernels will only offer limited functionality on the Star64 - Mainly USB, Wifi and PCI will not work.

== Prototype Bringup Notes ==

Note: This section is relevant to the original prototype (v1.0) that a few developers received.

# The [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf schematic] has several discrepancies with actual board labels.
# The serial console can be found with TXD on pin 8 and RXD on pin 10; a convention common to Pi-style boards. Use the 40pin header pinouts in color on page one and not the schematic prose.
# If you have only a single core running and no PCI card present, it appears to power up via the +5V/GND lines from the USB serial adapter pins.
# It will not boot from a VisionFive R1 uSD card.
# The boot device switch labels and the silk screen are inverted. "0" means "On".
# 2021.10-00001-gdbdaad919b will attempt to boot from SPI, but it appears blank. If you let it for many minutes, the device will eventually time out and boot OpenSBI v1.0 from (SPI?). This will fail, but only after self-identifying as a VisionFive R2, complete with five cores and 4 GB of RAM, before failing. A "press any key" timeout is offered, but I've been unable to make it stop. It will eventually crash with:

Loading Environment from SPIFlash... SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
*** Warning - bad CRC, using default environment

Not a StarFive EEPROM data format - magic error

[[Category:STAR64]] [[Category:StarFive JH7110]]

STAR64

2023-04-29T08:48:59Z

Fishwaldo: /* Software releases */

Ox64

2023-01-19T04:01:55Z

Fishwaldo:

[[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, pokey 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 ===
* [https://www.t-head.cn/product/c906?lang=en T_head C906 480MHz 64-bit RISC-V CPU]
[[File:T-Head.png|right|200px]]
** 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

=== 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 ==
* Baseboard Dimensions: 51mm x 21mm x 19mm x 3.5mm (Breadboard friendly)
* Input Power: 5V 0.5A microSD or USB-C port
* Schematic:
=== Production version schematic: ===
** Pinout:
[[file:0x64pinout.png]]
** [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)
** STM32F401 BlackPill - running the [https://github.com/blackmagic-debug/blackmagic/tree/main/src/platforms/blackpillv2 Black Magic Debug] firmware
** 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.

== GitHub/Gitlab ==
* [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]

== Articles and Blogs ==
* [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]

== 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]]

Ox64

2023-01-19T04:01:04Z

Fishwaldo: Add links to updated kernel development efforts and buildroot

[[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
* [https://github.com/openbouffalo/OBLFR OpenBouffalo Firmware] low_load drivers by Fishwaldo

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 ===
* [https://www.t-head.cn/product/c906?lang=en T_head C906 480MHz 64-bit RISC-V CPU]
[[File:T-Head.png|right|200px]]
** 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

=== 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 ==
* Baseboard Dimensions: 51mm x 21mm x 19mm x 3.5mm (Breadboard friendly)
* Input Power: 5V 0.5A microSD or USB-C port
* Schematic:
=== Production version schematic: ===
** Pinout:
[[file:0x64pinout.png]]
** [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)
** STM32F401 BlackPill - running the [https://github.com/blackmagic-debug/blackmagic/tree/main/src/platforms/blackpillv2 Black Magic Debug] firmware
** 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.

== GitHub/Gitlab ==
* [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]

== Articles and Blogs ==
* [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]

== 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]]

Ox64

2022-12-22T17:43:47Z

Fishwaldo: add pinout

[[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 ===

OS images are still in '''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 ===
* [https://www.t-head.cn/product/c906?lang=en T_head C906 480MHz 64-bit RISC-V CPU]
[[File:T-Head.png|right|200px]]
** 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

=== 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 ==
* Baseboard Dimensions: 51mm x 21mm x 19mm x 3.5mm (Breadboard friendly)
* Input Power: 5V 0.5A microSD or USB-C port
* Schematic:
=== Production version schematic: ===
** Pinout:
[[file:0x64pinout.png]]
** [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://files.pine64.org/doc/datasheet/ox64/BL808_RM_en_1.0(open).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 a modified version of [https://github.com/sanjay900/picoprobe/releases/tag/v1.0 picoprobe]
** Adapters based on the CP2102
*** This also includes ESP32s with this chip on board, 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
** STM32F401 BlackPill - running the [https://github.com/blackmagic-debug/blackmagic/tree/main/src/platforms/blackpillv2 Black Magic Debug] firmware
** 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.

== GitHub/Gitlab ==
* [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]

== Articles and Blogs ==
* [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)]

== 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]]

File:0x64pinout.png

2022-12-22T17:40:50Z

Fishwaldo: