README.md (1406B)
1 # drivers/ 2 3 Host-side drivers needed to flash the badge. **Binaries are git-ignored** (they're 4 re-downloadable from the vendor); this file is the breadcrumb so the knowledge stays in-tree. 5 6 ## CH34xVCPDriver (macOS) — required to flash the FireBeetle on a Mac 7 8 The **FireBeetle 2 ESP32-E** uses a **CH340** USB-UART bridge (VID `0x1A86` / PID `0x7522`) — *not* 9 the CP2102 the bench testers use. macOS enumerates the chip but attaches no driver by default, so 10 **no `/dev/cu.*` port appears** and the board looks dead (it isn't — confirm with `ioreg -p IOUSB`, 11 which shows the device; `system_profiler SPUSBDataType` reads false-empty on Apple Silicon). 12 13 - **Source:** WCH official → https://github.com/WCHSoftGroup/ch34xser_macos → `CH34xVCPDriver.dmg` 14 (the macOS 11+ build is a DriverKit System Extension — Apple-Silicon-native, no kext / reduced- 15 security reboot) 16 - **sha256** (downloaded 2026-06-04): `161f61a5c7a0de34ed056c76cc21cb9a32ab94a03a0084f91054ea53e9ec2dc8` 17 - **Signed:** Developer ID — Nanjing Qinheng Microelectronics (WCH), Team `5JZGQTGU4W`; Apple-notarized 18 - **Install:** open the `.dmg` → run `CH34xVCPDriver.app` → click **Install** → enable it in 19 System Settings → General → Login Items & Extensions → Driver Extensions → unplug/replug → 20 the port appears as `/dev/cu.wchusbserial*`. 21 22 (Use the `.dmg`, not the legacy `.pkg` kext, on Apple Silicon.)