Dokumentacja MQTT

Temat bazowy

scalior-slc-{MAC}/

Gdzie {MAC} to adres MAC urządzenia małymi literami bez separatorów, np. scalior-slc-aabbccddeeff/.

---

Tematy master (globalne dla całych schodów)

Prefiks: scalior-slc-{MAC}/M/

Temat	Kierunek	Wartości	Opis
M/Switch	pub / sub	0 / 1	Włącz/wyłącz całe oświetlenie
M/Standby	pub / sub	0 / 1	Tryb czuwania (oświetlenie nocne)
M/Sensors	pub / sub	0 / 1	Włącz/wyłącz czujniki ruchu
M/Brightness	pub / sub	25–100	Jasność (%)
M/UpperSens	pub	0 / 1	Stan czujników górnych
M/BottomSens	pub	0 / 1	Stan czujników dolnych
M/Illuminance	pub	0–255	Odczyt czujnika światła
M/LightSensorState	pub	0 / 1 / 2	Stan czujnika: 0=wyłącz, 1=jasno, 2=ciemno
M/Version	pub	ciąg	Wersja firmware
M/Uptime	pub	liczba	Czas działania (sekundy)

---

Tematy biegów

Prefiks: scalior-slc-{MAC}/{N}/, gdzie {N} = 1–4.

Temat	Kierunek	Wartości	Opis
{N}/Switch	pub / sub	0 / 1	Włącz/wyłącz bieg
{N}/Standby	pub / sub	0 / 1	Tryb czuwania biegu
{N}/Sensors	pub / sub	0 / 1	Czujniki biegu
{N}/Brightness	pub / sub	25–100	Jasność biegu (%)
{N}/UpperSens	pub	0 / 1	Czujnik górny wyzwolony
{N}/BottomSens	pub	0 / 1	Czujnik dolny wyzwolony

Tematy biegów są dostępne tylko jeśli tryb Tylko tematy master nie jest włączony w ustawieniach MQTT.

---

Przykłady poleceń

Włącz całe oświetlenie

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

Ustaw jasność biegu 2 na 75%

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

Włącz tryb czuwania

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

Wyłącz czujniki biegu 1

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

---

Metadane (retained)

Urządzenie publikuje opisy JSON swoich tematów w wiadomościach retained:

scalior-slc-{MAC}/M/meta   → opisy tematów master
scalior-slc-{MAC}/{N}/meta → opisy tematów biegu N

---

Integracja z Home Assistant

Przykładowa konfiguracja do automatycznego dodawania przez MQTT Discovery lub ręcznego dodawania:

# configuration.yaml
mqtt:
  light:
    - name: "Schody"
      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: "Oświetlenie schodów"
      state_topic: "scalior-slc-aabbccddeeff/M/Illuminance"
      unit_of_measurement: "lx"

---

Tryb "Tylko tematy master"

Jeśli opcja Tylko tematy master jest włączona w ustawieniach MQTT:

• Publikowane są tylko tematy M/*
• Tematy 1/* – 4/* nie są używane
• Odpowiednie dla prostych instalacji z jednym biegiem

---

Jakość usługi (QoS)

Wszystkie wiadomości są publikowane z QoS 0. Flaga retained jest ustawiona dla metadanych i tematów statusu.