Wb-mcu-fw-updater: различия между версиями

Нет описания правки
Строка 26: Строка 26:
<pre>
<pre>
apt update
apt update
apt install python-wb-mcu-fw-updater
apt install wb-mcu-fw-updater
</pre>
</pre>


Строка 49: Строка 49:


===== Режим "update-bl": ===== <!--T:9-->
===== Режим "update-bl": ===== <!--T:9-->
Обновление бутлоадера устройства с известным slaveid. Утилита сама находит настройки соединения с устройством, запрашивает у устройства его версию бутлоадера и производит обновление, если требуется. '''Обновление бутлоадера - потенциально опасная операция''', поэтому, данный режим имеет минимальное количество настроек. Если во время обновления бутлоадера пропало питание, устройство может превратиться в "кирпич". В таком случае, гарантия на него аннулируется. При обновлении бутлоадера, устройство будет '''автоматически прошито самой свежей прошивкой'''.
Обновление бутлоадера устройства с известным slaveid. Утилита сама находит настройки соединения с устройством, запрашивает у устройства его версию бутлоадера и производит обновление, если требуется. '''Обновление бутлоадера - потенциально опасная операция''', поэтому, данный режим имеет минимальное количество настроек (описание ключей запуска доступно в wb-mcu-fw-updater update-bl -h). Если во время обновления бутлоадера пропало питание, устройство может превратиться в "кирпич". В таком случае, гарантия на него аннулируется. При обновлении бутлоадера, устройство будет '''автоматически прошито самой свежей прошивкой'''.


===== Режим "recover": ===== <!--T:9-->
===== Режим "recover": ===== <!--T:10-->
Восстановление устройства с испорченной прошивкой (например, при прошивке пропало питание, и устройство перестало загружаться). После указания модели устройства, утилита скачивает самую свежую прошивку для него и прошивает её через бутлоадер. Режим предназначен для использования '''только в бутлоадере''' (устройство мигает зелёным светодиодом примерно 1 раз в секунду).
Восстановление устройства с испорченной прошивкой (например, при прошивке пропало питание, и устройство перестало загружаться). После указания slaveid и порта, утилита попробует восстановить устройство. В случае неудачи, (с согласия пользователя), утилита пытается восстановить устройство с помощью всех доступных прошивок (процесс может быть длительным).


Для успешной работы в данном режиме, '''нужно освободить порт, к которому подключено устройство, от других драйверов''' (например, остановив на время wb-mqtt-serial).
===== Режим "update-all": ===== <!--T:11-->
'''Только для контроллеров WirenBoard'''. Обновление всех устройств, подключенных к wb-mqtt-serial (настроенных через web-интерфейс).
Для каждого обнаруженного устройства в конфигурационном файле /etc/wb-mqtt-serial.conf утилита проверяет наличие обновления и устанавливает его, если имеется. По завершению, пользователю вовзвращаются результаты (сколько устройство обновлено/сколько - нет)


===== Режим "update-all": ===== <!--T:10-->
===== Режим "recover-all": ===== <!--T:11-->
Обновление производится для всех устройств, работающих через wb-mqtt-serial. Поддерживается только на устройствах Wiren Board '''(для работы нужен драйвер wb-mqtt-serial)'''. Утилита останавливает драйвер, для каждого обнаруженного устройства в конфигурационном файле /etc/wb-mqtt-serial.conf проверяет наличие обновления и устанавливает его, если имеется. После этого, драйвер перезапускается, а пользователю возвращается список устройств, обновление которых не удалось (если таковые имеются).
'''Только для контроллеров WirenBoard'''. Утилита проходит по всем устройствам, подключённым к wb-mqtt-serial (настроенным через web-интерфейс). Если какое-то из устройств находится в режиме бутлоадера, утилита прошивает его самой свежей прошивкой.


==== Ключи и порядок запуска wb-mcu-fw-updater: ==== <!--T:11-->
==== Ключи и порядок запуска wb-mcu-fw-updater: ==== <!--T:11-->
{| class="wikitable"
{| class="wikitable"
|+ wb-mcu-fw-updater <port> <общие для всех режимов ключи/флаги> <режим работы> <ключи/флаги для этого режима>
|+ wb-mcu-fw-updater <режим работы> <ключи/флаги для этого режима>
! Параметр !! Описание !! Значение по умолчанию
! Параметр !! Описание !! Значение по умолчанию
|-
|-
wb_editors
556

правок