Outil de programmation en ligne de commande WCHISPTool CMD
Introduction
Fonction du logiciel
WCHISPTool _ CMD est un outil de ligne de commande multiplateforme pour la gravure en ligne de MCU WCH, qui prend en charge le téléchargement, la vérification et d'autres opérations du micrologiciel pour les MCU de série de WCH via un port USB ou série. L'outil contient la bibliothèque FAI et samples programmes de développement personnalisé de l'outil FAI.
Système d'exploitation pris en charge : Windows x86/x64, Linux x64, macOS x64/arm64.
Modèle de puce pris en charge : CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32X03x/ CH32L10x.
Ligne de commande
Télécharger
Mode USB :
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o programme -f Target.hex
Mode port série :
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o programme -f Target.hex
Vérifier
Mode USB :
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o verify -f Target.hex
Mode port série :
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verify -f Target.hex
Description des paramètres
| -p |
Instruction |
Description des paramètres |
|
| Périphérique FAI USB ou nœud de périphérique série | /dev/ch37x /dev/ttyISPx | Téléchargement via USB sous Linux Téléchargement via port série sous Linux | |
| EmplacementlD COM(/dev/tty.*) | Téléchargement via USB sous macOS Téléchargement via port série sous macOS | ||
| -b | Débit en bauds de communication du port série | 115200/230400/ | Débit en bauds de communication du port série |
| -v | Imprimer le numéro de version | démarrage/outil | La version de démarrage/outil |
| -c | Le nom de chemin complet du fichier configure file | xxx.ini | Le chemin complet/relatif |
| -o | Le type d'opération | programmer/vérifier | Télécharger/Vérifier |
| -f | Le nom de Flash file | xxx. hexadécimal/xxx. poubelle | Le chemin complet/relatif |
Remarques :
- Toutes les commandes et paramètres doivent apparaître par paires au format « -x xxx ».
- Une opération de téléchargement ou de vérification est requise pour transmettre les instructions -p,-c,-o,-f.
- Pour la méthode de confirmation du périphérique USB ISP ou du nom de nœud du port série correspondant à la commande – p,
Code d'état
| Descriptif des instructions | Description des paramètres |
| 0 | Exécuter avec succès |
| 1 | Paramètre d'entrée invalide |
| 2 | Impossible d'obtenir les paramètres de la configuration file |
| 3 | Échec de la définition des paramètres du FAI |
| 4 | Le nom du port série spécifié n'est pas valide |
| 5 | Aucun appareil répertorié |
| 6 | Le type de puce spécifié n'est pas cohérent avec le type de puce réel |
| 7 | Impossible d'obtenir les informations sur l'appareil |
| 8 | Flash invalide file chemin |
| 9 | Flash invalide file longueur |
| 10 | Impossible de lire le Flash file |
| 11 | Échec de la conversion du Flash file du format HEX au format BIN |
| 12 | Échec de la désactivation de la protection en lecture |
| 13 | Échec du téléchargement |
| 14 | Échec de la vérification |
| 100 | Erreur inconnue |
Configuration file
La configuration file est généré par la fonction « Enregistrer la configuration de l'interface utilisateur » de WchIspStudio.exe sous Windows. Les opérations spécifiques sont les suivantes : Tout d'abord, ouvrez le logiciel et sélectionnez la série MCU sur le côté droit du logiciel. Ensuite, sélectionnez la série et le modèle de la puce dans l'interface de « Chip Option » et configurez la puce dans l'interface de « Download Config ». Cliquez ensuite sur le menu principal «File ->Enregistrer la configuration de l'interface utilisateur ». Sélectionnez enfin le nom et l'emplacement de la configuration file. L'interface de fonctionnement est la suivante.
Développement personnalisé
Le répertoire src dans chaque dossier système contient la source files de l'outil de gravure en ligne de commande, qui peut être directement développé sur la base de ce code pour répondre à la demande personnalisée des utilisateurs. Le répertoire lib contient la bibliothèque dynamique et l'en-tête de développement du FAI files. Pour les fonctions et les instructions d'appel, les utilisateurs peuvent se référer à WCH55XISPDLL. H et autre en-tête files dans le répertoire lib.
Plateforme Windows
Pour plus de détails, veuillez consulter : https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html chemin d'installation \ WCHISPTool_XXX\Doc.
Plateforme Linux
Instruction
Mode de téléchargement USB
- Branchez USB
Assurez-vous que le MCU est en mode de téléchargement BOOT et que le PID du périphérique USB est 0x55e0. - Installer le pilote de périphérique USB
Ouvrez le terminal système, entrez dans le dossier du pilote et exécutez la commande « make install ». Cette opération n'est requise que pour le premier téléchargement. - Déterminer le nom du périphérique USB ISP
Utilisez la commande « ls » pour vérifier si le périphérique de caractères /dev/ch37x existe. - Exécuter les instructions de téléchargement
Exécuter selon les exigences de format d'instruction de l'outil, par example, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o programme -f Target.hex
Mode de téléchargement du port série
- Connectez le MCU au port série
Assurez-vous que MCU est en mode de téléchargement BOOT. - Créer le nom du périphérique FAI série
Confirmez le nom du nœud du périphérique du port série, puis utilisez la commande « ln » pour créer un lien symbolique nommé « ttyISPx » pour ce périphérique. La commande spécifique est la suivante. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Exécutez les instructions de téléchargement.
Exécuter selon les exigences de format d'instruction de l'outil, par example, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o programme -f Target.hex
Journal d'exécution file
L'exemple d'une opération de téléchargement réussie
L'instance d'échec de l'opération de téléchargement
L'exemple d'obtention de la version BOOT séparément
L'exemple d'obtention de la version du logiciel séparément
Plateforme macOS
Instruction
Mode de téléchargement USB
- Branchez USB
Assurez-vous que le MCU est en mode de téléchargement BOOT et que le PID du périphérique USB est 0x55e0. - Déterminez l'ID d'emplacement du périphérique USB dans le système macOS. Recherchez le périphérique dans le rapport système -> Matériel -> USB. L'ID d'emplacement dans l'arborescence du périphérique USB est illustré dans la figure suivante.
- Exécuter les instructions de téléchargement
Exécuter selon les exigences de format d'instruction de l'outil, par example, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o programme -f Target.hex
Mode de téléchargement du port série
- Connectez le MCU au port série
Assurez-vous que MCU est en mode de téléchargement BOOT. - Déterminez le nom de nœud du port série sur l'appareil et exécutez la commande « ls /dev/tty.* » sur le
terminal pour vérifier le port série sur macOS (si la puce du port série WCH est utilisée, installez le CH34xVCPDriver de macOS). Une opération spécifique est illustrée dans la figure ci-dessous.
- Exécuter les instructions de téléchargement
Exécuter selon les exigences de format d'instruction de l'outil, par example, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o programme -f Target.hex
Journal d'exécution file
L'exemple d'une opération de téléchargement réussie
L'instance d'échec de l'opération de téléchargement
L'exemple d'obtention de la version BOOT séparément
L'exemple d'obtention de la version du logiciel séparément
Documents / Ressources
 |
Outil de programmation en ligne de commande WCH WCHISPTool CMD [pdf] Instructions Outil de programmation en ligne de commande WCHISPTool CMD, WCHISPTool, outil de programmation en ligne de commande CMD, outil de programmation en ligne de commande, outil de programmation en ligne, outil de programmation |
