Markisenwächter – Home Assistant Blueprint (ESPSomfy Edition)

Automatische Wetterschutz-Steuerung für eine Markise (cover), z. B. via ESPSomfy-RTS. Fährt bei Starkwind, Regen oder Sensorausfall ein und nach Entwarnung wieder aus – komplett ohne Helper-Entities.

---

Features

Funktion	Beschreibung
🌬️ Starkwind	Einfahren ab konfigurierbarer Windschwelle
🌧️ Regen	Einfahren, wenn der hochgerechnete Regenwert die Schwelle überschreitet
⚠️ Sensor-Timeout	Sicherheits-Einfahren, wenn der Windsensor unavailable/unknown wird
✅ Entwarnung	Wieder-Ausfahren auf definierte Position nach Beruhigungszeit
🕘 Uhrzeit	Optionales Einfahren zu fester Uhrzeit
🌇 Sonnenuntergang	Optionales Einfahren mit Offset (früher/später)
🌙 Nachtsperre	Nach Uhrzeit/Sonnenuntergang bleibt die Markise geschlossen
🔒 Auto-Extend Off	Automatisches Ausfahren komplett deaktivierbar

---

Installation

Variante A – Import-Button (empfohlen)

Variante B – manueller Import

Einstellungen → Automatisierungen & Szenen → Blueprints → Blueprint importieren, dann diese URL einfügen:

https://git.kleckerbox.link/Hassio/ha-ESP-MarquisenGuard/raw/branch/main/blueprints/automation/kleckerbox/markisenwaechter.yaml

Variante C – Datei kopieren

cp blueprints/automation/markisenwaechter/markisenwaechter.yaml \
   /config/blueprints/automation/markisenwaechter/

Danach Entwicklerwerkzeuge → YAML → Automatisierungen neu laden.

---

Voraussetzungen

• Home Assistant 2024.6.0 oder neuer
• Eine Markise als cover-Entity, die set_cover_position unterstützt
• Ein Windsensor (sensor, Einheit km/h)
• Ein Regensensor (sensor), der den Regen pro Sensor-Update liefert (nicht kumuliert!)
• Die sun-Integration (Standard in HA) für die Sonnenuntergangs-Option

---

Konfiguration

Eingabe	Default	Bedeutung
marquise_cover	–	Die zu steuernde Markise
extend_position	100	Position beim automatischen Ausfahren (%)
wind_sensor	–	Windgeschwindigkeitssensor
rain_sensor	–	Regensensor (Wert pro Update)
wind_max_threshold	27 km/h	Ab hier wird eingefahren
wind_min_threshold	20 km/h	Unterhalb dieses Werts gilt Entwarnung
rain_threshold	0.7 mm	Schwelle für den hochgerechneten Regenwert
rain_sample_seconds	12 s	Updateintervall des Regensensors
rain_projection_minutes	5 min	Hochrechnungszeitraum
automatic_extend_timeout_minutes	30 min	Wie lange der Wind ruhig sein muss
wind_sensor_timeout_minutes	15 min	Ab wann ein toter Windsensor als Gefahr gilt
disable_auto_extend	false	Automatisches Ausfahren abschalten
enable_time_close / close_time	false / 21:30	Einfahren zu fester Uhrzeit
enable_sunset_close / sunset_offset_minutes	false / -10	Einfahren zum Sonnenuntergang ± Offset

Regen-Hochrechnung

Der Blueprint rechnet den Momentanwert des Regensensors auf einen Zeitraum hoch:

rain_factor          = (rain_projection_minutes × 60) / rain_sample_seconds
rain_value_projected = rain_value_current × rain_factor

Beispiel: Sensor liefert alle 12 s einen Wert von 0.03 mm, Hochrechnung auf 5 min → Faktor 300 / 12 = 25 → projiziert 0.75 mm → über der Schwelle 0.7 → Markise fährt ein.

⚠️ Der Regensensor muss den Regen pro Update liefern. Ein kumulativer Tageszähler (total_increasing) führt zu Dauer-Einfahren.

---

Sicherheitshinweis

Dieses Blueprint ersetzt keinen zertifizierten Windwächter. Ein zuverlässiger Schutz vor Sturmschäden erfordert eine hardwareseitige Windsicherung am Antrieb. Die Automation ist von Netzwerk, HA-Verfügbarkeit und Sensorqualität abhängig. Nutzung auf eigene Gefahr.

---

Repository-Struktur

.
├── blueprints/automation/markisenwaechter/
│   └── markisenwaechter.yaml     # Das Blueprint
├── docs/
│   └── logic.md                  # Ablauflogik & Trigger-Matrix
├── .github/
│   ├── workflows/validate.yml    # YAML-/Blueprint-Validierung
│   └── ISSUE_TEMPLATE/
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
└── README.md

---

Lizenz

MIT