[Integration] Pentair IntelliCenter - Local Push Pool Control

Share your Projects! Custom Integrations
1

Pentair IntelliCenter Integration - Local Push Pool Control (v3.5.6)

Repository: GitHub - joyfulhouse/intellicenter: Home Assistant Integration for Pentair Intellicenter

Hi everyone!

I’m excited to share a significantly updated version of the Pentair IntelliCenter integration.

The Story

The original IntelliCenter integration by @jvaillant was a fantastic starting point, and @dwradcliffe made valuable improvements. However, the codebase needed modernization - deprecated async patterns, connection stability issues, and limited device support were becoming pain points.

We invested in an Anthropic Claude Code subscription specifically to tackle this modernization effort. Working collaboratively with Claude, we completely overhauled the integration - not just updating syntax, but fundamentally rearchitecting how the integration communicates with the IntelliCenter. The AI assistance made it possible to implement sophisticated protocol handling, comprehensive test coverage (179 tests), and achieve Platinum quality tier - the highest level in Home Assistant’s quality scale.

What’s New?

Intelligent Request Queuing & Coalescing

The IntelliCenter hardware struggles with concurrent requests - it can get overwhelmed and drop connections. We solved this with a sophisticated queuing system:

  • Single-request flow control: Only one request on the wire at a time, with atomic locking and deadlock detection
  • Request coalescing: Multiple rapid commands are intelligently batched
  • Attribute batching: Queries batched to max 50 attributes to prevent protocol choking
  • orjson serialization: 2-3x faster JSON parsing than standard library

Optimistic Updates & Responsive UI

Nobody wants to click a button and wait 500ms+ for feedback. We implemented optimistic state updates throughout:

  • Instant UI feedback: Switches, lights, valves, and other controls update immediately on click
  • Background confirmation: Actual state syncs when the IntelliCenter responds
  • Automatic rollback: If the command fails, state reverts automatically
  • Push-based real-time updates: NotifyList messages provide instant state changes without polling
    The result? The UI feels snappy and responsive - lights turn on when you tap them, not a second later.

Modern Async Architecture

  • Fully rewritten using current asyncio patterns (Python 3.13+ compatible)
  • Removed all deprecated async_timeout and legacy function calls
  • Non-blocking operations throughout - no thread pool hacks
  • Clean async/await patterns with proper cancellation handling

Flexible Transport Options

  • TCP connections (default) - direct, low-latency communication on port 6681
  • WebSocket connections - alternative for networks where raw TCP has issues
  • Choose during setup or reconfigure anytime through the UI - no need to remove/re-add

Rock-Solid Connection Handling

Connection stability was one of the biggest pain points. We addressed this comprehensively:

  • Automatic reconnection with exponential backoff (configurable 10-120s initial delay)
  • Circuit breaker pattern - after 5 consecutive failures, backs off to prevent hammering
  • Keepalive monitoring - configurable health checks (30-300s) with automatic disconnect after 3 missed responses
  • Buffer protection - 1MB max buffer prevents memory exhaustion from malformed messages
  • Connection metrics - track response times, reconnect attempts, and health via diagnostics

Comprehensive Device Support

Category Features
Pool/Spa On/off control, temperature monitoring, heater management, max temp setpoints
Lights Full color effects (IntelliBrite, MagicStream, GloBrite, MagicStream Laminar)
Light Shows Coordinated multi-light synchronized effects
Pumps Running status, power (W), speed (RPM), flow (GPM), min/max operational limits
IntelliChem pH/ORP sensors, setpoint control, tank levels, water quality index
Water Chemistry Alkalinity, Calcium Hardness, Cyanuric Acid (editable configuration)
IntelliChlor Salt level monitoring, primary/secondary output percentage control
Heaters Running status, heat mode selection per body
Valves Valve actuator control with optimistic updates
Covers Pool cover open/close/stop control
System Vacation mode, freeze protection, air/solar/water temperatures
Schedules Active status monitoring

IntelliChem & IntelliChlor Deep Dive

Chemistry support has been significantly expanded with proper entity categorization:

Sensors (read-only measurements):

  • pH value, ORP value (mV), water quality index
  • pH tank level, ORP tank level
  • Salt level (ppm)

Configuration entities (user-adjustable setpoints):

  • pH setpoint (7.0-7.6 range, 0.1 step)
  • ORP setpoint (400-800 mV range, 10 step)
  • IntelliChlor output % (primary and secondary bodies)
  • Alkalinity, Calcium Hardness, Cyanuric Acid inputs
  • Body max temperature limits

All setpoints use convenience methods with validation - the integration won’t let you set invalid values.

Clean Architecture

The protocol layer was extracted to a standalone, reusable library:

  • pyintellicenter on PyPI
  • Clean separation: protocol handling vs. Home Assistant integration
  • Independently testable and versionable
  • Additional functions and capabilities based on reverse engineering the Android APK
  • Convenience methods abstract away protocol complexity (set_ph_setpoint(), set_valve_state(), etc.)

Quality & Reliability

  • Platinum quality tier - highest level in Home Assistant’s quality scale
  • 179 automated tests - protocol, controller, model, all 7 platforms
  • Full type annotations - mypy strict mode, zero type errors
  • 12 language translations
  • Zeroconf auto-discovery
  • Diagnostics support - export connection metrics and state for troubleshooting

Installation

HACS (Recommended)

  1. HACS → Integrations → Custom repositories
  2. Add: https://github.com/joyfulhouse/intellicenter
  3. Install “Pentair IntelliCenter”
  4. Restart Home Assistant
    Your IntelliCenter should be auto-discovered. If not, add it manually with the IP address.

Migration from Original Integration

If you’re using jlvaillant’s or dwradcliffe’s version:

  1. Remove the existing integration from Settings → Devices & Services
  2. Delete the old custom_components/intellicenter folder
  3. Install via HACS (above)
  4. Restart Home Assistant
  5. Re-add the integration (should auto-discover)
    Your automations should continue working - entity IDs follow the same naming pattern.

Troubleshooting

Connection issues?

  • Try switching transport type (TCP ↔ WebSocket) via Reconfigure
  • Check that port 6681 is accessible: telnet <ip> 6681
  • Adjust keepalive/reconnect settings in Configure options

Enable debug logging:

logger:
logs:
custom_components.intellicenter: debug
pyintellicenter: debug

Links

Credits

This integration wouldn’t exist without:

Happy to answer any questions! If you run into issues, please open a GitHub issue with debug logs and your IntelliCenter model (i5P, i7P, i9P, i10P).

1 Like