Настройка интеграции actobus с ChirpStack Application server. Для контролируемости версий продуктов из пакета Chirpstack рекомендуется развертывание посредством docker контейнеров.

Конфигурация сети

Конфигурация сети требуется в случае развертывания ChirpStack и ПО РТЛС в docker контейнерах на едином docker хосте.

Перед началом работы ChirpStack и ПО РТЛС уже установлены

  1. внести изменения в chirpstack-docker/docker-compose.yml

    1. добавить в конце файла добавить описания сетевых интерфейсов default и rtls 

      networks:
  default:
    driver: bridge
  rtls:
    external:
      name: rtls_rtls-net

    2. для модуля  chirpstack-application-server добавить сетевые интерфейсы, которые должны использоваться контейнером

          networks:
      - default
      - rtls

    3. пересоздать контейнеры chirpstack с новыми настройками 

      cd chirpstack-docker
docker-compose up -d

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

  1. в разделе Applications создать новый профиль интеграции или выбрать уже созданный

    1. перейти в конфигурацию профиля приложения

    2. добавить в профиль девайсы, данные от которых должны передаваться в Actobus

    3. перейти в раздел Integrations

    4. добавить конфигурацию по HTTP (add или edit, если уже создана)

      1. Payload marshaler - JSON

      2. Endpoints - http://actobus.rtls:8420/act/cs (actobus.rtls может быть заменен на IP адрес, в случае если Chirpstack и ПО РТЛС развернуты на разных машинах)

    5. сохранить изменения 

  2. в разделе API keys создать ключ для авторизации входящих сообщений 

    1. указать API key name  - actobus

    2. создать ключ с помощью кнопки CREATE API KEY

    3. содержимое скопировать в файл cs_token

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

настройка нужна для передачи команд в метку по протоколу LoRaWAN

  1. в файле rtls/actobus/config.ini

    1. Раскомментировать блок подписки  с типом LORA_SERVER,  в случае если chirpstack развернут на другой машине , заменить chirpstack на адрес машины, где установлен ChirpStack Network Server

      {
   id      = "LoraServer",
   type    = "LORA_SERVER",
   url     = "http://chirpstack:8080/api"
   oauth2_url = "http://chirpstack:8080/api/internal/login"
   passfile= "/opt/actobus/config/.cs"
   token   = "/opt/actobus/config/.cs_token"
   downlink_port = 171
}

  2. в папку rtls/actobus/config/ скопировать файл с ключом для доступа к actobus (cs_token) добавив точку в название файла 

    cp cs_token rtls/actobus/config/
mv rtls/actobus/config/cs_token rtls/actobus/config/.cs_token

  3. перезапустить контейнер 

    docker restart rtls_actobus_1

  4. открыть пользовательский интерфейс модуля actobus , где <ip> адрес машины, на которой развернуто ПО РТЛС, параметры доступа по умолчанию (system/admin)

    http://<ip>:8420/

  5. в разделе Devices зарегистрировать метки. Команды в незарегистрированные метки передаваться не будут