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
 | Ferramenta de programación da liña de comandos WCHISPTool CMD |
Referencias
- 南京沁恒微电子股份有限公司que.cn
- WCHISPTool_Setup.exe - 南京沁恒微电子股份有限公司www.wch.cn
- Manual de usuariomanual.tools