Referenca MQTT

Osnovna tema

scalior-slc-{MAC}/

Kjer je {MAC} MAC naslov naprave v mali črki brez ločil, npr. scalior-slc-aabbccddeeff/.

---

Glavne teme (globalne za celotno stopnišče)

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

Tema	Smer	Vrednosti	Opis
M/Switch	pub / sub	0 / 1	Vklop/izklop vse razsvetljave
M/Standby	pub / sub	0 / 1	Način pripravljenosti (nočna osvetlitev)
M/Sensors	pub / sub	0 / 1	Omogoči/onemogoči senzorje gibanja
M/Brightness	pub / sub	25–100	Svetlost (%)
M/UpperSens	pub	0 / 1	Stanje zgornjega senzorja
M/BottomSens	pub	0 / 1	Stanje spodnjega senzorja
M/Illuminance	pub	0–255	Odčitek svetlobnega senzorja
M/LightSensorState	pub	0 / 1 / 2	Stanje senzorja: 0=izklop, 1=svetlo, 2=temno
M/Version	pub	niz	Različica vdelane programske opreme
M/Uptime	pub	število	Čas delovanja (sekunde)

---

Teme odsekov

Predpona: scalior-slc-{MAC}/{N}/, kjer je {N} = 1–4.

Tema	Smer	Vrednosti	Opis
{N}/Switch	pub / sub	0 / 1	Vklop/izklop odseka
{N}/Standby	pub / sub	0 / 1	Način pripravljenosti odseka
{N}/Sensors	pub / sub	0 / 1	Senzorji odseka
{N}/Brightness	pub / sub	25–100	Svetlost odseka (%)
{N}/UpperSens	pub	0 / 1	Sprožen zgornji senzor
{N}/BottomSens	pub	0 / 1	Sprožen spodnji senzor

Teme odsekov so na voljo samo, če način Samo glavne teme v nastavitvah MQTT ni omogočen.

---

Primeri ukazov

Vklop vse razsvetljave

Tema:    scalior-slc-aabbccddeeff/M/Switch
Vsebina: 1

Nastavitev svetlosti odseka 2 na 75%

Tema:    scalior-slc-aabbccddeeff/2/Brightness
Vsebina: 75

Omogočanje načina pripravljenosti

Tema:    scalior-slc-aabbccddeeff/M/Standby
Vsebina: 1

Onemogočanje senzorjev za odsek 1

Tema:    scalior-slc-aabbccddeeff/1/Sensors
Vsebina: 0

---

Metapodatki (zadrž.)

Naprava objavlja opise JSON svojih tem v zadržanih sporočilih:

scalior-slc-{MAC}/M/meta   → opisi glavnih tem
scalior-slc-{MAC}/{N}/meta → opisi tem odseka N

---

Integracija z Home Assistant

Primer konfiguracije za samodejno dodajanje prek MQTT Discovery ali ročno dodajanje:

# configuration.yaml
mqtt:
  light:
    - name: "Stopnišče"
      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: "Osvetljenost stopnišča"
      state_topic: "scalior-slc-aabbccddeeff/M/Illuminance"
      unit_of_measurement: "lx"

---

Način "Samo glavne teme"

Če je v nastavitvah MQTT omogočena možnost Samo glavne teme:

• Objavljajo se samo teme M/*
• Teme 1/* – 4/* se ne uporabljajo
• Primerno za preproste enoodsečne namestitve

---

Kakovost storitve (QoS)

Vsa sporočila se objavljajo z QoS 0. Zastavica zadrž. je nastavljena za teme metapodatkov in stanja.