MQTT-Referenz

Basis-Topic

scalior-slc-{MAC}/

Wobei {MAC} die MAC-Adresse des Geräts in Kleinbuchstaben ohne Trennzeichen ist, z. B. scalior-slc-aabbccddeeff/.

---

Master-Topics (global für die gesamte Treppe)

Präfix: scalior-slc-{MAC}/M/

Topic	Richtung	Werte	Beschreibung
M/Switch	pub / sub	0 / 1	Gesamtbeleuchtung ein/aus
M/Standby	pub / sub	0 / 1	Bereitschaftsmodus (Nachtbeleuchtung)
M/Sensors	pub / sub	0 / 1	Bewegungssensoren aktivieren/deaktivieren
M/Brightness	pub / sub	25–100	Helligkeit (%)
M/UpperSens	pub	0 / 1	Status der oberen Sensoren
M/BottomSens	pub	0 / 1	Status der unteren Sensoren
M/Illuminance	pub	0–255	Lichtsensorwert
M/LightSensorState	pub	0 / 1 / 2	Sensorstatus: 0=aus, 1=hell, 2=dunkel
M/Version	pub	Zeichenkette	Firmware-Version
M/Uptime	pub	Zahl	Betriebszeit (Sekunden)

---

Abschnitts-Topics

Präfix: scalior-slc-{MAC}/{N}/, wobei {N} = 1–4.

Topic	Richtung	Werte	Beschreibung
{N}/Switch	pub / sub	0 / 1	Abschnitt ein/aus
{N}/Standby	pub / sub	0 / 1	Bereitschaftsmodus des Abschnitts
{N}/Sensors	pub / sub	0 / 1	Sensoren des Abschnitts
{N}/Brightness	pub / sub	25–100	Helligkeit des Abschnitts (%)
{N}/UpperSens	pub	0 / 1	Oberer Sensor ausgelöst
{N}/BottomSens	pub	0 / 1	Unterer Sensor ausgelöst

Abschnitts-Topics sind nur verfügbar, wenn der Nur Master-Topics-Modus in den MQTT-Einstellungen nicht aktiviert ist.

---

Befehlsbeispiele

Gesamtbeleuchtung einschalten

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

Helligkeit von Abschnitt 2 auf 75% setzen

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

Bereitschaftsmodus aktivieren

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

Sensoren von Abschnitt 1 deaktivieren

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

---

Metadaten (retained)

Das Gerät veröffentlicht JSON-Beschreibungen seiner Topics in Retained-Nachrichten:

scalior-slc-{MAC}/M/meta   → Master-Topic-Beschreibungen
scalior-slc-{MAC}/{N}/meta → Topic-Beschreibungen für Abschnitt N

---

Home Assistant Integration

Beispielkonfiguration für automatisches Hinzufügen via MQTT Discovery oder manuelles Hinzufügen:

# configuration.yaml
mqtt:
  light:
    - name: "Treppe"
      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: "Treppenbeleuchtung"
      state_topic: "scalior-slc-aabbccddeeff/M/Illuminance"
      unit_of_measurement: "lx"

---

Modus "Nur Master-Topics"

Wenn die Option Nur Master-Topics in den MQTT-Einstellungen aktiviert ist:

• Es werden nur M/*-Topics veröffentlicht
• 1/* – 4/*-Topics werden nicht verwendet
• Geeignet für einfache Einzelabschnitt-Installationen

---

Dienstqualität (QoS)

Alle Nachrichten werden mit QoS 0 veröffentlicht. Das Retained-Flag ist für Metadaten und Status-Topics gesetzt.