MQTT-referencia

Alaptéma

scalior-slc-{MAC}/

Ahol {MAC} az eszköz MAC-csíme kisbetűvel, elválasztók nélkül, pl. scalior-slc-aabbccddeeff/.

---

Mester-témák (az egész lépcsőre globálisak)

Előtag: scalior-slc-{MAC}/M/

Téma	Irány	Értékek	Leírás
M/Switch	pub / sub	0 / 1	Az összes megvilágítás be-/kikapcsolása
M/Standby	pub / sub	0 / 1	Készenléti mód (éjszakai megvilágítás)
M/Sensors	pub / sub	0 / 1	Mozgásérzékelők engedélyezése/letiltása
M/Brightness	pub / sub	25–100	Fényerő (%)
M/UpperSens	pub	0 / 1	Felső érzékelők állapota
M/BottomSens	pub	0 / 1	Alsó érzékelők állapota
M/Illuminance	pub	0–255	Fényérzékelő leolvasása
M/LightSensorState	pub	0 / 1 / 2	Érzékelő állapota: 0=ki, 1=világos, 2=sötét
M/Version	pub	karakterlánc	Firmware-verzió
M/Uptime	pub	szám	Üzemidő (másodpercek)

---

Kar-témák

Előtag: scalior-slc-{MAC}/{N}/, ahol {N} = 1–4.

Téma	Irány	Értékek	Leírás
{N}/Switch	pub / sub	0 / 1	Kar be-/kikapcsolása
{N}/Standby	pub / sub	0 / 1	Kar készenléti módja
{N}/Sensors	pub / sub	0 / 1	Kar érzékelői
{N}/Brightness	pub / sub	25–100	Kar fényereje (%)
{N}/UpperSens	pub	0 / 1	Felső érzékelő aktiválódott
{N}/BottomSens	pub	0 / 1	Alsó érzékelő aktiválódott

A kar-témák csak akkor érhetők el, ha a Csak mester-témák mód nem engedélyezett az MQTT-beállításokban.

---

Parancsok példái

Az összes megvilágítás bekapcsolása

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

2. kar fényerejének 75%-ra állítása

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

Készenléti mód engedélyezése

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

1. kar érzékelőinek letiltása

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

---

Metaadatok (retained)

Az eszköz JSON-leírásokat tesz közzé témáiról retained üzenetekben:

scalior-slc-{MAC}/M/meta   → mester-témák leírásai
scalior-slc-{MAC}/{N}/meta → N. kar témáinak leírásai

---

Home Assistant integráció

Példakonfiguráció automatikus hozzáadáshoz MQTT Discovery-n keresztül vagy manuális hozzáadáshoz:

# configuration.yaml
mqtt:
  light:
    - name: "Lépcső"
      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: "Lépcsővilágítás"
      state_topic: "scalior-slc-aabbccddeeff/M/Illuminance"
      unit_of_measurement: "lx"

---

"Csak mester-témák" mód

Ha az Csak mester-témák lehetőség engedélyezve van az MQTT-beállításokban:

• Csak M/* témák kerülnek közzétételre
• 1/* – 4/* témák nem kerülnek felhasználásra
• Egyszerű egykaros telepítésekhez alkalmas

---

Szolgáltatás minősége (QoS)

Az összes üzenet QoS 0-val kerül közzétételre. A retained jelző metaadatokhoz és állapot-témákhoz van beállítva.