Skip to content

javier-jm/smartthings

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SmartThings - Ring Alarm Device & Smart-App

📣 DEPRECATED: All features from this fork have been merged back to the original repository: https://github.com/asishrs/smartthings

📣 This is a fork of https://github.com/asishrs/smartthings adding support for sensors as "Things" that can be used in automation tasks.

This repository contains device handler and smart-app for Ring Alarm integration with SmartThings. In order to use this, you need to deploy the API part as described here.

Prerequisites

Ring Alarm API

⚠️You need to have a working API before proceed to the next steps.

Supported Ring Devices

  • Alarm base
  • Keypad
  • Motion sensor
  • Contact sensor
  • Flood/freeze sensor
  • Z-Wave range extender

Manual Install SmartThings Device Handler

  • Login at http://graph.api.smartthings.com
  • Select My Locations, select the location you want to use.
  • Select My Device Handlers
  • Click on the + New Device Handler button on the right.
  • On the New Device Handler page, Select the Tab From Code
  • Copy the RingAlarmWithSensors.groovy source code and paste it into the IDE editor window - edit as shown below for devices/counts.
  • Click the Create button at the bottom.
  • Click the blue Save button above the editor window.
  • Click the Publish button next to it and select For Me. You have now self-published your Device Handler
  • Repeat the same steps (Add new device handlers) for the Ring contact sensor, Ring motion sensor and Ring flood/freeze sensor.

✏️ Update the number of ring devices in the code, check for below part.

//Define number of devices here:
def motionSensorCount = 5
def contactSensorCount = 11
def floodFreezeSensorCount = 1
def rangeExtenderCount = 1
def keypadCount = 1

Install Alarm Device

  • Select My Devices
  • Click on the + New Device button on the right.
  • Fill the Name and Network ID Field (can be anything you like)
  • Under Type, select "Ring Alarm With Sensors"
  • Select appropriate options under Location and Hub
  • Click Create
  • Click Preferences (edit)
  • Input below:
    • Ring User Name
    • Ring Password
    • API Url - Invoke URL from Lambda setup (should end with .com/default)
    • API Key - API key from Lambda setup
    • Location Id - Location Id value found in browser Network panel.
    • ZID - ZID value found in browser Network panel.

Install SmartThings App

  • (optional) Login at http://graph.api.smartthings.com
  • (optional) Select My Locations, select the location you want to use.
  • Select My SmartApps
  • Click on the + New SmartApp button on the right.
  • On the New SmartApp page, Select the Tab From Code
  • Copy the ringalarm-watch.groovy source code and paste it into the IDE editor window
  • Click the Create button at the bottom.
  • Click the blue Save button above the editor window.
  • Click the Publish button next to it and select For Me. You have now self-published your SmartApp

Setup your SmartThings App

This is based on Smarthing Classic App.

  • Open your SmartThings app and go to My Home
  • Tap on the Ring Alarm and then tap on the settings (gear icon).
  • Add below
    • Ring User Name
    • Ring Password
    • API Url - Invoke URL from Lambda setup
    • API Key - API key from Lambda setup
    • Location Id - Location Id value found in browser Network panel.
    • ZID - ZID value found in browser Network panel.
    • Polling Interval - Polling interval between Ring Status API call.
My Home Ring Alarm Settings
SmartThings - My Home SmartThings - My Home

Support

Do you have more devices?

Either open an issue with the device type, or you can make a PR with the required changes.

Other issues? Please open an issue.

License

SmartThings - Ring Alarm Device & Smart-App is released under the MIT License.

About

SmartThings Custom Integrations

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Groovy 100.0%