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.
   

7. 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.

8. Write: Kopiervorgang starten

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

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

11. 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

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

   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.

Zigbee2MQTT

Die Installationsanleitung zeigt die Inbetriebnahme von Zigbee2MQTT mit dem ConBee III auf einem Raspberry Pi 5 mit installiertem Raspberry Pi OS (Debian Trixie).

Voraussetzung

• Raspberry Pi 5
• Raspberry Pi OS → Installation des Betriebssystems siehe hier

Installation mit Onbording (Webbrowser Wizard)

Diese Anleitung basiert auf der offiziellen Beschreibung von Zigbee2MQTT unter Linux.

1. Installation des MQTT Brokers: Anleitung

2. Installation der notwendigen Umgebung sowie Zigbee2MQTT: Anleitung

3. ConBee III an Raspberry Pi anschließen

4. Konsole öffnen und den ersten Start von Zigbee2MQTT ausführen

   cd /opt/zigbee2mqtt
   pnpm start

5. Den Webbrowser auf dem Raspberry Pi öffnen und über die Adresse http://localhost:8080 das Zigbee2MQTT-Onbording starten

   oder

   mit einem externen Webbrowser von PC oder Laptop aus über den Raspberry Pi das Zigbee2MQTT-Onbording beginnen:

   Methode 1: http://raspberrypi:8080
   Methode 2: [Raspberry_Pi_Hostname]:8080
   Methode 3: [Raspberry_Pi_IP_Adresse]:8080

6. Auswahl des ConBee III und Prüfung das Baudrate 115200 sowie Adapter deconz eingestellt ist

7. Zigbee2MQTT-Frontend aktivieren und auf Submit klicken

8. Nach ca. 30 Sekunden wird das Zigbee2MQTT-Frontend geladen

Nun können die ersten Zigbee Geräte über das Web-Frontend angelernt werden.

Installation per Konsole

Diese Anleitung basiert auf der offiziellen Beschreibung von Zigbee2MQTT unter Linux.

1. Installation des MQTT Brokers: Anleitung

2. Installation der notwendigen Umgebung sowie Zigbee2MQTT: Anleitung

3. ConBee III an Raspberry Pi anschließen und Konsole starten

4. Anschlussport bestimmen

   ls -l /dev/serial/by-id

   

5. Verzeichnis zur Konfiguration von Zigbee2MQTT öffnen

   cd /opt/zigbee2mqtt/data/

6. Konfigurationsdatei configuration.yaml erstellen

   nano configuration.yaml

7. Den zuvor bestimmten Anschlussport, die Baudrate 115200 sowie den Adapter deconz eintragen und die Konfigurationsdatei speichern

   Beispiel mit generischem Schnittstellennamen ttyUSB0:

   mqtt:
        base_topic: zigbee2mqtt
        server: mqtt://localhost:1883
   serial:
        port: /dev/serial/ttyUSB0
        baudrate: 115200
        adapter: deconz
   advanced:
        log_level: info
        network_key: GENERATE
        pan_id: GENERATE
        ext_pan_id: GENERATE
   frontend:
        enabled: true
        port: 8080
   homeassistant:
        enabled: false
   onboarding: false

   Beispiel mit definiertem ConBee III Gerätenamen:

8. Die Anwendung Zigbee2MQTT starten. Bei korrekter Konfiguration dürfen keine Fehlermeldungen erscheinen.

   pnpm start

   

9. Den Webbrowser auf dem Raspberry Pi öffnen und über die Adresse http://localhost:8080 das Zigbee2MQTT-Frontend starten

   oder

   mit einem externen Webbrowser von PC oder Laptop aus über den Raspberry Pi das Zigbee2MQTT-Frontend starten:

   Methode 1: http://raspberrypi:8080
   Methode 2: [Raspberry_Pi_Hostname]:8080
   Methode 3: [Raspberry_Pi_IP_Adresse]:8080

   

Nun können die ersten Zigbee Geräte über das Web-Frontend angelernt werden.

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

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.