Raspberry Pi mit DS18B20-Temperatursensor auf dem Steckbrett, daneben ein wasserdichter Fühler, im Hintergrund ein Temperaturverlauf auf dem Laptop

Temperatur aufzeichnen mit dem Raspberry Pi: DS18B20 + RRDtool

Wie warm war es letzte Nacht im Gewächshaus, wie kalt wird der Keller im Winter, und hält der Kühlschrank seine Temperatur? Mit einem DS18B20-Temperatursensor für wenige Euro und dem Raspberry Pi zeichnet ihr das dauerhaft auf. Am Ende misst der Pi alle fünf Minuten, speichert die Werte in einer RRDtool-Datenbank und zeigt euch den aktuellen Wert samt Tages-, Wochen- und Monatsverlauf als Webseite im Browser.

Kurz gesagt

Ihr schließt einen DS18B20 an GPIO 4 an und schaltet in raspi-config die 1-Wire-Schnittstelle ein. Den Rest erledigen zwei kleine Python-Scripts: Eines schreibt alle fünf Minuten den Messwert in RRDtool, das andere zeichnet daraus Grafiken für den Browser.

  • Sensor: DS18B20 mit 4,7-kΩ-Widerstand an 3,3 V, GND und GPIO 4
  • Speicher: RRDtool belegt einmalig festen Platz und wächst danach nicht mehr
  • Anzeige: statische Webseite über Apache, ohne PHP und ohne Datenbankserver

Ist RRDtool der richtige Weg?

RRDtool (Round Robin Database) ist ein kleines Werkzeug für Messreihen. Die Datenbank hat von Anfang an eine feste Größe: Alte Einzelwerte werden zu Stunden-Durchschnitten zusammengefasst und irgendwann überschrieben. Ihr müsst also nie aufräumen, und die Speicherkarte läuft nicht voll. Die Grafiken erzeugt RRDtool gleich mit.

Das passt, wenn ein einzelner Pi ein paar Temperaturen protokollieren soll und ihr sonst nichts dafür betreiben wollt. Habt ihr bereits Home Assistant laufen, hängt den Sensor besser dort an: Mit ESPHome wird aus einem ESP32 und einem DS18B20 ein Funksensor, und Verlauf und Diagramme bringt Home Assistant selbst mit.

Was ihr braucht

KomponenteDetailsKauflink
Raspberry Pijedes Modell mit GPIO-Leiste, mit Raspberry Pi OSRaspberry Pi 5*
Temperatursensor DS18B20als loser Baustein für das Steckbrett oder wasserdicht mit Kabel für draußen und in FlüssigkeitenDS18B20 als Einzelbaustein* / DS18B20 wasserdicht mit Kabel*
Widerstand 4,7 kΩPull-up-Widerstand zwischen Daten und 3,3 VWiderstand 4,7 kΩ (10 Stück)*
Steckbrett und Kabelzum Aufbau ohne LötenMini-Steckbrett* / Jumper-Kabel*
Mit * markierte Links sind Affiliate-Links, also Werbung. Kauft ihr darüber ein, erhalte ich eine Provision, der Preis bleibt für euch gleich. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen. Mehr dazu

Sensor anschließen

Der DS18B20 hat drei Anschlüsse: Masse, Daten und Versorgung. Alle Sensoren teilen sich eine Datenleitung, den sogenannten 1-Wire-Bus. Der 4,7-kΩ-Widerstand zieht diese Leitung auf 3,3 V hoch; ohne ihn findet der Pi den Sensor nicht.

DS18B20Raspberry Pi
Pin 1 – GNDPin 6 (GND)
Pin 2 – Daten (DQ)Pin 7 (GPIO 4)
Pin 3 – VDDPin 1 (3,3 V)
4,7-kΩ-Widerstandzwischen Daten und 3,3 V

Haltet den Sensor so, dass die flache Seite mit der Beschriftung zu euch zeigt und die Beinchen nach unten, dann ist Pin 1 links. Die Pins am Pi findet ihr in unserem interaktiven GPIO-Pinout. Beim wasserdichten Sensor mit Kabel steht die Aderbelegung beim Händler; meist ist Rot die Versorgung, Schwarz die Masse und Gelb die Datenleitung. Seine Adern steckt ihr wie die Beinchen des losen Sensors ins Steckbrett und verbindet sie von dort mit Jumper-Kabeln zum Pi; der Widerstand sitzt ebenfalls auf dem Steckbrett. Schließt den Sensor an 3,3 V an, nicht an 5 V: Die GPIOs des Pi vertragen nur 3,3 V.

Schaltplan: DS18B20 mit Masse an GND, Daten an GPIO 4, Versorgung an 3,3 V und 4,7-kΩ-Widerstand zwischen Daten und 3,3 V
Schaltplan des DS18B20: Der Widerstand verbindet Daten und 3,3 V.
DS18B20 auf dem Steckbrett, verbunden mit Pin 1, Pin 6 und Pin 7 eines Raspberry Pi, Widerstand zwischen Daten und 3,3 V
Aufbau auf dem Steckbrett, hier noch an einem frühen Raspberry Pi. Pin 1, 6 und 7 liegen bei allen Modellen an derselben Stelle.

1-Wire einschalten

Raspberry Pi OS bringt den Treiber für den 1-Wire-Bus schon mit, ihr müsst ihn nur einschalten. Am einfachsten geht das mit raspi-config:

sudo raspi-config

Wählt dort 3 Interface Options → I7 1-Wire und bestätigt mit Yes. Danach startet den Pi neu:

sudo reboot

raspi-config schreibt dabei nur eine Zeile in die Datei /boot/firmware/config.txt. Ihr könnt sie auch selbst eintragen, etwa wenn ihr ohne Menü arbeitet oder einen anderen GPIO nutzen wollt:

dtoverlay=w1-gpio

Ohne Zusatz liegt die Datenleitung auf GPIO 4. Für einen anderen Pin hängt ihr ihn an, zum Beispiel dtoverlay=w1-gpio,gpiopin=17. Der Eintrag gilt auch für den Pi 5; die Firmware lädt dort automatisch die passende Variante. Den Temperaturtreiber w1-therm lädt das System beim Start selbst, sobald es einen Sensor findet. Einträge in /etc/modules, wie sie ältere Anleitungen zeigen, braucht ihr nicht.

Sensor testen

Nach dem Neustart taucht jeder angeschlossene DS18B20 als eigener Ordner auf. Sein Name beginnt mit 28- und ist die eindeutige Seriennummer des Sensors:

ls /sys/bus/w1/devices/
28-00000530ed24  w1_bus_master1

Notiert euch diese ID, ihr braucht sie gleich im Script. Den Messwert lest ihr so (eure ID einsetzen):

cat /sys/bus/w1/devices/28-00000530ed24/w1_slave
35 01 4b 46 7f ff 0b 10 31 : crc=31 YES
35 01 4b 46 7f ff 0b 10 31 t=19312

Die erste Zeile endet mit YES, wenn die Prüfsumme stimmt. Die Temperatur steht hinter t= in Tausendstel Grad: 19312 bedeutet 19,312 °C. Nur den Zahlenwert liefert die Datei temperature im selben Ordner; beide Dateien beschreibt die Kernel-Dokumentation zu w1_therm.

RRDtool installieren und Datenbank anlegen

Installiert RRDtool zusammen mit der Python-Anbindung:

sudo apt update
sudo apt install rrdtool python3-rrdtool

Legt einen Ordner in eurem Home-Verzeichnis an und erstellt darin die Datenbank. Lest vorher die Erklärung unter dem Befehl: Messbereich und Speicherdauer legt ihr nur beim Anlegen fest.

mkdir ~/temperatur
cd ~/temperatur
rrdtool create temperatur.rrd --step 300 \
  DS:temp:GAUGE:600:-30:100 \
  RRA:AVERAGE:0.5:1:1200 \
  RRA:MIN:0.5:12:2400 \
  RRA:MAX:0.5:12:2400 \
  RRA:AVERAGE:0.5:12:2400

Die Parameter bedeuten (Details in der RRDtool-Dokumentation):

  • --step 300: RRDtool erwartet alle 300 Sekunden, also alle fünf Minuten, einen Wert.
  • DS:temp:GAUGE:600:-30:100: eine Messreihe namens temp. Kommt 600 Sekunden lang kein Wert, gilt sie als unbekannt. Werte außerhalb von −30 bis 100 °C verwirft RRDtool.
  • RRA:AVERAGE:0.5:1:1200: jeder einzelne Messwert, 1200 Stück lang. Das sind 100 Stunden.
  • Die letzten drei Zeilen: Minimum, Maximum und Durchschnitt pro Stunde (12 × 5 Minuten), je 2400 Stunden lang. Das sind 100 Tage.

Die Datei ist danach etwa 70 KB groß und bleibt so. Passt die Werte an, bevor ihr den Befehl ausführt: Misst der Sensor draußen Frost unter −30 °C, setzt die untere Grenze herunter, etwa auf -55. Wollt ihr länger als 100 Tage zurückblicken, erhöht die 2400 in den letzten drei Zeilen. Habt ihr die Datenbank schon angelegt, löscht ihr die Datei und legt sie neu an; die bisherigen Werte sind dann weg.

Messwerte per Python aufzeichnen

Das erste Script liest den Sensor und schreibt den Wert in die Datenbank. Legt es im selben Ordner an:

nano ~/temperatur/temperatur_aufzeichnen.py

Fügt den folgenden Inhalt ein und tragt in der Zeile SENSOR_ID eure ID ein. Speichert mit Strg+O und Enter, beendet nano mit Strg+X.

#!/usr/bin/env python3
"""Read a DS18B20 sensor and store the value in an RRD database."""
import sys
from pathlib import Path

import rrdtool

SENSOR_ID = "28-00000530ed24"  # replace with your sensor ID
RRD_FILE = Path.home() / "temperatur" / "temperatur.rrd"


def read_celsius(sensor_id):
    """Return the temperature in °C, or None if the reading is invalid."""
    lines = Path(f"/sys/bus/w1/devices/{sensor_id}/w1_slave").read_text().splitlines()
    if len(lines) < 2 or not lines[0].strip().endswith("YES"):
        return None  # CRC check failed
    raw = int(lines[1].split("t=")[1])
    if raw == 85000:
        return None  # power-on value, no real measurement
    return raw / 1000


temperature = read_celsius(SENSOR_ID)
if temperature is None:
    sys.exit("Invalid reading, nothing stored")
rrdtool.update(str(RRD_FILE), f"N:{temperature:.2f}")

Das Script verwirft zwei Fehlerfälle, damit keine falschen Werte in die Kurve geraten: eine falsche Prüfsumme und den Wert 85000. Auf 85 °C steht der Sensor direkt nach dem Einschalten, bevor er zum ersten Mal gemessen hat. Taucht der Wert auf, liegt meist ein Wackelkontakt oder eine schwache Versorgung vor. Probiert das Script einmal von Hand aus. Klappt alles, gibt es nichts aus; ob der Wert angekommen ist, zeigt der zweite Befehl:

python3 ~/temperatur/temperatur_aufzeichnen.py
rrdtool lastupdate ~/temperatur/temperatur.rrd
 temp

1793535024: 19.31

Die lange Zahl ist der Zeitpunkt der Messung in Sekunden seit 1970, dahinter steht die Temperatur.

Damit der Pi regelmäßig misst, legt ihr einen Cronjob an. Öffnet eure Crontab mit crontab -e (beim ersten Aufruf fragt das System nach einem Editor, nano ist die einfachste Wahl) und fügt am Ende diese Zeile ein:

*/5 * * * * /usr/bin/python3 $HOME/temperatur/temperatur_aufzeichnen.py

Das Intervall von fünf Minuten passt zum --step 300 der Datenbank. Misst der Pi seltener als alle zehn Minuten, entstehen Lücken in der Kurve, weil RRDtool den Wert nach 600 Sekunden als unbekannt markiert.

Grafiken und Webseite erzeugen

Für die Anzeige im Browser braucht ihr einen Webserver. Apache ist schnell installiert, mehr dazu steht in unserer Webserver-Anleitung:

sudo apt install apache2

Der Ordner /var/www/html gehört dem Systembenutzer root. Legt darin einen Unterordner an und übergebt ihn eurem Benutzer, damit das Script dort schreiben darf:

sudo mkdir /var/www/html/temperatur
sudo chown "$USER": /var/www/html/temperatur

Das zweite Script zeichnet je eine Grafik für 24 Stunden, 7 Tage und 30 Tage und schreibt eine kleine Seite mit dem aktuellen Wert dazu:

nano ~/temperatur/temperatur_grafik.py

Fügt den folgenden Inhalt ein und speichert wie beim ersten Script:

temperatur_grafik.py
#!/usr/bin/env python3
"""Draw temperature graphs from the RRD database and write a status page."""
from pathlib import Path

import rrdtool

RRD_FILE = Path.home() / "temperatur" / "temperatur.rrd"
WEB_DIR = Path("/var/www/html/temperatur")
LABEL = "Wohnzimmer"

# file name, start time, heading
PERIODS = [
    ("tag", "-1d", "Letzte 24 Stunden"),
    ("woche", "-7d", "Letzte 7 Tage"),
    ("monat", "-30d", "Letzte 30 Tage"),
]

for name, start, heading in PERIODS:
    rrdtool.graph(
        str(WEB_DIR / f"{name}.png"),
        "--start", start, "--end", "now",
        "--width", "700", "--height", "200",
        "--vertical-label", "°C",
        "--title", heading,
        f"DEF:temp={RRD_FILE}:temp:AVERAGE",
        f"LINE2:temp#C0392B:{LABEL}",
        "GPRINT:temp:MIN:Min %4.1lf °C",
        "GPRINT:temp:MAX:Max %4.1lf °C",
    )

last = rrdtool.lastupdate(str(RRD_FILE))
value = last["ds"]["temp"]
current = "–" if value is None else f"{value:.1f} °C".replace(".", ",")
updated = last["date"].strftime("%d.%m.%Y %H:%M")

images = "\n".join(
    f'<h2>{heading}</h2>\n<img src="{name}.png" alt="Temperaturverlauf {heading}">'
    for name, _, heading in PERIODS
)

page = f"""<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="refresh" content="300">
<title>Temperatur {LABEL}</title>
<style>
body {{ font-family: system-ui, sans-serif; background: #f4f4f4; color: #222;
       max-width: 760px; margin: 2em auto; padding: 0 1em; text-align: center; }}
.now {{ font-size: 4em; font-weight: 300; margin: 0.2em 0; }}
img {{ max-width: 100%; height: auto; }}
</style>
</head>
<body>
<h1>{LABEL}</h1>
<p class="now">{current}</p>
<p>Stand: {updated}</p>
{images}
</body>
</html>
"""
(WEB_DIR / "index.html").write_text(page, encoding="utf-8")

Den Namen in der Zeile LABEL könnt ihr frei wählen. Die Seite lädt sich alle fünf Minuten selbst neu und kommt ohne PHP und ohne externe Schriftarten aus. Erzeugt die Grafiken einmal von Hand:

python3 ~/temperatur/temperatur_grafik.py

Öffnet dann im Browser http://<IP-des-Pi>/temperatur/. Die IP-Adresse zeigt euch der Befehl hostname -I auf dem Pi. Direkt nach dem Einrichten ist die Kurve noch kurz; sie füllt sich mit jeder Messung. Damit Grafiken und Seite immer zum Messwert passen, kommt das Script mit demselben Fünf-Minuten-Takt in die Crontab. Öffnet sie wieder mit crontab -e und setzt die Zeile unter die erste:

*/5 * * * * /usr/bin/python3 $HOME/temperatur/temperatur_grafik.py

Mehrere Sensoren

Weitere DS18B20 hängt ihr parallel an dieselben drei Leitungen; der eine Widerstand reicht für alle. Jeder Sensor erscheint mit eigener ID unter /sys/bus/w1/devices/. Am übersichtlichsten bekommt jeder Sensor eine eigene RRD-Datei und eine eigene Seite. Für einen zweiten Sensor, hier „keller“ genannt:

  1. Legt die Datenbank mit dem rrdtool create-Befehl von oben ein zweites Mal an, als keller.rrd.
  2. Kopiert beide Scripts, etwa als keller_aufzeichnen.py und keller_grafik.py.
  3. Im Aufzeichnungs-Script ändert ihr SENSOR_ID und RRD_FILE, im Grafik-Script RRD_FILE, LABEL und WEB_DIR auf /var/www/html/keller. Ohne eigenen Webordner überschreibt der zweite Sensor die Seite des ersten.
  4. Legt den neuen Webordner mit mkdir und chown an wie oben.
  5. Tragt beide Scripts mit je einer eigenen Zeile in die Crontab ein.

Die Seite des zweiten Sensors erreicht ihr dann unter http://<IP-des-Pi>/keller/.

Wenn etwas nicht klappt

ProblemUrsache und Lösung
Kein Ordner 28-… unter /sys/bus/w1/devices/1-Wire nicht eingeschaltet oder kein Neustart danach; Widerstand fehlt; Daten nicht an GPIO 4. Prüft mit grep w1 /boot/firmware/config.txt, ob die Zeile dtoverlay=w1-gpio da ist.
Sensor wird sehr heißGND und VDD vertauscht. Sofort vom Strom trennen und die Pinbelegung prüfen.
Wert t=85000Sensor hat noch nicht gemessen, meist wegen Wackelkontakt oder schwacher Versorgung. Verkabelung prüfen.
crc=… NOStörung auf der Leitung, häufig bei langen Kabeln. Kabel kürzen oder abgeschirmtes Kabel verwenden.
Kurve bleibt leerCronjob läuft nicht oder misst seltener als alle zehn Minuten. Mit rrdtool lastupdate ~/temperatur/temperatur.rrd prüfen, wann der letzte Wert kam.
Browser erreicht die Seite nichtApache läuft nicht oder die Adresse stimmt nicht. Mit systemctl status apache2 prüfen, IP mit hostname -I nachsehen und den Schrägstrich am Ende von /temperatur/ mitschreiben.
Permission denied beim Grafik-ScriptDer Ordner /var/www/html/temperatur gehört noch root. Den chown-Befehl von oben ausführen.
ModuleNotFoundError: No module named 'rrdtool'Paket python3-rrdtool fehlt, oder das Script läuft in einer virtuellen Python-Umgebung. Mit /usr/bin/python3 starten.

Häufige Fragen zum DS18B20 am Raspberry Pi

Welchen Widerstand brauche ich für den DS18B20?

Einen 4,7-kΩ-Widerstand zwischen der Datenleitung und 3,3 V. Er zieht die Leitung hoch, ohne ihn erkennt der Pi den Sensor nicht. Hängen mehrere Sensoren am selben Pin, reicht ein Widerstand für alle.

Funktioniert das auch am Raspberry Pi 5?

Ja. Ihr schaltet 1-Wire genauso über raspi-config ein oder tragt dtoverlay=w1-gpio in die config.txt ein. Auf dem Pi 5 lädt die Firmware dafür automatisch die passende Variante w1-gpio-pi5.

Wie viele DS18B20 kann ich an einen GPIO anschließen?

Mehrere, denn jeder Sensor hat eine eigene Seriennummer und erscheint als eigener Ordner unter /sys/bus/w1/devices/. Mit vielen Sensoren und langen Leitungen wird der Bus aber störanfälliger; zeigt die Prüfsumme häufiger NO, kürzt die Kabel.

Kann ich den Sensor im Freien verwenden?

Ja, nehmt die wasserdichte Variante in der Edelstahlhülse. Laut Datenblatt misst der DS18B20 von −55 bis +125 °C. Die Datenbank in dieser Anleitung nimmt nur Werte von −30 bis 100 °C an; für tiefere Temperaturen ändert ihr die Grenze im create-Befehl, bevor ihr die Datenbank anlegt.

Warum RRDtool und nicht einfach eine CSV-Datei?

Eine CSV-Datei wächst mit jeder Messung und muss irgendwann aufgeräumt werden. Die RRD-Datei hat von Anfang an ihre feste Größe, fasst alte Werte selbst zu Stundenwerten zusammen und erzeugt die Grafiken gleich mit.

Ähnliche Beiträge