home-assistant.io/source/_docs/z-wave/services.markdown
Erik-jan Riemers d5c995135b Update on z-wave docs because of upcoming change (#9095)
* Update z-wave section

* ✏️ Tweaks
2019-04-03 17:07:17 -07:00

6.1 KiB

layout, title, description, date, sidebar, comments, sharing, footer
layout title description date sidebar comments sharing footer
page Z-Wave Services Services exposed by the Z-Wave component. 2017-09-21 10:59 true false true true

The zwave component exposes multiple services to help maintain the network. All of these are available through the Z-Wave control panel.

Service Description
add_node Put the Z-Wave controller in inclusion mode. Allows you to add a new device to the Z-Wave network.
add_node_secure Put the Z-Wave controller in secure inclusion mode. Allows you to add a new device with secure communications to the Z-Wave network.
cancel_command Cancels a running Z-Wave command. If you have started an add_node or remove_node command, and decide you are not going to do it, then this must be used to stop the inclusion/exclusion command.
change_association Add or remove an association in the Z-Wave network
heal_network Tells the controller to "heal" the Z-Wave network. Basically asks the nodes to tell the controller all of their neighbors so the controller can re-figure out optimal routing.
heal_node Tells the controller to "heal" a specific node on the network. Requires node_id field. You can also force return route update with return_routes field.
print_config_parameter Prints Z-Wave node's config parameter value to the (console) log.
print_node Print all states of Z-Wave node.
refresh_entity Refresh the Z-Wave entity by refreshing dependent values.
refresh_node Refresh the Z-Wave node.
refresh_node_value Refresh the specified value of a Z-Wave node.
remove_node Put the Z-Wave controller in exclusion mode. Allows you to remove a device from the Z-Wave network.
rename_node Sets a node's name. Requires a node_id and name field.
rename_value Sets a value's name. Requires a node_id, value_id, and name field.
remove_failed_node Remove a failed node from the network. The Node should be on the controller's Failed Node List, otherwise this command will fail.
replace_failed_node Replace a failed device with another. If the node is not in the controller's Failed Node List, or the node responds, this command will fail.
reset_node_meters Reset a node's meter values. Only works if the node supports this.
set_config_parameter Lets the user set a config parameter to a node. NOTE: Use the parameter option's label string as the value for list parameters (e.g., "value": "Off"). For all other parameters use the relevant integer value (e.g., "value": 1).
set_node_value Set the specified value of a Z-Wave node.
soft_reset Tells the controller to do a "soft reset." This is not supposed to lose any data, but different controllers can behave differently to a "soft reset" command.
start_network Starts the Z-Wave network.
stop_network Stops the Z-Wave network.
test_network Tells the controller to send no-op commands to each node and measure the time for a response. In theory, this can also bring back nodes which have been marked "presumed dead."
test_node Tells the controller to send no-op command(s) to a specific node. Requires node_id field. You can specify amount of test_messages to send by specifying it with messages field. In theory, this could bring back nodes marked as "presumed dead"
update_config Attempt to update OZW configuration files from git to support newer devices. After you run this, wait a few minutes then stop Home Assistant. You can now back up your zwcfg_*.xml file, then delete the relevant entries from your zwcfg_*.xml (between and including <Node id="?"> and </Node>), and finally start Home Assistant.

The soft_reset and heal_network commands can be used to help keep a Z-Wave network running reliably. This is a configuration option for the zwave component. The option defaults to false but can be enabled by setting autoheal to true. This, however, is bad practice since it introduces overhead that can be avoided since you only need to do a heal_network whenever one of the following actions are done:

  • Adding/Removing a new node
  • Moving a node around
  • Moving the Controller
  • Removing a Dead Node

Using the `soft_reset` function with some Z-Wave controllers can cause the Z-Wave network to hang.

To trigger a heal_network, one can always use Settings -> Z-Wave Network Management -> Heal Network from the GUI whenever one of the above actions took place.