Сервис управления PTL индикаторами

Контроллеры
0
Онлайн
0
Активных PTL
0
Деградированных
0
Всего PTL
0

Контроллеры

IPПортДиапазонТипСтатус

Включить PTL

Массовые операции

Чтение PTL

Назначение адресов (Assign IDs)

Режим назначения Modbus-адресов PTL устройствам. Контроллер последовательно назначает адреса в указанном диапазоне.

Проверка доступности

Информация об устройстве

События (WebSocket)

Отключен
Ожидание событий...

История событий (Redis Stream)

Выполняемые задачи

Задачи поступают от WMS через API (POST /scenarios/tasks). Здесь отображается их прогресс.

Демо-программы

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

Журнал задач

Топ модулей (активации)

Контроллер:АдресВключений

Кнопки

Контроллер:Адрес:КнопкаНажатий

Цвета

Нагрузка по контроллерам

Активность по часам

Активность по дням

ДатаКоманд

Prometheus

Эндпоинт: /metrics — подключите к Prometheus через scrape_configs.

Доступные метрики

МетрикаТипОписание
ptl_controller_onlinegaugeКонтроллер онлайн (1) / оффлайн (0)
ptl_units_activegaugeАктивных PTL на контроллере
ptl_controllers_totalgaugeВсего контроллеров
ptl_button_events_totalcounterНажатий кнопок
ptl_bus_queue_lengthgaugeОчередь команд на шине
ptl_poll_cycle_duration_secondshistogramВремя цикла опроса
ptl_reconcile_cycle_duration_secondshistogramВремя цикла reconcile
modbus_requests_totalcounterModbus-запросов по операциям
modbus_request_duration_secondshistogramВремя Modbus-запросов
api_requests_totalcounterHTTP-запросов по method/path/status

Полный вывод

Нажмите "Загрузить"

Примеры запросов PromQL

ЗапросОписание
ptl_controller_onlineСтатус контроллеров
rate(api_requests_total[5m])RPS по эндпоинтам
rate(modbus_requests_total[5m])Modbus RPS
histogram_quantile(0.95, rate(modbus_request_duration_seconds_bucket[5m]))p95 Modbus latency
rate(ptl_button_events_total[5m])Частота нажатий кнопок
ptl_bus_queue_lengthДлина очереди шины

Параметры

В demo-режиме все операции работают через Redis без Modbus. Переключение требует перезапуска.
Как часто поллер читает состояния PTL с оборудования. Меньше = быстрее реакция на кнопки, больше нагрузка на шину.
Да = поллер читает только зажжённые PTL (экономит шину). Нет = читает все PTL в диапазоне.
Как часто reconciler проверяет расхождения между желаемым и фактическим состоянием PTL.
Максимальное время ожидания применения команды к оборудованию. При превышении API вернёт ошибку таймаута.

Контроллеры

IPПортАдреса PTLТип
Добавить контроллер

Webhooks

Глобальные webhooks срабатывают для событий на любом контроллере. Для настройки webhooks отдельного контроллера нажмите кнопку WH в таблице контроллеров выше.

Типы событий: button, task_confirmed, task_completed, task_timeout, task_cancelled, controller_offline, controller_online. Пустой список = все события.

Импорт / Экспорт

Конфигурация (JSON)

Загрузка...

HTTP API

HTTP API для управления PTL-индикаторами. Базовый адрес: http://<адрес>:8000. Тело запросов и ответов — application/json (кроме /_ping и /metrics).

Полная машинночитаемая спецификация — OpenAPI 3.0 (/openapi.yaml). Интерфейс не требует пароля: доступ ограничивайте сетью объекта.

Общие соглашения

  • Цвета задаются именами (Red, Green, Blue, Yellow, …); «погасить» — режим без цвета либо active: false.
  • У индикатора два состояния: желаемое (что запросил клиент) и фактическое (что применено к железу). Синхронный запрос ждёт применения не дольше apply_timeout секунд; фактическое состояние читается через /ptls.
  • Число на дисплее — 0–9999, суб-позиция — 0–99.
  • Ошибки возвращаются как {"detail": "…"} с кодами 400 / 404 / 500.

Методы и адреса

Служебные

МетодПутьОписание
GET/_pingПроверка доступности → текст pong
GET/versionВерсия продукта, вшитая при сборке
GET/metricsМетрики в формате Prometheus
GET/checkСводная диагностика сервиса и подключений

Контроллеры

МетодПутьОписание
GET/aliveСетевая доступность контроллеров (ping)
GET/controllersСписок контроллеров со статусом online/offline
PUT/controllers/{ip}Обновить контроллер
DELETE/controllers/{ip}Удалить контроллер
GET/controllers/{ip}/healthЗдоровье контроллера
GET/controllers/{ip}/units/{unit}/healthЗдоровье одного unit'а
GET/devices/{ip}/{unit}/infoРасширенная информация об устройстве (v2)
POST/assign_idsЗапуск/остановка назначения ID модулей
GET/assign_ids/statusСтатус назначения ID
POST/rebootПерезагрузить устройства по IP

PTL-индикаторы

МетодПутьОписание
POST/ptlsПрочитать фактическое состояние индикаторов
POST/bulk/ptlsПрочитать состояние с нескольких контроллеров
POST/turn_onВключить индикаторы контроллера
POST/turn_offВыключить индикаторы контроллера
GET/clearПогасить все индикаторы контроллера (?ip=)
POST/bulk/turn_onВключить на нескольких контроллерах
POST/bulk/turn_offВыключить на нескольких контроллерах
POST/bulk/clearПогасить на нескольких контроллерах
POST/applyПрименить декларативный снапшот (с sequence)

Сценарии

МетодПутьОписание
GET/scenarios/tasksСписок активных задач
POST/scenarios/tasksЗапустить задачу
GET/scenarios/tasks/historyИстория задач
GET/scenarios/tasks/{id}Статус задачи
DELETE/scenarios/tasks/{id}Отменить задачу
GET/scenarios/presetsСписок пресетов
POST/scenarios/presetsСоздать пресет
GET/scenarios/presets/{id}Получить пресет
PUT/scenarios/presets/{id}Обновить пресет
DELETE/scenarios/presets/{id}Удалить пресет
POST/scenarios/presets/{id}/runЗапустить пресет

Демо

МетодПутьОписание
GET/scenarios/demo/programsСписок доступных демо-программ
POST/scenarios/demo/runЗапустить демо-программу ({"program":"running_light"})
DELETE/scenarios/demo/{runID}Остановить демо-программу
POST/pressСимулировать нажатие кнопок (только demo)

Конфигурация

МетодПутьОписание
GET/configТекущая конфигурация сервиса
PUT/configИзменить конфигурацию (частично) и сохранить
POST/config/importИмпортировать конфигурацию целиком
POST/_restartПерезапустить сервис

События и аналитика

МетодПутьОписание
GET/eventsПоследние события (журнал Redis Stream)
GET/statsАналитика (активации, нажатия, цвета и т.д.)
DELETE/statsСбросить аналитику

В реальном времени

МетодПутьОписание
WS/ws/eventsWebSocket с трансляцией событий

Примеры запросов

Список контроллеров:
curl http://localhost:8000/controllers
Прочитать состояние индикатора №1:
curl -X POST http://localhost:8000/ptls \
  -H 'Content-Type: application/json' \
  -d '{"ip": "192.168.0.100", "ptl_ids": [1]}'
Включить индикатор (число 5, зелёный):
curl -X POST http://localhost:8000/turn_on \
  -H 'Content-Type: application/json' \
  -d '{"controller_ip": "192.168.0.100", "commands": [{"unit": 1, "number": 5, "sub": 1, "color": "Green"}]}'
Погасить все индикаторы контроллера:
curl "http://localhost:8000/clear?ip=192.168.0.100"
Декларативный снапшот (/apply):
curl -X POST http://localhost:8000/apply \
  -H 'Content-Type: application/json' \
  -d '{"controllers": [{"controller_ip": "192.168.0.100", "sequence": 1, "units": [{"unit": 1, "active": true, "number": 5, "color": "Green"}]}]}'
Пример ответа POST /ptls:
[
  {
    "unit": 1,
    "controller": "192.168.0.100",
    "state": "Activated",
    "color": "Green",
    "number": 5,
    "sub": 1,
    "fun_hold_counter": 0,
    "btn_led_pressed": false,
    "btn_fun_pressed": false,
    "btn_min_pressed": false,
    "btn_arrows_pressed": false
  }
]

WebSocket /ws/events

После подключения сервер присылает события по мере их появления: нажатия кнопок, подтверждения и завершения задач, изменения здоровья unit'ов. Сообщения от клиента игнорируются.

var ws = new WebSocket('ws://' + location.host + '/ws/events');
ws.onmessage = function (e) {
  var event = JSON.parse(e.data);
  console.log(event);
};

Сервис управления PTL индикаторами

Версия — Регистрация ПО Свидетельство о государственной регистрации программы для ЭВМ № 2025687159 Правообладатель ИП Краснов Владимир Андреевич (ИНН 781422796858) Документы Отказ от ответственностиЛицензионное соглашение Email support@whsoft.ru Сайт whsoft.ru