Pine64 BL602 IoT SDK modded for the articles...

"PineDio LoRa Gateway: Testing The Prototype" <https://lupyuen.github.io/articles/gateway>_
"Build a Linux Driver for PineDio LoRa SX1262 USB Adapter" <https://lupyuen.github.io/articles/usb>_
"Monitor IoT Devices in The Things Network with Prometheus and Grafana" <https://lupyuen.github.io/articles/prometheus>_
"CBOR Payload Formatter for The Things Network" <https://lupyuen.github.io/articles/payload>_
"Internal Temperature Sensor on BL602" <https://lupyuen.github.io/articles/tsen>_
"Internal Temperature Sensor on BL602" <https://lupyuen.github.io/articles/tsen>_
"IoT Digital Twin with Roblox and The Things Network" <https://lupyuen.github.io/articles/roblox>_
"Encode Sensor Data with CBOR on BL602" <https://lupyuen.github.io/articles/cbor>_
"Grafana Data Source for The Things Network" <https://lupyuen.github.io/articles/grafana>_
"The Things Network on PineDio Stack BL604 RISC-V Board" <https://lupyuen.github.io/articles/ttn>_
"LoRaWAN on PineDio Stack BL604 RISC-V Board" <https://lupyuen.github.io/articles/lorawan2>_
"Rust on RISC-V BL602: Rhai Scripting" <https://lupyuen.github.io/articles/rhai>_
"PineDio Stack BL604 RISC-V Board: Testing The Prototype" <https://lupyuen.github.io/articles/pinedio>_
"Rust on RISC-V BL602: Simulated with WebAssembly" <https://lupyuen.github.io/articles/rustsim>_
"Rust on RISC-V BL602: Is It Sunny?" <https://lupyuen.github.io/articles/adc>_
"Reverse Engineering WiFi on RISC-V BL602" <https://lupyuen.github.io/articles/wifi>_
"Machine Learning on RISC-V BL602 with TensorFlow Lite" <https://lupyuen.github.io/articles/tflite>_
"BL602 Bootloader" <https://lupyuen.github.io/articles/boot>_
"Simulate RISC-V BL602 with WebAssembly, uLisp and Blockly" <https://lupyuen.github.io/articles/wasm>_
"uLisp and Blockly on PineCone BL602 RISC-V Board" <https://lupyuen.github.io/articles/lisp>_
"Run Rust RISC-V Firmware with BL602 IoT SDK" <https://lupyuen.github.io/articles/rust>_
"PineCone BL602 RISC-V Board Receives LoRa Packets" <https://lupyuen.github.io/articles/lora2>_
"RAKwireless WisBlock talks LoRa with PineCone BL602 RISC-V Board" <https://lupyuen.github.io/articles/wisblock>_
"Connect PineCone BL602 to LoRa Transceiver" <https://lupyuen.github.io/articles/lora>_
"The RISC-V BL602 Book" <https://lupyuen.github.io/articles/book>_
"PineCone BL602 Talks UART to Grove E-Ink Display" <https://lupyuen.github.io/articles/uart>_
"PineCone BL602 Blasting Pixels to ST7789 Display with LVGL Library" <https://lupyuen.github.io/articles/display>_
"PineCone BL602 talks SPI too!" <https://lupyuen.github.io/articles/spi>_
"PineCone BL602 talks to I2C Sensors" <https://lupyuen.github.io/articles/i2c>_
"Mynewt GPIO ported to PineCone BL602 RISC-V Board" <https://lupyuen.github.io/articles/gpio>_
"Control PineCone BL602 RGB LED with GPIO and PWM" <https://lupyuen.github.io/articles/led>_
"Flashing Firmware to PineCone BL602" <https://lupyuen.github.io/articles/flash>_
"Debug Rust on PineCone BL602 with VSCode and GDB" <https://lupyuen.github.io/articles/debug>_
"Porting Mynewt to PineCone BL602" <https://lupyuen.github.io/articles/mynewt>_
"Connect PineCone BL602 to OpenOCD" <https://lupyuen.github.io/articles/openocd>_
"Quick Peek of PineCone BL602 RISC-V Evaluation Board" <https://lupyuen.github.io/articles/pinecone>_

Changes

Capture built firmware from GitHub Actions Workflow as Artifacts
"jtag" branch contains a modified Hello World app that remaps the JTAG port: sdk_app_helloworld <https://github.com/lupyuen/bl_iot_sdk/tree/jtag/customer_app/sdk_app_helloworld>_
Modified PWM Demo Firmware that runs without Device Tree: sdk_app_pwm <https://github.com/lupyuen/bl_iot_sdk/pull/1>_
"i2c" branch contains a modified I2C Demo Firmware that uses the Low Level I2C HAL: sdk_app_i2c <https://github.com/lupyuen/bl_iot_sdk/blob/i2c/customer_app/sdk_app_i2c>_
New SPI Firmware that uses the SPI HAL: sdk_app_spi_demo <customer_app/sdk_app_spi_demo>_
New Firmware for ST7789 SPI Display + LVGL Graphics Library: sdk_app_st7789 <customer_app/sdk_app_st7789>_
New Firmware for Grove E-Ink Display with UART Interface: sdk_app_uart_eink <customer_app/sdk_app_uart_eink>_
New Firmware that transmits and receives LoRa packets: sdk_app_lora <customer_app/sdk_app_lora>_
New Firmware for LoRa Ping: sdk_app_loraping <customer_app/sdk_app_loraping>_
New Library for NimBLE and SX1276: nimble-porting-layer <components/3rdparty/nimble-porting-layer>_ and lora-sx1276 <components/3rdparty/lora-sx1276>_
New LoRaWAN Driver and Firmware: lorawan <components/3rdparty/lorawan>_ and sdk_app_lorawan <customer_app/sdk_app_lorawan>_
New Driver for LoRa SX1262: lora-sx1262 <components/3rdparty/lora-sx1262>_
New Rust Library and Firmware: rust-app <components/3rdparty/rust-app>_ and sdk_app_rust <customer_app/sdk_app_rust>_
New Blinky Firmware: sdk_app_blinky <customer_app/sdk_app_blinky>_
New uLisp Library and Firmware: ulisp-bl602 <components/3rdparty>_ and sdk_app_ulisp <customer_app/sdk_app_ulisp>_
New TensorFlow Lite Library and Firmware: tflite-bl602 <components/3rdparty>_ and sdk_app_tflite <customer_app/sdk_app_tflite>_
New ADC Firmware: sdk_app_adc <customer_app/sdk_app_adc>, sdk_app_adc2 <customer_app/sdk_app_adc2>, sdk_app_rust_adc <customer_app/sdk_app_rust_adc>_ and sdk_app_rust_gpio <customer_app/sdk_app_rust_gpio>_
New PineDio Stack BL604 Blinky Firmware: pinedio_blinky <customer_app/pinedio_blinky>_
New PineDio Stack ST7789 Firmware: pinedio_st7789 <customer_app/pinedio_st7789>, pinedio_st7789_bitbang <customer_app/pinedio_st7789_bitbang>
New CBOR Firmware: pinedio_cbor <customer_app/pinedio_cbor>_
New Internal Temperature Sensor Firmware: pinedio_tsen <customer_app/pinedio_tsen>_
New PineDio Stack LoRaWAN Firmware: pinedio_lorawan <customer_app/pinedio_lorawan>_

BL602 SDK (Pine64 version)

Join us on Discord <https://discord.gg/89VWQVH>, Telegram <https://t.me/joinchat/Kmi2S0nOsT240emHk-aO6g>, Matrix <https://matrix.to/#/#pine64-nutcracker:matrix.org>_

This repository contains the Pine64 fork of Bouffalo Lab's SDK for their BL602 Wi-Fi/BLE Combo RISC-V SoC. Documentation, including upstream documentation, translations, mirrored technical documentation, and original reverse engineered documentation is at bl602-docs <https://github.com/pine64/bl602-docs>_, which is cloned as a submodule of this repository at docs. Use git submodule update --init to initialize the submodule.

This repository is the central focus of Pine64's Nutcracker Challenge <https://www.pine64.org/2020/10/28/nutcracker-challenge-blob-free-wifi-ble/>_. The main task is to reverse engineer the following files:

- `components/bl602/bl602_wifi/lib/libbl602_wifi.a <https://github.com/pine64/bl_iot_sdk/blob/master/components/bl602/bl602_wifi/lib/libbl602_wifi.a>`_
- `components/network/ble/blecontroller/lib/libblecontroller.a <https://github.com/pine64/bl_iot_sdk/blob/master/components/network/ble/blecontroller/lib/libblecontroller.a>`_
- `components/stage/atcmd/lib/libatcmd.a <https://github.com/pine64/bl_iot_sdk/blob/master/components/stage/atcmd/lib/libatcmd.a>`_

This is being done at bl602-re <https://github.com/pine64/bl602-re>_.

Documentation

You can find a lot of documentation on PINE64 Documentation Website <https://pine64.github.io/bl602-docs/>_ and PINE64 Documentation Repository <https://github.com/pine64/bl602-docs>_, where you can find Datasheets, Reference Manuals and various other documentation materials.

Quick Start

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

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

In order to build all sample apps simply call make, for example::

make

To only build the sample app of interest, go to the directory of the app, then call make, for example::

cd customer_app/bl602_boot2
make

Call

make CONFIG_TOOLPREFIX=riscv64-linux-gnu-

if you wish to bypass 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

Note: If you decide to copy any project outside of the customer_app folder, you will need to define a few variables in order to compile it::

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

Docker

To set up a development environment in Docker, and do a full build of all the example projects, using the bundled toolchain::

docker build -t bl602sdk -f Dockerfile.bundled
docker run -t -i --rm bl602sdk
# make

Hardware

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 <https://www.bouffalolab.com/bl602>_ for ultra-low-power applications. In terms of price range and feature set, the chip is competing against Espressif ESP8266 <https://www.espressif.com/en/products/socs/esp8266>. The RISC-V core is based on SiFive E24 <https://www.sifive.com/cores/e24>.

At the moment there are mainly three development boards:

PineCone <https://www.pine64.org/2020/10/28/nutcracker-challenge-blob-free-wifi-ble/>: USB-C evaluation board by Pine64 (datasheet here <https://www.cnx-software.com/pdf/schematics/Pine64%20BL602%20EVB%20Schematic%20ver%201.1.pdf>), RGB LED, CH340N USB-to-UART chip
Doi.am DT-BL10 <https://www.cnx-software.com/2020/10/25/bl602-iot-sdk-and-5-dt-bl10-wifi-ble-risc-v-development-board/>_: micro USB
Official BL EVB <https://twitter.com/nnn112358/status/1321289916249235457>_ (Sipeed early adopter program): mini USB, FTDI chip?

Comparison with ESP8266

+-------------------+-----------------------------+----------------------------------+ | | Bouffalo Lab BL602 | Espressif ESP8266 | +===================+=============================+==================================+ | Architecture | 32-bit RISC-V (SiFive E24) | 32-bit Xtensa | | | | | | | @192MHz (dynamic @1-192MHz) | @80MHz (and 160MHz) | | | | | | | L1 cache | | | | | | | | FPU | | +-------------------+-----------------------------+----------------------------------+ | Memory | 276KB SRAM | 32 KiB instruction RAM | | | | | | | 128KB ROM | 32 KiB instruction cache RAM | | | | | | | 1 Kb eFuse | 80 KiB user-data RAM | | | | | | | optional embdedded flash | 16 KiB ETS system-data RAM | | | | | | | | | | | XIP QSPI flash support | No programmable ROM | | | | | | | | QSPI flash support | | | | (up to 16 MB) | +-------------------+-----------------------------+----------------------------------+ | Wi-Fi | 802.11 b/g/n @2.4GHz | 802.11 b/g/n @2.4GHz | | | | | | | WPS/WEP/WPA/WPA2/WPA3 | WEP/WPA/WPA2 | +-------------------+-----------------------------+----------------------------------+ | Bluetooth | LE 5.0 | NONE | +-------------------+-----------------------------+----------------------------------+ | GPIO | x16 | x16 | +-------------------+-----------------------------+----------------------------------+ | SDIO | x1 2.0 slave | x1 v2.0 slave | +-------------------+-----------------------------+----------------------------------+ | SPI | x1 | x2 | +-------------------+-----------------------------+----------------------------------+ | UART | x2 | x1.5 | | | | (One Tx only) | +-------------------+-----------------------------+----------------------------------+ | I2C | x1 | x1 (software implemented) | +-------------------+-----------------------------+----------------------------------+ | I2S | NONE | x1 (with DMA) | +-------------------+-----------------------------+----------------------------------+ | PWM channels | x5 | x4 | +-------------------+-----------------------------+----------------------------------+ | ADC | 12-bit | 10-bit (SAR) | +-------------------+-----------------------------+----------------------------------+ | DAC | 10-bit | NONE | +-------------------+-----------------------------+----------------------------------+ | Analog Comparator | x2 | NONE | +-------------------+-----------------------------+----------------------------------+ | DMA | x4 | with I2S | +-------------------+-----------------------------+----------------------------------+ | Timer | RTC (up to 1 year) | x1 hardware | | | | | | | x2 32-bit general-purpose | x1 software | | | | | | | | (no interrupt gen. on sw. timer) | +-------------------+-----------------------------+----------------------------------+ | IR Remote Control | x1 | x1 | +-------------------+-----------------------------+----------------------------------+ | Debug | JTAG support | ? | +-------------------+-----------------------------+----------------------------------+

bl_iot_sdk
bl_iot_sdk copied to clipboard

Metadata

Changes

BL602 SDK (Pine64 version)

Documentation

Quick Start

Call

Docker

Hardware

Comparison with ESP8266

← Metadata

Owner

Metadata

bl_iot_sdk bl_iot_sdk copied to clipboard

Metadata

Changes

BL602 SDK (Pine64 version)

Documentation

Quick Start

Call

Docker

Hardware

Comparison with ESP8266

← Metadata

Owner

Metadata

bl_iot_sdk
bl_iot_sdk copied to clipboard