Join us on Discord, Telegram, Matrix

This repository contains the Pine64 fork of Bouffalo Lab's SDK for their BL602 Wi-Fi/BLE Combo RISC-V SoC. The upstream documentation lives in docs/html.

This repository is the central focus of Pine64's Nutcracker Challenge.

In order to build one of the sample apps, you need to set a few environment variables:

export BL60X_SDK_PATH=/path/to/this/repo
export CONFIG_CHIP_NAME=bl602

Then go to the sample directory of interest and call make, for example:

cd customer_app/bl602_boot2
make

Call

make CONFIG_TOOLPREFIX=riscv64-linux-gnu-

for bypassing the bundled cross-compiler and using your distribution's own cross-compiler.

There is a linker script (written in python) at image_conf/flash_build.py. To run this, you need to specify the application and the target, for example:

python3 flash_build.py bl602_boot2 bl602

BL602 is a 32-bit RISC-V based combo chipset supporting Wi-Fi and BLE (Bluetooth Low Energy). The chip is made by Nanjing-based Bouffalo Lab for ultra-low-power applications. In terms of price range and feature set, the chip is competing against Espressif ESP8266

• BL602/604 Datasheet (34 pages): Includes pinout, memory map, and general peripheral descriptions but no detailed functional specification or register listings. Sipeed, a board vendor that plans to use the BL602, claims that full register documentation will be available sometime in November 2020.
• soc602_reg.svd: Contains a seemingly-complete register listing, with names but no descriptions, for the BL602.
• Hardware Notes: Additional information gathered from this repository and elsewhere on the internet.