From 881ff0ebd0a50a49003ad9383aed9aecb2605092 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Simon=20St=C3=BCrz?= Date: Wed, 16 Dec 2020 15:08:07 +0100 Subject: [PATCH] Add zigbee philips hue plugin documentation --- zigbeephilipshue/README.md | 59 ++++++++++++++++++++++++++++++++ zigbeephilipshue/meta.json | 15 ++++++++ zigbeephilipshue/philipshue.png | Bin 0 -> 9143 bytes 3 files changed, 74 insertions(+) create mode 100644 zigbeephilipshue/README.md create mode 100644 zigbeephilipshue/meta.json create mode 100644 zigbeephilipshue/philipshue.png diff --git a/zigbeephilipshue/README.md b/zigbeephilipshue/README.md new file mode 100644 index 00000000..3de849ad --- /dev/null +++ b/zigbeephilipshue/README.md @@ -0,0 +1,59 @@ +# Zigbee Philips Hue + +This plugin allows to interact with Philips Hue ZigBee devices using a native ZigBee network controller in nymea. + +## Supported Things + +In order to bring a ZigBee device into the nymea ZigBee network, the network needs to be opened for joining before you perform the device pairing instructions. The joining process can take up to 30 seconds. If the device does not show up, please restart the pairing process. + +### Hue motion sensor + +The [Hue motion sensor](https://www.philips-hue.com/en-us/p/hue-motion-sensor/046677473389) is fully supported. The time period for the present state can be specied in the thing setting. + +**Pairing instructions**: Open the ZigBee network for joining. Press the setup button for 5 seconds until the LED start blinking in different colors. + + + +### Hue outdoor sensor +The [Hue outdoor sensor](https://www.philips-hue.com/en-us/p/hue-outdoor-sensor/046677541736) is fully supported. The time period for the present state can be specied in the thing setting. + + +### Hue dimmer switch + +The [Hue dimmer switch](https://www.philips-hue.com/en-us/p/hue-dimmer-switch/046677473372) is fully supported. + +**Pairing instructions**: Open the ZigBee network for joining. Press the setup button for 5 seconds until the LED start blinking in different colors. + +### Hue lights + +Most of the lights and lamps from Philips Hue should be handled in a generic way by the `nymea-plugin-zigbee-generic-lights` plugin. There are 2 methods for bringing a Hue light / bulb into the nymea ZigBee network. + +1. Use a [Hue dimmer switch](https://www.philips-hue.com/en-us/p/hue-dimmer-switch/046677473372): + + * Open the ZigBee network for for allowing new devices to join the network. + * Switch the lamp off and on again (take the power). + * Take the Hue dimmer switch and press the `On` and the `Off` key at the same time + * Hold the switch close to the lamp while keep pressing both buttons (< 5 cm). + * Keep holding an pressing the buttons until the lamp starts blinking multiple times. + * Once you release the buttons on the switch, the lamp should be resetted and start joining the nymea ZigBee network. + +2. Remove the lamp from an existing Hue Bridge setup. + + * Open the ZigBee network in nymea for allowing new devices to join the network. + * Remove the lamp from the Hue Bridge using the official Hue App or nymea. + * The lamp should now be resetted and start joining the nymea ZigBee network. + +The most reliable way is method 1. + +## Requirements + +* A compatible ZigBee controller and a running ZigBee network in nymea. You can find more information about supported controllers and ZigBee network configurations [here](https://nymea.io/documentation/users/usage/configuration#zigbee). +* Optional: [Hue dimmer switch](https://www.philips-hue.com/en-us/p/hue-dimmer-switch/046677473372) for resetting lights and bringing them into the nymea ZigBee network. + +## Request support for a ZigBee device. + +If your Hardware is not listed and you want to request support for your device, please let us know in the [nymea forum](https://forum.nymea.io/). + +## More + + [Philips hue](http://www2.meethue.com/) diff --git a/zigbeephilipshue/meta.json b/zigbeephilipshue/meta.json new file mode 100644 index 00000000..36ec9a97 --- /dev/null +++ b/zigbeephilipshue/meta.json @@ -0,0 +1,15 @@ +{ + "title": "ZigBee Philips Hue", + "tagline": "Connect and control ZigBee Philips Hue devices native.", + "icon": "philipshue.png", + "stability": "consumer", + "offline": true, + "technologies": [ + "zigbee" + ], + "categories": [ + "light", + "sensor", + "switch" + ] +} diff --git a/zigbeephilipshue/philipshue.png b/zigbeephilipshue/philipshue.png new file mode 100644 index 0000000000000000000000000000000000000000..70dd93b46ba5bede7a6e9b873aa8a9700d071db1 GIT binary patch literal 9143 zcma)hWl$VZ(=L(_B#;D&u*f0-76K&5;vr~o_XUywfdzK4;2PY5JBtK&hh3cD7TkA{ z;O_31_x-BwpIi0SJyp}w=kzl@-A|u0b8047Md>p!AtfOe78bFrjHDVC7B=`l2R`n@ z$gGhP;^FkjOiWP>3#%f6=;qtwhd%ZXwa?;MrGr$PSXj7NDhe7>3g)(0&aGIk%@5K* zSN=b`^B)}77F@T+2Yr{CewT_K%cvF%b!#oKT>cPv=AHRc zKVZ%RsSZ@=PF!i;7A7XO36O?o%GEdtSNOjO%R1BsUZzsMFN(nZQTTwADE7m4s6Do# zJrAXNAm_1j{w^c^W+lyuGi_QM|7;DzsSh=McJhbPh(itFMGoZyv5bXDeC5HPtK8_a z5d*a>`{HzcwJbrMVwr!yHBIj&syx5eoBSuKVCthBsyz|<;uh|gu^AJ{w|K5ajScK) zfz*2AKyLiA;|y8iU%57cUkCn>F9Sk=+A!s%P8a81*6)9!#hPn zIz{R85tn6e9X%y zqd<8eYf0Qg)y|`+@LcnN*(q;}k{<|6XctUs7euu3pSsh~WTc*#QNE7<{Se8gN}s2` zIS;u=R=FQL&=Pv(iB)-Vltk@UP-&v9=4$B2P)ss4&VaPEJt6up^(N`9e21n$Y`cQh zD&WIBc^Q+TRAYZsK}8;waq2_UTL(H&2e#I~+n1uRZhHT|Ec~f=4zyAK@GJ085BSKw zprn~Aw}to661dAvzg0og(7>^;K!0Qf#Ih;Eu_-#X0WQB>%zRiFS@vp5>R7W%JJ{W? zNS~fjE#p0+UMXzQBKh!C;6;_OSi|i#Ddo|?J}YJF5m}=Up;33M5d6jwuXjIH6bA4m zJ`mYIXqgH9!Ee)_UO72+2+LF3W4D!VMO;pT)z|lh>c97%MCdNoG8NPwL~n;p9fWuU z7oCE3u+Gcb|NIMT4#ZGS4=f9744-G7!v5K6Sf`bGb%pF-K%ikyjSm$keEV)u`z^b- z8>aREEG*hwSxGSsXY@{ra?tD~bvJJo-<7fDTPY#kA^UlgoWi!}-kLrq?uaZ|+xZcZO!4pEO@Jr+e-Xy=#9U?0;+6GNg~v)@v1Y;}v!1SDeMf z$oViWrE_zJ+5Ge;1tH} z6ySgh>^{CAh96}Ai?2a%&ao?A&_eT<+Hl%#^oUwFQfpOk)8bfjph8;O+*Ne}ns1!< zG1BFVtF-qB#+?Fd)-e)+!R^|oA=_8R^9$AdlQUw!J#P>-WWY~z(&9ttcfS1tivwQ*U8P(iGBIt@l&OQfQ$lryMJO zO}U-QjZne%lHrn~XTi(0FQcW&+Plj!|A@$U`nB3RWOwxPS1oE=GuHl&x3@?0J~xsY zv)H){?$Aub$CU&7*Q!R(IABC#Z1i=RX=PGi9Zl+$FP>L^rx1<{vzO2T%Xan-BpKus z%>^wFC$r+Ubs2z*WAd!6mY?3Z@obSUf{*<2VTzT%B4ILQy-T0ny?t&W98r(`zHjGS zrJa?Ne3sh2LL#!0y~3z%0fWWRBN^&Z@(zLzRt!YIS!rrZauEMU_M;t2!UlGLa;@nA zqehhj-$3p(wR(h7s|)K9OmK}%;l(RVGCv4OVFR&)2?b$to%{fFb1D$0IgN>ORtiUq zMr{WBz&5y1#|m-v8@Zs|Kscz<3Xdev|A@LgEngLwleQoAZD1EcE;jDIIWxWVR_RA7 zrOP`Z5|&+h(_U+W6cgz}g?JxO}UvlhQ|QnR>kdx`}NhpL5}<2hoeTj#|Z}oLTp} ziEK8D!%$ib3qh_j<%hOpibFA=zkVk5RwAkIaJB}cjp>Z4yo9R!4@5s+rOPXLctO|x zYF|GYCV98Xm2Zpi7VMDAASkEYv`0jp|L~b-Qk!#RmcC!Nwz@JJa=%Drg zOy{ouz%Ys$_ZCWt=Gf&cpqNbhrRxXYewUbV=H$?TwO<+`XdNgu>=9H_B&%V!H};08 zLyDvPkDufL7^V{ze=71_wQ1h^{6q|NCch#C&=`=wgZ!X?=$q}b9pf#9RPv38%?5Ot zv^>jAeaVje;4&vY1@Dv;7Og0o)->On?gI8rD8dVj0a>cYE|VP^2<8YF3_m_2TGDBcB@ z>;?x0@8)nXzQP|YD3@R_d;y9 zi8Cg6f4$|zF|Lbuu-1413XaisHBzqmG&4qwK zn-OWtezf^DFxUw)sj+3$0UmEZl&{8*lP@5{C{Fy{2b=J1iivO8Z;aVss(!%@T$wNg z>@ixS+K==m8Y_s+HF&SbVgomkb;bzUF!ErcC}Ax%2g{zzS*G#L$Jb46I$hHN^%Slk zjX5A*G_I!d2yx(fA!8?!WS>I3g^V~!7dib>*ql+rt(rhT9zE3xd;0FJE}wzCEn=P{ zfp-AODwsP((ka;fFhi>F4BgO8QKaT1NN^?uqtFm%BH+ZxSoZd->Qv_<4_Oum#;L%J zQ2T^H`l4RkGuY_jfUXOyJuYP%WIQT6^?n&#OP7J+HWG^IcZ`{Pi7t>Fi4G1EE3H+& z*N^LH&B)5!rZI%ISIz11^Z~z_0mTu?lvBC}ZsD4ja&a5-e(y%!JWo&|rZt?8AE(L* zA9Y+w`yn^7@e)0o==2Of3Z>wG8z&bflj&4`i@OvAL*vq&p26K^xo z7{NltY$uO*C>LNO1UfHJ#B9i4Jr;ddI@PsGa`~+Fq2w63CX2z6Gm<6;78K?rI!B6D zQJ2xA*A79?AqNAn)_{5UgQ9t>3tri<*oM{)$lEt^KFiUl*r|Ni84G#&Yy_@bF+kB9 z%LR=%x0y&YCDiy42`hWc&Kyw?3$E6u<&#Ss7BRCrQftd%c@|oyXfE6`9T5CWtvYw$ zjeQXp=X;htx^fE<$2AO3KKYCibxfx0CQHe^W#{a}qj*N-h|@=E&%ADMrBUY~Od)Q7mxe(U#;*+GWn3Je=e4Hcv-EiJxGKn~}+q$o%Id5DpUg|FM+ZSW<8ME+cFPAj8;@i{XoUW=Y zZfPmlKmT~%GKtg+ng8|I;&nWqe%LMd6CCAeGkUqD%YR(ouEOY<|AvI60aYn-sTsto zwAAd|2448+`O>PDCh__SZXf-&ikOft;&K^`8##F%^34~FDw%cj* z)P8rOya;)-$p38{^Z(i|_I$J=s02KT?OB-6QT?>kBCcCIPk{O_kV$u#)S?mLpGRAbkfshd;LMvR97z`4? z2kODI@}0)BR2|5y2iMu zh`Fr9-3k0Gli2&q`9GJ8;1L!vB!D zaj(9(9{y1#A!xZhgfN#HHrj7a5F~Ikd!1T~@?9!@n<1SI&_WHS%()!jwFjQ>i#Fav zk4`T}{E39h3@(>@+xWbWK6~9A#A$n;p7tPfmoE-7l>T z2s!P|HvKr?oAdJeu(+zd;CwF`_t{_2ycnZ3FHlu=yxSgVt)zkYSFqN5w$aO{oTkt3 zwVGSq2qvK`ort;lsZ(jP{?bLn~j~M}AKdtuSinjS`D>n~4 z5Nw)e(F{9pu65d<_cHWc&Rh4xts^dhrOvq={A)#}S$!m%5vCFKyjkhxqq$$+gBd6H zjq)q~?ft4FM8M_O@hlRbL1~6Z(Sy^6Y?$|GsrL0Jv3VbU%2_?W5W3>$i~)as2Zfdv zseg_MV=sLgq*z6&^842>7Hmm58R=y6=ez)%oyeyIeR~4yY1e8i$n!L%hOTv=^p%%) zx2g9((tf0kL3Hxj66jLS8fTtZKj8A%+Q0u{Hvz+x3}1{BCc|dO`hiwAU)(_>!P%8Kh;3=Oo>ID2^o-;YQ{ z3aOw-XR@iMbJCNyc1%ndsu#tsPCm90k4zFS&o>pjdJ&>O>5bknl7?mMisGQ>3850I z`7z+7>h-Q}#9u|lAf#Cl19X=Cjx$04P3hEkQau}^9uMkC{)yZtfS;#A+bicn>(Vl! zw&AT46vzDd@Rp#lvs`%tp!x3r7=V@!f#}MBm2s5b`2-*}uia>WRF@FPA7@?ix`uuy z>;sQ(uE6)l&XS{u37rPM7&0}bycT-)t-VlS?CiKqX&z70xBiV~j!9SK0@-vVswB5B zr)cuGm>d*R6zi*3FhBZ@u25vDDJ%*OLgPJoQkFuTAc4r_cl0DJ>T-je4b99*@`i(@ zQGC|*^%gDBjDYchS-$z7cpzdpR$td}fZC?srg~&~?M65WQT9M(5OS_zME{kd%M|Ak zm~r;RrcW9;g9)-Iwwlo{W7;ImDjXXdBP$9aDt&pkwF0+(JvZw{!2poJaQBJzjZQj$ zCV_wBrKZ*a7o+hdFu@*q956W!@f?a9l7;$Bbj9iR<4Q3!US6Ix2QDdhL8hQ1>EkT) z#8Ss{IhDAwb-+T%zsMj912MY8hnx1oKegTY{&JFm+=>%M3YcgTPDnCp+$(p; zobFq`tBZra%F8?EVl)};{~Tm-Oc5NF8A0>}m{~X+3^qOvcz#};L;xRhmxg@QAnxxP zMG{4?9l0C=Z(vV9V{E*m~R5^Zu4m_PF!Q8<;K*kCudtSuet! z=b8MGrX<^OJLPleaa}vzUKCcGIu&A+e78 z6!qe1NYk+lyYuP~N#lIS$ldmG!pNadso_m#NsUu^0d1Y$k6p>4bNCRA9%61vVvK`xWI}> zw}K_z@oe0IY620+5_@FCvJB>O?EZ!sSv-^}u( ze=!x2{0~$v(OIUkBrk8>B=IHz;^LnJcLeWqAG!cC*^zpa4Ww%QqozKpfF(q-1`fQB zvY4_rdxSNF8nAjQ7LJ^e3xhIA8S}`lbwAyhX2l+yEe>ps{s$*+J^*8VLpWcMWx)UW z1gyd3n%hR!WDZ{y$%4KfAG2|4{Fq;}>*^ns{?gZewwFv~4T!mQ z5&87lL}K1_?)U8{uFbTOCn|j65c3zQ7M_cIc?9sP@a;SLB=WYihULodp=#Vo4k4j5mNdBwR(gByTVw6BB z=c^=C*j!Mo*LuI(<7(ZkY!kJzAm;ZA(&a=PunP!T~Sxy)f$0|2tlscfdA3!JiN zO~iv}esn7% zB(hvMR_+bDv`hz$VWl_Ud-}ay=)E-C36eM(dR&U~7Rk!eXQJ*qIhO?U*cvw}zPDY* z+Z45$OKuQjLr^AU*Ty?30@_Njm(~od8#?;Vp1)Pg$*X>0?Z&KQ7y7iZVi}L{!n*SX z`#|cLrTXP|V?GR>0*9qw9QW9gwL=zyjdllXSma*zX8eta(9V#jNH_1E?;6i$)*P(R ztZ`5^`7O_Q7u5Gi*c#%T(A|&cLw|{%DK`-k)DwyCoEo6*N3`fGQO)90(@IBY-|au2jflHnrXsmgWYwO zRVmqNX5L^Nb?tK^9AhenOtnkq@&3yJ!gN1>%grAN-B@aZL-V`4cr6Z7mm(geE-7Cw zQ~5Ay>cq@A)H&}W>A1B6!9H; zy`yhp@aH0g!Q27-mSg1oyrIf zhKtUr;9;ae&$$Tqb@zIB)9=Ku4icn3Lxa4tAuN7}0A*b)9ZfB5 zGc)yqKNuLhFx-_$aL_ihij1~hY8jU9I<}vzt z7xlxPe{AocvF}yZ6OTiA2<`j)jW*sn9G@qE3ci!=ysZVT?z>hh$ZCDE;+~7$){i}M z#D+7+8J4Sg!*+MmdZe{F=Sop7)ynnKHXN<~FgG3a0q`^)wu6gUYgB~91g?|baqP@F z&_S$lTINmJPM^@S!YwKj{zW6x-PFOJBhTM0_BdI1Z0RW_@6k)eRV3; z?_-*l=a+bkSvI^YZVdh2SI)I)=p(m0AhzWV3qqQX3opxoPhQ}fma<1mg9rGUqM^7U z3ax}P{n%xrrthoWcHm42l}UAD{bd|?VN7qSb}5FDgSTf~>W~TNDU6j%ENNnD(S41R z!w1FGZx{ORQPNWeVNo_COv6Erey=}QN&~^$(706ryaZR zUpFndc=pJ!@5Rnoc^x_n6obI@snO~XwF13OB-}_9 zCzowS*j&~1iV0XHx4TBFNE-4)IQh2=W59Gun72cK(lmQyHi1bt zJd3;2AKHGEx8VV3h4j2*U{^4X@HZA#W)*{PwOc0=idJehgSkZtrU~#X7>siR)2%SBSI=Lrrlqu<*x#edYl5i|P^gx_Z=O;dD5Wd@Z#QtU7NNI;2jmMPfRLLkWP#;lgxDUGq{Ow*;64L--wo zM?uqjsz_pvv9C}Mks-P^fXcH|=_wg>y`AFGINr$8qSJV?CrV{5Gx`|w(<1O&_mj<& z>?Ktk2Q66)SPj12-*37IBtp4Ou}ro(@@fv!8Nd(B_~I1QIJ`GsZrH`k?H1x{gi&Oj znr$ibE(S?%3`LDDVO}1zQbfNPC0oWo3~28fF|Cm=U(ya9w*_Th*vhq^yvX;b>C*tIs+MGoO0( z-oT=P8w_R&M&g?GKv+6B)O?VgokgiufnLs>rR{X@>O2D*oE(f9>R-HFeR+%yJ|C#r zi>HY>QtA<@QeLX3P_JunkY4{JZ{7@+&l%l5WsPH%w}ciqeH>NSKRcjH1t~F2i(aiO ze3a3S1@^{7zwlV#&jZKv1?3cJ3keC$9n{s=W8VXzH7>g=T{^+&9;KL9^3HP=m&c@O z6BBQQ1O-zDY4WPF>SlEGZ_e0fN-myg!G}=lkS!xMkVX5?QqDFMyg!uDTAo}hUQ0_$ zTT5FOEi;)J$=heyF@se8PA**7C;#xDqg-G$sRxsql;n~MbV^XgnBSgR_*Tzp{GsG$ z+AS5{rw~|cbg_uyDB~_>=TPk^c@A{J{9axAuG6kycZKQ%)Mkd3N?K$UeKkdb@76KM zD``6At9?2t_NU=Bx1CZ1>x@k+pS%nsRUnb-fOg6OfHJ&E;_pPq z_{fH|CdY9OHqF0+-O9i3310UV8JGmz8k-v8h>Wky^!tqomtc$B`r3%ctR57#9mbG{6AoH~YQ~Tod5+bqwQNbL-)D;=1%k za-B^VU4GHe5crnS1oE>dfiRW@y#LSP<9y`) z=2nK8LJ3;IXOqfnJc7p*u5OOqTzV6%hRH}x4GOb@&k)c?u;X3N30k3%DZfrb-PKJWJjC zm}>2^GfGMp`>kfAmMKFQU{$I{q3Vz_%!gvxgH%OL?4pUQ&F@s|;kN;!*m)JDsc#m$ zi+t!_n%n9gZ}gnH$LVFW$}}C{jHJqjF+H|O?ab`Q4&e~BIu!bAg(`^&!0et~vM1jL zhh}11aV7C=t%Q^;=2?X5;o+rFOEY|sdh#)Jv3+`Wj9X0=lm8ZJzSOkQo4L>UY%jJ2 z_p%KksIUFIAJhZ-O%kdk}NBwBv~r{)#v{J&2!!l literal 0 HcmV?d00001