https://github.com/rustsbi/bouffaloader
Bouffaloader is a baremetal bootloader for Bouffalo IoT chips.
https://github.com/rustsbi/bouffaloader
Last synced: about 1 year ago
JSON representation
Bouffaloader is a baremetal bootloader for Bouffalo IoT chips.
- Host: GitHub
- URL: https://github.com/rustsbi/bouffaloader
- Owner: rustsbi
- License: mit
- Created: 2024-10-11T09:26:01.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-10T08:25:13.000Z (about 1 year ago)
- Last Synced: 2025-03-29T10:04:50.756Z (about 1 year ago)
- Language: Rust
- Size: 34.2 KB
- Stars: 79
- Watchers: 73
- Forks: 80
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bouffaloader demo
## Usage with Cargo
### Compile
```
cargo build --target riscv64imac-unknown-none-elf --release
```
### Convert ELF file to binary file
```
cargo blri elf2bin ./target/riscv64imac-unknown-none-elf/release/bouffaloader
```
### Fix the image header (CRC and other fields)
```
cargo blri patch ./target/riscv64imac-unknown-none-elf/release/bouffaloader.bin
```
### Flash to the development board
```
cargo blri flash ./target/riscv64imac-unknown-none-elf/release/bouffaloader.bin
```
## Usage with Bouffalo Lab Dev Cube
### Build
```
rustup target install riscv64imac-unknown-none-elf
cargo build --target riscv64imac-unknown-none-elf --release
```
### Convert the elf file to a binary file
```
cargo install cargo-binutils
rustup component add llvm-tools-preview
rust-objcopy .\target\riscv64imac-unknown-none-elf\release\bouffaloader -O binary .\target\riscv64imac-unknown-none-elf\release\bouffaloader.bin
```
### Flash the binary file to the board with [Bouffalo Lab Dev Cube](https://dev.bouffalolab.com/download) on Windows
1. Connect the board to the computer via UART (Here takes M1s Dock as an example):
- Normally, you can see 2 new serial ports. If not, visit [Burn onboard bl702](https://wiki.sipeed.com/hardware/en/maix/m1s/other/start.html#Burn-onboard-bl702) for help.
2. Run the `BLDevCube.exe`, choose `BL808`, and click `Finish`.
3. In MCU page, browse `target\riscv64imac-unknown-none-elf\release\bouffaloader.bin` as the target of `D0 Group`. Choose the bigger number serial port, and set uart rate 2000000.
4. Press BOOT and RST on the board, then release RST first and BOOT after to be into UART burning mode.
5. Click `Create & Download`, wait for flash the binary file to success.
## Interact
After flashing, repower the board and open the serial port monitor to see the output and interact with the CLI:
- `help`: print out all commands.
- `hello`: print out 'Hello world!'.
- `led [|on|off|switch]`: operate on LED.
- `reload`: reload from sdcard.
- `read `: fetch data from address.
- `write `: write value to address.
- `boot`: boot M-mode firmware.
- `bootargs get|set `: print or set the bootargs in memory.
- `print`: print the configs.bootargs.