From efd37b4e47005f5398bacb23b3bbdbed73b94ff5 Mon Sep 17 00:00:00 2001 From: Rudd-O Date: Tue, 8 Aug 2023 00:32:38 +0000 Subject: [PATCH] Documentation for KMeterISO component (#3095) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/sensor/kmeteriso.rst | 48 ++++++++++++++++++++++++++++++++ images/kmeteriso.jpg | Bin 0 -> 20159 bytes index.rst | 1 + 3 files changed, 49 insertions(+) create mode 100644 components/sensor/kmeteriso.rst create mode 100644 images/kmeteriso.jpg diff --git a/components/sensor/kmeteriso.rst b/components/sensor/kmeteriso.rst new file mode 100644 index 000000000..c8aa46dfc --- /dev/null +++ b/components/sensor/kmeteriso.rst @@ -0,0 +1,48 @@ +M5Stack KMeterISO I2C K-Type probe temperature sensor +===================================================== + +.. seo:: + :description: Instructions for setting up KMeterISO temperature sensors + :image: kmeteriso.jpg + :keywords: BME280 + +The ``kmeteriso`` sensor platform allows you to use your KMeterISO +(`product `__, +`M5Stack`_) K-Type thermocouple temperature sensor with ESPHome. +The :ref:`I²C ` is required to be set up in your configuration +for this sensor to work. + +.. figure:: ../../images/kmeteriso.jpg + :align: center + :width: 50.0% + + M5Stack KMeterISO temperature sensor. + +.. _M5Stack: https://docs.m5stack.com/en/unit/KMeterISO%20Unit + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: kmeteriso + temperature: + name: Temperature + internal_temperature: + name: Internal temperature + +Configuration variables: +------------------------ + +- **temperature** (*Optional*): The information for the temperature sensor. All options from :ref:`Sensor `. +- **internal_temperature** (*Optional*): The information for the temperature sensor inside the probe. All options from :ref:`Sensor `. +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the + sensor. Defaults to ``5s``. + +See Also +-------- + +- :ref:`sensor-filters` +- :doc:`absolute_humidity` +- :apiref:`kmeteriso/kmeteriso.h` +- `M5Stack Unit code `__ by `M5Stack `__ +- :ghedit:`Edit` diff --git a/images/kmeteriso.jpg b/images/kmeteriso.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5db95eaf80301d62f4fee488669249cd96a60679 GIT binary patch literal 20159 zcmeIZbzB|G(kMDO1b2spySux)yR(qs?g^40!AWq3;O-FI-7UBTO(20lkR-rekiGXg z_ulV*_xIlW^POgfsqT`luBo2x>hAUM@nIXlP?S}W1)!jy0CUJ6@UR0VDdTHz0{{vN zi~u44KyEZBXh0AGIYVwNC>Q_=@_f9Bpx~aKr4X3-FSr&0)Bi;S4S_izyr__8E9B;c zz&McS5ahOxfPLa!g}{$VN>fHcTTN3CWNXdx+!bsK^5$S=2hn?Z*gM;T6cpt^is~|Q zAa8zl24;|(mxZIfryocJ#K-gOQRyd1e?R3ERMbJ7tQ_pDT-=a4**Uoc+4%&yI6xd6 zf}A{poE!i&5T1kpNI>{*9(nWr)gnmtpY;D;qlX=oX**9(S3x#5XAf2jYZpr}tCfor zo3Di{8>CfifUuaatA&*V*b`(4wzYQ_q5Rg~O$oBM7NOMRQDIkcl>*z@%lo^7wft4J zt^6IV1gt5=L_xy7g1%0!PGC<9kgt=YvxlIs2<4M-K?wX<%ti@%BJp$(q11;MLCVD) z4B}?xW@TrAyi#vYN{9@1Ya2mLY1zLdKyo6Kf2r!@d2%f=xfAi&1X$;Qda z0-<2>@N@RG@MUrKp!!>aG}yz+-QLyH-o+X8DAB^w#miHK5>o#k#hhGKRQ?hCU)sRQ z=~3G!Y7b8tZwT{$XE6_LKUXlDCfLKp%iRhr;|+H9r23oP+Ug%(S1)(Rrv_MCv4I`I zP7pE=h{ZYnsp`=;{-J(su&uq5>k|jWvj0#);D3nzOXVM{hO|&n+QrK2u@VJo5z0qN zg4Qlp_SS+=ARjlU1vk3|n1#mzY{A0K$;r)PX>G;FVq?wAZ^gwUz-`58@wXfWXAe&c zXDjfd9EfCAdx#KAes*>U9Xkt{kBgm!n}eU5g`eAkn}vs+*UC!3hL@9zkNaB-uE_hcq^c0qQCUXZp5s<>F&+xY$8NFRIA)2oxW_kdLE z_g9b50=xYMIogAs{87-t>e0JJC_OB^!Pb<26WNW5vQ}Ex-e|WCvT=@bmr6@8M$O>0{vzmav8R5yS!zFM9fT zf#{#C%kVdyj~)2YbPyY`u=BBSar|uq?!Ron2GO7Gu`B**3fuqM$|u~vb=$wmA>V>W z@SjhMDCj@wKNk3p1^#1!|5)HZ7Wj_^{{Lrze+4ICXUI&)2NHTb>_XQnNJ*KgYpTgA zD9b>iMF4=#bF^~ufE5P-CudK0O*u)BzJVbK;SfLo$N^-40Kl@a@^F<<&>70)KogxBLU2Ji@k5@MEwF;J9mRNu1N{^8;3fNgk3-Y9f+$4Y;pa7@<>Hr9^1iS!yz!C5SSRhYl zNQnoa3BgPLANYx$_|+j?mJlv`zzV`44Y&YKfW;F(@c0fOG?4T!+j`h=aXuA6p-2J% z+~&i>1q}coyaj-}golS;`410w1polE4gfvQ|KfMa0|5RXkn)6ol~Lyc0QxHcXdd`i znPn;fv_t>^!HTPeyTwyIFp&SyHjpKR?A;G~R;h-X; z;`~2O5BGrZ|A(c7J^&LDiW!O-1_~2^#)N{wgnAf&m;wrbf_v z1OW~6KVhL@p<&?Q5gt|n6c`8+0|o=q5q`e^hx@+ItLofweP-aTXj_d4Om98t5C#-3Q4;m}hhtDxx9k@i(cmXaL{HxE zA#H(PBx>5rGBCz>wYaU+@5`t{qoovvd_EbsmqLbI-d~b9KPEqsL*ekuB;geW9u#W? z;Vb#N>pJh zmO%q@{Mq!=xhIZ7>s2-H_w*2>=ISn#sqRq4{FU6F1Q1ALbSNb79N{dda3a;h_DSQ7TdXQ@DkNF)rtVRP1;;74j43iyt-Bv^YzGS4<#ViL_E{%fAg z0}kokT)Aw17*n@-MW?B4)4z!EMlh{6Gp#+Gy|>c8PX`3(X=YgrP=AS-dEKK8qi?_! z(-+*~|D=Ou0_Xd9eDa7Pfg%KXKHCM^BV2lI9B9g<%LGQVCkj+Ics5DRz;CQJL8^)| z*yfJC>golQAHVLcKL84gRj%M>Ms4U@^(WfdL>T7eoET1eIV3`EE=dM#d*K%~R@sY} zg8p|5Ia9VypM8(XRxd^H-vmF=M<;%=QH)HVL_DSwl1L-yz@BmUG-k!)~y>XA>7Hrlu4{`}|L z!o6z3LGdSgDD$usmE$f(DEZ-J&C9^Ph|2wT*U70avgrA$-^iIf-c`S=6CD!M0-mTL zBioXprl@OHHWurJ&;v@3_>6qbtAkaAQu|KSCj6KP9{gb@5D@W+Fx>DH+f7 z<=u4IC%$%`O)jWE=7WgCOyc$DrCk_j?c*w6kgPGP@D#qcfJ|ckPSU7^M=Qi()Pyz~ z|L_2Sa6+NJ<4z+l*2lj-dVk2(=W{ITQvQwZZz%|n!GQ$>fD8su(D2YuuutPK00RXL z3kSesVqqg-;81XgQ?i3_sW{cSB+Mbh1tMe^fr5j60LFzQ2e|vbBhlM<9qRpr^XC(z z=_j#rcu%3Vz-$?OnjkFmtArZS1}V#Tk8YooA~z!8`)=4uFP zbo#iyGq#XYjK{o@+TM*5vR>!lI8tD}EG^S=rvIL(F&Zg-_$B2zkKr{{v3|QyjV?!g zV#phIUhv1@8Z9Lc%&MV=l*tV{;=W-rW-I4|R==wdw86)+jTW(-B;`=YC3(Ijuf{ZdLG* zFnu<;nX+lfHvjU5Yoj953(H`z$Qm5RVoIPLz_}rED%WH*b9|=xo(zUhR&;roWm+v0{XKAY+ zbjckwm5g(>Z()oa=@V>X-5+o~IDj88&tnE3&Vm9n&yXL(|VLCA=m=Y_R08VO)2j*%uCkQ_bN zC)HwRduqZ;@8Cft+>F3dD_xUX%0cYH_s#P+=2AHys!91pWPR@DWGOH=olKLF5~41d z^KFIqJm}XuIn#%cJQ`(6N9zwx+KlwD7Jx)}dK;Nb_li<$eU>1U=LfB6?}rK_59|6~ z^2hh4PFCyEE5CA?sg3yP&MK2Q)A6Hzj-fzb&aS$&yGXR^S(3Maj$vuR_Qx>$sD<)Q z#j#JqUMA0wgI}1c7$g7wc>fwxJ?hu`g1d5Lo&4fR#Ey4RPz#3v&H#^Y$ztN}GcLC; z{bpy-SBhATpXBcv#t=%8c9S@7k$hif5CXMy;XULXefHt59~d-Nu+;dU&-w_DKLCWn z`Qx5?u}8A+I(bU8B~I)OFd33b zTuOpDym)0x=1Tk1HbA7re>q2aZghwbnBr8P>7RT%5YBI}JgRdgD6F7;yW?~+Vg$`L zlZ!-Mhih0#Cpj#LTY~Ns7%AEqz!fK)&OL$Oo=hCMRL9HmmB+kjqG6?y_0qP5MmCl) zoFwB84XrL;|D7aYdr|T8TuT*-_I>h19LeF@JJCaLJJOfWy{k^7D+Z=)<63>#>PTf|(oDY!$X7kRd9 zj#g+k@F@T{?jFk)n$|Ig+AD@=aA*TYW>JPxCchnS?G)t5D|j8g#J68o_*#yfI<=9Z z0khQze%~ZIRNMIQy4>UKPNiO9J$26O0E|;@-D;5|?vE`;i#@eYSJMcp3z-3A+DmqA z4&a*Q92}F>0XhdFIPc~yfo-k9B-2#>H*FfI;L+QG0kch63Sw5y0Y+A-)#zj1P&+%w3?;?22kb03}X@QpmKkABv8_%C5?!wdmo_!e@ zd78i(HTxzyVc*L(%3pGQ(B1XJQcsZc>WhOLzKrSDnw48RN@z)9M~9y$Ba^~QciO6V zEEVKh2FOvBIAzFRx9~keZC9lKwr!cCJS$rZ$YD#{{K;^2tCGW8C^qhw5 zf`Y5ZQ*N$MD;` z+JnWvku(ip$klB znRopx5TKLP|N8tq%$vh4^b!96NR~}um9ptB*0u7VkpEJHjK3V102Cx3g@%JdfcrBp zKL%^Cm=thW9O4of*f^BxZt%DuDozaxO>@`a-ls7b63mG~Jpfjxo|O0Rx1olOKW?6c z#P?n*N4A=n#C&3y_GlCLO6a?tT0*YkIysH|{Q9VDjXY)Pdy@&zf*PycRn0!n>vfi@ zc!mr7^H+jHwXHkqceyEfo2GcVa5%7oXvTQO*Uc<3olBWC($k`TP3?@W1u2x&IykdZ z469#WIiK*oKE8JEq?gUSQjKgfYtfQ;udVyxv|rov-3O}yN8Jx8Y)+Y&$ znq9xrLyifkJKMa3h0 z?h{}s$h4F0Ss*&pyN|!xTwq?Q{0z?|E`9&ubVo~-jCC<38RtcQbN!p-#FFm%9HmSO zLT|lBSYtIkoXlsAJ$c(YeO^K&KDgeERE#O66S@xWd&g|cJcAvy+6K=OI>lAX^yp{= zmU?b@YjbpoF#W_}XWL&9Au!BgpUEH&v&!6M-qm=asHQJL$rW>>`m>&`9hnE&}t9jN!jv?x@?~PFs&e|5=`4 zv%sN-6mlhEx34i%cX~mRu~F5aWzez0@6;pn%UwstqB9gMRq*0V#ck#0Vg*M?>X*_A zQsibbY?TK<4LPQa+&#NPaNmimBNV&zmw_}*j1viq;k|sfvE+P(H#x&0B615mR80)sl@;Uv)?SNHIu*7v1Jxjj2MP=R2<)u+necJ-jIsn zqUyXIg%wKwRR#_${wju~cuq3urt=}%I)2RdCjN2q3Rwez%v%9CXn4pn#$$qbL|+I65ecgy<>Y`Lw12@7`QG| zrd4A&f&Z3yA@@9o3Oik;eOOG^OX4kG=Q^_?^tIS>U%huhSK$4h7i1Nd6ELwY;bJJxhr3=@6STJO6&$@8LJj*a8bOl11FjBHS_Vw>MK6`6u#A1* zt?XotRpI4PKD%n(;lcGSi}Fq{6aMjIo_w7=|3sURgZw4c9FO8Ke;CZ#m(r0y0&$z&su>QGs`tDPCAJf}5u>vU{(4ZTtN>jvvXN`5e%X!%c{m~rk? zRB4rB+Uh-%gmCWz7S3{=z-eK<_EGVH3dQ8_8&g4d_GM;mHt`}-g?8MImPg%hIp28e zjV2!}TA=hhQxg@~80{#ses8CM+zMejM!^9(# z*{@)lo4q6seA$5x`R?c)xlD4-6to4GCD%YIseg?)pee^ez}Lf*Z?&pFF*#p{CN0Y} zA-5@FziZ$|qN+wqAP{WB;+kiHj)1L}6y(+PHQNoHofR|$0;yrhK3g9X{buH6uqVMq z5N|*FnT2{N@0a59l{5V1mI;c_l&Q%JI38!-clAwZ=Hi`!G+|6pI@BZ&z{mpt@m&c> z;00NYM1Vzrhe3Rby#9Rnu_!RGDLEuGEZ{iB-5}n}C8-$#PpxIyJB#a{kH;;go>;eY zW*(aKS1<-I1_{On+o}>@F~$CtyT#WT)vrw9xQ`U+68*|+^wpnPRY)GF)-_^2(5m~0 zo<7nPK_b5Q)lPnzIEm)q3kx~@=W1UUH+^%W`3qOQ^uY(X=G0BZYN1MYK4)$KzA6?LzcSmvw^U!C>+@+8o#8qg4fxS*L ztK2@t&kck(fw4J!xD?(KpKOs1I!jp+(=p(`S8iG0Q*4Uqv2>Dpax`~?SK90$4uv)CB34AZSqDQ4WCX$i-{ttef zmpZ9=|HbDcT}HThj-KhdxLSafgX!s4m=__hDz7U(^+)jNsL3HSmcLKvHslNPt8#KY zP*q-Ex`kb?P3bJ&ezi(;7{1)-*!loOKLDZ_jmMYeHU}bmR=eaM%oAfXgm!`ArJbJZ zRp_g0e-mCmo7lAg?cNTgZNH-dLk^Uh_s}O(p~FIES~nW^!AMFV#t@lwmPeA$|W$f^%mCt zSfKC&j9;!~fQGJR4|@JsG`^my>N{3wS6Y&)h! zDz#E~6+{dV$bKukd4n~<({NAq0LX;WS|Ib;R1NoVxgJWjQH5q8IA;Bru{0(m9})W)#qf9RLpt+*kFl<)+A<@ zSFa={_1D@qwxjW8#&c4BrbXArRT#mXxA+7zd+*i?9r+#gX%#yFep|~6f_}B%5c!Ei zt7WILM_oM>hcR3B1&NCWr|pBXhneCKo6}M_PhI^s5lQgcv5QL*e%VER^SaPjoExEz z`qX0~bc3V+J5o=V3F8Oi{OgVWJA8J%dau8nhT_@w=Y~^+`hr@TQchmMaQoC zS6+VZuQy(@6O<&_ESre>nsk%q(r%CU(R;T>GH0!HHv@A=$@|CH07?c)$;u`+NX1?x`b2P_2~SGwIA>JA5KF$hJ1ne`n(wL<8mlVF+f1a+ER-6L1|a)RI~QEO zpJXVTg|q06!fG9MzgKkf05p;|8Q@Yo4Pr)a8RC-S+sw(^A7@rXRV;tumZKhw|r8h<%!)#jxu$hwP=;X&ck z<{?pQq>CV*nYh zO5Nvn2dF<+}D;0SEDjufl zPX0ZgiG0N@6(RP_P^Q-`;Va{g!NxbExw44OG%j-fy$|1oF|8he<%~dfQpYUf9v17G zfv<{5#Tk`K%!RAH4g_NyTjqz>UN)m$a{YLnt)X?3C2o4iVg?)evK!s!1?2cbSOfpjNqZ>k+mIfA=17a%H{oZ<)AzI6NU=Jzdc%pYIf8wVbmp z6MMBoTV~ zS_R|3-|U`zH~C&qevk{9ZZcv(rkBu=r3P5Y;=$8iFcg4E@i@2F~Z_aswn_ zI?x)F2_^d!>~GDRuDI@Cz2gw%SZdOu+t~%Rc#ckdgBZ`h27}8S3^0*Gyc|;FkZ(cOmo{i~o?8Gjr>PAvF z;(dOHxTm-HQY$Q+JrH9|6O{+%Oj%otxBZ(*lns6z>iq$22uYM}l0fff32=8*Y1d_Fl=CB3YxFoDFk~$?TwN$rNqQa{9m= z3ML(mfW}S2V$spp_J9`&Zn(fkaXSeCsVg1Vi`iacR;u|AK1D_*==aN9yvTxs1DkLA zeD0`FrFK(l-k(jBfbZI)hNZQ=EKJw6GEI%g`8~aL#*S}ferhA5ju(i-!?lx)v$64J zq}Mjlhv9c~_lwT`(*Ic_B|awgY-f1@_IhS5GY(pDv3+utx^Apcg!TlKiod%^mh2nit{33?sW53ON0pqRmb^$8`Jmgt zu)5kW>he;4SmrM&$X-Uw>E{H}#ofO$b{R{dwGU)20o8)z-Ugx{vFq6EXCDny>&duP~~CzPv0`XUBtOoSY`V zv(b@W4z4yIR1>l3S~H28Ij`-jY%$(aeC4!ea9J*N?BQ0S`VnqpU?)R3cWc6d1Q&k^ zo!>j-0eICdgH!CeO!aZT{v%}L?%5ROa|CGNF`!4n-|@ruUCypnxxKtxo2Z#=D#^)i z>Vs+;=$>XNg*cQhqzjz-ZZ1-yRyu|611L8bJ>HR2%2iWTu|k5AKRuFOuwS8pYi&lC zf2M&k`t#n|A0sLnwr9Sh{)}~TK#*K?(;#gLLN?$3CKUfIB2+6cMFg`OiaTtyE*2>i^c1vza;rC(f#YKCj(7uOF)TzsK~w0*dXquh{pCxe&RRmqwf7BVs;!W z&7!r&9%cPwj=s8IN*xwvD{#d%YO>lwRweVAJI9*&b#`ObXsDl+HF-|pltP6gW>l2F zMP@DO2dP6=GLHO>uRz?5gi!%eqy>H;m<62SfrBoZ?0C)0vU;s{pAl`$p87IW;mR+t zGTZlaz3|w!);p;WfVVI25xaa-+6W4#;~>uY=;wE;^#cL^puMCUAQf}UsLW2X(kYVF zMg4PhC0^xEuSpAkLDXB7)mw>tmigmPU-W;=7G;R9Ta_rLBGi^$3V5Aj=<*87 z!6x%eY^MJ5PnG0nx7g>BDaWUP3fedQl(ov0o>JxB0d5jr;*o>s_M zn53=Q#pH#7@$m&}^Jg&onF@lW81c|;3{LpuM~S{Mm#VQl*--w>9cYg?G+`S;Gy+$} zTy45(&|fJweBdWv=&Hm}X`D%2BJT=eXFP{tLqDJeF<9A6MZSOv{#nCr>z;$iBztQ` z0#mfYCdrM;MTq=z9hxQ{s}MZse#}fsB-3$b)tM6#Uiz%U1Zz7K`eRiVu~YJ={5BR< zdxK0qqDJUTp9q{E)rq-dkLLBGEyNJn@C8ORSdipA{$IzwJR9}y5xSW*j z_rTV2j6jLyOV`ckJ)|3@D*gT6W~7?SU~X|vlwN?zJB(k2a!I*&@~}JrZ9Y~dg-bXF z+-KRA?-CH3IQP8xS7&FhBYVOzV+yi5+}R|J+8y=$X%5+gmS%sD)>(8b{-}|LH%$Ev zpZ0PqqKlEi(bEcA)lGRYYOuR$6zW;c4}A19!@AS?T_d^k^d)cU`=jnSY!=0aJ@4#D zRmG-Zum^kQzDa`14O!3U2Oxh=cmCBbe~jcetQ5coomBGy7?%BsUs*&419Qae=WinW zEYa{1TYkXv4PId8PjTIby1vn2xO65Uxs->4Krl(_6S(L zlxSumAXYcyY)erwOw5hEV7K_%(Hf1DIoqB$j1Z}{y*8yc@!Z^PCwWEUz4trY7OT7o z9Kro#jzZ@h>-mpGLz15(7;F?855oy~Zkm|5bW(h^yDv8flkvO^(boa()Y+ydAMUds=ZFFyc7 z$#Yu3YQ(022K)5cfDF{|H_v$KDvTn}fQgTj7IN}Rju&@wsD1#kaB z5j)OsfE0$Pf*cWAuU~1rQ8;;c-@7$_4T|GbQi#l77Gc|-1~m@sy=C-+E=IQh{N&!e z$<1qJzKmHa;rVuVP)16t38+~4_d8|S2f%|_!CeGy zVPMO6Q&z{)hC@)C8z-Qob@qZ3oWS$EFt1rUP8W<17FbJ@FC@omm}3f!+9K<^nlE70 zaDJZU?3UJJroFGX3Kwt)C5JeqVj>fo<&%aIAFsr}3)RoVa>6{}*k^=RAcgX`-|3;922#fJ=*|$)j(7&?@3Y7ZdpnpVRKo-A|{?3X6 z35c|z60m=;p%MVJd}G32jG$lz$axP?0@9Nj^1;vm5Gqe){09pcoPgvFU_FO^$|k@8 zDL16Aa%8Zcvd~CSG@m$QzsNs{1z|xkGUX9(j9CAvg`mq8HBES~=Si#r^&4Xfv6m!F z`G2y!l2!93I{^1nr3nh)hA;HDTlOjRE5Su^%h=$@gkl%170Y^!HYEj7x1*k(K{$fmm0)mlKn7#gF zL0Iyzm|s0R{xB*$+KmZj8v2PbNgfmmpj?{1!h*L!Z!FBeXXPpXd6oaLCq3>6Qei?tJOvt({@T-k z9PWIasf%l1Sb)@B-9r9sWjyWyVmttaQyeQAzR7S0EDkI@yJ(%H{l2$*r!4D~fotpg ze!%yv6cZ(6^?s(~R2rxWZ$-D{gdEBMA%P+h8UMYe7rbT(D69P|{OsOA{kY_~D9noC zy}Unz{RQw)B|hdlzQ2J(*z@g=_(gN{Nlo*Xc}rFuea2U5T10dgoba)A5bod^1yQO& zk#%>i~=1K@KtP5T#YMlzEH=OQJ|+1td`!873hjGugBm5ZAD`xTrJl?mm~0kaio(sY>kSP{L`vG{ zw1gR%z@bXHgqr@IYv?819AQGmD5-hM-_lYAtfi5K&b@awbcT&$ z2z87C$9@A*pOJmT;RtbGg7p}?RH ziS9TMO0M+cp!}wWa_|ogqlqVTuS$nyrfxID;0oZxa1a|XhED|9X3h$ny29E~po?qm`P}tq3X4a{dbf%k?I&wa zg7Co>yEieyr|+t0+!}W>wKinGGz<2;YcIAR%hS!e{hTEc`;`H4p5gvQd?@BSq3&HV zh)dBzTpv5NCZ=FGz(Zvt>RLMUpI_(P<%wk)|%M79;i9^#BN0Mc?!Svh4p$9hYpVNkW2d8 zRTlRvGx;rc#PB0#W}lW}=@)NjPY6gy=BDHu3%v(T+T@j`nHQ;4)99LrW@G#bZ3+vv z=e4nY54Bhqtn(4qlThJmiA$61(RO#4y7=k0>)t>gRsHs)Ar`=cQr3(e`(>9*Z==4G zvO^liYdnh{>963zgngARTI{-zAJ_Pm$sZA>uD>_Rb05%9=(xmdV1OD*nwMyfGb(#4 z&RMYd8Cg^VN!wW5Nc|(qktj%~BGKVl2qC=YXER|rhp5%Js~o4%K)iMz+tSP7G%OnD zx-mTBS4I>LBAhV`@>2my<{}M^MS0%{)(+{dG8nQ(akMb5W&FaRP9hKeU)hxz?~(Q( zed^fw)<>@V>VC2drc?C?0gsBQU+(5xe7IS*mL7rfQ|vgEK}WN)up6$gf+a5}<1R>B zM}$JmlKNf0>YpTpUz`b?VqBn#Hx{Lp64+;rT}+il63X(-`j&hE;+E`MCSAv9dbEwT zk0M#(fQ8W*s3|V%@y1>)pFBR-1~;ZY)3#mVfVgdAb{d)8*!B68$t}SmG(w*Sj;6sc z>Pr*7WscJ#2(D{wGNvg_TfH3XFOpvW<_WBUI1JO%YQf(w^SHJ8&uT%4cw&ApMjiX? z&KXGk{GT&{kKdy2E#z6jYbbCQI(EkoKqP}MwR?#;DLX@k1hkmx44hrt3tG*Zo?d1l zcms6@qj0BSsjyLkJ>jbA^w;M|H(}-(KL<#c@?E)1H}T6h6dX97>39#adNBb)M4UNd zHa1-dDId>n=vcm5=^Aj*BH!{8^TCC4wujFm~f>OAk#gdWQ zuX=eEv*0Hb{v!FACLf`JjG?ytw&n&lhg1nd@-BWW?%Mdo;fUrP)$KWbG`RQklvyen zWesCBI&yqkMHU$jYocc@eViNC`Up#%dqMiiMBA@7c!|d`Glp>M)r8j1IsDwqv@(lh z1^v-NKSLR^Mn88>t1uE8fiJDoe2E#~)98BR7u||GsE3|A zqLe^rIMU(alT*#`VK(RnuXT6>iV<&dth0wg4m+tP!v#yb))ilj~JNI1AaJ_mHO$FwsoN>#aq=alHti? z^C^Hlq|HKYb`3`50*P2izOve8T?SOIkzo`>8-!Od>Bz75gGq}q*dTx-T+1%T)ehM( zg`a_o)Vgm*R&(?=a<{*3W|I5&c-DA$l$J_$YmCJ3fVo|ZW}EK{645CgT`5Q*PPyw$ zano;x%Wt@KCDb~0cJc}Vb%DyQ`zRdUsmn?PCZvGUp1_+#8+K)vP+(=E`zY3lQZh(< z+8`Er-DnbpsK_H_> zJ%;yjaPE@ZZ#i@D)nx4`GQ8fvs?Fu3+jUR`SLos%w59M}vgXU6M3iv8TYVNX8=Cin zXrJF@$HR+f$F%`4m3dzwq+bhaVy(Jp(|3qb(41>L_7TfVJn{-Ybq@RMoKppbBex}_yNGT0y9ycj3)XCapSHa zfAk%IRY!ampuF*IB52pdNq2fYbJ3aKNXxymLbq)?R{S~C^*jHcczrM&S9cO)bFH|Z zJQFzChu+yVb{{sVt!uP`M=e)}rMy4wkXQ~Y6oVU88>I6~)!m5Ri} z#Kp9Rqxx5?x8V?DTk?^-TSQVBQu=!4MM|$(`{J#GQQ`VvYdE7}Q&Pr&=E6x!vNXEd zD>^v93zZA0l^b&G*QOe1I6@Bh{Ft&P;j2iYn)_{{Xs?+okW1quH(y zH?7&Un6xS-vfeX%^*RCDHEOpG^P|bn2jDm*N-H_c#Pp>UHhV@I<%YgMz5PL?4QM3x zHhy)8jD?!Z;&1>1spN+D(t^g0@FxIA6NklxW|1l8GQ28sp=`5aqHz7UaI4C_a4%}e6@St8SQllTszlj^AeyigA}Ub#0^O;h8CWt)m&XYdnOq!~ zm>%HN=H4R51omCk@acaY>sr6qTIjh)7pNvk2~b|E+54d5xD)Oct`Y-v@3vdO9XArU zq&M0AqDbGR)h-@aiIU~nq0uxt3X>3uW_)<_&=+^Ch?e81Ncdowyj@>uG27oXy_v>? zpmADWv3Z8|@9rN0dkPy#kb5rrp?^~D&lVfFkmSC-8v~!>kXDK2nSG~AO9fKl{gMyP z7^JBb60hN>FXm$BGRd$fUg9;E3n9r63%o<9f_t|sIQYxEw@AnG!@WL&-fenG)-;EF z_buWDOrpLV;xTHM!otSR0-_?%B+MQpCZx%?dhWtmRcCl}&j}M?H^DE3MbqSC6DF`* zlx$=Tl?BJU_O>(u+E^nn1FwWdDAe&Axbho(V(`o9uq`#Q&tI*&HpuD11t|nl)M<>k z3Jwczd6eL&ZFyOkr5!b;zqtJ}%Q{_0kXwO$`3qlYP5%Kf6^JqNe=Zsj--BuD+CQK< z&eGe($x?_(>;g|uB!^eXYLPuLrr7b@W$+w+4q(R%T`)2t!~=cexKLhJptC~u>zH<9 zJA#9%nP|BikV2KvY@@Qq_Cm@i(wgYGBJsYLp+U>}Er)~cm*tf}GN{x}!WvPQVBn-% z(`FJ|BmY`KdQ@_Ap)lP^n&Q+SVTLG#hLDCkI<{xAoVHR_=Gi-y(rOCeIlGQ{CyYj| zf^Ax4Kd2zJFhBro_uKBkLrni&el0@dec}Z(%E=Jr^X;FgWGS-M9b#OFZN7JM_AFVw zH?SiYq=*$S3vbIYZ{xTFF%L}676^Nn?MclyX!%YGuFDr?@D4aAp)`ZlYn*C{nnMiX zx5t)E%^B_VP?37KH)>;gCdQnfvlxw4Wnm(rkcG@dpKG-`cq+A>h|X1|Y$?M-6LBur zrKs4jyz>8)BYK#B@7dNkjn+*y?B>B2m7O{$rvb$`ipW%jN_S82nX=9skLQZmZlC~q zP$@6ZLlU`VPf7()kvR=0Ib%L!^uTe~Qp2FV&is*>w6Vo3)F$^! z9rSSk{>981Vx#kQX*B6svCQd&5c1m;^X<||w#HHuNyXlNPWYUi@7)(+mYUI6Tn?|s zC(f5w2`>l--%PXyBO-AVCA(6KfZmLb9VIt)N60Q%pTiM`drM&CWjo2>?ec6FXty$w zoV5?Kr*N<9V)PT}DQGA7Q+#2G^u8t3iqxzoapCUY)_3Pk6p0{POI2+k4#hgFGacj1 zrRf)WH}PtauSVmw(RbL;Gw5w_336eZHY2K{?mLP%#t%T&OLq8?`|FDDp0^Y`&0LMD zc%&LaOc5G=&bUl+MJU$&3tQ$V44N@*B*Wd@B(K>i%w$A&H*g&|3%niU5(bCj2`4+0Ey<$TT4bxfmc9GZcA~&FuV1j9 zTDZBtY4z3;hPh_e(&iqj_C%|0h!T8-xgsmq3Cb{rB zt_-o9sqyuGPc}|C^h?Yglcl`&!$Lyuqpt#wD)i}`J}QQF_12o`bgS2^yEio{vphuI~_ch9TpI zwc`oRliNm@4eSr5d^g*wML<%_aNjvNBA}LK>bocL6^t_KRd04RF|iZw(E9s5L+(tZ zblnPPLq+<1x~mVN4IX{*0f~9V>SE&AacF^SwaMbL7k(mMAi-SFoS;Emvm==vGwd@M z4Ls@6#ZGAwxmP5!`AJK$F&KzNa`dmy^w?Y2t>^XLeT{ZV*GsYq**@Q;LbuT82+KON zK`pOv-TW5gMyR&RdZB%ceGbEwO2jh*>Sy7Fi~WB5!qV8(9CVXzG(Ag2jcUnmU{m$U zVHC5`fGHA%!viO@0`*|C2G-I3-p&>UsA|YtEtwA&bRd#y49k0$1A4B@C+V_B^Fm3M zslC(g*y#sP@_=L~e5f8=35`Se$8H)aHTpEPfD6NO=)zAQr5<O&y0mVbQIP@$bu`Qr*>>?cUO~%r|-DqQl+0U9rrZL@%dCA zu#0=a=gGC&Vgv(fD5~ATnLZ28yX<9MsmNMG0hl6`8xw{3;Ach(7GGf7wK3$K-YpRAFI9lK97(=Xg%!J+;~*=eNfw=3)F9_ zw?q>~z&TDnLMj$%U3GSr(CFT)*Ux^o0B!!9jVRL5-{AoAdv7yi$AJ(_=|