From a6a8941d84a4d38129bdc00be701a7ca8fc867b6 Mon Sep 17 00:00:00 2001 From: Matt Trentini Date: Sun, 23 May 2021 17:20:43 +1000 Subject: [PATCH] docs/rp2: Add skeleton docs for the rp2 port. --- docs/index.rst | 1 + docs/rp2/general.rst | 18 +++ docs/rp2/img/rpipico.jpg | Bin 0 -> 89259 bytes docs/rp2/quickref.rst | 288 +++++++++++++++++++++++++++++++++++ docs/rp2/tutorial/intro.rst | 6 + docs/templates/topindex.html | 4 + 6 files changed, 317 insertions(+) create mode 100644 docs/rp2/general.rst create mode 100644 docs/rp2/img/rpipico.jpg create mode 100644 docs/rp2/quickref.rst create mode 100644 docs/rp2/tutorial/intro.rst diff --git a/docs/index.rst b/docs/index.rst index f760fa12a0..58552daf51 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -11,5 +11,6 @@ MicroPython documentation and references pyboard/quickref.rst esp8266/quickref.rst esp32/quickref.rst + rp2/quickref.rst wipy/quickref.rst unix/quickref.rst diff --git a/docs/rp2/general.rst b/docs/rp2/general.rst new file mode 100644 index 0000000000..9ff83a9656 --- /dev/null +++ b/docs/rp2/general.rst @@ -0,0 +1,18 @@ +.. _rp2_general: + +General information about the RP2xxx port +========================================= + +The rp2 port supports boards powered by the Raspberry Pi Foundation's RP2xxx +family of microcontrollers, most notably the Raspberry Pi Pico that employs +the RP2040. + +Technical specifications and SoC datasheets +------------------------------------------- + +Datasheets! + +Short summary of tech specs! + +Description of general structure of the port (it's built on top of the APIs +provided by the Raspberry Pi SDK). diff --git a/docs/rp2/img/rpipico.jpg b/docs/rp2/img/rpipico.jpg new file mode 100644 index 0000000000000000000000000000000000000000..336d3582775b8701d670403b0e63df8fcefc478c GIT binary patch literal 89259 zcmcG#2Q*yK|1Wx!kRYTGofJJm^lqde2!iNBLi8Yd8zqfI8Bs!XqD7R6-iaPW8)ft| zdKqSvG0YhE`2F9#Z@v58dh5RT)|**ppS{mMWw-M!pYP|KO`I(NS2Wc$)BrLvGTlvr92vMNld=Dgyc(GRK=GgBKbZXQRG!k&5~fH5JuG+KZQH&VOKzj+Tb*yl{S#|GJd?0tLkd8fq%)|D5vwC^`EB zT)jxvOCCx=b_*cCN=9*&?5qRe20L}(Kg~Pu_+a;@U z0@z~k>>#inpuBqF+AXmMRM+)hQQvlF6n__+eeur2vQ{SjVGNIiwa5EQG&h)8SlM{_ z_yq)oB&DQfWaZ=^Jyumyf1;sj@Z8YI*u>P#=C!Szy@R8Zrnub+RwhmW7a!askB zh>K77mYDQCIps%AZeD)D&%$5j6_r)hHMMp1ZS5VMUEP0sdJ!X|W8=t)$*D!u((=mc z+WN*Oc5naS5O;(>J~{6f89?!0-2&79%YI!2`$c{}2h`{NA|v+&H;Sv27jB7BU3;KM z{mT9NZSi*(86U=Gm$hEHBcYFBvi2CJxxpj3$csJi+JAcXzt*w$|F3%XKRWim_iGBE zqaXt(kK!r-0Zxg7vN;7#fNVd%&L~g-mrP!Ir$UR@n+v_3QE5LFN`IWY8Sspp#F#Fd zbzx&j5C4qZTS+j42GB{k&0nf-XAE;zeU~+EK z4UuI8=z%35=l_>VTJkiClluR)o@n2O z3Rx$IUFh`~O=T-h;J%=ak^?X(85#k$4HZfeViM!07L;W>1REkT5visIg)@Kc;5f= z$?5XvcY73}7wSNE5f#%LN+SRaGM@L18ob?f1Vji>!sl#701S)jHH<*;^FXW$HRn3m zQijBLumb>Eo3qjh4%P795Fj=elf-y_1RQ;3Gb)84vOU!K5%(?iJ{6!lK-uCMAbnKe zjtHgLijd8s{Bw{)L8t^8y|PZg0TaBhBmn#&p+z|b0Oi`82;eD$=6y(m3T?M0L#Y6O zil+dV2g42m`~Ttc06i6I9#1uTPZipJ3Z->2xx>6Qa5-d}Sq3?f734dthSK@uqyQ2R z7VJXl9lD(WIdD9=3pUgkjvRni5}E~Lr)3u05h`Dv0Y0I0Ar)#2c>pI^3Hh(X zHmBfX4HDS>-!3^n%Dp}OVMB%b5h5Y*8QGw|15Og~9MbE_0s{5G5`dHR9C}99ll6bB zq-RGJbhpqD1?yvU$L{U87Q{Z1^dW@!6lC+nj#mY<5sfguoiBK+tZ1DSrue4ao%txg z)({?z3>`@A;dMlM-IGtB=3gc}dGTUwwPelYS}J5VP7`b~i|z_B+bV7dA78PKWR_cwme1w$6 z%#6Xf@*(m#q&>6A`fcUUl~GJ%$)2hj+VL)Lpzlsl`$EW#jbJg%VRccy(^U%zl??YU zQN4PKVli4{Lxf_GOJ?gYn!i+~R(!#HbelCGlRom6XDSUE4!^ro0__N?L zoGCBgel2ACX2YsRuPq&~hcx%8m&epTRlDuJ{K2tDT@|UVyc(<@()!>Gu;bK4aZf4B z`-xAPO0{yGI`wFHdgYMJ7;p*R6hE2v;M?;A9lsi!D|QbbqZzw4;`&{+c;nu@aEIw8 zwLNDlW?ehjrcL%2)VtO2H%p;quEB?(z_yTaw8ZgJC$xZRks(@AHj?Z{p;253)9_ZG zS?0j5PK3j$GM+jgN_m>ycu6Mupamu!@a70<`9@nZw*2Q!Yw3IK&Vt997{9@Qg%-!H z`5Q##>RP-vX5S>_h7)r{CMMcs9k;rwvBOlO!Q)=4p_1tbyNkUC`IPLUe6w{`_Kj8| zU!Ji}6?INzLv!k0ZcTucy(dBDGycR-mYXv=TL)v}tEgnSE7+^2nP99gr}6V=iFv)l zLFR-NuJd|3x0eP%k+y2oCbXWebOrcnlmhH4235C#{|btH!U1q0(Ss?%I&Ku6?UM zsht7Qil}%a+hzxNqXGrE0Cv?S0X=X5fcp4!UZW|tr9vB}?*$6vCTdXQ1|UEs zo-PlXB4md-T$Mm=C%;Yt5I7X%0Cbm#h^br}$>TZzxXpYYfTC)i(GyhmjVEBcIH@&t zL0fA;UVk6FmDHc$;rXjjL(JM@(-`;?sD2+Wja@{{Khqz|oxY^sn|n3Q<>fc@p^p*eZCqEg+C+nmwsP%ZRXIkr+JKU;L27QU3=QPieixushXLUmO<)}5z zJ1L^d%wA$wZXO#l{9g9%4~i$;4<4^qM>AkfP`bY#xGi1gn^nupm$+a${cf#*K<5vc zRSYm*A_*-Y>_>%#d4591-mMx>L)-895GIcqhUZ}t#Vs9CAq@6o+?5@gW-^%Z{3&;> zAMVi4 z_QSGy^d$nAEL$v)NXyHog+xzxOrOROi5dz4g=7zg}{#0yR%6E(frjq~&P3Ww8A zH`D67RfCP43ndYC28#@>XTTRrHta`B$q}M~GpoefVj0d51Iiv1ywYdlH zNw9KgsYqq2x}XP5i8ynb8n z6}v;ns;$={4>4TEX?WvS|ET?`UsYVThC)vI2^Pf#UI+v(F~vMN)6*}o!;C*tQo-t) zpWE}Wy)GP6;`rvAO3&@9Ump}TQEQSCqjCfag_BPVg(|lY(VDKv2Q@j6lV&3cc;~H#URjOl z3T5bu2le^!@JL}61vY0ti*f-$@&ddzK@~x!u#^I76%v~OkP{F3F{2@u0Y*^4#CL)w zNXTVI!0UfHEC8AymE4b1s9AIWWB~y*W&lGr{L1O?Gr$e<{tPICha+~o_Fg!#H6dzn zK9L1&rg^VUkGdwh?-UMZNku!2u1_a#&c^K=l^^q+UR_x;t!BQ}>ue{RN|4uE^)U|2 zZN?$ch1j+2eQ-g4!>)D0BavL3_zxoKi(@VEZsD(@ea%CVtXduxhYYdt-K=mZ{tMPh z4_lpAPy_SM+gqA>gDytcbBSaYGWgNzXokf5b}G3iyKy9~>zMQ1oKMALR~iQ!e3enM>*qRq5rEQfb2`Da<#O|F$c zxaSg8xXh%a8W>E66`_u<<;u4*d|}XN7D$kr*CqJotf%R&x#fmmUbP@YDPND=JM0lE zk4iNzFVao2(kOc29hbfnq_Gf#7ar_NH`hc2vpQFgSJ#;34Nma2G>qO*xa&9BVXf{H zo%@)TXYUC`MA4Glhclr3w54O7^$cit4n|Df$SYROXAe|R;+og5tQ}stTJ}l!ju=a+ zwMS1FKcxqQ9DKwt@RK`>qA#-Io&kLO$D)R0e3bcEPl+vGoblm~b4Rm)ZCc>h_6tS{ zZxc9{gf`?fMhkmH4B7c|SehMGArTrP;XU&VmF#Xe{3a8gAWWzFtM9k7s!Xt+Adyzo zjTb_GzIc#}cWz5c$vf=`Sr70@b$T85)R#;h2uLHd%5Y!3b2Z}Mt&h2B#g!3bbz0>+ z2T$OXdlt&vcS~X%J#}0K50^j1Sp`iW`zXK1=x&b?o;nWQb+)Ql8NL5EwQ;pJOv7N> zsVDZ>uE?3h4jUX8QPj@v=NK-7X$AhIi6!+ISVgazie6pbFEEy9(~O?4-$`+Cs)}@k z@Y{u`%KP0jqJQq1n^K|en(1{SHebPv_UGOX#PT5*!($Ew8QNQ}YDX(On$+NU$JN}= zfTyX7uvzs0LPb{#yE2C#!;|pmV^CGbe&37nx|L*Imih=+I(7G()3>+fE505kfoF~Je4bZd>TB93tuu}(MOWpDS zu$en|8kkcaDp-dC3VJaQRH$S(EUdb@rUxIJ1|LTM@&KI$%U5B#rAasr5ReK)ZB-v zDblP)bh$8f*RJM((;p-bM@ZF+#HJtk9F-KU7Z2?MZ-gl!Ocx*Ke3)#0(Otu1yrAff zxQb z<)G&O3^GBlU}ulocUdO;E+6KGX$5}k{qke5@1Fhf2^)c*bg75%3UAewGM?=r5V4PKP?Q|h}&4YuM->N9?~17EBBaq z|NL=e`O1KSB`Z1iV31*Zz5a*LHU8Z7gn@Qf31g5Hbd}>Xz$3D@cPcdWY-cKn|one8@C=*+3roRiNR@y$m-tS z#cd`W3-%=w3N25CXGpf~81-w`V&C2}ZpawL>F8PYJLlF*@9x0x9`#4GbUx@Lt((aB-(%5$*Q0voe?uCTr-s^e=JL6~Yg7 zRa}~C5&J064J#bYK*ZD&kKeQyobb2(ecq1w_q*!$=*DOvD}Ox{>3F&}{o1F~&mP^k zkV*dnDiPmRbFJGY&{@&}UP~d%PZsnSZDrUwsf$B0Aln7@HIWfp|Ei1*r&oiM!;7|^ z3T14OL&xe5Php1)F!#xMKZ35q0bYa>)BZNs?dH{^fEwy%>hY!`gUki~?e=`LnhxOr z7B{1L@96LUkV#@$T@xet=X7+KA4Tu+E|}6sbW*0Ch5FEj-CPXfO0}55QqX1t{{gjiYi7xF9i@d86pFn zUl7e00$tf9jlmK?m}@c%IJbE~49N^os(8>3a7XhiR|1uw_@YRGumL(jjv&C(4>}%v zAiTt!;w+!lS3Q&F;Xpx+N{R?sq{RpQ!YAABEmu|AeZ2$2u5lG;3X>#O1!gBw!#$Hn_g_N%WOMb zbx8q`OjncZO@`0KZ;}kN;+fd=UTdS}1oUqxekce*Iw;U$Nc zs`}OSBRFrE2v3&s*7Nu~U;C+SIvZsli?;eXoTEEY&Chx0 ztru)KY+O}JpKfN{F1^sIz2Ry*Trfn6!-RZkin%i0D?#(CnonEDU_>*~>6xyhY^SPY z-f`S8mndisr=5P4`oq=Lq6{J? zqSIO(mTcp18VwiWOfwEAWAPMp!~cvkZH7LqJMX8B2zR3HKgTkPq6L~$Cr#lE#K9rY zVk7FXS_E`3F;Pe?HHb;~({bRq@qX1Hl3~&w*M8a%e0Sr9bkZF2(607aie^o`>EF29 z_j?=AZLeceIrpdPtYF+V%-aNv!4iGa;u$b?7e(;P=@{7*YxmBd=z9HvO*-fkvFd`& zl*bcU9>L=;s21J7Hs7EBd6+LUkYikKE(%dztJ1HMaXif&B$46lk`}j^5ILh>`C+SF z4oh+4dvi~VW6Q&gDSd8!=w@1IsYY&#W|79F$JyrMQ4HHwjO(~P)qJNY)*Oc!PmXs_ zc;4cW3+s{Q2z|)&p838*m zN0u3&1EMIauz=N2#UfnQY5wcepXg!--R*t_}NzY6^Q8s|&@C)P^l`}6j- z1b2ULA(;64m3TARUOoND17qERelLh1_D)Pi21S4QSa{CPbEn+gvC+j#Q_sgv8UhEs zQmWUcgV|1VD;XjnG;e}=H|9h}rTV$n)p6!}Z*5Og4>mShSj(3{lqtSIF@()C zN;W-OT!1yUmmJE>ZYDCXl5qOv{WLu33PLmcy}zlRwU=wM>h1uVIgHnHXZgi z(KN~%Jah-URug0Q>q6LUWdjc3Tz+jo+@a-BDaI?#&YPLBq*u27puv9^MP>88FE^z? zu(iuMMf`nILqB_ozGIP;T}{=NH3uJU)LEs1hwYj=C2OWcnJ z0K%ctp7WQHm$eN|q;4O_TQJmJhgWyK;Qj zYuaUJcG|5$*;yQwHXSWtq2~O3FeOhN{YT^F6|};ANUxPHphds z`(|DB={cHChg_Wlx_kh59+tv8%;0EF3>&9R*BQWg2G~bGdQfKmd8K*`z2KKy_4UfL z@E)3D67I6Qwd{wxf0hat%dTtYX~+8nfAK!vIZ$6ulUpD;c5=w?I|P;rVTT(`*Jt4Q zQ>F@cWdbKoVsJtD4U8zt!q}>EFhY^S5zCD7Ui&Qk<3qdn&vzm&|D4{VrsgDHDUBcU zw!bGkuHMrQxKXpPI~Af~YC<`BMY2LR84NTC*GaUPa>lN@6Z=={uI6#;raa zE;|F79W^{}rK>?l_p@K6K`YDt@>;-$!?R2E)jg4tbq86L)Z?)KF4LHm6GB0oaIk~} zOe_#qCn_bbWvkE z54@2q2)r?Zq8;Q7_?*Xc$kw~%p57XvCZP_kg-BI9yx*E~TEs^P{>4*m#N7N>r zn*Is$oRt3>6_=h-s3g+RFug15vAx98?fycU^P4w^_7hD#bGXj{Vtd9FG1o)fhU#F! zM_h-3rsbs@rPU`vRZYn?HB~7qKED!Y{&g&Qaw)tdJLKQDBGFJ2uA1Z7|KWQUF6lw} ze_8&Tvv8yVR&WZmyz5JhC~mUPeHd7iEz@Q8V5?}c=Ut&VoU`l;0;c(*HM zqT^yrRW^OV1U35hHk!A|#Hu2u$+h(2e$1pBE)NUYez(L>*;&vJ_p?N;%2jD|zVI!M z{cT(KS*F+GrL8W#ERQ$0+kedM#o)grN&L$x$~msumWGCr$G@jHP87p7Io?Z)EZq5W z5_SC1X1wL`pa)%>RGAmX#Kb5}L`aG;C59)?Il004M)7u)zOi{`f}aEm_vq82nXJX` zb$O}#+Vw8{B7V{-@3%+lkvc|6kM`YAkk0y_Jahe|cNr)kaNen=H8S7HWZ zye?8v%F*rTCfBvm5Z^-fYY*aVqioIlUgRNtFs1YevhMGGni{<0H|zLU<4zn0l*ku? zi=9Vt;-8p9AX^wkMK$9ue=!VGrv(cBn!=q0)rDQS?cp)fzn1GzQGz0Ad*yRRZSY}_~&jQ3kUb10+^$;NZ1}IaPk*&xyLflc{^Zia;PuxC zOjlgOx8r+ApC3PvB_meu7>4cCB?d02;Mg7PTIgY9wDi8tnCd{hH*5PHN+5QcIt}*G zxDe`lTB|HiG#TQ@d_is>%--JA;71BWWeQYn==0>L-O_A;ffd+W4W`ozq2Ju>lCLP?EJc@b%a-XG?Q@zt~kXQ5Xx#@_s4AI03xiv5;3VY7gRFre1?6ULN z>)Fq`wdHFP_W$60wuUX|L1PI0q_i^!S;o;)7kdYxm6> z#(PNi>*2&}4LIS`?;zNcIT@ilwS~*ZUTDr+V%RpVdSN7IO?c#h$zrG$_ho`09wRuXUL zIeKah9sLgOlC;hqv)E<*2mJtBW0Gnb)sYtCt&gB@L%g|IE=U-o>ulXO^#@IYCLRf` z_F(b%cgu2Tdt!E6U7df5WkH;3ED{ORAu(qF+~j%m_j!*eE7yL;DL+T-PZ+%pSLy`g z-Q-JC@%$jOAdp6G=R6vo1V$v1l@mNCKwCHfK`x;}hRZt4x*(Z+m_?ohTD{3fd4mDK z)1!V4E|9yEyOf;;SVzGsfwz7jt>-!{4CFLXF=+Z~0=oO-AiGChGTnhJKtCj-5^&d) z%c9)U0;7qLFqE!&2?RjJL>yOqRW3%ITyBxEDg~e z@*Gga8@eibFW|kXu{W{8siyaMNkcU>4_MHH{L`h*iPZ|!;qlR$v5^`*`3Pu{@5ZW& zE`wP~+U>dOVQ=(iFo-F%szL0ub(ey_$aITROj%@JHM`Svm=Gt?G~2AfLK)wr{%X{H zlm@T9$k5pmX$6o3P4WAG#*egkQ+8@&%W&p@V;EeQ6oNXo%NBD9 zSqzBi#Rt|7?1&$`1Y_0rTcS;c-7Z7*+uixD?mdJHn<%-U1^2qVK%&Nqy-NvS%qV=) zw=;y|40zL|2z`=@62(1rDd>E2FV9=}l?QEd_E)hsG2V;T%HCb_G%FxJ@K=$RpgtjPsGkI*=3RDl5uLkP+!g0Uz1(_M03)uM5?gcFniq_Qb;d&Y^s)Sm0pZN4QT#q_D(2tjKwKhCKIf>RJkR34(fSt(`8BKREA%-fFU;^4 zXJNsL6lxN=EDK4oqtuo{-O)2;j8qpn@hu~ zR~~Fely%{&^RO~4^d6$|W+rX0B&m~a;6sVu>Rs=;(diEEYm)1xyAw52Uc1}J@MRm-{)j9aa81WHy zq_u?wV*P@>V?5w+L`&xLLBA!+<&gp6P)zLFWaTyftMtz$T*XB^H2%UzMJKySm!=6q zR#2rztZz(+t@-7<9l?S%o^Z3x@di>qPXt|ytwm;ewugxe&1Mk5veBv9$&YxU;CSpB z3~yJwp0MO(SQz=E;308zN%+kQyLQ9QEY7#Wc&>ZJ4ZTQ!K$T82&j1JRt58lv72Z2t zLATbxS!BDBW|QOb8ex+jj5;2ZAT)S#_F-3j=R#U&;{Crb=H~%SbMXYX8D{I%Mtyaf z&p64Pc*^j{=uVWZsAAV^R&Rf`OvRFlBTIyKfgNgWs%9=SCHyn`vAS;M`x{j?wx%WM z=~FJUtvjV`7T!Xc0!7xVmt_pXbt-F;jF6>FH`;aI&qh9F2`#$zgGoh$rJH}Q;SOu> zQ21aUi5ouSHzsajCscKho=JMMdV02bcMU$f>E;L98GJZygUM*{&YRo{u{N#ZW@s%n zpPe-+x(1}*wjL5&*nV3~#>#<2SYdQxre(UUDh9IsG3;hdacgZEymq9Hx`tX4WIOWX z^}5#{)y*2n=T?VslR;X1SMO)de|7@fK=udVlje%1(03isKsi&+8001#1}B#L8> z&{FQ0oQ}+k2eVqOSPe>Mt1FG{L6SI^#!y7DYm4H`ui^}fON#by9;eI6X>8%S$0ol$ z6~cKL)~#XSm4uDye}tSxuJi@BZQ)04!TdE9V?^F17hapdnER3vk+bg{lb;mW5_IGGx zS&Nqu!^ze{9$kGt0ZH2s?9NE{5s4GezBGS*j^W0}-d_?cR&{KoU!=gPAvbYg<2woa z@#Qvu8h;u8E}V9gEkP_&tHGZ~@5nM6?lb#=K_tLex+LL~@Xe`#NukSHov+`pa#bdS zR8;-fToNj@onQ$_W^8;$4i>dK0fB>D(DsKKc!JES^KdAlE zstRzfpU1=2ft)6Qbv0^;EM5&nV8DHfxC77+Iw~n3aa0@Ri=OWtda@{_x}k6JU*J#~ z%;Tw+Pm+NOXnmJq$KUfa-?JoKczwTJD2pAUBfzRw?d8%HQ}32Ur&_ z`Z<~{uxHZB2D6W=IEA-3wR{O-o?BXiMDA`Mx==rxx5=3b3!7^*RAkAa=2nyA@rD0x zv9X$FZwFZ}@9e`njCw%c3OzEo#J-ZkBSJPqZ07!^f=n6HF?EFhb59ZOoU~V&5}#6? z(FW;N2RZ|@sgPS3(GCtQJ_*)S(c{r~Wh#mtk*=v-`lR$rce2b_-pnEX5FSCHQ#ESU z>hZ{p$I2mIUQ7E%`v9B1#7OPU0OLO`m}hQees}(~TnAMVE1m|qE$T5l~V> zG&h}s;LJTTJC5M}MDBmJslrP!zw8(}$}Pv6MZ=l#=Z zsPNKU;W4?OQzw9_0QFD_9WyY*s)Nh5&xdD4rByST=n|b;eDC zVWs>rdsam~?0yXE8%ZaP34{w-(fV&c7o{^G^Kiv&h@eBgI8|H!tVFVe^+gxXqkhb{ zs+o848&S*`WkQs1VIfgLCC2Y=#c6;|U`a?b*@LDiI_uL+V2Q7q z*s?cYC9HaXYCb4)A-E)NS+8G=G5v{@wnC?Jzu7ZnE>9()A+xN7vc+x?q$O0~zTp_c zxvquHp;S9p3uSgiN>d9Rc@*Px`B^BDK6eMxR`hlBXHFB-WfAYAj6UO2Nwf+CR-!V# zilFG!!gYXVW7oazr!!+=VL9C%-c&J@y#)2>^s{x%DwV%>7ZcuXbTaqBGmv6N(%E0= zqNy!e-WRd~6}c|mM{^OQL3u1=+vvS|XJSkTQRnX>otK2XJ2ENJXnQVZAB0#sQ51|f zs@dY;xPbo1qR(i3^GJv9@9wC^DZ4b4i#uz*I4y0I$S3+CNSt6K$UG=#YUAEZ46f6{KChWTfqjkd(N6ch;8T^?Q*T6tGW4gjg}HUr)MvUk4s#CnZb<$ z*S49#q3*?#5zL7JNM%uHNM$-mRC_%vSy!bU(vJBRng9Jx<)U4x;PSPGW4b?L-0iiP z;ET=UhwNV@+uyoXuB1H4OWxrmt`nGNq{BAaUK&3CmXKR%mE4Ld|Fcxi!R6)_oNMN$ z%~qjt*mPXI<@))+jdDF@5Y4`nNk^o_w-WTzDgM;ovlZqahkvdf8CLfG@@L=)#~oSO zws)|L2O(1*TCJ#wx)`|rX#!;7n^narG8(dYXQV$STA6R&tam6qiuSY20$DB9+}p^s zD4bj&>gUv4&GDNchH!txKTO%bvg_Vr_4*$ni9&+=A)g9-MH9FCKp`IzJkDmd&5A|0 zEF^)>M|dX__C`Vxjh}fZR@T9*p@%&FmEb*}E{oqr{3|cTfsmvFg(b*`MkOqBYqc^h zK6)`V$Zq6mGijhFH^e5a%n*@DasKDd;oC%*jMe&gb|??vey=q_EU zLnQIK4X%0^;+8pSrGX!FqYQ9uay|pD?cQ+Q{L@LF%_efB<8dcmA?aspmtViH=CuM% zDW2WH`4hsR4MRk<)4)|Tp5lP+C@6Q1-+cQ?_&cI$Zl{0#W}=6glXOMa>qHs-(kO-Z zmzeh4+C%VnxIYo4mK=@F0F*&U8#`TUP3z-OiUozhz(G-a+{b^2r#a26U%CR9Sm93{x8H>LvamN%JGJRc zMLjpZr=#ta{zwm-U_8FJNqe!`JS^6gLruDrW&vB)5MvPgqRIA>rg6Ps?kA$)1=HJW z5g_sMoKgNhN%0xE*N@QalJ>RzfJl%anbJBi$Ppp81%hFo5r6>bE3r!E4v{Y-C_pXN z4^SeOhsY^FP1n!5mItsd<+0+jE(}(IDdnJ&z#vF(9;^}x`U$3d{veUuZ$mBUCz&Vu zJe2@hnQl{&xQTO%^tBs9X%W`Gvo{HOv0Ha&`&qxQPkVV5At>v)-2JXd#w0%?vQAi=BuNX4czqIUU*Dbs>hu5 z%umXMxTg&BSH#6W$=-auq&$X&pg!$JzbJC9|x}LM0@ZD3>kzKqrgQU;d-#RXJ}2dn*J)O2 z8v`3|<04x<9#!>_wB}f-!gqWi%7{7gt=8l(L{xgcQTSaq?NQ|2pq2ihm~s**=34`y zs*8i+zx}K_AapyWQVymiHq~Wu(jSF{_DYFAmw`MTr9k7qX8;FD8b6PVz=Q5OEps=m zOYVdt$pInxDUAi~Tj$87wvG_viBrG;01d$cese%@mC@PGFh}p1e)L^61hhvz#jQoC zDlutv5qr0*xaLc(w5g79Si1c80`51{jmCEyqJ)S0%o`LOZT>;cDx3n|rS#63ep@gp zv7Rnl>wEw2m;a@A(fv`Q0Uh#>kBp7$gFo5Zb9N**nwYg97WO8aKQuZgPO&ftvz2z?(f>D3=^o7 zSDKBC&P-Xk_C7DSOl~%RbA-;?minhkaItbX-f<0`TawBZm&^g?Es38Ybe)Nnm9x*1Qo-$04;F{?UZ4g_90Ed|0dx83|5AwaZSixxWHEdXH7U`e-+NUbchjW)2 z^(r)KuFFvOzvOI=Najb>F-&QZF2xe0NJA}Uvn|_aKsKKH3F7sL*WVRPX@!mJ7pamV zmB(SvWMt!6;@uUFUN47&Jjvyi4c`+kOZ&vdeG6d=DOGHD65^z7n=Ax;=GQ~Sq zsN48+ed{w7L6wYDUpdf?_DjhO!VGk$*>{ygzuj}5*s-s#_z|TU-MNK8^guEQ}9!TX; zYs}~ue&tP-;EaoSjs-HuqfD412VjcO}~N%nv^vhTHvGTk9j&y&#OqqA?hHX z<|bC8X+eqI80#CxH+-m7qRc8id3!~O_A!F*`8UPa#)g63AZ>xxOp4U-vz_f` zkE4lD#GaGk^Ch3bAL{==JEefgWWF%?hcF>o^u)DFRC*&j(OHVjnkG9f(VFVv*N3kw zt^w3i2lj1f-?lkrj8W>+Je~8<=D2*`FAKA|wn=p(R-#gCD|LxK9{SjwiL=_Ai;Lm& zec6AgYIABruX|KVkO5+=DRUL}{q22050%oTDQ5mEKHYP=w;=dA77vX@1_**GozuN3 zSEIfP05|PFJPED@a_tLq{~TrkOPr3LQ=wO|S}DM#qns!Z9vy7r3tA`h)Bvdjo8}Bjm=!`qUd12LGQH#ZD#%dhvZ+e>|LQ1x6wh(&PB_qh;$faud<( zNktNsa2WSxsTWG#j98wxMK^6D7B%ZAU%#|j9jta<)}5AFa0?4@R$?%#9=|s}j)n6i zfmTuyq0fhgJW+OFy!-BYkZQ0(w}ngMNZU&+Ymlv6*N^mgf}rGRl2(DU#QL4q%q=S8 z=sqz_mHg<82%$l?$9Kh1YCTvFpSkE8rOb-&dxjy^A`|6t;ZW${_ngPQlNvVNhKl!H zkC~1Jw=WT%`Elc-NrRYz?yY>cYwOY#s@{$TJ=Nx0o)s=r@0E}Gs>XEGd0ui{hCcaQ zZh5=sZ5@nPZYVM;e+eruQ6oLIku&lf?xMSznN!1Pm&S~uQV0{1F3>NKyq(corSKDs z>S-nWH*lc|4<|?i^E8SQ%rGePk``Keylca?O3s@#Jx;*pc-{`%l=iO1;jcnd9kK2- zUs;?8!M9*X4Dg>Y4Q&-0@*sW@xzclkZ>-cc=tEuk|>__dYTl#(nc4ZMGS9@#8*cq%diU{ z1~KrCEQHQlsFpZfnKz3Rytb0paEVS_gYStQ#i}geqOWZgF)nb8R>5!C$OLQ85Krh- zk==WxsFoGdr{NKZJh<*ea6WY;g}4)qA2Bd7@g1NMXTX}Z=NHx?o!A@KX_nX2(p7mWabt1{zUA|;gDad;B&}FUoVwn^;YmR`=;|@a@$ZVvLYq9( z9O?86Mo(tEc&OM-6MvDq=ftY<4@&0!LNpqTDw^sYZ-o|e*e2%ZQ(&eq0J~%kEp|h zjov^@erjj(GSv7&3dUu7QFHH#{oWm3*40f_9}_+ttxDBu zj0pOxw`v3vSmwElp`Qzvg;zivb|-5V=R4e}@bgxuzk}~@UYVZQN=mwJB3;2-n!4DK z+VJY_`{{ow-hwQj^dlZdrO`itYfJA$mis7E*=>YXb_Z<`O4;rJDzRzXd*r>y%_y9a#~1U{e5a=N6}kEyLBiiPr@exi4_3tx zj7CdLO9dE4QpX4(QC97l3{&g%D`|J#P{K;pisSo$jP;|W3HO2$SC9IAshy&mTBAl;B#F?%HefgO!VhJi%m*{zgJuM!5C8}{%%1uNyypwzj1Wl z;cT{VAJ<2p(rT-;_DEY)QPiH5rvpV%drMV~NKrdh(xudFslD1-HA2-U#EiX1YLgf> zLSjTnr0@NE|KJaf!(rrho!57K&IM+wb462k)AI#ud#2J&w%0mmw$bFH$eS(Bcf0TR z4LY*zd}#`iUYwukj#f=N-w|xTH4&6t?O;b_Aawg%E@-KcCke**OQxI05gl4$$=Mv4 zOrOrHE?o}Ex(qw8W1NT5oISu*DS5!GkcpS66kTASD71{%%LGrGCBZ6O zo9eVBPsF}uf2FNQ#Z7?b$zNQqO%2E~CP8t`?BBkgx&yu2Zkjn0LNWXj6U&w^;Xf9W zE|7{Xlft05cr%lX@sm*?tdgO&5zS5d8^GWcQ54R4dQQ9(!f6jTYdgvq{8Cxa z9`Tspr7zO$f@;sO_!Q;}aw%WEjwr^1os9x4A$9=>>~r7Xt#<)&DQ`JL9$wLK7WuaG zcqK<_%_qG}l`N!L4#P)kLV|A{)FoQ!t|FA5`4z*FhXaB{Jqwevl$}eV<);m08C(7# z-Txac7i%Vj`zZm`g0hJEv)aqyrW@p@vB}=uY4C2YK8?)~D018&oL)BOphENms%U2U zCN>Vb%tT$OgtQON*vA`#NEK>CE7~FoFIjISoX~7`RB9ohP1jSYDfqrsNppLn8IZKj z06A@~?V(AOJdOGJE*TrenxKfx{f0euI@h^=BkzBw!yb|$k(jD5o8|eyS^b8zc8(fW z*LWSddV)+2WJRwc9#ta^Ye$IHkQXB~ADze)<7=EbhIq_rGRIq4=^W}41@i_Ul5;vduWOi#5B9bb1|x>Wm(8{a`) zBq!qzwJi)n=IORgsr+%r<>gxa1DmIZ+&};=;M$Sv1&yVQu4g^J9>1{A%j7XtYLi?T zH=Z&}ICkUh_BfT2ZGEOGT3KKq zZAEW|snS$;S7xPE+#@b4!KuCca3Xb&=4#FNQ6;X=k8R zHZ>;T+Sph-AAoj~yMN`_3CqsMyW?@``UVuQLu#^*3H_MIX>WTRNBQ_P%PZKYIyT3` zI$%ew_(y^991uXjt&R%9kDt5und4Eag)^I|yk;7>`9$bN4hLy1tk_@5#hrBScdJx_ z&tRzdwhQeU{o!deI$XK=JKP%H-+}X4Beb6stZ}n_0tW?ni$*UzdG~r2u}A*>{Pt8a zpKouIVAfTvbq+UPQnhc)w}=NSgRanpoo)>PG1eED+1XCWWi6$x1r91IB&CIwjA+EE z8>dv%>D2rBtSQEC_iQ6v@66g%9r@}mAUH|j_nO*du;EldW+)6LL$L@q!Wu5vk9oEm zMX+|JUC2Lhxxg-2SVbA@zzgD$_9R*EWjH~WLbflz>I3VCpKi=fDr{76Pz{z>>mt@e z6D~d&(e)T8b%QlNm!qo+#Ds+6dXVfGSHnQ?Np}OSY&bc+c8*FXpaGL=LyC|cKX7YaRh_2CB}xV zc((`eSJ>bPC6~ANV^6=EBu9#_q|B|XEbZy8?Go?Nyci>YnQA-_vB_kCuDYwxL}eP1 z<J&nkaV zhXL_^9`dSsukdb?aozA2t>(E?I0dEA?5sbMK(S1MQu@1=UlQeN!AG-Sg*$Q!%$*OT zWAa6)$TqkAWc^|J;$D`1qk9niV&-3_*U{^bnkKxgo{}T*gZo~QMln&&ba2$E#}Qqe z|K68wqsln1Td_{x;{W^naECamTPOb8!Y}-}rL8s+5-PHJsG$EjLdnBte0Bc#m&R|U zxDe)Wzi<7eIvDlu_Tf3aINE68L!i6r8L7HtNy#H?bT0BN8jz5k>`}IBDDEU!)x*k( zut&J5&lN`^qV%FVvvHx<<@JU?_U>2D1dbagX{B-KEHkcR?AdXq+Ye68N8IS$bwt~enL(ltPjoXbYzV; z=DYulqIGBDFs<__!?3MSG=*lxfn5wyc`8uZ@sGr^hn|VYy+f`3)(w|>^qO^;v)3!r zY{kWbms`3l1|~g__$_`;dE|^##Kkif zB5NW(*HPyU*m|XTkgbfQ0S~kGUW@m{5<^N$D*XwFD#7!Pp$bPn8Pnv!gX5LezXX|9 z*Ubp$-YiRHrA|w6JsnO+<9c~fo)nDb*(T7gJyfa&N(+GYrL1>Ne)eZO_TH%>!m8UQ zl5&sh0{cRs$=>E-1;om4*=J78F1ntu`MY8NX&&p4iE&xANqAOC3#&(orBs$<=Q=bY}rt- zjtPI<%Arsb4Hv~21zkd1L`)&r8mKN64ueGtH}9XdM|uA^a?9O zZ%|Xe(}|kL7C+#6`pZYZ_jZ1E8SU1raZu??Mtb)v9Z(e9m?w4ot-oZu-sY?)N-${B z9hYGVmS_>BYIGr45jQ<@{vmVLl$U^mku$k?9MO#M zFIlBaBh#9wIGte^ehX_VExo2XP`gQ!uw_E_c_LoVrQTw&F_@`` zXX-Y4KmT8*aT~Q=#~ia1lU@?Xw{r_SrlEa?3#JIqW`v3E5ZU_*zJC0pcqZPWKs1lH z;sb}??XJLIdMcYIpF2G#MHig+{Ak$y+1|h*aIow`1M=~BbjnJH>uilc`t=OOITdWF zq6s0c_(=NdY2op($AS9%UnU3+zulB$p}Mb|3y|^78N@E znOf=JkGa%?vt;;prHID)>{kiOibwF>Geo>Ww1)%{4QLuvc4J_i)>bNm2_4p8A{e8u zs>J5e$6cQ@!CU5+Mtkn&OE?U-p*BsDpGcMRlx%Fka$CX$Nz@+aO0JdN`?m6qUi6BU za0i+WW1PW4J+oA-X-E$0eg#$c{JHn7TLIFWn{xY8*jNMeSC-hM*XJwx7iXCn7t+a* zgfCV(SE$aR!ArTUb6)TJFJ=Z9-e+wSz@^=1Y`X=OI^S%#ZIYFrH*spv$MU*&K#EDZUOVA~K@-i;P|47MaPV>hVXj}k%k_7iKId9fQ}`kh2)>^kgrg1d=<0%l zIHkyW2$h-^l0;{o-5=BwMevaWlYMIU(-k{6Hja$Hnj_q|92%~n%6n^n9{&#c8ah}*W*F+OS0MjKgasw?F9WnM9e zcv&9IPt@X}Ta)WrAyKu9Tnu4{6e-Z>a%d z>4))|G@dY~%6B}Dyp4_Zn$6pdS-nzno5;XEmXV8A;)H~0FEG=c9C6aEyr6)hndxF+rJ!&BdQxuN@Ap+(y$GSaG&bSsqv#0(JVnUrETrjG$| z0^SAWuM+kKyK@Tsu`W_i;vYs^3+f|=@(+>y{>jA6)ZW_Q`tnO%$a23ScXNIDuf=`b zQ>JmcxAp%r&BqpjG|Iahq)LDItC@|QjFBNz=jR=+-P%!ze(KI7-VB7>q7CQVt}%Tb zF%J2krXdP23$FuwMrIs1Sq3O(pUFx8x?bphMm<3B#sAwBNkHz~PcP{|wk(sRt^dyH zZRi3C?cRc++f2Q?I*->CnVu26+*g2!C#NAVr<&)q2I=9UfxjIY0CJ%`pLMEycXjKil@v7Y5H=>b#3$RbVmQqab%G&5Qn3gB6@SL zAkKt6&1^O6WqUAQoe^+&AX~dPF23_xXZpWQwKkzHgmbH=fq@(z9mub4Rv}?t6s}}f zVWSKAe4IO`@?Jz(ply95Zv8`zI=Z&0NH*dx(`?oFaMn@6Z#&8YDYv6*oN<;hc@>3? z$X`HpM+TG@^Xe4GDwPeKX^&kMsC$T&qvR6V$OH;Y71c?(vUFPK;9af$@#F z4+y-5;`@pxm+M!o;ySYgI;tyG=ai*n14^Dll+I&Sd{XFjGlEq|R6I!&A2#ej9{P2mkwYknHM~QLN3yAXS zQoK^MGOPMkK@S6E9?{QTzAEZ6S@pppao;}J|AbcYg8}0p98g7^&Ya+g4O$?YhD3*x z0H*5w4J4^cicTy_DFVoVc(H6B9ToYvzfhJ1=1mfVy|RfO43~FT?`y)YB>9&AvFiQj zX-j1%!ul#BL(4iI`u4WtbfMXWHj(G9P=RgWANDNrFx8mRx2zq)-#2{1XbQBgivOY} zN|*ph&;?xaNj;~U+`!U3JKK(L@s`+AF1&^=6CYbA+N7-}IOb=Jr!K7RARoE} zJ94Ye)Su{KmF^IP5`WbxILsexH~Y7}!fc`outbckwl^x&Z5u^7zK(qu0Ue_&8oaQOiE|pI|~khL4Pu;G%f(LnD}ja)m2q&>?KN0xeArdYbmo z6aIN{{q*blusIcYiv*3B~z3 z-<&an;0_tOWXLs_>Yp_YONoDoRPZ3%+N`{yDfXAda>{?KA`8vmX_WobQl;DoWypm9 zWVGkynD6^Vj&?KH)Tp%9kE@ah?I$I~wlnd11YV~CwC5i|ajXsQT-lSK;Jp*goJ5+u zBg{_tA(;&y8P}q;HM*rGN|yNs93bwUaxnhY4*irra>;SVX003Xx@sjEUJ-fF8#STD zXK@^bt}TsDd$M&eK>AZAajdl4FmcSWun{!FbvosiY3D?M)I^t}Rp;U+eHj##Ze{yNMt zUteZhm(%SnQ(HaC9;Emkz9QN(rMBy!*F?mN$F$z`A?We*EeSxET}EcZcVk*)dz~~h zlDoz_yheJZ7VQ_#r4ZajyjE53*E>IV9?$qOZW5Q*gc+zQ(_u*JluxS#P1d$-rdM?-cSj>}{o$_h#LBgScvxedcY zKO3fjM}a%JkN6p=BFQF}Jf0_ae!A%U%E*Rdg8Yrk{ zlnn#;O@n`#q>_x3X$^LpGk?M>X~K+I9#HlAJI`-q>@QccYfMp|hoj3Zc=p?cGff|j z=fxA`tf(zskqP?LH>4_j5D~g0ZQL%*M!oOzW21JoI>>f%=s8Vo{mUKm7XiJRh-7Lx zB#9s=cwe&5^R|-c$-2g@sS{Tv#C<$*hAGS9x%fmdkbH2s$C zLTgCtZ#~NnRvRo+*euc%_g-tct*?3ejaV9ATh(9071RGRWfBygSg2bE7b~$&Yt*@y z_LlnF&bMUHD@Dkc79-Kxu=3KsO!?D&sGF77<9!u~45bq`ngC;RD(C!E^=?!M8>;h8 zi^E}Y(%HQ56)l2b=o?5nIUn|n%xgcCG4-W}HV#RGC>#yv?LdvhheWu)8L)HVC74f9oO zZWr}{$U8$7ZD`1Rp;W#6#WZzw-dM`&=r(B+oK^`cDuR z8Vuw+)+_VA0`rj1#OUw?cc%5JcR5%90*HD6&~_n6Hn|Hfe}G=4|_x&j;}#- zxi@weC}z$!_|{6}wwJG+jdK3{TIF)ES~&!OX3)Yht=?P}9kNj&^dMpOmI=+wk1j>UPZ$fRoLx#urPN`Bf$T zW%?RYYjXTxOPlf)kq8f626rVSq@2VTFX!^x+%M=3`ZYCQVJ*`A+M*J)Fn5{QU5RfA z2EN}!s+BD;z-}+&y)TD7e+wdl&!dvpBb5?V^=|fyjXk=dOB>*0yHfP&++$u|I?o5H zc$~b}t^WGVS&648OO6%Orda#LxT%H145&x>_`Ezs$a+%N=$_`*EPR}pJ0?v>Xcy#{OyKk%rnPeANpc@k-KpA zzepDolYmS|A z74&`l`qEdI=oKF#M9+{Wg%~JZ0y9CS$uR42x*Z|z;{1k|XnmFL=(7eZ_l34V37W*^ zf6|R5t*^EXy6Go0K?DCX$x=Z931hzm3qRcYvYzH=c4YRhHs@f%ykES*o+bj)R>F)dJ~hf8 z%!!y>xJG_XHEts>$i~*NUu8Y`O+=^UZof)upSx=l#Kf%N73Ae-XGRIz+pAl|O`Hs0 zhBP6}8K2gcvGEMQ3YIC?!WC*O)xWV-%Wuti%<#H*e&dmH zoMgp}%cVK`Z(>#=3!6GLbj5k@?KM#5bQs#6c^5~JW+n*Zud1d&K>(pI*5d3PglPeG@sVn}Zw za;v-Mc|NK7z>!AhInI?b&Sj3MUToG-5}vX&MT9iTrhCx3uRv9#@@HpGf9-pTRMj%G zG01=N4oj*wGRmt|Tgcf%)RV5l4n`rk;%IoPaIfPbB#r?h8RY4xveJx?gOzrU#c`7d zw9W~}jXyKo^UA&4Py&Q{SoiF^*kK^;2N>e9UegTgT+sUPh}0YdI;kV73 zpwv7|;w>pMG)quC*qsj!!AK_*^!U~U?P*ggtS0^RSAz={CK=aN2*-hb_}w!UUfS!PjZZ;)khL42cXo zo=DU26}Jz2Loc)(21E(YZ`F^6RaMt&#%w`Bj$eGPxfmX9O&=h|OEiGYNUjh=6funC z@J9-S@iwL3sGcM=l8CD-&yA(uy_nHgvobrn@cDyfn_$N2E_Gu`b{0d)rHU^@*lgTq zyx)5UcwQF3@Ix6F((GDYQe>3|2V#ymg8mu(Fz4&b&b61=?;P1JZs;+KL>>z`RZf49 zI-|~!T;U=f-l!)wUw!ze2CTrijTpoM6&hs19e{85XEp2e9$(HX3yx! zV2@#3+t|0Emg;3o19DGL2#!ZRe7SYLCf@Np+$Df_vuN!Bi!3R(6U2pJg|iL&+HUaj^B}sITij*fU!*=xu^@UYb)j|7Wyo1Ek`ZasXB*v)#eI>b~k! zHBjK&Tb-OT7He8%kpC^uAxZ0NZnv-|iM@3T6sH9yoepJs`xQ%nnNs1<`?rrLVKCa9 zv*hD1J=YL2tu~ z{mP@X3c(*MRNnEfXX}Tlto_M~Uo#!-j*@c?LNpYICCH0i-XAgi^oO1W;Osj%tMixQ zV%3(je=?bDZ3b7AF*uQJ_gYxtK^?uJWF9R4T+5A!2M)?_`von>$Z1F51($n|heZS} z!~D9^z-+345f?SNR%j4yj73@Yq1WuO$XeJ<61F0K?ta=@!=&!^WYTI_T~>9hSyfmy zzS^>Bd@$D-P}s_V7urx#(HxW^)`C;CE9Sb@l3w{rAU1z1>7(4p9y==Bk2DLAW)b2; z(qT%9ndk(Cm)l%DyRC!42u^a!Ig8Z~hP}^S3k<{4y5?(2M+=G0CpfL;IUR?HqVxJY zvF0xpyTk=_h=*P{jKfej=3HtGQU`QRcshR<=#&I4jr>E&n^k0b|39#I=-B0E_cKtP z$7?{;W$QmywF2zzGwNgi%ftX!`Xs>RY6fV?7XXduWOO9pEAzE%Z6=v}e}FG^e+nH$ z={&6r6QNxX)2t^K)-6lhIW)vyAN~EmV^eZR%%b2Ez4F`j*gg2hxMux;D~MTl#v)O# zh6_<{DB9wg@8|3THf^2iQf-iY`ejCcXVl1OQ54|>j7@FsEt>ES0x>mCOVpvmZD}(7 z8}M(!O?Lna6%f9~=@ynGb7t-_%i0-pVXZx|K(#S{m}V7u5|^+(abOVToH2A?;c?YD z?3@h3b=bKFtWVeNdJ-7?#kNLrFYW@#C*x0+*L-8a|M+Zk`9)CNOU>sXZCN2BR+hO?t05{g_V<&`S{2E+ z&@ia}jOvVZDN@maIG(&Y%(fBG3Xc^wev23L3NbZb8S@|~uL8G$4$)>*P+ZYk8VgtKoJ^1%}3FT~{%G1?d3r^j3uLO_5KzcGRsk7hTc5rpiV z^=VGG{X!!mNuZm#GDfr(KeVcI*Ct**l>apIeA}^u;I#9#OW{R=8Usm+3!jGu$$iNE0UrlzV~!*@U#1ck)E;i-0@Q{NGb3u{e4Nj9rmR< zZNXj|Ek>`$n;xqQUVIJa-vPS~0~tTr7_IX&bQfwiIb*+L4?-=jHV~^DVNAljU){KR zURIP->Om~qvy#eoxi+lS_Rm*io|MI1Aojluhe&^mZ+)Pe-uNnPZ%v=(i>hukTyRKq zYeo$4uVWM5gQ|nxVO+fhsBd|zjnDmQte&yRNf1%0i{V}y+c~BHwi_DC76&w;q)cn7Gs&+FaMJu2<1#Lz03gv#bV32N*6`Jc-TQ@a z1)8Eo-yBQsvuNVL%g8Hs?toxe3@?4i_&rt~P=i5}PA6hNL8??gb;yhfz*uH}UnlmQ zwNwlJB2jq6_*^9L%y+ILw$!|>TleA29TGO1 z5N--HRO!H+WeCE3lAXt~2Q;&PU4I`x(9f#!GQ(WvXCQts83d+No?`d!pr`;6Jh zPqW3Eu1x~Z71ANBdOr6(Ig;CQsM0vmvOr+A;4c&UG$ef8y3yZ~Qh|bd zQ+H>_UnUpOdPZ7*qSjO)3J6(7iV0w4g`#ngfFR^b%s;qx1WT2PWSPK8-!xQIYyLM* z3Sj?usJMD+jT@nBYA${*^C1weo)97cqxjAQ?H>=Q?gAwVKqA=E6U;=~`}v}+vmQ2u z-{S%O8t&JWJHkLki=ui7?{gZw%vn1Wyct*Bz*< zX(`f;N1aK7BnDi>7N)nabaX=e2$czJh8E%3jdp{J#ix9&S$vWB zC%!p19KY}fGF(wbg^kDVbq$1El2rm#d^Z9iNwqm3D$J(KDYu_m}B2)gs_&^qAiDcqRL)y893_ zQjV|I+tX-&lmUa&j-7*=)Ox9y>bi{H;+Y_xuR_;HYn!d+Y&WR2v3&mg4$|x>3tW;zie~U z-O$0h@5slo;(C215o+2t(|wM+=&6q|p7E0T+;qTV0s$K^7-RB=cn}x0>rf39lxZ#U zS-YljJq;g+ux{OWtzp#)=B6Vn;1%6LIf9KfIa3QmPC}@dVpi%F8X25$owBiOPepj7 zMM`WrL=~wZ#fH_L;p1q zS0Z}mB0aJ$UNLv(Emt4yGKY4UXCLf-qtoyRWQN&baredX2m$>mLq8b81*Z!O#Q5!W zpB95%g``@ia^CtEm=~Bha1{v4{x0w&_hZ=k%VlD2!R2L`VCm|i zAT;OgXFYw!ER9RJwXE>B%bRetvaDuD$#4GxBfZie4L0qTTh*z<4-dV+?*zvcTm0%a6f{jIl zBP^dzgyqgmAGpM~)dRj=b9&0)e$#q5&AE9GuQfMXQI4s1(I?16o9EW8`Kh%ZcMx^Mn(L0^LY6LQwmGa3KCk9TNMcmOBenL$L|x9}*VX{{$^gtE4OYKH3oNyWbY? zzSm+7kfd4f+#|mY#>C((F+7JcTSVtaLrFe`sD$5Mlds4wz48Hk8mC4~ge=?=;)c%- zyIfz13p~Ux4n9%+CAlFyt0Hukc~!c= zL_mz7@jw_u;HzRe-MaPlq@e}{y>E`5(6efyX@c?c>dbS_3uOo(fK)5M=x_WEWMOJN z1Af3S5T4rg2U^>@j_us%JH9{X4ZIvUEQ1H4(G z84;ZVH_=s%v4#R1akI`QcitldzJ%h|im;Gq6q!IkG?6c3+YJm=4C~(Mj1t8^DfWB* z!xVoSjDVDDgw z@``V)mfG`G^%Bp*)&8^9hRtT4MP4c4{oqS2=ff-o6s|afZWKZ9?T_7{_T|i%gj4h}{yV{hluE z@)i~$F&;y0#2ThrZZ-AC`64VM!`}QBmdheLSal5x^pjweBI-sV==Dr8u3ca-Xd59z z+MS+RV9gpR<{B`Kkn)yI8zBD#1yBeqTrI+o2H2|i)&vb9JXmQRFYt}aAl<2`2aoxT zEiFaNky9#Yb@RN)YA{iWv^mtj?3GJXU7!|wGp=<9foC;=PKwaV-N9FGG22A8#=cK0 z#OG()Rsy&P;A;$(Fmoz~phM2>H0Gb9zH>~rwG-IdU`Z~vy?eZL`)*0A&uf;V05CcLJz z){a2I#Az&F>Fhts7NfyJ06>dvsW55TIBF^*?4;=Zp+hby)dNSQl-em;?4i(AZ)A*? zF7tX?2tF_LUo{=PR|D}i-W|<-*lzRw7hOjD()MvOd@nzFQR#Fx~83Kf4Qu}`A?$uL()FM`vc>K zyP2Iw?V<~M;^qg9j|zKj@=R9}b|3vdiPu#}BAW@~p#M&`!-yBlV`3%hx1;vbAw{rBj?LS^S%4{{?v zJM=am{`%D>guEo_mAUV>n2q)EL1YfN_V^X5%5hC&;Nvh}Ao^omDtx ze8f=pq0A^evoqB*6h2a_IPUz?-t9v3HFgiXTz=hBFeT{q%S$V=Q)a_%a57%EUvZ>1Io}aogi;=B#oJZ}wI+GXH(U0x;?yf63McMs-Ksej}fb?hO6i z?^@rf&dN2*L`hmJzZmvgKAbC{KW6dbAC*)#g^gEzL|Uct$h=&3{l&RYA-MZr7dJz0 z)d^P?4AIKWv72(W7UDYu%~Pic=ie|G-Bz}_AE1p4|?;qIMRL05AOgX`fm6(}@t_cSa) zq(k#E%lVF~)^_erlgv2FL*K*@{Zq5JGUUAw$Ak)Mq(kOI(&C4mTWDC(neIxbAV=-ZY4imI+6XIS^#q;ouFV9JJjHT}8V@O;z zrx0WGi9m-VE9of0AJDWkteqa&*Y#avN9vDcwzu$MUN19gixq*-DaYg%1)oSmt+nY<8ra{nM`px&EhIsQVt7-A1y;%AVo zG_=}Z`sX;<0+-TnwzN2#KzS0qYves+uq+;d=q}nELG4CsYIx+5*QI_q`vDz_An`TG z!(4l~@pb{Z6uVe;)LDgh_(#I4x*uPRf=173cRo8^6=E*eJA1NpsC43X84sntY4v7t zU>xdB_xG7py~oH}rqjpq+7}jBspH0K9kO$M`qiG_zlhFxbkyxj`5TFEt#3numv`fH zIB=RSOWxeJ^CE`VIE?Fp5)1Fr`0gLuU+vM1-qzHhDboL|r*=EzA-phKBweJDzgsI4 z1{0}Hn)kjl(E9oZTD)P!f33whBJ9qfNL<^R#iov2bgJT=<0On#RdX)P{SaJ1p0i3N zSlHHw_9a^bha(lxrA}^Boxs52wTDFAWng)=DdHMaT>KYc#gik;HDGN0 zyZ{vacxr@BMwrx1fL(BWU)O;>%ljF?`qsQ#ubH!a41f>j1DkbEGSmUBw9ZyH;C@P& z+r-E@s|3yea=1v2D7;F;UJF2ImdBj^!1}oL`pP;lubL7S$Z-5?O=Tgw;<|E4BkXu- zXULe6xb-fN85){tkluKGn2qD!T_zSFvyrtQC6-FIWI3bUob95tp;4}jwCkSC1>xN; zJ+B(RL{5tZQY+_mJY{QG7qgWnMUR1DbiDU3le72CRyXojP#kKuYkV+Z>D1OG!M+Lv zp4NFKb9FxSB>tY%!FW69lBP55$#8Hf^&ws-^E7?6Lnblxs!9rFnAauQM0YTy=g$2$ zULqtBp0~W9@DU!J0%Ef;IT@?YrD)qU`)Rx4_pSVo_@lk0meSxi+9DRAZ0xuLYJ zWAC7%**RDUHnPyev%-2Kt|!zZ`Hv^LbJb@v zVdCrm@_3Hf<_a7%x35fR3pQ!AHd$ojWM@_phr}6quU*#_7kjwMBTJ~=;|Pmiyw%LA z^wL{>{br=~C?e5wCiNqZi(_tykOP-f#N<*Pa zo}syZVLGHsbsv#X&;I#$y>t=ASYzUZ{#ZKejB9p}g>18?O=hbl2))L@;C-B^ml_Eq;T+ zMjvh&y#4$xUn&mT(C!a2%6ielYWj`!N2wU4X<=v#W9iM91R8yRnIgih0AUaM%J%pF z>i*%8QDrZQ`MhHl;``h%&%7^jh0!_*KZi!g8jRyWb+X;EGqy9hR`8V;iI!q#80Yp+ zWr$P!jyuj-dcx`I(5H8A6#jV_v{nwmdV0!Ik==(XC_AAqYiTpQ622o9eJjb03wkoe zqBDUTd72@+_R3(ls#=WuO0+Jct+{^r^PA&s*8{aBw|Kvi3_{H!pN+wbQJrC!v-Ff* z;6o@+-mwU%qt3}lee2Z!^yMk96Ui*wpkR-lIuAeX{zAV`-F1Tc1QczIbo_9%KNo5J zLG4UUusOYsb!)O}xPRjGafJk#B}!?L$3Y7Pl#gM>++qoSOk7MX!gK5ljMB7DuGJ~B z<0ay_4Xq$p8{LH$p<%0yw^2%mP$?h<|L8PLOPMZ3)eR~cBnvD9WaGCd6QaU!OLyb1 zms#6-dbi?}TW8?u-^dQbQNWT`n>I>hihzp!9iJU=(?+Y1I-;6j1khKTieNI`vv|^h zPnzD-AJvIaAUM=>RKZNecSFW`tjDwM*3#FW&PHF0y>3RW>X22td2%6dJ4va{g3MKmYdYr}KP#%XG7{EOG;O&!mfRM$%aD!gJwY-L{t1<>0rw)?6#NI(Y1ovMll5pXkqK^#wwB(X8YPWKU}oG>7zV{tD+$z8iTHL%Wm zknvD9+w@$z(Yf>9wtI2Ux9tmJrR%hwB;5rqBwBh8d(EKlSXDPNs@-ZjLLQXvx|}c~ zEtUthkOJO5YmM1DXnHrO$Fih z0a(acjhiCCcyd;5i8Sq)&=yNk&A9q?>ZAg)g|rN>VZ0zCP&bWUsoV+@b) zd5?7i!r@QdNH9#6A2Aft-7f8hS8li$pI(e?zX!{+vH6*E+wvOph5YS{Z_vahgDXwE z$r}(Y#Q*Ll2F;EHyeL9wcE#pT%fGxT^4&kch zMJ{mEY-fg7hV#T7#$(38rb@88iKr#P>5ku9SZZV!MN5n(EU~iYhgnEb^G@ ztz3}btK5XYWM-0r52eAeJ=?_5C~N$M&Ywm$dc7ji`*NH79-rR~LA=Y~i1P_AhKQl!%3jE(OOd`Ny*>vUz^eOuI2L|%=slL2KkZ?_ zhXLN$@W&ew1zN$qKOB#&Ffys$1}OF_jN2krT(%>Zb#p3Yk!a(4LMgjJGZ*F=&-BW5 zZ)jDJ>&}`UW?9uRK6_#3FO!G&G|Ms|^$(x@%hV27Hjk@D(N5pmO^1ygJ_=WPoVoRz z$i&U$0zVrXpW9zQ%&&%i++j=Z(BAuTu#!S7|CMs|XS=D2w#a-C-nQDp@!U6=b@-~~ z1>funS*SpL{)vvPPGgbyq{vdmC3sUO@?V7L?=XE*HoEo%`_aGswoKlQyiYDKYLoA= z_Wd7OXBpSz|A%`_R78}JW(r6OC>?`g&;kJWqhZnl;-sZv zBP0eJIavJ8{Xehs>^$3E_a5!uz3(Tk>w2gD3sBiO^{2?dCv%|$QDRKn12+`Z8eIa1 zzH3tqRdio?z^AA*w%1P*WMDC1sn7Ix(ZZfIUxOV8ieyyWp$ zo*{4spy@@cZ-jq3-z&4Md3hl*@+pJ3zb50d-omS^kx#|WL{-RbX$n9nF7U}y#C9t2 zJEgz>2T%EXUnv6h=K%q7sq*qI@OQp#&4>?Ncr;v}98G89rf7$a;Tw=7HJm^VTUfy4 zN>v!d@K?yUAN^^~C%MnKB)0X=M>tzz*I0`R9lu#!QBbilV)dBrGZII&Y@BSvEpehC z*EzPl=i-hYFe3#Q(fT6p>CW(0`NhW*jgW`(#xv)-kk>U>t*I7cZ61*|VIiAbYv=^5 ztm2;L4FY!Ys{flXb;^_i4)b2)Ea}uPOtcSvDcO+aX@k43lakh&gpS>Hj&D=v3Y8V8 z&|bc0`OoXzqrwMEtqd|-w=OVx%g?JnJLsTn&|exQ0CLINr8D6>7w zSAd+R#(be{-uLr#Yr>uN)wwf^k)qAF1Alw{_U1IzW1roaY<)M#Y-@h=_$p@m^Y?fC zpNa5xuMJtgY^D!Oj&F;?Z7t~IC3JD6$z4RVdx{!>n~}xe#g%y^dFZtY)46oEyCetT zs1T3t8gj#M$h>>RE@hG@&HfWe$6A@{$*j}I6V+SN;?Vx3mr3u~%<7NB%}0e?dTc}; zI|9n<7&d9_FgilpqNb!5Ud$+|G%B2_(1DU63F=#q$mv9#qjaJ}x*I7Qcc(n2mZ zKqc(}f6v8v89GefVPbXAjuDB~{c+{{CqJEMOO~Z!ScjBnMDN7K`b9!J%liYVYpc>y zRLBy)hPTn~v*)dvS$Z}2zag*=r@HTNBBvg$W`vi_Sr+8d+gbh)o2nb{6{`%f7xAR( zqctp6RdlLVBad3!bG>&`vVdE>J0pNSdQ0x~$9r=c#pyR1N=wNZ621Ehi60Nh=9dVQ zriA9~tg8>HJ%xvB3s-5y#bh@eznL!iy}}V1xS{MG1pb4g5dWbsF~&Jg+Ns$dKW8?Y zm}hMZK3QrADoB_GZ46GKa}TM6Ai5T@&oL&2quNI>yIDyXM{q95ZS)d8*fVzO0UMKs z4A8O1!0wNiqL8~%9ih0r46iW*@6TLCng>i(AH@P=x4}- zND6&-U|=8Q8R4uNTf}5o`Y&6_R(c1=ls4F|vR(3KzGX5n|9NdEI}C(VH&|Y%If@+8 z6ZF0RV*IYNX`;EJ?t0OA0gQ3PF@!lR)|k!C+S+#BPO7$ueTvi6I{#bJ-)3&m&eD{k z=yAxGl%KFiLvYmlWXDU3dBL=QH8PuNP@$>nHcOJ%(Rb3b2 zsWIu`h<}IXZjqQw#@q@dgq6!On*Ewejxx+L|whq z=g@a!dKi=L4=qAyH>$!@y~>?vS}h_vU(c4bx7Cdja<|Nytek#xAXS|HF`7oj8oCW( zO@A&Ysea6V^wcuIO{pTR_34D(Xpomul9gkzec5s+okaPHnv&X<;Fsx~amfHuylr~C zgpp#&7qHo^uV1N9=2demljWTT0KYA2Yi#^@Q+c&sJw|kQD0FM;0E#dV;&G^Q365y6 zsM}4=d+FCxI*&bm#_r>^edbFr3+NI1hz;3v>}k5`QeR_;>*7xp9FRP^L7+*vFP{`+ zO{M{#Nk7X6CyA%0tGZ2N#<)hP1Fg|*9#jXVa$rqqc^DV_fPQ+xxl+-EX3=vIqxtp6zg_p%JbIn3zx! zd>nH=C}0*oI`yzifEm9R*Bk-G^W5Gm#qSG&_(vy^g1YZ=6? zhp4gLpsS9rjjqOPQ64AwI>}cgO*8n4r-ex{F{p53OJV9fv2VWqbC76tm#+EzAH#$8 z6n|;tKK7Pd;u8GX`q1=byU1b0VjbihNeJAzW)&0HEwk{zr)7G(4f~ABA5DMvq-tYAJx$#^e$o3shWEX> ztfubAXThs;l#IlCFW;#2k0P(vgW?L6NZNT7WTqdZVQ@8-U;8t$57vj@uw8ju`DH+q zu~3;yg&vIO0jp&!d#z*=5tt+`(%yy z0L6H-yp{(vwdAZBwdHF$S2>{`i6Dind(}Nb11eP=e8j0Z>h0nO%Zp6z4J}bg-wBQN zb#HZeSe{EBdUAoK1@!&in68?%XP#IL(lY0>b13Ti6B6zV**^2q$1;2)*wSF`IQht@ zX8@uy5IhFp-^ZVx6{z=fKcl=O)`^|}bS4fh^8m2z*0=vV^S|k&SbsYM$mag8<^_O# z(cccTVYm;#Fv3v;A&Nch3@rmJu^>(!!&B_l{2)$aP8!~;c>Ipm73!}jB75j9OHK-e zzKCSOxU-zoA+dC8fLgqm-gDpNa@8)J9$)H}O;c=IBI@3HBYR17jhz1eYnxnLtmuu) z`gz%ROZmfn@+|FrCfaJ9vhcEVLmJ^ysw69<>!w)8K*{01!xr0V=!=w|D3cC}Ev4Kn zRN3vXX}#W@#!W8HH_rAZtiQ2EsDJ$wF|~rCvU48sw~`rwwWiM7ws}a`3~kz5$t3x< z;NPFaO|xkMim6?N_zo?&L8qM~Uw6-y9R~u~A=S8~*w+nVo*!icMhGY?ZFPXUd9}fZ zUuAM?qBa8>>yzjk;bL_%NBV$~(Rf;@hb;`+mo=4(?WWn_)DpIog;@2<=Wn04d;Ip* zgBc~UTlY?{(5{iPsW)YgE|6rp5)!-?IsV;sn7YyJTWXh+3S=zbc*Wrt0qcCQ8-Mx> zf2Y@_xlp!@?d-SveOlVkE30WnGP(aTywEEnOs@BlA-DzuX_oG#Iy^=MW1%nSj&OzSt-KKSbxhrY26yMU9Z4HJI*VS3HyYlO zTE%G39_TE!x%8ysuSxW}CV1AR+bXdad@jtJmO@3^jgv&*Qtg+f>L%JuoC1NrEO!s$ zqSfY18&~e;%rj=*nciux051PzxtUgPv!e)KCOS3()L-LdL!8eG`@XZO&Z$LGPyFuS zY0`Ns**bAn|4}Sh#2gRE3BOjfr1?iFd>?5InbjI=6}^x>p6EH~Z5D(NR}mTa!KI;* z?IIJ4j{#wGpgH+IMH`NFU?Qud441qaAB+X5RKvW>&=aLK^rWEI3;Zv-*0YfQGXnRv zdswf0(AHp^IQ$zFWwfP}(k~#~*bwU$4Ll$p5qJu?o`UMt}} z^2f;fTH>__VRhX=JEhxO2ZX)QOBl)v;^OR;XZ-nMa$mk}?189NiwXa{#9ZrMZPs24nF zDPB0p&9H2W#;j>hTHmGZ;hs8zvd7sVru@YGv*xe!`OHgSB(Iy%@_b=J#nylfp^n5c z(Z1s4&rHw$bn>Aq>5pDh?C*QJeT-ZHk@!07PR-ULE85WZ36XF(nMl7%v5X5oKlXD^ z1AC>30e|eQ$9tRcyz{Zb;AVyVsn;ooPn;A*)159jf%yuvjaoK{Z5juwb5GQ^#R)hs ze>`inm^q_h0p3SObdeqL?mI0Lt%1%@C|O`nNX97U7`1>FU*>_K2~u+gKrg5 z&5^9Zz|aeN9xg<#!(q02fYt1>Jdsv_e1CPMeLk~FPR#nD9^1=bKY0{iT&cTf*{LvO zgx!Ir7-yyoD%-Ra3N&0RQ7`q7*7x_)?SswHq{;~GFC%nf+Z>m%?5E0C9;s|wFIaWZ*i}j+bW}z};`^qjc z#UGYWj`JJ#5B7E!ogxiJs<(?M*RtJHKi7te_2cxm4iyGVKs7ab zy9jR)MEC4mBUmF{hU(o+L(8(|*%`wChe-yA)o}I3u3{^m-x&>{P zjU@s;5|Ns<+77pvu%RP~5isKyJ$$>Ry{)=Z&o$wZgD6S6H=BC6xkoCx&Q3hBSBrmL znU__aV7Uk%kPNMAK!v`Tysy955~o%sUU+63g5^MmQxpKj=VH@tir)$Rrn0AOTSp;kz_JT3jm*H?d^a8bZ@jV&Ki1Waax6XhAkMGzZ6^`n1 z+o?5V(6>SX+DC9C3G$o?M1yt7w+{5g}3hi}v?lO7;>ctd|^uC#AJ%osmBrwVH^DliR%(7RT6wVy*nsBRQab z>M-29hzM@g$cg}M>~bv!AXt@+`MXC;w>PyEE}j}}57;`Fq#1Ytl0|8^c!QQjWb{F z9)0jfJN-O&HO%#?TrYgFZw_P}zxn)IlVL{jP0Cndqy0&!!7#E9sgtbO=hqkh(XT;4 ze*JQNHEpn-HZ3}vC=XpSokp;;a5Q)wG4x1(%3X5~St*5`#z$Q}u@h#Nco#i*+5St#0ldvt>*_oI?EoUSYg3yd=rY9mVohQ;eiiA*qz6BY&N&L z<>qx5YO-nznVQAltWJ0} z2u$T)sk)Ubkfkk`3qxP^EQb|l-BuZ_cif&#mI8Fh#}oVg&%BlXVR!6y6O=>wyU1;| z?TQs(a4A74!Kh%aW;U}uVl(9zvt&PyaMty|p7$R33-(#=q*Q!hjaS!Gpk<1gWw!yTZzL#@WiRwb>LACic1?Q3X*eP^NwGDs z7T9sQ=#C8WnVyliXug>hkBGNa-nZo=EJd7yI&UJrvi$J9;a~$(CPPDU!%jW9*{`wh zVBGj=*!u&1OV68G=X`mhJ>)rnET`mZ~#I+P8h4B2bv}^TtjVc*i;my+l#38S9?zwKgf@;2wC+iFPm4Sf)>Cn z^~E-$p@)k@hfx2$l=wE=sx7#D`{-fbdybl&9Pgs^ox9Hu4>s&WxBp|P?DWTl9Wcvv z@kFhz3<(ZIh0BGfKD>^c$NOCc2J^uQXSF3q*Vc-Iu$yg#NqicX+U%L1KR4{_Ev_A^ z8UnDy4gso(FEd%rYIKH|W}{nTul=)H)j92YwOkqp_a$C(FavE=k_BJT@jAqjBtsRx zG3S{Sbq9UefMg2?kd^+gI_Cp~2X4Kw%Xdy)a3qP&9sGjCXmE_Sxsc9wch6MaM5kHE z-g?0#Sj?)^e2yD`YS~8ry&ylpNcKwh%YmRcVLqH8qo41fQr!ijJ~H^GJV7hloI= z{vkBBLz(m+Lo~!g-Kh_LjkKa6NL0sT{VVOYV12y0)7AseRkSUB-@EtsT)UICNkve$ zA@vkCl#me&9_v$`{8mJL+BSh^R1o42wrZuV}qaxP*BU~)URYGsEeMb(e$#}iwHFc5wC-d@KU>DKvn0NTWmpf+BO=nBPJAv5#`Hp7%;(1&8 zpB7-V8S;lJr*P14bE@Iaf|_kNrP~J|dA-#>B)d~6cmFGFG(XeL$GaV|^fFRF#QDG< zc7J>CU!ZwOesgACoke>3zRhvR%9RlaWLv^AznV8LFZ1X|*bP+;5<0?)%&L zp1MZt^>dfjY0qD#=1)0Gh?`|f+Dt-VL`$|TfS7R4=dyXCFSkYo%)xf+A3O-=Lr!5w z@B|Noju6BP?FFZvrr<)sG`C!Jjqq!3_OdrM>@#fZD7{yAr{BDi{QdHvT^5gHk8u4w zwIEL_E4_7=Yr6cy0DWYgAyhri|Cvp_IuawPEwLAsU9sZt8kOrG5_Pvu(#PLhOKbs) zZf#gdLAT~D2orbT!4v=iFj=e3cbWEdb8^34&f2g%+}~plWiHvex&&y16nC0?dG;SH zCA_Yl*YoxAUn!UjY*{ioZ3XCm^PJwnb>T{I9F`W?Kz#V2Pk0n z_k8zN$3-$l<{j9H1YhtXUexU;k3y^xVsBPk(CJkSDTT(4rV6iG%*d94V1{ z+ZOnV*jO~n`MH;8r|iap%kzfPzYp;y)h5jqB5PoVlm}D}4A~M-gD!`@(;Bkh*gMDk zYZ7-q{PL=_;EZnP(LXJCAkclpTkU{@zgn$Fd}#Z;>f>6A;w`DI-l^|MDNUK_NONFX zZDWe=b~{mrxN(Sed5VA8L~#qx))`uFxefDL1BdAUOwS4kZ!av*Eb0eKLQ6G~9N%}n zMWl92mfz?C-{X}VIZvF#x0KDwLcSCF1pku)`xZ^6cGRmR~(G>c*%V z7z_7GbF3NC;>Vb2fpWQNKF4CK@O+wm!C2#C_CNKs?LL@ev%5e0Z?TykI#4|Gjv*tQk->|22M(Hn1l7)QApqrM~M4d%|jP^Y*uy z4!~&oCJNChOI4!?cm}{sNXGHDHl)&>k4FImzI)Tt54V#^edXCNoa|adxEP$*kFhNH z#2&wfE5U{FmrJ)Q9YQShj`Tty3KiYTS6M)=)-_l3rK{W5siWTwOGlK#HTJwuqn_~P9JI%5jvz{0P ziB(OBSGe@tS_AuXi0|fL&+EItj0ic5w>eU3=c4UYVjW|K#3azG&Z}G~Yx!&(U3b0j zSxxK@%O10`wT&*bRa-Py!zd-?Ck7DCcG}Q2$oQk^ujCPu5Y#qFWb)A!vi|(LZ}HQ8 z!k6OcHu%)rC*RdCGaeXsAwghf{NmdX#7%h!nRK2^hpy7=A1lP2?RrIH!gyx1#bNu- z5GVWbu}wn9ZqAVkiVbEdAPv*`Hvh^Aq6vVe>BEvz09vTMCBAkyF3O=Xx{0<Y%OEg-SryH*RmRS;2V8nSqX_ z;3UBfo|vX4bo`@B_YAk?B$*U95RU%~~W37M!x899r<)!E!d&#A3uYLac=HK~d y{b8d64j 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 literal 0 HcmV?d00001 diff --git a/docs/rp2/quickref.rst b/docs/rp2/quickref.rst new file mode 100644 index 0000000000..6bbe179541 --- /dev/null +++ b/docs/rp2/quickref.rst @@ -0,0 +1,288 @@ +.. _rp2_quickref: + +Quick reference for the RP2 +=========================== + +.. image:: img/rpipico.jpg + :alt: Raspberry Pi Pico + :width: 640px + +The Raspberry Pi Pico Development Board (image attribution: Raspberry Pi Foundation). + +Below is a quick reference for Raspberry Pi RP2xxx boards. If it is your first time +working with this board it may be useful to get an overview of the microcontroller: + +.. toctree:: + :maxdepth: 1 + + general.rst + tutorial/intro.rst + +Installing MicroPython +---------------------- + +See the corresponding section of tutorial: :ref:`rp2_intro`. It also includes +a troubleshooting subsection. + +General board control +--------------------- + +The MicroPython REPL is on the USB serial port. +Tab-completion is useful to find out what methods an object has. +Paste mode (ctrl-E) is useful to paste a large slab of Python code into +the REPL. + +The :mod:`machine` module:: + + import machine + + machine.freq() # get the current frequency of the CPU + machine.freq(240000000) # set the CPU frequency to 240 MHz + +The :mod:`rp2` module:: + + import rp2 + +Delay and timing +---------------- + +Use the :mod:`time ` module:: + + import time + + time.sleep(1) # sleep for 1 second + time.sleep_ms(500) # sleep for 500 milliseconds + time.sleep_us(10) # sleep for 10 microseconds + start = time.ticks_ms() # get millisecond counter + delta = time.ticks_diff(time.ticks_ms(), start) # compute time difference + +Timers +------ + +How do they work? + +.. _rp2_Pins_and_GPIO: + +Pins and GPIO +------------- + +Use the :ref:`machine.Pin ` class:: + + from machine import Pin + + p0 = Pin(0, Pin.OUT) # create output pin on GPIO0 + p0.on() # set pin to "on" (high) level + p0.off() # set pin to "off" (low) level + p0.value(1) # set pin to on/high + + p2 = Pin(2, Pin.IN) # create input pin on GPIO2 + print(p2.value()) # get value, 0 or 1 + + p4 = Pin(4, Pin.IN, Pin.PULL_UP) # enable internal pull-up resistor + p5 = Pin(5, Pin.OUT, value=1) # set pin high on creation + +UART (serial bus) +----------------- + +See :ref:`machine.UART `. :: + + from machine import UART + + uart1 = UART(1, baudrate=9600, tx=33, rx=32) + uart1.write('hello') # write 5 bytes + uart1.read(5) # read up to 5 bytes + + +PWM (pulse width modulation) +---------------------------- + +How does PWM work on the RPi RP2xxx? + +Use the ``machine.PWM`` class:: + + from machine import Pin, PWM + + pwm0 = PWM(Pin(0)) # create PWM object from a pin + pwm0.freq() # get current frequency + pwm0.freq(1000) # set frequency + pwm0.duty_u16() # get current duty cycle, range 0-65535 + pwm0.duty_u16(200) # set duty cycle, range 0-65535 + pwm0.deinit() # turn off PWM on the pin + +ADC (analog to digital conversion) +---------------------------------- + +How does the ADC module work? + +Use the :ref:`machine.ADC ` class:: + + from machine import ADC + + adc = ADC(Pin(32)) # create ADC object on ADC pin + adc.read_u16() # read value, 0-65535 across voltage range 0.0v - 3.3v + +Software SPI bus +---------------- + +Software SPI (using bit-banging) works on all pins, and is accessed via the +:ref:`machine.SoftSPI ` class:: + + from machine import Pin, SoftSPI + + # construct a SoftSPI bus on the given pins + # polarity is the idle state of SCK + # phase=0 means sample on the first edge of SCK, phase=1 means the second + spi = SoftSPI(baudrate=100000, polarity=1, phase=0, sck=Pin(0), mosi=Pin(2), miso=Pin(4)) + + spi.init(baudrate=200000) # set the baudrate + + spi.read(10) # read 10 bytes on MISO + spi.read(10, 0xff) # read 10 bytes while outputting 0xff on MOSI + + buf = bytearray(50) # create a buffer + spi.readinto(buf) # read into the given buffer (reads 50 bytes in this case) + spi.readinto(buf, 0xff) # read into the given buffer and output 0xff on MOSI + + spi.write(b'12345') # write 5 bytes on MOSI + + buf = bytearray(4) # create a buffer + spi.write_readinto(b'1234', buf) # write to MOSI and read from MISO into the buffer + spi.write_readinto(buf, buf) # write buf to MOSI and read MISO back into buf + +.. Warning:: + Currently *all* of ``sck``, ``mosi`` and ``miso`` *must* be specified when + initialising Software SPI. + +Hardware SPI bus +---------------- + +Hardware SPI is accessed via the :ref:`machine.SPI ` class and +has the same methods as software SPI above:: + + from machine import Pin, SPI + + spi = SPI(1, 10000000) + spi = SPI(1, 10000000, sck=Pin(14), mosi=Pin(13), miso=Pin(12)) + spi = SPI(2, baudrate=80000000, polarity=0, phase=0, bits=8, firstbit=0, sck=Pin(18), mosi=Pin(23), miso=Pin(19)) + +Software I2C bus +---------------- + +Software I2C (using bit-banging) works on all output-capable pins, and is +accessed via the :ref:`machine.SoftI2C ` class:: + + from machine import Pin, SoftI2C + + i2c = SoftI2C(scl=Pin(5), sda=Pin(4), freq=100000) + + i2c.scan() # scan for devices + + i2c.readfrom(0x3a, 4) # read 4 bytes from device with address 0x3a + i2c.writeto(0x3a, '12') # write '12' to device with address 0x3a + + buf = bytearray(10) # create a buffer with 10 bytes + i2c.writeto(0x3a, buf) # write the given buffer to the slave + +Hardware I2C bus +---------------- + +The driver is accessed via the :ref:`machine.I2C ` class and +has the same methods as software I2C above:: + + from machine import Pin, I2C + + i2c = I2C(0) + i2c = I2C(1, scl=Pin(5), sda=Pin(4), freq=400000) + +Real time clock (RTC) +--------------------- + +See :ref:`machine.RTC ` :: + + from machine import RTC + + rtc = RTC() + rtc.datetime((2017, 8, 23, 1, 12, 48, 0, 0)) # set a specific date and time + rtc.datetime() # get date and time + +WDT (Watchdog timer) +-------------------- + +Is there a watchdog timer? + +See :ref:`machine.WDT `. :: + + from machine import WDT + + # enable the WDT with a timeout of 5s (1s is the minimum) + wdt = WDT(timeout=5000) + wdt.feed() + +Deep-sleep mode +--------------- + +Is there deep-sleep support for the rp2? + +The following code can be used to sleep, wake and check the reset cause:: + + import machine + + # check if the device woke from a deep sleep + if machine.reset_cause() == machine.DEEPSLEEP_RESET: + print('woke from a deep sleep') + + # put the device to sleep for 10 seconds + machine.deepsleep(10000) + +OneWire driver +-------------- + +The OneWire driver is implemented in software and works on all pins:: + + from machine import Pin + import onewire + + ow = onewire.OneWire(Pin(12)) # create a OneWire bus on GPIO12 + ow.scan() # return a list of devices on the bus + ow.reset() # reset the bus + ow.readbyte() # read a byte + ow.writebyte(0x12) # write a byte on the bus + ow.write('123') # write bytes on the bus + ow.select_rom(b'12345678') # select a specific device by its ROM code + +There is a specific driver for DS18S20 and DS18B20 devices:: + + import time, ds18x20 + ds = ds18x20.DS18X20(ow) + roms = ds.scan() + ds.convert_temp() + time.sleep_ms(750) + for rom in roms: + print(ds.read_temp(rom)) + +Be sure to put a 4.7k pull-up resistor on the data line. Note that +the ``convert_temp()`` method must be called each time you want to +sample the temperature. + +NeoPixel and APA106 driver +-------------------------- + +Use the ``neopixel`` and ``apa106`` modules:: + + from machine import Pin + from neopixel import NeoPixel + + pin = Pin(0, Pin.OUT) # set GPIO0 to output to drive NeoPixels + np = NeoPixel(pin, 8) # create NeoPixel driver on GPIO0 for 8 pixels + np[0] = (255, 255, 255) # set the first pixel to white + np.write() # write data to all pixels + r, g, b = np[0] # get first pixel colour + + +The APA106 driver extends NeoPixel, but internally uses a different colour order:: + + from apa106 import APA106 + ap = APA106(pin, 8) + r, g, b = ap[0] + +APA102 (DotStar) uses a different driver as it has an additional clock pin. diff --git a/docs/rp2/tutorial/intro.rst b/docs/rp2/tutorial/intro.rst new file mode 100644 index 0000000000..5609ab3798 --- /dev/null +++ b/docs/rp2/tutorial/intro.rst @@ -0,0 +1,6 @@ +.. _rp2_intro: + +Getting started with MicroPython on the RP2xxx +============================================== + +Let's get started! diff --git a/docs/templates/topindex.html b/docs/templates/topindex.html index ff766b0cf2..42233942bc 100644 --- a/docs/templates/topindex.html +++ b/docs/templates/topindex.html @@ -58,6 +58,10 @@ Quick reference for the ESP32
pinout for ESP32-based boards, snippets of useful code, and a tutorial

+