wlink 0.0.3

WCH-Link flash tool for CH32V faimily MCUs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# wlink - WCH-Link command line tool

[![Crates.io](https://img.shields.io/crates/l/wlink?style=for-the-badge)](https://crates.io/crates/wlink) [![Crates.io](https://img.shields.io/crates/v/wlink?style=for-the-badge)](https://crates.io/crates/wlink) [![docs.rs](https://img.shields.io/docsrs/wlink?style=for-the-badge)](https://docs.rs/wlink) [![GitHub release](https://img.shields.io/github/v/release/ch32-rs/wlink?include_prereleases&style=for-the-badge)](https://github.com/ch32-rs/wlink/releases/tag/nightly)

**NOTE**: This tool is still in development and not ready for production use.

**Known Issue:**

- Only support binary firmware file

## Tested On

### Probes

- WCH-Link CH549
- WCH-LinkE CH32V305

### MCU

- CH32V003 - flash ok, reset not work
- CH32V103 - flash ok
- CH32V203 - flash & reset ok
- CH32V307 - flash & reset ok
- ... (Feel free to open an issue if you have tested on other chips)

## Install

`cargo install --git` or download a binary from the [Nightly Release page](https://github.com/ch32-rs/wlink/releases/tag/nightly).

## Usage

```console
> # Flash firmware.bin to Code FLASH
> cargo run -- flash ./firmware.bin`
16:55:56 [INFO] WCH-Link v2.7 (WCH-Link-CH549)
16:55:56 [INFO] attached chip: CH32V20x(0x20360510)
16:55:56 [INFO] flash 860 bytes
16:55:57 [INFO] flash done
16:55:58 [INFO] now reset...
16:55:59 [INFO] resume executing...

> # Dump Code FLASH, for verification
> cargo run -- -v dump 0x08000000 100`
18:31:18 [DEBUG] (1) wlink::device: Acquired libusb context.
18:31:18 [DEBUG] (1) wlink::device: Claimed interface 0 of USB device.
18:31:18 [INFO] WCH-Link v2.8 (WCH-LinkE-CH32V305)
18:31:18 [DEBUG] (1) wlink::operations: attached chip: ChipInfo { chip_family: CH32V20x, chip_type: "0x20360510" }
18:31:18 [DEBUG] (1) wlink::operations: Chip UID: cd-ab-b4-ae-45-bc-c6-16
18:31:18 [DEBUG] (1) wlink::operations: flash protected: false
18:31:18 [DEBUG] (1) wlink::operations: SRAM CODE mode: 3
18:31:18 [DEBUG] (1) wlink::operations: RISC-V core version: Some("WCH-V4B")
18:31:18 [INFO] Read memory from 0x08000000 to 0x08000064
08000000:   b7 00 00 08  67 80 80 00  73 50 40 30  73 50 40 34   ×00•g××0sP@0sP@4
08000010:   81 40 01 41  81 41 01 42  81 42 01 43  81 43 01 44   ×@•A×A•B×B•C×C•D
08000020:   81 44 81 46  01 47 81 47  01 48 81 48  01 49 81 49   ×D×F•G×G•H×H•I×I
08000030:   01 4a 81 4a  01 4b 81 4b  01 4c 81 4c  01 4d 81 4d   •J×J•K×K•L×L•M×M
08000040:   01 4e 81 4e  01 4f 81 4f  97 01 00 18  93 81 81 7b   •N×N•O×Oו0•×××{
08000050:   f3 23 40 f1  b7 02 00 00  93 82 02 00  63 f4 72 00   ×#@×ו00×ו0c×r0
08000060:   6f 00 c0 29                                          o0×)

> # Dump System FLASH, BOOT_28KB
> cargo run -- dump 0x1FFF8000 0x7000
....

> # Dump all general purpose registers
> cargo run -- regs
16:24:20 [INFO] Dump GPRs
dpc(pc):   0x2000011a
x0   zero: 0x00000000
x1     ra: 0x49c85c07
x2     sp: 0x20002800
x3     gp: 0x206e24c4
x4     tp: 0x9add07a3
x5     t0: 0xb4a9b38a
....


> # Set dpc(pc) to System Flash and Run - Not working :(
> cargo run -- write-reg 0x7b1 0x1fff8000

````

## References

- <https://github.com/openwch/ch32v003> RISC-V QingKeV2 Microprocessor Debug Manual
- <https://github.com/cnlohr/ch32v003fun> A miniwchlink implementation