RaspBee

Installation

Zur Konfiguration, Steuerung und Darstellung von Zigbee Netzwerken mit dem RaspBee Zigbee Gateway, wird die Software deCONZ verwendet.

Die folgenden Abschnitte beschreiben die Installationsschritte von deCONZ für verschiedene Plattformen.

Unterstützte Plattformen

Raspbian
Docker

Anschließen

Der RaspBee muss auf die Raspberry Pi Stiftleiste wie folgt aufgesetzt werden:

Wichtig: Der RaspBee darf nicht versetzt aufgesetzt werden, da dies zur Beschädigung des Moduls führt!

RaspBee auf Raspberry Pi Header Gesamtansicht

Raspbian

Unterstützte Raspberry Pi Modelle und Distributionen

Raspberry Pi 1, 2B, 3B, 3B+ and 4B
Raspbian Jessie
Raspbian Stretch
Raspbian Buster

Hinweis

Die folgenden Schritte beschreiben die manuelle Installation von deCONZ. Alternativ kann ein vorinstalliertes SD-Karten Image verwendet werden.

Installation

Zugriffsrechte der seriellen Schnittstelle für Nutzer setzen
```
 sudo raspi-config
```
Interfacing Options → Serial
- Would you like a login shell accessible over serial? → No
- Would you like the serial port hardware to be enabled? → Yes
Hinweis: Die Zugriffsrechte werden erst nach einem Neustart aktiv.

Phoscon Public-Key importieren

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

APT-Repository für deCONZ konfigurieren

Stable

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

Beta (Alternativ)

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

APT-Paketliste aktualisieren
```
 sudo apt update
```
deCONZ installieren
```
 sudo apt install deconz
```

WiringPi aktualisieren (nur für Raspberry Pi 4B notwendig)

 cd /tmp
 wget https://project-downloads.drogon.net/wiringpi-latest.deb
 sudo dpkg -i wiringpi-latest.deb

Nach der Installation kann deCONZ über das Applikationsmenü gestartet werden.

Menu > Programming > deCONZ

Nun können die ersten Zigbee Geräte über die Phoscon App angelernt werden. Weitere Informationen hierzu gibt es in der Phoscon App Dokumentation.

Docker

Unterstützte Hostsysteme

Linux x86_64/amd64
Linux armv7 (z. B. Raspberry Pi)
Linux arm64

Um die Steuersoftware deCONZ in einem Docker Container zu betreiben, empfehlen wir das von der Community gepflegte Docker Image marthoc/deconz. Dieses ist auf amd64, arm64 und armhf Plattformen lauffähig.

https://hub.docker.com/r/marthoc/deconz

Installation

Im Folgendem wird beschrieben wie der deCONZ Container auf einem Linux Hostsystem gestartet wird.

Zugriffsrechte der seriellen Schnittstelle für Nutzer setzen
```
 sudo raspi-config
```
Interfacing Options → Serial
- Would you like a login shell accessible over serial? → No
- Would you like the serial port hardware to be enabled? → Yes
Hinweis: Die Zugriffsrechte werden erst nach einem Neustart aktiv.
Verzeichnis für persistente Konfiguration erstellen
```
 mkdir -p ~/.local/share/dresden-elektronik/deCONZ
```

deCONZ Docker Container starten

 docker run -d \
   --name=deconz \
   --net=host \
   --restart=always \
   -v /etc/localtime:/etc/localtime:ro \
   -v ~/.local/share/dresden-elektronik/deCONZ:/root/.local/share/dresden-elektronik/deCONZ \
   --device=/dev/ttyAMA0 \
   marthoc/deconz

Mit dieser Konfiguration läuft deCONZ im Docker Container auf Port 80.

Nun können die ersten Zigbee Geräte über die Phoscon App angelernt werden. Weitere Informationen hierzu gibt es in der Phoscon App Dokumentation.

Eine Beschreibung aller verfügbaren Parameter, sowie die Verwendung von Docker-Compose und VNC-Zugriff auf die deCONZ GUI ist in der Container Dokumentation zu finden.