WCH-Link命令行工具使用教程

WCH-Link命令行工具使用教程

wlink An open source WCH-Link library/command line tool written in Rust. 项目地址: https://gitcode.com/gh_mirrors/wl/wlink

1. 项目介绍

WCH-Link是一个开源的命令行工具，用于与WCH公司的调试器进行通信，支持闪存编程、擦除芯片、读取芯片信息等功能。本项目使用Rust语言编写，旨在提供一个稳定、易用的工具，帮助开发者更高效地进行嵌入式开发。

2. 项目快速启动

安装

首先，确保你的系统中已经安装了Rust编译器和对应的依赖库。

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

对于Linux系统，你可能需要先安装libudev和libusb开发库：

sudo apt install libudev-dev libusb-1.0-0-dev

使用

以下是几个基本的使用示例：

编程闪存

将firmware.bin文件编程到芯片的Code FLASH地址0x08000000。

wlink flash --address 0x08000000 ./firmware.bin

启用SDI打印并监视串口

编程firmware.bin文件，同时启用SDI打印，并监视串口输出。

wlink flash --enable-sdi-print --watch-serial firmware.bin

芯片信息读取

读取并显示芯片信息。

wlink info

3. 应用案例和最佳实践

闪存编程

在嵌入式开发中，经常需要将固件更新到设备中。使用wlink可以轻松实现这一操作。确保使用正确的固件格式（HEX、ELF或二进制）和目标地址。

芯片调试

通过读取和写入芯片寄存器，可以更深入地了解程序的行为，这对于调试非常有用。

wlink read-reg 0x7b1
wlink write-reg 0x7b1 0x000009a8

芯片保护

对于需要保护的代码，可以使用wlink提供的代码保护和取消保护功能。

wlink code-protect
wlink code-unprotect

4. 典型生态项目

WCH-Link工具可以与多个开源项目配合使用，例如：

• openocd-hacks：WCH的openocd分支，用于芯片调试。
• 其他Rust编写的嵌入式工具和库，如ch32-rs系列项目。

通过这些工具和库，开发者可以构建出一个强大的嵌入式开发环境。

wlink An open source WCH-Link library/command line tool written in Rust. 项目地址: https://gitcode.com/gh_mirrors/wl/wlink