homelab-brain/docs/projekte/garage-decke-monitoring.md

Garage-Decke — Deckentemperaturen (Klimadecke, Brunnen/PWT)

Stand: 27.06.2026 (Abend) · Datendrehscheibe: CT 143 (Raspi-Broker) · Grafana: https://grafana.orbitalo.net/d/garage_decke/garage-decke

Ziel

Fuenf DS18B20-Fuehler an der Garage-Decke dauerhaft messen und auswerten:

• Klimadecke: Vorlauf + Ruecklauf (VL/RL) — passive/strahlungsbasierte Kuehlung
• Brunnen/PWT: Vorlauf vor Plattenwaermetauscher + Ruecklauf danach
• PWT-Oberflaeche: Fuehler oben auf PWT geklemmt (Gehaeuse, schneller Indikator)

Aus den Temperaturen werden ΔT (Effektivitaet) und — nur fuer den Brunnenkreis — thermische Leistung abgeleitet.

Getrennt vom Garagen-Raum-Satelliten (garage/temp, ESP-Werkstattknoten) — der misst Raumluft, nicht Deckenrohre.

Architektur

Brunnen (Garten)
   │ Brunnenpumpe + ggf. Verstaerkerpumpe(n) in Reihe
   │ lange Leitung → Garage
   ▼
Plattenwaermetauscher (PWT) — Primaer: Brunnen / Sekundaer: KaelteDecke
   │
2x Shelly 1 (Gen1, SHSW-1) + DS18B20-Addon
   │ HTTP lokal: 192.168.178.86 / .78
   │ MQTT (Gen1: Cloud ODER MQTT, nicht beides!)
   │ Topics: shellies/<id>/ext_temperature/<idx>  (float °C)
   ▼
mosquitto CT143 :1883 (192.168.178.36)
   ▼
Telegraf satellites.conf (5 Inputs, feste Tags)
   ▼
InfluxDB DB `sensors`, Measurement `temperature`
   Tags: node=garage_decke, sensor=<rolle>
   ▼
Grafana Dashboard „Garage Decke“ (UID: garage_decke)
   → Stat: Temperaturen, ΔT, Leistung Brunnen
   → Verlauf: 5 Fuehler + ΔT/Leistung

Code / Git (homelab-brain auf pve-hetzner)

Artefakt	Pfad im Repo	Deploy-Ziel
Telegraf MQTT-Inputs	infra/telegraf/satellites.conf	CT143 /etc/telegraf/telegraf.d/satellites.conf
Grafana Dashboard JSON	infra/grafana/garage_decke.json	CT143 /etc/grafana/provisioning/dashboards/garage_decke.json
Hermes MCP	infra/hermes/garage_decke_mcp.py	CT151 /root/.hermes/garage_decke_mcp.py
Projektdoku	docs/projekte/garage-decke-monitoring.md	CT999 /root/docs/projekte/garage-decke-monitoring.md

Nach Aenderung: sofort git push origin main, sonst ueberschreibt Auto-Sync (sync-state.sh alle 15 min).

Hardware

Sensoren (Shelly)

Geraet	IP	Shelly-ID	MQTT-Prefix	Fuehler
Shelly 1	192.168.178.86	shelly1-F4CFA2D3B444	shellies/shelly1-F4CFA2D3B444	3x DS18B20 (idx 0–2)
Shelly 1	192.168.178.78	shelly1-8CAAB55D9A15	shellies/shelly1-8CAAB55D9A15	2x DS18B20 (idx 0–1)

Sensor-Zuordnung (final 26.06.2026)

InfluxDB sensor	Bedeutung	Shelly	idx	hwID
rl_klimadecke	RL Klimadecke (Ruecklauf, waermer)	.86	0	28ff641e01be641a
pwt	PWT-Oberflaeche (Gehaeuse oben)	.86	1	28ff641e01b534e2
vl_kaeltedecke	VL KaelteDecke (Vorlauf, kalt)	.86	2	28ff641e23c9d2f6
vl_brunnen	VL Brunnen (vor PWT, kalt)	.78	0	28ff641e23ea0235
rl_brunnen	RL Brunnen (nach PWT, waermer)	.78	1	28ff641e23f7232d

Wichtig: InfluxDB-Tag node=garage_decke — nicht garage (das ist der Raum-Satellit).

Urspruenglich decke_1..5 / reserve — umbenannt in semantische Tags; alte last()-Werte in Influx ignorieren.

Hydraulik / Pumpen (Stand 27.06.2026 Abend)

Komponente	Details
Brunnenpumpe	Bestehend, liefert Volumen am Brunnen
KD-Pumpe	2. Pumpe KaelteDecke; Flussrichtung umgedreht (Entlueftung) → Grafana kd_flussrichtung = Umgekehrt
Verstaerkerpumpe	ZC-T50 (haendlerisch „50 W“), Typenschild: 24 V DC, 3,5 A ≈ 84 W elektrisch; als Druckerhoehungspumpe
Aktueller Test	3 Pumpen in Reihe (Brunnen + Verstaerker + KD) — Durchfluss 5,27 l/min gemessen (27.06. Abend)
Mittelfristig	1–2 Pumpen ausbauen — minimale Kombination finden, bei der l/min + PWT/KD-ΔT gleich bleiben

Erkenntnis Garten vs. Garage: Am Brunnen direkt wirkt die Zusatzpumpe stark; in der Garage weniger. Engpass ist Druckverlust (lange Leitung + PWT + KaelteDecke), nicht zu wenig Brunnenwasser. Mehr Pumpen in Reihe kompensieren das kurzfristig; dauerhaft besser: eine gut platzierte Verstaerkerpumpe (Zulauf beachten, Kavitation vermeiden).

Nach jedem Pumpen-Umbau: entlueften, 30–60 min stabilisieren, Durchfluss mit Wasseruhr messen (gleiche Stelle wie Benchmark), Grafana-Variable brunnen_durchfluss setzen.

KD-Flussrichtung optimiert (27.06.2026 — zentraler Befund)

Problem vor Umkehr: Nur ca. 20 % der KaelteDecke wurde spuerbar kalt — Rest stagnierte oder wurde nicht durchstroemt (Hydraulik/Entlueftung, nicht Sensorfehler).

Massnahme: Durchfluss in der KaelteDecke optimiert durch Umkehr der Flussrichtung (2. KD-Pumpe, Entlueftung). Grafana: kd_flussrichtung = Umgekehrt (-1).

Ergebnis: Erst nach der Umkehr wurde die gesamte KaelteDecke kalt. Daten bestaetigen den Sprung (~09:30 Uhr):

Phase	Hydraulisches VL KD	Hydraulisches RL KD	ΔT KD	Wirkung
Frueh (wenig Durchfluss)	~27 °C	~20 °C	~0 K (VL waermer als RL)	Decke praktisch aus
Nach Flussumkehr + Pumpen	~20 °C ↓	~25 °C ↑	~5,5 K	volle Decke kalt

Interpretation: Fuehler bleiben am Rohr fix montiert — die hydraulische VL/RL-Zuordnung aendert sich durch die Flussrichtung. Vorher lief vermutlich nur ein Kurzschluss-/Teilstrom (ein Strang kalt, Rest tot). Nach Umkehr: Durchstroemung der gesamten Flaeche, VL faellt deutlich, RL steigt — typisches Kuehlbetriebsbild.

Fuer kuenftige Wartung: Flussrichtung und Entlueftung sind genauso wichtig wie Pumpenleistung. Ohne korrekte Richtung liefert mehr Druck allein keine volle Decke.

Montage Fuehler

Fuehler	Status	Anmerkung
Klimadecke VL/RL	montiert, plausibel	ΔT ~4–6 K je nach Hydraulik
PWT-Oberflaeche	auf PWT geklemmt	reagiert schnell; Indikator „PWT wird kalt“
Brunnen VL/RL	isoliert gegen Raumluft (27.06.)	ΔT ~2,4–2,8 K; optional Tauchhuelle nachruesten

Shelly Gen1: MQTT statt App

Shelly 1 (Gen1) kann entweder Cloud (Shelly-App) oder MQTT — nicht parallel. Fuer Monitoring ist MQTT aktiv:

http://<ip>/settings/mqtt?mqtt_enable=true&mqtt_server=192.168.178.36:1883&mqtt_clean_session=true&mqtt_update_period=30

Lokale Werte/Identifikation: Browser http://192.168.178.86 bzw. .78/status → ext_temperature.

MQTT-Topics (Beispiel)

shellies/shelly1-F4CFA2D3B444/ext_temperature/0   → 29.5
shellies/shelly1-F4CFA2D3B444/ext_temperatures    → JSON mit hwID + tC
shellies/shelly1-8CAAB55D9A15/ext_temperature/1   → 22.1

Telegraf / InfluxDB

Fuenf feste [[inputs.mqtt_consumer]]-Bloecke in satellites.conf — je Topic ein Input mit festen Tags node=garage_decke, sensor=<rolle>.

# Auszug infra/telegraf/satellites.conf (Kommentarblock + Tags)
#   rl_klimadecke  = shelly .86 idx0
#   pwt            = shelly .86 idx1
#   vl_kaeltedecke = shelly .86 idx2
#   vl_brunnen     = shelly .78 idx0
#   rl_brunnen     = shelly .78 idx1

[[inputs.mqtt_consumer]]
  topics = ["shellies/shelly1-F4CFA2D3B444/ext_temperature/0"]
  name_override = "temperature"
  [inputs.mqtt_consumer.tags]
    node = "garage_decke"
    sensor = "rl_klimadecke"
# ... analog fuer pwt, vl_kaeltedecke, vl_brunnen, rl_brunnen

Verifikation

# MQTT live (auf CT143)
mosquitto_sub -h 127.0.0.1 -t 'shellies/shelly1-F4CFA2D3B444/ext_temperature/#' -v

# InfluxDB
curl -sG 'http://127.0.0.1:8086/query' --data-urlencode 'db=sensors' \
  --data-urlencode "q=SELECT last(\"value\") FROM \"temperature\" WHERE \"node\"='garage_decke' GROUP BY \"sensor\""

Benchmark / Messwerte

Durchfluss

Datum	Konfiguration	l/min	Quelle
27.06.2026	Brunnenpumpe + KD (ohne Verstaerker)	3,5	Wasseruhr
27.06.2026 Abend	+ ZC-T50, 3 Pumpen in Reihe	5,27	Wasseruhr — Grafana-Default

Temperatur-Vergleich (kd_flussrichtung = Umgekehrt)

Kennzahl	Vor Verstaerkerpumpe	Nach Verstaerkerpumpe (27.06. Abend)
VL Brunnen	15,8 °C	15,1 °C
RL Brunnen	18,5 °C	17,6 °C
ΔT Brunnen	2,7 K	2,4–2,5 K
PWT-Oberflaeche	17,7 °C	16,2 °C
KD-ΔT (RL−VL)	~4,5 K	~6,0 K
Leistung Brunnen	~659–684 W @ 3,5 l/min, ΔT ~2,7 K	~772 W @ 5,27 l/min, ΔT ~2,1 K (live); ~920 W bei ΔT 2,5 K
Garage-Raum (node=garage)	~27,4 °C	~27,8 °C (Traegheit; Decke fuehlt sich kaelter an)

Interpretation: Sekundaerseite (PWT, KD) profitiert deutlich. Brunnen-ΔT sinkt leicht (typisch bei mehr Volumen). Netto-Leistung erst nach neuem Durchfluss: Q [W] ≈ l/min × ΔT × 69,8.

Beispielrechnung bei ΔT = 2,5 K:

l/min	~Leistung
5,0	~837 W
6,0	~1005 W
7,0	~1172 W

Grafana

Eigenschaft	Wert
Titel	Garage Decke
UID	garage_decke
URL	/d/garage_decke/garage-decke
Datasource	InfluxDB-sensors (DB sensors), Math-Panels: Mixed
Refresh	30 s
Stat-Anzeige	Hintergrund gruen (OK) oder schwarz (kein Signal)

Dashboard-Variablen

Variable	Typ	Default	Zweck
kd_flussrichtung	Dropdown 1 / -1	-1 (Umgekehrt)	Tauscht hydraulische VL/RL-Zuordnung der fest montierten KD-Fuehler
brunnen_durchfluss	Dropdown 3 … 8 l/min (inkl. 5,27)	5,27	Brunnen-Volumenstrom fuer Leistungsberechnung

Durchfluss nur Brunnenkreis bekannt. KD-Kreis: nur ΔT, keine kW ohne Durchflussmesser.

KD Flussrichtung (kd_flussrichtung)

Fuehler bleiben am Rohr (rl_klimadecke idx0, vl_kaeltedecke idx2). Math in garage_decke.json:

RL_anzeige = (A + B - kd_flussrichtung * (B - A)) / 2
VL_anzeige = (A + B + kd_flussrichtung * (B - A)) / 2
ΔT_KD      = RL_anzeige - VL_anzeige

(A = rl_klimadecke, B = vl_kaeltedecke in Influx)

Panels

Zeile 1 — Temperaturen: RL KD, PWT, VL KD, VL Brunnen, RL Brunnen

Zeile 2 — Berechnet:

Panel	Formel	Einheit
ΔT KaelteDecke	RL − VL (per Flussrichtung)	K
ΔT Brunnen	rl_brunnen − vl_brunnen	K
Leistung Brunnen	brunnen_durchfluss × ΔT_Brunnen × 0,0698	kW (Anzeige W)

Verlaufs-Charts: 5 Temperaturen; ΔT KD + ΔT Brunnen + Leistung Brunnen

Formel Leistung Brunnen

Q [kW] ≈ V̇ [l/min] × ΔT [K] × 0,0698
Q [W]  ≈ V̇ [l/min] × ΔT [K] × 69,8

Benchmark ohne Verstaerker (27.06.): 3,5 l/min × 2,8 K × 69,8 ≈ 684 W

Benchmark mit Verstaerker (27.06. Abend): 5,27 l/min × 2,1 K × 69,8 ≈ 772 W (gemessen); bei ΔT 2,5 K ≈ 920 W

Grafana — technische Fixes (27.06.2026)

Problem	Ursache	Fix (Commit)
5× No Data in Stat-Panels	filterByRefId filterte Math-Abhaengigkeiten A/B weg	hide: true auf A/B, kein filterByRefId
No Data bei Math	Panel-DS Influx statt Mixed	Datasource -- Mixed --
Rot/Gruen-Flackern	colorMode: background + mehrere Serien	Nur eine sichtbare Serie; zweistufige Thresholds
KD-ΔT negativ	Swap-Formel (B−A) statt (B−A) mit Richtung	kd_flussrichtung + korrigierte Math
PWT-ΔT-Panel	wenig Aussagekraft	durch ΔT Brunnen ersetzt

Grenzen

• KD-Leistung kW: ohne Durchflussmesser im KD-Kreis nicht berechenbar
• Garagen-Kuehlleistung gesamt: Raumtemp garage vs. aussen — separates Orakel
• Brunnen-Leistung: abhaengig von Wasseruhr-Messung und VL/RL-Montage

Deploy

# Sync auf pve-hetzner AUS, dann in /root/homelab-brain/ editieren, commit + push

# auf pve-mu-3:
pct push 143 satellites.conf /etc/telegraf/telegraf.d/satellites.conf
pct exec 143 -- systemctl restart telegraf

pct push 143 garage_decke.json /etc/grafana/provisioning/dashboards/garage_decke.json
# Optional: API-Overwrite fuer sofortige Live-Aenderung (siehe Session 27.06.)
pct exec 143 -- systemctl restart grafana-server

Verwandte Messpunkte

Quelle	node	Zweck
Garagen-Raum-Satellit	garage	Raumluft Werkstatt
Aussenfuehler ESP8266	aussen	Temp. unter Dach/Vordach (MQTT legacy: oelraum/temp)
Oelknoten	oelknoten	Oelraum-Temperaturen (separates Board oelknoten)

Historie

• 26.06.2026: MQTT an beiden Shellys, Telegraf-Ingest, Grafana-Board. node=garage_decke (Kollision mit Raum-Satellit garage). Sensor-Zuordnung identifiziert.
• 26.06. Abend: reserve → pwt, Fuehler auf PWT geklemmt (~26 °C → ~16 °C).
• 27.06.: Brunnen-Fuehler isoliert; ΔT Brunnen plausibel (~2,8 K). Durchfluss 3,5 l/min gemessen. Benchmark 684 W.
• 27.06.: 2. KD-Pumpe, Flussrichtung umgedreht → kd_flussrichtung. Grafana: ΔT KD/Brunnen, Leistung Brunnen.
• 27.06.: Grafana-Stabilisierung (Mixed-DS, hide A/B, gruen/schwarz Hintergrund). Forgejo Issue #132.
• 27.06. Abend: ZC-T50 Verstaerkerpumpe eingebaut; 3 Pumpen in Reihe (Test). Durchfluss 5,27 l/min (+50 % vs. 3,5). Leistung ~772 W @ ΔT 2,1 K. Mittelfristig Pumpen reduzieren.
• 27.06.: KD-Flussrichtung umgekehrt (Entlueftung/Optimierung). Vorher ~20 % der Decke kalt, danach volle Flaeche — VL KD von ~27 °C auf ~20 °C, ΔT ~5,5 K. Belastungstest bei ~38 °C aussen.
• 27.06. Abend — Test bestanden: Brunnenkühlung + KaelteDecke unter Extremhitze (~38 °C aussen) hydraulisch OK. 5,27 l/min, ~772 W Brunnenleistung, volle Decke kalt. Pumpenstrom (~84 W Verstaerker + bestehend) bei PV-Ueberschuss akzeptabel. Naechster Schritt: Pumpen-Kombination vereinfachen.

Hermes MCP (CT151, ab 28.06.2026)

Hermes fragt Brunnen/Kältedecke nicht per curl/ioBroker ab — festes MCP-Tool.

Artefakt	Pfad im Repo	Deploy-Ziel (CT151)
MCP-Server	infra/hermes/garage_decke_mcp.py	/root/.hermes/garage_decke_mcp.py
Gateway-Config	manuell in /root/.hermes/config.yaml	Block mcp_servers.garage_decke

Tools

Tool	Funktion
garage_decke_live	Alle 5 Sensoren, ΔT Brunnen/KD, Leistung @ BRUNNEN_DURCHFLUSS, Garage-Raum + Außen
garage_decke_compare	Jetzt vs. vor N Stunden (hours, default 24)

config.yaml (Auszug)

  garage_decke:
    command: /opt/hermes-agent/.venv/bin/python3
    args:
    - /root/.hermes/garage_decke_mcp.py
    env:
      KD_FLUSSRICHTUNG: "-1"
      BRUNNEN_DURCHFLUSS: "5.27"

Deploy

# auf pve-mu-3:
pct push 151 garage_decke_mcp.py /root/.hermes/garage_decke_mcp.py
pct exec 151 -- chmod +x /root/.hermes/garage_decke_mcp.py
# config.yaml Block ergänzen (siehe oben)
pct exec 151 -- systemctl restart hermes-gateway

Regel (MEMORY.md): Bei Fragen zu Brunnen/Kältedecke immer garage_decke_live — niemals Vorher-Werte erfinden.