16 343
правки
Bootloader: различия между версиями
→Описание
| (не показано 18 промежуточных версий 2 участников) | |||
| Строка 1: | Строка 1: | ||
{{DISPLAYTITLE:Загрузчик периферийных устройств Wiren Board}} | {{DISPLAYTITLE:Загрузчик периферийных устройств Wiren Board}} | ||
== Описание == | == Описание == | ||
{{YouTube | |||
|link= https://youtu.be/d_olK15Xhkw | |||
|text= Что такое загрузчик (28:27) | |||
|start=1708 | |||
}} | |||
В периферийных устройствах с Modbus есть прошивка, которая реализует заложенную логику работы. Чтобы прошивку можно было обновлять прямо в инсталляции по RS-485, в устройствах предусмотрен загрузчик (bootloader), который отвечает за инициализацию устройства и обновление прошивки. | |||
[[ | В [[Documentation | документации]] на каждое устройство есть раздел «Обновление прошивки», где есть ссылки на инструкцию по обновлению и список изменений. В это статье мы рассмотрим только обновление загрузчика. | ||
== Обновление == | |||
==Переход устройств в режим загрузчика == | |||
[[File:Bootloader.gif|300px|thumb|right|Индикация режима загрузчика]] | |||
Устройство находится в режиме загрузчика в следующих случаях: | |||
* первые 2 секунды после включения питания, если на устройстве есть корректная прошивка; | |||
* постоянно, если на устройстве нет корректной прошивки, например, был сбой при обновлении прошивки; | |||
* при записи <code>1</code> в holding-регистр <code>129(0x81)</code> в момент работы основной программы — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд с параметрами соединения <code>9600N2</code>. Этот режим можно активировать запустив утилиту [[wb-mcu-fw-flasher]] с ключем <code>-j</code>. | |||
*при записи <code>1</code> в holding-регистр <code>131(0x83)</code> в момент работы основной программы — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд с параметрами соединения, '''установленными в настройках устройства'''. Это может быть полезно для обновления устройств за шлюзами без перенастройки параметров шлюза. | |||
*:Перейти в этот режим можно в [[wb-mcu-fw-flasher]] начиная с версии '''1.3.0''' запустив его с ключем <code>-J</code>. Кроме того для запуска режима необходима поддержка со стороны загрузчика (версия 1.3.0 и выше) и со стороны прошивки (см. changelog прошивки). | |||
В режиме загрузчика индикатор '''Status''' устройства мигает с периодом 1 секунда, а при записи прошивки мигание индикатора учащается. | |||
Восстановление прошивки описано в статье [[WB_Modbus_Devices_Firmware_Update#fw-recovery | Обновление прошивки Modbus-устройств Wiren Board]]. | |||
===Проверка связи с устройством в режиме загрузчика=== | |||
Загрузчик продолжает слушать шину RS-485 и отвечает на опрос некоторых регистров. Можно прочитать сигнатуру устройства используя команду | |||
<code>modbus_client --debug -mrtu -b9600 -pnone -s2 /dev/ttyRS485-1 -a1 -t0x03 -r290 -c12</code> | |||
Важно: именно 12 регистров одним запросом, начиная с адреса 290. | |||
== Список изменений == | |||
Изменения во всех версиях описаны на странице [[Bootloader_Changelog |Список изменений в загрузчике]]. | |||
== Обновление загрузчика == | |||
{{Anchor|update}} | {{Anchor|update}} | ||
Текущую версию загрузчика можно узнать, считав 8 holding регистров с адреса 330: | Текущую версию загрузчика можно узнать, считав 8 holding регистров с адреса 330, например, с помощью [[modbus_client]]: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
echo -e $(modbus_client -mrtu -pnone -s2 /dev/ttyRS485-1 -a1 - | echo -e $(modbus_client -mrtu -pnone -s2 /dev/ttyRS485-1 -a1 -t0x03 -r330 -c8 | grep Data | sed -e 's/.*Data://' -e 's/ 0x00/\\x/g') | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Есть несколько способов обновления загрузчика: | Есть несколько способов обновления загрузчика: | ||
=== | === С контроллера Wiren Board === | ||
Загрузчик обновляется из консоли контроллера Wiren Board утилитой [[wb-mcu-fw-updater]], которой для работы нужен доступ в интернет. Если интернета нет, используйте другой способ. | |||
Учитывайте, что утилита учитывает [[ Wiren_Board_Software#Кратко_о_релизах | установленный на контроллер релиз ПО ]], то есть вы не сможете зашить тестовую версию загрузчика, если на контроллере стабильный релиз. | |||
Перед обновлением загрузчика, обновите прошивку контроллера через apt или другим способом по [[Wiren_Board_Software#update |инструкциям]]. | |||
<syntaxhighlight lang="bash"> | ==== Обновление загрузчика одного устройства ==== | ||
Процесс: | |||
# Подключитесь к контроллеру по [[SSH]]. | |||
# Запустите команду, заменив в ней порт и адрес: | |||
#:<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-bl /dev/ttyRS485-1 -a1 | wb-mcu-fw-updater update-bl /dev/ttyRS485-1 -a1 | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Утилита считает модель устройства, проверит наличие обновления прошивки загрузчика, скачает обновление и зашьёт его в устройство. | |||
==== Обновление загрузчика всех устройств ==== | |||
Начиная с версии 1.10.8 в | Начиная с версии 1.10.8 утилита wb-mcu-fw-updater умеет в режиме обновление прошивок устройств проверять и версии загрузчика, а потом обновлять его: | ||
# Подключитесь к контроллеру по [[SSH]]. | |||
# Запустите команду: | |||
#:<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-bl /dev/ttyRS485-1 -a1 | |||
</syntaxhighlight> | |||
# Если есть новые версии загрузчика для устройств, утилита запросит подтверждение на обновление загрузчика, нужно ответить <code>y</code>. Если откажетесь, прошивка обновиться, но загрузчик останется старым. | |||
Пример: | Пример: | ||
<syntaxhighlight lang="console"> | |||
<syntaxhighlight lang=" | # wb-mcu-fw-updater update-all | ||
wb-mcu-fw-updater update-all | |||
2024-04-03 07:17:24,061 Will probe all devices on enabled serial ports of /etc/wb-mqtt-serial.conf: | 2024-04-03 07:17:24,061 Will probe all devices on enabled serial ports of /etc/wb-mqtt-serial.conf: | ||
2024-04-03 07:17:24,063 Probing WB-MAP6S fw2 (port: /dev/ttyRS485-1, slaveid: 26, uart_params: 9600N2, response_timeout: 0.50)... | 2024-04-03 07:17:24,063 Probing WB-MAP6S fw2 (port: /dev/ttyRS485-1, slaveid: 26, uart_params: 9600N2, response_timeout: 0.50)... | ||
| Строка 45: | Строка 82: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==== | === С компьютера и других устройств === | ||
==== Установка утилиты ==== | |||
Если у вас нет контроллера Wiren Board или на нём нет интернета, можно обновить загрузчик в ручном режиме утилитой wb-mcu-fw-flasher, которую надо установить по [[wb-mcu-fw-flasher#install|инструкции]]. | |||
==== Чтение сигнатуры ==== | |||
Для начала нам нужно считать сигнатуру устройства, чтобы понимать, какие загрузчик и прошивки нужны. | |||
Сделать это можно прочитав 12 holding регистров с адреса 290, например, с помощью [[modbus_client]]: | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
echo -e $(modbus_client -mrtu -pnone -s2 /dev/ttyRS485-1 -a1 -t0x03 -r290 -c12 | grep Data | sed -e 's/.*Data://' -e 's/ 0x00/\\x/g') | echo -e $(modbus_client -mrtu -pnone -s2 /dev/ttyRS485-1 -a1 -t0x03 -r290 -c12 | grep Data | sed -e 's/.*Data://' -e 's/ 0x00/\\x/g') | ||
</syntaxhighlight> | </syntaxhighlight> | ||
В результате на экран будет выведена строка вида <code>mwac0</code> | В результате на экран будет выведена строка вида <code>mwac0</code> — это и есть сигнатура. | ||
==== Скачивание файлов ==== | |||
Чтобы скачать файл с загрузчиком, перейдите по адресу https://fw-releases.wirenboard.com/?prefix=bootloader/by-signature/ ,выберите папку с полученной выше сигнатурой, далее раздел <code>main</code> и скачайте файл <code>latest.wbfw</code>. | |||
Чтобы скачать прошивку, перейдите по адресу https://fw-releases.wirenboard.com/?prefix=fw/by-signature/. ,выберите папку с полученной выше сигнатурой, далее раздел <code>main</code> и скачайте файл <code>latest.wbfw</code>. Если вам необходима конкретная версия прошивки, можно скачать именно её. | |||
<syntaxhighlight lang="bash"> | ==== Прошивка ==== | ||
Теперь, когда файлы обновления загрузчика и прошивки скачаны, их надо зашить в устройство: | |||
# Запустите обновление загрузчика, замените порт <code>/dev/ttyRS485-1</code>, скорость <code>-b</code>, адрес <code>-a</code> и имя файла на свои: | |||
#:<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-flasher -d /dev/ttyRS485-1 -b9600 -a1 -f wb-bootloader-updater_mwac0__1.4.1_master_e676613.wbfw -j | wb-mcu-fw-flasher -d /dev/ttyRS485-1 -b9600 -a1 -f wb-bootloader-updater_mwac0__1.4.1_master_e676613.wbfw -j | ||
</syntaxhighlight> | </syntaxhighlight> | ||
#: утилита сотрёт прошивку и зашьёт новый загрузчик. | |||
# Запустите обновление прошивки, замените порт <code>/dev/ttyRS485-1</code>, скорость <code>-b</code>, адрес <code>-a</code> и имя файла на свои: | |||
#: <syntaxhighlight lang="bash"> | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-flasher -d /dev/ttyRS485-1 -b9600 -a1 -f mwac0__1.21.1_main_ac00010.wbfw | wb-mcu-fw-flasher -d /dev/ttyRS485-1 -b9600 -a1 -f mwac0__1.21.1_main_ac00010.wbfw | ||
</syntaxhighlight> | </syntaxhighlight> | ||
#: так как устройство со стёртой прошивкой находится в загрузчике, то в команде выше нет ключа <code>-j</code>. | |||
Более подробно про ручное обновление прошивки читайте в статье [[ WB_Modbus_Devices_Firmware_Update#Ручное_обновление | Обновление прошивки Modbus-устройств Wiren Board ]] | Более подробно про ручное обновление прошивки читайте в статье [[ WB_Modbus_Devices_Firmware_Update#Ручное_обновление | Обновление прошивки Modbus-устройств Wiren Board ]] | ||
== Известные ошибки == | == Известные ошибки == | ||
[[Bootloader: Errata | Список известных неисправностей]] | [[Bootloader: Errata | Список известных неисправностей]] | ||