Der Frostalarm, der auch funktioniert, wenn Home Assistant ausfällt

Was es deinem Home-Assistant-Setup hinzufügt

• Ein Alarm, wenn es im Haus still wird. Bleiben Messwerte eine festgelegte Anzahl Stunden aus, sagt ProbeHarbor dir Bescheid. Stille im Winter heißt meist, dass Strom oder Internet weg sind – und die Heizung womöglich auch.
• Alarme, die nicht von deinem Netzwerk abhängen. E-Mail, Push und Chat-Apps im Free-Plan, SMS mit Pro. Haushaltsmitglieder bekommen sie, ohne Zugriff auf dein Home Assistant zu brauchen.
• Warnung, bevor die Kälte kommt. Eine Schätzung der Zeit bis zum Gefrieren in jedem Plan, Frostwarnungen aus der Wettervorhersage mit Member und Unwetterwarnungen des National Weather Service (USA) mit Pro.
• Keine neue Hardware. Sende jede Temperatur- oder Leck-Entität aus Home Assistant. Zwei Geräte sind kostenlos.

Zwei Richtungen, einzeln oder kombiniert: Sende Entitäten aus Home Assistant an ProbeHarbor für externe Alarme (das YAML wird mit deinem Schlüssel unter Dashboard → Devices erzeugt, wenn du Home Assistant auswählst), und hol ProbeHarbor-Sensoren mit der HACS-Integration unten als Entitäten in Home Assistant. Hintergrund: Frostalarm in Home Assistant einrichten und was bei einem Stromausfall passiert.

Installation über HACS

1. In Home Assistant: HACS → Integrations → ⋮ → Custom repositories
2. Repository https://github.com/doodersrage/probeharbor-home-assistant hinzufügen (Kategorie: Integration)
3. ProbeHarbor installieren und Home Assistant neu starten
4. Settings → Devices & services → Add integration → ProbeHarbor
5. Erstelle unter Dashboard → Share einen Live-Freigabelink (Free enthält einen Familien-Livelink; Pro ergänzt Verlauf/Metriken und Links ohne Ablaufdatum) und füge das Token aus /share/YOUR_TOKEN ein

Ausführliche Entwickleranleitung: Home-Assistant-Anleitung ↗ · Manuelle YAML-Rezepte funktionieren weiterhin, wenn du REST-Sensoren statt HACS bevorzugst.

Was in HA erscheint

• Sensoren: Temperatur, Luftfeuchte, CO₂, Luftdruck, PM2.5, VOC, Füllstand, Energie und allgemeine numerische Sensoren
• Binärsensoren: Tür, Wasser/Leck, Bewegung und Stromzustand
• Abfrageintervall. HACS fragt standardmäßig alle 5 Minuten ab (60–3600 s einstellbar). Für Dashboards reicht das; für zeitkritische Frostgrenzen und Nässekontakte nimm lieber nativen Push-Ingest (ESP/Arduino → ProbeHarbor), damit Alarme beim Messwert auslösen und nicht erst nach der nächsten HA-Abfrage. Parallelbetrieb ist normal: Push für Frost- und Leck-SMS, HACS für lokale Entitäten.
• Dienste (optionaler eingehender Webhook + Secret aus Dashboard → Share): thermaltrace.snooze, vacation, clear_snooze, clear_vacation, status
• Push-Dienst (optionaler Ingest-Schlüssel): thermaltrace.push mit einem JSON-payload-Dict

Native JSON-Formate (Push & Pull)

Über den HACS-Freigabelink hinaus erkennt ProbeHarbor automatisch JSON, das dein HA-Setup vielleicht schon ausgibt – ganz ohne eigenen Wrapper.

• Home-Assistant-REST-Sensor. Per POST senden oder abrufen: { "state": "65.3", "attributes": { "unit_of_measurement": "°F" } }; ordne unter Devices den Sensorschlüssel state zu
• SenML (RFC 8428). JSON-Array mit den Einheiten Cel / %RH; verbreitet bei IoT-Gateways
• thermaltrace.push: native sensors[] aus Automationen (siehe Innentemperatur unten)
• MQTT-Bridge: MQTT-Payloads aus dem LAN über POST /api/ingest/mqtt entpacken

Live-Beispiele: HA REST · SenML · Anleitung zu Ingest-Formaten

Innentemperatur über Home Assistant

Haus- und Sensorwerte nebeneinander in Overview und History. Zwei Wege: Nest-OAuth mit Pro (sofern verfügbar) oder als Plan B eine beliebige HA-Klima-Entität senden – praktisch, wenn die Ecobee-Entwickleranmeldung geschlossen ist oder du ein anderes Thermostat nutzt.

Nest-OAuth (Pro, bevorzugt, sofern verfügbar)

Auf probeharbor.dev können Pro-Haushalte Nest unter Dashboard → Temperature verbinden – für Live-Innentemperatur, Sollwert und HVAC-Modus neben den Sensoren in Dachboden, Kriechkeller oder Werkstatt; Frostalarme können diesen Kontext enthalten. Der Verlauf speichert Thermostat-Snapshots im selben ~15-Minuten-Takt wie andere Pro-Datenquellen.

• Vergleich für Endnutzer: ProbeHarbor vs. Nest
• Betreiber selbst gehosteter Instanzen, die OAuth-Secrets aktivieren: Nest- & Ecobee-Einrichtung für Betreiber

Plan B: Raumluft aus Home Assistant senden

Die Anmeldung zum Ecobee-Entwicklerprogramm ist oft geschlossen, daher steht Ecobee-OAuth selbst mit Pro eventuell nicht zur Verfügung. Jedes Thermostat, das schon in HA ist (Ecobee, Nest über HA, generisches climate.*), kann ProbeHarbor trotzdem beliefern: Sende die Raumtemperatur mit thermaltrace.push und wähle diesen Sensor dann unter Dashboard → Devices als Indoor reference.

1. Mach dein Thermostat in HA verfügbar (z. B. climate.living_room).
2. Ruf alle 15 Minuten thermaltrace.push mit einem temperature-Sensor auf (Schlüssel house_indoor).
3. In ProbeHarbor: Devices → Indoor reference: diesen Sensor auswählen.

automation:
  - alias: Push house temp to ProbeHarbor
    trigger:
      - platform: time_pattern
        minutes: "/15"
    action:
      - service: thermaltrace.push
        data:
          sensors:
            - key: house_indoor
              kind: temperature
              value: "{{ state_attr('climate.living_room', 'current_temperature') }}"
              unit: F

Auch nützlich für Ecobee über HA, wenn OAuth nicht verfügbar ist: siehe ProbeHarbor vs. Ecobee. Ausführliche Payload-Hinweise (GitHub Pages): Entwicklerdoku ↗

Parallelbetrieb mit MQTT (der übliche Weg)

ProbeHarbor ist kein MQTT-Broker. Die meisten Homelabber behalten Mosquitto / ESPHome / HA-MQTT im LAN und spiegeln ausgewählte Topics per HTTPS, wenn sie Frost- und Leckalarme aus der Cloud samt Verlauf wollen.

• Rezept für die MQTT → HTTPS-Bridge POST /api/ingest/mqtt mit deinem Geräteschlüssel
• Node-RED-Flow für Mosquitto-Abonnenten
• ProbeHarbor vs. selbst gehostetes MQTT: wann gehostete Alarme besser sind als ein eigener Stack

Alarme in Home Assistant

Ausgehende Pro-Webhooks feuern, wenn ProbeHarbor einen Frost-, Leck- oder eigenen Regelalarm sendet. Richte die URL auf deinen HA-Webhook-Endpunkt oder importiere den Blueprint.

• Webhook-Blueprint-YAML herunterladen
• YAML zur Entitätsbenennung für Push-Geräte
• Produktanleitung: Ingest & Webhooks
• Ausgehende und eingehende Tokens konfigurierst du unter Dashboard → Share

Prüfe X-Signature, wenn du in ProbeHarbor ein Webhook-Signatur-Secret festlegst. HA (oder jeder andere Empfänger) sollte POSTs ablehnen, die die HMAC-Prüfung nicht bestehen. Der Blueprint dokumentiert den Header; Details in der Ingest- & Webhook-Anleitung und den FAQ unten.

Beispiel-Automation

ProbeHarbor-Frost- und Leckalarme pausieren, solange eine Tür für Wartungsarbeiten offen steht:

automation:
  - alias: Snooze ProbeHarbor while door open
    trigger:
      - platform: state
        entity_id: cover.garage_door
        to: "open"
    action:
      - service: thermaltrace.snooze
        data:
          hours: 4