Інструмент програмування командного рядка WCHISPTool CMD
вступ
Функція програмного забезпечення
WCHISPTool _ CMD — це багатоплатформний інструмент командного рядка для онлайн-запису WCH MCU, який підтримує завантаження прошивки, перевірку та інші операції для серії MCU WCH через USB або послідовний порт. Інструмент містить бібліотеку ISP і sampфайли програм для індивідуальної розробки інструменту ISP.
Підтримувана операційна система: Windows x86/x64, Linux x64, macOS x64/arm64.
Підтримувані моделі мікросхем: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32X03x/ CH32L10x.
Командний рядок
Завантажити
Режим USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o програма -f Target.hex
Режим послідовного порту:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o програма -f Target.hex
Підтвердити
Режим USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o verify -f Target.hex
Режим послідовного порту:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verify -f Target.hex
Опис параметра
| -p |
Інструкція |
Опис параметрів |
|
| USB-пристрій ISP або вузол послідовного пристрою | /dev/ch37x /dev/ttyISPx | Завантажити через USB у Linux Завантажити через послідовний порт у Linux | |
| LocationlD COM(/dev/tty.*) | Завантажити через USB у macOS Завантажити через послідовний порт у macOS | ||
| -b | Швидкість передачі даних послідовного порту | 115200/230400/ | Швидкість передачі даних послідовного порту |
| -v | Роздрукувати номер версії | завантаження/інструмент | Версія завантаження/інструменту |
| -c | Повний шлях до конфігурації file | xxx.ini | Повний/відносний шлях |
| -o | Тип операції | програма/перевірка | Завантажити/перевірити |
| -f | Ім'я Flash file | ххх. шістнадцятковий/xxx. bin | Повний/відносний шлях |
Примітки:
- Усі команди та параметри мають відображатися парами у форматі «-x xxx».
- Для передачі інструкцій -p,-c,-o,-f потрібна операція завантаження або перевірки.
- Для методу підтвердження пристрою USB ISP або імені вузла послідовного порту, що відповідає команді –p,
Код стану
| Опис інструкції | Опис параметрів |
| 0 | Успішно виконати |
| 1 | Недійсний вхідний параметр |
| 2 | Не вдалося отримати параметри з конфігурації file |
| 3 | Не вдалося встановити параметри ISP |
| 4 | Вказана назва послідовного порту недійсна |
| 5 | Немає пристроїв у списку |
| 6 | Зазначений тип мікросхеми не відповідає фактичному типу мікросхеми |
| 7 | Не вдалося отримати інформацію про пристрій |
| 8 | Недійсний Flash file шлях |
| 9 | Недійсний Flash file довжина |
| 10 | Не вдалося прочитати Flash file |
| 11 | Не вдалося перетворити Flash file із формату HEX у формат BIN |
| 12 | Не вдалося вимкнути захист від читання |
| 13 | Не вдалося завантажити |
| 14 | Не вдалося перевірити |
| 100 | Невідома помилка |
Конфігурація file
Конфігурація file генерується функцією «Зберегти конфігурацію інтерфейсу користувача» WchIspStudio.exe у Windows. Конкретні операції такі: спочатку відкрийте програмне забезпечення та виберіть серію MCU у правій частині програмного забезпечення. Далі виберіть серію та модель чіпа в інтерфейсі «Chip Option» і налаштуйте чіп в інтерфейсі «Download Config». Потім натисніть головне меню «File ->Зберегти конфігурацію інтерфейсу». Нарешті виберіть назву та розташування конфігурації file. Інтерфейс роботи виглядає наступним чином.
Розробка на замовлення
Каталог src у кожній системній папці містить джерело files інструменту запису командного рядка, який можна безпосередньо розробити на основі цього коду для задоволення індивідуальних потреб користувачів. Каталог lib містить динамічну бібліотеку розробки ISP і заголовок fileс. Щоб дізнатися про функції та інструкції щодо виклику, користувачі можуть звернутися до WCH55XISPDLL. H та інший заголовок files у каталозі lib.
Платформа Windows
Щоб дізнатися більше, зверніться до: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html шлях встановлення \ WCHISPTool_XXX\Doc.
Платформа Linux
Інструкція
Режим завантаження USB
- Підключіть USB
Переконайтеся, що MCU перебуває в режимі завантаження BOOT, а PID пристрою USB – 0x55e0. - Встановити драйвер USB-пристрою
Відкрийте системний термінал, увійдіть до папки драйвера та виконайте команду «make install». Ця операція потрібна лише для першого завантаження. - Визначте ім’я USB-пристрою ISP
Використовуйте команду «ls», щоб перевірити, чи існує символьний пристрій /dev/ch37x. - Виконайте інструкцію щодо завантаження
Виконайте відповідно до вимог інструменту до формату інструкцій, напрample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o програма -f Target.hex
Режим завантаження послідовного порту
- Підключіть MCU до послідовного порту
Переконайтеся, що MCU знаходиться в режимі завантаження BOOT. - Створіть назву пристрою провайдера з послідовним доступом
Підтвердьте назву вузла пристрою послідовного порту, а потім скористайтеся командою «ln», щоб створити програмне посилання під назвою «ttyISPx» для цього пристрою. Конкретна команда виглядає наступним чином. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Виконайте інструкцію щодо завантаження.
Виконайте відповідно до вимог інструменту до формату інструкцій, напрample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o програма -f Target.hex
Журнал запуску file
Приклад успішної операції завантаження
Випадок невдалої операції завантаження
Екземпляр отримання версії BOOT окремо
Екземпляр отримання версії програмного забезпечення окремо
Платформа macOS
Інструкція
Режим завантаження USB
- Підключіть USB
Переконайтеся, що MCU перебуває в режимі завантаження BOOT, а PID пристрою USB – 0x55e0. - Визначте ідентифікатор розташування USB-пристрою в системі macOS. Знайдіть пристрій у System Report ->Hardware ->USB. Ідентифікатор розташування в дереві пристроїв USB показано на малюнку нижче.
- Виконайте інструкцію щодо завантаження
Виконайте відповідно до вимог інструменту до формату інструкцій, напрample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o програма -f Target.hex
Режим завантаження послідовного порту
- Підключіть MCU до послідовного порту
Переконайтеся, що MCU знаходиться в режимі завантаження BOOT. - Визначте ім’я вузла послідовного порту на пристрої та запустіть команду «ls /dev/tty.*» на
термінал, щоб перевірити послідовний порт у macOS (якщо використовується мікросхема послідовного порту WCH, інсталюйте CH34xVCPDriver macOS). Конкретна операція показана на малюнку нижче.
- Виконайте інструкцію щодо завантаження
Виконайте відповідно до вимог інструменту до формату інструкцій, напрample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o програма -f Target.hex
Журнал запуску file
Приклад успішної операції завантаження
Випадок невдалої операції завантаження
Екземпляр отримання версії BOOT окремо
Екземпляр отримання версії програмного забезпечення окремо
Документи / Ресурси
 |
WCH WCHISPTool Інструмент програмування командного рядка CMD [pdfІнструкції WCHISPTool Інструмент програмування командного рядка CMD, WCHISPTool, Інструмент програмування командного рядка CMD, Інструмент програмування командного рядка, Інструмент програмування рядків, Інструмент програмування |
