16 278
правок
N.maslov (обсуждение | вклад) м (Починил опечатку в процедуре установки wb-mcu-fw-updater) |
|||
(не показано 16 промежуточных версий 4 участников) | |||
Строка 16: | Строка 16: | ||
# Откройте консоль контроллера через [[SSH]]. | # Откройте консоль контроллера через [[SSH]]. | ||
# Обновите список пакетов: | # Обновите список пакетов: | ||
#:<syntaxhighlight lang=" | #:<syntaxhighlight lang="bash"> | ||
apt update | |||
</syntaxhighlight> | </syntaxhighlight> | ||
# Установите утилиту командой: | # Установите утилиту командой: | ||
#:<syntaxhighlight lang=" | #:<syntaxhighlight lang="bash"> | ||
apt install wb-mcu-fw-updater | |||
</syntaxhighlight> | </syntaxhighlight> | ||
=== ОС Linux === | === ОС Linux === | ||
Для Debian-подобных операционных систем есть | {{Anchor|linux}} | ||
Wb-mcu-fw-updater не поддерживается на других платформах. Для Debian-подобных операционных систем есть утилита [[Wb-mcu-fw-flasher |wb-mcu-fw-flasher]]. | |||
== Режимы == | == Режимы == | ||
Строка 47: | Строка 38: | ||
Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию ПО и производит обновление, если требуется. Этот режим гибко настраивается с помощью ключей запуска, например, в этом режиме можно устанавливать тестовые прошивки. | Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию ПО и производит обновление, если требуется. Этот режим гибко настраивается с помощью ключей запуска, например, в этом режиме можно устанавливать тестовые прошивки. | ||
{| class="wikitable" | {| class="wikitable noclear" | ||
! Параметр !! Описание !! Значение по умолчанию | ! Параметр !! Описание !! Значение по умолчанию | ||
|- | |- | ||
Строка 64: | Строка 55: | ||
|- | |- | ||
|- | |- | ||
| --force || Произвести перепрошивку устройства даже если установлена самая свежая прошивка || Флаг | | -f, --force || Произвести перепрошивку устройства даже если установлена самая свежая прошивка || Флаг | ||
|- | |- | ||
|- | |- | ||
| --restore-defaults || | | --restore-defaults || Стирает все настройки и калибровочные значения: датчики начнут показывать ерунду. <br>Не используйте, если не знаете, что делаете. || Флаг | ||
|- | |- | ||
|} | |} | ||
=== Обновление загрузчика (update-bl) === | === Обновление загрузчика (update-bl) === | ||
{{Anchor|update-bl}} | |||
Обновление загрузчика устройства с известным modbus-адресом. | Обновление загрузчика устройства с известным modbus-адресом. | ||
'''ВНИМАНИЕ:''' обновление загрузчика — потенциально опасная операция. Если во время обновления загрузчика пропало питание, устройство может превратиться в «кирпич». В этом случае гарантия на него аннулируется. Чтобы избежать такой ситуации — резервируйте питание контроллера и устройства, например, с помощью [[UPS2 | | Изменения в новой версии загрузчика описаны в [[Bootloader_Changelog |журнале изменений]]. | ||
'''ВНИМАНИЕ:''' обновление загрузчика — потенциально опасная операция. Если во время обновления загрузчика пропало питание, устройство может превратиться в «кирпич». В этом случае гарантия на него аннулируется. Чтобы избежать такой ситуации — подключайте устройство напрямую к контроллеру, а также резервируйте питание контроллера и устройства, например, с помощью [[UPS2 | WB-UPS v.2]]. | |||
Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию загрузчика и производит обновление, если требуется. При обновлении загрузчика, устройство будет автоматически прошито самой свежей прошивкой. | Утилита сама находит настройки соединения с устройством, запрашивает у устройства версию загрузчика и производит обновление, если требуется. При обновлении загрузчика, устройство будет автоматически прошито самой свежей прошивкой. | ||
{| class="wikitable" | {| class="wikitable" | ||
! Параметр !! Описание !! Значение по умолчанию | ! Параметр !! Описание !! Значение по умолчанию | ||
Строка 91: | Строка 86: | ||
|- | |- | ||
|} | |} | ||
Пример команды, которая обновляет загрузчик в устройстве с адресом 153, подключенного к порту /dev/ttyRS485-1: | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-bl -a 153 /dev/ttyRS485-1 | |||
</syntaxhighlight> | |||
=== Восстановление (recover) === | === Восстановление (recover) === | ||
Строка 108: | Строка 108: | ||
|- | |- | ||
|- | |- | ||
| --restore-defaults || | | --restore-defaults || Стирает все настройки и калибровочные значения: датчики начнут показывать ерунду. <br>Не используйте, если не знаете, что делаете. || Флаг | ||
|- | |- | ||
|- | |- | ||
Строка 146: | Строка 146: | ||
| -h, --help || Описание ключей запуска для режима || Флаг | | -h, --help || Описание ключей запуска для режима || Флаг | ||
|} | |} | ||
=== Залить прошивку из файла (flash-file) === | |||
Заливает в устройство прошивку из указанного файла. | |||
{| class="wikitable" | |||
! Параметр !! Описание !! Значение по умолчанию | |||
|- | |||
| ||Порт, к которому подключено устройство. Позиционный аргумент || '''обязательный''' | |||
|- | |||
| -a, --slaveid || Modbus адрес устройства || '''обязательный''' | |||
|- | |||
| --file || Путь к файлу прошивки || '''обязательный''' | |||
|- | |||
| -h, --help || Описание ключей запуска для режима || Флаг | |||
|} | |||
<syntaxhighlight lang="console"> | |||
# wb-mcu-fw-updater flash-file /dev/ttyRS485-1 --conn-settings 115200N2 -a20 --file /home/debs/mcm8G__1.4.0-rc1_master_20e4b39.wbfw | |||
2022-07-27 12:14:02,043 Flashing /home/debs/mcm8G__1.4.0-rc1_master_20e4b39.wbfw | |||
100%|#######################################################################################################|134/134 | |||
</syntaxhighlight> | |||
=== Получить debug-лог === | |||
Если в работе утилиты возникли ошибки, то при обращении в техподдержку лучше приложить debug-лог, чтобы его получить, добавьте в конце команды <code>--debug</code>, например: | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-fw /dev/ttyMOD1 -a32 -f --debug | |||
</syntaxhighlight> | |||
Параметр работает во всех режимах. | |||
== Типичные сценарии использования == | == Типичные сценарии использования == |