Konfiguration des RaspBee ZigBee-Moduls über config.txt

Einleitung

Für den Betrieb eines Phoscon RaspBee Aufsatzmoduls auf einem Raspberry Pi ist eine Anpassung der seriellen Schnittstellenkonfiguration zwingend erforderlich. Standardmässig belegt die Bluetooth-Funktion des Raspberry Pi den primären UART-Port, den das RaspBee-Modul für eine stabile Kommunikation benötigt.

Dieses Tutorial beschreibt die notwendigen Anpassungen in der Boot-Konfiguration, um die Schnittstellen korrekt zuzuweisen.

Voraussetzungen:

• Raspberry Pi (Modell 3, 4 oder neuer)
• microSD-Karte mit Raspberry Pi OS
• RaspBee / RaspBee II Aufsteckmodul
• Computer mit Kartenlesegerät

[BILD 1: Raspberry Pi mit aufgestecktem RaspBee Modul in Nahaufnahme]

Überblick

Durch die Bearbeitung der config.txt erreichen wir folgendes Ergebnis:

• Aktivierung der seriellen Schnittstelle (UART)
• Umleitung von Bluetooth auf den Mini-UART
• Freigabe des Haupt-UART für das ZigBee-Modul

Schritt-für-Schritt Anleitung

1. Vorbereitung der SD-Karte
   Verbinden Sie die microSD-Karte mit Ihrem Computer. Das Betriebssystem (Windows/macOS/Linux) erkennt diese als Laufwerk, meist mit dem Label boot oder bootfs. Öffnen Sie dieses Laufwerk im Dateimanager.[BILD 2: Dateimanager-Ansicht der Boot-Partition]
2. Konfigurationsdatei bearbeiten
   Suchen Sie im Hauptverzeichnis der Karte die Datei config.txt. Öffnen Sie diese mit einem reinen Texteditor (z. B. Notepad++, Sublime Text oder VS Code). Vermeiden Sie Word oder Rich-Text-Editoren, da diese die Formatierung zerstören können.Datei-Anpassung:
   Datei: config.txt
   Aktion: Am Ende der Datei einfügen

   # Serielle Schnittstelle aktivieren
   enable_uart=1
   
   # Bluetooth auf Mini-UART umleiten (für Pi 3/4)
   dtoverlay=pi3-miniuart-bt

3. Hardware-Inbetriebnahme
   Speichern Sie die Datei und werfen Sie das Laufwerk sicher aus. Stecken Sie die Karte in den Raspberry Pi und starten Sie das System. Stellen Sie sicher, dass das RaspBee-Modul korrekt auf den GPIO-Pins 1-10 sitzt.
4. Schnittstelle verifizieren
   Nach dem Booten und Login per SSH prüfen Sie, ob die Zuweisung erfolgreich war. Der Befehl listet die seriellen Geräte auf.

   ls -l /dev/serial*

   Die Ausgabe sollte zeigen, dass serial0 auf ttyAMA0 zeigt (das ist der hochwertige Hardware-UART für RaspBee).

   [BILD 3: Terminal-Screenshot mit der Ausgabe von ls -l /dev/serial*]

5. DeCONZ Software installieren
   Installieren Sie nun die Steuerungssoftware von Phoscon, um das Gateway in Betrieb zu nehmen.

   # Repository aktualisieren und installieren
   sudo apt update
   sudo apt install deconz
   
   # Dienst aktivieren und starten
   sudo systemctl enable deconz
   sudo systemctl start deconz

Wichtige Hinweise & Stolperfallen

Bluetooth-Einschränkung: Durch die Nutzung von miniuart-bt wird die Bluetooth-Leistung und -Stabilität reduziert. Sollten Sie Bluetooth nicht benötigen, ist es sauberer, es komplett zu deaktivieren. Fügen Sie dazu dtoverlay=disable-bt in die config.txt ein.

Raspberry Pi 5: Beachten Sie, dass neuere Hardware-Revisionen oder andere Betriebssystem-Images (wie Home Assistant OS) eventuell abweichende Overlay-Namen verwenden.

Ergebnis & Fazit

Mit der korrekten Zuweisung der UART-Schnittstelle ist die Hardware-Basis für Ihr ZigBee-Gateway geschaffen. Das RaspBee-Modul kann nun fehlerfrei mit der Phoscon-Software kommunizieren, ohne durch Bluetooth-Signale gestört zu werden. Sie können nun mit dem Anlernen von Lampen und Sensoren in der Phoscon App beginnen.