Ferramenta de programación da liña de comandos WCHISPTool CMD
Introdución
Función de software
WCHISPTool _ CMD é unha ferramenta de liña de comandos multiplataforma para gravar WCH MCU en liña, que admite a descarga de firmware, verificación e outras operacións para MCU serie de WCH a través de USB ou porto serie. A ferramenta contén biblioteca do ISP e sample programas para o desenvolvemento personalizado da ferramenta ISP.
Sistema operativo compatible: Windows x86/x64, Linux x64, macOS x64/arm64.
Modelo de chip compatible: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32V03x/ CH32V10x/ CHXNUMXVXNUMXx/ CHXNUMXVXNUMXx/
Liña de comandos
Descargar
Modo USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o program -f Target.hex
Modo de porto serie:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o program -f Target.hex
Verifica
Modo USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o verificar -f Target.hex
Modo de porto serie:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verificar -f Target.hex
Descrición do parámetro
| -p |
Instrución |
Descrición dos parámetros |
|
| Dispositivo ISP USB ou nodo do dispositivo en serie | /dev/ch37x /dev/ttyISPx | Descarga a través de USB en Linux Descarga a través do porto serie en Linux | |
| Localización D COM(/dev/tty.*) | Descarga a través de USB en macOS Descarga a través do porto serie en macOS | ||
| -b | Velocidade en baudios de comunicación do porto serie | 115200/230400/ | Velocidade en baudios de comunicación do porto serie |
| -v | Número de versión impresa | arranque/ferramenta | A versión de arranque/ferramenta |
| -c | O nome completo da ruta da configuración file | xxx.ini | O camiño completo/relativo |
| -o | O tipo de operación | programa/verificar | Descargar/Verificar |
| -f | O nome de Flash file | xxx. hex/xxx. lixo | O camiño completo/relativo |
Notas:
- Todos os comandos e parámetros deben aparecer por parellas no formato "-x xxx".
- A operación de descarga ou verificación é necesaria para pasar as instrucións -p,-c,-o,-f.
- Para o método de confirmación do dispositivo ISP USB ou do nome do nodo do porto serie correspondente ao comando –p,
Código de estado
| Descrición da instrución | Descrición dos parámetros |
| 0 | Executar correctamente |
| 1 | O parámetro de entrada non é válido |
| 2 | Produciuse un erro ao obter os parámetros da configuración file |
| 3 | Produciuse un erro ao establecer os parámetros do ISP |
| 4 | O nome do porto serie especificado non é válido |
| 5 | Non se enumera ningún dispositivo |
| 6 | O tipo de chip especificado non é coherente co tipo de chip real |
| 7 | Produciuse un erro ao obter a información do dispositivo |
| 8 | Flash non válido file camiño |
| 9 | Flash non válido file lonxitude |
| 10 | Produciuse un erro ao ler o Flash file |
| 11 | Produciuse un erro ao converter o Flash file de formato HEX a BIN |
| 12 | Produciuse un erro ao desactivar a protección de lectura |
| 13 | Produciuse un erro ao descargar |
| 14 | Produciuse un erro ao verificar |
| 100 | Erro descoñecido |
Configuración file
A configuración file é xerado pola función "Gardar configuración da interface de usuario" de WchIspStudio.exe en Windows. As operacións específicas son as seguintes: Primeiro, abra o software e seleccione MCU series no lado dereito do software. A continuación, seleccione a serie e o modelo do chip na interface de "Opción de chip" e configure o chip na interface de "Descargar configuración". A continuación, fai clic no menú principal "File ->Gardar configuración da interface de usuario". Finalmente seleccione o nome e a localización da configuración file. A interface de operación é a seguinte.
Desenvolvemento personalizado
O directorio src de cada cartafol do sistema contén a fonte files da ferramenta de gravación de liña de comandos, que se pode desenvolver directamente en función deste código para satisfacer a demanda personalizada dos usuarios. O directorio lib contén a biblioteca dinámica de desenvolvemento do ISP e a cabeceira files. Para obter funcións e instrucións de chamada, os usuarios poden consultar WCH55XISPDLL. H e outro encabezado files no directorio lib.
Plataforma Windows
Para obter máis información, consulte: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html ruta de instalación \ WCHISPTool_XXX\Doc.
Plataforma Linux
Instrución
Modo de descarga USB
- Enchufe USB
Asegúrate de que a MCU estea no modo de descarga BOOT e que o PID do dispositivo USB sexa 0x55e0. - Instalar o controlador do dispositivo USB
Abra o terminal do sistema, introduza o cartafol do controlador e execute o comando "facer instalar". Esta operación só é necesaria para a primeira descarga. - Determine o nome do dispositivo do ISP USB
Use o comando "ls" para comprobar se existe o dispositivo de caracteres /dev/ch37x. - Executar instrucións de descarga
Executar segundo os requisitos de formato de instrución da ferramenta, por exemploample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o program -f Target.hex
Modo de descarga do porto serie
- Conecte a MCU co porto serie
Asegúrate de que MCU estea no modo de descarga BOOT. - Crear o nome do dispositivo ISP en serie
Confirme o nome do nodo do dispositivo do porto serie e, a continuación, use o comando "ln" para crear unha ligazón suave chamada "ttyISPx" para este dispositivo. O comando específico é o seguinte. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Executar instrucións de descarga.
Executar segundo os requisitos de formato de instrución da ferramenta, por exemploample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o program -f Target.hex
Executar rexistro file
A instancia da operación de descarga exitosa
A instancia da operación de descarga fallida
A instancia de obter a versión BOOT por separado
A instancia de obter a versión do software por separado
Plataforma macOS
Instrución
Modo de descarga USB
- Enchufe USB
Asegúrate de que a MCU estea no modo de descarga BOOT e que o PID do dispositivo USB sexa 0x55e0. - Determine o ID de localización do dispositivo USB no sistema macOS. Busca o dispositivo no Informe do sistema -> Hardware -> USB. O ID de localización na árbore do dispositivo USB móstrase na seguinte figura.
- Executar instrucións de descarga
Executar segundo os requisitos de formato de instrución da ferramenta, por exemploample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o programa -f Target.hex
Modo de descarga do porto serie
- Conecte a MCU co porto serie
Asegúrate de que MCU estea no modo de descarga BOOT. - Determine o nome do nodo do porto serie no dispositivo e execute o comando "ls /dev/tty.*" no
terminal para comprobar o porto serie no macOS (se se usa o chip do porto serie WCH, instale o CH34xVCPDriver do macOS). Na seguinte figura móstrase unha operación específica.
- Executar instrucións de descarga
Executar segundo os requisitos de formato de instrución da ferramenta, por exemploample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o program -f Target.hex
Executar rexistro file
A instancia da operación de descarga exitosa
A instancia da operación de descarga fallida
A instancia de obter a versión BOOT por separado
A instancia de obter a versión do software por separado
Documentos/Recursos
 |
WCH WCHISPTool CMD Ferramenta de programación da liña de comandos [pdfInstrucións Ferramenta de programación de liña de comandos WCHISPTool CMD, WCHISPTool, ferramenta de programación de liña de comandos CMD, ferramenta de programación de liña de comandos, ferramenta de programación de liña, ferramenta de programación |
