wchisp - WCH ISP Tool in Rust

Command-line implementation of the WCHISPTool in Rust, by the ch32-rs team.

This tool is a work in progress.

TODOs

• [x] chip detection, identification
  • wchisp probe
  • wchisp info
• [x] flash and verify code
  • [x] ELF parsing
  • [x] hex, bin, ihex support
  • [x] skip erasing, verifying, resetting
• [x] chip config register dump
  • wchisp config
  • works for most chips, but not all
• [ ] write config registers
  • [x] reset config registers to default(unprotected state)
  • [ ] write config with friendly register names? like wchisp config set SRAM_CODE_MODE=1 ...
• [x] EEPROM dump
• [x] EEPROM erase
• [x] EEPROM write
• [x] select from multiple chips(using index) wchisp -d 0 info
• [ ] ISP via UART or Net

Usage

```console

cargo install wchisp --git https://github.com/ch32-rs/wchisp

wchisp info 14:51:24 [INFO] Chip: CH32V307VCT6[0x7017] (Code Flash: 256KiB) 14:51:24 [INFO] Chip UID: 30-78-3e-26-3b-38-a9-d6 14:51:24 [INFO] BTVER(bootloader ver): 02.60 14:51:24 [INFO] Code Flash protected: false RDPRUSER: 0x9F605AA5 [7:0] RDPR 0b10100101 (0xA5) - Unprotected [16:16] IWDG_SW 0b0 (0x0) - IWDG enabled by the software [17:17] STOPRST 0b0 (0x0) - Enable [18:18] STANDBY_RST 0b0 (0x0) - Enable [23:21] SRAMCODEMODE 0b11 (0x3) - CODE-228KB + RAM-32KB DATA: 0x00FF00FF [7:0] DATA0 0b11111111 (0xFF) [23:16] DATA1 0b11111111 (0xFF) WRP: 0xFFFFFFFF - Unprotected

wchisp flash ./path/to/firmware.{bin,hex,elf}

wchisp config info

wchisp config reset ```

Tested On

This tool should work on most WCH MCU chips. But I haven't tested it on any other chips.

• [x] CH32V307
  • VCT6
  • RCT6 #8
• [x] CH32V103
• [x] CH32F103
• [x] CH552
  • Works but might be buggy #10 #14
• [x] CH582
  • CH58xM-EVT
• [x] CH573
  • WeActStudio.WCH-BLE-Core
• [x] CH579
  • BTVER: 02.90 #18
• [x] CH559
  • CH559TLMINIEVTV20 by wch.cn
• [x] CH32V203
  • CH32V203G6 FlappyBoard
  • nanoCH32V203
• ... (feel free to open an issue whether it works on your chip or not)

Related Works (Many Thanks!)

• https://github.com/MarsTechHAN/ch552tool
• https://github.com/MarsTechHAN/ch552tool/pull/21 by @Pe3ucTop
• https://github.com/Blinkinlabs/ch554_sdcc
• https://github.com/rgwan/librech551
• https://github.com/jobitjoseph/CH55XDuino
• https://github.com/frank-zago/isp55e0

Contribution

This project is under active development. If you have any suggestions or bug reports, please open an issue.

If it works for your devices, please open a pull request to modify this README page.

It it doesn't, please open an issue. Better provide the following information:

• chip type (with variant surfix)
• debug print of usb packets
• correct usb packets to negotiate with the chip (via USBPcap or other tools)