Table of Contents

ChirpStack

Эта интеграция позволяет получать данные от сервера ChirpStack принимающего данные от счётчика по протоколу LoraWan.

Поддерживаются следующие модели устройств:

  • Борей 4-L
  • КАРАТ Компакт 2-223

Интеграция производится через http интеграцию сервера ChirpStack. Сервер ChirpStack при получении данных от устройства осуществляет отправку полученных данных post запросом на указанный адрес сервера ЛЭРС УЧЁТ, который принимает и обработает данные.

Обязательные требования

Сервер ChirpStack должен иметь возможность обратиться к серверу ЛЭРС УЧЁТ. Т.е. если сервер ChirpStack установлен во внешней сети, а сервер ЛЭРС УЧЁТ во внутренней сети предприятия, то сервер ЛЭРС УЧЁТ обязательно должен иметь внешний статический IP-адрес, или доменное имя. Сервер ЛЭРС УЧЁТ должен быть доступен из внешних сетей, а не только изнутри вашего предприятия.

Если же оба сервера находятся во внутренней сети предприятия, то можно использовать внутренние адреса.

Важно

Если на вашем сервере не настроен HTTPS, данные запросов будут переданы в открытом виде. Таким образом, данные могут быть перехвачены и использованы для передачи в систему заведомо неверных данных. Чтобы этого не произошло, настройте на сервере ЛЭРС защищённый обмен по протоколу https.

Настройка

Авторизация на сервере ЛЭРС

Сервер ChirpStack должен быть авторизован на сервере ЛЭРС, чтобы убедиться, что передаются не заведомо ложные показания. Для этого понадобится токен доступа службы опроса, который будет нужен при настройке интеграции.

Чтобы получить токен, откройте список учётных записей, найдите учётную запись "Служба опроса" и откройте её свойства.

На закладке "Приложения" введите:

  • Наименование приложения: любое понятное значение. Например, "ChirpStack"
  • Срок действия токена истекает: укажите достаточно большой срок, чтобы интеграция не сломалась в ближайшее время. Или оставьте поле пустым, чтобы токен действовал бессрочно.

Сохраните полученный токен, так как он понадобится в дальнейшем для настроек устройств в ChirpStack.

Эту операцию нужно выполнить только один раз. Но если вы потеряли токен, вы можете повторить процедуру. Старые токены, которые уже используются в интеграциях, продолжат работать.

Создание интеграции в ЛЭРС

Выберите пункт меню "Справочники → Интеграции" и нажмите кнопку "Создать". Выберите тип интеграции ChirpStack, введите наименование и адрес запроса. Адрес запроса будет использоваться как часть пути, по которому сервер ChirpStack будет обращаться для передачи данных. Путь формируется следующим образом {адрес сервера ЛЭРС}/api/v1/Poll/Hooks/{адрес запроса}. Так например для сервера https://my.lers.ru и адреса ChirpIntegration путь для обращения будет выглядеть как https://my.lers.ru/api/v1/Poll/Hooks/ChirpIntegration.

Создание точки учёта и подключение

  1. Создайте точку учёта и на закладке Устройство создайте устройство с моделью поддерживающую интеграцию с ChirpStack.
  2. Перейдите на закладку Подключения и создайте новое подключение с типом Интеграция.
  3. Выберите созданную ранее интеграцию ChirpStack.
  4. В поле URL будет выведена подсказка с адресом для подключения сервером ChirpStack. Сохраните его, так как он понадобится в дальнейшем для настроек сервера ChirpStack.
    Примечание

    В адресе используется адрес сервера ЛЭРС из параметров подключения пользователя. Поэтому, если вам необходимо организовать подключение из внешней сети, а в данном поле вам предлагается внутренний адрес, например localhost, то в сохранённом экземпляре, замените его на правильный самостоятельно.

  5. Задайте параметр DevEUI соответствующий устройству для которого создаётся данное подключение. Параметр DevEUI должен быть указан правильно, так как именно по нему определяется для какого устройства сервер ChirpStack передал данные.
  6. Перейдите на закладку Автоопрос и создайте новое расписание автоопроса через подключение интеграции с ChirpStack.
    Примечание

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

Настройка интеграции в сервере ChirpStack

Общий принцип настройки сервера ChirpStack находится в документации.

  1. Зайдите в параметры приложения, в котором заведено устройство с DevEUI указанным в ранее созданном подключении и перейдите на вкладку интеграций.
  2. Найдите интеграцию типа HTTP и нажмите клавишу Добавить.
  3. В параметре 'Payload encoding' выберите JSON. В поле 'Event endpoint URL(s)' введите ранее сохранённый адрес.
  4. Нажмите кнопку 'AddHeader'. В появившемся поле 'Key' введите x-lers-api-key, в поле 'Value' введите ранее сохранённый токен службы опроса.
  5. Сохраните введённые параметры интеграции.

После завершения настройки интеграции на стороне сервера ChirpStack все полученные им данные от устройства заведенного в приложении, в котором заданы параметры HTTP интеграции, будут пересылаться на сервер ЛЭРС, где будут разбираться и сохраняться как данные соответствующих точек учёта.

Журнал опроса

Каждая успешная передача данных фиксируется в журнале опроса и может быть просмотрена наряду с другими сеансами.