WB Modbus Devices Firmware Update/en: различия между версиями
FuzzyBot (обсуждение | вклад) м (FuzzyBot переименовал страницу WB-MCU-Flasher/en в WB Modbus Devices Firmware Update/en без оставления перенаправления: Часть переводимой страницы WB-MCU-Flasher.) |
(Новая страница: «== Firmware bootloader ==») |
||
(не показано 40 промежуточных версий 1 участника) | |||
Строка 5: | Строка 5: | ||
== Firmware bootloader == | == Firmware bootloader == | ||
В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU. | |||
На устройства добавлен режим загрузчика, в котором возможно обновлять прошивку. | |||
В режиме загрузчика основной функционал устройства отключается. '''Коммуникационные параметры в режиме загрузчика фиксированы и не зависят от значений в памяти устройства: 9600 8N2.''' | |||
== | == Переход в режим загрузчика == | ||
[[ | [[Special:MyLanguage/Файл:Bootloader.gif||right||Индикация режима загрузчика]] | ||
Устройство переходит в режим загрузчика, если: | |||
* | * на устройстве имеется корректная прошивка — первые 2 секунды после включения питания устройство работает в режиме загрузчика; | ||
* | * на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки) — в этом случае режим загрузчика активен постоянно; | ||
* | * при работе основной программы в holding-регистр 129 (0x81) была записана 1 — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. | ||
Индикация режима загрузчика: индикатор Status устройства редко мигает. При заливке новой прошивки индикатор перестает менять состояние. | |||
== | == Прошивки == | ||
Запись прошивки в память устройства выполняется загрузчиком, который получает ее по Modbus RTU. Прошивки хранятся в файлах с расширением '''.wbfw'''. | |||
В настоящее время имеющиеся прошивки высылаются по запросу. | |||
== | == Сигнатуры устройств == | ||
При прошивке на заводе в память устройства записывается сигнатура — наименование аппаратного типа устройства. При перезаписи прошивки текущая сигнатура сравнивается с сигнатурой прошивки. Запись новой прошивки возможна только при совпадении сигнатур. | |||
Строка 37: | Строка 39: | ||
Загрузчик устройства получает прошивку по Modbus RTU. В режиме загрузчика коммуникационные параметры фиксированы и не зависят от значений, записанных ранее в память устройства: 9600 8N2. По протоколу Modbus устройство можно перевести в режим загрузчика, если во время работы основной программы записать 1 в holding-регистр 129 (0x81). В этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. | |||
Modbus-адрес устройства для прошивки в режиме загрузчика следует выбирать следующим образом: | |||
# | # Основной адрес для прошивки — адрес, заданный в памяти устройства: то есть это стандартный адрес, на который устройство отвечает из основной программы. | ||
# | # Прошивать устройства можно по широковещательному адресу 0. Это менее предпочтительный способ. | ||
== | == Утилита для прошивки wb-mcu-fw-flasher == | ||
Для передачи прошивки на устройства используется утилита wb-mcu-fw-flasher, запускаемая с контроллера Wiren Board (или компьютера с Linux или Windows). | |||
Для установки утилиты '''на контроллер Wiren Board''' выполните команды: | |||
<pre> | <pre> | ||
apt-get update | apt-get update | ||
Строка 55: | Строка 57: | ||
</pre> | </pre> | ||
Версию утилиты для '''MS Windows''' можно скачать по этой ссылке: [[Special:MyLanguage/Media: Wb-mcu-fw-flasher_1.0.2.zip | Wb-mcu-fw-flasher_1.0.2.zip]] | |||
Для установки на '''компьютер с Debian''' скачайте пакет отсюда: [[Special:MyLanguage/Media: Wb-mcu-fw-flasher_1.0.2_amd64-all.deb | Wb-mcu-fw-flasher_1.0.2_amd64-all.deb]] | |||
и выполните команды в директории, гуда загрузился пакет пакет. | |||
<pre> | <pre> | ||
apt-get update | apt-get update | ||
Строка 67: | Строка 69: | ||
wb-mcu-fw-flasher | Опции запуска утилиты wb-mcu-fw-flasher: | ||
{| class="wikitable" | {| class="wikitable" | ||
! | ! Параметр !! Описание !! Значение по умолчанию | ||
|- | |- | ||
| -d || | | -d || Устройство последовательного порта || | ||
|- | |- | ||
| -f || | | -f || Файл прошивки || | ||
|- | |- | ||
| -a || Modbus | | -a || Адрес Modbus || 1 | ||
|- | |- | ||
| -j || | | -j || Отправить на устройство команду перехода в режим загрузчика || | ||
|- | |- | ||
| -r || | | -r || Адрес holding-регистра для перехода в режим загрузчика || 129 | ||
|- | |- | ||
| -D || | | -D || Включить режим отладки || | ||
|} | |} | ||
Строка 89: | Строка 91: | ||
</pre> | </pre> | ||
Пример для Windows: | |||
<pre> | <pre> | ||
wb-mcu-fw-flasher.exe -j -d COM10 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw | wb-mcu-fw-flasher.exe -j -d COM10 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw | ||
</pre> | </pre> | ||
COM10 | Здесь COM10 — имя виртуального последовательного порта, которое присвоено адаптеру USB RS-485. | ||
== | == Прошивка устройств == | ||
''' | '''При прошивке с контроллера остановите wb-mqtt-serial:''' | ||
<pre> | <pre> | ||
service wb-mqtt-serial stop | service wb-mqtt-serial stop | ||
</pre> | </pre> | ||
Подключите устройство к RS-485. | |||
Если вы не знаете точного аппаратного типа устройства, то его сигнатуру можно прочесть командой: | |||
<pre> | <pre> | ||
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 '' | 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> | </pre> | ||
Задайте адрес прошиваемого устройства в переменной mbusaddr. | |||
В выводе команды вы получите сигнатуру устройства, например, '''wbmr6c'''. | |||
Выберите подходящую прошивку, например, WB-MR-MR6C_MCU3_3_1.9.4.wbfw. | |||
Прошейте устройство командой: | |||
<pre> | <pre> | ||
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 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw | ||
</pre> | </pre> | ||
Успешный процесс прошивки выглядит следующим образом: | |||
<pre> | <pre> | ||
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 1 -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 | ||
Строка 133: | Строка 135: | ||
</pre> | </pre> | ||
''' | '''После успешной прошивки устройство само выйдет из режима загрузчика и перезапустится в основной программе.''' | ||
Пример ошибки при несовпадении сигнатуры: | |||
<pre> | <pre> | ||
Sending info block... | Sending info block... | ||
Строка 143: | Строка 145: | ||
=== | === Прошивка устройств по широковещательному Modbus-адресу 0 === | ||
Bootloader | Bootloader позволяет загружать прошивку на устройства но Modbus-адресу 0. Для этого устройство должно быть единственным устройством на шине и находится в режиме загрузчика. | ||
=== | === Прошивка нескольких устройств на шине === | ||
Возможна прошивка нескольких устройств, подключенных к шине. Устройства должны быть переведены в режим загрузчика и прошиваться по отдельности с указанием нешироковещательного Modbus-адреса. Прошивка устройств с одинаковым адресом возможна, если в режиме загрузчика находится только одно из них. Устройства прошиваются по очереди. | |||
''' | '''Внимание!''' Прошивка устройств, находящимся в режиме загрузчика и имеющим одинаковый modbus-адрес, или же прошивка нескольких устройств, находящихся в режиме загрузчика по адресу 0 не будет выполнена; имеющаяся прошивка на устройствах будет испорчена. |
Версия 15:50, 25 апреля 2019
Внимание: Отображаемое название «Загрузка прошивок на устройства Wiren Board» переопределяет ранее заданное отображаемое название «WB-MCU-Flasher».
Firmware bootloader
В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU. На устройства добавлен режим загрузчика, в котором возможно обновлять прошивку.
В режиме загрузчика основной функционал устройства отключается. Коммуникационные параметры в режиме загрузчика фиксированы и не зависят от значений в памяти устройства: 9600 8N2.
Переход в режим загрузчика
|right||Индикация режима загрузчика Устройство переходит в режим загрузчика, если:
- на устройстве имеется корректная прошивка — первые 2 секунды после включения питания устройство работает в режиме загрузчика;
- на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки) — в этом случае режим загрузчика активен постоянно;
- при работе основной программы в holding-регистр 129 (0x81) была записана 1 — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд.
Индикация режима загрузчика: индикатор Status устройства редко мигает. При заливке новой прошивки индикатор перестает менять состояние.
Прошивки
Запись прошивки в память устройства выполняется загрузчиком, который получает ее по Modbus RTU. Прошивки хранятся в файлах с расширением .wbfw. В настоящее время имеющиеся прошивки высылаются по запросу.
Сигнатуры устройств
При прошивке на заводе в память устройства записывается сигнатура — наименование аппаратного типа устройства. При перезаписи прошивки текущая сигнатура сравнивается с сигнатурой прошивки. Запись новой прошивки возможна только при совпадении сигнатур.
Modbus
Загрузчик устройства получает прошивку по Modbus RTU. В режиме загрузчика коммуникационные параметры фиксированы и не зависят от значений, записанных ранее в память устройства: 9600 8N2. По протоколу Modbus устройство можно перевести в режим загрузчика, если во время работы основной программы записать 1 в holding-регистр 129 (0x81). В этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд.
Modbus-адрес устройства для прошивки в режиме загрузчика следует выбирать следующим образом:
- Основной адрес для прошивки — адрес, заданный в памяти устройства: то есть это стандартный адрес, на который устройство отвечает из основной программы.
- Прошивать устройства можно по широковещательному адресу 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.2.zip
Для установки на компьютер с Debian скачайте пакет отсюда: Wb-mcu-fw-flasher_1.0.2_amd64-all.deb и выполните команды в директории, гуда загрузился пакет пакет.
apt-get update apt-get install libmodbus5 dpkg -i Wb-mcu-fw-flasher_1.0.2_amd64-all.deb
Опции запуска утилиты wb-mcu-fw-flasher:
Параметр | Описание | Значение по умолчанию |
---|---|---|
-d | Устройство последовательного порта | |
-f | Файл прошивки | |
-a | Адрес Modbus | 1 |
-j | Отправить на устройство команду перехода в режим загрузчика | |
-r | Адрес holding-регистра для перехода в режим загрузчика | 129 |
-D | Включить режим отладки |
Пример:
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.
Прошивка устройств
При прошивке с контроллера остановите 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 не будет выполнена; имеющаяся прошивка на устройствах будет испорчена.