16 343
правки
м (Убрал пустую строку) |
м (Убрал перевод, заменил теги pre → syntaxhighlight) |
||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE:Обновление прошивок на устройствах Wiren Board}} | {{DISPLAYTITLE:Обновление прошивок на устройствах Wiren Board}} | ||
== Возможность обновления == | |||
Для устройств Wiren Board, работающих по протоколу Modbus RTU, доступно удалённое обновление ПО (микрокода) самого устройства. Обновление реализовано посредством прошивки файла .wbfw по шине modbus с помощью утилиты wb-mcu-fw-flasher. Подробная информация о процедуре прошивки доступна [[WB-MCU-Flasher | здесь.]] | Для устройств Wiren Board, работающих по протоколу Modbus RTU, доступно удалённое обновление ПО (микрокода) самого устройства. Обновление реализовано посредством прошивки файла .wbfw по шине modbus с помощью утилиты wb-mcu-fw-flasher. Подробная информация о процедуре прошивки доступна [[WB-MCU-Flasher | здесь.]] | ||
Сами файлы обновлений можно скачать в репозитории [http://fw-releases.wirenboard.com/?prefix=fw/ fw-releases.wirenboard.com] | Сами файлы обновлений можно скачать в репозитории [http://fw-releases.wirenboard.com/?prefix=fw/ fw-releases.wirenboard.com] | ||
== Автоматическое обновление прошивок устройств == | == Автоматическое обновление прошивок устройств == | ||
Чтобы не производить действия по выбору подходящей прошивки, её скачиванию и установке на устройство, была написана утилита [https://github.com/wirenboard/wb-mcu-fw-updater.git wb-mcu-fw-updater]. | Чтобы не производить действия по выбору подходящей прошивки, её скачиванию и установке на устройство, была написана утилита [https://github.com/wirenboard/wb-mcu-fw-updater.git wb-mcu-fw-updater]. | ||
Строка 19: | Строка 12: | ||
=== Утилита wb-mcu-fw-updater === | === Утилита wb-mcu-fw-updater === | ||
==== Установка: ==== | ==== Установка: ==== | ||
На контроллеры Wiren Board утилита устанавливается следующими командами: | На контроллеры Wiren Board утилита устанавливается следующими командами: | ||
< | <syntaxhighlight lang="bash"> | ||
apt update | apt update | ||
apt install wb-mcu-fw-updater | apt install wb-mcu-fw-updater | ||
</ | </syntaxhighlight> | ||
===== На другие Debian-подобные системы: ===== | ===== На другие Debian-подобные системы: ===== | ||
Для Ubuntu, Linux Mint, Elementary OS и других дистрибутивов, использующих пакетный менеджер apt, порядок действий примерно следующий: | Для Ubuntu, Linux Mint, Elementary OS и других дистрибутивов, использующих пакетный менеджер apt, порядок действий примерно следующий: | ||
# Перейти в репозиторий [https://github.com/wirenboard/wb-mcu-fw-updater.git wb-mcu-fw-updater]. | # Перейти в репозиторий [https://github.com/wirenboard/wb-mcu-fw-updater.git wb-mcu-fw-updater]. | ||
Строка 32: | Строка 25: | ||
# Установить [[WB-MCU-Flasher | wb-mcu-fw-flasher]]. | # Установить [[WB-MCU-Flasher | wb-mcu-fw-flasher]]. | ||
# Установить собранный deb-пакет командами: | # Установить собранный deb-пакет командами: | ||
< | #:<syntaxhighlight lang="bash"> | ||
apt update | apt update | ||
apt install ./<путь_до_собранного_пакета>.deb | apt install ./<путь_до_собранного_пакета>.deb | ||
</ | </syntaxhighlight> | ||
==== Интерфейс и режимы работы: ==== | ==== Интерфейс и режимы работы: ==== | ||
[[File:Wb-mcu-fw-updater interface.png||center||Help доступен при запуске утилиты с ключом -h. Для каждого режима работы тоже доступен help (пример: wb-mcu-fw-updater update-fw -h)]] | [[File:Wb-mcu-fw-updater interface.png||center||Help доступен при запуске утилиты с ключом -h. Для каждого режима работы тоже доступен help (пример: wb-mcu-fw-updater update-fw -h)]] | ||
Утилита работает в разных режимах (обновление прошивки, обновление бутлоадера, восстановление после неудачного обновления, обновление всех устройств из devices, восстановление всех устройств из devices). | Утилита работает в разных режимах (обновление прошивки, обновление бутлоадера, восстановление после неудачного обновления, обновление всех устройств из devices, восстановление всех устройств из devices). | ||
===== Режим "update-fw": ===== | ===== Режим "update-fw": ===== | ||
[[File:Bootloader.gif||right||Индикация режима загрузчика]] | [[File:Bootloader.gif||right||Индикация режима загрузчика]] | ||
Обновление прошивки устройства с известным slaveid. Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию ПО, производит обновление, если требуется. Данный режим гибко настраивается с помощью ключей запуска (см. wb-mcu-fw-updater update-fw -h). Например, в данном режиме можно устанавливать тестовые прошивки. | Обновление прошивки устройства с известным slaveid. Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию ПО, производит обновление, если требуется. Данный режим гибко настраивается с помощью ключей запуска (см. wb-mcu-fw-updater update-fw -h). Например, в данном режиме можно устанавливать тестовые прошивки. | ||
===== Режим "update-bl": ===== | ===== Режим "update-bl": ===== | ||
Обновление бутлоадера устройства с известным slaveid. Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию бутлоадера и производит обновление, если требуется. '''Обновление бутлоадера - потенциально опасная операция''', поэтому, данный режим имеет минимальное количество настроек (описание ключей запуска доступно в wb-mcu-fw-updater update-bl -h). Если во время обновления бутлоадера пропало питание, устройство может превратиться в "кирпич". В таком случае, гарантия на него аннулируется. При обновлении бутлоадера, устройство будет '''автоматически прошито самой свежей прошивкой'''. | Обновление бутлоадера устройства с известным slaveid. Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию бутлоадера и производит обновление, если требуется. '''Обновление бутлоадера - потенциально опасная операция''', поэтому, данный режим имеет минимальное количество настроек (описание ключей запуска доступно в wb-mcu-fw-updater update-bl -h). Если во время обновления бутлоадера пропало питание, устройство может превратиться в "кирпич". В таком случае, гарантия на него аннулируется. При обновлении бутлоадера, устройство будет '''автоматически прошито самой свежей прошивкой'''. | ||
===== Режим "recover": ===== | ===== Режим "recover": ===== | ||
Восстановление устройства с испорченной прошивкой (например, при прошивке пропало питание, и устройство перестало загружаться). После указания slaveid и порта, утилита попробует восстановить устройство. В случае неудачи, (с согласия пользователя), утилита пытается восстановить устройство с помощью всех доступных прошивок (процесс может быть длительным). | Восстановление устройства с испорченной прошивкой (например, при прошивке пропало питание, и устройство перестало загружаться). После указания slaveid и порта, утилита попробует восстановить устройство. В случае неудачи, (с согласия пользователя), утилита пытается восстановить устройство с помощью всех доступных прошивок (процесс может быть длительным). | ||
===== Режим "update-all": ===== | ===== Режим "update-all": ===== | ||
'''Только для контроллеров WirenBoard'''. Обновление всех устройств, подключенных к wb-mqtt-serial (настроенных через web-интерфейс). | '''Только для контроллеров WirenBoard'''. Обновление всех устройств, подключенных к wb-mqtt-serial (настроенных через web-интерфейс). | ||
Для каждого обнаруженного устройства в конфигурационном файле /etc/wb-mqtt-serial.conf утилита проверяет наличие обновления и устанавливает его, если имеется. По завершению, пользователю вовзвращаются результаты (сколько устройство обновлено/сколько - нет) | Для каждого обнаруженного устройства в конфигурационном файле /etc/wb-mqtt-serial.conf утилита проверяет наличие обновления и устанавливает его, если имеется. По завершению, пользователю вовзвращаются результаты (сколько устройство обновлено/сколько - нет) | ||
===== Режим "recover-all": ===== | ===== Режим "recover-all": ===== | ||
'''Только для контроллеров WirenBoard'''. Утилита проходит по всем устройствам, подключённым к wb-mqtt-serial (настроенным через web-интерфейс). Если какое-то из устройств находится в режиме бутлоадера, утилита прошивает его самой свежей прошивкой. | '''Только для контроллеров WirenBoard'''. Утилита проходит по всем устройствам, подключённым к wb-mqtt-serial (настроенным через web-интерфейс). Если какое-то из устройств находится в режиме бутлоадера, утилита прошивает его самой свежей прошивкой. | ||
==== Ключи и порядок запуска wb-mcu-fw-updater: ==== | ==== Ключи и порядок запуска wb-mcu-fw-updater: ==== | ||
{| class="wikitable" | {| class="wikitable" | ||
|+ wb-mcu-fw-updater <режим работы> <ключи/флаги для этого режима> | |+ wb-mcu-fw-updater <режим работы> <ключи/флаги для этого режима> | ||
Строка 132: | Строка 125: | ||
|} | |} | ||
== Типичные сценарии использования == | == Типичные сценарии использования == | ||
Рассмотрим порядок действий и запуск wb-mcu-fw-updater для некоторых типичных случаев: | Рассмотрим порядок действий и запуск wb-mcu-fw-updater для некоторых типичных случаев: | ||
==== Обновление прошивки устройства: ==== | ==== Обновление прошивки устройства: ==== | ||
# Узнать modbus адрес обновляемого устройства (адрес по умолчанию напечатан на наклейке сбоку устройства) и порт, к которому оно подключено (например, /dev/ttyRS485-1). | # Узнать modbus адрес обновляемого устройства (адрес по умолчанию напечатан на наклейке сбоку устройства) и порт, к которому оно подключено (например, /dev/ttyRS485-1). | ||
# Запустить утилиту wb-mcu-fw-updater со следующими ключами: | # Запустить утилиту wb-mcu-fw-updater со следующими ключами: | ||
< | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства> | wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства> | ||
</ | </syntaxhighlight> | ||
==== Установка тестовой прошивки: ==== | ==== Установка тестовой прошивки: ==== | ||
# Узнать modbus адрес обновляемого устройства (адрес по умолчанию напечатан на наклейке сбоку устройства) и порт, к которому оно подключено (например, /dev/ttyRS485-1). | # Узнать modbus адрес обновляемого устройства (адрес по умолчанию напечатан на наклейке сбоку устройства) и порт, к которому оно подключено (например, /dev/ttyRS485-1). | ||
# Узнать название тестовой ветки (branch). | # Узнать название тестовой ветки (branch). | ||
# Запустить утилиту wb-mcu-fw-updater со следующими ключами: | # Запустить утилиту wb-mcu-fw-updater со следующими ключами: | ||
< | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства> --branch <ветка с тестовой прошивкой> | wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства> --branch <ветка с тестовой прошивкой> | ||
</ | </syntaxhighlight> | ||
==== Обновление всех устройств, подключённых к драйверу: ==== | |||
==== Обновление всех устройств, подключённых к драйверу: ==== | |||
Устройства должны опрашиваться драйвером wb-mqtt-serial (находиться в его конфигурационном файле). | Устройства должны опрашиваться драйвером wb-mqtt-serial (находиться в его конфигурационном файле). | ||
# Запустить утилиту wb-mcu-fw-updater со следующими ключами: | # Запустить утилиту wb-mcu-fw-updater со следующими ключами: | ||
< | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-all | wb-mcu-fw-updater update-all | ||
</ | </syntaxhighlight> | ||
# <li value="2">Дождаться результатов обновления.</li> | # <li value="2">Дождаться результатов обновления.</li> | ||
==== Восстановление прошивки на устройстве: ==== | ==== Восстановление прошивки на устройстве: ==== | ||
Устройство находится в режиме бутлоадера (зелёный светодиод мигает 1 раз в секунду) и не может запустить нормальный режим работы. По завершению восстановления, адрес устройства и настройки uart '''остаются прежними.''' | Устройство находится в режиме бутлоадера (зелёный светодиод мигает 1 раз в секунду) и не может запустить нормальный режим работы. По завершению восстановления, адрес устройства и настройки uart '''остаются прежними.''' | ||
# Узнать modbus-адрес устройства и порт, к которому оно подключено. | # Узнать modbus-адрес устройства и порт, к которому оно подключено. | ||
# Запустить утилиту wb-mcu-fw-updater со следующими ключами: | # Запустить утилиту wb-mcu-fw-updater со следующими ключами: | ||
< | <syntaxhighlight lang="bash"> | ||
wb-mcu-fw-updater recover <порт, на которм находится устройство> -a <modbus адрес устройства> | wb-mcu-fw-updater recover <порт, на которм находится устройство> -a <modbus адрес устройства> | ||
</ | </syntaxhighlight> | ||