Інструмент праграмавання каманднага радка WCHISPTool CMD

Уводзіны
Праграмная функцыя
WCHISPTool _ CMD - гэта шматплатформенны інструмент каманднага радка для запісу WCH MCU у Інтэрнэце, які падтрымлівае загрузку ўбудаванага праграмнага забеспячэння, праверку і іншыя аперацыі для MCU серыі WCH праз USB або паслядоўны порт. Інструмент змяшчае бібліятэку ISP і sample праграмы для індывідуальнай распрацоўкі інструмента 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 праверка -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 | |
| LocationlD COM(/dev/tty.*) | Спампоўка праз USB у macOS Спампоўка праз паслядоўны порт у macOS | ||
| -b | Хуткасць перадачы паслядоўнага порта | 115200/230400/ | Хуткасць перадачы паслядоўнага порта |
| -v | Друкаваць нумар версіі | загрузка/інструмент | Версія загрузкі/інструмента |
| -c | Поўны шлях да канфігурацыі file | xxx.ini | Поўны/адносны шлях |
| -o | Тып аперацыі | праграма / праверка | Спампаваць/Праверыць |
| -f | Імя Flash file | ххх. шаснаццатковы/xxx. бункер | Поўны/адносны шлях |
Заўвагі:
- Усе каманды і параметры павінны з'яўляцца парамі ў фармаце «-x xxx».
- Для перадачы інструкцый -p,-c,-o,-f патрабуецца загрузка або праверка аперацыі.
- Для метаду пацверджання прылады 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» і наладзьце чып у інтэрфейсе «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-правайдэра
Выкарыстоўвайце каманду «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, інструмент праграмавання каманднага радка, інструмент праграмавання радкоў, інструмент праграмавання |




