Skip to content

SmartThings Integration

We provide the following capabilities to interact with SmartThings:

  • On/Off
  • Percentage (light)
  • Fan Speed (fan)

Prerequisites

Upload Corresponding Information Model

Before using your connector, please upload corresponding information model with Integration Schema filled in to the Admin Site.

  • No device will be shown in the SmartThings app if there is no information model on the Admin Site.
  • Make sure the content in your information model is correct. If your information model is incorrect, you cannot discover your device. For more details about the content of information models, you can refer to Using Information Models.
  • We strongly suggest that you change the nickname for your device, not using a general name or device type as the device name.
  • For more details about uploading information models to the Admin site, you can refer to Managing Information Models.

Create SmartThings Workspace Account and Enroll Your Company

Please create an account and login at Develop Workspace.

Once you've logged in, please enroll your organization for project distribution.

Ask Exosite to Provide the Needed Info

You will need Exosite to provide the ExoHome's client ID and client secret to setup your project.

Setup Cloud Connector

This section describes how to build up a connector between SmartThings and ExoHome. A connector could link your devices to SmartThings.

After completing the section, you could start to try testing your devices on the SmartThings mobile app.

Create New Project

  • Go to Develop Workspace
  • Click "Create a new project"

    Please choose the enrolled company workspace (on the top right drop-down selector) to create your project

  • "What kind of project would you like to start?"

    • Choose "Device Integration"
  • "How do you want to integrate the device?
    • Choose "SmartThings Cloud Connector"
  • "Choose a type of Cloud Connector"
    • Choose "SmartThings Schema Connector"
  • "Give this cloud-to-cloud device integration a name"
    • Fill in your desired project name

Create Connector

  • Go to page "Cloud Connector | SmartThings Schema" under tab "Develop"
  • "Where are you hosting your connector app?"
    • Choose "WebHook Endpoint"
  • Target URL
    • https://YOUR-DOMAIN-NAME.apps.exosite.io/api:1/smartthings
  • Client ID
    • Fill in the client id provided by Exosite
  • Client Secret
    • Fill in client secret provided by Exosite
  • Authorization URI
    • https://YOUR-DOMAIN-NAME.apps.exosite.io/oauth2/authorize/smartthings
  • Token URL
    • https://YOUR-DOMAIN-NAME.apps.exosite.io/oauth2/token/smartthings
  • OAuth 2.0 Scopes Required
    • Fill in "profile"
  • App Display Name
    • Fill in your desired connector name that is friendly to the end user
  • Logo
    • Upload a logo file to represent your brand
  • Click "Save" and copy the Client ID and Client Secret provided by the pop-up window. Please provide the copied information to Exosite.

Create Custom Device Profile (Optional)

If your device type is not listed in the SmartThings categories, you may define your own device by adding device profile.

Currently Exosite supports light and fan capabilities. You may create a "ceiling fan with light" device by following the steps below.

  • Go to page "Device Profile" under the tab "Develop" and click "ADD A DEVICE PROFILE" in Option 2.
  • Give a name to your device and choose light as your device type, then click "Next" to proceed.
  • Add capabilities: Health Check and Refresh to the "main" component.
  • Click "ADD ANOTHER COMPONENT" and add capabilities: Switch and Switch Level to the "light" component.
  • Click "ADD ANOTHER COMPONENT" and add capabilities: Switch and Fan Speed to the "fan" component.
  • Click "Next" to proceed.
  • Select "Use general UI display". Choose light's Switch to both "State" and "Action".
  • Hit "CREATE DEVICE PROFILE" button to complete this session.

Deploy To Test

  • Go to page "Overview"
  • Click "Deploy to test"

Connect Your Device On Mobile to Test

You may follow this document for detailed instructions.

  • Install app "SmartThings"

  • Launch app and login to your SmartThings account

  • You can follow Test your device to:
    • Enable developer mode
    • Link your device
  • Choose your testing connector
  • Add device by clicking "+" on the upper right.
  • Click "My testing device"
  • Choose the project you set in SmartThings Developer Workspace from the list.
  • Login ExoHome for authentication
  • Authentication succeeds
  • All linked devices will be listed
  • You could refresh current status of devices and operate them

Publish

After completing your self-testing in developer mode, you can send the publish request by following SmartThings' instructions on the developer workspace.

Problem Shooting

If you run into any issues (e.g. not being able to control devices), try to do one of the following actions:

  • Check the correctness of information model
  • Delete original project and create another one again
  • Unlink the connector and re-link it again
  • There's no extra spaces in the fields you enter in the SmartThings Developer Workspace.

Last update: March 23, 2022