Утилита для диагностики, конфигурирования и обновления прошивок wb-mb-explorer

Это черновик страницы. Последняя правка сделана 28.12.2021 пользователем Explorerol.

Данная утилита официально не поддерживается. Её использование осуществляется на свой страх и риск! Если вы не уверены в своих действиях, то не используйте ее!

Общая информация

Здесь описывается wb-mb-explorer — консольная графическая утилита для диагностики, конфигурирования и обновления прошивок modbus-устройств Wiren Board. Она представляет собой скрипт, основанный на штатных программах и утилитах контроллера Wirenboard: modbus_client, wb-mcu-fw-flasher, wb-mcu-fw-updater. За счет графического интерфейса работа с утилитой обычно проще, чем непосредственный набор команд с множеством опций в рабочей строке.

Установка утилиты

Утилита доступна для установки в релизе testing. Исходный код доступен в репозитории wb-mb-explorer. Установка утилиты осуществляется стандартным способом:

1. Откройте консоль контроллера через SSH.
2. Обновите список пакетов:

   apt update
   

3. Установите утилиту командой:

   apt install wb-mb-explorer
   

После установки утилиту можно запустить командой wb-mb-explorer

Описание интерфейса

При запуске утилиты, а также при каждой попытке обращения к устройству по шине RS-485, драйвер wb-mqtt-serial будет остановлен. При выходе из утилиты драйвер будет снова запущен. Это необходимо для получения доступа к портам контроллера. После запуска откроется главное окно, в котором можно выбирать нужные действия с устройствами.

Перед началом использования нужно выбрать пункт Settings и задать параметры обмена данными (скорость, четность, количество стоп-битов), а также адрес устройства, с которым требуется установить связь, номер и тип его регистра. Эти настройки утилита будет использовать для обмена данными с устройствами.

Описание основных функций

Главное меню утилиты wb-mb-explorer

1. Settings - настройка параметров обмена, задание адреса устройства, номера и типа регистра для работы
2. Show device info - чтение информации об устройсве (модель устройства, серийный номер, версия прошивки, сигнатура прошивки и др.)
3. Read/write register - чтение/запись выбранного регистра
4. Quick device scan - проверка доступности устройств с адресами от 1 до 247 на шине с заданными параметрами обмена
5. Complete device scan - проверка доступности устройств со всеми возможными комбинациями параметров обмена. Полностью процесс занимает около 1 часа. Для ускорения обнаружения устройств сначала производится опрос устройств на скорости 9600 бит/сек, затем на 115200 бит/сек, затем на остальных скоростях. При необходимости процесс можно прервать.
6. FW update - переход в раздел обновления прошивок
7. Show log file - показать файл сообщений о работе утилиты с момента последнего запуска. Записи хранятся в файле /var/log/wb-mb-explorer.log. При запуске утилиты содержимое файла стирается.