From 7d21bc6e40700b9207470394770c4602d7809e30 Mon Sep 17 00:00:00 2001 From: Marcelo Moreira de Mello Date: Mon, 6 Mar 2017 03:38:02 -0500 Subject: [PATCH] Added initial documentation to Ring.com sensor (#2203) --- source/_components/sensor.ring.markdown | 40 ++++++++++++++++++++++++ source/images/supported_brands/ring.png | Bin 0 -> 43514 bytes 2 files changed, 40 insertions(+) create mode 100644 source/_components/sensor.ring.markdown create mode 100644 source/images/supported_brands/ring.png diff --git a/source/_components/sensor.ring.markdown b/source/_components/sensor.ring.markdown new file mode 100644 index 00000000000..72fb85e57e8 --- /dev/null +++ b/source/_components/sensor.ring.markdown @@ -0,0 +1,40 @@ +--- +layout: page +title: "Ring" +description: "Instructions on how to integrate your Ring.com devices within Home Assistant." +date: 2017-03-05 10:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: ring.png +ha_category: Sensor +ha_release: 0.40 +--- + +The `ring` sensor allows you to integrate your [Ring.com](https://ring.com/) devices in Home Assistant. +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: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: ring + username: USERNAME + password: PASSWORD + monitored_conditions: + - battery + - last_activity + - 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 by the Ring doorbell camera + - **volume**: Return the volume level from the device. Currently supported by external chimes and doorbells. diff --git a/source/images/supported_brands/ring.png b/source/images/supported_brands/ring.png new file mode 100644 index 0000000000000000000000000000000000000000..f4be1a4c709fb83e7c7e7ce51ab6b8b0013ae667 GIT binary patch literal 43514 zcmeFZXJ6CJ_B|XTNRuK8s8p#UO{GakQIL*Q>7ex9dlDl8DpCaLgd);=?*v2y=}4~u zDWSK}5>oDX{=e(;JiK4Pc|^!3-^}biYpuO!&z`*3)mEjUxnJ<$UINQo~m z0VpmL|1>u<(h&cU_~@xV29yu6ZUO*G0JSHN3<61Z7ARZU?1B^zLOlH6ymqBD;&o({ z5OUUyYJ38uOgGzJ{B1;VpPn#vD@kk~&l4%rsB$j*ZR+O2JXv|8j>Ih|`$j{tP(3dv zC&k;HGXl$%__y<`i$3casG*E~v}dCOsg?7{jv3HOel&|} zfk(Ta?bv`B*7TOhQpGo6UI!( zdXq4+wLRHxzdFu6`I#a4;olH=tWGrBxVn#5X-ON3E+`A0*w{F4@!=(;^2UFRjfKd* zfA3HZMt}22zLAyk_pxzaP7>YZuig~&(?(13%!8?l4zXiCh6D%Ki%0J(eoU>t0f;v3 ztwn~`f8Y52D1 zlrgfkVd-AD%HJnnL91er;@m`k`Eyq8hlomB4^7urNNz5{i&d&~nglvGLTDfEnt9AU zs%w4v_pw8u3P8M_((tvCG%%#?th&v9I2E1fD-@Y@&5-<)D?6mCu0n2Am~Fs`=`WzV zscw+yx{gtNRO%wt#{Jrnu5rM-tkB^FPpd|yhGlon2o*NMoaTQYkY$VmObf))QPQWB zc95V>agLWq6~WbG$qE)CmVvX_vGNz@!5P1~|IIt@nUE9!G>!UvNhvh%+}p2!pTt*H zjmBy|e59<{8%|Qe#(_9L*tYaKKcOjmQ~4LA*vB0dudQ^?$w`1PiUC5$8g-9~Dq`wq zYu<3el}(aY++&J~4|z2-JcJIf{v&NWdP+d+` zr2X+uC6*&Q>hCiD!b!xB3`+bDMl~S2`+-?v*B`<*c>?>-dMzxs+W$2}_w8#^rK^LS z6u`l2(-$DCxmT{fJ8Xkdp<7pDV`6rs9DH}Q^s~lT|7uL%)i}VN0^ui*v!4US@`pi& zz{Q5=j{>gl5Q#>ZJHrwDvP3@I6Z}gH=pW7ajQB<=Zm=}2;m^Xta?uu{f-srR<*v!s z%0iRF23+RU{(40i$N;FjclT|_0R_=7ERn1A zkk}iUw>+%I4ig$6JuZJIp+z4DaC|KI{*%%pAaO~+ZP}g}j=qhJ=cq+ObQlJ1t-X@V{*TEJ|cMnB{#O(Vkp#=IaAW%Bhl| zN#)D8UWZ@%2WIpsUtW`TT<_G>woV~aQT@RSs4oTNa;KYIK_x$0_-B4J*NLvN&ZSK4 z=pa>5rDdJ2rZyuA{|1hlTJ7P#vm^B<8d0gw&cVQ0S=VviyU|t;mLDJt!2qW>)-ffr z|2ReoMalz6o3iKPyLSV6W-jjFYim1e&1Csok5^gUmGS<+9MBXZhKQTTjP&s zT0BmEDXR7$AOAah&c8^wqHDdv<}yj^dDtx+>>Fxp;q{2}-M={K&?b)Q|7L|7NV><= zxLg<8B8+T9D#pqZjdtgK^jCV+h-Iko zNFkD_gC|b&@#_vI=;){I7uatvC8+-kO$
AAd5?8qkjp$eDUpjS7+pRZT#Co@F- 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 Nc)I$ztaD0e0su7+eK!CA literal 0 HcmV?d00001