🏊 Violet Pool Controller für Home Assistant

Verwandle deinen Pool in einen Smart Pool! Diese umfassende Home Assistant Integration bietet vollständige Kontrolle und Überwachung deines Violet Pool Controllers.

📋 Inhaltsverzeichnis

• 🌟 Features
• ⚡ Schnellstart
• 📦 Installation
• ⚙️ Konfiguration
• 🧩 Verfügbare Entitäten
• 🤖 Automatisierungen
• 🚨 Fehlerbehebung
• 💝 Unterstützung

---

🌟 Features

🎯 Kernfunktionen

• 🌡️ Intelligente Klimasteuerung - Heizung & Solar mit Zeitplanung
• 🧪 Automatische Chemie-Dosierung - pH & Chlor mit Sicherheitsgrenzen
• 🏊 Smarte Abdeckungssteuerung - Wetterabhängige Automatisierung
• 💧 Filter-Management - Automatische Rückspülung & Wartung
• 💡 LED-Beleuchtung - Vollständige RGB/DMX-Steuerung
• 📱 Mobile-Ready - Kontrolle von überall über HA App
• 🔧 100% Lokal - Keine Cloud erforderlich, vollständige Privatsphäre

📊 Überwachung & Sensoren

• Wasserchemie: pH, Redox (ORP), Chlorgehalt mit Trend-Tracking
• Temperaturen: Pool, Umgebung, Solar-Kollektor
• System-Status: Pumpen, Heizung, Filterdruck, Wasserstände
• Anlagen-Gesundheit: Laufzeit, Fehlererkennung, Wartungsalarme

🤖 Smart Automation

• Energie-Optimierung: PV-Überschuss-Modus für Solarheizung
• Wetter-Integration: Automatische Reaktionen auf Umweltbedingungen
• Wartungsplanung: Intelligente Zyklen für alle Anlagenteile
• Sicherheitssysteme: Notabschaltungen & Überlaufschutz
• Custom Scenes: Pool-Party, Eco, Winter & Urlaubs-Modi

---

⚡ Schnellstart

1. Vorbereitung

• ✅ Home Assistant 2023.1+ installiert
• ✅ HACS installiert (Anleitung)
• ✅ Violet Pool Controller im Netzwerk erreichbar
• ✅ Controller-IP-Adresse bekannt (z.B. 192.168.1.100)

2. Installation (2 Minuten)

HACS → Integrationen → Custom Repository hinzufügen:
Repository: https://github.com/xerolux/violet-hass
Kategorie: Integration

3. Konfiguration (3 Minuten)

Einstellungen → Geräte & Dienste → Integration hinzufügen → "Violet Pool Controller"
Host eingeben → Features auswählen → Fertig!

🎉 Geschafft! Dein Pool ist jetzt smart und bereit für Automatisierungen.

---

📦 Installation

🚀 HACS Installation (Empfohlen)

Schritt 1: Repository hinzufügen

1. HACS öffnen → ⋮ (drei Punkte) → "Benutzerdefinierte Repositorys"
2. URL: https://github.com/xerolux/violet-hass
3. Kategorie: "Integration" → "Hinzufügen"

Schritt 2: Integration installieren

1. Nach "Violet Pool Controller" suchen
2. "Herunterladen" klicken
3. Home Assistant neu starten

🔧 Manuelle Installation

Für Entwickler & Fortgeschrittene (Klicken zum Erweitern)

# Option 1: Git Clone
cd /config/custom_components/
git clone https://github.com/xerolux/violet-hass.git violet_pool_controller

# Option 2: Download
wget https://github.com/xerolux/violet-hass/archive/main.zip
unzip main.zip
mv violet-hass-main/custom_components/violet_pool_controller /config/custom_components/

# Neustart erforderlich

---

⚙️ Konfiguration

🎯 Basis-Setup

Die Konfiguration erfolgt komplett über die UI - kein YAML nötig!

Integration hinzufügen:

Einstellungen → Geräte & Dienste → Integration hinzufügen → "Violet Pool Controller"

📋 Konfigurationsoptionen

Einstellung	Beispiel	Beschreibung
Host	192.168.1.100	IP-Adresse des Controllers
Username	admin	Falls Authentifizierung aktiviert
Password	•••••••••	Controller-Passwort
SSL verwenden	☐/☑	Bei HTTPS-Nutzung aktivieren
Abfrageintervall	30s	Update-Frequenz (10-300s)
Pool-Größe	50 m³	Für Dosierungsberechnungen

🎛️ Feature-Auswahl

Wähle die Komponenten, die du aktivieren möchtest:

✅ Heizungssteuerung        ✅ Solar-Management
✅ pH-Steuerung            ✅ Chlor-Steuerung  
✅ Abdeckungssteuerung     ✅ Rückspülsystem
✅ LED-Beleuchtung         ✅ PV-Überschuss-Modus
☐ Erweiterungsausgänge     ☐ Digitale Eingänge

---

🧩 Verfügbare Entitäten

Die Integration erstellt automatisch alle relevanten Entitäten basierend auf deiner Controller-Konfiguration:

🌡️ Klimasteuerung

climate.pool_heater          # Hauptheizung mit Thermostat
climate.pool_solar           # Solar-Kollektor Management

📊 Sensoren

# Wasserchemie
sensor.pool_temperature      # Aktuelle Wassertemperatur  
sensor.pool_ph_value         # pH-Wert (6.0-8.5)
sensor.pool_orp_value        # Redoxpotential (mV)
sensor.pool_chlorine_level   # Freies Chlor (mg/l)

# System-Status
sensor.filter_pressure       # Filtersystem-Druck
sensor.water_level          # Pool-Wasserstand
sensor.pump_runtime         # Pumpen-Laufzeit heute
sensor.energy_consumption   # Energieverbrauch

💡 Schalter & Steuerungen

# Hauptkomponenten
switch.pool_pump            # Filterpumpe (variable Geschwindigkeit)
switch.pool_heater          # Heizung Ein/Aus
switch.pool_solar           # Solar-Zirkulation
switch.pool_lighting        # Pool-Beleuchtung

# Chemie-Dosierung  
switch.ph_dosing_minus      # pH- Dosierpumpe
switch.ph_dosing_plus       # pH+ Dosierpumpe
switch.chlorine_dosing      # Chlor-Dosierung

# Wartung & Extras
switch.backwash             # Rückspül-Zyklus
switch.pool_cover           # Abdeckung
switch.pv_surplus_mode      # Solar-Überschuss-Modus

---

🤖 Automatisierungen

🎯 Custom Services

Die Integration bietet spezialisierte Services für erweiterte Automatisierung:

🔧 Kern-Services (Klicken zum Erweitern)

violet_pool_controller.turn_auto

Gerät in Automatikmodus schalten:

service: violet_pool_controller.turn_auto
target:
  entity_id: switch.pool_pump  
data:
  auto_delay: 30  # Optional: Verzögerung in Sekunden

violet_pool_controller.set_pv_surplus

Solar-Überschuss-Modus aktivieren:

service: violet_pool_controller.set_pv_surplus
target:
  entity_id: switch.pv_surplus_mode
data:
  pump_speed: 2   # Geschwindigkeitsstufe 1-3

🧪 Chemie-Services (Klicken zum Erweitern)

violet_pool_controller.manual_dosing

Manuelle Dosierung auslösen:

service: violet_pool_controller.manual_dosing
target:
  entity_id: switch.ph_dosing_minus
data:
  duration_seconds: 30  # Dosierdauer

📋 Automation Blueprints

Installation:

Einstellungen → Automatisierungen & Szenen → Blueprints → Blueprint importieren

Verfügbare Blueprints:

• 🌡️ Intelligente Temperatursteuerung - Tag/Nacht-Modi mit Solar-Priorität
• 🧪 pH-Management - Automatische Dosierung mit Sicherheitsgrenzen
• ⚡ Energie-Optimierung - PV-Überschuss-Nutzung
• 🌧️ Wetter-Reaktionen - Abdeckung bei Regen/Wind
• 🏊 Pool-Modi - Party, Eco, Winter & Urlaubs-Automatisierungen

---

🚨 Fehlerbehebung

⚡ Häufige Probleme & Lösungen

Problem	Schnelle Lösung
Keine Verbindung	IP-Adresse & Firewall prüfen
SSL-Fehler	"SSL verwenden" Setting anpassen
Entitäten fehlen	Controller-Features & Integration neu laden
Langsame Updates	Abfrageintervall verringern (min. 10s)

🔍 Debug-Schritte

1. Konnektivität testen:

ping 192.168.1.100
curl http://192.168.1.100/getReadings?ALL

2. Logs prüfen:

tail -f /config/home-assistant.log | grep violet_pool_controller

3. Integration neu laden:

Einstellungen → Geräte & Dienste → Violet Pool Controller → ⋮ → Neu laden

📞 Support erhalten

• 🐛 Bug Reports: GitHub Issues
• 💬 Community: Discord | Forum
• 📧 Direkt: git@xerolux.de

---

💝 Unterstützung

Diese Integration wird in meiner Freizeit entwickelt. Wenn sie dir hilft, zeige etwas Liebe:

Andere Unterstützungsmöglichkeiten:

• ⭐ Repository auf GitHub sternen
• 📢 Mit anderen Pool-Besitzern teilen
• 🐛 Bugs melden & Verbesserungen vorschlagen
• 📝 Code oder Dokumentation beitragen
• 💬 Anderen in Community-Foren helfen

---

🏊 Über den Violet Pool Controller

Der VIOLET Pool Controller von PoolDigital GmbH & Co. KG ist ein Premium Smart Pool Automation System aus deutscher Entwicklung.

Warum Violet?

• 🔧 Komplette Pool-Verwaltung - Alles aus einer Hand
• 📱 Smart Home Ready - JSON API für nahtlose Integration
• 🛡️ Sicherheit First - Mehrfache Schutz- & Überwachungssysteme
• ⚡ Energieeffizient - Intelligente Planung & PV-Integration
• 🇩🇪 Made in Germany - Premium Qualität & Support

Bezugsquellen:

• Offizieller Shop: pooldigital.de
• Community: PoolDigital Forum

---

🤝 Mitwirken

Beiträge sind herzlich willkommen! Ob Bug-Fixes, neue Features, Dokumentation oder Tests:

1. Repository forken
2. Feature-Branch erstellen (git checkout -b feature/amazing-feature)
3. Änderungen committen (git commit -m 'Add amazing feature')
4. Branch pushen (git push origin feature/amazing-feature)
5. Pull Request öffnen

Siehe CONTRIBUTING.md für Details.

---

📋 Changelog

v0.1.0 (In Entwicklung)

• ✨ Erste Veröffentlichung mit umfassender Pool-Steuerung
• 🌡️ Klimasteuerung für Heizung & Solar
• 🧪 Chemie-Überwachung & automatisierte Dosierung
• 🏊 Pool-Abdeckungs-Integration mit Wetter-Automatisierung
• 🔄 Intelligente Rückspül-Automatisierung
• 📱 Vollständige Home Assistant UI-Integration
• 🤖 Smart Automation Blueprints
• 🌍 Multi-Language Support (EN/DE)

---

Made with ❤️ for the Home Assistant & Pool Community

Transform your pool into a smart pool - because life's too short for manual pool maintenance! 🏊‍♀️🤖

---