From c0f63537934afa65463ddd87972690f47c2fc62a Mon Sep 17 00:00:00 2001 From: Carlos Pereira Atencio Date: Mon, 5 Sep 2022 19:30:23 +0100 Subject: [PATCH] docs: Add Power Management documentation. (#754) * docs: Add Power Management documentation. * docs: Merge the wake_source() function into deep_sleep(). * docs: Merge power.deep_sleep() `pins` & `buttons` params into `wake_on`. * docs: Move power examples to Python files, and the tech details to the end of the page. --- docs/index.rst | 1 + docs/power-mcus.png | Bin 0 -> 105215 bytes docs/power.rst | 126 ++++++++++++++++++++++++++++++++++++++ examples/datalog-sleep.py | 15 +++++ examples/low-power.py | 36 +++++++++++ 5 files changed, 178 insertions(+) create mode 100644 docs/power-mcus.png create mode 100644 docs/power.rst create mode 100644 examples/datalog-sleep.py create mode 100644 examples/low-power.py diff --git a/docs/index.rst b/docs/index.rst index 1d8a85153..687ac4c1c 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -91,6 +91,7 @@ Projects related to MicroPython on the BBC micro:bit include: neopixel.rst os.rst pin.rst + power.rst radio.rst random.rst speaker.rst diff --git a/docs/power-mcus.png b/docs/power-mcus.png new file mode 100644 index 0000000000000000000000000000000000000000..ca28fada5b453b3a0bafaa8022b8036dde8af2a5 GIT binary patch literal 105215 zcmd42x$OZQ6s{q!v_EWL>lVK`TziqF93i^g@=p&34=*D z696M;NJCk{0E}_4(t?4hK!MYH3l-xujn7uU&0LNtVI7y#z#MVHCxbkq8|xg6J4X=(D^$?3O`=CA;W6&#k& zKOYVKxxF*umS#$1UuAoJ-3SQY@#`_Foq)b~m+llAi1%DOe-G%*?F0 z*BumGB;)dRD*Zl)WGi>Mx?E*0Aka(`OA?$4?3Sg$P5fX(Bxq;*IxMy^HmYr9BPj zVusU4#~U*^>&jpSazV0X=cJ$Kx}^JQhNKZEpLG(HiW9$8MbM8k^zn91I`b=`P8MF|6 z(A)_J!|f8j$agoP*3U_hg+X^UUXzlj*9fFG+n@6Jp1TsauKQc&o7upiq$cMJ*&9?V zRPpjUkwZgh6+9(zGC(f$WG1|KyzTcn^VTEZH6o<`b86*q|7Q_GZV1de(-wwjNv@ku zG*WOeUj+U6o_X`@Md7_6>g;KG!d4LM&rcNUYXD(CX$7Kuc|&53d z6M^?kx5%JCtZ7E^R5PDhL-5s@Wh5nU##Vy#(LihW?|0)*;EcX9lR=YSU*lH;E~IZ! z-lLBnnHSk)LO!~!-6h@~uHD_P{q#ZK)Dy4F*Y!rNljfWW#@v${{P5Vzi8C3f68Oy< zZqTntFtBSQ$M|a5wNdbY=*%=+0ktq@NJ%=$HfB zc-&NeW+aqLRTsx{6{PM-0z4SQ-?hgY^J+T(RFjx>din(e9mn*D;|@WFfP-%@7@1sS z__D3Ic%*dqPcIBQJokUoMdm8CZ9zMMcSK)_jYxr6wBJ=K;rLSzH8#JxI+Fgm$@_i| z(~&&^*O|35A1Nt(2}?JF7XWXpG}_Nt4{xl%Xp>pMVKaPjWWJNGtvN>rVHZP+W2{5W8Iq5UKms zWv+N;T8e7CFv`eTq|6XlC90KS&zki#`!fElw^o=S%x~?)?_X7kfb%UPTew4g&~<0 z@K*c|QYmb%&zT0DL0rB>=*9n>uIJUCM<)}Tx8WugJN5Q^wu^bEmNL?|QyPKvIq_aY zMbp~H(Fi=8FShbijCp%c3B$4(iOIssV#RTU(0BVM1ZcIpkZ(!ZX_DcS)}exJlwG^; zRK~j?nOS>41ox{q`fjViB;{{-y36B-#gUw7JVMZ0_~Cq!8(YxlV14!sy_866&v|r^ zWDO>mr-Zv%alh{`UG12Trs{vzgtY9)+Z=iDX6%5Oj3`O|9qO< zW|Fa^&lzzU@0{GK-+#?$oDS2++Qz~Q50JR&?OYms9jSdx_kRy4Zm}qLA-$%QN_n%x z?`*eSS7lvOTQSp>4YEyiQ9Yx*^GeD)-|Ivs*fUQ#(dP+P@ad3~P7Q~Q%r6=2`tMEE zIo33Y<}hK#6xh&ssSx2-k+=b`A+XEiuq$)RNk(*RAwt5bm=8?Qo=feV{MkhB>^Q4Y z^HZrYXM-6*sna$Ser^L$G&R8qz!CyFF&aF2j&JcVpW6T4p>B^&t4ySV9hBpJX)0uf zDEiB1i-t!XI#|jS?26REb>&>1Itf}L;&Ylv*Am56$a^nCgq?PY^WcyO%}{Tgz0m1O zCE)oHohq|CApeI{LZ2kuQ%A}V$K-*HFVp})*Up-0%Ai)w`&8Ku8iRPQ`;C6mu}M4_ z523g>lnvW>re~3jHMulMFJ^X@uO>Ra$MC<__KT`>R+x|t)bCNU+EH9lenPH+wY-SLF8ansW)I`CkVx)xb zs=T)QenMlQDEgj0*@E@r(E?^y^7*nUnf zLXXJr?ej2fh2suxFeUllsu4M2jy^qG`2lF0)mNQWZjjb$$J=@%EtO+3J?%kP^>~Pl zVfNT~hfZ0{!R(}YGy%oF!z%&D-9gshNyY9f$B0TuFlM6;O5irqI=ttaos;z&@caNn zf;q|bPC5%Ix&4Vj3xcPSGVn7m)<^d%vTDkNwdC|HLGRbp!3QR%pSs0ukCtJ6WBLwv z_Jl&bMs;tn&34+)N)u(JLL_6U}3pZGg^qgLv6s9YMXK{4W@9;0V zvi<>71?_a&Aars*oySJJPUS!|p0R_?ELwfrReQUhA?l3HZs&bhTLYhe3s*<34DcCc z@HUNug{tzIQiP&1PqY=y(D-TM{pFOzZdU2Xz}uH!q)n#sw#!1Tc`+`<_j59G!L`-?B}etCnXPw4r3{kAi*(!3Y~KsfWFITN zyXVsgecei&-*$g@J$-+>#+!)4Li@_%G$nKWaw}0S+q@IBv5E>5-{m>=hh1*Q>g~wg zpUIv4{U${G`lJ?a3Rn6pde#p>pHsk@%$kY!UdDF;De&^(btYd@q)%@4@&=5+P^Tk! zMQxmc{HWO7Vy>NG9}=l}Dpf7Y>G>B0`?vpACxsm!$>Oat9*|Erl!IRiRJuS}oQwO# zbig$q;*{c^XrR%xH^;AbWRAD~cCx)0z`(dUx|TMBQ(1FI%xfL3^5%(L9*x z*|wR>B`UF`ciMe?>|~}LlBEki$}GsDZ4;`g#Kc53R>nXtR?Q#%@jGLgTYII6ktM4T zFIwQqj$CS!RUame8if+8GpF(|K8Hvz9Vve|qIQg4TOQx1$`rLnqqwLVfcw=x^Ky`He7yyruV4$LjWHs-YZsGN&v+o_(JFQtK66O8< zr;c^gsGyZSRErGnPhJTg{!x4pt+A)E=aQAYFv~g)8zZ<1&;yAd7KP`*DGX- zOo3X#pn#v<#;cmV%*5!H)r_;#3xP7ur)JL7K_rhFgIvhm0ENPxo+P3#N!#^~F_V~IJ>o ziphb4iR#Y8_t0RC*!b_$Xhzjy1X=B0PH?M7Mb#~CX&k2A1mI$J!G^xG$=S)TBq`OcWtpQeMZ z4c8sfn@)#5^?%xle>Jw8cNoK+_ar~WM+%J9;6<{nE|UF_7f--5ih^Zj2c<)x1Xskt z=B$S{c?Os){NZk!_+LzMPc)U)$9mZH_VAm&EiEj(no~Gls{0FS|AnxJ`XIE9{Ko?S zfGa~kX^nC?RGHJ2NWSz{?D0FucKSXdpdI;y?a%MU)Q%y)N}(gatdGuugtkMZSC4zn z3o0HD!H0TzCbRSuRYf2GS{e+VP*tgDdqSnM)4cuoNW30y_gzd8=1a$*bH|f2bPAGs zGpIfqMP9?8j0+FEgBqN>WGgzLlUA7wy-3v6S_q^BFX$xJGA`G(0en)F|0H;1&|Fdbit z4ZW6AUFfEd6fSMnDHrveDtJb^p`fhW%ZK?2N|HyIenNPh{r>yL#LlBvA`{F*Zk@G$R4j z_X6x1!9Kjf7d;6l8HvEphoRQv91*%MzI$nmgE=kE4_swyhgaduL4^5lp5(q#50`{Y z5*W2h*M}NsVf0Bmr%9y{+4>DLOCtk^$1MRL#g%uUGu&Vt#tG6IJj);JJ4UsG$^)Ke ziX1|J`5JmBU$7hghpc&4LRGs*@OnTzHpY$znxCAF2hlOdVi@kq3RYQn${D1IFl=HmU z?0X46Om-y9S77Rm$9;)=Te{M?GSyXnUE$wTfVz`$Q20f!iV-2hzDCjT4bJ`LqY+XfEgSRtaGmHv(au$Zxi-!b@66X^4q$f^YhX#$>DB1`mlF#y zIFO*TyL6_7UTi7a)3_5P#x-k$oI=d`B zw3F;$3%$TX z{;IeQ8%09-USq#M zCW^B)>dWfaH;!=CH?WE1P5GtyLpH@UFfJ?!hU=Tw9zB3DDatEzuL zxT5vUQ03q`h@6C>t22q{noh#uED;~aBJ?Lzv6u?KcW zoFi!;FKQ5=u3P^PKmPR@dp{zT4 z(?%__b9Z9yv6UH&x0q=!zn7`Zo~2(apOOvs`Xs@WUsBh4x{7hQ^<2Eg1@yNCLjq;X zOqL8jv!YVHEklz`>F}P`&+ltgMZ@4ZazWjAn-ciEcx#tRAOPK8fd8*xd53E%WO@+l z9Z=fUI{RqwR`W)x$xv zDyKMULv!2gis>rLU*%T?>-IBJ#qlhBKI;SpJx;7>S>yV0pS83>fdGk1eMcz7G`U^A zc}Q5PT*_>o0@*V3wB(>ZUD+)qT;dHiD$Qy)Bs)kNjz&7&VJ+AN9GDC`irJn88c7wf z)}vvC7!jUrcszZy+G$?NJn-*c{-HO`s>5Lk%am7&C6LeOFas_;qxi|oxP-nsdXG`_ z`!7WRfzTtNqc&!+BPr|}{w@8R_4@QY<|C$ln&*Ty;|u9!JdV5~zGZ3OJV)nwnp&YY z#&D6Ug?LG!x7;TPxO+8m%?iJqqrfvH7S;5Df)z`+@=;72f0?V2GPDeXP@INcd#I{H zPg8;^IlN_snzO@K8aOF$ z@Is50^3#XG{>cjzG|*cqQ8^qh{4MB%;8qJAg>{i#qEdEtCA|5^kah5Vk&SsLXX9($ z8qLK|24l9A45TM2_H07Ib!lmM{0_QRNk5;lV1(p7NL7;K&DfIv80iKt(j1QE& z+OFJm4;fathl*;oz4C(0`Qt{`QfN~LZoYp9(VLndsdWM~)o{vL7WhEf| zx;rq0K%@4|y$f`Bw|2AggaboAirY^^T$Q)PW?oB%{UUrE>yY7%{a{x@Fcp?c z;zz-|s2E$eaTqgC>>L6UytLzS^@pX|z3+YAeV$js40J9DTXdwuN3GZrEf03b&~Aq( zIf|Yc0z@=kIhuA|v>PnG(&nADF)t3%JJa|0xZ98U1Nlp{d6Y2Ap z#?dfFi>{ud)|kalxE;DjVB&{MK4|({{TRSFMw-eoGKKLfUNZ6IE7v+dGp88{Xgh-G zU8eWoZqqQX=SJ-di7TAXR=3<4EgmZABN*yQo7sO$?UIm$Wl4jMM1UaFa#SOqQZAl` z2MP5&jN#hm305a5t}klgX_n8VD`eC>(Z8hG(;np7D4_a;&m0EuaE0^*tVh3Rj)w zMdf?-WFW8Pu!f(E*J;EGAUM2_{SOi8pO)W&CQttS-v7~kebh|+PyG4UNPlZDuA6SD zU1ig$0j2zvC44vmPk8*)vagWV3}P}(wBRu~9%`Qz?ELun$XK;67PS^>GNjwitC5xL zgmeX_cm7TiO_XEe&E!)kHBx$}y@6kiR2t&qD$#=>`ySYi+RR67vmTNny+{K-CQ<>r zgdu>c5B4N#-C50JZ>Ux~?gTCWdazIiUk3mO!=RG7Wve~uy%FS z@@9vpQbN{yGJFN=5PLW#8|L}U0^87j#~|VjiQh8);pm|u=MEe+S-sBR@Vg)^C?Qg~ zU+8R6+1q|N4B(`)#0J6`@GuUMnStHpz8pWmGIvD%z5V|rrZ5|PgM-Oj@hP0e{hWyk z@Av_z`QgGWpz3Yb6;k>5i$opRTl6@R1c+!2Y4m(7mBQ8ADPU*zXDZy;tq*iQf+ zdVQ~r`(D?nlM!9!-u+bg4P^**EgSs&i~k{gDMU%*=_v5PqZ` zxpefnbcU_pyHSrl*R=S9?N^0CFxg(3NcIxT6U04Mu&H_tun#R4vPPGIQJkp3H!d#E z&*iET9M<)5&~@eiYgdceX}#H7JTF||66cLC@QZCA(In_%9`Z(F+tG?4!v(=44c>x8 z8a~5DNn7@T?|aC*KRk0FUp9!BoKx=fC5Y8+7+?3Pry{j8)xj>bFLEHqdrE?AVp(}l z>he~?wJHrum%1H~g`X++J)VuhX0>OPjZo$spf3!P966Ih3WPl^$|j>Ljyd>!sBt+S zF}lt%s3W#@$k8nM6vtQNz z8S{zKk5|!n(hp_(VXrvqqx~4w!D^>C{u)}hvbMA1z+YkM*z`yDi6;_x4Q;H2nwHgX zbB5saPy~D4W{-G>tLY<&`3BNfBu_&F5xv;Dy5_KAHL+)(m;$Gpxh|ZsyaU-g8sPIg zO(l&m**)ax^u5fmX=*sL#AkX74wr@6#X(gi1#|KVN%oRWGO>(v0@@$ly|Ftl;#n_9 zH5e4tAxerq^4!9@c=ir1uKd6skO*$ijd6g*jvx?idKMp;6V%zwX>pOa87%<{eAEr|~J9K%84RbWOhk0_}$2+x9 z#H&7oI;M_{P;qf_75-`$%OwKBnnk=WPR9h{1Qy4bcx=YCn-}6iXX3UNH=ER3<$@pH z-e9Oub070L1U`qGN+Op4WEx<;%FxX0tv8XU6;2x-wfUX+N`IL-;eRtp(bR*l3>~%V zY9d0-yi%Ip3`+VLu*r5uhC5Nhcz)>+@ef(Y2%@-BV;^dm+aJbYhOJR%Qiq3Ow6hbl z2B%_q{oi$@iJZe2w7fIkrVP|Dk0JV_?8a%BX#2E%S0juH*zx-}g&C87gg?f&U`w!B z3E5zC@wG;;CmBE8JkYtC1Ha50FyG?qqut zg5d7T=_B*X$6`(Ks1ds-NiS@s8(f=4WK5LPAXUpNst0fZHoiC5bu3`NbP)xjqBr6 z2EMl~U-4;ydKLPuWQu8N044n)E7kU&IS`B~U5$M}TS-{vb{5`*KN0%`kZ?ZNJuj3y z{Gr}aXkT8~NIyHt#m<`QvXMpq;*s2y z226}m-M1{xYoWuZcKB(syWU3}TB;yJi%xK&a#{a%$G$6BJ7Q;lh?I)ol-tvHPTIGj zeHYiy{MUQvSO!0^Jz!YccS`o!1@F`};O?wY@LoHNLXLRt_Q<#K!!;-`@XrqkWS*D% z2xsQ{MbQ0){jHs+FOz8DX5KXr$T|21w-VJFQv>g4G)1=m8-e^cYm?D^i-39;l8U}G zIhfn`!I!|0*C!Tzr0h)x2=y5F_!0+&JJe{7EeJf$$z+K^G?+&yK@=FB*ji>L2uxxx z=@=vEX+!AgFeM*gmdvF4b;^k0I zrTK0uHQ{mWY1*6Pev+{~1ox_)Ky{o84HMH`{9MAP$<-L{-?K=5_~0eJ_FBxN?CX0-Yvxq2;MT1xA3 z^jH7??_`Ry@R!3!AtH=h8^d^oUx`G75m?YzbM1T(AIDc#URHD792gFlenBU~`( z!4RK(dP^!PYs`v2qrk8^K3SZikEg&?pTcNF7^)oVnaWqGcn_AlYR`PiZGF*`AiV>G2b}Tp zytRk_i}Mgp@q3-C_iX8fCvlGQXlWzApY1`V(l}YN-B->ASvcuhBe~IJ^#UV5r6rTwY>(YBue zTdT~^(TFoNaXZB1?h%hQ*geYmXHEE*f(+KAJbMmKvwoe$Q?Mpfcxo_Y+^uCb1hC47StXoO{qD#T z4Db0x)`;)kJ$}A`AU;uNIMiEAwVlVy&8_>&;jh;r${<`5evCyTL&|w} zg)D5y?`(AXCCPl}{$rm1`AFuG#Cc+E1N0@`R{R1w_8`^)+^+=u@bg3&Y3 zn0Y6lO!HH!vb2^Bkz`KxzK}y2PHFG81^jZ*QAqX@cWCn}ZgEI*J-#RYGSA=Rw|2PJ z-9s+WgXhOh7m&@*-vE)3!O1{(h?`g++Xtlu$zVLf@-PlrFyVAsx2$q-ZAgk#5^+Ra z@P6s~5~;+yU~~KmieM~JjJo>Xa>>q@X)Za{EQ&sB-5)&W4ikfJY|TFWo^58^-S!(+ zbrxUsP96Tt{r*g*!4=n6BEdn(!D?4Pbjz^8pVGB$12-)K#cO$`ncYZ_RuJOH_77VF z_gn2&QAo3?@n`~d{;qk?KX+PT@_t7G|5%*VUlTzbkCa>MLK}O9QSFG%gsClcL+|)f zUnl-hT$4MK`y#HqxS+ICImBYUo*C;is^D4Ub;TM+;D(H z4U$iazbUw0K`MUJBa+H(r5=aruf0fz3%{xH@-1HA#{ElB|Jxe=tN`hodDnI?4(*pI z8ieI;vMEXFLJo0*XCY$(n=Bw&`?-1m;$CWKI-;2!BzR{YsNZ;A5h6Ti zlAY>H;lr}SYKeY$Iij&GlEIp1>!1M>Zx!4ujvyW6&|1e>!*%4pbRqLA=o`BirnbrK z93pdMYnRCp~ysmM4Q&p zr50z~M=0Z-KZe=xW%Pv+vpm)^PlmnC>2R8N^?CV}KFAdfaj%enk*=5&f0Ui}Q>2%G zff`0NAdgEPkkOw7%-~m~=yc8~W_QlOV)n<{;?E>6Scp_o%mJXlI9rR3MUU=%7~QWN z9~KDrX01o4udu*i-mmAJg3DGDrl~!JViEl$P`8wD@2rS<% z%cgDrOJVOxT(d?YdYBS&g^~~xi|jn=AV3!{9Y5QapD^pL9@GSqP^sff&~M`)%BcXv z+2+2MrJCjapZRZ(c+HBk+Fvt`$ZxcmrgWxj&yN0Ux&IsJquqZTYiXI`0&n3^wD+b= ztBeoqBknlD9rxDpif!NY~5CtEfb=F}nuep3FYh4Yxq_j%E) zAyJa}W=^eJyKiNLL;hw+Wb8hnEoePSar^U7ETWr^2J(ekR`BR?UzUedyl|53kLh%% z`Ns9yy(}(Ka_6IbZ!)wAPv!V$p^_6yuFyKalX9;9HMRZGS>gTrJdYvTs?+r_lFhqo zlv*L7Xfwect`iwg<;x2J%*s4Z{G17{RkT0nUsC-i^qO}r0ZWqIXqFB^W(4}RYu*%$ zT|_kBWAK(Q-dWX|Ej8d#^%1~!Y7XY5 zVSgDIX-j?dcFHxtvvwnL<-iL@>A3KVGVt4#1t=Tmd5_y=Kcu;jaGf3m+|BTh2ITVMO>JBuQz+!hxb2N>jhu$gvaL!)j#=(R^fqLb>v@D1>dJ0lUNQ0 z+q(Plg~gcVckMHaDW|7lxJeP5>n2Gg#y&HInu__C6JOUO+W<%r92^ zct_4;MqggtGfuNgSFNCHssx%~2un%vtadUEy7uJ4O`=fAv+V)sUv0d&|Mj96?GU3h zHus@~!cIqDp(}Ch<4s7_D(Hl$v|5=16 z;WQMLwDJU)s}sG1XANmj+nu#sxPG0OuZVKM0#7k-X$&4A8^WVkF(NtBZ5zxx$$*`Q zVqcv!?D&xer=T0~Lx_74jWPgloZBjxrcpW*KP1-?;5aA|$;QA2Ken1wl98`l?PSG1 zdihi5!*`+dud<`&KM<=hKT%ww^hUHVGV>eoRAxu=MSJa{n4zd04E`m8z*bdN)m;dT z%3U22^4?pTrJet`?*F2Vd&fMpmL6o#>6^-tOjn9@|4PGVCwJ^Wl!CK2YDaKc*+9<4 z^(|cm4SQk$ICMxsbOkL}&<$n7Mg312?lEq*=JCR!`^-B)*^>Ax++L5kf?2vhx-r`f z4Q-pjxGwe}09=kC?>@s5opl=ytmc>{!eGb>Rc|UQIV-<%AMZSOW`L56j29lMX1LG9 zOEOqWx2#T$7csrKYuwZaQoV;=0T-@zCS0C%j!3AD;=GivkHgu%<-I>`7fVASw|CG6 zbs$EjIfxe8bLW3EA9PDC(0yqmbNKef_hjY|F9Qn=0}~CYI-jj|(*8e@MyXR?`JkkT z!&_RRoPlHL<@_i&uGNN&w@Ua?;SJGo`#lcg$~gRXYcED70kTP+;P5;>nH8u?Nd4i2G%v-1G!>Og)W%tLG4SHtt&hgy=^ID>5PVfQ-t8%d_o-z|*@==`8oTBs;z9iu`PplSK zfo+BI)K$|?!mE)Yc2DDoPb^dB+j&-uu(|eS5^3L~fl9gCw;Bv%ER3+Jpu4jZQMofw z_3sq1RQz9Zo;nl%dS;AbuDH1D>-@{}|5He+mh)CsOBD`5xtM$Ii4HL|aOQ}DP$QaL z7TE2Up#s6mnL7onYv3bjEmFsF9s1xaHG%5iqF-Rkm=)4<$F_m?W&?y@IRn!>B)!a> z9~`Zc$OPw0gNk+;$TV`;G{`8;8*RnMyq-sPNDjw|iJmGR>~fA=mkS0F$%up+rC7N+ ziy)BEz4C;8tQrhWD{#16N>Tzc=(hC*TRo?{Kse3e95#c<6S72y)&3Vp3X_1a^=JKI zNf8~+Qx-SJk<8XVN(S9IEK9L9QrIXLwJ4-Vop|7DGg_?IB4+;hfJDh9|wxO*$$0gKVd-Cv9 z-6;8e1>3*D^3N$6M|=h%A=^r;1O%P%P+=@nq7%>N;wTC)zYPVfTBm%xZ0jm;Tp2{L z;z?3W9c!obc^(svHUVA^AVb{D!W0HrLMMk*zLmdb8cb@`amP7tHLZH^xbqDH#to+b zEtM0G`?FZn7-iSi?dw9A=(ZU8K>^aTvlWtc3WJ=Ux`FmoKkz|P4PR)G^q=^826OuE%r$+=fhuj&tIm%g!2o-tbXMLjYCeJ>q_SCSmy(| z&XVH3(PT&cImUBRQWAdK9G#_#)v{sD(c*uzFrs+yxp~t=CY_1dO2aX#yu@oXH+H0P zn6DaZviK*HxC=AZFD;)i)6};A2a2{8-K?LX$#2(xZApL*h{eC9n+KqUD~<$e|)2Tu0Ju`|tNa$lIX~~Mt zjk1e~dl$PvlucohtAR&Lww-3fW_!R`IB;~kwb13pSND22$);|C#tjQyK}>GIpFXHp zFv7x5xt#g3L!b*4H@Zbe{Vb(ZFXtnLgU`|)KKq*8>49bTuTVD|z@Sh^ROEX7X=qEd*P|pYd5` z9y>?J*yiuYBJ#YaHQM${VmAfO(C(t<29l`YBudX#Mv+Aa3AUoP0>7bmzN-X`NB~>f ziR4GO_n74GiuhN%RZLmgz@i$&V9OL#acJ?c1BCr$ z?$X$HG+tO??2*hg^X*?L`Lrh}h5Zlo#hvL`!>&pEV^`~?Ls|plju(ucN5ek@+-`(6 zKG4(fb`CE+!9e)1ZcPVqtz6^zBY5p3H@oH$p_0LUl#R8kEr%uh8Na$W{heJ1r4<>z znjB?F1-+K1=;Q(WJXaFHDDa*<@+vrE_{R{}ZYI{&(SE>Zp*^w&!wQN8q9PAIDVou< zkOC4ewwc~YuOl9avnKC{14`Re#I<8D>=7!GD>e8Cnb9pUNffvMp*^$R;UzFvT+GV% z>Z4WBAar!~iT2jn+*znK>9<}@%j>>BX@95H|H*_crttvv2MxcKu ztR8W$E{G6rkodcPg+@Q=7CL}9E zPCP|u(nV}rjU~#yAmrU|n*Ckc>VH+~xI%xr2aN>4CtVQ-PavzOTU}SB;qcZH-sk}R zM&2#@&;?FHSzO;LzqjNq61=T@9gGBvD2DTh4sp9eFMVm%hC^OihdOYa(Mgtx{gHr_ zfl|3sd1nr1I3H*wayvX4q&{XH6#LPQ%}#&Q<~)x4T=R>ciPrgx@PI9!FR#X|UG!xw z*b*NnGM2mD$RIM&?-ZogC+B&1w9CDWcNZrM<$_qGL7b(frKd72UdB@|ew@UyH+UI4 zXj+0dA{wtd$>B@^eBHn6-8SMxCwmPViT`;({_C%^BW?bC`Ol|k;nv7oN}+t_}=-7mL?;%o7eaTCj&haL8~iaWYKwk@XW`re0JoYfn_kOuY5 z1st;_b!{gjgTtkCp+9}f4IpD=H%FRHCcjMzp?YeGb0#2$m6WufPCzy?#7x>dR%iY5 z48w5j2@#K1d$TU4e*ucWXZwBWx8Bio-qK5SKRqw+bEv5-U+6jdn5}5cvsEUrBBr=FwVv?R|zZdrc!r5OHK68bMFhZb4!GaXmujlq#8U*P=mPgI;sLz8}?L9(WQV*CYwFpcBR%MjCm?J z;BMiKg&dTcV>pJS_%3~$Tt!=2^W*i7{wn$kn%1AcW%rULPibZFCG$+Z+;K&nkavk2 zG!rA(>%5FDkftQI|4Q7yPR-iv*u|=U42={~g-NuXdcBj}(iaeUTtp`Zc$Ds!olEHP zWDn+%KOhQ&3v4dzm8rGb;>m|(BvndLyaR<-Jqc>1NbgWt7&yY%pjDS2?prU}S(FAg z5>nTkN!c1Z{n%Hc)T;AJpcU@uqZ1wc+0tyRa!mM+YbP&u^<#g3|B3N;X1{IVNbld* zY&x=6cG<1GWF5#zr=>w&N-?>mzbE{Ey{~pBD@Y+R7zK->@!#Tm4S(2qv5~}5h}=vh z6YwK)|MD$P=YaVE;^g7b3o)`?F5IXjC~xR|W;1(go&spXbcJfc#hJYJ&OjsxW94^)`YgoKrxi9OpFWEUYIPF<{Iu)LMee2B2z}# zKWhwY(eDR|hIjt--)k>)EB$x z>aM!hg)S73Hr;)10NUjCJX}N>0cuy}0+C>~HO)ayHK5I&N~UydZpuQUdYV0$WE}PA;Rpc$JA5owB;nyX{HKruf7uLJS2dZp(n^QLb zflc3jCB(&)OH|EXCQNfiDIP>N=9QA?i|}jumOJdoIO5)0GKCg>SAHXu(8K1af9=wL z%D9llX>2d^9j?D8svlzGI~6#Ne+^gJ^z=JWOdEH*!`nEDa?i5*SjGlEJC%qatxu^_ z?<9NHaB-#2FUMspi^8x873Y}Od7a$EfT=hstT&^%lx|nP*JV*76B(6YzsCv+aLwcT z@jCLytyGS6Unq{m^+9tZ_{4@1);!&)r7Us#>%09N)cY`IVK$lY!~NBhNRKi8*7a$v z`=Ik9EQuQbAo@!$MY=9cK_0wNwxXgS%0W*RoCaS*PrWi5&6J{Yj+BgWs|gKw4XT1w z&6D(UM^7Q; zm6eq#&|6a%K3g`$g*l9U&^6@6+$wC*Yru`60P4BtuC@ALT13|771isN;<}>8(P&$L z%x$ZV{C?2!zCsVY-&a4A`N}OYa3g|xGm_p_zTUKDoUPS!XH@v$H*Qa*=7-KN7tLpl zG-T*KA)ye+@ab==$VmXMPcx7)BA6!~YiM8*%!>GOj!hu|Og`@Pd0aT zho|fFA3A+MVA(SXOf5e97WC-m)p#^|uPc;5ph+hV*e@r-`o$u*IT=R!W1P5zX6@e2 zw^0$B&pDnxrIfqz*0c%0`&;IY>=HZ}o-XhD!+U^Cty%sAAZcphJA0ec* z(W5h>L`#_h6v2EWwRYB%Pk!nz!?Y%pdA|!hKFRNQJjn?nY4CErLWtJ68>ghEert8J zL?0X^07wc1O7=H;hG3u?DX8;vD0qN+Pn9sdGydpoNJYJD?j6NBNB&`~ zvven3voOCeGFEu^b>88OcXES1gStKuNECeLggSqol5<=x&-upggMd`M2_d_O6!o8(+vWu;ECP&}D#$@|O8 z^=nbc4`O6lJNh{OUTAXj@Z73=;XGg54;%v?#|K297AgT*StS}IJxKR+tJ)fx+;TZZ7`hBF$B-#@-T zAfOgdHZx-=)8%?Zuyq1neox|&kMw2!*&*ln=-19+Y}4Kz_rhm*Re6cNq(n45a~7l^ady*BBI;sYQEzAUE5(voD{J;Yi#*cK?ki=xt~pl zhe?4BAkpNHY|uHM^u@Bu=rY7(?`#Z(^gVi+BvWwkv7&Cie);FA$FnMnu9}BF6C2;n zpNkPPNVt=Zz*DUQWb(d6Y$BI#jy5lm7n7v0kl$gPjfxwyKbneb@oox0(d5_?#{*~gx`jC*p2hBpNVF~oRLSK@tG2Xa}m-E zGPpN3+_=II4&Jdhf0@xfz5C2AVs0{RgDI!^P5Oz9tn7wMj=R9@RKDEFDBr5#_E2Jh zko(#1Q7!P&CZa~=*cy9~1itIkU!XLXnax+3pynAOVcRdG7K9L;h8nahn-+T1)Ku$+ z^=2I$IE-hvOFMQ=_>XrR6hPZIU-g`A2yE>)a`EHrcy)&UclY2qT0Ba0$U`qstkkO{ zQCce6EY_P>Rkl8ni+B+nw_Z|Gdi{B(oXGrcqS4vHc><_P3cX#hz8=4P*+j0N0c~~m zt5NlDhgI{>1a7mw2+>&(CJ@2l~U_Tt)QN zmB-S@%VlW)gc)$O{no0rNs&0f)^4+KKusgsYXzS0rF{{Z-rQ*rQKZyWT@~ zxHp8Sri;HC-f>xge6030CA_GgcCRe@!@EGR0w0_Jp6ZbnhMcEi`-3yjuZzWKL&Qn}3T2}~&)P{`l@o#j|8XO#+V=4FqNhltlg0mpV)_lOF z>wCT3aJk~GQm!j-?0q2ic#Y#zWpNIiA3@(F!?06$ZPU;vv%HT4T5gY;V_vDACw~<% zU=Ma4dmPkb!yg9!Rc#oy-p>kAeu9th2*3d~$?PDo^UVc!fPLfiv>TS?hPDHKK&a^n zUw7r2bPWGwZQ&Vsiiyk zGXTQNF&|BXHTgO~SEGW1k(9yanr!>%EuSU4fHV#0piL(_O7l4Pr3S|_RYpxhoIKle zWU<=);9O*4XsE$Y<>wz8kvjq@G+g~}2lWOoOv7AlZRhz3b;akZ&E&v}4p>6m0T>u7 zMvFK!OE+{EZwcALf9`TH`*F_>{~+{yd%UCR`+z$zD25P3fkp`j)Rg$jZregN=r{p>bcB?Yro5)dh zR=ZlG#$4fyr=Ky~2f=UY%eX9RVQD?Mf&;WF&k%9N=cv}Tp>147_{dUVClEW>7LGKP zw0vA?ovjO_%hPtbz0d~SxHKL%?8ad*?|cJ+o8+7K0trWNR}}$4T9NcxemQTs&6gNa z11qB;VHBJgW7C`SU4F+6q&HFIpFwZFBVH=H8s>1GOuPfwx0^5^*87D}J9^C^zoQ~m zOr#(p0&-S3ZZ?$Aspr0IhW+SZ2A(j5+XDNp>LT}TG$r&BgqZXRP4%D3Xgj)SHl}9g zza1ai-XZe#P$;=+3|L!h!wYhOBa`3tCM-2dSvTWrmX90WKs!tudpa6{K8;`@eI}oural z+$t?@hwoW+8z#sOrcSqq75a}N`BpxKVv&6XND|_uAksaSDRcr7urb&pja};?yrLXX z{@#RD^}xbHoVNzn4*F3GO`^=yw4mFl^VM?O0&!FW;5^`@`i; zc8>Xqn_>2LLx9owd3d?Fxz^sU+qKCbnK!rA-I#$4Dy@PAd+U4ZCWMk}hI13c`Qv)5OrTWZAqoO#;>nrzFost{nA z0i>WWcPe*5KN49qos6gpGtbrq;YhU$8JA|Z?98?1X6r;?t3U$-{GT{}nDyJ`I}NBE zT6Hv7*qo=EKHEi8OjoVqeRBc#G&?Njw-0v9V@OC%xX;~5zj>hh>DHj`D{}@9_k;O> zz*9hJrqWxrMNx`a?LD0>)9yys!?zM>KpNBTxY#YsP8-}5FVXmJrLXiHpFy4@w~p-N z?L}{<`%0=c=Q0>cgYM@e%;rvuvXd$3%7tGV#ol&>05aLzSFaF`+HUP?`0ehlP8`0O z^hW_6K1G|27(*y*)%VtRVxu=4kBkh{xSne~?B@spDe32I-y8HEt1sZ}J(+HBG#N?b z!NgV!zW{g#o2_Y+9qA9aYA0x;h4%wS!m?|#fFQkozq^w#wf?n|_&T@4#pmxz2z<=U z%{Rb(b*3^iGh=`$L6mn;i*8!e5aj4PLv3EJsh>)c4J_K)+D3XhzcvHFaV3a_mBPWU znBTk>pBtc*&j_NXK*?F2vK}bBYGcuRLbA}^6|%F4wtYD6kJDc5;PxamFQdei@9-_v z#~%N=^I4+cy_wQ)Ak?4*KQm5d({ljTydg;7IWY8LZ&0jCkEHfh3f;L``AW;K67gz1 zjEWa?mHcwm&#%KFxwHKEta`3Nr{1m+L2mVoO}jd;v6T#BLJHk>^$zXFRvZw7XF9%| zl4DQpUKdWX-*J+chqPzy^TI$bh;c~9S_eMuuR<{35l7xqdLq3mQ4a_bd&{`wO0-EK z;DnUB<0+NWhRpL)zXuJ zkf4h6uMooA*hn02fTXNWV|*U0b9`Z?$PrX-AbW85O*aaLK0r$*v&`oU z9W@|=jJ8c+lXbb>^MbfrCC7QKr)(3P5UKsy?-Ib6&<_Rx>NmMCb#=zvfIu#3Y)o@H1(KC+C)+)6vh=NW1~m?hkujX1<=ZVcnRhJ^GbVc; zSunRnr}5fi_+>;r04JRahfQ8#p{3L1k7+K`lf@EeunV^2F<^)IX?8zu;$KuWW_rR; zQ3zjY@RVo19IWvWV$H{YQq#y~E`(jPqK{jFi@8Cv4Id|s(lf^8z!(MX0c8lj3F4{h# zmPm)?FQe|z)HS=uhkN+s?(3{ywR8IW!OglEy~o$=v!__0y6tQlQVttQJ3UW7`Q7gu z+@+P?avJXZIQcXA?fSvtW2=Yn-D~*nLxB3y#WTY1mNvX&c62fv-d_WB{$hGp>p^#F zN_9QyP;e=+Y(!rF*Q*0q;TektjzRGH#*Mk)?D-;!^Bocg^-32DH>;^BO%XGp|H=3w z#8gS9*9qcw&F?l~=)UKJ(o7`fQ}yj{RX-*7I(?Ab#X3;}ut9~#7adHR5eB(`P3bQ- zRDdshcaJlRx)o9j2P`Ow?oC{xqATn@kO;svH#$5J_yKS*U=N8xY-JP87Q1*po+&g} z9J)sEeP7Ys;z^1a{zJs8brbF!2E`l2w3p~nAajH*8w|xPJ@PLzYnI#ic24F<1pRzc zhT^4A_L_+U;;yEqM|H&VjEnHidYc-9=x8m_FHF!)(xI(-lyn+vRR$3RNz5@Z?ozuT_2F+<+zF>n2 zRE@}@DLxB>gkCp{ZLqhwYZX>`{k3{&zp_NGkoJ-jfABRa@z64;dCPh@b_@=*#I4?! zJbE)xl_1h_b0Zd8rW)z$;K1@c?!VJK{1j0#t5UlbcY58V1M>u8x&C*@d~JK~1!RBB za&;{cV>5gG2Rrmqv7yf@jI-5dTA0zLQs_YhbM*l`Hl|_i^L+*Fn+T5O!a~escLCqK zlecOH9Z&sX+|)Xgkny#EHBy(3`WD~oVdW_U{hx6VnFSH~gW3Dl$A=v(Ptqg7pUsk? z5J$p@Q@0GFvGLJ6-6*0ze^I*H79Z|!H$iOY48Uj1TV6xpcH?wEURjoxXa{prB$DR^ z=EB8TEH=`fu?Okxc(vZ04##x$3@+mv-Bou73dJSH2D}vd<=U{%bOj6K|F|RR(r|x? zWgDrtG)0pA{_tw7HmjI^TL1VJvjShaWJnt%62AfB!FO1x`@+nmQs)~+;LwE@2@jdp zDXK1>cAX6=%txA`2$4_cu|`SbFhbBM(}GXqccfu7)yC=E)o06fY9r=Fi9GPaA}+LT zoQ{-DWF~ZYmCS=o`!>onCf$N#Xf7_><`?#@Yn5i|@bY}n@Z4`AYx;)gkz(P7m)1WE zumB~oi*?vYK2DXLJbcQZ_#&jIZgi`hg_jPpt4%sEGUo8n);1ay7LWZiVMs06z;uW7 zfPoSvEBg;pbHMjsDCgP6&#sXIjiEw5t# z8;Q*XOZ|oq2fx$p$GAzB>ukxse31x33DI-z{I&BqsPm?lNn z3l`biq!Fi$^Ka9$F=r53%SpM-*ADAf-*ANCQ1QBAx9IUVP)8;eJuTYw3@DR9zS!HZ&W9l9RC@3dB(bbHLeomKCvR_Ki+(nyc zNz2Tn6&zhbmC^&_Suv<#QPa|yY2wi+7~2g8;l4m?J{f7Q?f?Zwsi`ZGZ4XoD%#*O$ zA)>Uxm#rXG2+sI(dLlLNl6J(95^2~5OUL%>Ydk70JU(2uXS~E}nEuRzDtvd1T67Tj zU9&>J;}*61NNXi}K6Tjnq#~Y#$10)N`onTl?JoTaD4qul69V>4qD7J_){S!JdL4w> z0pJmct}Og;ou;k1zS`{rYCaAdY_HaamKOp73%X~Ix9yMI@e3K|Y~@#!pdNoo>9Gdy zMqRVosNAI&`sZQY?({_6)bvf*go4tQ8>olUMTBS+OA|ia zcn4_oAXo*KCE^{k!Dlp}oM`m!d5e;j6*G9BqQTX!`x;0!KqLWU2{8zYgpx34`CD~h z^{)%t-=k%+s;Vjr*A}bX2SPO_JQS;^NrHGUqkA zazd`PkNM4!^`gi}?Z{2A>g-4kBLgaB=b$l`ls-V%h~C=)FVBPvN7MPzY0(t@L;p5u{lXoY{Pq@6l!(#h`mgdjCys&jT={E#k_RGph@19h z=UVo&k6`4B!UQ{r1vJRyF!2Aw8mq?@gYbYW!K^ZzBXD^ldd7l=qmEBG9|2*5rvAwN z84^g<`WYBDSEw|vDGS{)pCY3q-{D^<^B`vUZ=EwcTJb7V71{pEkisHq(R1iThPB~b z>1N29Ne_w{;CP6(U3vH{wN#cSCn9F7h&XMb%~lvtImjjxqU6gZhi2#abx~1Jj3PTf z%ym4rNQ$D^|ICxY7iB*lNB?kfj8f*kR_khNZhoV{{-;cS>6pn&Mma%Y?Zd59_g)wxklX{kc0}3IC zfhFFkloS%!a7kGD9&zF^kdcuwpIoRk>K2C~P5NZrKyfWTC;;di-|JUSag;`l`84FO zR+BL|uC72_e`!<^)LQG4Audvkj*iYi9uXaV89J>8#(`#Sg7WbMFm~N@0M|!9<+0-5 zi7TB7Xl((MvlL)KNyUF-bPD7Ox%`>XoxwlAGk<=#_NtN0uA!3*NwZV~3-Hd+SyPw& zS*+;-1u}pnQFA%2OdlOodM}6Kl|<1u_FY*(LG!afL9*HHaAZ6zk@!v<#%xM=ewm=h z#fxpWtDM|#o9I0Ho!Q~f#4tbVev1Qt&!8T7+t`Ne-Be4HT6B|1B>6+mY^4g3q5@GmpdjgZ9f|mx&o(C z7q!{G|q|s*&+_mj7#!SQ$VPT*e`F!?&JvG{899X^rFz1Lf2uo!yH{>;ig6p<sIsa2K-KJ)=%WoXFw)=CI6?-tAdaW{7Y6i@SI@JmJ67YOvIi zI%N8Ma98Pp^gh*JEgulD#zlMbho`R4ea7X0p`2eQpm}r??6H$jw=%Ldx+6d+JC$`4+x6S%q?)g7HkY2c0ZXf4nBia0)z9xM;i?R zjx`2FIvf%XI6&^4X}sXbIj;wFq5b^GCE@rg*2Q_Xe)sX33E`k&vg;E~gO9c7jUZPa zc}*o>Ht!ask8H73Fs|yr!rMQ68e_h@9$s&80d2eDMaOW34u5PYf-|%zb)feGiRA;_ zNQhkqlyE(P8ByLK17+KEJ=I_0Wz|`ND*{B4G@-iY!qlNERjs!}`Q&U|>@D>{GFF~^ zDwp|QB7Pw#$AUMTkK2NR@GGML@h~X1)D3D<$3GL#aD%Kg_=3A)5`T7K&k9|EAKj9W z-%={BvLOrex$SX{T=e?8U!QI}{P-}5@K9&75D0LGKS@h8rN~n|2ZY&2az9Yw(`X}i zEn?5AMo@`m{l#CGzj0E{&}%+;!S>&m_(NGiN{aHjK5~qYHZPIP{~4^>`r1+Dw0=G3 zuObo<>gue?=kO(ExrHWU$mghWXU)Dpio!y^LCE{U249z}Xe+y+M#EpP)(49*sI!cg zp1wCYb=}afq#bAtoO7m(-4bEk$YdXG5<82W6$88+Npq@cQ{h<{UuDV|QZkn6Haa;} zn#^ZE3Y=X8aGYmvuKQAOG{3?Bd|+5mvQ zBbOH9+O04|p}W{)ZHg0RBxA}YsaE9X&o^l$C7dgAFxL#HDQ3hG=w??YGZJ9at%nb{ zXzk+Wv?mhcJp|C~Gh7LG>WfuaOvtP&@4SKZda~UuK)s;E=$_XgcAboHk9V|}02yxp zOnZx;F8jU4F201)1-W0)y8|J}c%$btVA}rkv?1c1cDjr?AFYGW_YFEKQ;DjpRsN`| zE_7l#uhfXv#(0oe2vo6R0+{or-fnr#9uOE>HRf2x#>OO+)qbo(+5Px85=)``_2QMTZinmCI$O6bN(SWg>IS3@|3>GX zE-J}w*Zo;!-J-ttfiR{G{9(HjeOy;Uuuuym8O)6*wT_#8+Zd*#2pZ+O3%h$*{GXdW z&%j(4fuGIik(te)%L<27@K%ZYtm^(`QDDAx7`gy-fBd2h(ZB5%#+v)t^_uEQ!AfI*z=(PCFal0oNeE;9_T^FN(Odb2Vq&L&VLkZgez z=@X5qvESp_ zIK$Nq4HH7Ol%%AdL&xzI?GH~?R8+<`D-F`xp-xFRnVZq52Nkh}?NY;}dsEyD1U^}$R|-)w`-h`vxL}d*Aj@;@+(yrX zgOP6@&o5*Wm}=2a&R9Kc2VQ7iP&mUYFOQ;RFWKuetB6wVCRQwfRj8&w58j-J8j?Tr@* zp!Bs#d=7u^H$R5%W*fYb9WYal65-v~CqVd2m9A1OX+2*|aUb-S49b@ZkSu)!vK$mKEJd5 zwg902EtwRkllDB3R6uD~{Ih2sI}2JcsMO@dGae!V&{MpvM!XyoI_?2cY{Uym!-!-4 z@5M^B)dtAp+-e=jkuwCkp?%8nbAdZ!G4XT$KYM-bVU7fb=kB1%F25jcOD{{7VEYG{(5(Z~=fk;^RuV%qMIwOYtM@|)4y zeJnqx5;PjdKhpuqy!f57$;FRqomqFM$Y*r7?)O28a+h%#;Rg6Be^L{5%_zDm}Wp#MZ?L7cl|k+bDyN4XWTaLtnx`GSL163I za5(}8b}#cyt!=tqskw22+>lQq8+ybZ`j3V@wh{wjwEib;9qWh3-3EKHwUsrhDz!2O z>MVbWtu&;2#;tAU>q59m87=XjJgEc#2;X;yFSO6cM&Dh78)~7VUg<8t#PoTmPx-d& z52e|}7)Sm4TB`#mb9X1L_%@&bamKeDSQ0V4N#Yu*wG~1XHwTe|0gh6eGMbTPXH~n- z)?&wJ?9n+X6aUJ~Nz}{fm4Q$pM!%xG{Ez=})iI$#EDZLnHirt(cF*#O3Pun!$juKm z*77Zh9&Iv>QZ#420AG`B3lJuwT5*}wbralxH6i_}e|H!T_a|f27v0VNt%+u`@U-4= z3S@HzJE61`flF2rPO z@XyUH9UJcrCzixO^;?0MvAiqk>Gk|=v4ip`w2{EJ$}%o|1|ee8MT2GJf3`a0h~clH z!bY1@n0Qlxy+r1$5M11UUPg}Uut=x;^>@YO91LT9m?uPajN*C9j#kO2hx1j4oeAuS zz+C0Hj_m57_>G^A@eb#$b5sl6@jZr{8*>SdC;XhzOB$M4!#@yeTFh(X4uAL$z~YEt zl-UX7hT&~ZNJXnF0VqyTUXgN{e&Snd1&C(8p6q3W84qIecf4jx1D})E!Be0TcDr(N zOe<~EVO%<#$PLo|@Ft#7sSl7KxY7WuI3Cu{In}hMk|)M@!)3w0V0qr;y5G0$Ue5T@ zQ;bc;g!&FtEHK9DALb`OKyC(cf3gMdRoWvK$G#d;ttTUgKfJwC`g)4yYsR%qV?b+v zBCsSJI=#oxoyg&3=KB+Bf^I18hIs*%?^UP#el<>V^mvag$iJ5%~BUM-AuvrvA6sk%s@m zGyK)xoVWqq?ZuYauwBkEUAS6w#^NYpO6yHTByr*U`5%Zhub-^eeA}>jS!RF=+OBa2 zz1uradg#$KWvAGorr8|=Sep|lKRIZu=us5vW7490xILhTFvYdU-+3g3lUlI_CH;LH z=r_cZ2S~fMldV}}p>Z!ffSK3^`E-ymI|Y4B942x(^Mgk*PqM?y4tj^v=J5b=`@H^4 z(h@aj)$(US>f$FDif)rlW{VVX{+$wYHTjmxbuyL(5Kp~fRK6efgeZNljP3waaLu&~ zjG;6%FvTekF5ye9Lg9zavzUtcieL6|A%K8aXUlHxc2QSCY3b-YB$E0P=gi#IVln<* z6LWiiDP+^T{moErBENQVm?o{`CX%`(N!TMI$I|=H0Y6`4NK3Yz=^?oTT#VH9S<~&} z<`yXKBspo_uF@e;_%mGv%5W#D$MyX|M0T~V%I%Wtj2i!RS4x% z+hU#VFf)pCc?QG9OpyxhMPJ(B8W8Oyd9ZS;R)XReGrWHHut{F}q@M#u^gl3J6)vmk z*T+ilV+A(v^_UIDxW1;k_;+&ysJbOSg1sq6o{ zA5+>oUM=r+09m*kaV4&*WBS_Pwi(kSJJZm}CL?n1os$xz=BLYl*l%1W`5ET!mbYNJ zL#t=(US>A#_Vd!T=TWVG=~2K}*$yn6#Nh3dV(a(!02#EHKsIHQ z$3xKDh~S&aZ#LXvH(zPgNK{faTo0TgzZ>o^emMeX)r}@)%F!y&QIY?gV&PC_cd7Z+B@ZtRE46PHa&)Bdp%~gZH-3wFB(qz2`Kpl;e9$T!AXb=OzR%)a*Cqp1 zm}IK+`%RAx_5taI(7Pl@AE7v2g;(1sO1a=Q(t1C9Ayxv`i|4?*w*H-w-|M_6^~3f{ zb83j;f(02ya*>|*VXdxuA8t$l+dk0<9s7wjc!#Zi{mhJkh^|LjF7%SJvKW9Wf9#|( zpmqGLNj)~FO}kFSmW*y$25*E^9wtNSbY&ajyOC zx10oue&v2*fK&M#DFsC&XgPxPIJ<{;x&n4#?2AJ(%+<_b&u6=c#P@Lg_<(Z^W~{Br z82oQS3}JskL2@Ms9f}tZf8(${Tk1dmfoyZ779cobdYEwZ!N?^e(u-$}kOCPWik)p~ zv|xbC#E~IxKZEofPY1sryF7@|6%fo0@6GZLC8v`3l&|mJP7vIM^kcN(+OI=7GYC-Z zltlg}><)j|YvvVF(H`xvLf|&r6|439Wn14#RmfLw`>U^9XJt}R-#~-BZ~0eIxI}?qcF<67{+)%C=NKyZZO}*A9#e)&d7z_%Fvm#=Ozl3s5DSh zoU?>Ixt5GGkt)dcsmD+<*31dR$N*`WkM8z!YHCFNFZfHq`S;%_iY7a5h*}=+TGcRx-aOCZ+5Ht|kJPW{ zXxf&j4i5YB>caJyX}S=6U^*Xp6lKkTgvKv7xpo6{O4n;m22)sh#A(!pbhUwGmm{h_ z%ftcv7HN(*iD6vm8>hz0qm&5kOd1=LGaB zzf)lHaH|jJ{5Aobff7Hk)Q&vUFI(ln+yh3tzP07MB_Le?hYu$(B28sjW?>IMx*3`f)bjF%(Jko<{@?=TXI<>nHa5 zTAjOcvA%`wd{1BLc)3)&jQA8@@DDKN&!UM()3y@`NS}T0Z*oD9%7Hlx4tlq%InP>^ zGkPuX85MiLC^dy0wo>8}%?dk&aZmyn189GsYlanUKasX$f|`cAop%^Z`&L}>`zz3Q zG2%RRcYUT1Lp}m5F!CW%$1AN0aM~b(lZ*Pyv#O=Pw2VuY66NX2c>uDDDaW|s+}#N5 zN%O9%z{@NQ>h0b+djcBQ*kZG?^l5IY^AH{d*y<+Q8m#{FWo2b?aI!*g z$1aE9);Q6`Wr71F_QRtW8k$ITZ*9Ma7;y)Tur{a`5WukDo4{8?{%19i&IuQ~b+;=xdc? zz_Y5YXxJwJxXnj6avwpx7zEVPO&bQ|Ul-5eZbc}Sxcn0a1_lV=gjK;kt2sYpCY`mO zgZqrgI698V2no>!^}jYJC+7liNR8{)+hwBqAG(9mj{u#Xng&^d;ONa3>)q#pv9Tzq zhcF)a@m&j&b`s%Wkf+Vq^UvS z2R#LJc5T~SPstovWDjkkN|Da4v{77vL)D)~O<5Hm;*g`?J)x(m#?$U%tCU6i75~`; zmG9fMK=L=^>$rv%mB8!QGNs#bgQGG%B;^l@I%|CB6um70fnu|TY4WSy_k3TaF6<6&c5r~%%}9x6 ztpaGKz%8#)PO0nm)yc^fs6pTxZA{&hIryn%)($=W{ppJ+sQZ*}qA9WXV7x_*eXNv(?mD$r$gl+L^BqFoSTyRRSQc&AUup7tB(*@lD;B@p za3V)y09{8MM0gE98#o{-bAV{=v|Y~MRU|1l z1L!Kqmm_XC0hu&ctx)l~S^?y=iz8{B?bgvASR0UPjJi=kuK}2sm{vY#=+uSZ)7!fa z9F8w@9YQb&M`#3qjs8rYfA`Ny>p#dk0eY;UK-=2UKI^c4_w5Z90mFkZN$BxH4Jxpf z@n<$nl!H&{=$iLiTa*{WXhB#D1QP=RRM7+H_vWZ(SE3x7q1N!WjRPUHARiHNBjCUW zlP1LM@tI<#H+0Ixa$w|3X#beh_0+<1G!=TAgwG1y0hw|t#eLgFnk*=D`e{-2e)YHz z;*7(URx-c_nBfljj|B&S`35h47PqDG*=MoL(}&h<_D5gNK6SvjYQ0>d*n*VV*1z`jNO5cLqy1Pr0OHWrbmilg-Nc{)n-hypU0Es-`1Fh@ zaCDfB-2)m?(%hT@1)Ka6u)3fKs5v#7sP4SG(-?p-#WT7Xq>TAd5FD*rkWnBEBUa-1MyT9Wb#{%|CNE|N?l zl3X=~B&csO36ar+uLf@Lg!&0}Rpj!z2vg8g>pyP0hQ%*{^6_XJgc$08z@KVP76;=Y|sYKOH!< zT)Xrh1jOvghQQNVztZ6&K{~tWneYPK{K_0q2Fyac7-B%I<_GOssK!``L96hHC>)ip zR?n{lU!gREjS+?J285w6AmqP-1@3>EEdgd7R?7nw<^m-dMMW43aVAd0=NeAxhY@XD zdZ#}rA?w^CB+w5GZb#8v_}lN8O>?QG-Y!bZDN1%a)FTyQWyvn#E-ge3ugaUM3g?s_rHupCYs{*ALIMwuo>9Y z@kgH*MZU^`71;tQmUggXpuT$Y7>`Wo;w>%9uQz{(7LajS-_mf45Z=afRhia?C^N{X zz!_LtS{Bq?48+nxd%qwQk|pOJfwqo5S)|aegHAJ7i2(O9C!;hf4Hk|iEU?JBqz7DO zuFzV+#3ya>{i{A_k;UPLVXRf5x%R7V62zmx?~6_41BC}QixGpLf%hR#2G+mzrE$=B zf)`sahPd+B6{v${h4^jLCV@SOJ9J=jv*S;_Fx1q-@V4#4fgod@s=6U0udI(}v+_&`osCHnoB9J+RMN|HlWF z@}S`sghpWMo=+bZPswaz=mGBfde6*TkCn!LzN@7oGV%&#TMr(^~It-O$dmZ`5p`O+Jx5pEnC*ufQt| zy}s6#{NF7Lk`3GvYKv(Za%?GeZ=&gUB~-yoHn8u?B7j z;hh29^vaF8%qU9rRg8E>LSE<3r+)qv&VweEq)t9tj_@t)s}(X%s(SH=+4wratUUsErs9A zs+t5OKprhW?Weqa#LeHP-;RSw=iB(6rY_)p&}F|*5Gvz4j(Rf{i>6+h5S451RmnFP zsN=ruN=#gw%CrPr(v!bR(^FDDi9K8)PEJm)*!=<=tIOdckLEG!K6aD)@sTgQkKHt8F5n56y%j4lr>@s0O9n%doa6Iw0Qw zL&{twu})e82vN9$tQ#r%^lNknmg(TOPWu# zwZ+dcNuZ&`2j$B|;fQZ(R7#zgLq{t0l&buIvjK)Ke9SB?XqlMMfuzQ_Y9bP3vNv6v z!`^=Pi2mp$D&O9eJ0#blj@^T*C{!7k)VG&-Kg0~>TS6Ry)_bage*O>^ zGhQtZ!XHo)J_$}8ajjHKnZarUy)_|m^m2jxwJbEf^N%LSl>X#{w;WMo6eDAFHFYP8 z7v65`BkxXZe$}&5%<|vP0{3%Wyvo$a_Mx=+1v0vtRizpC1DW08azBHYaBypAaLP|I zq!-W~S$R z(DXWO>*+{O_!yR#Eb8>bvDyCz9#k%Rbze=NwXBH;anC2?}ae+hL!E(m4YrI0-o&x z;Y39KvqpU*#DH(9!__}rmBg{Er2g6|B^wdLzKp%e21i{Rkxg6sC@+K4@=giTlI8D$ z=T7kv8d>U(KQp^5p`af_KkhsxbfBo6P)u=)V5P;K#&6=j`s^(e>VN+QxcJ`!R+od5 z@T{com}M!lWAJWWLK(86tLNMg zu!^*oKdl^Y?g9=Qohq_|g zDAZ({FRrJ{j__)C51Hd=VSm?f2^lUgdO8o# zu~Dy{5-P1IPkAO|JNAC7e)-o%*lqhK;3>z!!D;-ndjwTl*{by~>RNsHG5?$K_ym3>RevwrgP0_xNozGZrBs9gt4z ze8I=p{(ui2*9woTWs819g8dG5J-C>!%;~cnf$?0FMq10<0(^)hncog zkweXQN9HCmZN3r*1D$l&lc(?NwI1sqKFs{E`a?IjXm49jqHSW9 z_e~keBZK#MeFQcM&@Jcxl+TWJ{A?O4m0#9rONDomQs0V3&+&)SOOxg>Bjr^nD)sGnyBVS=B@n~7E8VPCEz>(;xZ`|hpHTFe{Oi^ zjDGK|8|QPtWpevnK7&FU9qi)Zlqe@rRz1~SV_r~{eWCFE*LSLfmQ`)OBGZ?myaW20 zkoLLK+3;CD4eLZwxVKT{lREaT`HQty^lz3o13Pn2AS5|JRsRF<*}rvn_|4}3)l=j3 zS;ThHm7evB%5t?6bglX#d3dz2?h>_TH{*E`wKp6^CGSe;LiNG*a|i^OQQ`XZ;2x_V z3b&@~(n_zEO|fcAige*|u|w4B6)6OwzMV-!n*Z+4n5=;X>xe#Bc1f_-WG?TuUZf@x{D)J77(( zEnAOUIN84~+@31hnC^{n?9bY&>2TyQ)?W04pU20!(+g31cCXu7i;l=RsX2tHa~Q}Oo`>vD3(#?YDN7W5nYrE#=tws^-)6+P=oTxaxZ^kOl0I0>pE z1(lT(3&N3doKo+hf^siymg}%6C@38A6JQU=AmfYW&T`|?=*=~(H&d_6a*cdj?VvZP z%7a%>nULlGXIqxda8|mFNxNv6E3Ym$ZXDVXZE^h$#a^$)p}nIYO<(e=?M3RRBV>Bw zprSyNt?b0<%CdVtzp4};#Z$sTCN}#Fy*uxAwQ7aaw++qjPBFTYX;XWJsD6qRyuOsv z-@NotF(zyKjYzF>R5mS$v+%!{p6nHs;iD`-f+ z>0Wk5i>6N4Z7lITXaR$$ zmg3V$x9}sebSN!Tf@*JX?;lO=&mPd*dlF^M9oET-l@;v&EIbW|v=hM+GTr6L*@K1~ zT+l+~!K)^T4!-@*zFF=q=Z*qDQHSE7zmX#_FvB)`8PBK1AWm zT8Xkp7BXbtWppLCSQRlY%?&p7@)dDMCGRp(?N<|C(h8DYQ>LKgt9KC+6IRVfQe}_t z$V2U7(O2B`zDh8`ZX@KF+elu01$#yZYujZX!6QBFDxG57SaVqK9rZO!p{F~wAQ5JJ zg&eC?!592G9_hAMgTt)JChu51b-A=pnWk20l4glMS@Gxlh%6b__+CP=U3 z;5oD1GP@O1YdeVbC(|AW#?5s~X19-VZ-u`s)3avr zK`qFc8apaoBpbKb+B&C}nFsBX&A5I$QW*W(WSjjSM~0g@$r`GV6+8b&^67m#)epl= zOT=s3%CaYZXnr*>you(%DhkLZCMA9S+Cu)hJ1{xDthToHnLId7391#%HhVVJil^*! z8brxOrACc4a@EMi?3!H4s$*Ht=ob24Sw+%)npVMZM@`WpIN9A2_O1Ktc%0=%Ii4xa z8s6=a&-&PObzd*{eq+8HD>i|XG>*ZXXM9I9)En}wmu_+H1;UgoqFc)egiE89U&Q8$ z5o1}SxjQJVhB-DI%TjJ%9*v5up#N*Hh^B>mD#b7KtNY97pA5{c_S zG`KT!eTF^9oJu9xD1^46|BC8Vw7jU^)*6NN;R*HdD^8n{%j^5>(53@3xTYL+s^@MB z$oAIOEUN#4=(O#V?Dd+X?_mj!g=aN;5q3k_k$1XxLW3I7;}?vQ!6%;A!=dAK zu20$7(c2d5Hj+j+M3|*vH1mAh^`V13f8z|?)k?Cu+LNu?%5j`dPZ+}>))a@F5I0op zdYMya+->Kx>l1mzLS{Lmx@gIFkH7ctc!5*h3Ei&_3{g$CGs@hepxoS{WvyoMXo*fH zH+jzVYd&1K_gRB^UctUV&s?S#TRW+e+QMtkYbL(C8Y4G%r^yM+I}sy;v>J z%g-CMTE>M4T;tS`P>^aCMu+}BAiSbsk~Ymsoq>-J00As$>24) zU;8CCuZHHNhB~=(KiZUd1i1eSZEktX1N7Tf{7UV|3Y6Wy|2sh zF{^3RhQ)=Y178fHw&n@p*wl5v$SxfT_u#@gvqUN^NP{gG2HRrqglosv>&%k4DqjJqMcc1e%f^K~K>_HXYp8H)J` zHrzYQKDTd~fA!9OdyKpBdi_nZA6km}Raj`c1Ujqx>5?=>*;%U0^5W z#r0YdvS-m6Y54y^@*s93>vAvaXRjD#CB$EsYVc+saWxXfHffzV&uhQ+kj%lAB045W zZjx8`iU+(8gLY*zDK9MZHUBAD7k@THU?l zKp1@|oG3yiBByf6*RKfq^z?s>#*mKdfT3Y(3L&4SQGf$*MXUyG;&g*6Yxy@qO#zNuP?IIlN2^&kF*_%5{8%VY-KzW1Z0mpd!vzV24D zc_?AE0a6)x2OC@&!~BJp!E=X}#6)c}wD%^gm?r;+r?ZTU>ifd|P}1EXT_W8|T6BpZ z4bmaq-Cfe1qJT(u42?8Mi38FN0z*p2-Shk3dwnr4)X$kSXP>>++Iz3(`xwtBLwxv+ z{zX8Qw5=e_X=wSlF!tpV6qv80DBLyzz36GtESGUjHrBP)d*cZ6&n+#Kt8aDp^8ocR zL)7gl6*cuSXa=z9&b9*4oAXUomTK}(*^|e;huZ=;{&$KeiC;4f`kay`9X*&vdK)4a zJc~t!R!9zuHE|vqi$VLq2t_+SaK~z7odL6%m9wcXpsijTXf(mM7ia0(F4V zOtqF%37I!MW`Fw)|EAu$tWk~Izo+w!>D{$y4RbV#jR&@RS2Jr`!mrr>f}&(?Z7qdk z@B8&Xm-{=g=HgY;-T#@vhoWArg!Cg6lQ$x;3U{17D&GP8A|D*=Lx|fk7DuYVakpZpWXg;m#i=@>%Vj*eM-W)obf;ZMOU+ zFcp<ZkO)lV0u;m_8Tll}}&u83pBp0nY>n!n= ziZ&UB1;0;1veA_p6yd_p+*#HM9P)V@lG`y6E{yv7@YusvH?_uNy>K)ax-_&j8Ehz9 z^Gt{Y$}ZTg_a1FzyBD0ytx8+hU{itShEq#g0E6Q4BnEHWubW%_Y1G18PTva`u0odeur=t3=&5#i^EO$v8RMZkHDhz28|f zr&Vt{Sg_nNjhEcAPaBAr`xJNNxjbS5Gm{LE8L1|`(`8;3^IcX3FH=osRC9CV|KrNy}mKWX{=SCG`$6&H(qp5BazO ze)3PKUqhpLzu562YwoQ0f7t#scE5GtVBs)6n=ltFM0qo5jrMtpI9>dOv9Yl(7mYE} zYzZ2Vb&U^DyqJKlJYGj(Z73j2A2oH};dUDlC=`{Imve6W-UA=4ME;a_^Wu_X+zItm zc{u-Ata*|cXsPQvksacA#hykxdlYS)2?86@3>y|Lh4435pj{_pk)nGFY2M3aRW2>P zz;>vHkM{6DsbSS~IV8_1c?0ROJ+k8A8;K(QwZ)g;aL)YIC4^CIHboimTVtJ7W&c_Q z&pl(7L0{&T4v(57o)qBxT1miT5y1O_ex3D+R}^TzZqJ(IQ^8I@rF#T-X^}VKPuP3y z)^F{XYrwm+%D!x_pN-MeifyTZGt5qtPJE<%GM|xQd?RD7-Ju4lU43=0a{o~B zxh@I)c_ss?~;BN7N1h^=3;&-AU;BEk6+JqLRC zx0CQZu_=X3%VajP-c`^3bCFn%61O*H7V^asW9#?t!ZKB_gcd#<0LMvI@kOkitSuBv zCu7M&5?gBa<-hSG%2Zd>hYgm(I)+~ydSH!qjET|hu6*GYj=3rRA#+=?8rCRAd=>st z=Hx1|$J74q*Cz5^s~J!;I;BBbrM9!Avk6+9lGs>Mxi{gO8RqiEveg8)md1^w)@vVc z+e<48;T4}gee!^|w(_5xobZ32cRu0Xc`RJZt-;?)pTgJrB;`5x_)iL^BKyo6%){QU z7oU@N34X2Z^{{rPv}dZ!amY8Ye|WEM5O;g)`?V}O8mp^z;@2^6m5Q`Hro*x)moOWzp zX1J#nSWrfJFQ2!X#3V*Qo4*mj(wVS9MeBDtA-Jgw3)6xB#4vrHs+HI;e2MS6sC{<) zG=IFQyS7{lvLSbsD8{I*Db(@BcVnV*O>M?~sXFO}yB%TeM*%y!1(HyHK2eS6NrNK# z+!N*8B8nUnEiAvU(C8EA?d>_J2am>bVrC|$j!Ac>VQfE8$s!tf*MM&HrKKfXib6!T z4$QzK_w*NX=t7Fy5_+A*n6v#mgsO8_rL?c3tOIN0`gx!@wr2Qv1WIEVI?|}LV6dFf z*p3&eT$}G#HYvp(2NvVg^QRep(U;%$Q3h_@Y3r2U66L*H!l?^dq51=Ywf%G65t-}R zzF-gjg}YBst)(8JP?VhSxjzRWD$*p{kNolB{-gf_@1u^cn8|Bn7Z@|C`f{@vIEnD- z-R>gg!`+9fSOP-l5;;w_099HaYDdPJ>nIB&9 z)DL$ynZI9JB83RcAKwTE2IE}%Yg3PoSL{9QDllRQcOzAdeoHkRq;mDKCR=IK-26y~ z%>8fcp*rIE?+j7uh}_K%3%4(c9#C7;pipDs>1w$vz9i}dT{v$l z)RhvY(j|$yWRdW}PFv(jI(6h-<{XX(3bSRM_Txu}%!LaRT#6?GDj|OeHcVe$@?Ga; zw^YItdCS&XpWEmx@rZ6b`*k8NX7G-#Z?Ub;=-kHt;KplmxtD$4dnqu3WeC$0GumK> z2^qsUq;qa4d-j};7>c5EJ}hIKzzAaxa2pm863$C9f$7xMG_iAWh3(v-RoOFdl0XqM zIdMRIBmj0dnRV{gK0adaKE2DC@&l3Iamj1jxSLqj2x!^@J&%IW9e>YRe$lPm16Wl# zHih;e4lEY|Kc;em{+=FYu~2NgGHA~TH&*w(HxIkVYwK!;YuP039~LxI<03sz-0kjd z6`AwpgdLgM#qrprP3T6kl3m-h`ajDV#^rgaQ*6SOhrEMxe=0e)%p=z!zbWQDVZ*Oq zFu1cz|zjAwTSN4KmCwx4abJc7|MP)|Qu@rO> z^F@vl#m60NIothCzhb3ezj{0}5-Zsn)FsWi5wl|VBwar;o&0&b&*RZzfyw*WK*0)Iaro$p{W2cPViAsDMW-BU6U#h6!ebXWXhU&&J_~P4kRd@Hs zx)fv>bzF8<7M10}R0ORzhMk?A+)IV$)Fl-Lbz2j-yt$|Uf^H5YHcyR#-s0`kBG}|V zy=2aLk^aV&l$L5fEQU*43~GzU_c)|g%IzLKwrOUV*J-vxO~&q38?xL!KOP4S9t6%A z{TNWm@Qd$rZS_f3jZzil{8CMDeA@bT#FRa<>ST8loKx}2mu}oW5q72v9>n?NyY9*5 zk)O1%QzN{$o#8t1v_<3Okt*Em`mHk;-REj?nJG5@<0I7$9c5PD2&}?G-JiR2mfltd zYc`&fRj*9+5AQw0v2+_%uFhR+^z>pLvk!Pf!KPWs&TNYdn?}{@LP~-O?0Gyp9F2#~ zbMnuhXpJu#58t1XK_htP==WsAlA*0H3;tTiI4bk;JEFciPfRlxf}AHp`sZ@!>$tj% znQVm#>N(pmNvmY5rNZX;{Hhmnx!M2iI8@4Yp}NHwx7L0_QMDn=R_(o<%iob!#a=e` zOcDvav|dx+DCsgFOuxyA+sPSzIm~9z(f^5eX+%;UW9cu;4DWp9ru~J7s(+vC#TO@D zG;;O;RcF?cIPAiVU>dsKcbBJE-nVLNvd-dMI%LN`s=Reh(3XVCq@62LbNXW(`PTN* zld=n3hecA^+;#TP(fXvN1MN(=D-GVZx6N)c?Ey9kk$>kyb!TzF!+nN?k1%b5?4q8o zZh=O$es8XefE3Soy?&HShzSsr|NH~}zP%$@DS;*ITg~{#+&Aw=#6U(*s(-@?x=s) zaoX3pqrtnPg%Jy$LiKLb#o)XP@*(_Io$+QxXSTINO_0j#no|Z;2|M(;DW4CR1|H)| zzC0{W>vh9kIpE;MR#^J&3~R@s;%Ir&gWZ+iQar>ZCo!)0Dd|>tRC!AC$ZRzEmK2@^ z3@(@tk5tBHnQxJCos`pI%tdb#JwG@zADS4DmAvXm-0Vp2OL`=!>0+BBOma)alc7-J ztB#Fb-ug#(J0#$Py1xE?iig;gf3Q}r%g^VPeQw@(We0ZYG9PcL+rXnukDa6N|Vt_Ie*7q3&Mo9CHh?64L68rw&= zo5)05e{-X=jZoEmCh~uXBl8uoot5nJ9>FvDgrAvRfY)P-(^DsZl4#76;&iJoq-Db7 zYtD&TwRsZiz~HyhI~wuBbM(tX?nvnvtXKcHBSU(m=f4E!resx`{1Eti1$c7KfE0D5 zxcl?vE#g}Ig6#&yzlq}GwGkPRx_r4$8^;TOo$_)=Djg}>+IvjXHu=WdG-`?9_iV8& zeB|=yA6xbe@qTV>=`N>lgsU0)#gPw{CA6kFi#j7?FO8pmdWm+JVY{7j=%OUYk8S~F z%Am~~#GanHT_R&7PH5|fO2+r@6W`|qB;^pQ$(NohR2p@QrAvEZGS+2#u+V)vqN5d- z`?MW)s(WwA5j~&>U!&<-d@H({9lSwkV0kJ?2K7st^@FWG1*&~ zxY1vt z-g7eYrt&~(qsN{uEMc=&xYCPCt9G=pW_G)Gs`7;$m{NMLucg3b2+L+@AK~cr+9&Odlp!{=#MiBm*r@~vCr{d>n!;p*FEw-&l^h; zq&YyN9Im?JJ`8*}Dmmo7fg}nyH@ID_RW{^ zB5jy>+GXY^QjdEnhR(oYTMNcD6}v%HMM@XN*Pa$8DH(bj-93 z&Wq#ST=_|E5Rr@!N@a4^EZS~|F=^%}n|bBCsGTZOUHTQvJwLNR^zAzxD zq2|nlJLlCaoD0}ox^#@Yu!NqO@~w2r`vHw>_p={144)2KTJz$Bk5@(T(Hy)32eb#vXMg5UZG{`oUsBeaQa zXg+^l1=&wn|An(sa0{2jco8gowOuQGb$D>{;D(9}sxZGL_PrqVjT{WQD7usq^Yqk0eZun5&V44Y&x;f3ctfLz)ra{C_CmpYQs)xh9)C_(lMWk zE8PBb6bTD4VRdl9a<2OtCN&_>*$`vo-oDB{9rH|Err-32DE>8vR2^+MH$CN3P377ul6(?<4Uz&F zjtyU%ps~>L4xO`~@=oPWv40?g){>woB7M$Lj=a_*1HD4wXJ7FiKMMri66Ce#mFgV` z`s#5tFel_RY(rGBLAJ$PzH~+2c z^QCrQ(sT@0OKAS_M1-|&Yh8Q~S%Kqo5tT>dp*o}^b5?%J{M@mo&r>k-uQ4M8 zEt#%dAR&54LRA+S97MhD8p3 zp9rb?lm_4WTJ|!qdrmj+Phjo?-8AOr=4K>Q2`8{75db|`7)9Ph>FHX$vcMix17o<+O`0 z@wn7#^~H}NyOwNF6P2M?V!I_(F?ArfVV;r6jVyLBs5=v#(kylRg(dgc;OV5-hZeyt znM*>Q+8jdODeR_HkwI%*+_S6T%XIUN4zOCLG3~Ul>uYZ^=y5vF<^#Yq0{9NrAk)O# zr={Bc!}VOSz)$hw?OXqJI}PUF8vM=YXBZjIfn@eKaN5MGte<0E$Xm$$eC_MoWBoIm zg}lJQCziT5Kp=XoCxF3=zn|#9H_b)LcrqJfo;msQ$E6mF-BE>2F)q-i6LqY&cUN2G=hfK!;hj`6qRE+8+lZ?%5%Yr1gZNs*XA2g!4FuNWXY) z%1T0k%N?|+L=O)uFuyZ4{;Yn){h>o2+b~rl3=M5(xig@r((A75yX)eypqs0#LHAIu zkXy(FIUW~=Ic;KC>?5giC&;rnY~x))`(?s4=0zfvEHZj`XmiUynj{{VFGrkj-~}7( zl?T_7Q`1e&SLcU4PqedJe*aZYQj0W5$d2PN8xj+U#vMpMerA94OvOcq!ar<4k}h#C zrEPHij-+4*Ee}8a^zK*S;K2$p{6eA#GI`D)-`)4IE?&%Vjb>ru%{ z>KdLm!Tnmd>ip7SmbQzcQJ%%B_v zndJ2!^cAnBDXt41H_M;287H%0FV1(>j%;WTIX3(72EQr-u3LhV79SXf((51BmR{%% zMLf><6MLj_a_GWeB92~d#%ZxT|I~VYuReUblgCA;UnL{+)8tQz;t%oX+KT5qg!WlW z@qG*O3xgdRwGl=0{AAVRCqm&*PBV)A#iErjU9P^KlF-I{j(Cht7tbehG2oN5eR)Av z%6Q}{@EUJUUtD&o+q5GNmbxjPZ)mBO^W+P2eh7A2#vVcTy)S-?b$qXkQ%LjfBKf62 z>S?>~u<7iNfaNaO8CN9|%^O>1&wG_kCz}4#lx=)b{HuGqW1o(pLkA|6`h^*1kGc)P zJTnD$E{|#Xuj(BZIVX#o4j#q6Ff+K6>oAPn-5jd{rn3JLJYzV3!nTmScD|E3ha(N9 zO2n^S?y7hUP%-mRitp)$HH=MBncLW{XKj9$cCvG@wlj6KWBEd{xciWO`}YrJ@phi- zdsv-U=kwFOj}1?Qn&xbSt!kK)<f4 z$ac+9b3aWZQ$mIf+ff3s^jk`omK!OxFbUm@7W6W!Px-UyuNsE zsBZN=#Gw^)|7kQ3!1)4iweNMxDc-Ep2a;Ak_!R#)$TLQKLP9rRo2Hyv$6p$ky7DXx)@}udGEKROcaHx zTNzVY%Fc;X>12}?QrCf{Ldo)2C??^MN;>6?)&8pmf^zMY4tn!9eM4l0k&{>W| zKQZx~dH*Z>5Le}QVB@>{XD!SCvm{aO>mF>eOslGYc9!D%%+pBt@u9=j#9%F_>lZ^W zYX-8XN6vA39KB(|;J2GBfN5tkyI5lyQSQ#N@BZy$y`y+zJ;w+2UC#?ovf?uNH@G}Yem4K&9YPQd0l=nP4*&{Qj(=$s1= z0y*$u%_9h_2*gnA91qaR@@Kx$<4*5wIo&4IFQkrR8R_mmPyRM)x>*LXYED!|QYGn` zASn=Zs8D#gjF2jrvt7$Q^kvJt+qYadrMt-}_X2fXI^X`!hl_`ksBq^N97cwX&2(ob z1DKnqJOF{c#R@Y?v{_I=sDszJft^lOz@3dwSjR>CVX8WW?*1sE#_z@*_12#=BCKt5 z51BUwPtQfdLwMyd;D#C^w*u@_uq96t<9UyM9@Yotm?Tv19VZik$DNMCqxOs>DImZm z>k)nuu^?oN$g>3zQ2+Ogm+#;n&NoMXhdy+`OP+<fP<92|Dmy#rD&M(W z`DEGXgD?5-CAz*l4B$aJMxnceJVHl5z9nyibl&#yB*-yOR6JHT=G5t5R!6h_Ik4ie z+g!e7vpOHYxgs4WgW}-1PJLXP-i~7zaJx?D<>3Jrk()Qx>VP`St)#M?TwXql?qh_j zlEe>emUm;(m#w=#MJv+SE_1DP0)xPxn(FD@?niQQE|Z`^JD1{VE_7uj>)^|9jx8C@-Q zjGqo{Pe3p+30kUL;Fv?0j-f(#yy!dX$xR46RV^*ZlJWBhSwdvmJ;pS#d zrS*n&SS&+nOH2t8j>T2bt0eYHAbAK$jcYn?b(4QvpvtsZKu3xC^yw)<9WfJ!2^McH zQgPJoj}6gGc~jktc8m|S>d1vu#psiXmLE`{8J#cJ+W*6cBTO{Vifd{nQ`@9DiA>%H zdX?ADu;jU2oE4-MJsL&qw*YlQ*oXaSz3#3kgQg^gpqAdcG@cKiz=2GCW8smd)(KChO|UEV)T_+Xb$e%1;tJSF_B8<9ernf%Rhd|o8FJ=qra9=!i`kO z5GSZGf}2Z@`I08GTiBZzI!N!*F+9p|I=Q+Tl_p3<5S^n26_`ld*1HBwntn$ch$-PB z6g+SG?4K1a1LZVgJtin3@|wuvU$`JnBiA6lqb1(&&k~k){Xhmb=;K z(Iy;96!xrs(!^uVvn>HB%X8B;-$C_#crE7YO@*28vpg@JQw!FxE38xgQ&pV9=}~oF z*4!b>;Y{3f?-Jfl3xM@y@UQp!{rrr+m9}1pg8a|FdYYu_O$3+=_Vbb8n#zr$uJ*RuJ`}exGw#R_xnU&p`e(5fZ-yptMUbpa(476anPpagKl19;Y zdSGq2T9~M4HFCIEwwisU@&Lb^k>foIv3NuFs?L{*ALXXso$6^u^)eOozPz|Rd$I|S z8EvOn(yFL$iuiWkci^`an78$lMrS4*LD+*?Tif*+(G!Fb|LH3+5y|SS z6ce`_PGOgSsJ{bj+Sd2D3+cE~stBHEW%C*q0YWk;4&d#B!=p+G)(f1<>;1@tS1F`9 z7ra%*YvpH;r_No9shFUBcsE%N5tXC@$`slDTQQn&B9)-@TNrC5`5(7?Wx2vM#K`p| zUl}kwcj?Db;#b~}_Q?`ubC>9=Jg?;j>t~V(v?@st;P1f&0HXM>z+su8?`oJlkNfE} zYv^ZZGO{L16r=+Gk39Fa^>}V`_uo|4&%ffXIBL@Ub@oD?7OV{PCZMq$2@$ymteMGAv_<@Jszd1DK3mry@mjljX2K3k(t#>ITNqtl~@ zuk|kydKYYq{wWpD-Gg4mD~fIY5pndf1~0r4vGLR6_kV8cGM_JE9aC-Pr$K_L&HRUb zP(TdUL|g}zki0sDB(m`h+?E9bip zTWoe>0s=$aSBfqIjljYQ_|qsAj|OS9JrrFH9xA?8phpY6qS5hORy;j&c0w=qu#EMh zYLfV}OxoPQ=}fInLYK9*ZSF8(y`b^6u)G{c+-&TC!GBM08L|32U?Weg)=|s)>8dj) zl6cGON_DCj3-8VA{q?a>oBObPc7w0exUy%G+f>pnd2+e`=r^wiuYl30%*_RiH@>%b zX$j2#->2K^w#eB>EL+w-579=WdUoSSZcO^|9=a`J5iP+jxKT>~z3BBdD>U_(hH3H? zxvsA6-)&<|YM{PX&RWrEY=EBTyqxXE_h1xkW^Rsf^`t+$xL5}Xl|xiily^=OMoMo< zKND?WT67p4?i*TYIZXet|m7zt2QA83q)>!@=doawyN18%nGyP6!qd z2oy0rBT@K6-ADw56zgwnr9gS(rGAY+^;T@*u#Zt1Sf^?f*AhMH=E*-eUT6&54lF%v zjok0LX^nWF0h$8_?7iRX-cZR@?Y>HceUG1mGcJZn zx~rR;F~~5N6A_Z3@5nO94P6Q0&3Eo1MWUHxu4YVr^g{dA`YNlf4Y>cFx93?eM7FTs zfpaNALBVFrPYaH{xNytAhy*|o8JWVjN$>rLxGJfomsNc_qhgdi1Dbi0iJqaA3F#4u z(Fy%R$~VBTSMJMl8{9&?dJ|nT+dji;=VN45l)9BEEPZoBPd6eT8}AiCIv+wmTnqCm zO>H9=m?z8=s37Q=s8kFo6&~}Ushh355MgMxEMI8v!a9a9+kZ7dz$NM}3RI@QeNlOS zD*CR58V&rhAFv1VVVvTRSlLEsbm?*SOr{#?Noy=yM|i1PdeX zI)j`c-w=~lzBo92TBAD#gXYC{@hG!sAGgPTt3mB*BG5V+gFcW*yQ!(EV33PJci^0| z!S?31>fiC10R_FuTv39vmAd70*jl`z&9S2n_W7n;Z@%!e&kx(S+kc}wIwZA@oImhk zVPo@Q5hk+GPe%?-4wpCWPR(bY)3f|F9~H@<8RZz=jLcKjLCOw0((g6%iZ-JQz9FuI z)e^|=nfb@8xCf59hF1B7O7#10$(#dOLX7AhCS$c5Iv z`%Nd3$w^}c`s1vrrFDo!i?aQj=mMf@fKpr}ZIim&RW;y~#F|8{8q`m)?!Ck|^7POv z<}I@=>iTFAN7}|aAP~?L(%%uh+Me%4BAY#&GP}1ps?^l!Q=1BEjIpN)S0dpTSalS= zKAF4Hj*>TZIIQ@qKDNy;J2+h}?HbQBU7EqsH$UDW!U-z9Q@V zcAM@*SmUU_QZZmNJl@P%ySTZ#oQ(Gm1@vT6q9n-0GxWB;N}4rtNEfqsBKTGPgQA2j zDzTNz3OfDr<|?L@Moad6oI5d%KUdjNn8Q&ijI!yHh~$iA=XK~?C#R|g)wHqu{^Ov{N$fUFz-cQ2@i_* z`u1bZ1bBOwi7@eVjYhoK(haTbQkQ8m-uLG7*X?~WuP*as-q@KT3%t^a-xf2mk4k?a z$t~=_;WEm0T*C^A$@Wqo)m;R#G9#nJa04a_rPtr?E0p><0GT>D5#68p`NXWGV4(41 z+p|Nu=rU&Mv;a63KvN02KEgXCNo`@Ip-&D<6be$Jd?n(N0ZSZMcvKjX!DH%b;C?x4 zp7$O((fg4Z8I!9&RLQh9!~RE}U@WIY#(138eZt-c4FqBYX_8=H)@l+kIb2IVW?A@g=YZyCD(SneVgpXAnVT*VI<%^xa;>1vNwH&eagS&HGZQt*Q&9)-}M0{^V+wS)Zf2>9=o2ijo1H;&k)3^ik*AJAJ8>vk2be=r4l*L_`p245I^`>#LVPU1Y_}o zcyh<#<6>Dw(Y`Gl2e)@fihO{N{*lHTXp=^sc@8Zp{rvY%nIQe zJyj~TtU5S&_UFO$yEt+EMQruSD#cd(sE?gj4=mZN^pgntYY>bmB#V9@ ztmF##2!rrUWQ>f(>AuJyo0vRz+nNDdhs;h$$jPD39>8nSsXjyttx9i6TRZa2)aL2u z#zuGFPQ3R=(ac|Hx45@HT9C?kM79iR;+TO_SygXRcZB568>>fykIjT})M?#$)Bm8_ z^SR)imXmfsGg*rRb$*W0)ZYC2rz8=6;S>sYziICI$FSw58Q2lh(*IlNt3Zk8@B!AA zK!ztYlV$YFsQM^(ap?2$x~j`VO$d7O8hgoM`2S!x!Q^f4-@g~`re5x|_j~<1CE6fU z%)>sG1o}=xBNX6{1|}IIoiorJ^pGpUc6WAOC@YVll0Z!!$YYqZ=l4&Ti*df(KvP?J zy0ncwkp%|S_s{tPYMhTC;TQZawe3qU$IW)VG_k5KNT7G4hjy(O{%?vyuBcroUAWd| zFaI3ewJp}+Un*q3;xw`SH5L{Y!b4a?LjzR;=eWG?r}O4K0DIEc)X_dl0m2^7{-i&WWRz_7 zo!s5r$xhK)8=6~sN~OxZ_PslKCMxEdx-B{uVYVXb<88wW-GYpQ?=_>j&ABa9nlM*v zIgBsn-yBM1_EIc0*&|3-H<&H(tF22`jRX11J>FE)kzow?viWAKBcUJ@nyT)%5u82-m=0m7o zSmo8e8L>&L`PirwPLuZbK-TJfuxBFtCdf-T2zL>ZlZFQ z<-!NJ&pDzwDyel-r;k6i68F{agQL=Y>qoa*AgTKKT<+b8L2;H&PtJJc!VeNYvCPg_ z|HXAYi{ylhyO!W|^?AO|=+9enHS;rQlwlG=x3~_TD8;JzcvU)e7A?U|ZEXwfk3}?& zT1`B_p74<)+MyfFAOca+6Y1S_UD0dkw|7=lR74_)Dsg$y>XTbrF5wrBGtJ3UovIPE zr&GQ-iyQ{;pz@J7Dx;?#7v!lIn=|^Ul$d0Y3KB)YNMF`mvXV!Rh%>BlUCmN&}#)^Y>#JlD0Ltx$)f#j6^S9d($XUX1(0v zt*XO<@En~`LU{NhGJ+iKKg|8AgoZ}CAKr)PjO2uvv5N33W=ip2F#Y{6T;kn3Mj5>_ z$3H|pK%4jpn;yr39GzZdK{WU!f8da|<*dXtgxoINY@S}xf8pTdbnWBj2_btf<^gv_ zKagK=LIa>z2@#WSAHYjxa*yn;^ZMQ54UBL&v}X9)AL5g#yA*zW3`1#qj5^Vm zelWq}YRV~C%5h>}oP5Qfl=}70FMIS;!XJo;RH+GUL+$(#MUUa~eVeJ3nrVxFFVSQ zmYDi+H3W$gqb`5ysG1&S9;9s(N_P6)a}c`xH#GJ9NFx*Mq=$!mJFjfjy2YYA?yt_@ zONI{P$Rc`YpOOcvyD-9^s!DMajmsBPZSWDU&D+dRAz1^=PdgiOR4PH7l z@d}>7aODs?;!hFiSvn@{u31_`Ozu)v%Y%dOz8GI-7wfHwot>TO`Ri9CfLjhjO~bnT zJKFkMbg%EKR8L-d_|pb z;J2xO=dHDGVQKlAIRi9P;{$4zu$lJI(MqaM!l&_YM=8@@*4<~i!wKn>Y}l9xm<%FR zkvOiID2;tiZMC6*CC{BKBSX+ash7C9Yq8FiJbH*a~rhTV7_! zlR5N|blXF<_su=1`|oHUe&SfL%B*um0%jv3mJFiGy);wsw6tUhWLJ91DGSHZ+08~V z%DeNoC2r!Wt*dj<2RnXOA7l`|f(xGOfUVlg3YalYKAv{7yky^2DoQDv@__@K-M6wT zS&bc}pE{6YfzsDlOM%E2Mhf3svV=SfZQ#WP4<=Bp04?|mypm#;-og?+*^ zH9f6}PftkOIE6I!!>vJ_0&v1E?Z_O*9!%gNO~uGobGxFcsEAEPMNKG_)HAwvkb1%- z?eOvAM}|NX3*mr6k}YkBwedoSg1n-lOFF{#15xVn`?uX}GJ4YN3jgDe_XyrXd9rEF z&CERmgMDdlH|T>i&vy8U0ryn`RzeZChxz6E-yI&rsaQ)gX{{02S-jk?K2MUH3@q*f z&f&<--^KjaFNwPshu<}95cv$xE<8&BfaFX?6 zVp0W*-5lOzKa3G%(KCp&h+O$wz#nT?Eq@;O8b7`FE@v$b|2mu$?Q;>@3Meoy0DT2Q z(1vpiMoG!_^CS5EJ9}(TQxg-^1-oj1a8v7MLoqC~sy@7sxZ|dK?yXT; zqB6A2hn6GUo=x1%4S|G0A%QqNG^j{b|DNkstuI!iy@~>59f1i2@)GFv{s^{6T4}mi z-3DSQ*I7mV$QNdC@{$d8ZY3<9&gb8&q^bl$AoKvn;tBN-;pKhXHD((uA|&+QV+|Oq zxL@&g+Y2}Q-?akFrfgS?UhUx)aAZ$SN@C1MhkjqJWb-^|qGx9xQntK7LtUsmc{=i5 z8v-E!FcmD4Cj|5>+%#hT`fTdz4%GYJudvM=x}bpTiA0G8)$B7GX}Cq-|NH2sqWAY%mfyLbO->Rz)M8NyuT-; zpn!gp1_J}*E!g%-%>+D9tFxU+f2#c+m(<=0 z$Urhi0~Ajczne38a%RI;Umc)~{R~ii0>*#)?$;5!i0cC5;>pI%Hyg>SPenzuSlqps zXDif8J^}V#>Rc3A_UzbHPcOnE0od9miU2LAKJW`lD}DPp_#T{Nj!>63xdUta6AWx@ zbzsS}i7Wivp{lN_wISd8+FIJ-&(~}n&NJGK|NWgY#P;az?Ioq6`VLxEZMI@5tzW|ZNI9M|GQPUGI7C>9jbF?? zuz4JWT6F=+G75$#666;@1X4>npL0mUDF>`b(tqYlRq>k-H%puLjByj#_-s{O8d@XUq)Z)Zgvh$+v2nXFE=4TDK*XZB*F$v3FxdVrCRoSVWI`0sOV6gkmbD0jD4NBh?DGbXwJJ$kaUIDhDZuvi8(V_=D z{aO=esx-`jJ+)NfX8HiFNz6uFzO0FyHOWgc|@XD*)Yn2PFR1BK?l| zDBBx*9mrgvbj&hp9Po>CNABx+;h>VJyOXus(*YD!>Y#`5eH0OkE068u=+TjR>*Wus5PbS-kjt7UeYIY|b z03gmc06>EHT)<~Qsw_@PA&H|BdP*K*P;LPIou++PoDK`-ESo@d#A9dP($4~C5*Qc+ z{d{<{)B2QK+aL3r-!(Sf_9`_HSXzsYP+$#(B&h|k{5jtNvi!O_wl zTF3Tg?0E*lgi=pCk8J?S$P>5(`ka0M^|FKo~EqiCtP$+qkj07yekk zJYKg(s^a=pTaB1b!}8}|wZtgG%57GYjPJ{})%w3n?w_U_aC$b})aWTG#k!3Zqtyx9 z`S5VgHdtG#YTL1W1-2j!z$9IS(q@?&JIQh^s|YMaS{_vFMZHeGmbKLkpg&k*|FZx4 zrvcNmG65O#b_6^~-w5UK9=2JtLbUh7SDD6D+kkifzRFO7lv`i>2={lUElm?8*BIC& z2c~uNYl7siTdaHY4N;3gvRU%JP8^hxhM8oIt?8h=^AdGFWY5VHb^9KRHmxaQObn$& zb*yxN*=xoar4qIbE!k{vajK(0cw0cu2^2Hwwzsf7nJ#8J$hdI?;60JjkKk|KsjK_3 z?$>?9hzIlRi7b2@SY2yqf{s`v+6NHPxMthGIJN-#8v>@33m82IM~_REVB*D-VW{V3BwjLA10y9cJu?%tQ3QNq3XYwWw>)~UUmO|7IQh?0LgbM zDacgUV8U^jey-$tjQS0V{NI#-bRFtMTF|rsl&afEZNh1HrSe<7#bBP8$jFH?0FEkN z?Tvsw4cX`SyLR<}su>v--2bZz*adz-Z#A_eY6h6%#Tmi<{r8j;N{|h)DRz~9UP-=J zt=@|V)W9!@-PY*X*fVc(Ct!#53qYeeXChHiQ3t>HUY#KC{6YI)NC^}N0i1(O@J~|1 zAuwYb8)g-HO+VA> zTe?I(fa@2e0j62tcgWiywGtH?ul=QVy(N>}4n)Swrdon}RKdgD&VhXZ)H?qV%=#s@ z_K=yEv(6&_@BS_qld8bf#F*=BR(TAvMbRPAi%2atiw{TDKhpn)Q+to_QCz(eER#Uo+%kKL6t zcatFXXaM(lO6-y^VE%yanffquKq}6w?adOhIRi|639c87?2EuYN5skI{v^HA%$i+y zwI@u-Y3+@W-5(9`^8Beak6H3u$DJwHnf|8)Sjz?gb6kgMR%TzlouMgxl+aPZxc3lQe9oU%wsuRI%I|Ggv9AZEE`&;#7UcG)TWHmu=o~nE+BO~*- zZd|f%d%b5pG!)fiB$A8F7ue?^z-a%wrdj(JvPPY4Yha<|=HYm}CY?R&mVSMc4bsY; zMN6jTI~ZAt1em5Dfe#mWkxG1wh`ZgTnsBrwuovK|%AX%V9{&y93tj@_@)rawU^kk9 z{hdSO+lq?C?CJG7-NQFV>1Yh_eW1pJK)e`NxYUbd;W*s-%`3r+0N6iB=e9cq#BUXV z7MBGkzwN|2C|vC^}#dg9Yba>|vc<~Kfl6pR=^#Iy-4xBgRK znv|3z=zHlXWWS&t*mST6g&{Bb((U*6_Y>`dHy@EvA!du2sK9*;L~qzI1C)+MpyY!FB8*6$>ehb)NuRYV8<3-|jCBpK%jbrO%0!1? z-S%(aCV(k`@Kb3&8RmFu*w%bI21ZdR;NEvEPh#Fr2E17>xKKds@0?slUfS8Qx;t

K13L8FztMVH1}q&X!K$HRdLG!Mn-cfa`JE+#t&h(j z(CxNt=MjU)hT(w(IkL9=nd5|X2-dW~%F6?BhKAgB0QkjZN4igjU5?a+KSP~275?o` z%YwpH(~yvWpg`(&6(0nPw6Zd&K0)*~ZQ1R}cl!obe- zOoyKjmqDuru*B)OzBp9v!mbi?S_@rUU-uJTk#OBf0G=CFw>v@Tv=e8$)9*{)v20ob zYp_=EGLOE;1y^b!EY}BvRjJ=n2wnk@XZ)uCR=W&*?f)U`t)r^kqVC~CcS|TpNhs1F zB^}ZsAs`{$-62RE5JYJSX#@n65|M7DO9VmbmXKCje(QMO_Z#mR-~H#@F|OC~Jp0*u z?YZWfYt0RCRs8~S2h&d#VuOXHrCy_tbI#p7x7~ReRyH;cDGuG@_IiQg3lW1*(%zJ@t5PU^(P*)D>^yLuyJte%F4+FXzD}OD; zNqvL#0LxF+!J!lo`eTlH3Ag!>j30v)0e`ki6zTn!%c%ro8Kg|X=6C{*%Hx1*jY=ly)j^YPLPVU*d# z4BqAp_@LxwoT7FSWMT-(>$^Ui-_*ea#4{)fj5D+$$Hemc3K*v>pGhBM7GML1sHow| z%in!}wr8fUyRL10uilufdW{;RJdv{%2Z@*!d)4&lhr9Qi1H5ZoW*)-dj0z@gYZ$Xo z5p>*|tU}!lSWRm0nBJhz8ke9$y+4kaLGs=C7GyGd&>`y$V~sQKLx2GH6_zKqIW;hJ z^qcz1Y&5q?LosAFs6h7bVF$S@{(`j(*JO>0iZ7@nDnlCUKea;q__p>~AFV=9a9Ov_ zG3NkMmU=9+6BDq)*uF`KGX4Ue^1LRipCfs%#Qop9yaAx%@&gr@gR8V)3!%@tww&CX zsCc9greLUxx5nxFD3?|r2`Ynb2A7|YTm8;cwb84vz#I^FKy3T1$^XFXWZxR)g?hSG zJ?vEtpSJPuH^{CXJ0ppxGw> znrdpg;4HIjKK%KwaQ0;!M09YOR)J%wZD5e*QV1`y?eTci-~#e$eR z;81@frs0+L?cBBmEC2~lw*K9mUl)_jfwchqi_W@8 zRJEhvSwM{m$K~HHZiTdg@I&q>dNUpcTb=p=RojaBM@Ej$V08k2ux2oa`)AU5NDB5c z=(=9R7-Yf_=i*D@^JwldE^_Qb^rCB&WcbA#9JktW^*&20+~^@KzSf0|CvCIBH>-=b z=nJ{Rs;h=Ys7^8R$fWLKwRPCHYse?FI&jW6Ezn~Q+?z3f|f^Fj@6E>wNkE8Pxu-oAZWj;+60W3=F zG`sw5up(mfnt>fzwRwGCOiJ1mwejJ@2XWOcdQp#01E0X`hV*+)fBiM7 z;HDLQ$X1tHj=-X!hS#O_!soV0!-w+gOh{5$++Gv-VfIFOI7>Obz~uS5x;{G)HzM$S z5{tYTj5sYyB@@ZM_vF?iZ%u$dbR+RFa2iJN^|O8=p~#%3@s%JzW!)bf65f3d6NxQ^ zYnWPXS2274^yZ{*0i^{s6_4qb`~z_y2Xu_!@JzFKa7G!?+ba^n9b88E-Q!HJSc@q` zz&7?QNJD1V#>VDhKtKb9Ydz*!mk;Y2x?9;jX&m3txs%)Fbzx{$+XC|WH@;rl*O|+3 z^*{)iJ`%xG`u??bz)`M(fxLy~C<5Mz3AtPjKMDNL=_P(>Cr zopEO91;H}^uINElp$}8~lM0a`02T_S8HtUkcO?DyBj3jdXIVaWX-_r40eP@MYl zP>$A*KFnJi;reXc3TZdkIs(y%HP+R{FJmv{gV^h;$h?CAs{9g557&KX@C5|TtJ*Wu z(>-#2uBDcw{q4xR6XX*dC1*WXL`){`d!Rfj*--nEiNzN_WmK{i7#wmJo~&lL{(xwd zId2{RAUIT>9z8kKRQe6KM--OdK&BTn`OVp-pX#p!&5y4(fB3t!t)xj_z4uMA2-|#S zQjmq2yqMge(WlG=+!=aI9-Xr#Hb&LVR|@~7A5VQgX{{Uyd5{rUO`IcHn2Cg(CgYb1 z*s_W;DN56gaaOlaJ z;hGmruLOSbB~+$M@uB)ZJ5NQ9=k_ff`u<0CZcNN$%DLx=eNX7T=G;#3F8Bh@MV$x% z`js^@ugHSWeJ0w4f0s64BNV=B%X$NFjBV?kHNuFdT?P9S3_>=O3Ng1Qbjc9+_n6MJ zk_b37`}s=MF7Y0{fDPd#m-*T@FlEzXy&=UJl0jl6HjlQ)%Zw(X`C_GT;-l_WdS<#~ z@pQ)<#q-+u8OucOxLtXiO}3lPTBBjwK8Tr88Km&zUg+-HS=PBI#lPo|P(yu!TX?th zPHzFs3c#!gRFfKCpQ`22qiA6{{XOyM7oe&tFeIt7KQ(9c@gK{xV4;QRR&S&i^XmEb&MuKP?}>*9&&a)rjjXeRNMs9bBfpC>1`8Folj}M83X_GnLLRuMx-pT zIkU<(AtgF*en7)eN|_%6q&1^?gM<`EH-9I1My$QLS3 z12a$xsvEY)M4_|rL{A!kC9gRwhOdXI@WM5ju<&ll4AqaJaxncc4x?W_ZjQIGimJ?CQcVw-P`5j-d;cnauh^pu=X@%$7I) z{7XX8dm|ZbP15HKuBEe#$*r$%;+#PN(Q6{z#^hTf9i?((l$}t?`6CGqFQL{#L{Q72EDa;VbJMpb$0 zBVujJr>ydxVTlsnpVNFQ_wO4STfoNK4^uTjf5NjBUD{!)@^%;MpxnR7)l&mXN(JMX zvwz;&P)@S2dBA!5_FEB*v0@6DLRCTOL1GGsMDF?=UkrT@ z`CSr;OV${+EF>{%e&zOqf${6h`T%DYD!jBWTa>r(QTum!^C33s_c1v0eS?|%z~BkV zwJBkb_P)}VTZ}i9iGKvs>)nIOls3U4iWVW&O;N4H$m9Ika>M;@fNBb-JzTNg7rAim z59V+ZlzsPLPo9WwZ)OK>i|XrX)i~&3-inr;aF2Ps=ncKmi@xQKg3sr3g)jxqI@T1d zF`7G@E&)8;W5qIQBMdya%?REwGr@w6-v&4yy!%)REJpvtXVMInAKjm? zFHy0U^7aE7MED%w25WQh?1XYqRUjD{B6Md};Kpwdsx1lh30wG1*SQ-XDHCZgtzxc8 z$Hy@4*DMS^&{xj?LYcuIt$P|nt(1bCy)1lIpSgNVAh2H#${6Fl7Rr=q%du4reoFEpBQgXL& zf&4gy<1uj5E>UCfS|*g8P){MEDNR;N1b46DHdWL6mh-*==-_`d>H_v|7!HIY?C{oi z7-wQW6te$$td35JSAfj`qbHH2mtqcAiv@AFZc$BJXgM(lp+CD7LyUn4t&|GTD_L=t%QOjguzN}Rol)MUk6 zQlH@=9MBeJp0ICvJ~th%L5qHLY7?GM8ItTOPD37fg{b@ykWH{WOP-gsz%srBqrc?&hL#fs5N6rXCA~?Y94>L z&GEk80;okYhpwo5)I_I1{VKBiEILze1%09o=0)1|cBtb}NfKyJ;hH)~D|uW_xn1|X zxF6cl*1FX}6i#jG*Isx;Aowrv{FnFaVt0s$rm8SnTN*Zal|UHdS}-eRWU)y20cCq3 z#4=AC*igIdndKU7owg4dS=sn}zEgvb*!u`T#c0C5|1baZ7v=N0@!2Bo%-stPG&C0X z9=W7)n-s^^Nl$vxD>>Y_2$N_7j>EQ*FkRKJiSR*;A_VLi^fngmIx&dcfi#yAqLET1zCce z7lmWkBW3-Jq6K!9VxjVG`P-)QtP+jwze7K4oA}OHx8)?UsrP+*z0&iYm$cb)b->(x zG<|3q2)`+C;M-chy}u2ZO>z5l{0eMUv6!UR+8Lh=icdYJ^Iv=;v#REz_)X&`S0>{- zW#W4gQWu9wpTlQuI2eE{j(luoMA#|2t+KVs{N#M^scOlMwX4PYqzh+5-uG;MMEjJEqwu zr^&qML5dh&-0qlkYgO zB*o6TQfcOPgcbz&mh@lWR8xnTTK=I7QCw~G`Q?DnmHHG;{3v*$%t%=3q<>8|z+jof z*f;7FT~z-0W~!qTXaoLB8Iz|e;rZp!klQAS?^sMqnA0E@tA1b>TW81y6S=tsl>Iil z%X${;O3W@6Bc-Y)SG?9>PfsO8Rgn@X+87A;I02{V1BR6kAsUvcrSl7+upUlnf|~sN zUI6CpxMcyF7om16DeD)7PbiC34Z!#tEvpvA>uzG(1c@mtkG?0N<8hk$IH>uPIj*Ey zn*K%v%p9*TuGJ>0Kpa#ln*H%av(_z5VDQ;UDsP9#P1>m7a|Um7in* zOsLPeEp@&d{_jit$I{4N(eiuO2=$qdFyG~^ZV9*6UT9y9>XHKl2MKE>1<~ zjJ)ja>tlZ9eRA^o%%mZ`iqM=Y5$`@CHxkVp7toSBxey`djr}XdMA8H3j6Sr2c4mk% z3e3CK%{zs60P_Itx2pXvY6@HFg7Gp%xCQAeO@r`~`%;KrYy{CfTHgYNRL-oc&C}|1=RYSp%+B0FH`y}0>4|blPmCJ##qT4 zxXIPT1D4H`#vVDZ*H)NBLbESgFJGT@oz=!)R#jTTR^L8+0i+=&-iW5!BQO}JygM-yUldx;{IUG=) zNwyNzySZ(Hs~qs(ANn73bIE);JZpmJ)w6YFkZLs8{Tz;?+Jo*sQnq1hIuTLF z?Ow~A&FGFxwHT&qwe-NwP3f;|^TCDQ7w@$p=PY_9n;cEO3N@R623KEAJxJ)+dg>zs zFxVW@TM8QmUx8C;7uVIhP`NK6%1HZAXq37U1%cr~YHLn+ES;zY1)JLZy*Pd}9*S?s z7PaS%6@{3(fAlT$vuN)y!_8{8pP}p(CPV>chXge`RKrWu$gO_#Y69*$#w&K?0N^@$ zQ@Aof9@Wlu|8*$>sWgW54szNejVuSqiUdLmtsYC=!9r#;9v29wJj6bgTJIGF|QLXWN7c6e-zz82uQP}YnJ^=>>%5fUv zQ8h5;5wWauiV^77n>bAmHl}JTGH|huXD~exM^%8UM)=t3EN{``j*I#vzznO&h(w^& zi#~^`{_+21!0`w5VOTCtCt3-`VXk5$wh!NdpCMcKqKN711Cu^vp7U(e_ZgJ>^q-Sy zRF7z=5_A3`*m%C*{}q{mYypnkqn(?H3HOHK{Bn*9OC3sd zCEVb)zFQcRI(OZhgUXnG_$chwyb`YBjhPDJVpc(-qh`7r4F-6E^}0DOrX#(msCMKn z6-$A}-P{hu$}V^8>sI0M9cJA>*oD9;e?-T^rPr@^Aef`}>>**(w!BDJ zs<=u~4nDmeCWD-zOCq4z_|I?`dI0mGw1*Qs$gusM#tB&SJhRl#Ho*L@wBm8#dEogr zo7r^B`yB5^d6IX57zGJLSs6LBTty@3W3z4PkM@Ox>dJ*uS`?>N61c3VVYv@wv3X>X|hY zWgM9<2k*l9@RPp+f>rooYUsuxU}Q(#&eyb-9cavog~l^C1$1`XHH?O+lOqszk2LiKN4R^Of1RLIz(T?la$J+rrO#fTP{tx^a{afX{+WAPp{uca^y8}W zdBo%t`IHcf0E=+PVXQ|zi+p$gPOjhHA~vZR`PL~4&4-Y)s?hNI?^{uCod!Y0)%>mr z+$>o(81{q!+cMZk-g@PYmk#@QrHtK@kos(MN27=H*=4Vmi zTFQhad|FgOyfg7SIQzUCAM-PEcU^`Qt}*9>Mc+M|8}*RWaY1g3z4fD}|NlO*SAc21 zmo2tgz;1tXiDop%mHDt+dQ`4KXTNHZjd}AEwA-^@U)8a}W@IEkZ<8uY*s9t>Y+7qroNn!Ht^kZCmi-VZ%y_QQhY&J%9jzV702ahXLd}n#M=U8^Yps1S<{^H^%t5NLM=xtR z!_*Ei{GRMz$ywm(^W8u*FTcF;w&EkGTYEhqsH1ck2Bf@U#Ks||=q@rfM4U6|dGzKy zDk+@nrB~6B=o&3K3Xbz<;Dt+Sa7&uHtkw4j&>G6qT2-jX3(xPyK9}w$uu*TLr2!y0 zgYZUeJu()L;5&ESJUW|R`k^`n{Z~gq(&VQCfVF`Cyxu*G^^vn;Nz$^tst*@@OxIeL z9u|MAanuLdOJ*MEAze65&URXBtt>jy8Pi$a=q{h%$V4o9|6U0C3(8jCY4@jh6FPch zTTwSe&m31hYWK8r>l7F#4kKBbEBR)?1940CA@@aGB&&tmcBmGGnIV@-Tp%_6V%?7}5KAylvW7J$TLU+{_7vI1Y!;fpS_bHf9;7zg} zbTgge`gmsi!bgxk8np&D-wpLJMcr`f|J`pheaoCoT;Ylj(!sfG!K%~*VXR?nE$jR9jn?>IgLc}Cj3La7u5 zD^8Qwt*P^oB_{Cp_IcO9cd|X`n4KWJC3UVl*<~!kL6=##!gQwN1UA7th^llL**M*u z>TjULIL!;}21u0R38vNu3memD-CgUM#WTAR|e8Um1Tz>Vr2Co_+xZg&BAU~G3U>M9AkimbldiB#&~Svd4>rjTw&ZqVWioy>xK zpy5>{3^^wqAm{c}9gk79<@vd5Ejk62e^+=9?@(S!tmzQAej`gJ)2K>A+s2-jjO6ZE z_X!k5IG{2f1-aa5z}#B7s>0h)7G7w0MnWet-(k)c0DOxKReb#thTAmmL%gDrw>`LM z!#OGuEIhg~*MC!B&a3?jbIYvQYf;y%6%6`>wjdOPCSX{1J9D0ClIYYJ#Ou=!%8l(& z;bBd$4(7Zt%T~(J^sj6qZKILaYC7*j2-M0(jW!g65H*;LnJj76WHimGa2t93MpM(8 zg&r=KhpAers{3<+I}$DI<5z5<^n|N`w~G4!FBOJdwk7wM$ptlXZd;IxJha2*Ahfuc z1=&!8n;4y|?IsjLjOTdHyCd)k+2loocO^B0CoJP6R*RBBtfGd{tQ!m>6(dLBXiy2@ zUAHd*s;%2E`|q40dM2Tk@;>M*!2X+{XaVi94 zICtL2yNUag?3*4gwXk|F{EnTb<%YN1UpvjP#v~&ZQBtiEtNMeU<35C;ieLiDixz^=zF1 zQmyA3xBH*FH2;2}FCZ=bqfnLFsL8J?`kaT!FBtNqugC+nd{@Y%_#^+CdMDUJ)a8QrV>1Z5YWWUec-%_A9@e*2LS-31zbGV#i&w0FmSw}mk z4#D$0``@lr7PVgpGx>X#Zkt^NWX3~&zWcpl0!5s7>QJy)kget|wwkYUD-r*ij>(K3%R92G~SRdf)7ug5gz%P2e)HYWG`6_;ZdJCU@qxj$$ zkU{6%s}ZC)!C41ZBcm4-m5NVh{MWMn+MA({&vO#!qmq|T8)Ka;Jo^9_tMac`1*@Td zCxN4`$CC)rN_vJxRmQi6t<^aKiE>IQ+55tcAyzk=1d;YSf)7faLcvy!YK93$p!rrW^y16_>>ELZ{fyKz!qYtPc*CD4Vw2 z0=LO~*grN8Cul$LH>-?vC0|b+pa{U`R>nB$?FtmLk$J))V=sOjggHC?^MdQayR^3@ zyUZc1mA^|LwFaBjO|?FGLLXQvX%uFdBI@o0xuOk(3$}&wz-^GK>~bgE7${OqtIS~a zolc`0Xmiu|d*Yrn5NGel=7U=3zYb4oCsD(=Dg|Hk>W1kQsU%(7(v||mw5(OxFHe_L zhM5EgyoglEHxGNf!DWH>GcCT4VckoqC&7(CYR+77Rng2}Kvj<+{P0;^U>p&N|2HOBl5n}@}?WC}rn&;bw81Wyx4Z{NX9y6u3_m`0&=r9`%Wi;PP{ z&29X%L)U?@ZcHj&C6!w}p7w|M92^#1CN@1B6ej_?R2s;ChAdud>7k)%ZBxta!nMqB`b+nc> zilv7Kd{q@(pbgTEkV^|e4P5snHRjMf-|mGP#lf5xp1}7eIJR0^YJNlooaidQ(~frL zTv4TP=y7U@ULA-sUG1h19KiaHxuPbl)9b$6Lq>gE0owFRl9$Am!I8Z#vr|o}BKII_ zz6T`hxyW3!V%#)~-28hq4x5&XzR3lWmiHiyYj}pUo$8h|yPU+X`2+Gjf8)nOiC^Hd ziR67b_c@SdHNt{UKvGq0+jGEAQ(L{A<#vv+WK6W(bX^q@oybTtH^Q6eaV*99i`A;V z+OY1vv#{==F{uikofoyU0sR+2(bP{~pX*cYX4dndj_76HKfs0i2lwYtYP87)Nih|; z+c%@oHPWv4ht;;MHk%omY<_MfGFDagDk&08_X_D&2dxwNki_AL9CjG}lRDKhw3qn0 z>bp&*fxqtbXWgxBtN`(W)^}2U{oOkg#+GfMo+4sA?+3UL+A@t2H1Woaq`>fHL9*G! zxS zLoHw0+}DE)G(CmQkEPDGPt5B%p4a+)wveNx8emhB8(q;&(G}6p-Eb}0H8Sl?k^N0O z7Vclwh3hFOKtAg+e2ct8IiMh2o;~+D&d!q!aX(Fps6Z*5FC8)GH^7mvUFpPqS54AG){{a(Yj-3wqD!8OG zLfFT3Z3Hnh5DN~ZJ1ksZ>(J5~Zro(WEclwD+J;w&=WO{Za(Pu@hpT@i%>py2ozn{= z^}_YXhv@kwPZ+_OSSuy|(D4rF_hJ4$K{%FV=k7jCJ-< z^=r4ZlG9>TI`A+1#Z5)`3@^xjS2%G1)qY~aAlxGZ(t8!$q1O$VR~1(xeBUQwIm+M~ z8%B0nALmY_D$g5eouMj~ogf4?Vc&ppN(m0H5=#_iZAcIIC4$E=NyR)wr6@5lKVnAf z;)JZJ*{R|Vvhd?Z?sdE8KT4tfdEdIP7V2N;oT0oF#pz7b*7%|pm8v7XpX@`F+PQab z%?dz@8EsffEmCy2UWB95pmtq{HbFzJMq8r&0!!niz{{btTc&CsJVwJy6AtIS=jE}I zhC|URDju-jL>5_|4wv?>L-XC;`c8}P1Jr=k9uy{#U#4qMX82l{OOc$d8>Sp`sea7w zG|7u$@&VJCvByFt-SNsXMTXi?+sFgW1+G%RWf$yp1oYt5Y-#Pku{tLwmSRMS7&oQO-JdQ5^Qnbpz6 zfO~#%@$nFiVhg)D2lsU+cB8oKX-2w|P3e^IFAXX8Nwd@=rr%VU{dBc(?eQxN*fKfU z^&Rqd3)2;i7+NU_e>mdX_Z&-Oc_!(wp)S(ivA2wglcR`ko3e$q;7Zv1saKkdu;SJ* z53bJN^Tx}rwWB783e2d=+F-5iWj}KK=mgtEg#Ntw?N_b@mSr%CXQZYVzyi%IF3o>G| zWt4hRSHEBbAGi$4;kfl%&fBm6W9Pm~WS5{~dmxiWJPeIW^J_`?xKECF2{sMTdyrf^ zhUkV4GUqyny7ZMJFV?7$6sR7VCC{N~I@4jKoCekK7xh8M&C4LQ6$*JzaU77DZzixk zU&SQPxid?$-kvY!a>#NJeE51JycOsFTg?QuP`rm?Vt9$t!nY`iFbgmnk!Db#QMrSq zeDj_b7P>k_S05SPdzG>xfAkr>mieFXdT)|=;HKktOIL6&@boX^*0@3PK_R(ECp&eC z_c-H@qs>msnTwrR0_n3SOD6&*eH~n3CcISx6KQ`X=3a8>aqLRSkBYKIIr(O7g#d^#aHy0m{&zuqe&`d-JaBFyzx z*4)=56Hn|Ve`6wZ=0~^Oito+`S3S85#;CK(Lf~UoeJN!#c#eJQe}NmAK3PaWHKxdG z*yG8bX&si>fW@YSH;^X3;?GyVnMGWn64pPo{-b%jVbgC&ZLG_31W7z4!u*N$3%c zjnI`UQX8>G&Kcmdxi4s+LCMKI=7fI>Ittxl)@#@@Uqq@7)}LGlj&8=HUEbbmfx4Lt z+cO4Bbpf|UpqiJW8gueXfIh{ks0N#xG2XYJxEo(oBHOy}QOfa?ZDC`5P>WUUw2)#5 z8?9rX!%H+w?D|lz50u?ZFHVt-KnLjao#6(gBIz({h`GoUAfShu$zt|DKDq-2oFsVC zrDAv{wNg#}PLDk_YY=h^hy}y36i)L_jiR87quz_-BJcI1*1&XAfe98SSAWcwk2K=YAJ`iMD+YUjBa&LN&R=!EC_A6&vbc5|d`Gw0n6HEaHt ztQH{B6GAB`xYY4GwAmXJs+^~UsOQ5N6JyE3 z{Y{aX97nf%+G!HzfqEJ)T@(eSj8k-hn+>UknkI+QmfY8RwFmoi*?m|oR6=frab7?~ zZA;!@BDArn0sxt0^;Ac?>|2eXy#&sj`$xOlCBMn^E3IcA$E!EE09z4>UC_LXr#ce3h-`T}v^?P6Q`P888sfLaZBN3Rpb7vmF!$;5*3J6*&7K5^i z^EUKOWiVb*_TvAbl_%>{E&>`Ath`bdvUB6ZrT981d!#e4`^3NNR=rT+-}NQb`qg_W}=x6QoTfT$Yv%fIQqTGNeH|+pbhK?kH_n$O?l&I;uCo97_bM%2*d@+h31)pA&ZH2~} z288I<+2AwhgV+3pz*17-u)W~PpF`qtgr@nh*xc_HNN7E2G zG`Xmlfkv){+EN+=CDWm5cY|>yWc&}HKeit?Q-o>kkQSO5HgjXKbbdh%64#jOqg5|? z3{v@lWD>Llu2fT3Nu@QUps1wtd(UYW*xW70QFJuOKu^k`0bZ|@rGK-cm7XT-_B;wg z{QHiHx5!H0b2>wx4|fO?uKB)DbIb7}0WD~gLRA+_>~>LVH`(8WP++Ts!pbDHE7_t1 zhu(w;)o&I|vUVz5Q4HgZz(3nQo4(j_`}xYW(hRL1VKUjbEQ03151OYC$@Mk`>wj=y zGhtWM{PYN=m1>16V=1)LJ`%zRTvnp zZ%C?JTFy!uiVaksv+YfcSc!7chGxZvP@S{+Bh<~47)_yo8bAPzXe@({QlQ0g{F09q z_Y%+bw7KTr{`;3DD6OJOk-~c^ARy2scnQNz=8KkXhBB|ZKTG6|cDp(K!3soPb?&z$ zO!CU9!U|Q9a*UIUzC1=BpU-n`*aVTu4guWapV^pI3b;s*$@{!EQ+PH-9x z;5L;*h^&TvC%Ic=8*mkxG~Bz@P+to*sf;<%eg>xZq}(nL%;u&KdgC{t*bxYX2qHs=Xt9^iL<{3!iFs<<&;(8HshJ( zIKPXee}Oisv(wEAE{S5{T&YyCNToFG7hVhrkB?@2QAFXR9CwRilZ673mn2t1TW?|R zLx-y{?4tjw8A?TRgJ=|w8F8bL(l1rtWAG|$X0;V+gsM(p@W?!ZP9M8h)VUbmKr@$z zg<{=DxwsNMh6;)e;N)t+#~fF%$^MKM_PxK!=2xF7NuB_4$`C-RGc>SmOEB;h^#CeW zvwLMOvka_GNqDXg(*78E8VDkppBuFK-z&}KiWixR1MjBLJB#`Fzk}#j<9C5-#D1g6 zAiS6J1zIXKSqbmZZM#zFT}eloBHa8hC3q$D0JCm7{{+-*%oMKT`>QYTbQ-)+Vws6w z88;M(Vfyf!O=| zHL&`mQNfm>BFU%kWxPOilP z!9NJv%{4a7lH*(pByZ|S;)>}`(?M*8?i)*CatHaJuD_=myd4{;D^>>5lf=jaocw3S z?{QF0CtpD9R;eh@7%Lv|49$%( z)_N#;j0`J4Q_L`B>dBz%W5S1ywIbUI{Vn2gJ%%I?a%z&_cU@d{t(ctR`V-VIy0av* z{Z(+>Kig5I1g9a02yxRF?e7Z@YJ-$QYP=ln^)-anHu}6AsxcmcNJe#wBT#)r zg9z!bC!P=v^hIM)82W>De#v4_JC*hM0`thz*B^`*Q2$&=`1<XQh8+ zd33}-NK~1LjAYy`Hz`8+q4?iVu&twi`yt>(7T3W$ap_;^4U8* zFIl?tO!S4eb_(Mmi9O*s?q(yNV*}=oMv?q9Gnz74 zgIJnpCK={JSYcS9F@}gBi0rVW%~!XXh`-;JZl(|MBH3W7bczV?PpR`Wt05{gZwlee zbKgBDbrs|O^ub-Su2NbYC!R<}#rEJ?SCcGSJdG50hp8v}&8yP=_zq~Dqi4pM!G#eo zH#un<>4!ouY;cr$ZTxguArVcLK|9c>`VnAmge;$`ry zk|q$ey;z#Wh#!8&_W%+9O&HB@67Rz@rKztjC681Au{t+?1b^Ez1fMv&81^z_>3Hxb zcVu<>o?E-R|JdV>Sj*=wFOPQ}gXjcXh3G~pT+wb`im%?m)WzbUm!3%#S${7+)Y^XX zglyT^8)DSMrAf=U&*jC1xw|d;$09a!9Ca(9ez&C~*1iyY=`zLbw0iLEwzeL0M#16DmhVw~!ShzICB9iFcdcQAX}DEb;~!!yewR#1FVC8igTABhH@8OJWEa=%%&d*d2aXpv5Z6^o@Iy*T^YIzW z0o^3-J>diL0W*mBh^K#ze!2NV!svIF4e{n)j89z!15-N5XDm zDoslM{1@$V&`H)E&g_NoXrT~x1;VLh;*dI=`v&dn6Ia|uS-A_CDYmz*Jjy%X%o%s* z5qzy=-^7Y_R(Z<>rU=-4-PP>Ya?gnkYmcvvKgCgSb&bH*ubBAF z-r#lRvl(JCjeo1k+M}zcJxhemevfJPGm=+!UyZd53aR z<2K_x3^PBQvB=T&9yE*L$~YEMUnWBAy{WG;br$L2Sx@;K9iHz5yOEZ$;*c)oeC9I2 zvm*)%3x05sEAyVjeKMjyb!GRdfalagN~^!^pNUxsKRerea^@!_)n5XTMf#O{4RSQu;qK zM!m5s6SaKDUJ}fV|5aPXACYNA_fmJWpz58+vE;k`qNNdj>n3i2S&ll1XU^ozKS_W0 zJ)Azfx%-+zrTE*`Y^m4Ay2szyvHAR)5QY?JxX+awJkL6F`n*c@4)sPnInV7L^Ho38gB6$tX0Ou*ggQCB z{3BC}e|4fjd)-qlfrV1O;3c|~Y7(h3AG3lzkKc2@Z0VCS2E#OnjvlemAl4>Rrmp&rMTj& z6|~*5r=9oNv2W`=UN~ZXXUx8Po-P_Rp}Og}RHcU-NGN!FDLqE0g-1%kY~&LfuDE3b zF=bgNMyF#_h(lKTe~bR#@#>hl?%lt(#;~K{sCu>II!1_4B%isn$uds+$lOp(YPOHP zU^~g{8Ls|-9{0?%!~hn5dY1gHaMEix3JYs&5Tlndcr81cnq4QaA0DP1wLCj&-ln-@ zYG7?tXL+?PK02J6P%mJwQ0k-PFvA+ZjYjltj3#m0pZ8M@H?;JA7Hi&;D4;j$hFka$I{;7W8^~W7fu^EM8_wmx&*#c!Bf}#5N(Mnfy{9ee`uZe}1{Z?L`CJ*14 zvVZeB-21)GM7-AY>Uo}a-?xWTnV+3?x_gxc-gG6!PCxa>;YQSQ#v#A<2|A)lL!?=B zIj)g>yfIP6qm^qrnbK7uc_&KZjYs?)`(?y~ry*P8{MWQ*E_9n$h4fl&(g&n|Xw=Ng z%(l~PvgUtauqaGM%!{NrWbt#;O9cu`oGReB*B?2F82f$t#gB0tozW>)7t6hlxb<#x zh^mYGUS@iDlT|Cjr-CYUrL|;{k1C2U^f`3(I5%J2yjM14RjA?q({T{9r>YGUjU9>SON5G}jS_=tbPI|MzvS`+$v&y} z6c-yQ2J7$U#AMQ5dOQ$hjkR{CF-a50=$rEZCH(OUMN{(V~GaE9|ntXhfr`R@XMa;O)lcCI6Q z-ym*amb2iHDP}20u|Ey=eYMZis6bHo>#p&H$+rLOE3aVMgVHYrd=;E!UXowuXDw=) ziA}C-9pz2zO-~ACxZ85lu2V6Vpdo(~Ki>A`@^gD>4ZGE9$mPCAU?W4yUH4BFwn@af z`5Kg`dj1`(4IZm{4}TL*)~+3#G&)V0*1o(GyNZ!%rFPV4apm-YN~7ZX;YaGP#~4(+ zE~2lM4(?-;zDl?zyIi|8b!pdLcJ!UsCsW&WA?^`PTiO?_kT}}CZy$;8zGV2;k;FY} z!v3iAAx`PH@Ytp4Uk%%xDb{*ucFfvFQ?$w24`?EF!g7Uta}3*qcb*XWQfshh+_j|f zyNWQ^A@i!dwl-(C6lc4-w?)%yP8)od9$a_wMx-Yk+e&J&So5Cw&59OEIeo5|+xv=! zuH@e;C}q9)y0D{fqURzewfn*zc#IWP?JY-q9Y-#aEIM5J|5y;$9B{GJ^qn%oa)c;L zP`ArAfoz1^B+|UY1Rw~-whKw1+VkB5%|oU~uTHHH#grYVrG6&*O@CfX6?i+|?fjm- zX7Z5ZWeQ&xdZDhGeAPEGf=d=e8TsG>_gdzMZ?v5zh|H*W%imQLZ&|y$x$PcTl`Vv| z24|J80S%HTxAnu|#{zbBVE)g)8h@!T7@dNz!=n?<7AHf@g(okSAncCcI7Y6|Xt zp6mJ|L301j`j^{DBY!2!ypxBVwcqpQl#(s}9K^_!7pl!Cn>MO>=-kyI@znJ6_tEGl zJWKI=Lzvj_tMK&Xwkq1!f~TJ0d<<-J?3hW{dA%HIBZU;EWF*PZmY&Y*Je597y4>jV zpD=IpCeUZSsAM);dht8!kDQprf$4l^wNsYxDdXKwSB<>R;?5>%55ry`S<2Q?&=|P) zn;z;f7+v1{1DNqr!F0)fd4F@b{$VQTRJ|l#qYJhc zd;V&$UuiSbCSHR0zLP7>SAMT^>RFj25`#9bZ8a-1e^^;>9~bnSWR!OQV2%ACu*G@m*SfJo*;mo)++7Aj-Ro)NyP4=w z)%DKV`coeR18<)gX*P#Fs4x^3JeaS)5TXuiGj@`vO6ysw3lgieig?k2-(9|CvJ*h9 zjpFL7s{bEVUm4a`*L01vK#N;(E2ThjE5&JXFSNM3dvSsmcXuf6?(Ts?Ab4;nTHJ#K z!k7Dgp6|NeXa6`!{v_8qlRbN8&CFUEg6u#?u@zhv{+GX2-?SbU^{N^8O0@k`bh?~| zKHjsj?OsuhSfj_I(fBQ3#_V&lA*s4@Fcp7qlY?5%azcRn+ z3J?z|!WfhdkVKYYJs#?gd;R0u#m;a~9n1e|3`x4xT&xHpsZJN1av5Y>D6@V)u?T2d z>+ZInDzMN84_zX4vx;r8a1`~*ulrh7A9Zh}99N&@__oRZ5?$jWedAh?*oe_2j=@z9^3F{Z(?a-8QMT4Jk$#f zP{s@Vj@C6C{9YtrOTvj9lNa{aF*Fm*@Y%we-Z9GMZja+pdjqP4aeF>*S^3#dI z;~$lN`?@%JB40(rStq*wN3zb*AKb4Vz|fQBnJZD6Il8-R`y1_m4WMYn>&Pbvs?QN5!c78o<^!Ur;#k z#8uF`RtM{SJpLqR>A%3waPpuS@3fAG;Btr=kFWSP&=_}%-2KHh-(XIwZ?3K$?5<1X z`q%|T^mQlgmmY_(_Sp)vAWejQx}g*E*tbqAudvj-%@(qcPhcYGYYg!CbS&ngieA$( z!6#PKMg=$vCI+SNAuqJC;Q)dTAC}Sm0_IB%N~#tXT6(>5J^1nGk&Ar3EaPhT<()k1 zo`kUqk9+^}YO?R_-6BcN^;D$=wyHC#vl0vCRuuV?~X(xG4O^=^zbq3Vmpe}C! zT4-AMXDU62el!{2e($I}gO^;Z^e75%dhYt~y0rTU>=OgET7ZLlMy>UGg-s3jcCU{M zkC9|-+4LdywP@`OjQW%^xYZRZLM|6b&Xc6+VMQ-1I!>T695+**7@!qW3kdi$Ta z;{ECq&!y`gZi362iJgQ6vZy>tHHOTl&NQiWNEQWmQ!2qEa;@-C<6`7=UonZ zzESARuXMRdQQ_AieoalW>&M*{uLZS=Pun=WcP0!YikNZqzh=XR&Mm*u)N9y=<5OnpQi*Me^1xmf8SH0(52sEQ$nuArVBvb$K4#r61K7* zShGLa&nq+9Y9r_yw<_6o_>R{3q4vJ&wT4^A0rF&sB<~QZt-_eb2iAVpHni`5P~c;{Yj^3!bD`FYNE0V%*srDTVjGrW7nYGhY2k_I3!+q}4$VM(;1q4#t`ZpMT%;{OG|Y=V zb&gqW%x%8%=e-fy&;3w7ucqQ}I8V7&!H&K0BWWY6x8`nL02(9)gRE;<9{YV+SbZ^7 zzOg!<|M*+f5o5Qc)&VXs{m4>ObYMz_B-u61@iL5M+NQat=Q0yM^!SC#85{Lg5&3Gjmpn>ejLWJMZIFm(SWh7ZvFnlEGz8M^(&-)=ZBC?^w z;(TMOz@uU^)&>;_u5?)E1f~RbWS=={W>=U1o-Q$ir)C0R@Y0sfQd8pK!Fbz@NLhFO#O+d$zD4@Sn!$P%2ZE&X{Hr}h++)X2|CQ| z=kub35%ci?bLUTFD=MBB@Ra&^MXd7{zjpGf%4wWaQQ1%G0T9tWOW@i%hCJN>K)w1r zkOB2fYKQCXO#jBdt-(t70=qMbILAc?|)A2wAs9SuH) zDapiPd3x%g&31R(rKw~c!7sak(JG4F;~BLO&5L6x)gi+_SiDD->Ch+71uUOIWJ>6j zdbUsa^1lCL**)b3OC0wqwK77w(BxM1v^ zI*o7E8hT@#)K6?y2_&7gcHXib`>y9%Y&*1^LUQgsjBlA`!scrD&o}^B0S+>O@ZLsWkbEWHJ7n^Dbqp0*_n&FAo|Fa z#V!ln$xiNJcm@VPzE*EZUsf&;=GqVE5HzkON2h+`Cl-Up{q7s~nmqT5?(mWt%S~Bd zh8B~}JKJ)c>;##s_pzqTF-h-Q^UIIo)qakRYRV-}K5YsEPA+7?8_wfDYVc!_BwL-w z-rOcV8h-T09Cvu(>QQB%ec_6cu!9owtsgP(?ROi*;||NP21r@#X#%NS15UccMnT(l zzTnaAKBZHaeom62oY|?H6#>^TimCeOnQ8j)qkExTul;*T210%^aaD>D<+J`J5{BO4 z=5$m?uN&6)?;*0fS802Ah0jy;hWbBVCmC#7IQh@gTpK&o_0~RwRpsK|^yE97Y5;;A zQNCOT+|!P`AKximR_6GSoH=crTqQ(y`+mjdot3gm@v?13JN3~aQ4yvOmghH$@Uj^v z>m1(j$AkEuv;6JQUVMHdHI23X+ufo12HlZVb7K`zLF|1qTL2xWFl8|lvTyQxN}<{H z-djL16MbbA@c&&iJ*w5IzRVe=O#B~t{7li8YbP*S#wXWk-~#@5UVEl$9w-Kv1V7WA~Fvu3NgJh zWXtW;5o6We;9}?HyO`fIl5}-|oi&Op%jblpmGLYw8VU*_8QTeW_QN^X0r1P-YS?`r z#4|e?^)d=_aeMZ>WKMYYbPl-$K^^O8r^06nR~xwKNc?nHO?7dzV$~GV_Br**{-AriMIhWm3J5$NzuSdw_b7J$So3N%FZ9&2z=l96-g(k--^An+ z{Zh@Jguzm3`|e)RmE#w_aUl4iW(loj5H_zTGDzn4V(Ig>q0+kcqV}(WLwrRQ>9#8k z0Z9zXR=U9xesghNoPr_H(aB^Uj1fw1TbSdpaJuA%nzJDkv($ml!9`e@oA{~0jM6LH z@eu~WQ@>y>-ui=Scys&kSk*W?ut)nbvu|O={1ZaOqp#X>O)}8O@eE~}$XD@M8WyYa zcieroj3lQXMpc{RDu*WK=f_@WMtzs)J|SF&`}auVdH+<&SE2 zgzAb!7M27EWlu?Lw&W9?FPE~3!xWnP2Cf}B{jcD6B#<-iq*(C63MCg1vd$xRc4*nFF9oU zOF2LJh^DBtrT1t?uVn^~3z{BhUG#ibnMZd{P48h{@^Hcn%S=yy+&k-4H*EHQR#fpi z$%-hSEzFkd4*1t%DE+GlUG%^{{BuwkJFUHPpbCSg1$9(Z_mT&o%OjiTS+ua(;K!k> z$lBriY;&(hJ$`S3BRr)VY8gihf8;bt!Ym<*JEcXEU+^P@i2U#7w2>F18 zi3iY%g|OqBZ{$60S0yzPIlnpJ@DYDcJjwpj1T zY4?5ZEr4$2*yRt8`eShn7vsYXG9@^hkPAw55cLSLf@-u+Sw8=1K2g&Mt7SKNNB>CF2XVm;O9cqS)zwa$Os-P2FQv_os} zMP<;+#S35Be{R&#u=E?5k4aqKO7=5EF_ArUy+lTpQOfKa9+%2+KD+RYf`ckNtrC?6gk&OZDh*nXS@xu@=*A9szgLQ&N_ zn%7}D#Kn#CeP*L!x3e@h{8KwEC}LgjB?!9ACTCj(t%>5r1ogR39sCe-gvqw758trJ zC4w|Uy;S7KcoulbIeBgLx*Zm9xlgShq1HGshT4ALfB zt2iuyE|{K?bFOI;bcEzx@KM1v?tZN`Gq_sgNQRvR%0trCcHJdx#BR1*<(t2-KoKKt zxU-8Q6%66O_Kab;-?V*x9J1^^M@=eR#6=N_E_{z!l{bdpcGI;vt^e1I;Kc&%*-4u3 z;+cs@zOa=7!r?NT^nzOyu@5QIQH#?Fv!_qU;KE^I@vTLM=jaqQYdr9SJUy$|JLt}Y z_yuM}xa~e9l^HUt3TTef$i$H4yO=#U$6;)Fe!o8tkG7S_M9_P?jp9FJiwiJcF@tD2 zbf<{ptE-^if&9g>34uvf0X)`1Kb4S5%YMLF`m=sPIr zjt%m5M+KLFlmo-uUhZgyQ;@*M6rqIEMlXP_=iS*^YXEY@jI%KOdLDMTisg1Nlf2__*d24iD5XvqJf4{}{Sva~3zr@qT1vq<7-uBw6Ro z-W?}m1`13$j=ke-l!_|A>toy4uoRZ;Mt+0j9bG*-e06y1N7qpS$(k_sp`{#J;>}43 zPHz2=n+!BMMMFfTo5r`t1$?|XiMP1Rwa={WZA^CK&csUU_>PxR1*17uePc=;$-K_5 z+w;@7dWYK{Ihr@cZl{(4vHnyvT{qolBjMTayGi^ZK zW252YsS(M=HcAM^oKOb>Y5I(X_K|R0KQD8w2r;Y}u!ox&N_z>s-#1&CEH=}hn~?6g zoyAOuQkD88a}gi}#cOjLeK-`X*&qCTl^Un@I}CHT6gGpibo&7CH^;E>LriR?`NsR1 zeBJm8MlV;$6Cccb>i$X=1PWw$dJepwcGP#~du_faUgcoiWUo<;?>PX(8f3%%Yr$6H zGeOhElI8d@%VfbrWILPd2L1XSnp>lRqMrYG==1it7Eda{%CZr4j0w&%Yx^6^^VCp) z?e&V|bNX)tE24sGcp?{M-@_U6KN$qZo&zE(`B`d9yCDN!-m>2P;U^>!7bP@vqLVCR5R0}(HbE|@H$~`?P!Z~oXZ4R7~OC{Etnb!mo{6{<_a{5p?Ve94Dol=#5XN`~1~lb?Tn zvNpW9X;d#s6;`yxIAZjXHH}IkBqignVKWPG2<(H>5jy$*FzA`y9T2eFc-vB|6Fv0H zQixOvmvjfw@dS~UsgMZg)z|;B*k3a{K#tZ_Uw5Sa%_-9)j(Sj=ss>@ zGPF7RO8A-@(3jV2E2Q<;1pYV<8|etl%WGt7I4iE#8CHDoZQ0*)0u280J%2#k3$cR% zaAMXUIQZYmyt{?^ZjKLsPU4~YRK_3OSv3=8y}pmreVK->P#2YM*mOmrXT8vtvDkZ! z=E&U(-iNQMk~Ou5^VIF{?L~`u(xW!MC5QTnoehcR276_MD|CA11wPO2X2W_O3-1o! z<~7!#i6$0Wt}{sdn-l#1Eyy|gZ6A{!ShJOg_4j6~eQWu+%%ahY42hm#P{yGOGi-Hr zyk#MCEXV3FA~n5ZQkcM0^HAfR8=|CJOSzpDsP>`Q%urkK-h7hc%PFc6BID~8o}qe~ zXGOXacVyb^a+~B6zGZwjI&o#$YrC&+=U3c(I#pF`qU)q9xh*}^7LKekYXBk#E@XWC z_gib_9&_$;8TO5OM%`ZiW{KoV&3Zn|DXba0^1?)UDap3#rx2P#*tQ)Z@>e!m_$3NY zoNH}(jix-6(}nOTREZd;#cdB+J>ye}XaGGbKL~v<=r|2h95Xvw+3XCZQR9Y#kX5}v z!$O(+Z=^_i?h6Y)DhsrP(bIFz@lFyM+CVE!aKzfbo*~hSHE$eb97RWMKoIJ|P?)m0 z_8A4*POu$}r&Fpu50}!Y!0Hio^XQ&~!#3CU>Lrrj?GzC8RIO^JIOSdLAR?f|5`9$f zoCR!(fS zQY~uV$;K+HTu&>qX-NOaSfu}EaBkV&zM=V0P7FnK$gyG#e@SEUk{w(cdLA18zE)O| zX8V^hqYIC3)ykeySChNP{Hh zst%=yNFn_c+t3XLgB7&*kXPDCJ^e&i?t&c9&fhQwwbY#JW5@v%ch6$|{YiR&psQZax z5THjSCC{8GPz4Od^>%T}GqW&U{i&#|X+Q$~>gflEEiGy9TD+zZqtWa6-Ex6;zW6-e zJO)M<`Eh^abA@idv>Nd%^s5>an@od32iX?*5MVPf^2T*fL5$Z_LW16Ke>11azIMm% zZ$V~rmge|AX+{c%eJ-G9DEWkvnm}RcY~6DAxmO5V&k)zPx?+n=y?5XO=G|WMto=F- zRTHo$qd`d?Cj>%{@mU?uB`fm{QGo$mL*H0%ui}@e47lwy>Tf&+aV3k=M z^cB%-9rE8u0^Ewrx|q|vCl>XUff-09XydRk*Kp@|`%WeC#n##T?SFh8!SqOY62`YF z5SB_i63KEjhhBk^55r_D04*+&@Dt-25|55GUx~{3Wn;>0VkKwy+;p!ezYWRIL4Yqa~*GINW)sCI`(LmkeN?2rj}<$Hu-EdO5lf3h@nr3F6|$8zi~wx^9i z`arsKQy0ccu>VN{AId4kQQsZ8O%w~!HhMsri|x#R>6Cw4O?BzBWpF_~BkK&Rer52g z`UX*l>bPjBCdF>3^;0s9CVhbkIpM7v{ahu_DPU7a9zh=^ZGuD`%(ODt^E6Fud-65$ zU6@tR)F{4JeK9hN8<(Ngqz<^NejKC68r(J}P_)xB8dXT6%S;A=$5N=X=dHyZseXII z!pONkiL`c}BW$g@*xs7%)Ly6CV~fOlEgz8}Lm210b?hrfqA@c${Nggr$k>4k${oKc zA9+FYxXKGT{?1dPm5E6x^N3X4*J6rQWfLUJz9YShnPW0DY{iH^`ItVpy-oI{u|w8* z)AOr`E!01Qe?0))@N8%U=)r$=`H%w1l;8xc{tOD0rf=3#vdf$t*FIL@6ggfcnP^W> z2C}cH+9QQoh^!PjPDWPovlyb;l14G0ewyjAK5qbgqa@mDK7^3miIuIW)E-#YCC2?k z^N{U+G+~Lm%BN~Yuh`qo2slK z_=Q()AyZ@^+6u~cqipsd84Uyi zMccWit{IyOSmkw{ZT1J_y&)lCuuLWWlx+Ez;&jD-)V<2TvG#2fIT{P%JZbu>gN&De z62eSllicRnkQ0@EI8wmg%YlS&VnSgN-NbAV;8Dc{s8>6dGBXZGCu`$JuCDpcO9bG| zboV3?Yf$2|u$=Ht&cX_c8y>vDpM0`B@wfIC+wESfcgOA&(dhkK<>CIh$l;v5G9zU4 z#$3R+YMxZb{0XkLB3|AmN=QLsV7*t!w0zQfR=`x`r!|;+LF8rct3ADGF1!mMP|1xt z(Lsxrq!hmt)x5XG_NrT+L`_Hl_au`Zy+;G`{sSBaifg&@|MO<{8(N5bJS*20mf+LO z$%zpXuO;QV^NP(>{v`oUTvv@1%D@PJ8hW8t#!;D{#*V}_Z$7V%QtN0J>Df@M!q(7)BKt z3(~u0Su!)Pd!7U8+qvzx-)(K)$`R;hhy`D5oqHkGw4W?MsD;1zdsP|c84eZjg`jwp zVOX0vnZ1w>bZL~}_sR~snj#a1=Vuj~q>+55?k z?r$cLHvgs5JU8VnOC*1E7XYb=kv;q(QqugXFE65dz_USr_S}-W@v2z3$~f=c zZ#W?A%}IUMRWUXVerOmg+JBxFE$CnTNBk`?93`JIl9%~bjn{#A*M3~3=3Y=C!&q08 zcSPj-t996+n;P{vdc}os!SaoK0n?YKY#m!Iaa1%>=Yl$NGOGFT<{*_hUQYbCNPzhM z3%ofOAVO?(y4rI0Omo}xRkBA@Y{0wW*RR4kSkN+5+RN##ZMiITD=8dW$)K23jn$BH zeSbNT8Npy&{~u10FPb{M2%B1>-Ds#;!f}m-7Pn`G_cLvwm)v<=6CW}y z^;TGw_(>RLV_A^on{k5qzaKU3YdU~7Y>r>oTJAQUiWxP9^b-u#sbK&A+fD!X`1z{y zS?FF%@{_lY6fixsS;GOx`r#|Q<;}bSeLUl?DIQ;=rXmd&`r&?=AxC7vrS~cnd()l5 zIuUrD5Z6O)jY}ME!upv3zl1RfEx;-oE^UPmRpu~kt;8C9rHTrYtmuis zKAPqX7yphmgk2RcPPvjr@k@tJDcUSt7Mt@5y~PW-K{G@)1w0BCFq31SQ<(mPAV*Cy zZ7FX~!#r#?Jw@XsFPAG;bBu}}ce&>j6dbe9yv@aE)ifce@pA%OHpLKq7_ecS8Go_> zzE>r>!4r&30dyE5jjXfT-Izx4eI2m!mh{fco*7nBYU;gqNqM4?`Zvf^@O^xNh zC7tV1#V^(`nm< zJ>ytSC}I7Unz&Y@1@@%iQPrho&oc>gB#PKwKkj*B-V@fq*Q340RLmrkL7){#C+k5v z*B269X%&BUVL^cerh&w6XIO*k3F07|3mb z<8AMj`;m#!xBH+yLjh?Yd)nHx_P!9KvV`XPWcJwU&f%Gkio~mIRj>MZQjv?B!y^J& z@5Ko@BHuF8`=PbKRyHP;58L{q#F;UxwKP5ZF%A08R_Hf-JbVun3dE%XH zugjqZ-^=-cxY#z{2_}QP0g{0n+-DLl;3k5Ri5>P7SVlVH5IJ1u*gz$tDoJQibQH`S zjOO$%cOG?qF5t#pyCLT45wFqUGWLGJ^8-4%!(%^c80AK0ZX(2#b!2GhMJ_^Ib?}C) z)k2%p_r%t45Wy<-^WPo!-)hLSJN0=0`lfoVH?ad7f&sP9X9H$n^?jUM3s15mgzzIr zO{HRQNpnkS@(1jNLw_mBZ7D26e8z@Wey7u_)dO=(xloGBa z)fPV=8V@e3LL%gH+Me1$>+14uWSU%mUvBKgY=1)Fwe`;YN8WyZ>)bVdio1IohLOQQ z_U*&yH^7t+=x93+1cuDWUqQ`(MQ?eJ)Xe$5cMNq!s3~m|)%vU*!8OyN9RBy?&k7Up zGv9rowyj7OTG6&UX1|YGTpko`Zilb#x4e1}l{)Vxu7qk^IU-UlJLGE8KQLC2KC!P8 zU=5OGHS6KcmV#bFIGo;mS`k2ZGRxbcsO5mfH{=pND3|_qUJSKlVV2$dZb4vxpj$1R zw=w2K=JH5E>1`~&kLPu|tj`Il^tfHUA{g1!q^0b@DP4ep8;K|EhF%?wI8JkMVT(;LqyH2$caYkMWNNG6zH}u~G_X zqAcIk6`1GzBj|%!){UZ)i;H49+?nn5EY8M)@&9}s$6l9J+2euuxqd}BoAmM*g;wmWvQTyOQMJ@V*ne8Ym$Nk-i0;2KERAUAyuHo63^kZcDX|811eY}E6|ypu2aY%%<`EsprqCoM1Diw7 z5rVr^2)@)^=(F4o?EOSZ=nTHEU?bOpomF{fHm{iLl3R|FgoK3af)2SQfeNsN*U73* zC`sDFI&&wue;Mw z$LqoNwwMkf!$OE)SZlC6MXMkUxW{9d0U}3{cU0%zZ5sT54tFcDvqPAQ@46e!l#?y8 zNNa$9N0icpSd^E}H17ZPp^jx3TA8tfqs`uQ10342LE~+O)OY`_SPwljm9Tr+qiv|lxfnp!uX5gwn z(?SxDWJRa`#uYN@T#8wFS5s+=WsGRFZVs{=STyJUn31b20LOi+je4g_C{xR$WI89v z5n8bL#}O9X6oNG=4|8w4Vxx3e;f|f;Y#qm1pYt!yujDRxm&*F&m)kp*aH2HZ9iv)B z{OeEQoYKi7f-Mbh|6nM}&mZ=GT*UJ>2LDm(%VM@4MaGc~Leocl*NxPUAh9PO$I8y> zPCaI+U_LIO*?f$9K{NYm%jkFh2NMit@-An}v_|itO?CO-;QP;AH{{mGHjLz*Cgcj* z1~Q5?jO_+*S4;#iEesv5X`BUP!|V%V7i`qm=lCe_n;Nu&UMl8RXy(kz=RNPiFHVJe z6H7#TWipveppg-bh~SNI_J;`Y#lx^NwUO&b!RPE(fxEAq_8ivM_@pRqd#(aiAr^77I?vy6ii@g|N7E6N zd9@bjOpzcS8--v^6MgW@1`v|+kT2f51$A~#n#V3yx93jQRcu*gVz2gJsaQ^Kf;npA zc$*$2ZX#4hoRMK`9)6Ft&-7`&cVtLpKaG27BPknHz7OI2ens|}kR9I>82Zae0T66? zoC@fTx_O{FHnG>gb#x~wuH+-}N&-_n4&}&zMCBdegnnqY_T>((KAj_C zO&J5x1(P;_MP;6t{N~R&AreZ$e?bZ5$8MdiI<~#c8|9W|si6ipNV(iKA%&R<_WE|T z(lMRRngrAy!PS(P-|X(3i=8>fKZOTM@ThEkNYsjK@B1X5y(a2!VL)~kmYvUEO;$fa z;U1GO%EK|k5@*ZlF)!}Q4<;wgu=;y4GC>W?k|-%oKCF-N0Xk%00#$c|-9lr;WCwlY z-C9z*aBxLg738`6tl)FYUSzIfa1gFMR?mnShDY5DkXV=%-AO}MTz!0=2u*>h;Z4c= zLbLH7XN&DsdM(9ZzclA~`08+Z{AUq#{|Mw-$M_!cR4Y!kb+wH?U%dPKuQxC?4w$DO z8hN+;(%tlJt4D(krQ7$P>N1H~27j~|?Qa%m8-XxH@#MYS02DE-T)tluZ8ayPop~eA z%ypc?pU#*F+5A?W1q#cLj2L%k2MYTa<6}mfGT>~f0|H~Iy~MhyZAhsNgk=7&HTx{v zGaQHh;z#37v`{;N7h?AHcw5)jqMr%G4a&dD6C+9PV&`*7J6sQU5eJ8GPutiGMdZ}KY-)HEhWVyM1FtFA`RjopAakiB# zJXA4A_;cWxE;dZYBeoB^lP5^~0@Bwc&*#1xLP|`J%4aOb*AvCE+n&VO1Fe>-t)|zM9;f?7O<|$4$x3ekX~DD))&IAp|le@JS%@Rc6o7tgrG&AK^`@3aM3VZ4F7B<`Ks$m=a zTRJr(zoedAE(wD?7`r=U>BaMPsZ0!|D_H-QGB3Ns0B2vx&-~ZyBJr%jNAch^72R43 zSDUc>euX<)DnvQQGZV;;Evz}yg+JYuPj0!&zwWtOV)isoG89mg#n1JYvCnAtr#Ttg z^hxw))3^OB3drQTM~RS2kJ^~ycCpotdgE1pKSj0MsgV#r=q3JD9|>fg$ZBU=xN5n5 zZfT*oC{a^X$X{@+@$2PXs7Sw5DgiW1SSWAV0MrBr!`%91jg)WBESH@vZ?s)P3YiSH7;wciu3GLDRK zy{&G}mY8I7Gf0vLF z_SOgabll{fpe_UEau;S|IasP|%uOD=xplPf>#a3jdWA`;^R zxw@l|gy7o2k62SN7Owh*hHiO1QX%LXGt8;QD`7*-(+&EpmUbm8T9@2)1q*3#s3tB} z{@qBO=D5OZ{T@3V*O)o?)52HMfS0d%%HfxMG4%$uu0g(G(S?L7xuiz~V!Z&ydC~?8k{PrF3{PXiqE_1N~TLm2TCnXoi$x=zDJs+Wl65F#~fYB+= z`+q?w&i^2GI+bI0^}zqDQJSE!Lkn0s&lL{w2f^~9DW|Y9i4c=9t}6v6*^Lt zKla%DBOO&sIs5u^Ui)8nn9kt(!!Kp_+$Ug_dFwnayT@$Rd^C|m8JTJjdFBXW$a?bj z(^BScy`D^l3gnhLIeDhbSP{8Su^8UcYbEC7s}%!(IHdcHHSM4zwCF;KB;R zF+Gxdx~sq4fTcUaU98ZN=o_7j&Ge|$K7_p~TGMF96PlH|6fd#3^2A?h4ae0tfyEX9 zqR1p?(UGw8O40}q&f{&mq3y$j9hmD?`nbdBR@LbNYRX~vlY&>jn?!*gQMcE$9SIi(?qvI`cgfFO6 zPFsp~+@`}H$+7f)st2NyRYtzkP{(|EXx9C4L7D%?^i=G5wD!5mEd>JEH_*#(w$PKB zvDo!@Jw5cAw@_+bF{cRI*ccC5gqvPT7A)&b+CfZBk5D%m+0Na&hfs? z(1#_GIDr<3?x$vMwanlltsO7+4Y6(Q$(?E_zrL`f+P>}E@^8Lk;Fa?sTVCqh_=Wm7 zVb{AJet1RUuS9bf?x0wcs$`>6n*ix&Br?;SexaaV-?gFhhYJbZq)%G5PmAApjf$(e zq0z2M^{IgD9EJLcD}ddZ+5?c?GB)ahez)^^QJ6kN4pZpk-4zSshGoLH)P%?Pg1XxMfa&{-hny^*ZAcwM^fNBgJ|^2~UhINSngqj= zL4*di2l|?Gc-;>IPw12)7GW`&f{K$BgBj3&?eO2`%s+uPI>Y1Ze=()F0z31PW1is( z3rYwgopY@9=cMM8~4zSQ#Lk;pvER)>EDotq)Fx$wq7Pa5ftkXiba!g?t=}V(D ze!l|Gl*~>pqV108n(nS(w^`dcl69Vo7uucaB_gJ(8K0v22?+DJiZZs#cNGIPo<40n z*6!mN3LUfo=fs|VFYllB8cVzRNR0bA*z@tmGSwJshnj_O0O%wswY$u&q445lV zdPWB$H47!y$1|&h)5jziq~t+t%p#3-yIG-Kdxr2>zs-oONVc`fxrRJlbs!j@z~b}} zBdic&FK(&_c+AVZRoGsyHyQJK;y~bmb?Y2;j+=eBu0e?M@P6=I_toVy`utpt?|9b5 zX!FT>C`eI4tHpn+(p4L+YLPk3)#;dV_4AqdW#X7-p4hAEWA-}nS zo@KQYp}XAK#>nJY$NH>3Mfq4R{V}abb{S~+pAHmrvVy^^fUmFiEKF~<7@L7$@5?(X zTq?mI92;}Q!5<^vlDDg=nQYxjb4W?F!pW6ZJLEtO2XlTi6317D*U1U__ZdXuKNi94 zz#E%)u_k~2o^L1_km~vD3ZJ^gu{{tvk^#!OEI@IUG^oIYEnAa49L|R#GuEdoELJIs zg;G;PKLlXHPOTG;bF72|Yfp*%`|0Vtnpm8?@)GlS3bWyb}IPl;ScPQX~2g5PiAM` zxQ(9!5rSjsum9cJB+HN_375eRmgW&Qyo((9?? z;Vk)?-yt6?lhKO$pQ!D>qXJA!Rzm^J%321b1NkCRhe{ljG+q!TwK@&$LmhO# z^EicVeWKoiXC96$+&0H>DMXvJiaaEiN^<~a6@ZL5#~juP{Q~yu=i7K`ifN)6js7cM1(nLbLv7YqA+L&vtRykDg-c`azk~ zEhU{Y%^NvXDa*cAX@});20|y``yZ2QcN!R+*hf6|0Rds8LV8gtoe5k-9m_8=8Dk5x zl&c@6lP~VcHcPsWubXCeIE~-xQme)6r=Xv;9^bNsHEAl9^Q?nNm%7`;caq|UFQIPQD%|zhi9UdpHkJVBmmSNO0cGUVhMcscVRGMcg4jM|T<^btGj6?x zEV`y~Q9d0YcipQAwde{D>wCCv8;Zh%H7C7GhgZZUm5E4@a<@OdEdJgHq6-);`lwz~ z6aO*4nh4TA!c-%QR7(okzFoJNAQ2Nd4HluInrom#50IXe_!Fo_2mDBKJ*ICF{eov| z`U@$KAC|tqHx%7pr~(G<%vBVn`{@+PS7Y0V)CYQb&`~qvX3$jDGoi->kWMDtZJ(Ok zoYV8RyYa}(8u*=4je-Rp*!SFZD2|^p1(K4Xc?%|5QPK~wS)%nmuGD87oq7!zmYN=r z-s4&E?1x&Z@w*0Lxnj9SjG}I4xWXToCKqR+S3N14*FSr5r2|&+0q@_(JDvMugXv5^ zP?HafJ8FuEwgJg}`rAN`{y)BMnK4JCYcm!9thoxRnf+A-R5z#h$+cL?D=&E`(JC2~6vL4DbJ4Z#+y*5G%A>D((6{8@qtKTi**o)Bng= zv*!037Y?0ivNZf-TUk-@5#{_R9x_iBm`8CzkU+I$M%W$R#*1U{v z^DFBKXV`=mL(s=V8xLf8B%@AZn}N>>0Dl3RjXO|_k#@j$Tl$ErmJ6?J6AR7x<~>l{sDrgney5D&B}XMn^BXc<`3iua1&o-w+WrCz%wV(`2jLh0wP zh=cF{_=nQ>iieQSoG1<@nH4w;LKW$u+}z}WIiGzaz{l0=pg6Q;w$T+t1NjZ_Hz3gt zWzv-NMfX$M477(i-uA$yxy%O*%kXeTlLq}t_wk&k&faXz+5*Yii=O5IDfiUqcSjLV zo+dfbb8dK1w`98HUpCEuG%L)_YtBZ%Al2Px)2URqf)SHSH}sVpT|_@9$3tk!U6GNr zFgqo7znJCLxIOFUU6LSJXm1Qhp~c-bI2#WZ+(A=YHIhT6qKLs(_*yodZRiB~K2q9R z=CC&84W9EPzL3e%fKDMWrfaidc^7YEg(HTa{{!!WkEatSjahxFOxcBp4(1(n{VDwJ zp|o@pES8H*92(jyu|tcJ?QD*wxk^U6Rgt7=G}-jwBn_%bvvS>&1NYggM{0k3BA~qLiM}Xt!ciZ@2PU z+-2+uB<4K(%Px=-0GlJ$l2yxoSd)Tg!mKA{(>mq;=s1QRIN!s+G01H z_~5164;R;01U368lsfu-s&x6C)o2PN?J=!639zGD+?3MZ>k=#e!&%g?Oe9A!f?;$E zg^H_g*evi+SVA3(WK&#A<3nL*nTWUG&#$XSRI{ETe*d^qgfIQz%>U0u-21t43?GmAZZ|xlhy^FJJ`tPuXMIBrj1I=^C4Cftdpr-O)2VSjF&Ht zKk*@?$8XolN@hw_l-%w_embCze$g0oR3Pc5mfyH*&dCy`?uINY^94iN&=J?=z=M;Z zX0VLwvAWu%$a_PYJ*i>*bN*P1Ia3%H<-zyx!0ds;oKjw~CSRl4amPc?qe^EuPsF9)KL#|TN5Uh=R7fFoXUa7L2RI(HP8=p ze2E_S&W8~G)eOM(FP*auzGt&?mgrRf|>gh%SZ~RZx5HY-#{?A%| zH~-$29JwNh3M;vA=3GAl@1aPtp?&|av$qOsJ80g9gVO@VrMT1LQd~<*Demr0(E`QY9g0J7 zD6YXFcyV`vyGx)rA@HWp^MB<#{pMhD<>a@!Gqba^GIO&;4EaJ5UVCG2;MEza!oH`2eU^SVBm&v0Y@k09GZ+GlS{ zspA)tKa14VPS<}aDQlu14w7gq$#E> zF@UR67RAliRgVtRV|Tl_JD@e%)sm5#55U_i8txEQR_i`tMTSKvEhLOAb)(dd#u1?%PJFCuvg)To_-Wis#sViTV{?{ufvt#G2V|yf&^zj2tS_*jUtd?$>Zab)dh}ah}bm zm}cLMut>PAR&i471B2Ia;mFwFtZ8CYQ9#~BtMj;OBu*HYf!8Gnpq2-Y8Ghv&Ok=@u z7o4(pHS(1QfeE5u4LH{LYV}p6`Z4>pyEQuk0YvW7a>ZSo)&`}DUJWZz`=M0Jbgi88 zX|Fdtm_S<-(z7ouC$DZES28~@YtL(i;JtEQWOZlsb#}c;q#&9b%jN7W_M=YA?_B?| z;Et46rx8wAbLcX9%vW3Eq*3W4Dy}{FVaom$E-RZ04)d{XpE^QHq-R(cLV9u$2}SZg zeZe*bmh)T}-GfMe6+;Mw8MyY;mw2N1O_!S!2i4Jm9DIGxgLHE4E!%k+pVpEIKVU3s zo$Yw!751EUGumfM7q7SZ;)=(+^n>jp8-@Uiq&EhQ&iMIc=hAfsm7kQ~-(mlQ7uVH?Em)1c z1P9=Kh%#Uf+J~`S@_^i{RP!>VFTOWxW&QZy`rUj5 zKPd9OWyMG}3U18%31*f5`t7I&Ir;rLbFCGwR`ldrtrH!mbjI~w4a$_?)aeLO)?F`~b2t1nqpFsjS*d^GYu zMnn$z7+91jFV9LIuD{3-@D39Rb9ZLQyw2lfoFF|^ktDix>=Apu0nDL+!o?fP3nkUE zoCwSZ^HG5#%4j%wmp+qZp`Gg0@5u4B z5tNZl0g_~IJvZYo$fQyji-{1pqUO)rs=}(8EvD?pJy-k`XI8lH!@3qK23>j3a(3(+ zzwaXj`Y=tcWdt95b@WN%x#6KI&3WvP_q-4xrtjW|Sd)YhAfvEjK8fE>{E&7gd)1q3 z6L-`3B7APN;pU$37I+c{Xhk1yN}err!hb*zbeANjbcF*Rb&9~AnO+{gbtuL9V+Xn9 zgko15IB+V@w@axINU3Z)z`4ft$QN8R7d+Nn!|mI*V)d7T)8{`l{zefpiMR{LJ-^#0 zCt6sx0Hpq>y4)jiCj>;7fT!rtBqvZ8{iJ4@?nn0ct0TUxH;IG)gVYBs^zOZ zrUz7<2p_!7xk|FA*q+d?p+`q^I_PaRW<3zKo2RNGny7Tz05hM*$Cu50K@e{os6vH9 zu$@0%9oN6%7jt?w%6wSNW!1{|Lb}kR1U|AJybUmGBK`^P=F+71ZA7YZxhN9y_k=bs zY=43FOBn5hqF}PdXf5>wV&K+i3it@TJJ;lO{5Ql^ctY~K^$gvUY=Jn$-vI9s<-Um` zGe6!_iG{)gW})>PC=g0o$I z1fv%T9t3`zV(GTqD)%bJC(6}x-G(TnbeZpgz=md;zcw)`znlSs(8WrU(?T#a*K&j@%?z>jRXu@6FSr1)G)aov%Q)QjBlj}QNXcD+v z2c?2=G4#+}c*zrpG&$)KRXp&o=G1)6-33^0Z4XFp-v-+Ci?NECLcIHO#?B1DTqRSE zH2unF zQ=v|T?p78$Vj^Js0EDi_AzQe7qYC=g;CvgaLt*?)VivK>T>>>hzyZdmJ~NGEa`W$x zGlFKW+~D50-;So#nD}AjAuD9pj>eIgQBUczORH}p>aQI{z7-YQpBfV^a0>_-bAM%n zP@N4m^9P!Tq^CpxxrK)ET9SH=9)5)g$o&Ymid(T6w(69pj&dqww6L3*No9 z>RT-w`cfYSI#da95m(te5}lm?&|V*ya(t z;f*HZI0T+B;?9Jl@@h%_$JG8ao1C67`fw^BWJnXyt!C?CyAW1HKfMoLsb6;c$*i1X zX<44o^~zRDtnx3Ccgm;si|pu7JTFDqiLOHCug)5k4w@#?`IW$5M{Xbi^ISr?wmUVt zJ5Jxc&rrS@aw-4$hBX88MoS*z6%a?0i3Ihg>u^cpL3gFrr``E!`Bd(({vTOL_c7iV zzZF5j^1yLt=%jkKG?DM4K5q+#>7Ht-Z(X&bR_x_`GwBDe29}h>t(A~#wboO>Z^?M;|OQ4{a>Eoz1CO~n-l<;?GQ%II#sv0Q0R zQ?9&&IKCo!OFqmc^>ABm*5x?4);z$MxY1Xl`^L_N(m(s4nl@uawMGUHziXci*Ash1 zWp&*9-0)Fswrvwd>1`q~dEMNn$Yyb+W&{58{(pDlloZVV^j&gHG~@&D;GFxlKZP(P z)cQvUTd?yPY$slV>!4*hTNzVQc443TWYP2^h|a;M{WKY8;+lw?FEEaL}iZ%@qOSF-1qIEJaiFqG3J?wf<^U9emY03GrV| zAmb@O_p-eRnuXa)KPI-f584>UqzcoAl&|mKtTrNfUaTraAF$1L851m7F?aRk@m!fq zMh&WIy2x?qX6XBUE2tyGR5bhrM&@(u6Q4=#Ss>HTYuaPQKz%CauOs}oNJN6*T%%0* z=@A0d_^Iv5<&HM`4)OH;r)f0*(NsLjECSU!4c}M!HaPB~rW0JT;DLEQO*yUMgwu`6 zbTlK+B(aPUgDshgtMN@L+r54l*Q}vGRw3QK8wa-hBoeq!pY8{U%U$K2JEYKB8l1IW zf2U`5N8xNfs7`UMAiYSp<8ymyXZFx}4_A`xDjS@Sb;BVH+ByE7ZzrciU)LSn8e#TC zp|e_r=BiWP>X_JHgp6x+!5*cV9xHP|u}vE1rYszlTk6%xHLK%}c)RjQnPGT zK#wEe!#Khwwb8^t|Bp6$yr*({%%p}jrM90E77>=N4BJChKK~`*Wc@jIbL08xe6kBQ z3Yxq_YIE(Oc$=`Xl3sijKC%`WZ;OVl|ADxAa_x`cZ-&dG${Lzie#X6!$Gg~l2 z+*WY!dFRdivsKMygU0_|bTFTut|l{UL01e&Q<^%?ic`K=-_|o{KSGVJeOXbtJ&kft zKA(H#>&n|S=QHY_h;Z(tCpthr*(BAD$AAY^>-_Ip{KWKOzv#Kn!YE0kCMUy3ji}c5 zGwvt@7>V3tlg0BJ27`o+Wpq=eybI1}XOj@%cuZ+&YMTE9{9g;~ANZ~^ND2poWHL)R zzb!(t@1nfKdHaO51EoQsOVV<}@@NBM@fS4TsqsE!vvhm&Ec{LZq08V`&Y$cj*zaca zuRXA|4z8{v)^oDlrY$`9F9~BX@;kG=9=(+i@Tcy&`ebC0s-S z0H|k==CXy|C#1&bjv-EGYt*zf0$OoIwo5bJ_X=1v)D!J)Z){EGoODnjL})?kuZzfp zo!)O-4XUKPv{}ef4C_E6knrmUhN%GIFIqOUo0il{?X@yjAhC;Al6@%b%#36hoKNf8pV4Ex}{VH;I3(<jn8kM?8Qn_)2bJ zH3bzwurByAMzNuOAJ-gj+}y#V>zmii-a>-2%S@SR#sD;e`cs=SQ>lSK)$oyYg5>kAu#yMugRmKwE<5qUdokyh*rYq`3uNb(ki-?8JIRP zjlvzz!lyf^8}y{7Eb$|evYcgGvO`U}-C>4J^>?J<_4SaoK4Cw{*<3p-$;N#qrTXhA zqFM3voD%c_em{L)4nF{#ac3FDVN8k?lPa=m1f93pcJ;u=7tji4vqwMNOiKAR>gC`L zgBds~on5h#gqCHlV0&(g$VYjCci5X762{FDJNPjdQ+IHEO8IofmENLJ^Ytf5M*sW8 zUH8K2QcN0;6mH6RD@Mnhg9Y<5%c8e^hHy1;!VTZph=(`HkiL#}MJvk0??^di-ut2C z=-vu1D%JLWc;*;;m{*?kzMW4=k6D!SN=RGIC*ada(#_A_9Bk)+R?tBgYz6<|6S`ON zG86Q>!KCq{VWg$a|MVTL(AB*vV|jnS*cWRG)4ry^duvxxo+a>j^BPL z=dY$eW{bEV`^qfsx8;u0y~=Ok`*Gv1=S^;d#5pb8OEdM!GLxEwZnt$-`i{+U-@V}8 zVGJ&P9B;*v*_QL_PBd>KDXt16EtN1F%QgrwrDDaq5JPc<2+Kf5wY#0Pn;hW%sqO2w zu2=_)-y-a<;|^q5M|O`Ts$hyIO{}WtSNb*5oo?v^jl4<#FAa!L&RbI9l8GH4?o6 zDeq^v%(S07w9#wo1~&Yft|x7BpMYqoC+1|)D{Da`{JLnHKc2stQvSs_k~h;H&P0mu zrhijaB5u&hw-lEMDk?ZKU>VM{;$$0Ewk<~e-%8k!`0%!_t<6RT7i2!BuBk3wVRN%J zumpMOxFsZZGgskQA{ow8)gM==4ubYdbsUyEOB7I1#h02LMgLT}F&+M?`0;P~zqKP(3rlNj$K zoX}8cyNu%KUt}(wh zEPZ!*U^0K@EkXp`@CmpsPCrAnm$8F_`bT2v^-(LRwORj3cIiU=dOdq zHm|!Gy%TSix4(klReWQO$W!0pubhm1s}e6kRNp(V^)?kcUY23bSz352#^;EDpX>9Z zA;nUBe0;qN3!0_tpV&H1s-7K01OM(%X8CEnYkti%(>=#a|50#E1XDDod*Aqw!4|m= zQnILw<-%`C@9kj5;=emjB@V5+^vKc*vv;s!g7~VyM0nh8Vlb;TVo23pFKiRsGWxf5c^?D07pr zdN!M->cSuRqtn*A5@FjQ!)Vy>Z(vf*rQt1WqwOBawLW|UP^P3I+E}rX*Cu77rH>3B z-oJ1nLKL2WCk}$c>6B-%EP(&afIM?1*=eriBH!ooqYWEgCh%;uv>!p76W1n2Hv%{w zVazDg@Wn-jSFhk&_7NIvjLaT_S^AB3*x*yt=vK72*zLrTXoXV5SIzgiCGJ+^bIjLA zH+Dr-Ikq}sNH%9t@YVP~K3k8v@w!@;gGBW`xabc%&Ab{1ZU5@rd~_7^Y;G=WLak=F zE*py}RQLn!H|CG&T4>oBcR$$^i_?|%8{1hAAY?BWe>OxOq;ZGm=Bmtx*D`wa${Kd7 zZv?G%ZQ-`@&p-k)(@l=nmWoX6?b)PKWA$hD z2P1*{nAmb=NKS&ET934KzS}v=jQ1azJ0zbkej4qvM7sHll*KSG0?!F{R=4F;=#Q}F zE1{LHcZ~i(Q4!F^h%LJRazEFc^E~7svR;qfrD1b=yfiFtAgpHZ=;(dsB4GpX(mzk1 z*NBJpYaKohuLdZ8F;B}y_=eV2))rH@rdUqNjXij4<$BByDv50z=y^{(1V8N}e}z>v zIp?J>iY@N^9$?05(1&#PZqRvMIO;F!b>bn2Dw3`e+&kPkpupBjlIp?T1n^4M*FY^(@$A*5HJo-y_3K`5aG2;Tf|=jbFJY z_VfVTR-w_8!OBJmjs|UAUveDDR2 zG6yULx;y8|eUOjZNpC>F%`aQ;cW%w9r3j-z{TLvVn3s$fic>buY2R`+JyY(Vg)RO# zAsy~tsNM=FC4G8$AMgQyCxv_1-~#x7MT|IY&7k}h1@YcrB3*2Xpz9MW&r4=(u5i5{ z3L@6mFA5wu%G5n`Fj)nCqb$$di8c>wF`{=cZ1h*JieF_3BI6VUpqe3AZ9dMZ`S?a! z5cL@+*rgLkx(Ndb|_4fD=IWPW!Q{hL{s0#Or zd1n0fcBxN@sKvd=vPF1p$Tbh-DXP@)D+uC-1?rH13WrIKr74z9_~Qhu7crxEKM?mz zobcpuz6hbtv^5*qof>BAHMvT>3FlJB{YdAJ5U7o>T#n21jG#b`Y+C-ny39vN@R>de z#bC9QC!=e_VVaVHt<4}$UG)_LyGZeTjV}Jt=fRVv(wjAw`M-g=q+;7%{JrVir;D4(TM)XT*!P3lSZOA|2{JiU8{O zK5gJ!mU@*Rf{>Tqq%UQX>t~9!c5x=|PM&)PJi!AsIrGP0dB~xf4SvMwYo`dFe&3oo zy2lC>wn$z5r?5YNl0cMj^5YA;nFpbI!QnN-E-#&WlCY6>hra@~x{^+5O+aYab z3E4DT4TGk2KXN=*pXf=G3tUu8Xm+4Q&`KsnWSmXQxK2|PolM?qjUs)bGtGj^e2$!c zb;ZAGY0d{E@eYa9x-qjpb zP}dkAU}g`p%#-=VJGVn@VAOv8bfQO95%WiYcHmTvHY#@fc|OiR^2UElYk~QSC0g=x z;|u#%J4cuM?))T}MM&Zm4MP8Hd9Q;_-pfZ39JxZEL<$$FD0F$IK+eJ8D3Ue`CxKyF zm#LCRPne5SCp42YNJk$1%fA27KoBta0K(I`M!X^V_fZsUI&%PVGplkgE084X$mKm| z(qWxm^kVMSi!K!@X(02)YXNZq&y9V*8PwR_FxJVHRq7L$=Lw90xSCG?-4qUR&7(de z%t>{I3PzGE`I0CwJ-Rqb$Ye0>_Xie@LDsO~v_A-rbIH7VtFSuS%GS!pfI{VCV6map zZgEXf6yzY444wlQp#PX7Hu6?_4(ZC$XR>|i-U-JIYac>(JnwlLVVZ+w@)vYlk|Z2>9;{B)H64_49Pw#abCk%E zV}9I@x4EMx^YyZ>FZcH-X;`s1No}|QE+Cm;(vv#boX^QUNlstQjN+|=9xXggl)>G5 zVYeKOf)`RiOvTwbt0cyMAL(P5h6B7DS!)Hc1^25h8|@hSD!G4$)F_?ks#mGD#Lk7L zH_F}9qq64@nwkwSW8MlMFru#PfB2>xjS?4Y7lU@kF%iFUcd)AC=zDaZvjH2L8gv#+ z$aD^MyF$Jv2cH*ta!z-71#5dAPGd}L2t^QPlEpObIvB`*$RWcFN%+8Do4tpcvKMYV zZm9tqzRcDVaj!XE6Nk-oGwDXng+;^~1-A+gWQxb57tp_oZ>zoOWpQL-2bz&n6Uv>| zRbf>sRT(ioB|K(15?faporwl4=5w@k?gd6WGK)VJPTqDM?M=oRvdxlDeV?!@Qc$DD zn!fk2*d4-%?s{0vE@A+vGZg%^Kr~Hrwfj+-9QClFEPwHu#-^`Yt?@r<-`W~Bz=l)& z{@tqUhhR9Ydl^;_279t1xgWtBLwW;{c0!Um$uso>{h~-|NNAP za8MjGWs#sLQp;Aay{X^lgsboE4z%k3;@W4_wRRUPX-GiEEC9Smw?>TCv(%!-2`!|OhV!t)lKBw?&|JI6NB0gMf zKO=iaH!})KAN9fMc(zGLB3g#SrJ4je@Z!SBSrEj%h6uoCzSizfspIriF zS2H#3j@D;rhQhZ_-=?Try+4&nOwOt}uI#V`Nrh9bcv_OclgP$@JIL-X6PH?eM#q9!>bPysPp~+zRrsuAL9ie(Y5^T_8$`$jI&J|4!qyZXwH#zFvn$slQ@ec9C-3qV)cHzN)v|;DD!tvrq(t6nHfz~M9I%*FB&hvYSJ;ZE4!N@o_hnrWbmG%hygIV|`OywM*QOM?0zQzBSR99@kq)VeUSg$hne z>E0}R87qEtIF8?&L{H!@85ZI8Fpg}44PmS}5YXOu(}%zTcw;f-cHe@vYcIR|s&mZ0 z>)>IJyN7(bh_bT-0hQ^l(l-s-WkccZo*lx6cnFex&5KsPOD5pR2V?Kq7i-=BNhdTp z8r-dGN-r5g}wy`$zksUZS#eN*?bR}}CoI7}WRIF3tqC0PWPySJO0(Y9? zY6h=s&}i9hRPkyjHBD65v&JJ)nol>X&B)gGc*OO-N6vv622Bl*vW<90KpQJ3ryO2c zZ)32)nhK5`92n4E5p~0-a}y2|%251ojOFp)AnOl}hbNw?Q7w@aZYyE?M;ricB7<5{ z@^7q|eI0^K8KGgBA3ldF1|_&$8FDt+OO__a+G0XoqDw~9`ysU{wY!?vp-(>uN!ZWvBAVsy7;tPP{DHrcDkFV6Ej9JZoo zCsgFmx->X84uAQ1l&??7Bk*7QJKI5zBqLO4qu4T-ip(i2o*U`kK>3}XMt~L-t@{V(V z7ff?|i{a<7H{kWvl3x58YtcP22-U-{pVa&EBFa1myp&%*1F%IBKo7;?vU0!sz?yB# zS(BX&Vkm%eK==?a;PT2df{`cn^kj7+<(s|o`(1x9#XRG{*g5okhdcuIt zUN@bP(iREwluBxv_6if`j2S9i+)vvLeE|?7d|c4k+1WDwe_}DpoYnvAD?FGD8wP5V zeqN*4wkwh2=2wBMG%Jpx=l?$V=yr_uZUDW1Z>J3mz#vZuo!K8T!FL4SS7YgGo~O- z^Xzv-B|-eg&|~3|c%NhYLR$<9FLyweLi{M7(;G1cjk3?^cW%VhM--S%%ghReW(T-F zL}VP1gw5P5BlN#JQih*KE{QGNHr0|s_AUV(-?&k~J^CdvifQ4` z6o6hI#D@!f{;ihSxAyB#EXo33+T36e#ST&N*+9?`vqzCy&*;vQ!(?98+1nWpL+L1e#@kH_{T#p$Oipb=_4OW=Be?fgmgB@ zR^uWFK}?*uz|R>?yA2F(_)T<3&we<_uexH~XiXQ}+fzy9JIDVUZU0ZWopZ>WgyXS= zVWdsx;hD%SB9evI%Erb44 zplZ!i%e`1~k7>W?hlV>IS;yw0AaC!Eu1q2ZsL(mMrZ$CC7Y@_-G}x1&*eR*cYn7lx zpQ)|UwfT%Cf*NfmU20fzALj4gP$gne^Lr18WIecKp1Ks|dyO$vY1JFCef#wJy-8tm z6dqC<*n)fVvf>7KqIIH%vD*|WZ5UC?^!@jzQ=oWZn>5hHvd;e)&5-|=?fuuWAn6*b z0M1`W0-vo3oFr3{s_i;LXQLP{>$FRkQZInN9lqSR?D%X8Inlab4%lqPILaLsCBhtr zoVqpK3(W}DpTELu42g(8A|smYbY{TJe41|gr*Wv)PgL;x*u74bJW_4Y(=FCZ$OuUY$zWw-ork|{QQ6wGc0IEfl8>!E_M<{BPLxKT%gk71-52 zZ8LU;D|fM6Zm@9EoASq;QKvC7Z~mq){>Um8Q0KVJw|zUw;F%Fp zi5pa$c!GQ71|z!z(|Fl;&kwlb&@vQJ@&r9(tuGx;gdI3Um`{xt6EsK@d(ATt2w(*7 zK-z}-)8M1wDSpA1Q{C*^Y?QS$IO6+g4IWMf!E-vuhl<~%(z({~n=MOgn_ ziKsQ=r4YGGVRx5Ik!n3yh-L)_BZr3`N3oX__ z;v=*hdDpstOTNJaCs82$25&mGfz2Aii8%jN2m?`) zVJq^qEfL^FRPn03#q3jY?j<;C)r-dFvODB0RNQ%3+!o}y;S&!L^h(sacKLB0g zWI-WK-W%76mmoLYJR|0x&piCpDtXpi2e_0xz_&YX30&+mT=h8-VcbS%R9|9Md}VQ$ zy`>b7oE3Qm22kR$L?!#oQYMSC3z2o51d>U4Xae@D*pjy+TilK ze;of?4NcpH2%RiDyB7tmmOM)Be0XLpt4Q9qFSmIZxlW4L*+Tg~{_9F3xQ{(L{6ECx zF8VJ@wT!!VW${qBVgLKN-`YfGUA9OvY?Fb}=nrSI4xwZ3+3DqHF~*aKCiSe>y2`R9 z8#q1v{3%{Ifh6aCZOhb|PnXEDJUxHxt!M{eGEAXvlG;XRX1p&dl?L14!_>1)Q0Ko~ zM|ct=61Ehag7;NjW8(Yaxo1YVL9lX1Iz;nfc9J;F&s|*c{Ip)0yLaoZCQr^o#$8q) zLk^qLYSb!lF4>!i*EE)0!mEE%koI-g9)9cta!Pt0DeN6c1d~*53edXMci0&?JX`Rm zxerGeIa|$anv(5Et+52V7B}{Mol%_=#)|1JL4F;%)LQ9^xMRi2OyT`dRV4>#&}-bY zx&3DM(>$e}T+U5ZA$7CruHpo~(;30{Z>qnKW-A-)bz4iNnLh9neo517c$9a^)~jx>x|Ux&Fos3NiPxKvLHBTI+0CHqIlXaz3QdKraVq%BQzF2V zxBZLFBC|h_1g&vMFA&bh_YvluAK3PMNuS3J=ffi^z?~0U+w8X9!4HZe@}wBn4P`TC zh`=uW-xK*N_jMBatJ)Egt_*_Qq!wg9`E7M2s=$zRxn+imG@C3+^s zIi;=gE)N8otDx%WBP*u(jk%=lTz*!7Lef%7Je=tbzl}JBkfa`ilZ^bUWr~r z#u#fA{uJzCs^K6?>tG5U(bKy@wi}jc;Ryr0Tn6v0;_ocJlc3J)mINg$J>lOg z@-z$OVYbLMvq}@v-&U#?#%~wqSuLkC#b;B&Y-yuy%I_{{AF>#K{AZqtOc^0!$G=Rj zzpZYFE+{e6y4yhDFj0lD0;k&=XXqu^T`*h-|h891YkS66*pxBu|`(BawA z(bX0I&IT3Hkw9qmYsV@4t%c`A%kR?HfyD6&KCeq-Dr%zz+w+7u`x{HK%_`04NM4$T zYNSlOgxb{6O^G9?(_i~_MaXdFaMgn2J<_`;9{MvyiEK=4(vIFMf%@)GdwcoBIn>f< zQ26$10X1fsAtD1KY@YL1Hioti7Ao>e?FaKN6&Q`O>_*9>B8s~~p6`Vosv(GnYk(va_?gUyX!0G)ppKy}8nK`T>vO^+?WW^;KTBYImY3KT(o{z5 zHkV+`w@75A_xl!#c zTGA^Je+EU}UtL{E6Z#!13EBdwa^iOK?{rY|IG-?Fy1>F9{pJJ;^k!~PMZN?I^B1|H zH+AtM57uMdRNe2D$@S{+zp}Fa3bItg~zhzy7i4{r7w9(K^A(C08_unfv{k`lWxK4A; zf^#;f(kH_y@AJ4`Hh~|{Mq1V<;e{HHO=n5wCy|z#mbx0F_}2x~&30J#2SCzzo*698 z{TFBuD!Hzt`()@zRIMoD#KUml3fAHaPvy~NmSSq~u*j1!otDSp8r$!5DBN$WZ zbs}2EcF^fx#PPfbrVO8JoQY|Kn4X_Bk@G?q@X*C`%_s0_zo#4~o$|jFb41Hd&F-{; z8Oxi@CO$d)NAkWBJCPk4mDUHcG^ww+xrO@E?1w18|HSMp>3|CloGlhJzt+=l%6HUc zA-Xh{h$wHNu^U4+CHJLbz@6KOBBeh1f_Xm5>_da(%YzqO2f3kikN2K2=&-Fm^e?M3 z;>>|}B0kzwWShOJb`h;nPwMtOi{S2!U`D5{0Je9s=1yFx5a{PZpl;buwI=pM8i=5O?;#g+-zln5Lk^CRoaA0U%{EbC{liF`n&5qaq15WYfNBiK_r(SnK%0MgFCHQ5&|Xe2NPEe2g|%=0j_9R5hYCozDSHtLa|9B_fa&N+Zq z!ax;{krHnPJw|%thsCrWf^A@DY$T}i`dLJfPq|0QE_E(_m;Y^dZJ*WB(Di*2NoO(V7v1kWl~c zkb}wGh*pupw^(q?`LhiNA|GJsA#86Psz_-UTpH2fiy^#jsfucqlRQ5|Op0lJ9ETU~ z%=~Z^zoGkD!nr}bT&xT*4uhH+MzqDyP4ZN~oOwv;R~&=|_2qcFA}Cz5#<+S}iiTCp zXJ`abDb=ww*`1NX^0smrpTM{@2b3V%3lk876MyYmQ}}kbGG%S>>BLAv>2}@>>8fL~ms# z=os#gBIf3*W!fJ9xu%gWk}czTVp0V0nzETfX*xHHO5`;bVmQF;CgXaawx%t&bXK8m zW{1aP`B*3On<20A`+#`5r`6F=Lb2ymeE`kw#wCJvNL3`(sg{q#oUf*x@fa{LedCg5 z&}V?0Y*Ut)Y<+w(@?n`y2PX137snzbZUnt+7aC945N*4QFK7Gwk`Q^2&h{TO|BoWW zc5Z*WDEzJ{oRNclZ|s*;$tToKTD?md)Lqh`I+&RE!#~+hOvORfv8DB#%KGcDwYd zWBVLN>j!E^FmvfWC zDt9{mlSR59-1@p=L__}Ng5(+HOg$JIR+ z>k%O$eWM@s_AVal_NuWdB>|tpc3oU(or_X)?*Dq(fd;3w!kQ41>O-hg^(j^Rj}tGN zXBzZ*!V$DDu4JMzzG>H28xDl7WSL48pVtSfMV2~^I(^<&_UAZ8&LwfPQ}#X=p{pB& z+>@&i+Yx)3Rrlunm3S~_p93OL{s0ET#Q2OMR)eVfmC;~o;@S>dyTd1u`0U)Bla5@+ zXYV(~1Lywtu$?EkxHw}bcTWHPE{A}6#_pT_PHsx=MVydbqizzX^ysfuU`Y!BH=ZE| zw|=lk-g-tL#EWSC*?07oR2cljbmIQzWbyrJl!BRBKY2$)Ngd0TJJA(MO$xk_VHIkqg#&Peog2ES`Vea6Zd;c zUy*&cv~u#d%WgJZ%S~hDc>R?fC<94CN_Y=Yi0(mme-SVw4%t1JO~If8P(7FD3iENE zQ;=zIP>^l@xdngs6CWI;y1sfKhfp1a|Fb3Sf31JF%hjY;_l^ctu6*W7^dk&Z$3Y$! zqwS_)ag*7u5Ip=WQfu0=xaVKkRIz*^0!O+G%)!P&Yl?8Y^7ESjU*#Y44nNe=@*O@R z1iozCo(KFfB|!yz_qu!WcX=ZaDy`mJ>9`?%DZ;5xS7aJpvJfV>^D*ZDDM!5S*#{92 z1Lzjb19>u&pA(V34F5pCK)m{~@S%t>nksiVbK8#K7V7`2zO#Ak^5W=c$z|c^qO2VM z(JQ&*Pepv@dLq}0sGjQ^{+0m18+U{j6R+ZzM!Y|w4koWpI=}eaJvkz?0DrESm55V* z`EFyMj@7vJBx3Y|{1ma9vTGUuXySX>l|mCyvb*O2cPu{aiV$Pi1bbKyU6}y@;s}5P zzS`_. + +Functions +========= + +.. py:function:: off() + + Power down the board to the lowest possible power mode. + + This is the equivalent to pressing the reset button for a few second, + to set the board in "Off mode". + + The micro:bit will only wake up if the reset button is pressed or, + if on battery power, when a USB cable is connected. + + When the board wakes up it will start for a reset state, so your programme + will start running from the beginning. + + +.. py:function:: deep_sleep(ms=None, wake_on=None, run_every=False) + + Set the micro:bit into a low power mode where it can wake up and continue + operation. + + The programme state is preserved and when it wakes up it will resume + operation where it left off. + + Deep Sleep mode will consume more battery power than Off mode. + + The wake up sources are configured via arguments. + + If no wake up sources have been configured it will sleep until the reset + button is pressed (which resets the board) or, in battery power, + when the USB cable is inserted. + + :param ms: A time in milliseconds to wait before it wakes up. + :param wake_on: A single instance or a tuple of pins and/or buttons to + wake up the board, e.g. ``deep_sleep(wake_on=button_a)`` or + ``deep_sleep(wake_on=(pin0, pin2, button_b))``. + :param run_every: Set to ``True`` to wake up with each + ``microbit.run_every`` scheduled run. + +Examples +======== + +Example programme showing the power management API: + +.. include:: ../examples/low-power.py + :code: python + + +Example using data logging: + +.. include:: ../examples/datalog-sleep.py + :code: python + + +Detailed Information +==================== + +The micro:bit board has two microcontrollers (MCUs), which can be +independently asleep or awake: + +- **Target MCU** - Where MicroPython and your code run. +- **Interface MCU** - A secondary microcontroller that provides the USB + functionality, like the ``MICROBIT`` USB drive, and the USB serial interface. + +.. image:: power-mcus.png + +Each MCU can be in one of these "MCU power modes": + +- **Awake**: Running normally. +- **Sleep**: A low power mode where the MCU can be woken up from different + sources and continue operation. +- **Power Down**: The lowest power mode for an individual MCU, when it wakes up + it will start from reset. + +The Python code can request a "board power mode", in this case **Deep Sleep** +or **Off**, which will set the Target into a specific "MCU power mode", +but the Interface MCU mode will depend on the micro:bit power source, +i.e. if it's powered via USB (connector to a computer) or battery. + +In essence, on battery power the Interface MCU can go into a low power mode, +but when it is connected to a computer via USB, it will stay awake to maintain +the USB connection. + ++------------------+-----------------+--------------------+ +| .. centered:: USB Powered (Interface always awake) | ++------------------+-----------------+--------------------+ +| Board Power Mode | Target MCU Mode | Interface MCU mode | ++==================+=================+====================+ +| **Deep Sleep** | 💤 Sleep | ⏰ Awake | ++------------------+-----------------+--------------------+ +| **Off** | 📴 Power Down | ⏰ Awake | +| | | (red LED blinking) | ++------------------+-----------------+--------------------+ + ++------------------+-----------------+--------------------+ +| .. centered:: Battery Powered | ++------------------+-----------------+--------------------+ +| Board Power Mode | Target MCU Mode | Interface MCU mode | ++==================+=================+====================+ +| **Deep Sleep** | 💤 Sleep | 💤 Sleep | ++------------------+-----------------+--------------------+ +| **Off** | 📴 Power Down | 📴 Power Down | ++------------------+-----------------+--------------------+ diff --git a/examples/datalog-sleep.py b/examples/datalog-sleep.py new file mode 100644 index 000000000..c0f3ac3d3 --- /dev/null +++ b/examples/datalog-sleep.py @@ -0,0 +1,15 @@ +from microbit import * +import power +import log + +# Log the temperature every 5 minutes +@run_every(s=5) +def log_temperature(): + log.add(temp=temperature()) + +while True: + if button_a.is_pressed(): + # Display the temperature when button A is pressed + display.scroll(temperature()) + # To go sleep and wake up with run_every or button A + power.deep_sleep(wake_on=button_a, run_every=True) diff --git a/examples/low-power.py b/examples/low-power.py new file mode 100644 index 000000000..1f6f710c6 --- /dev/null +++ b/examples/low-power.py @@ -0,0 +1,36 @@ +""" +Shows a silly face on the display every 10 seconds. +When button A is pressed it goes into Deep Sleep mode, and wakes 30 minutes later, +or by pressing button A again. +When button B is pressed it goes into to Off mode. +""" +from microbit import * +import power + +@run_every(s=10) +def silly_face(): + display.show(Image.SILLY) + sleep(400) + +while True: + if button_b.is_pressed(): + display.scroll("Off") + # In this mode the micro:bit can only wake up via the reset button + power.off() + # This line of code will never be executed, as waking up from this + # mode starts the programme from the beginning + display.show(Image.SURPRISED) + elif button_a.is_pressed(): + display.show(Image.ASLEEP) + sleep(300) + # Go into Deep Sleep with multiple wake up sources + power.deep_sleep( + wake_on=(pin0, pin1, button_a), + ms=30*1000, # In 30 seconds it wakes up anyway + run_every=False, # Stops run_every from waking up the board + ) + # When the micro:bit wakes up will it continue running from here + # Blink a few times to show you are waking up + display.show([Image("99099:09090:99099:09990"), Image.ASLEEP] * 3, 250) + display.show(Image.HAPPY) + sleep(200)