Pool intelligent steuern: Violet Pool Controller Integration für Home Assistant

Mach aus deinem Pool einen Smart Pool! Die Violet Pool Controller Integration für Home Assistant verbindet die VIOLET-Poolsteuerung von PoolDigital vollständig und 100 % lokal mit deinem Smart Home – ohne Cloud, ohne Abo, ohne Hersteller-Gateway. Was als kleines Auslesen von Messwerten begann, ist heute eine ausgewachsene Integration für die komplette Pool-Automatisierung.

Violet Pool Controller Basismodul von PoolDigital
Der VIOLET Pool Controller von PoolDigital – entwickelt in Deutschland, mit offener JSON-API

Was die Integration kann

Der Violet Pool Controller ist ein All-in-One-System für Filtration, Heizung, Chemie und Licht. Die Integration hebt davon nichts auf – sie bringt alles nach Home Assistant:

Bereich Funktionen
Heizung & Solar Thermostat- und Zeitplansteuerung für Heizstab und Solar
Chemiedosierung Automatische pH- und Chlorregelung mit Sicherheitsgrenzen, inkl. Standalone-Dosierung
Filter & Pumpe 3-Stufen-Pumpe, automatische Rückspülung
Poolabdeckung Wetterabhängige Abdeckungs-Automatik
Licht 8 steuerbare Szenen, RGB-Beleuchtung, DMX
Monitoring pH, ORP, Temperaturen, Druck, Durchfluss, Laufzeiten – rund 400 Werte
Energie PV-Überschuss-Modus: Solarenergie gezielt zum Poolheizen nutzen
Mehrere Pools Multi-Controller-Support: mehrere Pools in einer Home-Assistant-Instanz

Installation in drei Schritten (HACS)

1. Integration per HACS hinzufügen:

HACS → Integrations → ⋮ → Custom Repositories
URL: https://github.com/xerolux/violet-hass   |   Category: Integration
→ "Violet Pool Controller" herunterladen → Home Assistant neu starten

2. Integration einrichten:

Einstellungen → Geräte & Dienste → Integration hinzufügen → "Violet Pool Controller"
Host-IP eintragen (Port anpassen, falls nicht 80) → Funktionen auswählen → Fertig

3. Fertig! 🎉 Dein Pool ist jetzt smart – mit Sensoren, Schaltern, Climate-Entitäten und fertigen Lovelace-Dashboards aus dem Dashboard-Verzeichnis des Projekts. Für das richtige Klick-Erlebnis auf dem Tablet an der Poolwand empfehle ich zusätzlich die Violet Pool Card.

Auch ohne Home Assistant: die Python-API

Der HTTP-Client der Integration ist als eigenes Paket auf PyPI veröffentlicht und funktioniert auch standalone – für eigene Skripte, Auswertungen oder ganz andere Steuerungen:

pip install violet-poolController-api
import aiohttp
from violet_poolcontroller_api.api import VioletPoolAPI

async with aiohttp.ClientSession() as session:
    api = VioletPoolAPI(host="192.168.1.50", session=session,
                        username="user", password="secret")
    readings = await api.get_readings()      # alle ~400 Werte
    print(readings["pH_value"], readings["orp_value"])
    await api.manual_dosing("Chlor", 60)     # 60s manuelle Dosierung

Der Client bringt Produktions-Features mit, die man sonst selbst bauen müsste: Token-Bucket-Rate-Limiting, Circuit-Breaker, Retry mit Backoff, Eingabe-Sanitisierung und SSL/TLS-Verifikation.

Sicherheit ernst genommen

Die Integration steuert physische Hardware, die Wasserchemie und Elektrik regelt. Deshalb: komplette Kommunikation lokal, SSL/TLS-Unterstützung, Rate-Limiting und saubere Eingabeprüfung – und eine ausführliche Security-Dokumentation. Die Wasserwerte solltest du trotzdem unabhängig im Auge behalten; die Integration ersetzt keine Messung vor Ort.

Voraussetzungen

  • Home Assistant 2026.8.0+ (getestet gegen 2026.8 und 2026.9)
  • HACS
  • Violet Pool Controller im lokalen Netzwerk erreichbar
  • Für das standalone Python-Paket: Python 3.12+

Dokumentation

Die vollständige Doku – Installation, Konfiguration, alle Entitäten, Services, Automationen, Fehlercodes, FAQ – findest du im Projekt-Wiki. Der Community stehen außerdem Discord und das PoolDigital-Forum offen.

Hinweis: Inoffizielles Community-Projekt, steht in keiner Verbindung zu PoolDigital GmbH & Co. KG.

Fazit

Wasserwerte, Pumpe, Dosierung, Heizung und Licht des Pools komplett lokal in Home Assistant – das war früher teure Herstellersoftware mit Cloud-Zwang. Die Violet-Integration macht daraus ein offenes System mit allen Freiheiten des Smart Homes. Wer einen Violet Pool Controller besitzt, kommt an dieser Integration nicht vorbei.

Projekt unterstützen: ⭐ auf GitHub vergeben, Bugs melden, anderen Poolbesitzern im Forum helfen – oder die Entwicklung über Ko-fi / Buy Me a Coffee unterstützen.

X

Basti

Entwickler und Smart-Home-Enthusiast aus Deutschland. Ich entwickle Open-Source-Integrationen für Home Assistant (IDM Wärmepumpe, Violet Pool Controller), Modbus-Tools (ModBridge) und betreibe verschiedene Server-Dienste (Matrix, Seafile, SOGo).

GitHub →

Schreibe einen Kommentar