Der Bus zeichnet sich auf, während du weg bist.
Vorschau Die Busclear Box ist ein Raspberry Pi, der rund um die Uhr jedes Telegramm mitschreibt und ein eigenes WLAN aufspannt. Eingerichtet wird sie mit der App: heute mit der Linux-App, bald per QR-Code mit iPhone, iPad und Android. Ohne Home Assistant und ohne Internet.
Was du brauchst.
Für die Vorbereitung am Schreibtisch rund eine halbe Stunde, ohne Vorkenntnisse in Linux.
- Raspberry Pi
- Pi 4 (getestet) oder Pi 5 mit passendem Netzteil (Pi 5: 27 W USB-C), Details unter Hardware
- SD-Karte
- microSD ab 16 GB und ein Kartenleser für den Rechner
- Rechner
- Windows, Mac oder Linux mit dem kostenlosen Raspberry Pi Imager
- Netzwerkkabel
- Vom Pi zum Router oder Switch, an dem das KNX-IP-Gateway hängt; entfällt für den Bus mit dem kBerry
- Gateway
- Ein freier Tunnelplatz, Home Assistant oder die ETS belegen oft schon einen. Oder statt Gateway das Aufsteckmodul kBerry
- App
- Heute die Linux-App, bald auch iPhone, iPad und Android
- Drucker
- Optional, für das Blatt mit den zwei Aufklebern und den Zugangsdaten
Einmal vorbereiten, dann nur noch koppeln.
Image und Aufkleber entstehen einmal am Schreibtisch. Auf der Baustelle braucht es danach nur Kabel, Strom und die App.
- Laden
- Image laden (Knopf oben, Datei
knx-box-….img.xz). Nicht entpacken, der Imager liest es so. - Schreiben
- Im Raspberry Pi Imager: Gerät wählen (Pi 4 oder Pi 5), bei Betriebssystem ganz unten „Eigenes Image“ und die geladene Datei, dann die SD-Karte. Die Frage nach Anpassungen mit „Nein“ beantworten: Name, WLAN und Passwörter legt die Box selbst an.
- Erster Start
- SD-Karte in den Pi, Strom anschließen, ein Netzwerkkabel braucht es dafür noch nicht. Nach wenigen Minuten erscheint das WLAN „KNX-Box-…“. Dann noch eine Minute warten und den Strom ziehen.
- Karte lesen
- SD-Karte zurück in den Rechner und
knx-box-de.pdfausdrucken (englisch:knx-box-en.pdf). Auf dem Blatt steht alles: zwei Aufkleber zum Ausschneiden (1 für die App oben auf die Box, 2 mit dem WLAN auf den Boden), WLAN- und Box-Passwort, der Link für die Linux-App und die nächsten Schritte. Gut aufheben, dann die Karte zurück in den Pi. Einzeln liegen daneben die QR-Codes als Bild (knx-box-app.png,knx-box-wlan.png), der Link alsknx-box-link.txtund die Werte inknx-box.txt. - Anschließen
- Netzwerkkabel zum Router oder Switch am Gateway, dann Strom. Nach etwa einer Minute ist die Box bereit.
- Koppeln
- In der App „Busclear Box hinzufügen“ und den Aufkleber scannen. Die App tritt dem WLAN der Box bei, koppelt sich, stellt die Uhr und sucht das Gateway. Gibt es genau eins, ist es gleich eingestellt, und die Box zeichnet auf.
- Mit Linux
- Linux-App laden, entpacken und im Ordner
bundle./install.shausführen: Es installiert Busclear ins App-Menü, der Download kann danach weg. Am Rechner ins WLAN „KNX-Box-…“ wechseln (WLAN-Passwort ausknx-box.txt). In der App „Busclear Box hinzufügen“ und den Inhalt vonknx-box-link.txteinfügen; den Rest erledigt die App wie oben. - Ohne App
- Ohne App geht es auch: Der zweite QR-Code (
knx-box-wlan.png) verbindet mit dem WLAN der Box, dann im Browserknx-box.localöffnen und mit dem Box-Passwort anmelden.
Was die App für dich auf die Box legt.
Alles, was die Box wissen muss, kommt aus der App. Du musst nichts kopieren.
- Gateway
- Findet die Box an ihrem Kabel selbst; bei mehreren wählst du in der App.
- ETS-Projekt
- Importierst du in der App, legt sie es auch auf die Box. Dann kennt die Box Namen, Datentypen und den Zeitgeber.
- Keyring
- Für KNX Secure ebenso: Die Box zeichnet gesicherte Telegramme lesbar auf.
- Verlauf
- Zeigt die App direkt von der Box, Tag für Tag, mit Wiedergabe und Export.
- Speicher
- Auf einer USB-SSD mit dem Namen
KNXBOXDATA, sonst auf der SD-Karte, in beiden Fällen unverschlüsselt. Bei fünf Telegrammen pro Sekunde roh etwa 43 MB am Tag.
Startet von selbst, hört nicht auf.
Sobald ein Gateway eingestellt ist, zeichnet die Box auf. Es gibt nichts zu starten und nichts zu vergessen.
- Dauerbetrieb
- Ein Tunnel bleibt offen, jedes Telegramm landet in einer Tagesdatei, auch wenn kein Gerät verbunden ist.
- Uhr
- Ohne Internet: Die Box stellt ihre Uhr nach dem iPhone oder iPad, das sich verbindet, oder nach dem KNX-Zeitgeber auf der Linie (DPT 19.001, 10.001 + 11.001).
- Bis dahin
- Zeichnet die Box schon auf und ordnet die Zeit nachträglich zu. Oder sie wartet, wenn du „Erst aufzeichnen, wenn die Zeit stimmt“ einschaltest.
- Stromausfall
- Nach dem Neustart verbindet sich die Box wieder und schreibt weiter; verloren gehen höchstens die letzten Sekunden. Ohne Echtzeituhr startet die Uhr beim zuletzt gespeicherten Stand (höchstens etwa 15 Minuten zurück), bis sie gestellt ist; so lange packt und löscht die Box nichts nach Alter. Systemprotokoll und Grund des letzten Neustarts bleiben erhalten.
- Aufbewahrung
- Standardmäßig sieben Tage, bis zu zehn Jahre.
- Pausieren
- Gibt den Tunnel frei, etwa wenn die ETS den einzigen Platz am Gateway braucht.
Über IP oder direkt am Bus.
Die Box hängt per Netzwerkkabel am KNX-IP-Gateway oder IP-Router. Seit 1.8.4 sitzt sie auf Wunsch auch direkt an der Linie: mit dem Aufsteckmodul kBerry, ganz ohne IP-Gateway.
- IP
- KNXnet/IP-Tunnel oder Routing, auch KNX IP Secure. Die Box belegt einen Tunnelplatz am Gateway.
- TP mit kBerry
- Busleitung direkt an die Box: über das Aufsteckmodul KNX BAOS 838 kBerry von Weinzierl auf der Stiftleiste des Pi. Verbindungsart „KNX-HAT (kBerry)“ im Expertenmodus. Kein Gateway nötig, kein Tunnelplatz belegt.
- Anleitung
- Vorschau: Wie der kBerry auf den Pi kommt, wie der Pi vorbereitet wird und wie das passende Gehäuse zusammengebaut wird: Anleitung für Bastler (PDF, Vorschau).
- Busmonitor
- Über TP sieht die Box auch, was ein Tunnel nie zeigt: Quittungen (ACK, NAK, BUSY) und Wiederholungen. In dieser Betriebsart kann sie nicht senden.
- Adresse
- Zum Mithören braucht die Box keine physikalische Adresse und keine ETS-Programmierung.
- Stand
- Vorschau: auf einem Pi 4 am echten Bus geprüft, auf dem Pi 5 und im Dauerbetrieb noch nicht. Mehr im Issue auf GitHub.
Was in den Koffer gehört.
- Rechner
- Raspberry Pi 4 (getestet) oder Pi 5 mit 2 oder 4 GB; ein Pi 3 mit 64-Bit-System reicht für die Aufzeichnung
- Uhr
- Empfohlen für den Pi 5: der RTC-Akku. Dann stimmt die Zeit schon vor dem ersten iPhone. Der Pi 4 hat keine Uhr; ein DS3231-Modul richtet das Image nicht selbst ein.
- Strom
- Netzteil mit 27 W (USB-C); schwächere führen unter Last zu Abstürzen
- Kontrolle
- Die Box-Einstellungen zeigen unter „Raspberry Pi“ Temperatur und Höchstwert seit dem Start und warnen bei Unterspannung oder Drosselung, auch im geschlossenen Gehäuse ohne SSH.
- Speicher
- USB-SSD oder NVMe, 128 GB reichen für Jahre
- Gehäuse
- Vorschau: Gehäuse zum Drucken (STL, Zip) für Pi 3B bis 5 mit kBerry: schlanker Deckel, Modulbrücke, USB-Abdeckung, ein Boden für die Hutschiene mit angeschraubtem Federclip (empfohlen: Variante 1, wird noch nachgebessert) und Proben für Einschmelzgewinde und Deckel. Bei 0,2 mm Schichthöhe drucken. Beschreibung im README.md darin. Die Passform ist erst am Modell geprüft.
- Rest
- Netzwerkkabel, die zwei Aufkleber vom Blatt; für den direkten Busanschluss das Aufsteckmodul kBerry
Eine Vorschau, ehrlich gesagt.
Das Image wird automatisch gebaut und läuft in der Testumgebung und auf einem Raspberry Pi 4 am echten Bus. Im Dauereinsatz auf einer Baustelle hat es noch niemand geprüft. Meldungen dazu sind sehr willkommen.
- App
- Die Box arbeitet mit der App: Einrichten, Projekt und Verlauf laufen über sie, der Browser ist nur ein Notbehelf (siehe Einrichten). iPhone, iPad, Android, Mac und Windows erscheinen in den nächsten Wochen; bis dahin nimm die Linux-App.
- Gateway
- Ein Gateway mit fester Adresse direkt am Kabel der Box geht noch nicht; dafür braucht es den Switch.
- WLAN
- Selbst beitreten kann die App auf iPhone, iPad und Android ab Version 10; unter Linux, Mac und Windows trittst du einmal selbst bei.
- Alarme
- Ohne Internet gibt es keine Mitteilungen aufs Handy.
- Rückmeldung
- Fehler und Erfahrungen gern als Issue auf GitHub.
Häufige Fragen zur Box
Brauche ich einen PC?
Einmal am Schreibtisch: zum Schreiben des Images, zum Lesen der SD-Karte und zum Ausdrucken des QR-Codes. Bis iPhone, iPad und Android erscheinen, koppelst du die Box mit der Linux-App; danach reicht auf der Baustelle das Handy oder Tablet.
Brauche ich Home Assistant?
Nein. Die Box ist dieselbe Software wie das Home-Assistant-Add-on, nur als eigenes Gerät. Wer Home Assistant OS hat, nimmt besser das Add-on. Mit Home Assistant Container bindet die Integration „Busclear“ die Box ein.
Welcher Raspberry Pi reicht?
Getestet ist der Raspberry Pi 4. Ein Pi 3 mit 64-Bit-System sollte für die Daueraufzeichnung reichen, lange Auswertungen dauern dort aber länger. Pi 2 und der erste Pi Zero gehen nicht, es gibt nur 64-Bit-Builds.
SD-Karte oder SSD?
Beides geht, für den Verlauf über mehrere Monate ist eine SSD besser. Die Box schreibt die Telegramme gesammelt alle 5 Sekunden statt einzeln, das schont auch SD-Karten. Abgeschlossene Tage werden gepackt, rund 20 MB pro Million Telegramme.
Belegt die Box einen Tunnel am Gateway?
Über IP ja, genau einen, rund um die Uhr. Alle iPhones und iPads im WLAN der Box teilen sich diesen Tunnel. Braucht die ETS den einzigen freien Platz, pausierst du die Box. Direkt an der Linie mit dem kBerry entfällt das.
Kommen Geräte im WLAN der Box ins Kundennetz?
Nein. Die Firewall trennt das WLAN der Box vom Netz am Kabel. Nur wer in knx-box.txt INTERNET_SHARING=yes setzt, gibt den Geräten im WLAN Zugang nach draußen.
Kommt der Kunde über sein Netz an die Box?
Nein. Über das Kabel antwortet die Box standardmäßig gar nicht, nur in ihrem eigenen WLAN. Für die eigene Box im eigenen Netz schaltest du den „Zugriff über das Kabel“ in der App unter Box-Einstellungen frei, oder vor dem ersten Start mit LAN_ACCESS=yes in knx-box.txt.
Was passiert, wenn jemand die Box mitnimmt?
Wer den Aufkleber hat, kann sich koppeln. Deshalb schlägt die App direkt nach dem Koppeln vor, ein eigenes Box-Passwort zu setzen; danach koppeln Aufkleber und SD-Karte keine neuen Geräte mehr. Unter Box-Einstellungen änderst du es später und sperrst Geräte, die du nicht mehr brauchst.
Wie gut sind die Daten auf der Box geschützt?
Ohne Box-Passwort oder gekoppeltes Gerät kommt niemand an Daten oder Bus; das Passwort liegt nur als Hash auf der Box. Zwei Grenzen: Projekt und Verlauf liegen unverschlüsselt auf SD-Karte oder SSD, wer den Datenträger hat, kann sie lesen. Und im WLAN der Box läuft die Verbindung ohne TLS, das WLAN-Passwort ist dort der eigentliche Schutz. Stell die Box also nicht frei zugänglich auf. Von sich aus schickt sie nichts an uns; hat sie Internet, stellt sie darüber ihre Uhr.
Darf ich den Bus in einem bewohnten Haus mitschneiden?
Ein Busmitschnitt zeigt, wann jemand da ist. Sprich das mit den Bewohnern ab und stell die Aufbewahrung so kurz wie möglich ein.