Raspberry Pi OS

Unterstützte Raspberry Pi Modelle und Distributionen

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

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

    sudo apt install deconz

6. UDEV Regel erstellen

    echo ACTION=='"add"', SUBSYSTEMS=='"usb"', \
         ATTRS{product}=='"ConBee III"', \
         RUN+='"/bin/stty -F /dev/%k 115200"' | \
         sudo tee /etc/udev/rules.d/99-conbee3.rules

   Hinweis: Der ConBee III 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

    sudo apt install deconz

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

    sudo apt install deconz

6. UDEV Regel erstellen

    echo ACTION=='"add"', SUBSYSTEMS=='"usb"', \
         ATTRS{product}=='"ConBee III"', \
         RUN+='"/bin/stty -F /dev/%k 115200"' | \
         sudo tee /etc/udev/rules.d/99-conbee3.rules

   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

Home Assistant ZHA

Unterstützte Versionen

Mindestanforderungen:

• Home Assistant Core 2023.12.0 (Stable Version)
• ConBee III Firmwareversion 0x264E0900

Update ConBee III

Der ConBee III muss manuell über die Konsole aktualisiert werden, damit er reibungslos mit der ZHA Integration arbeitet. Die Updateprozedur verhält sich genau wie beim ConBee II und wird im Wiki Artikel Update ConBee III firmware manually sowie im Youtube-Video beschrieben. Der für das Update notwendige GCFFlasher kann auch als eigenständiges Programm heruntergeladen werden.

Installation

1. Login in die Home Assistant Weboberfläche und den Menüpunkt Einstellungen öffnen.

   

2. Die Einstellungen zum System öffnen und den Abschnitt Updates wechseln.

   

3. Den Home Assistant Core Version auf 2023.12.0 oder höher aktualisieren.

   

4. Im Einstellungsmenü den Punkt Geräte & Dienste öffnen.

   

5. Den Dienst ZHA suchen und hinzufügen.

   

6. Die ZHA Integration konfigurieren und den ConBee III einrichten.

   

7. Die Netzwerkbildung festlegen: Einstellungen beibehalten, Backup laden oder ein neues Netzwerk aufsetzen.

   

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.