Загрузка прошивок на устройства Wiren Board
Загрузчик прошивок
В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU.
В режиме загрузчика основной функционал устройства отключается. Коммуникационные параметры в режиме загрузчика фиксированы и не зависят от значений в памяти устройства: 9600 8N2.
Переход в режим загрузчика
- Если на устройстве имеется корректная прошивка, то первые 2 секунды после включения питания устройство работает в режиме загрузчика;
- Если на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки), то режим загрузчика активен постоянно;
- При записи 1 в holding-регистр 129 (0x81) при работе основной программы — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. Это может сделать утилита wb-mcu-fw-flasher если использовать ключ -j.
Индикация режима загрузчика: индикатор Status устройства редко мигает с периодом 1 секунда. При заливке прошивки индикатор часто мигает при приеме блока данных.
Автоматическое обновление прошивки с контроллера Wiren Board
Прошивку устройств, подключенных к контроллеру Wiren Board можно обновить с помощью утилиты wb-mcu-fw-updater. Утилита проверяет наличие новой версии прошивки для всех подключенных устройств и, при необходимости, обновляет их.
Для установки выполните в консоли:
dpkg -s wb-mcu-fw-updater || (apt update && apt install wb-mcu-fw-updater)
Для обновления прошивки всех устройств, описанных в разделе Serial Devices Configuration (файл /etc/wb-mqtt-serial.conf), выполните:
wb-mcu-fw-updater update-all
Для обновления прошивки конкретного устройства, укажите порт и его адрес Modbus:
wb-mcu-fw-updater update-fw /dev/ttyRS485-2 -a70
Подробную информацию смотрите в выводе
wb-mcu-fw-updater --help
Пример работы wb-fw-mcu-updater
Ручная прошивка устройств
Выбор прошивки
Прошивки публикуются на сайте fw-releases.wirenboard.com в виде файлов с расширением .wbfw.
Прошивки сгруппированы по версиям и сигнатурам (типам) устройств.
Каждое Modbus устройство Wirenboard имеет сигнатуру — наименование аппаратного типа устройства. Перезапись прошивки возможна только при совпадении сигнатур устройства и прошивки.
Сигнатура устройства хранится в формате строки из 12 ASCII символов, по одному символу в регистре, и доступна по адресу 290. Получить можно командой:
echo -e $(modbus_client -mrtu -pnone -s2 /dev/ttyRS485-1 -a A -t3 -r 290 -c 12 | grep Data | sed -e 's/.*Data://' -e 's/ 0x00/\\x/g')
замените значения /dev/ttyRS485-1 на имя устройства шины и A на адрес устройства.
В результате будет выведена строка с сигнатурой, например mr6c
Прошивку вы можете скачать например с помощью команды wget , для mr6c это будет выглядеть следующим образом:
wget http://fw-releases.wirenboard.com/fw/by-signature/mr6c/stable/latest.wbfw
Подключение устройства
Прошивать устройство лучше по стандартному адресу (на который устройство отвечает из основной программы).
Так же можно прошивать по широковещательному адресу 0, если у вас одно устройство на шине в режиме загрузчика.
Поэтому для прошивки нескольких устройств на шине можно:
- переводить в режим загрузчика (перезагрузкой по питанию или записью в регистр) и прошивать по отдельности с указанием нешироковещательного Modbus-адреса.
- переводить по очереди в режим загрузчика (перезагрузкой по питанию) и прошивать по адресу 0.
- Одновременная прошивка устройств невозможна; имеющаяся прошивка на устройствах будет испорчена.
- Перевести устройство в бутлоадер по широковещательному адресу 0 - нельзя!
- При прошивке с контроллера остановите wb-mqtt-serial:
service wb-mqtt-serial stop
Утилита wb-mcu-fw-flasher для прошивки устройств
Для установки утилиты на контроллер Wiren Board выполните команды:
apt-get update apt-get install wb-mcu-fw-flasher
Версия утилиты для MS Windows: Wb-mcu-fw-flasher_1.0.3.zip
Для установки на компьютер с Debian скачайте пакет - Wb-mcu-fw-flasher_1.0.3_amd64-all.deb и выполните команды в директории, куда загрузился пакет:
apt-get update apt-get install libmodbus5 dpkg -i Wb-mcu-fw-flasher_1.0.3_amd64-all.deb
Для контроллеров других производителей с процессорами ARM Cortex можно воспользоваться Debian-пакетом для Wiren Board: http://releases.contactless.ru/?prefix=stable/stretch/pool/main/w/wb-mcu-fw-flasher/
Опции запуска утилиты wb-mcu-fw-flasher:
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
| -d | Устройство последовательного порта (обязательно) | |
| -f | Файл прошивки | |
| -a | Адрес Modbus | 1 |
| -j | Отправить на устройство команду перехода в режим загрузчика | |
| -b | Скорость порта (baudrate) | 9600 |
| -p | Чётность (parity) | N |
| -s | Количество стопбитов | 2 |
| -r | Адрес holding-регистра для перехода в режим загрузчика | 129 |
| -D | Включить режим отладки | |
| -u | Восстановление заводских настроек UART и Modbus адреса | |
| -e | Сброс всех настроек до заводских |
Пример (устройство в рабочем режиме):
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 (со скоростью порта 115200):
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw -b 115200
Прошивка устройств
Итого, порядок действий:
- При прошивке с контроллера остановите wb-mqtt-serial.
- Подключите устройство к RS-485.
- Скачайте файл прошивки, например, mr6c__1.14.1_master_19c9ca5.wbfw
- Прошейте устройство утилитой wb-mcu-fw-flasher:
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f mr6c__1.14.1_master_19c9ca5.wbfw
- После успешной прошивки устройство само выйдет из режима загрузчика и перезапустится в основной программе.
Успешный процесс прошивки выглядит так:
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 1 -f mr6c__1.14.1_master_19c9ca5.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... mr6c__1.14.1_master_19c9ca5.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