Skip to content

ups.md

Latest commit

 

History

History
95 lines (70 loc) · 4.75 KB

ups.md

File metadata and controls

95 lines (70 loc) · 4.75 KB
Raw

Модуль UPS

Подсистема UPS предназначена для мониторинга и управления встроенным источником бесперебойного питания контроллера.

Функционал доступен только на устройствах SLS Hub / Hub Max с установленным модулем UPS и автоматически определяется при запуске контроллера.

Как работает

Состояние UPS обновляется каждые 5 секунд.

При пропадании внешнего питания контроллер включает сервисную индикацию аварии питания. После восстановления питания индикация возвращается в обычный режим.

Уровень заряда батареи рассчитывается приблизительно по напряжению:

  • 3.0 V и ниже — 0%;
  • 4.1 V и выше — 100%;
  • между этими значениями используется линейная шкала.

Параметры состояния

Одинаковые имена параметров используются в Lua и MQTT JSON.

Параметр Тип Единица Описание
available BOOL — UPS был обнаружен при запуске контроллера
external_power BOOL — Наличие внешнего питания
voltage_input FLOAT V Входное напряжение
voltage_battery FLOAT V Напряжение батареи
battery INT % Расчётный уровень заряда батареи
temperature FLOAT °C Температура по NTC-датчику контроллера
current_charge FLOAT A Ток заряда батареи
charge_status INT — Код состояния зарядки
charge_state STR — Текстовое состояние зарядки
charging BOOL — Выполняется предварительная или быстрая зарядка
charger_enabled BOOL — Зарядное устройство включено
ups_enabled BOOL — Питание от батареи разрешено

Состояния зарядки

charge_status charge_state Описание
0 not_charging Зарядка не выполняется
1 pre_charge Предварительная зарядка
2 fast_charge Быстрая зарядка
3 charge_done Зарядка завершена

Для неизвестного кода поле charge_state содержит unknown.

Web-интерфейс

Страница UPS доступна по адресу /ups, если контроллер был обнаружен при запуске.

На странице отображаются:

  • наличие внешнего питания;
  • входное напряжение;
  • напряжение и расчётный уровень заряда батареи;
  • температура;
  • ток и состояние зарядки;
  • состояние зарядного устройства и питания от батареи.

На этой же странице можно включить или отключить зарядное устройство и питание от батареи.

::: warning Внимание Отключение UPS запрещает питание контроллера от батареи. При отсутствии внешнего питания это может привести к немедленному выключению устройства. :::

MQTT

При активном подключении к MQTT состояние публикуется каждые 5 секунд в топик:

<MQTT prefix>/ups

Сообщение отправляется с флагом retain и содержит один JSON-объект:

{
  "available": true,
  "external_power": true,
  "voltage_input": 5.1,
  "voltage_battery": 4.02,
  "battery": 92,
  "temperature": 27.4,
  "current_charge": 0.35,
  "charge_status": 2,
  "charge_state": "fast_charge",
  "charging": true,
  "charger_enabled": true,
  "ups_enabled": true
}

Если UPS не был обнаружен, топик состояния не публикуется. При ошибке очередного чтения контроллера в MQTT-брокере остаётся последний retained-пакет.