Довідник 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-прапор встановлено для метаданих та статусних топіків.