This repository continues the original socbrian/AP_PoolSync integration and is now the active home for development, bug fixes, and feature work.
Since the fork, the integration has been substantially reworked and modernized toward Home Assistant Silver/Gold quality-scale standards.
Special thanks to @socbrian for the reverse-engineering work that made the original linking procedure possible.
This custom integration monitors and controls AutoPilot PoolSync equipment over your local network with no cloud dependency. It supports the PoolSync controller, ChlorSync chlorinator reporting and control, and supported heat-pump monitoring and control surfaces exposed by the device.
- Guides you through local push-button linking to obtain the device access password.
- Polls PoolSync locally for status, configuration, and diagnostics.
- Creates devices and entities for the controller and any detected attached equipment.
- Supports chlorinator output control.
- Supports heat-pump climate control, target temperature changes, and mode selection when a compatible heat pump is present.
- Exposes optional diagnostic entities such as firmware, board temperatures, and Wi-Fi signal details.
Before setup, make sure:
- Your PoolSync device is powered on and connected to your local Wi-Fi network.
- Home Assistant can reach the device on your local network.
- You know the device IP address.
- You are running Home Assistant 2023.1.0 or newer.
- HACS is installed if you plan to install this as a custom repository.
- Home Assistant Core 2023.1.0 or newer
- Local network access to the PoolSync device is required
- Confirmed scope today: PoolSync controller data, ChlorSync data and output control, and supported heat-pump data and control surfaces exposed through PoolSync
- If you validate additional equipment or firmware combinations, please share results in the community thread or GitHub Discussions so the support list can be tightened over time
- Open HACS in Home Assistant.
- Go to Integrations.
- Open the menu in the top-right corner and select Custom repositories.
- Add
https://github.com/ccpk1/AP_PoolSyncas an Integration repository. - Search for PoolSync Custom in HACS and install it.
- Restart Home Assistant.
Manual code edits should not be required for normal installation.
- In Home Assistant, go to Settings > Devices & Services.
- Select Add Integration.
- Search for PoolSync Custom.
- Enter the local IP address of the PoolSync device.
- When prompted, press the Auth or Service button on the physical PoolSync device.
Prompt:
|
Auth Button:
|
- Wait for Home Assistant to complete local linking and create the config entry.
If linking fails, the flow offers a retry path. If repeated attempts fail, restart the PoolSync device and try again.
Retry:
|
This integration is intended for:
- AutoPilot PoolSync controllers
- ChlorSync chlorinator data and output control exposed through PoolSync
- Supported heat-pump data and control surfaces exposed through PoolSync
Support depends on what your specific firmware and attached equipment report through the local API.
The exact entity set depends on the device data exposed by your PoolSync installation, but the integration typically creates the following:
- Wi-Fi signal strength and Wi-Fi signal status
- Controller board temperature
- Controller date and time
- Firmware and hardware version
- Water temperature
- Salt level
- Flow rate
- Output setting
- Boost time remaining
- Optional diagnostic sensors such as cell current, voltage, serial number, and firmware details
- A number entity to set chlorinator output percentage
- A climate entity for the water thermostat
- Active target temperature control
- Mode selection for supported operating modes
- Water and air temperature sensors
- Pool and spa setpoint sensors when reported by the device
- Binary sensors for heat-pump flow, fan, compressor, online state, and fault state
Some diagnostic entities are disabled by default to keep the default dashboard cleaner.
After setup, you can adjust the polling interval:
- Go to Settings > Devices & Services.
- Open the PoolSync integration card.
- Select Configure.
- Set Update interval in seconds and submit.
The minimum supported interval is 10 seconds.
To remove the integration:
- Go to Settings > Devices & Services.
- Open the PoolSync integration.
- Select the menu for the config entry.
- Choose Delete.
This removes the Home Assistant config entry and its entities. It does not change configuration on the physical PoolSync device.
- Setup is currently manual and IP-based. The integration does not support automatic network discovery.
- Linking requires physical access to the PoolSync device to press the Auth or Service button.
- Entity availability depends on what your controller and attached equipment actually report.
- Dynamic device add and remove handling is still limited. A restart or reload may be needed after some equipment changes.
- Confirm the PoolSync device and Home Assistant are on the same local network and that the configured IP address is correct.
- If the device does not finish linking, restart the PoolSync device and retry the setup flow.
- If the integration becomes unavailable or reports connection reset errors, check Wi-Fi quality at the controller. Weak signal is a common cause of intermittent failures.
- Download diagnostics from the device page in Home Assistant when reporting issues.
- Check Home Assistant logs for
custom_components.poolsync_customentries if setup or updates fail.
If this integration is useful to you, the two best ways to support it are simple:
- Star the repository so other Home Assistant users can find it more easily
- If you want to help support ongoing development and testing time, consider GitHub Sponsors or Buy Me a Coffee
- Community thread: PoolSync Pool / Heat Pump Integration
- GitHub issues: ccpk1/AP_PoolSync/issues
- GitHub discussions: ccpk1/AP_PoolSync/discussions
When reporting a problem, include diagnostics, relevant logs, the PoolSync firmware or hardware details if known, and what equipment is attached.
Bug reports, testing feedback, and pull requests are welcome. When reporting problems, include the device model if known, what equipment is attached, and diagnostics or log details when possible.
🤖 AI-Assisted Development: In today’s age, leveraging AI is one of the few ways a maintainer can realistically build, thoroughly test, and actively support a truly complex, high-quality open-source project. But to be clear, this integration isn't just blindly "vibe coded." While AI acts as a significant force multiplier for the workflow, human oversight dictates the architecture. Every commit is strictly audited, backed by extensive tests, and measured against rigorous Home Assistant development standards to ensure long-term stability.
This integration is not affiliated with or endorsed by AutoPilot Pool Systems. Use it at your own risk.