A Home Assistant custom integration for the Polyaire ZoneTouch 3 air conditioning zone controller. Communicates directly with the ZoneTouch 3 over your local network via TCP — no cloud or bridge required.
- Zone damper control — Each zone is exposed as a slider (0–100%) to control airflow
- Temperature sensor — Reports the controller's built-in temperature reading
- Zone names — Automatically imports zone names configured on the ZoneTouch 3 touchscreen
- Device info — Reports serial number, firmware version, and hardware version in the HA device registry
- Auto-discovery of zones — Zones are detected automatically from the device; no manual configuration needed
- Local polling — Periodically queries the device over TCP (default every 30 seconds)
- Open HACS in Home Assistant
- Go to Integrations > click the three-dot menu > Custom repositories
- Enter
https://github.com/CRCinAU/zonetouch3as the repository URL and select Integration as the category - Click Add
- Search for "Polyaire ZoneTouch 3" in HACS and click Download
- Restart Home Assistant
- Copy the
custom_components/zonetouch3directory into your Home Assistantconfig/custom_components/directory - Restart Home Assistant
- Go to Settings > Devices & Services > Add Integration
- Search for "Polyaire ZoneTouch 3"
- Enter the following:
- IP Address — The IP address of your ZoneTouch 3 controller
- Port — TCP port (default:
7030) - Poll interval — How often to query the device in seconds (default:
30, range: 5–300)
The integration will test the connection before saving. If it fails, verify the IP address and that port 7030 is reachable from your Home Assistant host.
| Entity type | Description | Example entity ID |
|---|---|---|
| Number (slider) | One per zone, 0–100% in 5% steps. Setting to 0% turns the zone off. | number.living_room |
| Sensor | Controller temperature reading in °C | sensor.temperature |
The device card in Home Assistant will display:
- Device name — Derived from the owner name configured on the controller
- Serial number — The controller's device ID
- Firmware version — Current firmware installed on the controller
- Hardware version — Hardware revision of the controller
The ZoneTouch 3 must be on the same network (or a routable network) as your Home Assistant instance. The integration communicates over TCP port 7030 by default. Ensure this port is not blocked by any firewall rules.
It is recommended to assign a static IP address or DHCP reservation to your ZoneTouch 3 controller to prevent the IP from changing.
- "Unable to connect" during setup — Verify the IP address and port. Try
telnet <ip> 7030from the HA host to confirm connectivity. - Zones not appearing — The integration discovers zones from the device response. If the device returns no zones, check that the ZoneTouch 3 is fully booted and has zones configured.
- Stale values — Reduce the poll interval in the integration config if you need faster updates.
This integration communicates with the ZoneTouch 3 using its native binary protocol over TCP. It sends a FullState request and parses the response to extract system info, zone names, zone statuses, and temperature data. Zone control commands use the standard group control subcommand format with CRC16-Modbus checksums.
MIT