Skip to content

Commit d897e34

Browse files
authored
Update z-wave-device-specific.markdown
Add info and example of entry in dev-service to set configuration parameter for zwave. Add more info on security devices.
1 parent 76b28de commit d897e34

File tree

1 file changed

+19
-2
lines changed

1 file changed

+19
-2
lines changed

source/getting-started/z-wave-device-specific.markdown

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,32 @@ footer: true
1111

1212
##### {% linkable_title Motion or alarm sensors %}
1313

14-
In order for Home Assistant to recognize well the sensor, you will need to change its configuration from `Basic Set (default)` to `Binary Sensor report` or `Alarm report`. Currently there's no way to do this in Home Assistant but you can use ozwcp (OpenZWave control panel), Domoticz or similar to do it.
14+
In order for Home Assistant to recognize well the sensor, you will need to change its configuration from `Basic Set (default)` to `Binary Sensor report` or `Alarm report`.
1515
These devices will either show as a binary sensor or a sensor called `Alarm xxxx` and will report a numeric value. Test to see what value is what. Sometimes this is noted in the device manual.
1616

17+
As of version 0.30 you can set the settings of a Z-Wave device through the dev_service page of Home Assistant with the service: `zwave/set_config_parameter`.
18+
19+
The following parameters can be entered:
20+
- **entity_id** (*Required*): The entity_id of the device that you are going to set a parameter to. Any entity_id of the node can be used.
21+
- **parameter** (*Required*): The index number of the parameter to be set. Refer to device manual or zwcfg_[home_id].xml
22+
- **value** (*Required*): The value to set the parameter to. Refer to device manual or zwcfg_[home_id].xml
23+
- **size** (*Optional*): The size of the value. It is normally not needed to specify this parameter, but in some cases it's needed. Check OZW.log for details on this.
24+
You should check OZW.log to see if setting has been set
25+
Example entry in dev-service, setting binary report for Aeotec multisensor 6:
26+
```yaml
27+
# Example entry in dev-service
28+
{"entity_id": "sensor.aetoec_multisensor_6_luminance_5",
29+
"parameter": "5",
30+
"value": "2"
31+
}
32+
```
1733

1834
##### {% linkable_title Locks and other secure devices %}
1935

2036
These devices require a network key to be set for the Z-Wave network before they are paired. This key is set in OpenZwave's `options.xml` which is located in OpenZWave's directory. This should also be the same directory as `config_path:` in your `configuration.yaml`. If it's not, make sure you have the same values in all the files you are using.
2137
The option is commented out by default in `options.xml` and is a default key. Make your own unique key. The key is in Hexadecimals.
22-
It is best to pair these devices in OpenZWave Control Panel or other Z-wave tool that can show you logs while pairing. Test the device before you save the configuration.
38+
It is best to pair these devices in OpenZWave Control Panel or other Z-wave tool that can show you logs while pairing. Home Assistant show logs from zwave too and it is `OZW.log` in the Home Assistant config directory.
39+
You should see communication from the node with lines starting with `info: NONCES` in `OZW.log` when the device is paired secure successfully. If you use Open Zwave Control Panel to Pair, test the device before you save the configuration.
2340
Make sure you copy the newly saved `zwcfg_[home_id].xml`into your Home Assistant configuration directory.
2441

2542

0 commit comments

Comments
 (0)