Wb-mb-explorer: различия между версиями

Wb-mb-explorer (просмотреть исходный код)

Версия 18:06, 9 января 2022

1290 байт добавлено , 2 года назад

добавил информацию и скриншоты

Explorerol

wb_editors

480

правок

@@ Строка 4: / Строка 4: @@
 {{DISPLAYTITLE:Утилита для диагностики, конфигурирования и обновления прошивок wb-mb-explorer}}
 == Общая информация ==
 Здесь описывается <code>wb-mb-explorer</code> — консольная графическая утилита для диагностики, конфигурирования и обновления прошивок modbus-устройств Wiren Board. Она представляет собой скрипт, основанный на штатных программах и утилитах контроллера Wirenboard: modbus_client, wb-mcu-fw-flasher, wb-mcu-fw-updater. За счет графического интерфейса работа с утилитой обычно проще, чем непосредственный набор команд с множеством опций в рабочей строке.
+Ниже приведено несколько скриншотов работы утилиты.
+<gallery mode="packed" widths ="260px" heights="200px">
+Image: Wb-mb-explorer-main-menu.png | Главное меню утилиты wb-mb-explorer
+Image: Wb-mb-explorer-device-info.png | Чтение информации об устройстве
+Image: Wb-mb-explorer-read-register.png | Чтение регистра
+Image: Wb-mb-explorer-quick-device-scan.png | Быстрое сканирование доступных адресов
+</gallery>
 == Установка утилиты ==
@@ Строка 22: / Строка 32: @@
 После установки утилиту можно запустить командой <code>wb-mb-explorer</code>
 == Описание интерфейса ==
-При запуске утилиты, а также при каждой попытке обращения к устройству по шине RS-485, драйвер wb-mqtt-serial будет остановлен. При выходе из утилиты драйвер будет снова запущен. Это необходимо для получения доступа к портам контроллера.
+При запуске утилиты, а также при каждой попытке обращения к устройству по шине RS-485, драйвер wb-mqtt-serial будет остановлен. Это необходимо для получения доступа к портам контроллера. После запуска откроется главное окно, в котором можно выбирать нужные действия с устройствами. При выходе из утилиты драйвер wb-mqtt-serial будет снова запущен.
-После запуска откроется главное окно, в котором можно выбирать нужные действия с устройствами.
 Перед началом использования нужно выбрать пункт Settings и задать параметры обмена данными (скорость, четность, количество стоп-битов), а также адрес устройства, с которым требуется установить связь, номер и тип его регистра. Эти настройки утилита будет использовать для обмена данными с устройствами.
@@ Строка 30: / Строка 39: @@
 === Описание основных функций ===
-[[Image: Wb-mb-explorer-main-menu.png |rigth| thumb| 400px | Главное меню утилиты wb-mb-explorer]]
+[[Image: Wb-mb-explorer-main-menu.png |right| thumb| 400px | Главное меню утилиты wb-mb-explorer]]
 # <b>Settings</b> - настройка параметров обмена, задание адреса устройства, номера и типа регистра для работы
 # <b>Show device info</b> - чтение информации об устройсве (модель устройства, серийный номер, версия прошивки, сигнатура прошивки и др.)
 # <b>Read/write register</b> - чтение/запись выбранного регистра
-# <b>Quick device scan</b> - проверка доступности устройств с адресами от 1 до 247 на шине с заданными параметрами обмена, занимает около 1 минуты.
+# <b>Quick device scan</b> - проверка доступности устройств с адресами от 1 до 247 на шине с заданными параметрами обмена, занимает около 1 минуты. Утилита отправляет запрос на чтение holding-регистра с адресом 128, в котором хранится адрес Modbus-устройства Wirenboard.
 # <b>Complete device scan</b> - проверка доступности устройств с адресами от 1 до 247 со всеми возможными комбинациями параметров обмена. Полностью процесс занимает около 1 часа. Для ускорения обнаружения устройств сначала производится опрос устройств на скорости 9600 бит/сек, затем на 115200 бит/сек, затем на остальных скоростях. При необходимости процесс можно прервать.
 # <b>FW update</b> - переход в меню обновления прошивок
@@ Строка 40: / Строка 49: @@
 === Меню обновления прошивок ===
-Для обновления прошивок Modbus-устройств есть четыре метода:
+[[Image: Wb-mb-explorer-fw-update-menu.png |rigth| thumb| 400px | Меню обновления прошивок]]
+Для обновления прошивок Modbus-устройств есть четыре способа:
 # <b>Device FW update</b> - обновление прошивки устройства, используя текущие настройки порта, параметров обмена и адреса. В процессе обновления из репозитория будет загружена самая последняя прошивка и произведена попытка обновления на нее. Если устройство уже имеет последнюю версию прошивки, то обновления не будет произведено. Для обновления вызывается команда <code>wb-mcu-fw-updater update-fw</code> с указанием выбранного порта и адреса устройства.
 # <b>Force device FW update</b> - функция, аналогичная Device FW update, но обновление будет даже в том случае, если устройство уже имеет последнюю версию прошивки. Для обновления вызывается команда <code>wb-mcu-fw-updater update-fw --force</code> с указанием выбранного порта и адреса устройства.
@@ Строка 47: / Строка 57: @@
 === Особенности работы ===
-При выборе порта или обновлении прошивки откроется диалог выбора. Перемещаться между элементами окна следует с помощью клавиши <code>Tab</code>, для автодополнения можно использовать клавишу <code>Space</code> (пробел). До нажатия кнопки <code>"ОК"</code> в строке должен быть полностью указан путь к порту (файлу). Если этого не сделать, то путь будет задан неверно. Путь можно задавать, набирая его с клавиатуры или выбрав элемент в окне и нажав <code>Space</code>.
+[[Image: Wb-mb-explorer-setting-port.png |rigth| thumb| 400px | Диалог выбора порта]]
+При выборе порта или обновлении прошивки откроется диалог выбора. Перемещаться между элементами окна следует с помощью клавиши <code>Tab</code>, для автодополнения можно использовать клавишу <code>Space</code> (пробел). До нажатия кнопки <code>"ОК"</code> в поле ввода должен быть полностью указан путь к порту (файлу) иначе порт будет задан неверно. Путь можно задавать, набирая его с клавиатуры, или выбрать элемент в окне и нажать <code>Space</code>.
+Для изменения скорости обмена, настроек четности или стоп-битов нужно выбрать нужный вариант из списка с помощью клавиши <code>Space</code>, выбранный вариант отмечен символом <code>*</code>.