Herramienta de programación de línea de comandos WCHISPTool CMD
Introducción
Función del software
WCHISPTool _ CMD es una herramienta de línea de comandos multiplataforma para grabar MCU WCH en línea, que admite la descarga de firmware, verificación y otras operaciones para MCU serie de WCH a través de USB o puerto serie. La herramienta contiene biblioteca ISP y sampLe programas para el desarrollo personalizado de la herramienta 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/ CH32X03x/ CH32L10x.
Línea de comandos
Descargar
Modo USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o programa -f Target.hex
Modo de puerto serie:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o programa -f Target.hex
Verificar
Modo USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o verificar -f Target.hex
Modo de puerto serie:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verificar -f Target.hex
Descripción de parámetros
| -p |
Instrucción |
Descripción de los parámetros |
|
| Dispositivo ISP USB o nodo de dispositivo serie | /dev/ch37x /dev/ttyISPx | Descarga vía USB en Linux Descarga vía puerto serie en Linux | |
| UbicaciónlD COM(/dev/tty.*) | Descarga vía USB en macOS Descarga vía puerto serie en macOS | ||
| -b | Velocidad de comunicación en baudios del puerto serie | 115200/230400/ | Velocidad de comunicación en baudios del puerto serie |
| -v | Número de versión impresa | bota/herramienta | La versión de arranque/herramienta |
| -c | El nombre de ruta completo de la configuración. file | xxx.ini | La ruta completa/relativa |
| -o | El tipo de operación | programar/verificar | Descargar/Verificar |
| -f | El nombre de Flash file | xxx. hexadecimal/xxx. papelera | La ruta completa/relativa |
Notas:
- Todos los comandos y parámetros deben aparecer en pares en el formato “-x xxx”.
- Se requiere descargar o verificar la operación para pasar las instrucciones -p, -c, -o, -f.
- Para el método de confirmación del dispositivo ISP USB o el nombre del nodo del puerto serie correspondiente al comando –p,
Código de estado
| Descripción de la instrucción | Descripción de los parámetros |
| 0 | Ejecutar exitosamente |
| 1 | Parámetro de entrada no válido |
| 2 | No se pudieron obtener los parámetros de la configuración. file |
| 3 | No se pudieron configurar los parámetros del ISP |
| 4 | El nombre del puerto serie especificado no es válido |
| 5 | Ningún dispositivo enumerado |
| 6 | El tipo de chip especificado no coincide con el tipo de chip real |
| 7 | No se pudo obtener la información del dispositivo |
| 8 | Flash no válido file camino |
| 9 | Flash no válido file longitud |
| 10 | No se pudo leer el Flash file |
| 11 | No se pudo convertir el Flash file del formato HEX al BIN |
| 12 | No se pudo desactivar la protección de lectura |
| 13 | Error al descargar |
| 14 | No se pudo verificar |
| 100 | Error desconocido |
Configuración file
La configuración file se genera mediante la función "Guardar configuración de UI" de WchIspStudio.exe en Windows. Las operaciones específicas son las siguientes: Primero, abra el software y seleccione la serie MCU en el lado derecho del software. A continuación, seleccione la serie y el modelo del chip en la interfaz de "Opción de chip" y configure el chip en la interfaz de "Descargar configuración". Luego haga clic en el menú principal “File ->Guardar configuración de interfaz de usuario”. Finalmente seleccione el nombre y la ubicación de la configuración. file. La interfaz de operación es la siguiente.
Desarrollo a la medida
El directorio src en cada carpeta del sistema contiene la fuente files de la herramienta de grabación de línea de comandos, que se puede desarrollar directamente en base a este código para satisfacer la demanda personalizada de los usuarios. El directorio lib contiene la biblioteca dinámica de desarrollo del ISP y el encabezado. files. Para funciones e instrucciones de llamada, los usuarios pueden consultar WCH55XISPDLL. H y otro encabezado files en el directorio lib.
Windows Platform
Para más detalles, consulte: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html ruta de instalación \ WCHISPTool_XXX\Doc.
Plataforma Linux
Instrucción
Modo de descarga USB
- Enchufe USB
Asegúrese de que la MCU esté en modo de descarga BOOT y que el PID del dispositivo USB sea 0x55e0. - Instalar el controlador del dispositivo USB
Abra la terminal del sistema, ingrese a la carpeta del controlador y ejecute el comando "make install". Esta operación sólo es necesaria para la primera descarga. - Determinar el nombre del dispositivo USB ISP
Utilice el comando "ls" para comprobar si existe el dispositivo de caracteres /dev/ch37x. - Ejecutar instrucción de descarga
Ejecutar de acuerdo con los requisitos de formato de instrucción de la herramienta, por ejemplo.amparchivo, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o programa -f Target.hex
Modo de descarga del puerto serie
- Conecte MCU con puerto serie
Asegúrese de que MCU esté en modo de descarga BOOT. - Crear el nombre del dispositivo ISP serie
Confirme el nombre del nodo del dispositivo del puerto serie y luego use el comando "ln" para crear un enlace suave llamado "ttyISPx" para este dispositivo. El comando específico es el siguiente. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Ejecute la instrucción de descarga.
Ejecutar de acuerdo con los requisitos de formato de instrucción de la herramienta, por ejemplo.amparchivo, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o programa -f Target.hex
Ejecutar registro file
El caso de una operación de descarga exitosa
El caso de operación de descarga fallida
La instancia de obtener la versión BOOT por separado
La instancia de obtener la versión del software por separado.
Plataforma macOS
Instrucción
Modo de descarga USB
- Enchufe USB
Asegúrese de que la MCU esté en modo de descarga BOOT y que el PID del dispositivo USB sea 0x55e0. - Determine la ID de ubicación del dispositivo USB en el sistema macOS. Busque el dispositivo en Informe del sistema ->Hardware ->USB. La ID de ubicación en el árbol del dispositivo USB se muestra en la siguiente figura.
- Ejecutar instrucción de descarga
Ejecutar de acuerdo con los requisitos de formato de instrucción de la herramienta, por ejemplo.amparchivo, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o programa -f Target.hex
Modo de descarga del puerto serie
- Conecte MCU con puerto serie
Asegúrese de que MCU esté en modo de descarga BOOT. - Determine el nombre de nodo del puerto serie en el dispositivo y ejecute el comando “ls /dev/tty.*” en el
terminal para verificar el puerto serie en macOS (si se utiliza el chip de puerto serie WCH, instale el CH34xVCPDriver de macOS). Una operación específica se muestra en la siguiente figura.
- Ejecutar instrucción de descarga
Ejecutar de acuerdo con los requisitos de formato de instrucción de la herramienta, por ejemplo.amparchivo, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o programa -f Target.hex
Ejecutar registro file
El caso de una operación de descarga exitosa
El caso de operación de descarga fallida
La instancia de obtener la versión BOOT por separado
La instancia de obtener la versión del software por separado.
Documentos / Recursos
 |
WCH WCHISPTool CMD Herramienta de programación de línea de comandos [pdf] Instrucciones WCHISPTool CMD Herramienta de programación de línea de comandos, WCHISPTool, Herramienta de programación de línea de comandos CMD, Herramienta de programación de línea de comandos, Herramienta de programación de línea, Herramienta de programación |
