From 6093e588f30e50488c01e7390b467f0ba701c016 Mon Sep 17 00:00:00 2001 From: Alexander Bessman Date: Sun, 28 Dec 2025 12:49:39 +0100 Subject: [PATCH] Clarify bootloader instructions --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 6c50ed9..14bbb38 100644 --- a/README.md +++ b/README.md @@ -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.