wb_editors
480
правок
(→Общая информация: убрал лишнее слово) |
(→Установка утилиты: полная версия утилиты доступна и в стабильном релизе) |
||
(не показаны 4 промежуточные версии 2 участников) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE:Wb-mb-explorer - утилита для диагностики, конфигурирования и обновления прошивок устройств | {{DISPLAYTITLE:Wb-mb-explorer - утилита для диагностики, конфигурирования и обновления прошивок устройств Wiren Board с протоколом Modbus RTU}} | ||
== Общая информация == | == Общая информация == | ||
Строка 12: | Строка 12: | ||
** обновление прошивки. | ** обновление прошивки. | ||
Утилита представляет собой скрипт, основанный на штатных программах и утилитах контроллера | Утилита представляет собой скрипт, основанный на штатных программах и утилитах контроллера Wiren Board: modbus_client, wb-mcu-fw-flasher, wb-mcu-fw-updater. За счет графического интерфейса работа с утилитой обычно проще, чем непосредственный набор команд с множеством опций в рабочей строке. | ||
Утилита работает только на контроллере Wiren Board. При запуске утилиты, а также при каждой попытке обращения к устройству по шине RS-485, драйвер wb-mqtt-serial будет остановлен. Это необходимо для получения доступа к портам контроллера. После запуска откроется главное окно, в котором можно выбирать нужные действия с устройствами. При выходе из утилиты драйвер wb-mqtt-serial будет снова запущен. | Утилита предназначена работает только на контроллере Wiren Board. При запуске утилиты, а также при каждой попытке обращения к устройству по шине RS-485, драйвер wb-mqtt-serial будет остановлен. Это необходимо для получения доступа к портам контроллера. После запуска откроется главное окно, в котором можно выбирать нужные действия с устройствами. При выходе из утилиты драйвер wb-mqtt-serial будет снова запущен. | ||
Ниже приведены несколько скриншотов работы утилиты. | Ниже приведены несколько скриншотов работы утилиты. | ||
Строка 25: | Строка 25: | ||
== Установка утилиты == | == Установка утилиты == | ||
Исходный код доступен в репозитории [https://github.com/wirenboard/wb-mb-explorer wb-mb-explorer]. | |||
Установка утилиты осуществляется стандартным способом: | Установка утилиты осуществляется стандартным способом: | ||
# Откройте консоль контроллера через [[SSH]]. | # Откройте консоль контроллера через [[SSH]]. | ||
Строка 47: | Строка 47: | ||
[[Image: Wb-mb-explorer-main-menu.png |right| thumb| 400px | Главное меню утилиты wb-mb-explorer]] | [[Image: Wb-mb-explorer-main-menu.png |right| thumb| 400px | Главное меню утилиты wb-mb-explorer]] | ||
# <b>Settings</b> — настройка параметров обмена, задание адреса устройства, номера и типа регистра для работы | # <b>Settings</b> — настройка параметров обмена, задание адреса устройства, номера и типа регистра для работы | ||
# <b>Show device info</b> — чтение информации об | # <b>Show device info</b> — чтение информации об устройстве (модель устройства, серийный номер, версия прошивки, сигнатура прошивки и др.). Используются параметры обмена с устройством, заданные в настройках . | ||
# <b>Read/write register</b> — чтение/запись выбранного регистра | # <b>Read/write register</b> — чтение/запись выбранного регистра | ||
# <b>Device setup</b> — переход в меню настройки адреса устройства и параметров обмена. Также есть несколько дополнительных функций: перезагрузка устройства, перевод в режим загрузчика (bootloader mode), сброс настроек на заводские. | # <b>Device setup</b> — переход в меню настройки адреса устройства и параметров обмена. Также есть несколько дополнительных функций: перезагрузка устройства, перевод в режим загрузчика (bootloader mode), сброс настроек на заводские. | ||
Строка 88: | Строка 88: | ||
# <b>Com settings scan</b> — проверка доступности устройства с заданным адресом, используя все возможные комбинации настроек обмена данными. | # <b>Com settings scan</b> — проверка доступности устройства с заданным адресом, используя все возможные комбинации настроек обмена данными. | ||
# <b>Scan of addresses</b> — проверка доступности устройств с адресами от 1 до 247 на шине с заданными параметрами обмена, занимает около 1 минуты. | # <b>Scan of addresses</b> — проверка доступности устройств с адресами от 1 до 247 на шине с заданными параметрами обмена, занимает около 1 минуты. | ||
# <b>Complete | # <b>Complete scan</b> — проверка доступности устройств с адресами от 1 до 247 со всеми возможными комбинациями параметров обмена (полное сканирование сети). Полностью процесс занимает около 1 часа. Попытки обнаружения устройств сначала производятся на скорости 9600 бит/сек, затем на 115200 бит/сек, затем на остальных скоростях. При необходимости процесс можно прервать с помощью комбинации клавиш <kbd>Ctrl+C</kbd>. | ||
=== FW update (обновление прошивок) === | === FW update (обновление прошивок) === | ||
[[Image: Wb-mb-explorer-fw-update-menu.png |rigth| thumb| 400px | Меню ''FW update'']] | [[Image: Wb-mb-explorer-fw-update-menu.png |rigth| thumb| 400px | Меню ''FW update'']] | ||
Для обновления прошивок Modbus-устройств есть | Для обновления прошивок Modbus-устройств есть несколько способов: | ||
# <b>Device FW update</b> — обновление прошивки устройства, используя выбранный порт и адрес устройства. Перед обновлением и по завершению обновления утилита попытается считать информацию об устройстве, используя заданные настройки обмена. В процессе обновления из репозитория будет загружена самая последняя прошивка и произведена попытка обновления на нее. Если устройство уже имеет последнюю версию прошивки, то обновления не будет произведено. Для обновления вызывается команда <code>wb-mcu-fw-updater update-fw</code> с указанием выбранного порта и адреса устройства. | # <b>Device FW update</b> — обновление прошивки устройства, используя выбранный порт и адрес устройства. Перед обновлением и по завершению обновления утилита попытается считать информацию об устройстве, используя заданные настройки обмена. В процессе обновления из репозитория будет загружена самая последняя прошивка и произведена попытка обновления на нее. Если устройство уже имеет последнюю версию прошивки, то обновления не будет произведено. Для обновления вызывается команда <code>wb-mcu-fw-updater update-fw</code> с указанием выбранного порта и адреса устройства. | ||
# <b>Force device FW update</b> — функция, аналогичная <code>Device FW update</code>, но обновление будет даже в том случае, если устройство уже имеет последнюю версию прошивки. Для обновления вызывается команда <code>wb-mcu-fw-updater update-fw --force</code> с указанием выбранного порта и адреса устройства. | # <b>Force device FW update</b> — функция, аналогичная <code>Device FW update</code>, но обновление будет даже в том случае, если устройство уже имеет последнюю версию прошивки. Для обновления вызывается команда <code>wb-mcu-fw-updater update-fw --force</code> с указанием выбранного порта и адреса устройства. | ||
# <b>Recover device FW</b> - восстановить прошивку устройства, у которого она повреждена или отсутствует, используется команда <code>wb-mcu-fw-updater recover</code> с выбранным адресом и портом. | |||
# <b>Update FW of all devices</b> — обновление прошивок всех устройств, сконфигурированных на контроллере. Для обновления вызывается команда <code>wb-mcu-fw-updater update-all</code> | # <b>Update FW of all devices</b> — обновление прошивок всех устройств, сконфигурированных на контроллере. Для обновления вызывается команда <code>wb-mcu-fw-updater update-all</code> | ||
# <b>Update FW to specified version</b> - обновление прошивки устройства на заданную версию, номер версии в формате X.X.X будет запрошен в отдельном диалоге. Для обновления вызывается команда <code>wb-mcu-fw-updater update-fw --version</code> | |||
# <b>Update FW using file</b> — обновление прошивки устройства с использованием заранее скачанного файла прошивки. Для обновления вызывается команда <code>wb-mcu-fw-flasher</code> с указанием выбранного порта, скорости обмена, адреса устройства и имени файла прошивки. | # <b>Update FW using file</b> — обновление прошивки устройства с использованием заранее скачанного файла прошивки. Для обновления вызывается команда <code>wb-mcu-fw-flasher</code> с указанием выбранного порта, скорости обмена, адреса устройства и имени файла прошивки. | ||