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

 

Note: These command classes may only work with preferred devices.

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_1.png Z-Wave_Example_Switch_2.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

 

Example: Z-Wave Dimmer Switch

After including a Z-Wave dimmer 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 which the device’s DTH translates into a Switch Multilevel Set command. The Hub then sends the command to the device to activate the switch. In addition, the card is updated to show the switch’s new status. 

 

Z-Wave_Example_dimmer_1.png Z-Wave_Example_dimmer_2.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. 

Additionally, the dimmer switch provides a control to set the dimmer level. As with clicking the on/off button, sliding this control triggers the generation of a Switch Multilevel Set command.

 

Z-Wave_Example_dimmer_3.png Z-Wave_Example_Dimmer_4.png

Example: Z-Wave Thermostat

After including a Z-Wave thermostat, the device appears in the mobile application’s dashboard as a card with a status field indicating the current temperature.

 

Z-Wave_Example_Thermostat_1.png

 

Clicking on the card brings up a device page with thermostat controls and status fields. Changing a setting triggers an event which the device’s DTH translates into the appropriate Z-Wave command. The Hub then sends the command to the device to control the thermostat. 

For more information about the status fields and device controls for the Z-wave thermostat, check out the table below:

Status Field

Example Field

Current Temperature

69°F

Operating State

Heating

 

Control

Description

Triggered Command

Heating Temperature

Change the thermostat heating setpoint

Thermostat Setpoint Set

Cooling Temperature

Change the thermostat cooling setpoint

Thermostat Setpoint Set

Thermostat Mode

Change the operating mode of the thermostat

Thermostat Mode Set

Fan Mode

Change the operating mode of the HVAC system’s manual fan

Thermostat Fan Mode Set

 

Z-Wave_Example_Thermostat_2.png Z-Wave_Example_Thermostat_3.png

 

What is Z-Wave S2? 

Z-wave S2 is a new and improved security protocol for Z-Wave S2 compatible certified devices. Starting in 2018, newer Z-Wave devices are mandated by Z-Wave Alliance to support S2 security. S2 security allows you to add Z-Wave devices more securely than ever before as well as adding improvements to battery life and device reliability. 

 

How is the Z-Wave S2 security protocol different from the Z-Wave S0 security protocol? 

The Z-Wave S2 security protocol uses a new method to ensure when Z-Wave S2 devices are added, they have the most secure method of pairing. There are currently three groups of Z-Wave S2:  

  • Z-Wave S2 Access Control
  • Z-Wave S2 Authenticated 
  • Z-Wave S2 Unauthenticated

 

How do I add a Z-Wave S2 device? 

In the SmartThings mobile app:

  1. From the Home screen, touch the Plus (+) icon and select Device
  2. Select Manufacturer of the device then the Z-Wave device you would like to add 
  3. Touch Start
  4. Choose a Hub for the device
  5. Choose a Room for the device and touch Next
  6. Scan the QR code located on your device
    • If you cannot scan the QR code, select Add device manually
    • Enter the first 5 digits of the DSK code or Pin Number found on the device
    • Touch Add device 

Note: Devices classified as Z-Wave S2 Unauthenticated will add into SmartThings without the need for scanning the QR code or entering a pin. These devices are still using a form of the Z-Wave S2 security protocol.

 

How do I know if my Z-Wave device supports S2? 

Z-Wave devices that support the Z-Wave S2 security protocol should have clear and visible markings on the product that includes the Device Specific Key. 

 

I already added a Z-Wave S2 device previously, before the option to scan the code was available. Is my device using the new Z-Wave S2 protocol?

No, Z-Wave S2 devices added before the feature was available will still be using the older Z-Wave S0 security protocol. If you would like to have your device use the new S2 Security Protocol you will have to exclude and re-add the device using the steps above. 

 

How do I know which security protocol my Z-Wave device is using to communicate with the hub?

While adding older non S2 devices, you will receive the following prompt from the SmartThings App.

“Your device has been connected, but it isn't using the highest level of security. For more security, exclude the device and try adding it again.”

You can also see the network security level by using the SmartThings IDE. 

  1. Go to graph.api.smartthings.com
  2. Login to your account
  3. Select Devices next to your Locations name
  4. Select the name of the device
  5. In the Data section, look for the devices Network Security Level


More info:

How to add/exclude a Z-Wave device

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