Home
Open-source desktop toolkit for Quansheng UV-K1, UV-K1(8) v3 Mini Kong and UV-K5 V3 radios.
Tip
New here? If you just want to run the toolkit on Windows, jump to Installation → Windows. If you're flashing firmware for the first time, read Flashing Firmware end-to-end before plugging anything in.
This wiki is the end-user manual. Code-level documentation lives in the source tree (CONTRIBUTING.md, docstrings).
| Page | What you'll find |
|---|---|
| Installation | Step-by-step install for Windows, macOS, Linux. Driver setup. Permissions. |
| Hardware Compatibility | Which models are supported, how to identify your radio, MCU detection, firmware compatibility matrix. |
| Flashing Firmware | DFU mode, anti-brick allowlist, bundled firmwares, recovery procedure. |
| Channel Management | Channels, scan lists, CSV import/export, CHIRP migration, tone modes. |
| Calibration and Backup | What to back up, when, how to restore. The single most important habit. |
| CLI Reference | Every subcommand with examples. Useful for scripting. |
| Troubleshooting & FAQ | "Doesn't see the radio", "Apply fails", "DFU doesn't start", and other common pain points. |
- Channels — read, write, CSV import/export (CHIRP-compatible 21-column format)
-
Scan lists — 24 lists, named, channel assignments encoded round-trip in CSV
Commentcolumn - Settings — ~110 named entries across F4HWN 5.x and Quansheng stock registries
- Calibration — dump, restore, byte-level diff between two dumps
-
DTMF contacts — full 16-slot phonebook editor at EEPROM
0x1C00 - Boot logo — text editor (2×16 lines)
- Live LCD mirror — real-time screen mirror over USB, save PNG screenshots
-
DFU firmware flashing — 9 bundled
.binimages (F4HWN + Quansheng stock), anti-brick allowlist - Hex viewer — read-only diagnostic pane for byte-level inspection
- Cockpit-themed UI — 5 palette families × Light/Dark, wheel-edit guard on numeric fields
Warning
The toolkit takes irreversible operations seriously. No write to the radio happens without an explicit user action (you click Apply Changes; you click Flash). The DFU flasher refuses any firmware whose target doesn't match your live bootloader. The calibration restore checks byte counts and target metadata before allowing the write.
But software guarantees are not perfect. Always back up your calibration and your full EEPROM before any write operation. See Calibration and Backup.
- Source code & releases: https://github.com/knoinok/quansheng_toolkit
- Bug reports / feature requests: Issues
- Discussion / questions: Discussions
- License: Apache-2.0
-
F4HWN firmware (the foundation everything else is built on):
- armel/uv-k1-k5v3-firmware-custom (PY32F071)
- armel/uv-k5-firmware-custom (DP32G030)