SmartThings - Ring Alarm Device & Smart-App

📣 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

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.