SmartThings Edge Drivers

What is SmartThings Edge?

SmartThings Edge is our new architecture for Hub Connected devices that uses Device Drivers to execute commands locally on SmartThings Hubs. Edge Drivers are Lua©-based and can be used for Hub Connected devices, including Zigbee, Z-Wave, and LAN protocols. SmartThings Edge will bring new benefits such as reduced latency and cloud costs.

Getting Started

In this repository, you’ll find different ready-to-install sample Edge Drivers that can help you integrate your devices to the SmartThings platform. For more information on building Edge Drivers, look at the resources in More Information

Zigbee SmartThings Multipurpose sensor

Example integrating a SmartThings Multipurpose sensor, which has the following Capabilities:

• Contact Sensor
• Temperature Measurement
• Acceleration/Vibration Sensor
• Three Axis Sensor

Sample Code

LAN RGB Light Bulb

Example integrating an ESP8266 board via LAN. This device is configured to work as a RGB Light Bulb and has the following Capabilities:

• Switch
• Switch Level
• Color Control

Sample Code

Z-Wave Aeotec MultiSensor 6

Example integrating the Aeotec’s MultiSensor 6 which has the following Capabilities:

• Motion Sensor
• Illuminance Measurement
• Temperature Measurement

Sample Code

thingsim device simulator

Example LAN device integration through an RPC Server supporting the Switch capability.

Sample Code

Custom Capability Integration

Zigbee Driver example that implements a stock and a custom capabilities.

• Refresh
• <namespace>.fancySwitch

Sample Code

Hello World example

Example Driver to get started with LAN-based device integrations. This implementation uses the Switch capability.

Sample Code

Installation Tutorial

Make sure you have the following:

1. The latest version of the SmartThings app (Android | iOS)

2. A SmartThings Hub with firmware version 38.x or greater

3. A compatible device ready to be integrated:

   a. Battery's level is enough for the device functionality (Zigbee Multi Sensor and Aeotec MultiSensor 6)

   b. The device was previously excluded from the Z-Wave network or is a fresh installation (Aeotec MultiSensor 6)

   c. You've installed the LightBulb App in the ESP8266 NodeMCU board and it's wired according to the schematics (LAN Lightbulb)

You'll find further installation instructions in each sample and in the Tutorial Community posts:

• Tutorial | Creating Drivers for Zigbee Devices with SmartThings Edge
• Tutorial | Creating Drivers for LAN Devices with SmartThings Edge
• Tutorial | Creating Drivers for ZWave Devices with SmartThings Edge
• Tutorial | Writing an RPC Client Edge Device Driver

More Information

Take a look at the announcement of SmartThings Edge in our Community.

Support

If you have any questions about the specification document, visit community.smartthings.com.