Настройка сенсора в беспроводном режиме

Начиная с версии кода сенсора 2.1442, сенсоры поддерживают режим работы без провода (или, как мы его называем, Unwired режим). В данном режиме сенсор использует только WiFi для работы и связи с сервером, и не нуждается в подключении к ЛВС по проводу.

Настройка режима работы Unwired может производиться как с сервера (если сенсор уже подключен к нему), так и с самого сенсора при помощи функционала онбординга через временную настроечную сеть, вещаемую сенсором.

По умолчанию некоторые модели сенсоров (например, HW4C), имеют включенную по умолчанию опцию настройки по беспроводному каналу, поэтому для настройки его необходимо просто воткнуть в розетку, и сразу приступать к настройке.

Настройка нового или не подключенного сенсора

Если сенсор включен в сеть питания, но еще не подключен к серверу, или не подключен проводом к ЛВС, то для запуска режима беспроводной настройки необходимо выполнить следующие действия:

Зажмите на сенсоре физическую кнопку RESET на 3-5с для включения беспроводного режима настройки. Необходимо именно зажать кнопку, а не нажать, потому что иначе сенсор просто перезагрузится;
После зажатия кнопки сенсор начнет вещание открытой беспроводной сети с именем qow-sensor-aabbcc, где aabbcc - 3 последние октета MAC адреса сенсора. Вам необходимо подключиться к данной сети с телефона или ноутбука;
После подключения к сети на устройстве, с которого выполняется подключение, должно появиться уведомление о входе в сеть, на которое необходимо нажать. Если уведомление не появилось, или автоматически не открылась страница настройки сенсора, перейдите в браузере по адресу http://100.100.100.1:1111
На странице настройки сенсора необходимо заполнить:
- SSID, к которому будет подключаться сенсор для связи с сервером
- тип безопасности для данного SSID
- учетные данные для подключения, если нужно
- адрес сервера для подключения
- порт MQTT для подключения (если используется нестандартный порт на сервере, иначе оставить по умолчанию)
После заполнения всех данных, нажмите кнопку "Подключить" внизу страницы для сохранения параметров и выполнения попытки подключения;
После сохранения данных сенсор отключит временный настроечный SSID, и произведет попытку подключения к заданному SSID, а также попытку подключения к серверу и регистрации на нем;
Если сенсор успешно подключится к SSID и серверу, то он появится в списке сенсоров в веб-интерфейсе сервера, иначе если подключение не удалось, то сенсор опять начнет вещание настроечного SSID для исправления заданных параметров с указанием ошибки подключения на странице настройки.

Данную процедуру необходимо проделать один раз, после этого сенсор автоматически добавится на контроллер и ему будет выставлен режим работы по беспроводному каналу, а также задан настроенный вами SSID. При необходимости его можно изменить уже на самом сервере в настройках сенсора, но для успешной смены необходимо, чтобы новые параметры поступили на сенсор, то есть сенсор запишет новые данные в память только если он в текущий момент свободен (не выполняет задач) и подключен к серверу по беспроводному каналу или по проводу.

Настройка подключенного к серверу сенсора

Если сенсор уже работает, подключен к сети и имеет связь с сервером, то для включения режима работы Unwired найдите его в списке сенсоров в веб-интерфейсе сервера (Объекты - Сенсоры), перейдите в его настройки, включите чекбокс "Поддержка взаимодействия с сервером по беспроводному каналу", и выберите в списке ниже необходимый SSID для связи с сервером, после этого сохраните настройки. Настроенный SSID запишется в память сенсора и будет использоваться в дальнейшем для подключения к сети и связи с сервером.

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

На время тестов сенсор отключается от заданного SSID, а после выполнения тестов подключается обратно для передачи результатов выполнения задач и метрик. При этом сенсор может подключаться к серверу и через тестируемые SSID прям во время выполнения тестов, если в задачах настроено подключение к каким-либо SSID, но это не гарантировано, так как в этих сетях может не быть доступа в подсеть сервера или не быть связности.

Настройка сенсора вручную

Если вам необходимо настроить сенсор вручную, то это можно сделать, подключившись к консоли сенсора (напрямую в консольный порт, если он есть, или по SSH), и записать в файл /root/qow/.unwired_settings.json настройки в следующем формате:

{"wifi_ssids":[{"ssid":"SSID_NAME","security":"SSID_SECURITY","username":"PEAP_USERNAME","password":"SSID_PASSWORD"}],"lte_iccids":[]}

где:

SSID_NAME - имя SSID для подключения
SSID_SECURITY - тип безопасности:
- OPEN - открытая сеть
- PSK - WPA2-PSK
- PEAP - EAP-PEAP
SSID_PASSWORD - пароль для подключения (необходим для безопасности PSK или PEAP, для PEAP - пароль пользователя)
PEAP_USERNAME - имя пользователя для авторизации EAP-PEAP

После внесения настроек необходимо перезапустить сервис сенсора при помощи команды service qow_sensor restart

Данную процедуру необходимо проделать один раз, после этого сенсор автоматически добавится на контроллер и ему будет выставлен режим работы по беспроводному каналу, а также задан настроенный вами SSID. При необходимости его можно изменить уже на самом сервере в настройках сенсора, но для успешной смены необходимо, чтобы новые параметры поступили на сенсор, то есть сенсор запишет новые данные в память только если он в текущий момент свободен (не выполняет задач) и подключен к серверу по беспроводному каналу или по проводу.

Массовая настройка сенсоров

Для ситуации, когда необходимо настроить множество сенсоров имеется специальный режим настройки через внешний SSID, вещаемый каким-либо другим устройством (точка доступа, ноутбук, телефон). Данный вариант настройки работает следующим образом:

Сенсор каждые 30с сканирует радио-эфир и ищет SSID с определенным именем;
При нахождении SSID. он подключается к нему, получает адрес по DHCP и адрес шлюза в сети;
Запрашивает по HTTP с адреса шлюза специальный файл настроек;
При получении файла сенсор отключается от SSID и пытается произвести настройку;
Если настройка не удалась, сенсор начинает процесс сначала.

Для настройки в таком режиме необходимо:

Настроить на каком-либо устройстве вещание сети WPA2-PSK с именем QowOnboarding и паролем QowP@ssw0rd
Также необходимо настроить на шлюзе в данной сети настроить HTTP сервер на порту 8080. Если вы производите настройку на телефоне или ноутбуке, то это устройство и является шлюзом, иначе настройте свой DHCP сервер для передачи адреса шлюза с HTTP сервером на нем;
- Для настройки HTTP сервера на телефоне или ноутбуке существует множество бесплатных приложений, для примера:

В корневой папке HTTP сервера необходимо создать файл config.json со следующим содержимым:

{
  "server_name": "qow.example.com",
  "server_port": 8883,
  "wifi_ssids": [
    {
      "ssid": "Corporate-WiFi",
      "security": "PSK",
      "password": "SecretPassword123"
    }
  ]
}

Описание параметров для SSID описано выше в блоке настройки сенсора вручную;
После создания файла проверьте вручную, что HTTP сервер работает правильно и файл доступен: откройте в браузере устройства адрес http://ip_адрес_устройства:8080/config.json, если предлагается скачать файл или показывается содержимое файла, значит HTTP сервер настроен корректно;
После настройки HTTP сервера включите функцию "Hotspot" или "Точка доступа" на устройстве с указанными выше параметрами;
После всех настроек включите сенсоры в сеть или подойдите к ним с устройством, сенсоры автоматически найдут вещаемый SSID, подключатся к нему, получат настройки из файла, и произведут попытку подключения к заданному SSID и серверу.

Данную процедуру необходимо проделать один раз, после этого сенсор автоматически добавится на контроллер и ему будет выставлен режим работы по беспроводному каналу, а также задан настроенный вами SSID. При необходимости его можно изменить уже на самом сервере в настройках сенсора, но для успешной смены необходимо, чтобы новые параметры поступили на сенсор, то есть сенсор запишет новые данные в память только если он в текущий момент свободен (не выполняет задач) и подключен к серверу по беспроводному каналу или по проводу.

Ограничения Unwired-режима

Команды, отправляемые на сенсор, будут выполняться не сразу, а только когда сенсор свободен (не выполняет задачи) и подключен к заданному SSID для связи с сервером;
Не будут работать команды в реальном времени, такие как доступ по SSH, получение списка сетей, захват трафика и т.д.;
Не будет отображения текущего статуса измерения, или оно будет обновляться редко;
При задании выполнения непрерывных задач без задержек для сенсора он просто не будет успевать подключаться к SSID для передачи результатов на сервер, поэтому необходимо задавать адекватные задержки между выполнениями, как минимум 60с.
При выполнении длительных задач с множеством инструкций сенсор может отображаться как оффлайн, но при этом после выполнения задачи целиком будет появляться на сервере и передавать результаты измерений.

Page tree