WCHISPTool CMD Command Line Programming Tool
Ynlieding
Software funksje
WCHISPTool _ CMD is in multi-platfoarm kommandorigelark foar WCH MCU online ferbaarnen, dat firmware-download, ferifikaasje en oare operaasjes foar searjes MCU fan WCH stipet fia USB as seriële poarte. It ark befettet ISP bibleteek en sample programma foar maatwurk ûntwikkeling fan ISP ark.
Stipe bestjoeringssysteem: Windows x86/x64, Linux x64, macOS x64/arm64.
Stipe chipmodel: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30X32x/03x CH32/CH10.
Kommandorigel
Download
USB -modus:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o programma -f Target.hex
Serial poarte modus:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o programma -f Target.hex
Ferifiearje
USB -modus:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o ferifiearje -f Target.hex
Serial poarte modus:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o ferifiearje -f Target.hex
Parameter beskriuwing
| -p |
Ynstruksje |
Parameter beskriuwing |
|
| USB ISP apparaat of serial apparaat node | /dev/ch37x /dev/ttyISPx | Download fia USB yn Linux Download fia seriële poarte yn Linux | |
| Lokaasje D COM(/dev/tty.*) | Download fia USB yn macOS Download fia seriële poarte yn macOS | ||
| -b | Kommunikaasje baud rate fan serial haven | 115200/230400/ | Kommunikaasje baud rate fan serial haven |
| -v | Print ferzje nûmer | boot / ark | De boot/ark ferzje |
| -c | De folsleine paadnamme fan 'e konfiguraasje file | xxx.ini | It folsleine / relative paad |
| -o | It type operaasje | programma / ferifiearje | Download / Ferifiearje |
| -f | Namme fan Flash file | xxx. hex/xxx. bin | It folsleine / relative paad |
Notysjes:
- Alle kommando's en parameters moatte yn pearen ferskine yn it formaat "-x xxx".
- Download of ferifiearje operaasje is fereaske om yn -p,-c,-o,-f ynstruksjes troch te jaan.
- Foar de befêstigingsmetoade fan it USB ISP-apparaat of de namme fan 'e seriële poarteknooppunt dy't oerienkomt mei it kommando - p,
Status koade
| Ynstruksje beskriuwing | Parameter beskriuwing |
| 0 | Mei súkses útfiere |
| 1 | Unjildige ynfierparameter |
| 2 | It heljen fan parameters út de konfiguraasje is mislearre file |
| 3 | It ynstellen fan ISP-parameters is mislearre |
| 4 | De opjûne seriële poartenamme is ûnjildich |
| 5 | Gjin apparaat opnomd |
| 6 | De oantsjutte chip type is net yn oerienstimming mei de eigentlike chip type |
| 7 | It opheljen fan de apparaatynformaasje is net slagge |
| 8 | Unjildige Flash file paad |
| 9 | Unjildige Flash file lingte |
| 10 | It lêzen fan de Flash is net slagge file |
| 11 | It konvertearjen fan de Flash is net slagge file fan HEX nei BIN-formaat |
| 12 | It útskeakeljen fan lêsbeskerming is net slagge |
| 13 | It ynladen is mislearre |
| 14 | Ferifiearje mislearre |
| 100 | Ûnbekende fout |
Konfiguraasje file
De konfiguraasje file wurdt generearre troch de funksje "Bewarje UI Config" fan WchIspStudio.exe yn Windows. De spesifike operaasjes binne as folget: Earst iepenje de software en selektearje MCU-searje oan 'e rjochterkant fan' e software. Selektearje dan searje en model fan 'e chip yn' e ynterface fan "Chip Option" en konfigurearje de chip yn 'e ynterface fan "Download Config". Klikje dan op it haadmenu "File -> UI-konfiguraasje opslaan". Selektearje úteinlik de namme en lokaasje fan 'e konfiguraasje file. De operaasje ynterface is as folget.
Oanpaste ûntwikkeling
De src-map yn elke systeemmap befettet de boarne files fan de kommandorigel baarnende ark, dat kin direkt ûntwikkele wurde basearre op dizze koade te foldwaan oan de oanpaste fraach fan brûkers. De lib-map befettet de ISP-ûntwikkelingsdynamyske bibleteek en koptekst files. Foar funksjes en opropynstruksjes kinne brûkers ferwize nei WCH55XISPDLL. H en oare koptekst files yn 'e lib-map.
Windows Platfoarm
Foar details, ferwize nei: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html ynstallearje paad \ WCHISPTool_XXX\Doc.
Linux Platfoarm
Ynstruksje
USB download modus
- Plug USB
Soargje derfoar dat MCU yn BOOT-downloadmodus is, en PID fan USB-apparaat is 0x55e0. - Ynstallearje USB apparaat stjoerprogramma
Iepenje de systeemterminal, fier de map fan de bestjoerder yn en fier it kommando "ynstallearje meitsje". Dizze operaasje is allinich nedich foar de earste download. - Bepale USB ISP apparaat namme
Brûk it kommando "ls" om te kontrolearjen oft it /dev/ch37x-karakterapparaat bestiet. - Utfiere download ynstruksje
Utfiere neffens de easken foar ynstruksjeformaat fan it ark, bygelyksample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o programma -f Target.hex
Serial port download modus
- Ferbine MCU mei seriële poarte
Soargje derfoar dat MCU yn BOOT-downloadmodus is. - Meitsje serial ISP apparaat namme
Befêstigje de knooppuntnamme fan it seriële poarte-apparaat, en brûk dan it kommando "ln" om in sêfte keppeling te meitsjen mei de namme "ttyISPx" foar dit apparaat. It spesifike kommando is as folget. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Utfiere download ynstruksje.
Utfiere neffens de easken foar ynstruksjeformaat fan it ark, bygelyksample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o programma -f Target.hex
Run log file
It eksimplaar fan suksesfolle downloadoperaasje
It eksimplaar fan mislearre downloadoperaasje
It eksimplaar om de BOOT-ferzje apart te krijen
It eksimplaar om de softwareferzje apart te krijen
macOS Platfoarm
Ynstruksje
USB download modus
- Plug USB
Soargje derfoar dat MCU yn BOOT-downloadmodus is, en PID fan USB-apparaat is 0x55e0. - Bepale de lokaasje-ID fan it USB-apparaat yn it macOS-systeem. Fyn it apparaat yn it Systeemrapport ->Hardware ->USB. De lokaasje-ID yn 'e USB-apparaatbeam wurdt werjûn yn' e folgjende figuer.
- Utfiere download ynstruksje
Utfiere neffens de easken foar ynstruksjeformaat fan it ark, bygelyksample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o programma -f Target.hex
Serial port download modus
- Ferbine MCU mei seriële poarte
Soargje derfoar dat MCU yn BOOT-downloadmodus is. - Bepaal de knooppuntnamme fan 'e seriële poarte op it apparaat, en fier it kommando "ls /dev/tty.*" op de
terminal om de seriële poarte op 'e macOS te kontrolearjen (As de WCH-seriële poarte-chip wurdt brûkt, ynstallearje dan de CH34xVCPDriver fan' e macOS). In spesifike operaasje wurdt werjûn yn 'e figuer hjirûnder.
- Utfiere download ynstruksje
Utfiere neffens de easken foar ynstruksjeformaat fan it ark, bygelyksample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o programma -f Target.hex
Run log file
It eksimplaar fan suksesfolle downloadoperaasje
It eksimplaar fan mislearre downloadoperaasje
It eksimplaar om de BOOT-ferzje apart te krijen
It eksimplaar om de softwareferzje apart te krijen
Dokuminten / Resources
 |
WCH WCHISPTool CMD Command Line Programming Tool [pdfYnstruksjes WCHISPTool CMD Command Line Programming Tool, WCHISPTool, CMD Command Line Programming Tool, Command Line Programming Tool, Line Programming Tool, Programming Tool |
