wb_editors
556
правок
WB Modbus Devices Firmware Update: различия между версиями
WB Modbus Devices Firmware Update (просмотреть исходный код)
Версия 12:24, 28 июня 2019
, 4 года назадНет описания правки
(Подготовка страницы к переводу) |
Vdromanov (обсуждение | вклад) |
||
| (не показано 7 промежуточных версий 3 участников) | |||
| Строка 5: | Строка 5: | ||
<translate> | <translate> | ||
== Загрузчик прошивок == | == Загрузчик прошивок == <!--T:1--> | ||
<!--T:2--> | |||
В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU. | В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU. | ||
На устройства добавлен режим загрузчика, в котором возможно обновлять прошивку. | На устройства добавлен режим загрузчика, в котором возможно обновлять прошивку. | ||
<!--T:3--> | |||
В режиме загрузчика основной функционал устройства отключается. '''Коммуникационные параметры в режиме загрузчика фиксированы и не зависят от значений в памяти устройства: 9600 8N2.''' | В режиме загрузчика основной функционал устройства отключается. '''Коммуникационные параметры в режиме загрузчика фиксированы и не зависят от значений в памяти устройства: 9600 8N2.''' | ||
== Переход в режим загрузчика == | == Переход в режим загрузчика == <!--T:4--> | ||
[[ | <!--T:5--> | ||
[[File:Bootloader.gif||right||Индикация режима загрузчика]] | |||
Устройство переходит в режим загрузчика, если: | Устройство переходит в режим загрузчика, если: | ||
* на устройстве имеется корректная прошивка — первые 2 секунды после включения питания устройство работает в режиме загрузчика; | * на устройстве имеется корректная прошивка — первые 2 секунды после включения питания устройство работает в режиме загрузчика; | ||
| Строка 21: | Строка 24: | ||
* при работе основной программы в holding-регистр 129 (0x81) была записана 1 — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. | * при работе основной программы в holding-регистр 129 (0x81) была записана 1 — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. | ||
<!--T:6--> | |||
Индикация режима загрузчика: индикатор Status устройства редко мигает. При заливке новой прошивки индикатор перестает менять состояние. | Индикация режима загрузчика: индикатор Status устройства редко мигает. При заливке новой прошивки индикатор перестает менять состояние. | ||
== Прошивки == <!--T:7--> | |||
<!--T:8--> | |||
Запись прошивки в память устройства выполняется загрузчиком, который получает ее по Modbus RTU. Прошивки хранятся в файлах с расширением '''.wbfw'''. | Запись прошивки в память устройства выполняется загрузчиком, который получает ее по Modbus RTU. Прошивки хранятся в файлах с расширением '''.wbfw'''. | ||
В настоящее время имеющиеся прошивки высылаются по запросу. | В настоящее время имеющиеся прошивки высылаются по запросу. | ||
== Сигнатуры устройств == | == Сигнатуры устройств == <!--T:9--> | ||
<!--T:10--> | |||
При прошивке на заводе в память устройства записывается сигнатура — наименование аппаратного типа устройства. При перезаписи прошивки текущая сигнатура сравнивается с сигнатурой прошивки. Запись новой прошивки возможна только при совпадении сигнатур. | При прошивке на заводе в память устройства записывается сигнатура — наименование аппаратного типа устройства. При перезаписи прошивки текущая сигнатура сравнивается с сигнатурой прошивки. Запись новой прошивки возможна только при совпадении сигнатур. | ||
== Modbus == | == Modbus == <!--T:11--> | ||
<!--T:12--> | |||
Загрузчик устройства получает прошивку по Modbus RTU. В режиме загрузчика коммуникационные параметры фиксированы и не зависят от значений, записанных ранее в память устройства: 9600 8N2. По протоколу Modbus устройство можно перевести в режим загрузчика, если во время работы основной программы записать 1 в holding-регистр 129 (0x81). В этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. | Загрузчик устройства получает прошивку по Modbus RTU. В режиме загрузчика коммуникационные параметры фиксированы и не зависят от значений, записанных ранее в память устройства: 9600 8N2. По протоколу Modbus устройство можно перевести в режим загрузчика, если во время работы основной программы записать 1 в holding-регистр 129 (0x81). В этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. | ||
<!--T:13--> | |||
Modbus-адрес устройства для прошивки в режиме загрузчика следует выбирать следующим образом: | Modbus-адрес устройства для прошивки в режиме загрузчика следует выбирать следующим образом: | ||
<!--T:14--> | |||
# Основной адрес для прошивки — адрес, заданный в памяти устройства: то есть это стандартный адрес, на который устройство отвечает из основной программы. | # Основной адрес для прошивки — адрес, заданный в памяти устройства: то есть это стандартный адрес, на который устройство отвечает из основной программы. | ||
# | # Если устройство находится в бутлоадере, прошивать можно по широковещательному адресу 0. Это менее предпочтительный способ. | ||
# Перевести устройство в бутлоадер по широковещательному адресу 0 - '''нельзя'''! | |||
== Утилита для прошивки wb-mcu-fw-flasher == | == Утилита для прошивки wb-mcu-fw-flasher == <!--T:15--> | ||
<!--T:16--> | |||
Для передачи прошивки на устройства используется утилита wb-mcu-fw-flasher, запускаемая с контроллера Wiren Board (или компьютера с Linux или Windows). | Для передачи прошивки на устройства используется утилита wb-mcu-fw-flasher, запускаемая с контроллера Wiren Board (или компьютера с Linux или Windows). | ||
<!--T:17--> | |||
Для установки утилиты '''на контроллер Wiren Board''' выполните команды: | Для установки утилиты '''на контроллер Wiren Board''' выполните команды: | ||
<pre> | <pre> | ||
| Строка 59: | Строка 69: | ||
</pre> | </pre> | ||
Версию утилиты для '''MS Windows''' можно скачать по этой ссылке: [[ | <!--T:18--> | ||
Версию утилиты для '''MS Windows''' можно скачать по этой ссылке: [[Media: Wb-mcu-fw-flasher_1.0.3.zip | Wb-mcu-fw-flasher_1.0.3.zip]] | |||
Для установки на '''компьютер с Debian''' скачайте пакет отсюда: [[ | <!--T:19--> | ||
и выполните команды в директории, | Для установки на '''компьютер с Debian''' скачайте пакет отсюда: [[Media: Wb-mcu-fw-flasher_1.0.3_amd64-all.deb | Wb-mcu-fw-flasher_1.0.3_amd64-all.deb]] | ||
и выполните команды в директории, куда загрузился пакет. | |||
<pre> | <pre> | ||
apt-get update | apt-get update | ||
apt-get install libmodbus5 | apt-get install libmodbus5 | ||
dpkg -i Wb-mcu-fw-flasher_1.0. | dpkg -i Wb-mcu-fw-flasher_1.0.3_amd64-all.deb | ||
</pre> | </pre> | ||
<!--T:20--> | |||
Опции запуска утилиты wb-mcu-fw-flasher: | Опции запуска утилиты wb-mcu-fw-flasher: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Параметр !! Описание !! Значение по умолчанию | ! Параметр !! Описание !! Значение по умолчанию | ||
|- | |- | ||
| -d || Устройство последовательного порта || | | -d || Устройство последовательного порта ('''обязательно''') || | ||
|- | |- | ||
| -f || Файл прошивки || | | -f || Файл прошивки || | ||
| Строка 81: | Строка 92: | ||
| -a || Адрес Modbus || 1 | | -a || Адрес Modbus || 1 | ||
|- | |- | ||
| -j || Отправить на устройство команду перехода в режим загрузчика || | | -j || Отправить на устройство команду перехода в режим загрузчика || | ||
|- | |||
| -b || Скорость порта (baudrate) || 9600 | |||
|- | |||
| -p || Чётность (parity) || N | |||
|- | |||
| -s || Количество стопбитов || 2 | |||
|- | |- | ||
| -r || Адрес holding-регистра для перехода в режим загрузчика || 129 | | -r || Адрес holding-регистра для перехода в режим загрузчика || 129 | ||
| Строка 88: | Строка 105: | ||
|} | |} | ||
Пример: | <!--T:21--> | ||
Пример (устройство в рабочем режиме): | |||
<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> | ||
Пример для Windows: | <!--T:22--> | ||
Пример для 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> | ||
<!--T:23--> | |||
Здесь COM10 — имя виртуального последовательного порта, которое присвоено адаптеру USB RS-485. | Здесь COM10 — имя виртуального последовательного порта, которое присвоено адаптеру USB RS-485. | ||
<!--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. | |||
== Прошивка устройств == | == Прошивка устройств == <!--T:25--> | ||
<!--T:26--> | |||
'''При прошивке с контроллера остановите wb-mqtt-serial:''' | '''При прошивке с контроллера остановите wb-mqtt-serial:''' | ||
<pre> | <pre> | ||
| Строка 108: | Строка 135: | ||
</pre> | </pre> | ||
<!--T:27--> | |||
Подключите устройство к RS-485. | Подключите устройство к RS-485. | ||
<!--T:28--> | |||
Если вы не знаете точного аппаратного типа устройства, то его сигнатуру можно прочесть командой: | Если вы не знаете точного аппаратного типа устройства, то его сигнатуру можно прочесть командой: | ||
<pre> | <pre> | ||
| Строка 116: | Строка 145: | ||
Задайте адрес прошиваемого устройства в переменной mbusaddr. | Задайте адрес прошиваемого устройства в переменной mbusaddr. | ||
<!--T:29--> | |||
В выводе команды вы получите сигнатуру устройства, например, '''wbmr6c'''. | В выводе команды вы получите сигнатуру устройства, например, '''wbmr6c'''. | ||
<!--T:30--> | |||
Выберите подходящую прошивку, например, WB-MR-MR6C_MCU3_3_1.9.4.wbfw. | Выберите подходящую прошивку, например, WB-MR-MR6C_MCU3_3_1.9.4.wbfw. | ||
<!--T:31--> | |||
Прошейте устройство командой: | Прошейте устройство командой: | ||
<pre> | <pre> | ||
| Строка 137: | Строка 169: | ||
</pre> | </pre> | ||
<!--T:32--> | |||
'''После успешной прошивки устройство само выйдет из режима загрузчика и перезапустится в основной программе.''' | '''После успешной прошивки устройство само выйдет из режима загрузчика и перезапустится в основной программе.''' | ||
<!--T:33--> | |||
Пример ошибки при несовпадении сигнатуры: | Пример ошибки при несовпадении сигнатуры: | ||
<pre> | <pre> | ||
| Строка 147: | Строка 181: | ||
=== Прошивка устройств по широковещательному Modbus-адресу 0 === | === Прошивка устройств по широковещательному Modbus-адресу 0 === <!--T:34--> | ||
Bootloader позволяет загружать прошивку на устройства | <!--T:35--> | ||
Bootloader позволяет загружать прошивку на устройства по Modbus-адресу 0. Для этого устройство должно быть единственным устройством на шине и находиться в режиме загрузчика. | |||
=== Прошивка нескольких устройств на шине === | === Прошивка нескольких устройств на шине === <!--T:36--> | ||
<!--T:37--> | |||
Возможна прошивка нескольких устройств, подключенных к шине. Устройства должны быть переведены в режим загрузчика и прошиваться по отдельности с указанием нешироковещательного Modbus-адреса. Прошивка устройств с одинаковым адресом возможна, если в режиме загрузчика находится только одно из них. Устройства прошиваются по очереди. | Возможна прошивка нескольких устройств, подключенных к шине. Устройства должны быть переведены в режим загрузчика и прошиваться по отдельности с указанием нешироковещательного Modbus-адреса. Прошивка устройств с одинаковым адресом возможна, если в режиме загрузчика находится только одно из них. Устройства прошиваются по очереди. | ||
<!--T:38--> | |||
'''Внимание!''' Прошивка устройств, находящимся в режиме загрузчика и имеющим одинаковый modbus-адрес, или же прошивка нескольких устройств, находящихся в режиме загрузчика по адресу 0 не будет выполнена; имеющаяся прошивка на устройствах будет испорчена. | '''Внимание!''' Прошивка устройств, находящимся в режиме загрузчика и имеющим одинаковый modbus-адрес, или же прошивка нескольких устройств, находящихся в режиме загрузчика по адресу 0 не будет выполнена; имеющаяся прошивка на устройствах будет испорчена. | ||
</translate> | </translate> | ||