Das ist der dritte Teil der Serie über die Gasanzeige für unser Zeltlager:
- Halter für die Zeltstange
- Der Sensor: Teardown, Reverse Engineering und Strom messen
- Die Arduino Software und erste Tests (dieser Artikel)
Im letzten Teil habe ich herausgefunden, wie die Ultraschallsensoren unter den Gasflaschen funken. Jetzt fehlt noch das Gerät, das sie alle abfragt und die Füllstände übersichtlich anzeigt.
Die Hardware
Die Anzeige ist ein TRMNL 7,5" DIY Kit: ein ePaper mit 800 × 480 Pixeln in Schwarz und Weiß, eine Treiberplatine mit XIAO ESP32 S3 Plus, drei Tasten und ein Akku mit 2000 mAh. Ziel war, dass die Anzeige mindestens vier Wochen ohne Laden durchhält, also ein ganzes Zeltlager. Gehäuse und Strommessung habe ich im Artikel über meine Zimmeranzeige beschrieben, den Halter für die Zeltstange im ersten Teil.
Statt der TRMNL Software, die fertige Bilder aus dem Internet lädt, läuft auf dem ESP32 eine eigene Firmware. Im Zeltlager gibt es kein WLAN, und die Sensoren sprechen ohnehin Bluetooth.
Vom Testsketch zur Firmware
Angefangen hat alles mit drei kleinen Testsketches auf einem ESP32 C6, die gleichzeitig mein Werkzeug fürs Reverse Engineering waren:
- v1 scannt nach Sensoren, zerlegt die Advertisements und markiert Bytes, die sich ändern. Ergebnis: Dort stehen keine Messwerte.
- v2 verbindet sich, abonniert die Characteristic und schreibt die Rohdaten mit Zeitstempel und Trenngrund mit.
- v3 dekodiert die Werte und rechnet sie gleichzeitig für Wasser und Flüssiggas um, inklusive Neigung und Batteriespannung. Über die serielle Konsole kann man einzelne Sensoren messen, alle reihum abfragen oder eine Live Ansicht starten.
Aus v3 ist dann die eigentliche Firmware entstanden. Sie ist in Module aufgeteilt, unter anderem für Bluetooth, Volumenrechnung, Anzeige, Menü, Tasten, Weboberfläche, Einstellungen und Stromsparen. Für Bluetooth nutze ich NimBLE Arduino, das deutlich schlanker ist als der Bluetooth Stack, der beim ESP32 mitkommt. Das Display steuert GxEPD2 an.
Die Anzeige
Gestaltung
Bevor ich eine Zeile Firmware für die Anzeige geschrieben habe, habe ich die Layouts als SVG entworfen. So ließen sich Varianten schnell vergleichen. Bei der Schrift fiel die Wahl nach einem Vergleich von sieben Kandidaten auf IBM Plex Sans Condensed: schmal genug für viel Text, aber auch klein noch gut lesbar.

Das Display kann nur Schwarz und Weiß. Grautöne entstehen deshalb als Raster aus diagonalen Linien mit 25 % Schwarz. Alle Flaschengrößen haben dieselbe Silhouette, die Größe steht weiß im Schutzkragen. In der Flasche stehen der Füllstand in Prozent und die Restmenge in Kilogramm, darunter das Alter des Messwerts und der Batteriestand des Sensors.
Für jede Anzahl von einer bis zehn Flaschen gibt es ein eigenes Layout. Bis fünf Flaschen stehen sie in einer Reihe, ab sechs in zwei Reihen.

Zustände
Jede Flasche kann vier Zustände haben:

- normal
- fast leer: standardmäßig unter 10 %, die Prozentzahl wird invertiert und ein Warndreieck erscheint
- Sensor ab?: wenn die Neigung deutlich von der beim Anlernen gemessenen Grundneigung abweicht, oder wenn kein Echo erkannt wurde, weil die Werte zu stark schwanken oder über der Flaschenhöhe liegen
- kein Signal: wenn ein Sensor sich zu lange nicht gemeldet hat, standardmäßig 2 Stunden

In der Kopfzeile stehen Zeitpunkt der Messung, der Akkustand und die geschätzte Restlaufzeit der Anzeige.
Messen
Alle 20 Minuten wacht der ESP32 aus dem Deep Sleep auf und fragt die Sensoren ab:
- Verbinden mit bis zu drei Sensoren gleichzeitig
- Benachrichtigungen abonnieren und auf den ersten Wert ungleich null warten, das dauert 7 bis 10 Sekunden
- 4 Sekunden weiter zuhören, um Ausreißer und fehlende Echos zu erkennen
- trennen, bei einem Fehler erneut versuchen
- Display aktualisieren und wieder schlafen
Bei jeder sechsten Messung sucht die Anzeige außerdem 4 Sekunden lang nach neuen, noch unbekannten Sensoren.
Echte Restmenge statt Höhe
Der Sensor liefert eine Füllhöhe. In der Küche interessiert aber, wie viel Gas noch drin ist. Bei einer stehenden Flasche mit gewölbtem Boden und Schulter hängen Höhe und Volumen nicht linear zusammen. Die Firmware rechnet deshalb jede Flasche als Zylinder mit zwei Böden in Form eines Halbellipsoids. Die Maße stammen aus dem Produktblatt eines Gashändlers, abzüglich etwa 3 mm Wandstärke:
| Größe | Innendurchmesser | Fassungsraum | Füllhöhe voll |
|---|---|---|---|
| 5 kg | 223 mm | 11,8 l | 27,0 cm |
| 11 kg | 294 mm | 27,2 l | 34,2 cm |
| 33 kg | 312 mm | 79,0 l | 87,2 cm |
„Voll“ ist dabei die Höhe, bei der genau die Nennfüllung in der Flasche ist, gerechnet mit einer Dichte von 0,51 kg/l für flüssiges Propan. Der Prozentwert ist der Volumenanteil zwischen leer und voll, die Restmenge in Kilogramm ergibt sich daraus direkt. Der Umrechnungsfaktor von Laufzeit auf Höhe ist standardmäßig 2,13 wie in der App und lässt sich in den Einstellungen korrigieren.
Bedienung
| Taste | Hauptbildschirm | Menü | Wert ändern |
|---|---|---|---|
| 1 | jetzt messen | nächster Eintrag | weniger |
| 2 | Sensor anlernen | auswählen | mehr |
| 3 | Menü | zurück, lang drücken: Hauptbildschirm | übernehmen |

Sensoren anlernen
Woher weiß die Anzeige, welcher Sensor unter welcher Flasche klebt? Die Sensoren sehen alle gleich aus und heißen nur BLE_ plus ein paar Zeichen der MAC Adresse. Hier hilft der Beschleunigungssensor aus dem letzten Teil: Zum Anlernen hält man einen Sensor einfach kurz hochkant. Die Anzeige sucht den Sensor, der gerade mehr als 60° geneigt ist, man wählt die Flasche aus, und die Zuordnung wird dauerhaft gespeichert.
Weboberfläche
Für alles, was sich mit drei Tasten mühsam einstellt, gibt es eine Weboberfläche. Dafür öffnet die Anzeige einen eigenen Hotspot „Gasanzeige“. Auf dem Display erscheint ein QR Code, man verbindet sich mit dem Handy und landet über ein Captive Portal direkt auf der Einstellungsseite. Dort lassen sich Namen, Sensoren und Flaschengrößen einstellen, die Einstellungen sichern und neue Firmware einspielen. Die Uhrzeit übernimmt die Anzeige dabei vom Handy, denn Internet für einen Zeitserver gibt es im Zeltlager nicht. Nach 5 Minuten schaltet sich der Hotspot wieder ab, um Strom zu sparen.
Bonus: Das Wasserfass
Weil auch das Trinkwasser ein ständiges Rätsel ist, kann seit Version 0.1.8 ein Platz auf der Anzeige statt einer Gasflasche das Wasserfass auf dem Anhänger sein. Es belegt zwei Plätze und hat ein eigenes Symbol: einen Anhänger in der Seitenansicht mit Fass, Wasser, Sensor und Messstrahl.

Das Fass ist ein liegender Zylinder mit gewölbten Böden, und es steht meistens nach hinten gekippt, damit das Wasser abläuft. Die Firmware rechnet beides mit ein: Innendurchmesser, Länge, Form der Böden und die Position des Sensors werden eingegeben, die Neigung kann aus, von Hand eingetragen oder automatisch vom Sensor übernommen werden. Weil der Sensor nur ganze Grad liefert, bleibt eine Unsicherheit: 1° Neigungsfehler macht bei 1 m Abstand zum Sensor etwa 1,7 cm Wasserhöhe aus.

Reicht der Akku?
Ohne Sensoren hält die Anzeige bei 20 Minuten Intervall gemessen etwa 285 Tage. Wie viel Ladung eine Abfrage pro Sensor auf der Seite der Anzeige kostet, habe ich noch nicht gemessen. Die Firmware rechnet vorsichtig mit 0,06 mAh pro Sensor und Abfrage. Damit wären es mit fünf Sensoren etwa 60 Tage und mit zehn Sensoren etwa 34 Tage. Das Ziel von vier Wochen wäre also auch mit zehn Flaschen erreicht.
Der richtige Test kommt im August im Zeltlager, mit echten Flaschen, echter Küche und echtem Wetter. Dazu gibt es dann einen eigenen Artikel.
Nachbauen
- Firmware der Gasanzeige (Version 0.1.9) mit README und Werkzeugen
- Testsketches v1 bis v3 für den ESP32 C6
- Layoutgenerator mit allen SVG Entwürfen
Übersetzt habe ich mit der Arduino IDE, ESP32 Core 3.3.12, NimBLE Arduino 2.5.1 und GxEPD2 1.6.9 (mit Adafruit GFX). Als Board XIAO_ESP32S3_PLUS auswählen, als Partitionsschema „Default with spiffs (3MB APP/1.5MB SPIFFS)“, damit das Update über WLAN funktioniert, und „USB CDC On Boot“ einschalten. Solange ein Computer per USB verbunden ist, schläft die Anzeige nicht und zeigt „USB“, damit sich neue Firmware bequem hochladen lässt.
Das Passwort des Hotspots ist in der Firmware fest auf „nopassword“ gesetzt. Wer das ändern möchte, findet es in config.h.
Die Software steht unter der MIT Lizenz. Ihr dürft sie frei verwenden, verändern und weitergeben, auch kommerziell, solange der Lizenzhinweis erhalten bleibt.
Falls ihr Fragen habt oder andere Dateiformate braucht, schreibt mir gerne: wird geladen …
Fazit
Aus ein paar Testsketches ist eine ziemlich vollständige Firmware geworden: Sie fragt bis zu zehn Sensoren ab, rechnet echte Restmengen aus, erkennt abgefallene Sensoren und lässt sich am Gerät wie per Handy bedienen. Auf dem Schreibtisch funktioniert das alles schon. Ob es auch im Zeltlager zwischen Kochtöpfen, Gasflaschen und hungrigen Kindern besteht, zeige ich im August.
