
WCHISPTool CMD Command Line Programmering Tool

Inleiding
Sagteware funksie
WCHISPTool _ CMD is 'n multi-platform-opdragreëlinstrument vir WCH MCU-branding aanlyn, wat firmware-aflaai, verifikasie en ander bewerkings vir reeks MCU van WCH deur USB of seriële poort ondersteun. Die instrument bevat ISP-biblioteek en sample programme vir pasgemaakte ontwikkeling van ISP-instrument.
Ondersteunde bedryfstelsel: Windows x86/x64, Linux x64, macOS x64/arm64.
Ondersteunde skyfiemodel: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30X32x/03 CH32x/CH10.
Opdragreël
Laai af
USB -modus:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o program -f Target.hex
Seriepoortmodus:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o program -f Target.hex
Verifieer
USB -modus:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o verifieer -f Target.hex
Seriepoortmodus:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verifieer -f Target.hex
Parameterbeskrywing
| -p |
Instruksie |
Beskrywing van parameters |
|
| USB ISP-toestel of reekstoestelnodus | /dev/ch37x /dev/ttyISPx | Laai af via USB in Linux Laai af via seriële poort in Linux | |
| LigginglD COM(/dev/tty.*) | Laai af via USB in macOS Laai af via seriële poort in macOS | ||
| -b | Kommunikasie baud rate van seriële poort | 115200/230400/ | Kommunikasie baud rate van seriële poort |
| -v | Drukweergawenommer | selflaai/gereedskap | Die selflaai-/gereedskapweergawe |
| -c | Die volledige padnaam van die konfigurasie file | xxx.ini | Die volle/relatiewe pad |
| -o | Die tipe operasie | program/verifieer | Laai af/verifieer |
| -f | Die naam van Flash file | xxx. heks/xxx. bin | Die volle/relatiewe pad |
Notas:
- Alle opdragte en parameters moet in pare in die formaat "-x xxx" verskyn.
- Aflaai of verifieer bewerking word vereis om in -p,-c,-o,-f instruksies deur te gee.
- Vir die bevestigingsmetode van die USB ISP-toestel of reekspoortnodusnaam wat ooreenstem met die – p-opdrag,
Status kode
| Instruksie beskrywing | Beskrywing van parameters |
| 0 | Voer suksesvol uit |
| 1 | Ongeldige invoerparameter |
| 2 | Kon nie parameters van die opstelling af kry nie file |
| 3 | Kon nie ISP-parameters stel nie |
| 4 | Die gespesifiseerde reekspoortnaam is ongeldig |
| 5 | Geen toestel opgesom nie |
| 6 | Die gespesifiseerde chip tipe stem nie ooreen met die werklike chip tipe nie |
| 7 | Kon nie die toestelinligting kry nie |
| 8 | Ongeldige flits file pad |
| 9 | Ongeldige flits file lengte |
| 10 | Kon nie die flits lees nie file |
| 11 | Kon nie die Flash omskakel nie file van HEX na BIN-formaat |
| 12 | Kon nie leesbeskerming deaktiveer nie |
| 13 | Kon nie aflaai nie |
| 14 | Kon nie verifieer nie |
| 100 | Onbekende fout |
Konfigurasie file
Die konfigurasie file word gegenereer deur die "Save UI Config"-funksie van WchIspStudio.exe in Windows. Die spesifieke bewerkings is soos volg: Maak eers die sagteware oop en kies MCU-reeks aan die regterkant van die sagteware. Kies dan die reeks en model van die skyfie in die koppelvlak van "Chip Option" en stel die skyfie op in die koppelvlak van "Download Config". Klik dan op die hoofkieslys "File -> Stoor UI-konfigurasie”. Kies uiteindelik die naam en ligging van die konfigurasie file. Die operasie-koppelvlak is soos volg.

Pasgemaakte ontwikkeling
Die src-gids in elke stelselgids bevat die bron files van die opdragreël-brandinstrument, wat direk ontwikkel kan word op grond van hierdie kode om aan die persoonlike vraag van gebruikers te voldoen. Die lib-gids bevat die ISP-ontwikkelingsdinamiese biblioteek en kop files. Vir funksies en oproepinstruksies kan gebruikers na WCH55XISPDLL verwys. H en ander kop files in die lib-gids.
Windows-platform
Vir besonderhede, verwys asseblief na: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html installeer pad \ WCHISPTool_XXX\Doc.
Linux platform
Instruksie
USB-aflaaimodus
- Prop USB
Maak seker dat MCU in BOOT-aflaaimodus is en dat PID van USB-toestel 0x55e0 is. - Installeer USB-toestelbestuurder
Maak die stelselterminal oop, voer die bestuurderlêergids in en voer die "maak installeer" opdrag uit. Hierdie operasie word slegs benodig vir die eerste aflaai. - Bepaal USB ISP toestel naam
Gebruik die "ls"-opdrag om te kyk of die /dev/ch37x-karaktertoestel bestaan. - Voer aflaaiinstruksie uit
Voer uit volgens die instruksieformaatvereistes van die instrument, bvample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o program -f Target.hex
Seriepoort aflaaimodus
- Koppel MCU met seriële poort
Maak seker dat MCU in BOOT-aflaaimodus is. - Skep seriële ISP-toestelnaam
Bevestig die nodusnaam van die reekspoorttoestel, en gebruik dan die "ln"-opdrag om 'n sagte skakel genaamd "ttyISPx" vir hierdie toestel te skep. Die spesifieke opdrag is soos volg. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Voer aflaaiinstruksie uit.
Voer uit volgens die instruksieformaatvereistes van die instrument, bvample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o program -f Target.hex
Begin log file
Die geval van suksesvolle aflaaibewerking

Die geval van mislukte aflaaibewerking

Die geval om die BOOT-weergawe afsonderlik te kry

Die geval om die sagteware weergawe afsonderlik te kry

macOS-platform
Instruksie
USB-aflaaimodus
- Prop USB
Maak seker dat MCU in BOOT-aflaaimodus is en dat PID van USB-toestel 0x55e0 is. - Bepaal die ligging-ID van die USB-toestel in die macOS-stelsel. Vind die toestel in die Stelselverslag ->Hardware ->USB. Die ligging-ID in die USB-toestelboom word in die volgende figuur getoon.
- Voer aflaaiinstruksie uit
Voer uit volgens die instruksieformaatvereistes van die instrument, bvample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o program -f Target.hex

Seriepoort aflaaimodus
- Koppel MCU met seriële poort
Maak seker dat MCU in BOOT-aflaaimodus is. - Bepaal die nodusnaam van die seriële poort op die toestel, en voer die “ls /dev/tty.*”-opdrag op die
terminaal om die seriële poort op die macOS na te gaan (As die WCH-reekspoortskyfie gebruik word, installeer die CH34xVCPDriver van die macOS). 'n Spesifieke bewerking word in die figuur hieronder getoon.

- Voer aflaaiinstruksie uit
Voer uit volgens die instruksieformaatvereistes van die instrument, bvample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o program -f Target.hex
Begin log file
Die geval van suksesvolle aflaaibewerking

Die geval van mislukte aflaaibewerking

Die geval om die BOOT-weergawe afsonderlik te kry

Die geval om die sagteware weergawe afsonderlik te kry


Dokumente / Hulpbronne
![]() | WCHISPTool CMD Command Line Programmering Tool |
Verwysings
- 南京沁恒微电子股份有限公司wch.cn
- WCHISPTool_Setup.exe - 南京沁恒微电子股份有限公司www.wch.cn
- Gebruikershandleidingmanual.tools
