WCHISPTool CMD kommandolinjeprogrammeringsværktøj
Indledning
Software funktion
WCHISPTool _ CMD er et multi-platform kommandolinjeværktøj til WCH MCU-brænding online, som understøtter firmwaredownload, verifikation og andre operationer for serie MCU af WCH via USB eller seriel port. Værktøjet indeholder ISP-bibliotek og sample programmer til skræddersyet udvikling af ISP-værktøj.
Understøttet operativsystem: Windows x86/x64, Linux x64, macOS x64/arm64.
Understøttet chipmodel: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30X32x/03 CH32x/CH10.
Kommandolinje
Download
USB -tilstand:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o program -f Target.hex
Seriel porttilstand:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o program -f Target.hex
Verificere
USB -tilstand:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o verify -f Target.hex
Seriel porttilstand:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verify -f Target.hex
Parameterbeskrivelse
-p |
Instruktion |
Beskrivelse af parametre |
|
USB ISP-enhed eller seriel enhedsknude | /dev/ch37x /dev/ttyISPx | Download via USB i Linux Download via seriel port i Linux | |
Beliggenhed lD COM(/dev/tty.*) | Download via USB i macOS Download via seriel port i macOS | ||
-b | Kommunikationsbaudrate for seriel port | 115200/230400/ | Kommunikationsbaudrate for seriel port |
-v | Udskriftsversionsnummer | støvle/værktøj | Boot/værktøjsversionen |
-c | Konfigurationens fulde stinavn file | xxx.ini | Den fulde/relative vej |
-o | Operationstypen | programmere/bekræfte | Download/Bekræft |
-f | Navnet på Flash file | xxx. hex/xxx. beholder | Den fulde/relative vej |
Bemærkninger:
- Alle kommandoer og parametre skal vises i par i formatet "-x xxx".
- Download eller bekræft handling er påkrævet for at sende -p,-c,-o,-f instruktioner.
- Til bekræftelsesmetoden for USB ISP-enheden eller den serielle portnodenavn, der svarer til kommandoen – p,
Statuskode
Instruktionsbeskrivelse | Beskrivelse af parametre |
0 | Udfør succesfuldt |
1 | Ugyldig inputparameter |
2 | Kunne ikke hente parametre fra konfigurationen file |
3 | Kunne ikke indstille ISP-parametre |
4 | Det angivne serielle portnavn er ugyldigt |
5 | Ingen enhed opregnet |
6 | Den angivne chiptype stemmer ikke overens med den faktiske chiptype |
7 | Kunne ikke hente enhedsoplysningerne |
8 | Ugyldig Flash file sti |
9 | Ugyldig Flash file længde |
10 | Kunne ikke læse Flash file |
11 | Kunne ikke konvertere Flash file fra HEX til BIN-format |
12 | Kunne ikke deaktivere læsebeskyttelse |
13 | Kunne ikke downloade |
14 | Kunne ikke bekræftes |
100 | Ukendt fejl |
Konfiguration file
Konfigurationen file genereres af funktionen "Save UI Config" i WchIspStudio.exe i Windows. De specifikke handlinger er som følger: Åbn først softwaren og vælg MCU-serien på højre side af softwaren. Vælg derefter serie og model af chippen i grænsefladen til "Chip Option" og konfigurer chippen i grænsefladen til "Download Config". Klik derefter på hovedmenuen "File ->Gem UI Config”. Til sidst skal du vælge navnet og placeringen af konfigurationen file. Betjeningsgrænsefladen er som følger.
Tilpasset udvikling
src-mappen i hver systemmappe indeholder kilden files af kommandolinjebrændingsværktøjet, som kan udvikles direkte baseret på denne kode for at imødekomme brugernes tilpassede efterspørgsel. Biblioteket indeholder det dynamiske bibliotek og header for udvikling af internetudbyderen files. For funktioner og opkaldsinstruktioner kan brugere henvise til WCH55XISPDLL. H og anden header files i biblioteket lib.
Windows-platformen
For detaljer, se venligst: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html installationsstien \ WCHISPTool_XXX\Doc.
Linux platform
Instruktion
USB-downloadtilstand
- Tilslut USB
Sørg for, at MCU er i BOOT-downloadtilstand, og at USB-enhedens PID er 0x55e0. - Installer USB-enhedsdriver
Åbn systemterminalen, indtast drivermappen, og udfør kommandoen "make install". Denne handling er kun nødvendig for den første download. - Bestem USB ISP-enhedsnavnet
Brug kommandoen "ls" til at kontrollere, om /dev/ch37x-tegnenheden eksisterer. - Udfør downloadinstruktion
Udfør i henhold til instruktionsformatkravene for værktøjet, f.eksample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o program -f Target.hex
Downloadtilstand til seriel port
- Tilslut MCU med seriel port
Sørg for, at MCU er i BOOT-downloadtilstand. - Opret seriel ISP enhedsnavn
Bekræft den serielle portenheds nodenavn, og brug derefter "ln"-kommandoen til at oprette et blødt link med navnet "ttyISPx" for denne enhed. Den specifikke kommando er som følger. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Udfør downloadinstruktion.
Udfør i henhold til instruktionsformatkravene for værktøjet, f.eksample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o program -f Target.hex
Kør log file
Forekomsten af vellykket download
Forekomsten af mislykket downloadoperation
Forekomsten af at få BOOT-versionen separat
Forekomsten af at få softwareversionen separat
macOS platform
Instruktion
USB-downloadtilstand
- Tilslut USB
Sørg for, at MCU er i BOOT-downloadtilstand, og at USB-enhedens PID er 0x55e0. - Bestem placerings-id'et for USB-enheden i macOS-systemet. Find enheden i Systemrapporten ->Hardware ->USB. Placerings-id'et i USB-enhedstræet er vist i følgende figur.
- Udfør downloadinstruktion
Udfør i henhold til instruktionsformatkravene for værktøjet, f.eksample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o program -f Target.hex
Downloadtilstand til seriel port
- Tilslut MCU med seriel port
Sørg for, at MCU er i BOOT-downloadtilstand. - Bestem nodenavnet på den serielle port på enheden, og kør kommandoen "ls /dev/tty.*" på
terminal for at kontrollere den serielle port på macOS (Hvis WCH seriel port-chippen bruges, skal du installere CH34xVCPDriver til macOS). En specifik operation er vist i figuren nedenfor.
- Udfør downloadinstruktion
Udfør i henhold til instruktionsformatkravene for værktøjet, f.eksample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o program -f Target.hex
Kør log file
Forekomsten af vellykket download
Forekomsten af mislykket downloadoperation
Forekomsten af at få BOOT-versionen separat
Forekomsten af at få softwareversionen separat
Dokumenter/ressourcer
![]() |
WCH WCHISPTool CMD kommandolinjeprogrammeringsværktøj [pdf] Instruktioner WCHISPTool CMD kommandolinjeprogrammeringsværktøj, WCHISPTool, CMD kommandolinjeprogrammeringsværktøj, kommandolinjeprogrammeringsværktøj, linjeprogrammeringsværktøj, programmeringsværktøj |