From cfe9f2264c83758a0d2469bf35142b1aac799580 Mon Sep 17 00:00:00 2001 From: YuXifeng <2860280851@qq.com> Date: Tue, 4 Mar 2025 19:58:23 +0800 Subject: [PATCH] =?UTF-8?q?QT=E5=AD=A6=E4=B9=A0--=E5=88=9D=E5=A7=8B?= =?UTF-8?q?=E7=89=88=E6=9C=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- APP-Test1.pro | 32 + APP-Test1.pro.user | 274 ++++++ libusb-1.0.a | Bin 0 -> 212738 bytes libusb.h | 2142 ++++++++++++++++++++++++++++++++++++++++++++ main.cpp | 10 + mainwindow.cpp | 167 ++++ mainwindow.h | 31 + mainwindow.ui | 207 +++++ usb.cpp | 32 + usb.h | 14 + 10 files changed, 2909 insertions(+) create mode 100644 APP-Test1.pro create mode 100644 APP-Test1.pro.user create mode 100644 libusb-1.0.a create mode 100644 libusb.h create mode 100644 main.cpp create mode 100644 mainwindow.cpp create mode 100644 mainwindow.h create mode 100644 mainwindow.ui create mode 100644 usb.cpp create mode 100644 usb.h diff --git a/APP-Test1.pro b/APP-Test1.pro new file mode 100644 index 0000000..27b307b --- /dev/null +++ b/APP-Test1.pro @@ -0,0 +1,32 @@ +QT += core gui + +greaterThan(QT_MAJOR_VERSION, 4): QT += widgets + +CONFIG += c++17 + +# You can make your code fail to compile if it uses deprecated APIs. +# In order to do so, uncomment the following line. +#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000 # disables all the APIs deprecated before Qt 6.0.0 + +SOURCES += \ + main.cpp \ + mainwindow.cpp \ + usb.cpp + +HEADERS += \ + libusb.h \ + mainwindow.h \ + usb.h + +FORMS += \ + mainwindow.ui + +LIBS += -L$$PWD/./ -lusb-1.0 + +# Default rules for deployment. +qnx: target.path = /tmp/$${TARGET}/bin +else: unix:!android: target.path = /opt/$${TARGET}/bin +!isEmpty(target.path): INSTALLS += target + + + diff --git a/APP-Test1.pro.user b/APP-Test1.pro.user new file mode 100644 index 0000000..c989069 --- /dev/null +++ b/APP-Test1.pro.user @@ -0,0 +1,274 @@ + + + + + + EnvironmentId + {365fcea5-97bf-4386-8d9b-1f8d69787ebd} + + + ProjectExplorer.Project.ActiveTarget + 0 + + + ProjectExplorer.Project.EditorSettings + + true + false + true + + Cpp + + CppGlobal + + + + QmlJS + + QmlJSGlobal + + + 2 + UTF-8 + false + 4 + false + 0 + 80 + true + true + 1 + 0 + false + true + false + 2 + true + true + 0 + 8 + true + false + 1 + true + true + true + *.md, *.MD, Makefile + false + true + true + + + + ProjectExplorer.Project.PluginSettings + + + true + false + true + true + true + true + + false + + + 0 + true + + true + true + Builtin.DefaultTidyAndClazy + 3 + true + + + + true + + + true + + + + + ProjectExplorer.Project.Target.0 + + Desktop + Desktop Qt 6.8.2 MinGW 64-bit + Desktop Qt 6.8.2 MinGW 64-bit + qt.qt6.682.win64_mingw_kit + 0 + 0 + 0 + + 0 + D:\QT-APP\APP-Test1\build\Desktop_Qt_6_8_2_MinGW_64_bit-Debug + D:/QT-APP/APP-Test1/build/Desktop_Qt_6_8_2_MinGW_64_bit-Debug + + + true + QtProjectManager.QMakeBuildStep + false + + + + true + Qt4ProjectManager.MakeStep + + 2 + 构建 + 构建 + ProjectExplorer.BuildSteps.Build + + + + true + Qt4ProjectManager.MakeStep + clean + + 1 + 清除 + 清除 + ProjectExplorer.BuildSteps.Clean + + 2 + false + + false + + Debug + Qt4ProjectManager.Qt4BuildConfiguration + 2 + + + D:\QT-APP\APP-Test1\build\Desktop_Qt_6_8_2_MinGW_64_bit-Release + D:/QT-APP/APP-Test1/build/Desktop_Qt_6_8_2_MinGW_64_bit-Release + + + true + QtProjectManager.QMakeBuildStep + false + + + + true + Qt4ProjectManager.MakeStep + + 2 + 构建 + 构建 + ProjectExplorer.BuildSteps.Build + + + + true + Qt4ProjectManager.MakeStep + clean + + 1 + 清除 + 清除 + ProjectExplorer.BuildSteps.Clean + + 2 + false + + false + + Release + Qt4ProjectManager.Qt4BuildConfiguration + 0 + 0 + + + 0 + D:\QT-APP\APP-Test1\build\Desktop_Qt_6_8_2_MinGW_64_bit-Profile + D:/QT-APP/APP-Test1/build/Desktop_Qt_6_8_2_MinGW_64_bit-Profile + + + true + QtProjectManager.QMakeBuildStep + false + + + + true + Qt4ProjectManager.MakeStep + + 2 + 构建 + 构建 + ProjectExplorer.BuildSteps.Build + + + + true + Qt4ProjectManager.MakeStep + clean + + 1 + 清除 + 清除 + ProjectExplorer.BuildSteps.Clean + + 2 + false + + false + + Profile + Qt4ProjectManager.Qt4BuildConfiguration + 0 + 0 + 0 + + 3 + + + 0 + 部署 + 部署 + ProjectExplorer.BuildSteps.Deploy + + 1 + + false + ProjectExplorer.DefaultDeployConfiguration + + 1 + + true + true + 0 + true + + 2 + + false + -e cpu-cycles --call-graph "dwarf,4096" -F 250 + + Qt4ProjectManager.Qt4RunConfiguration: + D:/QT-APP/APP-Test1/APP-Test1.pro + false + true + true + true + D:/QT-APP/APP-Test1/build/Desktop_Qt_6_8_2_MinGW_64_bit-Debug + + 1 + + + + ProjectExplorer.Project.TargetCount + 1 + + + ProjectExplorer.Project.Updater.FileVersion + 22 + + + Version + 22 + + diff --git a/libusb-1.0.a b/libusb-1.0.a new file mode 100644 index 0000000000000000000000000000000000000000..9fd8457f363ee6f00a6c2b04d354741a1e531689 GIT binary patch literal 212738 zcmeFa3wTu3xj(!o7mWx`R8**_qk;{V%Yn69N{Il2ZD;4F-u0JLf<^M&OWAY1%xQh2H4&%By zOL2Ua>)ZDzj?mA)+O_Y9;`pTAxFVs-y0WUqhK68OxU4$3wyr9u2wFvbePfl4Qe78H zW2~>M1aH~uV7LsRtRb?dGT5wGs7;N{;o-;?&B2DSl~KlAR#9Eu91MkqaS1gAgVhGT zIap(pj0Dg_s9awbLI`z@4P|xAZ@L>HfV*r>a7~#=Wje8@IT$o(Ap~6!2{$7Aa79&Z z*$u(whG2bJb#vWXGpV%|p|Yxqri#kC`nvFXslWQh)e?j%8tTGz-w7HL53e3unuXe$ zD#Epf6qJB96)j~=6;(F?h7er3Q(dTWIOj-%MOk{(ls-dW^>v}JB61e#304z1R94Z{ z6l@qqdu4)K52X=2h7g2}5ZBd(Ys=QwRhKoH8BkT<7_vzWL#nA;9ciuzBd3f|NY}$U zRMl71ttqQ(2nU;MDqx_x1kJ(vU_~f6)PVwGZsajE77T~$8de)VtKhM@tQIZ?1!f0N z(ufS2ECQi$bFg9!=Z{cc8qH=DWffIn7>5za7uiik_{269Y^h`6q-d29mY)bPu(GO3 zBO0PKHd(b<2eUI=*ELr(m4()a(h?YKZf#YvfR79XaaT$kZt?vZiqJ6j5`K3z?79gTWJmz*RR4C6fJFiiBQ_tAnAc=DMbEqpdnI zLxk}lEyM9h1Ny3tWvDOKR@6sW0U~?9FpN;B45@2sgn=P#Yno8JQP~U?MjFajWG1~= zHd6kir%41eyc2n%`gdBHy9{{~Y!KDn34-`4j1(Y}N3422n6=u8MEfuBQ}AR*6?F~4 zW>n873i3;Mgp}cC6lY5SWfh^Sx;kZ8Lljn7+Zb-DkE}+$fMQ{zh>~WbG&F|mYU-+F ztDC33Ey(h9Z?~>cVB|DztU!WaF7C)iPNVTH0E6)w2n8C%H;3Ry0)C z2RT4deCmUu(i+}f2vBdyhfv+>h6+<8YY2L>!_DhOO;Z+Ji#`Td+f@0aks=Ml5QQ(a z3=otItnmgTA1w~ZBYPb$+M4D_Q&`3zy_-5WqbXZgQ3oSosjMQTyAf+y4eDnRvmr)P zV|{&1bx4n*EL^uH*cdUBNlI@(U0^sE-b8|ex&jPGLwjb&YFM^m!x)zMWdV{R%*e=m zWOB-6fg{BTJ3u#3*JP+M(roldn}cf_*Xn5~vpUo@T1qt@tW75=MAw-ivM2%u&1!dM z2iIQwj0VkC?EYJ25=n**D(bnpq2fc0upt{&ea(%gfgAM7Nc|05ZVaMnc1EF->Z?MB zC9Eq-QqU$K*!8+8i8SjaNg9`+$WD=!Aj2UWYqp1DAyqW55%y$o)P>S0vL2GfM^tSh zGP`x_`Hs|Ai@>VMSy@-tP~Er=EvV?GAO%W&V?{OfW5VdVqr5j)G_O}`!xfb%4xw5S z5w78iFy2MbW9JG%)_}SThl-+A6+~bSRfgGer-zJYO(Tr5v7xR?2xK*g>Kn?^Edr7v zawZ#s+j>%lACl4xfxJ~T)v;H@#?pgGi$R&1K6qdsN*MAqdxk+OA0hH0RHjEUrE%(r za4oVLwTgvg2!JjQR6$Gz1$RhIlo3^p%|QSoXqPd9F?+gw1S8+=o;3?&7t?0v&n^($ z{^qGT;sl)EKTriebKco6?Ozpf}BI}~NyWs+6`>{3e0rwBtb`G!Ltr8F_6 z5-*dMU#SHfu$A~)>;b-(p(t$=4GwwtC~nV`COhBF;47b`DCb`xd47hQ;A^(?xkf3< zYf}_unJ&PMg0I{&b%yk3{C5Eyn`=DDJEeDOexZ$+ho^D#Y$Ory)af&A#4&g(2H#`L zB>5!VgnW3-t_tHNMgKM7zH(@IiK#R54Hj|t;QzBj_)0xfXHB#5<>F~1^6WD`USyl% z$u0FPU#e<b9f7qkg^mqQ#idf27LkwJ=r5g|p%e?e_e zgwIp8J>v1mX`n8_$NbTwTr@-J| zr4IJ0+VX*iU?$4oS>!zs^9`ul69H|HU`P?IW=fho?uQk`8qiAe0&!eg$$$_=_}E+1 zY2o)??OpC&cFomG)s2Ts;YW?%JH8b`s_jpy+B4e05^Z0J_6KL%)yRQZW?{ecwmCr2 z<5|wlRIZTj9Ne@I)vD3oQyotaz7>eiBsnR;?bnm1QI!7nr<`p)g1;moMTsp>#C+ZA zH_r0F`5W0P{v)Lc&DXs?SB?J7k*z%aqq#aoraV^C{qTX3%G`ifJ-$FI9-mhnD@myF zTY3Uoc)U9h&+b7OTKAr#7kv7+J)fO4@o7~%sx2Gu61qsfb$oEptL^h{JT{oAD9+6v zg1MyXW8rv3eB|uF#18|pxEsQjXh|Vrd&1dq3|!v$=&X&O317D##`DI{{y`z!o=@r7 z_Arg4Y99m~{WaR?lU41rWFBHt+g}ZjR%1muWD2MHwE<{IdwH;@Q{A|a)O_9bW!{zE zRo?4Y?NwvvAp|J=RcHH;$gAb~yLe7+`^Vs5>NX(f1q!r#E|^KXZ9gYwk^JiMt`hA7 zndkBBPbf6)XtE#vEGgb}+93F~qk_$sf5eynPHF^52+{=~sVfj%Cmt@Lhs#8C9%VP# z(ZghY#S?oc_M}Ei4`l4Au_FGn$Zj8^JnqWIKLturk`oZM8b7NASU4p|QyK>GZ{y#N zLwN}43HYw*Tn@w2OHk~_oG!0Q-eGvo`})jAb+WnQ1tln z%=knq$)g(I;6_T3BM8_?Bqio3>;~yVno4ujt|FIU?kdWoyOBo95mnREm`AaRM0TQT z9JAL_zVSTP`V6J!TA$(mHS2TCJI-D|=(+Q-RBCs>bI-U(~V@)rD^29t; zNY6$UEHoW!-AT#?DHFACe!`{?lZonbgK782h(*MwyC3n4$Oxa5pU|#S_Zp6^6ngZi zBm9l_r-Y4$FWh*P3@bc2Ke6$s11RFu{l`2x6BH#wLFFKYinin_&N~y%T?vCESsV&k znW-PWJ@KeuB&{lpXIE( zHviSO7s99NIu-dH^XCNOqnaSBXxC8dZbvUH*#-qLn+hgjFpq$W`eoESup6A;0;%tJ zLs+PNF<533%XejYwaFKVU7O>hCh`U6))=(uuSx{sfsDaoE#bUC=ogZYg~(&jutx_5 z!ya$P>4+-VA5A&XqD6X(wY?Mf78fRNKE;%FTcB!hKzrUFADto0mR&@BJ8B1|mC9Q{ zdl?dXklaTGAYrl-H5l_gf``Gr->BO20qqI&Huj{vAei-=TRWg?&#Cd{vL$X$v`kfF zkpbtf1CM+TMpRZw*QdC{?6RB>uE-(+;#5QgZd78(_eHu^e*zECYPVFGi}as`==%RwsD$Xd|5`yNpxjuL$&DUD#Vw0G3OdM=#b{zCYC zHFgS;gDNO~eNJ*LNf6ze191k(X5UY1$PgzrYO*9RH+pZDQmn=b)xz}<^BKSP;<^eo zb_EsLvkVm=`3X|(^RPS7LqRg)qn{+x2*hi1WzMuGRBeCws(@CT6VTpFesYwOTYMbV z`AH5{>xT?f$5IythN(TTYOg1smpq^63inKhjmN0})#zL$d|p1fGHr;Dj4=QY(Jn{w zB3Q6GcW(20q+W9B`ysWTX8%;$G<5b5iHf8dl7^jX7kNBJ_?nv!aBekSFRDnoz zD<%3h%D3n(1B$clX%ru|{fM)zfIv)iuGQH5Jmj~t?Ewl7g%#chd(^6dcBpFAKuf6_ zoBME%a9ix~YsU={{MwVwwo(z`pxTu+01jot1^Gu{?}3kUlee=x#$Zn%-hdub%4k&=pq5{OR`nxi+hddfyhik$0r{>&Q`(276m)v|6rGAa$$L=l z5Duv>@~Ya^^$CoU153S+yfWmGMFo0n-%UBF7ah{;4m`)QNn6mU=-MJ<3MgZsC`9xD zGNqg{Wg#r5D;otybhA=T@Mol7k2>|Kpm~)1!BoU53TZX9nj)4mrgj2b`ahQPvBKzs z1!9vC6w<@Zx9i;|`ldAx(mJ*fYS)%dzvvM=58t|>?V)~&`D zuTZrs(RjmdmllX_;KFjrNb`GHeHr4(0vGc=YYUtDPrG4dgMC|eQ~vk0Q~RQ~Fww)TPwge2 z_N3b7+kqIU&}>gGAlsz&CQg)C$#yk1mfnb#1meM+kC8?6onzP!IgZPRN#j-N)i5mf zEu#W}j?Swoyk&Rfm73zhH4jG)AnYCF_;utl951Gjg)Jq2N$H7+uD7WhlApx_E47bl z>O*?2F>4r0nq=$ZY-<&DgV$rNQlQ}NuoyMgggW+vq=uZ0ZKW=bu1-;GP>1A_b?LSi zLwAmpvx%$(rD`{f!#nsVHFj4o2!Z%_2K=#wxoW&+06e1ADeM7TcjS`Pzkq@3166Qc zljGM=jU{u`!sXrJn^djKKlf*?;ETLb5?@yu&^|!e-XjY=cuV{vg|B_!kN&;YJNTkM zc1?3jWzg zRLbNFN&FT-Pc5}IS7Oiu2_Ec;4tyNGygd<_?A+y}4r&4F9AQvUiXMijL9anL#NySm zWPMgH>ND!E!Pl6fzLFE*!-pX;7+)Tu>M9;zkVLk5cT-*Ra4Y_Sqh(SeN;3c&l%6Q_Y?F`A^%Hu`BA+o%p z&^iVrk&5hIj14C1`laTVZ5$kgKs9B6Z#agM6FpXA3ZkQ~_>#c7lq&-`9Lup*oAhPWgS%HYmu+j_6v~Qz$P?RY* z5kcN{R7Q;G@Fa&?`aZPv|Av$ovNw!s7vts2T59rS4^NukK_~#?w30ag`u^ZxN&7p_ zJD)(O_NR%QCn9s&2g9?>ax~YJaJw$yRIm0yiPlT?qW+FZCB>3oDBz;($eem#j1l#{ zi~iMc_NIz5Qj8ZetH4xDl9r4rCt;7hhm3-Fv)hksm~M(#V2Zdy7jcpouW^QehBsPf4-C4&BBLlSFE=n`EjsvFagME^6b{`;rpagjU+ z4}Xz7-T#~NC?wBhYpH%XtT&*3NVGClzuRy zyE{NP*)c?4yi1S~3OeeW$ccW^AKQm#43&9|z|fmG36@7e6kbNG&bCwWke`sUgC$8+ zzQ>H0-q*v60`Un;AdnirjFMo~?=(JCqP>X^G)7+$-2`)3=y!iZaq23{5ux&{^6Qaq zHNIelTDYJ*d@fYfgm4Y-x{8t^@~MAZh%c%g#LLSfH~x!`px*w%E zTpi1vgy_)AL`P7-Td#oIY>ET!O8!$u6uBY_@&28<5#>a_?_^VhOY)}v0-D-oK6m38 zA&o&udJuYm$^EIp!OfRZ_RG>IswUZAG|Ib6z7c5$!;@k~S?J`QgKvPlNg(Iq{@oNG zYDcwSn~o5~@RV$C3>9FQqua#JHu4ZVi}c$5LgYS3Wf>Qsu9g@Vm``p^)*-k?o>C3cPoUbB=7nQY8L$^T}IWh4i4T&$yHBO-zds| zL!U3#we&EJ{;q5h#?N*jZFi zFomOSGAOZZDj-^BibkaD?cYlp3*K}Gu~5~{|`6qe>t`zOf62AJ0V83{4&?MLtp z#;ne}L~|{?$}v|m9@IIhL3~S<1A0bkQ@JROGCi?T)VN?a#@2jTiy9k60U+1!Ff0NF zL|LD_|7~=UvcCaW$L5)o`!rpES`d8T^^hO!GOE3C!+-gL5 z^Ldm+@1r!#nR*KZqkmu-?^K75AD@cpQ2yBO#~?+bDZ*qE^wsflf%GQu)+*Z9WG!Mr z;2u>e6M$beQ4FkrXXhik5l#uvMwdjq> z*E=<~v>d$=3>;sH8e$Q~A&#or)dixDRm20wGvq*v$^*yx`?^_`JKHOec*}F!Rd_b4 zcV|0|c0ilMwbPs5wAR)s`haEVk9t$^l?O!$Wgri9-OyN$OY=RN^usrG?)0HQ*@cVw z9!0BWiYsgTIS5${MW<-41(nC>o~r24I_GAp4>1G54VzS}vc9W2dIo#R9VT`S;>O1^ z(dD4$Gr?nhUY+KCQ`+wWvva0pWinne3?4h8 zeQf6Gj_)cX+^3Z1G@YEt?#b+RlsZOaXOEb6Qf8(*qg?pUJ*ho6Gp91komrmI1b6v7 zpPx|-kmdHv8vj@2Z`NfzEvx;s%#-F*N*q>9agc0FEV7L{IeXNSQ!-C-XP0L+WhR8Y z={)J_8J*KUI&8E6$zGPIUT@#2;^8Vb$I~;Ayi1sm=xj!H2 zKDB&A(FKoU>c8VZJ-qbi;lfPUZTjHFA;n#_)2N!H#+|P#bjRAJyUW{uza4GK3p~vSY9^B{P?MMao;7%ih zD}Z<6egPV!T3{FM6L7TvyK$e1i{>wQaQESA1un&XIj%O~a@?zNkxcZ;`5>+>zzN*v zppb3@_TcWrwF9^m_b{$|fm?CE8`nHZH~JAf6m8oTKNPT*d9 zHs%)tH{m|#9LNdm!F?w#>SNM$pY&_u{@`EYbnoiu-Bk_qu^|asMeU z5Ab%}r(pJFDX<&&8_=~W2X4asAGpH6%K4ZdimMH{6Zg?B$PDbly>>igCVt#UUIKZ6 zb8&C^I&=%%ihBpHL%;$5{N+pMmlgZwFJGuc8g6K4T-Tt;g&uVcHH}JjkQQ^Ut7vYZ zMX8uiN((Bma$!x=D%W*#GQPifl?#hq#foBAJ*Mo}yRNH=G+=FMV}q*-iz-&R=D|;> zVs-FxaZdx$z(#27{rGD3%x=g(VaF^KiKQxsZ)?UE6hki?EOH-z9Iq9_&%{9SUHmrJb5u6C`ft*Z~Zj3q>_ zbqGEbuB)$iRR&1{eaU06dXlR$5_W}agGRETD#-}JX#W5t4}NPZn(4MK=pwV1Df1$& zw3bjV<#S=_4dqK+!{nO!y4AG^R9~eC$wCcZ4_ITq8W0;?uHt zL|9dUj5Cy@>lhxSnnj2;Fe*w3tpy@epd7_=FPC1B_0`daaZQNmVo3Y0TptdG^c+Qs z>QD`Yo9kJ&Zz@J;H5JHEWS6LLDC^;1mKP%M;`sCj7na0hks7U)CnsZ}v&-Ewp+%v^ zYFG*HnhIJ`Fhr3g80jQYYG|=-9ZE9_-Zv>NRFd?vK{2Emw(^Bev^51} zLP^rC4h0U&Zedo{3N|c2aS-c7QCHT4U7^M`MoxrWVyA-UU_=;EdYp2x9Mub=AQ|%O zwV7+}gvb=*Zvw9+s%t=HEwi#AxX$o1T)|Y*mfn*l{j+AY$ecZaqqW#xdg<~-S1ww7 z&7w;$HJTOQk|m3ml=&CipS?vzzNJg;v_*^223_qh@}-lPl`UAjd{METj5h09J7t-_ z#J70)GCOhc)xISQ0*kM)Q%n7&X|ebhErX=XOPBf5;(=5pz7o6lMT?h}EnQw(x_HSD z_QlIo-x7m+*%I%fr3-vZ%7hYzP)Xq8GK8$S=eRiGH)O-B%~p#V}4FQ zxARMv3*Eb>y7Y#hd5ad8lm>i5lH^}>wKw1|E-Upe@s_|8KGypYH>3YR{fIVP)R)+T zi`Ky1iEA6KyK!yDbq}r`xbDTZ6W0T{cH?>!R|3~QT-~^y#nprBMO=q)y@sn7*E_h9 zxDMm$$MrF;0bIv$DS23vhbsryNL;zNM&lZTYaA{YE*enG!!-$)8`lh61-Rzn^581Q zrQ!F{H{)u>)rPAB*A`rzxbDQY4cFbcw&S`7 z*A86w;@XMp0bILrJ&G%VYagy|T+ib2;F^Ie57#(cxwx`$QF$>5KH&54U%4 z9l}NaDLe|F;?tLuiUr10g7s&yrvN=0Kb=18{vO1myAQiJh{b)_eMKzpa*GLle-fe_ zKO=szhmT%u8*X&h-EEtm4C8LuCdKN?{%Hj_Hzl@xR_yF%eCZpu=zO|7>HEBJD7rhv zXKTw02Hl<3?GEc+-B>1C;WU1x>HbASK|K0%TJ>!BW_R1>I;JbTi*>}EAtF6R}M#`DDc`Uessrcrh->X#Wfk7j@1pcc6rW4=B_cMD(pjp-r7ZzX4rUy zLa28}Ju|W)V!de6^r1|8Kf%I-_!brw&2ik zx_WdE*SkvU8WvtN`I=cXs89WEbeJc)3Z~>wp#g`q-;eQJiz`dnj{h44`ZxT)O`uot zzfz#%_`hDDImm)Gf$jj3et*g60U+svK4rBFz5`5qnGt=%_>OQrFT)6>7D$GC5GX8M z{|ZE%(<~(uZ*(%Y@rRa`I|Z5v^aFwFfMkkV7_|XO`F_W=M;X1%=tD-A zqME)-gf|~ZhIbXC21d6q`aPpPj9vng@#dXngffHCw}52Yz6~V#ZUd63OfuicjLtaQ z@Np54^l=%G^zl<5Dd~NTUIdbH^fBLOKx;+XF2Z=F^gESN4Ui0_nUMx0eH>ug8;p*y z>uQX1O1}+^wgE}MPK>t(bGNcw$}Y0ooyk6nG| zDoU$J?NumEj|Gz9T?q6;5ywQJZ30~eB;zP% z^aDosFxm+u%gmpE!ou&L+4V0#GLC*mN7?mcj10>-&ZIG7;rC*oh(ObsR>XW)Fj@&D zL%yH+9tVMjx^3*z=80W&=qHihyJ&OW1W4kPM}s(K>eR0+QM-xWLG* z5+EtxwTv1WMHt--B;)M>lJVZbt`9JJg!v8tNm<@v^d9rgbs4fO1ZowUTmvL!xecgA z(7wy)=RmT4ejex+;o1)*eO!E@fffMCcq z+91$GAX)S0v+I0DR{_b~S^*@rQO&54`PMROXS4-K>fjDW+ko0dy!Qaf@a_kaaXiel z1dx=phiUIH>SHu!ypapjfn<2|fu#QYOuH6HhPN3=>V7M`{)W*ZAZZ)#0ZH39ZGurN zPXoGHNWT)Mn#O4GOA(}ViaX`h6D4WgidE= zDas~+&doN^57A?k+ISSGL%0qy?Gf}hzAtFcp^lY&-KgunEocGMQWD`&xgJ-hf+%#9 z15_<&=sM~&benWEnq9{*4N>T>E_Q{H=(IdWli1bGv>A*F*mWM$JdBFjRb^U$Q7OAF zW7-NvE7`T2X_P{l@>+JSXIc{@vSq0aDzVbX&5T;vwT)>VjJB|AC)4g^w2fWwX4-Z} z_ps{@rrpbEC%ZntwB3vzW!D7L_A%;a*Jqj5!{|kJJ;b!v81=I2J4{P5I?S&9O#7J8 z0J|PzngScw?GLCL^i1(ZT+&9eYc9KvW*U7hmwe;c)y1^&jPlrZ64Ts_X0U4k)98D< z4B5l3G=D+TR7L@IEoIs=Ml0BLCDY0oRkLd?)9M*Dv1^!VEsW?}ztmML)7ltyuUAHmqZbsYL^&Y0}V016L?qu2njCQl@qfARM+Q+WlOna7554*m|v_p(uW7l4$ zy~8NUu7{b{&*)=z9bnoqMoNaE$t)n5zd4L(&V$r5tx}e*qZy51*Ktg9F&fXVc}$zc zh-OX5kY_NBCJo9s=CP}XX~m3Gb`3C%W?M+V%h+`V(^fJnXV+?`(a4kZThFddObat= zVb>g8e_6^%M!AeeGaAE)rW{fnS;`DX1&rn~@-Ql9q%sOHDrK~c(F#T@8PN!kjJKLm zEu(ryO^m{fS{U8TsFhJ0qYg$}7;%czIZi;NC2dW}&pqjwl3869TS&*)=D1B{L_qG4p2A6blY7}4mPbj@Wnn$Z|W z;~3G5D(Pc9qdZ2F7`YkEU{t_p9wQHCtbT6Zwj2>XLo6)0;5{&jS>SpvTqaH>t zG8z~ud(x;h^f5*t{HUiY`==7Yn3Q@!g9qI;m(gf;1yFvB%b`rE!AuQ$#P9eZ=0`d7 z2~m>7|G%XphvHH)W#sH;fLee~T!IHX<*uf^xy5WpNg=+Qak+72>X+=FyAY!3i{7+K znSux9C%Ce3nZEYo$z!8X?~Gl%uEMq%S?*&qbM{plV(|( zz9xg>!rO&ODFTINT$+?`f#R`I>OrB|mnP39P|9tTpMpX&F-@MGpd@UR=RonCWaa4v zh300OzCHn^)kZl5$=PnBOaUdq6!EzUS>!s|8V;b$Xhx^W z(+Y~m#&bLQf_hD!dqAO@+N3-Vip%EfIikSkO`i8ap((Rw?8k^Q!pcLl`e-{Yljj0Z zXx^w9&TLR<_NYl&L_D^TSAjyaN==?HD6KZ0C@5q#xar#H1T44l{0tPDk!ptXTTph| zBzzbYnyG5?yaEc%S2Zc`fV!kRqwptx;3H-SPkWKEtsLCLl8`~no3IcxIl1Em*vVW#2$C^Vzi?R_(uy%1lQIJJ3M~(jzN~w3qk==b(*bVUf!q99_u;0h zVYs%*x(ByN7cIC*`&swjhVdbs*C;sK&${ zO^b^OSAvIRp`TRFjYBB(O`3klM4jhuokE(IzWyB)vN8He%6^^4q`WqS^2rcNt|1JE z^Nk^tD~C{45238LQ81|`*g#zn@pD1Kig06{@r<$nN=*};cwzjALch%%jzPI=2<1K- zg=Wz=R$0TrDKep8b66))I5;GXPMxq&2-2I2{26i48;6}Tf{a4^44zpw3QgWJIAppo zyVfF*h}}vMX(u05ws45jI)w6rAr$I8%by|7LqjOf457R|g!0J{N(Py>_!%KPhfpqL ziUO@p!IP+8rr-pWx*LM^>lIlASf0gJ`<7=>w8wwvJKw=s479ucc;l!9(U~$%SE#|6 z5qv(ALQ|w*PGw@fMVVMdA$rDga(1&4YG}eaLgAVznDG+|V^&VnlvxU$<|aMV;!p$} z_Ciz1%P=LXslH-;uzE`2>{&CWDZFB%3=0cZ*XhS)A)GHhN$-nf7YQ*BA%PI$I6li{ zu>b#*y|h#I(&w<1mC+iRvNB}SwAr()^XzQ%=qzm0r_CP1_GL%!S-sDmX7x^o^rg@C zvvL>AG`MYZ2dylH%p#_DTIcVbU|OEV_cR>XV6hjgXDb)tpv6aI%rj>d%uq}>JaYVE zI;80|dq)0rBXDxk?GuNFoan$mt6vCaeVk#F(>`g_%7=p`^z;m!{AuIkTuh%tYUP^E z2^e~Ipp~zH`A$5=)yiM!Hl(ynnYA$#7!0;Kw-%O}Zq~b~^!1aqLRPKK%x50k)L&~b z(`Fbk4Lf_-$~uEthn1J+UBBWtP4W-Ybhqd(y2?*Pas&aHaNVKpBEAh?_P|fK*J~SyR1G0 zX|5KhJj#fc)(3-4z7|BgCRDc8=meOvs?*MX5*jtm@smfD$+bp?g;F=eoMk-x*_5Kd z%6bmg%xfAgmG%E)2TSU$z|dH&$Ir3Bo2S(or*etIQpKTBQbo3-!}J6oW%h&1Y)TU~ zfuI=2vl$Pfc-eSOiqWSt1(#<{ec35f`7;Wp7r5w0r%cI?`9Zg$6p21+){s-CXqTL2 zc(1(~@5l7pi_7&-oH8W>N&DA2%qde8XB);NtUu2%r%cgzt3%^3!+wh7^x-D>EN{Ey z;z3dmV_d@e^C&}4neu>PlAczB*Q4MRCsf7OAH5~kgYQ}Bj(!kBoZ{padx4m{Ksk41 z;A|$38hyesuR46=hHuV`giGhGi@Y1q5;*83BiifmJ8<}gchDbAWbEn9@oIbUbiDYK z?i#P=IWGK161&tHjX*o-71k^VLi-fdyznQ<5 zU3B=Y5x@2>ef1*9nDq|TqxNBwpVBa~kYl{eoP6hB5-hvHwMvmX$#c5uTtMM6o zAov*R99x9lpq>gJXx)&dg#VELs&m)g=w3PuEE}8dJLE3NbFR;Vhur43`|cH<{9RcX z=0g5OE$0{5P9ee>9XKz90-h)WzBvC?Iz>VcI!krzQR7$TBrk<+6v)8Wy=llZ2Eo$a zcPWbEgu9Y$JlsJN80TzhC8gNI?jg!>pVswo9`4vUu2zOgXPw|=feT><-soVCbL-D@ z$m>}bgUgSyfejCLV$&rrc2joD%W$^84QD*uqIg=ty(vik3J0BA76RZ{ZBgHv@J_f8!2wY}rle7VlH=@%pV z{MxN!ypA##?M_X{%Bh*YLkKqq+xYc3x3)tOKJDXTEs`wJ{_fZIcll`MkJ9DC{+-wz zNn4Zf#unfRfzzns*`~%vx2k*I$~5A2wq-#<{;I2U{MtzYY||7U{e3k)u17yP2`Njy zjeYE~C8c9tmb3jOq0P*Bh`h_WX(Hk-F6?#QJ_EqH>&mRwqsYjs@!*Xv$Z=qkN*X*= zqPH9#G>?p;>{TKsJ9mXLw8&wHZ@@coU%)YljRcW{&xr8PLDr~Rk8=}!ky~fBJr$`0EoZ}7-qu?kS&`Ea_QH(0zQfKoI?5ps zTaze`MUtsa2%UH73sk+2jm}KH-U~-;sE>o&==?QGG-*f+xv*W{n6{_FKYiE*n!yi! zB0qOK+ae@7)f>i!YA7qtws~Z;D0H+5nNdhk3;TKlnwqP%jG?U&CxXWj8BnYCdnbPEjXsIi zx(h7b#dB)2oYCV@2h{M1f6rgD1DTQCq;e>)*SU3>)Us6h$zZdnyajHg@~uA;W&mBs zR$&WKktEtu%msGQuomMuK%~)3S8>M;S#n!^qkV@J^;6{mZ@ZyKu_+-11z%Jfc^{|Z zD|A9;^*$YB1J`2Op$uNOQA|`ngT2R4o?(B**q?3Vz7DwBb`lhVqWu;U`m|4r<&NN^ zdMOx4qsOf01Gd8N@S&wLrqP{8rNcjA7k zFy}1Ha^Chj0{3hGK$3mfr?TS#+J~==_Kr)PhkyF6b0oa?aoTK;g?kw%lccT}EFQ#X z$!?i%)Poc$qh1lrjWUBRIdux6LBU%Dtx>_dn~tZr4Gkmja_8Hrmjs$RM$uD^t}Bg# zNmp8`3Ze|BADSv=^ygq478z*wLp?s!4k?dFOB*Dm2qQaFXJa3BmIr1$OuAt5l&&Ev z$L6poitX|Y$YPlQXqc2vhLidpl8@Rt^>5UCpned>A;Zr@ex_c>j)o$Sp*!TU`lWf? z7Z*VUg#Fi15I;r`tPe`xjUu^5`i%S(e4S>`RrG&FLDH2?}ZPEnmc2 z30?{x`2bywBD)|}_Wev6RO$w}qoC}xX0nB!re2Ept<{F5w4}Z*bY=S2?dBh(glFJJ zM^GT%7Q`#kmAV)it=AOSftdOxo^@GvAfHN!6^;&^5u-L_D5?n|y1Vyy9z> z*h>>9)a_4pNwH@aJ0A>o(;;UhlI$LauMm5JCj@iyr&4kp({+^gtCW({_LRovv2->c z$(|Cjf0i6YvOm8Y**n;GNG9R=wD%!Cbyu9^!LMyGPdWDb*Pg=`qIh|OFyUgz+CSLS zo>=c>T^Z-bE;95L!x4Ym=x`Q8o05aet335?)MwBanREWDum=|vL|NfPmKtzf9 z2}d93eDhH=iGxz?>9?N>A&wdje=Qk-qG^-XC>`yPB0U@RrJ(HP^lKo{vduXw>D>l48u*e!f_OI!H?v7>Dn%+;b2Qy|2!5I@=G!o9K{dIX8_4z3_l@%Wnj2L6(pZZ);EHARI$doR^7X-oOD% zDMdNbU&k-RQ5Wd!jvSA!EDq6J6rXWg@x*7^aDdJm9ln>GZFFdK^z#hoR(f*;4`R=C zw$m~NJY0^~cAS~@xpNckc_-f7X_Eziym)*L+FS^JsP8(IBy`5nCFlOQ<8{2QQ@6W# z&KgAV9EFTMznxoYRUpSPH$9F8AgEE_p`2n25!}9pp7foR(f%G1nc;}siJI{d>Zv7H zQ@4@Yd+bV&Y>-`Bxa!9GCo_+A6|w4_?Hj2Y=)gZ&KOim0U&>}`!dF0hMi-$QX0iij zBDz>2oZ=3oX_xP%{8zmlP$-&HHK4hu4uWraJZg)r>ka)x2R;q|MVG4)vB+|%y{X%v z@Y%P|EI(hy`aNA>dY^{CMxP^fCG}9xQ;-^j2az|aPk>OdP{+iL@aWtrl1T_7 zg3#3}Ql5HTj|c_bnw-98WnkMaav;EdL`wnEp}i&DdUq(-NU9#NnaorLyr+#%(s0_T zsY}qsm-&xMv>0~8^_N+nJ9o{`n1>>805y7~3gf!-PFkD)P!0qYqQfZtI8c^q=kZXJ zD043-e}{7-@)H5t?A=x+D_{{SAg!XgBki@?tL8uGx)moLkh|c!hrnBSCAjJWoP|T`HfR4Hy);U8>6{vdjW&Y8ctQ%>(l<= zZ2O&XiX@Q5MpFk(nN1xIkoRAMDr(0v)-r^-%x}geD4~(4KeRejlEsO!oj4J`u@|zUc_hV8H?;m_J7^ z$uxgmzR<$*kwK<#2oMLCY-sjI|KZqBUmTzR5AVY?vrrT%U%ceF_xYqBUuW>a#L(I}bR7J$`BLSla9q`*|AQ*s+^tMKyK~ojRdfsjOUANk2r4q4kDf zOOxEU*1}C&ox1Yag&rqj!&JE`u^xD3AlR@vTvA)4VNC87dfmJEvYf~ zhqWYTNP0M&wA2`Slj$+JEUBSP!cXR_5!bLX(U!I{hnUTtrmq-I1QsG~LS`U)xj2Q$EzUe5p0edVNosi3>zX-wK#@ClY>o@X^&-WEgh<&l;|9K{GuGCb6HX( zbfoA>z&6IhY5wA+u+{2`dUnwxd!gC|J;ugJL$!+>O!4NpLf9RcwiFhLokXb0nB-X( z3=J1rM2e|9RW^n!;aTG}@{Kr#T7zL%C-P6GuufDIGJi3PW-=uElDG`66US$8m^v_J zmMOE;OO?gJwMB+H)-PM%6ck%A52>GoM!rPOh^zoBsTLGAzD@vC8j(;FHWP1*m}){U z&<@%46%DH+*kRt~FUF?Jm?~|pSHHmD5MEcFZVRX`Px!OWg%XijCQ4yuepOxF3B3vj zi+`GqR8iM}$=h|+mQcR3f6T?gq$K#H8Q5iPkn6uNEKB_4d0Lsf43%53A%rPzR*$ki zfZe5uWAP71s}IR&asSe}VrfB(M~i>ij#;88t6X0uY7vV^n$|Xi(c=C^;Srlmr%@pr z&)n+h?lOi*v)H}c61t)^SF95fmW8o>t7z42&SG}|38&qG)gqssk!G2*ha{i=r+4xE zPXs#$SC-O;|FZ=8oDofem@8=K0ZCUHUXo}QyRHI~p~TtsCyZ#1PZhT^BL!T1Iv3 z`eUZiN_Qy>egBXlPsd<_q|x4;5(R*y>k6jb#Aqv{pEBPgOnZh=54+N-FEZo{7)=6_ zaooVPTN!mS`U&&h$Fx31pEEiY%hY6e_ zr0W78slR%5y@^pP^Zk%%zhd-Tc72>_v_Ghf?OjG6FyBbLk4o2Bj4op|A4p2Il4%h} z-(lCSO#2<9Cm21)=n#+$Z|2#Cu8M)A1gja{#HbZW`uIN6e#Pjw?D`3i)O{A-l4pth z{W_z$jA-4r3~ve3Xg5;n;|6y9J&+7HZ>Tem!H-RMI79bhk-HiSZ^YvyJR#i^y-4%i8v~i4F>^h!ld5kD58M2#cGZ+=HE6FC~ z^)M=CSCwf2My2e!jA<(vtz_47rd2blW!HM9H8BdaYYWqEX4J~AZA|N6w1r(enRX|m zZR~nC)3!6Zhh29t?OsMZ+4TXY?Pl~SyC#^nk5Mtb2`#e07P6dx}x>je%!Tm)0v_#<6kKPu#Xh;G5$O>rm(G2HDM6vPwD=0K7 zY4RjMp|MGmLb*UAlqTg}P-x$KLEwP$H;$x(qxNk4=6NNYWjK?6q>bRhJ1v0a;-e0Aq0)2 zn!Y@s^umkjYcVJ^!fNu+J_t019J_3bC zd`(|xXF(pkPe@-w_pG3?;k^jh{QdX#tT6o>Xy~35w4TTQ8@gu&S*6d$Bv*t>l1PPP zG8McbKXGCPs4$@u?h!#>kLgDNWXQ!@SpFzTBA18mIZ!oZhXD-Kr0+ryTvOGwUWTHG zaOiNn#wsg?uuqR&@(^VeQ%Ig~<4Irt{$O##GQ}T7PeY|3rF$!y7(+aW3&{&c_%ROth^%3jTtdH)(LSx86 zEEcqn0ZoBQ!c%zdDUHnx9n`SIl|PFYyMC4BiNlZeSi>u@EvFx%LvsMh>M3n8`w(A7 zf+_kh9n-P|JT0HskIR+NA>Q->Lq%(vDjL$p+$>{3cD-72U>a7XTO*mqDjX(5tfGJ6 zaGy0qSfDP62=NR3Sw#LS!;#i#X4#|pD&8%zA(w_7JhjF!+aAM-yjVh&W5U)UM>(Wx z4Ye@eUO@zFn!?RfpryJpV=<^6B1MRk6U&T~8D(W>FzJhR<#JJ%%k^a|MrX~Q?gkrv zv|?9-^Ak%S9k>0k`{OiJSRnZ1F@^He#?_n5>v-`wH{S_I-otT(pmCtBKqa_nXB3} z=IljG)-6=yu^r&k&$5q4JMqvJ-H!j15LJtAlQ&84(do|n`sJM0y`7es&b(3*^MS3g zL`Dhb>&v_=y{lI3jcuY}5P3?C-6evLKSsf;@hf^U!81=Sd`XS3=nYR4bFS3bRhT=M zt7`M*ByvpqMm$SFds!{~j2I)Ysj*Eo?5oBf>!DlWKx9(iLSrUwtO%Z8R%1)Ys2b*J zl^VfFFNFi)^P(;N83?F9azKr#14)RY^kI>d)Snt#fJr8ki5Q4aK=%#Ntbm-5qVRP! z-qIU6ukR*`K>J+y#GK7MHJWs(g~!8HShy9-#Dtf~1&BWno*=f60ju9!6eR9>;!aXR zCA(rYKPK{TV9iB3!d^%Of2Htux~g4~qjq_8e{{wl`eO^BTGNR8ep%BQotxooyI06@0z>ywA=t~n<2VX)pBCDgV zBDdqEy=vi}h_i2{8k>(gM?8iX&qYOn#hh=dvGd4h>j+OE{;MX0KZq%a2nB)Qfebtg zlg;mpBhtPdj(T~Zw3BQi?OoYeX*7r@C3PGV)r5KL6+ccVq@+7fMSX6YiO=N&Yg!B1 zUqIDBHA9zAd)C=@6`E4*V6m2n{`FY2_xLIMo$Z%{c%twt9Mqt*htvrUPm&7$pc0BnZs>Kvp%VSurG?+R9#>Z%$f9f!KG}`Os*I;UM^l*Vuuft-6 zF=+>dHprZgB5nHWRtM6lR}&FRYG~OTlG$ri2;=8A^+(P~-3d-= zp9-7$oo$=Rn^|c@{+9o$8H%U}3Q%W>m1;KSMYh-;!{w$P80PDe|WC#xHOwi$GtX=yV}KxZjS!rc&Te z+-ZY}YT#1b@1S=Z;3-q4;!nPAO*LMqsuT=5Ouigr5!l&@1|VD)Ugp9yN`c`CKY8lB z7$Cxw4$K(R{qiCAl1-r(V5@UgrE5ZyoDe6sXQTt@vHfCjHO^}dHghno44j7iuSs$Gby*+moZC;&#+N-&*Bo--@uF#e0TTzwd3xHEkXKI5JizoDlSgpS#+^cHPMi>)rJf}xNR z7Ts;`wq35QTqgdXo-JdBEYUjLF2$9lbm0Fb0{xk3lTZ}t>qeFmV)T8WNrLukAeTV* zF?yC=uSTi(x^P_sL_OUs!MmhWR!E$=JqWSX#AOHOlp~Bj z2a@4APBHjy0Fv@;0Fpl9jJ^*fef%0IPsIBk&_sbUM;H>E0VE}$-N&T_Q-Nf7moq8? zlHvK8uN_E+TmgHLt_WVirxQh9O&=0SdLFCQk<3JvN@x@kBqE(h0w$&eVA*-%s?l^;yXsj~)8NTStuKW>2wClF7faJE{#zT}p521X* z6h)WkRB3#~4vGs;U-CV#M(^s-{9Vzh8SYbE+77Jtp2(Vta8+$tRi&M3ZW3wqXv{4p z4T`M~WBJP9#_qnh&W_O;vhtYU;*8*i>%dujdGYyi=#k?|B9@^^x|0?=!!oP^~ZcuvfYD=fOjANO;&U6`PY=f4O+bLtZS?8%!i$ ze*HpaV*L?c0r;*@=gYSXNPH^zYSZ|5y}e6~eQ!5np+WlCe0*}aq93F4JBdejuNY}jlCpN{CkJQ zZN-3!<;l*zGVy^XE*`^6)aXrl*tIZL^juaJVM&5`;scpyTvp%pVY#T#N2{fy; z!a508gp032aeNh#+W@49W_;D4(Ph)S@TdD3hTq)nMUI;3qhJX9-tnynDE|n)tf^us z@R=~Sq-cWX9;4vQVJS)j2JG=2qbMgbBX*^`{i(=gF>qOm&rU@U8{Az*ltYSTI77#_A%^>WHtKsfEvFunm}w)C(!$1)qxm`TGaTJrP_3TTst0Z6%vVEPA#LP z*p6Wi9K5?vLmx|xj|vze2}O!sq)ddbAQt-&d;d7wena8LyxsXvL93)v72mGpw}(}5 zGKOrO61g7(M}qaz6+FC z(MSyOZUd6$BR*aA=2$8WKProWzGEo9MC=b&qR4g%MHY3Kg|!1gP+{#9cln`;K2N0v z5A>B${U{@C&%n5_A0N+&Te}kB6m{s2Byou*G$%s8j6$MMWUxHw03W(KdjW(DYbjuC zTJdJG9Ygfu>jaH1)7O6Q^jS+rx~ z!MY=!`A#J>v=c(?!0tOw{b;Th+UeXn3pIs`{TepDuRQ&ux#S3P$^~ll$^>@hM9h6# z5PlI|9lFT4k#wo8V3YQ5l=qiq$!UeF5GZvHZ4=nZsV+K!5>iD7$}*}>rb{)n@)&k7 z9Mp9yzD|hvtY6jLRBXK6YW&7lvjV2lGKwn-Qn9Q&vbQ6t8*(;RRu#KvHaLFOnaE z^ejRsT2Hh)D|-Bxv$&`4cOpGTu@;i`z1H~{GJ3G@hvruo>wbG`{NIH|75;lK$x7A9 zg9PFw{ldQ*iwXzPd}8;kAHflGE67caUzUTn)xOiCR~DmA#TRYKgb4;Tfuj8dqm`|T z6&3Huq^Tbz{c7RUUgysekrA=w1BFZ7gney^$O3$aYeksR?hLJ{I9Z1bL~Zpe1f)`> z{Q_0mSBTwC#NK%W<_=Dlh$EX(u^JoxnfcG{flF*p_Dpz+8oys809hh(j6T2p6;aBn znOYS7rd@1iV2r+^p{3NTfAJW8Kt7?4`3;OjL1m<8keJ;7^$0DRUvvAS_OG@Z4^tIl zH2uOrkqOxUumsalG}<;o7m>ah9~Z1*;s#HFplJ?A#LNxY8`Y4o&%poX?OOn&s;;%q zK)|5j#Am6sm!lVIsDKF%Nfc`W2~KQ)C=bzUlOdTTBS~gD4+s=(Fo`l9)5iLu_u5?#by zPu`DLTkD6OWRjw9{m)~?$6lgdk933avGQ;+YO4NTNp;!Veh5LqWX<8tkiZM3&9D_t z7SBqO3$jY_+C10Fvczj8$x<|kr9;O$hv135e+<_A100)*Do!s?T0JV>8UPnw`LuMd zG7?d*-%UB@>a&pZMc~jCpK`vy%6XD>CB8hmC4LA|vbqbtg+p%&p1tioR0AxHm4U~p z4^i!@b?8HH`!~>r5Jvuy{)f;B4V2@j^?n{!*nt-)j7~^L#(^BtnIc_BX|L)}pq2vj zYq)z+ocKBo{v*4PomD8TBfF5F=P8i2r*t0@4`E+L3XbeDz3ulYknL@!V_x&SkL-d? zb;=Ah+^Y%bQORCG zvGw~3mv&wy=_Mjy)UU+Q6jz<7OSg#$v8T-qrT)141`>kcy;hgXrm^E z&(IUXi2jxG4j(*jfyZ*P7n2hg*wLPn7lcoGiDgKbK7ccDw&D-`3CF265>O@~Msd6PrIRF(c{SyjXTJtzIKGCn;{zf8dc|^(Q`U#1in9Wm!e`vrMnC78j@@wSsPY%Akt9Y@hcigwf;NRs}ITxhrDe+2SS=vwL_)CFN3QCF;Z3FT%a0Rp7@mt zB%uNs*hr~WK3_|e?o+K2Su-#w?SJ^9YZGRdLt#ABA$MOi}m^G;RW;XJ-W84O$Q00)-P76!ByzOLu81^zzH>uW93oY#% zxIq#19Ei4y!+X8MI~7h@;T~`M6zagBE~4{CN>KGH1AQ0wfxq#Qt#4-+Vm8r;E*qe_<#n}8;}PBYZZlrA5VdhFSJ`7NI!lV1HVTRImer(8gDu#`!v@4 zKg28J!eq2WFdYqTAhktpM`9-8S??CM2*Rp()bI#pgABoFhLqR_z9Q{2b-h7W8(xUj zDeXg64V5lO^g`)PLAr7|cyC*Zpy<38n&?K!4Ulw387lQqg0Tq*34*9~2R*K`ekyyn z)L$s62VddwIBNyTdI*o&ylrhrJ4S9aFu*`fkF|ewkMk!~u<|jI%mIzvRUx3FjNQ{( z03!Zlr~%DuEslyG`MAl>N9ud&+b`!Md2q3(jt9N%L6o}BH70au`O!E5;ZwxN9~Tas z3(jqnHl47nNt810NjN{otrf1;G@uveOs1VWl`=9JJqnVehgV}(=t?_&#`0y%`s8Pl zZSeMOc8>1JnnXECm-nROlvm8B*9-7wEP@9Xk-S-wzaljZlzK@y)fP1u(iNu9C4Bq= z*H1513PaL!>t{;OzzXEG-T$Sv2hL%vvmCdsZKYg5gq*fsY}BFQQW2BoGq(6$}k(uP`=QQ zcDAjVlKvljw(_k{Yxf&bvC!^q`?Zuxnu`B=+9+!e(3ihMghlYE1B zXYPOgf5vaEH$$r$=Ebq!;g#6em2Nn_zmuaeH{Ea$X#I^@mttAUd&~3G2s>`4>?uP} z!kvq%1vHhrqZKgU+QQN9eJ^`JnHJ)61(!d zF|%l2hf3M zxVP=uyAl+4*9UJKed~}q@mb#oSY>zAPs=`T>pMPcA%jZ_%NVh9@HvA7i>*|hx=&Bs zhn26_C9b#a3r_hS{Y+&rh}Xc+DI00Ukr#N9xA);Uih?Q%)}Xv?%09WZR!oPG94RV+ zq1_kBJsHLhj)7z|sqx42&=F42qlqkXrBwjPF&;nA$s8W7i)`R*U0yoMjs;!Z^U!>{ z@UZts7-Q~)|27mqjX!;ppFRJEt!qy7wZ7|FzlRn~6GLjPX6La9#fg~{u{49@CJ<2r zBH}qA#ia(Lv|jU3F>LH+kzH;zTvc(UXK@K7ry{4EQ;HK0y>06dd9g}u+o=$F@b`#g zA>wdMm?R<@2)tD-ts>QzaMSOD-dvV^;TT3#@_|IEFcpHD65(3_OUC zto0M=zw>;`GBlPahWh^x_%Uw#BG!u3DAxVx;J?dKTw^$ZI2<}$~$m8 zQQ{+&x=EXnX*jf^|6=3>7DKD>x@m_g{%2x~2EGeVR{Fr)UqGt??MDD(C#oK+{Y-H5 z`(d#i5w>rm`T(}uz@`^C5w;@Xp`L$&B0UxzeyKV>(uz->2{Z4sO7V{7h#jGIh15w9 z%}*U2nzy}>q;-+nz5-HGee^^++sESILl0laO(o9id~)S^;-W$ycUvp zw!aHz{@af{JPeV_VgGLM(0hZwLfiGt;xEHQLG!9Ae8+J7X}ca?NuG+@hqB!86GSBMFKCB0zCX6rdxD2+`sV??EfRsTr-X}nWY-P0GCOONSPQP;0 zh}gaS3qjuf*@~TJ%4|J5N$)3k%0_tB!dx#psR2kX_1`()MH7F1n+Zp}8cGs-R3%X# zTJUM%$K>bfJ<<)))7ykG{6c>T7EgH)iV{jOB^1IOY+zZ=%+kScZ8h!;bk_ zTcquZSYO0uAh_~$mIi&aKS<4EV`obcR)?ZCsp;{QH6R>(jg9nUGh>nS{g+anH1dR? z5IY93N%?_{p`&lJ`)Pd8=V`3odWp@on@RAF?~#P)tnr;>KjwHBUvoH~J@_?WA#^1Q zuyYt?UIeGTzQnFLPRij=*c&MGxx1h(WE8i`*THL8e)!8N!;WKL0w=2B%Xi1kU5KP? z4_R`df+#{}F)2}$qoG;>RGZ^`iMxp1$}ip{NBLz{E^F*5<5eh0==uC>JU<-f`?dZ` zQQq+YiHnMXJzX@<#QTJnn|a!Zr4RK(58Ty4w0pMrSGe;lw{_@PqLsc`U@-@OeI2dp zZI4B4gpXw@)B>h-sEUBKDG*e?bIpJUN-Bu-%E3eZ>S*odUkCZ2es$=Dapy9*%5-`G zU<21CN)Z$^s1HGN{7^Mn<#Hprbj(9(?DQo{H#+l{> z;WeK@=L2%Hw?E*bzhAI9QF^}$nPeaVmZL99mfjBu==(08Zi0N)Uy<<5LFF^{%kuIy z^7Li?Aj3I}zTplTt_D>K#(AuIHb7HUalMXRe}+UT2?pZmWziP;(o==g2AO3R0&w)F z)_C7k9|zP%#@NaIcOuQcj;~wi^K!acn8@`_795fkEL9<12_jI0!c&y60`A07`+u#! zZ_ zH)3fQRpg~3^NT#OT3}K$Sg;j;J8mW(B@2Xr>?R4#-!@bNSSID$djHTTar!Q)!g&%E z1Rnm{zm8thJo%v@+0`jj`%0>Ch}Ng7zcr;$`U}{s>!EWBQqNj&o^QZA)#h3|)jpM< zcgL;xOuOSUo#T)yk3J{jv`ptjAib!6hKJ61xH7{z51DrFrKTtKw{u5es@tdiPLE3-z@o!l zQoPf3yd=jkyCmUc&>j-Hs&Ic5g3zlq4^Mh$n81B_-hgj5dB81r`Y=x_06f=4{^S*oo%^yaYNyCl$4S^}?Na@Vp=QcHk~NAH&@Z+>NIRduzLa z>G?0XUkBcV=f$UDF9~oFo(oR{fLs-L4&u%MK8z>XEIk{z3(s3IeWtx^op^@Mgl$UT zFrM=FrK+*BRt?dJnzDNKkz0z zANnVx0k{j#t+?rXm_5)co2dW}aag z2*T!41IC2ROD-{k77ZI&Bf(X|GWBav^seO1rv@%W#qlUx_?CddCMB4eTN{i-VhNzO;a^aH&9&q^aR?<`gwP<23BD+t{Dx*BiPev zHil|~wZTBm6gpObwukU8TxL?6Q(ZfIL(vOj^<v1N3s zMDEJKnkgo7ZZd84%`-S0nCGvn!`@s-k8>14D7vPA8K>PkIMgCmA23}q5fd(pFC34A zL(xEOoC;Z4S&PKO@W@;?A1Uth=3fNrckIQLkb+UOx*?=C|N3z-0~zZ#^u`ElyD@U1 zIuKk%p`SyF{gr{naBNNPSE^&pQ@>_yqG*iPMJH!)CsSe#0f;7crod)sD^n)d6me39 z$G{ECV^-0-kM~INr?M!TnN?+leZWQ(Tai_bS2fYuUWid;VK{=A(J=TB2&seqC?78( zm7F$N*MnNEcji#Ls6i5|Rmtf_$aSXb8+(oQusrsE&;RgA^DAogrE3&g_|hxqqIKI%{Tvk_JMflptM%bf3J9*V zo=!+H7cIWn<&&GG#qV#Ry1mB4c|Jj^uFkxpwmYezX4<5@3ma;pMoozF53R@yt!~m4 zSQRnIN*=D$Tala2+Zp8`N971l zanoTD5p;cKIMjeX1+vtlZ&`u8CFe!CosgreWl>-V-CTnT5{-w$H~dA2{eXQ1#BluV09?oP}6i?%&diH+sRZXyb!zbRdfc_4J;{N zT)AlJlFCK%E6Wy^lrAq_j2%@Zv0X`Z0Ynil6G=?}Dja)5mBQJhMyb1*kNt1d)#y6G zZ5bQ=r$JU-8&&ube^ay;d5Of-MnaABMnLUqLiME-@TE56=*F4JUGEm69Y2)QwJ3Yn zrTlXSRjM4TE-19%qfFR&rBNL1_ODcNAS^ zXr&dt%D>}SI?(>nh$`{=TFKELCxOoLwmLrS1Ebfh)rDD6XMAS%&s{${GAsW$MCtDB zpfFBQ*%_(CnK_lNB2`RORd9q!Z3A@*m1=jH?HNd?HyU5j7({K*RorIL?rJNV(^bhG z3{|SlkT!c7a%mL!VBH8~M|=Rak<-Kpu*W#D-56;s!LT@nVR8+I%`-u^rRj>7x(|R6$wP)y5`_l z2zQpU3cO6AU*j*M-vWgd?LDE5z(|)}PXJ=qZvs^-zPo^^>0}wSS)xjzFJVke)iukQ z0TfVZF%XARC5X;np>8Y7Aaz-G-6m)U5XbfcP_5#79Vo8Qn?O|xjTveAJyXz^fH-8b zT*2x64iNk809vK|ZUf?Y_Xyet#PJ>is#bjOWLbPi1!bX1FkcSPw-n!{K%5(7hk_9; zepe~i-9W1qnujXH@zTl*qoqJB^Ibsf_Z4w{ThL#CINpzeSiVzHO*xJkRAE&d3xPP~ z<$~&f*l$A6b3iQBTf#Re=z25)_Ccq@aBO>kIF8=}`BiLh0Ig8yFi?d;WQT$!pi^NO zd4V{*Gk}=y3ZOdWqaKLkXb0jrehO5tT>lKztk4-~VpR&w2jY+y3!)QXI49#mYZH_J zVhMf-v_^%p6KJhM?+KrQrpzIa0^;ya6WY0g&I97`-Uni-u0eOeerpBAfS7MKIt6x} zFX-z)>}s7x3Ck|xdXu1AgzsITZ!4Lz(ebeKUjX8ezar>-AP#w+(5@78mAJMF?FWMH z7S~6GwoA|+aUG8p0giW)psxaPu3aUx8bLvE&CapP{0ty2^Z7s=-j#x`1q!S5?hx8< z1idP*bSez{Jyp;bfY|TXfw+cU1;nwf6uz~Bz5~QQ_5rbv30Tu$AG3hgDOu`)*mbqI zZU71@*GGX^mR*AO0CC7~0&(j(0>rH+>oluXoCd^x&lPkY5c{1fe8oU4K}gUoKpgU2 zKpgV@Kov@=UjT8)I|TIramddJ-|v7pt4601TS@~J=^vI)c?pAW<#UnJ;KAP%`y_?C)mji8|L zeFuo+eN0df5KHhT5KHhkAeMm4y08Q%0kH&U37P=J5=;VOK05JcnaV3V@rF?u5c917 zVhL^#*My+kgpba?VZPl!T>oAM(vkvcNrAMa7;0!qftD!=&Jr{MNJ}bwg+Ls~DnYG4 z9P$rad^GLcL<2Xdt1<7fH=JW7QXRVIb5m2J0FOBTr8*vD5hL*2jbZ7 z1LD{o17fM324cT22>LA$$M%}=%{a>nWiAkhvIK}jsRZIsngm6GIFvQQ_kAEPtyh3J zcmE8;e%}@J9uWH-@g`zYziheQ4#au-Qy|Wbtw0q@zCA!3-YbF*0ddHG5We@sbp%#&*~bY$%vUY6 zh@jQtdKcDsS%RMcu>_9-u>?DSIK1BoIsn8W9~8d##PyhaHavKom>B~Ut3>qPiJje2TqM!*t?Dqm7_8S)0?+9uWzP|x+$fM4+LOvfTpyCJu zH7FDZYEBbO63oMY7{!*D^@6{2^tT?;Y|XnQha~L-)|}O1rN>u zRp_fDtyxUd>1+us%Xk=l$#Uho5Urb0mT86eJfsgPSNt)`akGszMi`hIS1K9?rP?(| z5Teko=p3~x8m&gAxFQNo%M~<5T=RrBQ&54p&JkLXpb~NQ3611snJdI~iO?w3?0T)Z zRtb&ron2}E!0Bxe8s$5?#>BN*Xw>T1wMAUpgtkG@t>W4#v^xZC6xVx%wn@*y(F#&h4#9jK5>0ZX#IlT5!b^)dtcCyxPB}& z`T|&vUwqCNmqNDC#tNdZgX~KCfZ4}*L1&ArDYS`#a>bRtC9>ZU#kEUlj|ti;uG@vyEois6?iJcTLA~PolF$wcdR<&mRa9@r{nc_+ zbF%UG8imG+YmT7P#dW;U&K6{fD}d388&Tn+*376~p=q@^k)9lIeR2#d5+3zIl?jf& z|E{seFpZHMfWwvHPCTk`D;`Cn_SKDKjK&k4Ij%w6dGK%ZP-uOcGD7iu5x?ldR3C9s zE@%P}bKr~?kXrDA!eQFwpwM@GJFcriAx!|ACkzT1V6l0~oO+*2!ta4XIs>+^pMbK- z#Y1(2bP4QKJP!()ZLmZB9Vnz@VDr2U3SCs1!=>wFoj@$A49i37i*!+ra;_GEa@ZC7 zB2Xwd?AU4Dk@oM~62^$fMQH_v^dIcB-wO(9LD-b1K_OiToAP^5T3q?_E-0iUVe{lb z&>|Pl1W-tK!sfY@cusXvmVrXM25p&X|0-!#*uI)UA^i%QLMxqgonV+ce|`oE>0Q`7 zJ)qETFFWJ|ppZU>&GRn#a`Djl*QBRm^PHUpUoM{WK_UGOn}<$FBP|Y_;wK(7Tbn{> zXOl*UO}PscY5{gCo&tq5J#3zriGn29sdx(%MCI^BE4HK)LcSnAF0uzsnjv;LC7@Kf zQn45m(ipLM!l01eh)rn+g|tU(%Ke~_4v9_aCLR~%bx?X;G7o~1V>*425+t=jJ6$<| zhh03ALFshy6yO(Wq}Z{Sf>PjW?@K@-O%6NzAHLFUs*>Id+3K^e|2>tfi&^**y zIN@VSG+flvGG(%+P`}EQ%QS`fn6e^`Lg&s~7xVlmjj}C`@_ZWQKhh{i( zbDr^-S2)}9l=^+&Uv{i6KW5C~78LUZjC2bAc_0tq4oOv?iLTzlBl~^P`mwtxR z!%S_RSsUrKJ)|jQq$-FwL$MFqbgGc(DuhPo&@0JAoK_uzVpzT$x00oB6lX#u}b-k7RaaC$dNQb(TGddikt4lGXuZ)fv ziH`6y21vz#Mz7s6YIr&2D$L``pQbG4V49Ja&rF##&Rl#2%x7u*INb8AMguox2we+E znQy7MIoM~|X2F$Gk;UR{*AB%wr_brLKG%!OVN=|C(R@nR=B`=h$m7=mVFs3};jyffY1=R|d!B#hQ0 zR66LYs_{A7+&6LE3&p|>@w!UOBEKTKthKX0q*}#TLy>U|)p&Kqw34KYqO?z$g7d_2 zXz&`HRuz;*atM)D%`~GrSPC5kA7r42Rvo5SV7AUXV9KyX^TCTzWK?udTM>-{9`|Y? zz7)&s-Iz$tL3rIdJX(V+GOCK4XLnGbwA%PFR)U;YQ3i|fl)mu@tAv&;anW>*_%4{K ze#)OBpgbL?MMOG^QY{Ox!O<7lq-sBL`p7Ko&6|O|TP_>X*6qD>=bTFKox9rh$4+YP zpE}3my(Os}y}piFyJe9FY~CHqJTP~B$hY!P*w-7Nu!=4tw9vK~r;Y4=HI<9L_7yWGs$XtCPISn!@qe z1&iV_Jj_z6j7C}0Dt|+;#>8oD{zj0qm@a zMxpRZdmQ*$7=l)Lb-mtN0S_^=(Z9y5_d|7jMIg}RP`?h;Og7Nr1!HTJLV9f|-c(~; z8DPz6Xvjy`7>f{v+ESp@#G$4hj~Rq1qlZ$iJ_5NJfwSz|s{4_*2& z6o#S1+h{CO8v88IWr2qH${1y5C=i)?K|B~EfD}Ufrn*2wO|Z`NN9y7f7U$cNP@v8a zb@;l#>Oc_tWRTY(_-?2P1)6F|a^)Pw)|C2KplPyE9Huhz$B?Pf7(G!wF*6r=vjVF4 zr1*~VGyN79(IcUifu>6*8w-iEF0cw+B5H#KgslVh@rE$inrM%}ion`noiP{UL{?I8 z2%#YqhKH;C{s<%jODtg4MM9yNaan)^H^af}!$=_xKGB3I6-%Je?{A8P0%0U|kt0!c zf%-ta4s`-)sICvLT!D}|Hw;I_t3#0*ojj5lJE#IwQHlxEt^njI)##qhQ3I7YfXx^+ z=OJ4oJr4vfh+=m`FknzwLt+@EgqZN^D~O3rsn~@$)M)})bfU&2dJo>>~>8D z@AW;K%usc8JPe^7m0oQ@AyP@t11pdXs_scD1IX^Ml@JsoHj+_x_iSzqnEn-*JYkmu zCrQLYG}V5bIcV0r(elH1leC5fkS~PYF0Lf2ELsGSbQ8p3iB^MvOxSjZW{awVHo>VQ zVieh59f+Z3P`e0F!w49~amo_33>1#h`|tbL_debG`2Kbke(%5S-_X0Y_mSQwd%Miu zU*g}6-p6{oF6jN`{-pJT7<+%z`#63-zQ3jSDY$Gi5k?n&boFir@uvMPDm3uj(Ys^+ zdJtNBpEi4+fcw+ndVGIk|82cbnYq1B^*(OyZ%0U7`)`6HydoqO&M#FTM&eO$5Mvu5 zlEFlfH{nOC`U?^QCy%*Gz$YNVj@~T@dB+rR($nmH1Ty|ge1iHoQni(0CwIiu`w-k8 zC*hGE$Ut)8Pgn0YFoI_EZbBRsXUqQeoRFvXe}Df?I+;fAMkU?j$Tt~t`)@T>6t^hhP`bnn zkyK^T!c%HgPLbq~QBEOFN-f1p)nGkwaMF>_TumT9T-s2GEvl%tQ68%Lv=uT^ouYIh zGL=_$bwop}4K>t70>SEfqZEChe??&G1;z0wf!aWQ1743yo9cSDH^ivNHdQa9UYZF1 z>o}=2V9rGsg$_Gd7e^18driD960EJ&ow%ujKv%9V;>T+@8l~<&YF-wI^xRLqbS?Ti z^pLrrt?b#-gr3MmM}qxK=uN0+gj*C|^_!IZU~FA)`!q^|0TVA({Z_?xM)bA~fja%# zQO;NSu?K8z0I%xWp6%#9;lq9nk`Mn1ytDlATJ-)40`(EI1Wgt;LpNyj$>wL(1c|lpl18YlVK%YknCE1Ot(nfvHm+dS{e*#GKDnV=-1~BY~(f z7nNouHfS|rx20JhT;Vr*5|LFs4>YZbp&+Qx>E-kQ4YqutwQGCstwoR9^8mKxqLln~ z{+d;O8Y#|NRHTWAaLaBM?wph=T4d}wr(PLj7a5dhVHF1PbKet4Bw#1MRn1WSD z{jm^s8{*B?R1;l`aaGSlt0*uC8eQvOiRdBf!eCQ1Y6AkKAxLA-quA3)@|%s%JhBQ2 zMg=9&dhTru)ge5DjjD$#gjXHcfnRnfiH+e%9(IS+AjMy?&CO2wkMNLD$F;{5(ZJFVN4q z`ngm;tM#)*KR4^=bNczRep+YiStshzH*mU&^fRuX-__55*Uv5bN#CgHI;fv#X7TSl z{fz17dj0Iw&#n5|r=O;pQ5XhUG@|PP{oJdcS^E3gm-UmrqtZoRSLy1~PttFoYl?o7 zHUV9W^s`<+H|pnW`bp=&(nVkL=^{MW!m)bAL-{- z{p{DzA^r5~dD8^_oTi^8`svrtX8rt$el|7WU`8Vn#|~+uKF%^^`ddZwHeA*ES*xEx z{cO-r=Cc1PDmEdI4F+BK*Y`7NF($3uOkNN}=5& zXfqIHNS3l}!3aN=o22=%AoJLH&Xb3mOtcodJiJEhtCOctNJ1TtRt) z3Ir7i@(HRCv|Lb?pn5@JLCu0%1Z@!1DQKghO@cNH>Jqe7P`9AHf_eoV6x1iEU(jJe zLxSj2x6VI7IfBLuG6m%d$`e!|s7R1cP=%o7f~o}73knNr7StkWgP=}98wG6=v{_J> zpsj+s1??5oE9ju0K0*D04htF*M5;DA{{-a-8ZXEclq)DtP=TN#K|Vnhf|d(v5wt;2 zr=X33HVN7+h*~3cnXEI&i2l+N+DHRQ)2{TJT~8O+biF@W&8!BKT-NfQ$G~@Q{hky@ z4NN>K9rU{4SJj0;)I->ma!}}^S0nRKpVNn1h3s1Uq-aKZsOQr!4j{VH^<^kkZlRoO zo)k|eT}9`5r;^aq1?g#()4rT*o%EU<>7mt5_vO^7p;zQc5B1dgW$9oIX-ugZPKRZ! zgMWm9vcRy?B9X?y2K>;U$w?W&{uG53c0V*Y)xtF6N?Gx8P=jk>&O|M2>9u)<>FX{g zMe-5Qssqlb_)|wLgylL6Z^@XAwcc&w`m{CgnKNe1BtBmAMwP(zGxS>16iQ$7?m~f( zhAwR-r^{4#MU}JciJs~DJZs)nh?8`~Vl1Mnc|{r4yz3G1WA18cWLop~f$wZo&nIKRNDgDi_?T0hdh$qO<1C%;Mp)8j&?xy^%J2J>)bHq3KN-a^b@BnYCEN^ z@5l*@bP}h>m%JK>nPJ)dMeFoL9Ar4Mykjc0AsmI)hX<_Y!9?O@IucSFS8VTYp6YA8 z6c!4SBM0Av`<}~aAG)zewR6O6ow}z)D1qkl(2>|niJeNe1&M(Li9UT`Lz^?T8abik~e_{D#j;AUlFj!yYdT=oMurH_SnP zu#HEg(cAuS;Ld+eMWWK&<8Au|NWMfKEF_j}XdaU+EhtY!^GXscPcPX}ePUwXSe#e0 z9Y_7;;u}LfOg#d!`9XMqebqh9W&QUOx%CDZyBd>(;mhRGyu=6`7uPy8dR3V(xvU69 zM19)RKY~;+VA@R)>eJpF=e)r}BOHu$lYeYa5mp*E!8tkSrooq<#(`hQ246<54{K#{ zxn-%mB-vP$yskoJ*^9+wm3G1Q(!?I?pe;3or#wr`uEegbDjUh1`x}Va&bBffiq`gB zWNeA|iJr0!AC8nP?NY**lPz$nOJIl+!v?do?JeZ1$NNO-_S%v}Q&w%_o1<$J^G7s~ zLq@?CZ9C%Y`MDz7;4&C`pYou54dWGak(Wr_Jz z7>8gQ6Oao7)o}*d{X7$PKoO&N!;c_wF$_JT5WKf^;Ro`snI6?yH~Boh$NIK@K&1h5 zlBL^~07;Z`>+a>QbJw=QP;&~;;P14R@2!ab*x(LnUt3}7`q<#Z@*9zlAN;XhK3m~@ zZ18*HUY4Anx1f4Hs>=f8LIvl-KpB|8g7)G|US(Ar)EUy$Pp>musYVUV#vf(4cYq9a zQ!XH#22&}Ko=iPE(Pszl*5tJ>;s^$i=Hi{z#(Ple`=cl(h^Dh_v z&Q2)X#QhDGcw5%R>Mw!WAbsfd=?g!V4etZ?1nfrFYm?Zagm zk}XcIa9Nxj#(JZ+>Udw8bx*SX7;#vg)Rt_Sh=JcSP9FZ&n*%2l)l$fk)3T?aH-p&tQ#RiPJvIAq$#!ss0! z4&{9yk}S(O4Q0Zv>wq}CJAgR6M}R07vW!8XsS44qPL5+S5c_Qa;_#?FG5RYI`#1q* z%X}vbGJ#l@IY8`VCZwWKdX_=wxG|#67i9<9IzcUh+5~M7bgQ6FK>&JIg~&9@1{#l> zXId1;NaezaW?Jk@f0;%SF*3zFkUr~b#JpK>{8EEIFbnW#fUhw>&Pk3&00 zrQPF0lZjZno!~+j#W2#7?oMt?H4n9ck)Gv5O1rGRE|jyw z&5YwZ9GWBzH#2V0JQTqQYeri~zbMDKOz9w7zAVZkX_THc3iWJmUx(8uCvXH{qma{g z6yWnnb(qyoG|$=aq3VZ2i@%w)-yFY(*YZz$e>>DL^JeC&`M12aGmZyb9twvUU^tne z3!iZmqIGtywT84IgENfTvxZ~iP(-ELJJS_ktxh=m zCUR=VorN^e8Y^A&RwBOC)srI7*XgtZs*B=PXL-qbLuvkVIN(9g`=8H$PA2BQ#K_nf zb&fy*PWI9>O>1R?x&kbEXjA)LNMS#PuO>f(`%=y-kyVp195~KcI*C_8)U3)5n!drP z*|!~ZrxmnbJHh zTXk*00l>N*O=usy!k0W5bJ$!Y1?OsGDM^9gp_aQgVvbtcl^DWlV;{V|^P^FdKk`){ z@Oggg^IX@3Y?f#P5hlTZ#4o+$($inL`Tj0HPt*-zcGJ*aAFHQuv|Vh)yK5* zJ0e*J9Yp=SEnspCol_wqe9@OYNq&q~^7zmWQ2*@unn9pGw?H_pBmFGQ)@|L?ez3ad zZQn{DxqdSU`3Lr_x4yRfIv&{slCNVqj^25;EO9V?(qNrl`{Z@?yeG2}AeS4O**YBBgR@!C+IHb6qRWST$*+(1bzF@wUx@en61R{XDrtP0 zC$Dm#jrSrD-6haj!o+6hGMX;4gK;A)&5I#%RTk>mo;fYL81rDYJ>XMY!W?Tc#^OLMjTP!n8K@lYRZ#yYZOtXn$cdx`G^`sX z)4&dcI%w*cq@x9`Qm8&^YwJ_Bfo&S6K^2OvhpQJobf9XE>#sS?R@4K{Sc`&b`+U-> zoURRNYaJ(&YJMoPAPzM%s2?v{aXtJ*b0;f<*pnLK7Ps5#IT z0)=QVKW&-FGOiSK6%fgqrEDDXD%S1z%|8A`_#P7UOCa{~8=&)WXBlteFZ*~Kh~xOX zAnGjH$CrU}m5&)f?BgOJ_Cf1oT0S5x70_hm<4z#LuQfxfEHJwUw1^-CZQg=|K%eES6L2jWo3x(fT40>o=@^MKgzrEf;j1xZWbPUkG|aT=xP^RdKv1u5Sn$5Wasx z4Wuz{mazhRYI!~R4=X# zLJJF`7R@rJuk)$S(LNNW8mzdy{4msd80u`M>l_ffQ2$VLdYzAQgkn{`@HC8hxI0}u z)b_h^+dPztu#1OYP1LK|JZ+#Ut4+`~~HqU6d_qlk^z%S}eZJzT%q1f$ksIQ@3*5+9R$|m7SUuC5J*jjUi5V-#L zRvC98h3+eTm2rcc0l%Cx`O)}2($kE;G=FzrWJ{keUS+(Lf291SieXW7J zL)XVSIO4I3W94nuOl@hw8eOGx%+lM@UE?EX5VK~c53pSBdJDR1faYYla5@KI$-qN6 z7l)S89veDcv3kfOGr?zQPC7@j-r3s(-X^wn(@#$U1la$U|5IbosBeKDUQyE!97BDz%E}_cxvr2lMB(( z=MvhRc3h0l+SW9~&(H~r&cf4ML zFmiBbsqb|3Eu7w3*1L-^-8`#I}(j>sd6$l zz>UVayD2kq5g%GlH(~qosG5b5c8g6TGp5nUAUql&)981K4jT}7CjKrn7GwXy zGNTmp$i+q(zBez#?=t+Iuf9EFmYnsMPgoj{v2W^G@WW55l(JBp-8IZGXits@;l*H! zI*4{vhtPts6COawO|YpQLMXM0C(oFPnMWb+nV6eHe#~*l!tXrrG-CYg2mcyKDD zk5uI0o^D)-zxnt#8<@%l^%)~PkIJ){^4Ek=8yvae%nRcGo-qsj<>0MToRo`Uq>yB- z!-+UC@GORFKucVs(hx*y;)>ryT0+1PB|GH{ms%8aU=tcf3z2>k;a`THtsH0-Bqf3Oqf@#k6UANk$!RdgyhQY4Vc`7R?$7i_nZ z=F~=7n8B3|{CP${EhKu%)nZh2JLhTSTo1ncaZZKv$~5{RzOh(X>7T`%q&=Kz^h2Y# zSjv=+(vhmOPWk;-3ZDuuMQ5Gr`jiRi7YhM!k*G>Ohvo~>X>Zj=@U6Xwe(`B$MMhQ8 z1sQbP3v?bcCxus0bOGim&WlDk&EPvzzX&Khi*mqMn9jEWd}azCK57|wZ}^T?<*@E- zM=>cpTMFSo0N;MT=E+_ zw1_s({S`XRy&%P%WSf{Vz9QnprzeO+>iES)L$qpNd!N(ycM0wy2`*ZEUNMy>$7#4Re0q#zmxY^RXvBdOuM@s z!|D0ijIVaftnYS-KjMRSQ9iWyf7n6+v>(FvVakblMZRP+a^mLif;?yBs*C4jdE5U4 zjL&lT%U=eufdJpYs-W1=PqeM?W5iAh&7##!A61L+5wNzotaaT)(}+!kcN)$(zCeoi zGWnpKc&$9C+G6psS9~3dE1>(Y%@&nm4+g%DFRm!-z-MUsl}o>TiMgn7^D1Dc$d|lD z)uqH=k9D>nCQK+o9J#l>3i3gKPKN-A(vO`APcIS(1cIoPv+EknuH2WiEm>2+*jBY%uwfcUwaLfTV*Mk{bg*!+r;RYqrB* z%3t-NmH*(x7I6ELmrxhxYd;oS=&@8|e}T72v!e8sM5y`gVJ?4Qs8*YBoqq~;VuJ;3TOum|O(;?|Ex zuU?rfJs9)14tZC~CQPbEdNU_%DP8RNa>r=a;d zt_zo<0d+*NFJovMtpNBEACx2lF+{Q;aaj3Bx$h|rQy%Q0g+IMT2I*f@QW$tCdJ@=Q z+EaRvoFra~91$kt2g^HFW|ih2DNF2W{bbDQyz<21^2A?scnc6GWw>fkh%pgwMr87> zdvYRvP-mald&`}uNyx&1C-E$9-HnO&$0vH*OOf=!-?cvLY5nBH_AQM%9j#DW_5UIKD$DeV#Z8X@YTM-e9)ULKn0H-Ho66LZn%`Vb>24Po<@(gje} zI9a-H;5lqQ(eIx#NO5&5%H9~fyB6}FaW4JFG{qRaMg69aghtuW0vEv^x!_5dIV^{L$L|JP=fM8hBsj z{fCRZH=h9cA?jgx*-DEE13OhiFH)I+l#gqIC!KPg5AF=uiwza3e@CVjfS+=b)GUyJ zD%U6jGv?g);jz=vo?Ti^&^UqeO#G6TOF{_Gh!y(~4s;#HnaEEi0D>>F`h3f5TcVXZ zFr{!pI%VorF!(poI>FeJ^hm^;G7UF)fZdlaTg-Z7Chd?b_W5W_)AO+`Uown0(c)(8 z#4+vlp;!*D1AXJ0)?PPuyQCADj}9<-v+7EdEgPsT(8k80LD0exJm9s8SDO!+0y@IS zUMgsrP`aq@K)@C&T~E@xZ1Bz}$%NhD_b8Vg`DJOnAy44#Ndx&*o>+h)!<|?#q-rQ) z#C||kKXrdCdQ0ukC7$=T(aRLYe=}k)PV7acp|F(K#IuQm)P44O+m7HtFQLBp7;M;D z|2#${En6wR`~#%k#P5%77;_tw4;Lp6Zle`Q)PP)H$0a7b`Kq7wd4`m-igXFHI!f|B zX_<4vxY!p^@fBC=ZlBV}(&L+Fvrd3yZYS{`NAPBG;x(0O9sqPA3H^UYlG|DOO*wO+jy{%2CAC)J6K{d!uG2X`IiJ0zwkYwu(j=IwaNlixd-oz{;=dfT@%hgD&!!TO`$NB!Xbb^Xyt;O=ev5OnN-T!Ajg z8j6ul7S$94JB}===+IdS9#*GxykH0D-KXm#d~W&&1fo8F zfU2f7K7jvO|A2q$S_TfN=-U8QO)(Kh#V}zEoQt?>o&B@bKjxvrqTxfeF`39luuvYf zYANTpFPWszx=$hiy`tVabj;iKb4040d_1tmxH_4nAdbC~97SIUTKhc-1>(h4$A7x? z?XMlH$bNQ|dL6iEO3@VE>cI8bA#3-K)b&yCY~>eJ=sx^Njl2(1k`Wt9?KMk$RQeyFc8EL1%X_q97Yi1k-4M@#o=%ndIpZ7GNK=*vA^zSI>vRmJyP71Xgc{v z$?#+jLfQ5Se(o7{Hid|bg`?~mMH3Kj`(orFgyScw%r;`VOAG*80bu(joZAYji<3)e(q& z3|rCnVuyJz_E+0|QakCKVXOWSYCRnSR^CxvU!J@H)0aQ!R+F4pg$X|N)5E>K!d>3B zbHKHrBZLY4brqQM{&u6M!yCXO!vUHN+x@Gg8}bz)oE(J1&7FeqZmBp6lcfUhmZI^T6Nz;bb7^#f zP3SxpJUo9&UX@q816hMn?1xAXRx3vM5*69LJ(uNzi1mTX)IgInWgrHBh_%mM zO+|Y3`a-iAjdudrXdac?Y;4{mTwk>o`TBPXsDP|xjgI)Hvczx75-(v8^(1wc(phal ziW5B@MaM3o8n${VdgYEeCnH}}$~sC$j=qFuY^!Hs&`Fy=Vg5qaJg_jtJ@)$D6r0Xt zSN?X4+sjp_2=g)}e0gF(1+9w4<&Aa$q>MN7uwaK}G;iB`2;aK{%KXJ1*ye7dHSlet z5INNRTf03w-x%fT_3SM6?kGCe)*XMl{kdOJAFH}+Z#%se+0$*S!5DHt0g^u$q>6PQ3fTb`(yn5*g-RxJ`3^>MoWKQ8nu~o>0mmGO;^T()8 z)>{jLgq>Sc&klo{&V_5W_6q_Js&+U<;gd|B-)afO=&K|5ruOBzXFCq)7}NfRkzUVvhSQP<`M5U%=HdA-=sE5O-h^k(IJQI(#`D&bISrk7{utfg>%@cS zA|&t~;0ip);Z>LoS#t1ff_gWlDU9b)-1Ls63>f=G^bo{@=YzPH1N#zLla|Aoo+LN5 zNSe!ePx_xmY(s@aIsSc0z!+(~h2*`I12rJ8wv~dUQ2n{lM?I_Xr20Y6>v5a7X}>wF_dq)n28$#9 zrYOvAM{#aLK%G~y2BwU~TAqpRVD94};!P`?LaSjVyQwA|!X|Yywg$&lDEmLh*-2(a zqc?TYDGPKC#lofK5cnVSM}ACyE$m8*@aAfN6f&=948lTxje&FRrsw5fXyoVPIeog3 zKb^Lpk=_0X@(oVYNf{?Eub}eE=|;h{d}A3*V*8Ed70Qi>aGXJZD4@IoqX36i=l~`g zSK%Cr(CR4m?wN}#CdH>siqkf}3ujJUfdhC_9LdE&!mpWVI~y_VrJdnd058RTHSX(h z`*8wU zHr!9)-ie#q@N>9-gL^;jmvO&_`#*610rwwq58(bU+<(RW-?%@-{de4S>@>YP#^4@@ z`xM;ta{40fFXKK3_axktaZkmak9!twIN-ug*%RW4elFoug5(RawPEVzs@&_A8Ng0`n{%>_KhI2b$1xp`sWKIgx87p+agv+nuhOJ|z zmyG&Fnjy2altim1ciR4y#;qWS1kKd6z^cex1ukN&#@*lZiR1Ix6>|!5xTQ5f8)zHS^>E z%*AYj&b^iQIQfiv6luWeL8#wIAHRN#U|my)Oum{9SF{+;y{4K5G{>-+t1F}G@h2;Z ztTs)~x}pVYT#YGns_0xoM0dRRo?WEalAw;i!QlcmILW3OM-{Bm`Ei_dLajOCk5F5T z)#J#iTD;*^>eK;K*G`H~t3i`iRRhO+HUz2mnz`pqik@e#ikkGK6xvmXGOIS;&|u~| zY9VI=_-tWo;^Bs1HD0tdyr3LSsevr`(#3O2Di<#)Ub1wtnb$liub`osU*+_QuA!c` zylgI*DwkYYym0aS(km-Vue@^6m4+j~UAbJ3hEvH^OhrJuI9Bspy3%Tz95es5+=8L% za3$9?oV62D(n6Zs9v1=v5#N?`@%dDCiS$y&dyQ zp9+PRr$}!+%Xmi6K5_l6pg#e9Q}KNT6QoLo?gL^;{~M@E(Mpi(eueHA^d=DV{g5sV2%0LWL{PP$CPCi;;#A%)w0{@$sGwbfek2ma+;uX1qUYt6~0wKD-_=k zfT|UGQTPrC>I34CPr@pJPw|}t6jNvc5KBO3ov`b*Kyl^zQ=vTpL?eSNW1rCeEa(Uj zOOS)s$l;w0#NkZ`V%I`(rS*Jvy&Q;RTQ9C1;!0bT7@?qh~q65G#`jVNeGQjkYK(aiEEG04hVWx zTt}jZ)+rM71t1RjGNCOK^bK+S9#E~4k4|H#Q|M`+dWCv{ICozY^anwMKwQH<5ZW=I ztCio2@cv+_77AJn#8O=^v>OGritBwq9Ph(|o&@5M4*>;L964B+xn7|{Aoj6H(ABhT zqg?9+H3G2&F(3|a0}!X<9^w1BpvQsO$FG1mj=h3j09vWyco~RedrQz?f!MDn$MSn3 zP_y!Jy3o!6V!w21EF)S-X1^B;-(qpSMo^vbMTGA=f)YTSwtp4cLxOsMIJN_VUI*fM zj|lBVEQB$i7l>WY0OH&@SI`t7j;%mwl|bybNl+AsLumo3SGjRB5Qle{@a+)vYeD}3 z#D32`6{8yEcRmom-#UQ!{k9p1q&01nm;OkA!dZ=~j4W2s#Uh!<#C!VnOr8_1i#=O46Ie^&X(LiuSP3wgGYf zw+pCAxxOi`ZwvYWh~sU*DlO-D1c>usjnHltbRSSih1VstX9XP)bP$O1&vT|>d|UZ2 zftDzAfuNZ{EWunLmY`G61H$*1pdCQ$BO5Ep9P(Ts4!J_mRY1(QTWALay(+GS<1N3J z3%Ux3{oVk?ePWlmZWpvu_znr}T|w`O>%=cwX`2NUR(Vh^v?YStfxe|&e=M}03If3H zHL9njf*uz{TFdM@Nl>XEvPsLXWaEd?Q+N+DLLf#7ZniGNC>y^oS2Vm_v@1FRjZks4 zD-x+`XA3gLb)wL61x*pxJfY1LR3NT%gjOVoWMiqQuCS!#f-1z7Y6H727euw1{ZjbrkYn#wE2)b2VJB43ci7ju%AQ66}}ekL)^8P_DR={yw|r37RRc^lge==LjkiSNdAT zu0BEK;#wiJC4%Ui7E5)l(5eL0h%1t>S|hhXYL{$@phBUs;+iAqbRc#eFSN4-nc_N8 zXt{!>h-;qEW(q10*EvEf5=80eczr@E7ep@XxR?G?07P_Lku1RWIg zx}ZKmZwcxb^p2pzg5DQ2BY<5<$xaT`QrB^K@Eb!f?|T21+5d* zBB)K!20^z9>J)T`ppAm=5wuCr{em_NdQec8pvMGl6|`MYx1imE_6pi3s8`TSf({CL zT~ME(w*>VIdPmSY%{H2RDf~Pe@$d_50}>Eih#e$l(e4tX@{ zO_7V|JW%Gkcq%{%yLhTWp*N5n&W)gSx_E8}WtoeIT3DBhXAdadF3RsgslrMW{_C87 z7nBwhf}N{JL8*r?Dj6=F(RffQY|1GFvz)#rfkNwOcE~e9p_O$zRkbGqW-p&cgpuO(~) zg}zqUA>Rf{uPdK7fkL|dwy$4+V!C4g6)2?9WQX%2DCEWV^`D@SrW5gSZu||DBIJh6 zsil7&b)G&VV7ktZd|sef_^#XKZ$bL7_Pri02wN6Mh{+ zD(J#OJi@tN;nY8GYaTQ)@c2@l)$flqkIE5G188m&BW$XQy{c07Y(NEFl@`{CBnU1P zBI42}HWbDFbB5*_3li6#^EHL)JX7Xs3Y891t^}n@*A1prY90!iDQnXxccxJuNuxZI zM)`djWhjj@hO$#%9J|tNa#8Zrc)p%SX-K2ooJO(EV5h)2F4B&&E~flCjq-LH!}!h~tJQ244}E{( z%c4ByqEx5Z*Cg(jTs-)KpK{(VDAkQ&9k9sbJTaBiHIk~fzD5|Q;Fszb9B2J}_OpMq zakpuaKy5e{nTBBz@~KkmZdsP$ELZxly;2;lArz?tu<{1JR!3vV zRg-Cc_b+C-P>2*ZOx#1E3t#7(YJ+u%DOw!~hM}h6V)_SND_5+kT;*?w+tE`@97vqi zr7{GsU0BH3!a#ZonY~sw_=Am=>ZqYwC=7{@6gmf3AkL8h%+5yx89b)Bu-8KIO0r0N zmHvhp2uc~oDy`udI3TEYT8!1o^nE>o$UxHE`Qj9zvlDbR$Vk*ari-IxxRtApkW-a9 zY)h)M3#ZRyoeAxge<-akhK+H&AB{}vDUMKP7usngnYD%q*KJ!H%i*H{wxd$oN#>SN zopN}SBaFfsI7h3AI}>C@Q#1zcqVTkt2J{5=iP+N$XJ1$_Loz~XD=O2eR*4)(U&R^I zOgoI>edyw_S(Oq_5Slrt%JHUHYJwqyvtw|?S1{eKxa1#JVQb?!U9=MEnT`77_*npD zVWsp^8*FHR+L@Iwr=pOPJ@3Mdx-brw3kwT5M5RXKaF~t!rb7C3JshW}nRfNetnA}t zh6OOh5Uiy7hB;&?7HSGsD?`FYJv7OpoRNVD+G8+=%qX07p?1KF=UeeWQ}r4}Ezs0h zuzICZ7z#%fefH<-*111-*Hfz>Pbo~R7%W{bl`88Mz$QOSo1ol1F9N+fyxJB+OOBMJ z*r`0=UlqvgRDymiHjLY4f!H!u>nv@ytQLc?I1rl$^P`9;)U?1KU8y61OR#p0_E6ST z8?wC2Q%$ZcRNAaL5w2~0lqH<+)bq7Gf^X3(OIZ=7m2pgp4xs|dt(o;8HA5zY#~f3- z4QDp=To$rbDl4G-sspNA5vW6Ft@L2gad8-Bs4YY8Z>v|kY z+{18))+xJd+u@=&=g_%Jsle`9exg;M6&Yq{Kh36M{`46$VU8A;ed67+uRw=hjj_^g zDt2P#IR*2aa$3&E^;6s?Y!NzVUdkcEpCY58dz#|}PGV`vz}I4=+f>X$oZC-zGb@{g z>S#xsZi4R}e9_)}F4KH?D83ZihP1z7EM~tOCovzqfDg6}=~IK_Dgqv>(`u2Cjv{49 zsKmSFiqg`y1I3B`u>$O84`VLmOJ-km#i-Z?#jS69e68KtFtT^x@{ZGc2XPQO_SAJ} zmlTwZiskqUd*kn_K-gA~_le>WWr=LDUBM>)S~eiW4I}cqd+^_73$10_cOj0aJb6WP z?6k7v+E!MDniH*El^3sRT^W*`*6biu`}}E>MQ(x{7=5*_sB&@ zs<~Do4GC;U0LRWS5ehQ< zpL|F>g@_A~+!Sn82BLakWPrBR6G?5*#g@@}O!&!El#+C?JH-~1EB|4ag``DBlw+rI z^7Q?_#7^%M*NiAHe7?+k*=w-Zq5@Hyths#L<%f!#psGe2K$EwrYMj`4dGhpMb09qk z}=+ zB+%+iJ5$cU1Ol{BeW?UfVyYssohjkcI$>to91jQU3w@~vX?g+D7LryG z)1pwoOF+;Zrb4(_LV@Q0`>lP>nRAj9{eR!{Jm+%m6VV5;0&#+fU7IWWMnwO$bPMc7K zwPK@gyq*9)7;j5ww65C|$SjZQC5+!m90r*%a?@Er%XLbRulsrJbMf3r`ozMu;wvG$ zv!w3(EVz6@!gR8BJ=p+1hj5)>tmPGo4k|NJRgL2CJ^4EfdV@RYr12W?DdYl5>w1!Q z&p(AXHW_W9v}KJr7~m)Zz8_Et&*TatgOw;hC3qb%hYYZLay+T&rrOtlhn>=%_)vA4Y<&MF_p2t?zi*R%-$~<*5A7+Rt4^B>-@nZgP-hG?^S*74hmSt{ zc&)308^tX8)`PDm)JTsI8op;u)K>Q*32VQ@z;`^?(_V3)gXmYTv+am6z=7Xe(*9 zqJa)JpD@r?a|dCJpzciAh1Qh!5Cey<^BU11I2&2H5Xor&QK=tPMJFj*m0>1hUXzyN z3vBeY0%pL?f^<$f(%ZG%Cy^e{kF1;#wJrgr9@4Elwjoisl24SI=aG9Mm!KQ%@JO>g z{f~sXmY|5|UgWeVOv|0%1i;XK6}*rt5Ewi1d*!uMEti9z33z(c#4AlA2#r>xx%6bD ziX_{9M51DZrTpFt#}q<8q;5tTI|}z;CwhO>IT7P>Q77!-0a3?(gFcst5w?vG#xcrE z<3eB20jxxUoAM#mJ#K-{!xvaBz0aW6uJ5oSMS?331J2QedOC!Y^S3iqrOUQWY!&82 z(OY-C;vWz#0yVJ@#KeoSvK!>W24ML{WCKBmt-%p3wyK2j*vQij`G07+E+oPy4qCxmsGdtXt7F2PV)6$GO1ju8QuD$lQiE;TF4|FNkdLjy_eL)q%)9I4wU0qKj~&} zliPD$BE{^lV!fjzQM&MGkxQh~iI545!Q~SBy$0!$RUGpc3$*!~a|?JqEPMk^5dH1X zqoi8Xv!|oF)JKaoP`}0<-k2JSy_UA=WX)Z_qtAox3+4b(HJaG+Eg;{&^bOmwpQOU& zTXpMJ>Lnx$oF0A$_tG1aMz3^9Ri-ND?5@FRz{#hk@dxHNWK0tFk(CLR0*iJAJAttQ z9q4&8>`_kfZ@V|>E6&HSplSGB!#m)Z*#+xIs>)FX*n=DilNn#n;H3yAt!wYCJ&?3! z)0t)Atd=zivjO9MUAhBy7lc!Sa4fIosHc!H7KPwyx<0*LTUCkQ#vAafwn6#l(w96Z zi?rm~!IuDHaL<1*7u@SI>{yg=yq*63m?$kLOL*d<4d4>UyGJ|cO+&C6LF~ySA&mL} zSSEbIZ=hMn6yxHV2u4(JmbU2*9l@5UaYYPeYY@gM32saaD6Or^;}gFps^18~8~#q# z+c)oIj2u4eu4r^l8pg9pV~-3v+PkU~^`NPJvMcNuy!Z_cOUsGZL*q37LNXE>t6#^E z!T&!84|*F$s@Q99yHLKk$Q{9J5!ja`n+5Pfb`B`e01v4Ap=LPZ&aikqT>})z5Cwu6 zw!$~th%{YT!@5v9WY-~1ei2>lkKq^S15-H$n?8BB-i;6YT6}otZ{WXjlHz=_oxs2H z|1)O-Ul1PcH;8#h`vmgm_lH&4FL?fe96vwTjpyfwetVqP!2EEc#{ z4Hxfz;i3UvA0V3MU$GpXCWrrqP%LpZu2K}HEK5?cK`OrbGIcpWHUYjemZsc=;bgu%b$#2YC{zmc zfhvQeO%N+8G&lnav~#$;ZYG6oPIDg4IlrTH4MQCC`VQpx{SF|wKaUz+pg-uhJCf^{ zsv9O};!eB#w9DzFMJ`&oRCp}U&KXhT2xeUx88j9HH#N3`ru|0zX~ctt6=}t^wI%aJSii0 z*KSt%R`Jc(G`EhUeS!@_rL)y#@F9fdeD#vWSL5!?Rf8y|D}X5V7`L3L$N1Y3Z5V$C zRC&zU_!=Ef`#wDle_@1G`K5l%j6e>RzWDm9K~lzg(QwNnoes^$$>5cDR_N#~PXEPk z*yuENg!>f#xbN|g`w;)QKgu`uO#bya-x=py#i~7<;Wj6NdmaC{hw(3r{gHp%Kl#T! zm4Do?`N#b;@aM#5oXG#Tej;j7A9V{$Lk(VtPXL@LaXY-Yk6~OY?n;EtmQ?CYtI$^v zib&l5A{3R-0WVYwSgEqqMpmK42%RVSZbnGe!nY+==$iYU5X4h@MYXYql3R?1kR*QcuF%s9I(qbiUMlh8OpF zFSHaP)#numsn&8{=q`j*YkLq<^}U3UDlz2cd&>(^6I7LmBcw`v79mw)F+!@1FMFYt z2&obY+@Gov3lUN!mLa4{eBBG>5K<+6;>F$Xg*JJqGr(}F`sni^79!^S0HL^qc6g!F zq4B5k(U*hD_XRI*sTaz7p*s*#{ksn#)xRxX=n;fe|7QWAf(DZ?Zy2Cp?OmFbuaE+gj9XUK=oGDa=I7# zoEKV!kiwjAdU1Clr0V-2LaKlFd8s{K+;6?Ozj$%`y|_bO+)-299-M-Zs_$c7+$=9H z;l=%j7uV{=-Q>ls_Ts+n#r?#K>-ORv^Wx}DLbW^K#l7yuz2n7IK)9sx9gmQLTD2E9 z*9%?hg_d~v+P%;Ugwz~SSfy&Y%M1O)3;oQ?_W(j_79R6bpFl|A!5_Rh+Y7ydkZOZI zDOA2mpyjHy6TQ%f5K{T7y|_;yL}6@cD2k9Ot9z+ed7*0%Qf2ASLiO*vUh4lMbb-|J zrWZF^!?9lC!U(Cpoau#TBBbi0$BHv0AH7qkeCrTONZgMQx==!YL+Bz2y^T;(LhCAB zdb%AUm2V$HXG-cZ*vC|T$0HPxxQ}>oXL+GnUh21z=hKo8AEA%qU)igw5C{lfYGoXd z#7RYCPH3u^I?ana*$aie)ahPawHNw?ms;b+&GbTbUMg3y>Py56k$$OO5!x!1&{3gA zFLk~b$8)nvy~;~%^5PbIp;j;TD_&fi7b5$p+HLpZZt+4HFE!`Ib$X%Oywo*b+?`%% zotOGOFK)dTy4OqH;Klvi3vKjLAMoP3z0fu=qq4i#9gBRN9g}S{^j~CkIh5EhFJ})%j zg@(M)uooKpQhiWItr;WZ9|(i|m4w2uOL2aT`kIN~P575Ql9t40TOejJeq{nNEAWeR zQY>{BA}GZw#t_f=2X;^X;msDIfk2*T5knbQvDDuXLp2=?)+zN*gff9V$Dod$K+H_U zkk2pHL(4|0qZI487%?F1zC714CXnYA)`OU0J*yEzPQMuQ9mMnmO8pcuJQWo4P)NHz zkY_hy!stvf&mdwlfjn;^hS*iiQ-M)(2*pvHjF?Cu=HrNA&BZ+DA!Z;@bAqM7_Y`Yh zgcx3D7EAGDz%x`a53ebC_fpKW3NgICDaNct3{OhMQa?jX&?=8}MG0Xs&j4b=fgZk! z7@pXQdCD-KkwBiQh~a5W;rN7cL#>Aw? z#28~@zURfz9%-yy6HelzY@e>X_PXXaPcq|LG3^M{(>%TvQy|ZEq`=A1Dx7mkT(4aD4pUyiNDO*h@-6VX6M5i}nvngA&|1?4y@lWPFv$S)2P zPhZTQRO4zoV-5&pJhf%md@T1wG0LuIOkb8c8I)Mc`7z2sM)gM7O!>?Z>gwv9{KWzI zjiic$JFFd*$|CZpK*ckiiVrIR^XG=scU6xVlBi%n^yJG-LmrjGC%p2f*Scdmtnka9 zyT;2sO4Q`fgm>8eKLIuW&za{0ex7@lSP`i{7KMqv66cx=1zt}KF>OA>^ceBe7vve0+j!+b!-VR z+9lVuQCQvxv1=4kS4cyPkwt3^_TyjM)NbmOIKIq3CFL@sefD^g?~@ zVghX0)k?M;a$NMLzX~%*pY&GQ_BfD*#b8m)OPDT!c^$5)-27*reRkOY=UN@qeJUKT zkp%TwTT^q+IWRYb9hPcH3^NiI@tJKc!oTqgq;-X}e+nqWqYnLRAU0T=f1}nL{+`CPuX#(<=)xmP%II8(2>vyGJ zcFhwaq4BH}bThIL|8>xhNNKw9>&>{HAHhS%)Vm$69j~kzBA1CN18(<&+UMD~N76^= z=A4MBw?Sow1JRpz>q~ZbGE}ll&(?)fb<~`_$T~TqZ~tqlUh<@FUWCk-j_BEg@7*wU z1WKiSbKBSj(KVuyyL7+sI<@ph3I()U)YixAmvr6%Eu;%0&{XY7ox|EMu}U)+W^dWv z9!iCEs}wEaHLQ{yddE$z5AMO0z)`5WZ%!*4QI+qMx?%0$YTrURTgrnQ9$Q)@z+*Y|OY*cAo^`cDqkgr-n4{jxtYqFr z8TwpTHxc?AfC^uM_RTNr%VdzXu$oV1`Cg)SD+?o0GN@|6mrG%35`h^+ zt7u;)%@4$ko(Aipkwo_G_ip$|()?_>_p9m>Yf9!4^R{2JIly&tw0;k4RGO< za5(*lXoD8}=UGqG_-6(Rkuo`7rZTZ^JP8H&|J1X$?7{q8TAZIDy`x>`Cv~=NCh&M* zM1Da5<#QYnR&a<<40BXCJ`Un%$oPDdV2QkM)r}`#M+&bgY%U@-bMSKZp`)Bv# zamJrd&!8f9FJU}oG=z2YvIw54-01cTINcYgC<2x^izl_ECz*5FjCfdYUJ=%p^a)~H zAO^(mK0W)HkfTRwvW7*E>wUe%GQ39FjS4gP-;wFQjoA}Wp)}6HoZC7O*wqGu?oM}f zGlv@OCe2Hjcdfyf)^+k(>J@e4dE?oUeyRY`cq^KH53lo50Fqr1#ug<6-D$O&^=@!^~IJh)?#2PtxOo!_|bDPQ9-o z?e-H8mpud(-wPU}#y_=u9~KIp^X#tOt3W56CiHaT3!#BPJJ0}0e_sxG{F~6*a zg#ptKr^)s2+r@9A3bkS$3D8%e@1AZm41AL2e`e4b(8pU1d?(D$MH1N^ZAt69oS}p{ zLB~VT&@p@OhEFBTxuv9yAH)0|mD|1Y)Yy5U)E8)YfXz#X?b;Mrm*H3JyvRuELLD2` zYtiiX5>yA;va>pxeLI}K4+PXt<3J1sI1v1kR@R*5(n{)8f>zdHyJ%?MeUVja=+=~? zEkK0t3Z^vEkOeFGK%}up@rqJr4usSp#?^=l)GeeFy6G`!odm2w{(lFL%6}UkvTKb4 z4+>w#hexq)KRmpb3*&f4&|DhPtb)*TW;BhUUG%h5rOD^m=w7 zktX6orH2d5tdQZh!w$aKf(-t9F1_~lyD*gPv1>I6839YvDuK++aS#}jEL`dnWXwKV zdq6i!Uy}~#mj0%bU2EcA`Bc=V7+$Xb1Z`dasu6_Ui1RaQcCSdC};(;$@KZSnbnMCrb$Q8YU3x zG1!<|iDk^IHy=;~v`Uu?A7>^fwvANvW9l)B$N08?VGmz(?J1Oj85O~?mZc*1K~KRN z)devyd)RO7<+ldR?uVAV;tz=0-~^0@N+>mh2bc#Qpi*y+S0S%<;8Z{~C!q$dYw9%CQjS`_Dp{sZ%k91KM^5F_xbNP9ijd^XjW*M_InYg* z3nEy9>(MK(HD$h6Ezlj^uH7ixWyH1aamq*j?ebTQTfXhzE??`Ge=fVCazg5KeMx+y z%$viznXw~;B345Eym%U!Fw!q7)O`BAs6xF}5bbYjKe!SE(5Lkdbi_%d#fbkxw>mO} zq4Bidv7H2I=kQ^l8opAbBux%er5;g)`)q3PEUbv811e3v+RqM^q=}Sg9S1~*m z9R}8sQ~>L|QebKSBZilydB`)9liGmVv$;Ty_n@VWRTO`--y;xL5QTRaEAw9b9ZeuM z`_2!e=39rEpS!Ve1GqSX6JZ3D-fVA6Rj4)BH!p(Thca7vpe#vG&W^w;;714}`$BFC zUcQCQCx(kyTOb~~xiy0rWpSc)!2;8oa+le`%fo!n%A+tRhWvm5hf_d3NsR66G*$)v z$}v{P+Qqq%CUH^?paWQe@trRatpM3@Nyo5zVl4a&oFKZ0-Ey~<;{qP3qDdUeepc_B z*Te?wdc+#r)i~wtWH5&FAW3i@P<9A;g;=tXHj&4w#^iae*mF=r5x(B!jQbAr04B>l z*;dv$NFz^Wd;4*aelK+CchbBj0$cv5@s!r}Y|MyngHg&ZoD+cLgVKA@y!`b7^7t+s z1`oyR+Df%mw;|>tYyL0rtT$v86Bkw{n_tzz&sZn-Uu4C80eU|3(S&(BNjoP}IY&tJ ztzrcK0F7m(@!Wy*7ag|%y!&z?T?0tVB;4Xr=Z0OdePSFAo38a`eno(mI*5@Lb zQKvt_pX{SSR=;Hpy8eVzA-!&}rYfVnTiGFHdJ^xvUsiW5%s!r?bq61}P8tU>DbgW4 zDz8txyi)7Ba6-cTFP59rIpsW=6wnx{YHWh$&r2__UI5oczjJZHhS~s`HYhMIeeFkJSX`P(`Bc3$g0k@YuAAnygmGUX> zEo=rcS$x*+j^|%YCCLoRYHToUSi>sHm-298ZaIj&c~Rxa8WznCzp3SpXS3NygWHnq zN12HPWaQ;9ZAKxit$sadg%tKNvRbE@alU{G|YJH2W@0dN-kdpI`|!Q0vfz zIL9WnC`d0uF;70FbuBN=9>V5^`d9xA0QXhnbf$?_VFEdMUR9vsUHIRrXWQEWoeeU3 zGT@{sGt)qDe~ZxoMrS9AM`a=8S0K)Q6(9cbuzeYmq<++oZ}D!e>*7-2Wg`~m-qaV8 zrd|oDSk#Py9a=drVb*f1gRCZLUDaC+YFUb0Gk|!N=jjtt&G1t~X9HX%4*MHs{6)h4 zDo*at>D^Iq#fj|p%6MIW`o~66CZWb1HxAKOS)&U?N_@OIv44e~T)1)f33-r9P}B*S z0vgyj1%3Qn1BSDFf>dBbCNdJ;hPeybH=>@v%kq(E_hckszlvb&zc!xii%qW^1U;?Y zi%<=c;LHS#F@Wzdzok~}91}Y~e;Lp%!lQ*ixk#^r@?YHmP2HY^d=h=djHPM-tAshV zpBuvT_w!@o(r-t2=i!rgehH)3pS>)edk$<&$}bk5Nw+Ri4D<8}H9Za1{5|E;(}Z~p z+ny9V?{j6T<1r=W4fVfH+mhcsEoqzPOh_6#VWXL>@6ok+K?f=7K;`ytL3BPj0OKVv zePOJ4oD15?;(?6CPz9R$IJQiko59RDKo`SKsS}pEu?K!YYF`wXA~M3rlB?@t#(?Sv z7))5_u}a7I&&^bL1`=AvpFgj0`KO85zBL7eSdT-JEY0XP@C87TijUx1wPVtc11a~# zderDKdNSvMi`tnwJz?}X8IYLY>vmGheF;m&zR9;j1^NYn`c$A>{SGbHr+!vBKdDiL)Z?9>lS$lQv>M&aTM*r} z_yr5dk*XmCNCtk*@|)rtTlnK;{Aigyxm3#yAS8g$Hch!4{%_Fr7RpQ=$%(GF=-x=$PTIn){XXY zl6#b+RYv@4woGMI3Eb;UU?);b(5KYm&CDqH7t=PCUTEOrV|z&p@F7*+673j9Z~pG~ zrm%{}z$1kXK=~N@PX)5VeIEXAnTi8!;rrh2Zv0eSmkPyEw#9#b#bgNBT)Fns#U)vd9 z)7^m>)bXwE;}A$1i#jp1OQ&E^ds7Lz$m)%iWhT$*ja6hotn>=}ytN7+*$_T*r{N<% zf{#^ce5@|VN9WpD=ln7Qp>KQ(AL6=dinb|nH0LY{2_Yh#3MZn%qw(`!RoIzS_1(|< zCg9^XY;Ha5N~Q;A7+i%dpVVNKwAdCB}p(%D;=^?-tfZwN0_fhg$ICP@xn2HtAi*{si1C(37;{8wQU9)^szbFWxoz!<8kNnk|t0Z|IG0I~C!Fd3MhZPhLJn@0&!zFVr6; zyEyC}%RY)>H)HBJ?9hQ76FMiR7rVV>>x$Gz;FKd_CM&^vCXXAo8sYGxeCfXI3mB}i z9b;`UrGGh|G}cq=j971eD^^K1H&r#g{G&(1mlEJGON13TxP((y z#hk;fS4p(<^L01^C(QZN+j-FCDK}X%h;u`0(rkk;>B4Y>dCT;6%%d85Zm-sP1=>W! zZPN*#Wb@v6T352NJ^OrlR9o8<&+U$N#($^iWi<0P*nIR!yK{TAZkLwdfTFU$M9n*= z--+UiHPx3KU|k-ok6q@M*k!Q&cs)(>Y!EkZlTxtU_j*LWB8G(9Lhd6A|LxNE9FDGCXcB%1ewQ>B z;BF1$!`&J`^(DQ6Kf<5E;mQ0X8k6RNZf+`nLULxs??R~+at0~f?AGVZp9>t1(H;jr zd>;1yF?{Om=di$KbndJtN*8#{~&R);4)(k$~8%5pu`j zVvRQtr=rMs6%`(Yw}&GCQv(+d20WKN3R%^=&Up@;wDGKXyI7B%3JlOE%|-7*2w^-s z2$15C+>`oa0}efQM=(v*XgLm#5XuR$Xl%$nPo=aY-A_z*e3lB4#|}ClTi+%!mlNJ_)gR zCB)t{AogDDBN0XZ!4ZF7pv2#O|*6#UPUfu3Sb6k-%NFIC8qAH3}z93G?fq6ndC( z5I^tIRy~b=AZ3D%hgT71 z@Z2$w>-qXAb^*-3JAY1E6k>r`{qV}qXkGusLw^G#EtFuqJyO+%hPcGe!V> z1o)2nz3FEYO7NBXpeyv!a=qYd;SQt;4R}4*t@u6=y8f7Hl2~GdiaIH8V&-TQQ-l7$%x>5?58PukA zEf_T8`*8^v$=-PK1Z_2aQsJmwyZ5cvjO}KY_yKoW2i|%OxSRVP4(MZB;&a+#yT&2f zQ}K!UR*o>oajXZaY6ah}km4~AjsS3#sHPu{`liFlRZ-#2i60>U*VEBte`PH6Vw^1W zY{2cAzX{c;^T&lm)8Qd;q!hSgJ>aQZv%hgN*TNN`Z(A8---A0n>q514ZXcNV z%M92z5{^~K6Piu_0@6EV9Uq_qM3>Llhpza$&1I{og0Vx;2J@LuAGR*HngO&q7K_lO z5xWkBnXN`wD=g+>3nQydS-b?~NL4#<%KitgNyhKD+t!A0p+}!R_T&Guuyl0H`na2g zzlp*w(YCLKz7;em$|qx7BpARfXSN*;isIsuwQ?C-K49O2Vu}%oB4X?s7$EBbN*{o^ za_m=$0!o%U2_cbhsr#5}moHHB3pN8D>Qbj_UFFb~JjwAdryD!hj6B85w9dIBS{GDO z(nC6Sr7S!h(NMOGWa>)O1>J-=A*!x)|4cu5#Z2kve9|8|4_y)U^H|uj=Qx*la{7U284ZJ{ zw;Ptc)QQkV*3=n#7K$~Ca3sKW$M@GG66Yn|dYJdlnfeLr{ZU@~WxV*s$ab=e>6aiG z!gZ(9w^r_UCdH`)9DX@Zl?0 zu>>57@+vm7;+LWH$>^WDj&<)d$+gcd)>sWqfp}VQ$Fv&T;#!0(|x5}@4#2O!cxaiAWPsj=@d3S0^Q$=N>Ca` zPQWiqsB>-4W*nix1U>zR{xd-US)3UbaSNylP%aJG8u}s`>Z}EUN*KQ# zl=9?u;OmlNH6+y`NvA7Jw?8BtWz)EE=lIYXvSg427lr7Zq=hAIflB-DU|O}L(M1Hx z?FgpTNZOxN+LOVwI!U_}qy**4j|{X&VT_g&58_tUX~8sI(oR?9J{?SJl(g9@ttptc zP||8u+TFplCP_O@rO__WH}+OZ`>aZPE||uR2|KD9-Y3||0D*J@M^|VT)0g}`4OV?sMWLMgP-4|oA!HaBQO%PnT zH!$`lAcM1hkxYjP#oWbgoSP|9M-h|YRP`0rSS6B1VUm`k-!w=bhDQ3$_`9e&tjar$ z%chAPv(AhU* zT&c=kMnYaCR7bljiV4+7xJ4z@M7yUI6KasKOeNGsyH6}8)FI(ZDgpOX6f8S!M38We zO3CNW>fd zx*lfzHuno>zq88j0@@b$SE2$cY(%6w7!ZYv6@qdJw!=GS{y(t2AZtJIm(>ck`?A74 zE^*b^w;2Yj_$GO!3PkOTYPYdZBx7xrEk|30RjNOzPX~AeRY%olU#+rJvTV->z{o$L z_!IoCuJ|KZXB8QiAE!S^`rBcWPz!p9W9w7;lD(V~+_eI9#?z|j9WOHuz0V&=9bJ2% z@VDZA3b~^*n6DA0Yf#f`?9T)E<@E1t5GVUy=XcU@s6`p6g}sLysZ~ZFF?I*Cu>2+b zkt&wImA@Akf8WpF^NYU;zA^K+@h~H`51=3#;iMP#N`LpTzS3fSgl}P!%U>w?Qoxx3 z3-y#E?;zGWPdzxH>n}kpLrTcda0SF z%E7`Y*u#RdE_?-50SFZhDQTZhSdS?>>=una0))k)FScyI1Iv5ys#K zCguIy z>y)fEm|rP_LS$@ud(vnPO8~>%CS#^%FP^KRqBdUq&^oV1dztnlu-7mYHMhytNX)vS zL?m&E=BE_wxS!7j;D3x$-7yV* z3)iG*DWH3T>|CQ2jv|g~qR3NHfBYBsHP^9ijDjo01254@geW`%d=CH&pc6U;GdD{w zkywt*{xA@}h~F99cxd?_0_UT+T;dA0+DmL&v#9kgKmZ_h2MQtnbv^|-$ zRkq$0UV>fJ`*x!1jzFxi)!8os^rB<`Fxzld;9XNotL$OaEg}&r!CPgI@+aOrFyhnj z>o@$>7ax-T!BP%p20RsHA0g@jS0Cdq)p)%2K=dI*_9U$@;$mVS6y3w%G$BxN*MCAR z3LdRaK$|Ny7pg?lDbBTVDLuVBQ(v0?OPmkqyf(kLRrh2 zc*%=YH3qj`MM8rMu77Y!qkGL0D3P?xZdIn09tItSWu20e#MBF z8VmR=Nd%LhspOptmhy#M_+iyIs83frn0^wX8p?{U= zpGyi{NI6|=7{bLpXu%}7j7M4EcE_Vc!{8>as#y9(Y1-y%8nwGyj8691 zUIeOudBpWkWU7$cxVZ@I)^n*JtmN(7AT7O&75%#LR$qJ{x`&&{r~2Z5RH5|a*s>>J zl@+S8@qHyqzf_Obr$gH97P9E(l|+Ca77g!> z?2|<)OJ70xGm=X%zFQ4=oJlEs+b_=?CBK5E(NgIZ+J6lSKj26I#TdRAZ64j94qo7r9Uc zB(*(-UmkvZnJwSI?BWfuCsR{nC3EY9EpsK%F(~lC1H;j}QkkX!fhbHVR-t*jzNDv< zxRaeV0T}ZDg4wrAmS2^98)^W*!Y}9QR^6~`o&AW)?_Ighxs-yAA5h~m-Ma0LT}V;< zm08&rDaS7|>QjtHye73PU9i8vITHLc&2A<_?;sD;VSS-?`#hv2tV^dt!w-iHx#UFy zJ;+5*7AF^uH+5LG?I<_OS!JSrkCr5-RoXWnZW{qXvKE z5S4`FICoBZ^E3LAokSq`4xlFwEjNSb@EjG^{|;+Mq(J#B{~Pu}u9e`^!)U-X9(-?k z1iTHH--}yE8f(b=8~_!=UZU6|EQe`Ru^g}qBC=rs>{BBth%v8i5K)XP$I~usn#ZuH zb>)bt!CA3MZBQ`Bjn)UNS?PModqr!a87fJR*AHXlXDJ!ItC4;I{>F2Qz@5u+G;v{)|b4adWHcSFe)l}Yvf89;~MD>CIEYj zZd}l2QwW2;ZKa zkzq*d0YXw%9P}P5xMF)IMe($ z>I1k?O?2}Iz;`Nm)*zO1fJcqA+~xdX#c@m!z|yCOf{azwcpSQHyw(>-f2c29irK;x zcA^9b$uS^iAti{;T#0xWL2a^2Kn+|vppG8eSm14^r-l@>A;2QZ<5>)PUwFxBmk@~567b~xG^1B6 zT++B1D^GRA-T-F7Js%Ph!jY*tHXF97&blie>!Q=0)3NK~NYq5sad5SwACM9>a`y!N6I)lj7MaII7www3kcwIchI>#qxNaqDkl{ZqkP;^KGANDlAe zBQstbo@+eEp{$b_|vOZv8cfgU`&v*1hi>ci!Iw#yhj%hff%4MD4oy4dR^E z6{!Q83XZHaldwubcsm&lPjkdSdYU_08Cas8@S?=X^J87`_;IfPEVpeUp_JKK#Mk2d z+^QOZO*6W}KFs>i4Ye@Hl3q;d@enfOBI3NFgBDo>GM=%0i4ZCd{%`d9!V|fI!~3Fd zu>b*A_^ofgl|MP`ZR{cbi*QOT3<9Y}fMk^&e(w8gT^Jo^ey|=7-`=H-4LBkkt0o1! z_HG$iV&nx3Ep=F&SU+By|K9lY@yAE)objnZX1ul({<+$0J|7uG0O#HbXAGRywXTJA z=_6?2gX5~ByRXx}N9;2k-TigME_0OeW5wNWpVYon)-=J4M?e?YXm8Z>=^ZnQDa|k?rGihOuE>G7@)iN#g|>R0VqP-bydp3C>;|?fE0^Pdy|9 zI{ca&3ebG_yyDQ?Hr?olU9<+lY7@SX#`i*eSKzx5-&637$Hy-{3f~cYABpced{4%A z4Zi6Yq#EX(lkgpeooAvHJZB};aAL5dbFLZJpu25j?ZN%``yKnq^t9cgc(@R#rqITs0UZX+0L@jo8$XC=R%mMga-*T#k<}MAh2u;V+l?& zc4S{@!aLfiHFFU1RHXTh`M{0UoPdsybM;rNc%zO-35|ekfv?>@vJtVU{ECvKdF@bx zd0j-$_LXn=AdcWL4%xJF0&O9F8#SI#{z($%CG9z!qZ;}(gZ@h733l51LCGr;N}T}z zMdj#6BlXuA!5~BCg2!(tqbG=%D^JfGvR7fBk;jkpxo;Von*PA@o&`Qd?g@Al&22OUM@A4#GrOZv!w|qnWyEkM2^$A+8 z9{Yj7KbJ=ZgiIL4?;5X9swZ9OIx7+!^XKzcz)X%Cvll-`3WwX41H0psSu zAXJc&xQJ;UXxWa%W?fz0k{$jC+tyZh0gXTrt|H_&6(LV~taD1@JYjr27!@qH@||eR zTrlLGg)yuDQ0Li%xtjRT`(hxVV&r-uQ7-&moj0ZH zU8;{@isBKsa=84s%xSN)QQh3w^mm{z(6I@*8BlY!O@T9ei2MpfSri7>BOAD>mSArem_dhAFmWl_0ffoOBWuLtL^N{BSW}qY00jf z5;C@@%AjXq?CNZ&&>jYX!OPpP!c+|7fakI)7)*Tl^c{WiqcQa%qkqd}F4n&IFqF?i z*`AYH4BnB)Ct&d%n`|D?yGu$!nX@LBqG$2a!5Q0euHH27NTi-b2MNdb#ZNk-tOI_O z7Mu#RY!v)ZZ~Vi!fSosm$;TkBZ^98}6DGD8b4q*XOgd6G(?f~+H`V--BUc;L8s`@Ut*M4zw^9f&DiDd;9BvH%hJ@uO#LCm?QvWq-q~9fkfnN zwA6h!u*UuvgbXM-*Da|(d~6AXbD>bgKl2GQuVyG65{DLMWsA`;g_rhSasjMu%J7Q0 zH-1b>=K`d~aeaeUv%|+4JC+|y+=Z+rw1pqt{DA#_!m#1J5t>nWLAg}RbMvDL!S{)R zUGWgT7+g>e?Op!f6sw@Q{ZWVPuj42EJ#Aor*-d{hm2S&I$Ui_6z6F|~ZR!&wjvIe> zge(q$Cq07+sjze{`4KJOfvTcbaytBk_@tl^Nq!#vgG6s1B!*Ps!4vHc9~keaAC6Fj6ru3yal1f5 z@#b6D&OYhxXY`g6tDrN9qa0@v+O1Ckuf}sIF>&cD_7H%Qhv5VT^5Xn+|a8Vumn2!@Rd%F#bKZ#e2*`_pLKCl9l#_G6eX z)OEV4D5Fh?mecTw?O_PXBG^3ztTWq&XWl}WVR5uit&1TpAO7SnoM5QZ|J`5I7Bq#*m zUl=d#A(lViEB}Gu^a&2-x2f`HkC(QdA|;i5BZIV{T(&lVtL<2Jz!Fag4in%kE~$#OJkUa>E&!7RFDxgt=@v%xG8 z$s+bm-iYRYD9})yWLXoaWnC~!jb!-+vnWGQP)uv3y3KfKavB&(IDQbUJnIO^d`Ol5!FXvea(y>?^!(SsJhB4vht&H1<9KN=uzaOg{;gmhSswZ4 zRr%5&PO7xWSiaw*kF$b#WP#-WqRL-3UfNEUU*na}1@p-2$?s6*zdK&qPguUuEB{0= zPm{p!$Eti`yflO5E4}ik2hl;+UA|M5pEq9GS6H5|C=`7j4(5>+m*?39xDgI65|y@; z<=1%S7Y6f0r2k)2<(H3_wt(entfboC9LytYH9udK|J`_L^wwZkdgTX$d1N8y&sF6s zu^fC$MWvm@^8NTg`vHA>-+MH=`JGG%i{AA|JC{nJQR8ulN^zpz$SV|lcc-CT6yF## zn{aJ%2J%Br`tB%?-oFQVi<%-mwc3U|4pC^TttS7?1Ch_at=Kd2NWJeaB|m*!>--a| z{Fn06hFOETk&58Gqb<4~SkouR-i`ajDj|z2o@- zlurLIES||`IEf0ue{$#=OZ<=ehz~ z@{X+m!MH2sS{^RS2a1K!&WL><3aiuSz0%=G5Pv)NFNB2EmG=Yqh832Ghgt#5&5$9} zXcN~o-$E0cBlxKsYpa>V$TuNJkxhwLYPsiu&`_PLME-$U%yR@n{SvwW^2o9w6|B_F zvM|=X-gg1coA{S*BYcp;^vjg$W(Y zYxdVGPPoNLO^MXdl53yzc~Bi71$6 zWYH?C?8^@zC5->1^)5dmcANi ze}`X?Y_HOc*6ZKGa|vdH^0J;?vA864wz*<4221qPEx{q{%0s#}>#4$#PI(meBpawe zH-^#$GhPaw=`?%+Si|%SX`s+8edR4{=&GgI-XUpkSdd1vLy6x3auTawu~=I*1xNvV zQ{8;vu_koIjJFdBe`F@CEREs9@H7n=6(pHCQPTAMo+4SlGV)NxPNvl8mZ!5%3{w>m14^FAB9swn4n_d-8CpqabC4N!-d`4 zn$B78L|rh+h#HS+xl=?$1nFu9k@5ULwA|0oooL5WEWMD!O#2>OobyLyaUUfD@nH&HbTJ?cn&1Z z;#t4RG#APLNJYeJ{{av$WNl(aGKBfpZv77IJdjn(eHGGgGTgATv>Fd}yzn0KX?YFf zj+$50%qr#esg|RN(dhyOj%Q*ZBqGiTr1QY)2mtgd($sIx3>6D;XED*(lYO}c7f;&i zCnP3PihIbx8hCfrR&Qg>!@ISI_gXoFJgJqM)1N)`A?=%At46EM;PXqN<#RG#Kf0)0 z49!l2I3T;C75GfqFP(x8h02jCq=LRdiuD%>0MB&n@Hwbor{?j-2e3S-c^p^MBGaVh z-j;NsLq*c$Rx_F)vBGHpr7R{~0M6oqS#6>(NXg%eZ%~dNd^wZ~^#HpFdE5spPao(m zp;3w0B9+R)>I)==)V1~icC*EWDmgzY`?B&_{VQ6o25W)(n8rbcRXyqFK?z919w7qI z{rUm>cua&^>00gy3fhNDB^5cjD4_rk9K^(Q;s^Q|?LHL&_J^s0bV$4tVTaC={gMcD0?mcNTN5_Kw4XE~ih`zR^DU|5wtweHm1axmRD#R$jN|f8n0oo#e>{Q>7KVaTX>MIC&B^Cm9 zX$}m80Ej=h;7>%gTc+2bAMGCo8pAY9_z-82%c|abH>yT=)}uQzqxKG5N;Y!Flt!7kk70nq2`#`a)F*aWkrE?b>MY-UB`yRVlmyvQ8!Cl)RqHU91lU)m zp!8bKtTP;ef>5HJTJApZy_t4;5_;emXr2y%|1+A#fpg^1titFj!szf zN(!F;hu+A@`50h{u?L=FTu9>KHk6=+IkxKD_I+ z4E|EMiQR5j{xp*TvczCee&Gb84^F4{L_&BC_SuQa`WLiZ`4Oz=c{M2lo9$?_4&HS^ z9RXg}uERlq5w8h=uaC)Q92#32bpR=UK+E0jM1e6$n%xn^7Ag{8*+~Fz&mi$4bLy)A zbj)~FHFvQ!^B<@lla+2?^&%l!|ij*w-L6wZx9R{F$?GsmeL>1kk`NwG-~ zJw8}b7w*@J@r74NYxX_WIESL?&>KI|?&>+2swz2iDn}KcCas{8(n@iglD$c4_EUZ> z_c)d#P7~9%un2Zh83N`S=HN^*7PaceJB1JQV$>?fGsPUYF^4t#r|b=a$lc2h?Z`X} zgE|;gTY8yfHu?-1r&@>6%!o9w3q?SVtM+uG0}AJDh{|Nq`I;25{1Kh3PG8gz#@Z z3%N)5WOV#8Y7bp{684<}bYn))bIc7GPjCy+EW@H=_pq8VqRoWs7QOUT*{&6k!Cgd0 zp5iS06_nk~KcdK1ZXUMh%tQC$*Rko_G7tS2fs%9vNQ2L1>dtE?74C(J{msV z5;Yb;6)N9_jEGn;E7ue4j9;eZJ_xFXB^7b%(DGd%tz0))YmGqj;TrUbtOExV2Z~4h zC@zt?p3Zng%keT9T97zP?AlU}0%C+$18#}Prf|hrftS^w-;gKm$4xG%E5Q6>-69l! z5V?}pL;WZTG=wte8_~@KKS0#d@kD6CmP!ByG7`{hv||kSUNBYq^a0_#tec^P^WY@Z z(U&I^5DHDkJhA0&5*1KDQfUv?gnte3fh_>Q0L^m*^3hn8S?NQSmj5t2xoIu0S6c9H zgtn?uBH*=P(U7G>17@1hpxAYD!894y4mk53(sFNM1rjoNnS2pE9pHV5=K=rAj+7xF zv~&_Y`A>@)6I9=#&=G>S0(_O5anNv_xq=<#bVQBq=qKF!Pow*9wo;0|Bmeorf@^tt zq`=J1IlATiJiDyr4`C;cW^Ss$Y4Ay)3u>vsq>^J<_=)1A&N&8?8pfo?L<8MeP|fCK zzR((&Dw!-iiaI4yw<3}>rtVu>f%WkhPFnsl$U}fVFY3w?Gg}9(#_wUL^fn7^Q=Yt5 z%j^+w(H}($uKZ zSAqw~^``<}oF~j(26HD=N4jVK;Wc&^)LK0ZppGd-b>aWjYLv}Rc~Ruqii^S9R&WI1 zvMJSaUjS)vn?KAEpa;~!+4hPXsQJ)s7?^zmcD$r{U0v<&m_aZo)&Om}q-FgXY7oH4 zvT_arIKe%jsaO@g0n6wZ2h!zWMQ45al(Ntx92lbGC0J}LB3mkf5nF))A^co$PWMCzL!#So83J9l)+vaK zpBFV2oh+~CDEcM%;E}IO$!kMzY)ba|&$#JY?tH}R*4gW4p)#%O_em=RVAZpY!7XR=+d(KF_mOl!2)u1CQpA|FWJ?b zo3IBb=8%02ESF?G$*D{Y&cSMAR;vjVCW67VV(%S;)qt!nrR?`?QI5!Q_}tA|WcW-6 zfB8JNE8nBQsff$=nOM<~&r1G&p6H10e(tdmi@=xvKbc=4wV02eP~bF3@w(|K4(vtq zZewIUi-nzd<>C_~LVjmNY7D=5nb3%lrC5V%L~(Zk;FldfLd$=a0TBe8rmafihq+>Z z{R*1NgMHbIea0i9VDzw!V}a^Q5~OrmmDrv{j~!}6+D|Z4h9d}*X>qs$M%5we9!b7s zy3Po)400Z`=1n4Ls%B(3XT4*mWUSGe9Ts1KSOYZb6?zE!%s_Ta0<| zEhY6kKcS;5J#c>F!7k|>e^Qc<0!M4B9>9J9iGC8-6PA9ko3+7X-=xB^Eo-bsNdNE< zTm3FAXCWJWM)l};@w)!JG1ac;>s zfMx3b1tQ-326n+(yPjWKoF}a|JO4MqCv`;yKmkS->w&t$uK8yhHx2N8cnrw7hb|Sv z%m`2g&;olD*Me;U^TypTsR#_+1b#aAk3uc%zhju{zQQ?TtI-Jzgfn_9b&7698sXe0 zv*J>qLVTf?KYxg8U5OnCBX)m=(|!N42x7KUw(mt*(#bfUSgPiw0GML( zXMk>mJ60*6MU<6FimX3IQ#aCYzx#&xp<+1-xpJW zI3D~v4xRst4`+Sei8k1;d-mh16~xp5)ii>N6X?z9Xh|Fh7P%Vfo1J=*6-J7=D~8-X z!;dNuMToLD8+;HeUF&Kqi)0RkwcJYlN?0r5pDB_%04_#Pov!NBXzWypqpUQ1bR_GAr3%H!_DzSbk#QUd&Ag0ib_I6CdMvzh6SeL=D(5oS#pP&F_ zex!D{d(N#nUo+^RUnQifh+sDDO0rO0aaLSY?aUUs0z@klQmc^EYAeBp1Q{h( z5aBBgMLL&FOIjCw8VBK|HFp-~?NZbrNw`NzO?OA(EW0*V@2n!;E>Za4c;3d|H3gkRfV~|T#A;wVLynqDEKB3h0R#ZIn+!B5Qi8A z6C688!umgkvC7^<%vbxr+Ul|E%OQdU+qdUurzk%7Mf(p}5YDNUXHG4jz}DfNJZEtq zL9fw9$ZbOwpR?N798Ng#PqTUkW+9;PLKr0bt6+VJnZyAjbOh*75+Y7;!=AK4*YWbtyIpG8u^ zJr)8Y?~o}QtRrTaSe%3mxNQNW*7XoKa7+W)bZ*I9spNe0!|Bd6}b!W zO%F9Z*^A?OI7@&Zsvb4MU*693%Lza*{JXxUYFrN z5F?e73kS$t`iG$bK(8^A`?p*rW0jhmaV-Vv;oSL0WZZzw@Iij#VEkKrBYGcy;-JVb zB06^mn#3a+;@DK1vk#Z#5xgG-nf)4M;Gu@+8Sjvb7u#mRy%2^9Jgl3H(?7lAJplBDhq7uuEIL2V^q)4mzoGY&r_o9@>a^qQ)wx_EiVhBZ!kHi^m(&QBl`@r} zBxO~XnxaOI4*fcgisl!~#pgIRrXaY_G%S z&f%JeKFnzcRWAa0eE@Y87rOY5f^HEEe;E6}Or0MCMxC$D!j%(s8>=`bbHQRk>8Erf z_lG9*Q_CI6_1RnEFvUiCv7H9Kpz<>8-7d*T&XBYYIQO7WYR;eji?Ftmpkf|F4CD|e z6IJY5tPB1iCAX(LKR8+T3C<5zYai+S;I3o82UZl+Lbe1fZhIJ%)VIFFz?9?Fc_J)ff-C{fB#Ap1}<6kgj6kDy@`%c z^5;Ag;=lO4>JcIh?yZ3b8-bSG4Fxsr2|$iwB~tuT08kLAPeE}I9JhuDYLL zv$hmBF^I%w!iB6OJi`W6oP6w15pTcRO1xDFFb`r)>_0GG#4Tm^owD?^_Bw@gr5H{C z=YE7jUdxBsKi#$`LYtu2c$|%g&?tp;Te*T%g47u^cVcgcy9N8}&&s-lu&^{_S6~oec_VNftmTyDfKW|gxgp^rFI1SGedt4& zrjm3;=Ajc10Pk?x$jC_jqKGvY%kKxoRchk28h3LDpsXaiJT>^PdjiDvBN$PUgr+WiWTLZL7=^(gn|423!K{^+6U%NYDyeB_NiHm4YHLxJw zUc1c$si37od$kOzPX!rJ&4{XlAhcRs>I%^-~^ZuOVv>P{?A$Y{z8?qQ z-k?nIanQ0+Q8yvVe~`${1}E*{ek&S~rDC5Al<;jad&Z3Fn_ImtrWJ!w>v$cocvN!} zFr^Mb!ORI&_jaO+U6`>TR=I-0-~Yku)W&LzdV(4?4mh5G)){pSH^tHJFXIN1WcSnH zAmg*_9T3E-u@PR4CD&Pwn`Q0B@h9fqay z8IO>G$TiA#0rKR~QKG#9Z#yo=z59V65t`SElAjruyZP*>Qi2L3f2g0OYS11=={2K< z`Vo{uqE7jMI<^Zq#JM(dljTww7wwab(~z<7f7(0u_&Cb4?@vi72AWf6BjihZz(gO$CZnB$ZVY9pJp-lj_NRbMNrBtjOv{D50;m`^XprS-TL^-tu zr9j0(LBI#G98?r|cz@S@&HbC1>?Y{*$NPCdpXZ%VxAV>Ky6)>f%suzqGdnx;+kh)t zQ$pMxD%xCnKkjSKJ!Klo^a426Nki!-v)5P$HPkEEg-T`d%|Thbb^#*ev4OIWm{R%^ znYKiBTL&e=me>1s0d4_jA`G9uXP@SG0$zt+*cbPRUWkXCJ%Hyk%G0q&!r2pR@Y!7_H=gbK<=#PRds^zwI=FWz9g#{WuD{4t|08dEm9b7Z(|*l;b?1)7^-{{yKPWx^?h-O zcA0H+98s!VWB1*AY}J8f`-S&iHafGw27J z;e^s@#X5(JBDl4|k-Mrc#WkA_@LH^|LGWeZjaYBk*Kv}KI6a} zvHm+g6<`OySGgFU8t_`I*P()q;)C@uxV>#DIE?k5$D^F!Jy`!974HM@!ulH_$5{hj zi}eTiYy>+;p=~gsmEWC)uukIhC^&=lpYhoV-h=hWaqVG`_+Y&apV4SPx%PT78gLwV zE!IE9rvf~H_3@bQ)_`T&`*01)3EqlzZLQq8_K{;1Je-!)Ghlne8~68jwGDGuB5m!dHB-&YtWz?|@ff{TM!SFU(e~XScu( zZpHded?tYhus(dgPKRAQ+ zv-qqMf2ESpPnOHV5y*`r4%2e1`3cb?Y_g!(dr|AD;}kkUBe+ zUYQETQ?X1sk;;ei{h4^EJcbrEOCgmjWHRY&J{}9@v(Z$pJD#;Zp^8E(8}CXlPbJQU zITl}$=!%D8*~E%?cB0djj3#;^BWOI^9fhU5fOEcRA}OKLp6NQIT(uM>^3ul=xoBrH9%`Sru&pD~THkPTQ%9tu zscnAqg8Ggo6NHs=6PHZiJa@suwx)J4wo5wHyuQ7@b%?~MZ$V3m_U?`5 zyL!C#gc41K(wTV5w}mE$x}vGBcruwtE$8Mg>Ie0$&G1VmO|Hk4=Z+h`BjgI5y@`Az zkxNHx4{}_svyeR76T6b}Xg1OlP3Hecugf2LK?Ap>0{v@((J@ihx}hin}EH7^0)-HilYIXbf6p;cNw5FNzPdb-!_F95l1MFTpB=&$L67JxbYq`3Z4xcy z)04AtY=&HL$Bp^+JHJz)jY1XWIUE&q=}H%pv5;(%Y&;s1-MKrl979B|E1SsV)5tHL z&0;^dBaLsAh=tOHylgiNH_Nfj;H5*0L{6o-sd6wCQZeJ;OO8PXOGP$5F`COImZyp~ zE_!~EyQ86ky&&!1HQa&*J*0k`628$?zZcjP0{=zx`FL-}bR0XR*_|Mik7k$0&A=Kc zkr{jQ*?zMRVw^lXkwGKo^4Ua}ID2KEP#z0aNasE~-rt#yX3=ojP;a`Bi{o-sAt&iQ zXSe)lKY58zt~2C~>vYP=xZIWQ%_LDQT_s;L=>Zj*&Z?plLD5K-9*hP>|fC&=5vk@U8C*j4uJ;uAO(vhw?SNw_ISRb zkj=(Z`T8U}N(yCyBpulq#^fcInzp8siLQR}_xF~hA|77-2}-N}LI--JmOdzHLrN0t>@t2tS6~ip=AJm@V9VeZZMCZv7^pVB!Y%Y;bS>0r8j&zeknB9vB!%M8v z{u{OcU;8?;2Xk+@^_CyG9;RS*u~I@URUsrQodGk;|7Xe z)Gnzwc6x8hltK=^^5jA*<5`)aU>-6l)SoV3K*PLPiZ6qvoSw)$yQ@p4ggS}I$?PVV zh?#*jo+|Xlv(db?v@T|LRpQi1r#W^CVGqqXhs&myXQRC#%yr^fiQ^7xp~)c$Wga~j1)HZVwDS_Fq7=X!-4dw`#$`09th(dTd?6dxb{wW% zGB`oS_+w5BFsmwbNh<6|=%`-ruqVLYJl32lNe$fdT=dMgDN8Wl!ltY!F$2REa3^v0 z_#q`56wi%?{kVd&Fzi(xUxj;d%bcitb$VXT)<>dp_n^2wGrxn!`#qggp4h(+^J%sAa#TCLs) z*=FRWH)%|Ou4pFOnMmTug87#uZlbbYUWD=jdqbfA zbmpZ;us3#_ODfj2fwfAjpBK+;MQH=f2xY#QEFHh79J=*mh2GwN**K-s53^l*^7+in zDN}lLu~cPmqAQ!urMvT$Xq+kW)Z{{L3dYrJG}{k{=`*Tkgr`mjO*tV5?QEnt|-^|a9z(okJpjFJK}ng{>?b1AYLgoFRv(p z-D0@oAWnI^3n?8UrOep*yrYoreCDDT_eh)vVz`WG+v5*&JtV@M9ceGOI}Vp`B88zW z;cLAJj`p4LtRul0ErQEk5X@9qkJdEdgaeZa3|YR0!!XU02mkpC6Y-SI1e4J&k;O@T z`;ZfGe-y_#uRL70RQfFct6C~!E+mD)>n}Pj&9gBzjWl*d8k-h3H#GT#hJ_2}G|%-3 z?Hz5+3;Y5GOP{%|sTCJRWIflh-Ru)4SIX&~n(Ia&4)g)2L9|OxN<5 zJDAhdSiC!mGuKc$r4s{5;I)<4_GT)?EX+RQGkz{?x3{kxdTevAQ`;HYaN}Ph7SW4s zGN{QMalxXN7RPoIb0DrLZ?3H=;OdQgSzeAM?s3sxn0Now`IkK$I=zXUy_89ZP=y)d zkeRqm!u1Ty6mew-Be#2j(trI%W^g(wT4?4|?s3=bh2GxGS%DsvjWv%8^EWQS-27C0 zw}Q_*`1@geI?lkY(5E}jNvAoEyu>+%zkBdW;*-HAk53;y=i{>qpVj!R!RIo3*5b1s zpAGn2i_b=UZoubed~U&KGd_3Xa}PfE;xmBHgZMm*&!hNk#pfw}?nM44An(6n-IIvn zp{0YTNR(ijTPW#LPakh)wS-z=9z@lR<|TCnH=UfRmrfW^z2pJe%Y1$`Rls?@OkuO_ znDya6X{uNh-;GqHd!bsh=@=%%{wSEH6=&d;so3U4YmaAfAz^_T@dkwqWaLE)$X=jk znWe;IgJKki_W~8$Of=3qxs3v$z4QUuEeOU>)TLQw&U!5%Cs7#EB<5dU;ahw9a|wJ` z(#Q+nnt5?JH~V6P8_Zn#!DWgVlLE} zoSXXUMQBK-bMceo{Y6G&4Y)6nqhKL}eEbOmQCyeCgq)xxF==azugKMFy2eBk4&V^* zEoXD8J8ji~D}4hh!}=q*Q@Wgu5Xo>lDV_JN?NtS-1Kfx)8pI?63ifw zD+32q6Y!(r4QkgR^L00;?>q&Q<#cjIT(1zi^X#0XC&oMnk@I4lR(HxbDmbYhba~r9 z1;td-e=$f-@8f=&D-@0 zJ$&nc>mo9Z#OV#bFpK9VnXlq9QWg0EM81-9P!oIgphSLV`lVMJFzF1OY!{{TCZ+yV zD1CDZU%`|omukVi^P!JEKSzTPmwuS@=U_@{*^kWEe;yr7ZVK*8Uz{(`qk{>9`Iczk z947P9ysfELd@HP%Qt_wUlHhJ;U%5-9XG@m|U^ke1al|XXnE^`&V9(O=7gt10VSG*Q z^%!3{OnP5wF+53^l6tri{pHurn2N6)TuC>X_y*gF*F}o+u+B)3Ps<%4_{O@(OZs`b z*H$kFuYPl~A{VsHh3o__YdalifNorROs|x}y9MttSD4-F3^UDkkh005mpz8NJf6rq zjqb749qHySlIw3JM8qqk;(Zxh_vAIW?rgd@l)>N_IOLmVHP!Y825f+j7*!J85gBr% z+~<|o^-V6X=^6Z=Nb>n&d8!<@Tsgi?hwIkTYDsKSx&Ns|`9r>q=j$W!K3p6RNv&<~ z4b)Rk0H>IX2hC6%N728?HeKey?adNnEgk=p?;QFrl1{^2JlS0@F)0+!cU4Mp z?3G*Dnz#<9qmL9{b}F}S(sCH#SX z?s72w$@Ry@8GIuoo7&W8NcZ5lVY;ofhe@QzK77w3w;)M-%i^{4a=A1jGjCH#X;pv! z$PE3x(Y%I6(~aEJ{4UPK*Xx+lBy_{UF@(VvSGMF1zt)E4GZr^3h~N@ZPv5b)BBWIQ z8Qr8_`EW!=ip9;1Q(Dmq=!+6Co5p34oDOG+o4N3LzjNJPn%W=S6ioQGdTWw$oOcl zdc}BRto863l*cifpT_hOgreCjj!phv?eG8YNHb(=v`~fb%M9sj-tgx?z6=*ZFWLR~3Bauc4fF23~o?eTD>sPIp|f)(){Cx?rm^%xum_3$+}imCh9kb!)gqAS|f zgHc;u(SPiHf6_54Ivf05)11wpSYDVUHgjJY`leU^kJ@i47FX%FH@+_BZOCE90oUK& zv6;qw4c(Z}VAJa@(XKt0iK8Oe*UjRU%k1zRuk2p$*`?exo6`^5JYMN=Z@L}uWV5-) zR$QFLx1#bTckX}E4#AM-%X<4AU)#ck9g%s9W>-&jh+$$Cu5t&<|54-BFj;AH`Qi=Q zpZ$G88YU15_iy5;f_6fuknN*nMqNes4uArt7v>=0J2B)rr=7xbP9#ObDT6tn2fw71 z0+{1Ierce~F#X0o1i8lz`2qvWF#h=3-Aq$>h9`3<-902xLW>j%&H@`U|x#)F&x$OZ%v^gR1yxl{&6s;WR0(u{* z{TgM3TsoBWo`1P~6NqzbxtY~B-NFd(PUG>tgB&dN_)qop@>sBb-b~H?V#VIqV0M>a zI}fJ?BItGGDiEqOm#3|6lv41beu|j z%JDe@pALMuT_Q4WNDJ!X>4U%g8*IlGF8!^c4Q19|yyEXI#lf@t@3!|sc=nRF==;)_ zx>M3|FzWeA+1VelH=BA{1gI!K95LjFAKsU-0e4^i`b&kueqOv1H(4MQPFKx+o-#^E zWc#<>D)w)CjEl1ZIa82e{cvuDi=(-S_6dKy(p%Gn2>fUB``5OvSKiWF&$9=|au2%WM%XMZ{buw(aBZDkhcd zKV+A2?WG4#M1bA&M?DW7G&uOmWzmf{WEW(4ye?>ynl;NK5q#}zoosyVvi9amYqk4V zq-ggu{n4$Z=k58MpJLf?5xHejy=-}lyW}G84vmm}#fE97SvT?tw_NfdL|LpZ zzX_IQV3MxocfPX7?~G-U-`&b0zvq=jelIJ_M)N;@8+(v~{N7p?`E9dV^s<8aEv)=4 zzqvKbY+a3X|GdC0*XBXxlHby5*AJ;>#kx!InjS3oncOK3kT3(XM#e@PM-~w$unow9nob zNM9I*lU3Lb{qXI79Ch2qd6$&08hg_Zram*~zMbC>$G4ANd!#e4@W-e8dCftWym`O_ zTgR^XxU=!sqkg_)a{9iR51#XxIhU;abWik;w;wmRpoQwD1 zN02MRlR~o#nCs(`L}-2@HFwG6CABpnoadc|3(ONkb(K>qQG~(E&me5UXQVR$HB)*8 zbhpvoCdnIQo-msHB3`YtNKGKM{tTp1MxoZ~_X*N?kow&OQonzop_JP8wkggeoek0y z@|a|ecQI)_t@4shwcbG*p!I2LyGeU!-3McVragod0%^XVr?!~XMe89LPc-e3q+>vu zHcBl|I*+u9eiJZCX_P6X8jwaghuUh=rKGj=I~?6jqZ~^*9;8v^eWGf;fV776b^84X zwAF0spORi6{ev_HBZc}MK`JNB2kBOQ2&DOLCp`_)QoTm)ze%GoCaU$5AdNB&w9S-i z7D(gGC7lM+6t{ykg^VofH=T4cNd2w^X}s^y`hC&^^m~$i&(r!csq8=-?+}p2`!q=N zEhjb5uM4E*I}JwwrDs5z;$_mGKw8p6KW44tNg>n9H0@2GCryf9(QgOo_aII2 zHb_f<&{!M!aMF<=^^1d^GVwNpwi?<>zn!GlK$_w$&~J_3w1XYzcZRw^TKZnnZ6HnY z3bi*$WtbhP^%EdXdo*bZt+PRz+qXbk(k=A6hx7qRouRY zX|E^U1k$u`fd))u=SbWCjsR(H6{N`^P4QD|_mh4_>y(g9`&rT~kf!aUwwm-cT7Lr4 z`aS}B#*uw+#!*(=3er;TB)tIA$YYMS*2734kXjQUjl7+-dVZpPDLO!!Vi_q8(i9g_yMlBTt$(5R9?3b@rac6tc~pWlkCRA^ z^ovtFhqQv$hp9b9dWP12P}}=Bo5y}2Eqxnkz|=AZ(z2|k-=(CrAWd;KNZWohNK-sQ zzo$t%L7HMrg-vk;NK;G)X?+_=^FW&7RQlyMfw@(e)_#l?L*SYi8i+? z&@W6I%mdwTXcb6nxeoMz(GK~H)ouf+HuiW+e+Frd-T`Uae}Wz~X^)>|wOY_Gjdmin zd8Bq)PoowmWoTVV?HbaJwBAbXG14=%zDR8kNuJxTWj-9FQkZ!>rP`d-9TkvseJ4o+=o-ldr6}F`x1JcreYpT_5B>e|SQ`}AMA<`qX zzD;d(m5p*3=?IWUnE={iN`QOO-EBUbG?#u0=+^_%zMH4tg`{<)Z-F$AP1NonJwVz{ zdK#oDo~QO_(p$9t1Egi1R&C4D0MZ`YPU-@w-&xdFkS-)$N!moZgY+=zY0^%Rmh@F> zZezkA?X{WYe+Yd?jYSq`T(SDP&UoZ(Ze9sYC-pzt$zV% zr=jaX+LE`C?f_|hpQH8)>2+E^QESsykS2pP?dc%R_Xd#8|Ei|j6rUqCfHXx9wSLl< zXx#=5TtoU1NOSu!=~p1l?J4@bO&WKCO>rb?I_VUUru{Cpo2flbZ8zz4T0a13 z`96K3&EqqqYLG^rMXiOjh}LUB8s#^nzmi6M&i0a{LF!in(l+=!Nb_h1>Gs`0>mFM7 zImvFVgF%}1lcbp-x1^u}vwd%+^-j`{>Gx}Df1q~gEL*-CK-)}|+d-P!U8Ltgn%fJY z0Y~Qi&(vGLmq~Ac)Njsg8+k&5^{XYFNSY1O6kh}V-bB8*(WZSBq-A-RG@{9-SPD{W zgcPIob&!^H{2W`i<3XBYI;kF{C5V7D#X4FyfOHGqPwi1^egzSSTteFI2yTSz(;q-9P~JD2ojTGxOcF!`Bqe6aMF<=O>rr; zt3bL>KMvA*ybscNXD+hw;-s@c8f7!Jdr7~bwQjLZdlIP;q-oCsJ!@+DLt3|x?xNpI zpht|~ge5j!l+;Vgf;947)b1z!iq^kU8?n^J8wJv|<s*OC6R0+~Nx;_LKVPx>}UQ+yAk+v5&e?;|}(Kj$=??*XK-AdON> zZ8m8xtw)`1=gLz+cboEkmNW~bQ4-V&q;qM#1f;F8iPj&JeonvkGi)9aQVgVdTuN;n z>1tZ#2@Ah7<$D6O!_WsH?In}GV6AgOYK?-lMg`KjAkFO?paB!*dm!B&chT=>r29dd z;x{1O9y89gk!O*bKj&;C7I<-@UXx1bWC=x6}Fu(jV#fS897j zY?OULTJv$#%1M)G{VcV4q=mGeN$qS>mez}@T~6&fYCj}xp>=@TW2C2O-A!!|>F>0T zT4w8Z2@I)~O()V@wyPwOUXn@M-m`Vh4z zNzc;y8nwSs8`W)VbRek}q~r4$Al-tUphq1!KkuX8#k8)cwu#ziYWI;I1Zm{m)ZPMV z9v@OWXt~uUfZYBg0vrm&bD)lnV{XKhwYuTR14Cyvq^J7nszB@n@N$Q z^~DZq}{Z>LG5kO z%O*uMYwNKZr1@S-`X)#t-$3m#kk;)5&{h-W9ngTGy>fO7ejKFnCX%W^8t=29Eha^d zw2AZ{X}`RUd<;mp+vy-p+XvDT+(OMMSnG7qA59)NQM(Vc&1lbow0tj;UI%IU4p`wh zw;R8)Ae~d62-18zKpN$AkVYwxz6{bRchGM)ts__36#IhIZwlxclUoz5i%6%@Z#hV7 zbQ!HzlWw5jEudFSygNaGL}+J2rb z>6svn@;z!l0sYBD-bs3$e*2z}mvraX9+0MZ4Ro*Zdk^%0p<`Fs6fx3z(6f#lyYB&MOFjnD_G`Gn z_Rhs1Eomny3DVqt2-2;3KS=xY^YnX}^cRq(IN&SRZ#+mNA4i%AQos4s7J+o6=>=(x z9tLS^yh?f(r12J9=s2&Nx^;t8TS2-3qz(mES7U`n-^)&wa>zpqmJI%yrPPlL3D7Jk*{)&Y9M zME)m8OZu^kt@UWqB#^dH4M_dcw4O&=MZXQyZXo@D)(1h_*Zv#yj48o{HQe_>+8Pa{ z`5-O9^`O6)6hEN#8PY5C8~ZgI*c}K^l1_wTnsLBHcm1UsHP=q}%9^)ZQZf9i)-RU202kJZTz8t#QyxrlcE5 zTS&hGX@A}h(zbtv^iPmRslCiv=aM=>YQ31+<)jU?-bC#~(x|W7c>9Ai%Bi4Vo06^o zJ!0sm^n0AN8>A`z1kw?1*X4FRSn~}V`8v`~AWiWLkZ#|tpkJ6g_FHR5>IooigXth` zm(NjKK#GDi-dUgrOq2qxmykBl?`CTEk{+V<36MtFMeEz759s%)D{T3WAytC3ET5zH zdD22!`>3rZeT~+pbvE)+QYT0wucUSv=_*=p0BK7;MeFONH|bY)rR|A5AZ_P$q^m(M zo0i-H($@GJt^2RHDLxL;Qq2ba#iVGaH38aYv^=%1k*)=4+FR(ilh!w>efpa=x9Oz0 zq*Fi|2Z6M{A&^=xru9nF29W0VEVagO*?eOlZOIf! z{nk+X25CL5n?PFT-L(FN^bh)t*kJdRv7oz6n;u0v9;CTtsohL^k@Onr4UnezJ7}wk zx6ik2^q1L->Y-3Zcl`3bF$k)EdCJJjAIIoH@Sj|FL&CxUdlg-O%s z_c@T}HkWidXp7l0Ujb>_%Sl&)v|Zk8z&kUI-{=wQH^RIZR8ov^D$1;eKb>3gDZ|{- z(rC~fMmvDo7}BA%j-z%2DMafr)GA1mXbn@VA=S}(0<~GBMq1}lYazAL+Cgn8=?q$z zQHzm!XiZYfkn*(lQ9GZsiq_TC){rivbuG2^qz$xQOKl_R23l{Xb_;1Ut#?wphjcHk z1JoWQJxuGP)V7kIqICzgoupl~zC`U+((APDq4o~xU0UC#hR$gFA4q$h^jPha2av|l zdMLGVq$6kzQ9FiILF*)HVNwmPb<|EE&7xJ_?5m}kM{1$9m0AaBDXnKvTSkh}+Cwc# z%Fvpp)<-&@)>YJ2lh)9B8MU>f^|WrFb}eZmtv67+nRE-So2lJNx`)<#sSS`Gr1fEH zkCL|1`V_Stq@A?xqV^K$Ra#%Cwukf%t?yEMpXBUid)-KoZeMwqvfKY?9YgIo;$PTE83JJjAKy-zC+yzW*VNg54ukH6H$kPfAF9JM1z zAzF{2CP#a>|Ir$zRzs?z^#p3ONR6~Mj?;J}oq41dQY)#0w3KuPX&EU->LDdb8B(6q zM>?OhinN*}zt5AJk9000ttG7|Z6IAs+DN*AbTjD|(q__~q?# zinN2YleCNU66sY^$5dPMrKB@R%SbWO&2@H8IBSNb9i&|(XQoCT;fyAYBZWv6q%f(D zG>bHk)Jj@PT1JwmKj`eWkF+dN?J-+7~OLa7qt$}(~LD_hq-=`Uh zJlDocbq18pfmBH-^2`*^=VFNy$o(oP?*_KcjZns5to3So7nJZ=f1D>o38eZ16nVan zm)8hXaaEvI$3kfhC`Un&r^9%uWBJ6|sfjy9gp z&!EVx8!NZ3J_!sT?)P~^e8&5gQ6nAmydW>m1Sop~?OY9IZOET$7L<)>5ihR=P@JRu zK4(E06X@aRLJ3Xu`+N;bCZJpiWluo)o}@b7pK1#fd1jAS=AS|73zX+cC~E`CYfxk+ zt7Vqwz~Kq!d3m;x7w1Fx$Wxd+<$%4>hLiouC!y>KY~_hiwxXt9sv0Ogf$h}@MV^1; z`FsJ&n1D|&l+8HKdp_qv*~m7OGRs5VGC0zCK9|5}9P5Rx;9Lh~SD+{Sr$lBP@%bf` zF@aRiL6I{#Z=1dfWpu#jLnux_IUKu@oY#4&ra_Uh!&Bx$k!M@B zo=*-+Phdp4P*TnI`+Nt=szAMNgR;57@3R|uEC$3WQ}@Tq|!Pj2&kTA^$W z^r&S}-Sse#fHP)>%j zG@$fAnHNwlg;Ez#z6a%=KrOaF*_H6;z75JO)&c{A^8%EONx#p#k}5E69DD%!SU{Nq zWlum^1Z5zwz2cH8P@V#mRRN!ip!5WkZ$jA^P~@poa+LA*rvHQz3MjvXA`5mZ%&6sm zY&>^CBbntT_>2yudI!qJKrO}{h@KGeserO4P>VV!a*pGbXTGGm#@~i#NveR)1yD9q zsm$ZuFmAb|q-7(%kMs-WNW`U5-e%zST`7+fJ2VisEh^Ri1KvB%msPDN^>s{Ms(+^Qj``_#$OSk#cg8vb;#?FH$Zq zQod89+*+jESETGLQr;?34#ru6U9_f01r$6MI}u5ym#a?*E!K^9l-d;7gWNWp!cw#`}`+rZ=0LjeJ`mRd2kvE5i9a+b#f{^uhA7c|8e_g)M3F_FIH!wM?hPop93Clbt7Rg)uhklq z>Pe<@5P3KLsx;%mG3TCpuEk2c!!MK1R@$o{coB!ZiOD|0SsoEx^Z@Dz9xbmgBhYIl zc(yj)16rKKeJ!+W=)+^W2fxi*j?KktBoa#|&BMO&?xq+n)418VPrbKKMs^|*dAE2Z zQaLqTT|J}DJkJ{C3Or$3av1!;X@9yIQ>U?fT2Z{2!S`rszi&<5RNpi3OFe_%=Up>3 zTwClNeCE5~Jv?K&&)xTkdB4+CmR6nzF7MW~&!yIS@Z-y?!FW?VQfm@-&HeeYHXqPDek`4H(5i;eZgG*RP!E## z6`&>@MuB7_N-o&4c(Idg;;w8WgBP#ywZqMU7cw(}J^YA!5|LX$$rZ7%Tq%l9T4uj=#G}1$jT;eUn zMK9cRMBzKRrLUG4x6yi;e!jUy-}~Ti{F%mFiyiQlJMcLZ$mp^g>R zwLDgong;j|@3kz|;GR`oT{X==b_`p+nyJ(L$MC_gX7H81W@=T9FYK_zs|n-bW!~^5 zM-cD58PQ}Of_X`#KYVzae|H(C$JT_Wg}t6F!?EuLJ-&$5wTNhUn}4MU)zdJbXo8_% z)8fyddYYXp4LhZ(#solK;TpkPSM*3$iPv`JE2qxzkDtRGo~vin)cSXq>ghA81Ao^| ztqS}-eR>T?vDTjcTmnM^b}M`I^jBg=)eO2~+?*@#nspn&91R-gM=&%;%vrW<2b}^sqYsVw!x-N=cbeigubjq zU&m5B*kPoT7txg%2E`)dVnfpq#(4|dJ0cAW7j(2OY-zzj=`V9tO<+z{J+*F{-(FQW zW01YJCSad|A;lkW>Y$ArMyGI3V1_zt@h1;YuQhM@lb7lg&&eYBcy9)8rf}%75!FM($W2C&I$G)U}s0zA0)w)F@iQY`4N#6F> zkWJ*J+qdHl3339brj~egMZB~Lowp^L%Qt1Sm|v>5?5?pw#{DawHZNUs|1!swd3rvk z-i@1{p~t=V)}J>DpYm;Jip5)?W4!Go8Qf6@DT=q;EH!q7jiOCyIwq3Q;RKzJLk1lHV$4?*oA3WKhDCX z)9V(oiOf5a-J!@a<&GtCsF1uQIv|_NMgb)km5qiI1|7&8lMt6C;&LvtB8OcCvm!HY Mn{8w-TI~0K0PrdT&j0`b literal 0 HcmV?d00001 diff --git a/libusb.h b/libusb.h new file mode 100644 index 0000000..2592ea7 --- /dev/null +++ b/libusb.h @@ -0,0 +1,2142 @@ +/* + * Public libusb header file + * Copyright © 2001 Johannes Erdfelt + * Copyright © 2007-2008 Daniel Drake + * Copyright © 2012 Pete Batard + * Copyright © 2012-2018 Nathan Hjelm + * Copyright © 2014-2020 Chris Dickens + * For more information, please visit: http://libusb.info + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +#ifndef LIBUSB_H +#define LIBUSB_H + +#if defined(_MSC_VER) +#pragma warning(push) +/* Disable: warning C4200: nonstandard extension used : zero-sized array in struct/union */ +#pragma warning(disable:4200) +/* on MS environments, the inline keyword is available in C++ only */ +#if !defined(__cplusplus) +#define inline __inline +#endif +/* ssize_t is also not available */ +#ifndef _SSIZE_T_DEFINED +#define _SSIZE_T_DEFINED +#include +typedef SSIZE_T ssize_t; +#endif /* _SSIZE_T_DEFINED */ +#endif /* _MSC_VER */ + +#include +#include +#include +#if !defined(_MSC_VER) +#include +#endif +#include + +#if defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) +#define ZERO_SIZED_ARRAY /* [] - valid C99 code */ +#else +#define ZERO_SIZED_ARRAY 0 /* [0] - non-standard, but usually working code */ +#endif /* __STDC_VERSION__ */ + +/* 'interface' might be defined as a macro on Windows, so we need to + * undefine it so as not to break the current libusb API, because + * libusb_config_descriptor has an 'interface' member + * As this can be problematic if you include windows.h after libusb.h + * in your sources, we force windows.h to be included first. */ +#if defined(_WIN32) || defined(__CYGWIN__) +#include +#if defined(interface) +#undef interface +#endif +#if !defined(__CYGWIN__) +#include +#endif +#endif /* _WIN32 || __CYGWIN__ */ + +#if defined(__GNUC__) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5)) +#define LIBUSB_DEPRECATED_FOR(f) __attribute__ ((deprecated ("Use " #f " instead"))) +#elif defined(__GNUC__) && (__GNUC__ >= 3) +#define LIBUSB_DEPRECATED_FOR(f) __attribute__ ((deprecated)) +#else +#define LIBUSB_DEPRECATED_FOR(f) +#endif /* __GNUC__ */ + +#if defined(__GNUC__) +#define LIBUSB_PACKED __attribute__ ((packed)) +#else +#define LIBUSB_PACKED +#endif /* __GNUC__ */ + +/** \def LIBUSB_CALL + * \ingroup libusb_misc + * libusb's Windows calling convention. + * + * Under Windows, the selection of available compilers and configurations + * means that, unlike other platforms, there is not one true calling + * convention (calling convention: the manner in which parameters are + * passed to functions in the generated assembly code). + * + * Matching the Windows API itself, libusb uses the WINAPI convention (which + * translates to the stdcall convention) and guarantees that the + * library is compiled in this way. The public header file also includes + * appropriate annotations so that your own software will use the right + * convention, even if another convention is being used by default within + * your codebase. + * + * The one consideration that you must apply in your software is to mark + * all functions which you use as libusb callbacks with this LIBUSB_CALL + * annotation, so that they too get compiled for the correct calling + * convention. + * + * On non-Windows operating systems, this macro is defined as nothing. This + * means that you can apply it to your code without worrying about + * cross-platform compatibility. + */ +/* LIBUSB_CALL must be defined on both definition and declaration of libusb + * functions. You'd think that declaration would be enough, but cygwin will + * complain about conflicting types unless both are marked this way. + * The placement of this macro is important too; it must appear after the + * return type, before the function name. See internal documentation for + * API_EXPORTED. + */ +#if defined(_WIN32) || defined(__CYGWIN__) +#define LIBUSB_CALL WINAPI +#else +#define LIBUSB_CALL +#endif /* _WIN32 || __CYGWIN__ */ + +/** \def LIBUSB_API_VERSION + * \ingroup libusb_misc + * libusb's API version. + * + * Since version 1.0.13, to help with feature detection, libusb defines + * a LIBUSB_API_VERSION macro that gets increased every time there is a + * significant change to the API, such as the introduction of a new call, + * the definition of a new macro/enum member, or any other element that + * libusb applications may want to detect at compilation time. + * + * The macro is typically used in an application as follows: + * \code + * #if defined(LIBUSB_API_VERSION) && (LIBUSB_API_VERSION >= 0x01001234) + * // Use one of the newer features from the libusb API + * #endif + * \endcode + * + * Internally, LIBUSB_API_VERSION is defined as follows: + * (libusb major << 24) | (libusb minor << 16) | (16 bit incremental) + */ +#define LIBUSB_API_VERSION 0x01000109 + +/* The following is kept for compatibility, but will be deprecated in the future */ +#define LIBUSBX_API_VERSION LIBUSB_API_VERSION + +#if defined(__cplusplus) +extern "C" { +#endif + +/** + * \ingroup libusb_misc + * Convert a 16-bit value from host-endian to little-endian format. On + * little endian systems, this function does nothing. On big endian systems, + * the bytes are swapped. + * \param x the host-endian value to convert + * \returns the value in little-endian byte order + */ +static inline uint16_t libusb_cpu_to_le16(const uint16_t x) +{ + union { + uint8_t b8[2]; + uint16_t b16; + } _tmp; + _tmp.b8[1] = (uint8_t) (x >> 8); + _tmp.b8[0] = (uint8_t) (x & 0xff); + return _tmp.b16; +} + +/** \def libusb_le16_to_cpu + * \ingroup libusb_misc + * Convert a 16-bit value from little-endian to host-endian format. On + * little endian systems, this function does nothing. On big endian systems, + * the bytes are swapped. + * \param x the little-endian value to convert + * \returns the value in host-endian byte order + */ +#define libusb_le16_to_cpu libusb_cpu_to_le16 + +/* standard USB stuff */ + +/** \ingroup libusb_desc + * Device and/or Interface Class codes */ +enum libusb_class_code { + /** In the context of a \ref libusb_device_descriptor "device descriptor", + * this bDeviceClass value indicates that each interface specifies its + * own class information and all interfaces operate independently. + */ + LIBUSB_CLASS_PER_INTERFACE = 0x00, + + /** Audio class */ + LIBUSB_CLASS_AUDIO = 0x01, + + /** Communications class */ + LIBUSB_CLASS_COMM = 0x02, + + /** Human Interface Device class */ + LIBUSB_CLASS_HID = 0x03, + + /** Physical */ + LIBUSB_CLASS_PHYSICAL = 0x05, + + /** Image class */ + LIBUSB_CLASS_IMAGE = 0x06, + LIBUSB_CLASS_PTP = 0x06, /* legacy name from libusb-0.1 usb.h */ + + /** Printer class */ + LIBUSB_CLASS_PRINTER = 0x07, + + /** Mass storage class */ + LIBUSB_CLASS_MASS_STORAGE = 0x08, + + /** Hub class */ + LIBUSB_CLASS_HUB = 0x09, + + /** Data class */ + LIBUSB_CLASS_DATA = 0x0a, + + /** Smart Card */ + LIBUSB_CLASS_SMART_CARD = 0x0b, + + /** Content Security */ + LIBUSB_CLASS_CONTENT_SECURITY = 0x0d, + + /** Video */ + LIBUSB_CLASS_VIDEO = 0x0e, + + /** Personal Healthcare */ + LIBUSB_CLASS_PERSONAL_HEALTHCARE = 0x0f, + + /** Diagnostic Device */ + LIBUSB_CLASS_DIAGNOSTIC_DEVICE = 0xdc, + + /** Wireless class */ + LIBUSB_CLASS_WIRELESS = 0xe0, + + /** Miscellaneous class */ + LIBUSB_CLASS_MISCELLANEOUS = 0xef, + + /** Application class */ + LIBUSB_CLASS_APPLICATION = 0xfe, + + /** Class is vendor-specific */ + LIBUSB_CLASS_VENDOR_SPEC = 0xff +}; + +/** \ingroup libusb_desc + * Descriptor types as defined by the USB specification. */ +enum libusb_descriptor_type { + /** Device descriptor. See libusb_device_descriptor. */ + LIBUSB_DT_DEVICE = 0x01, + + /** Configuration descriptor. See libusb_config_descriptor. */ + LIBUSB_DT_CONFIG = 0x02, + + /** String descriptor */ + LIBUSB_DT_STRING = 0x03, + + /** Interface descriptor. See libusb_interface_descriptor. */ + LIBUSB_DT_INTERFACE = 0x04, + + /** Endpoint descriptor. See libusb_endpoint_descriptor. */ + LIBUSB_DT_ENDPOINT = 0x05, + + /** BOS descriptor */ + LIBUSB_DT_BOS = 0x0f, + + /** Device Capability descriptor */ + LIBUSB_DT_DEVICE_CAPABILITY = 0x10, + + /** HID descriptor */ + LIBUSB_DT_HID = 0x21, + + /** HID report descriptor */ + LIBUSB_DT_REPORT = 0x22, + + /** Physical descriptor */ + LIBUSB_DT_PHYSICAL = 0x23, + + /** Hub descriptor */ + LIBUSB_DT_HUB = 0x29, + + /** SuperSpeed Hub descriptor */ + LIBUSB_DT_SUPERSPEED_HUB = 0x2a, + + /** SuperSpeed Endpoint Companion descriptor */ + LIBUSB_DT_SS_ENDPOINT_COMPANION = 0x30 +}; + +/* Descriptor sizes per descriptor type */ +#define LIBUSB_DT_DEVICE_SIZE 18 +#define LIBUSB_DT_CONFIG_SIZE 9 +#define LIBUSB_DT_INTERFACE_SIZE 9 +#define LIBUSB_DT_ENDPOINT_SIZE 7 +#define LIBUSB_DT_ENDPOINT_AUDIO_SIZE 9 /* Audio extension */ +#define LIBUSB_DT_HUB_NONVAR_SIZE 7 +#define LIBUSB_DT_SS_ENDPOINT_COMPANION_SIZE 6 +#define LIBUSB_DT_BOS_SIZE 5 +#define LIBUSB_DT_DEVICE_CAPABILITY_SIZE 3 + +/* BOS descriptor sizes */ +#define LIBUSB_BT_USB_2_0_EXTENSION_SIZE 7 +#define LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE 10 +#define LIBUSB_BT_CONTAINER_ID_SIZE 20 + +/* We unwrap the BOS => define its max size */ +#define LIBUSB_DT_BOS_MAX_SIZE \ + (LIBUSB_DT_BOS_SIZE + \ + LIBUSB_BT_USB_2_0_EXTENSION_SIZE + \ + LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE + \ + LIBUSB_BT_CONTAINER_ID_SIZE) + +#define LIBUSB_ENDPOINT_ADDRESS_MASK 0x0f /* in bEndpointAddress */ +#define LIBUSB_ENDPOINT_DIR_MASK 0x80 + +/** \ingroup libusb_desc + * Endpoint direction. Values for bit 7 of the + * \ref libusb_endpoint_descriptor::bEndpointAddress "endpoint address" scheme. + */ +enum libusb_endpoint_direction { + /** Out: host-to-device */ + LIBUSB_ENDPOINT_OUT = 0x00, + + /** In: device-to-host */ + LIBUSB_ENDPOINT_IN = 0x80 +}; + +#define LIBUSB_TRANSFER_TYPE_MASK 0x03 /* in bmAttributes */ + +/** \ingroup libusb_desc + * Endpoint transfer type. Values for bits 0:1 of the + * \ref libusb_endpoint_descriptor::bmAttributes "endpoint attributes" field. + */ +enum libusb_endpoint_transfer_type { + /** Control endpoint */ + LIBUSB_ENDPOINT_TRANSFER_TYPE_CONTROL = 0x0, + + /** Isochronous endpoint */ + LIBUSB_ENDPOINT_TRANSFER_TYPE_ISOCHRONOUS = 0x1, + + /** Bulk endpoint */ + LIBUSB_ENDPOINT_TRANSFER_TYPE_BULK = 0x2, + + /** Interrupt endpoint */ + LIBUSB_ENDPOINT_TRANSFER_TYPE_INTERRUPT = 0x3 +}; + +/** \ingroup libusb_misc + * Standard requests, as defined in table 9-5 of the USB 3.0 specifications */ +enum libusb_standard_request { + /** Request status of the specific recipient */ + LIBUSB_REQUEST_GET_STATUS = 0x00, + + /** Clear or disable a specific feature */ + LIBUSB_REQUEST_CLEAR_FEATURE = 0x01, + + /* 0x02 is reserved */ + + /** Set or enable a specific feature */ + LIBUSB_REQUEST_SET_FEATURE = 0x03, + + /* 0x04 is reserved */ + + /** Set device address for all future accesses */ + LIBUSB_REQUEST_SET_ADDRESS = 0x05, + + /** Get the specified descriptor */ + LIBUSB_REQUEST_GET_DESCRIPTOR = 0x06, + + /** Used to update existing descriptors or add new descriptors */ + LIBUSB_REQUEST_SET_DESCRIPTOR = 0x07, + + /** Get the current device configuration value */ + LIBUSB_REQUEST_GET_CONFIGURATION = 0x08, + + /** Set device configuration */ + LIBUSB_REQUEST_SET_CONFIGURATION = 0x09, + + /** Return the selected alternate setting for the specified interface */ + LIBUSB_REQUEST_GET_INTERFACE = 0x0a, + + /** Select an alternate interface for the specified interface */ + LIBUSB_REQUEST_SET_INTERFACE = 0x0b, + + /** Set then report an endpoint's synchronization frame */ + LIBUSB_REQUEST_SYNCH_FRAME = 0x0c, + + /** Sets both the U1 and U2 Exit Latency */ + LIBUSB_REQUEST_SET_SEL = 0x30, + + /** Delay from the time a host transmits a packet to the time it is + * received by the device. */ + LIBUSB_SET_ISOCH_DELAY = 0x31 +}; + +/** \ingroup libusb_misc + * Request type bits of the + * \ref libusb_control_setup::bmRequestType "bmRequestType" field in control + * transfers. */ +enum libusb_request_type { + /** Standard */ + LIBUSB_REQUEST_TYPE_STANDARD = (0x00 << 5), + + /** Class */ + LIBUSB_REQUEST_TYPE_CLASS = (0x01 << 5), + + /** Vendor */ + LIBUSB_REQUEST_TYPE_VENDOR = (0x02 << 5), + + /** Reserved */ + LIBUSB_REQUEST_TYPE_RESERVED = (0x03 << 5) +}; + +/** \ingroup libusb_misc + * Recipient bits of the + * \ref libusb_control_setup::bmRequestType "bmRequestType" field in control + * transfers. Values 4 through 31 are reserved. */ +enum libusb_request_recipient { + /** Device */ + LIBUSB_RECIPIENT_DEVICE = 0x00, + + /** Interface */ + LIBUSB_RECIPIENT_INTERFACE = 0x01, + + /** Endpoint */ + LIBUSB_RECIPIENT_ENDPOINT = 0x02, + + /** Other */ + LIBUSB_RECIPIENT_OTHER = 0x03 +}; + +#define LIBUSB_ISO_SYNC_TYPE_MASK 0x0c + +/** \ingroup libusb_desc + * Synchronization type for isochronous endpoints. Values for bits 2:3 of the + * \ref libusb_endpoint_descriptor::bmAttributes "bmAttributes" field in + * libusb_endpoint_descriptor. + */ +enum libusb_iso_sync_type { + /** No synchronization */ + LIBUSB_ISO_SYNC_TYPE_NONE = 0x0, + + /** Asynchronous */ + LIBUSB_ISO_SYNC_TYPE_ASYNC = 0x1, + + /** Adaptive */ + LIBUSB_ISO_SYNC_TYPE_ADAPTIVE = 0x2, + + /** Synchronous */ + LIBUSB_ISO_SYNC_TYPE_SYNC = 0x3 +}; + +#define LIBUSB_ISO_USAGE_TYPE_MASK 0x30 + +/** \ingroup libusb_desc + * Usage type for isochronous endpoints. Values for bits 4:5 of the + * \ref libusb_endpoint_descriptor::bmAttributes "bmAttributes" field in + * libusb_endpoint_descriptor. + */ +enum libusb_iso_usage_type { + /** Data endpoint */ + LIBUSB_ISO_USAGE_TYPE_DATA = 0x0, + + /** Feedback endpoint */ + LIBUSB_ISO_USAGE_TYPE_FEEDBACK = 0x1, + + /** Implicit feedback Data endpoint */ + LIBUSB_ISO_USAGE_TYPE_IMPLICIT = 0x2 +}; + +/** \ingroup libusb_desc + * Supported speeds (wSpeedSupported) bitfield. Indicates what + * speeds the device supports. + */ +enum libusb_supported_speed { + /** Low speed operation supported (1.5MBit/s). */ + LIBUSB_LOW_SPEED_OPERATION = (1 << 0), + + /** Full speed operation supported (12MBit/s). */ + LIBUSB_FULL_SPEED_OPERATION = (1 << 1), + + /** High speed operation supported (480MBit/s). */ + LIBUSB_HIGH_SPEED_OPERATION = (1 << 2), + + /** Superspeed operation supported (5000MBit/s). */ + LIBUSB_SUPER_SPEED_OPERATION = (1 << 3) +}; + +/** \ingroup libusb_desc + * Masks for the bits of the + * \ref libusb_usb_2_0_extension_descriptor::bmAttributes "bmAttributes" field + * of the USB 2.0 Extension descriptor. + */ +enum libusb_usb_2_0_extension_attributes { + /** Supports Link Power Management (LPM) */ + LIBUSB_BM_LPM_SUPPORT = (1 << 1) +}; + +/** \ingroup libusb_desc + * Masks for the bits of the + * \ref libusb_ss_usb_device_capability_descriptor::bmAttributes "bmAttributes" field + * field of the SuperSpeed USB Device Capability descriptor. + */ +enum libusb_ss_usb_device_capability_attributes { + /** Supports Latency Tolerance Messages (LTM) */ + LIBUSB_BM_LTM_SUPPORT = (1 << 1) +}; + +/** \ingroup libusb_desc + * USB capability types + */ +enum libusb_bos_type { + /** Wireless USB device capability */ + LIBUSB_BT_WIRELESS_USB_DEVICE_CAPABILITY = 0x01, + + /** USB 2.0 extensions */ + LIBUSB_BT_USB_2_0_EXTENSION = 0x02, + + /** SuperSpeed USB device capability */ + LIBUSB_BT_SS_USB_DEVICE_CAPABILITY = 0x03, + + /** Container ID type */ + LIBUSB_BT_CONTAINER_ID = 0x04 +}; + +/** \ingroup libusb_desc + * A structure representing the standard USB device descriptor. This + * descriptor is documented in section 9.6.1 of the USB 3.0 specification. + * All multiple-byte fields are represented in host-endian format. + */ +struct libusb_device_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_DEVICE LIBUSB_DT_DEVICE in this + * context. */ + uint8_t bDescriptorType; + + /** USB specification release number in binary-coded decimal. A value of + * 0x0200 indicates USB 2.0, 0x0110 indicates USB 1.1, etc. */ + uint16_t bcdUSB; + + /** USB-IF class code for the device. See \ref libusb_class_code. */ + uint8_t bDeviceClass; + + /** USB-IF subclass code for the device, qualified by the bDeviceClass + * value */ + uint8_t bDeviceSubClass; + + /** USB-IF protocol code for the device, qualified by the bDeviceClass and + * bDeviceSubClass values */ + uint8_t bDeviceProtocol; + + /** Maximum packet size for endpoint 0 */ + uint8_t bMaxPacketSize0; + + /** USB-IF vendor ID */ + uint16_t idVendor; + + /** USB-IF product ID */ + uint16_t idProduct; + + /** Device release number in binary-coded decimal */ + uint16_t bcdDevice; + + /** Index of string descriptor describing manufacturer */ + uint8_t iManufacturer; + + /** Index of string descriptor describing product */ + uint8_t iProduct; + + /** Index of string descriptor containing device serial number */ + uint8_t iSerialNumber; + + /** Number of possible configurations */ + uint8_t bNumConfigurations; +}; + +/** \ingroup libusb_desc + * A structure representing the standard USB endpoint descriptor. This + * descriptor is documented in section 9.6.6 of the USB 3.0 specification. + * All multiple-byte fields are represented in host-endian format. + */ +struct libusb_endpoint_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_ENDPOINT LIBUSB_DT_ENDPOINT in + * this context. */ + uint8_t bDescriptorType; + + /** The address of the endpoint described by this descriptor. Bits 0:3 are + * the endpoint number. Bits 4:6 are reserved. Bit 7 indicates direction, + * see \ref libusb_endpoint_direction. */ + uint8_t bEndpointAddress; + + /** Attributes which apply to the endpoint when it is configured using + * the bConfigurationValue. Bits 0:1 determine the transfer type and + * correspond to \ref libusb_endpoint_transfer_type. Bits 2:3 are only used + * for isochronous endpoints and correspond to \ref libusb_iso_sync_type. + * Bits 4:5 are also only used for isochronous endpoints and correspond to + * \ref libusb_iso_usage_type. Bits 6:7 are reserved. */ + uint8_t bmAttributes; + + /** Maximum packet size this endpoint is capable of sending/receiving. */ + uint16_t wMaxPacketSize; + + /** Interval for polling endpoint for data transfers. */ + uint8_t bInterval; + + /** For audio devices only: the rate at which synchronization feedback + * is provided. */ + uint8_t bRefresh; + + /** For audio devices only: the address if the synch endpoint */ + uint8_t bSynchAddress; + + /** Extra descriptors. If libusb encounters unknown endpoint descriptors, + * it will store them here, should you wish to parse them. */ + const unsigned char *extra; + + /** Length of the extra descriptors, in bytes. Must be non-negative. */ + int extra_length; +}; + +/** \ingroup libusb_desc + * A structure representing the standard USB interface descriptor. This + * descriptor is documented in section 9.6.5 of the USB 3.0 specification. + * All multiple-byte fields are represented in host-endian format. + */ +struct libusb_interface_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_INTERFACE LIBUSB_DT_INTERFACE + * in this context. */ + uint8_t bDescriptorType; + + /** Number of this interface */ + uint8_t bInterfaceNumber; + + /** Value used to select this alternate setting for this interface */ + uint8_t bAlternateSetting; + + /** Number of endpoints used by this interface (excluding the control + * endpoint). */ + uint8_t bNumEndpoints; + + /** USB-IF class code for this interface. See \ref libusb_class_code. */ + uint8_t bInterfaceClass; + + /** USB-IF subclass code for this interface, qualified by the + * bInterfaceClass value */ + uint8_t bInterfaceSubClass; + + /** USB-IF protocol code for this interface, qualified by the + * bInterfaceClass and bInterfaceSubClass values */ + uint8_t bInterfaceProtocol; + + /** Index of string descriptor describing this interface */ + uint8_t iInterface; + + /** Array of endpoint descriptors. This length of this array is determined + * by the bNumEndpoints field. */ + const struct libusb_endpoint_descriptor *endpoint; + + /** Extra descriptors. If libusb encounters unknown interface descriptors, + * it will store them here, should you wish to parse them. */ + const unsigned char *extra; + + /** Length of the extra descriptors, in bytes. Must be non-negative. */ + int extra_length; +}; + +/** \ingroup libusb_desc + * A collection of alternate settings for a particular USB interface. + */ +struct libusb_interface { + /** Array of interface descriptors. The length of this array is determined + * by the num_altsetting field. */ + const struct libusb_interface_descriptor *altsetting; + + /** The number of alternate settings that belong to this interface. + * Must be non-negative. */ + int num_altsetting; +}; + +/** \ingroup libusb_desc + * A structure representing the standard USB configuration descriptor. This + * descriptor is documented in section 9.6.3 of the USB 3.0 specification. + * All multiple-byte fields are represented in host-endian format. + */ +struct libusb_config_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_CONFIG LIBUSB_DT_CONFIG + * in this context. */ + uint8_t bDescriptorType; + + /** Total length of data returned for this configuration */ + uint16_t wTotalLength; + + /** Number of interfaces supported by this configuration */ + uint8_t bNumInterfaces; + + /** Identifier value for this configuration */ + uint8_t bConfigurationValue; + + /** Index of string descriptor describing this configuration */ + uint8_t iConfiguration; + + /** Configuration characteristics */ + uint8_t bmAttributes; + + /** Maximum power consumption of the USB device from this bus in this + * configuration when the device is fully operation. Expressed in units + * of 2 mA when the device is operating in high-speed mode and in units + * of 8 mA when the device is operating in super-speed mode. */ + uint8_t MaxPower; + + /** Array of interfaces supported by this configuration. The length of + * this array is determined by the bNumInterfaces field. */ + const struct libusb_interface *interface; + + /** Extra descriptors. If libusb encounters unknown configuration + * descriptors, it will store them here, should you wish to parse them. */ + const unsigned char *extra; + + /** Length of the extra descriptors, in bytes. Must be non-negative. */ + int extra_length; +}; + +/** \ingroup libusb_desc + * A structure representing the superspeed endpoint companion + * descriptor. This descriptor is documented in section 9.6.7 of + * the USB 3.0 specification. All multiple-byte fields are represented in + * host-endian format. + */ +struct libusb_ss_endpoint_companion_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_SS_ENDPOINT_COMPANION in + * this context. */ + uint8_t bDescriptorType; + + /** The maximum number of packets the endpoint can send or + * receive as part of a burst. */ + uint8_t bMaxBurst; + + /** In bulk EP: bits 4:0 represents the maximum number of + * streams the EP supports. In isochronous EP: bits 1:0 + * represents the Mult - a zero based value that determines + * the maximum number of packets within a service interval */ + uint8_t bmAttributes; + + /** The total number of bytes this EP will transfer every + * service interval. Valid only for periodic EPs. */ + uint16_t wBytesPerInterval; +}; + +/** \ingroup libusb_desc + * A generic representation of a BOS Device Capability descriptor. It is + * advised to check bDevCapabilityType and call the matching + * libusb_get_*_descriptor function to get a structure fully matching the type. + */ +struct libusb_bos_dev_capability_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_DEVICE_CAPABILITY + * LIBUSB_DT_DEVICE_CAPABILITY in this context. */ + uint8_t bDescriptorType; + + /** Device Capability type */ + uint8_t bDevCapabilityType; + + /** Device Capability data (bLength - 3 bytes) */ + uint8_t dev_capability_data[ZERO_SIZED_ARRAY]; +}; + +/** \ingroup libusb_desc + * A structure representing the Binary Device Object Store (BOS) descriptor. + * This descriptor is documented in section 9.6.2 of the USB 3.0 specification. + * All multiple-byte fields are represented in host-endian format. + */ +struct libusb_bos_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_BOS LIBUSB_DT_BOS + * in this context. */ + uint8_t bDescriptorType; + + /** Length of this descriptor and all of its sub descriptors */ + uint16_t wTotalLength; + + /** The number of separate device capability descriptors in + * the BOS */ + uint8_t bNumDeviceCaps; + + /** bNumDeviceCap Device Capability Descriptors */ + struct libusb_bos_dev_capability_descriptor *dev_capability[ZERO_SIZED_ARRAY]; +}; + +/** \ingroup libusb_desc + * A structure representing the USB 2.0 Extension descriptor + * This descriptor is documented in section 9.6.2.1 of the USB 3.0 specification. + * All multiple-byte fields are represented in host-endian format. + */ +struct libusb_usb_2_0_extension_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_DEVICE_CAPABILITY + * LIBUSB_DT_DEVICE_CAPABILITY in this context. */ + uint8_t bDescriptorType; + + /** Capability type. Will have value + * \ref libusb_capability_type::LIBUSB_BT_USB_2_0_EXTENSION + * LIBUSB_BT_USB_2_0_EXTENSION in this context. */ + uint8_t bDevCapabilityType; + + /** Bitmap encoding of supported device level features. + * A value of one in a bit location indicates a feature is + * supported; a value of zero indicates it is not supported. + * See \ref libusb_usb_2_0_extension_attributes. */ + uint32_t bmAttributes; +}; + +/** \ingroup libusb_desc + * A structure representing the SuperSpeed USB Device Capability descriptor + * This descriptor is documented in section 9.6.2.2 of the USB 3.0 specification. + * All multiple-byte fields are represented in host-endian format. + */ +struct libusb_ss_usb_device_capability_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_DEVICE_CAPABILITY + * LIBUSB_DT_DEVICE_CAPABILITY in this context. */ + uint8_t bDescriptorType; + + /** Capability type. Will have value + * \ref libusb_capability_type::LIBUSB_BT_SS_USB_DEVICE_CAPABILITY + * LIBUSB_BT_SS_USB_DEVICE_CAPABILITY in this context. */ + uint8_t bDevCapabilityType; + + /** Bitmap encoding of supported device level features. + * A value of one in a bit location indicates a feature is + * supported; a value of zero indicates it is not supported. + * See \ref libusb_ss_usb_device_capability_attributes. */ + uint8_t bmAttributes; + + /** Bitmap encoding of the speed supported by this device when + * operating in SuperSpeed mode. See \ref libusb_supported_speed. */ + uint16_t wSpeedSupported; + + /** The lowest speed at which all the functionality supported + * by the device is available to the user. For example if the + * device supports all its functionality when connected at + * full speed and above then it sets this value to 1. */ + uint8_t bFunctionalitySupport; + + /** U1 Device Exit Latency. */ + uint8_t bU1DevExitLat; + + /** U2 Device Exit Latency. */ + uint16_t bU2DevExitLat; +}; + +/** \ingroup libusb_desc + * A structure representing the Container ID descriptor. + * This descriptor is documented in section 9.6.2.3 of the USB 3.0 specification. + * All multiple-byte fields, except UUIDs, are represented in host-endian format. + */ +struct libusb_container_id_descriptor { + /** Size of this descriptor (in bytes) */ + uint8_t bLength; + + /** Descriptor type. Will have value + * \ref libusb_descriptor_type::LIBUSB_DT_DEVICE_CAPABILITY + * LIBUSB_DT_DEVICE_CAPABILITY in this context. */ + uint8_t bDescriptorType; + + /** Capability type. Will have value + * \ref libusb_capability_type::LIBUSB_BT_CONTAINER_ID + * LIBUSB_BT_CONTAINER_ID in this context. */ + uint8_t bDevCapabilityType; + + /** Reserved field */ + uint8_t bReserved; + + /** 128 bit UUID */ + uint8_t ContainerID[16]; +}; + +/** \ingroup libusb_asyncio + * Setup packet for control transfers. */ +#if defined(_MSC_VER) || defined(__WATCOMC__) +#pragma pack(push, 1) +#endif +struct libusb_control_setup { + /** Request type. Bits 0:4 determine recipient, see + * \ref libusb_request_recipient. Bits 5:6 determine type, see + * \ref libusb_request_type. Bit 7 determines data transfer direction, see + * \ref libusb_endpoint_direction. + */ + uint8_t bmRequestType; + + /** Request. If the type bits of bmRequestType are equal to + * \ref libusb_request_type::LIBUSB_REQUEST_TYPE_STANDARD + * "LIBUSB_REQUEST_TYPE_STANDARD" then this field refers to + * \ref libusb_standard_request. For other cases, use of this field is + * application-specific. */ + uint8_t bRequest; + + /** Value. Varies according to request */ + uint16_t wValue; + + /** Index. Varies according to request, typically used to pass an index + * or offset */ + uint16_t wIndex; + + /** Number of bytes to transfer */ + uint16_t wLength; +} LIBUSB_PACKED; +#if defined(_MSC_VER) || defined(__WATCOMC__) +#pragma pack(pop) +#endif + +#define LIBUSB_CONTROL_SETUP_SIZE (sizeof(struct libusb_control_setup)) + +/* libusb */ + +struct libusb_context; +struct libusb_device; +struct libusb_device_handle; + +/** \ingroup libusb_lib + * Structure providing the version of the libusb runtime + */ +struct libusb_version { + /** Library major version. */ + const uint16_t major; + + /** Library minor version. */ + const uint16_t minor; + + /** Library micro version. */ + const uint16_t micro; + + /** Library nano version. */ + const uint16_t nano; + + /** Library release candidate suffix string, e.g. "-rc4". */ + const char *rc; + + /** For ABI compatibility only. */ + const char *describe; +}; + +/** \ingroup libusb_lib + * Structure representing a libusb session. The concept of individual libusb + * sessions allows for your program to use two libraries (or dynamically + * load two modules) which both independently use libusb. This will prevent + * interference between the individual libusb users - for example + * libusb_set_option() will not affect the other user of the library, and + * libusb_exit() will not destroy resources that the other user is still + * using. + * + * Sessions are created by libusb_init() and destroyed through libusb_exit(). + * If your application is guaranteed to only ever include a single libusb + * user (i.e. you), you do not have to worry about contexts: pass NULL in + * every function call where a context is required, and the default context + * will be used. Note that libusb_set_option(NULL, ...) is special, and adds + * an option to a list of default options for new contexts. + * + * For more information, see \ref libusb_contexts. + */ +typedef struct libusb_context libusb_context; + +/** \ingroup libusb_dev + * Structure representing a USB device detected on the system. This is an + * opaque type for which you are only ever provided with a pointer, usually + * originating from libusb_get_device_list() or libusb_hotplug_register_callback(). + * + * Certain operations can be performed on a device, but in order to do any + * I/O you will have to first obtain a device handle using libusb_open(). + * + * Devices are reference counted with libusb_ref_device() and + * libusb_unref_device(), and are freed when the reference count reaches 0. + * New devices presented by libusb_get_device_list() have a reference count of + * 1, and libusb_free_device_list() can optionally decrease the reference count + * on all devices in the list. libusb_open() adds another reference which is + * later destroyed by libusb_close(). + */ +typedef struct libusb_device libusb_device; + + +/** \ingroup libusb_dev + * Structure representing a handle on a USB device. This is an opaque type for + * which you are only ever provided with a pointer, usually originating from + * libusb_open(). + * + * A device handle is used to perform I/O and other operations. When finished + * with a device handle, you should call libusb_close(). + */ +typedef struct libusb_device_handle libusb_device_handle; + +/** \ingroup libusb_dev + * Speed codes. Indicates the speed at which the device is operating. + */ +enum libusb_speed { + /** The OS doesn't report or know the device speed. */ + LIBUSB_SPEED_UNKNOWN = 0, + + /** The device is operating at low speed (1.5MBit/s). */ + LIBUSB_SPEED_LOW = 1, + + /** The device is operating at full speed (12MBit/s). */ + LIBUSB_SPEED_FULL = 2, + + /** The device is operating at high speed (480MBit/s). */ + LIBUSB_SPEED_HIGH = 3, + + /** The device is operating at super speed (5000MBit/s). */ + LIBUSB_SPEED_SUPER = 4, + + /** The device is operating at super speed plus (10000MBit/s). */ + LIBUSB_SPEED_SUPER_PLUS = 5 +}; + +/** \ingroup libusb_misc + * Error codes. Most libusb functions return 0 on success or one of these + * codes on failure. + * You can call libusb_error_name() to retrieve a string representation of an + * error code or libusb_strerror() to get an end-user suitable description of + * an error code. + */ +enum libusb_error { + /** Success (no error) */ + LIBUSB_SUCCESS = 0, + + /** Input/output error */ + LIBUSB_ERROR_IO = -1, + + /** Invalid parameter */ + LIBUSB_ERROR_INVALID_PARAM = -2, + + /** Access denied (insufficient permissions) */ + LIBUSB_ERROR_ACCESS = -3, + + /** No such device (it may have been disconnected) */ + LIBUSB_ERROR_NO_DEVICE = -4, + + /** Entity not found */ + LIBUSB_ERROR_NOT_FOUND = -5, + + /** Resource busy */ + LIBUSB_ERROR_BUSY = -6, + + /** Operation timed out */ + LIBUSB_ERROR_TIMEOUT = -7, + + /** Overflow */ + LIBUSB_ERROR_OVERFLOW = -8, + + /** Pipe error */ + LIBUSB_ERROR_PIPE = -9, + + /** System call interrupted (perhaps due to signal) */ + LIBUSB_ERROR_INTERRUPTED = -10, + + /** Insufficient memory */ + LIBUSB_ERROR_NO_MEM = -11, + + /** Operation not supported or unimplemented on this platform */ + LIBUSB_ERROR_NOT_SUPPORTED = -12, + + /* NB: Remember to update LIBUSB_ERROR_COUNT below as well as the + message strings in strerror.c when adding new error codes here. */ + + /** Other error */ + LIBUSB_ERROR_OTHER = -99 +}; + +/* Total number of error codes in enum libusb_error */ +#define LIBUSB_ERROR_COUNT 14 + +/** \ingroup libusb_asyncio + * Transfer type */ +enum libusb_transfer_type { + /** Control transfer */ + LIBUSB_TRANSFER_TYPE_CONTROL = 0U, + + /** Isochronous transfer */ + LIBUSB_TRANSFER_TYPE_ISOCHRONOUS = 1U, + + /** Bulk transfer */ + LIBUSB_TRANSFER_TYPE_BULK = 2U, + + /** Interrupt transfer */ + LIBUSB_TRANSFER_TYPE_INTERRUPT = 3U, + + /** Bulk stream transfer */ + LIBUSB_TRANSFER_TYPE_BULK_STREAM = 4U +}; + +/** \ingroup libusb_asyncio + * Transfer status codes */ +enum libusb_transfer_status { + /** Transfer completed without error. Note that this does not indicate + * that the entire amount of requested data was transferred. */ + LIBUSB_TRANSFER_COMPLETED, + + /** Transfer failed */ + LIBUSB_TRANSFER_ERROR, + + /** Transfer timed out */ + LIBUSB_TRANSFER_TIMED_OUT, + + /** Transfer was cancelled */ + LIBUSB_TRANSFER_CANCELLED, + + /** For bulk/interrupt endpoints: halt condition detected (endpoint + * stalled). For control endpoints: control request not supported. */ + LIBUSB_TRANSFER_STALL, + + /** Device was disconnected */ + LIBUSB_TRANSFER_NO_DEVICE, + + /** Device sent more data than requested */ + LIBUSB_TRANSFER_OVERFLOW + + /* NB! Remember to update libusb_error_name() + when adding new status codes here. */ +}; + +/** \ingroup libusb_asyncio + * libusb_transfer.flags values */ +enum libusb_transfer_flags { + /** Report short frames as errors */ + LIBUSB_TRANSFER_SHORT_NOT_OK = (1U << 0), + + /** Automatically free() transfer buffer during libusb_free_transfer(). + * Note that buffers allocated with libusb_dev_mem_alloc() should not + * be attempted freed in this way, since free() is not an appropriate + * way to release such memory. */ + LIBUSB_TRANSFER_FREE_BUFFER = (1U << 1), + + /** Automatically call libusb_free_transfer() after callback returns. + * If this flag is set, it is illegal to call libusb_free_transfer() + * from your transfer callback, as this will result in a double-free + * when this flag is acted upon. */ + LIBUSB_TRANSFER_FREE_TRANSFER = (1U << 2), + + /** Terminate transfers that are a multiple of the endpoint's + * wMaxPacketSize with an extra zero length packet. This is useful + * when a device protocol mandates that each logical request is + * terminated by an incomplete packet (i.e. the logical requests are + * not separated by other means). + * + * This flag only affects host-to-device transfers to bulk and interrupt + * endpoints. In other situations, it is ignored. + * + * This flag only affects transfers with a length that is a multiple of + * the endpoint's wMaxPacketSize. On transfers of other lengths, this + * flag has no effect. Therefore, if you are working with a device that + * needs a ZLP whenever the end of the logical request falls on a packet + * boundary, then it is sensible to set this flag on every + * transfer (you do not have to worry about only setting it on transfers + * that end on the boundary). + * + * This flag is currently only supported on Linux. + * On other systems, libusb_submit_transfer() will return + * LIBUSB_ERROR_NOT_SUPPORTED for every transfer where this flag is set. + * + * Available since libusb-1.0.9. + */ + LIBUSB_TRANSFER_ADD_ZERO_PACKET = (1U << 3) +}; + +/** \ingroup libusb_asyncio + * Isochronous packet descriptor. */ +struct libusb_iso_packet_descriptor { + /** Length of data to request in this packet */ + unsigned int length; + + /** Amount of data that was actually transferred */ + unsigned int actual_length; + + /** Status code for this packet */ + enum libusb_transfer_status status; +}; + +struct libusb_transfer; + +/** \ingroup libusb_asyncio + * Asynchronous transfer callback function type. When submitting asynchronous + * transfers, you pass a pointer to a callback function of this type via the + * \ref libusb_transfer::callback "callback" member of the libusb_transfer + * structure. libusb will call this function later, when the transfer has + * completed or failed. See \ref libusb_asyncio for more information. + * \param transfer The libusb_transfer struct the callback function is being + * notified about. + */ +typedef void (LIBUSB_CALL *libusb_transfer_cb_fn)(struct libusb_transfer *transfer); + +/** \ingroup libusb_asyncio + * The generic USB transfer structure. The user populates this structure and + * then submits it in order to request a transfer. After the transfer has + * completed, the library populates the transfer with the results and passes + * it back to the user. + */ +struct libusb_transfer { + /** Handle of the device that this transfer will be submitted to */ + libusb_device_handle *dev_handle; + + /** A bitwise OR combination of \ref libusb_transfer_flags. */ + uint8_t flags; + + /** Address of the endpoint where this transfer will be sent. */ + unsigned char endpoint; + + /** Type of the transfer from \ref libusb_transfer_type */ + unsigned char type; + + /** Timeout for this transfer in milliseconds. A value of 0 indicates no + * timeout. */ + unsigned int timeout; + + /** The status of the transfer. Read-only, and only for use within + * transfer callback function. + * + * If this is an isochronous transfer, this field may read COMPLETED even + * if there were errors in the frames. Use the + * \ref libusb_iso_packet_descriptor::status "status" field in each packet + * to determine if errors occurred. */ + enum libusb_transfer_status status; + + /** Length of the data buffer. Must be non-negative. */ + int length; + + /** Actual length of data that was transferred. Read-only, and only for + * use within transfer callback function. Not valid for isochronous + * endpoint transfers. */ + int actual_length; + + /** Callback function. This will be invoked when the transfer completes, + * fails, or is cancelled. */ + libusb_transfer_cb_fn callback; + + /** User context data. Useful for associating specific data to a transfer + * that can be accessed from within the callback function. + * + * This field may be set manually or is taken as the `user_data` parameter + * of the following functions: + * - libusb_fill_bulk_transfer() + * - libusb_fill_bulk_stream_transfer() + * - libusb_fill_control_transfer() + * - libusb_fill_interrupt_transfer() + * - libusb_fill_iso_transfer() */ + void *user_data; + + /** Data buffer */ + unsigned char *buffer; + + /** Number of isochronous packets. Only used for I/O with isochronous + * endpoints. Must be non-negative. */ + int num_iso_packets; + + /** Isochronous packet descriptors, for isochronous transfers only. */ + struct libusb_iso_packet_descriptor iso_packet_desc[ZERO_SIZED_ARRAY]; +}; + +/** \ingroup libusb_misc + * Capabilities supported by an instance of libusb on the current running + * platform. Test if the loaded library supports a given capability by calling + * \ref libusb_has_capability(). + */ +enum libusb_capability { + /** The libusb_has_capability() API is available. */ + LIBUSB_CAP_HAS_CAPABILITY = 0x0000U, + + /** Hotplug support is available on this platform. */ + LIBUSB_CAP_HAS_HOTPLUG = 0x0001U, + + /** The library can access HID devices without requiring user intervention. + * Note that before being able to actually access an HID device, you may + * still have to call additional libusb functions such as + * \ref libusb_detach_kernel_driver(). */ + LIBUSB_CAP_HAS_HID_ACCESS = 0x0100U, + + /** The library supports detaching of the default USB driver, using + * \ref libusb_detach_kernel_driver(), if one is set by the OS kernel */ + LIBUSB_CAP_SUPPORTS_DETACH_KERNEL_DRIVER = 0x0101U +}; + +/** \ingroup libusb_lib + * Log message levels. + */ +enum libusb_log_level { + /** (0) : No messages ever emitted by the library (default) */ + LIBUSB_LOG_LEVEL_NONE = 0, + + /** (1) : Error messages are emitted */ + LIBUSB_LOG_LEVEL_ERROR = 1, + + /** (2) : Warning and error messages are emitted */ + LIBUSB_LOG_LEVEL_WARNING = 2, + + /** (3) : Informational, warning and error messages are emitted */ + LIBUSB_LOG_LEVEL_INFO = 3, + + /** (4) : All messages are emitted */ + LIBUSB_LOG_LEVEL_DEBUG = 4 +}; + +/** \ingroup libusb_lib + * Log callback mode. + * + * Since version 1.0.23, \ref LIBUSB_API_VERSION >= 0x01000107 + * + * \see libusb_set_log_cb() + */ +enum libusb_log_cb_mode { + /** Callback function handling all log messages. */ + LIBUSB_LOG_CB_GLOBAL = (1 << 0), + + /** Callback function handling context related log messages. */ + LIBUSB_LOG_CB_CONTEXT = (1 << 1) +}; + +/** \ingroup libusb_lib + * Callback function for handling log messages. + * \param ctx the context which is related to the log message, or NULL if it + * is a global log message + * \param level the log level, see \ref libusb_log_level for a description + * \param str the log message + * + * Since version 1.0.23, \ref LIBUSB_API_VERSION >= 0x01000107 + * + * \see libusb_set_log_cb() + */ +typedef void (LIBUSB_CALL *libusb_log_cb)(libusb_context *ctx, + enum libusb_log_level level, const char *str); + +int LIBUSB_CALL libusb_init(libusb_context **ctx); +void LIBUSB_CALL libusb_exit(libusb_context *ctx); +LIBUSB_DEPRECATED_FOR(libusb_set_option) +void LIBUSB_CALL libusb_set_debug(libusb_context *ctx, int level); +void LIBUSB_CALL libusb_set_log_cb(libusb_context *ctx, libusb_log_cb cb, int mode); +const struct libusb_version * LIBUSB_CALL libusb_get_version(void); +int LIBUSB_CALL libusb_has_capability(uint32_t capability); +const char * LIBUSB_CALL libusb_error_name(int errcode); +int LIBUSB_CALL libusb_setlocale(const char *locale); +const char * LIBUSB_CALL libusb_strerror(int errcode); + +ssize_t LIBUSB_CALL libusb_get_device_list(libusb_context *ctx, + libusb_device ***list); +void LIBUSB_CALL libusb_free_device_list(libusb_device **list, + int unref_devices); +libusb_device * LIBUSB_CALL libusb_ref_device(libusb_device *dev); +void LIBUSB_CALL libusb_unref_device(libusb_device *dev); + +int LIBUSB_CALL libusb_get_configuration(libusb_device_handle *dev, + int *config); +int LIBUSB_CALL libusb_get_device_descriptor(libusb_device *dev, + struct libusb_device_descriptor *desc); +int LIBUSB_CALL libusb_get_active_config_descriptor(libusb_device *dev, + struct libusb_config_descriptor **config); +int LIBUSB_CALL libusb_get_config_descriptor(libusb_device *dev, + uint8_t config_index, struct libusb_config_descriptor **config); +int LIBUSB_CALL libusb_get_config_descriptor_by_value(libusb_device *dev, + uint8_t bConfigurationValue, struct libusb_config_descriptor **config); +void LIBUSB_CALL libusb_free_config_descriptor( + struct libusb_config_descriptor *config); +int LIBUSB_CALL libusb_get_ss_endpoint_companion_descriptor( + libusb_context *ctx, + const struct libusb_endpoint_descriptor *endpoint, + struct libusb_ss_endpoint_companion_descriptor **ep_comp); +void LIBUSB_CALL libusb_free_ss_endpoint_companion_descriptor( + struct libusb_ss_endpoint_companion_descriptor *ep_comp); +int LIBUSB_CALL libusb_get_bos_descriptor(libusb_device_handle *dev_handle, + struct libusb_bos_descriptor **bos); +void LIBUSB_CALL libusb_free_bos_descriptor(struct libusb_bos_descriptor *bos); +int LIBUSB_CALL libusb_get_usb_2_0_extension_descriptor( + libusb_context *ctx, + struct libusb_bos_dev_capability_descriptor *dev_cap, + struct libusb_usb_2_0_extension_descriptor **usb_2_0_extension); +void LIBUSB_CALL libusb_free_usb_2_0_extension_descriptor( + struct libusb_usb_2_0_extension_descriptor *usb_2_0_extension); +int LIBUSB_CALL libusb_get_ss_usb_device_capability_descriptor( + libusb_context *ctx, + struct libusb_bos_dev_capability_descriptor *dev_cap, + struct libusb_ss_usb_device_capability_descriptor **ss_usb_device_cap); +void LIBUSB_CALL libusb_free_ss_usb_device_capability_descriptor( + struct libusb_ss_usb_device_capability_descriptor *ss_usb_device_cap); +int LIBUSB_CALL libusb_get_container_id_descriptor(libusb_context *ctx, + struct libusb_bos_dev_capability_descriptor *dev_cap, + struct libusb_container_id_descriptor **container_id); +void LIBUSB_CALL libusb_free_container_id_descriptor( + struct libusb_container_id_descriptor *container_id); +uint8_t LIBUSB_CALL libusb_get_bus_number(libusb_device *dev); +uint8_t LIBUSB_CALL libusb_get_port_number(libusb_device *dev); +int LIBUSB_CALL libusb_get_port_numbers(libusb_device *dev, uint8_t *port_numbers, int port_numbers_len); +LIBUSB_DEPRECATED_FOR(libusb_get_port_numbers) +int LIBUSB_CALL libusb_get_port_path(libusb_context *ctx, libusb_device *dev, uint8_t *path, uint8_t path_length); +libusb_device * LIBUSB_CALL libusb_get_parent(libusb_device *dev); +uint8_t LIBUSB_CALL libusb_get_device_address(libusb_device *dev); +int LIBUSB_CALL libusb_get_device_speed(libusb_device *dev); +int LIBUSB_CALL libusb_get_max_packet_size(libusb_device *dev, + unsigned char endpoint); +int LIBUSB_CALL libusb_get_max_iso_packet_size(libusb_device *dev, + unsigned char endpoint); + +int LIBUSB_CALL libusb_wrap_sys_device(libusb_context *ctx, intptr_t sys_dev, libusb_device_handle **dev_handle); +int LIBUSB_CALL libusb_open(libusb_device *dev, libusb_device_handle **dev_handle); +void LIBUSB_CALL libusb_close(libusb_device_handle *dev_handle); +libusb_device * LIBUSB_CALL libusb_get_device(libusb_device_handle *dev_handle); + +int LIBUSB_CALL libusb_set_configuration(libusb_device_handle *dev_handle, + int configuration); +int LIBUSB_CALL libusb_claim_interface(libusb_device_handle *dev_handle, + int interface_number); +int LIBUSB_CALL libusb_release_interface(libusb_device_handle *dev_handle, + int interface_number); + +libusb_device_handle * LIBUSB_CALL libusb_open_device_with_vid_pid( + libusb_context *ctx, uint16_t vendor_id, uint16_t product_id); + +int LIBUSB_CALL libusb_set_interface_alt_setting(libusb_device_handle *dev_handle, + int interface_number, int alternate_setting); +int LIBUSB_CALL libusb_clear_halt(libusb_device_handle *dev_handle, + unsigned char endpoint); +int LIBUSB_CALL libusb_reset_device(libusb_device_handle *dev_handle); + +int LIBUSB_CALL libusb_alloc_streams(libusb_device_handle *dev_handle, + uint32_t num_streams, unsigned char *endpoints, int num_endpoints); +int LIBUSB_CALL libusb_free_streams(libusb_device_handle *dev_handle, + unsigned char *endpoints, int num_endpoints); + +unsigned char * LIBUSB_CALL libusb_dev_mem_alloc(libusb_device_handle *dev_handle, + size_t length); +int LIBUSB_CALL libusb_dev_mem_free(libusb_device_handle *dev_handle, + unsigned char *buffer, size_t length); + +int LIBUSB_CALL libusb_kernel_driver_active(libusb_device_handle *dev_handle, + int interface_number); +int LIBUSB_CALL libusb_detach_kernel_driver(libusb_device_handle *dev_handle, + int interface_number); +int LIBUSB_CALL libusb_attach_kernel_driver(libusb_device_handle *dev_handle, + int interface_number); +int LIBUSB_CALL libusb_set_auto_detach_kernel_driver( + libusb_device_handle *dev_handle, int enable); + +/* async I/O */ + +/** \ingroup libusb_asyncio + * Get the data section of a control transfer. This convenience function is here + * to remind you that the data does not start until 8 bytes into the actual + * buffer, as the setup packet comes first. + * + * Calling this function only makes sense from a transfer callback function, + * or situations where you have already allocated a suitably sized buffer at + * transfer->buffer. + * + * \param transfer a transfer + * \returns pointer to the first byte of the data section + */ +static inline unsigned char *libusb_control_transfer_get_data( + struct libusb_transfer *transfer) +{ + return transfer->buffer + LIBUSB_CONTROL_SETUP_SIZE; +} + +/** \ingroup libusb_asyncio + * Get the control setup packet of a control transfer. This convenience + * function is here to remind you that the control setup occupies the first + * 8 bytes of the transfer data buffer. + * + * Calling this function only makes sense from a transfer callback function, + * or situations where you have already allocated a suitably sized buffer at + * transfer->buffer. + * + * \param transfer a transfer + * \returns a casted pointer to the start of the transfer data buffer + */ +static inline struct libusb_control_setup *libusb_control_transfer_get_setup( + struct libusb_transfer *transfer) +{ + return (struct libusb_control_setup *)(void *)transfer->buffer; +} + +/** \ingroup libusb_asyncio + * Helper function to populate the setup packet (first 8 bytes of the data + * buffer) for a control transfer. The wIndex, wValue and wLength values should + * be given in host-endian byte order. + * + * \param buffer buffer to output the setup packet into + * This pointer must be aligned to at least 2 bytes boundary. + * \param bmRequestType see the + * \ref libusb_control_setup::bmRequestType "bmRequestType" field of + * \ref libusb_control_setup + * \param bRequest see the + * \ref libusb_control_setup::bRequest "bRequest" field of + * \ref libusb_control_setup + * \param wValue see the + * \ref libusb_control_setup::wValue "wValue" field of + * \ref libusb_control_setup + * \param wIndex see the + * \ref libusb_control_setup::wIndex "wIndex" field of + * \ref libusb_control_setup + * \param wLength see the + * \ref libusb_control_setup::wLength "wLength" field of + * \ref libusb_control_setup + */ +static inline void libusb_fill_control_setup(unsigned char *buffer, + uint8_t bmRequestType, uint8_t bRequest, uint16_t wValue, uint16_t wIndex, + uint16_t wLength) +{ + struct libusb_control_setup *setup = (struct libusb_control_setup *)(void *)buffer; + setup->bmRequestType = bmRequestType; + setup->bRequest = bRequest; + setup->wValue = libusb_cpu_to_le16(wValue); + setup->wIndex = libusb_cpu_to_le16(wIndex); + setup->wLength = libusb_cpu_to_le16(wLength); +} + +struct libusb_transfer * LIBUSB_CALL libusb_alloc_transfer(int iso_packets); +int LIBUSB_CALL libusb_submit_transfer(struct libusb_transfer *transfer); +int LIBUSB_CALL libusb_cancel_transfer(struct libusb_transfer *transfer); +void LIBUSB_CALL libusb_free_transfer(struct libusb_transfer *transfer); +void LIBUSB_CALL libusb_transfer_set_stream_id( + struct libusb_transfer *transfer, uint32_t stream_id); +uint32_t LIBUSB_CALL libusb_transfer_get_stream_id( + struct libusb_transfer *transfer); + +/** \ingroup libusb_asyncio + * Helper function to populate the required \ref libusb_transfer fields + * for a control transfer. + * + * If you pass a transfer buffer to this function, the first 8 bytes will + * be interpreted as a control setup packet, and the wLength field will be + * used to automatically populate the \ref libusb_transfer::length "length" + * field of the transfer. Therefore the recommended approach is: + * -# Allocate a suitably sized data buffer (including space for control setup) + * -# Call libusb_fill_control_setup() + * -# If this is a host-to-device transfer with a data stage, put the data + * in place after the setup packet + * -# Call this function + * -# Call libusb_submit_transfer() + * + * It is also legal to pass a NULL buffer to this function, in which case this + * function will not attempt to populate the length field. Remember that you + * must then populate the buffer and length fields later. + * + * \param transfer the transfer to populate + * \param dev_handle handle of the device that will handle the transfer + * \param buffer data buffer. If provided, this function will interpret the + * first 8 bytes as a setup packet and infer the transfer length from that. + * This pointer must be aligned to at least 2 bytes boundary. + * \param callback callback function to be invoked on transfer completion + * \param user_data user data to pass to callback function + * \param timeout timeout for the transfer in milliseconds + */ +static inline void libusb_fill_control_transfer( + struct libusb_transfer *transfer, libusb_device_handle *dev_handle, + unsigned char *buffer, libusb_transfer_cb_fn callback, void *user_data, + unsigned int timeout) +{ + struct libusb_control_setup *setup = (struct libusb_control_setup *)(void *)buffer; + transfer->dev_handle = dev_handle; + transfer->endpoint = 0; + transfer->type = LIBUSB_TRANSFER_TYPE_CONTROL; + transfer->timeout = timeout; + transfer->buffer = buffer; + if (setup) + transfer->length = (int) (LIBUSB_CONTROL_SETUP_SIZE + + libusb_le16_to_cpu(setup->wLength)); + transfer->user_data = user_data; + transfer->callback = callback; +} + +/** \ingroup libusb_asyncio + * Helper function to populate the required \ref libusb_transfer fields + * for a bulk transfer. + * + * \param transfer the transfer to populate + * \param dev_handle handle of the device that will handle the transfer + * \param endpoint address of the endpoint where this transfer will be sent + * \param buffer data buffer + * \param length length of data buffer + * \param callback callback function to be invoked on transfer completion + * \param user_data user data to pass to callback function + * \param timeout timeout for the transfer in milliseconds + */ +static inline void libusb_fill_bulk_transfer(struct libusb_transfer *transfer, + libusb_device_handle *dev_handle, unsigned char endpoint, + unsigned char *buffer, int length, libusb_transfer_cb_fn callback, + void *user_data, unsigned int timeout) +{ + transfer->dev_handle = dev_handle; + transfer->endpoint = endpoint; + transfer->type = LIBUSB_TRANSFER_TYPE_BULK; + transfer->timeout = timeout; + transfer->buffer = buffer; + transfer->length = length; + transfer->user_data = user_data; + transfer->callback = callback; +} + +/** \ingroup libusb_asyncio + * Helper function to populate the required \ref libusb_transfer fields + * for a bulk transfer using bulk streams. + * + * Since version 1.0.19, \ref LIBUSB_API_VERSION >= 0x01000103 + * + * \param transfer the transfer to populate + * \param dev_handle handle of the device that will handle the transfer + * \param endpoint address of the endpoint where this transfer will be sent + * \param stream_id bulk stream id for this transfer + * \param buffer data buffer + * \param length length of data buffer + * \param callback callback function to be invoked on transfer completion + * \param user_data user data to pass to callback function + * \param timeout timeout for the transfer in milliseconds + */ +static inline void libusb_fill_bulk_stream_transfer( + struct libusb_transfer *transfer, libusb_device_handle *dev_handle, + unsigned char endpoint, uint32_t stream_id, + unsigned char *buffer, int length, libusb_transfer_cb_fn callback, + void *user_data, unsigned int timeout) +{ + libusb_fill_bulk_transfer(transfer, dev_handle, endpoint, buffer, + length, callback, user_data, timeout); + transfer->type = LIBUSB_TRANSFER_TYPE_BULK_STREAM; + libusb_transfer_set_stream_id(transfer, stream_id); +} + +/** \ingroup libusb_asyncio + * Helper function to populate the required \ref libusb_transfer fields + * for an interrupt transfer. + * + * \param transfer the transfer to populate + * \param dev_handle handle of the device that will handle the transfer + * \param endpoint address of the endpoint where this transfer will be sent + * \param buffer data buffer + * \param length length of data buffer + * \param callback callback function to be invoked on transfer completion + * \param user_data user data to pass to callback function + * \param timeout timeout for the transfer in milliseconds + */ +static inline void libusb_fill_interrupt_transfer( + struct libusb_transfer *transfer, libusb_device_handle *dev_handle, + unsigned char endpoint, unsigned char *buffer, int length, + libusb_transfer_cb_fn callback, void *user_data, unsigned int timeout) +{ + transfer->dev_handle = dev_handle; + transfer->endpoint = endpoint; + transfer->type = LIBUSB_TRANSFER_TYPE_INTERRUPT; + transfer->timeout = timeout; + transfer->buffer = buffer; + transfer->length = length; + transfer->user_data = user_data; + transfer->callback = callback; +} + +/** \ingroup libusb_asyncio + * Helper function to populate the required \ref libusb_transfer fields + * for an isochronous transfer. + * + * \param transfer the transfer to populate + * \param dev_handle handle of the device that will handle the transfer + * \param endpoint address of the endpoint where this transfer will be sent + * \param buffer data buffer + * \param length length of data buffer + * \param num_iso_packets the number of isochronous packets + * \param callback callback function to be invoked on transfer completion + * \param user_data user data to pass to callback function + * \param timeout timeout for the transfer in milliseconds + */ +static inline void libusb_fill_iso_transfer(struct libusb_transfer *transfer, + libusb_device_handle *dev_handle, unsigned char endpoint, + unsigned char *buffer, int length, int num_iso_packets, + libusb_transfer_cb_fn callback, void *user_data, unsigned int timeout) +{ + transfer->dev_handle = dev_handle; + transfer->endpoint = endpoint; + transfer->type = LIBUSB_TRANSFER_TYPE_ISOCHRONOUS; + transfer->timeout = timeout; + transfer->buffer = buffer; + transfer->length = length; + transfer->num_iso_packets = num_iso_packets; + transfer->user_data = user_data; + transfer->callback = callback; +} + +/** \ingroup libusb_asyncio + * Convenience function to set the length of all packets in an isochronous + * transfer, based on the num_iso_packets field in the transfer structure. + * + * \param transfer a transfer + * \param length the length to set in each isochronous packet descriptor + * \see libusb_get_max_packet_size() + */ +static inline void libusb_set_iso_packet_lengths( + struct libusb_transfer *transfer, unsigned int length) +{ + int i; + + for (i = 0; i < transfer->num_iso_packets; i++) + transfer->iso_packet_desc[i].length = length; +} + +/** \ingroup libusb_asyncio + * Convenience function to locate the position of an isochronous packet + * within the buffer of an isochronous transfer. + * + * This is a thorough function which loops through all preceding packets, + * accumulating their lengths to find the position of the specified packet. + * Typically you will assign equal lengths to each packet in the transfer, + * and hence the above method is sub-optimal. You may wish to use + * libusb_get_iso_packet_buffer_simple() instead. + * + * \param transfer a transfer + * \param packet the packet to return the address of + * \returns the base address of the packet buffer inside the transfer buffer, + * or NULL if the packet does not exist. + * \see libusb_get_iso_packet_buffer_simple() + */ +static inline unsigned char *libusb_get_iso_packet_buffer( + struct libusb_transfer *transfer, unsigned int packet) +{ + int i; + size_t offset = 0; + int _packet; + + /* oops..slight bug in the API. packet is an unsigned int, but we use + * signed integers almost everywhere else. range-check and convert to + * signed to avoid compiler warnings. FIXME for libusb-2. */ + if (packet > INT_MAX) + return NULL; + _packet = (int) packet; + + if (_packet >= transfer->num_iso_packets) + return NULL; + + for (i = 0; i < _packet; i++) + offset += transfer->iso_packet_desc[i].length; + + return transfer->buffer + offset; +} + +/** \ingroup libusb_asyncio + * Convenience function to locate the position of an isochronous packet + * within the buffer of an isochronous transfer, for transfers where each + * packet is of identical size. + * + * This function relies on the assumption that every packet within the transfer + * is of identical size to the first packet. Calculating the location of + * the packet buffer is then just a simple calculation: + * buffer + (packet_size * packet) + * + * Do not use this function on transfers other than those that have identical + * packet lengths for each packet. + * + * \param transfer a transfer + * \param packet the packet to return the address of + * \returns the base address of the packet buffer inside the transfer buffer, + * or NULL if the packet does not exist. + * \see libusb_get_iso_packet_buffer() + */ +static inline unsigned char *libusb_get_iso_packet_buffer_simple( + struct libusb_transfer *transfer, unsigned int packet) +{ + int _packet; + + /* oops..slight bug in the API. packet is an unsigned int, but we use + * signed integers almost everywhere else. range-check and convert to + * signed to avoid compiler warnings. FIXME for libusb-2. */ + if (packet > INT_MAX) + return NULL; + _packet = (int) packet; + + if (_packet >= transfer->num_iso_packets) + return NULL; + + return transfer->buffer + ((int) transfer->iso_packet_desc[0].length * _packet); +} + +/* sync I/O */ + +int LIBUSB_CALL libusb_control_transfer(libusb_device_handle *dev_handle, + uint8_t request_type, uint8_t bRequest, uint16_t wValue, uint16_t wIndex, + unsigned char *data, uint16_t wLength, unsigned int timeout); + +int LIBUSB_CALL libusb_bulk_transfer(libusb_device_handle *dev_handle, + unsigned char endpoint, unsigned char *data, int length, + int *actual_length, unsigned int timeout); + +int LIBUSB_CALL libusb_interrupt_transfer(libusb_device_handle *dev_handle, + unsigned char endpoint, unsigned char *data, int length, + int *actual_length, unsigned int timeout); + +/** \ingroup libusb_desc + * Retrieve a descriptor from the default control pipe. + * This is a convenience function which formulates the appropriate control + * message to retrieve the descriptor. + * + * \param dev_handle a device handle + * \param desc_type the descriptor type, see \ref libusb_descriptor_type + * \param desc_index the index of the descriptor to retrieve + * \param data output buffer for descriptor + * \param length size of data buffer + * \returns number of bytes returned in data, or LIBUSB_ERROR code on failure + */ +static inline int libusb_get_descriptor(libusb_device_handle *dev_handle, + uint8_t desc_type, uint8_t desc_index, unsigned char *data, int length) +{ + return libusb_control_transfer(dev_handle, LIBUSB_ENDPOINT_IN, + LIBUSB_REQUEST_GET_DESCRIPTOR, (uint16_t) ((desc_type << 8) | desc_index), + 0, data, (uint16_t) length, 1000); +} + +/** \ingroup libusb_desc + * Retrieve a descriptor from a device. + * This is a convenience function which formulates the appropriate control + * message to retrieve the descriptor. The string returned is Unicode, as + * detailed in the USB specifications. + * + * \param dev_handle a device handle + * \param desc_index the index of the descriptor to retrieve + * \param langid the language ID for the string descriptor + * \param data output buffer for descriptor + * \param length size of data buffer + * \returns number of bytes returned in data, or LIBUSB_ERROR code on failure + * \see libusb_get_string_descriptor_ascii() + */ +static inline int libusb_get_string_descriptor(libusb_device_handle *dev_handle, + uint8_t desc_index, uint16_t langid, unsigned char *data, int length) +{ + return libusb_control_transfer(dev_handle, LIBUSB_ENDPOINT_IN, + LIBUSB_REQUEST_GET_DESCRIPTOR, (uint16_t)((LIBUSB_DT_STRING << 8) | desc_index), + langid, data, (uint16_t) length, 1000); +} + +int LIBUSB_CALL libusb_get_string_descriptor_ascii(libusb_device_handle *dev_handle, + uint8_t desc_index, unsigned char *data, int length); + +/* polling and timeouts */ + +int LIBUSB_CALL libusb_try_lock_events(libusb_context *ctx); +void LIBUSB_CALL libusb_lock_events(libusb_context *ctx); +void LIBUSB_CALL libusb_unlock_events(libusb_context *ctx); +int LIBUSB_CALL libusb_event_handling_ok(libusb_context *ctx); +int LIBUSB_CALL libusb_event_handler_active(libusb_context *ctx); +void LIBUSB_CALL libusb_interrupt_event_handler(libusb_context *ctx); +void LIBUSB_CALL libusb_lock_event_waiters(libusb_context *ctx); +void LIBUSB_CALL libusb_unlock_event_waiters(libusb_context *ctx); +int LIBUSB_CALL libusb_wait_for_event(libusb_context *ctx, struct timeval *tv); + +int LIBUSB_CALL libusb_handle_events_timeout(libusb_context *ctx, + struct timeval *tv); +int LIBUSB_CALL libusb_handle_events_timeout_completed(libusb_context *ctx, + struct timeval *tv, int *completed); +int LIBUSB_CALL libusb_handle_events(libusb_context *ctx); +int LIBUSB_CALL libusb_handle_events_completed(libusb_context *ctx, int *completed); +int LIBUSB_CALL libusb_handle_events_locked(libusb_context *ctx, + struct timeval *tv); +int LIBUSB_CALL libusb_pollfds_handle_timeouts(libusb_context *ctx); +int LIBUSB_CALL libusb_get_next_timeout(libusb_context *ctx, + struct timeval *tv); + +/** \ingroup libusb_poll + * File descriptor for polling + */ +struct libusb_pollfd { + /** Numeric file descriptor */ + int fd; + + /** Event flags to poll for from . POLLIN indicates that you + * should monitor this file descriptor for becoming ready to read from, + * and POLLOUT indicates that you should monitor this file descriptor for + * nonblocking write readiness. */ + short events; +}; + +/** \ingroup libusb_poll + * Callback function, invoked when a new file descriptor should be added + * to the set of file descriptors monitored for events. + * \param fd the new file descriptor + * \param events events to monitor for, see \ref libusb_pollfd for a + * description + * \param user_data User data pointer specified in + * libusb_set_pollfd_notifiers() call + * \see libusb_set_pollfd_notifiers() + */ +typedef void (LIBUSB_CALL *libusb_pollfd_added_cb)(int fd, short events, + void *user_data); + +/** \ingroup libusb_poll + * Callback function, invoked when a file descriptor should be removed from + * the set of file descriptors being monitored for events. After returning + * from this callback, do not use that file descriptor again. + * \param fd the file descriptor to stop monitoring + * \param user_data User data pointer specified in + * libusb_set_pollfd_notifiers() call + * \see libusb_set_pollfd_notifiers() + */ +typedef void (LIBUSB_CALL *libusb_pollfd_removed_cb)(int fd, void *user_data); + +const struct libusb_pollfd ** LIBUSB_CALL libusb_get_pollfds( + libusb_context *ctx); +void LIBUSB_CALL libusb_free_pollfds(const struct libusb_pollfd **pollfds); +void LIBUSB_CALL libusb_set_pollfd_notifiers(libusb_context *ctx, + libusb_pollfd_added_cb added_cb, libusb_pollfd_removed_cb removed_cb, + void *user_data); + +/** \ingroup libusb_hotplug + * Callback handle. + * + * Callbacks handles are generated by libusb_hotplug_register_callback() + * and can be used to deregister callbacks. Callback handles are unique + * per libusb_context and it is safe to call libusb_hotplug_deregister_callback() + * on an already deregistered callback. + * + * Since version 1.0.16, \ref LIBUSB_API_VERSION >= 0x01000102 + * + * For more information, see \ref libusb_hotplug. + */ +typedef int libusb_hotplug_callback_handle; + +/** \ingroup libusb_hotplug + * + * Since version 1.0.16, \ref LIBUSB_API_VERSION >= 0x01000102 + * + * Hotplug events */ +typedef enum { + /** A device has been plugged in and is ready to use */ + LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED = (1 << 0), + + /** A device has left and is no longer available. + * It is the user's responsibility to call libusb_close on any handle associated with a disconnected device. + * It is safe to call libusb_get_device_descriptor on a device that has left */ + LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT = (1 << 1) +} libusb_hotplug_event; + +/** \ingroup libusb_hotplug + * + * Since version 1.0.16, \ref LIBUSB_API_VERSION >= 0x01000102 + * + * Hotplug flags */ +typedef enum { + /** Arm the callback and fire it for all matching currently attached devices. */ + LIBUSB_HOTPLUG_ENUMERATE = (1 << 0) +} libusb_hotplug_flag; + +/** \ingroup libusb_hotplug + * Convenience macro when not using any flags */ +#define LIBUSB_HOTPLUG_NO_FLAGS 0 + +/** \ingroup libusb_hotplug + * Wildcard matching for hotplug events */ +#define LIBUSB_HOTPLUG_MATCH_ANY -1 + +/** \ingroup libusb_hotplug + * Hotplug callback function type. When requesting hotplug event notifications, + * you pass a pointer to a callback function of this type. + * + * This callback may be called by an internal event thread and as such it is + * recommended the callback do minimal processing before returning. + * + * libusb will call this function later, when a matching event had happened on + * a matching device. See \ref libusb_hotplug for more information. + * + * It is safe to call either libusb_hotplug_register_callback() or + * libusb_hotplug_deregister_callback() from within a callback function. + * + * Since version 1.0.16, \ref LIBUSB_API_VERSION >= 0x01000102 + * + * \param ctx context of this notification + * \param device libusb_device this event occurred on + * \param event event that occurred + * \param user_data user data provided when this callback was registered + * \returns bool whether this callback is finished processing events. + * returning 1 will cause this callback to be deregistered + */ +typedef int (LIBUSB_CALL *libusb_hotplug_callback_fn)(libusb_context *ctx, + libusb_device *device, libusb_hotplug_event event, void *user_data); + +/** \ingroup libusb_hotplug + * Register a hotplug callback function + * + * Register a callback with the libusb_context. The callback will fire + * when a matching event occurs on a matching device. The callback is + * armed until either it is deregistered with libusb_hotplug_deregister_callback() + * or the supplied callback returns 1 to indicate it is finished processing events. + * + * If the \ref LIBUSB_HOTPLUG_ENUMERATE is passed the callback will be + * called with a \ref LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED for all devices + * already plugged into the machine. Note that libusb modifies its internal + * device list from a separate thread, while calling hotplug callbacks from + * libusb_handle_events(), so it is possible for a device to already be present + * on, or removed from, its internal device list, while the hotplug callbacks + * still need to be dispatched. This means that when using \ref + * LIBUSB_HOTPLUG_ENUMERATE, your callback may be called twice for the arrival + * of the same device, once from libusb_hotplug_register_callback() and once + * from libusb_handle_events(); and/or your callback may be called for the + * removal of a device for which an arrived call was never made. + * + * Since version 1.0.16, \ref LIBUSB_API_VERSION >= 0x01000102 + * + * \param[in] ctx context to register this callback with + * \param[in] events bitwise or of hotplug events that will trigger this callback. + * See \ref libusb_hotplug_event + * \param[in] flags bitwise or of hotplug flags that affect registration. + * See \ref libusb_hotplug_flag + * \param[in] vendor_id the vendor id to match or \ref LIBUSB_HOTPLUG_MATCH_ANY + * \param[in] product_id the product id to match or \ref LIBUSB_HOTPLUG_MATCH_ANY + * \param[in] dev_class the device class to match or \ref LIBUSB_HOTPLUG_MATCH_ANY + * \param[in] cb_fn the function to be invoked on a matching event/device + * \param[in] user_data user data to pass to the callback function + * \param[out] callback_handle pointer to store the handle of the allocated callback (can be NULL) + * \returns LIBUSB_SUCCESS on success LIBUSB_ERROR code on failure + */ +int LIBUSB_CALL libusb_hotplug_register_callback(libusb_context *ctx, + int events, int flags, + int vendor_id, int product_id, int dev_class, + libusb_hotplug_callback_fn cb_fn, void *user_data, + libusb_hotplug_callback_handle *callback_handle); + +/** \ingroup libusb_hotplug + * Deregisters a hotplug callback. + * + * Deregister a callback from a libusb_context. This function is safe to call from within + * a hotplug callback. + * + * Since version 1.0.16, \ref LIBUSB_API_VERSION >= 0x01000102 + * + * \param[in] ctx context this callback is registered with + * \param[in] callback_handle the handle of the callback to deregister + */ +void LIBUSB_CALL libusb_hotplug_deregister_callback(libusb_context *ctx, + libusb_hotplug_callback_handle callback_handle); + +/** \ingroup libusb_hotplug + * Gets the user_data associated with a hotplug callback. + * + * Since version v1.0.24 \ref LIBUSB_API_VERSION >= 0x01000108 + * + * \param[in] ctx context this callback is registered with + * \param[in] callback_handle the handle of the callback to get the user_data of + */ +void * LIBUSB_CALL libusb_hotplug_get_user_data(libusb_context *ctx, + libusb_hotplug_callback_handle callback_handle); + +/** \ingroup libusb_lib + * Available option values for libusb_set_option(). + */ +enum libusb_option { + /** Set the log message verbosity. + * + * The default level is LIBUSB_LOG_LEVEL_NONE, which means no messages are ever + * printed. If you choose to increase the message verbosity level, ensure + * that your application does not close the stderr file descriptor. + * + * You are advised to use level LIBUSB_LOG_LEVEL_WARNING. libusb is conservative + * with its message logging and most of the time, will only log messages that + * explain error conditions and other oddities. This will help you debug + * your software. + * + * If the LIBUSB_DEBUG environment variable was set when libusb was + * initialized, this function does nothing: the message verbosity is fixed + * to the value in the environment variable. + * + * If libusb was compiled without any message logging, this function does + * nothing: you'll never get any messages. + * + * If libusb was compiled with verbose debug message logging, this function + * does nothing: you'll always get messages from all levels. + */ + LIBUSB_OPTION_LOG_LEVEL = 0, + + /** Use the UsbDk backend for a specific context, if available. + * + * This option should be set immediately after calling libusb_init(), otherwise + * unspecified behavior may occur. + * + * Only valid on Windows. + */ + LIBUSB_OPTION_USE_USBDK = 1, + + /** Do not scan for devices + * + * With this option set, libusb will skip scanning devices in + * libusb_init(). Must be set before calling libusb_init(). + * + * Hotplug functionality will also be deactivated. + * + * The option is useful in combination with libusb_wrap_sys_device(), + * which can access a device directly without prior device scanning. + * + * This is typically needed on Android, where access to USB devices + * is limited. + * + * For LIBUSB_API_VERSION 0x01000108 it was called LIBUSB_OPTION_WEAK_AUTHORITY + * + * Only valid on Linux. + */ + LIBUSB_OPTION_NO_DEVICE_DISCOVERY = 2, + +#define LIBUSB_OPTION_WEAK_AUTHORITY LIBUSB_OPTION_NO_DEVICE_DISCOVERY + + LIBUSB_OPTION_MAX = 3 +}; + +int LIBUSB_CALL libusb_set_option(libusb_context *ctx, enum libusb_option option, ...); + +#ifdef _MSC_VER +#pragma warning(pop) +#endif + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/main.cpp b/main.cpp new file mode 100644 index 0000000..115a22b --- /dev/null +++ b/main.cpp @@ -0,0 +1,10 @@ +#include "mainwindow.h" +#include + +int main(int argc, char *argv[]) +{ + QApplication a(argc, argv); + MainWindow w; + w.show(); + return a.exec(); +} diff --git a/mainwindow.cpp b/mainwindow.cpp new file mode 100644 index 0000000..1eecd21 --- /dev/null +++ b/mainwindow.cpp @@ -0,0 +1,167 @@ +#include "mainwindow.h" +#include "ui_mainwindow.h" +#include "QDebug" +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include "usb.h" + +void listUsbDevices() { + libusb_device **devs; + libusb_context *ctx = nullptr; + ssize_t cnt; + + if (libusb_init(&ctx) < 0) { + qDebug() << "Failed to initialize libusb"; + return; + } + + cnt = libusb_get_device_list(ctx, &devs); + if (cnt < 0) { + qDebug() << "No USB devices found!"; + } else { + qDebug() << "Found" << cnt << "USB devices."; + for (ssize_t i = 0; i < cnt; i++) { + libusb_device_descriptor desc; + if (libusb_get_device_descriptor(devs[i], &desc) == 0) { + qDebug() << "Device Found: VID =" << QString::number(desc.idVendor, 16) + << "PID =" << QString::number(desc.idProduct, 16); + } + } + } + + libusb_free_device_list(devs, 1); + libusb_exit(ctx); +} + + +MainWindow::MainWindow(QWidget *parent) + : QMainWindow(parent) + , ui(new Ui::MainWindow) +{ + ui->setupUi(this); + + myusb.hello(); + // 创建 QStandardItemModel(表格数据模型) + QStandardItemModel *model = new QStandardItemModel(3, 2); + + // 设置表头标签 + model->setHorizontalHeaderLabels({"Name", "value"}); + + // 插入数据 + model->setItem(0, 0, new QStandardItem("SN")); + model->setItem(0, 1, new QStandardItem("123456789")); + model->setItem(1, 0, new QStandardItem("BLE_NAME")); + model->setItem(1, 1, new QStandardItem("G01-06")); + model->setItem(2, 0, new QStandardItem("")); + model->setItem(2, 1, new QStandardItem("")); + + // 将模型与视图关联 + ui->tableView->setModel(model); + + //设置列宽 + ui->tableView->setColumnWidth(0,100); + ui->tableView->setColumnWidth(1,160); + + ui->lineEdit->setText("123456789"); + ui->lineEdit_2->setText("G01-06"); + +} + +MainWindow::~MainWindow() +{ + delete ui; +} + +void MainWindow::on_pushButton_clicked() +{ + // ui->lineEdit->setText("123456789"); + QString lineEdit_text = ui->lineEdit->text(); + QString lineEdit_2_text = ui->lineEdit_2->text(); + qDebug() << "SN:" << lineEdit_text << "BLE_Name:" << lineEdit_2_text; + + + // 创建一个 JSON 对象 + QJsonObject jsonObj; + jsonObj["SN"] = lineEdit_text; + jsonObj["BLE_NAME"] = lineEdit_2_text; + + // 创建一个 JSON 数组来保存所有键(第一列的内容) + QJsonArray keysArray; + + // 获取当前的模型 + QStandardItemModel *model = qobject_cast(ui->tableView->model()); + + if(model) { + + int rowCount = model->rowCount(); + for(int i=0; iitem(i, 0); + QStandardItem *item_Col1 = model->item(i, 1); + qDebug() << "name:" << item_Col0->text() << "value:" << item_Col1->text(); + jsonObj[item_Col0->text()] = item_Col1->text(); + keysArray.append(item_Col0->text()); + } + jsonObj["KEY"] = keysArray; + } + + + // 将 JSON 对象转化为 QJsonDocument + QJsonDocument doc(jsonObj); + + // Windows 路径示例 + QString filePath = "D:config.json"; + + // 打开一个文件进行写入 + QFile file(filePath); + if (file.open(QIODevice::WriteOnly)) { + // 将 JSON 数据写入文件 + file.write(doc.toJson()); + file.close(); + qDebug() << "File saved to:" << filePath; + } else { + qWarning("Could not open the file for writing."); + } +} + + +void MainWindow::on_pushButton_2_clicked() +{ + // 获取当前的模型 + QStandardItemModel *model = qobject_cast(ui->tableView->model()); + + if (model) { + // 获取当前表格的行数 + int rowCount = model->rowCount(); + + // 插入新的一行 + model->insertRow(rowCount); + + // 为新行设置单元格内容 + model->setItem(rowCount, 0, new QStandardItem("")); // 第1列 + model->setItem(rowCount, 1, new QStandardItem("")); // 第2列 + } +} + + +void MainWindow::on_pushButton_3_clicked() +{ + // 获取当前的模型 + QStandardItemModel *model = qobject_cast(ui->tableView->model()); + + if (model) { + // 获取当前表格的行数 + int rowCount = model->rowCount() -1; + + //删除最后一行 + model->removeRow(rowCount); + } +} + diff --git a/mainwindow.h b/mainwindow.h new file mode 100644 index 0000000..8f114de --- /dev/null +++ b/mainwindow.h @@ -0,0 +1,31 @@ +#ifndef MAINWINDOW_H +#define MAINWINDOW_H + +#include +#include "usb.h" +QT_BEGIN_NAMESPACE +namespace Ui { +class MainWindow; +} +QT_END_NAMESPACE + +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(QWidget *parent = nullptr); + ~MainWindow(); + +private slots: + void on_pushButton_clicked(); + + void on_pushButton_2_clicked(); + + void on_pushButton_3_clicked(); + +private: + Ui::MainWindow *ui; + usb myusb; // ✅ 在 MainWindow 类中定义 USB 对象 +}; +#endif // MAINWINDOW_H diff --git a/mainwindow.ui b/mainwindow.ui new file mode 100644 index 0000000..f0f519f --- /dev/null +++ b/mainwindow.ui @@ -0,0 +1,207 @@ + + + MainWindow + + + + 0 + 0 + 796 + 549 + + + + 配置文件生成器 + + + + + + 0 + 10 + 301 + 81 + + + + SN序列号 + + + + + 10 + 40 + 61 + 31 + + + + + 16 + + + + SN: + + + + + + 70 + 30 + 221 + 41 + + + + + 16 + + + + + + + + + + + 610 + 30 + 181 + 61 + + + + + 24 + + + + 生成配置 + + + + + + 320 + 20 + 281 + 71 + + + + 蓝牙 + + + + + 10 + 20 + 69 + 41 + + + + + 16 + + + + 名称: + + + + + + 80 + 20 + 191 + 41 + + + + + 16 + + + + + + + + + + + 10 + 90 + 301 + 391 + + + + 添加下列属性到配置文件中 + + + + + 10 + 20 + 281 + 311 + + + + + + + 200 + 340 + 41 + 41 + + + + + 20 + + + + + + + + + + + 250 + 340 + 41 + 41 + + + + + 20 + + + + - + + + + + + + + 0 + 0 + 796 + 25 + + + + + + + + diff --git a/usb.cpp b/usb.cpp new file mode 100644 index 0000000..1fef3ba --- /dev/null +++ b/usb.cpp @@ -0,0 +1,32 @@ +#include "usb.h" +#include "QDebug" +#include + +usb::usb() { + // 初始化 libusb + if (libusb_init(&ctx) < 0) { + std::cerr << "Failed to initialize libusb!" << std::endl; + ctx = nullptr; + return; + } + qDebug() << "libusb initialized successfully!"; +} + +usb::~usb() { + + if (ctx) { + libusb_exit(ctx); + std::cout << "libusb deinitialized." << std::endl; + } + // listUsbDevices(); + + // libusb_exit(ctx); +} + +void usb::hello() +{ + qDebug() << "hello q!t"; +} + + + diff --git a/usb.h b/usb.h new file mode 100644 index 0000000..aece1c4 --- /dev/null +++ b/usb.h @@ -0,0 +1,14 @@ +#ifndef USB_H +#define USB_H +#include + +class usb +{ +public: + libusb_context *ctx; + usb(); + ~usb(); + void hello(); +}; + +#endif // USB_H