English | Deutsch

The complete documentation for the Violet Pool Controller add-on. From installation to uninstallation – with all features, states, services, and automations.

• Comprehensive disclaimer: Liability disclaimer for safety and usage
• German & English: Complete safety notices in both languages
• Setup integration: Mandatory liability disclaimer in the configuration process
• 📖 Configuration Guide (DE)
• 📖 Configuration Guide (EN)

• 68+ icons optimized: All entities now with consistent, professional MDI icons
• Better recognition: Special icons instead of generic symbols
• Examples:
  • pH value: mdi:ph instead of mdi:flask
  • Pool water: mdi:pool
  • Overflow tank: mdi:water-sync
  • Heat exchanger: mdi:radiator
  • Backwash: mdi:autorenew
  • Flocculant: mdi:water
• 📖 Icon Reference | 📊 All Icons

The Violet Pool Controller Home Assistant Integration connects Home Assistant with the Violet Pool Controller by PoolDigital GmbH & Co. KG. It enables complete local control and monitoring of your pool system – no cloud, no subscription required.

┌─────────────────────────────────────────────────────────┐
│              VIOLET POOL CONTROLLER ADD-ON               │
├──────────────┬──────────────┬──────────────┬────────────┤
│    Pump      │   Heating    │    Solar     │  Dosing    │
│  (3 stages)  │ (Thermostat) │ (PV Surplus) │ pH/Cl/ORP  │
├──────────────┼──────────────┼──────────────┼────────────┤
│   Lighting   │    Cover     │  Digital I/O │ Diagnostics│
│ (DMX 1-8)    │   (Cover)    │  (DI1-DI8)   │  Download  │
├──────────────┴──────────────┴──────────────┴────────────┤
│  100% local · Multi-Controller · SSL/TLS · Rate Limiting │
└─────────────────────────────────────────────────────────┘

1. Installation & Setup – Install via HACS or manually
2. Configuration – Set up the integration
3. Entities – All sensors, switches, climate
4. Understanding Sensors – What data do I get?
5. Device States – What do the 7 states mean?

1. Services Reference – All available services
2. Automation Examples – Copy-paste YAML examples
3. Control Pump – Speed control
4. Dosing – Intelligent chemical dosing

1. Troubleshooting – Common problems & solutions
2. Download Diagnostics – JSON export for bug reports
3. Advanced Logging – Diagnostic tools & log export
4. Error Codes – Controller error codes explained
5. FAQ – 50+ common questions
6. GitHub Issues – Bug reports

→ Multi-Controller Guide – Manage multiple pools

→ Contributing Guide – Pull requests, tests, style guide

Home Assistant
    │
    ├── VioletPoolDataUpdateCoordinator (polling, 10s default)
    │       │
    │       ├── VioletPoolAPI (aiohttp, rate-limited, retry-logic, SSL)
    │       │       │
    │       │       └── Violet Pool Controller (HTTP/HTTPS)
    │       │               GET /getReadings?ALL
    │       │               GET /setFunctionManually?{payload}
    │       │               POST /setConfig
    │       │
    │       └── Entities (sensors, switches, climate, cover, number)
    │
    ├── Services (control_pump, smart_dosing, manage_pv_surplus, ...)
    │
    └── Diagnostics (download diagnostics data via HA UI)

• Rate Limiting: Token bucket algorithm prevents controller overload
• Input Sanitization: Protection against XSS, SQL injection, command injection
• SSL/TLS: Certificate verification enabled by default
• Auto-Recovery: Exponential backoff (10s → 300s), max 10 attempts
• Thread Safety: Two documented locks without nesting

This integration is fully compatible with Home Assistant 2026.x:

⚠️ IMPORTANT: This integration controls real pool equipment!

• ✅ Read the liability disclaimer in the setup process carefully
• ✅ Make sure you understand all safety mechanisms
• ✅ Always keep manual emergency shutoffs available
• ✅ Personally monitor your system regularly
• ✅ Observe the safety data sheets for all chemicals used
• ✅ Follow your pool manufacturer's documentation

📖 Details: Safety & Liability

This wiki documents version 1.0.5 of the Violet Pool Controller add-on. Last updated: 2026-04-01