Référence MQTT

Topic de base

scalior-slc-{MAC}/

Où {MAC} est l'adresse MAC de l'appareil en minuscules sans séparateurs, ex. scalior-slc-aabbccddeeff/.

---

Topics maîtres (globaux pour tout l'escalier)

Préfixe : scalior-slc-{MAC}/M/

Topic	Direction	Valeurs	Description
M/Switch	pub / sub	0 / 1	Allumer/éteindre tout l'éclairage
M/Standby	pub / sub	0 / 1	Mode veille (éclairage nocturne)
M/Sensors	pub / sub	0 / 1	Activer/désactiver les capteurs de mouvement
M/Brightness	pub / sub	25–100	Luminosité (%)
M/UpperSens	pub	0 / 1	État des capteurs du haut
M/BottomSens	pub	0 / 1	État des capteurs du bas
M/Illuminance	pub	0–255	Valeur du capteur de lumière
M/LightSensorState	pub	0 / 1 / 2	État du capteur : 0=éteint, 1=clair, 2=sombre
M/Version	pub	chaîne	Version du firmware
M/Uptime	pub	nombre	Temps de fonctionnement (secondes)

---

Topics de volées

Préfixe : scalior-slc-{MAC}/{N}/, où {N} = 1–4.

Topic	Direction	Valeurs	Description
{N}/Switch	pub / sub	0 / 1	Allumer/éteindre la volée
{N}/Standby	pub / sub	0 / 1	Mode veille de la volée
{N}/Sensors	pub / sub	0 / 1	Capteurs de la volée
{N}/Brightness	pub / sub	25–100	Luminosité de la volée (%)
{N}/UpperSens	pub	0 / 1	Capteur du haut déclenché
{N}/BottomSens	pub	0 / 1	Capteur du bas déclenché

Les topics de volées ne sont disponibles que si le mode Topics maîtres uniquement n'est pas activé dans les paramètres MQTT.

---

Exemples de commandes

Allumer tout l'éclairage

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

Régler la luminosité de la volée 2 à 75%

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

Activer le mode veille

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

Désactiver les capteurs de la volée 1

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

---

Métadonnées (retained)

L'appareil publie des descriptions JSON de ses topics dans des messages retained :

scalior-slc-{MAC}/M/meta   → descriptions des topics maîtres
scalior-slc-{MAC}/{N}/meta → descriptions des topics de la volée N

---

Intégration Home Assistant

Exemple de configuration pour ajout automatique via MQTT Discovery ou ajout manuel :

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

---

Mode "Topics maîtres uniquement"

Si l'option Topics maîtres uniquement est activée dans les paramètres MQTT :

• Seuls les topics M/* sont publiés
• Les topics 1/* – 4/* ne sont pas utilisés
• Convient aux installations simples à une seule volée

---

Qualité de service (QoS)

Tous les messages sont publiés avec QoS 0. Le flag retained est défini pour les métadonnées et les topics de statut.