Reference MQTT

Základní téma

scalior-slc-{MAC}/

Kde {MAC} je MAC adresa zařízení malými písmeny bez oddělovačů, např. scalior-slc-aabbccddeeff/.

---

Master témata (globální pro celé schodiště)

Předpona: scalior-slc-{MAC}/M/

Téma	Směr	Hodnoty	Popis
M/Switch	pub / sub	0 / 1	Zapnutí/vypnutí celého osvětlení
M/Standby	pub / sub	0 / 1	Pohotovostní režim (noční osvětlení)
M/Sensors	pub / sub	0 / 1	Zapnutí/vypnutí pohybových senzorů
M/Brightness	pub / sub	25–100	Jas (%)
M/UpperSens	pub	0 / 1	Stav horních senzorů
M/BottomSens	pub	0 / 1	Stav dolních senzorů
M/Illuminance	pub	0–255	Hodnota světelného senzoru
M/LightSensorState	pub	0 / 1 / 2	Stav senzoru: 0=vyp, 1=světlo, 2=tma
M/Version	pub	řetězec	Verze firmwaru
M/Uptime	pub	číslo	Doba provozu (sekundy)

---

Témata ramen

Předpona: scalior-slc-{MAC}/{N}/, kde {N} = 1–4.

Téma	Směr	Hodnoty	Popis
{N}/Switch	pub / sub	0 / 1	Zapnutí/vypnutí ramene
{N}/Standby	pub / sub	0 / 1	Pohotovostní režim ramene
{N}/Sensors	pub / sub	0 / 1	Senzory ramene
{N}/Brightness	pub / sub	25–100	Jas ramene (%)
{N}/UpperSens	pub	0 / 1	Horní senzor spuštěn
{N}/BottomSens	pub	0 / 1	Dolní senzor spuštěn

Témata ramen jsou dostupná pouze pokud režim Pouze master témata není v nastavení MQTT zapnutý.

---

Příklady příkazů

Zapnout celé osvětlení

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

Nastavit jas ramene 2 na 75%

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

Zapnout pohotovostní režim

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

Vypnout senzory ramene 1

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

---

Metadata (retained)

Zařízení publikuje JSON popisy svých témat v retained zprávách:

scalior-slc-{MAC}/M/meta   → popisy master témat
scalior-slc-{MAC}/{N}/meta → popisy témat ramene N

---

Integrace s Home Assistant

Příklad konfigurace pro automatické přidání přes MQTT Discovery nebo ruční přidání:

# configuration.yaml
mqtt:
  light:
    - name: "Schodiště"
      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: "Osvětlení schodiště"
      state_topic: "scalior-slc-aabbccddeeff/M/Illuminance"
      unit_of_measurement: "lx"

---

Režim "Pouze master témata"

Pokud je v nastavení MQTT zapnuta možnost Pouze master témata:

• Publikují se pouze témata M/*
• Témata 1/* – 4/* se nepoužívají
• Vhodné pro jednoduché instalace s jedním ramenem

---

Kvalita služby (QoS)

Všechny zprávy se publikují s QoS 0. Příznak retained je nastaven pro metadata a stavová témata.