Ferramenta de programação de linha de comando WCHISPTool CMD
Introdução
Função de software
WCHISPTool _ CMD é uma ferramenta de linha de comando multiplataforma para gravação on-line de MCU WCH, que suporta download de firmware, verificação e outras operações para MCU série de WCH por meio de USB ou porta serial. A ferramenta contém biblioteca ISP e sample programas para desenvolvimento customizado de ferramenta ISP.
Sistema operacional compatível: Windows x86/x64, Linux x64, macOS x64/arm64.
Modelo de chip suportado: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32X03x/ CH32L10x.
Linha de comando
Download
Modo USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o programa -f Target.hex
Modo de porta serial:
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 verify -f Target.hex
Modo de porta serial:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verify -f Target.hex
Descrição do parâmetro
| -p |
Instrução |
Descrição dos parâmetros |
|
| Dispositivo ISP USB ou nó de dispositivo serial | /dev/ch37x /dev/ttyISPx | Download via USB no Linux Download via porta serial no Linux | |
| LocalizaçãoID COM(/dev/tty.*) | Download via USB no macOS Download via porta serial no macOS | ||
| -b | Taxa de transmissão de comunicação da porta serial | 115200/230400/ | Taxa de transmissão de comunicação da porta serial |
| -v | Número da versão impressa | inicialização/ferramenta | A versão de inicialização/ferramenta |
| -c | O nome completo do caminho da configuração file | xxx.ini | O caminho completo/relativo |
| -o | O tipo de operação | programar/verificar | Baixar/Verificar |
| -f | O nome do Flash file | xxx. hexadecimal/xxx. caixa | O caminho completo/relativo |
Notas:
- Todos os comandos e parâmetros devem aparecer em pares no formato “-x xxx”.
- A operação de download ou verificação é necessária para passar as instruções -p,-c,-o,-f.
- Para o método de confirmação do dispositivo USB ISP ou nome do nó da porta serial correspondente ao comando –p,
Código de status
| Descrição da instrução | Descrição dos parâmetros |
| 0 | Executar com sucesso |
| 1 | Parâmetro de entrada inválido |
| 2 | Falha ao obter parâmetros da configuração file |
| 3 | Falha ao definir os parâmetros do ISP |
| 4 | O nome da porta serial especificada é inválido |
| 5 | Nenhum dispositivo enumerado |
| 6 | O tipo de chip especificado não é consistente com o tipo de chip real |
| 7 | Falha ao obter as informações do dispositivo |
| 8 | Flash inválido file caminho |
| 9 | Flash inválido file comprimento |
| 10 | Falha ao ler o Flash file |
| 11 | Falha ao converter o Flash file do formato HEX para BIN |
| 12 | Falha ao desativar a proteção de leitura |
| 13 | Falhou o download |
| 14 | Falha ao verificar |
| 100 | Erro desconhecido |
Configuração file
A configuração file é gerado pela função “Save UI Config” do WchIspStudio.exe no Windows. As operações específicas são as seguintes: Primeiro, abra o software e selecione a série MCU no lado direito do software. A seguir, selecione a série e modelo do chip na interface “Chip Option” e configure o chip na interface “Download Config”. Em seguida, clique no menu principal “File ->Salvar configuração da interface do usuário”. Por fim, selecione o nome e o local da configuração file. A interface de operação é a seguinte.
Desenvolvimento personalizado
O diretório src em cada pasta do sistema contém a fonte files da ferramenta de gravação de linha de comando, que pode ser desenvolvida diretamente com base neste código para atender à demanda customizada dos usuários. O diretório lib contém a biblioteca dinâmica de desenvolvimento do ISP e o cabeçalho fileS. Para funções e instruções de chamada, os usuários podem consultar WCH55XISPDLL. H e outro cabeçalho files no diretório lib.
Plataforma Windows
Para detalhes, consulte: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html caminho de instalação \ WCHISPTool_XXX\Doc.
Plataforma Linux
Instrução
Modo de download USB
- Conecte USB
Certifique-se de que o MCU esteja no modo de download BOOT e que o PID do dispositivo USB seja 0x55e0. - Instale o driver do dispositivo USB
Abra o terminal do sistema, entre na pasta do driver e execute o comando “make install”. Esta operação só é necessária para o primeiro download. - Determinar o nome do dispositivo USB ISP
Use o comando “ls” para verificar se o dispositivo de caractere /dev/ch37x existe. - Execute a instrução de download
Execute de acordo com os requisitos de formato de instrução da ferramenta, por exemploamparquivo, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o programa -f Target.hex
Modo de download da porta serial
- Conecte o MCU à porta serial
Certifique-se de que o MCU esteja no modo de download BOOT. - Criar nome de dispositivo ISP serial
Confirme o nome do nó do dispositivo de porta serial e, em seguida, use o comando “ln” para criar um link virtual denominado “ttyISPx” para este dispositivo. O comando específico é o seguinte. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Execute as instruções de download.
Execute de acordo com os requisitos de formato de instrução da ferramenta, por exemploamparquivo, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o programa -f Target.hex
Executar registro file
A instância de operação de download bem-sucedida
A instância da operação de download com falha
A instância de obter a versão BOOT separadamente
A instância de obter a versão do software separadamente
Plataforma macOS
Instrução
Modo de download USB
- Conecte USB
Certifique-se de que o MCU esteja no modo de download BOOT e que o PID do dispositivo USB seja 0x55e0. - Determine o ID de localização do dispositivo USB no sistema macOS. Encontre o dispositivo no Relatório do Sistema ->Hardware ->USB. O ID do local na árvore do dispositivo USB é mostrado na figura a seguir.
- Execute a instrução de download
Execute de acordo com os requisitos de formato de instrução da ferramenta, por exemploamparquivo, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o programa -f Target.hex
Modo de download da porta serial
- Conecte o MCU à porta serial
Certifique-se de que o MCU esteja no modo de download BOOT. - Determine o nome do nó da porta serial no dispositivo e execute o comando “ls /dev/tty.*” no
terminal para verificar a porta serial no macOS (se o chip de porta serial WCH for usado, instale o CH34xVCPDriver do macOS). Uma operação específica é mostrada na figura abaixo.
- Execute a instrução de download
Execute de acordo com os requisitos de formato de instrução da ferramenta, por exemploamparquivo, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o programa -f Target.hex
Executar registro file
A instância de operação de download bem-sucedida
A instância da operação de download com falha
A instância de obter a versão BOOT separadamente
A instância de obter a versão do software separadamente
Documentos / Recursos
 |
Ferramenta de programação de linha de comando WCH WCHISPTool CMD [pdf] Instruções WCHISPTool Ferramenta de programação de linha de comando CMD, WCHISPTool, Ferramenta de programação de linha de comando CMD, Ferramenta de programação de linha de comando, Ferramenta de programação de linha, Ferramenta de programação |
