Aggiungere un interruttore MQTT alla configurazione Home Assistant

Abstract

Home Assistant fornisce sin dalle prime versioni un supporto nativo al protocollo MQTT tramite un componente chiamato, per l’appunto, “MQTT“. In caso si possegga un interruttore intelligente dotato di supporto MQTT (eg. un Sonoff riprogrammato Sonoff-Tasmota), è possibile integrarne il controllo in modo molto semplice su Home Assistant.

In questa pagina vedremo come farlo utilizzando il componente “Switch” di Home Assistant, nello specifico la piattaforma (sott-componente) “MQTT Switch”.

Affinché la configurazione che ci apprestiamo a realizzare funzioni, è necessario che il componente MQTT di Home Assistant sia già configurato.

Si consiglia caldamente, prima di prendere visione della presente guida, di leggere la guida “Come aggiungere interruttori e sensori Sonoff a Home Assistant“.

Installazione

Non c’è bisogno di installare nulla: è sufficiente aggiungere alla configurazione di Home Assistant la voce relativa all’interruttore che si vuole aggiungere.

Configurazione

Vediamo quindi come farlo.
Il set minimale di configurazione da aggiungere al file “configuration.yaml” di Home Assistant è il seguente:

switch:
  - platform: mqtt
    name: "Ventilatore",
    command_topic: "cmnd/Ventilatore/POWER"

Una volta salvata la configurazione e rilanciato/aggiornato Home Assistant, apparirà (come da configurazione d’esempio) un nuovo switch:

Variabili di configurazione:

Alla luce di questi parametri, uno switch tipo appare nella configurazione come segue:

switch:
  - platform: mqtt
    name: "Ventilatore"
    state_topic: "stat/Ventilatore/POWER"
    command_topic: "cmnd/Ventilatore/POWER"
    availability_topic: "tele/Ventilatore/LWT"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    payload_available: "Online"
    payload_not_available: "Offline"
    retain: false

NOTA

È possibile integrare lo stesso tipo di configurazione non solo per introdurre su Home Assistant degli interruttori ma anche delle luci. Poniamo il caso in cui si stia utilizzando un Sonoff Basic (modificato Tasmota) come interruttore di una abat jour: sulla domotica definita su Home Assistant vorremo che tale interruttore appaia come punto luce, piuttosto che come interruttore. Il blocco di configurazione sarà il medesimo sopra descritto, ma indicato alla voce “light:“:

light:
  - platform: mqtt
    name: "Abat Jour"
    state_topic: "stat/AbatJour/POWER"
    command_topic: "cmnd/AbatJour/POWER"
    availability_topic: "tele/AbatJour/LWT"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    payload_available: "Online"
    payload_not_available: "Offline"
    retain: false

Censimento dello stato all’avvio di Home Assistant

All’avvio di Home Assistant tale ambiente non conosce lo stato degli switch MQTT eventualmente inclusi in configurazione. Per far sì che tale stato venga rilevato immediatamente è necessario inserire in configurazione  un automatismo che pubblichi sul broker un topic di interrogazione telemetrico verso lo/gli switch da aggiornare:

automation:
  alias: "Censimento stati MQTT"
  trigger:
    platform: homeassistant
    event: start
  condition: []
  action:
    service: mqtt.publish
    data:
      topic: "cmnd/Ventilatore/POWER"
      payload: ""
      retain: false

Sotto il blocco “action:” sarà possibile indicate quali topic MQTT indicare (in questo caso “cmnd/Ventilatore/POWER”) al fine di forzare una risposta da parte dei componenti MQTT per ottenerne ottenerne lo stato.

Come aggiungere interruttori e sensori Sonoff a Home Assistant

ATTENZIONE: ricorda che sul nostro community FORUM c'è una sezione ad hoc dedica ai Sonoff, per qualsiasi dubbio, domanda, informazione nel merito specifico di queste componenti.