Integrare la gestione tapparelle di Tasmota a Home Assistant via MQTT

Scopi della guida: Integrare un attuatore dotato di firmware Tasmota e configurato per la gestione tapparelle all’HUB di domotica personale Home Assistant Livello di difficoltà: bassa Categoria d’integrazione: Local Push Concetti affrontati: Configurazione software	Componenti software utilizzate: Home Assistant Firmware Tasmota Componente Home Assistant “Cover“ Componente Home Assistant “MQTT“ Piattaforma Home Assistant “MQTT Cover“ Prerequisiti: Home Assistant configurato e funzionante Componente/i dotato di firmware Tasmota e già configurato opportunamente per il controllo di tapparelle elettriche (eg. Sonoff Dual R3) Dispositivi fisici utilizzati: Il computer sul quale è in esecuzione Home Assistant Il componente da integrare
GUIDA INDICATA A UTENTI CON ISTALLAZIONE:
NOTE E DISCLAIMER qualsiasi eventuale modifica agli impianti domestici dev'essere progettata e realizzata SOLO da personale qualificato; qualsiasi modifica non prevista attuata in proprio è a propria responsabilità personale nonché a proprio rischio e pericolo (i contenuti della presenta pagina hanno infatti puro scopo didattico) e fa decadere garanzia, omologazioni e certificazioni di qualità; dei dispositivi interessati; tutte le tecniche descritte si intendono applicate a software e firmware aggiornati alle ultime versioni disponibili; gli articoli di inDomus sono totalmente indipendenti e non sponsorizzati. Se mai questo cambiasse, verrà segnalato chiaramente sulle pagine oggetto di sponsorizzazione; questa pagina è materialmente scritta e manutenuta da più individui: non ci si aspetti né si pretenda un supporto personale. In caso di difficoltà, chiedere supporto alla community sul nostro forum o sulla nostra chat; se hai bisogno di orientarti, c'è la mappa.
Revisione guida: 1.3

Abstract

Una volta scelto un attuatore per gestione delle proprie tapparelle elettriche e provveduto, se necessario, alla riprogrammazione con firmware Tasmota e alla sua configurazione, va da sé il passo successivo più naturale  è quello di integrare tale componente al proprio HUB personale.

Nello specifico, questa guida si concentra sull’integrazione di uno o più componenti configurati allo scopo sopra descritto col l’HUB personale Home Assistant, utilizzando nello specifico il protocollo MQTT.

Assunti

Per l’implementazione della presente guida è necessario che sulla propria rete sia presente un broker MQTT; in primis però è importante capire come MQTT funzioni: per far questo, è importante la lettura di questa scheda scritta appositamente per capire il ruolo del broker MQTT all’interno della propria rete – a prescindere dai componenti che supportino MQTT presenti nel proprio ambiente.

Per dotarsi di  un broker e per attivare le funzioni client MQTT su Home Assistant (cosa necessaria) si rimanda a questa guida.

Si assume inoltre che il componente in questione siano già stato configurati fornendogli accesso alla propria rete Wi-Fi.

Cover

La prima cosa – fondamentale – da fare è quella di creare un’entità di tipo “Cover” (in inglese “copertura” – in questo caso intesa come tapparella). Per farlo, aggiungiamo alla configurazione di Home Assistant il seguente codice:

mqtt:
  cover:
  - name: "Sala"
    device_class: shade
    availability_topic: "tele/NOME-TASMOTA/LWT"
    payload_available: "Online"
    payload_not_available: "Offline"
    command_topic: "cmnd/NOME-TASMOTA/Backlog"
    payload_open: "ShutterOpen1"
    payload_close: "ShutterClose1"
    payload_stop: "ShutterStop1"
    set_position_topic: 'cmnd/NOME-TASMOTA/ShutterPosition1'
    position_topic: "stat/NOME-TASMOTA/RESULT"
    position_open: 100
    position_closed: 0
    position_template: >
      {% if ('Shutter1' in value_json) and ('Position' in value_json.Shutter1) %}
        {{ value_json.Shutter1.Position }}
      {% else %}
        {% if is_state('cover.sala', 'unknown') %}
          50
        {% else %}
          {{ state_attr('cover.sala','current_position') }}
        {% endif %}
      {% endif %}  
    retain: false
    optimistic: false
    qos: 1

Ovviamente il valore NOME-TASMOTA andrà personalizzato in base alla propria configurazione del dispositivo, presso la voce di menu dell’interfaccia web di Tasmota “Configuration” > “Configure MQTT“, alla voce “Topic“.

Imposteremo la devide_class a shade, per far sì che l’entità impersoni una tapparella; infine, imposteremo la QoS a 1, per aver maggior certezza che i comandi vengano eseguiti. Ovviamente, il name “Sala” (e poi di conseguenza la chiave “cover.sala“) è personalizzabile a piacere.

Announce

Quando si configurano dei componenti Tasmota via MQTT su Home Assistant è sempre consigliato di impostare un’automazione tale che, all’avvio di Home Assistant, faccia recepire all’HUB lo stato dei vari componenti sulla rete. Nel caso delle tapparelle la cosa è ancora più importante, dato che conoscere la posizione assoluta del sollevamento della tapparella all’avvio dell’HUB è piuttosto importante.

L’automazione è pertanto la seguente:

automation:
- alias: Tasmota Announce
  trigger:
  - event: start
    platform: homeassistant
  condition: []
  action:
  - action: mqtt.publish
    data:
      topic: cmnd/tasmotas/POWER
  - action: mqtt.publish
    data:
      topic: cmnd/tasmotas/SHUTTERPOSITION
      payload: “”

La prima action pubblica un topic MQTT (“cmnd/tasmotas/POWER“) che fa sì che tutti i dispositivi all’ascolto comunichino il proprio stato di accensione; la seconda chiede, nello specifico, la posizione delle tapparelle (“cmnd/tasmotas/SHUTTERPOSITION“) a tutti gli eventuali dispositivi configurati a tale scopo.

N.b. Si utilizza “tasmotas” in quanto topid di default per i GROUPTOPIC di Tasmota.

Terminata la configurazione, riavviare l’HUB.

Interfaccia

Al riavvio dell’HUB, una nuova entità sarà apparsa: cover.sala. 
Presso l’interfaccia dell’HUB l’entità apparirà più o meno me segue:

consentendo all’utente il pieno controllo della tapparella (nonché consultare le variazioni di stato attuate manualmente tramite eventuali pulsanti fisici collegati all’attuatore).