Open Zwave

Overview

The support from LinuxMCE system is represented by an executable ZWave (it's placed in /usr/pluto/bin) which is the device implementation and a DeviceTemplate (1754) which is used to create LinuxMCE Devices for ZWave. There are high speed (4x 40kbps) and standard speed Z-Wave devices.

As of LinuxMCE 1204 the driver will be based on Open-Zwave

This page is intended as a placeholder for notes and documentation on how to setup and configure the Z-Wave network with Open-Zwave.

For information about what hardware to get look at Z-Wave Getting Started, or check out the Z-Wave Wiki Category.

Configuring and setting up

For configuration and settings we will use the ZWave master control device to send specific commands to the ZWave devices you want to change. To do that we will first need to open to the Send command to device popup-screen:

• Go to Advanced -> Configuration -> Devices this shows the device tree on the left
• Click the top level Zwave device with "Device Template #: 1754"
• Click Send command to device button for the popup-screen to appear

From the drop-down menu, different commands can be chosen for different actions:

• Adding a new device to the zwave network:
  • Select Add Node
  • Activate the inclusion mode on the device to include (usually triple click to send the "node info frame") - see your devices' manual for exact information
• Stop adding a new device (if you want to cancel the command - no need to do this if you actually add a node):
  • Select Add Node
  • Set 48 Value (int) to 5
• Remove a Device
  • Select Remove Node
  • Send the "node info frame" from the device (usually triple click a button on the device) - see your devices' manual for exact information
• Remove a Failed Device
  • Select Remove Node
  • Set 48 Value (int) to -<node_you_want_to_remove> e.g. -7 to remove node 7

How to install and use ZWave

When starting a new ZWave network, it is recommended to reset the controller first, to enable SUC/SIS mode.

Send the Reset command to the ZWave device, with the argument set to "ResetController". This will clear out all network data on the ZWave interface, and will delete all nodes.

(currently, enabling SUC/SIS mode does not work on 1204 - but if you have enabled SUC/SIS mode previously this will still apply and you can skip this step)

Setting associations

You might need to set associations between your ZWave devices. The function of these associations can usually be found in your devices' manual. Generally, associations connects an action on one device with an action on another device. For instance, you can associate a button(switch) device with a dimmer device, and have the button control the dimmer.

• Go to Advanced -> Configuration -> Devices this shows the device tree on the left
• Click the top level Zwave device with "Device Template #: 1754"
• Click Send command to device button for the popup-screen to appear

Select Set Association and fill in the parameters:

• NodeID: The node to set associations for
• GroupID: The association group on the node to set. Different groups often have different meaning(or actions if you will)
• Nodes List: a comma separated list of node IDs to associate to.

To remove associations, use negative node ids in the Node List parameter.

Tweak advanced ZWave settings

The StatusReport command can be used for several different actions, depending on the parameter:

• NNU<nodeid> : RequestNodeNeighborUpdate
• NU<nodeid> : RequestNetworkUpdate
• HNN<nodeid> : HealNodeNetwork
• HN : HealNetwork

You should know what you are doing before trying any of these.

Update node information

You can request a manual update of the node information (command classes). To do this open the advanced page of the main ZWave device and send command to device. Send a "Resync node" command with the node id of the node you want to update the information from.

It should normally not be necessary to do this, as the node information is updated at the first reload after it was added. However, it can be useful if for some reason the node information was not correctly set or if you have replaced a node which may have other command classes.