Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- projekt:python_ds18b20_logger [2026/02/22 10:26] – [Voraussetzungen] torsten.roehl
+++ projekt:python_ds18b20_logger [2026/02/23 12:23] (aktuell) – [Testen] torsten.roehl
@@ Zeile 3: / Zeile 3: @@
 //
-In diesem Projekt wird ein Temperatur-Logger mit dem digitalen 1-Wire-Sensor DS18B20 am Raspberry Pi realisiert. Ergänzend zur reinen Temperaturauslese werden Messwerte kontinuierlich in einer Textdatei protokolliert und aus diesen Daten automatisch ein Temperaturverlauf als Grafik erzeugt. Der Logger lässt sich über ein Kommandozeilen-Interface steuern und speichert Messdaten sowie Diagramm lokal oder zur Anzeige im Webserver-Verzeichnis.//
+In diesem Projekt wird ein Temperatur-Logger mit dem digitalen 1-Wire-Sensor DS18B20 am Raspberry Pi realisiert. Ergänzend zur reinen Temperaturauslese werden Messwerte kontinuierlich in einer Textdatei protokolliert und aus diesen Daten automatisch ein Temperaturverlauf als Grafik erzeugt. Der Logger lässt sich über ein Kommandozeilen-Interface steuern und speichert Messdaten sowie das Diagramm lokal oder zur Anzeige im Webserver-Verzeichnis.//
+|{{ :raspberry_pi:temp_logger_0.png?400 |}}|
+|Der Temperaturverlauf im Browser wird nur angezeigt, wenn zuvor das Programm ''temp_logger.py'' im Terminal gestartet und die Messung mit ''start'' begonnen wurde. In diesem Beispiel wurde die Messung noch nicht gestartet.|
 ====== Überblick ======
@@ Zeile 13: / Zeile 15: @@
   * Software
       * Quellcode
+  * Testen
+      * Terminal
       * Webseite
@@ Zeile 20: / Zeile 24: @@
 ===== Voraussetzungen  =====
+<note>
+Das Projekt [[python_projekt_ds18b20_digitaler_temperatursensor|DS18B20 digitaler Temperatursensor]] muss vollständig durchgeführt sowie erfolgreich getestet worden sein, da derselbe Aufbau (Verkabelung und Hardware) weiterverwendet wird.
+</note>
-  - Das Projekt [[python_projekt_ds18b20_digitaler_temperatursensor|DS18B20 digitaler Temperatursensor]] ist verpflichtende Voraussetzung und muss zuvor vollständig durchgeführt und erfolgreich getestet worden sein.Da hier dieselbe Hardware verwendet wird, sind damit alle grundlegenden Voraussetzungen erfüllt.
+**Nutzung lokal:**
-  - Soll das Programm ausschließlich lokal genutzt werden, genügt diese Voraussetzung.
+Für die reine lokale Verwendung des Loggers sind keine weiteren Projekte erforderlich.
-  - Soll zusätzlich die Webausgabe verwendet werden, muss zuvor das DokuWiki-Projekt zur Einrichtung des Webservers durchgeführt worden sein. Idealerweise wurde auch das FastAPI-Projekt bereits abgeschlossen.
+**Nutzung mit Webausgabe:**
+Hierfür muss zuvor das [[dokuwiki|DokuWiki-Projekt]] zur Einrichtung des Webservers abgeschlossen worden sein. Idealerweise wurde auch das [[python_fastapi|FastAPI-Projekt]] bereits durchgeführt.
 ==== Environment ====
@@ Zeile 52: / Zeile 60: @@
 <code bash>
-(course_env) pi@raspi88:~/devel/projects/course_temp_curve $ tree
+(course_env) pi@raspi88:~/devel/projects/course_temp_logger $ tree
 .
 ├── data
@@ Zeile 61: / Zeile 69: @@
     │   ├── hardware.py       # aus dem vorherigen Projekt!
     │   ├── __init__.py
-    │   └── temperature_logger.py  # Program
+    │   └── temperature_logger.py
-    └── temp_curve.py
+    └── temp_logger.py        # Hauptprogramm
 </code>
@@ Zeile 158: / Zeile 166: @@
 if MODE == "local":
-    DATA_DIR = Path("~/devel/projects/course_temp_curve/data").expanduser()
+    DATA_DIR = Path("~/devel/projects/course_temp_logger/data").expanduser()
 elif MODE == "web":
     DATA_DIR = Path("/var/www/html/temp_curve").expanduser()
@@ Zeile 200: / Zeile 208: @@
     plt.ylabel("Temperatur (°C)")
     if temps:
-        plt.plot(times, temps)
+       plt.plot(temps)
-        plt.xticks(rotation=45)
+       step = max(1, len(times) // 10)
+       plt.xticks(range(0, len(times), step),
+               times[::step],
+               rotation=45)
     else:
         plt.text(
@@ Zeile 271: / Zeile 283: @@
 === Hauptprogramm ===
-Das eigenständige Programm ''temp_curve.py'' dient als Kommandozeilen-Interface zur Steuerung des //Temperatur-Loggers//.
+Das eigenständige Programm ''temp_logger.py'' dient als Kommandozeilen-Interface zur Steuerung des //Temperatur-Loggers//.
 Es ermöglicht das Starten und Stoppen der Messung, das Setzen des Messintervalls sowie das Zurücksetzen der gespeicherten Daten.
+<note tip>Die eigentliche Messung läuft in einem //Hintergrund-Thread//. Dadurch bleibt die Kommandozeile reaktionsfähig und kann weiterhin Befehle entgegennehmen, während im Hintergrund kontinuierlich Temperaturwerte erfasst, gespeichert und grafisch ausgewertet werden.</note>
 <note>
@@ Zeile 280: / Zeile 296: @@
-++++  Quellcode ''temp_curve.py'' |
+++++ Quellcode ''temp_logger.py'' |
-<code python temp_curve.py>
+<code python temp_logger.py>
 #!/usr/bin/env python3
 from core import temperature_logger as temp
@@ Zeile 303: / Zeile 319: @@
 status | t                Status anzeigen
 help   | h                Diese Hilfe anzeigen
-quit   | q                Programm beenden
+exit   | x                Programm beenden
 """)
@@ Zeile 351: / Zeile 367: @@
             print_help()
-        elif cmd in ("quit", "q"):
+        elif cmd in ("exit", "x"):
             temp.stop()
             break
@@ Zeile 363: / Zeile 379: @@
 ++++
+===== Testen =====
+Das Programm kann sowohl **lokal im Terminal** als auch über den **Webbrowser getestet werden**.
+Für die Webausgabe gelten die im Abschnitt „Voraussetzungen“ beschriebenen Bedingungen.
+<note>**Hinweis**
+Wird die Messung mit ''start'' begonnen, werden in regelmäßigen Abständen Temperaturwerte erfasst, die in der Datei (''temperature.txt'') gespeichert werden. Zusätzlich wird nach jeder Messung automatisch eine aktualisierte Grafik des Temperaturverlaufs erzeugt.
+Die Erfassung erfolgt entsprechend dem eingestellten Messintervall, sodass neue Messwerte erst nach einigen Sekunden sichtbar werden. Das Programm führt die Messung kontinuierlich im Hintergrund aus, bis sie mit ''stop'' beendet oder das Programm mit ''exit'' geschlossen wird.
+</note>
+<note tip>
+Vor dem Testen prüfen, welcher ''MODE'' in ''temperature_logger.py'' gesetzt ist:
+  * ''local'' → Dateien werden im Projektordner ''data'' gespeichert.
+  * ''web'' → Dateien werden im Webverzeichnis ''/var/www/html/temp_curve'' gespeichert und können im Browser angezeigt werden.
+Für die Webausgabe muss ''MODE = "web"'' gesetzt sein.
+</note>
+==== Terminal ====
+Zur Überprüfung wird das Programm im Verzeichnis ''src'' gestartet:
+<code bash>
+chmod 755 temp_logger.py
+./temp_logger.py
+</code>
+<code bash Beispiel Ausgabe>
+Temperatur-Logger v1.0.0
+Mit 'h' Hilfe anzeigen.
+> h
+VERFÜGBARE BEFEHLE
+------------------
+start | s                 Logger starten
+stop  | p                 Logger stoppen
+reset | r                 Messwerte zurücksetzen
+interval <sek> | i <sek>  Messintervall setzen
+status | t                Status anzeigen
+help   | h                Diese Hilfe anzeigen
+exit   | x                Programm beenden
+> start
+(Programm misst im Hintergrund …)
+> stop
+>
+</code>
+Nach dem Start erscheint die Kommandozeilen-Oberfläche des Temperatur-Loggers.
+Im obigen Beispiel wurde mit dem Befehl ''h'' die Hilfe angezeigt.
+Die Befehle können entweder vollständig ausgeschrieben (z. B. ''start'') oder in der angegebenen Kurzform (z. B. ''s'') verwendet werden, um das Programm zu starten.
+Die erzeugten Dateien befinden sich im Verzeichnis ''data'':
+<code bash>
+ls
+temperature.png     # erzeugte Grafik
+temperature.txt     # Messdaten
+</code>
+Die Grafik kann anschließend mit folgendem Befehl betrachtet werden:
+<code bash>
+feh temperature.png
+</code>
+|{{ :raspberry_pi:temp_feh.png?400 |}}|
+|Bildausgabe mit dem Befehl ''feh''|
 ==== Webseite ====
@@ Zeile 368: / Zeile 459: @@
+<note>Zum Testen im Browser genügt es, die **IP-Adresse** des //Raspberry Pi// in die Adresszeile einzugeben.
+Der Apache-Webserver liefert automatisch die Datei ''index.html'' aus, die als Startseite angezeigt wird.
+</note>
+|{{ :raspberry_pi:temp_logger_1.png?400 |}}|
+|Bildausgabe über den Webbrowser|
@@ Zeile 422: / Zeile 519: @@
 </code>
-<note>Die Dateien ''index.html'' und ''temperature.html'' müssen sich im Webverzeichnis ''/var/www/html/'' bzw. im Unterordner /''var/www/html/temp_curve/'' befinden, damit sie vom Webserver korrekt ausgeliefert werden können.
+<note>Die Dateien ''index.html'' und ''temperature.html'' müssen sich im Webverzeichnis ''/var/www/html/'' bzw. im Unterordner ''/var/www/html/temp_curve/'' befinden, damit sie vom Webserver korrekt ausgeliefert werden können.
 </note>