+ Using the Dome On/Off Plug-In Switch with SmartThings 773-794-1300 support@domeha.com www.domeha.com Table of Contents Installing the Device Handler 2 Main Page 3 Settings Page 4 Turn on a Lamp When Motion is Detected 5 Receive a Notification if the On/Off Plug-In Switch Overloads 6 Dim the Lights When Your TV Turns On! 7
Introduction Installing the Device Handler Until the Device Handler is officially published by SmartThings, users must use their own Device Handlers for full functionality within SmartThings. See below for instructions: 1. Log into the Smarthings developer portal (https://graph.api.smartthings.com/) If you do not have an account, register by following the link on the page. 2. Click My Device Handlers in the navigation bar (fig. 1). Figure 1 3. Press Create New Device Handler (fig. 2). 4. Click the From Code tab (fig. 3). 5. Open a new tab, visit https://raw. githubusercontent.com/krlaframboise/smartthings/master/ devicetypes/krlaframboise/dome-on-off-plug.src/dome-onoff-plug.groovy and copy ALL of the text. Figure 2 6. Paste the copied code into the text box, and click Create (fig. 3). 7. Now click Save (fig.4). 8. Finally publish it for yourself (fig. 5). 9. Now add the Siren to your SmartThings system. Visit www.domeha.com/ for further installation and set-up instructions. Figure 3 Note: You should only add the Siren to SmartThings AFTER the Device Handler is created. If you already added the device, remove it and add it again into your system, and the Siren will automatically detect the Device Handler. Figure 4 10. Congrats, that s it! Keep reading to see how to operate the Siren and create automations. Figure 5 Installing the Device Handler Page 2
1. Main Status This section displays the status of the On/Off Plug-In Switch: Off, On, and overload. The status is displayed with both text and the background color. The Interface Main Page The Main Page of the Device Handler displays the current status of the On/Off Plug-In Switch (Off, On, or Overload) and also presents energy usage data. See below for an overview of the interface and how to control the On/Off Plug-In Switch directly. 2. Previous Energy Usage These tiles display the kwh of energy the On/Off Plug-In Switch consumed before the last time the energy usage data was reset, and how much money it cost the user. 3. Energy Usage These tiles display the kwh the On/Off Plug-In Switch consumed after the last time the energy usage data was reset, and how much money it cost the user. 4. Power (W) Data These tiles display the instantaneous power output, along with the peak and minimum power output since the last time the data was reset. 8 7 1 2 3 5. Voltage (V) Data These tiles display the instantaneous voltage output, along with the peak and minimum voltage output since the last time 4 the data was reset. 6. Current (A) Data These tiles display the instantaneous current, along with the peak and current since the last time the data was reset. 5 7. Active/Inactive Status This displays whether the device plugged into the On/Off Plug-In Switch is active or not. If you want to use the active/inactive status in an automation, it is disguised as a Vibration sensor, and the overload status is hidden as an Open/Close sensor. 9 6 8. On/Off Switch These tile lets you turn the On/Off Plug-In Switch on or off. 9. Refresh This button refreshes the page so all of the settings and statuses are accurate and current. Main Page Note: the On/Off Plug-In Switch will appear as both an acceleration/vibration sensor and as an open/close sensor inside SmartThings. The vibration sensor status indicates whether the attached device is active or not, and the open/close sensor indicates when the On/Off Plug-In Switch is overloaded. Page 3
1. Enable/Disable LED This enables or disables the LED that indicates the device status (Enabled by default.) 2. Enable/Disable Physical Button This enables or disables local control of the On/Off Plug-In Switch using the physical button (Enabled by default.) 3. Auto-Off Interval This setting lets you automatically turn off the On/Off Plug-In Switch after a predetermined amount of time from 1 minute up to 3 weeks (Disabled by default.) The Interface Settings Page The settings page allows the user to change several properties of the On/Off Plug-In Switch, including its LED behavior, overload current threshold, and automatic shut-off capabilities. To access the settings page, simply press the Gear icon on the top right corner in the main device page. 8. Overload Warning LED Threshold This sets the current, in amps, at which the On/Off Plug-In Switch will light a yellow LED to warn that the current is getting high (12 Amps by default.) 9. $/kwh Cost This sets how much you pay per Kilowatthour of energy. 10. kwh Auto Reset Interval This sets how often the On/Off Plug-In Switch automatically resets the kwh of consumed energy (Disabled by default.) 4. Enable/Disable Remember On/Off If this setting is enabled, the On/Off Plug-In Switch will remember if it was either on or off the last time it was plugged in, and resume that status when 11. Inactive Attached Device Current This sets current below which the On/Off Plug-In Switch labels the device as inactive (0 Amps by default.) plugged in again (Enabled by default.) 5. Meter Reporting Interval This setting controls how often power usage information is transmitted to the Hub (5 minutes by default.) 6. Meter Reporting Threshold In addition to periodic meter reports, the On/Off Plug-In Switch also reports power consumption data when a relative change in usage is detected. This setting sets the threshold, in percent change, beyond which the On/Off Plug-In Switch will send a Meter report (5% by default.) 7. Overload Shut-Off Threshold This sets the current, in amps, at which the On/Off Plug-In Switch will power off for safety (13 Amps by default.) Settings Page Page 4
Automation & Security Turn on a Lamp When Motion is Detected SmartThings can automatically turn on a lamp connected to the On/Off Plug-In Switch if motion is detected. Follow the steps below to automatically illuminate your life with the On/Off Plug-In Switch: 1. Open the SmartThings app, go to the Automation tab, and tap Add a SmartApp (fig. 1). 2. Select Lights & Switches from the list that appears (fig. 2) then select Smart- Lights (fig. 3). 3. Select Which ligths do you want to control? and select the On/Off Plug-In Switch turn on (fig. 4). 4. Select if you want the lights to turn On or Off, then tap Select trigger and select Motion (fig. 5). Figure 1 Figure 2 5. Tap Which motion sensors?, select the motion sensors you want to trigger the lights, and press Done (fig. 6). 6. Tap Turn on when and select if the light should turn on when motion is detected or cleared. 7. Tap Next in the top right corner. 8. Rename your automation if you wish and tap Done to finish. Figure 3 Figure 4 Figure 5 Figure 6 Turn on a Lamp When Motion is Detected Page 5
Automation & Security Receive a Notification if the On/Off Plug-In Switch Overloads The On/Off Plug-In Switch will send a notification if the plugged in device starts to draw too much current. Continue reading to see how to receive a notification if your device overloads: 1. Open the SmartThings app and go to the Dashboard tab (fig. 1). 2. Press the Gear icon in the top right corner and tap Custom in the list that appears (fig. 2). 3. Tap New monitoring rule (fig. 3). 4. Tap What kind of device do you want to use? (fig. 4), select Open/Close Sensor, and tap Done. Figure 1 Figure 2 5. Tap Select Open/Close Sensors (fig. 5), select all of the On/Off Plug-In Switches you wish to monitor, and tap Done. 6. Use the toggle switches under What do you want to monitor and toggle on Sensor opens (fig. 5). 7. Choose how often SmartThings should notify you - if Only once per day is turned on, you will only be notified the FIRST time the device overloads in a day. Figure 3 Figure 4 8. Tap Next when done. 9. Tap Text & Push Notifications, specify how you want to be notified, and tap Done. 10. Tap Next, name your rule (fig. 9), and tap Done to finish the process. Receive a Notification if the On/Off Plug-In Switch Overloads Figure 5 Figure 6 Page 6
Automation & Security Dim the Lights When Your TV Turns On! The On/Off Plug-In Switch will send a notification when the plugged in device is active and drawing current. You can use this to know when your sump pump is active, keep track of how much TV the kids watch, or to trigger events when devices are active.continue reading to see how to dim your lights when your TV turns on: 1. Open the SmartThings app, go to the Automation tab, and tap Add a SmartApp (fig. 1). 2. Select Lights & Switches from the list that appears (fig. 2) then select Smart- Lights (fig. 3). 3. Select Which ligths do you want to control? and select the lights you want to turn dim when the TV turns on (fig. 4). 4. Tap What do you want to do?, select Turn On and Set Level, and set the level you want to dim the lights to. 5. Tap Select trigger and select Acceleration (fig. 5). Figure 1 Figure 2 6. Tap Which acceleration sensors?, select the On/Off Plug-In Switch your TV is plugged into, and press Done (fig. 6). 7. Tap Turn on when and select Acceleration Starts. 8. Tap Next in the top right corner. Figure 3 Figure 4 9. Rename your automation if you wish and tap Done to finish. Figure 5 Figure 6 Dim the Lights When Your TV Turns On! Page 7