wlink 0.1.1

WCH-Link flash tool for WCH's RISC-V MCUs(CH32V, CH56X, CH57X, CH58X, CH59X, CH32L103, CH32X035, CH641, CH643)
Documentation
# References

## Real Shot

![real shot](https://web.archive.org/web/20230613102346im_/https://www.wch.cn/uploads/image/20221230/1672381416120803.png)

## Feature matrix

| Feature                         |  WCH-Link  | WCH-LinkE  | WCH-LinkW  | WCH-DAPLink |
| ------------------------------- | :--------: | :--------: | :--------: | :---------: |
| RISC-V mode                     |  ✓   |  ✓   |  ✓   |             |
| ARM-SWD mode (HID device)       |            |            |            |   ✓   |
| ARM-SWD mode (WinUSB device)    |  ✓   |  ✓   |  ✓   |   ✓   |
| ARM-JTAG mode (HID device)      |            |            |            |   ✓   |
| ARM-JTAG mode (WinUSB device)   |            |  ✓   |  ✓   |   ✓   |
| ModeS button                    |            |  ✓   |  ✓   |   ✓   |
| DFU via 2-wire                  |  ✓   |            |            |             |
| DFU via serial-port             |  ✓   |            |            |             |
| DFU via USB                     |  ✓   |            |  ✓   |   ✓   |
| Power Supply (3.3v)             |  ✓   |  ✓   |  ✓   |   ✓   |
| Power Supply (5.0v)             |  ✓   |  ✓   |  ✓   |   ✓   |
| Power Supply (Configurable)     |            |  ✓   |  ✓   |   ✓   |
| USB 2.0 to JTAG                 |            |  ✓   |            |             |
| Wireless mode                   |            |            |  ✓   |             |
| Download via [MounRiver Studio] |  ✓   |  ✓   |  ✓   |   ✓   |
| Download via [WCH-LinkUtility]  |  ✓   |  ✓   |  ✓   |             |
| Download via [Keil]             | ≥ v5.25 | ≥ v5.25 | ≥ v5.25 |   ✓   |

## Supported Chip matrix

| Chip           | WCH-Link | WCH-LinkE | WCH-LinkW | WCH-DAPLink |
| -------------- | :------: | :-------: | :-------: | :---------: |
| JTAG interface |          |  ✓  |  ✓  |   ✓   |
| SWD interface  | ✓  |  ✓  |  ✓  |   ✓   |
| CH32F10x       | ✓  |  ✓  |  ✓  |   ✓   |
| CH32F20x       | ✓  |  ✓  |  ✓  |   ✓   |
| CH32V003       |          |  ✓  |  ✓  |             |
| CH32V10x       | ✓  |  ✓  |  ✓  |             |
| CH32V20X       | ✓  |  ✓  |  ✓  |             |
| CH32V30X       | ✓  |  ✓  |  ✓  |             |
| CH569          | ✓  |  ✓  |           |             |
| CH573          | ✓  |  ✓  |           |             |
| CH579          | ✓  |  ✓  |  ✓  |   ✓   |
| CH583          | ✓  |  ✓  |           |             |

## Supported Baud matrix

|   Baud | WCH-Link | WCH-LinkE | WCH-LinkW | WCH-DAPLink |
| -----: | :------: | :-------: | :-------: | :---------: |
|   1200 | ✓  |  ✓  |  ✓  |   ✓   |
|   2400 | ✓  |  ✓  |  ✓  |   ✓   |
|   4800 | ✓  |  ✓  |  ✓  |   ✓   |
|   9600 | ✓  |  ✓  |  ✓  |   ✓   |
|  14400 | ✓  |  ✓  |  ✓  |   ✓   |
|  19200 | ✓  |  ✓  |  ✓  |   ✓   |
|  38400 | ✓  |  ✓  |  ✓  |   ✓   |
|  57600 | ✓  |  ✓  |  ✓  |   ✓   |
| 115200 | ✓  |  ✓  |  ✓  |   ✓   |
| 230400 | ✓  |  ✓  |  ✓  |   ✓   |
| 460800 |          |  ✓  |  ✓  |   ✓   |
| 921600 |          |  ✓  |  ✓  |   ✓   |

## SWD PIN matrix

| Chip     | SWDIO | SWCLK |
| -------- | :---: | :---: |
| CH32F10x | PA13  | PA14  |
| CH32F20x | PA13  | PA14  |
| CH32V003 |  PD1  |       |
| CH32V10x | PA13  | PA14  |
| CH32V20X | PA13  | PA14  |
| CH32V30X | PA13  | PA14  |
| CH32X035 | PC18  | PC19  |
| CH569    | PA11  | PA10  |
| CH573    | PB14  | PB15  |
| CH579    | PB16  | PB17  |
| CH583    | PB14  | PB15  |
| CH59x    | PB14  | PB15  |
| CH643    | PC18  | PC19  |

## Documentation

- [WCH-Link 相关资料汇总]https://web.archive.org/web/20230613102346/https://www.wch.cn/bbs/thread-71088-1.html
- [WCH-Link 使用说明 v1.7]https://web.archive.org/web/20230613114619if_/https://www.wch.cn/downloads/file/417.html?time=2023-06-13%2019:46:05&code=1BaRkx0gWHP7accBAPUtCuJ0dk0emAIzZ85o8UIf
- [WCH-LinkSCH.pdf]https://web.archive.org/web/20230613133629/https://www.wch.cn/downloads/file/421.html?time=2023-06-13%2021:35:48&code=CA0Mz2JvD7YBhFB9t8jVb3MhgGgZV4fxg23Ku5B6
- [User Manual (Chinese)]https://web.archive.org/web/20230613102015if_/https://www.wch.cn/downloads/file/417.html?time=2023-06-13%2018:19:04&code=z6nAIBmh1M4Uv64xdbCeAwywfJ9OEPG6OBvdUz1A
- [User Manual (English)]https://web.archive.org/web/20230613102158if_/http://www.wch-ic.com/downloads/file/372.html?time=2023-06-13%2018:20:36&code=uRfQmamyIynlCZPHO33rloOWiCgb44NLTXxStO8l

## ISP

- [WCHISPTool_Setup.exe]https://web.archive.org/web/20220811233210if_/https://www.wch.cn/downloads/file/196.html?time=2022-06-30%2014:56:16&code=LS2LHywwDiw3P71gxsM1hfZClwSQlbI4nQga1Kzo v3.3

## Firmware

- [WCH_RISC-V_MCU_ProgramTool.zip]https://web.archive.org/web/20230613112000if_/https://www.wch.cn/uploads/file/20220628/1656415558432295.zip
- [WCH-Link v2.3]https://web.archive.org/web/20230613112654if_/https://www.wch.cn/uploads/file/20220718/1658124411917956.zip
- [WCH-LinkE v1.1]https://web.archive.org/web/20230613112104if_/https://www.wch.cn/uploads/file/20220913/1663036474195451.zip

## Other FOSS implementation

- <https://github.com/openwch/ch32v003> RISC-V QingKeV2 Microprocessor Debug Manual
- <https://github.com/cnlohr/ch32v003fun> A miniwchlink implementation
- <https://github.com/blackmagic-debug/blackmagic/pull/1399>
- [MounRiver Studio] compatible WCH-Link OpenOCD source code <https://github.com/treideme/openocd-hacks>

[MounRiver Studio]: http://www.mounriver.com "MounRiver Studio"
[WCH-LinkUtility]: https://web.archive.org/web/20230613114515if_/https://www.wch.cn/downloads/file/418.html?time=2023-06-13%2019:44:31&code=z88GXEXY3kNBV9rTwDe0iWerDk5iKHB50lkst8j8 "WCH LinkUtility"
[Keil]: https://www.keil.com "Keil Embedded Development Tools"