homestar-smartthings v3.0.1

homestar-smart-things

IOTDB Bridge for SmartThings

About

This Bridge allows you to control your SmartThings devices from IOTDB and Home☆Star. Note that this inherently is complicated. You'll have to add a new app to SmartThings. If you're not comfortable with programming-like things, please ask for help from someone who is.

• Read about Bridges

Installation and Configuration

• Read this first
• Read about installing Home☆Star

Then:

$ npm install -g homestar    ## may require sudo
$ npm install homestar-smartthings
$ homestar configure homestar-smartthings

Use

Turn a SmartThings switch off

const iotdb = require('iotdb')
iotdb.use("homestar-smartthings")
iotdb.connect("SmartThingsSwitch").set(":on", false)

There are many more samples available. Look for the files called iotdb_*.js.

Models

SmartThingsBattery

e.g.

{
    "battery": 90
}

SmartThingsContact

e.g.

{
    "open": true
}

SmartThingsSwitch

e.g.

{
    "on": true
}

SmartThingsTemperature

In Fahrenheit

e.g.

{
    "temperature": 72
}

Models with Issues

May be affected by SmartThings API changes. If you care to investigate...

SmartThingsMotion

true if there is motion.

e.g.

{
    "motion": true
}

SmartThingsThreeAxis

No particular units

e.g.

{
    "x": 10,
    "y": -180,
    "z": 78
}