WCHISPTool CMD Инструмент программирования командной строки

Введение

Функция программного обеспечения

WCHISPTool_CMD — это многоплатформенный инструмент командной строки для онлайн-записи MCU WCH, который поддерживает загрузку прошивки, проверку и другие операции для серийных MCU WCH через USB или последовательный порт. Инструмент содержит библиотеку ISP иampфайлы программ для индивидуальной разработки инструментов 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 program -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 проверить -f Target.hex

Режим последовательного порта:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o проверить -f Target.hex

Описание параметра

-p	Инструкция описание	Описание параметров
	Устройство USB ISP или узел последовательного устройства	/dev/ch37x /dev/ttyISPx	Загрузка через USB в Linux Загрузка через последовательный порт в Linux
		МестоположениеlD COM(/dev/tty.*)	Загрузка через USB в macOS Загрузка через последовательный порт в macOS
-b	Скорость передачи данных последовательного порта	115200/230400/	Скорость передачи данных последовательного порта
-v	Номер версии для печати	ботинок/инструмент	Версия загрузки/инструмента
-c	Полный путь к конфигурации file	xxx.ini	Полный/относительный путь
-o	Тип операции	запрограммировать/проверить	Скачать/Проверить
-f	Имя Флэша file	ххх. шестнадцатеричный/ххх. мусорное ведро	Полный/относительный путь

Примечания:

1. Все команды и параметры должны указываться парами в формате «-x xxx».
2. Операция загрузки или проверки необходима для передачи инструкций -p,-c,-o,-f.
3. Для метода подтверждения устройства USB ISP или имени узла последовательного порта, соответствующего команде – p,

Код статуса

Описание инструкции	Описание параметров
0	Выполнить успешно
1	Неверный входной параметр
2	Не удалось получить параметры из конфигурации. file
3	Не удалось установить параметры интернет-провайдера.
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» и настройте чип в интерфейсе «Загрузить конфигурацию». Затем нажмите главное меню «File -> Сохранить конфигурацию пользовательского интерфейса». Наконец выберите имя и расположение конфигурации. file. Интерфейс работы следующий.

Индивидуальная разработка

Каталог src в каждой системной папке содержит исходный код. fileИнструмент записи командной строки, который может быть разработан непосредственно на основе этого кода для удовлетворения индивидуальных потребностей пользователей. Каталог lib содержит динамическую библиотеку разработки ISP и заголовок. fileс. Для получения информации о функциях и инструкциях по вызову пользователи могут обратиться к WCH55XISPDLL. H и другой заголовок files в каталоге lib.

Платформа Windows

Для получения подробной информации, пожалуйста, обратитесь к: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html путь установки \ WCHISPTool_XXX\Doc.

Платформа Linux

Инструкция

USB-режим загрузки

1. Подключите USB
   Убедитесь, что MCU находится в режиме загрузки BOOT, а PID USB-устройства равен 0x55e0.
2. Установите драйвер USB-устройства
   Откройте системный терминал, войдите в папку драйверов и выполните команду «make install». Эта операция требуется только для первой загрузки.
3. Определить имя устройства USB ISP
   Используйте команду «ls», чтобы проверить, существует ли символьное устройство /dev/ch37x.
4. Выполнить инструкцию по загрузке
   Выполнять в соответствии с требованиями инструмента к формату инструкций, напримерample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o program -f Target.hex

Режим загрузки через последовательный порт

1. Подключите MCU через последовательный порт
   Убедитесь, что MCU находится в режиме загрузки BOOT.
2. Создайте последовательное имя устройства интернет-провайдера
   Подтвердите имя узла устройства последовательного порта, а затем используйте команду «ln», чтобы создать программную ссылку с именем «ttyISPx» для этого устройства. Конкретная команда выглядит следующим образом. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0
3. Выполните инструкцию загрузки.
   Выполнять в соответствии с требованиями инструмента к формату инструкций, напримерample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o program -f Target.hex

Журнал запуска file

Экземпляр успешной операции загрузки

Экземпляр неудачной операции загрузки

Экземпляр получения BOOT-версии отдельно

Вариант получения версии ПО отдельно

Платформа MacOS

Инструкция

USB-режим загрузки

1. Подключите USB
   Убедитесь, что MCU находится в режиме загрузки BOOT, а PID USB-устройства равен 0x55e0.
2. Определите идентификатор местоположения USB-устройства в системе macOS. Найдите устройство в системном отчете -> Оборудование -> USB. Идентификатор местоположения в дереве USB-устройств показан на следующем рисунке.
3. Выполнить инструкцию по загрузке
   Выполнять в соответствии с требованиями инструмента к формату инструкций, напримерample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o program -f Target.hex
   

Режим загрузки через последовательный порт

1. Подключите MCU через последовательный порт
   Убедитесь, что MCU находится в режиме загрузки BOOT.
2. Определите имя узла последовательного порта на устройстве и запустите команду «ls /dev/tty.*» на
   терминал для проверки последовательного порта в macOS (если используется чип последовательного порта WCH, установите CH34xVCPDriver для macOS). Конкретная операция показана на рисунке ниже.
   
3. Выполнить инструкцию по загрузке
   Выполнять в соответствии с требованиями инструмента к формату инструкций, напримерample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o program -f Target.hex

Журнал запуска file

Экземпляр успешной операции загрузки

Экземпляр неудачной операции загрузки

Экземпляр получения BOOT-версии отдельно

Вариант получения версии ПО отдельно

Документы/Ресурсы

WCH WCHISPTool CMD Инструмент программирования командной строки [pdf] Инструкции WCHISPTool Инструмент программирования командной строки CMD, WCHISPTool, Инструмент программирования командной строки CMD, Инструмент программирования командной строки, Инструмент линейного программирования, Инструмент программирования

Ссылки

• Руководство пользователя