From 10daaa76928100f759e2571038fae6003232f893 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C3=ABl=20Arnauts?= Date: Thu, 29 Jun 2017 10:21:24 +0200 Subject: [PATCH] ComfoConnect climate platform documentation. (#2483) * ComfoConnect climate platform documentation. * Update documentation for rewrite. * Update version * Minor style fixes:wq --- source/_components/fan.comfoconnect.markdown | 56 +++++++++++++++++++ source/images/supported_brands/zehnder.png | Bin 0 -> 9683 bytes 2 files changed, 56 insertions(+) create mode 100644 source/_components/fan.comfoconnect.markdown create mode 100644 source/images/supported_brands/zehnder.png diff --git a/source/_components/fan.comfoconnect.markdown b/source/_components/fan.comfoconnect.markdown new file mode 100644 index 0000000000..3e1d338e6f --- /dev/null +++ b/source/_components/fan.comfoconnect.markdown @@ -0,0 +1,56 @@ +--- +layout: page +title: "Zehnder ComfoAir Q Ventilation" +description: "Instructions how to integrate Zehnder ComfoAir Q350/450/600 ventilation systems into Home Assistant." +date: 2017-06-28 18:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: zehnder.png +ha_category: Fan +ha_release: "0.48" +--- + +The `comfoconnect` component lets you control Zehnder ComfoAir [Q350](http://www.international.zehnder-systems.com/products-and-systems/comfosystems/zehnder-comfoair-q350-st)/[450](http://www.international.zehnder-systems.com/products-and-systems/comfosystems/zehnder-comfoair-q450-st)/[600](http://www.international.zehnder-systems.com/products-and-systems/comfosystems/zehnder-comfoair-q600-st) +ventilation units from Home Assistant. You need a [ComfoConnect LAN C](http://www.zehnder.co.uk/products-and-systems/comfortable-indoor-ventilation/ms-comfoair-q/ideal-control#node-21233) +bridge to connect the unit to your local network. + +There is an official iPhone and Android app to configure and control your unit. This platform connects with the help of +the unofficial [pycomfoconnect](https://github.com/michaelarnauts/comfoconnect) library. + +The component has a fan platform to view and control the ventilation speed, and a sensors platform to read out the outdoor temperature and humidity, the indoor temperature and humidity, and the extract and supply air flow (in m³ per hour). + +To set it up, add the following information to your `configuration.yaml` file: + +```yaml +climate: + - platform: comfoconnect + host: 192.168.1.213 +``` + +Configuration variables: + +- **host** (*Required*): The ip or hostname of the ComfoConnect LAN C bridge. +- **name** (*Optional*): The name of this device as you want to see it in Home Assistant. +- **token** (*Optional*): The token you want to use when registering with the device. This is a random 32 char hexadecimal string. The default value is `00000000000000000000000000000001`. +- **user_agent** (*Optional*): The name you want to supply when registering with the device. The default value is `Home Assistant`. +- **pin** (*Optional*): The pin code to use when registering. This is `0000` by default. You only need to change this if you have changed the factory default pin. + +To register the sensors, add the following to your `configuration.yaml` file: + +```yaml +sensor: + - platform: comfoconnect + resources: + - current_temperature + - current_humidity + - outside_temperature + - outside_humidity + - air_flow_supply + - air_flow_exhaust +``` + +

+Note that it's not possible to have multiple connection to the bridge at the same time. This component will keep the connection open, and if you open the app, it will ask you to disconnect Home Assistant. If you close the app again, Home Assistant will reconnect automatically. +

diff --git a/source/images/supported_brands/zehnder.png b/source/images/supported_brands/zehnder.png new file mode 100644 index 0000000000000000000000000000000000000000..fd910207c1903fb89d56251f8083c0f877a0fbe2 GIT binary patch literal 9683 zcmb`tXH-*L)Gkbs5_;&;dzYeA=^aFRmnI+}hR~}N6Gdr)bdh?bN(~SLNR3n}2~7wI z2Sln!2SF6XyK~<0eLwE6JMOrQ!3yl`Rc3qUGuK)vRu;zeG+Z+Xqkz>q%%tim%u}wa6_kX+aTZY zD9=zI65R(uUOoaw{-HimL7|W^0exHLZ{4jgNk{}pObvAHqKo&IVv2bUQRpKNOJ=gH z8*BnHwGx@Bt(|XS$5wo4v`=M(q*`f(zO!7@Wpy?nwH_SN2U~+Phn^c!Y$5+9+LU93A3Tz3L41YfWt!@|*UEJAnxS}#BlR@M{iV7?r@(6T zwCO6FUN{+JH;;dVLT31n3u)7Cy<~>W3DQjit^ke0PLuy{lH8&erVj0y;P}MX5xi!^ zL2X?*LK^6WGuTQ*+yxD4I*OZx1z$jg(``Y-F*5!sj=y#uQTcUw3uT=({6Fi+iOW;% z;&!0ScqwloDsn_4c>6`@nc%AEgm90tivgFk)PFt8i#2IgZ}nTP!M;R8mDA)M>{8xG zap;8$Au#^v*FtosLcw&B+E#zg@~GEPLKzZX=wZ%}E@B|agubByq&xd+c+}y{$?RjZ1G=oyb1rRP~t7b z62FO9wyVQ#n*b_JE+i`U|7{zd4ccQ6cv}6JzmlnwsXQl+(kij{;ZmKyx##u=u|y`N zoGMDe#CLCiW&LmM?jt6>a0&!Q3O1V1NZUZ#K=zWHot&10QFX<0MG!6N$I&jj0{+xQ zDQGZqOyFG6M_<6($?7>e;sp;mgVlq1gL6X9vcBo&3lNQS z;t=$qMb_EF!p#cFAZRHwsYxd-2; zg`TO{UlXzfrnnak6(f5+Ra!}Vc=6U$1*x6x{ksi5k<^8_n+U=w&UB zqL7^8_$svKKsMlQ2BO`{MK(=M`xKG^3U_CQAV|`$AjMZ{c}O{>^GjO_@4{^K4(;+S znHazdc2#$wOVWAB3*`@+B*&VH)#w;~?FskXJtz4lg~UO1bm9CAM_Ik?DChDlOAfhiPThwP8%TXg*ruF#;^>vXZ~pqJ$oaD+cmkm z)-f^O9P{{|o~n@RaGmIZ%L}64u(ee?nZJ0B9#U&kSKW#}flI$gSTJtY^mH`1zGk-E zPWPYmtnsyxh|sg?EZIXsgIO;*BT1hPR`%iHFCM*}vYX|3p}9mm_YYGb`qW31E;66! zqb<4O-xc?8tBM6#>32IF_xcdM&0quNoVDtLDCG>9ko2V!JlYJY2|dg3e4=8GrSRQi z+(XIV`FA#xxUhg6kSJRkry7T7fbkVMBYjyURqfSvTKG;_2I{@I+5i8RM5#-m=-ji= z3?#|9PsYwwURbwo8vN?%PdXwJ3$^9l`S&CcfeB4d7=R$ze=%w(1}rV>Ojq<-S_j6I z3lha!;1Zh>t7c+QR&3>Hj>Co=v$skTK;ADx9o(Bhf@3FyfIU=7Br_!0h+^dAJRfHy z_vhoKtoW?d1#RU~4So)jv+~W)65Cdq=M%u>K#(4L!e=&@<40Y7&*l(BpjP zi8a%)GKOc((yPUaru!6H*(art7ye6ELEXv+|3sU9>XY=VfQph6`zHRft$8K*S@xk_ zhp*_06atfAEw*E(8PetsHM!ztHutEDfzFf2isnYktg28Tg6iQR&S}^5;wyPWj;sa?y)hJ<2(z zIX%cVl#i?NyG{E_#Rtw8en2i`+YNT zwYb+Hl`RXntJmivLV&@-M<#E{5dD7lFBr3bV+E%g@+@l#sfyj^RsfXYG;C$)bR@4g z;E6O}d5pkV7zWy4AFoh>*WS%aj^X|4xm<~&C*pj`g4u@BGPe{+&l_=KK{3O+U&J&t zBUxxKE%R82bFm)&P6r)AR`%E|PlXYfkQg}!ECY$LJ*Op`R(Yw-%z7HKt9)e)qFWkpHN=Rdn9i}2dwH_f;T9y=X-cEZj%OKzI^+`1zFP= zOz52B&?DlmNQz^!Y)x^z7X0tEgnK8SyO`WN8>e^s1LO{|=&(Fvdn_$_e+=I$dV@BL zoK^3okb6-OiAQ4$;W`>ShOdsFX#F$fNG@&1XRn|x>4&I;+yoHJi`5#-M;q6)=})!u zySEGfd<@SG`$<}5F<}3o>~_xoXww>-P-ZpKmTl`e;KX~LgY(7ta!C0Fk+zZTH)+&m z-Jm?P!MZ#B93<-Xc`oub>7w-kA7KMN-lLqP+-0S9A5^Gy4LnC z<~u(*m84&h`?s3A{KnaQWIRSkUK=qO(%zX6ZwGk%8fNtVuaac+Yen+Rbm6?_RvjZc=6PKb0f5u zpIc4D*``8uV_!^NKfk%sy8A73Bom1CS4V{6YdkI|?{C2wrTzFN!jL#$sb-KMDYstK zdLBFkATX1pNKkC*0olG47MsEpMWlt(&$^Y9tUP=0o)c7B<;6WMn=$Gc0A4<}Yuh># z`mSl%mKl8iD~A#mAM$`72-Q1ku@udk^6kU^ugPUk32|?S)&A%Gg3vREe!@0X$?}gT z0@MDe6zToR<{6Xb7zC;O_Vicuia9z8W)ERld#bp%7-aLe@39mZAa3PJ(a=beNb+Sv zRgAJ{?H6~w*j|dieCO{%+icB@i~tIq%(sI2#d#>Y0^Q5-;fx~dlJL7&O`V9wyWNN#L2@*QpZ%SU%BdZ@{@h zRBT4iX7iB7ZR*Jj#QE<$SV}mcoCl`Qa?3^cvXr>}yRYK~VDF&BSJVfZ1%>10pCmuY zELoU;8zl~~M|5ROCH#4#Ji$xk@kXQw3?Eufm?1_p*fp~992HZ2*UTh4iuuv+ef=IY zt|*qaB2=S~r3^6wL&Xi^ULmTTKLzO9e4SQk}dEYi2Xg?~xbsIk?VDQ?E zB~s9RMpOJ?TxMf8ehkkG7lwD1t|$gq;5OrxFpk7>A-vD2F^=!9iMHbpv5npB#F}M_ ztks9UJ}Zw97%e3XM~RFQ_4H6HL;owLnu1^AK-|1%8sAKu->x@E7DXVK@{QQ%RsF`- z0n6;SiH2nF&!UwY>HaD1;ay;R7q*BS9o#W;f34Ymlj~KkSyUgN>a$O!3 z%Ml4sc)OF_9J?VG)yD2m&_!TFpdlt|AL29Lay z5qIIQ9++{uSptB&1T|VeiaaLpu=~rf`SZZYbCEbB9z^4Rqt!{UhrIy6hk9*YZ9$&n zJS+#2VUN9PI1Rp?1em#Vkr#c!_VR)jKy#m<1oxtA=LQ*Oj$~(|;d+7V0UNt2)=#%R=aoz|CK-;*J<)n)Q#*iQ}IvQ_p)D);;9gru|yOhi0S(Vd&urX*Ad%Z^{TfMSr2^!i=XBrvS!}XX(D%^)PES4RVskHgMZ!Tg?x-<$ z1AR7ze_b?))IOX|^-kH2S)m`p$LujwT4YBL)psjPgEL|*ghb|1Fv&!f&$lnW)cfFM z7>jF*8IILh=cO$<&K)T3e>tYB?-O3}9etpa9o#e1C$+oI`H`#|# zBzppu-I@>XkNs%z&(^xr-Iu8%?e~Snzo98>57YDdP`{pcxuUoyrjoWbqp#iSi)_+O zU-A25w=cW^QVFB(_#u_D>tFX(;57dF`lK_thqmB^1SNoKGKs*nr(x&#JEoX2smhY8@JO1Ps zFTm+jaGN;vDSF=Q&pa4!yZ_J3^N-TGJGC4-#LUNbct7In%ZL0M0VNlu>iK|7Cn9ed z0%Z2$y1pNuo*VR5~#fqu7@*?^9i`|n8n{FI;|-542O1s=OlZ$`hkO`nyW;Xd`4M<7>@~;=~miGFD~+s z+{Rq>H}SZmHCTIY#~+IR+5JV@<#x_*;uJ>P(S30p`6Tmo#6gPwmlFV|WX<>}}5M=vb?DWd&N0 z<-MvgeP4<}M|e0HC_Yn0$cOasedt+UtL`sJF~P5{E9h45-0<7M<)M+f6<;RWp12t) zU6gT<0Eydjm~#Shi*EteJkhG<>FnQZx<%GMKlp?+3SdmB3Vw*p?+{6T8s@_mSMm-5q`T;#|`kLsfJVLi>N)3tzx z;y;cQ-f1Qe9QA|h_L!dIHm&q*2XiFL!bz)H+O(F|P269>+KX*o6|`%`OpVTj`NfQ z<+)LGUB)SM&=fb!<1rL#g-uWxIn@^1#mC#OtL8`Mgx>Oy3i$#~oDF6X8bQ|Me9bm? zJ%nFL3rXfi_b7t|;o;-I4QMLI@MB_!kDpy*hthO&FOV%1Oo{mk39D$ufup5dM!M6Q z^M5&R>{jGaTol$&@4Rcd>i_Gq3P3Zht3GOUKNyj2gWXq|0kC4oy$C__+L1F&IxHtN zvW-{+wq&irgLBWdr8pf8tbU~YWLhyxDhj> z!IZDuc*oV}CqWjR1zui#-7Gh<2i1WLJdEB8H`>XagO|lXvEvr3sJhRzZ#^4~7QW9} zlmWKXnxPoOQ-Qj8>Vh9i18GT)yl&xnb7Z0XDp$w5GLdD^2Q_I|blo48TIgE%gX57R zIr_WoI(uzGnOoc+K~|$FZI~YADqPGhW8;(u&c?nQI)+J^gNr&2qu(Ft-5Rm@A-gi% zP;Td3(XutC<=z)ENZWdwvc^&Iugbj-&T6r=Z<{Rwo*AbQJEljkV5a+q^3L1sLu(Q3CrpX?> zD9n+-mHcy^_A({&vmDixk*X}utmARpFTTp+_^jaY==b=~mLQDxL3M`SA~Jau{Chc{GlCC#jd0PP1TjAkCP3!nz360-4hAuM0i z$ZgH15glPd*e{=Mp(jD2g6)Er_ZMl-HNH|=u~lb^*`Bx-pw$1GQ7GKC7?}R;P;8|1 zH?HlBu&W}D5{g`x6? z&&Ylb$})aa&j*`CzyYxh@?fgLIQnfMAWsB~a=Q!Qtk6GFKGr36QtYW-2Q+?)W zi#x~dDm!y9pQ@Q!*At|W_85LGrOfFc9XQ{{ZW;WG9n(PS`*Sjc+y+m-jXm8f(j*bn z9J5s*~V=2DwSiUUhriCrR8I3vXv$o*mc}R>`dW6*8^_844jD+3IFq^*< z;a7GiEg~Cy_wS`CG#IKH1V>_b>P@;CMMaVT#D-VQOgSm|-k@X+KNpP<;wBhAox)*+qdDVbqZ6mOl<^ zi!%d2YCt63n>3UmOSm>FIfi-ny(nFx_J$m;HOEuM)_f+O{agoGS%lA0HRb4UdOp)y z>ceP|?7gP2_WSrs^ako`VX*AZzhM+1X*;iD9&438%3wYyMim4NSyLeXvK=aK?D~mr zM^+P9g67u|b^0{VOjUxG=A0m1Cdyvc9GeKQIxcz)@L4>64WoE?p%U*xb;yqrZdjN!|< zk5vSgbAIl?8imu@^!X1h0G4cj5KE1~w4Zug~{q!Cov%^>MWyAxQo?(IwLR7tDY~#V)1;kj1#6 zxQ}hjUz4n^w~X7dyKg;r?9yG|_O%`k={>C&>>>@a$MVUUw#V8R0y&$?%DhUHdM9U5 z+V4Oj=I?EVXWKe4WnSK5-5|O%4{6!R)f;~%Rn+gqxePi{npY21Y>(lkkrrI#Y4-WV z?&R9F56^$0BggRSE}RwNVg0fS5jvLRCzC3^wErY#TNVx?UM+rSoOgiSpxa7jr(H<1 z{wI5I2lb2YZP+8WQX!4)tBRqJ&b{+6>-s7Y>8%dgvm9SM%fqmg1-3$Vk7C~ov^T#j zyqVS3{>J@j(QX1YzF5 zQCLoEXs$&(^!m#ZHc>SpDkC>Y*x@=^(Glk|GwH=li1Ns#SAEW@255~?;9Nti86RTo zk<6u{o{WCFU;sIbrqn%vmhf0e3|l`}L${6LV}&xDhmNK!kZ~E1O>o=#(9Bql@5BIY z{UpveE-|F;_MPq=+~zX?%{z5+iBdAp@wUfhA6CYCtcPqF@gZ20H1n5UzjW4#cD`;_ z6Rzc8n#l3aS#znbQ#ZhNx}$sm6$k5wgelI&Lmy}7?%DPA^gV6i2M(EK?#r#RKTdhO z9rMTDPqW}Lbd%`-jb8utm{4FE==%mWz2LIwAdclaYX>Fqd$C1y@}75wo)wy`rO3|O ztYRKL&-Z^{FtUb@tm|{VG0Wp?z#~2COy6ibv}^EI;Ejn>zl2nzXrmH5|8%9|Whg{6ubB3G;vYnWQZB&LaSPx1!m5OcI zTqT{l>ZQGH7l|Z6laNs867K?-%&=MAJbDbZ_@}cc`A=e{%l3A01Ks_GK`r*^pvo44 z;AW1mIB$8f{WZ{>wl{dFi@DFhiGSHnEw(W9?77oX^1g%WkuUvu210(+9{#< zZUlvaFVh`$Et~1{bXNu*uzy2TG*k=dP&t8dFS3WfVy^Kb#8aex)V~ZI@L^ew)B9TC zB-c{+ZX|^DZR}X^6?JiDyX^aK<{y|5xE(S1Gp9PUPNro&51UrlX)tsD@)V<_-)l+x z0+CB4^B7pP54i6D^+8|FrTW(H8}xG4>N)G%=a1dPK;rMcA}AzJ*`6%-Kc7Uj{Tq4$ zkkJa9ffaUn74;$2r|b14ud1n9tk166(6^kEl&IZbgJv`XZ}bM0K2$w?;cW9pb-Wtj zfGJUgK%qlp1STo1xOv>-a_INTDeLav{Qho{@WW(#)pwuG8n?svxEmO|tt(X>_@`!v z&BJebm)U3(;+PLA(6yk^4=hVBIhWcE89#LmcllRY+tuS~(@&CJ5G$u>pq?4%Ru(Sh z0nV4#QEDX};#ac3xt&C)eyd2#i;g6Tdw6rEFub=7S6iE56~KTFCwCVUIsCQ&iyN-H zt;M&@NDxfaF5=qEgngAzIPkLXlV!*WWaV~$+5knS1#JBk9hs=laeK9!7CxJ{TbT8t5~A5ZUQj_@LvT-gpfMNjM5$`4=5l7>{#o37=7G=H94t9L+3V)pv=$~_@At2b zCVYPDzarf=Ls_1IzEXJEoBs5?x46jxY*>&rI2m}DV+VJ?W&TF%*%>n**Z}*b%&8txMdWFywjhZ!$4dtw7XE$C1W8I{n*PLf zz%+&rih&N3iUYgM#ajH^mrrUm{ITK<^a%IWRfW5b7qO+OKHOCDoKZA^24KQ5?$i4)}62x(+cl_NpSYDtDa5#(`G)6g8Teb zn^|Jybx($GCiwuDC9+=QY-;heNO`aAAT6IIsNYt@aUFkT)dQLXzEyB@( zc768SvU*F;%cT9>hQf4BDw!hL==g;BTy6Iz6EI>82rb<lYpr^$nU(%0%AP=h zU0V$^pJQHeHo@8i8cncoMnfI0wNYr11QF5c$f!0|cR}}}cBXj; zKk^etn4e>?4^1OT&?sB_C^ajlhe6(x%X9J@W#TDDGVzg*H2F9