Справочник MQTT

Базовый топик

scalior-slc-{MAC}/

Где {MAC} — MAC-адрес устройства в нижнем регистре без разделителей, например scalior-slc-aabbccddeeff/.

---

Мастер-топики (общие для всей лестницы)

Префикс: scalior-slc-{MAC}/M/

Топик	Направление	Значения	Описание
M/Switch	pub / sub	0 / 1	Включение/выключение всей подсветки
M/Standby	pub / sub	0 / 1	Режим ожидания (ночная подсветка)
M/Sensors	pub / sub	0 / 1	Включение/выключение датчиков движения
M/Brightness	pub / sub	25–100	Яркость (%)
M/UpperSens	pub	0 / 1	Состояние верхних датчиков
M/BottomSens	pub	0 / 1	Состояние нижних датчиков
M/Illuminance	pub	0–255	Показания датчика освещённости
M/LightSensorState	pub	0 / 1 / 2	Состояние датчика: 0=откл, 1=светло, 2=темно
M/Version	pub	строка	Версия прошивки
M/Uptime	pub	число	Время работы (секунды)

---

Топики пролётов

Префикс: scalior-slc-{MAC}/{N}/, где {N} = 1–4.

Топик	Направление	Значения	Описание
{N}/Switch	pub / sub	0 / 1	Включение/выключение пролёта
{N}/Standby	pub / sub	0 / 1	Режим ожидания пролёта
{N}/Sensors	pub / sub	0 / 1	Датчики пролёта
{N}/Brightness	pub / sub	25–100	Яркость пролёта (%)
{N}/UpperSens	pub	0 / 1	Датчик сверху сработал
{N}/BottomSens	pub	0 / 1	Датчик снизу сработал

Топики пролётов доступны только если в настройках MQTT не включён режим «Только мастер-топики».

---

Примеры команд

Включить всю подсветку

Topic:   scalior-slc-aabbccddeeff/M/Switch
Payload: 1

Установить яркость пролёта 2 на 75%

Topic:   scalior-slc-aabbccddeeff/2/Brightness
Payload: 75

Включить режим ожидания

Topic:   scalior-slc-aabbccddeeff/M/Standby
Payload: 1

Отключить датчики пролёта 1

Topic:   scalior-slc-aabbccddeeff/1/Sensors
Payload: 0

---

Метаданные (retained)

Устройство публикует JSON-описание своих топиков в retained-сообщениях:

scalior-slc-{MAC}/M/meta   → описание мастер-топиков
scalior-slc-{MAC}/{N}/meta → описание топиков пролёта N

---

Интеграция с Home Assistant

Пример конфигурации для автоматического добавления через MQTT Discovery или ручного добавления:

# configuration.yaml
mqtt:
  light:
    - name: "Лестница"
      state_topic: "scalior-slc-aabbccddeeff/M/Switch"
      command_topic: "scalior-slc-aabbccddeeff/M/Switch"
      brightness_state_topic: "scalior-slc-aabbccddeeff/M/Brightness"
      brightness_command_topic: "scalior-slc-aabbccddeeff/M/Brightness"
      brightness_scale: 100
      payload_on: "1"
      payload_off: "0"

  sensor:
    - name: "Освещённость лестница"
      state_topic: "scalior-slc-aabbccddeeff/M/Illuminance"
      unit_of_measurement: "lx"

---

Режим «Только мастер-топики»

Если в настройках MQTT включена опция Только мастер-топики:

• Публикуются только топики M/*
• Топики 1/* – 4/* не используются
• Подходит для простых инсталляций с одним пролётом

---

Качество сервиса (QoS)

Все сообщения публикуются с QoS 0. Retained-флаг установлен для метаданных и статусных топиков.