PINE64 - User contributions [en]

Quartz64 Software Releases

2023-05-17T20:18:24Z

Ngp: Fixes formatting

This page contains a list of all available operating systems for the [[Quartz64]] in alphabetical order, as well as links to other resources.

== Software releases ==

{{warning|You are strongly encouraged to procure a 3.3V UART serial adapter capable of running at 1.5 mbauds, such as [https://pine64.com/product/serial-console-woodpecker-edition/ the Woodpecker] if you want to use a Quartz64, as some images' U-Boot may have no video output on this chip.}}

{{note|'''Note:''' The images are provided by the community, not by PINE64. Most community projects currently aim at getting mainline Linux running on the board, not some vendor provided kernel that will never be receiving updates. A mainline-first approach allows for the boards to continue receiving important updates, such as security updates, for years to come, as well as have higher quality code in the kernel as it underwent independent review, but does mean that not all aspects of the hardware work right out of the gate.}}

=== Armbian ===
[[File:armbian.png|right|100px]]

'''Armbian''' is a base operating system platform for single board computers

* Lightweight Debian or Ubuntu based Linux distribution specialized for ARM development boards
* Each system is compiled, assembled and optimized by [https://github.com/armbian/build Armbian Build Tools]
* It has powerful build and software development tools to make custom builds

Download:
{{Info|This image appears to have issues detecting more than 2GB of RAM.It is strongly recommended to use a different distribution.}}

* [https://github.com/armbian/build/releases/ latest, as fresh as possible, upon code change, images]

Notes:

* Support on Armbian forums https://forum.armbian.com/forum/96-upcoming-hardware-wip/

=== DietPi ===
[[File:dietpi.png|right|100px]]

'''DietPi''' is a lightweight, yet easy to setup and feature-rich Linux distribution, based on ''Debian''. To find out more about DietPi, please visit the [https://dietpi.com/docs/ official documentation]. Discuss the Quartz64 build(s) on the [https://forum.pine64.org/showthread.php?tid=17601 PINE64 forum thread].

Download:
* Quartz64 Model A: [https://dietpi.com/downloads/images/DietPi_Quartz64A-ARMv8-Bullseye.7z Direct download from dietpi.com]
* Quartz64 Model B: [https://dietpi.com/downloads/images/DietPi_Quartz64B-ARMv8-Bullseye.7z Direct download from dietpi.com]
* SOQuartz: [https://dietpi.com/downloads/images/DietPi_SOQuartz-ARMv8-Bullseye.7z Direct download from dietpi.com]

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

=== Manjaro ARM ===
[[File:Manjaro-logo.svg|right|100px]]

'''Manjaro ARM''' is a user friendly rolling release distribution, based on Arch Linux ARM.

Download:

* Quartz64 Model A: [https://github.com/manjaro-arm/quartz64-a-images/releases Image on GitHub]
* Quartz64 Model B: [https://github.com/manjaro-arm/quartz64-b-images/releases Image on GitHub]

Notes:

Most of the hardware support is already available in the mainline kernel. If some devices doesn't work it is possible to swap to the linux-quartz64 kernel <code>pacman -S linux-quartz64</code>.

Default username and password over SSH is <code>oem</code>/<code>oem</code>.

Following desktop options available:
* Gnome
* KDE Plasma
* Mate
* Sway
* XFCE
as well as minimal image without desktop.

=== NetBSD ===

'''NetBSD''' is a free, fast, secure, and highly portable Unix-like Open Source operating system. It relies upon the UEFI support in Tianocore. Before NetBSD 10 is released, the latest version of NetBSD-current should be used.

Download:
* [http://nycdn.netbsd.org/pub/NetBSD-daily/HEAD/ NetBSD daily builds top level] from inside here, navigate to a date, and inside the images/ subdirectory are installable images. Use the one called "NetBSD-<version>-evbarm-aarch64-install.img.gz".

Notes:
* This image can be written to a supported device, such as the eMMC interface, any USB storage device, NVMe, and PCIe AHCI SATA are all supported with builds after 2022-01-15.
* Currently this can not be shared with the EDK2 port, ie, microSD for EDK2 and some other media for NetBSD.

=== pgwipeout's Quartz64 CI ===

pgwipeout provides continuously rebuilt set of images for Quartz64 devices which includes a Debian installer and a buildroot rescue environment. It is aimed at advanced users who generally know their way around a Linux system, and as a baseline for whether something is working or not. Works on both SD cards and eMMC, uses pgwipeout's patched kernel. Kernels aren't auto-updated on the installed system, so the user manually has to do this by mounting the actual correct boot partition.

Download:
* https://gitlab.com/pgwipeout/quartz64_ci/-/pipelines (Click the three dots on the right, download the merge-job archive.)

Notes:

For Quartz64 Model A, flash ''rk3566-quartz64-a.dtb.img.xz''. On Linux, you can for example do this as follows, assuming your target device is ''/dev/sdX'':

sudo -i; xzcat /path/to/rk3566-quartz64-a.dtb.img.xz > /dev/sdX

For Quartz64 Model B, use ''rk3566-quartz64-b.dtb.img.xz'' instead.

For line by line instructions to boot Quartz64 CI on a microSD card and use it to install Debian onto an eMMC follow these instructions [[Quartz64 Installing Debian]]

=== Plebian ===

Plebian stands for '''P'''INE64 '''L'''ive D'''ebian''' and aims to be a fairly vanilla live Debian image for Quartz64 and SOQuartz devices, based on Debian Bookworm.

* [https://github.com/Plebian-Linux/quartz64-images/releases Download Release Images]
* [https://github.com/Plebian-Linux/quartz64-images/blob/main/RUNNING.md Read The Instructions]
* [https://plebian.org/ Visit plebian.org to learn more]

To flash, run (replace ''/dev/sdX'' with your target block device):

$ xzcat imagename.img.xz | sudo dd of=/dev/sdX bs=4M oflag=dsync status=progress

Some quick notes:

* You will be asked to change your password on first login (for what the default login is, read the instructions!)
* Root file system is grown to take up the entire space of your boot device
* NetworkManager is used instead of Debian's interfaces config to be more flexible with what adapters are plugged in and working
* An sshd is started on port 22 with freshly generated keys

=== Tianocore EDK II port by jmcneill ===

This (as of 2021-12-30) is a work in progress to enable UEFI enabled systems, and is able to bring up SD, eMMC, USB, PCIe with SATA and NVMe, HDMI, thermal sensors, TRNG, as well as general Cortex A-55 features. Known to work with NetBSD -current, and the ESXi Arm fling version 1.8.

Download:
* [https://github.com/jaredmcneill/quartz64_uefi jmcneill's Quartz64 UEFI Github]

Notes:
* The microSD card image should be written to an microSD card and installed. Currently, using the same card for the operating system as well may be problematic.

== BSP Linux SDK ==

The '''BSP Linux SDK ver 4.19'' for the Quartz64 Model A.

Download:
* [http://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_BSP%20Linux.tar.gz Direct download] from ''pine64.org'' (32.67GB, MD5 of the TAR-GZip file ''24554419aec29700add97167a3a4c9ed'')

== Android SDK ==

=== Android 11 SDK ===

The '''Android 11 SDK''' for the Quartz64 Model A SBC.

Download:
* [http://files.pine64.org/SDK/Quartz64/QUARTZ64_SDK_android11.tar.gz Direct download] from ''pine64.org'' (79.00GB, MD5 of the TAR-GZip file ''77c2ff57ea3372fb04da7fb49e17d12b'')
* Just the boot blobs (<1MB): [[File:Rk35-blobs.tar.gz]]

=== Android 11 Production Test Builds ===

==== Android 11 Stock ====
The '''Android 11 Stock''' images for eMMC boot for the Quartz64 Model A. This is test build that was used during product testing.

Download:
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_dd_20210604_stock_android11_emmcboot-8GB.img.gz Stock image for the 8GB eMMC module] from ''pine64.org'' (819MB, MD5 of the Gzip file ''e4365753e584d9fce1b8f10f095eede6'', build 20210604)
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_dd_20210604_stock_android11_emmcboot-16GB.img.gz Stock image for the 16GB eMMC module] from ''pine64.org'' (1.10GB, MD5 of the Gzip file ''491c5f7744b0ca0b74ae76e607051836'', build 20210604)
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_dd_20210604_stock_android11_emmcboot-32GB.img.gz Stock image for the 32GB eMMC module] from ''pine64.org'' (846MB, MD5 of the Gzip file ''47a6f0cdac8bad06cb920743849a8894'', build 20210604)
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_dd_20210604_stock_android11_emmcboot-64GB.img.gz Stock image for the 64GB eMMC module] from ''pine64.org'' (884MB, MD5 of the Gzip file ''4e2fed6f5db0d55afdc8a142fc0c4fe1'', build 20210604)

Notes:
* Write the disk images to the eMMC modules using the USB adapter, for example using <code>dd</code>.
* Please allow 3-5 minutes boot up time on first time for initialization.

==== Android 11 Production Test Build ====
The '''Android 11 Production Test Build''' for the Quartz64 model A for eMMC boot using ROCKChip tools method. This is a test build that was used during product testing.

Download:
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_20210604_stock_android11_emmcboot.img.gz Direct download] from ''pine64.org'' (812MB, MD5 of the Gzip file ''800f867fdd0d1b2bd7822c156b6067e3'', build 20210604)

Notes:
* Please unzip first and then using [https://files.pine64.org/os/Quartz64/android/RKDevTool_Release_v2.84.zip Rockchip Android tool ver 2.84] to flash in
* For Windows OS environment please install the [https://files.pine64.org/os/Quartz64/android/DriverAssitant_v5.1.1.zip DriverAssistant v5.11] driver first
* The OTG port located at top USB 2.0 port on top of USB 3.0 port, needs USB type A to type A cable.
* Please allow 3-5 minutes boot up time on first time for initialization

==== Android 11 eink SDK ====
This the '''Android 11 eink SDK''' build for 10.3" e-ink panels on the Quartz64 Model A.

Download:
* [http://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_eink.android11_SDK.tar.gz Direct download] from ''pine64.org'' (72.88GB, MD5 of the TAR-GZip file ''293a550584298de4fb95ceae18103672'', build 20210604)
* Just the boot blobs (<1MB): [[File:Rk35-blobs.tar.gz]]

[[Category:Quartz64]]

Quartz64 Software Releases

2023-05-17T20:17:32Z

Ngp: Adds default username/pass on Manjaro ARM

This page contains a list of all available operating systems for the [[Quartz64]] in alphabetical order, as well as links to other resources.

== Software releases ==

{{warning|You are strongly encouraged to procure a 3.3V UART serial adapter capable of running at 1.5 mbauds, such as [https://pine64.com/product/serial-console-woodpecker-edition/ the Woodpecker] if you want to use a Quartz64, as some images' U-Boot may have no video output on this chip.}}

{{note|'''Note:''' The images are provided by the community, not by PINE64. Most community projects currently aim at getting mainline Linux running on the board, not some vendor provided kernel that will never be receiving updates. A mainline-first approach allows for the boards to continue receiving important updates, such as security updates, for years to come, as well as have higher quality code in the kernel as it underwent independent review, but does mean that not all aspects of the hardware work right out of the gate.}}

=== Armbian ===
[[File:armbian.png|right|100px]]

'''Armbian''' is a base operating system platform for single board computers

* Lightweight Debian or Ubuntu based Linux distribution specialized for ARM development boards
* Each system is compiled, assembled and optimized by [https://github.com/armbian/build Armbian Build Tools]
* It has powerful build and software development tools to make custom builds

Download:
{{Info|This image appears to have issues detecting more than 2GB of RAM.It is strongly recommended to use a different distribution.}}

* [https://github.com/armbian/build/releases/ latest, as fresh as possible, upon code change, images]

Notes:

* Support on Armbian forums https://forum.armbian.com/forum/96-upcoming-hardware-wip/

=== DietPi ===
[[File:dietpi.png|right|100px]]

'''DietPi''' is a lightweight, yet easy to setup and feature-rich Linux distribution, based on ''Debian''. To find out more about DietPi, please visit the [https://dietpi.com/docs/ official documentation]. Discuss the Quartz64 build(s) on the [https://forum.pine64.org/showthread.php?tid=17601 PINE64 forum thread].

Download:
* Quartz64 Model A: [https://dietpi.com/downloads/images/DietPi_Quartz64A-ARMv8-Bullseye.7z Direct download from dietpi.com]
* Quartz64 Model B: [https://dietpi.com/downloads/images/DietPi_Quartz64B-ARMv8-Bullseye.7z Direct download from dietpi.com]
* SOQuartz: [https://dietpi.com/downloads/images/DietPi_SOQuartz-ARMv8-Bullseye.7z Direct download from dietpi.com]

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

=== Manjaro ARM ===
[[File:Manjaro-logo.svg|right|100px]]

'''Manjaro ARM''' is a user friendly rolling release distribution, based on Arch Linux ARM.

Download:

* Quartz64 Model A: [https://github.com/manjaro-arm/quartz64-a-images/releases Image on GitHub]
* Quartz64 Model B: [https://github.com/manjaro-arm/quartz64-b-images/releases Image on GitHub]

Notes:

Most of the hardware support is already available in the mainline kernel. If some devices doesn't work it is possible to swap to the linux-quartz64 kernel <code>pacman -S linux-quartz64</code>.

Default username and password over SSH is `oem`/`oem`.

Following desktop options available:
* Gnome
* KDE Plasma
* Mate
* Sway
* XFCE
as well as minimal image without desktop.

=== NetBSD ===

'''NetBSD''' is a free, fast, secure, and highly portable Unix-like Open Source operating system. It relies upon the UEFI support in Tianocore. Before NetBSD 10 is released, the latest version of NetBSD-current should be used.

Download:
* [http://nycdn.netbsd.org/pub/NetBSD-daily/HEAD/ NetBSD daily builds top level] from inside here, navigate to a date, and inside the images/ subdirectory are installable images. Use the one called "NetBSD-<version>-evbarm-aarch64-install.img.gz".

Notes:
* This image can be written to a supported device, such as the eMMC interface, any USB storage device, NVMe, and PCIe AHCI SATA are all supported with builds after 2022-01-15.
* Currently this can not be shared with the EDK2 port, ie, microSD for EDK2 and some other media for NetBSD.

=== pgwipeout's Quartz64 CI ===

pgwipeout provides continuously rebuilt set of images for Quartz64 devices which includes a Debian installer and a buildroot rescue environment. It is aimed at advanced users who generally know their way around a Linux system, and as a baseline for whether something is working or not. Works on both SD cards and eMMC, uses pgwipeout's patched kernel. Kernels aren't auto-updated on the installed system, so the user manually has to do this by mounting the actual correct boot partition.

Download:
* https://gitlab.com/pgwipeout/quartz64_ci/-/pipelines (Click the three dots on the right, download the merge-job archive.)

Notes:

For Quartz64 Model A, flash ''rk3566-quartz64-a.dtb.img.xz''. On Linux, you can for example do this as follows, assuming your target device is ''/dev/sdX'':

sudo -i; xzcat /path/to/rk3566-quartz64-a.dtb.img.xz > /dev/sdX

For Quartz64 Model B, use ''rk3566-quartz64-b.dtb.img.xz'' instead.

For line by line instructions to boot Quartz64 CI on a microSD card and use it to install Debian onto an eMMC follow these instructions [[Quartz64 Installing Debian]]

=== Plebian ===

Plebian stands for '''P'''INE64 '''L'''ive D'''ebian''' and aims to be a fairly vanilla live Debian image for Quartz64 and SOQuartz devices, based on Debian Bookworm.

* [https://github.com/Plebian-Linux/quartz64-images/releases Download Release Images]
* [https://github.com/Plebian-Linux/quartz64-images/blob/main/RUNNING.md Read The Instructions]
* [https://plebian.org/ Visit plebian.org to learn more]

To flash, run (replace ''/dev/sdX'' with your target block device):

$ xzcat imagename.img.xz | sudo dd of=/dev/sdX bs=4M oflag=dsync status=progress

Some quick notes:

* You will be asked to change your password on first login (for what the default login is, read the instructions!)
* Root file system is grown to take up the entire space of your boot device
* NetworkManager is used instead of Debian's interfaces config to be more flexible with what adapters are plugged in and working
* An sshd is started on port 22 with freshly generated keys

=== Tianocore EDK II port by jmcneill ===

This (as of 2021-12-30) is a work in progress to enable UEFI enabled systems, and is able to bring up SD, eMMC, USB, PCIe with SATA and NVMe, HDMI, thermal sensors, TRNG, as well as general Cortex A-55 features. Known to work with NetBSD -current, and the ESXi Arm fling version 1.8.

Download:
* [https://github.com/jaredmcneill/quartz64_uefi jmcneill's Quartz64 UEFI Github]

Notes:
* The microSD card image should be written to an microSD card and installed. Currently, using the same card for the operating system as well may be problematic.

== BSP Linux SDK ==

The '''BSP Linux SDK ver 4.19'' for the Quartz64 Model A.

Download:
* [http://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_BSP%20Linux.tar.gz Direct download] from ''pine64.org'' (32.67GB, MD5 of the TAR-GZip file ''24554419aec29700add97167a3a4c9ed'')

== Android SDK ==

=== Android 11 SDK ===

The '''Android 11 SDK''' for the Quartz64 Model A SBC.

Download:
* [http://files.pine64.org/SDK/Quartz64/QUARTZ64_SDK_android11.tar.gz Direct download] from ''pine64.org'' (79.00GB, MD5 of the TAR-GZip file ''77c2ff57ea3372fb04da7fb49e17d12b'')
* Just the boot blobs (<1MB): [[File:Rk35-blobs.tar.gz]]

=== Android 11 Production Test Builds ===

==== Android 11 Stock ====
The '''Android 11 Stock''' images for eMMC boot for the Quartz64 Model A. This is test build that was used during product testing.

Download:
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_dd_20210604_stock_android11_emmcboot-8GB.img.gz Stock image for the 8GB eMMC module] from ''pine64.org'' (819MB, MD5 of the Gzip file ''e4365753e584d9fce1b8f10f095eede6'', build 20210604)
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_dd_20210604_stock_android11_emmcboot-16GB.img.gz Stock image for the 16GB eMMC module] from ''pine64.org'' (1.10GB, MD5 of the Gzip file ''491c5f7744b0ca0b74ae76e607051836'', build 20210604)
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_dd_20210604_stock_android11_emmcboot-32GB.img.gz Stock image for the 32GB eMMC module] from ''pine64.org'' (846MB, MD5 of the Gzip file ''47a6f0cdac8bad06cb920743849a8894'', build 20210604)
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_dd_20210604_stock_android11_emmcboot-64GB.img.gz Stock image for the 64GB eMMC module] from ''pine64.org'' (884MB, MD5 of the Gzip file ''4e2fed6f5db0d55afdc8a142fc0c4fe1'', build 20210604)

Notes:
* Write the disk images to the eMMC modules using the USB adapter, for example using <code>dd</code>.
* Please allow 3-5 minutes boot up time on first time for initialization.

==== Android 11 Production Test Build ====
The '''Android 11 Production Test Build''' for the Quartz64 model A for eMMC boot using ROCKChip tools method. This is a test build that was used during product testing.

Download:
* [https://files.pine64.org/os/Quartz64/android/Quartz64_model-A_20210604_stock_android11_emmcboot.img.gz Direct download] from ''pine64.org'' (812MB, MD5 of the Gzip file ''800f867fdd0d1b2bd7822c156b6067e3'', build 20210604)

Notes:
* Please unzip first and then using [https://files.pine64.org/os/Quartz64/android/RKDevTool_Release_v2.84.zip Rockchip Android tool ver 2.84] to flash in
* For Windows OS environment please install the [https://files.pine64.org/os/Quartz64/android/DriverAssitant_v5.1.1.zip DriverAssistant v5.11] driver first
* The OTG port located at top USB 2.0 port on top of USB 3.0 port, needs USB type A to type A cable.
* Please allow 3-5 minutes boot up time on first time for initialization

==== Android 11 eink SDK ====
This the '''Android 11 eink SDK''' build for 10.3" e-ink panels on the Quartz64 Model A.

Download:
* [http://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_eink.android11_SDK.tar.gz Direct download] from ''pine64.org'' (72.88GB, MD5 of the TAR-GZip file ''293a550584298de4fb95ceae18103672'', build 20210604)
* Just the boot blobs (<1MB): [[File:Rk35-blobs.tar.gz]]

[[Category:Quartz64]]

PineCone

2023-05-11T00:59:22Z

Ngp: Removes lupyuens reverse engineering blog post, as it contains tainted code.

[[File:Pine64_BL602_EVB_photo-3-small.jpg|thumb|PineCone BL602 EVB (Evaluation Board)]]

The '''PineCone''' is a BL602 evaluation board, which was developed with the goal to challenge the open source community to achieve blob-free and free and open source WiFi and Bluetooth, see the [https://www.pine64.org/2020/10/28/nutcracker-challenge-blob-free-wifi-ble/ Nutcracker Challenge].

== Challenge ==

The goal of the challenge is to achieve a blob-free BL602 for the open source community to achieve a blob-free FOSS Bluetooth and WiFi on PINE64 devices, see [https://www.pine64.org/2020/10/28/nutcracker-challenge-blob-free-wifi-ble/ Nutcracker Challenge: Blob-Free WiFi & BLE].

== BL602 Specifications ==

[[File:BL602_Block_Diagram.jpg|thumb|right]]

CPU:

* 32-bit RV32IMAFC RISC-V “SiFive E24 Core”
* [https://www.sifive.com/cores/e24 SiFive E24 Core information]

Memory:

* 128KB ROM
* 276KB SRAM
* 1Kb eFuse
* 2MB Embedded Flash

Security:

* Secure boot
* Secure debug
* AES 128/192/256
* SHA-1/224/256
* TRNG (True Random Number Generator)
* PKA (Public Key Accelerator)

Wireless:

* Wi-Fi 802.11 b/g/n
* Bluetooth® Low Energy 5.0
* Wi-Fi Fast connection with BLE assistance
* Wi-Fi and BLE coexistence
* Wi-Fi Security WPS/WEP/WPA/WPA2/WPA3
* STA, SoftAP and sniffer modes
* Multi-Cloud connectivity
* 2.4 GHz RF transceiver
* Integrated RF balun, PA/LNA

Package Type:

* 32 pin QFN 4mm x 4mm

JTAG support:

* See below for BL602 impact

== JTAG ==
{| class="wikitable floatright"
!colspan="2" | Default JTAG pins
|-
| GPIO Pin || JTAG Pin
|-
| GPIO17 || TDI
|-
| GPIO11 || TDO
|-
| GPIO12 || TMS
|-
| GPIO14 || TCK
|-
|}

BL602 multiplexes four GPIO pins to provide the familiar JTAG lines. See the accompanying table for the default pin mappings.

These are the default JTAG pins in use after a cold boot. However, many pieces of software, including the demo that's installed by default on new PineCones, remap these pins to other functions. You cannot use the default wiring for JTAG while such software is running. This issue is especially prevalent on the PineCone because three of the default JTAG pins are connected to the onboard RGB LED. Nothing about the LED itself interferes with JTAG, but any program that uses the LED will necessarily remap some of the default JTAG pins to be GPIO.

The MaskROM download mode that the BL602 enters when you tie GPIO8 high does '''not''' remap the default JTAG pins, and so you can and should use that mode while checking basic functionality of your JTAG adapter.

Note that, just as software can remap the default JTAG pins to be something else, it can also remap other pins to be JTAG. Control over this is quite granular, with 5-6 candidate pins for each individual JTAG signal that can be mapped independently of one another. LEE Lup Yuen has written some [https://lupyuen.github.io/articles/openocd#free-the-led-from-jtag-port sample code] showing how to remap the JTAG pins so that your software can use the LED without giving up support for debugging.

== Pine64 USB JTAG Adapter information and schematics ==
* [https://files.pine64.org/doc/Pinenut/PINE64%20USB%20JTAG%20Adapter%20Schematic-20201215.pdf PINE64 USB JTAG Adapter Schematic-20201215.pdf (pine64_ft232hl_board-2020-12-14)]
* [[:File:PINE64_USB_JTAG_Adapter_Schematic_ver_1.0a-20210109.pdf|PINE64 USB JTAG Adapter schematic 20210109 1.0a]]

== PineCone BL602 EVB information and schematics ==

[[File:PADI-II_EVB.png|thumb|right|120px|The board layout]]

The approximate dimensions are 26mm x 43mm.

Schematics: [https://files.pine64.org/doc/Pinenut/Pine64%20BL602%20EVB%20Schematic%20ver%201.1.pdf PineCone BL602 EVB schematic ver 1.1]

Note: In the PineCone revision 1.1 ("BL62B_EVB V1.1" silkscreened on back of board), CC1 and CC2 share one 5.1KΩ resistor. This means the board will fail to power when you use an e-marked USB-C cable like the one that comes with Apple chargers. See [https://medium.com/@leung.benson/how-to-design-a-proper-usb-c-power-sink-hint-not-the-way-raspberry-pi-4-did-it-f470d7a5910 this article] for details of why this happens. The next schematic design will give each line its own 5.1KΩ resistor as per the USB-C specification.

The board uses a CH340 Serial/USB adapter. This chip is commonly used in Arduino-class development boards. It is a full speed (12Mbps) USB interface and has vendor ID 0x1a86 with product ID 0x7523.

The GPIO pins (11, 12, 14, 17) plus the nearby RESET, POWER, and GND pins are all located on one side of the board, on J1 to provide JTAG connection.

== Pinenut-01S Module information and schematics ==

<gallery>
File:Pinenut-01S_PCB-Front.png|200px|The PCB front
File:Pinenut-01S_PCB-Back.png|200px|The PCB back
</gallery>

Schematics and GPIO definitions:

* [https://files.pine64.org/doc/Pinenut/Pinenut-01S%20V1.01%20SCH.pdf Pinenut-01S schematic ver 1.01]
* [https://wiki.pine64.org/images/6/6b/PineNut-01S_v1.01_KiCad.zip PineNut-01S KiCad schematic ver 1.01]
* [https://files.pine64.org/doc/Pinenut/NUT-01S%20GPIO%20Definition%20ver%201.0.pdf Pinenut-01S GPIO Definition ver 1.0]
* [https://files.pine64.org/doc/Pinenut/USB%20Adapter%20for%20Pinenut-01S%20Schematic%20V1.0.pdf USB Programmer adapter for Pinenut-01S schematic ver 1.0]

The default firmware runs the UART at 2000000 bps. It will accept input whilst regularly outputting:

proc_hellow_entry: RISC-V rv32imafc
cur key status:1

== Pinenut-12S Module information ==

<gallery>
File:NUT-12S_module-front.jpg|200px|The Pinenut-12S Module front
File:NUT-12S_module-back.jpg|200px|The Pinenut-12S Module back
</gallery>

GPIO definition: [https://files.pine64.org/doc/Pinenut/NUT-12S%20GPIO%20Definition%20ver%201.0.pdf Pinenut-12S GPIO Definition ver 1.0]

The onboard LED is connected to IO0

== Datasheets for components and peripherals ==

Bouffalo BL-602 SoC information:

* [https://github.com/bouffalolab/bl_docs Bouffalo Lab's official bl_docs repository]: should always contain the latest SoC documentation available, in PDF, HTML, and reStructuredText source forms.
* [https://github.com/pine64/bl602-docs/tree/main/mirrored PINE64's bl602-docs repository]: contains an archive of all historical datasheets and reference manual PDFs but may lag behind Bouffalo's official repository. If you notice that it is, please submit a pull request!

USB/Serial adapter:

* [https://cdn.sparkfun.com/datasheets/Dev/Arduino/Other/CH340DS1.PDF CH340 serial converter]

== Misc notes ==

Planned to be available in at least three form factors:
* NUT-01S -> ESP-01S
* NUT-12S -> ESP-12S
* NUT-15 -> RTL8723/AMPAK

== Loading code ==

To load code, you must move the jumper to the position closest to the edge, press reset, load the code, move the jumper back toward the center of the board, and press reset again.

There are currently a number of loaders in progress, each with differing degrees of completeness and success on various operating systems.

* In the build tree, there is BLFlashCube for Windows, which is a proprietary GUI for flashing images. Linux and macOS binaries are available via [https://dev.bouffalolab.com/download Bouffalo Lab's developer portal].
* [https://github.com/stschake/bl60x-flash bl60x-flash] is in Python and has been reported successful on MacOS catalina (10.15.6) by Punnerud and madushan1000.
* [https://github.com/bouffalolab/BLOpenFlasher BLOpenFlasher] is a WIP, written in go, by Bouffalo Labs to provide source for a flash utility.
* [https://github.com/renzenicolai/bl602tool bl602tool] is a Python utility in development.
* [https://pypi.org/project/bflb-mcu-tool/ Bouffalo's MCU tool] (Mar 2021) Python image tool replaced both of the above. Now combined with eflash loader, deals with partitions, DTS, signing, fuses etc.
* [https://github.com/spacemeowx2/blflash blflash serial flasher] BL602 serial flasher, inspired by BLOpenFlasher

== Development efforts ==

* [https://github.com/pine64/bl_iot_sdk PineCone BL602 GitHub Page (PINE64 fork)] has compilers, linkers, and all the code to build on Windows, Linux (x86_64), and MacOS.
* [https://github.com/bouffalolab/bl_iot_sdk Bouffalo Lab GitHub Page]
* [https://github.com/renzenicolai/bl602-docs/ BL602 Developer organize documentation GitHub Page]
* [https://github.com/renzenicolai/bl602tool BL602 Developer organize tool GitHub Page]
* [https://github.com/stschake/bl60x-flash Programming tool for Bouffalo Labs BL602/BL604 chips]
* [https://github.com/pine64/bl602-re BL602 reverse engineering working group]
* [https://github.com/pine64/bl602-sdio-linux Linux kernel module]
* [https://github.com/tchebb/bl602-docs BL602 Documentation]
* [https://github.com/spacemeowx2/blflash BL602 serial flasher]
* [https://github.com/mkroman/awesome-bouffalo#feature-matrix Awesome Bouffalo]

== Articles and Blogs ==

* [https://lupyuen.github.io/articles/pinecone Quick Peek of PineCone BL602 RISC-V Evaluation Board by Lup Yuen]
* [https://maero.dk/bl602-firmware-image-format/ Documenting the BouffaloLab BL602 firmware image format by MK]
* [https://lupyuen.github.io/articles/openocd Connect PineCone BL602 to OpenOCD by Lup Yuen]
* [https://lupyuen.github.io/articles/debug Debug Rust on PineCone BL602 with VSCode and GDB by Lup Yuen]
* [https://lupyuen.github.io/articles/mynewt Porting Mynewt to PineCone BL602 by Lup Yuen]
* [https://lupyuen.github.io/articles/flash Flashing Firmware to PineCone BL602 by Lup Yuen]
* [https://lupyuen.github.io/articles/led Control PineCone BL602 RGB LED with GPIO and PWM by Lup Yuen]
* [https://lupyuen.github.io/articles/gpio Mynewt GPIO ported to PineCone BL602 RISC-V Board by Lup Yuen]
* [https://lupyuen.github.io/articles/i2c PineCone BL602 talks to I2C Sensors by Lup Yuen]
* [https://lupyuen.github.io/articles/spi PineCone BL602 talks SPI too! by Lup Yuen]
* [https://lupyuen.github.io/articles/display PineCone BL602 Blasting Pixels to ST7789 Display with LVGL Library by Lup Yuen]
* [https://lupyuen.github.io/articles/uart PineCone BL602 Talks UART to Grove E-Ink Display by Lup Yuen]
* [https://lupyuen.github.io/articles/book The RISC-V BL602 Book by Lup Yuen]
* [https://lupyuen.github.io/articles/lora Connect PineCone BL602 to LoRa Transceiver by Lup Yuen]
* [https://lupyuen.github.io/articles/wisblock RAKwireless WisBlock talks LoRa with PineCone BL602 RISC-V Board by Lup Yuen]
* [https://lupyuen.github.io/articles/lora2 PineCone BL602 RISC-V Board Receives LoRa Packets by Lup Yuen]
* [https://lupyuen.github.io/articles/rust Run Rust RISC-V Firmware with BL602 IoT SDK by Lup Yuen]
* [https://lupyuen.github.io/articles/lorawan PineCone BL602 Talks LoRaWAN by Lup Yuen]
* [https://lupyuen.github.io/articles/lisp uLisp and Blockly on PineCone BL602 RISC-V Board by Lup Yuen]
* [https://lupyuen.github.io/articles/wasm Simulate RISC-V BL602 with WebAssembly, uLisp and Blockly by Lup Yuen]
* [https://lupyuen.github.io/articles/boot BL602 Bootloader by Lup Yuen]
* [https://lupyuen.github.io/articles/tflite Machine Learning on RISC-V BL602 with TensorFlow Lite by Lup Yuen]
* [https://lupyuen.github.io/articles/adc Rust on RISC-V BL602: Is It Sunny? by Lup Yuen]
* [https://lupyuen.github.io/articles/rustsim Rust on RISC-V BL602: Simulated with WebAssembly by Lup Yuen]
* [https://lupyuen.github.io/articles/pinedio PineDio Stack BL604 RISC-V Board: Testing The Prototype by Lup Yuen]
* [https://lupyuen.github.io/articles/rhai Rust on RISC-V BL602: Rhai Scripting by Lup Yuen]
* [https://lupyuen.github.io/articles/lorawan2 LoRaWAN on PineDio Stack BL604 RISC-V Board by Lup Yuen]
* [https://lupyuen.github.io/articles/ttn The Things Network on PineDio Stack BL604 RISC-V Board by Lup Yuen]
* [https://lupyuen.github.io/articles/cbor Encode Sensor Data with CBOR on BL602 by Lup Yuen]
* [https://lupyuen.github.io/articles/roblox IoT Digital Twin with Roblox and The Things Network by Lup Yuen]
* [https://lupyuen.github.io/articles/tsen Internal Temperature Sensor on BL602 by Lup Yuen]
* [https://lupyuen.github.io/articles/payload CBOR Payload Formatter for The Things Network by Lup Yuen]
* [https://lupyuen.github.io/articles/prometheus Monitor IoT Devices in The Things Network with Prometheus and Grafana by Lup Yuen]
* [https://lupyuen.github.io/articles/nuttx Apache NuttX OS on RISC-V BL602 and BL604 by Lup Yuen]
* [https://lupyuen.github.io/articles/spi2 SPI on Apache NuttX OS by Lup Yuen]
* [https://lupyuen.github.io/articles/sx1262 LoRa SX1262 on Apache NuttX OS by Lup Yuen]
* [https://lupyuen.github.io/articles/lorawan3 LoRaWAN on Apache NuttX OS by Lup Yuen]
* [https://lupyuen.github.io/articles/rust2 Rust on Apache NuttX OS by Lup Yuen]
* [https://lupyuen.github.io/articles/auto Auto Flash and Test NuttX on RISC-V BL602 by Lup Yuen]
* [https://lupyuen.github.io/articles/loader BL602 EFlash Loader: Reverse Engineered with Ghidra by Lup Yuen]
* [https://lupyuen.github.io/articles/ikea Connect IKEA Air Quality Sensor to Apache NuttX OS by Lup Yuen]
* [https://lupyuen.github.io/articles/bme280 Apache NuttX Driver for BME280 Sensor: Ported from Zephyr OS by Lup Yuen]
* [https://lupyuen.github.io/articles/rusti2c Rust talks I2C on Apache NuttX RTOS by Lup Yuen]
* [https://lupyuen.github.io/articles/st7789 ST7789 Display with LVGL Graphics on Apache NuttX RTOS by Lup Yuen]
* [https://lupyuen.github.io/articles/pinedio2 PineDio Stack BL604 runs Apache NuttX RTOS by Lup Yuen]
* [https://lupyuen.github.io/articles/touch NuttX Touch Panel Driver for PineDio Stack BL604 by Lup Yuen]
* [https://www.robertlipe.com/buttons-on-bl602-nuttx/ Buttons on BL602 NuttX]
* [https://lupyuen.github.io/articles/expander NuttX GPIO Expander for PineDio Stack BL604 by Lup Yuen]
* [https://lupyuen.github.io/articles/auto2 (Mostly) Automated Testing of Apache NuttX RTOS on PineDio Stack BL604 RISC-V Board by Lup Yuen]
* [https://lupyuen.github.io/articles/zig Zig on RISC-V BL602: Quick Peek with Apache NuttX RTOS by Lup Yuen]
* [https://lupyuen.github.io/articles/iot Build an IoT App with Zig and LoRaWAN by Lup Yuen]
* [https://lupyuen.github.io/articles/lvgl Build an LVGL Touchscreen App with Zig by Lup Yuen]
* [https://lupyuen.github.io/articles/sensor Read NuttX Sensor Data with Zig by Lup Yuen]
* [https://lupyuen.github.io/articles/visual Visual Programming with Zig and NuttX Sensors by Lup Yuen]
* [https://youtu.be/1O5Eb8bKxXA Visual Programming with Zig and Apache NuttX Sensors (Video)]

[[Category:PineCone]]