Aggiungere i sensori del Broadlink A1 e-Air a Home Assistant

Scopi della guida: Aggiungere dei sensori del Broadlink A1 e-Air alla configurazione di Home Assistant Livello di difficoltà: basso Categoria d’integrazione: Local Polling Concetti affrontati: Configurazione software	Componenti software utilizzate: Home Assistant Componente Home Assistant “Broadlink“ Prerequisiti: Home Assistant configurato e funzionante Un Broadlink A1 e-Air già configurato in rete tramite la sua applicazione Broadlink e-Control Dispositivi fisici utilizzati: Il computer sul quale è in esecuzione Home Assistant Un Broadlink A1 e-Air
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.1

Abstract

Il “Broadlink A1 e-Air” è un dispositivo molto semplice, a basso consumo, utile per introdurre nella propria domotica cinque sensori in un colpo solo. Questi sensori (temperatura, umidità relativa, luminosità dell’ambiente, livello di rumore, qualità dell’aria) possono essere censiti tramite l’applicazione Broadlink e-Control ma possono anche essere configurati presso la configurazione di Home Assistant, diventando così a pieno titolo sue entità.

In questa guida vedremo quindi come aggiungere questi sensori alla configurazione di Home Assistant.

Configurazione di base

Per introdurre in configurazione i cinque sensori forniti dall’A1 è necessario disporre, a monte, del suo indirizzo IP (fisso – leggi qui come impostarlo) e del suo indirizzo MAC (disponibile sull’app e-Control di Broadlink usata per configurare il dispositivo sulla propra Wi-Fi.

Ottenute queste informazioni, il blocco di configurazione da aggiungere al configuration.yaml di Home Assistant è il seguente:

sensor:
  - platform: broadlink
    update_interval: 60
    host: IP_ADDRESS
    mac: 'MAC_ADDRESS'
    monitored_conditions:
      - temperature
      - humidity
      - air_quality
      - light
      - noise

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

L’introduzione di tali sensori genererà delle entità che sul frontend appariranno come di seguito (qui raggruppati per comodità):

Personalizzazione dei sensori

Come si nota nell’immagine sopra, due sensori sono intelleggibili (temperatura e umidità relativa) mentre i restanti tre indicano dei valori interi (0, 3, 1) che poco aiutano nel capire lo stato dei sensori.

Per ovviare a questo problema creeremo altrettanti sensori sfruttando la piattaforma “Template Sensor” di Home Assistant, mappando di fatto i valori numerici come segue:

La configurazione da aggiungere è la seguente:

  - platform: template
      air_quality:
        friendly_name: "Air Quality"
        value_template: >-
          {% if states('sensor.broadlink_sensor_air_quality') | int(default=0) == 0 %}
            Excellent
          {% elif states('sensor.broadlink_sensor_air_quality') | int(default=0) == 1 %}
            Good
          {% elif states('sensor.broadlink_sensor_air_quality') | int(default=0) == 2 %}
            Normal
          {% elif states('sensor.broadlink_sensor_air_quality') | int(default=0) == 3 %}
            Bad
          {% else %}
            -unknown-
          {% endif %
      brightness:
        friendly_name: "Brightness"
        value_template: >-
          {% if states('sensor.broadlink_sensor_light') | int(default=0) == 0 %}
            Dark
          {% elif states('sensor.broadlink_sensor_light') | int(default=0) == 1 %}
            Dim
          {% elif states('sensor.broadlink_sensor_light') | int(default=0) == 2 %}
            Normal
          {% elif states('sensor.broadlink_sensor_light') | int(default=0) == 3 %}
            Bright
          {% else %}
            -unknown-
          {% endif %}
      noise:
        friendly_name: "Noise"
        value_template: >-
          {% if states('sensor.broadlink_sensor_noise') | int(default=0) == 0 %}
            Quiet
          {% elif states('sensor.broadlink_sensor_noise') | int(default=0) == 1 %}
            Normal
          {% elif states('sensor.broadlink_sensor_noise') | int(default=0) == 2 %}
            Noisy
          {% else %}
            -unknown-
          {% endif %}

Tale configurazione, presso il l’interfaccia dell’HUB, genera entità di tipo sensore che riportano informazioni di questo tipo: