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

м
Строка 140: Строка 140:


== Типичные сценарии использования ==  
== Типичные сценарии использования ==  
Рассмотрим порядок действий и запуск wb-mcu-fw-updater для некоторых типичных случаев:
 
Утилита имеет формат запуска:
<syntaxhighlight lang="bash">
wb-mcu-fw-updater <режим работы> <ключи/флаги для этого режима>
</syntaxhighlight>
 
Ниже рассмотрим типичные сценарии использования.


=== Обновление прошивки устройства ===  
=== Обновление прошивки устройства ===  
# Узнать modbus адрес обновляемого устройства (адрес по умолчанию напечатан на наклейке сбоку устройства) и порт, к которому оно подключено (например, /dev/ttyRS485-1).
# Узнать [[Определение и изменение Modbus-адреса устройств Wirenboard | modbus-адрес]] обновляемого устройства и порт, к которому оно подключено, например, <code>/dev/ttyRS485-1</code>.
# Запустить утилиту wb-mcu-fw-updater со следующими ключами:
# Запустить утилиту <code>wb-mcu-fw-updater</code> со следующими ключами:
 
#:<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства>
wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства>
</syntaxhighlight>
</syntaxhighlight>


=== Установка тестовой прошивки ===  
=== Установка тестовой прошивки ===  
# Узнать modbus адрес обновляемого устройства (адрес по умолчанию напечатан на наклейке сбоку устройства) и порт, к которому оно подключено (например, /dev/ttyRS485-1).
# Узнать [[Определение и изменение Modbus-адреса устройств Wirenboard | modbus-адрес]] обновляемого устройства и порт, к которому оно подключено, например, <code>/dev/ttyRS485-1</code>.
# Узнать название тестовой ветки (branch).
# Узнать название тестовой ветки (branch).
# Запустить утилиту wb-mcu-fw-updater со следующими ключами:
# Запустить утилиту <code>wb-mcu-fw-updater</code> со следующими ключами:
 
#:<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства> --branch <ветка с тестовой прошивкой>
wb-mcu-fw-updater update-fw <порт, на котором находится устройство> -a <modbus адрес устройства> --branch <ветка с тестовой прошивкой>
</syntaxhighlight>
</syntaxhighlight>


=== Обновление всех устройств, подключённых к драйверу ===  
=== Обновление всех устройств, подключённых к драйверу ===  
Устройства должны опрашиваться драйвером wb-mqtt-serial (находиться в его конфигурационном файле).
Устройства должны опрашиваться драйвером wb-mqtt-serial, то есть находиться в его конфигурационном файле.
# Запустить утилиту wb-mcu-fw-updater со следующими ключами:
# Запустить утилиту <code>wb-mcu-fw-updater</code> со следующими ключами:
 
#:<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
wb-mcu-fw-updater update-all
wb-mcu-fw-updater update-all
</syntaxhighlight>
</syntaxhighlight>
Строка 170: Строка 173:


=== Восстановление прошивки на устройстве ===  
=== Восстановление прошивки на устройстве ===  
Устройство находится в режиме бутлоадера (зелёный светодиод мигает 1 раз в секунду) и не может запустить нормальный режим работы. По завершению восстановления, адрес устройства и настройки uart '''остаются прежними.'''
Устройство находится в режиме загрузчика (зелёный светодиод мигает 1 раз в секунду) и не может запустить нормальный режим работы. По завершению восстановления, адрес устройства и настройки uart остаются прежними.
# Узнать modbus-адрес устройства и порт, к которому оно подключено.
# Узнать modbus-адрес устройства и порт, к которому оно подключено.
# Запустить утилиту wb-mcu-fw-updater со следующими ключами:
# Запустить утилиту <code>wb-mcu-fw-updater</code> со следующими ключами:
<syntaxhighlight lang="bash">
#:<syntaxhighlight lang="bash">
wb-mcu-fw-updater recover <порт, на котором находится устройство> -a <modbus адрес устройства>
wb-mcu-fw-updater recover <порт, на котором находится устройство> -a <modbus адрес устройства>
</syntaxhighlight>
</syntaxhighlight>