Womo-Handbuch

Das digitale Womo-Handbuch enthält die Bedienungs- und technische Dokumentation des Wohnmobils.

Das Handbuch wird mit VitePress erstellt und vom Raspberry Pi tsg-bobil als lokale Webseite bereitgestellt.

Zugriff

Im Womo-Netz ist das Handbuch unter folgender Adresse erreichbar:

http://192.168.8.10:8000

Der Zugriff erfolgt mit einem normalen Webbrowser. Eine Internetverbindung ist für die eigentlichen Handbuchseiten nicht erforderlich.

ℹ️Lokaler Betrieb▶

Das vollständige Handbuch befindet sich auf dem Raspberry Pi und steht deshalb auch zur Verfügung, wenn das Wohnmobil keine Verbindung zum Internet besitzt.

Funktionen, die externe Daten abrufen, können ohne Internetverbindung jedoch eingeschränkt sein. Dazu gehört insbesondere das aktuelle Außenwetter.

Technischer Aufbau

Das Handbuch basiert auf VitePress.

Die eigentlichen Inhalte werden überwiegend als Markdown-Dateien gepflegt. VitePress erzeugt daraus eine statische Webseite.

Für zusätzliche Funktionen werden eigene Vue-Komponenten verwendet. Damit können beispielsweise aktuelle Messwerte auf der Startseite dargestellt werden.

Die fertige Webseite wird auf tsg-bobil über einen Docker-Container bereitgestellt.

Eigenschaft	Wert
Anwendung	VitePress
Container	womo-handbuch-vitepress
Port	8000
Adresse im Womo-Netz	192.168.8.10:8000

Startseite

Die Startseite dient gleichzeitig als Einstieg in das Handbuch und als Übersicht über aktuelle Daten des Wohnmobils.

Über die Kacheln können die wichtigsten Bereiche direkt aufgerufen werden:

• Handbuch
• IT & Live-Daten
• Bilder

Darunter werden aktuelle Innenraum- und Wetterdaten angezeigt.

Innenraumdaten

Die Innenraumdaten stammen von einem Zigbee-Raumklimasensor im Wohnmobil.

Angezeigt werden:

• Temperatur
• relative Luftfeuchtigkeit
• Luftdruck
• Batteriestatus des Sensors
• Zeitpunkt der letzten Sensormeldung

Die Anzeige wird regelmäßig automatisch aktualisiert.

Außenwetter

Zusätzlich werden aktuelle Wetterdaten für den gewählten Standort angezeigt.

Der Wetterstandort kann auf zwei Arten festgelegt werden:

• Manuell – der gewünschte Ort wird direkt auf der Startseite eingegeben.
• GPS-Standort – die aktuelle Position des Wohnmobils wird über den am Raspberry Pi angeschlossenen GPS-Empfänger bestimmt.

Der manuelle Modus ist der Standard. Dadurch kann beispielsweise auch gezielt das Wetter eines Reiseziels angezeigt werden.

Im GPS-Modus verwendet Node-RED die aktuelle geografische Position des Wohnmobils. Aus den GPS-Koordinaten wird über OpenWeatherMap zusätzlich der zugehörige Ortsname ermittelt.

Ein Wechsel zwischen manuellem und GPS-basiertem Standort ist direkt in der Wetterkachel der Startseite möglich.

Bei einem Wechsel des Wettermodus werden die Wetterdaten unmittelbar für den neu gewählten Standort aktualisiert.

Aktualität der Daten

Bei den Innenraum- und Wetterdaten wird jeweils der Zeitpunkt der zuletzt empfangenen bzw. abgerufenen Daten angezeigt.

Sind die angezeigten Daten älter als eine Stunde, wird dies auf der Startseite besonders gekennzeichnet.

Dadurch ist erkennbar, wenn beispielsweise ein Sensor keine neuen Werte mehr liefert oder die Wetterdaten längere Zeit nicht aktualisiert werden konnten.

Bereitstellung der Live-Daten

Die Live-Daten werden nicht direkt von VitePress aus den Sensoren oder aus InfluxDB gelesen.

Node-RED verarbeitet die aktuellen Werte und stellt sie über HTTP-Schnittstellen für das Handbuch bereit.

Sensoren / OpenWeatherMap
          │
          ▼
       Node-RED
          │
          ▼
       HTTP-API
          │
          ▼
       VitePress
          │
          ▼
       Startseite

Die technische Umsetzung der Datenverarbeitung und der HTTP-Schnittstellen wird im Kapitel Node-RED beschrieben.

ℹ️Live-Daten und historische Daten▶

Die Startseite des Handbuchs dient zur Anzeige der aktuellen Werte.

Historische Messwerte werden dagegen in InfluxDB gespeichert und können mit Grafana ausgewertet und dargestellt werden.

Aktualisierung des Handbuchs

Änderungen am Handbuch werden zunächst im zugehörigen Git-Repository vorgenommen.

Neue Funktionen oder größere Änderungen können dabei in eigenen Git-Branches entwickelt und getestet werden.

Nach Fertigstellung werden die Änderungen in den Hauptbranch übernommen.

Anschließend wird die VitePress-Webseite für den Raspberry Pi neu gebaut und der Docker-Container mit der aktualisierten Version gestartet.

Durch die Verwendung von Git bleiben Änderungen am Handbuch nachvollziehbar und können getrennt entwickelt und getestet werden.

← Zurück zum IT-System