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

м
→‎Режимы: Добавил параметры
м (→‎Режимы: Добавил параметры)
Строка 39: Строка 39:


Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию ПО и производит обновление, если требуется. Этот режим гибко настраивается с помощью ключей запуска, например, в этом режиме можно устанавливать тестовые прошивки.
Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию ПО и производит обновление, если требуется. Этот режим гибко настраивается с помощью ключей запуска, например, в этом режиме можно устанавливать тестовые прошивки.
 
{| class="wikitable"
Ключи запуска и справку можно посмотреть командой <code>wb-mcu-fw-updater update-fw -h</code>.
! Параметр !! Описание !! Значение по умолчанию
|-
|  || Порт, к которому подключено устройство. Позиционный аргумент || '''обязательный'''
|-
| -a, --slaveid || Modbus адрес устройства || '''обязательный'''
|-
|-
| --version || Скачивать прошивку определённой версии || latest
|-
|-
| --branch || Скачивать прошивку из ветки разработки (на свой страх и риск!) || None
|-
|-
| -h, --help || Описание ключей запуска для режима || Флаг
|-
|-
| --force || Произвести перепрошивку устройства даже если установлена самая свежая прошивка || Флаг
|-
|-
| --restore-defaults || Восстановить настройки устройства к заводским || Флаг
|-
|}


=== Обновление загрузчика (update-bl) ===  
=== Обновление загрузчика (update-bl) ===  
Строка 48: Строка 69:


Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию загрузчика и производит обновление, если требуется. При обновлении загрузчика, устройство будет автоматически прошито самой свежей прошивкой.
Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию загрузчика и производит обновление, если требуется. При обновлении загрузчика, устройство будет автоматически прошито самой свежей прошивкой.
 
{| class="wikitable"
Ключи запуска и справку можно посмотреть командой <code>wb-mcu-fw-updater update-bl -h</code>.
! Параметр !! Описание !! Значение по умолчанию
|-
|  || Порт, к которому подключено устройство. Позиционный аргумент || '''обязательный'''
|-
| -a, --slaveid || Modbus адрес устройства || '''обязательный'''
|-
|-
| -h, --help || Описание ключей запуска для режима || Флаг
|-
|-
| --force || Произвести перепрошивку устройства даже если установлен самый свежий бутлоадер || Флаг
|-
|}


=== Восстановление (recover) ===  
=== Восстановление (recover) ===  
Строка 56: Строка 89:
После запуска с указанием порта и modbus-адреса устройства утилита попробует его восстановить с помощью последней зашитой в него прошивкой. Если восстановление не получится, то с согласия пользователя, утилита попробует восстановить устройство с помощью всех доступных прошивок, процесс перебора может быть длительным.
После запуска с указанием порта и modbus-адреса устройства утилита попробует его восстановить с помощью последней зашитой в него прошивкой. Если восстановление не получится, то с согласия пользователя, утилита попробует восстановить устройство с помощью всех доступных прошивок, процесс перебора может быть длительным.


Ключи запуска и справку можно посмотреть командой <code>wb-mcu-fw-updater recover -h</code>.
{| class="wikitable"
! Параметр !! Описание !! Значение по умолчанию
|-
|  || Порт, к которому подключено устройство. Позиционный аргумент || '''обязательный'''
|-
| -a, --slaveid || Modbus адрес устройства || '''обязательный'''
|-
|-
| --fw-sig || Сигнатура прошивки (если известна заранее) || None
|-
|-
| --restore-defaults || Восстановление настроек устройства к заводским || Флаг
|-
|-
| -h, --help || Описание ключей запуска для режима || Флаг
|-
|}


=== Обновление прошивки всех устройств (update-all) ===
=== Обновление прошивки всех устройств (update-all) ===
Строка 66: Строка 115:
Для каждого обнаруженного устройства утилита проверяет наличие обновления и устанавливает его, если необходимо. По завершению утилита возвращает пользователю статистику по обновленным и пропущенным устройствам.
Для каждого обнаруженного устройства утилита проверяет наличие обновления и устанавливает его, если необходимо. По завершению утилита возвращает пользователю статистику по обновленным и пропущенным устройствам.


Ключи запуска и справку можно посмотреть командой <code>wb-mcu-fw-updater update-all -h</code>.
{| class="wikitable"
! Параметр !! Описание !! Значение по умолчанию
|-
| --force || Произвести перепрошивку устройств даже если на них установлена самая свежая прошивка || Флаг
|-
|-
| -h, --help || Описание ключей запуска для режима || Флаг
|-
|}


=== Восстановление прошивки всех устройств (recover-all) ===  
=== Восстановление прошивки всех устройств (recover-all) ===  
Строка 76: Строка 133:
Для каждого обнаруженного устройства утилита проверяет его статус и, если устройство находится в режиме загрузчика — прошивает свежей прошивкой.
Для каждого обнаруженного устройства утилита проверяет его статус и, если устройство находится в режиме загрузчика — прошивает свежей прошивкой.


Ключи запуска и справку можно посмотреть командой <code>wb-mcu-fw-updater recover-all -h</code>.
{| class="wikitable"
! Параметр !! Описание !! Значение по умолчанию
|-
| -h, --help || Описание ключей запуска для режима || Флаг
|}


==  Аргументы командной строки ==
==  Аргументы командной строки ==