neil/blisp
1
0
Fork 0
mirror of https://github.com/pine64/blisp.git synced 2024-12-22 06:20:12 +00:00
Code Issues Packages Projects Releases Wiki Activity
ISP tool & library for Bouffalo Labs RISC-V Microcontrollers and SoCs
134 Commits 10 Branches 4 Tags 1.1 MiB
C 98.3%
CMake 1.3%
Nix 0.3%
3b47993de7
Go to file
Neil Hanlon 3b47993de7
Use CMAKE_INSTALL_LIBDIR for install destination to respect build forges 
CMAKE_INSTALL_LIBDIR should be popualted with either lib or lib64,
depending on the architecture. This change makes it so that this flag is
respected by blisp and the library, runtime, and archives are installed
to the location requested by the build.
2023-08-07 21:18:43 -04:00
.github/workflows Unify uploaded artefact names 2023-05-09 14:38:58 +10: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 More annotations on errors 2023-05-09 08:05:38 +10:00
lib DFU file support (#45) 2023-08-01 22:43:56 +10:00
tools/blisp DFU file support (#45) 2023-08-01 22:43:56 +10: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 Use CMAKE_INSTALL_LIBDIR for install destination to respect build forges 2023-08-07 21:18:43 -04:00
LICENSE Add license 2022-11-30 13:17:30 +01:00
README.md Release v0.0.4 2023-08-03 08:21:21 +02:00

README.md

Hits GitHub all downloads Discord GitHub release


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 .

For building against preinstalled system libraries of the used vendor libraries (e.g. for use by system maintainers), additionally define BLISP_USE_SYSTEM_LIBRARIES, e.g. using following commands:

mkdir build && cd build
cmake -DBLISP_USE_SYSTEM_LIBRARIES=ON -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.