Настройка actobus

1. в файле actobus/config/config.ini добавить информацию для сбора данных в формате stats event в блок с типом LORA_SERVER
   1. gw_stats_broker - параметры подключения в mosquitto, поставляемым с ПО chirpstack в формате host:port
      • в случае размещения Chirpstack и ПО РТЛС на одной машине указать подключение по имени контейнера 

        gw_stats_broker = "mosquitto:1883"

      • в случае размещения Chirpstack и ПО РТЛС на разных машинах указать адрес машины, где развернуто ПО Chirpstack
   2. gw_stats_topic - указание топиков для подключения , ru864/gateway/+/event/stats включает сбор со всех GW
   3. gw_stats_health - включение режима  healthcheck - пересылка периодических сообщений в сервер с текущим статусом БС, если выключен (по умолчанию), то сообщение будет передаваться только в случае смены статуса
   4. gw_check_no_traffic = true включает проверку траффика через БС, если обмен с метками упадет до 0 пакетов за период в 30 сек, статус БС сменится на DOWN
2. перезапустить контейнер actobus 

   docker compose restart actobus

Настройка srv

1. в разделе Системная конфигурация →Настройки UI в блоке Элементы UI
   1. развернуть элемент Конфигурация и включить элемент Стороннее оборудование для отображения 
   2. развернуть элемент Отчеты и включить элемент Отчет по внешним событиям для отображения 
2. сохранить изменения
3. после изменений в разделе Конфигурация будет доступна страница Стороннее оборудование
4. перейти в раздел Конфигурация → Стороннее оборудование
5. открыть меню создания нового элемента
   1. указать название БС (для идентификации в списке)
   2. указать место размещения на карте (для визуального отображения статуса)
   3. в поле ссылка указать идентификатор Gateway ID, который указан при регистрации в chirpstack 

Проверка результата

1. открыть Отчет по внешним событиям
2. при наличии связи с БС в списке должны присутствовать записи с соответствующим идентификатором и статусом UP, в поле Название будет отображаться название, указанное для БС при регистрации стороннего оборудования
3. перейти на карту , указанную при регистрации стороннего оборудования.
4. включить слой Стороннее оборудование
5. на карте должен отобразиться узел с лейблом и статусом, соотвутствующим записи в отчете
6. регистрации стороннего оборудования

Получение сообщений от сторонних источников по HTTP

1. На ресурс https://<ip>/feed необходимо отправить сообщение в заданном формате
   1. time: время события
   2. type: тип события, используется в последующем для настройки фильтрации в реакциях и отчетах
   3. object_id: идентификатор объекта для сопоставления с объектом из списка Стороннее оборудование

{
  "time": "2024-04-01T10:31:44.036",
  "type": "DOOR_OPENED",
  "object_id": "Door Lvl 1"
}

Получение сообщений от сторонних источников по  MQTT

1. В сервис emqx отправить сообщение в топик rtls/events в формате  сервисного сообщения RTLS
   • time - время изменения статуса
   • agent - сетевой узел, через который был принят статус устройства (для диагностики инфраструктуры)
   • source - источник сообщения, отправленного в сервер
   • source_type = GATEWAY
   • service = LINK
   • status - UP (устройство работает штатным образом) или DOWN (проблемы в работе устройства)
   • gw_id - указать идентификатор шлюза, указанный в поле ссылка при заведении записи стороннего оборудования

{
  "items": [
    {
      "time": "1970-01-01T03:00:00.000+03:00",
      "agent": "ACTOBUS",
      "source": "Actobus1",
      "source_type": "GATEWAY",
      "service": "LINK",
      "status": "UP",
      "descr": {
        "gw_id": "ABCDEF0123"
      }
    }
  ],
  "elements_count": 1,
  "elements_last": 1
}