Обновление прошивок на устройствах Wiren Board

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

В наших modbus-устройствах реализован механизм загрузчика прошивок — bootloader. Он позволяет обновлять микропрограммы устройств и модулей Wiren Board по RS-485/Modbus RTU.

В режиме загрузчика основные функции устройства отключаются, а коммуникационные параметры в режиме загрузчика фиксированы и не зависят от значений в памяти устройства: 9600 8N2.

Автоматическое обновление

Пример работы wb-fw-mcu-updater

Автоматическое обновление прошивки выполняется с помощью предустановленной на контроллеры Wiren Board утилиты wb-mcu-fw-updater и позволяет установить свежую версию ПО сразу на все подключенные устройства или отдельно на каждое. Определение сигнатуры (модели) устройства, новой прошивки произойдет автоматически.

Для использования утилиты нужен доступ в интернет, если это не так — смотрите раздел про ручное обновление.

Вы можете использовать утилиту и без нашего контроллера, для этого вам понадобится Debian-подобная ОС Linux. Читайте инструкцию по установке в описании утилиты.

Обновление всех устройств на шине

Для обновления прошивки всех устройств, описанных в разделе Serial Devices Configuration веб-интерфейса (файл /etc/wb-mqtt-serial.conf), выполните:

wb-mcu-fw-updater update-all

Обновление определенного устройства

Чтобы обновить определенное устройство:

. Узнайте modbus-адрес устройства, которое хотите обновить.
. Запустите утилиту wb-mcu-fw-updater параметрами: ключ update-fw, а также порт и modbus-адрес.

Например, обновим прошивку устройства с modbus-адресом 70 и подключенного к порту /dev/ttyRS485-1:

wb-mcu-fw-updater update-fw /dev/ttyRS485-1 -a70

Полный список параметров и примеры работы смотрите на странице утилиты.

Ручное обновление

Мы не рекомендуем этот способ, но если на объекте нет доступа в интернет — это единственный вариант.

Ручное обновление можно сделать утилитой wb-mcu-fw-flasher, которую нужно предварительно установить. Способ установки отличается и зависит от используемой операционной системы.

Выбор прошивки

Прошивки публикуются на сайте fw-releases.wirenboard.com в виде файлов с расширением .wbfw.

Прошивки сгруппированы по версиям и сигнатурам (типам) устройств.

Каждое modbus-устройство Wiren Board имеет сигнатуру — наименование аппаратного типа устройства. Устройство будет прошито только если его сигнатура совпадет с сигнатурой в прошивке.

Сигнатура устройства хранится в формате строки из 12 ASCII символов, по одному символу в регистре, и доступна по адресу 290.

Сигнатуру устройства в ОС Linux и на контроллере можно с помощью утилиты modbus_client. Узнаем сигнатуру устройства с адресом 10 и подключенного к порту ttyRS485-1

echo -e $(modbus_client -mrtu -pnone -s2 /dev/ttyRS485-1 -a 10 -t3 -r 290 -c 12 | grep Data | sed -e 's/.*Data://' -e 's/ 0x00/\\x/g')

В результате будет выведена строка с сигнатурой, например mr6c.

О том, как читать регистры из ОС Windows смотрите в статье Работа с устройствами Wiren Board без контроллера

Теперь, имея сигнатуру вы можете скачать прошивку устройства:

Перейдите на сайт fw-releases.wirenboard.com.
Выберите папку by-signature.
Найдите и откройте папку с нужной сигнатурой устройства.
Выберите одну из веток:
- stable — стабильные версии прошивок. Чтобы скачать самую свежую, выберите файл latest.wbfw.
- unstable — экспериментальные версии прошивок.

Подготовка устройства

Прошивать устройства можно:

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

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

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

на устройстве имеется корректная прошивка, то первые 2 секунды после включения питания устройство работает в режиме загрузчика;
на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки), то режим загрузчика активен постоянно;
при работе основной программы записать 1 в holding-регистр 129 (0x81) — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. Это можно сделать, запустив утилиту wb-mcu-fw-flasher с ключем -j.

В режиме загрузчика индикатор Status устройства мигает с периодом 1 секунда, а при записи прошивки мигание индикатора учащается.

Загрузка прошивки в устройство

Для загрузки прошивки выполните шаги:

Подключите устройство по шине RS-485 к контроллеру или другому оборудованию, где установлена утилита прошивки.
Если вы прошиваете устройство с контроллера, то остановите драйвер wb-mqtt-serial или иное ПО, которое опрашивает устройство.
Загрузите файл прошивки на контроллер или другое устройство, на котором установлена утилита прошивки.

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

на контроллере или в ОС Linux:

wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f mr6c__1.15.5_master_971fe50.wbfw

в ОС Windows:

wb-mcu-fw-flasher_1.0.3.exe -j -d COM1 -a 25 -f mr6c__1.15.5_master_971fe50.wbfw

Здесь мы флагом -j переводим устройство, подключенное к порту /dev/ttyRS485-1 (COM1) с адресом 25 в режим загрузчика и загружаем файл прошивки.

Успешный процесс прошивки выглядит так:

~# wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f mr6c__1.15.5_master_971fe50.wbfw  
   /dev/ttyRS485-1 opened successfully.
   Send jump to bootloader command and wait 2 seconds...
   Ok, device will jump to bootloader.
   mr6c__1.15.5_master_971fe50.wbfw opened successfully, size 14720 bytes

   Sending info block... OK

   Sending data block 108 of 108... 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

Навигация