To be able to manage Z-Wave networks via the Home Device Manager you need to select the protocol adapter registered under the name Z-Wave.

Protocol Operations

The Z-Wave protocol adapter supports the following device administration operations:

• REMOVE (Only failed devices can be removed using the remove operation.)

Protocol Properties

The device properties related to the underlying Z-Wave protocol adapter are described in the table below:

Conditional Properties

Added only if the Manufacturer Specific CC (0x72) version 2 is supported by the device:

Added only if the Z-Wave Plus Info CC (0x5E) is supported by the device (i.e. zwave.plus property's value is set to true):

Added only if the Security CC (0x98) is supported by the device:

You can retrieve a list of the properties required by the Z-Wave protocol adapter by using the getProperties or getPropertyMetadata method of the corresponding ProtocolAdapterInfo object. If a property is mandatory, its ProtocolAdapter.META_INFO_PROPERTY_RESOLUTION metadata property will be ProtocolAdapter.META_INFO_PROPERTY_RESOLUTION_MANDATORY.

Polling

Z-Wave protocol adapter implements a specific polling mechanism instead of the default HDM polling mechanism. Note that this mechanism is used only for legacy Z-Wave devices, since the Z-Wave Plus devices are required by specification to send events to the devices associated in group 1.

The specifics of this polling mechanism are as follow:

• every 40 seconds one device gets polled (whichever is next in the polling queue). If a device receives any message the polling time is reset to the default one
• after a successful poll, the device is put at the end of the polling queue. If there are 10 mains-powered devices then it will take at least 10*40 seconds to poll it again
• FLiRS devices are polled on a longer basis (300 seconds) to avoid draining the batteries
• if a poll fails (including the last working route and auto-rerouting/explorer message) then the next poll of that device is executed after double the period of time, i.e. 2*40=80 seconds. Each successive fail results in doubling the previous period until a maximum of 1 hour is reached and then maintained
• if a device starts responding and the poll succeeds - the interval is reduced back to the default 40 seconds (or 300 seconds in case of FLiRS devices)

This approach allows for a better balance between the need for polling and potentially making the network unusable because of the overhead.

Please note that, however aggressive a polling method is, it can never overcome the delay in refreshing the device state. To avoid this problem we recommend to choose mains-powered devices which implement Z-Wave HAIL Command Class, since in this case the device state is refreshed almost instantly should an action on the end device occur. Alternatively the use of Z-Wave Plus devices circumvents the issue altogether, because they send events to the device that have been added to association group 1 and our driver will always associate the controller for all Z-Wave Plus devices.

Network Controller

The ZWaveNetworkController interface extends the com.prosyst.mbs.services.hdm.deviceclasses.NetworkController and the com.prosyst.mbs.services.hdm.deviceclasses.NetworkControllerExt HDM device classes. For more information refer to: Z-Wave Network Controller

The NetworkController device class provides support for network controllers. The network controller mode can be for example add, remove, learn, etc. For more information refer to: NetworkController

The NetworkControllerExt class provides additional support for network controllers. The network controller mode can be normal, pairing and removing. Additionally the mode duration and mode remaining time are provided. The operation reset has to reset the controller and to remove all home devices. For more information refer to: NetworkControllerExt .