Clarify bootloader instructions

This commit is contained in:
Alexander Bessman 2025-12-28 12:49:39 +01:00 committed by GitHub
parent c299d578bb
commit 6093e588f3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -4,7 +4,6 @@ Hardware details and information to build an open firmware for Bluetooth LED bad
## Installation
### Unix
Install [wchisp](https://github.com/ch32-rs/wchisp?tab=readme-ov-file#installing).
Download prebuilt binaries from [release](https://github.com/fossasia/badgemagic-firmware/releases) or [the latest development builds](https://github.com/fossasia/badgemagic-firmware/tree/bin).
@ -17,12 +16,14 @@ the boot pin is pulled down in one of two ways:
- Alternatively, connect the USB, press and hold KEY2, then short and release
the C3 capacitor.
Then check `dmesg` if the chip has entered the ISP mode with idVendor=4348 and
If the badge has succesfully entered ISP mode, a single pixel roughly in the middle of the display will be lit. The badge will stay in ISP mode for approximately ten seconds before rebooting into normal mode.
You can also check `dmesg` if the chip has entered the ISP mode with idVendor=4348 and
idProduct=55e0.
![c3](assets/burn-badge.svg)
Then run:
With the badge in ISP mode, run:
```sh
wchisp config reset
@ -30,8 +31,8 @@ wchisp flash badgemagic-ch582.bin
```
### Windows
Install and run [wchisp studio](https://www.wch-ic.com/downloads/WCHISPTool_Setup_exe.html)
Connect the badge via USB and enter bootloader mode.
On Windows, you have the option to install and run [wchisp studio](https://www.wch-ic.com/downloads/WCHISPTool_Setup_exe.html) instead of the wchisp CLI tool.
Connect the badge via USB and enter bootloader mode, per the instructions above.
The device will automatically appear in the UI.