Difference between revisions of "WB Modbus Devices Firmware Update"

From Wiren Board
Jump to navigation Jump to search
(9 intermediate revisions by the same user not shown)
Line 9: Line 9:
 
<!--T:2-->
 
<!--T:2-->
 
В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU.  
 
В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU.  
На устройства добавлен режим загрузчика, в котором возможно обновлять прошивку.
 
  
 
<!--T:3-->
 
<!--T:3-->
Line 18: Line 17:
 
<!--T:5-->
 
<!--T:5-->
 
[[File:Bootloader.gif||right||Индикация режима загрузчика]]
 
[[File:Bootloader.gif||right||Индикация режима загрузчика]]
Устройство переходит в режим загрузчика, если:
+
 
* на устройстве имеется корректная прошивка первые 2 секунды после включения питания устройство работает в режиме загрузчика;
+
* Если на устройстве имеется корректная прошивка, то первые 2 секунды после включения питания устройство работает в режиме загрузчика;
* на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки) — в этом случае режим загрузчика активен постоянно;
+
* Если на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки), то режим загрузчика активен постоянно;
* при работе основной программы в holding-регистр 129 (0x81) была записана 1 — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд.
+
* При записи 1 в holding-регистр 129 (0x81) при работе основной программы — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд.
  
 
<!--T:6-->
 
<!--T:6-->
Line 27: Line 26:
  
 
== Автоматическое обновление прошивки с контроллера Wiren Board ==
 
== Автоматическое обновление прошивки с контроллера Wiren Board ==
Прошивку устройств, подключенных к контроллеру Wiren Board можно обновить с помощью утилиты wb-mcu-fw-updater. Утилита проверяет наличиие новой версии прошивки для всех подключенных устройств и, при необходимости, обновляет их.  
+
Прошивку устройств, подключенных к контроллеру Wiren Board можно обновить с помощью утилиты [[wb-mcu-fw-updater]]. Утилита проверяет наличие новой версии прошивки для всех подключенных устройств и, при необходимости, обновляет их.  
 
 
Подробная информация об утилите доступна [[Wb-mcu-fw-updater | здесь.]]
 
  
 
Для установки выполните в консоли:
 
Для установки выполните в консоли:
Line 36: Line 33:
 
</pre>
 
</pre>
  
Чтобы обновить прошивки всех устройств, описанных в разделе Serial Devices Configuration (файл /etc/wb-mqtt-serial.conf), выполните:
+
Для обновления прошивки всех устройств, описанных в разделе Serial Devices Configuration (файл /etc/wb-mqtt-serial.conf), выполните:
 
<pre>
 
<pre>
 
wb-mcu-fw-updater update-all
 
wb-mcu-fw-updater update-all
 
</pre>
 
</pre>
  
Для обновления прошивки конкретного устройства, нужно указать порт и его адрес Modbus:
+
Для обновления прошивки конкретного устройства, укажите порт и его адрес Modbus:
 
<pre>
 
<pre>
 
wb-mcu-fw-updater update-fw /dev/ttyRS485-2 -a70
 
wb-mcu-fw-updater update-fw /dev/ttyRS485-2 -a70
Line 51: Line 48:
 
</pre>
 
</pre>
  
<gallery mode="packed" heights="300px">
+
<gallery mode="packed" heights="200px">
 
File:Wb-fw-mcu-updater example 1.png|Пример работы wb-fw-mcu-updater
 
File:Wb-fw-mcu-updater example 1.png|Пример работы wb-fw-mcu-updater
 
</gallery>
 
</gallery>
Line 57: Line 54:
 
== Выбор прошивки ==
 
== Выбор прошивки ==
  
Прошивки публикуются на сайте [http://fw-releases.wirenboard.com/?prefix=fw/ '''fw-releases.wirenboard.com'''] и представляют собой файлы с расширением '''.wbfw'''.
+
Прошивки публикуются на сайте [http://fw-releases.wirenboard.com/?prefix=fw/ '''fw-releases.wirenboard.com'''] в виде файлов с расширением '''.wbfw'''.
  
Прошивки сгруппированы по версиям и сигнатурам устройств.
+
Прошивки сгруппированы по версиям и сигнатурам (типам) устройств.
  
 
Каждое Modbus устройство Wirenboard имеет сигнатуру — наименование аппаратного типа устройства. Перезапись прошивки возможна только при совпадении сигнатур устройства и прошивки.
 
Каждое Modbus устройство Wirenboard имеет сигнатуру — наименование аппаратного типа устройства. Перезапись прошивки возможна только при совпадении сигнатур устройства и прошивки.
  
 
Сигнатура устройства хранится в формате строки из 12 ASCII символов, по одному символу в регистре, и доступна по адресу 290.
 
Сигнатура устройства хранится в формате строки из 12 ASCII символов, по одному символу в регистре, и доступна по адресу 290.
 
+
Получить можно командой:
Получить сигнатуру устройства в виде текстовой строки можно командой:
 
  
 
<code>
 
<code>
Line 76: Line 72:
  
 
== Modbus == <!--T:11-->
 
== Modbus == <!--T:11-->
 +
При записи 1 в holding-регистр 129 (0x81) устройство перезагружается и остается в режиме загрузчика 120 секунд.
  
<!--T:12-->
+
Загрузчик устройства получает прошивку по Modbus RTU. В режиме загрузчика коммуникационные параметры фиксированы и не зависят от значений, записанных ранее в память устройства: 9600 8N2.  
Загрузчик устройства получает прошивку по Modbus RTU. В режиме загрузчика коммуникационные параметры фиксированы и не зависят от значений, записанных ранее в память устройства: 9600 8N2. По протоколу Modbus устройство можно перевести в режим загрузчика, если во время работы основной программы записать 1 в holding-регистр 129 (0x81). В этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд.
 
  
 
<!--T:13-->
 
<!--T:13-->
Modbus-адрес устройства для прошивки в режиме загрузчика следует выбирать следующим образом:
+
Прошивать устройство лучше по стандартному адресу (на который устройство отвечает из основной программы).
 
 
<!--T:14-->
 
# Основной адрес для прошивки — адрес, заданный в памяти устройства: то есть это стандартный адрес, на который устройство отвечает из основной программы.
 
# Если устройство находится в бутлоадере, прошивать можно по широковещательному адресу 0. Это менее предпочтительный способ.
 
# Перевести устройство в бутлоадер по широковещательному адресу 0 - '''нельзя'''!
 
 
 
=== Прошивка устройств по широковещательному Modbus-адресу 0 === <!--T:34-->
 
 
 
<!--T:35-->
 
Bootloader позволяет загружать прошивку на устройства по Modbus-адресу 0. Для этого устройство должно быть единственным устройством на шине и находиться в режиме загрузчика.
 
  
=== Прошивка нескольких устройств на шине === <!--T:36-->
+
Так же можно прошивать по широковещательному адресу 0, если у вас одно устройство на шине в режиме загрузчика.
  
<!--T:37-->
+
Поэтому для прошивки нескольких устройств на шине можно:
Возможна прошивка нескольких устройств, подключенных к шине. Устройства должны быть переведены в режим загрузчика и прошиваться по отдельности с указанием нешироковещательного Modbus-адреса. Прошивка устройств с одинаковым адресом возможна, если в режиме загрузчика находится только одно из них. Устройства прошиваются по очереди.
+
#переводить в режим загрузчика (перезагрузкой по питанию или записью в регистр) и прошивать по отдельности с указанием нешироковещательного Modbus-адреса.
 +
#переводить '''по очереди''' в режим загрузчика (перезагрузкой по питанию) и прошивать по адресу 0.
  
<!--T:38-->
+
'''Внимание!''' Одновременная прошивка устройств невозможна; имеющаяся прошивка на устройствах будет испорчена.
'''Внимание!''' Прошивка устройств, находящимся в режиме загрузчика и имеющим одинаковый modbus-адрес, или же прошивка нескольких устройств, находящихся в режиме загрузчика по адресу 0 не будет выполнена; имеющаяся прошивка на устройствах будет испорчена.
+
* Перевести устройство в бутлоадер по широковещательному адресу 0 - '''нельзя'''!
  
 
== Утилита для прошивки wb-mcu-fw-flasher == <!--T:15-->
 
== Утилита для прошивки wb-mcu-fw-flasher == <!--T:15-->

Revision as of 19:41, 31 July 2020

Other languages:
English • ‎русский


Загрузчик прошивок

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

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

Переход в режим загрузчика

Индикация режима загрузчика
  • Если на устройстве имеется корректная прошивка, то первые 2 секунды после включения питания устройство работает в режиме загрузчика;
  • Если на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки), то режим загрузчика активен постоянно;
  • При записи 1 в holding-регистр 129 (0x81) при работе основной программы — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд.

Индикация режима загрузчика: индикатор 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

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

Прошивки публикуются на сайте 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

Modbus

При записи 1 в holding-регистр 129 (0x81) устройство перезагружается и остается в режиме загрузчика 120 секунд.

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

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

Так же можно прошивать по широковещательному адресу 0, если у вас одно устройство на шине в режиме загрузчика.

Поэтому для прошивки нескольких устройств на шине можно:

  1. переводить в режим загрузчика (перезагрузкой по питанию или записью в регистр) и прошивать по отдельности с указанием нешироковещательного Modbus-адреса.
  2. переводить по очереди в режим загрузчика (перезагрузкой по питанию) и прошивать по адресу 0.

Внимание! Одновременная прошивка устройств невозможна; имеющаяся прошивка на устройствах будет испорчена.

  • Перевести устройство в бутлоадер по широковещательному адресу 0 - нельзя!

Утилита для прошивки wb-mcu-fw-flasher

Для передачи прошивки на устройства используется утилита wb-mcu-fw-flasher, запускаемая с контроллера Wiren Board (или компьютера с Linux или Windows).

Для установки утилиты на контроллер 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:

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.

Определите сигнатуру и скачайте файл прошивки, например, mr6c__1.14.1_master_19c9ca5.wbfw

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

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