Identifying Devices in the Third-Party Device Cloud

RHQB2B · October 6, 2015, 11:52am

Hi everyone,

i tried to build a device type in the 3rd party cloud.

i have read below doc:
http://docs.smartthings.com/en/latest/cloud-and-lan-connected-device-types-developers-guide/building-cloud-connected-device-types/building-the-service-manager.html#discovery

but seems like it is not clear to me…

question is:
how do i discover device from 3rd party cloud?
and how it is link into your device type?
then lastly… how to control it?

anyone have experience build this before?
please advise
thank you,
AnD

kevintierney · October 6, 2015, 12:13pm

Depends on the device and what sort of API/discovery mechanism it supports. Some devices can be discovered, some have to be specifically pointed to via IP or URL.

Can you give more specifics on the device you want to connect

There are some examples in the SmartThings github repo

Take a look at the WeMo connect smart app and the device type. Also check out smart weather tile

RHQB2B · October 6, 2015, 12:34pm

Hi @kevintierney,

Thanks for your reply,

So actually there is no physical device…
What in try to build is a ‘virtual device’ that actually taking value from an xml feed in the cloud.

For example: a virtual device that actually listening to weather online feed / temperature…

I would like to build this as a device (not smart app) so i can put the value in tile and in the future i can relate this with smart app and other sensors (e.g if temperature > 36c turn on air con and close window)

So my understanding is i have to build a smartapp (comnect) to discover the virtual device and i need to build a device type as well, but i cant see how the smartapp (connect) relate with my device type.

Any idea?

Thanks!
AnD

kevintierney · October 6, 2015, 12:44pm

The smartapp manages the connection,pulls the data, and creates the device .The device type handles the user interface (display and commands)

Take a look at the netatmo device. Even though there is a physical device, it interacts via an API

App:

github.com

SmartThingsCommunity/SmartThingsPublic/blob/master/smartapps/dianoga/netatmo-connect.src/netatmo-connect.groovy

/**
 * Netatmo Connect
 */
import java.text.DecimalFormat
import groovy.json.JsonSlurper

private getApiUrl()			{ "https://api.netatmo.com" }
private getVendorAuthPath()	{ "${apiUrl}/oauth2/authorize?" }
private getVendorTokenPath(){ "${apiUrl}/oauth2/token" }
private getVendorIcon()		{ "https://s3.amazonaws.com/smartapp-icons/Partner/netamo-icon-1%402x.png" }
private getClientId()		{ appSettings.clientId }
private getClientSecret()	{ appSettings.clientSecret }
private getServerUrl() 		{ appSettings.serverUrl }
private getShardUrl()		{ return getApiServerUrl() }
private getCallbackUrl()	{ "${serverUrl}/oauth/callback" }
private getBuildRedirectUrl() { "${serverUrl}/oauth/initialize?appId=${app.id}&access_token=${atomicState.accessToken}&apiServerUrl=${shardUrl}" }

definition(
	name: "Netatmo (Connect)",
	namespace: "dianoga",

This file has been truncated. show original

Device Type:

github.com

SmartThingsCommunity/SmartThingsPublic/blob/master/devicetypes/dianoga/netatmo-basestation.src/netatmo-basestation.groovy

/**
 *  netatmo-basestation
 *
 *  Copyright 2014 Brian Steere
 *
 *  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 *  in compliance with the License. You may obtain a copy of the License at:
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed
 *  on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License
 *  for the specific language governing permissions and limitations under the License.
 *
 */
metadata {
	definition (name: "Netatmo Basestation", namespace: "dianoga", author: "Brian Steere") {
		capability "Sensor"
		capability "Relative Humidity Measurement"
		capability "Temperature Measurement"

This file has been truncated. show original

RHQB2B · October 8, 2015, 4:01am

Thank you @kevintierney!

your sample is awesome, i’ve done my first smartapp (connect)

Cheers,
AnD

kevintierney · October 8, 2015, 11:45am

Glad to hear it worked for you. The ST github repo is a great way to learn how it’s done and find code to re-use

Identifying Devices in the Third-Party Device Cloud

Customers

Developers

Download the SmartThings App