mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 17:27:19 +00:00
Updated Ring component documentation (#2366)
* Updated Ring component documentation * Add reference to sub pages
This commit is contained in:
parent
4eb8f9a142
commit
06f2f03dcb
@ -2,28 +2,24 @@
|
|||||||
layout: page
|
layout: page
|
||||||
title: "Ring"
|
title: "Ring"
|
||||||
description: "Instructions on how to integrate your Ring.com devices within Home Assistant."
|
description: "Instructions on how to integrate your Ring.com devices within Home Assistant."
|
||||||
date: 2017-03-10 10:00
|
date: 2017-04-01 10:00
|
||||||
sidebar: true
|
sidebar: true
|
||||||
comments: false
|
comments: false
|
||||||
sharing: true
|
sharing: true
|
||||||
footer: true
|
footer: true
|
||||||
logo: ring.png
|
logo: ring.png
|
||||||
ha_category: Binary Sensor
|
ha_category: Binary Sensor
|
||||||
ha_release: 0.40
|
ha_release: 0.42
|
||||||
---
|
---
|
||||||
|
|
||||||
The `ring` binary sensor allows you to integrate your [Ring.com](https://ring.com/) devices in Home Assistant.
|
To get your [Ring.com](https://ring.com/) binary sensors working within Home Assistant, please follow the instructions for the general [Ring component](/components/ring).
|
||||||
|
|
||||||
Currently only doorbells are supported by this sensor.
|
Once you have enabled the [Ring component](/components/ring), add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
To enable device linked in your [Ring.com](https://ring.com/) account, add the following to your `configuration.yaml` file:
|
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
binary_sensor:
|
binary_sensor:
|
||||||
- platform: ring
|
- platform: ring
|
||||||
username: USERNAME
|
|
||||||
password: PASSWORD
|
|
||||||
monitored_conditions:
|
monitored_conditions:
|
||||||
- ding
|
- ding
|
||||||
- motion
|
- motion
|
||||||
@ -31,8 +27,8 @@ binary_sensor:
|
|||||||
|
|
||||||
Configuration variables:
|
Configuration variables:
|
||||||
|
|
||||||
- **username** (*Required*): The username for accessing your Ring account.
|
|
||||||
- **password** (*Required*): The password for accessing your Ring account.
|
|
||||||
- **monitored_conditions** array (*Required*): Conditions to display in the frontend. The following conditions can be monitored.
|
- **monitored_conditions** array (*Required*): Conditions to display in the frontend. The following conditions can be monitored.
|
||||||
- **ding**: Return a boolean value when the doorbell button was pressed.
|
- **ding**: Return a boolean value when the doorbell button was pressed.
|
||||||
- **motion**: Return a boolean value when the a moviment was detected by the Ring doorbell.
|
- **motion**: Return a boolean value when a moviment was detected by the Ring doorbell.
|
||||||
|
|
||||||
|
Currently only doorbells are supported by this sensor.
|
||||||
|
33
source/_components/ring.markdown
Normal file
33
source/_components/ring.markdown
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
---
|
||||||
|
layout: page
|
||||||
|
title: "Ring"
|
||||||
|
description: "Instructions on how to integrate your Ring.com devices within Home Assistant."
|
||||||
|
date: 2017-04-01 10:00
|
||||||
|
sidebar: true
|
||||||
|
comments: false
|
||||||
|
sharing: true
|
||||||
|
footer: true
|
||||||
|
logo: ring.png
|
||||||
|
ha_category: Hub
|
||||||
|
ha_release: 0.42
|
||||||
|
---
|
||||||
|
|
||||||
|
The `ring` implementation allows you to integrate your [Ring.com](https://ring.com/) devices in Home Assistant.
|
||||||
|
|
||||||
|
Currently only doorbells are supported by this sensor.
|
||||||
|
|
||||||
|
To enable device linked in your [Ring.com](https://ring.com/) account, add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry
|
||||||
|
ring:
|
||||||
|
username: you@example.com
|
||||||
|
password: secret
|
||||||
|
```
|
||||||
|
|
||||||
|
Configuration variables:
|
||||||
|
|
||||||
|
- **username** (*Required*): The username for accessing your Ring account.
|
||||||
|
- **password** (*Required*): The password for accessing your Ring account.
|
||||||
|
|
||||||
|
Finish its configuration by visiting the [Ring binary_sensor page](/components/binary_sensor.ring/) or [Ring sensor page](/components/sensor.ring/).
|
@ -2,7 +2,7 @@
|
|||||||
layout: page
|
layout: page
|
||||||
title: "Ring"
|
title: "Ring"
|
||||||
description: "Instructions on how to integrate your Ring.com devices within Home Assistant."
|
description: "Instructions on how to integrate your Ring.com devices within Home Assistant."
|
||||||
date: 2017-03-05 10:00
|
date: 2017-04-01 10:00
|
||||||
sidebar: true
|
sidebar: true
|
||||||
comments: false
|
comments: false
|
||||||
sharing: true
|
sharing: true
|
||||||
@ -12,20 +12,19 @@ ha_category: Sensor
|
|||||||
ha_release: "0.40"
|
ha_release: "0.40"
|
||||||
---
|
---
|
||||||
|
|
||||||
The `ring` sensor allows you to integrate your [Ring.com](https://ring.com/) devices in Home Assistant.
|
To get your [Ring.com](https://ring.com/) binary sensors working within Home Assistant, please follow the instructions for the general [Ring component](/components/ring).
|
||||||
Currently it supports doorbells and external chimes only.
|
|
||||||
|
|
||||||
To enable device linked in your [Ring.com](https://ring.com/) account, add the following to your `configuration.yaml` file:
|
Once you have enabled the [Ring component](/components/ring), add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
sensor:
|
sensor:
|
||||||
- platform: ring
|
- platform: ring
|
||||||
username: USERNAME
|
|
||||||
password: PASSWORD
|
|
||||||
monitored_conditions:
|
monitored_conditions:
|
||||||
- battery
|
- battery
|
||||||
- last_activity
|
- last_activity
|
||||||
|
- last_ding
|
||||||
|
- last_motion
|
||||||
- volume
|
- volume
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -36,5 +35,9 @@ Configuration variables:
|
|||||||
- **scan_interval** (*Optional*): Defines the update interval of the sensor in seconds. The default is 30 seconds.
|
- **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.
|
- **monitored_conditions** array (*Required*): Conditions to display in the frontend. The following conditions can be monitored.
|
||||||
- **battery**: Return the battery level from device
|
- **battery**: Return the battery level from device
|
||||||
- **last_activity**: Return the timestamp from the last event captured by the Ring doorbell camera
|
- **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.
|
- **volume**: Return the volume level from the device. Currently supported by external chimes and doorbells.
|
||||||
|
|
||||||
|
Currently it supports doorbells and external chimes only.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user