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

Материал из Wiren Board
(не показаны 63 промежуточные версии 8 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE:Утилита обновления прошивок wb-mcu-fw-updater}}
<languages/>
== Общая информация ==
<translate>
Здесь описывается <code>wb-mcu-fw-updater</code> — утилита для автоматического обновления прошивок modbus-устройств Wiren Board.
</translate>
{{DISPLAYTITLE:Обновление прошивок на устройствах Wiren Board}}
<translate>


Краткую инструкцию по обновлению прошивки читайте в статье [[WB Modbus Devices Firmware Update | Обновление прошивок на устройствах Wiren Board]].
Статья находится в процессе редактирования!


== Установка утилиты ==  
== Возможность обновления == <!--T:1-->
 
<!--T:2-->
Для всех устройств Wiren Board, работающих по протоколу Modbus RTU, доступно удалённое обновление ПО (микрокода) самого устройства. Обновление реализовано посредством прошивки файла .wbfw по шине modbus с помощью утилиты wb-mcu-fw-flasher. Подробная информация о процедуре прошивки доступна [[WB-MCU-Flasher | здесь.]]
 
<!--T:3-->
Сами файлы обновлений можно скачать в репозитории [http://fw-releases.wirenboard.com/?prefix=fw/ fw-releases.wirenboard.com]
 
 
== Автоматическое обновление прошивок устройств == <!--T:4-->
Чтобы не производить действия по выбору подходящей прошивки, её скачиванию и установке на устройство, была написана утилита [https://github.com/wirenboard/wb-mcu-fw-updater.git wb-mcu-fw-updater].
Чтобы не производить действия по выбору подходящей прошивки, её скачиванию и установке на устройство, была написана утилита [https://github.com/wirenboard/wb-mcu-fw-updater.git wb-mcu-fw-updater].


Она позволяет свести весь процесс обновления прошивки устройства до указания порта, к которому устройство подключено, и его slaveid.
Она позволяет свести весь процесс обновления прошивки устройства до указания порта, к которому устройство подключено, и его slaveid (опционально).


=== Контроллер Wiren Board ===
=== Утилита wb-mcu-fw-updater ===
Утилита предустановлена на все контроллеры Wiren Board, начиная с версии 5 и выше.
==== Установка: ==== <!--T:5-->
На контроллерах Wiren Board (приобретённых после мая 2020) утилита доступна сразу. На контроллеры, приобретённые ранее, утилита устанавливается следующими командами:
<pre>
apt update
apt install python-wb-mcu-fw-updater
</pre>


Если у вас её не оказалось, то можно установить из репозитория:
===== На другие Debian-подобные системы: ===== <!--T:6-->
# Откройте консоль контроллера через [[SSH]].
Для Ubuntu, Linux Mint, Elementary OS и других дистрибутивов, использующих пакетный менеджер apt, порядок действий примерно следующий:
# Обновите список пакетов:
# Перейти в репозиторий [https://github.com/wirenboard/wb-mcu-fw-updater.git wb-mcu-fw-updater].
#:<syntaxhighlight lang="bash">
# Собрать deb-пакет по инструкции в нём.
# Установить wb-mcu-fw-flasher.
# Установить собранный deb-пакет командами:
<pre>
apt update
apt update
</syntaxhighlight>
apt install ./<путь_до_собранного_пакета>.deb
# Установите утилиту командой:
</pre>
#:<syntaxhighlight lang="bash">
 
apt install wb-mcu-fw-updater
==== Интерфейс и режимы работы: ==== <!--T:7-->
</syntaxhighlight>
[[File:Wb-mcu-fw-updater interface.png||center||Help доступен при запуске утилиты с ключом -h]]
 
===== Режим "update": ===== <!--T:8-->
[[File:Bootloader.gif||right||Индикация режима загрузчика]]
Обновление одного устройства с известный slaveid. Если адрес устройства неизвестен, утилита, с согласия пользователя, задаст устройству адрес 245. Далее, утилита считывает версию прошивки устройства и проверяет необходимость обновления. Если есть прошивка новее - скачивает и устанавливает её.


=== ОС Linux ===
Для успешной работы в данном режиме, '''нужно освободить порт, к которому подключено устройство, от других драйверов''' (например, остановив на время wb-mqtt-serial).
{{Anchor|linux}}
Wb-mcu-fw-updater не поддерживается на других платформах. Для Debian-подобных операционных систем есть утилита [[Wb-mcu-fw-flasher |wb-mcu-fw-flasher]].


== Режимы ==
===== Режим "recover": ===== <!--T:9-->
[[Image: Wb-mcu-fw-updater interface.png|450px|thumb|right| Help доступен при запуске утилиты с ключом -h. Для каждого режима работы тоже доступен help, например, wb-mcu-fw-updater update-fw -h]]
Восстановление устройства с испорченной прошивкой (например, при прошивке пропало питание, и устройство перестало загружаться). После указания модели устройства, утилита скачивает самую свежую прошивку для него и прошивает её через бутлоадер. Режим предназначен для использования '''только в бутлоадере''' (устройство мигает зелёным светодиодом примерно 1 раз в секунду).
[[Image: Bootloader.gif|300px|thumb|right| Индикация режима загрузчика]]


Утилита работает в разных режимах, описание которых можно посмотреть ниже или во встроенной справке по команде <code>wb-mcu-fw-updater <режим> -h</code>
Для успешной работы в данном режиме, '''нужно освободить порт, к которому подключено устройство, от других драйверов''' (например, остановив на время wb-mqtt-serial).


=== Обновление прошивки (update-fw) ===  
===== Режим "update-all": ===== <!--T:10-->
Обновление прошивки устройства с известным modbus-адресом.  
Обновление производится для всех устройств, работающих через wb-mqtt-serial. Поддерживается только на устройствах Wiren Board '''(для работы нужен драйвер wb-mqtt-serial)'''. Утилита останавливает драйвер, для каждого обнаруженного устройства в конфигурационном файле /etc/wb-mqtt-serial.conf проверяет наличие обновления и устанавливает его, если имеется. После этого, драйвер перезапускается, а пользователю возвращается список устройств, обновление которых не удалось (если таковые имеются).


Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию ПО и производит обновление, если требуется. Этот режим гибко настраивается с помощью ключей запуска, например, в этом режиме можно устанавливать тестовые прошивки.
==== Ключи запуска wb-mcu-fw-updater: ==== <!--T:11-->
{| class="wikitable noclear"
{| class="wikitable"
! Параметр !! Описание !! Значение по умолчанию
! Параметр !! Описание !! Значение по умолчанию
|-
!colspan="3"|Общие для всех режимов. Ключи со значением (-<ключ> <значение>)
|-
|-
|  || Порт, к которому подключено устройство. Позиционный аргумент || '''обязательный'''  
|  || Порт, к которому подключено устройство. Позиционный аргумент || '''обязательный'''  
|-
|-
| -a, --slaveid || Modbus адрес устройства || '''обязательный'''
| -a, --slaveid || Modbus адрес устройства || 0
|-
|-
|-
|-
| --version || Скачивать прошивку определённой версии || latest
| --save-to || Принудительно скачать прошивку в файл <значение_аргумента> || None
|-
|-
|-
|-
| --branch || Скачивать прошивку из ветки разработки (на свой страх и риск!) || None
| --version || Скачивать прошивку определённой версии || latest
|-
|-
|-
|-
| -h, --help || Описание ключей запуска для режима || Флаг
| --branch || Скачивать прошивку из ветки разработки (не рекомендуется!) || None
|-
|-
| --mode || Обновлять прошивку или бутлоадер || fw
|-
|-
| -f, --force || Произвести перепрошивку устройства даже если установлена самая свежая прошивка || Флаг
!colspan="3"|Общие для всех режимов. Флаги (-<ключ>)
|-
|-
| --debug || Отображать подробные логи работы || None
|-
|-
| --restore-defaults || Стирает все настройки и калибровочные значения: датчики начнут показывать ерунду. <br>Не используйте, если не знаете, что делаете. || Флаг
|-
|-
|}
| --restore-defaults || Восстановить настройки устройства к заводским || False
 
=== Обновление загрузчика (update-bl) ===
{{Anchor|update-bl}}
Обновление загрузчика устройства с известным  modbus-адресом.
 
Изменения в новой версии загрузчика описаны в [[Bootloader_Changelog |журнале изменений]].
 
'''ВНИМАНИЕ:''' обновление загрузчика — потенциально опасная операция. Если во время обновления загрузчика пропало питание, устройство может превратиться в «кирпич». В этом случае гарантия на него аннулируется. Чтобы избежать такой ситуации — подключайте устройство напрямую к контроллеру, а также резервируйте питание контроллера и устройства, например, с помощью [[UPS2 | WB-UPS v.2]].
 
Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию загрузчика и производит обновление, если требуется. При обновлении загрузчика, устройство будет автоматически прошито самой свежей прошивкой.
 
{| class="wikitable"
! Параметр !! Описание !! Значение по умолчанию
|-
|-
| || Порт, к которому подключено устройство. Позиционный аргумент || '''обязательный'''
!colspan="3"|Режим "update". Флаги (-<ключ>)
|-
|-
| -a, --slaveid || Modbus адрес устройства || '''обязательный'''
| --force || Произвести перепрошивку устройства даже, если установлена самая свежая прошивка || False
|-
|-
!colspan="3"|Режим "recover". Ключи со значением (-<ключ> <значение>)
|-
|-
| -h, --help || Описание ключей запуска для режима || Флаг
| --model-name || Полная модель устройства (например, WB-MR6C) || '''обязательный'''
|-
|-
|-
|-
| --force || Произвести перепрошивку устройства даже если установлен самый свежий бутлоадер || Флаг
| --signature || Сигнатура прошивки (если известна заранее) || None
|-
|-
|}
!colspan="3"|Режим "update-all". Ключи со значением (-<ключ> <значение>)
 
Пример команды, которая обновляет загрузчик в устройстве с адресом 153, подключенного к порту /dev/ttyRS485-1:
<syntaxhighlight lang="bash">
wb-mcu-fw-updater update-bl -a 153 /dev/ttyRS485-1
</syntaxhighlight>
 
=== Восстановление (recover) ===
Восстановление устройства с испорченной прошивкой. Если при использовании <code>wb-mcu-fw-updater</code> процедура прервалась, например, пропало питание и устройство не загружается — можно воспользоваться этим режимом.
 
После запуска с указанием порта и modbus-адреса устройства утилита попробует его восстановить с помощью последней зашитой в него прошивкой. Если восстановление не получится, то с согласия пользователя, утилита попробует восстановить устройство с помощью всех доступных прошивок, процесс перебора может быть длительным.
 
{| class="wikitable"
! Параметр !! Описание !! Значение по умолчанию
|-
|-
| || Порт, к которому подключено устройство. Позиционный аргумент || '''обязательный'''
| --config || Путь к конфигурационному файлу wb-mqtt-serial || /etc/wb-mqtt-serial.conf
|-
|-
| -a, --slaveid || Modbus адрес устройства || '''обязательный'''
!colspan="3"|Режим "update-all". Флаги (-<ключ>)
|-
|-
|-
| --force || Произвести перепрошивку устройств даже, если на них установлена самая свежая прошивка || False
| --fw-sig || Сигнатура прошивки (если известна заранее) || None
|-
|-
| --restore-defaults || Стирает все настройки и калибровочные значения: датчики начнут показывать ерунду. <br>Не используйте, если не знаете, что делаете. || Флаг
|-
|-
| -h, --help || Описание ключей запуска для режима || Флаг
|-
|-
|}
|}


=== Обновление прошивки всех устройств (update-all) ===
<!--T:21-->
Пример (устройство в рабочем режиме):
Доступно только на контроллерах Wiren Board.
<pre>
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw
</pre>


Обновление устройств, настроенных через web-интерфейс или прописанных вручную в файле <code>/etc/wb-mqtt-serial.conf</code>.
<!--T:22-->
Пример для Windows (устройство в рабочем режиме):
<pre>
wb-mcu-fw-flasher.exe -j -d COM10 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw
</pre>


Для каждого обнаруженного устройства утилита проверяет наличие обновления и устанавливает его, если необходимо. По завершению утилита возвращает пользователю статистику по обновленным и пропущенным устройствам.
<!--T:23-->
 
Здесь COM10 — имя виртуального последовательного порта, которое присвоено адаптеру USB RS-485.
{| class="wikitable"
! Параметр !! Описание !! Значение по умолчанию
|-
| --force || Произвести перепрошивку устройств даже если на них установлена самая свежая прошивка || Флаг
|-
|-
| -h, --help || Описание ключей запуска для режима || Флаг
|-
|}


=== Восстановление прошивки всех устройств (recover-all) ===
<!--T:24-->
Пример для устройства с нестандартными настройками UART:
<pre>
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw -b 115200
</pre>
В данном случае, устройство работало на скорости порта 115200.


Доступно только на контроллерах Wiren Board.
== Прошивка устройств == <!--T:25-->


Восстановление устройств, настроенных через web-интерфейс или прописанных вручную в файле <code>/etc/wb-mqtt-serial.conf</code>.
<!--T:26-->
'''При прошивке с контроллера остановите wb-mqtt-serial:'''
<pre>
service wb-mqtt-serial stop
</pre>


Для каждого обнаруженного устройства утилита проверяет его статус и, если устройство находится в режиме загрузчика — прошивает свежей прошивкой.
<!--T:27-->
Подключите устройство к RS-485.


{| class="wikitable"
<!--T:28-->
! Параметр !! Описание !! Значение по умолчанию
Если вы не знаете точного аппаратного типа устройства, то его сигнатуру можно прочесть командой:
|-
<pre>
| -h, --help || Описание ключей запуска для режима || Флаг
export mbusaddr=1;  echo  -e `modbus_client --debug -mrtu -pnone -s2 /dev/ttyRS485-1 -a$mbusaddr -t0x03 -r290 -c 12 | grep Data | sed -e 's/0x00/\x/g' -e 's/Data://' -e 's/s//g'`|  xxd -r -p && echo ''
|}
</pre>   
 
Задайте адрес прошиваемого устройства в переменной mbusaddr.
=== Залить прошивку из файла (flash-file) ===
 
Заливает в устройство прошивку из указанного файла.
 
{| class="wikitable"
! Параметр !! Описание !! Значение по умолчанию
|-
| ||Порт, к которому подключено устройство. Позиционный аргумент  || '''обязательный'''
|-
| -a, --slaveid || Modbus адрес устройства || '''обязательный'''
|-
|  --file || Путь к файлу прошивки || '''обязательный'''
|-
| -h, --help || Описание ключей запуска для режима || Флаг
|}


<syntaxhighlight lang="console">
<!--T:29-->
# wb-mcu-fw-updater flash-file /dev/ttyRS485-1 --conn-settings 115200N2 -a20 --file /home/debs/mcm8G__1.4.0-rc1_master_20e4b39.wbfw
В выводе команды вы получите сигнатуру устройства, например, '''wbmr6c'''.
2022-07-27 12:14:02,043 Flashing /home/debs/mcm8G__1.4.0-rc1_master_20e4b39.wbfw
100%|#######################################################################################################|134/134
</syntaxhighlight>


=== Получить debug-лог ===
<!--T:30-->
Если в работе утилиты возникли ошибки, то при обращении в техподдержку лучше приложить debug-лог, чтобы его получить, добавьте в конце команды <code>--debug</code>, например:
Выберите подходящую прошивку, например, WB-MR-MR6C_MCU3_3_1.9.4.wbfw.
<syntaxhighlight lang="bash">
wb-mcu-fw-updater update-fw /dev/ttyMOD1 -a32 -f --debug
</syntaxhighlight>


Параметр работает во всех режимах.
<!--T:31-->
Прошейте устройство командой:
<pre>
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw
</pre>
Успешный процесс прошивки выглядит следующим образом:
<pre>
  wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 1 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw         
  /dev/ttyRS485-1 opened successfully.
  Send jump to bootloader command and wait 2 seconds...
  Error: Connection timed out.
  May be device already in bootloader, try to send firmware...
  WB-MR-MR6C_MCU3_3_1.9.4.wbfw opened successfully, size 12136 bytes
  Sending info block... OK
  Sending data block 89 of 89... OK.
  All done!
</pre>


== Типичные сценарии использования ==
<!--T:32-->
'''После успешной прошивки устройство само выйдет из режима загрузчика и перезапустится в основной программе.'''


Утилита имеет формат запуска:
<!--T:33-->
<syntaxhighlight lang="bash">
Пример ошибки при несовпадении сигнатуры:
wb-mcu-fw-updater <режим работы> <ключи/флаги для этого режима>
<pre>
</syntaxhighlight>
Sending info block...
Error while sending info block: Slave device or server failure
Data format is invalid or firmware signature doesn't match the device
</pre>


Ниже рассмотрим типичные сценарии использования.


=== Обновление прошивки устройства ===  
=== Прошивка устройств по широковещательному Modbus-адресу 0 === <!--T:34-->
# Узнать [[Определение и изменение Modbus-адреса устройств Wirenboard | modbus-адрес]] обновляемого устройства и порт, к которому оно подключено, например, <code>/dev/ttyRS485-1</code>.
# Запустить утилиту <code>wb-mcu-fw-updater</code> со следующими ключами:
#:<syntaxhighlight lang="bash">
wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства>
</syntaxhighlight>


=== Установка тестовой прошивки ===
<!--T:35-->
# Узнать [[Определение и изменение Modbus-адреса устройств Wirenboard | modbus-адрес]] обновляемого устройства и порт, к которому оно подключено, например, <code>/dev/ttyRS485-1</code>.
Bootloader позволяет загружать прошивку на устройства по Modbus-адресу 0. Для этого устройство должно быть единственным устройством на шине и находиться в режиме загрузчика.
# Узнать название тестовой ветки (branch).
# Запустить утилиту <code>wb-mcu-fw-updater</code> со следующими ключами:
#:<syntaxhighlight lang="bash">
wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства> --branch <ветка с тестовой прошивкой>
</syntaxhighlight>


=== Обновление всех устройств, подключённых к драйверу ===
Устройства должны опрашиваться драйвером wb-mqtt-serial, то есть находиться в его конфигурационном файле.
# Запустить утилиту <code>wb-mcu-fw-updater</code> со следующими ключами:
#:<syntaxhighlight lang="bash">
wb-mcu-fw-updater update-all
</syntaxhighlight>


# <li value="2">Дождаться результатов обновления.</li>
=== Прошивка нескольких устройств на шине === <!--T:36-->


=== Восстановление прошивки на устройстве ===
<!--T:37-->
Устройство находится в режиме загрузчика (зелёный светодиод мигает 1 раз в секунду) и не может запустить нормальный режим работы. По завершению восстановления, адрес устройства и настройки uart остаются прежними.
Возможна прошивка нескольких устройств, подключенных к шине. Устройства должны быть переведены в режим загрузчика и прошиваться по отдельности с указанием нешироковещательного Modbus-адреса. Прошивка устройств с одинаковым адресом возможна, если в режиме загрузчика находится только одно из них. Устройства прошиваются по очереди.
# Узнать modbus-адрес устройства и порт, к которому оно подключено.
# Запустить утилиту <code>wb-mcu-fw-updater</code> со следующими ключами:
#:<syntaxhighlight lang="bash">
wb-mcu-fw-updater recover <порт, на котором находится устройство> -a <modbus адрес устройства>
</syntaxhighlight>


== Полезные ссылки ==
<!--T:38-->
* [[Restore factory settings Wiren Board Modbus device | Сброс Modbus-устройства Wiren Board к заводским настройкам]]
'''Внимание!''' Прошивка устройств, находящимся в режиме загрузчика и имеющим одинаковый modbus-адрес, или же прошивка нескольких устройств, находящихся в режиме загрузчика по адресу 0 не будет выполнена; имеющаяся прошивка на устройствах будет испорчена.
* [[WB Modbus Devices Firmware Update | Обновление прошивки Modbus-устройств Wiren Board]]
</translate>
* [[wb-mcu-fw-flasher | Сервисная утилита wb-mcu-fw-flasher]]

Версия 15:14, 7 мая 2020



Статья находится в процессе редактирования!

Возможность обновления

Для всех устройств Wiren Board, работающих по протоколу Modbus RTU, доступно удалённое обновление ПО (микрокода) самого устройства. Обновление реализовано посредством прошивки файла .wbfw по шине modbus с помощью утилиты wb-mcu-fw-flasher. Подробная информация о процедуре прошивки доступна здесь.

Сами файлы обновлений можно скачать в репозитории fw-releases.wirenboard.com


Автоматическое обновление прошивок устройств

Чтобы не производить действия по выбору подходящей прошивки, её скачиванию и установке на устройство, была написана утилита wb-mcu-fw-updater.

Она позволяет свести весь процесс обновления прошивки устройства до указания порта, к которому устройство подключено, и его slaveid (опционально).

Утилита wb-mcu-fw-updater

Установка:

На контроллерах Wiren Board (приобретённых после мая 2020) утилита доступна сразу. На контроллеры, приобретённые ранее, утилита устанавливается следующими командами: 

apt update
apt install python-wb-mcu-fw-updater
На другие Debian-подобные системы:

Для Ubuntu, Linux Mint, Elementary OS и других дистрибутивов, использующих пакетный менеджер apt, порядок действий примерно следующий:

  1. Перейти в репозиторий wb-mcu-fw-updater.
  2. Собрать deb-пакет по инструкции в нём.
  3. Установить wb-mcu-fw-flasher.
  4. Установить собранный deb-пакет командами:
apt update
apt install ./<путь_до_собранного_пакета>.deb

Интерфейс и режимы работы:

Help доступен при запуске утилиты с ключом -h
Режим "update":
Индикация режима загрузчика

Обновление одного устройства с известный slaveid. Если адрес устройства неизвестен, утилита, с согласия пользователя, задаст устройству адрес 245. Далее, утилита считывает версию прошивки устройства и проверяет необходимость обновления. Если есть прошивка новее - скачивает и устанавливает её.

Для успешной работы в данном режиме, нужно освободить порт, к которому подключено устройство, от других драйверов (например, остановив на время wb-mqtt-serial).

Режим "recover":

Восстановление устройства с испорченной прошивкой (например, при прошивке пропало питание, и устройство перестало загружаться). После указания модели устройства, утилита скачивает самую свежую прошивку для него и прошивает её через бутлоадер. Режим предназначен для использования только в бутлоадере (устройство мигает зелёным светодиодом примерно 1 раз в секунду).

Для успешной работы в данном режиме, нужно освободить порт, к которому подключено устройство, от других драйверов (например, остановив на время wb-mqtt-serial).

Режим "update-all":

Обновление производится для всех устройств, работающих через wb-mqtt-serial. Поддерживается только на устройствах Wiren Board (для работы нужен драйвер wb-mqtt-serial). Утилита останавливает драйвер, для каждого обнаруженного устройства в конфигурационном файле /etc/wb-mqtt-serial.conf проверяет наличие обновления и устанавливает его, если имеется. После этого, драйвер перезапускается, а пользователю возвращается список устройств, обновление которых не удалось (если таковые имеются).

Ключи запуска wb-mcu-fw-updater:

Параметр Описание Значение по умолчанию
Общие для всех режимов. Ключи со значением (-<ключ> <значение>)
Порт, к которому подключено устройство. Позиционный аргумент обязательный
-a, --slaveid Modbus адрес устройства 0
--save-to Принудительно скачать прошивку в файл <значение_аргумента> None
--version Скачивать прошивку определённой версии latest
--branch Скачивать прошивку из ветки разработки (не рекомендуется!) None
--mode Обновлять прошивку или бутлоадер fw
Общие для всех режимов. Флаги (-<ключ>)
--debug Отображать подробные логи работы None
--restore-defaults Восстановить настройки устройства к заводским False
Режим "update". Флаги (-<ключ>)
--force Произвести перепрошивку устройства даже, если установлена самая свежая прошивка False
Режим "recover". Ключи со значением (-<ключ> <значение>)
--model-name Полная модель устройства (например, WB-MR6C) обязательный
--signature Сигнатура прошивки (если известна заранее) None
Режим "update-all". Ключи со значением (-<ключ> <значение>)
--config Путь к конфигурационному файлу wb-mqtt-serial /etc/wb-mqtt-serial.conf
Режим "update-all". Флаги (-<ключ>)
--force Произвести перепрошивку устройств даже, если на них установлена самая свежая прошивка False

Пример (устройство в рабочем режиме): 

wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw

Пример для Windows (устройство в рабочем режиме): 

wb-mcu-fw-flasher.exe -j -d COM10 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw

Здесь COM10 — имя виртуального последовательного порта, которое присвоено адаптеру USB RS-485.

Пример для устройства с нестандартными настройками UART: 

wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw -b 115200

В данном случае, устройство работало на скорости порта 115200.

Прошивка устройств

При прошивке с контроллера остановите wb-mqtt-serial: 

service wb-mqtt-serial stop

Подключите устройство к RS-485.

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

export mbusaddr=1;  echo  -e `modbus_client --debug -mrtu -pnone -s2 /dev/ttyRS485-1 -a$mbusaddr -t0x03 -r290 -c 12 | grep Data | sed -e 's/0x00/\x/g' -e 's/Data://' -e 's/s//g'`|  xxd -r -p && echo ''

Задайте адрес прошиваемого устройства в переменной mbusaddr.

В выводе команды вы получите сигнатуру устройства, например, wbmr6c.

Выберите подходящую прошивку, например, WB-MR-MR6C_MCU3_3_1.9.4.wbfw.

Прошейте устройство командой: 

wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw

Успешный процесс прошивки выглядит следующим образом: 

   wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 1 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw          
   /dev/ttyRS485-1 opened successfully.
   Send jump to bootloader command and wait 2 seconds...
   Error: Connection timed out.
   May be device already in bootloader, try to send firmware...
   WB-MR-MR6C_MCU3_3_1.9.4.wbfw opened successfully, size 12136 bytes
   Sending info block... OK
   Sending data block 89 of 89... OK.
   All done!

После успешной прошивки устройство само выйдет из режима загрузчика и перезапустится в основной программе.

Пример ошибки при несовпадении сигнатуры: 

Sending info block...
Error while sending info block: Slave device or server failure 
Data format is invalid or firmware signature doesn't match the device


Прошивка устройств по широковещательному Modbus-адресу 0

Bootloader позволяет загружать прошивку на устройства по Modbus-адресу 0. Для этого устройство должно быть единственным устройством на шине и находиться в режиме загрузчика.


Прошивка нескольких устройств на шине

Возможна прошивка нескольких устройств, подключенных к шине. Устройства должны быть переведены в режим загрузчика и прошиваться по отдельности с указанием нешироковещательного Modbus-адреса. Прошивка устройств с одинаковым адресом возможна, если в режиме загрузчика находится только одно из них. Устройства прошиваются по очереди.

Внимание! Прошивка устройств, находящимся в режиме загрузчика и имеющим одинаковый modbus-адрес, или же прошивка нескольких устройств, находящихся в режиме загрузчика по адресу 0 не будет выполнена; имеющаяся прошивка на устройствах будет испорчена.

Источник — https://wirenboard.com/wiki/index.php?title=Wb-mcu-fw-updater&oldid=38989