# Better Thermostat Multi-Mode Controller

Home Assistant Blueprint für intelligente Heizungssteuerung mit Better Thermostat, automatischer Sommer/Winter-Umschaltung und Zeitplänen.

## Features

- **Automatische Sommer/Winter-Umschaltung** basierend auf aktueller Außentemperatur
- **Tagesabhängige Heizpläne** via Schedule-Helper (z.B. Morgen 7-9 Uhr: 21°C, Tag: 19°C)
- **Urlaubsmodus** mit Frostschutztemperatur (z.B. 16°C)
- **Better Thermostat Integration** nutzt bereits SHT31-Sensoren, Fenstersensoren und Homematic IP Thermostate
- **Automatische Prüfung** alle 30 Minuten + bei Änderungen

## Voraussetzungen

- Home Assistant mit Better Thermostat Integration installiert (HACS)
- Homematic IP Thermostat via CCU3 eingebunden
- SHT31 Temperatursensor oder ähnliches als `room_sensor` in Better Thermostat konfiguriert
- Fenstersensor als `window_sensor` in Better Thermostat konfiguriert
- Weather-Integration (z.B. `weather.openweathermap` oder `weather.schleswig`)

## Installation

### 1. Blueprint importieren
Einstellungen > Automatisierungen > Blueprints (oben rechts)

Blueprint importieren > YAML einfügen

### 2. Helfer erstellen
**Schedule-Helper für Heizplan:**

Einstellungen > Geräte & Dienste > Helfer > Zeitplan
Name: Heizzeitplan Wohnzimmer
Zeitfenster: z.B. Mo-Fr 7:00-9:00, 17:00-22:00

**Urlaubsmodus-Button:**

Einstellungen > Geräte & Dienste > Helfer > Umschalter (Boolean)
Name: Urlaubsmodus Heizung

### 3. Automation erstellen

Einstellungen > Automatisierungen > Neue Automation

Better Thermostat Multi-Mode Controller auswählen


## Konfiguration

### Entities zuweisen
- **Better Thermostat Entity**: `climate.wohnzimmer_bt`
- **Heizzeitplan Schedule**: `schedule.heizzeitplan_wohnzimmer`
- **Urlaubsmodus Helper**: `input_boolean.urlaub`
- **Wettervorhersage**: `weather.schleswig`

### Temperaturen anpassen
- **Sommer-Schwellwert**: 20°C (Heizung aus wenn wärmer)
- **Winter-Schwellwert**: 10°C (Heizen wenn kälter)
- **Eco Temperatur**: 16°C (Urlaub/Nacht)
- **Komfort Temperatur**: 20-21°C (Schedule aktiv)

## Funktionsweise

### Prioritäten (von oben nach unten)
1. **Sommer-Modus** (Temp > 20°C) → Heizung OFF
2. **Urlaubsmodus** (Button ON) → 16°C Eco
3. **Winter + Schedule aktiv** (Temp < 10°C + Zeitplan) → 20°C Komfort
4. **Winter ohne Schedule** (Temp < 10°C) → 18°C (Eco+2)

### Beispiel-Tag im Winter (5°C außen)
- **07:00 Uhr**: Schedule startet → 20°C
- **09:00 Uhr**: Schedule endet → 18°C
- **17:00 Uhr**: Schedule startet → 20°C
- **22:00 Uhr**: Schedule endet → 18°C

## Anpassung für mehrere Räume

Erstelle pro Raum:
- Eigenen Schedule-Helper (`schedule.heizzeitplan_schlafzimmer`)
- Eigene Automation mit Blueprint (selbe Wetter/Urlaubs-Entity nutzbar)
- Separate Better Thermostat Entity (`climate.schlafzimmer_bt`)

## Troubleshooting

### "None has no element 0" Fehler
Alte Forecast-API → Nutze aktuelle Temperatur statt Forecast.
**Fix**: Zeile `weather_temp` anpassen (siehe Blueprint Code Zeile 82)

### Heizung reagiert nicht
1. Prüfe Better Thermostat Config: `room_sensor` + `window_sensor` gesetzt?
2. Trace anschauen: Automation > Drei-Punkte > Traces
3. Template testen: Entwicklertools > Template > `{{ state_attr('weather.schleswig', 'temperature') }}`

### Falsche Temperaturen
- Better Thermostat kalibrieren: Offset in BT-Config prüfen
- SHT31 vs. Homematic-Sensor: BT nutzt externen Sensor, Thermostat zeigt evtl. eigenen Wert

## Quellen & Credits

- Better Thermostat: https://better-thermostat.org
- GitHub: https://github.com/KartoffelToby/better_thermostat
- Homematic Integration: https://www.home-assistant.io/integrations/homematic

## Version

v1.0 - Januar 2026
- Initiale Version mit Sommer/Winter/Urlaub-Modi
- Aktuelle Temperatur statt Forecast (HA 2023.9+ kompatibel)