/SmartThings-1

Samsung SmartThings SmartApps and Device Handlers

Primary LanguageGroovyApache License 2.0Apache-2.0

SmartThings

https://github.com/codersaur/SmartThings

Copyright (c) 2016 David Lomas

Overview

This repository contains device handlers and SmartApps for use with Samsung's SmartThings home automation platform.

SmartApps

  • This SmartApp connects your Honeywell Evohome System to SmartThings.
  • Note, the Evohome Heating Zone device handler (below) must also be installed.
  • This SmartApp logs SmartThings device attributes to an InfluxDB database.

SmartApp Installation Procedure

Part One: Install the code using the SmartThings IDE

  1. Within the SmartThings IDE, click 'My SmartApps', then '+ New SmartApp'.
  2. Select the 'From Code' tab and paste in the contents of the relevant groovy file.
  3. Click 'Create', and then 'Publish' (For Me).

Part Two: Create a SmartApp instance

  1. Using the SmartThings app on your phone, navigate to the 'Marketplace'.
  2. Select 'SmartApps', then browse to 'My Apps' at the bottom of the list.
  3. Select the new SmartApp, complete the configuration options and press 'Done'.

Note: Some SmartApps may support multiple instances, whereas others may only allow one instance.

Device Handlers

  • This device handler is written specifically for the Aeon Home Energy Meter Gen2 UK version, with a single clamp.
  • It supports live reporting of energy, power, current, and voltage, as well as energy and cost statistics over multiple pre-defined periods.
  • This device handler is required for the Evohome (Connect) SmartApp.
  • This device handler is written specifically for the Fibaro Dimmer 2 (FGD-212).
  • It extends hajar97's original device handler to suport Nightmode and fixes a number of issues.
  • Nightmode function: Nightmode forces the dimmer to switch on at a specific level (e.g. low-level during the night). It can be enabled/disabled manually using the new Nightmode tile, and/or scheduled from the device settings.
  • This device handler is written specifically for the Fibaro RGBW Controller (FGRGBWM-441).
  • It extends the native SmartThings device handler to support editing the device's parameters from the SmartThings GUI, and to support the use of one or more of the controller's channels in IN/OUT mode (i.e. analog sensor inputs).
  • This device handler is written specifically for the Philio Dual Relay (PAN04), when used as a single switch/relay only.
  • It supports live reporting of energy, power, current, voltage, and power factor, as well as energy and cost statistics over multiple pre-defined periods.
  • This device handler is written specifically for the TKB Metering Switch (TZ88E-GEN5).
  • It supports live reporting of energy, power, current, voltage, and power factor, as well as energy and cost statistics over multiple pre-defined periods.

Device Handler Installation Procedure

Part One: Install the code using the SmartThings IDE

  1. Within the SmartThings IDE, click on 'My Device Handlers'.
  2. Click the '+ Create New Device Handler' button.
  3. Select the 'From Code' tab and paste in the contents of the relevant groovy file.
  4. Click 'Create'.
  5. Click 'Publish' (For Me).

Part Two: Update existing device types

When you add new devices, SmartThings will automatically select the device handler with the closest-matching fingerprint. However, this process is not perfect and it often fails to select the desired device handler. You may also have pre-existing devices that you want to have use the new device handler. In these cases, you need to change the device type of each device instance from the IDE.

  1. Within the SmartThings IDE, click on 'My Devices'.
  2. Click on the appropriate device to bring up its properties.
  3. Click the 'Edit' button at the bottom.
  4. Change the 'Type' using the drop-down box (custom devices will be near the bottom of the list).
  5. Hit the 'Update' button at the bottom.

Part Three: Update existing device settings

If you have changed the type of an existing device, it is very important to update the device's settings to ensure the device instance is fully initialised and ready for use with the new device handler.

  1. Within the SmartThings IDE, click on 'Live Logging'.
  2. In the SmartThings app on your phone, navigate to the device (you should find the GUI has changed to reflect the new tiles configuration).
  3. Press the gear icon to edit the device's settings.
  4. Review each setting to ensure it has a suitable value, then press 'Done'.
  5. Back in the SmartThings IDE, review any messages from the device in the 'Live Logging' screen.

Note: Android users may encounter some errors in the SmartThings app after a device type has been changed. This can usually be resolved by completely closing the SmartThings app and restarting it.

License

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.