- EPH Controls Ember Thermostat
+ Climate
- The `ephember` climate platform lets you control [EPH Controls](http://emberapp.ephcontrols.com/) thermostats. The module only works if you have a WiFi gateway to control your EPH system and an account on the ember app.
-To set it up, add the following information to your `configuration.yaml` file:
-```yaml
-climate:
- - platform: ephember
- username: YOUR_EMAIL
- password: YOUR_PASSWORD
-```
-A single interface can handle up to 32 connected devices.
-Configuration variables:
-- **username** (*Required*): The email address you used to sign up to the ember app
-- **password** (*Required*): The password you used to sign up to the ember app
+ The climate
component is built for the controlling and monitoring of HVAC (heating, ventilating, and air conditioning) and thermostat devices.
+To enable this component, pick one of the platforms, and add it to your configuration.yaml
:
+# Example configuration.yaml entry
+climate:
+ platform: demo
+
+
+ Services
+ Climate control services
+Available services: climate.set_aux_heat
, climate.set_away_mode
, climate.set_temperature
, climate.set_humidity
, climate.set_fan_mode
, climate.set_operation_mode
, climate.set_swing_mode
, climate.set_hold_mode
+
+Not all climate services may be available for your platform. Be sure to check the available services Home Assistant has enabled by checking
Services.
+
+ Service climate.set_aux_heat
+Turn auxiliary heater on/off for climate device
+
+
+
+ Service data attribute |
+ Optional |
+ Description |
+
+
+
+
+ entity_id |
+ yes |
+ String or list of strings that point at entity_id ’s of climate devices to control. Else targets all. |
+
+
+ aux_heat |
+ no |
+ New value of auxiliary heater. |
+
+
+
+ Automation example
+automation:
+ trigger:
+ platform: time
+ at: "07:15:00"
+ action:
+ - service: climate.set_aux_heat
+ data:
+ entity_id: climate.kitchen
+ aux_heat: true
+
+
+ Service climate.set_away_mode
+Set away mode for climate device. The away mode changes the target temperature permanently to a temperature
+reflecting a situation where the climate device is set to save energy. This may be used to emulate a
+“vacation mode”, for example.
+
+
+
+ Service data attribute |
+ Optional |
+ Description |
+
+
+
+
+ entity_id |
+ yes |
+ String or list of strings that point at entity_id ’s of climate devices to control. Else targets all. |
+
+
+ away_mode |
+ no |
+ New value of away mode. |
+
+
+
+ Automation example
+automation:
+ trigger:
+ platform: time
+ at: "07:15:00"
+ action:
+ - service: climate.set_away_mode
+ data:
+ entity_id: climate.kitchen
+ away_mode: 'on'
+
+
+ Service climate.set_hold_mode
+Set hold mode for climate device. The hold mode changes the target temperature of the client device temporarily to
+a different temperature. Typical hold modes provided by a climate device are “away” or “home”, where the hold temperature
+is chosen depending on a predefined climate, or “temperature” hold, where a particular temperature is selected as the
+temporary target temperature. The particular modes available depend on the climate device.
+
+
+
+ Service data attribute |
+ Optional |
+ Description |
+
+
+
+
+ entity_id |
+ yes |
+ String or list of strings that point at entity_id ’s of climate devices to control. Else targets all. |
+
+
+ hold_mode |
+ no |
+ New value of hold mode. |
+
+
+
+ Automation example
+automation:
+ trigger:
+ platform: time
+ at: "07:15:00"
+ action:
+ - service: climate.set_hold_mode
+ data:
+ entity_id: climate.kitchen
+ hold_mode: 'away'
+
+
+ Service climate.set_temperature
+Set target temperature of climate device
+
+
+
+ Service data attribute |
+ Optional |
+ Description |
+
+
+
+
+ entity_id |
+ yes |
+ String or list of strings that point at entity_id ’s of climate devices to control. Else targets all. |
+
+
+ temperature |
+ no |
+ New target temperature for hvac |
+
+
+ target_temp_high |
+ yes |
+ New target high temperature for hvac |
+
+
+ target_temp_low |
+ yes |
+ New target low temperature for hvac |
+
+
+ operation_mode |
+ yes |
+ Operation mode to set temperature to. This defaults to current_operation mode if not set, or set incorrectly. |
+
+
+
+ Automation example
+automation:
+ trigger:
+ platform: time
+ at: "07:15:00"
+ action:
+ - service: climate.set_temperature
+ data:
+ entity_id: climate.kitchen
+ temperature: 24
+ operation_mode: Heat
+
+
+ Service climate.set_humidity
+Set target humidity of climate device
+
+
+
+ Service data attribute |
+ Optional |
+ Description |
+
+
+
+
+ entity_id |
+ yes |
+ String or list of strings that point at entity_id ’s of climate devices to control. Else targets all. |
+
+
+ humidity |
+ no |
+ New target humidity for climate device |
+
+
+
+ Automation example
+automation:
+ trigger:
+ platform: time
+ at: "07:15:00"
+ action:
+ - service: climate.set_humidity
+ data:
+ entity_id: climate.kitchen
+ humidity: 60
+
+
+ Service climate.set_fan_mode
+Set fan operation for climate device
+
+
+
+ Service data attribute |
+ Optional |
+ Description |
+
+
+
+
+ entity_id |
+ yes |
+ String or list of strings that point at entity_id ’s of climate devices to control. Else targets all. |
+
+
+ fan_mode |
+ no |
+ New value of fan mode |
+
+
+
+ Automation example
+automation:
+ trigger:
+ platform: time
+ at: "07:15:00"
+ action:
+ - service: climate.set_fan_mode
+ data:
+ entity_id: climate.kitchen
+ fan_mode: 'On Low'
+
+
+ Service climate.set_operation_mode
+Set operation mode for climate device
+
+
+
+ Service data attribute |
+ Optional |
+ Description |
+
+
+
+
+ entity_id |
+ yes |
+ String or list of strings that point at entity_id ’s of climate devices to control. Else targets all. |
+
+
+ operation_mode |
+ no |
+ New value of operation mode |
+
+
+
+ Automation example
+automation:
+ trigger:
+ platform: time
+ at: "07:15:00"
+ action:
+ - service: climate.set_operation_mode
+ data:
+ entity_id: climate.kitchen
+ operation_mode: Heat
+
+
+ Service climate.set_swing_mode
+Set operation mode for climate device
+
+
+
+ Service data attribute |
+ Optional |
+ Description |
+
+
+
+
+ entity_id |
+ yes |
+ String or list of strings that point at entity_id ’s of climate devices to control. Else targets all. |
+
+
+ swing_mode |
+ no |
+ New value of swing mode |
+
+
+
+ Automation example
+automation:
+ trigger:
+ platform: time
+ at: "07:15:00"
+ action:
+ - service: climate.set_swing_mode
+ data:
+ entity_id: climate.kitchen
+ swing_mode: 1
+
+
+ Customization
+The step for the setpoint can be adjusted (default to 0,5 increments) by adding the following line into configuration
+customize:
+ - entity_id
+ target_temp_step: 1
+
+
diff --git a/components/index.html b/components/index.html
index 82e1bfcb58..ba956fd46e 100644
--- a/components/index.html
+++ b/components/index.html
@@ -316,7 +316,7 @@ var allComponents = [
{url:"/components/fan.dyson/", title:"Dyson Purifier Fan", cat:"fan", featured: false, v: "0.47", logo: "dyson.png"},
{url:"/components/sensor.dyson/", title:"Dyson Purifier Sensor", cat:"sensor", featured: false, v: "0.47", logo: "dyson.png"},
{url:"/components/sensor.ebox/", title:"EBox", cat:"sensor", featured: false, v: "0.39", logo: "ebox.png"},
-{url:"/components/climate/", title:"EPH Controls Ember Thermostat", cat:"climate", featured: false, v: "0.55", logo: "ephcontrolsember.png"},
+{url:"/components/climate.ephember/", title:"EPH Controls Ember Thermostat", cat:"climate", featured: false, v: "0.55", logo: "ephcontrolsember.png"},
{url:"/components/climate.eq3btsmart/", title:"EQ3 Bluetooth Smart Thermostats", cat:"climate", featured: false, v: "0.0", logo: "eq3.gif"},
{url:"/components/binary_sensor.ecobee/", title:"Ecobee Binary Sensor", cat:"binary-sensor", featured: false, v: "0.9", logo: "ecobee.png"},
{url:"/components/notify.ecobee/", title:"Ecobee Notify", cat:"notifications", featured: false, v: "0.20", logo: "ecobee.png"},
@@ -1326,7 +1326,7 @@ allComponents.pop(); // remove placeholder element at the end