Quatt integration for Home Assistant

Unofficial integration for Quatt Heat Pump.

Installation

Install with HACS (recommended)

Do you have HACS installed?

1. Click here or add repository manually
   • Select Integrations, then select the 3-dots in the upper-right corner, then select Custom Repositories.
   • Put the Reposity URL in the Repository field, then select Integration in the Category dropdown list and click Add.
2. Search integrations for Quatt
3. Click Install
4. Restart Home Assistant

Install manually

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called quatt.
4. Download in the Releases section the quatt.zip file for the version of the integration you want to install and extract the files. Alternatively, download all the files from the custom_components/quatt/ directory (folder) in this repository. Note that the version number will not be updated if you choose the latter.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant

Configuration

Manual

1. In Home Assistant click on Settings
2. Click on Devices & services
3. Click on Integrations
4. Click on + Add integration
5. Search for and select Quatt
6. Enter the ip address of your Quatt CIC (for instance: 192.168.0.100 without http:// or port number)
7. Click Submit
8. Enjoy

Auto-discovery

The Quatt integration relies on DHCP requests made by the Commander In Chief (CIC) for autodiscovery. To force a DHCP request, turn off the CIC and wait 10 seconds and turn it back on again.

1. In Home Assistant click on Settings
2. Click on Devices & services
3. In case the Quatt has been auto-discovered, the discovered CIC is shown at the top of the screen
4. Click on Configure
5. Click on Submit to confirm to automatically add the integration to Home Assistant
6. Enjoy

Remote Mobile API (Optional)

This integration supports the Quatt Remote Mobile API as an optional addition to the local CIC JSON API. The remote API provides access to additional sensors and controls beyond what's available through the local API.

Special thanks to @WoutervanderLoopNL for reverse engineering the official Quatt mobile app, which made this remote API support possible!

Key Features

• Additional sensors: Access to sensors not available via the local API (see list below)
• Sound level controls: Programmable day and night maximum sound levels (normal, library, silent)
• Smart filtering: Only sensors not already available through the local API are added, avoiding duplicates
• Seamless integration: Remote API is configured as an optional toggle on the existing CIC device

Additional Sensors Available via Remote API

The remote API provides access to numerous sensors that complement the local API:

• Connectivity status: WiFi SSID, WiFi/LTE/cable connection status
• Energy pricing: Electricity prices (standard, day, night), gas prices, and night time schedule configuration
• Sound control: Silent mode status, day/night max sound levels, and sound schedule configuration
• Heat battery metrics (All-Electric only): Serial number, status, size, charge percentage
• Enhanced heat pump data: Compressor frequency (actual and demand), minimum/rated/expected power, water pump level, ODU type, on/off status, Modbus slave ID
• Installation details: Installation date, insights start date, Quatt build version, installation name, location (zip code, country), and order number
• Thermostat data: Outside temperature (via remote API)
• Boiler data (Hybrid only): Additional boiler power and temperature sensors

Important Considerations

• Beta status: This feature is currently in beta with no backwards compatibility guarantees between versions
• Optional feature: The integration works fully with only the local API; remote API is optional
• Reverse engineered API: The remote API was obtained through reverse engineering of the official Quatt mobile app. As such, the long-term stability cannot be guaranteed
• Dependent on Quatt: This feature depends on Quatt's remote API infrastructure. Changes to Quatt's authentication system or API may cause the remote API integration to stop working
• No official support: Since this is based on reverse engineering, there is no official support from Quatt for this functionality
• Smart filtering: The integration intelligently filters remote sensors to avoid duplicating data already available from the local API

Enabling Remote API

To enable the remote API for your existing Quatt CIC:

During Initial Setup

1. In Home Assistant, go to Settings → Devices & services → Integrations
2. Click + Add integration and search for Quatt
3. Enter your CIC IP address (e.g., 192.168.0.100)
4. When prompted, enable Remote API by toggling the option
5. Enter your first name and last name
6. Within 60 seconds, press the physical button on your CIC to complete pairing
7. The setup will complete with both local and remote API active

Adding to Existing Integration

1. Go to Settings → Devices & services → Integrations
2. Find your Quatt integration and click Configure
3. Enable the Add Remote API toggle
4. Enter your first name and last name
5. Within 60 seconds, press the physical button on your CIC to complete pairing
6. The integration will reload with remote API sensors and controls available

Once enabled, additional sensors and the sound level controls will appear in your Home Assistant installation.

Sensors

All sensors from the local API feed are available. In addition, the following computed sensors are provided:

CIC

• Supervisory control mode: Textual representation of the QC supervisoryControlMode status.
• COP: Calculated using the produced heat and the power consumed by the external power sensor (configurable).
• Heat power: Heat output of the heat pumps.
• Total power: Combined heat output of both heatpumps (Quatt Duo only).
• Total power input: Combined power input of both heatpumps (Quatt Duo only).
• Total system power: Combined system power
  • All-electric setup: heat charger + heatpump(s)
  • Standard setup: boiler + heatpump(s)
• Total Quatt COP: COP calculated using the produced heat and the power used by the heatpump(s).

Heatpump

• Quatt COP: COP calculated using the produced heat and the power used by the heatpump.
• Water delta: Difference between inlet and outlet water temperatures.

Boiler

• Heat power: Heat output of the boiler.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines