Overview

This article describes the basic steps involved in creating device and sensor integrations using the SIB on the sensemetrics platform.

Basic Steps

1. Power on your sensemetrics Thread to connect to the sensemetrics cloud and add it to your account using the +Connection button
2. Create a sensor integration with pairs of metrics and units that represent the data you are collecting from the sensor
3. Create a device integration that references the sensor integration(s) created in step 2.  See Sensor Mount Types for different ways to reference sensors.
4. Update the device integration you created in step 3 to add UI controls to allow instances of the device to be added to a Thread.  This can be done by going to the YAML editor and using the Control Templates and clicking controls-array and thread-device.
5. Add an instance of the device to your Thread using the +Device button and specifying which port it is currently connected to.
6. Go back to the device integration editor page and select the instance you created in step 5 as your Test Device
7. Add code to the isDeviceAccessible code hook and click Test to verify connectivity and code feedback.
8. Add code to the syncDevice code hook if you need to set device properties that will be stored in the cloud
9. Add code to the syncSensor code hook if you need to set sensor properties that will be stored in the cloud
10. Add code to the poll code hook to get a reading from the sensor and post an observation to the sensemetrics platform

Finishing Steps

1. Verify that you can graph your observations or they appear in the data tables
2. Add any UI controls to your device config or sensor config forms if you need to set instance-specific properties that will be available in your code hooks
3. Add a device icon to your device integration by setting the icon key in the YAML file
4. Add a sensor icon to your sensor integration by setting the icon key in the YAML file