Legacy: SmartThings Installation and Setup (Smartapp)
  1. Help & Support
  2. Troubleshooting
  3. Legacy: SmartThings Installation and Setup (Smartapp)

SmartThings: Install the Device Handlers

This Article is Outdated!

New users should NOT follow these instructions! As of October 2020, this integration method is no longer supported. SmartThings users, follow this guide instead to connect SmartThings via Konnected Cloud.

Konnected comes with a number of Groovy device handlers for SmartThings that support the capabilities of the various things you can attach to a Konnected board:

  1. Contact Sensor
  2. Motion Sensor
  3. Siren/Strobe (Alarm)
  4. Smoke Detector 
  5. Carbon Monoxide Detector
  6. Panic Button
  7. Switch
  8. Momentary Switch
  9. Beep/Blink Switch
  10. Water Leak Sensor
  11. Temperature & Humidity Sensor (DHT)

You only need to install the device handlers that you plan on using, but it doesn't hurt to install them all anyway.

Device Handlers can be installed automatically using GitHub integration, or manually by copy-and-pasting the Device Handler code into SmartThings IDE. Both methods are detailed below:

Install the Device Handlers with GitHub

  1. In the SmartThings IDE for your location, go to My Device Handlers

    Make sure that the URL in your address bar is on regional SmartThings server, for example: graph-na04-useast2.api.smartthings.com, where the first part varies. If it's not, go to My Locations and click on your location to be redirected to your regional server.

  2. Click Update From Repo and choose the konnected-security repository
  3. Check the checkbox next to each Konnected Device Handler to import
  4. Check Publish 
  5. Click Execute Update

Install the Device Handlers Manually

If you've already installed the Device Handlers with GitHub, you can skip this section.

  1. Go to My Device Handlers and click Create New Device Handler.
  2. Click on the From Code tab on the Create New Device Handler screen.
  3. Click here for the Device Handler source code on GitHub.
  4. Click on a Device Handler source code .groovy file. Then click the Raw button in GitHub to show the raw source. 
  5. Copy and paste the raw source device handler code into the SmartThings IDE Code editor.
  6. Save and publish the new Device Handler.
  7. Repeat steps 1-6 for each Device Handler that you need to install.

Next Step: Device Discovery