SmartThings Integration


SmartThings SmartApp Integration

We have a simple, easy way to stream all of the SmartThings events going across a SmartThings network to Initial State with just a few simple clicks of a button and no coding required! SmartThings integrations are called SmartApps, so when you enable this integration, you'll see a new Initial State Event Streamer SmartApp installed into your SmartApps of your SmartThing's mobile application. You can enable or disable device capabilities from within this SmartApp inside the SmartThings mobile app, but we recommend doing it from the browser because of the potential for a very large amount of devices and capabilities!

You can check out the tutorial for setting the integration up on our blog.

Currently supported device capabilities:
  • alarm 
  • contact sensor 
  • lock 
  • motion sensor 
  • presence sensor 
  • relative humidity measurement 
  • switch 
  • switch level 
  • temperature measurement 
  • thermostat 
  • water sensor
  • acceleration sensor 
  • battery 
  • beacon 
  • carbon monoxide detector 
  • color contro 
  • energy meter 
  • illuminance measurement 
  • music player 
  • power meter 
  • relay switch 
  • sleep sensor 
  • smoke detector 
  • step sensor 
  • valve

Release Notes:

New SmartApp version 1.1.0

The current SmartApp version is 1.1.0 and does not buffer events like the previous version. Instead it sends the events along to Initial State as soon as they've occurred. This experience was driven by two factors: 1) the unbuffered version is a better overall user experience 2) the underlying buffering capabilities inside SmartThings didn't perform as expected for this type of use

SmartApp version 1.0.8

Buffering

SmartThings processes pretty significant event load across their infrastructure. In order to help SmartThings handle their load better, we've implemented buffering inside the SmartApp that's responsible for sending the events to Initial State as part of the integration. While this does make the events less "real-time" in the visualization than other means for sending events to Initial State, it does make the integration more reliable on SmartThings' infrastructure.

What is buffering and how does it work?

You can think of it like a shuttle bus waiting for people to onboard to take to their destination. Since the people arrive at unpredictable times, the bus driver may wait for a certain amount of time to pass before departing the current bus stop and heading to the destination. Additionally, the bus driver may leave early if all the seats fill up on the bus and there is no more room. While this potentially makes the travel time for an individual slower (i.e. they're the first to get on the bus) it does make the transit system more efficient.
The Initial State Event Streamer SmartApp functions just like this, except instead of people and buses on roads, it's events and buffers across the internet. The SmartApp will queue each event it's allowed to see and ship the queue to Initial State every 15 min. However, if the queue contains 10 events, it will ship right away (like a full shuttle bus).
You'll be able to see your events in Initial State's visualizations as soon as they're shipped from the SmartApp. 


Feedback and Knowledge Base