Integrare una testa termostatica Eqiva eQ-3 Bluetooth a Home Assistant

SCOPI DELLA GUIDA: Integrare una testa/e termostatica Eqiva eQ-3 Bluetooth alla configurazione Home Assistant Livello di difficoltà: basso Categoria d’integrazione: Local Polling CONCETTI AFFRONTATI: Utilizzo e configurazione software COMPONENTI SOFTWARE UTILIZZATE: Home Assistant Piattaforma Home Assistant “EQ3 Bluetooth Smart Thermostats“	PREREQUISITI: Home Assistant configurato e funzionante DISPOSITIVI FISICI UTILIZZATI: Il computer sul quale è in esecuzione Home Assistant Una (o più) teste termostatiche Eqiva eQ-3 Bluetooth Uno (o più) smartphone
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: 2.3

Abstract

Le “Eqiva eQ-3 Bluetooth” sono teste termostatiche per la regolazione domotica dei termosifoni dotate, per l’interfacciamento, di supporto bluetooth. Molto economiche, risultano essere altrettanto efficaci nella loro operatività: già di per sé funzionali se controllate tramite la loro app dedicata fornita dal produttore, danno il loro meglio se integrate alla propria domotica personale basata su Home Assistant.

A tale scopo, il noto HUB personale mette a disposizione una piattaforma ad hoc chiamata “EQ3 Bluetooth Smart Thermostats“.

Indirizzo MAC

Per integrare la/le testa/e, è necessario scoprire l’indirizzo MAC bluetooth dell’attuatore/i.
Per scoprire tale indirizzo, è necessario – prima di cercarlo – provvedere alla completa configurazione della testa (sia montaggio che prima configurazione tramite app).

Fatto ciò si utilizzerà un tool software per effettuare uno scan dell’ambiente alla ricerca del MAC address della testa che ci interessa

L’uso di tale tool è descritto in questa breve guida:

Utilità: elencare indirizzi fisici (MAC address) Bluetooth tramite Raspberry Pi OS (o su Linux, più genericamente)

In alternativa si possono utilizzare tool come:

• gli utenti Apple macOS possono utilizzare tool come Bluetooth Explorer;
• gli utenti Apple iOS possono utilizzare l’app (per iPhone/iPad) nRF Connect;
• gli utenti Google Android possono utilizzare l’app Bluetooth LE Scanner;

Integrazione

A questo punto è possibile configurare l’integrazione tra la piattaforma eQ-3 e Home Assistant.
La configurazione base della piattaforma presso il file configuration.yaml è piuttosto semplice.

Sarà infatti sufficiente inserire un’entry di questo tipo:

# Esempio di configurazione
climate:
  - platform: eq3btsmart
    devices:
      termosifone_bagno:
        mac: '00:11:22:33:44:55'
      termosifone_sala:
        mac: '11:22:33:44:55:66'

Provvedere ora al riavvio di Home Assistant.

Nel caso dell’esempio sopra, la configurazione genererà due entità di tipo Climate così chiamate:

• climate.termosifone_bagno
• climate.termosifone_sala

N.b. il corretto funzionamento della piattaforma è subordinato alla raggiungibilità radio dell’attuatore da parte dell’antenna Bluetooth del computer sul quale è in esecuzione Home Assistant.

Rappresentazione e servizi

L’entità di tipo “Climate” verrà rappresentata come un qualunque termostato integrato a Home Assistant:

Unico handicap di questa piattaforma (la quale, per il resto, funzione egregiamente) è l’assenza della rilevazione della temperatura nel quale è calata la testa/e: il parametro fornito a Home Assistant corrisponde al valore di temperatura target in uso. Non si tratta di un limite della piattaforma, è proprio un limite hardware dell’attuatore.

DASHBOARDS

L’interfaccia dell’HUB prevede una “card” apposita per i sistemi clima. Configurando l’entità “Climate” associata a una testa eQ-3, l’aspetto grafico apparirà come segue:

Servizi

Per quanto riguarda i servizi (utilizzabili anche in ambito automazione) è sufficiente far riferimento alla lista di quelli relativi al componente padre della piattaforma, ovvero “Climate“.