home-assistant.io/source/_components/sensor.ring.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release
page	Ring Sensor	Instructions on how to integrate your Ring.com devices within Home Assistant.	2017-04-01 10:00	true	false	true	true	ring.png	Sensor	0.40

To get your Ring.com binary sensors working within Home Assistant, please follow the instructions for the general Ring component.

Once you have enabled the Ring component, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: ring
    monitored_conditions:
      - battery
      - last_activity
      - last_ding
      - last_motion
      - volume

Configuration variables:

• username (Required): The username for accessing your Ring account.
• password (Required): The password for accessing your Ring account.
• scan_interval (Optional): Defines the update interval of the sensor in seconds. The default is 30 seconds.
• monitored_conditions array (Required): Conditions to display in the frontend. The following conditions can be monitored.
  • battery: Return the battery level from device
  • last_activity: Return the timestamp from the last event captured (ding/motion/on_demand) by the Ring doorbell camera
  • last_ding: Return the timestamp from the last time the Ring doorbell button was pressed
  • last_motion: Return the timestamp from the last motion event captured by the Ring doorbell camera
  • volume: Return the volume level from the device. Currently supported by external chimes and doorbells.

Currently it supports doorbells and external chimes only.