HOHA-Addons/fritz_temp_sync

Fritz!Box Temperature Sync

Dieses Add-on synchronisiert die gemessene Temperatur von Home-Assistant-Sensoren mit Fritz!DECT-Thermostaten, indem die Offset-Korrektur an der Fritz!Box angepasst wird.

Voraussetzungen

• Home Assistant Add-on Umgebung
• Fritz!Box mit Fritz!DECT-Thermostaten
• Home Assistant Entitäten für Thermostate und Temperatursensoren

Konfiguration

Die Optionen werden über das Add-on-Formular oder die options.json gesetzt.

Optionen

• fritzbox.url (URL, erforderlich): Basis-URL der Fritz!Box, z. B. http://fritz.box
• fritzbox.username (string, optional): Benutzername
• fritzbox.password (string, erforderlich): Passwort
• mappings (Liste, erforderlich): Zuordnung von Sensor → Thermostat
• update_timeout (int, erforderlich): Mindestabstand in Minuten zwischen Offset-Updates pro Thermostat
• log_level (string, optional): z. B. DEBUG, INFO, WARNING
• offset_threshold (float, optional): Mindestabweichung in °C, ab der ein Offset gesetzt wird (Default 0.5)
• dry_run (bool, optional): Wenn true, werden keine Änderungen an der Fritz!Box vorgenommen

Beispiel

{
  "fritzbox": {
    "url": "http://fritz.box",
    "username": "ha",
    "password": "***"
  },
  "mappings": [
    {
      "sensor": "sensor.room_temperature",
      "thermostate": "climate.room"
    }
  ],
  "update_timeout": 15,
  "log_level": "INFO",
  "offset_threshold": 0.5,
  "dry_run": false
}

Verhalten

• Bei jedem relevanten state_changed-Event wird die Differenz zwischen Thermostat- und Sensorwert geprüft.
• Erst ab offset_threshold erfolgt eine Offset-Korrektur.
• Pro Thermostat wird maximal alle update_timeout Minuten ein Update durchgeführt.

Logging

• INFO: Start/Stop, erfolgreiche Authentifizierung, Offset-Korrekturen
• WARNING: Verbindungsprobleme, Retries, Dry-Run-Hinweise
• DEBUG: Detailzustände und Entscheidungslogik

Hinweise

• Das Add-on schreibt keine Payload-Snapshots mehr auf die Platte.
• Die Zuordnung erfolgt über die Entity-ID-Namen aus Home Assistant.