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/32V30x/32V03x/32V10x/XNUMXVXNUMXx。

命令列

下載

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。垃圾桶	完整/相對路徑

筆記：

1. 所有指令和參數必須以“-x xxx”格式成對出現。
2. 下載或驗證操作需要傳入-p、-c、-o、-f指令。
3. 對於-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下載模式

1. 插入USB
   確保MCU處於BOOT下載模式，且USB設備的PID為0x55e0。
2. 安裝USB設備驅動程式
   開啟系統終端，進入驅動程式資料夾，執行“make install”指令。僅首次下載時需要執行此操作。
3. 確定 USB ISP 設備名稱
   使用ls指令檢查/dev/ch37x字元裝置是否存在。
4. 執行下載指令
   依照工具的指令格式要求執行，例如ample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o 程式 -f Target.hex

串口下載方式

1. 連接MCU與串口
   確保 MCU 處於 BOOT 下載模式。
2. 建立串行 ISP 設備名稱
   確認串口設備節點名稱，然後使用ln指令為該設備建立名為「ttyISPx」的軟連結。具體命令如下。 sudo ln –s /dev/ttyUSB0 /dev/ttyISP0
3. 執行下載指令。
   依照工具的指令格式要求執行，例如ample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o 程式 -f Target.hex

運行日誌 file

下載成功實例

下載失敗實例

單獨取得BOOT版本實例

單獨取得軟體版本實例

macOS 平台

操作說明

USB下載模式

1. 插入USB
   確保MCU處於BOOT下載模式，且USB設備的PID為0x55e0。
2. 確定USB設備在macOS系統中的位置ID。在系統報告->硬體->USB 中找到該設備。 USB裝置樹中的位置ID如下圖所示。
3. 執行下載指令
   依照工具的指令格式要求執行，例如ample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o 程式 -f Target.hex
   

串口下載方式

1. 連接MCU與串口
   確保 MCU 處於 BOOT 下載模式。
2. 確定裝置串口節點名稱，在裝置上執行「ls /dev/tty.*」指令
   終端機查看macOS串列埠（如果使用WCH串列晶片，請安裝macOS的CH34xVCP驅動）。具體操作如下圖所示。
   
3. 執行下載指令
   依照工具的指令格式要求執行，例如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 命令列程式設計工具, 命令列程式設計工具, 線路程式設計工具, 程式設計工具

參考

• 使用者手冊