5.3 KiB
layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, featured, ha_iot_class, redirect_from, ha_release
| layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | featured | ha_iot_class | redirect_from | ha_release | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| page | Z-Wave | Instructions on how to integrate your existing Z-Wave within Home Assistant. | 2016-02-27 19:59 | true | false | true | true | z-wave.png |
|
true | Local Push |
|
0.7 |
The Z-Wave integration for Home Assistant allows you to observe and control connected Z-Wave devices. Please see the Z-Wave getting started section for in-depth documentation on how to use and setup the Z-Wave component.
There is currently support for the following device types within Home Assistant:
{% linkable_title Configuration %}
If you have setup the requirements, then add the following entry configuration.yaml file:
# Example configuration.yaml entry
zwave:
{% linkable_title Climate %}
To get your Z-Wave thermostat or HVAC unit working with Home Assistant, follow the instructions for the general Z-Wave component.
Thermostats with support for fan modes or different operating modes, will be handled like a HVAC device and will also be detected as one.
If the thermostat supports different operating 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.
To enable the climate component for your Z-Wave network, add the following to your configuration.yaml file.
climate:
- platform: zwave
Once enabled, any Z-Wave climate devices will be available to Home Assistant. Multiple entities may be created. The following entities are created for a Remotec ZXT-120.
climate.remotec_zxt120_heating_1_id: Allows you to control the connected device. See below for examples.sensor.remotec_zxt120_temperature_38: A sensor which returns the current temperature set on the attached device.
{% linkable_title Automating Z-Wave Climate Devices %}
The following examples will instruct a Remotec ZXT-120 to turn the attached device mode to Heating, and set the temperature at 24 degrees after 8pm. Add it to automation.yaml.
automation:
- alias: Turn on Heater at 8pm
trigger:
- platform: time
at: "20:00:00"
action:
- service: climate.set_operation_mode
data:
entity_id: climate.remotec_zxt120_heating_1_id
operation_mode: Heat
- service: climate.set_temperature
data:
entity_id: climate.remotec_zxt120_heating_1_39
temperature: 24
Generally, in Home Assistant, you can use the homeassistant/turn_off service to turn devices off. For the Remotec ZXT-120, you must instead make a service call like the following.
automation:
- alias: Turn off Heater at 9pm
trigger:
- platform: time
at: "21:00:00"
action:
- service: climate.set_operation_mode
data:
entity_id: climate.remotec_zxt120_heating_1_id
operation_mode: 'Off'
Note: In the example above, the word Off is encased in single quotes to be valid YAML.
{% linkable_title Test if it works %}
A simple way to test if your Z-Wave climate device is working is to use 
Services from the Developer Tools. Choose the applicable Climate service from the list of Available services: and enter something like the sample below into the Service Data field and then press CALL SERVICE.
{
"entity_id": "climate.remotec_zxt120_heating_1_id",
"operation_mode": "Heat"
}
{% linkable_title Cover %}
Z-Wave garage doors, blinds, and roller shutters are supported as cover in Home Assistant.
To get your Z-Wave covers working with Home Assistant, follow the instructions for the general Z-Wave component.
If you discover that you need to invert the operation of open/close for a particular device, you may change this behavior in your Z-Wave section of your configuration.yaml file as follows:
zwave:
device_config:
cover.my_cover:
invert_openclose_buttons: true
{% linkable_title Lock %}
To get your Z-Wave locks working with Home Assistant, follow the instructions for the general Z-Wave component.
Z-Wave locks will expose three services under the lock domain to manage usercodes if the lock supports it:
| Service | Description |
|---|---|
| clear_usercode | Clears a usercode at code_slot X. Valid code_slots are 1-254, but max is defined by the lock. |
| get_usercode | Get a usercode from the lock at code_slot. Valid code_slots are 1-254, but max is defined by the lock. |
| set_usercode | Sets usercode to X at code_slot Y. Valid usercodes are at least 4 digits, and max defined by the lock. |