Dabei bleibt der Anwendungsfall unverändert: Die Auswertung und Steuerung von ca. 50 Zigbee-Geräten im Außenbereich der Dahlen-Mühle. Leuchtmittel, Sensoren und Steckdosen auf einer Fläche von über 10.000m², ohne direkten Zugang zum Internet und teilweise abseits einer dauerhaften Stromversorgung.

Hardware aktuell

Seinerzeit habe ich einen Raspberry Pi 4 und das Phoscon Raspbee II-Modul als Hardware-Plattform gewählt. Ziel war ein kompakter, unauffälliger Aufbau mit geringem Stromverbrauch. Dieses Ziel wurde erreicht, doch der Betrieb ist nicht frei von Problemen:

• die SD-Karte im Raspberry Pi 4 macht schlapp, obwohl es sich um eine Endurance-Version von Samsung handelt. Gleichzeitig ist es mir nicht auf Anhieb gelungen, den Raspberry von USB-Stick der -Disk zu booten (wie z.B. beim Raspberry Pi 3)
• die Raspbee II-Karte werkelt unsichtbar vor sich hin, aber (ich fürchte) ihre Bauform hat negativen Einfluss auf die Reichweite. Gleichzeitig fehlen ihr moderne Funktionen wie Touchlink
• trotz guter technischer Werte kommt der Raspberry Pi 4 doch an seine Grenzen. Im „Wirkbetrieb“ fällt das wenig auf, aber bei der (remote) Administration kommt es immer wieder zu Wartezeiten

Besonders der letzte Punkt treibt einem die Schweißperlen auf Stirn, wenn man nach einem Reboot aus der Ferne nicht weiß, ob die Kiste einfach noch ein paar Minuten braucht oder man den Weg ins 25km entfernte Elternhaus antreten darf.

Neue Hardware

Die neue Hardware soll entsprechend die identifizierten Ursachen beseitigen und gleichzeitig den unveränderten Anspruch eines unauffälligen 24/7-Betriebs bei geringem Stromverbrauch erfüllen.

Konkret bedeutet dies:

• sparsame x86-Hardware mit angemessener Leistung
• kompakt (was zu Lasten der Flexibilität gehen darf)
• keine beweglichen Teile, wie Lüfter oder mechanische Festplatten
• einwandfreie Unterstützung durch (Ubuntu) Linux
• moderne Zigbee Coordinator-Hardware mit hoher Reichweite

Minisforum N40 Mini-PC

Der Minisforum N40 (Datenblatt) Mini-PC erfüllt die gestellten Kriterien und ist für den angedachten Anwendungsfall mehr als ausreichend:

• Intel Celeron N4020 CPU (2 Kerne, bis zu 2,8 GHz)
• 4 GB RAM (DDR4, nicht erweiterbar)
• 64 GB „eMMC“ SSD
• 3 USB-A 3.0-Anschlüsse
• RJ45 GbE LAN und IEEE 802.11ac Dual-Band Wi-Fi

Bei Bedarf kann eine zusätzliche SSD (M.2 2242 SATA 3.0) verbaut werden. Ich habe aber darauf verzichtet, weil nach der Installation und Konfiguration nur 8,5 GB der verfügbaren 56 GB der eMMC belegt waren.

Das Netzteil (DC 12V, 1,5A) liefert bis zu 18 Watt, der tatsächliche Verbrauch des N40 in meiner Konstellation liegt zwischen 3 und 5 Watt. Die CPU ist mit Grafikeinheit, für den Anschluss an Fernseher / Monitor (während der Installation) steht ein Standard-HDMI Port zur Verfügung.

Die Kantenlänge des N40 entspricht übrigens ziemlich genau dem Durchmesser einer Audio CD (wer es noch kennt). Die CPU wird passiv gekühlt, das gesamte System gibt keinerlei Geräusche von sich und wird nicht warm.

SONOFF ZBDongle-P

Bei der Wahl der neuen Coordinator-Hardware fiel die Wahl auf das SONOFF Zigbee 3.0 USB Dongle Plus (kurz: ZBDongle-P), welches auf der Adapter-Seite von Zigbee2MQTT als „recommended“ aufgeführt wird und über einen modernen Texas Instruments CC2652P Chip mit zusätzlichem Verstärker verfügt.

Direkt eingesteckt steht das Dongle deutlich über den N40 hinaus. Allerdings wird bei USB 3.0 und Zigbee wg. möglicher Interferenzen der Einsatz einer USB-Verlängerung empfohlen, was eine relativ freie Platzierung des Dongles erlaubt. Genau wie der Minisforum N40 wird das Dongle auch bei max. Verstärkung von 20dBm nicht warm.

Der Einsatz des Dongles mit Zigbee2MQTT ist problemlos und es liefert „vernünftige“ LQI-Werte. Beim Raspbee II steigen diese mit der Zeit von 0 bis 255 und starten dann wieder erneut. Die Aussagekraft des Link Quality Indicators ist zwar begrenzt, aber stabile Werte sind dennoch von Vorteil.

Software: Home Assistant

Unverändert soll Home Assistant in der „Container„-Edition zum Einsatz kommen, in Verbindung mit Zigbee2MQTT. Jedoch werden die bestehende Installation und Konfiguration verworfen und neu aufgebaut. Nach diversen Iterationen des technisch „Machbaren“ gebe ich dem Wunsch meiner Eltern nach und reduziere auf „das Nötigste“: Licht an bei Bewegung in der Dunkelheit.

Auf dem Gelände sind mehrere, batteriebetriebene Bewegungssensoren von Philips Hue verteilt. Diese werden via Automatiken in Home Assistant mit einen oder mehreren Gruppen von Leuchten verbunden und agieren entsprechend – aber nur wenn es draußen dunkel ist.

Die „Sun„-Integration von HA wird verwendet, um über Dunkelheit zu entscheiden: Sie beginnt 15min nach Sonnenuntergang und endet 30min vor Sonnenaufgang. Alternativ kann die tatsächliche Helligkeit als Indikator dienen, denn die Hue Sensoren liefern ensprechene Angaben. Damit wären dunkle Phasen tagsüber abgedeckt (z.B. bei schlechtem Wetter).

Für meine Belange habe ich ein Repository auf Github angelegt, welches aber ausreichend generisch ist und auch für andere Einsteiger hilfreich sein könnte. Quelle und Instruktionen finden sich unter https://github.com/m0wlheld/homeassistant-zigbee2mqtt/.

Leider bedeutet ein Wechsel der Zigbee-Controller-Plattform (von Raspbee II auf den TI CC2652P des Sonoff Dongle) immer auch eine erneute Einbindung (Pairing) der Zigbee-Geräte. Ein Wochenende mit Leiter, Schraubendreher und Wäschekörben voller smarter LEDs ist also garantiert …

Der Beitrag Neue Hardware für den Zigbee-Hub und Home Assistant erschien zuerst auf dahlen.org.

Die Voraussetzungen zur Installation bei meinen Eltern könnten nicht stärker vom eigenen Haushalt abweichen: Es war nicht nur ist eine fast 30-fach größere Fläche abzudecken, sondern die Installation muss sich unauffällig, autonom und wartungsfrei verhalten. Die Abhängigkeit von Apps war (mangels geeigneter Telefone) ebenso zu vermeiden, wie proprieätere Cloud-Lösungen.

Aufgrund der deutlich größeren, abzudeckenden Fläche und den eher mässigen Erfahrungen mit Homematic-Hardware im eigenen Haus, wurde mit Zigbee diesmal auf ein „Mesh“-Netzwerk gesetzt. Dabei sind die Geräte auch untereinander und nicht nur mit einer zentralen Stelle (sternförmig) vernetzt. Theoretisch und praktisch sind damit auch größere Entfernungen zwischen dem adressierten Endgerät und der steuernden Einheit (Router) möglich.

Primäres Ziel der Installation war eine „smarte“ Außenbeleuchtung von Mühle und Garten, welche bis dato noch über Wandschalter bzw. mechanische Uhrwerke in Schaltkästen geregelt ist. Weitere Anwendungsfälle (z.B. Steuerung der Teichfilter) werden folgen.

Hardware

Probleme mit USB 3.0

Eine Warnung vorweg, damit ich als einziger mir die Nächte um die Ohren geschlagen habe: Die Verwendung eines USB 3.0 Gerätes, z.B. eines USB-Sticks in unmittelbarer Nähe des Raspbee II führt zu vielfältigen Problemen. Die Ursache ist bekannt, scheint grundsätzlich zu sein und lässt sich mit einer USB-Verlängerung, Alu-Folie oder der Verwendung einer SD-Karte lösen.

Die notwendige Hardware habe ich rechtzeitig vor Weihnachten im Versandhandel organisiert. Dass Einzelhändler vor Ort entsprechende Gerätschaften im Regal haben ist eh schon un­wahr­scheinlich, spätestens mit dem 2. Lockdown war dann auch der Weg dorthin obsolet.

Zigbee Koordinatoren (auch als „Hub“ oder „Bridge“ vermarktet) gibt es zu Hauf. Die bekannteste Variante ist sicherlich die Philips Hue Bridge. Üblicherweise sind diese „Appliances“ auf Apps und Cloud-Services des Herstellers ausgerichtet. Im Bereich Heim-Automatisierung ist Zigbee aber nur eine Komponente von vielen und darum kam auch in diesem Projekt ein alter Bekannter zum Einsatz.

Raspberry Pi 4B 4GB

Es hat sich bei meinen eigenen Installation gezeigt, das die CPU eines Raspberry Pi 3 ausreichend potent ist, aber der Speicher gerade beim Einsatz mit Home Assistant schnell an seine Grenzen gerät. Darum habe ich zum Raspberry Pi 4B mit 4GB gegriffen, welcher für ca. 60 EUR erhältlich ist.

Erstmalig kamen dabei auch das Orignal Raspberry Pi USB-C Netzteil, sowie das passende Gehäuse zum Einsatz.

Der Setup erfolgte natürlich wieder „headless“ (via LAN), auf ein Micro-HDMI-Kabel konnte also verzichtet werden.

Raspbee II

Beim Raspbee II handelt es sich um die on-board-Variante eines Zigbee Coordinator Moduls von dresden-elektronik, welches unter der Marke Phoscon vertrieben wird. Es wird auf die General Purpose IO (GPIO)-Leiste eines Raspberry Pi gesteckt und als serielles Gerät angesprochen.

Mit an Bord ist außerdem eine batteriegestützte Real Time Clock, also eine Echtzeituhr. Die Einrichtung und Nutzung ist aus der Produktseite des Raspbee II beschrieben und sei hier nur am Rande erwähnt.

Die Installation auf dem Raspberry Pi ist denkbar einfach: Das Raspbee II-Modul wird auf das äußerste Ende der GPIO-Leiste gesteckt, so dass die eigentliche Platine über den Raspberry kommt und in Richtung USB-C-Port zeigt.

Das Modul baut sehr flach, so dass sowohl der Einsatz eines moderaten CPU-Kühlkörpers, als auch eines flachen Gehäuses möglich ist. Das Gehäuse sollte aber aus Kunststoff sein, um die Reichweite der Funksignale nicht unnötig zu reduzieren. Ich habe – wie gesagt – auf das Original gesetzt.

Wer lieber auf eine externe Lösung setzt, der kann statt des Raspbee II auch die USB-Variante namens Conbee II verwenden. Dann kommen allerdings andere Einstellungen zum Einsatz, die ich hier nicht beschreibe.

OSRAM Smart+ Classic E27 / Plug 01

Die beiden „Smart+ Bulbs“ von OSRAM wurden als Proof-of-Concept beschafft. Es handelt sich um „retrofit“ Leuchtmittel für die E27 Fassung mit steuerbarer Helligkeit. Mit einem Preis von rund 10 EUR pro Stück sind sie erschwinglich, aber auch ohne Schnick-Schnack. Im Betrieb sind sie aktuell unauffällig.

Auch andere zertifizierte Zigbee-Leuchtmittel sollten funktionieren. Bei OSRAM gilt es aufzupassen, denn unter dem Schlagwort „Smart+“ werden auch andere Technologien wie WLAN oder Bluetooth vermarktet.

Ebenfalls gekauft wurde ein OSRAM Smart+ Outdoor Plug, also eine Steckdose für den Außenbereich. Ein Riesen-Trümmer (siehe Aufmacher-Bild), obwohl mit Schutzart IP44 nur grundsätzlich gegen Wettereinfluß geschützt. In Zukunft kommen sicherliche schmalere Lösungen zum Einsatz, aber für den Moment war diese intern „Plug01“ genante Steckdose verfügbar und preislich attraktiv – gekauft.

In Summe haben die oben genannten Hardware und weitere Teile wie Gehäuse, Netzteil, SD-Karte ca. 130 EUR gekostet. Deutlich mehr als ein Philips Hue Starter Kit, aber auch deutlich flexibler, leistungsfähiger und ohne App- oder Cloud-Zwang.

Software

Ursprünglich hatte ich vor, erstmalig Home Assistant OS (vormals HASS.IO) zu verwenden, eine Distribution welche auf den Betrieb von Home Assistant ausgerichtet ist und auf Docker und einen „Supervisor“ setzt.

Leider ist es mir innerhalb der persönlichen Toleranzzeit (ca. 30min) nicht gelungen, eine nutzbare Installation zu erstellen. Durch das Supervisor-Konzept sind notwendige Eingriffe in das Betriebssystem bzw. die Kernel-Konfiguration nur aufwändig zu realisieren.

Raspbian Linux

Also kam wieder Raspbian Linux zum Einsatz, welches auch als „Raspbian Pi OS“ vermarktet wird. Die eigentliche Installation beschreibe ich an dieser Stelle nicht mehr, es finden sich bereits entsprechende Artikel in diesem Blog. Die 32-Bit „lite“-Variante ohne Desktop ist ausreichend.

Bevor das fertige Installationsmedium (SD-Karte) in den Raspberry gesteckt und dieser gestartet wird, sollten noch folgende Änderungen am Inhalt der ersten Partition vorgenommen werden. Dabei ist ein Editor zu verwenden, welcher Zeichenkodierung und Zeilen-Enden beibehält. Unter Windows können das z.B. Wordpad oder Visual Studio Code sein:

1. aus der Datei cmdline.txt wird folgender Eintrag entfernt:
   console=serial0,115200
2. die Datei config.txt wird um folgende Zeilen ergänzt (die Leerzeile am Dateiende muss erhalten bleiben):
   enable_uart=1
core_freq=250
dtoverlay=miniuart-bt

Optional kann noch eine (leere) Datei namens „ssh“ angelegt werden, damit ein Login via Secure Shell möglich ist. Danach kann die SD-Karte in den Raspberry Pi und dieser mit Strom versorgt werden. Nach einigen Sekunden bis Minuten sollte ein neuer Host „raspberrypi“ im heimischen Netz auftauchen.

Docker

Docker ist eine Plattform zur Prozess-Virtualisierung mithilfe von Containern. Sie erleichtert den Betrieb von Home Assistant erheblich, weil hier Abhängigkeiten auf Bibliotheken und Versionen des Betriebssystems vermieden werden.

Die Installation von Docker habe ich bereits in einem eigenen Artikel beschrieben: Docker und Raspbian auf einem Raspberry Pi.

Home Assistant

Home Assistant ist meine bevorzugte Plattform zur Heim-Automatisierung, da sie einfach zu installieren ist (insbesondere unter Verwendung von Docker). Kein Grund also nach einer Alternative für das neue Projekt zu suchen.

Wurden das Raspberry Pi OS (AKA Raspbian) und die Docker-Umgebung korrekt aufgesetzt (inkl. Neustart), so ist die Ausführung von Home-Assistant ein Klacks.

Im Wesentlichen gibt es zu meinem Artikel „Home Assistant mit Docker auf Raspberry Pi betreiben“ nur eine relevante Änderung: Der Zugriff auf das Raspbee II Modul muss durch das „mappen“ des entsprechenden seriellen Devices in den Container ermöglicht werden. Der vollständige Aufruf lautet also:

docker run -d \
  --name=home-assistant \
  --restart=always \
  --publish 8123:8123 \
  -v $PWD/home-assistant:/config \
  -v /etc/localtime:/etc/localtime:ro \
  --device=/dev/ttyAMA0 \
  homeassistant/home-assistant:stable

Hinweis: Alternativ zu „–publish 8123:8123“ kann „–net=host“ verwendet werden. Dies bindet den den Home Assistant Container an das Netzwerk des Hosts und es werden beim Start Integrationen zu allen im Netzwerk gefundenen Geräten angeboten.

ZHA Integration

Finaler Schritt der Einrichtung ist die Installation und Konfiguration des Zigbee Coordinators in Home Assistant. Dazu gibt es für das Raspee II Modul zwei Möglichkeiten:

1. direkte Kommunikation mit dem Modul über die „Zigbee Home Automation“-Integration
2. indirekte Kommunikation über einen zwischengeschalteten deCONZ-Service und die entsprechende „deCONZ“ Integration.

Ich habe mich für Variante 1 entschieden, weil sie keine weitere Abhängig­keit erzeugt und für meine Zwecke ausreichend ist. Sie kann auch die Firmware für OSRAM/Ledvance und IKEA-Leuchten „over the air“ aktualisieren.

Sobald Home Assistant läuft, auf Port 8123 erreichbar ist und man die Basis-Einrichtung vorgenommen hat (Benutzer, Standort, Zeitzone, etc.), geht es über den Pfad „Einstellungen -> Integrationen“ zur Schaltfläche „+ Integration Hinzufügen“

Im resultierenden Dialog sucht man nach „zig“ (oder „zigbee“) und wählt das Ergebnis „Zigbee Home Automation“ aus.

Im folgenden Dialog ist das serielle Gerät für das Raspbee II Modul zu wählen. Der einzig angebotene Wert an dieser Stelle sollte /dev/ttyAMA0 sein.

Nach der Auswahl wird das serielle Gerät analysiert und es wird automatisch das deCONZ-Protokoll für die Kommunikation zwischen Raspberry Pi und dem Modul gewählt (auch ohne dedizierte deCONZ Installation nach Variante 2).

Mit der (optionalen) Auswahl eines Bereichs (also der Position des Raspberry Pi im Haus) ist die Installation abgeschlossen. Home Assistant ist nun bereit Zigbee-Geräte abzufragen und zu steuern.

Natürlich müssen die Geräte noch am Coordinator angelernt werden, dies ist aber in der Dokumentation der Integration beschrieben. Der schnellste Weg ist über Einstellungen -> Geräte und der Auswahl des Zigbee Coordinator. Alternativ kann auch Einstellungen -> Integrationen und die Auswahl der ZHA Integration verwendet werden.

Fazit

Die Installation von Hard- und Software war – wenn man von der USB-Problematik absieht – überraschend einfach, was natürlich meinem technischen Hintergrund und den Erfahrung im eigenen Haus geschuldet ist.

Das Raspbee II-Modul ist in der Installation idiotensicher und im Betrieb stabil. Seine Bauform erlaubt den Aufbau eines kompakten Zigbee Hubs mit deutlichem Mehrwert gegenüber einer fertigen „Appliance“, wie der Hue-Brige.

Die Zigbee-Geräte verhalten sich bis dato unauffällig und funktionieren einfach. Das Anlernen und die Visualiserung des Netzes in Home Assistent sind ein absolutes Plus.

Weiterführende Informationen

Software und Dokumentation

• Produktseite Raspberry Pi 4B
• Raspbian Linux (oder auch Raspberry Pi OS)
• Produktseite Phoscon Raspbee II
• Produktseite Phoscon Conbee II
• Homepage Home Assistant
• Home Assistant OS
• Zigbee Home Automation Integration
• Phoscon deCONZ Integration
• Webseite der Zigbee Home Alliance
• Webseite von Docker Inc.

Produkte*

• Phoscon Raspee II kaufen
• Raspberry Pi 4B 4GB kaufen
• Raspberry Pi Original Netzteil für Modell 4B
• Raspberry Pi Original Gehäuse für Modell 4B
• OSRAM Smart Classic E27 Zigbee Leuchtmittel
• OSRAM Smart Outdoor Plug
• Philips Hue Starter Kit mit Bridge und 2 Leuchtmitteln

Der Beitrag Zigbee Hub mit Raspberry Pi und Raspbee II erschien zuerst auf dahlen.org.

Im privaten Umfeld stehen die verwandten Themen Heimautomatisierung und Smart Home im Fokus. Eine sehr gute Basis dafür sind ein Raspberry Pi 3, Docker und Home Assistant …

In den letzten beiden Jahren habe ich viel Zeit (und Geld) in die Vernetzung unseres Heims gesteckt. Bereits vorhandene Gerätschaften (wie Computer, AV-Receiver und Fernseher) wurden um neue Aktoren zum Schalten und Sensoren zum Messen ergänzt.

Im Mittelpunkt der Installation stehen dabei ein Raspberry Pi 3 und Home Assistant.

Raspberry Pi 3

Der Raspberry Pi 3 ist die ideale Plattform für Heimautomatisierung, nicht nur für Home Assistant. Er ist ausreichend schnell, bietet ausreichend Speicher und seine USB- und GPIO-Ports können für die Anbindung diverser Systeme und Standards (ZWave, Zigbee) genutzt werden. Außerdem verbraucht er minimal Strom und kann daher ohne Belastung des Öko-Gewissens 24/7 betrieben werde.

Dieser Artikel geht entsprechend davon aus, dass ein Raspberry Pi 3 mit einem aktuellen Raspbian Linux versorgt wurde und im heimischen Netz via LAN der WLAN erreichbar ist. Für Unterstützung bei der Einrichtung kann auf meine anderen Artikel zu diesem Thema zurückgegriffen werden.

Die Zusammenführung der teilweise isolierten Systeme übernimmt dabei die Software Home Assistant. Es gibt viele Wege Home Assistant auf einem Raspberry Pi zu installieren und alle sind hervorragend dokumentiert. Allerdings habe ich mich weder für eine direkte Installation via pip, noch für die Verwendung von hass.io entschieden, sondern für einen Mittelweg: Docker.

Docker

Der Grund ist einfach: Ich verwende auf dem Raspberry Pi Raspbian, also ein Debian Derrivat. Und die Paketverwaltung von Debian ist apt. Die Verwendung anderer Paketmanager, wie pip für Python oder npm für NodeJS, führt m.E. nur zu Chaos.

Andererseits möchte ich den Raspi nicht in eine Appliance verwandeln, sondern durchaus auch mit anderen Aufgaben bedenken. Ansätze wie HASS.IO oder Hassbian erschwerden dies durch die notwendige Abschottung des unterliegenden Betriebssystems.

Software, welche nicht per apt zur Verfügung steht wird also in einem Docker Container betrieben, um die Auswirkungen auf das Hostsystem zu minimieren.

Installation von Docker

Docker ist aktuell in den Raspbian Repositories vorhanden (Paket docker.io) und könnte somit direkt via apt installiert werden. Doch die Entwicklung von Docker läuft schneller als die Release-Zyklen von Raspbian, so dass ich das offizielle Docker-Respository nutze, um die aktuellste Version via apt installieren zu können.

$ curl -sSL https://get.docker.com | sh

Wer sich in das ausgeführte Skript einarbeitet erkennt, dass hier lediglich die Schritte zur Anbindung des Docker Debian Respositories inkl. GPG-Key Download automatisiert werden. Sie können alle auch manuell ausgeführt werden, aber das Skript ist einfach convenient.

Damit wir docker als regulärer Benutzer ohne sudo ausführen können, fügen wir – wie empfohlen – den aktuellen Benutzer der Gruppe docker hinzu. Der hier bespielhaft genannte Account pi ist durch den tatsächlichen Benutzernamen zu ersetzen:

$ sudo usermod -aG docker pi

Nach einer Ab- und Anmeldung sollte sich nun ein erster Docker Container ausführen lassen:

$ docker run --rm hello-world

Home Assistant

Nun da Docker einsatzbereit ist, können wir Home Assistant installieren und im Container betreiben. Für diese Einführung belasse ich die Konfiguration von Home Assistant unverändert, d.h.:

• es wird die integrierte SQLite Datenbank verwendet
• die Home Assistant Oberfläche ist auf Port 8123 zu erreichen
• die discovery-Komponente durchsucht das lokale Netz nach bekannten IoT-Geräten

Installation von Home Assistant mit Docker

Docker Container sind vergänglich (ephemeral), ebenso wie die in ihnen verwendeten Daten. Um Konfiguration und andere Laufzeitdaten zu persistieren, müssen wir Docker einen Platz zum Speichern außerhalb des Containers zuweisen. Dort wird Home Assistant seine initiale Konfiguration erzeugen und dauerhaft verwenden.

Zunächst erstellen wir ein lokales Verzeichnis (der Name ist beliebig):

$ cd ~
$ mkdir home-assistant

Anschließend starten wir unseren Container auf Basis des offiziellen Home-Assistant Images für den Raspberry Pi 3:

$ docker run -d  \
  --name=hass --net=host --restart=always \
  -v $PWD/home-assistant:/config \
  -v /etc/localtime:/etc/localtime:ro \
  homeassistant/raspberrypi3-homeassistant:latest

Durch obigen Befehl wird die aktuelle Version des Docker Image (und seine Basis) von Home Assistant für Raspberry Pi 3 heruntergeladen und ein darauf aufbauender Container namens „hass“ wird gestartet. Das lokale Verzeichnis home-assistant und die Zeitzone werden in den Container eingebunden. Die genaue Bedeutung der Parameter kann per $ docker run --help ermittelt werden.

Der Vorgang dauert ein wenig, aber nach einigen Sekunden sollte das Web-Interface von Home Assistant über den DNS-Namen oder die IP-Adresse des Raspberry zugänglich sein, z.B. http://raspberrypi:8123/.

Der tatsächliche Inhalt des Willkommen-Bereichs kann sich unterscheiden, da die in Home Assistant enthaltene Discovery Komponente möglicherweise Geräte (z.B. Philips Hue, Google Home oder Sonos Lautsprecher) bereits aufgespürt und eingebunden hat.

Konfiguration von Home Assistant

Das lokale Verzeichnis (home-assistant) wurde dem Container zur Verfügung gestellt. Entsprechend hat Home Assistant hier seine initiale Konfiguration abgelegt. Da der Container mit den Rechten des aktuellen Benutzers gestartet wurde, sind auch die Konfigurationsdateien in seinem Besitz. So kann jetzt mit einem Editor (z.B. vi oder nano) die grundsätzliche Konfiguration unter home-assistant/configuration.yaml bearbeitet werden. Beispielhaft kann der Eintrag „introduction:“ (ca. Zeile 17) entfernt werden, um den Einführungstext zu verwerfen.

Neustart von Home Assistant

Bei Änderung der Core-Konfiguration ist Home Assistant neu zu starten. Auch wenn dies über die Web-Oberfläche möglich ist (unter Einstellungen), ist der Neustart des Docker Containers oft die schnellere Lösung:

$ docker restart hass

Aktualisierung des Containers

Etwa alle 2 Wochen erscheint eine neue Version von Home Assistant, dazwischen werden Minor Releases mit Korrekturen veröffentlicht. Auch die Docker Images werden dabei zeitnah aktualisiert und können für neue Container-Instanzen verwendet werden. Existierende Container verwenden jedoch immer ihr ursprüngliches Image, daher ist die laufende Instanz zunächst zu löschen (keine Sorge, die Konfiguration im lokalen Verzeichnis bleibt bestehen):

$ docker rm -f hass

Anschließend kann ein neuer Container wie oben beschrieben gestartet werden.

Fazit

Der Einstieg in die Heim-Automatisierung ist einfach und kostengünstig möglich. Viele Geräte im Haushalt sind bereits netzwerk-fähig und können über diese Schnittstelle überwacht oder gesteuert werden. Andere dienen als einfache Sensoren, so kann ein Router zur Erkennung anwesender Mobiltelefone beitragen. Und nicht zuletzt existiert bereits eine Fülle von Internet-Diensten, welche als Signale in der Steuerung des Smart Home genutzt werden können.

Home Assistant ist eine einfach zu installierende und leicht zu verwendende Software, welche wie geschaffen für einen Raspberry Pi (3) ist. Die gute Dokumentation und eine aktive Community erleichtern den Einstieg und stehen für Fragen und Ratschläge zur Verfügung.

Weiterführende Informationen

Software und Dokumentation

• Home Assistant
• Home Assistant: Getting Started
• Home Assistant: HASS.IO
• Home Assistant Forum
• Raspbian Linux
• Raspberry Pi 3 Modell B für USB Boot vorbereiten
• Raspberry Pi Zero W headless Setup – so geht’s
• Docker Comes to Raspberry Pi
• Home Assistant: Docker Image für Raspberry Pi 3

Produkte*

Die folgenden Produkte wurden im Artikel besprochen bzw. verwendet:

• Raspberry Pi 3 Modell B

Der Beitrag Home Assistant mit Docker auf Raspberry Pi betreiben erschien zuerst auf dahlen.org.