SmartThings Support

Z-Wave General Info

Table of Contents

 

General Information

The SmartThings Hub is a Z-Wave-certified central static controller. It can be included in any Z-Wave network and operate with Z-Wave certified devices from other manufacturers. To add a Z-Wave device to the Hub's network or copy network information to another controller, check out our guide on setting up new devices. To control an included device, find the device in the My Home section under Things, and tap on its name to see the device detail view.

All non-battery-operated Z-Wave devices within the network will act as Z-Wave repeaters—regardless of vendor—to increase reliability of the network.

The SmartThings Hub is a security-enabled Z-Wave product. When a security-enabled Z-Wave device is added to the Hub's network, its secure communication will be 128-bit AES encrypted.

 

Command classes supported by the SmartThings Hubs

The following Z-Wave command classes are supported by the SmartThings Hub:

Command Class Version Required Security Class
Z-Wave Plus Info 2 None
Transport Service 2 None
CRC 16 Encapsulation 1 None
Supervision 1 None
Inclusion Controller 1 None
Security 0 1 None
Security 2 1 None 
Association Group Info 1 Highest Granted 
Device Reset Locally 1 Highest Granted
Manufacturer Specific 1 Highest Granted 
Power Level 1 Highest Granted 
Association 2 Highest Granted 
Version 2 Highest Granted 

 

The SmartThings Hub has support for the Association Command Class—it has one association group, the "Lifeline" group, which supports sending associated devices reset notifications when the Hub is factory reset. A maximum of 231 devices can be added to this group.

The SmartThings Hub does not map the Basic Command Class to any functionality. It ignores Basic Get requests, though in some cases of legacy support for older Z-Wave sensors it may interpret Basic Set commands as sensor activation events.

The SmartThings Hub controls devices with unknown device types using the basic command class, and optionally controls other devices with the basic command class.

 

Including the SmartThings Hub into another Z-Wave network

Learn mode allows the hub to join or leave a network, or receive the latest network update from another controller in the network. Note that you can only add a Hub to a different Z-Wave network if no Z-Wave devices have been added. Otherwise, you should remove all Z-Wave devices from the Hub first by putting them through a device exclusion. When the SmartThings Hub is added into another Z-Wave network, it may not receive notifications from some battery-operated devices. SmartThings Technical Support does not provide assistance to consumers using the Hub with other Z-Wave controllers.

Here are the steps to put the Hub into learn mode to receive network information from another Z-Wave controller:

  1. Prepare the other Z-Wave controller to copy its network information to the Hub. This may be called include, add, transfer, shift, copy, or replicate mode
  2. Log in to graph.api.smartthings.com
  3. Click My Locations
  4. Click the location with the Hub
  5. Select the Hub
  6. Select View Utilities
  7. Click Join/Leave another Z-Wave network
    • Z-Wave learn mode will be initiated for 8 seconds

This will start learn mode on the Hub. It may take longer to receive all the network info and load all the devices. Check the other controller for confirmation of whether the transfer was successful.

Depending on the other controller, it may not have transferred the primary controller role to the SmartThings Hub, and the Hub may not be able to add new devices. To remove the Hub from the other network and reset it to default, follow the same steps above, but put the other controller in remove or exclude mode instead.

 

How controlled commands are sent from the hub to devices

Z-Wave devices connected to a SmartThings Hub can be controlled through the SmartThings mobile application. Interacting with a device in the mobile application by clicking a button, moving a slider, etc. generates an action on the SmartThings platform which is handled by the device’s assigned Device Type Handler (DTH). The DTH translates commands from the SmartThings platform into the appropriate Z-Wave commands for the Hub to send to the device. 

This example DTH demonstrates how many common commands may be handled. For a complete listing of functionality provided by DTHs, refer to the DTH API Reference.

The following is a list of controlled Z-Wave command classes the Hub uses:

 

Basic

Manufacturer Specific

Binary Switch

Multi-Channel Association

Door Lock

Version

Multilevel Switch

Wake Up

Thermostat Fan Mode

Z-Wave Plus Info

Thermostat Mode

CRC-16 Encapsulation

Thermostat Operating State

Multi-Channel

Thermostat Setpoint

Security 0

Association

Security 2

Association Group Information

Inclusion Controller

Device Reset Locally

 

 

In addition, the hub uses a subset of the above command classes to perform an automatic interview of newly added devices. This interview includes the following steps:

  1. Version Interview: The Hub queries the device for the versions of its supported command classes.
  2. Association / Multi-Channel Association Interview: The Hub queries the device for the list of supported association groups, the list of nodes in each group, and the association group information for each group. The Hub will also add itself to the device’s lifeline group if possible.

To further illustrate how to control a device manually using the listed Z-Wave command classes, we’ll consider a few common examples.

Example: Z-Wave Switch

After including a Z-Wave switch, the device appears in the mobile application’s dashboard as a card with a single on/off button and a status field indicating the device is off. Clicking the button triggers an event in which the device’s DTH translates into a Basic Set command. The Hub then sends the commands to the device to activate the switch. In addition, the card is updated to show the switch’s new status. 

 

Z-Wave_Example_Switch_2.png Z-Wave_Example_Switch_1.png

 

Clicking on the card brings up a device page with additional controls. The device page provides a button for toggling the switch on and off as well as interfaces for scheduling on/off events in the future. These events are executed by the SmartThings platform at the appropriate time, causing the Hub to send Basic Set commands to the device.

 

Z-Wave_Example_Switch_3.png Z-Wave_Example_Switch_4.png

 

Example: Z-Wave Lock

After including a Z-Wave lock, the device appears in the mobile application’s dashboard as a card with a single lock/unlock button and a status field indicating if the device is locked/unlocked. Clicking the button triggers an event in which the device’s DTH translates into a Door Lock Operation Set command. The Hub then sends the command to the device to activate the lock. In addition, the card is updated to show the lock’s new status. 

 

Z-Wave_Example_Lock_2.png Z-Wave_Example_Lock_1.png

 

Clicking on the card brings up a device page with additional controls. The lock provides a button equivalent to the dashboard button for locking and unlocking the device and viewing the device’s status.

 

Z-Wave_Example_Lock_4.png Z-Wave_Example_Lock_3.png

 


More info:

How to add/exclude a Z-Wave device

How to factory reset the Hub's Z-Wave network and settings