Ring Doorbell & Camera

Version 0.6 - Smart Home Programming

This driver brings your Ring video doorbell and cameras into RTI. Doorbell presses and motion become RTI events you can wire to macros, with on-panel feedback (which device, battery, link state, last event time) and a last-event snapshot. It also serves a polished live dashboard you can drop onto any panel as a Web Object. It connects through the Smart Home Programming Ring cloud relay after a one-time account link - no Ring API key and no port-forwarding.

What it does / does not do

- Doorbell-press and motion events, per device, delivered as RTI events (typically 3-4 seconds, similar to the Ring phone notification).

- Last-event snapshot image, battery level, link status and last ding / last motion times.

- A responsive dashboard Web Object that auto-adapts to any panel size.

- Handles multiple Ring doorbells / cameras on one account.

- Does NOT provide live video streaming (a Ring platform limitation). This driver delivers events, snapshots and status.

Step 1 - Link your Ring account (one time)

1. On a phone or computer, go to: shpdrivers.services/ring

2. Sign in with your Ring email and password and complete the Ring two-factor code when prompted.

3. Enter the Link ID for this job. The Link ID is the RTI processor's MAC address in colons-uppercase form (for example 00:15:26:0F:12:9A). You can read it from the processor, or load the driver first and check the Link Status / Driver Version variables in TraceView.

4. Once linked, the relay begins watching your Ring account for that processor. You only do this once per processor.

Note: your Ring password is used only to obtain a link token and is not stored on the processor.

Step 2 - Add and configure the driver in IDesign

Add the driver to your processor, then review the configuration categories:

Cloud Connection

- Cloud Host: shpdrivers.services (default - leave as-is).

- Cloud Port: 443. Use HTTPS: On.

- Link ID (optional): leave blank to use the processor MAC automatically. Only set this if you linked under a different ID.

- Enable Event Polling: On (this is what receives doorbell / motion events).

Web Object Dashboard

- Enable Web Object / Web Object Port: the driver can also serve the dashboard locally on the processor. For most installs the hosted cloud dashboard (Step 4) is simpler - see that section.

Licence

- Licence Key: paste the key issued for this processor's MAC after purchase. Leave blank to run the 120-minute trial.

Diagnostics

- Debug Port: a telnet console port for live diagnostics (0 disables).

- Debug Level: Off / Info / Detail / Trace.

- Enable Remote Logging + Remote Log Host/Port: optional support feature - only turn on if Smart Home Programming asks you to, for remote troubleshooting.

Step 3 - Wire events to macros

Under Source Events / Driver Events you will find:

- Doorbell Pressed (any) - fires for any doorbell on the account.

- Doorbell Pressed - Device 1 ... Device 8 - per-device.

- Motion Detected (any) and Motion - Device 1 ... Device 8.

- Cloud Connected (system).

Wire these to macros to trigger anything you like on a press or motion: change to a camera page, flash lights, send a notification, mute audio, and so on. Device numbers follow the Device Count / Device N order reported by the driver.

Step 4 - The dashboard Web Object (recommended)

The quickest, best-looking way to show Ring on a panel is the hosted dashboard. Add an Advanced Web Object to a page and set its URL to:

https://shpdrivers.services/ring/dash?id=PROCESSOR-MAC

Replace PROCESSOR-MAC with this processor's MAC in colons-uppercase form (the same Link ID from Step 1), for example:

https://shpdrivers.services/ring/dash?id=00:15:26:0F:12:9A

The dashboard shows the doorbell with a cyan glow that pulses on an event, the device name, the last event, the last snapshot, and battery / link status. It automatically chooses the right layout for the size of the Web Object you draw - wide banner, small tile, large landscape or tall portrait - so the same URL works on every panel and page.

Optional URL extras:

- &bg=RRGGBB - set the background / corner colour (for example &bg=101418).

- &radius=NN - set the corner roundness in pixels (for example &radius=18).

On-panel feedback (native widgets)

If you prefer native widgets instead of (or alongside) the Web Object, bind to these driver variables / tags:

- Snapshot Image (tag: Ring Snapshot) - bind an Image widget to this for the last-event still.

- Last Event / Last Event Device / Last Event Time.

- Doorbell Device / Doorbell Time, Motion Device / Motion Time.

- Link Status, Cloud Connected, Device Count.

- Per device: Device N Name, Device N Battery (percent, -1 if unknown).

Diagnostics functions

Available as driver functions (wire to a button if useful):

- Force Poll Now - re-checks the cloud immediately.

- Print Status (TraceView) - dumps current state to TraceView.

- Remote Logging On / Off / Toggle - for remote support sessions.

Licensing

The driver runs a full 120-minute trial each time it loads, so you can confirm it works with your account before buying. To licence permanently, purchase from the Smart Home Programming store, supply this processor's MAC, and paste the issued Licence Key into the Licence category. The key is tied to that processor. After the trial expires without a key, event macros are paused but status and snapshots keep updating.

Troubleshooting

- Link Status shows "Not linked": re-link the account at shpdrivers.services/ring using this processor's MAC, and confirm Enable Event Polling is On.

- No events arriving: confirm the processor has internet access and that the account is linked. Use Force Poll Now and watch TraceView (Debug Level Info or higher).

- Snapshot is blank: a snapshot appears after the first event since the driver loaded; it shows the camera's current image. (Frozen per-event stills require a Ring Protect plan.)

- Dashboard or events fail on a restricted network: if the processor cannot resolve shpdrivers.services (some corporate / filtered networks), set Cloud Host to the relay IP 209.38.27.58, and you may use that IP in the Web Object URL as well.

- Live diagnostics: telnet the processor on the configured Debug Port.

Support

Smart Home Programming - smarthomeprogramming.com.au

For help with linking, licensing or a fault, contact us through the website and quote your processor MAC address.