2024.10.4
Home ▸ Integrations ▸

WaterFurnace

The WaterFurnace integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] communicates with the WaterFurnace Symphony website’s WebSocket to show you many of the sensors in your system. While not an official API, this is the same backend the Symphony website is based on, and should be reasonably stable.

The sensors provided include:

  • Thermostat Setpoint
  • Thermostat Current Temp
  • Leaving Air Temp
  • Entering Water Loop Temp
  • Current Humidity
  • Current Humidity Setpoint
  • Total system power (in Watts)
  • Furnace Mode
  • Compressor Power
  • Fan Power
  • Aux Power
  • Loop Pump Power
  • Compressor Speed
  • Fan Speed

Configuration

To use Waterfurnace in your installation, add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

# Example configuration.yaml entry
waterfurnace:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD

Configuration Variables

Looking for your configuration file?
username string Required

The email address for your Symphony WaterFurnace account

password string Required

The password for your Symphony WaterFurnace account

Limitations

The WebSocket interface used by this module requires active polling to prevent the server side shuts down the connection. By default, this polling is happening every 10 seconds. All sensors are updated during every polling cycle.

While this is communicating with a thermostat, geothermal systems operate most efficiently when setbacks are not used, and the home is kept at a constant temperature. It remains useful to collect the data from the system to understand its performance, but a full climate interface won’t be implemented.

Related topics