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

→‎Описание интерфейса: добавил описание меню сканирования сети
(→‎Общая информация: изменил описание картинки)
(→‎Описание интерфейса: добавил описание меню сканирования сети)
Строка 31: Строка 31:


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


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




== Описание интерфейса ==
=== Описание основных функций ===
=== Описание основных функций ===
[[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]]
Строка 43: Строка 43:
# <b>Show device info</b> - чтение информации об устройсве (модель устройства, серийный номер, версия прошивки, сигнатура прошивки и др.)
# <b>Show device info</b> - чтение информации об устройсве (модель устройства, серийный номер, версия прошивки, сигнатура прошивки и др.)
# <b>Read/write register</b> - чтение/запись выбранного регистра
# <b>Read/write register</b> - чтение/запись выбранного регистра
# <b>Quick device scan</b> - проверка доступности устройств с адресами от 1 до 247 на шине с заданными параметрами обмена, занимает около 1 минуты. Утилита отправляет запрос на чтение holding-регистра с адресом 128, в котором хранится адрес Modbus-устройства Wirenboard.
# <b>Network scan</b> - сканирование сети на наличие подключенных устройств, есть разные методы сканирования.
# <b>Complete device scan</b> - проверка доступности устройств с адресами от 1 до 247 со всеми возможными комбинациями параметров обмена. Полностью процесс занимает около 1 часа. Для ускорения обнаружения устройств сначала производится опрос устройств на скорости 9600 бит/сек, затем на 115200 бит/сек, затем на остальных скоростях. При необходимости процесс можно прервать.
# <b>FW update</b> - переход в меню обновления прошивок
# <b>FW update</b> - переход в меню обновления прошивок
# <b>Show log file</b> - показать файл сообщений о работе утилиты с момента последнего запуска. Записи хранятся в файле <code>/var/log/wb-mb-explorer.log</code>. При запуске утилиты содержимое файла стирается.
# <b>Show log file</b> - показать файл сообщений о работе утилиты с момента последнего запуска. Записи хранятся в файле <code>/var/log/wb-mb-explorer.log</code>. При запуске утилиты содержимое файла стирается.


Для отображения краткой справки по функциям утилиты нажмите на кнопку <code>Help</code>.
Для отображения краткой справки по функциям утилиты нажмите на кнопку <code>Help</code>.
=== Меню сканирования сети ===
[[Image: Wb-mb-explorer-address-scan.png |rigth| thumb| 400px | Меню сканирования сети]]
В процессе сканирования утилита перебирает адреса и настройки обмена чтобы определить наличие подключенных устройств. Для этого отправляется запрос на чтение holding-регистра с адресом 128, в котором хранится адрес Modbus-устройства Wirenboard. Если ответ получен, то данные выводится в поле обнаруженных устройств.
# <b>Scan of addresses</b> - проверка доступности устройства с заданным адресом используя все возможные комбинации настроек обмена данными.
# <b>Scan of addresses</b> - проверка доступности устройств с адресами от 1 до 247 на шине с заданными параметрами обмена, занимает около 1 минуты.
# <b>Complete device scan</b> - проверка доступности устройств с адресами от 1 до 247 со всеми возможными комбинациями параметров обмена. Полностью процесс занимает около 1 часа. Для ускорения обнаружения устройств сначала производится опрос устройств на скорости 9600 бит/сек, затем на 115200 бит/сек, затем на остальных скоростях. При необходимости процесс можно прервать.


=== Меню обновления прошивок ===
=== Меню обновления прошивок ===
Строка 58: Строка 65:
# <b>Update FW using file</b> - обновление прошивки устройства с использованием заранее скачанного файла прошивки. Для обновления вызывается команда <code>wb-mcu-fw-flasher</code> с указанием выбранного порта, скорости обмена, адреса устройства и имени файла прошивки.
# <b>Update FW using file</b> - обновление прошивки устройства с использованием заранее скачанного файла прошивки. Для обновления вызывается команда <code>wb-mcu-fw-flasher</code> с указанием выбранного порта, скорости обмена, адреса устройства и имени файла прошивки.


=== Особенности работы ===
== Особенности работы ==
[[Image: Wb-mb-explorer-setting-port.png |rigth| thumb| 400px | Диалог выбора порта]]
[[Image: Wb-mb-explorer-setting-port.png |rigth| thumb| 400px | Диалог выбора порта]]
При выборе порта или обновлении прошивки откроется диалог выбора. Перемещаться между элементами окна следует с помощью клавиши <code>Tab</code>, для автодополнения можно использовать клавишу <code>Space</code> (пробел). До нажатия кнопки <code>"ОК"</code> в поле ввода должен быть полностью указан путь к порту (файлу) иначе порт будет задан неверно. Путь можно задавать, набирая его с клавиатуры, или выбрать элемент в окне и нажать <code>Space</code>.  
При выборе порта или обновлении прошивки откроется диалог выбора. Перемещаться между элементами окна следует с помощью клавиши <kbd>Tab</kbd>, для автодополнения можно использовать клавишу <kbd>Space</kbd> (пробел). До нажатия кнопки <kbd>"ОК"</kbd> в поле ввода должен быть полностью указан путь к порту (файлу) иначе порт будет задан неверно. Путь можно задавать, набирая его с клавиатуры, или выбрать элемент в окне и нажать <kbd>Space</kbd>.  


Для изменения скорости обмена, настроек четности или стоп-битов нужно выбрать нужный вариант из списка с помощью клавиши <code>Space</code>, выбранный вариант отмечен символом <code>*</code>.
Для изменения скорости обмена, настроек четности или стоп-битов нужно выбрать нужный вариант из списка с помощью клавиши <kbd>Space</kbd>, выбранный вариант отмечен символом <code>*</code>.
wb_editors
480

правок