57 lines
2.0 KiB
Markdown
57 lines
2.0 KiB
Markdown
# 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
|
|
```json
|
|
{
|
|
"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.
|