Piattaforma Home Assistant “MQTT Sensor”

La piattaforma “MQTT Sensor”, figlia del componente “Sensor” di Home Assistant, serve per definire in configurazione uno o più sensori alimentati da telemetrie MQTT provenienti da uno o più dispositivi presenti in domotica.

Esistono infatti sensori che, se interrogati tramite MQTT, erogano le proprie letture (temperatura, umidità, ma anche luminosità, presenza, livello di carica di batterie e molto altro) tramite i payload dei topic telemetrici dedicati a tal scopo. Inoltre, tali telemetrie solitamente vengono pubblicate automaticamente e ciclicamente via MQTT, permettendo a chi sottoscrive tali topic telemetrici di ottenere le letture man mano che arrivano.

Un esempio di topic telemetrico, nel caso di un Sonoff TH-16 o TH-10 aggiornato a Tasmota è il seguente:

tele/Sonoff/SENSOR

Tale topic restituisce tramite il proprio payload (o “carico utile”) le letture del sensore collegato all’unità, tipicamente temperatura e umidità, ad esempio (payload JSON):

{"temperature": 23.20,"humidity": 43.70}

Nb. Per utilizzare questa piattaforma è necessario che il componente “MQTT” di Home Assistant sia stato preventivamente configurato (vedi prima parte della scheda dedicata al componente “MQTT”). Si consiglia inoltre di leggere con attenzione la guida dedicata al tema della configurazione dei componenti MQTT nella propria domotica.

Configurazione

La configurazione base di un qualunque sensore MQTT presso il file configuration.yaml è piuttosto semplice.
È infatti sufficiente inserire un’entry di questo tipo:

mqtt:
  sensor:
  - name: "Sensor 1"
    state_topic: "home/bedroom/temperature"

dove l’esempio di “home/bedroom/temperature” sarà evidentemente il topic telemetrico del quale raccogliere il payload per l’estrazione dell’informazione di interesse.

Le variabili disponibili per la personalizzazione della configurazione sono le seguenti:

Esempi

LIVELLO DI BATTERIA

Il sensore dell’esempio a seguire estrae dal payload JSON ricevuto dallo state_topic indicato la misura della batteria residua del dispositivo monitorato. Nello specifico, ipotizziamo di stare utilizzando la piattaforma OWNTRACKS della famiglia di componenti “Device Tracker“, ovvero quelli dedicati al tracking GPS degli utenti configurati su Home Assistant.

Lo state_topic è il seguente:

owntracks/tablet/tablet

Il payload è simile al seguente

{"_type":"location","lon":7.21,"t":"u","batt":92,"tst":144995643,"tid":"ta","acc":27,"lat":46.12}

Per estrarre il livello della batteria (ovvero “92%”), il sensore MQTT configurato sarà:

mqtt:
  sensor:
  - name: "Battery Tablet"
    state_topic: "owntracks/tablet/tablet"
    unit_of_measurement: '%'
    value_template: "{{ value_json.batt }}"

Temperatura e umidità

Ipotizziamo di possedere un sensore di temperatura e umidità che dallo state_topic:

office/sensor1

produca nel payload una telemetria JSON come segue:

{"temperature": 23.20,"humidity": 43.70}

Configureremo dunque due diversi sensori, come segue:

mqtt:
  sensor:
  - name: "Temperature"
    state_topic: "office/sensor1"
    unit_of_measurement: '°C'
    value_template: "{{ value_json.temperature }}"
  - name: "Humidity"
    state_topic: "office/sensor1"
    unit_of_measurement: '%'
    value_template: "{{ value_json.humidity }}"