NGBS iCON — Home Assistant integration

A read-only Home Assistant integration for NGBS iCON underfloor heating/cooling controllers. It exposes each room's temperature, humidity, dew point and target, plus controller-level values (water temperature, outside temperature, mixing valve, mode), as sensors and binary sensors.

Installation (HACS custom repository)

1. In HACS → ⋮ → Custom repositories, add https://github.com/adborbas/homeassistant-ngbs-icon as an Integration.
2. Install NGBS iCON, then restart Home Assistant.

Setup

Home Assistant may auto-discover the controller on your network (via DHCP) and offer to set it up. Otherwise add it manually:

Settings → Devices & Services → Add Integration → NGBS iCON, then enter the controller's IP address — the SYSID is discovered automatically.

After it's added, Home Assistant's built-in Name and assign step lets you rename each room and assign it to an area. Room names default to those configured in NGBS, and you can rename a device or change its area at any time from the device's page.

Configuration

Use the integration's Configure button to change the polling interval (default 5 minutes, range 30–3600 seconds). Underfloor heating changes slowly, so a longer interval is usually plenty.

What you get

Per room (one device each): temperature, humidity, dew point and target temperature, plus the four heat/cool × normal/eco setpoints as diagnostic sensors; binary sensors for valve/demand, dew protection, frost warning, eco, parental lock and connection.

Controller device: water temperature, outside temperature (unavailable when no sensor is installed), mixing valve %, hysteresis, firmware and uptime; binary sensors for cooling/heating mode and eco.

The temperature, humidity and dew-point sensors carry long-term statistics, so they appear in history and the statistics graphs.

Requirements

• Home Assistant — developed and tested against 2026.7; a recent release is recommended.
• The controller must be reachable on the local network over TCP port 7992 (the NGBS service protocol).

Disclaimer

Not affiliated with NGBS. Provided as-is under the MIT License.

Credits

This integration is an independent Python port. The NGBS iCON local service protocol and data model it relies on were reverse-engineered by the molnarg/ngbs-icon project (MIT). All protocol credit belongs to that project — this integration reimplements the protocol it documents for use inside Home Assistant (which runs Python, so the original TypeScript library cannot be used directly). Huge thanks to that project for the hard work of decoding the protocol. See NOTICE.