Skip to content

marcoboers/home-assistant-quatt

Repository files navigation

Quatt integration for Home Assistant

GitHub Release GitHub Activity License

hacs Project Maintenance BuyMeCoffee

Unofficial integration for Quatt Heat Pump.

Installation

Install with HACS (recommended)

Do you have HACS installed?

  1. Click here or add repository manually a. Select Integrations, then select the 3-dots in the upper-right corner, then select Custom Repositories. a. 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 all the files from the custom_components/quatt/ directory (folder) in this repository.
  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. (optional) select a power sensor in order to get a COP sensor (currently only for heatpump 1)
  8. Click "Save"
  9. 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

Sensors

All sensors from the the local API feed are available. In addition to those, there are the following computed sensors (currently only for heatpump 1):

  • Textual representation of the QC supervisoryControlMode (status)
  • waterDelta: difference between inlet and outlet water temperature
  • heatPower: power of heat produced
  • COP: realtime COP (requires power sensor)

Sensors for heatpump 2 are disabled by default. These can be enabled manually: Go to Quatt -> device -> "+6 entities not shown" -> click on a disabled sensor -> click gear -> click enable.

Contributions are welcome!

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