community italiana di domotica personale
 
Installare e configurare deCONZ su Raspbian di Raspberry Pi

Installare e configurare deCONZ su Raspbian di Raspberry Pi

7 minuti di lettura
SCOPI DELLA GUIDA:
  • Installare e configurare il BRIDGE/Gateway deCONZ su sistema operativo Raspbian di Raspberry Pi, dotandosi così di una rete Zigbee per la propria domotica personale
  • Livello di difficoltà: basso
CONCETTI AFFRONTATI:
  • Installazione e configurazione software
COMPONENTI SOFTWARE UTILIZZATE:
  • Sistema operativo Raspberry Pi OS (aka Raspbian)
  • deCONZ
PREREQUISITI:
DISPOSITIVI FISICI UTILIZZATI:
  • Raspberry Pi
  • Un’antenna ZigBee coordinator compatibile con deCONZ (illustrato a seguire)
GUIDA DEDICATA A SISTEMI:

Raspbian

Note e disclaimer
  • qualsiasi eventuale modifica agli impianti domestici dev'essere progettata ed realizzata SOLO da personale qualificato;
  • qualsiasi modifica attuata in proprio è a propria responsabilità personale nonché a proprio rischio e pericolo (i contenuti della presenta pagina hanno puro scopo didattico);
  • qualsiasi modifica attuata in proprio a un dispositivo ne fa decadere garanzia, omologazioni e certificazioni di qualità.
Revisione guida: 1.1

Abstract

ZigBee, uno degli standard più adottati in domotica personale.

ConBee IISpesso l’interoperabilità tra componenti basati su questo protocollo ma di diverse tipologie e diversi produttori rappresenta 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.

Phoscon RaspBee IIPer salvare capra e cavoli esistono varie possibilità, tra le quali quelle di implementare presso la nostra domotica un BRIDGE/Gateway software avulso dalle logiche dei singoli produttori.

Tra le varie alternative, è il caso di deCONZ, oggetto della presente guida, componente software che consente per l’appunto di dotarsi gratuitamente di un BRIDGE/Gateway evoluto per la gestione della propria rete ZigBee: una volta installato, tale BRIDGE/Gateway espone delle API per instradare i messaggi da e per i componenti ZigBee tramite esso gestiti.

Tramite esse, sarà poi facile riuscire ad integrare il tutto con i più comuni HUB personali.

Scopo della presente guida è quello di installare e configurare deCONZ come applicativo presso il sistema operativo Raspbian di Raspberry Pi. La guida è sostanzialmente valida anche per qualsiasi altro sistema Linux. A valle di tale messa in opera, sarà possibile provvedere all’integrazione di deCONZ su qualsiasi HUB personale (Home Assistant, openHAB ecc.).

Altre guide disponibili su inDomus dedicate a deCONZ sono:

Si parte

Assunti

Questa guida è dedicata a chi abbia già un Raspberry in uso con sistema operativo Raspberry Pi OS (aka Raspbian).
Per coloro che non abbiano ancora provveduto e si trovino ad avere un Raspberry nuovo, magari acquistato appositamente per realizzare la propria domotica, allora questo passo della guida va smarcato seguendo prima un’altra guida, che spiega passo passo come configurare il sistema operativo Raspbian.

La guida da seguire:

Una volta terminata la configurazione di Raspbian (inclusa la possibilità di collegarvisi tramite SSH) è possibile procedere nella presente guida.

ZigBee Coordinator (antenna)

Prima cosa, ancor prima di avventurarsi nell’installazione del BRIDGE/Gateway software, è l’installazione dell’antenna, ovvero del componente cardine di una rete mesh ZigBee: lo ZigBee Coordinator. Tale elemento è rappresentato da un’antenna interfacciata al computer ospitante via USB, via seriale o altro.

deCONZ supporta alcune diverse antenne, tra le quali abbiamo documentato e testato:

  • ConBee (oggi obsoleta)
  • ConBee II (USB, supporta fino a 200 componenti ZigBee)
  • RaspBee (modulo HAT per Raspberry Pi, oggi obsoleto)
  • RaspBee II (modulo HAT per Raspberry Pi, supporta fino a 200 componenti ZigBee)

e, in futuro, altre che verrano.

N.b. Sul tema “potenza” si disquisisce quotidianamente nei salotti di domotica quale argomento principe. Parlare di potenza trasmissiva ha talvolta poco senso: le reti mesh come quelle basate su ZigBee sono concepite per esser ripetute e non per aver un singolo nodo di potenza massima che provveda a coprire tutta la superficie – la differenza vera semmai la fa, piuttosto, l’affidabilità del componente stesso. In caso di ambienti ampi e/o con muri spessi, se i componenti ZigBee risultano irraggiungibili la scelta dell’antenna può quindi non essere legata alla sua potenza: basta infatti introdurre, oltre all’antenna principale, dei repeater ZigBee (banalmente, bastano delle lampadine per illuminazione ZigBee, le quali hanno anche questa funzione – anche da “spente” – come le Philips HUE, le IKEA e molte alte) per garantirsi una copertura più che ottimale.

È quindi necessario installare correttamente l’antenna (se è un dongle USB basta inserirla nella porta del Raspberry Pi o del computer ospitante) dopodiché appurare che il sistema operativo “veda” tale device.

N.b. Si consiglia, sempre, di utilizzare delle mini prolunghe USB per collegare sulla porta UBS del Raspberry Pi l’antenna ConBee. Questo per evitare più che accertate interferenze.

Dato però che Raspberry dispone di due porte seriali – ma una è disabilitata di default – installando l’antenna potrebbe smettere di funzionare il modulo Bluetooth o comunque non esser riconosciuta l’antenna stessa. Per evitare ciò, basta effettuare una modifica sul file config.txt presente nella root della propria Micro SD.

Eseguire dunque da terminale il seguente comando:

sudo nano /boot/config.txt

per accedere all’editor. 

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

La modifica da fare prevede l’aggiunta, in fondo 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 (CTRL+X, Y, invio), e infine spegnere il Raspberry Pi con:

sudo shutdown now

Completato lo shutdown, spegnere fisicamente l’unità per poi riaccenderla subito dopo.

VERIFICA POST-INSTALLAZIONE

Dopo aver installato l’antenna e aver riavviato Raspberry Pi è il momento di effettuare una verifica per appurare porta logica sia stata assegnata all’antenna dal sistema operativo. A questo scopo andiamo a definire uno script come da nostra guida.

Eseguito lo script, l’elemento che inizia con “tty” e prosegue con la descrizione dell’antenna (per esempio dresden_elektronik_ingenieurtechnik_GmbH_ConBee” per la ConBee II) è quello che identifica la porta che ci interessa (per esempio /dev/ttyACM0).

In presenza di questo elemento, l’antenna è riconosciuta correttamente dal sistema. Segnarsi tale stringa, servirà a seguire.

Aggiornamento firmware

Se l’antenna è nuova, non è improbabile – anzi – che monti una versione di firmware non recente. In tal caso, verificare le ultime notizie in merito (in ordine cronologico) e, in caso, applicare l’ultimo aggiornamento disponibile come indicato nell’articolo che lo presenta.

Installazione

Per installare deCONZ, collegarsi via SSH al proprio Raspberry Pi (oppure acceder localmente al terminale di sistema).
Una volta collegati è necessario, in primis, attribuire i diritti di accesso all’USB (comando da eseguire solo in caso di uso di un’antenna ConBee):

sudo gpasswd -a $USER dialout

e successivamente importare la chiave pubblica del produttore Phoscon:

wget -O - http://phoscon.de/apt/deconz.pub.key | \
          sudo apt-key add -

aggiungere poi il repository Phoscon all’elenco di quelli presenti sul sistema operativo:

sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
            $(lsb_release -cs) main' > \
            /etc/apt/sources.list.d/deconz.list"

infine, eseguire l’aggiornamento dei pacchetti e l’installazione vera a propria di deCONZ:

sudo apt update
sudo apt install deconz

Al termine della procedura, deCONZ sarà stato installato e in esecuzione sul sistema operativo Raspbian.

Configurazione

Prima di iniziar a utilizzare deCONZ è bene effettuare una serie di variazione alla configurazione proposta di default.

Cambio porte

L’installazione, così come effettuata, non avvia il servizio deconz-gui (che serve laddove si utilizzi l’interfaccia evoluta via VLC) e imposta entrambi i servizi (deconz e deconz-gui) su porta 80, il che è tecnicamente errato (non consente di avviarli assieme e comunque, a prescindere, è buona norma non usare la porta 80).

Per questo, decidiamo di cambiargli porta: nell’esempio assegneremo la 40850 al servizio deconz e la 40851 a deconz-gui (nostra scelta arbitraria: ovviamente ognuno può scegliere la porta che crede – purché sia libera). Vediamo quindi come effettuare le modifiche.

Fermiamo il servizio e modifichiamo il file relativo al servizio deconz:

sudo systemctl stop deconz
sudo nano /lib/systemd/system/deconz.service

apertosi l’editor di testo, modifichiamo la riga (aggiungendogli “#” in testa):

#ExecStart=/usr/bin/deCONZ -platform minimal --http-port=80

uscire salvando (CTRL+X, Y, invio).
A questo punto creare una cartella (“deconz.service.d” sotto “/etc/systemd/system/“) e un file (“local.conf“) nella cartella appena creata con i comandi:

sudo mkdir /etc/systemd/system/deconz.service.d/
sudo nano /etc/systemd/system/deconz.service.d/local.conf

nell’editor che si aprirà inserire:

[Service]
ExecStart=/usr/bin/deCONZ -platform minimal --http-port=XXXXX

indicando al posto di XXXXX una porta alternativa, per esempio la “40850” (o una comunque libera), per esempio:

ExecStart=/usr/bin/deCONZ -platform minimal --http-port=40850

uscire salvando (CTRL+X, Y, invio).
Modifichiamo ora la configurazione di deconz-gui:

sudo nano /lib/systemd/system/deconz-gui.service

apertosi l’editor di testo, modifichiamo la riga (aggiungere “#” in testa):

#ExecStart=/usr/bin/deCONZ --http-port=80

uscire salvando (CTRL+X, Y, invio).
A questo punto creare una cartella (“deconz.service.d” sotto “/etc/systemd/system/“) e un file (“local.conf“) nella cartella appena creata con i comandi:

sudo mkdir /etc/systemd/system/deconz-gui.service.d/
sudo nano /etc/systemd/system/deconz-gui.service.d/local.conf

nell’editor che si aprirà inserire:

[Service]
ExecStart=/usr/bin/deCONZ --http-port=XXXXX

indicando al posto di XXXXX una porta alternativa, per esempio la “40851” (o una comunque libera), per esempio:

ExecStart=/usr/bin/deCONZ --http-port=40851

uscire salvando (CTRL+X, Y, invio).


A questo punto abilitare deconz-gui e riavviare i servizi con:

sudo systemctl enable deconz.service 
sudo systemctl disable deconz-gui.service
sudo sudo systemctl daemon-reload
sudo systemctl start deconz.service

e infine collegarsi tramite browser al nuovo indirizzo:

http://INDIRIZZO_IP_DEL_RASPBERRY:40850/pwa/login.html

mentre per l’interfaccia evoluta deconz-gui basterà collegarsi via VNC al Raspberry e lanciarla dal menu.

N.b. Come avrà notato qualcuno, nell’ultimo blocco di comandi disabilitiamo il servizio deconz-gui. La cosa è voluta: i due servizi non possono convivere contemporaneamente, nemmeno se collocati su due porte diverse. Pertanto, quando si vorrà accedere eventualmente all’interfaccia deconz-gui andrà prima fermato deconz, e poi avviare lui.

Uso e integrazioni

A questo punto il BRIDGE/Gateway deCONZ è pronto e utilizzabile al fine di integrare componenti ZigBee compatibili con tale servizio.

Ogni componente compatibile, una volta associato a deCONZ, può essere comandato, censito e amministrato attraverso la sua interfaccia web. Ovviamente, il passo successivo è solitamente quello di integrare deCONZ col proprio HUB personale, al fine di utilizzare le risorse delle varie componenti ZigBee all’interno della propria domotica personale. In caso il proprio HUB personale sia il diffusissimo Home Assistant è possibile integrare deCONZ ad esso (e con lui quindi le componenti ZigBee da controllare) tramite l’interfaccia

Analogamente, altri HUB o servizi possono utilizzare le API deCONZ per integrare rapidamente tale BRIDGE/Gateway.

Aggiornamento

Ciclicamente escono aggiornamenti per deCONZ (nonché di firmware per le varie antenne coordinato); per spiegare come aggiornare il BRIDGE/Gateway abbiamo dedicato una guida ad hoc:

Utilità: come aggiornare deCONZ e il firmware ConBee/RaspBee

   
Telegram News Channel