hueso/badgemagic-firmware
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #116 from bessman/doc/readme-bootloader

Browse Source 
Clarify bootloader instructions
This commit is contained in:
Hong Phuc Dang 2025-12-28 15:49:27 +01:00 committed by GitHub
commit a794becdb9
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 14 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
README.md
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,13 @@ 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
idProduct=55e0.
If the badge has successfully 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.
On Linux, 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 +30,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.
@ -40,6 +40,14 @@ Select the `badgemagic-ch582.bin` file and click 'Download'.
Where badgemagic-ch582.bin is the binary downloaded above, the .elf file also
works.
### Updating
Once the open source firmware is installed, there is no further need to remove the battery or short-circuit C3 to enter ISP mode. Simply long-press KEY2 to enter ISP mode. Then, flash updated firmware with
```sh
wchisp config reset
wchisp flash badgemagic-ch582.bin
```
## Usage