Intergas Local

A Home Assistant custom integration for the Intergas Xtend / Xtreme local API (Xtore not supported).

This integration is based on the same local-access approach described in HA_connection_Xtend: the Home Assistant instance connects directly to the Xtend unit over its local HTTP API. It exposes several sensors/diagnostics regarding the Xtend and Xtreme.

Why this integration exists

The HA_connection_Xtend works with yaml files for RESTful sensors and sensor-templates and had no specific devices available in Home Asssistant showing all the sensors and diagnostics. So I made an HACS integration doing practically the same but less complicated.

Important: dedicated Wi‑Fi requirement

For Xtend installations, Home Assistant needs to be connected to the local access point of the Xtend using a dedicated Wi‑Fi adapter.

This is important because the Xtend API is typically reachable only through a dedicated local network, not through the normal home network.

This is the same principle used in the original HA_connection_Xtend setup.

Installation

HACS (recommended)

Direct repository URL for HACS custom repository:

https://github.com/webpatrick/intergas_local

1. Open Home Assistant
2. Go to HACS
3. Open Integrations
4. Click the menu button and choose Custom repositories
5. Add this repository URL
6. Search for Intergas Local
7. Install the integration
8. Restart Home Assistant

Manual installation

1. Download or clone this repository
2. Copy the custom_components/intergas_local directory into your Home Assistant custom_components folder
3. Restart Home Assistant

Configuration

1. Go to Settings > Devices & Services > Add Integration
2. Search for Intergas Local
3. Enter the Xtend host or local IP address
4. Optionally adjust the polling interval
5. Save the configuration

The integration will build the local API URL automatically, for example:

http://<xtend_ip>/api/stats/values?fields=...

Network setup example

A common setup is:

• Home Assistant main LAN: normal home Wi‑Fi or Ethernet
• HA dedicated Wi‑Fi adapter: connected to the Xtend access point or local Xtend subnet
• Xtend controller: reachable at a local IP such as 10.20.30.1

This allows Home Assistant to talk to the unit locally without exposing the system to the internet or needing the cloud.

Sensor reference

For a complete overview of the available sensors and what they represent, see SENSOR_REFERENCE.md.

Troubleshooting

Integration does not load

• verify the Xtend host IP is correct
• check whether Home Assistant can reach the unit on the local network
• confirm the Xtend controller is online and connected to the local Wi‑Fi or AP
• check Home Assistant logs for HTTP or parsing errors

No data appears

• confirm the API endpoint is reachable from HA
• verify the device is on the correct dedicated Wi‑Fi network
• check whether the heat pump is actually active or reporting values
• try increasing the polling interval if the controller is slow to respond

Separate Wi‑Fi not available

This integration expects direct local connectivity. If HA cannot reach the controller on a separate local network, the integration will not be able to poll the statistics reliably.

Notes

This project is a local, derived implementation based on the original Xtend / Intergas work by DSchoutsen and related community efforts. It is tailored for the common Xtend/Xtreme local API access pattern and the dedicated Wi‑Fi setup required by these systems.

License

This project is licensed under the MIT License. See LICENSE.