WCHISPTool CMD 命令行编程工具
介绍
软件功能
WCHISPTool_CMD是一款用于WCH单片机在线烧录的多平台命令行工具，支持通过USB或串口对WCH系列单片机进行固件下载、验证等操作。该工具包含ISP库和samp用于定制开发ISP工具的文件程序。
支持的操作系统：Windows x86/x64、Linux x64、macOS x64/arm64。
支持的芯片型号：CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32X03x/ CH32L10x。
命令行
下载
USB模式：
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o 程序 -f Target.hex
串口模式：
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o 程序 -f Target.hex
核实
USB模式：
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o 验证 -f Target.hex
串口模式：
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o 验证 -f Target.hex
参数说明
| -p |
操作说明 |
参数说明 |
|
| USB ISP 设备或串行设备节点 | /dev/ch37x /dev/ttyISPx | Linux下通过USB下载 Linux下通过串口下载 | |
| 位置ID COM(/dev/tty.*) | 在 macOS 中通过 USB 下载 在 macOS 中通过串口下载 | ||
| -b | 串口通讯波特率 | 115200/230400/ | 串口通讯波特率 |
| -v | 打印版本号 | 启动/工具 | 启动/工具版本 |
| -c | 配置的完整路径名 file | xxx.ini | 完整/相对路径 |
| -o | 操作类型 | 编程/验证 | 下载/验证 |
| -f | 闪光的名字 file | xxx。十六进制/xxx。垃圾桶 | 完整/相对路径 |
笔记：
- 所有命令和参数必须以“-x xxx”格式成对出现。
- 下载或验证操作需要传入-p、-c、-o、-f指令。
- 对于-p命令对应的USB ISP设备或串口节点名称的确认方法，
状态代码
| 指令说明 | 参数说明 |
| 0 | 执行成功 |
| 1 | 输入参数无效 |
| 2 | 无法从配置中获取参数 file |
| 3 | 设置ISP参数失败 |
| 4 | 指定的串口名称无效 |
| 5 | 没有枚举设备 |
| 6 | 指定芯片类型与实际芯片类型不一致 |
| 7 | 获取设备信息失败 |
| 8 | 无效闪存 file 小路 |
| 9 | 无效闪存 file 长度 |
| 10 | 读取Flash失败 file |
| 11 | 转换Flash失败 file 从 HEX 到 BIN 格式 |
| 12 | 无法禁用读保护 |
| 13 | 下载失败 |
| 14 | 验证失败 |
| 100 | 未知错误 |
配置 file
配置 file 由 Windows 中 WchIspStudio.exe 的“Save UI Config”功能生成。具体操作如下：首先打开软件，在软件右侧选择MCU系列。接下来，在“Chip Option”界面中选择芯片的系列和型号，并在“Download Config”界面中对芯片进行配置。然后点击主菜单“File ->保存用户界面配置”。最后选择配置的名称和位置 file。操作界面如下。
定制开发
每个系统文件夹中的 src 目录包含源代码 file命令行烧写工具的s，可以直接基于该代码进行开发，满足用户的定制化需求。 lib目录包含ISP开发动态库和头文件 files。对于函数和调用指令，用户可以参考WCH55XISPDLL。 H 和其他标头 file位于 lib 目录中。
Windows平台
详情请参阅： https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html 安装路径\WCHISPTool_XXX\Doc。
Linux 平台
操作说明
USB下载模式
- 插入USB
确保MCU处于BOOT下载模式，且USB设备的PID为0x55e0。 - 安装USB设备驱动程序
打开系统终端，进入驱动文件夹，执行“make install”命令。仅首次下载时需要执行此操作。 - 确定 USB ISP 设备名称
使用ls命令检查/dev/ch37x字符设备是否存在。 - 执行下载指令
按照工具的指令格式要求执行，例如ample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o 程序 -f Target.hex
串口下载方式
- 连接MCU与串口
确保 MCU 处于 BOOT 下载模式。 - 创建串行 ISP 设备名称
确认串口设备节点名称，然后使用ln命令为该设备创建名为“ttyISPx”的软链接。具体命令如下。 sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - 执行下载指令。
按照工具的指令格式要求执行，例如ample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o 程序 -f Target.hex
运行日志 file
下载成功实例
下载失败实例
单独获取BOOT版本实例
单独获取软件版本实例
macOS 平台
操作说明
USB下载模式
- 插入USB
确保MCU处于BOOT下载模式，且USB设备的PID为0x55e0。 - 确定USB设备在macOS系统中的位置ID。在系统报告->硬件->USB 中找到该设备。 USB设备树中的位置ID如下图所示。
- 执行下载指令
按照工具的指令格式要求执行，例如ample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o 程序 -f Target.hex
串口下载方式
- 连接MCU与串口
确保 MCU 处于 BOOT 下载模式。 - 确定设备串口节点名称，在设备上执行“ls /dev/tty.*”命令
终端查看macOS串口（如果使用WCH串口芯片，请安装macOS的CH34xVCP驱动）。具体操作如下图所示。
- 执行下载指令
按照工具的指令格式要求执行，例如ample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o 程序 -f Target.hex
运行日志 file
下载成功实例
下载失败实例
单独获取BOOT版本实例
单独获取软件版本实例
文件/资源
 |
WCH WCHISPTool CMD 命令行编程工具 [pdf] 指示 WCHISPTool CMD 命令行编程工具, WCHISPTool, CMD 命令行编程工具, 命令行编程工具, 线路编程工具, 编程工具 |
