Integrare ConBee/RaspBee con Home Assistant (HASSIO) via deCONZ

6 minuti di lettura
SCOPI DELLA GUIDA:
  • Integrare un BRIDGE/Gateway ZigBee↔︎TCP/IP ConBee/RaspBee con Home Assistant (distribuzione HASSIO) tramite l’adozione della sua controparte software deCONZ. Tale integrazione consente di integrare componenti ZigBee di diversi produttori a Home Assistant.
  • Livello di difficoltà: medio/basso
CONCETTI AFFRONTATI:
  • Utilizzo e configurazione software
COMPONENTI SOFTWARE UTILIZZATE:
PREREQUISITI:
DISPOSITIVI FISICI UTILIZZATI:
GUIDA maggiormente indicatA per:

Tutti gli ambienti

Note e disclaimer
  • qualsiasi modifica all'impianto elettrico dev'essere effettuata da personale qualificato;
  • qualsiasi modifica attuata in proprio è a propria responsabilità personale nonché a proprio rischio e pericolo (la presente guida ha puro scopo didattico);
  • qualsiasi modifica attuata in proprio a un dispositivo ne fa decadere la garanzia.
Revisione guida: 1.0

Abstract

Sua maestà lo ZigBee.

ConBee IICome sappiamo l’iteroperabilità tra componenti basati su questo protocollo ma di diverse tipologie e diversi produttori è spesso – anzi, quasi sempre – un problema. Esistono infatti interessantissimi componenti ma di linee molto diverse tra loro e, non potendo pensare di acquistare un BRIDGE/Gateway per ciascuna delle linee prodotti, spesso ci si trova davanti alla scelta di doversi “accontentare” di una linea prodotti rinunciando magari ad altri singoli componenti che ci interesserebbe introdurre in domotica.

Altro prodotto di questa situazione è, spesso, l’impossibilità di integrare il BRIDGE/Gateway (e quindi i componenti ZigBee ad esso collegati) col proprio HUB personale, come nel caso di quello della linea LUMI Aqara – non fosse che, per fortuna, i componenti (validissimi) di questa linea sono gestibili anche dal gateway Xiaomi Mijia, il quale è integrabile con Home Assistant. Quando dei componenti ZigBee non sono altrimenti controllabili se non col “proprio” gateway (magari non integrabile col nostro Home Assistant), in sostanza diventano inutili, se non nell’ambito del proprio ecosistema e della propria app mobile.

RaspBeePer salvare capra e cavoli esiste un’ottima soluzione, ovvero quella di implementare presso la nostra domotica un BRIDGE/Gateway ZigBee↔︎TCP/IP avulso dalle logiche dei singoli produttori: la risposta è data dalla sinergia di deCONZ (componente software) e ConBee/RaspBee (componente hardware), un’accoppiata che permette di censire il più alto numero di componenti ZigBee possibile scavalcando i problemi di cui sopra. Ovviamente, questo BRIDGE/Gateway “standard” è pienamente integrabile con Home Assistant.

In questa guida vedremo quali sono i passi per integrarlo su Home Assistant in distribuzione HASSIO. Coloro che utilizzino un’installazione Home Assistant come applicativo (su Raspbian, Windows, macOS o altri sistemi operativi) devono fare riferimento a quest’altra guida.

La guida si articola in tre fasi specifiche: l’installazione dell’antenna, la definizione (installazione e configurazione) di tale BRIDGE/Gateway e infine l’integrazione di quest’ultimo (col suo bagaglio di risorse) con Home Assistant.

N.b. Alternativa al binomio deCONZ+ConBee/RaspBee è l’adozione di zigbee2mqtt+CC2531 non oggetto di questa specifica guida.

Si parte

Installare l’antenna

Innanzitutto è necessario installare correttamente l’antenna ConBee/RaspBee.

CONBEE

Nel caso di ConBee è sufficiente inserire la chiavetta su una delle porte USB del computer/Raspberry ed effettuare un riavvio controllato (voce di menu “HASS.io” > “SYSTEM” >”REBOOT“) mentre con RaspBee è necessario effettuare una modifica sul file config.txt presente nella root della propria Micro SD montata sul Raspberry.

RASPBEE

L’uso di RaspBee prevede non solo l’installazione fisica del modulo sul Raspberry Pi (a freddo, quindi prima spegnere il Raspberry tramite la voce di menu “HASS.io” > “SYSTEM” >”SHUTDOWN“), ma anche di effettuare una modifica sul file config.txt presente nella root della propria Micro SD.

N.b. questa procedura non è obbligatoria. Potete passare direttamente allo step successivo (“Verifica post-installazione”) e vedere se RaspBee sia stato riconosciuto di automaticamente o meno. In caso negativo, la procedura qui descritta va necessariamente eseguita.

Per effettuare tale modifica al file config.txt (in caso non ci sia, va creato) è possibile seguire due strade: montare la Micro SD su un adattatore su un computer di appoggio, accedervi ed effettuare la modifica oppure, alternativamente, installare l’add-on SSH il quale ci permetta di collegarci da un computer di appoggio, al medesimo scopo.

La modifica da fare prevede l’aggiunta, in coda al file, del seguente codice (avere cura di aggiungere una riga vuota dopo le due righe di codice):

Su Raspberry Pi 3B e inferiori:

enable_uart=1
dtoverlay=pi3-disable-bt

Su Raspberry Pi 3B+ e superiori:

enable_uart=1
dtoverlay=pi3-miniuart-bt

Terminata la modifica, salvare il file e avviare (o riavviare) il Raspberry Pi.

VERIFICA POST-INSTALLAZIONE

Dopo aver installato l’antenna e aver avviato HASSIO, accedere a quest’ultimo e, presso la voce di menu “HASS.io” > “SYSTEM” >”HARDWARE” verificare se, nell’elenco dell’hardware installato, appaia o meno il componente, solitamente una voce di questo tipo:

/dev/serial/by-id/usb-dresden_elektronik_ingenieurtechnik_GmbH_ConBee_II

In caso appaia l’installazione sarà considerata valida; segnarsi la stringa da una parte.

N.b. A volte l’antenna viene semplicemente riconosciuta come /dev/ttyAMA0 .

Installare deCONZ

Per avviare il server deCONZ (che di fatto rappresenterà il nostro BRIDGE/Gateway ZigBee↔︎TCP/IP) è necessario, in ambito HASSIO, utilizzare il comodissimo add-on “deCONZ” presente sullo Store interno a Home Assistant. Chi non avesse dimestichezza con l’installazione di add-on presso HASSIO può far riferimento a questa guida.

Come detto, presso lo Store HASSIO è disponibile l’add-on deCONZ:

HASSIO - Installazione deCONZ

Una volta cliccato “INSTALL” sarà sufficiente attendere l’avvenuta installazione.

Terminata quest’ultima, recarsi in fondo alla pagina dell’add-on e identificare il box “Config“, nel quale si troverà un payload JSON analogo al seguente:

{
  "device": "",
  "vnc_password": ""
}

provvedere dunque a modificarlo inserendo tra gli apici della voce “device” la stringa ricavata dalla verifica dell’installazione dell’antenna di cui sopra, per esempio:

{
  "device": "/dev/serial/by-id/usb-dresden_elektronik_ingenieurtechnik_GmbH_ConBee_II",
  "vnc_password": ""
}

Cliccare su “Save” e tornare in cima alla pagina; cliccare infine su “START” per avviare “deCONZ”. Completato l’avvio apparirà un nuovo tasto sulla destra, ovvero “OPEN WEB UI“. Cliccarvi sopra.

Configurare deCONZ

Cliccare su “OPEN WEB UI” fornisce accesso all’interfaccia web propria di deCONZ presso la quale configurare la/le antenne e i componenti ZigBee ad esse collegati. Tale web app è nota come “Phoscon App”.

N.b. L’indirizzo che viene contattato potrebbe essere – in caso abbiate configurato l’accesso remoto ad HASSIO – quello esterno, ovvero qualcosa tipo https://indirizzo_personale.duckdns.org:40850. Dato che la porta “40850” sarà chiusa presso il router di casa, ovviamente tale indirizzo non sarà raggiungibile e darà errore. È perfettamente normale.

Per risolvere le soluzioni possibili sono due:

  1. aprire la porta sul router (ALTAMENTE sconsigliato per motivi di sicurezza);
  2. puntare all’indirizzo IP del Raspberry Pi, sostituendo l’FQDN proposto dall’interfaccia HASSIO (eg. https://192.168.1.100:40850)

Una volta ottenuto accesso all’interfaccia di deCONZ, quest’ultima effettuerà la ricerca dell’antenna/e:

deCONZ - primo accesso

 

e successivamente domanderà la creazione di un proprio account personale locale:

deCONZ - Creazione account

Una volta ottenuto acceso, deCONZ effettuerà una verifica automatica alla ricerca di eventuali componenti ZigBee compatibili col proprio ambiente operativo; al termine della procedura (e comunque in qualunque momento successivo) sarà possibile accedere al menu e, sotto le tre voci “Lights” “Switches” e “Sensors” cliccare su “ADD” per effettuare il pairing manuale di eventuali componenti non censite automaticamente ma compatibili con deCONZ.

deCONZ - Ambiente operativo web
l’interfaccia web di configurazione deCONZ.

Integrazione Home Assistant

Siamo pronti per integrare deCONZ con Home Assistant. Per farlo è possibile sia utilizzare la discovery automatica sia recarsi direttamente e manualmente ala voce “deCONZ” sotto il menu di HASSIO “Impostazioni” > “Integrazioni“.

Per attivare la discovery è sufficiente aggiungere al file di configurazione (magari utilizzando l’add-on “Configurator”) la seguente voce (laddove non già presente):

discovery:

Salvare e riavviare Home Assistant (voce di menu “HASS.io” > “SYSTEM” >”REBOOT“).

Al termine del riavvio nelle notifiche apparirà una voce che indica il riconoscimento automatico di nuove integrazioni:

Home Assistant - Notifica discovery

 

Seguire il link proposto (“Check it out“) e, una volta visualizzata la maschera che elenca le discovery effettuate, cliccare su “Configura” alla voce “Gateway Zigbee deCONZ“:

Home Assistant - Integrazione deCONZ

Al termine della procedura, Home Assistant confermerà l’avvenuta integrazione:

Home Assistant - Integrazione deCONZ OK

Da qui in poi sotto il menu di HASSIO “Impostazioni” > “Integrazioni” apparirà la voce relativa al BRIDGE/Gateway ZigBee deCONZ:

Home Assistant - Integrazione deCONZ - ElencoPresso il quale sarà possibile visualizzare i dettagli relativi al BRIDGE/Gateway e alle risorse ad esso connesse (e quindi alle entità da esso derivanti):

Home Assistant - Integrazione deCONZ - Elenco

Come si nota nell’immagine esemplificativa, sulla destra (ultimo riquadro) sono elencate le entità derivanti dall’integrazione di un sensore ZigBee (nello specifico un sensore di temperatura LUMI Aqara), lo stesso sensore integrato a mo’ d’esempio presso deCONZ.

Uso

A questo punto le entità generate da questa integrazione potranno essere utilizzate per gli usi ordinari presso l’HUB (consultazione tramite frontend, uso in scene e gruppi, ma anche come trigger/condition/action presso le proprie automazioni e script.

Per aggiungere/rimuovere componenti ZigBee sarà sufficiente operare presso l’interfaccia web di deCONZ: l’effetto presso Home Assistant sarà immediato a partire dal primo riavvio di quest’ultimo.


Home Assistant Official LogoATTENZIONE: ricorda che sul nostro community FORUM c'è una sezione ad hoc dedica a Home Assistant, per qualsiasi dubbio, domanda, informazione nel merito specifico di queste componenti.


Please comment below