Wb-mcu-fw-flasher: различия между версиями

Текущая версия на 09:15, 13 апреля 2024

Общая информация

Здесь описывается wb-mcu-fw-flasher — сервисная утилита для modbus-устройств Wiren Board с помощью которой вы сможете сбросить устройство к заводским настройкам или заменить его прошивку.

Краткую инструкцию по прошивке устройств читайте в статье Обновление прошивок на устройствах Wiren Board.

Установка утилиты

Контроллер Wiren Board

Утилита есть в репозитории контроллера, поэтому обновите список пакетов и установите ее:

apt update
apt install wb-mcu-fw-flasher

ОС Linux

Скачайте файл для вашего устройства с расширением .deb в нашем репозитории.

Для установки, выполните команды:

apt update
apt install ./wb-mcu-fw-flasher_1.3.1_amd64.deb #измените имя пакета, если необходимо

ОС Windows

Утилита wb-mcu-fw-flasher выводит справку в командной строке Windows

Скачайте файл с расширением .exe в нашем репозитории. Установка не требуется.

Аргументы командной строки

Опции запуска утилиты wb-mcu-fw-flasher.

Параметр	Описание	Значение по умолчанию
-d	Устройство последовательного порта (обязательно)
-f	Файл прошивки
-a	Адрес Modbus	1
-j	Отправить на устройство команду перехода в режим загрузчика со стандартными настройками соединения 9600N2
-J	Отправить на устройство команду перехода в режим загрузчика с текущими настройками соединения (доступно начиная с версии 1.3.0)
-b	Скорость порта (baudrate)	9600
-p	Чётность (parity)	N
-s	Количество стопбитов	2
-r	Адрес holding-регистра для перехода в режим загрузчика	129
-D	Включить режим отладки
-u	Восстановление заводских настроек UART и Modbus адреса
-e	Стирает все настройки и калибровочные значения: датчики начнут показывать ерунду. Не используйте, если не знаете, что делаете.
-w	Стирает все настройки устройства, хранящиеся во Flash памяти. Доступно с версии загрузчика 1.2.0. Не используйте, если не знаете, что делаете.

Типичные сценарии использования

О том как выбрать файл прошивки для устройства, подготовить устройство к прошивке и примеры, смотрите в статье Обновление прошивок на устройствах Wiren Board.

Обновление прошивки, если устройство в обычном режиме

Чтобы прошить устройств в обычном режиме, его нужно перевести в режим загрузчика опцией -j:

wb-mcu-fw-flasher -j -d <порт, на котором находится устройство> -a <modbus адрес устройства> -f <файл с прошивкой устройства.wbfw>

Обновление прошивки, если устройство в режиме загрузчика

Если устройство находится в режиме загрузчика, то дополнительно готовить его не нужно:

wb-mcu-fw-flasher -d <порт, на котором находится устройство> -a <modbus адрес устройства> -f <файл с прошивкой устройства.wbfw>

@@ Строка 6: / Строка 6: @@
 == Установка утилиты ==
+{{Anchor|install}}
 === Контроллер Wiren Board ===
 Утилита есть в репозитории контроллера, поэтому обновите список пакетов и установите ее:
@@ Строка 14: / Строка 15: @@
 === ОС Linux ===
-Если вы используете контроллер на процессоре ARM Cortex, то скачайте и установите deb-пакет из [http://releases.contactless.ru/?prefix=stable/stretch/pool/main/w/wb-mcu-fw-flasher/ нашего репозитория].
+Скачайте файл для вашего устройства с расширением '''.deb''' в [https://github.com/wirenboard/wb-mcu-fw-flasher/releases нашем репозитории].
-Для установки на компьютер с ОС Linux скачайте на компьютер пакет [https://wirenboard.com/wiki/images/3/33/Wb-mcu-fw-flasher_1.0.3_amd64-all.deb wb-mcu-fw-flasher_1.0.3_amd64-all.deb].
 Для установки, выполните команды:
 <syntaxhighlight lang="bash">
 apt update
-apt install libmodbus5
+apt install ./wb-mcu-fw-flasher_1.3.1_amd64.deb #измените имя пакета, если необходимо
-apt install ./Wb-mcu-fw-flasher_1.0.3_amd64-all.deb #измените имя пакета, если необходимо
 </syntaxhighlight>
 === ОС Windows ===
 [[Image: wb-mcu-fw-flasher-in-windows-cmd.png|400px|thumb|right| Утилита wb-mcu-fw-flasher выводит справку в командной строке Windows]]
-Для Windows мы подготовили windows-версию утилиты, которая не требует установки и запускается из командной строки. Скачать можно по ссылке [https://wirenboard.com/wiki/images/d/d1/Wb-mcu-fw-flasher_1.0.3.zip wb-mcu-fw-flasher_1.0.3.zip]
+Скачайте файл с расширением '''.exe''' в [https://github.com/wirenboard/wb-mcu-fw-flasher/releases нашем репозитории]. Установка не требуется.
 == Аргументы командной строки ==
@@ Строка 40: / Строка 39: @@
 | -a || Адрес Modbus || 1
 |-
-| -j || Отправить на устройство команду перехода в режим загрузчика ||
+| -j || Отправить на устройство команду перехода в режим загрузчика со стандартными настройками соединения 9600N2||
+|-
+| -J || Отправить на устройство команду перехода в режим загрузчика с текущими настройками соединения (доступно начиная с версии 1.3.0) ||
 |-
 | -b || Скорость порта (baudrate) || 9600
@@ Строка 54: / Строка 55: @@
 | -u || Восстановление заводских настроек UART и Modbus адреса ||
 |-
-| -e || Сброс всех настроек до заводских ||
+| -e || Стирает все настройки и калибровочные значения: датчики начнут показывать ерунду. <br>Не используйте, если не знаете, что делаете.||
+|-
+| -w || Стирает все настройки устройства, хранящиеся во Flash памяти. Доступно с версии загрузчика 1.2.0. <br>Не используйте, если не знаете, что делаете.||
 |}
@@ Строка 75: / Строка 78: @@
 ==  Полезные ссылки ==
-* [[Restore factory settings Wiren Board Modbus device | Сброс Modbus-устройства Wiren Board к заводским настройкам]]
 * [[WB Modbus Devices Firmware Update | Обновление прошивки Modbus-устройств Wiren Board]]
 * [[Firmware Repository For Wiren Board Modbus Devices |Репозиторий прошивок для Modbus-устройств Wiren Board]]
-* [https://wirenboard.com/wiki/images/3/33/Wb-mcu-fw-flasher_1.0.3_amd64-all.deb Скачать wb-mcu-fw-flasher для ОС Linux]
+* [https://github.com/wirenboard/wb-mcu-fw-flasher/releases/download/v1.3.1/wb-mcu-fw-flasher_1.3.1_amd64.deb Скачать wb-mcu-fw-flasher для ОС Linux]
-* [https://wirenboard.com/wiki/images/d/d1/Wb-mcu-fw-flasher_1.0.3.zip Скачать wb-mcu-fw-flasher для ОС Windows]
+* [https://github.com/wirenboard/wb-mcu-fw-flasher/releases/download/v1.3.1/wb-mcu-fw-flasher_1.3.1.exe Скачать wb-mcu-fw-flasher для ОС Windows]

Навигация