From cd5f8bcf74c36379c0883fc93dec4267f1951cd7 Mon Sep 17 00:00:00 2001 From: Krzysztof Budzynski Date: Wed, 10 Oct 2018 08:15:23 +0800 Subject: [PATCH] MCPWM API doc update --- components/driver/include/driver/mcpwm.h | 45 ++-- docs/_static/mcpwm-bldc-control.png | Bin 0 -> 46855 bytes docs/_static/mcpwm-block-diagram.png | Bin 0 -> 56162 bytes docs/_static/mcpwm-brushed-dc-control.png | Bin 0 -> 20746 bytes docs/_static/mcpwm-overview.png | Bin 0 -> 18209 bytes docs/en/api-reference/peripherals/mcpwm.rst | 199 ++++++++++++++---- .../mcpwm/mcpwm_brushed_dc_control/README.md | 4 +- 7 files changed, 184 insertions(+), 64 deletions(-) create mode 100644 docs/_static/mcpwm-bldc-control.png create mode 100644 docs/_static/mcpwm-block-diagram.png create mode 100644 docs/_static/mcpwm-brushed-dc-control.png create mode 100644 docs/_static/mcpwm-overview.png diff --git a/components/driver/include/driver/mcpwm.h b/components/driver/include/driver/mcpwm.h index d1c10e8672..301ca41926 100644 --- a/components/driver/include/driver/mcpwm.h +++ b/components/driver/include/driver/mcpwm.h @@ -27,11 +27,12 @@ extern "C" { #endif /** - * @brief IO signals for MCPWM - * 6 MCPWM output pins that generate PWM signals - * 3 MCPWM fault input pins to detect faults like overcurrent, overvoltage, etc - * 3 MCPWM sync input pins to synchronize MCPWM outputs signals - * 3 MCPWM capture input pin to capture hall sell signal to measure time + * @brief IO signals for the MCPWM + * + * - 6 MCPWM output pins that generate PWM signals + * - 3 MCPWM fault input pins to detect faults like overcurrent, overvoltage, etc. + * - 3 MCPWM sync input pins to synchronize MCPWM outputs signals + * - 3 MCPWM capture input pins to gather feedback from controlled motors, using e.g. hall sensors */ typedef enum { MCPWM0A = 0, /*!+)|~*LQxqSyti7Ns;Vv+oX(m!Y1+jL_PmR2 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 literal 0 HcmV?d00001 diff --git a/docs/_static/mcpwm-block-diagram.png b/docs/_static/mcpwm-block-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..97620c29da0b34496de769660834f53ae44ccd18 GIT binary patch literal 56162 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

-hQtx`}Uo7$s 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�qKx^aNb` zK7X!~Zl|+jS#V80o77F!g=c)HNH149_ zUDYR6&ycj8bzLpe31!x;D7C5kZRhuv4AY-eJvJ_U_iRxnYbSU0_V7iZxwtxM4p;GM z(X0a3R8{Ju4)0Ic?U??rDmLWU|GSYo3Hkoq+MtB$>bXr>Z>~(k(SH>?jvq6<{m$`H z*FWE?H|4jy){4%z71pch6JFQR@+NUh!Bv;Phrb?HG21fj=+?jUZ9grt4RyNx{^j2b zFJ}qcFH6spzinfGD&wNIedSD}SI;K(UUO5u>6r2TlH9*D)u(UH-}mdtfq>Nt7Dd|^ zuQPh~`m%T3JG-0DJo(?G7;fy5UuEHdHU$@4bmv_3lZeQzrQUVVW~qep-u~cOzL)J{ zXPU9xu}{%=mvqK25|@ZI@!dJ`_oVyxJ~@d#Y+-^nHUfga=H)KRJJNKAafhIdnD2>* zwU4boe7k@0)s<);|H;a%tUnzmZ`sp)zr{~%-ji*Q+Svc;Wkl!9lu6rL(7JJd%;^H# zoRr(8Mi&$Beb?HPDV-oHsaLh|yohNUcf|{%in4?W-*s+F&U#VSj663tN6fugt$X?z zG1J@El0|jSi$(|avF}(uZO8V^tioTDS)WdLxBJM)ij1ehf-kqfC}Q+_$aGVn^sDEw z$%{T$vwY4?a(KJCPR#MVBVkoI5;m-aNmPseK0mmTug>JTvxxR4i+LkF8DG!Tt}2 zJd8Du)ciQ@ec5iFh5fIm7bPc2@cdiX{!8oT4xP7uoz3k6=ZO7!a;N50$+7phwbgWX zehmG7VEO57@sgFFuWtM1x=MH7*34;#v%gO-593WSiDdp}azRt8zW!^6{N8dusrRxC zN4J#Q`+I+zd-MLA!p9E0Tki>NUCNqo=Pg+=f5-otwEDbd9~0V5_-|%URGUyI9{qx2 zN&JFjof!*vGQ2(6UnU|h-fr%=HZU-7VOHL|H!s7&9T)wc|L<3p^^^?!H{`RhLKo zUd@uWTlbID%~~uvbIl4+r8&*;@3Kv2H(zmdVL!ul>W55ASI&aun2KHAPHWnG#g2be zs%YtZtXM9+H#JPyGV{(>GnNwFY5MW!JZ&~L_5T+W3qLcUtE#eIym0E&DGQmrcXxLB&$CHXZC$up;aFO~|BENF=6A&Ib4|WEA$NiH zrog&C?{4dH3w;+hyR-FW>q_PM3g+)KTy|Z1G}+CN%Wn3D-*VB{cW!;gll1g#`_!OW zFA`QhkgB+s{fW!%9zQ7KI_*opzjoPlR$H!y`jBhWJiWgp-S4|@v-`o(eS!^k6DLm0 zD4#fE#*X~^`}mG1d;9vzn&r%BZf@SYcW+x8TP(B7-}wD?b9+UOt!rBJD!VMYKO*^$ zP(BkS(?nMJuCnH9n_d}v;=`^LI>z6X+ds?OFa{>)Jf665(r2WufBiSEx)-C)Vkox)99_K2NzRJd%h@U=Exr>%$C6T08>_+Bx;Sjbsj9TmY?E%ic2eE!eXT0PGK z{J9tY%{98ydOlKWx5?D4@!hNMeX5_C{OncmGqzXRGU^+1Z@R~&ozMFG!@9CYBD6Zf zfA2Q`)W$8(wf3{}CxSb6Rn{B#{}Xu>RJ`4FiCE0-8xtokWQOGa-wHWZ;to^4G`;vP zy7SNV%Y}}9ljba4Fl~y!;{r)(2ma=bt9FMMOZ}Q-4{f^hm!*qLf7#yP`Afd>zo4In zh}i$`Kdk}kv8S%LZPO+r(5cdwf>KkTZqL83#4aTz#naDj{?T9fP{E$m z)6*In7(la+kCSB%Ki6q*V6gm|@%Qwl>clYrpLg;vyxi}$QnL{qwVW#n|%R!fCt6ySJO!wKp@_2=PAmT=2td9nxf1frpT_X?*3xMjOzlc z1pfAlJnxM(F6XhFbmiA-w$S~jul)A8lTsw8>1Go#Gq`5=@|Kt#XN#B2m{$Mnk#Rkb z*yikKXBl@0zCR`RcK2?9mGM~ui|kJbSw<8&^8U`#*1oyU zeqZ{S$HZIzew}u{9@nP$_WSv2jr*JROFxuMZ?dY`Zg1$^_~1qHC5 z{}2?w?q9CCCG?C2qt6RH)~|~%#&Nwm@$+QN;)#0A>{Izj<1&Jx8_{h!u2u-}!4s9)sQ*Z59Y(Q4{elT(YCMP+;c zo#_6k9&~7li%#bMmkoL>FESYz7#IZN9Q>IX7#JEpFjYx`1X{!|Tz2w3{MdIfPcwJN zsnhv;?eo0u6}S4wn_l_i!CAH>KkS{Htl^pWe_HNFH|wYE`4yzQ${^(YrQ-ARM1@5+ zoK-iQ(3;??`ZTn3t$BOv4uNkyhCBz?oUakJaP0Y_n|19#s^$^R_J4lgWi&2L*qeD} z3G<@t!)bBR#SNkTAP2}d-d^|Na&RzrdEVOpMK0b+@vQ6Zb!8wNgC7 z?)8(;hgd|5RF3ZwKggFIHsyb1N_4P+=f;P#jpJE;9R3~u@jKhiXTHI{501as9&Zp$ zS9y$6ixqV z{QdB-+2if<+k)m^9(&gu=YMa0{&?x~%#xHxah+!#uXnGuv2==9Aum{XyZYJ98}+|; z{?vKZeD~NMcTn)(ZQ_~%B6~n-lhSr<1A60ozc-?bt{pH?U zLfbYN{lEWG@w8ii_JLNk`@RIxBTuxH_G7ycr^V6d+qc$Fd7I7uAIz&4EI<1ZM=H|RQGy44bJEtBUDf5V)w_ai1a?N8QLdh2I1sNC^ z9w;wZ4vHd&3PxLAP(nGx{UY;V@rw%!e}8|^T_wW6z>uqVqjq8x>~!Dfq{Xuz$3Dlfr0M`2s2LA z=96Y%2-xH4;uumf=j~l~n<@D+3?H8FeVXI7aG}YRf4Xl?rm(FP(9HCh+?JuCyCv9b z^0Km!DQ%OcO*8Yo6cA+6JL&MO8CRuO) zGUkjHgsD`j~PnY}M-t3!VfW-?C{F7eD{=@=Y>X{Fa~o2K_7++ok3dT9JC^ zi)KfJaMPg=WR~AUdj0VX>s%7Ud?dt zlPN4H5GdJfX`gW=DpX6;Nuo_~eev^iy4l;82AMWr_{|dEQgd2i`S}L zbMg1rx7?Ysrt9~0p2aI3-I*Vq&ig9K=Gn!!i|1RnanEN{bar+=@_&|S=(+vbO-J?` z%`n@jcEtMJ-?RVsY)%SZ-G7#+G+?`J&@~RHu(lu88w3}Lv)xaf{_CQ-eehL{`}+&c zRiA{f&}f;Pc1H7gQrOv_$({?H?z0MSakIGy8rD@SH=?0dE1%`cJ1rwn{LO%?A+ z``VS)7dhJNEn+*KmeOs;oFwaU&rDfd{Q2K5jmakFnzypvEi``-_Nmg;bZb33=f3bG z*L4gGHq5c~xOhq++i6c)YHDZ|pHQ@@?s{URj^^hnH%=v3`CU&_ zG+Ax9(bemk&C(ayVWk_4R16Ib72_5!UVL)aLY45gBUc3)*3aCs=;T>T-=8bRB7|Qu zXFIhmS)x)~Tf6C*+D21PU*EGQP85`u-rZAatZ6*u#;g~gBqb#$nmX_76BhC}J#{|v z^r!Sv177)c&6<<8=y=xcKK3d><(zNSBb7hmn}SwelF{0#_J+OVbG1*mERcS- zCz1Wos|lvX8`qs&dH+r*+m^5IKfZ5o&+N5(x#!~sjbOo-TQ&4o25gA`^Vv5sG11J- z?5Ml&>sc8e{LMK1<`lcy$wY3EGU;NnR`d!gc*zU$_lJB#Lhe|J~gFls03 zA?amr4Nv@@H2?7b+C!bC5B@1wX=sJriGQxON2o@v@A*()TuX_864Z|B`g~J@!)poxlG&4Na2IuX8X*m7ZC_y)!aPk!>kEgr92*G zJ1Ip>*6Qx)h}d1GtMoo)?vZOpn);7O9@_5x>%{p=w@M}Z`}&nkTa|hjge?g?yLM_& zzRW}+(=B0P>*HeIOfy*-?3{h{^5x)5t{VQlYehBLw<`5!Wvn%rc_vBjBRPHdttWSOUamRuvodC>TiW)1{*^zT>V<`cE%%>4&pdzLdj0>O zTHhob_h#M}d39dU?)s~V96hA^V5NEw;r40@A|GcZ<@i81#bVFLMJ~G_c$}xI{ZT5!sO3aG=IyAEgp{ zCu~)7VzaKu-LU6w(*?16`ZJ{ew>@7quPbERcK(g(_m(d764<|S+M>MR;LCgV*f@TF zb#=9?%`%1k`xAaV=lOO#e|Gx2JB8&>8Ozt)-o<)0BBQdhR;^o?_w#W_-3<4-Y}U)y7G!6i+4(ejhv1ffrH-%F{HJeKkBb)mzha5* zT9>H-S(fws?)m4$vF+tA&iZow>dK?DZ8W`~X1iX{=#%5EK76cL_QTIs4P zBrEnyDZAyT)3@JOx4Omu**N>#tcyn-Dp{tB#x5)?S(UL|^769}?Nz0(pB0{tRXXP? z!FioaaQ9Llwa@3%_3SLN&6l2Y%xjD8G~Bv%YwNkSpSB*7*%e=XXx^4N5|5-;WL8g~ zJ6*WSw)4gOdGppST)4?EpPl*ku6^cn7fm_;blJaz*l+SHEY@3A#`_6g$SC=DEa2Qx zo1=|9_f~fceY=`8|9bgz%k4#T%585NE|rbEKWYD}B^xr;^3E-(KQ8igiQm&~*Mhr- zkG2O+{a<2vG4Xcv{tVT-`A@iJg%&;CpC!=wH_315^ia+ww?#!i8;vHEXPN{Wvih1U zKJoa&Kj)5FfzioE?%Z?N>eS?LvQXzmzJqJ~TG0um z2W#zJ7W9OWddImMmTBxl3f}iiM#``T6>Dzcyy&Ol4tbU%Y?bI~~`oq^U7G zi;iBoBJ#I-`n-}AouNuA`uA3U_nTqhcqvuW)pw0hV}10wX+oyky_SfDbY5AxGgRrY zeT<`{;}ZL)n_EuVCZ9Td*!fGf^}nMJ3;1LNKHaDmlCM*>dKl^?vN~#Y%Z*Pf@3b^F zHcrjhLqRLq197U*p*YOr$}x(ns)Teip|?f#arrbi_Te_vHnc{VFhE6 zmAAu^);0Z}8yZs4yX9=&y)D-l8+4!E$8}A~_KV+%Ij{Rx|MFSop%b{s?$hI}+k9?k zzf9a1H~Z(l@@<6{@xkT2c@JtPYS%mpvaqren*D6ms#UD>CEw0E-|M+eZS9^(p=U!E z<>*($UvAy@?Bnhv=2rq=9ruK;J2?4Kb%Au;Ud6cfy>-zig}me?X$`V<L7r-#&f%^p4^c|GuoVFiG1Nc>LhA9=qA?*`_uh-#QnVZAxAi968ZqDf_Y; z8@jv|E>&x+_IosKSz7Sq`P(-9t-IUXQ{)}A)txgqa{AQC_s+b!(0u2l#jB}uR#G$N z7X(%I-#8+YCA{9fPv++S`uf&qm4APgKAP&coZIf#{(Y0{>&|RFKRxi_;z-r(6B880 z#KiRU^g8~BJnow3x9;1QbEh7r{oT)o;_fwz+tj?G7_L`CMq{!i5Vb21a?`XL6}kQB{5U`Zf35{ySluZGmMq zPjYfx63_1Vm}R#tDdF&`9sPmQg7=e5)s+9G$1$_Hg}<12e3#>?M;-R%mR}VWylNFJ z*9o+YB(k-FdOwZ&&?RduRUk%Z5H*lY9HlWq5q;s^7goH9VPl`QuKn|Uh*}jXd zY@hXh){k2ch^+lM$Npt(2FTJ$i%e#3*{FVNM)-}%oc<(zx(23*`3y2-0-mSLoI z{cf{G2@<@=Z|?n&L`H}`H%m2h=mUHDtm>wK8qdG)qJZh0R6n)KrJ=Q1j9&HFxA zl)K0B$+?e?f2Y;{FRj;%e9J!l=(TV6AK&CTs`vTRyS0bQI#+uMtbc31^Ax&)H_#!b3U!SJ*$E`WLWawf%%WkM$Q_Vc*EC zzr`+K>1vk?8@{sS<}jVxed2M@9c#z>>ZeVDJO0=+#=Q~cG^=}Z{aCN`-Me>BOEU7U z=#UPSPnA6(WmWQGrg6HXu(u8bWN$=3b7QyZxd0 zuaI|%*{oJ>Cy)QPI(jGV-`nNcy{q??EVAo5H{B%TfCgVZ zG>7?lQ6}%)bi=ay>+H9m%#qJpTjp|pvGNw@I78>8``ISacTV2i{`y~BhHm?vNlTV2 z3CVM+TrKq3uFJ9Y?h)~8OXc#*S-fvL=KA&S+}GAIsrkKJf9UcZZFN6SJ+$RJmb}+H zJ<8~`%aZuYz$*_|pOSg9)=MVJN_c;i3;V~_tzx1%VNb;K;y=tt5c&rIbeUOcu3CEn>$2eWpwgGmDm?}{hKE1 zbIMgJlrc1D(gP*lLr+gnXI=i?Rpo}VUfsojr|&$Pw0_S1G@p6#-(O!pfB!CCFSx*K ziC^#PNmuo6%xl}9TN>+hnU7oVjsGL1zgadjgAz^GdDW$E7Cfe6R_!Yt8CUtx;Y;9z zO|K)eW2UZobLMs+|KD%VAD;P|vd(MO?`7Y;w(AD(d^=Og^)2sISEZe@R}W}RtV69P zgN0WgInq*o*UQbVt*yuK084bmoqu{_C#K4oy04kZra+{=NAG^%)ejyzq0}*X7RRF{ixm7A1o$2;QPcYA zAf~``gp=XWL}B$N=FdyccqzHmY!T|ba^=dZ8%FV=Q|>RBuW{$j9hIw}=DRr9t<=o9 zTGg6%*I~{P!NjkTlh^pCyD9#;?%&s?Rm1ASP`^Z~Evw)RpX~J;r(PfXu#oZO^|V)> zyL^lo9xYk+Ky|WH8FSQ!`=RU4hD;5qOyNGl$!}s6Ea#W>b{+eE`v|?4MIJ&&I0YW< zFZADUKjVFY(&G~ay^H3RzrXkO( zXMH%A5v%lcR`%-&3p*K^rM7-~@#pP}7u)6ARxVum-}FVbzUrFP=ZoL#nMuliwX0zH z-Pyn2|HqvR?n&A!r%ny+7SpY%t!0((PTz3z?CiXb=$k8+{{PKiUgY0UW!^_o#cnThLp1((=lp4=>-w?k@ZK>C>cygMa?~QSj3`a5x~7 z@z@8OzngwH?7EfgxANbcih36ZwI= zZ4a@pkjPKCv|;LDzNPbJoX@CeX}x-RdHL0-bLr>j&9$qoy1T2?W&7gAkM}G8*uPKM zCaC_z3b{Rken(udy^CM_RPf>(Y1aPu(5-e?oHn^m)R62KPW^3jZNB^0TDz39_0Ma$ zP5;#?2^&uOJI&7J_%!qH9pTs3pLw)d(jei$kxt>&TbHPwGizyU6D!TH_}W$>>-LA= zQ|ndblig1yb809(E@WzmaG1l8Iep^9kNM~4%$ZaFJN$lWwt%|LQTZ6%_1;rrXU&?m z^jrL<6wgk(d-v{LEh%w4_SmIhkN5mdyS#JHuXy`0HKd$id>bfDO z^|&zT#OHhEk4#tAW^bLa!<>mBdV&sz2w-tiJv7aNcY7d9wT$-n8J|^Jkv^*w0}e zw}W$I$3(-URa?JBFYNU{66xpeeq6}$6Z_)3b=uS7HqQ{hcH-IrB@;uYCYF!pyCitr zoSd5W?W_BleCy`TqeqT}1RJK<_)U3xx9jiMZR)m<_m?X*v53mO_o}-!yJBm&!?*YE zgk|6JMF_9|vr;7QuR#2SmiG4PrZ3Ka)H~u+_jg)_a+6EU(@Al!UcH(*bLJ5}_q@Dy z8jr>AzJCAk;loFdluXuXxg2}Egzb=hvWRSpq2(PJE+_Llv%cJ$a^=Qbw@b(7sUAPG zzk8+Lp~y|;H8;eb$-91S{zXI`m#x%gL!PrRu0ht|(mX83(M zxPRVpL9^|<*)HZDI-)m!*Q?9h5}qW7Zwg^Qe@x)jvsXP~enNk|-g6c@UNL&6XIWKM zwS=X!Vd27uudc4PwY6Psr`;hO*__F}j@SEy{vIctiD&JNE(jl2=d5!1^X$|8w}t-< zFLATV3x<_5^?lB}J>}Nx#iws}JI`!i(U$%}e`8G9q6O^FuUhe5zY%|Z)5keR%axj1 zrtlhc2rK9wI&|n%zO2muwG$+-#pb@)x5oIf;Hkijoqd0+*_Ulx|L3MqbbP43^pVb< zo0-SvR2hmV&PdxkZFB8+{jwK-zJHM63GO;`l-=uYU3Mo||cbz_Bwf?8<)1FVs2FolTr9FT6=1=tJsnx&uK3i?5 zE2;jk*}ToA{_k1OuthK4)ch}>mivyqUxD)?F+CJ(utHm|J^SdYS zN>13DdA^`b$L(Tj(hJks(es<0nJ$0(t0~*BL+`1^1et_e4=neb*0B7z+F;FV^LPHb zU0uG?$8KJaEw1M_GbjkzC~ON4InGd}frJFRK20RU}UP)sOT?sa}h%f`14Hn)u%8=ebyP zU|H+uHwU8a!QOT-?C6$fPgBcW&{i zz@0m}{C?&;`&&Kwe>cPJ^s`qNGTPGj73_Q+b>h96sy5GIgJo`qZ%X$){Bi2gjUTf& zRld0t#&yeY`Q`$pp16%WKetQ&&gXq;mQ}cAzwgV*9*qYMI0)U|G0P~GD{`~Y_vx8l zD&7<1yZClKu$cY*T9sVidEqaS<(jE??>`m^d?DUY%*=AP%lTVj@i$Q(4I8c}(FGr# z`?t^0{KYJ`IN}Ze*X6tSo)`Xee(ug2w}cI|z302^;+S_~(!6C7pE8pMW*RJ|6(|z>PwQJ|joKZ3K5IDj)A?n(-YfXGf%E6wVFQ1*AoqAVb z{`BeT2?-zm{jEM&`gQ8Q2TNrH)PvrBUz(XET=-4f+UHW1r8VL*%63%} z7v#?R?Ryf_|Ki7s*|Mpp@BCnvUmLfMzOEAU+?(v zb@Rv2JDj^yS~ta(O@f!Q+iD*_?m%$zA@m*h~Fh z-htMPu=wzm*7kK=z?T6mDj_hV@Sw-f$u-;JA-E)2xo%de$b=WHGVc+}vNzBtQOh<7T4V?$4jRz9~RsC;s?^F@Xa7HCmm!O1rAPPV8#f|0rK#3&a&kV3UvcAKlF#Fn*Wdf7TFpChOs{X2 zyUzEIkI!$PzOCEWrJP$Tz^Ai!ZG`lal`B_X4G4Pa>Nn@am&1<(AGY3kq;jzRxbUUR zmsjsNrKqTwBI>4gpiG?MkRv2?P#9M@Hg4S5w7gPuXW`?v1fp3sGBwk&R^oK zco@=fW?^`U$;b%0ooC5#iTM*Jih1DhCriY$w>eSb&YbW-0d>>v1z(RVyZ2dGSa|Hx z*~Ic_N!re`w^AQ><=iytn9S8^vC{F)+qa7sFYbK1ZpRJ_rHwy+{P5W2V#NGt3ERcX zmxW6VX8JfLF)B4#tkk@<+&kz^_iQr-}uQ(j)~xV@{Z zYk{)4d3cfPBtwwb`}+Lc+}ak*zF{v|($dm0W5$dVzc$Z0%KT`Fn}@fz_N#Z-*T)Bz zCnPLT=~Av%@XKOJI=**BbZqS26}K;32oO3t(N;j+)X&eaZ%MZTNM0sse%vM33AO_2 z3>@r*ObrD{3{$_0obC!%@V-;gqm(~CJ}x=q9^~WWGiT16BRgF<{~gV`x+?VRQvaDo zM{nGi(evm8ThXHK63iBcYJ*O9B-BB{r&t$I44-&JlJ#V zv1Z4!vNu1ay!UF>^7`BTd{^_};-`bWsZUG_^p>4_JTvpfChr{g$rEFh@9no~ zsB^!Tz2kFo)7qT3q@0nahEUjEp~~GcHXwUa4C5o_Bw= z{-xFV56U-+uFaXUO#KbFRd9B}1cjOXlmFa4V%D&%@#k^%<#GGn?(47pA|Y@i^;7Gf zJv%oG1a0P$*#7&mbxv%yNDG$~_tDPp!jIj3c2DTPv1a{`c~*b!ou6kb9If^L(^K!D zprDgSnielD&;S0RR`Dedlb8DALMQXI)Vl&DQfHzr?(2@elYHjizUTb=cXP~jnGw`| zRyX~=_q|G^6;H4H-d& zZ*On!F3-Psm)&K>6dC5r-_DzCclf+&tHc6O_&ISmx418izw>zck>96|7ydc_?XZB< zHG3g~v`k8g|9#z1Q;ZH(W&C+!kE4`SYn8>zn3r z9iH>Lb9IUX%O+WMh7NYnpa8UdoRFonPsp~oxY+ydeeKFEb8Q6F9ae44yZh_xZ1ex$ z{(t9mul@C9XVup%Q&HweEDR4*to^jg@16=Ny%!?5E;s78{Z--Xx$8G>+_*GmOOw~m zyr-Xctv`K9=FFlsTc_X4Vk&>?#eTC-xUnm4yV4A;=jPkDN$hVusvo7Pn$Q)y-6_-R z^lr_n&kl~fe&?pU#m2_Ex;}k=etu+RWK#5sp5vZN*F_7yFgo=sK&X6`oqkx}-Ce0k zNlI;>xYm72GLR4y6s+G`{QY~Wc79*a{!F=t9ECwAZrz&oqkHF$9X%3;i&oU`y>jKs zh7AVw_5b(m+4JPdlPukap5vaW>!K?yI_>Rx-Tuxvs9LwL^PQY+RZDw&c($h@kMbd9 z4UH2A8?RS5TV7vVU@yDpO78h9YFDy!``2V#T{U&(%9rQnTK|__vU;`kT>g*d*}F?# z9!lESWxsK%%O+X%sk`%B4W{aCj8!|f=#fR-uZBzOqGxLDEAm|5)6?_q?d|>5-~Fac z?DW0)=g%Ky_r93jWoxf2SfzBcPgr4nQc}{RM~_^1CMmhB+qQ9I=A9jduIeIOk61ip zla#w|=&62l(=ycEc-NJM^W{ROLZ#%gS%%Bw&b-}i`t#J6Hjbwk4OsaWJ$sn*%Rc#B zzT@@%v($giR?_af(S3VQWpU`U2@@t5q@EHHGC!c;m(m|}-|@PQ+QOF;-~5jASTFCj zPwj>Li@e8z1!24IF32`N?EG8%huWsV+AcG0`B`48I_Zv@=-|wxb z{+#}_Pki6*m)>_drC3>8@7%egb*|-vmYSN{5jnod@J$YLPROn6l70LAh`z-w!=vZ( z-rjr=c)ep@b$f=-?rTklPwn2k!<#uxS5Li~&+Y!FiPk;;CN8>NeDUp<8KADJva53L z6s~FYh5t6m?_3+QRL>*t{=UCIKc@$!nO1$t2y*gcc;q4$Xd4x{ytT&q^NhJ^i^a~o z-}=kxSv_~T!0m{;d;eTKC3l|t+_FV~s{dImsw};(uq$>}fO-BM%T=0AS&MJ2^p2e% zprfPXQFG?iT( z!C$%pk5ZJE^j+xok4fA8%%$FEVU(XyNNhxeL}#(Fk&%(Had%J8nqO-a{8EJWo-X>5 z`S!tr+Z>`>R@8p`Y3C;Vds?jd-ktKv4@zQ~1E(68tX{kD*X0W9y_vJPN_$^Dw@os% zm)XAGHfW9i4dGY^2M5dJJJyJ7yu6dg%zXQcKiRL|Iet}(x0un`AE;kEZ{^CBOQ!HX zayjPHnd1Afd;_;%%(bJ1X76L`WyIyfYtH!O9h~Xg{=M?(?|zGU#*2QPj^tb&zFzNt z#D>YN#g0DrcD-X=yY8k>{}!RL&U=4;J~3I&QpmK#H7+jhr*cI8eUmk(uassw?%{va zUM?xNxJdcb{FDz54lao~!vs>+Ev9=)p7FBW`md#j(rrAXou{Ys7F+!2u?}1O$FpPZ zj~_oOoShGAP2+vU;=vur=QFn?KWp#5&@+3UDKpzI%?X~Za46^U<;$yMOge;bHq{@~ zusUMhy6#Hpg&DyMtzZ3%Z9M))#Qm^$anAj-3|sHTgqeKQ{Qin(*~@Lm^2{fheN$=6Es))pbY8MA>T%`2N^~oC3+79ynDVuq3F5-*WSxpZSJ)6`SqL&b%a^Q(>* z<{r7d@$%wCd5fj-XBFAY_WieF`M;~|4@0iiQ%An-$q&D`-pF77!p_Q&(=}^dcIBTR z8$V23p?g*&PIumuZFV-nQ!1xbN@ucm+Rsnmsx-GN3asUdvQZ6)UHhQIHCyc~>(vLB z&Zc+C>wVjpSO4YW+enxA)`RiE-=3!Kdwpfm=1bC{r98Pjp5~H^cfND6;&osOPfb?o9ffpurtV|W+lY+OHU#)@m#E`?tEw0~C7t4*Be9e(EQSyxHj9~UxsXJ5XvSxNNwi;Ihmq||pTH%u-Hh&tk;`~UinEn-tH zyX-%+_e73cu3GWl@zcZiz5ipv0+{#$o{apWa|BG_Azds**niOwZxH-eIyZTSV zEzynf^#^Y5X?8vS<8SF4zF@VixRb7J?CKA_Bd|4;)?xb z5B~i8_eE`O&qZXOg>AR%DCVw``*~8gm}#HyY_p%geueGL5xQYNb6e`Z?I%P0`rpa$ zMziX@|C3!;qcbsJw)i{;rKTkdx<%VW?=62Vy*vFE`>&+eYk!32>g}ET_|3fFv)7*8 zGIPCh>?`Yjor=T%SKMUZ|1kQx&FwFR%WHW%CSPFLHY+xM%Kq6ws}ILB8}xGSnzFJx zIf~8gTg30K$wCf)N}ui8DOm4yJ#wA>kNCBdCVMbGYQKN@aPyS)rGlGgg->^wbD?Ki zP`y@8;ogkBrmR0dJZibOOWJ8pdQQp_eZPONPw({o;m@4H=j(6VaB;>ftv|URw#9W+ zD_A9TpL(#fC(iccois=3a4-y453OWDNW_a!l1`Ax>gmx}AwN?(4= zI(t&Z1+{HkLhqL4Olx|1#r&tn*}a-`two*dY@h$WxzbJ|WB)ouQCpGfnXV<@-^B_& zfA;EC)X~?UyFH#%h@ahS`Alx=Z`DoTtmNzXMQ6*cif|YG%e`Ii%Fn{ht8c3OeHmC> z!Th3LR(r{d>&qWBU$>bjWy%!zB1&Z2Z`W^k*!f%!TmO9X_t1-VMkVvFyqOi&?fKPI zJ$cKuTK8p7P3>tECKUyJ;V1vTyg~$-Oqtuhe*QcvXJ7jH%#rO}E!4j(z6xJNYd3 zph$)KtQ9<>-q+VAzLxp#GqavOSfZnto3H2I_ne#G@2-k>&pj0*G|z3R*{Mg*y565$ zx9Ffj&*`W0Y$}5aj?JuC8@qd3!sIu{`{j=;SY&wh>gj!JH=a`PTQV#0ys5a+$H{Dp zsr`!%9F3GXb$yA^pE<|RWkwZT74~}{CZeKrutd-2YUb0Tm$eT6wWjWv_0Zy9um73T ztrioLewt7IXvI9`qUXcKpX#!2zX%BUr|WYuY;)q@TQ_`cIw$m<>q*cLX_ZyHRwhqF)kF)8_NgyT{8`??UnwsBxNF+-viG~p z9v_X7vi_1ny^%thT^Aw%uKJ!jm>`Xja`)$@aHHqiU?dIG8LPt79 z4*!eUV32aZf6-rIC4B=!u8qfk8GkQ&SSH>Td+FGPBj)ej@>>l5`5fE5VcPdjF%qa{g}AErA}@AB&#HDw>_!RsOnd$C~Qz^LzQ{H(YrA=&>Q&uLR2~v&riAdncWL z+hTmCqo0?(SN8j-G`Ux8B06RlH=FjyXB8)XUKXvRm*o2R3frY=KIi6If6wBW#ON-PHJ@suN12)eR+WI$JU|!ljW!-M;hB>S!WjlmdF1wOz`doRY@f?T>MPgTU4jp9E!+A(*fulsfCm$3z|3<0&O=gd(~AYv z9d_s~Uc;|ixLhn-F#qeTt95mCS2wPymu5JyVbXQ3C(oW8s&rE*%`ka&oJY^8{?U=k zmoJ|_?cL-mWZWSfAeZ#KrQ)h-x~>#=e2o8p^85LmbvNBNw=`Q!EKVzJi~Du3`roz^g})_KoA{zp>%dzrsw-re~! z0_sKY-fY)q{&#uj++{mn{$b|Y)l;$d`ffWJ2kFN}0#EO!8O`*qwyxbB@oMR}2mBqv zmF^e2s^YE$tp989@AkU#J#MF*i!D-pS-cd~{p9TH)~sLee`-xu$Bi2|dU|*|b*heb ziFS+Yi`mI(w9T>j`0=A+s@)_ZIXS&&s<&=TxoeVa`up44=&Q3=s_k8vt;v2n7IXB7 zfJl(?j2SaTO6}|Z?0AuUcUNh@yuIE+r;|b*lcf$`xw7R-o~fy+r-=JEhdEa`Ojr5t zdc^=4lObR%>IfE8@s@h|>%0sM3?U*pWsD3A3XDsH85kH;8cLWL7#dh6_%SdrOklXg z$-uxMQC@ARkG~M@ib}nAH(6OeZynKE1cD;?uCry~3@Pe6Pr@~wYh4!SRq@Ld1 z`}=BFuU{`OEv@~+vg%8QudlDt;yu;h`HZ*}WS0mtJn@Z)xY5E18h!nLR#Hq%?D_fm z*RNeuGwNEmZk>u3`x7ycBCmje3CowKM@2TD@Y0$p4I#lqnM?Tv!*oJ9xR@%vrO#Ha0lS19{yqW@pjU zTU)bT=KUxan0~sqw^wzON1%Ld?ceG8@j}(=l9G~-w3Q}gPw-=yAiS*R|2Oqb9dqZ# zc9u9@xO%lUhRK5k9t#Tpz4o5sW+-yR8%a;(yN@=twK$f7g7;5z3DXhOxYhJhS5s5# zl`_q`zHaUk?jYy8d#laO&CP9WVlJ_+bj!-hI(P2ety{My>2>UgjEXw;$#a{8y5AfF zbMx$Eex~EIbjpbqsuI)8m-s^no&*$C8rB@~Gzdx@; z-bgj|++$pS=FJXyH~9RbSAFK7Dwd0651YVm}l>nGc8QZ=0arx$-Qza1E5FWQUVBp_dHUw^?>vDMOC~n7fbw66 z*u1)=KOM38pZUzL&T*?r*?g||?Q99NWqe_$cIb$`es_1b>CVK*+~RsX@^&@n=2%YB z^C)dBQL?;wa9h;k^AAe?U7cm}b=lszVeD%p{$%G~zt{h452x(XgRlP@pIJCD_};hg z>TiC^Z|>{O*tG61>-P4&$L>l={;P_=*p_fkRh;>AZ7g3c_tx-dbyoW;nr^?djyHI_ zZn7DxuK9J{J#tef?^u`LZ@Pc3{=LY1fqvO`rlz6c;oH|NTpFJ@p+388b>SRa&e>LN zx3YR`t-fATt`|NiZ}$Dl3pRE(^;XLdcF$Dj#~M`~5^GIezj)5;so$z29~T6d^^`1T zsr#3@I_`q{?=_PjcIevb?>77QT`EOsV#(WEp~1nMk8Qg-b>2L^mr5b}mVW~$iXP1u ze4z5{TgLMVzds)Enw^%H{qE-4mrlv{-=e=39um2A>uZ18`WFt#$Ja#*CU1V%koYUZ z^z=cU@1Do2WMmh5{@IY~ex~GaQqrbZ2_XHr-3N4rzbO_SO^R#`Y) zQkd(({%-ws_3LlFUp>C*-MMma&dPiB_kQ0!e=9DsZo}I@>8Dplt_^27Z)f=9&?kqx zs{U+7fgF!C_-;O{-*)@QU$y1OwA*%{IT>Gj_tgeR1E)7fcKo=Nn|}RKzHRcX|64EK z68JqS_j>2I*Ks=JnDB+CH zw^i!fr2c5O=iIK?)q6Paaq;AC*)1RKazV{hHxU!R|!XTAIC)vF`-I+rd@ z4K%*GYSpT*udWJP316*?o@G1Q=Xc4l4C#%oWpnzaV{k`i+<6XDi%e zq^$K{EU~XhpFiRI-0pCR%UA02U0xgRY}7w9waaWyXbzu!;P=9;rM1?)FTc##_V#3A z@KSSWwzEsuR%J$(oa|jR^Zu`9wr%_N=AX-V6n(ua)I2{wKWNs?5LXou+eZAD@1+UwlDUt;W?| zSx={XiCXvuwcJZStbI^%(;|Bv{$++4*LNSx#I?dhopzPkm@$KFpYX$?f09!Hw&JQvW>eN`R>*IQ>R{id3kwiW}NGS9=EU^ zn&s~_EauicUEij7PI&&gYoBNDzjLYGFYhMfgxsR<#Y&4;?Vc#=oFx6{+@Wt<_ZS{I z_p{Yp>ZSa%+n#mW|L;EwW#Mc){gi9wrXII24c@B$Oou(i_U`9oUrl>d_f+GFP{6cf zz0&46Hv&98Umow5zrVk}{`WWC=7RwN0T(V@P-sg_N%`~V=VZU-+1c6G*Tv30o3_9H z|G(?&<0t8vaz6Pk?z%0cSXq0I;+MSDkGQ_K>{x&O`kK;pg}7+uPey zwZo6>ex{-vw$MdhX;SCiDUHnRRu&d4Y;0XdlP^g{K3q0$R?fbroklgE_g4JO@?Z#w z{Qd21_SIFTpP!wztNmqRWfc_>!C}Ny3t?qU@lAu+J^*$K)qdw(9IG`t#!>m%p-;vbNUa z^G|!!mo_*&J9_LGpS0PU^7r>>gw+HzP&AX>E}6ION1GYFu1FIw%M=$d7n*r(S)x% zJFO&=j_b~U^k3?_oOSh+y`r->|FbzV?{C`t+WVS`@}C6vhE3kaHY;-dygmQswP$=? zTNcAD`6=h%4%3I*g>P~cCY#^n=Lj|b$`^gZbmtq-KHm(t^LAN_pB7AVHQusqiR+x2 z#>+kTl%_zw0uC;Y`k{m%9KMfN&<3n_m+B3S9b3U`8caW2-IB9$(UR7ZP)x4JM}Uq zSsw~%V|!PyqIYAwsC@Ii(r-%LcZJWT*nBUJw0p9sT->zh_uEbFr?;u_ExIDRuc9hj z>)V_|`4TfHPnt5P|COQ343^LZ2cr*^|Ni!tnVoOR(xsslr_MNsSta{#7Fc#8z4*^l z$zCt}MIH6FDVJ;Rtn`sF)a75++8?;yN3pZ#(vHH%UUy6*eL;<2w=a3xO)<{CW@?7) zxwlN$o!hT|*zoSh<(H2yxqEAC+TDGDzJG&^Zl1Z-d;442eQ}d~pW{(~<}bVUneTnY z>m4s5?i{PzHw?=D+AeR}v(_2n6+SqFB#v%9kVy7K(8|Nl-E z-Orac{Asd1j`{4BDOw?Y>(;HCJo)mf(A7(xOb}lp%&Cg7 zEGz%)n=<`};ewZ63O=g;n`-EvroDW@Z$HOH{);RgRh;YSnzkp+y7pIzhlj`0<;Q=m z{qWoBY~|9YYwmI0{`L26nfddZrxG_WUYQm>{aVzEnjKkB=UA1lnmSb!)K8t@7QQYf z^WL7yP(AKrpFf!%dwW~->KVm?mc=JmPY~SNRp#QRXU*aQb-b4FZH%8ZaiZg)9+BVqobeT#Pk)M>cDmZ`OP2S~ zvXnb7YVXfFyL;!|7)ixR@7AYpjOgkL`lw;!q0SI8J4tuVl$OBk@|j!puatZIEn0Wy ztgZRlw_iG9x~{GGYq+}lpm5lc)*F}ldwW$=!%URlU#`2j_D)#OC#jma{EJV5E$4=} zu7Bkf6)Uv!$?NOuRo-|{bX<4Y^JBuX8MWJ0;%433@L|>7J<@r)zw^8vZJqWdyx4Q6 z{&!2>xnh5`*!3;Vdlsg@tpB#cTRQFLe!)Gj|61$rD!BK=!Fsdo{2gEPvgh5Mmw({@ z-V^(6uW#6XU%KwIk8hg0`j4*<^!xu71n$mT9k(G>w%-tRo! zDu44m|E+R)`CW+_hhxQd3!k&P_&v&GPKo05i3_B}5MV$zNB+5JU&_1l6+ZyzRRHAxl*GqFke?4Q$owbbTo)%}2}Ytj#9hv#tb z{r05RDmrj`==+E3?7WX{3w|!Y{rLWOnzfn*`8A$yZf-~TylQG}B<(MY{GGY5deQ9u z*z8+wiqg^o0?#f^I#OM)q@+~!{hjW|Yw;{ktmcXwnDT2@`M%*Kx1Uk#`r-l~73^WXQt1-*CXf6~tc z+}W8N;CNnWzu=r7SMT1^t@)6!^yZmwh2B2j{dXU!+E9AA^m}ftBuA=D{Qk$f?e~uD z$#=VQbct+szaEc#xU}<{?%QRm8w8i7z1_ROn74LaL}O#mB2%gAFE9S4{oSVWf6t5E zKmS?ihlL4Z&zbk_O!r2NhUV+<$HH!AseJt&ca(e{-Ycqk5mlE#dO_dh@(F zzAV!d-zRQ!li|P2-}6eJHs8B@$Fx2=$L{0Zz?WC|@BU{YJH0gAeBa+4`N%y0%Y7^>Hf@e3cbUZgNIsVsoFaB9J*00PzzWvA- zf1P=^wfYCS?itF~iOKm_dyg*rExEJq_2P}%)|XtOxC9g~b@ui3Enb`q+WBv`^w*3J za|~6hwRrDLJajW~(egtZll_CEE8THyfpI^A{(uPBBD-#xTsU3Tf)oaBUzv*Q4 zzFhBneBJMq^tWMPjEz7I=sXCde z3x4m;H4cy3WnXALzjw;7e6Dzpn(7@@zF$_n;BCKEaBS)I=wAk>=5=0J%5cP9T3%4_ z;&T7_=jYpdpR|3hx@6fhzgZ@lwzjdCSbr{VTOyqFeNl7xg*n2u*XGT-{5J8|?HbY3 zcN>*WH|{>_zVM&<-OFi{YfpS%@94+3_r09-^6$^p?d%J0Kge4*-DoOrOy4mby%&*> z60YChaEtF=UiSI*HG<+BlH6urj^FtuFK=^Y;JFPm&Cfn~GV91>>t+A<{h!h+VJlw6 zAGXS;vGI(?zNd-}fm^Hec=)0(_Lrycd13Bm?EAO>{N6jsZzrezom0_U(92=<>`udW zW#3E#+do-Z@tZ^Wx6jg&&%3vC@45HWzt68Zb#M#Y5BK?VZ?2m2hsi5FC#UAqlat$W zZ>y=Rd+*XwRaI5pnsf8h+uPfNroPJZu~Mv?zgvfYmgue1@4s66q@K7pH+hS}l>gr) zB6N2@IB$FG+*Ya0KbIsc&r0rG$o0#NF`duvXaCR2nC>W_y2#w{hYs5a6i*m^(ueuzbPv|FfnU>Kd<{SRpa%#ua|yZ-o3{2 zM11hAn2_FZn;$zDJ@RHu-Lzo?2Pdau-KNKnAD5Pvs>aS?GBh-N_Uu{Ej@v5NUoJ^8 zxV(FP{n5DioR*+l+ZSAu-t)2Ums^OOV7;~SB3#3Zl z-?P=#U0eJ6n{oQNId-+XmUK7A#Ky+&tC=}-rsm70DNgGyb22c5NKQWKC2aVMLLG`%6RQ33pnwrPQdT(#Z++6wj*{f_FZB5P08ygaj=mi!O z7)(65DpOOX2{b4znw*jG!P-vI(c&CtMcXc)!)usy!i2GxA@oB z*ZaG=Ce2H~(#-^_;zNSIzq>1KlJVi$+1Z&jF7jNhPAXI9*;Y$QOY=*atni+$m+Cuv z>Qqrl$;wAZI&W{!umAHy@c92bZ?CocOG$CA69CoOV$Ywp*~vb;x9IEbZx%(5ZcF}R zX0p53{>Iz(?TW~P*$U5JZt|1e`zWAYwD7ywR;`;s!S|+S?(v+EcA1YY>WIUfxnC9k zrQXWdTV`2syZQ4uU$4D&b3Pko%yNIB-fGv)cm8eIqjhE9YR_LgmMtXu#=pisYjMEM ztB>|^8)TdRHQK%V{o&WeCv)OgxjiV_xxfDZz7x;izSVvCr~}jz(o+BZ=1APc-!)KTPOW;iMyOz@oTQHaqM3|`@aXTn9tmkW%PXg@4Fx64gVR(n$M{`CT*4Z z_0g_>wRhJCcD>t|y4+=L{EnRWKiyC67b&^TKX2c){Id7EL|ii86utZNI&81`8S|Mb zKg==;B+Xwj1u!iUX3%2(UsK`zAzW|q^`4n`yYCjxE6+=kt=d@KRiGChG3Dv~D7y{S z4EgE}pS4vL?L_la-tB#UAn2g*F+Ri2HH&DVSFsQ&wzEvaAmzn{;;DR=m9|B^nl zXV!9CvoDwHvVC=aAA7^M{w9a!AJZ*;wIAA*%c5?a*Ea6Wd!pzw^Poc7*}ppu-#MVF zwf^Uw*P7(j>#*=r^z5MWz;`QY-wH4jAN3OHoc5YW)$?1z*#U{UUnyup?GQp2w z1&?1*kP&;LSJkgwNBcbu+1_hDO_=WRi*YrZ@HtMs3yD$kUe-a=@Bd7H&yt?L+|F*_ zg~TrZ{cP%D_iA=5Dt26SXo^ny`CsqnFAlFPUw{APQA6I%g3Uj?L*CitrJUA1J^#OL z$%PDW-FpF7?+MHBFmt!3#aq`uHt!2~RF(W}zIE#6W`37EQ~6~L8n=G+PTlZ&znx0$ zg9W=j7&E#s-WO)jYF@Q`y}K*tnkP#_^s;nqFFnE`;kz?#wO;Nk zhsnF9-h2-TUtT=e*+%bNJ2u?)+J_=6c+PDwXfW zm#md;2S~p%Z<(zA)VlbYPfg7pjpTQCcZYj>pT2Y{Xv)N;-{OuIIao0+Ffw?1(fF-+ z{H^-x*VATX*4eJQa46~B&5v6(9{>D&B!lbKF1A>=b-QZif! zxm&M?Ue2*RP}%$Y$vJDWI}e}yQTx^?B6WV(w|!r^l3vXCl_jP7+j{-1g!B!?xlFz1 zx~shYt`s+Bn;UOjf79UZR{6T1Z1dMymbpJyP4xYF-sR-(&6TIu+IYntmt6e7W4b_F z&7z*lzrVh=@k-yiaU-OBq6(0lk@+!OW(@nyZq|ce|R2O&o=wHsI7PBZ^ewJx&AI}n{OVt7?vy9Z!7D6 zv^bmp(^tu$f*U>S%rj12boBPpn>>3=y#c&9&UI_r--(L$@gnSqg)S1tDePbOiVn$yy@z7dxFMRJbcQ3IFYtFKdb z7rbUW{$E5jR!2b+G`Sb*VE(OE=Iyb1yV859)6TTRt2BC8*ydYcZmmgf)`86NX!v=wqTNM&g$K3#s4$Kmpz*; z-M%Ni%6==y-hJD)OKp+o(c-*{*ggk9WVdw4#^) zfAP=rzh%GN@#3D{>RU_CH7>ii<^7jt|1;OVzj-4vNhWK(*0xQ|mCP?$7$VyO4a)4K zpO-(jd>L<4{PBf+nkYlB3w>)n2&0<*N63+3Y!0ra_BRZEbc{rM3j|v-jH1WWKzOzcYW=it5!n zXI4aa3l%^3Q&nEP{<+BfaAoCn{O!wUH)u7KFg5rDzuNWYV1H`s{4D7&^94oBoj)A3 z`x1RIbkCV{+R2l{#p;5#@t@U_a0$)Kc~tdf>FOP)xSxoF>SG3#35!ZDt&6pmw>v4u zeEcI<{KQCL-tstqUrWO|$w`|$6NqQU;(u1ae zW|>duQ8=;8z`zL_4pIO1?yhy=qa&NzzP-Nw{{B2(X)_-`zjf!F8l_k+aWWJoG0k7% j&6q_U+i=W%Kd9gQPPONuu`NFX0|SGntDnm{r-UW|hp)A* literal 0 HcmV?d00001 diff --git a/docs/_static/mcpwm-overview.png b/docs/_static/mcpwm-overview.png new file mode 100644 index 0000000000000000000000000000000000000000..6d3204466a5dedc1f5202756332e1998eaa237ac GIT binary patch literal 18209 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 to switch polarization of a voltage applied to the motor (M) and to provide sufficient current to drive it. + +.. figure:: ../../../_static/mcpwm-brushed-dc-control.png + :align: center + :alt: Example of Brushed DC Motor Control with MCPWM + :figclass: align-center + + Example of Brushed DC Motor Control with MCPWM + +Configuration covers the following steps: + +1. Selection of a MPWN unit that will be used to drive the motor. There are two units available on-board of ESP32 and enumerated in :cpp:type:`mcpwm_unit_t`. +2. Initialization of two GPIOs as output signals within selected unit by calling :cpp:func:`mcpwm_gpio_init`. The two output signals are typically used to command the motor to rotate right or left. All available signal options are listed in :cpp:type:`mcpwm_io_signals_t`. To set more than a single pin at a time, use function :cpp:func:`mcpwm_set_pin` together with :cpp:type:`mcpwm_pin_config_t`. +3. Selection of a timer. There are three timers available within the unit. The timers are listed in :cpp:type:`mcpwm_timer_t`. +4. Setting of the timer frequency and initial duty within :cpp:type:`mcpwm_config_t` structure. +5. Calling of :cpp:func:`mcpwm_init` with the above parameters to make the configuration effective. + + +Operate +------- + +To operate a motor connected to the MCPWM unit, e.g. turn it left or right, or vary the speed, we should apply some control signals to the unit's outputs. The outputs are organized into three pairs. Within a pair they are labeled "A" and "B" and driven by a submodule called an "Operator". To provide a PWM signal, the Operator itself should be clocked by one of three available Timers. To make the API simpler, each Timer is automatically associated by the API to drive an Operator of the same index, e.g. Timer 0 is associated with Operator 0. + +There are the following basic ways to control the outputs: + +* We can drive particular signal steady high or steady low with function :cpp:func:`mcpwm_set_signal_high` or :cpp:func:`mcpwm_set_signal_low`. This will make the motor to turn with a maximum speed or stop. Depending on selected output A or B the motor will rotate either right or left. +* Another option is to drive the outputs with the PWM signal by calling :cpp:func:`mcpwm_start` or :cpp:func:`mcpwm_stop`. The motor speed will be proportional to the PWM duty. +* To vary PWM's duty call :cpp:func:`mcpwm_set_duty` and provide the duty value in %. Optionally, you may call :cpp:func:`mcpwm_set_duty_in_us`, if you prefer to set the duty in microseconds. Checking of currently set value is possible by calling :cpp:func:`mcpwm_get_duty`. Phase of the PWM signal may be altered by calling :cpp:func:`mcpwm_set_duty_type`. The duty is set individually for each A and B output using :cpp:type:`mcpwm_operator_t` in specific function calls. The duty value refers either to high or low output signal duration. This is configured when calling :cpp:func:`mcpwm_init`, as discussed in section `Configure`_, and selecting one of options from :cpp:type:`mcpwm_duty_type_t`. + +.. note:: + + Call function :cpp:func:`mcpwm_set_duty_type` every time after :cpp:func:`mcpwm_set_signal_high` or :cpp:func:`mcpwm_set_signal_low` to resume with previously set duty cycle. + + +Adjust +------ + +There are couple of ways to adjust a signal on the outputs and changing how the motor operates. + +* Set specific PWM frequency by calling :cpp:func:`mcpwm_set_frequency`. This may be required to adjust to electrical or mechanical characteristics of particular motor and driver. To check what frequency is set, use function :cpp:func:`mcpwm_get_frequency`. +* Introduce a dead time between outputs A and B when they are changing the state to reverse direction of the motor rotation. This is to make up for on/off switching delay of the motor driver FETs. The dead time options are defined in :cpp:type:`mcpwm_deadtime_type_t` and enabled by calling :cpp:func:`mcpwm_deadtime_enable`. To disable this functionality call :cpp:func:`mcpwm_deadtime_disable`. +* Synchronize outputs of operator submodules, e.g. to get raising edge of PWM0A/B and PWM1A/B to start exactly at the same time, or shift them between each other by a given phase. Synchronization is triggered by ``SYNC SIGNALS`` shown on the :ref:`block diagram ` of the MCPWM above, and defined in :cpp:type:`mcpwm_sync_signal_t`. To attach the signal to a GPIO call :cpp:func:`mcpwm_gpio_init`. You can then enable synchronization with function :cpp:func:`mcpwm_sync_enable`. As input parameters provide MCPWM unit, timer to synchronize, the synchronization signal and a phase to delay the timer. + +.. note:: + + Synchronization signals are referred to using two different enumerations. First one :cpp:type:`mcpwm_io_signals_t` is used together with function :cpp:func:`mcpwm_gpio_init` when selecting a GPIO as the signal input source. The second one :cpp:type:`mcpwm_sync_signal_t` is used when enabling or disabling synchronization with :cpp:func:`mcpwm_sync_enable` or :cpp:func:`mcpwm_sync_disable`. + +* Vary the pattern of the A/B output signals by getting MCPWM counters to count up, down and up/down (automatically changing the count direction). Respective configuration is done when calling :cpp:func:`mcpwm_init`, as discussed in section `Configure`_, and selecting one of counter types from :cpp:type:`mcpwm_counter_type_t`. For explanation of how A/B PWM output signals are generated please refer to `ESP32 Technical Reference Manual`_. + + +Capture +------- + +One of requirements of BLDC (Brushless DC, see figure below) motor control is sensing of the rotor position. To facilitate this task each MCPWM unit provides three sensing inputs together with dedicated hardware. The hardware is able to detect the input signal's edge and measure time between signals. As result the control software is simpler and the CPU power may be used for other tasks. + +.. figure:: ../../../_static/mcpwm-bldc-control.png + :align: center + :alt: Example of Brushless DC Motor Control with MCPWM + :figclass: align-center + + Example of Brushless DC Motor Control with MCPWM + +The capture functionality may be used for other types of motors or tasks. The functionality is enabled in two steps: + +1. Configuration of GPIOs to act as the capture signal inputs by calling functions :cpp:func:`mcpwm_gpio_init` or :cpp:func:`mcpwm_set_pin`, that were described in section `Configure`_. +2. Enabling of the functionality itself by invoking :cpp:func:`mcpwm_capture_enable`, selecting desired signal input from :cpp:type:`mcpwm_capture_signal_t`, setting the signal edge with :cpp:type:`mcpwm_capture_on_edge_t` and the signal count prescaler. + +Within the second step above a 32-bit capture timer is enabled. The timer runs continuously driven by the APB clock. The clock frequency is typically 80 MHz. On each capture event the capture timer’s value is stored in time-stamp register that may be then checked by calling :cpp:func:`mcpwm_capture_signal_get_value`. The edge of the last signal may be checked with :cpp:func:`mcpwm_capture_signal_get_edge`. + +If not required anymore, the capture functionality may be disabled with :cpp:func:`mcpwm_capture_disable`. + + +Fault Handler ------------- -The block diagram of MCPWM unit is as shown. +Each unit of the MCPWM is able to sense external signals with information about failure of the motor, the motor driver or any other device connected to the MCPWM. There are three fault inputs per unit that may be routed to user selectable GPIOs. The MCPWM may be configured to perform one of four predefined actions on A/B outputs when a fault signal is received: -:: +* lock current state of the output +* set the output low +* set the output high +* toggle the output - __________________________________________________________________________ - | SYNCSIG FAULT SIG CAPTURE SIG | - | 0 1 2 0 1 2 0 1 2 | - |___________________________________________________________________ G | - INTERRUPTS<-----+ | | | | | | | | | | P | - | | | | | | | | | | | I | - ________|_|___|___|_____________|___|___|_________|___|___|_________ | O | - | | | | | | | | | | | | | - | | | | | | | | | | | | M | - | | | | __v___v___v__ __v___v___v__ | | A | - | | | | | | | | | | T | - | | | | | FAULT | | CAPTURE | | | R | - | | | | | HANDLER | | | | | I | - | | | | | | |___________| | | X | - | | | | |___________| | | | - | | | | | | | - | ____v___v___v____ ____________________ | | | - | | +---------+ | | +------------+ |--------->|PWM0A| - | | | Timer 0 | | | | Operator 0 | | | | | - | | +---------+ | | +------------+ |--------->|PWM0B| - | | | | | | | | - | | +---------+ | | +------------+ |--------->|PWM1A| - | | | Timer 1 | |------------------->| | Operator 1 | | | | | - | | +---------+ | | +------------+ |--------->|PWM1B| - | | | | | | | | - | | +---------+ | | +------------+ |--------->|PWM2A| - | | | Timer 2 | | | | Operator 2 | | | | | - | | +---------+ | | +------------+ |--------->|PWM2B| - | |_______________| |__________________| | |_____| - | | - | MCPWM-UNIT 0/1 | - |___________________________________________________________________| +The user should determine possible failure modes of the motor and what action should be performed on detection of particular fault, e.g. drive all outputs low for a brushed motor, or lock current state for a stepper motor, etc. As result of this action the motor should be put into a safe state to reduce likelihood of a damage caused by the fault. - +The fault handler functionality is enabled in two steps: + +1. Configuration of GPIOs to act as fault signal inputs. This is done in analogous way as described for capture signals in section above. It includes setting the signal level to trigger the fault as defined in :cpp:type:`mcpwm_fault_input_level_t`. +2. Initialization of the fault handler by calling either :cpp:func:`mcpwm_fault_set_oneshot_mode` or :cpp:func:`mcpwm_fault_set_cyc_mode`. These functions set the mode that MCPWM should operate once fault signal becomes inactive. There are two modes possible: + + * State of MCPWM unit will be locked until reset - :cpp:func:`mcpwm_fault_set_oneshot_mode`. + * The MCPWM will resume operation once fault signal becoming inactive - :cpp:func:`mcpwm_fault_set_cyc_mode`. + + The function call parameters include selection of one of three fault inputs defined in :cpp:type:`mcpwm_fault_signal_t` and specific action on outputs A and B defined in :cpp:type:`mcpwm_action_on_pwmxa_t` and :cpp:type:`mcpwm_action_on_pwmxb_t`. + +Particular fault signal may be disabled at the runtime by calling :cpp:func:`mcpwm_fault_deinit`. + + +Carrier +------- + +The MCPWM has a carrier submodule used if galvanic isolation from the motor driver is required by passing the A/B output signals through transformers. Any of A and B output signals may be at 100% duty and not changing whenever motor is required to run steady at the full load. Coupling of non alternating signals with a transformer is problematic, so the signals are modulated by the carrier submodule to create an AC waveform, to make the coupling possible. + +To use the carrier submodule, it should be first initialized by calling :cpp:func:`mcpwm_carrier_init`. The carrier parameters are defined in :cpp:type:`mcpwm_carrier_config_t` structure invoked within the function call. Then the carrier functionality may be enabled by calling :cpp:func:`mcpwm_carrier_enable`. + +The carrier parameters may be then alerted at a runtime by calling dedicated functions to change individual fields of the :cpp:type:`mcpwm_carrier_config_t` structure, like :cpp:func:`mcpwm_carrier_set_period`, :cpp:func:`mcpwm_carrier_set_duty_cycle`, :cpp:func:`mcpwm_carrier_output_invert`, etc. + +This includes enabling and setting duration of the first pulse of the career with :cpp:func:`mcpwm_carrier_oneshot_mode_enable`. For more details please refer to "PWM Carrier Submodule" section of the `ESP32 Technical Reference Manual`_. + +To disable carrier functionality call :cpp:func:`mcpwm_carrier_disable`. + + +Interrupts +---------- + +Registering of the MCPWM interrupt handler is possible by calling :cpp:func:`mcpwm_isr_register`. + + Application Example ------------------- -Examples of using MCPWM for motor control: :example:`peripherals/mcpwm`. +Examples of using MCPWM for motor control: :example:`peripherals/mcpwm`: + +* Demonstration how to use each submodule of the MCPWM - :example:`peripherals/mcpwm/mcpwm_basic_config` +* Control of BLDC (brushless DC) motor with hall sensor feedback - :example:`peripherals/mcpwm/mcpwm_bldc_control` +* Brushed DC motor control - :example:`peripherals/mcpwm/mcpwm_brushed_dc_control` +* Servo motor control - :example:`peripherals/mcpwm/mcpwm_servo_control` + +.. _ESP32 Technical Reference Manual: https://www.espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf + API Reference ------------- .. include:: /_build/inc/mcpwm.inc - diff --git a/examples/peripherals/mcpwm/mcpwm_brushed_dc_control/README.md b/examples/peripherals/mcpwm/mcpwm_brushed_dc_control/README.md index 9882c3a3b8..1781459a7c 100644 --- a/examples/peripherals/mcpwm/mcpwm_brushed_dc_control/README.md +++ b/examples/peripherals/mcpwm/mcpwm_brushed_dc_control/README.md @@ -8,7 +8,7 @@ Motor first moves forward, then backward and then stops for 2 Secs each countinu ## Step 1: Pin assignment -* GPIO15 is assigned as the enable/input 1 for motor driver +* GPIO15 is assigned as the enable/input 1 for motor driver * GPIO16 is assigned as the enable/input 2 for motor driver @@ -19,4 +19,4 @@ Motor first moves forward, then backward and then stops for 2 Secs each countinu ## Step 3: Initialize MCPWM * You need to set the frequency and duty cycle of MCPWM timer -* You need to set the MCPWM channel you want to use, and bind the channel with one of the timers +* You need to set the MCPWM unit you want to use, and bind the unit with one of the timers