2025-04-30 21:31:00 +02:00

54 lines
1.7 KiB
Markdown

---
title: EPH Controls
description: Instructions on how to integrate EPH Controls EMBER thermostats within Home Assistant.
ha_category:
- Climate
ha_release: 0.57
ha_iot_class: Local Polling
ha_codeowners:
- '@ttroy50'
- '@roberty99'
ha_domain: ephember
ha_platforms:
- climate
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
ha_quality_scale: legacy
---
The `ephember` {% term integration %} lets you control [EPH Controls](https://emberapp.ephcontrols.com/) thermostats. The module only works if you have a Wi-Fi gateway to control your EPH system and an account on the EMBER app.
To set it up, add the following information to your {% term "`configuration.yaml`" %} file:
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
climate:
- platform: ephember
username: YOUR_EMAIL
password: YOUR_PASSWORD
```
A single interface can handle up to 32 connected devices.
{% configuration %}
username:
description: The email address you used to sign up to the EMBER app.
required: true
type: string
password:
description: The password you used to sign up to the EMBER app.
required: true
type: string
{% endconfiguration %}
The supported operation modes map to the ON/OFF period selection of your timeswitch / EMBER app. These include:
- **Auto** The timeswitch operates 3 on / off periods per day.
- **On** The timeswitch is permanently on.
- **Off** The timeswitch is permanently off.
If **All Day** is selected in the EMBER app it will show as **Auto** in Home Assistant.
To **Boost** your heating, you should use the `climate.set_aux_heater` action on your zone entity. This will then **Boost** that zone for 1 hour.