Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Gliffy Diagram
imageAttachmentIdatt2413756432
baseUrlhttps://rtlsnet.jira.com/wiki
macroId36519b63-62d2-4dc8-8fcd-80d39395c0f6
displayNamechirpstack_integration_scheme
namechirpstack_integration_scheme
diagramAttachmentIdatt2413723667
containerId2403696690
pagePin3
timestamp1643351909057
Info

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

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

Info

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

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

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

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

      Code Block
      languageyaml
      networks:
        default:
          driver: bridge
        rtls:
          external:
            name: rtls_rtls-net
      
    2. для модулей  chirpstack, chirpstack-rest-api и  mosquitto добавить сетевые интерфейсы, которые должны использоваться контейнером

      Code Block
      languageyaml
          networks:
            - default
            - rtls
    3. если в текущей версии ChirpStack открыт порт 1883 для доступа извне - закомменировать настройку или изменить на другой свободный порт

      Code Block
        mosquitto:
          image: eclipse-mosquitto:2
        #  ports:
        #    - 1883:1883
    4. пересоздать контейнеры chirpstack с новыми настройками

      Code Block
      cd chirpstack-docker
      docker-compose up -d

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

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

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

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

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

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

      1. Payload encoding (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


Настройка ПО РТЛС

Info

для версий после  6.4.1 не требуется


  1. в docker-compose.yml для модуля keycloak  изменить порт доступа в UI  
    Code Block
    keycloak:
    ...
        ports:
         - 18080:8080
  2. применить настройки  
    Code Block
    docker compose up -d

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

Info

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

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

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

      Code Block
      {
         id      = "LoraServer",
         type    = "LORA_SERVER", 		
         url		= "http://chirpstack-rest-api:8090/api"
         token   = "/opt/actobus/config/.cs_token"
         downlink_port = 171
      }
  2. в папку rtls/actobus/config/ скопировать файл с ключом для доступа к actobus (cs_token) добавив точку в название файла

    Code Block
    cp cs_token rtls/actobus/config/
    mv rtls/actobus/config/cs_token rtls/actobus/config/.cs_token
  3. перезапустить контейнер

    Code Block
    docker restart rtls_actobus_1



Info

только для версии 4.x

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

    Code Block
    http://<ip>:8420/
  2. в разделе Devices зарегистрировать метки. Команды в незарегистрированные метки передаваться не будут


Table of Contents
maxLevel7
minLevel1
stylenone
printablefalse