neil/blisp

mirror of https://github.com/pine64/blisp.git synced 2024-12-22 06:20:12 +00:00

ISP tool & library for Bouffalo Labs RISC-V Microcontrollers and SoCs

Go to file

Berk D. Demir e959756f5a Refactor to address compiler warnings - Unused function warnings Move function definitions in include/blisp_util.h to lib/blisp_util.c. Defining them as static leads to internal linkage, accessible in that translation unit, hence the warning. Their references are to be handled in other translation units, so they shouldn't be static. - Unused function parameters Use C attribute `[[maybe_unused]]` (introduced in C23) to suppress unused parameter warnings. - `blisp_chip_xxxxx_get_eflash_loader` implementations accept clock type but don't use it. - `drain` function only has a body under macOS and FreeBSD with preprocessor predicates. - Enable compiler warnings Now that warnings are address enable them `-Wall -Wextra -Wpedantic` for the library and the tool targets. N.B. An equivalent of MSVC should be added to CMakeLists.txt, as these would only work when using GCC or Clang.		2023-04-30 10:21:34 -07:00
.github/workflows	Fix Windows CI build	2023-01-21 15:17:17 +01:00
.idea	Initial commit	2022-08-24 12:06:39 +02:00
data	Integrated eflash_loader	2023-01-09 21:23:46 +01:00
img	Delete test	2023-03-18 14:55:03 -07:00
include	Refactor to address compiler warnings	2023-04-30 10:21:34 -07:00
lib	Refactor to address compiler warnings	2023-04-30 10:21:34 -07:00
tools/blisp	Refactor to address compiler warnings	2023-04-30 10:21:34 -07:00
vendor	Add libserialport + another improvements	2022-09-12 13:14:55 +02:00
.clang-format	Update code styly and reformat code	2023-01-07 11:50:51 +01:00
.gitignore	Add initial MacOS support	2022-12-06 17:15:53 +01:00
.gitmodules	Add libserialport + another improvements	2022-09-12 13:14:55 +02:00
CMakeLists.txt	Refactor to address compiler warnings	2023-04-30 10:21:34 -07:00
LICENSE	Add license	2022-11-30 13:17:30 +01:00
README.md	update install instructions	2023-04-10 18:26:06 -07:00

README.md

BLISP

Bouffalo Labs ISP (in-system-programming) tool & library: an open source tool to flash Bouffalo RISC-V MCUs.

NOTE: Library API and blisp tool cli arguments are not stable yet.

Supported MCUs

bl60x - BL602 / BL604 / TG7100C / LF686 / LF688
bl70x - BL702 / BL704 / BL706

Supported Devices

System	Windows	MacOS	Linux	FreeBSD
Pinecil V2
Pinecone

How to update Pinecil V2

Download the newest release of Blisp updater here.

Check out the wiki page for install instructions.

Building from code

Clone repository

If you have not cloned this repository locally; clone the git repository locally by running

git clone --recursive https://github.com/pine64/blisp.git
cd blisp
git submodule update --init --recursive

If vendor/argtable3 and vendor/libserialport/ are empty, this last step has failed and should be investigated.

Build the library and command line utility

For building blisp command line tool, use following commands:

mkdir build && cd build
cmake -DBLISP_BUILD_CLI=ON ..
cmake --build .

Need more build details? See here.

Usage

For BL70X, BL61X, BL808 and BL606P, connected via USB, you can use following command, which will auto-detect serial port on Windows:

.\blisp.exe write --chip=bl70x --reset .\name_of_firmware.bin
or
.\blisp.exe write -c bl70x --reset .\name_of_firmware.bin

For BL60X, you need to specify also the serial port path:

blisp write --chip bl60x --reset -p /dev/ttyUSB0 name_of_firmware.bin

If you wish to see additional debugging, set the environmental variable LIBSERIALPORT_DEBUG before running. You can either export this in your shell or change it for a single run via

  LIBSERIALPORT_DEBUG=y ./a.out write -c bl70x -p /dev/tty.usbmodem0000000200001

Because this is done at the lowest level of serial communication, the displays aren't packet-aware or know about the chip's command set or such. This is really only useful for debugging systems-level issues withing the device or blisp itself.