ConBee

Raspberry Pi OS

Unterstützte Raspberry Pi Modelle und Distributionen

• Raspberry Pi (alle Modelle, außer Pico)
• Raspberry Pi OS

Betriebssystem installieren

1. Auf der Webseite www.raspberrypi.com/software den Raspberry Pi Imager herunterladen und starten

2. SD-Karte in PC oder SD-Karten Reader stecken

3. Raspberry Pi Device: Raspberry Pi Modell auswählen

4. Operating System: Ein aktuelles Betriebssystem auswählen

5. Storage: SD-Karten Laufwerk auswählen

6. Use OS Customisation: Auf No klicken falls die Standard-Einstellungen okay sind, z.B. wenn ein Ethernetkabel genutzt wird und direkter Zugriff per angeschlossener Maus, Tastatur und Monitor erfolgt. Andernfalls auf Yes klicken um die Einstellungen: Hostname, Nutzername, Passwort, WLAN, Zeitzone und Tastaturlayout anzupassen und mit save speichern.

6. Um Remote, d.h. ohne angeschlossene Maus, Tastatur und Bildschirm auf den Raspberry Pi Zugriff zu erhalten, ist es wichtig unter dem Menüpunkt Services die SSH-Schnittstelle zu aktivieren. Weiterhin sollten unter Set username and password eigene Zugangsdaten vergeben werden.

7. Write: Kopiervorgang starten

8. SD-Karte aus Kartenslot entnehmen (im Windows Explorer auswerfen → Rechtsklick auf den Laufwerkbuchstaben und Auswerfen wählen)

9. Micro-SD-Karte in den SD-Karten-Slot des Raspberry Pi einstecken

10. USB-Kabel an den Raspberry Pi anschließen, dass Betriebsystem startet nach ca. drei Sekunden selbständig und ist nach ca. einer Minute betriebsbereit

Remote Zugriff

Der Remote-Zugriff auf den Raspian OS Desktop erfolgt über die VNC-Schnittstelle. Diese muss nach erfolgreicher Betriebssystem-Installation zunächst aktiviert werden.

1. Hierfür mit einem geeigneten SSH-Konsolen-Programm über die IP-Adresse des Raspberry Pi mit dem zuvor vergebenen Username und Password einloggen und folgenden Befehl eingeben.

    sudo raspi-config

2. Im Menüpunkt 3. Interface Options den Punkt I3 VNC auf Enable setzen.

3. Raspberry Pi neustarten

    sudo reboot

Nun kann der Zugriff auf den Raspian OS Desktop über ein geeignetes VNC Programm erfolgen.

deCONZ Installation

1. USB-Zugriffsrechte für Nutzer setzen

    sudo gpasswd -a $USER dialout

   Hinweis: Die Zugriffsrechte werden erst nach dem Aus- und Einloggen bzw. nach einem Neustart aktiv.

2. Phoscon Public-Key importieren

   wget -qO- https://phoscon.de/apt/deconz.pub.key | gpg --dearmor | \
             sudo tee /etc/apt/trusted.gpg.d/deconz-keyring.gpg >/dev/null

3. APT-Repository für deCONZ konfigurieren

   Stable

   sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
               generic main' > \
               /etc/apt/sources.list.d/deconz.list"

   Beta (Alternativ)

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

4. APT-Paketliste aktualisieren

    sudo apt update

5. deCONZ installieren

   Bei Nutzung einer älteren Distribution (vor Debian Bookworm)

    sudo apt install deconz

   Bei Nutzung einer aktuellen Distribution mit Qt6 (ab Debian Bookworm)

    sudo apt install deconz-qt6

   Hinweis: Der ConBee wird erst nach einem Neustart bzw. an/-abstecken aktiv.

Nach der Installation kann deCONZ über das Applikations­menü 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.

Update über Repository

1. APT-Paketliste aktualisieren

    sudo apt update

2. deCONZ updaten

   Bei Nutzung einer älteren Distribution (vor Debian Bookworm)

    sudo apt install deconz

   Bei Nutzung einer aktuellen Distribution mit Qt6 (ab Debian Bookworm)

    sudo apt install deconz-qt6

Autostart der deCONZ GUI (optional)

Den GUI Service bei jedem Systemstart starten.

sudo systemctl enable deconz-gui

Problembehandlung

Sollten Probleme bei der Inbetriebnahme auftreten, beantwortet der Support-Bereich häufig gestellte Fragen (FAQ) und bietet erste Hilfestellungen.

Ubuntu

Unterstützte Versionen

• Ubuntu 18.04 LTS 64-Bit PC (AMD64)
• Ubuntu 20.04 LTS 64-Bit PC (AMD64)

Installation

1. USB-Zugriffsrechte für Nutzer setzen

    sudo gpasswd -a $USER dialout

   Hinweis: Die Zugriffsrechte werden erst nach dem Aus- und Einloggen bzw. nach einem Neustart aktiv.

2. Phoscon Public-Key importieren

   wget -qO- https://phoscon.de/apt/deconz.pub.key | gpg --dearmor | \
             sudo tee /etc/apt/trusted.gpg.d/deconz-keyring.gpg >/dev/null

3. APT-Repository für deCONZ konfigurieren

   Stable

   sudo sh -c "echo 'deb [arch=amd64] http://phoscon.de/apt/deconz \
               generic main' > \
               /etc/apt/sources.list.d/deconz.list"

   Beta (Alternativ)

   sudo sh -c "echo 'deb [arch=amd64] http://phoscon.de/apt/deconz \
               generic-beta main' > \
               /etc/apt/sources.list.d/deconz.list"

4. APT-Paketliste aktualisieren

    sudo apt update

5. deCONZ installieren

   Bei Nutzung einer älteren Distribution (vor Ubuntu 24.04)

    sudo apt install deconz

   Bei Nutzung einer aktuellen Distribution mit Qt6 (ab Ubuntu 24.04)

    sudo apt install deconz-qt6

   Hinweis: Der ConBee III wird erst nach einem Neustart bzw. an/-abstecken aktiv.

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

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

Autostart der deCONZ GUI (optional)

1. Über das Applikationsmenü zunächst den Autostart Manager aufrufen

    gnome-session-properties

2. Ein neues Autostart Programm anlegen und folgende Kommandozeile eintragen:

    deCONZ --http-port=80 --auto-connect=1

   

Problembehandlung

Sollten Probleme bei der Inbetriebnahme auftreten, beantwortet der Support-Bereich häufig gestellte Fragen (FAQ) und bietet erste Hilfestellungen.

Linux Headless

Die SD-Karten Images sowie die Standardinstallationsmethode starten automatisch mit grafischer Benutzeroberfläche.

Grafische Benuteroberfläche ausschalten (headless)

Zum Ausschalten der grafischen Benutzeroberfläche (GUI) müssen folgende Kommandos in der Konsole eingegeben werden:

1. Den GUI Service sofort beenden.

    sudo systemctl disable --now deconz-gui

2. Den headless Service jetzt und bei jedem Systemstart starten.

    sudo systemctl enable --now deconz

Grafische Benutzeroberfläche anschalten (GUI)

Zum Anschalten der grafischen Benutzeroberfläche (GUI) müssen folgende Kommandos in der Konsole eingegeben werden:

1. Den headless Service sofort beenden.

    sudo systemctl disable --now deconz

2. Den GUI Service jetzt und bei jedem Systemstart starten.

    sudo systemctl enable --now deconz-gui

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 deconz-community/deconz-docker.

Die Installation ist auf https://github.com/deconz-community/deconz-docker beschrieben.