Strumentu di prugrammazione in linea di cummandu WCHISPTool CMD
Introduzione
Funzione di u software
WCHISPTool _ CMD hè un strumentu di linea di cummanda multi-piattaforma per WCH MCU brusgiatu in linea, chì sustene u scaricamentu di firmware, a verificazione è altre operazioni per a serie MCU di WCH attraversu USB o portu seriale. U strumentu cuntene libreria ISP è sampi prugrammi per u sviluppu persunalizatu di l'uttellu ISP.
Sistema operatore supportatu: Windows x86/x64, Linux x64, macOS x64/arm64.
Modellu di chip supportatu: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32V03Lx/ CH32X.
Linea di cumanda
Scaricate
Modu USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o program -f Target.hex
Modu di portu seriale:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o prugramma -f Target.hex
Verificate
Modu USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o verify -f Target.hex
Modu di portu seriale:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verifica -f Target.hex
Descrizione di u parametru
| -p |
Istruzzioni |
Descrizzione di i paràmetri |
|
| Dispositivo ISP USB o nodu di u dispositivu seriale | /dev/ch37x /dev/ttyISPx | Scaricate via USB in Linux Scaricate via portu seriale in Linux | |
| Locu d COM(/dev/tty.*) | Scaricate via USB in macOS Scaricate via u portu seriale in macOS | ||
| -b | Baud rate di cumunicazione di u portu seriale | 115200/230400/ | Baud rate di cumunicazione di u portu seriale |
| -v | Numero di versione stampata | boot / strumentu | A versione boot / tool |
| -c | U nome di u percorsu tutale di a cunfigurazione file | xxx.ini | U percorsu pienu / relativo |
| -o | U tipu di operazione | prugramma / verificate | Scaricate / Verificate |
| -f | U nome di Flash file | xxx. hex/xxx. bin | U percorsu pienu / relativo |
Note:
- Tutti i cumandamenti è i paràmetri devenu apparsu in coppie in u furmatu "-x xxx".
- Scaricate o verificate l'operazione hè necessaria per passà in -p,-c,-o,-f instructions.
- Per u metudu di cunferma di u dispositivu ISP USB o u nome di u nodu di u portu seriale chì currisponde à u cumandimu - p,
Codice di statutu
| Descrizzione di l'istruzzioni | Descrizzione di i paràmetri |
| 0 | Eseguite cù successu |
| 1 | Parametru di input invalidu |
| 2 | Impossibile ottene i paràmetri da a cunfigurazione file |
| 3 | Impossible di stabilisce i paràmetri ISP |
| 4 | U nome di u portu seriale specificatu ùn hè micca validu |
| 5 | Nisun dispositivu enumeratu |
| 6 | U tipu di chip specificatu ùn hè micca coherente cù u tipu di chip attuale |
| 7 | Fiascu à ottene l'infurmazioni di u dispusitivu |
| 8 | Flash invalidu file caminu |
| 9 | Flash invalidu file lunghezza |
| 10 | Impossible di leghje u Flash file |
| 11 | Fiascu à cunvertisce u Flash file da u formatu HEX à BIN |
| 12 | Fiascatu di disattivà a prutezzione di lettura |
| 13 | Fiascatu di scaricà |
| 14 | Fiascatu à verificà |
| 100 | Errore scunnisciutu |
Cunfigurazione file
A cunfigurazione file hè generatu da a funzione "Salvà UI Config" di WchIspStudio.exe in Windows. L'operazioni specifiche sò i seguenti: Prima, apre u software è selezziunate a serie MCU à u latu drittu di u software. Dopu, selezziunate a serie è u mudellu di u chip in l'interfaccia di "Chip Option" è cunfigurà u chip in l'interfaccia di "Download Config". Poi cliccate nant'à u menù principale "File -> Salvà a cunfigurazione UI". Finalmente selezziunate u nome è u locu di a cunfigurazione file. L'interfaccia di u funziunamentu hè a siguenti.
Sviluppu persunalizatu
U cartulare src in ogni cartulare di u sistema cuntene a fonte files di u strumentu brucia ligna cummanda, chì pò esse sviluppatu direttamente basatu nant'à stu codice à scuntrà a dumanda persunalizata di utilizatori. U repertoriu lib cuntene a biblioteca dinamica di sviluppu ISP è l'intestazione files. Per funzioni è struzzioni di chjamate, l'utilizatori puderanu riferite à WCH55XISPDLL. H è altre intestazione files in u cartulare lib.
Piattaforma Windows
Per i dettagli, fate riferimentu à: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html stallà a strada \ WCHISPTool_XXX \ Doc.
Piattaforma Linux
Istruzzioni
Modu di scaricamentu USB
- Plug USB
Assicuratevi chì MCU sia in modalità di scaricamentu BOOT, è PID di u dispositivu USB hè 0x55e0. - Installa u driver di u dispusitivu USB
Aprite u terminal di u sistema, entre in u cartulare di u driver, è eseguite u cumandimu "make install". Questa operazione hè necessaria solu per a prima scaricata. - Determina u nome di u dispositivu USB ISP
Aduprate u cumandamentu "ls" per verificà se u dispositivu di caratteri / dev/ch37x esiste. - Eseguite l'istruzzioni di scaricamentu
Eseguite secondu i requisiti di furmatu di istruzzioni di l'uttellu, per esample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o prugramma -f Target.hex
Modu di scaricamentu di u portu seriale
- Cunnette MCU cù u portu seriale
Assicuratevi chì MCU sia in modalità di scaricamentu BOOT. - Crea u nome di u dispositivu ISP seriale
Cunfirmà u nome di u nodu di u dispositivu di u portu seriale, è dopu aduprate u cumandimu "ln" per creà un ligame suave chjamatu "ttyISPx" per stu dispusitivu. U cumandamentu specificu hè u seguitu. sudo ln -s /dev/ttyUSB0 /dev/ttyISP0 - Eseguite l'istruzzioni di scaricamentu.
Eseguite secondu i requisiti di furmatu di istruzzioni di l'uttellu, per esample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o program -f Target.hex
Run log file
L'esempiu di l'operazione di scaricamentu successu
L'istanza di l'operazione di scaricamentu falluta
L'esempiu di uttene a versione BOOT separatamente
L'esempiu di uttene a versione di u software separatamente
piattaforma macOS
Istruzzioni
Modu di scaricamentu USB
- Plug USB
Assicuratevi chì MCU sia in modalità di scaricamentu BOOT, è PID di u dispositivu USB hè 0x55e0. - Determina l'ID di locu di u dispositivu USB in u sistema macOS. Truvate u dispusitivu in u System Report -> Hardware -> USB. L'ID di locu in l'arburu di u dispositivu USB hè mostratu in a figura seguente.
- Eseguite l'istruzzioni di scaricamentu
Eseguite secondu i requisiti di furmatu di istruzzioni di l'uttellu, per esample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o prugramma -f Target.hex
Modu di scaricamentu di u portu seriale
- Cunnette MCU cù u portu seriale
Assicuratevi chì MCU sia in modalità di scaricamentu BOOT. - Determina u nome di u nodu di u portu seriale nantu à u dispusitivu, è eseguite u cumandamentu "ls /dev/tty.*" nantu à u dispusitivu.
terminal per verificà u portu seriale in u macOS (Se u chip di portu seriale WCH hè utilizatu, installate u CH34xVCPDriver di u macOS). Una operazione specifica hè mostrata in a figura sottu.
- Eseguite l'istruzzioni di scaricamentu
Eseguite secondu i requisiti di furmatu di istruzzioni di l'uttellu, per esample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o prugramma -f Target.hex
Run log file
L'esempiu di l'operazione di scaricamentu successu
L'istanza di l'operazione di scaricamentu falluta
L'esempiu di uttene a versione BOOT separatamente
L'esempiu di uttene a versione di u software separatamente
Documenti / Risorse
 |
WCH WCHISPTool CMD Strumentu di prugrammazione in linea di cummandu [pdf] Istruzzioni Strumentu di prugrammazione di linea di cummandu WCHISPTool CMD, WCHISPTool, Strumentu di prugrammazione di linea di cummandu CMD, Strumentu di prugrammazione di linea di cummandu, Strumentu di prugrammazione in linea, Strumentu di prugrammazione |
