violet-hass

🏊 Violet Pool Controller für Home Assistant

GitHub Release Downloads GitHub Activity License HACS

Discord Community Forum Buy Me A Coffee Tesla

Release Management

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

Violet Home Assistant Integration

📋 Inhaltsverzeichnis

🌟 Features

🎯 Kernfunktionen

📊 Überwachung & Sensoren

🤖 Smart Automation

⚡ Schnellstart

1. Vorbereitung

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) ```bash # 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/Password admin / •••• Optional für Basic Auth
SSL verwenden ☑ Bei HTTPS-Nutzung aktivieren
Abfrageintervall 30s Update-Frequenz (10–300 s)
Pool-Größe 50 m³ Für Dosierungsberechnungen
Pool-Typ & Desinfektion outdoor, chlorine Optimiert Default-Werte

🎛️ Feature- & Sensor-Auswahl

Der Einrichtungsassistent führt dich durch zwei Auswahllisten:

  1. Aktive Features – nur Komponenten aktivieren, die auch verkabelt sind (z. B. Heizung, Solar, PV-Überschuss, digitale Eingänge).
  2. Dynamische Sensoren – beim ersten Start werden alle Sensoren des Controllers gelesen und gruppiert. Du kannst per Mehrfachauswahl entscheiden, welche Werte in Home Assistant landen sollen.

💡 Keine Auswahl getroffen? Dann erstellt die Integration automatisch alle verfügbaren Sensoren (voll kompatibel zu bestehenden Installationen).

🧰 Erweiterte Optionen

Über Einstellungen → Geräte & Dienste → Violet Pool Controller → Konfigurieren kannst du jederzeit nachjustieren:

Alle Änderungen werden ohne Neustart übernommen.

🖥️ Lovelace Dashboard

Damit du sofort loslegen kannst, liegt ein fertiges Dashboard bei:

Installation:

  1. Datei Dashboard/pool-dashboard.yaml nach /config/ kopieren.
  2. Optional: screenshots/pool-dashboard.svg nach /config/www/violet-hass/ legen, damit das Dashboard das Vorschaubild findet.
  3. In Home Assistant → Einstellungen → Dashboards → ⋮ → Dashboard aus YAML importieren.
  4. Falls deine Entitäten anders heißen (z. B. wegen mehrerer Controller), per Suchen/Ersetzen in der YAML-Datei anpassen.

Das Dashboard nutzt ausschließlich Standard-Karten – keine zusätzlichen Custom-Cards nötig.

🧩 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: ```yaml 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: ```yaml 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: ```yaml 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:

🚨 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

💝 Unterstützung

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

GitHub Sponsor Ko-Fi Buy Me A Coffee

Andere Unterstützungsmöglichkeiten:

🏊 Über den Violet Pool Controller

Violet Pool Controller

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

Warum Violet?

Bezugsquellen:

🤝 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.

🛠️ Entwicklungsumgebung einrichten

  1. Repository klonen: 
    git clone https://github.com/xerolux/violet-hass.git
cd violet-hass

  2. Dev Container nutzen (Empfohlen): Das Projekt enthält eine .devcontainer Konfiguration für VS Code. Einfach das Projekt im Container öffnen, und alle Abhängigkeiten werden automatisch installiert.

  3. Manuelle Einrichtung: 
    python3 -m venv venv
source venv/bin/activate
pip install -r requirements-dev.txt
  4. Tests ausführen: 
    pytest

📋 Changelog

Für die vollständige Changelog siehe CHANGELOG.md.

v0.2.0-beta.4 (2025-12-02) - Bug Fixes & Improvements

v0.2.0 (2025-11-20) - Semantic Versioning Adoption

v0.1.0 (2024-XX-XX) - Initial Release

**Made with ❤️ for the Home Assistant & Pool Community** *Transform your pool into a smart pool - because life's too short for manual pool maintenance!* 🏊‍♀️🤖 [![GitHub][github-shield]][github] [![Discord][discord-shield]][discord] [![Email](https://img.shields.io/badge/email-git%40xerolux.de-blue?style=for-the-badge&logo=gmail)](mailto:git@xerolux.de) [![Tesla](https://img.shields.io/badge/Tesla-Referral-red?style=for-the-badge&logo=tesla)](https://ts.la/sebastian564489)
This site is open source. Improve this page.