diff --git a/source/_components/climate.ecobee.markdown b/source/_components/climate.ecobee.markdown new file mode 100644 index 00000000000..5f54c6f9027 --- /dev/null +++ b/source/_components/climate.ecobee.markdown @@ -0,0 +1,15 @@ +--- +layout: page +title: "Ecobee Thermostat" +description: "Instructions how to setup the Ecobee thermostats within Home Assistant." +date: 2016-08-26 18:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: ecobee.png +ha_category: Climate +ha_release: 0.9 +--- + +To get your Ecobee thermostats working with Home Assistant, follow the instructions for the general [Ecobee component](/components/ecobee/). diff --git a/source/_components/climate.eq3btsmart.markdown b/source/_components/climate.eq3btsmart.markdown new file mode 100644 index 00000000000..1d16168cb11 --- /dev/null +++ b/source/_components/climate.eq3btsmart.markdown @@ -0,0 +1,64 @@ +--- +layout: page +title: "EQ3 Bluetooth Smart Thermostats" +description: "Instructions how to integrate EQ3 Bluetooth Smart Thermostats into Home Assistant." +date: 2016-04-18 22:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: eq3.gif +ha_category: Climate +ha_iot_class: "Local Poll" +--- + + +The `eq3btsmart` climate platform allows you to integrate EQ3 Bluetooth Smart Thermostats. + +The only functionality is to set the temperature, there doesn't seem to be any way to query the temperature sensor or battery level ([read more](https://forum.fhem.de/index.php/topic,39308.15.html)). + +Setup is a bit more cumbersome than for most other thermostats. It has to be paired first: + +```bash +bluetoothctl +scan on + +scan off + +pair +trust +disconnect +exit +``` + +Then check with gatttool if the connection works as expected: + +```bash +gatttool -b 00:11:22:33:44:55 -I +[00:11:22:33:44:55][LE]> connect +Attempting to connect to 00:11:22:33:44:55 +Connection successful +[00:11:22:33:44:55][LE]> char-write-req 0x0411 03 +Characteristic value was written successfully +Notification handle = 0x0421 value: 02 01 09 14 04 2d +[00:11:22:33:44:55][LE]> disconnect +[00:11:22:33:44:55][LE]> exit +``` + +Important: For gatttool or homeassistant to work, the thermostat needs to be disconnected from bluetoothd, so I found it best to modify the hass-daemon startscript by adding: + +```bash +/usr/bin/bt-device -d CC-RT-BLE +``` + +to the start function of /etc/init.d/hass-daemon. + + +```yaml +# Example configuration.yaml entry +climate: + platform: eq3btsmart + devices: + room1: + mac: '00:11:22:33:44:55' +``` diff --git a/source/_components/climate.generic_thermostat.markdown b/source/_components/climate.generic_thermostat.markdown new file mode 100644 index 00000000000..88cc8fb180c --- /dev/null +++ b/source/_components/climate.generic_thermostat.markdown @@ -0,0 +1,45 @@ +--- +layout: page +title: "Generic Thermostat" +description: "Turn Home Assistant into a thermostat" +date: 2015-03-23 19:59 +sidebar: true +comments: false +sharing: true +footer: true +logo: heat-control.png +ha_category: Climate +--- + + +The `generic_thermostat` climate platform is a thermostat implemented in Home Assistant. It uses a sensor and a switch connected to a heater under the hood. If the measured temperature is cooler then the target temperature, the heater will be turned on and turned off when required temperature is reached. + +```yaml +# Example configuration.yaml entry +climate: + platform: heat_control + name: Study + heater: switch.study_heater + target_sensor: sensor.study_temperature + min_temp: 15 + max_temp: 21 + target_temp: 15 + min_cycle_duration: + # At least one of these must be specified: + days: 2 + hours: 1 + minutes: 10 + seconds: 5 + milliseconds: 20 +``` + +Configuration variables: + +- **name** (*Required*): Name of thermostat +- **heater** (*Required*: `entity_id` for heater switch, must be a toggle device. +- **target_sensor** (*Required*): `entity_id` for a temperature sensor, target_sensor.state must be temperature. +- **min_temp** (*Optional*): Set minimum set point available (default: 7) +- **max_temp** (*Optional*): Set maximum set point available (default: 35) +- **target_temp** (*Required*): Set intital target temperature. Failure to set this variable will result in target temperature being set to null on startup. +- **ac_mode** (*Optional*): Set the switch specified in the *heater* option to be treated as a cooling device instead of a heating device. +- **min_cycle_duration** (*Optional*): Set a minimum amount of time that the switch specified in the *heater* option must be in it's current state prior to being switched either off or on. diff --git a/source/_components/climate.heatmiser.markdown b/source/_components/climate.heatmiser.markdown new file mode 100644 index 00000000000..b74bb1c92e1 --- /dev/null +++ b/source/_components/climate.heatmiser.markdown @@ -0,0 +1,41 @@ +--- +layout: page +title: "Heatmiser Thermostat" +description: "Instructions how to integrate Heatmiser thermostats within Home Assistant." +date: 2015-12-11 12:35 +sidebar: true +comments: false +sharing: true +footer: true +logo: heatmiser.png +ha_category: Climate +ha_release: "0.10" +--- + + +The `heatmiser` climate platform let you control [Heatmiser DT/DT-E/PRT/PRT-E](http://www.heatmisershop.co.uk/heatmiser-slimline-programmable-room-thermostat/) thermostats from Heatmiser. The module itself is currently setup to work over a RS232 -> RS485 converter, therefore it connects over IP. + +Further work would be required to get this setup to connect over Wifi, but the HeatmiserV3 python module being used is a full implementation of the V3 protocol. If you would like to contribute to making this work over wifi, please contact @andylockran on github. + +To set it up, add the following information to your `configuration.yaml` file: + +```yaml +climate: + platform: heatmiser + ipaddress: YOUR_IPADDRESS + port: YOUR_PORT + tstats: + 1: + id: THERMOSTAT_ID + name: THERMOSTAT_NAME +``` + +A single interface can handle up to 32 connected devices. + +Configuration variables: + +- **ipaddress** (*Required*): The ip address of your interface. +- **port** (*Required*): The port that the interface is listening on. +- **tstats** (*Required*): A list of thermostats activated on the gateway. +- **id** (*Required*): The id of the thermostat as configured on the device itself +- **name** (*Required*): A friendly name for the themostat diff --git a/source/_components/climate.homematic.markdown b/source/_components/climate.homematic.markdown new file mode 100644 index 00000000000..61b3d6bd4af --- /dev/null +++ b/source/_components/climate.homematic.markdown @@ -0,0 +1,19 @@ +--- +layout: page +title: "Homematic Thermostats" +description: "Instructions how to integrate Homematic thermostats within Home Assistant." +date: 2016-06-28 08:30 +sidebar: true +comments: false +sharing: true +footer: true +logo: homematic.png +ha_category: Climate +ha_release: 0.23 +ha_iot_class: "Local Push" +--- + + +The `homematic` cliamte platform lets you control [Homematic](http://www.homematic.com/) thermostats through Home Assistant. + +Devices will be configured automatically. Please refer to the [component](/components/homematic/) configuration on how to setup Homematic. diff --git a/source/_components/climate.honeywell.markdown b/source/_components/climate.honeywell.markdown new file mode 100644 index 00000000000..28b5fd13e34 --- /dev/null +++ b/source/_components/climate.honeywell.markdown @@ -0,0 +1,32 @@ +--- +layout: page +title: "Honeywell Thermostat" +description: "Instructions how to integrate Honeywell thermostats within Home Assistant." +date: 2016-02-07 22:01 +sidebar: true +comments: false +sharing: true +footer: true +logo: honeywell.png +ha_category: Climate +--- + + +The `honeywell` cliamte platform let you control [Honeywell Connected](http://getconnected.honeywell.com/en/) thermostats from Home Assistant. + +To set it up, add the following information to your `configuration.yaml` file: + +```yaml +cliamte: + platform: honeywell + username: YOUR_USERNAME + password: YOUR_PASSWORD + region: REGION +``` + +Configuration variables: + +- **username** (*Required*: The username of an user with access. +- **password** (*Required*): The password for your given admin account. +- **away_temperature** (*optional*): Heating setpoint when away mode is on. If omitted it defaults to 16.0 deg C. +- **region** (*optional*): Region identifier (either 'eu' or 'us'). Defaults to 'eu' if not provided. diff --git a/source/_components/climate.knx.markdown b/source/_components/climate.knx.markdown new file mode 100644 index 00000000000..9f89dcfa73c --- /dev/null +++ b/source/_components/climate.knx.markdown @@ -0,0 +1,35 @@ +--- +layout: page +title: "KNX Thermostat" +description: "Instructions on how to integrate KXN thermostats with Home Assistant." +date: 2016-06-24 12:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: knx.png +ha_category: DIY +ha_release: 0.25 +--- + + +The `knx` climate platform is used as in interface with KNX thermostats. + +KNX thermostats use at least 2 group addresses: one for the current temperature and one for the target temperature (named set-point in KNX terms). + +To use your KNX thermostats in your installation, add the following to your `configuration.yaml` file: + +```yaml +climate: + - platform: knx + name: KNX Thermostat + temperature_address: 0/1/1 + setpoint_address: 0/1/0 +``` + +- **name** (*Optional*): A name for this devices used within Home assistant +- **address** (*Required*): The KNX group address that is used to turn on/off this actuator channel +- **temperature_address** (*Required*): The group address that is used to communicate the current temperature. Data format must be datapoint type 9.001 DPT_Value_Temp (2-Octet float value) (see http://www.knx.org/fileadmin/template/documents/downloads_support_menu/KNX_tutor_seminar_page/Advanced_documentation/05_Interworking_E1209.pdf) +- **setpoint_address** (*Required*): The group address that is used to set/read the target temperature. Data format must be datapoint type 9.001 DPT_Value_Temp (2-Octet float value). Make sure, you set the read-flag for the thermostat to allow Home Assistant to read the target temperature. + +With the current version of the module, no advanced KNX thermostat functionalities (e.g. HVAC mode) are supported. diff --git a/source/_components/climate.markdown b/source/_components/climate.markdown new file mode 100644 index 00000000000..4b2f5396fbf --- /dev/null +++ b/source/_components/climate.markdown @@ -0,0 +1,22 @@ +--- +layout: page +title: "Climate" +description: "Instructions how to setup climate control devices within Home Assistant." +date: 2016-08-26 19:00 +sidebar: true +comments: false +sharing: true +footer: true +--- + + +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`: + +```yaml +# Example configuration.yaml entry +climate: + platform: demo +``` + diff --git a/source/_components/climate.nest.markdown b/source/_components/climate.nest.markdown new file mode 100644 index 00000000000..78123905739 --- /dev/null +++ b/source/_components/climate.nest.markdown @@ -0,0 +1,30 @@ +--- +layout: page +title: "Nest Thermostat" +description: "Instructions how to integrate Nest thermostats within Home Assistant." +date: 2015-03-23 19:59 +sidebar: true +comments: false +sharing: true +footer: true +logo: nest_thermostat.png +ha_category: Climate +--- + + +The `nest` climate platform let you control a thermostat from [Nest](https://nest.com). + +To set it up, add the following information to your `configuration.yaml` file: + +```yaml +cliamte: + platform: nest +``` + +

+ +

+ +

+ You must have the [Nest component](https://home-assistant.io/components/nest/) configured to use this sensor. +

diff --git a/source/_components/climate.proliphix.markdown b/source/_components/climate.proliphix.markdown new file mode 100644 index 00000000000..5916d9258ea --- /dev/null +++ b/source/_components/climate.proliphix.markdown @@ -0,0 +1,40 @@ +--- +layout: page +title: "Proliphix Thermostat" +description: "Instructions how to integrate Proliphix thermostats within Home Assistant." +date: 2016-01-15 08:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: proliphix.png +ha_category: Climate +ha_release: 0.11 +--- + + +The `proliphix` climate platform let you control [Proliphix](http://www.proliphix.com) thermostat from Home Assistant. + +Currently supported and tested thermostats: + +- NT10e + +To set it up, add the following information to your `configuration.yaml` file: + +```yaml +climate: + platform: proliphix + host: IP_ADDRESS + username: YOUR_USERNAME + password: YOUR_PASSWORD +``` + +Configuration variables: + +- **host** (*Required*): Adress of your thermostat, eg. 192.168.1.32 +- **username** (*Required*): Username for the thermostat. +- **password** (*Required*): Password for the thermostat. + +The Proliphix NT Thermostat series are ethernet connected thermostats. They have a local HTTP interface that is based on get/set +of OID values. A complete collection of the API is available in this [API documentation](https://github.com/sdague/thermostat.rb/blob/master/docs/PDP_API_R1_11.pdf). + diff --git a/source/_components/climate.radiotherm.markdown b/source/_components/climate.radiotherm.markdown new file mode 100644 index 00000000000..01d806fa9e6 --- /dev/null +++ b/source/_components/climate.radiotherm.markdown @@ -0,0 +1,40 @@ +--- +layout: page +title: "Radiotherm Thermostat" +description: "Instructions how to integrate Radiotherm thermostats within Home Assistant." +date: 2015-10-18 17:15 +sidebar: true +comments: false +sharing: true +footer: true +logo: radiotherm.png +ha_category: Climate +--- + + +The `radiotherm` climate platform let you control a thermostat from [Radio Thermostat](http://www.radiothermostat.com/). + +The underlaying library supports: +- CT50 V1.09 +- CT50 V1.88 +- CT50 V1.94 (also known as Filtrete 3M50) +- CT80 Rev B2 V1.03 + +To set it up, add the following information to your `configuration.yaml` file: + +```yaml +climate: + platform: radiotherm + host: + - 192.168.99.137 + - 192.168.99.202 + hold_temp: True +``` + +Configuration variables: + +- **host** (*Required*): List of your Radiotherm thermostats +- **hold_temp** (*Required*): Boolean to control if Home Assistant temperature adjustments hold (`True`) or are temporary (`False`). + +Temperature settings from Home Assistant will be sent to thermostat and then hold at that temperature. Set to `False` if you set a thermostat schedule on the thermostat itself and just want Home Assistant to send temporary temperature changes. + diff --git a/source/_components/climate.zwave.markdown b/source/_components/climate.zwave.markdown new file mode 100644 index 00000000000..c99149936fe --- /dev/null +++ b/source/_components/climate.zwave.markdown @@ -0,0 +1,22 @@ +--- +layout: page +title: "Z-Wave Thermostat" +description: "Instructions how to setup the Z-Wave thermostat within Home Assistant." +date: 2016-04-03 9:52 +sidebar: true +comments: false +sharing: true +footer: true +logo: z-wave.png +ha_category: Climate +ha_release: 0.17 +--- + + +To get your Z-Wave thermostat working with Home Assistant, follow the instructions for the general [Z-Wave component](/components/zwave/). + +

+If your thermostat support fan modes or different operating modes, it should be considered a [HVAC component](/components/hvac.zwave/), and will also be detected as one. Thermostat component does not support setting fan or operation mode. This is controlled via the HVAC component. + +If the thermostat support different operationg modes, you will get one thermostat entity for each mode. These can be hidden with settings using the customize setting in the `configuration.yaml` file. +