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. Zugriffsrechte der seriellen Schnittstelle für Nutzer setzen

    sudo raspi-config

   Interface Options → Serial Port

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

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

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.

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.

RTC-Installation

Die Echtzeituhr (RTC) ist für die Nutzung des RaspBee II als ZigBee-Koordinator nicht zwingend erforderlich. Der RaspBee II benötigt die Firmware-Version 0x26610700 oder höher. Das Update der Firmware wird hier beschrieben.

Bei Nutzung einer älteren Distribution (vor Debian Trixie)

1. Raspberry Pi aktualisieren und neustarten

    sudo apt update
    sudo apt upgrade
    reboot

2. Abhängigkeiten installieren

    sudo apt install i2c-tools build-essential

3. Installationsarchiv herunterladen

    curl -O -L https://github.com/dresden-elektronik/raspbee2-rtc/archive/master.zip
    unzip master.zip

4. In entpacktes Verzeichnis wechseln

    cd raspbee2-rtc-master

5. RTC-Kernelmodul kompilieren

    make

6. RTC-Kernelmodul installieren

    sudo make install

7. Raspberry Pi neu starten

    sudo reboot

8. RTC mit Systemzeit konfigurieren

    sudo hwclock --systohc

9. Testen der RTC

    sudo hwclock --verbose

   Waiting in loop for time from /dev/rtc0 to change
    ...got clock tick
    Time read from Hardware Clock: 2020/03/06 13:55:21
    Hw clock time : 2020/03/06 13:55:21 = 1583502921 seconds since 1969
    Time since last adjustment is 1583502921 seconds
    Calculated Hardware Clock drift is 0.000000 seconds
    2020-03-06 14:55:20.017097+01:00

Bei Nutzung einer aktuellen Distribution (ab Debian Trixie)

1. Raspberry Pi aktualisieren und neustarten

    sudo apt update
    sudo apt upgrade
    reboot

2. Abhängigkeiten installieren

    sudo apt install i2c-tools build-essential

   Das Paket linux-headers-rpi-xx ist normalerweise bereits installiert. Wenn nicht, muss die richtige Version installiert werden. Die benötigte Version kann mit uname -a überprüft werden.

   Es wird der korrekte Suffix des notwendigen Pakets ausgegeben.

    uname -a

   für Raspberry Pi 1 | Raspberry Pi Zero: rpi-v6

    sudo apt install linux-headers-rpi-v6

   für Raspberry Pi 2: rpi-v7

    sudo apt install linux-headers-rpi-v7

   für 32-Bit Raspberry Pi 3, 4 und Zero2: rpi-v7l

    sudo apt install linux-headers-rpi-v7l

   für 64-Bit Raspberry Pi 3, 4, 5: rpi-v8

    sudo apt install linux-headers-rpi-v8

3. Installationsarchiv herunterladen

    curl -O -L https://github.com/dresden-elektronik/raspbee2-rtc/archive/master.zip
    unzip master.zip

4. In entpacktes Verzeichnis wechseln

    cd raspbee2-rtc-master

5. RTC-Kernelmodul kompilieren

    make

6. RTC-Kernelmodul installieren

    sudo make install

7. Raspberry Pi neu starten

    sudo reboot

8. Konfiguration und Testen der RTC

    timedatectl

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.

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