blisp/README.md

59 lines
1.2 KiB
Markdown
Raw Normal View History

2022-09-12 14:47:58 +00:00
# Bouffalo Labs ISP tool & library
Open source tool and library for flashing Bouffalo RISC-V MCUs.
2022-09-12 14:47:58 +00:00
2022-11-08 08:37:29 +00:00
**NOTE:** Library API and `blisp` tool cli arguments are not stable yet.
2022-09-12 14:47:58 +00:00
# Supported MCUs
2022-11-20 06:22:36 +00:00
- [x] `bl60x` - BL602 / BL604
- [x] `bl70x` - BL702 / BL704 / BL706
2023-01-21 13:50:27 +00:00
- [ ] `bl70xl` - BL702L / BL704L
2022-11-08 21:17:40 +00:00
- [ ] `bl606p` - BL606P
- [ ] `bl61x` - BL616 / BL618
- [ ] `bl808` - BL808
# Supported OS
- [x] Windows
- [x] Linux
- [x] Apple
2022-11-08 21:17:40 +00:00
# Building
2022-11-20 06:22:47 +00:00
## Clone repository
If you have not cloned this repository locally; clone the git repository locally by running
2022-11-20 06:22:47 +00:00
```bash
git clone --recursive https://github.com/pine64/blisp.git
cd blisp
```
## Build the library and command line utility
2022-11-08 21:17:40 +00:00
For building `blisp` command line tool, use following commands:
```bash
mkdir build && cd build
cmake -DBLISP_BUILD_CLI=ON ..
cmake --build .
```
# Usage
For BL70X, BL61X, BL808 and BL606P, connected via USB, you can use following command, which will auto-detect serial port:
```bash
blisp write --chip bl70x --reset name_of_firmware.bin
2022-11-08 21:17:40 +00:00
```
For BL60X, you need to specify also the serial port path:
```bash
blisp write --chip bl60x --reset -p /dev/ttyUSB0 name_of_firmware.bin
2022-11-08 21:17:40 +00:00
```
2022-09-12 14:47:58 +00:00
# How to flash Pinecil V2
Check out the [wiki page](https://github.com/pine64/blisp/wiki/Update-Pinecil-V2).