From 19de9d82c15c1cea2512f84d1af723ba10afd3a1 Mon Sep 17 00:00:00 2001 From: Ben Z Yuan Date: Thu, 25 Oct 2018 16:02:55 -0400 Subject: [PATCH] add proto0 schematic and firmware --- README.md | 8 +- fabscope_proto0.pdf | Bin 0 -> 45235 bytes firmware/Config/LUFAConfig.h | 126 ++++++++++++++++ firmware/Descriptors.c | 245 ++++++++++++++++++++++++++++++++ firmware/Descriptors.h | 110 ++++++++++++++ firmware/LUFA VirtualSerial.inf | 66 +++++++++ firmware/main.c | 239 +++++++++++++++++++++++++++++++ firmware/main.h | 65 +++++++++ firmware/makefile | 51 +++++++ 9 files changed, 909 insertions(+), 1 deletion(-) create mode 100644 fabscope_proto0.pdf create mode 100644 firmware/Config/LUFAConfig.h create mode 100644 firmware/Descriptors.c create mode 100644 firmware/Descriptors.h create mode 100644 firmware/LUFA VirtualSerial.inf create mode 100644 firmware/main.c create mode 100644 firmware/main.h create mode 100644 firmware/makefile diff --git a/README.md b/README.md index ea569cb..cd02818 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ # FabScope -Coordination and discussion for the FabScope project. \ No newline at end of file +Coordination and discussion for the FabScope project. + +## Requirements + +* LUFA 170418 (http://www.fourwalledcubicle.com/LUFA.php) +* a PDI programmer (e.g. avrisp2) +* optionally, the Atmel DFU bootloader (AVR1916) diff --git a/fabscope_proto0.pdf b/fabscope_proto0.pdf new file mode 100644 index 0000000000000000000000000000000000000000..9ea2f326dac5f114b8bdced5cf66a4c803c775ea GIT binary patch literal 45235 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

XqJlE=Qeo4ZHG}D@> z*Xn_t!vQTtNpi8%>Yux0=GKc%79uw_QU7b`!jqUMQXf7}6)n8BuDXybi@riftBV$J ztw6{+6JQM&$Y1`yBM&qkzOqQToMGAq08NLh+!rqAowfn~<^BhDUUfS6g*=erAG>I| zjbV65xo9;`(NNIICF!-5;hofAREQmi_t(*s8Zz(5ZjOq~uRY6vySk9eJ}#RM|S z>d4V+<*i?cEc_-`|Akh$vqm~7)ejvQStKww+x>m0b}V&Ojw(|=|D9Z4QON&j(s_gucA*o}s2%`8K6 zj(hkK@!=ErMHTYrKaj`vn{}mv;*&W^o4lif_Yv{Y4MCg%pdiITniX+Y4t%Xb(Sa+? zx={f`ODCAdQ7r6zw91VTLZ>yq&4{Jcm}+^k=S=#20crNMwQy$XhMDPj~3jU`@57xzOfQ>#9XDeqR=e z7p0lKWw?6!LJk} zYbcEhNYwQM<{9Jog0d;jp(q9ky0^)oP^e)`0Ut>fjrwqpi6OJc*RK-%1Ly0jF$aRv z;&KdHvgi$|4GtCf^$WUE1=tNNX($Z^=)BE^>211Y$;@hWvWqb~*Sem-2BY)H^}5yR z^#5}0$7M^l3*2?afx zaPtG#{wf2_2mM`EL)C4)XX_x!dqSb50Pk^+5QJ^e`KK z!v*34be#g9^Zs2TeCI26hx_0Bzl&8NJ^tU_-nd9(S{S?wVf&CfMz3LCf+z24PxWCti z8!i1>4>!su2B?W$h=2$Vstr>#RTa?G#K1Q6N*IV`xxygal2Et>CCFbTV4K5G8=e2b z|IE+9EkK1q_TM5Bz7GCQKWMNk$2lt^#mc9~C^62j-geW;td{dmW9*mB*wr2SO)R3H z`7N0M3l}jcPgn^TB@#|VnSvgGAOVKZ|Bne}K*!{YV1cO9!AG;Np#A=i#m`7e5*=C z9ov5*u~j9KPPwqH_0SVvEmvk8caEJ3Fnp#_NwtXP$8`%$rce{e*rG17~g|OWg&HM{u2R8MB-R$^DcX_*!|i2 zI_yEqzC~}^>;6kL;&G4Cdoc$s({m$7PF#r85>SPA?Q5#q0dOgYM`5KOxR zp;_?u2f}N-{{=}fxiHtE!^U&(!fyJKK1$+{s8^A)r!Uhi88D0E_yF;is0n(lO!BV_ z5%VL+Dsy4-BJ{uNhR*b7KZ;_|u%~+_RqGK0R0sjH{OE|9`4L^`)novH^kw8wHr#^$ zxA=f-w^GvkPClVk5hkI%Cr`L4km7rOVfC{B4K~_x~X_E2ajhTK^v+ zsFdqdiXT_k7l33NzI1-?L$(VKj@BlG|Yc*F^@*H%lV)x!6D7&b9t@r6ghpb z3T(%a3aq{!XYY780XftS#d zhOl`RlOjc~_p13nt61aFJ~&$#7XozBCreo?B~U0gKn<+v?y*)vtsic(SRpHHH--Q2 zL6iCbFgJ@@%4fqX6#OmUhCz(2WeZ9eZU(m4tBwFq;@afX;l0xXMFl@gGK&ViN0#_t zU3iLHs8eDDRJ2Ivr-7o=P3w*Y68qgAwK|Qw?HHm7aAl7=Fb%jlY9&@&YH(_;3Yl|b z&aATCan(mFKGFH0ztnrwivO?F#=rbFUVY8Jzs&`|)~dSV2k-)Oo9*`5RH8nbVT-3} zR_3ve$B4{ZZI2O9De$8Ki{&VH!uKD>F0XDWK4bVL+w;S4k@<%5y9EDU`Fm?h<8GQ# z4a2pskQx|?i&~fk78c>>pEvBi#;}pSaJV6e^Z+y^Tzm*Uld!T@VBTxdzY-fv!lkFq zY$~p7I(pdvInl(R;P}SiT$X{z9R;N-QXAnf?QZ5FKAE^<7TXBv)k7 zhGv&s-sT_iypX8Z{p#NWF{)3-!Y6|s-*4|vh~Rsho-QtdZZXAQWXZOv%7u<1hDXA(OsM1v-8?sc~M> zqsMNH{H<@5(%u!V8Z`@=_$hj?$ODE_B_PLhKGF zu$uVAz6_&dzvC1SAIGBP_;;~>j{dogv;S<;)_@4PI%=!$eSY~`P}jp-!+@v#ALUE_ zLAHZEpdZ`mpPeQ?G+U7BaRRG|ke8x@|F(6Pm_8Vi-XigyVmL38?AGuM8#~7JZBm4F zhyZ5OZb24$kTY8{da2alDf z{N?IhBV`?Lj*E?+NlO<-i!|n4_>n3~76;^iwZt@4l;Bo)&V3GHZ5=*)XzuNi*x!EV z;uO!@JWQ%*24vwtCP)kZI{xoA5`kAqA(qhu1CrL;!XOx1MM9&q!$#>D3WctmUb06x9muqBH_^zc*E@BL+yjJV!!w) z4Xf*^cZ53N{Q06S6m}@MdF8EwkDjt0)zo=-5HqX91W!Hu;O}a#c|6h;b7Xp=Q^J&xz|2Z zcD4%eMHO3gl%MUi#MoMOu5mYNsrFYDi`9fy9DT9cUaAsX3)%Zf9pJ)t+`ni(tWzkH z9&D_m5<=QeV0Hdt-lJIC7Q$z*Rcu)XeA-t7Jy!CoJ0sG zV?HADlU72~vEQJ-Pl~i*XXA$U5u&0h@c&;R6-U(I@+E&)juiVu)2MyHxzQJ02zni9fi$~Hq5vA-{o4_gHM$>yw8zh@;?F!s2Y+rdVgqiD6%wfo z*Tsp9am>FcBw}+bOD_MXs1T9ZpIPHh%a6|R^2JmphPONqoOVu&WgP=yHmxhA(I1^F zh>kHMH~Fq>ZN6>_jo4}&w83M!T3fU_+je6NTZ}t~M+*9L18R9D!+FvI1YtOQpR-N${C>sJ}o2AO}(U$Cg(+$0U z-T%tiD$ro!6SokEYA-dTSZTA6enB9$hN0V4xhDC!_=6T@%t-RU8^YC=QGF~O$Kv|< znj|jU9_}wGxLCPnJ*$p3S$;%Ph%_laA(aIKtG;WM9iQz{_6h9HqH7v>dKWiQbbYA) zzr^>}0TzjBEdXjip>e+Bc5P<9JRuezJp@aLSM+`tW#=1Jzi9OTiZ7pHu++IOwI&U%f|X6>73$932*bmC+U$?#%WAD7#) zFaYrUQfW?0>HSyApR>Y+aMAJntkB8vwa6PbcaKl&j;-P!5xl2jF*rsX@xwftUp)*? zpk0iN)wUppjt5h%7qZ;<`koMMf*Jg73q4X0J<^wx{+5mYHbW%753=ltG(e6t;Ll0# zOo;14i2K_@X_xIU_NcN?*`5iL4qf3lwxJzvIMTc&`fO72d13AXN6F`mWoOlpt^MZz zXEblL$+3$ucsdA9QQWY|ow*Yw<241u9O6&#I zv4>_N4lhDV9Msk_#Xx7%509nP$!?GkNqCua9H+x61*{m_FiMC_%7=)Za zW$;~cQUH+~jMplz%=@m2C$(x-Z9E+vvjHngZ5sWAx>+c6IP&MHh%!xL1!_a$LYJBb z4<6Y>P*)~d056^IKr-?2M*CR~cq9-YI~uv|b*mk>n0^4ULXX28OHSr{vuo6(?-k9L z;C4Y%3Od#?lk?w$Sludx!s#S0Bm^fNt_%Ts%bV_mbk=T2`)QV*f4n{l2n=7I96Nm{ zVAm9#r^iVvH;bugm}H&8)vKNirIh)}tp&}@$!te}{OU*PlA;QcdUL}#$~|H^Vwhjk z^DDjXjg`grtuhLDSBnOuSDo3U)||H*m4kxY#pGHV&n1VbhE11-V^2~Xyc~BZs&kk? z9pCZ|dgQ8$(u>k8=L-x+xMT!Y87Iu1gEr#G8!E%?!Z~GhKdUnP`)X!Uv!-O(0jySv z8b5qTFdSpDCHhrPsw6TptNhiEpZ;ue<3zzUFh(G;na1H0RUDT(ITgT>SJiVYtygyv zchkA(GMO`^DU+dnPkx8l@_$m>%m?##nrg^4Bcn*Tm6{PZj|Y*%IZi4v0h%x)btQc48LhI_9k{GncHag$_!8^qan<>~j5wOBs2T;%HGqZ@2L znq8r@=rr_16qDAr>wRBlRQb7AhbqW>bh+=0p_*oe(Prl2gx89H0=5#lox(OQ!l@m86~Y_^>6PGi>PF1=$mI{;z@U zVi(t!`(ItZ@5^S=ijgNXe_T}XN9~hl_0cxVTQ6y}oz@8-f-9C;S8`!Fd=SP)p&%|5t~O9DiRGgRtjdfGIF9H z3O81I-4s1J&Ty!H>dm|`)K1)IM@w@rTied)+e3w0XU-_!Z2^tRJ9#RkG4Jl5s3ovkMqdIZ*xSI8q6o=GJ~`3C>dV2Sj6Oz{X5UVhvSvF*xw5W`<9R~+(Qn;R(UXs z>OXN~+8p4T<}f)iC7i;LnUQnJXfL(GXL2m`X4`Sm*%N6sR+sRG+P5%yj^sj{a7B+_ zcKWryM~he|!(;XhZlyq&+xlBHu|qV@ms+KyC0`6j>&%`(=LBCEh^` zf3v(wao0W5+FAXN0$1;_TENa(a|%#>`>{v;@om4-C4(*X-B=_-2sn1DM-i_ zIn;^W>e|!~#C$D`Mm61w0%e0^j`}Ay=Z0Wg8Lv-^V*ZuB&d6{aZ2e6;JnB4sIRfV< zuGj5;c52$O$C5xqFeup@Qd>(aV2*6A1N8eYx**!hf02L}B)pX_T!nbn@Bjx#1Qs5| z07nT^P+<+jz#Z{BO}1VVvQb`kb5O;Fuu)7{8QEtDUCH@T`Fcz+bLC>K!ACwd@)%w`9 z=^bYBsbb!abU z%VlH6!*b|4~#pp*SjKtV|Okk%Wt{uA-$T^KYWLq|Qc?dh01h^as?oyyz)t;&C@q z(n(^chZM?s$w@BLxtg1FA(!E4oJ(cN*q%7;@cOsVkLi8s70^Ih+2e*_Te?DHU}OoT zz@@}S`#r0@Vf|qXYoaI-l1=T;r1t_Vy|eZ{v4v~pOF(~Z!-;S3UUdq)GQ!YmGPPS< zoWH~fcRbyic(&cYgx?v2Bg~Nh5Is!bXz7W8lf2}eX!iBVgZvnZ059ApNv?Q0p4qmC zI66&zE&t(f_U}GDfI_Pfy_}cE(NmcCRCgHX8bjaMEPUN}O0qt{w%LMiGtO0kXe&T0 zTDJ4K+5N2RCBVNL+P+Dp`(v6kwONYHPIdBJY!n<%y1_P%rTS}wGt2B`Nh zIg_Wt6hq~b(psCVic;f78wHGdMO&NuQedqcWhq0-e7ZBUj{j5-6B@`oxnpAmD}DB5 zs_)H|LwZW~NiOGCDrEfw-s#_=#B1z8KEE({>-9Q4Z5N0|39?#{nJ9CE50K<0GQpj+ z7kV!>M=Ck6PF8BpQmWC0&m4bHGv<+3pXN9=8H}@b{7d!x%}t;r{Zox1L=fjd;W$ODxK6I}Ydo`0}>RZh}AhmN!7FO@!>T(;?x55v! zy!epW@x$pKqIZQKV0l5G*^&R6`CpMy??F1b`T2v-(7(Rq-vsXDrt$}$zrH@C-s6A8 z#=$As(Mp@#llR#nS+v{o`DeqPL@Y^$NHi8ra4wBxu6D^{#rCz|u z%u=;k?TVdv!LgndR#JFsL1?2EPAqH!xvH)mKbuFA>sap$&zSMN4^rc|&aUaIn%S++ z{W6qUuiwzx1&bpC626?AHiyM;Z|2>Mholl;*GvUMz-=9iUQ%3zuFb%;S(gOSP=Wp# z6M1#6EDmvZt)-}C-0xAP`948hA#eGt&P83+w#AYrHwjwn1m!7|H_sLqpZQR5sh_8v>fV0aAg<*iS}ipx!z&*jOCouzuW=E&ZpEFLI22&{DZCMp|7P42cyB(JkiJ+{UW ziBs*dlV?^_{8~|_gG}^1qu-KzH5Imjx#icT4~2T{(jdCkcHf(#;-0e&?(P<3~x3}vx8=0&k;B4Z!n=suQ6U;C3yuods~=^r=%4cElBg1xj2p0#yZy|KETLzD*Ivfq5wfvG+-HIo~ughxPw*ICB2dF8qw~e=+tJ zP;E8czi`OR*Mr*Ftd!v}o}!&-1>Y{O|hK zx;HB)GiT49IXSaN_w2oYwJExRp~7$-`ek|sNHUr7i3V8OdTzen`bNz@(rdcrTU)_) zKPl3FKGupO_~e3&#Ikbk;&=Tf&?7Ib&F}E=a%p&rXnKV;%<+jh@;Tl`N#$HTsjtrM( z1Sk*pVo9N{ekk(jtm<)H0?&J8h_?J+*lNrtSAE)!&$I_qT`TTuglGxFA0a|??PdWq zf;(1xD%uHC2B!1XlieK5kRIFQ8>ni`wd`2mebHXegN5W8Cf4aW#!(~Xc}(qjv1r`& zsM~qWJtcyyj>ham5%^C}g`kh=AdRwZ`6~HwYNMLC?~D2-;dN^#htos?hA*jp44Gyq zw|Bt#@Izcr_-=qweP#Iu>xa6O?Su@rZ-MDb`v8S9$0Dr5+mDx~1a4*cDRobY?$o28SG|(-HRebl?*8LsU zY8J)sB$MmuG7+sSB*lYt@qfI}WQf;_Ygl#)s7w@bmW-eO`OL;JkX?_DU3(VPyin{o+kcBF5mNGwfZLp{57U=U?9%0TaZX z+%2X;jz&*d?+d#Df`z{fU~B~Hu%Dmvr@9?%PXE$5%1>O2+{QZ0V0;Wyp&;Mz7Oo$k z_1%BBZFyGr+Y$coimUhiKH&pzuy3k4%_CW|(VLY0R$ zV3OFHj;huN3b&Hm;x?1ZVXOpaGCmw#37u9qczrginZ-+Cha_9TZ-f1K_s(tcfEkpZl934C8*PFkm|5GwFYE$xNn(Sc*vw^Xel@M^q5$jn{J8J z!ZM)ol}I(0^9v-WtUD7L*zNY{ZN06cFjp#Age%)zyC=|9Zpo8(OYC_6Mo8$}-{`km zu$lI^`7n`R5WJbXS$q2{dA>^bL%7^Fte339X=`7?_d%4@RZ6kbDyWqM>V8P&-I-We zK--?baEt3b#ZjcUKBX<%ZQ<)5E<%5=7r)41WBzx~W9)r+c6K!Zh}PBUn%tqajtOjb zBBiCRtaWbU%BJ<4CjGYEyWuqMNo;5H%+pq(yFC=^Y7W!irr2pK-oRUZp;b81H<(-J zl5y?p98kLQF<4%PcdI)7&VQ{W@fZY|4Pub z?#4NGRHkQ#yhguD|1d`iYBOkP@SR_DgbptD8JsU4sYlXhri3?ckYdCcatQ1;F68OAo~bV@4IwV>W@;IIJVyX zrQP1Tv1DNi(PV4Nxce2Is}ILp3rl2T$$E-j$ca{$36GCtQ74~>tZcB~xB_M_Akj?a zs2`rlDA$UWX%W#^w3RNt#_h&Zs)~ynyy>fSrw^P`Ny?YfQB0W9V-w**xmo9-ChjrT zs-^$vDc1N7>$*WC>|4)Ot-ZXmo}R2;l;?iW=*PyvRgUgKp&-8~-I$E!#9rTuK`A;OE~ka|PipbFcX#`h$$9x@S!_4L4VRsf zy@Ap~EKRR+4K=iR~Zfda)H6 z-RH6Ac7fqVFXF~D+SeD&r^;LTiky^6wVwZdbK zqu0A+CqmLa2uqS+A;W#Ui`2}FhAdzvMEBopA15|i53CN%si3QLO=Vm~5uNOg&P^l9 z^@qO3!((GqZ)F3*v$JY%lx6t?l?}8B{?2wq8Dbe}d;!RB9$wZ}hNCO3J`Ogg1`DP} zw|8!=O$ywsZA+DTisIjqe|(o%2I_6z<+1a=X`hO&I$ut@dKY-DIC0cWR-Ow*N=a=5ITHEt4b?tCSt2Qnc36NEr2aftmss6c((bbMeS6Yk)jD91lc_ag) zpLSgjHHd!N&!3_wt~S1DcFQMyIvnmlSK%%q6zhN7x#pg_!6fu~M&5vX0{nCP^0#{H z=`#QMuXBACIX)p8O06GxXO4g_t-#F@wiQ!JC3ihjhtCvn|5GwOMB2+NCXdteidMIt z{)3l&+-9qQ+ofrq0-_F~MQUoh<;(h0bdZTxm>+v7rDb2-KdhyYZHKJpnz=sS#{f%B(ToIS2h;9kM7yS`#;jX9PPw%&t= z7~A>yGzFHS{-O=rlk2a_S}_}GKjlsJX2H8i!J8S@-FfGc}nY;g5K4~_yw`Z0c% z3AS`~>dN0St@n0;uy*TV?Rb`YV+hn=9+582F!`X5{PLTgYnc;vpz$!UyB})2+HV9|Aa4Rf+$5BMtd$zGle` z&Ube#Q8lDiif`3jmRbp6^nkfv+JWf;)h!eox~uKu?>n9kX-;PC?S^my=xfE(MC9v2 zTHXfmPqL4uduLr0n#r5NrVlm^xj&6`h zdvUcZ9z&w+8~q?;UD$ly^5Cqc3el_mEgeE(+86i184e!D-Pzyjt#bCRyfRLtC~J(% za<*$V>eE%4-s$A#V>$P-wF}1Ic=4I8N#YG*^F@HIhu-t~hYQ$OLv@X1CV zvggR?*Cqd!#JcvUbYOAxI=>@f)VK1+8EyAv&l%)J{BWUpukB=GmsH`d^mf7C46m44Ek&hk;a!@$v&%LL zO^(#_cQxovGO7Kpt3JU-*<5#wi(wCqC!*tf?uQb+)p_d2up_E@nq1Yuh6_3Zva-LG z&yc;EVDn9%?owf)vSg`xr!jD&N9u!uGHM`Y&qqvGo100{s&lvM`0ERx*`xJHUV6=0 z1l%DF#t5jQ8*eI2#JC^m#&+0#FAA-W30T@^n#xT(yjXzRb9pG9)jJdHvS-;STY7aO zjv>}Qc%gXjz=%^dx8u<$-koJOAT>DDb7G(6t2(wMmi0l&2}&M)I}5$_*ajIZ33-;K z$)mj}Iuec-SM9t~a{YQ&06E8rk;WfUDx4Ij!7*Y;7tN+lI=34X{I0`i$s{D1ksJhe z&nsj)qTc5U%8g~39WPy@73B7U9f)BSh2vj2)k*Im}|-Uz!o!bn2z zz9+qNwdZviLmYuKW{f65f&+%G*GXJ^M%{u2e8XnEw)C5>IlA-%R#JyPdu8_)^l*Y) zkdh-sX%P*u4ra{naB=*$B%tpCjWZT113Vd3q60Em08ZHZQnAU|#p1_vJox)uLB9rv zSbvLRwj*^HZi;cK*NmtWWO$l{w4J+JbRtgYnL|)dgOXM6bY^jFX9Rrmafz%Yt&EG2 z{?J$A*xih7*s;0VkCq=eZ4;yD)&c)4@LF^oBi9w)tV^(_Ol>dScJo({PzYqW?y>GV zo4A$+%-KK0`jr+)4cGO$YlrI2n;6KV4GR+ZYY-=H z??xeJ`3Gq!DS}V;y7`9A*x5H!O*FNvp4D+qj3c3lC+AP2LlS=)_*PN9*-f^ze&;Dg=>ZXe$ z#j@nB1<4cIwe2lEW+52#kaXZCs+5OC$wr>5^1ngSt!5%&a9ICz70dH29{fKPw+@`l%(X)_M_dP2G zE^gIy9$KAEZpi9G>%1~dyLW)rhRm1j1u>SJw7vjK0EWrB=(THM>*t|QT?MYdjxWiP z{GmJc4bq7yEU6orJ~?yLaPzaNBb`=xB);8kxHuYxufhs)y#(;KXmNT zn%n*s<={9mtoxArv=P$hkB6>GcQm^yhYqh?ayFoI%+e&te5>R2xz+YOzA8_zv8%_Y!mej+>ov@D z^_6v{z2QbC4W3$5!}c^A7E7lg+NPx^RtjXDE-YH1a3QCebmS z^Rlu*K0(|xQt6e-A^=+LO+<(S;Ilj@4|uuZoLT^(1`HD65CH zCfY0QLfo5X8J%m(DgLb4H))){vkGT-+}1+Dm6*Ly+IX--x#;Fk^61e>B~b#nl!688 zL)Qg;qHGv@!`?e6LRY2rI=d8CL4DUVGt9+j0pz8#60eBcuun!eVQwCyU{OM{qMGr8 z+Ru40SE5NCVmva8D|nb1(7S2mt>eR}ScQ|e?N@NORB`^;5zO%B`L|RA#byrJfKuI)eW!d6i$wYt; zt0Io1M|Yv#(o-AbMigF%CYbT)wPMi_+X7kFJ3bIAKBU?R=6UI5|K}jwpBqExh7Q>E z%cidEYghe3_vzA5ATWdO_7Y{Nbf)e?&Hm3Z(>0jFd@iq3gtuL=Ss!DGcQ+&8x~#Y@ zyf3Lm0pq8=5Xl-KN2IA!Q*F8q)NO=#``H+9EMZlpj;L-s+fy zv5Ukrc3Ejrx9HU|k5MmHE(TVvIE|esy8SRZYmf{}qg^FpQra?Y?O@rEvPfttqB5)f zoe?AwuNU|tVp_fNl=1+ju)gT|_!nYI_;M|LrEbl<^uX}6!9wQUzVNM+p^2aCJdYJ+ ztlMAc;%o$nqAebiR>H?#P2TLou`>80CcTx#+mv7Rt{hn#I zy}TlO^vKxn(U62UIZ|$K^24P{Xn_r<*T%tj%2~Qu5@w&DC_GkMt8m%dyE)|dH>Md@1BTksyP~@~g74v01 zpoP+T(ZiH0c|$)B_kH57rXm81?6PEI9%V)Zw^yxp%r=Z@+MM- zMuxtO$Dkq9?AjLQ;=Nnbi0oM!W)tld@Nz=EN(ECu%y;`y&DVfsJgJS%`BZ2Fj5Q+q35Df5*G6mBN_ci3(Fr?{?!voUPU} zeeKgnK3>CTaeHtlj{Javr zLehDnk2Ra!XPkdl-pJONt}HSh*AlGO&2VfFFfZ;E%7h$N$hb}^u6dwXX44wBoof$ZVMZ=Es5KtnmBYCLsBF;2>p4uV=Ac(7$W1r;~787mtxiA<1!|KZo<7wT2zj_s;FbQKKNT|^}H-U9{SyQ z%OHC+yEozvYQ0YizzuQz*3&M(KGy6>WA|El*5C&F(O`OR2~i~DuCbupS&03@QdWIy z`tq)^sQmn}=W*F&=csr8P+eNRm+$Jz=zj!n!ycEX=S=^71(42opP#a{`WBmeSYA(t z?KMkPOv>cP^ZCR=lD(+PXcZ1(X(NYLNb3sNPiU)^uZw368mzL!$PKi#5|aMz5tnpC zLN%9__auwXO)eWa2lgtZw-S;{Xw{S}D~^Q=oUi5735*21fl0GLU=?e) z39K<{UW3wSm4{v~(!DE%*jXEAUO%NbA2t-y+X+e)42&c8oj9dh(NaG?zlLv2U!&DF zU4`RmgX?aC2@Qt2UNny%YMI)OE$K? zg+2=k-`QZzJRIbl=11QMtGG>kF+7{5E8 z1i#pQ>{0Qu6%%6JEJsgkpvPiQy67!%yZvp)ml}wC;LNDo9CM=+MGN=$e!4}^w=9ih zf<|_YzFBh4b^*aZ3eH7Sh6`Q%%UxcNI#zuVH<;!&gJ`I=hmX z?j_W3Em)V5P`LP+PZcgizPr%^OF89}<-r*=#7Zh?@(3Bc1_)>V!B_v+pPrN&ZM;ec`1pz z&bfDcmrdndZL$d5w=R)?V5DSBz1OhD_|%>bS>`OGlH_(-<`t;I$p7Cr%7``vUMCK_ zSw^%fahWtArzF-5w~}$TWGWVCckWLyI^3-a5s8qGs_&hWum|IH+GLr-jsElaaCqLJ z3&Q$J?`DNSj~KaBxzaChYflvGjf?(tVxAdr2|AlUNY+dFJ@rlhd2pn#ZN6eFLW&M( zm779|zAI^Tj+%R&E0T}3z@=`&0)%}ne+=Bbxca(3G^;5#^+V{T!Prd~oTQ(c;Px7t z*%OCPey749wud?4I42UDqfYXmXWRkt5#!Jq9kDMT8{`QsADMHWDUBJtY<&nhqw0X$ zP>oz}Kx_B8vu&SPw-anuKU{X-lua>={@q4JB3As>eUSv|5(Wi$kA4=VYhDrVo7z?H+}8;+l4lnl@JyL`JljM*m_KI%((yT}n=f1%S@*sK1SlG4Ov`n+dy zA}Zke;eC;P^+5!)G=~k>n`dU-q&&)eKWiH6i~Pb+C#j#jN952)Oz z0_F-k)D-Q?KP^-f?Pvf`cGXiOB^N3MW}~=^=TF$a4T0TbCoiUOd_ogR$6~0UgUL}g z97%h7`x+Lb^I0(_B7LPBvrAb8M_0)3Bk-n|MkU5ph8n!l3G`|e9(P|GbKo$(%~xe} za)jFKtm)MIWEBgiI<@k-Bma($%(}dwD+<@**t9kS$LcptZ?X&leqRqJQ%mPoXpW5B z9X-t}xaf{?j5T@_HELw~3VWEuVbKNeBCH?HZ`JAAC$|}Udh|%=|3bP!EKQLoEQu!D zDIt1sJvNCURftnsq3S0YAttVp^&ICC?8&h~r%BPLxVh8tZFtUE<1{9Fpmg zqgrRklKRovrk-eD6-h~!=PA1luS+w{$OK~mY||1a$YuTb^*8Qx80wSf4EVO1NbWyL za~zp_oA=Rz$`gn>7>zqQBLC#MmVRsa)h-`4O{>(7A=}=SdAZy)E#Xs6p1MFLRXw4( z?=vD=<(_bFcKb!^)c)*G`P)u;*E7vrf1Lx0g?4$*|0VkFfMTd!zTGw9c)d8=zd+Tv z6fX?E0KA-6o=o8oN?^1vAji3^ttQ7oYL=O7nn~sQPMc8yO~IefCOVQ6Djtt(|HqOYGOZZ=gmrv#wiU$q~ICVq67mDD}hG&;lN-e$KEOpBGCRY5s zz?Zh17EvN0%E|2vRyu|U>3)=$zoMx%@{Gg;z`;x)+upWe+M(p>Tn||uTsn4(sEe+o zvoPZe5hX8UqE9Y@@0GrsSe+WF>i8ApLIl+81od}$(=rH3KbZNxSA9PQ)YM_D$AErI zEvg)n9dpL(NZDkv$@dDRE(2M%y9HWw@2oT`waI+a{7T*6Yir_w&}W_LV8t@aZAWo`@C zHShT#|K;f-;q4pp+&C4#3o$QGm=jOh@nP^j8yn?_OWRNWGDHwMLN|6Kw>C9ukTNmr zwnM!B^bsl$i&3i~nK=Iau+@!a@q8AytHB9saS|?q;nuc(h>E;Vi1n=0BlJ)tZ=Z}o zEKxtF_{%|3R1>f!cGgVkjVRk6Z|>{}!4ikXZprx5>U|S^v_iz`I_DIn?q1I+sC~s( ztG5KmNgt|(--xAZg%lx)9a^?&sg);;+#BF2@gBt}M?F--x3|U? zdHCi`TeEVU^4xxj<&2c(uf0T6p7awTJ&BBJ5j}}>Tc7ctC^T>UHHxT$LS_`+$+6V9 z{F((0%mIt%fuRdP%SE8{5|9SfYF0C1#F%x7*__WH!H^Y~B{w5Gr*|;n%60E)24^An zP1*_z8^O5s7?Eb;HA)QSN&95nWReL*1gK+g-=6vLS|%GY3tP}M1`AbO`#a3tVz>O0 zb)Xg2VMosVz|#_!_|w&idhhea)WOTc)?1zMb#Lu5lO=54E6?azb5&~le%oRkca42}H`X(eY=s-da_T0Pk`>~%vU6>4&x+*R<2{#_YaO8fXQ zUKtY7$XIg)OKB@~merb=8Y!HZq?jm^TW^Qkk^zlT)GvedTJ_F~r2%n{NSaTi_7+(A z4ju~899pz>5cTAJBER`V4)9IsBATW1VM)1YzNiwJL&CXwqh!=QA9|9q^flv5cwsOl z4&Uk({pG6#oJBnzdoc3i{CEvhnnkvjRkoJWT&i1e8Lv#1lbrolVJYdzm|Q3yAEG_j zdNH-=n>|EX``Fh$S0JSZWNli|~XOO;TAb5-a&-rx7m%yZg##@oLX+ZUVNQ$y0{G$=aHuw^I`L;O7RW3A0c z1;1b%zrxdyQ`o9-9_1-tOEJMp@-kaPy0lCJRb6L}a~X_|$0tmdW~CC1G;uN5fa1w; zF$>2Fa`?sNDbUgA#lh|!IQH`Ku@3BN)iZWvsp(CFe5H6b1eKp`BbKnfWYEiuB^Ii6 z@lxGyP#?ve7B%u%J0$4w?)1!A(7>iw0vHs9Iy!!SDq!7^T9-+x80dh{SIJq*6s%M> z>3NN!eh1p;`j?BporzkYg<<-~{1xw;5ptNkeS8~i8e zJNo$XpEQ@^f09*x$kMc=p;t`2T?}HY_zcFPC2lzEpFfdmDXTdNitxx9)yt%F({-r+ zqD|1>P%C93yf$Vh5yhlz&FJ2F4tZRO!_=@UzLu2*aR;4 z1kRBhiLMUb0T;B9FxDaeC#sXs_TSjQ#8FkOclwB>pYLm7iY7j6z$vPnrRvw1brzP#~$Rh-A<2;|Y zXHQp-ZMwF+3p}Weu4{UxNyMkt!`vzF;>CAtp!IYXv~%}0BKBK2WD;F~m+&7S;k@g!?>u{jltm`T%U-QEjJAW7$k)(P}SZ(f8Pk7TAl{sq@jU zQ`n2HGye1J#$+Q>o#m{z`SKfyoScou^T;zH{alSrcv&921&iShFhg!N`s!kD)gyD8$U*=om`=`1S zZTlAj>F2tW%htCd=1HE;JAPyig&E-_6c@<^)O;crbaVcd(5DdZzVI!1i7(i?WvNUl zL!~O|1r_t&S#tN$$BF>a^8NGrytg&w$8^W?_*DtgrOnf0Qa-~>c2CO#UI1|)3og4S zEB`unA)PF(6C2S40mG0Yv$y(G&OW5{&_1Y58~>y)bbTbfFxuwUDvlyUpW-n4{jNa2 z@?Ug@IOn>mm%R5P0mF)4Cn$Qe$G&4T=<@#5P>S+)2enT7s=i9xCE+O9T_saesbuD3 z*McdBOtRdnO~y^Uy|>kl@`3Ap7_8+8NDa!(Xd>?yk#eaZw19Zan%T+-*Yd93e^1)9 zB>RAY>p(tYDDSqIl;cTj^M4xc@-#pl4Mv=I{2QHusFOohV6pe=z2HI2lqE$|72C6u zctPn+ZN}erJz4?Ox_Ai~v)H-!D>S}i+F?2my7yhUj3+CV^pPamMU5yK=>}4W>VhNL zr&xn!xo^6Jmu+n-_DB}7c@ebxx%-gP5zrd8h0tjxpsE2kWi3G_ffxZNJCE52fx2(h z*udDoXD#N*>&Va9Z*ngq4K;zJo#!n@H)9;VVoyu?FVFQaJud-+bym76CP3WI;|MRd zH_JgcwFpZlIay$S>^d63us1c${iFOHZe@6K zHb)USF)RmuZ5P+(dQbuE9un?aXi0NJ)oBlC)y3yxro!pdmBg2smVDz}cvKjhVV z3EOQiep-^U*H)Jc8y7o$JIRy^P4|z%Zk+VD%sqJq%n9PSp(u4}p|DrHRUrCl$aAFY zy^}rZ+1t2);wD-w9mhC9&=^DR75#KJoqF~NMCEs2)9_xb_s>@$yg>e*%ux?Ib&hJI z_~b(U=DOlbk6wBaDa%py@#JjL`{sHcy6Vs+e59)UqYGYN9{Y?Zsu(Q-N2NhZbuXq| zhR)#O7OX-!2{aBALg1^AH*@zMVg-Umj7Vkkz?TzUm?3qVDQ=o+FLrA0wWFvyhSBPx zAZ%t5bGFlgWy3c+?UI*gCFKkP(VCi3ppp0;a#S>%Q|Gmu9p7aY$%vlk{M~_F`qoG? zq);r=&1%0$kO%EIg@P$#8@EfCOcZNNTw9*>hPc!+6a1=(i zetpf2xs6UB8sxEYBGK`gZcRrey)J`1R1kRE-+DHCJ#^_y1-u0u?Rw#U)yydf6Ztg8 z4y4cP4LEjN%!*w15o6KkMd1$a#_8FvTz_0_jjWsV{xf0RWSLuE?3QlqS*h9>mz&ZH^#v`8dL zF}otv-7``0$%GJc!OtL_R6BPY+eKYUUBarSEeo}!N5P|U`2Qr3?6f2AgH@0gPZ z*KPPY8O?ut7#8MkyKZQ=g)K7Gw2+P3bi)i%9kEPIA@%krM@?e*^!B&+wVfUTe?FO@ zHliL~+x_7=6vALw>{36*rsQOP!eL^Ffg{`#)_?||(W8rxbh zN7}!z6Pop%nv(5>lVMj1cAqwm2u{R`I!W+w1GcCOg~KE#tps_51t$u}-S#)?ae4|} zS^73Ai>vE@h)FD81$`#c=LbGN250C1#LJQ21_SM-G{%9@T0~GmAwH*{vg+I~Jx%@J zB-jWgRSJ8Jpg#+<4*W0jkCjfv|h5JtKsb2bXm?-3ro>!rfU&-czB z4)OU;aptvM0lLv%Ln~>DsvPQQe!@qEHFgTU>2f(?UanH32(-UEcGiT-Q+<N;a#K`Y)_P&Yn^^FIdm+5Dm(uuQs1hI z(O5D5SrZ3w@Fk+fhft;-Vi&_ki{R4LV55n<3ArI$A zL2mT_68ZigBxH0B9bXp^C5MK&4G10n>jrZ2pyc`o6&amF3*_$X>1GLXrxX!Er-Xkv zG~ApmwLu<~MjUWtWl9bmkdFr?hoU1quk?RIDd2xN<(%Q=aQ}<03ZU(EaHpzjpUX{pE}J<4t|O1*-bXO$uS) zOUm!M@ARd$2;cSFpVY2QrR990*~)+GXmvk78LGIYy&Qclzg5YUM^mqDJ=x-l)!^vY zyJrb21*!l@xzUV>Q#i{nk~u+!sZ;Sf-&(~51^3AWsHW}1lD{v9Nz~)s&<5ZmbjuM9 zlrEKd_(u`jOn#6|YXIbKSzfA0l~JeB{=&+mCWC^!9lmvXBP*OoNum4Pa&07^wdXlgaH z96ObQX{Tl}m>l2B`q~=CNdWjsAGy*;+J`sN6>kmb52{+~Ef+;?H0AMYx5BNAsEgCc zuE$fmg$QL;HO+O9wbQLCMxD^gjbRrfFhlnm?=_w+%c<GNY5#^sMnQ_5du2WfZ@j z0l)^BHqKf-eXI;1bx5LEOpurAT-Sc^Q-{fuxWW%TW?Qy^U%E!d#^>a~cK+K6-DI|$ zrHU@>G|u@Rsn|-F^amDs`*=H48%exnsTT(Mv0QzMXLbbbEPn=d)|@gh2*82mgx6)z7fMgqlRXZu#Giy0G%ed5ODR4I9WlVrtZNm&2nF|!ThwW%^VkOMwXb?@I$FVWLS?!#J0pEA4}YS3FkGK*fd!-WnDrAe!VI={!M$6*HVHh!?W^ z72*M+f=Ww-n5FM~19^gD36dm5--=6fOb=6*Ps2E<6G6BdD>Qk{MbzKLQDca(eP$bG zUX7o_S3|}F8C_V1coqeJPzysL*!xB10g4)__}cs5jYp}>vFt{JFC;4g9PEJN91~1N zk5d=4=F);ACS((uF`8Ccc%?!rl+ECEOmwT&o6LTVeSW_px><@v+r5TUuY=MgL>GsI~%i}wq3)$jI<^$ka<_SP$~tktTaCCT)QWqi|52?^R_3@wOY z$^QJn3HgfMABK|np0M6~=ahq*P3-q+Tsl!bC@Mo+xAx;7d; zv-@d9#U;2)MHD|GSc;NsCC3j~z~Nt_Sz|RhQ&*FVszAwovTA0g+-A0cj0Q`ZKkBR{ z$kHtoZ5gOIc6JIiU0*<+Ba>!T85jS7GxH`XIBjq*KcfNmop8Au9NYY|?!81>TW4ze z6xc|vl_8?LYovATg-z^9a4Z=}fAkm8{6h)FU&(v$Axb4mV4@iJBh3#{?$>4#+e|-0 zc*Cz%=DPgJvdq3dr4(-o~Lq}Zz!7gaboW@d?xh* zXNFiEgxam?Q@Zuff(Lq126v2i6ODFWH<1krQq;_Td_yNV?_)eF@l}l5t^g?F_>D3T zcN!;;jZ=)yKz)bX3n4f_BwWS73(ruaUy}8g*}^DQMVxdT#alYzRwi5{q_yJCO~g6$ z@z6np-4!c9`3DWFa>BpO3`7P$v@vT!X@6C?N6Hnw{!l`KDhUZjR^X~R4Nd3v$S|-j z4=_K^+v!Y)JA{0BesC5GRHC|>viQro!8hO>Fj-G$FNR2TysLV9Lik1KZ~ZGvxle2N zGX;#+OJ%RM0rZsN!(e*k78#U9{=QHRqh9(Ak3!k6W4e51s$RiajU>%qCm68&mPRRA zAw%`FzXUqVFQj<+3GB5!8oUamO53mpuKk}C-@5-r18tddTJe5s zLd0KR_*JO2wD}6u*RQ%LO?Ra4-|bA_gXPiVWsE zgT20vx>c`*!ptg~M5*qis_yml)Qb>@KlW*VvrPRIDL>mN21t7SiE)pUipb(##TiB| z7RvEVrSLbSlvxxeQYon0APrTp(qK%c331TnEbZB#+3OlAQ~YJ&`7}60|8+~?RaNb4 zcdf*g3PemZD@&})uNt;C$E=B8#{Gne4wFNg;={w3T|6E33ULwZLm)S!Y@`*6Zj3Ba z9$3d#b$b+3*z3lkbuNp1s+2jw;e6v(&d>FvNx+Ow;6~2(o0lA`rdPHy5z$15I)et% zg~rIQVF0z392W#nDI3QE979Xwx(Y~yH|(C(bDBj((@qDeIXQUL%GS_Q1FtbcAX5V+ zO{jtC7_%9D5)h1`%dKCorLc29PH;@&T~EO5+tfCy^kMBax@V2yB3>F(&|OS3jI87E zSdO1yOc0#BL2kbpb%o&AYQ|>XYPL`pPEfOY1fUB#CMCwS#59A92Cs$nkC#m%yi>EM z{i+Z1m;~@dVd(xmX3SzC89|GK>a(MH|5)vJ!iq{Wl2%&Z)`7ax_iu6}6Kfc!$hoSL z9HHPuVT!S5S)?Yh5!#Ze85J*9Mx2)wlje2RqcpHIr+P)kFd`Q840 z_Zf;WwCC)b`AH*AKxY5tVcg!Eg$ zKH?g1P@dunjobXqNa|K<;@?ly_ z5fV9c=irf;IeBI@11!@Q8tg$~C$G#_;~cH3dko`{6DAx_0U)P@^$SO|<1s73Uc8D{ z;-H^+!of14O07s6He<$fF3#-j&MCwd;loPw$SydRSh}i=%#EHrx^(ANgxjWeQ7=mU zj%ZbrRw?;6ugRus++&SnY9L(`T8L2j()12g&yU+mx}Hd1TJRWkFWcCHwN$+R;8WFe zHmsVI6eWy9K0nuWD%Wk*jyC&N^!t(+;4V;7gPU$z_2i-|*DZYhscO~Fc;0~yP$zue zvmDg`#2edoCx70FcZUhc(;wn6CqbCgA4t6=@sB0qZ5Izdj_5 z8+RLc3xx#>6+DefGT1mC16)2M9ummu8L%Q0HNuA;eUJH#SX~A|w+6|jdM$#JQXU1P zUZ*<1t5qi~L|ZHxX?r5XR+GYY3n}snp)o({2bxdngr7DlJ%~3q91S`KvXfeb`zOp2 zIA7_;VWts+|YX{b#_*R0NpPpYa!XkOLTCfNnNd*cS(O zhaqw`e-$IWA1>Hq`q{4v^W$IzzT<0-uQZHkLdj!advGpJPyW+BZGvU2%yAI0I3|TO zI!RnSQ^()yBAXzAU}-UNs$_JvHJ(Z5Bom$`U6zDFHuMt03x2_(4TqJd1y1&ke|4AU z)CMiCvqnOw-PA>Kel9Lx840Kq#lO`cO=_2_O_my6eP6Wu+Ee85+W3~J_(X6RCf~8! zGY%(pk+8+& z5q|A0R@VW6o^qp!)ZIX0xzTkxynfv)k78!Bp06N$vu5`PJ5~!hIg#G=`InyUV!b-& zJh4gw;6ekbfCpIC>WtmJ@$$SuG#jrJZ4)(_mLDrNxq@ zG?}+Wa+ei6(UX)9mBY3w=9t8+=2GNXq)^+p!#S_1o;b5IzJ2G6L>ZT%2oY z+H*{P_>=HJ!erl#DRS=zN~41DY+2x@#C(d0p6@I2IvnH02_`?EL~VAu zSgf(615Gquaw;xcF={@}Hh&lN=~#&nunb;+A)87Kj(`7y#==78al10t)N1RZRCtbz zI9hByQK}1Nb|5aMcEv6k&ZJ~fQmp!-F+DQR4C?&-UTzzds#e!ae4AW`8int*XyZf| zfS;@%1mia9)l;nuRfw4o?QWxOM`g{0ew18Jvs^~A;@EcfQt3)bL|^w#a&Tohn6xv8 zFq)`I$=LxKF4W`t)FxPyqk{X4i)Vyyd<6#n6W?U;Z zaY{9D;2n(}d1feTxNS}zPuW}8LTzprEO1CQcvN<_;+P zAP;!F3aL(1b>Q}+#vcmf5Z9Mf6P?AUI;JfpVlh!cA8t{pdJo1TOA*!g>s#lvkoRPE zCzN!TFrO`W)?X%VZ8qVpI7m|ZCW?+VGI)d}G|Cr}!c1CgyG>f2I~SslmR`5`^m~HL zfH+`4Nk-JTNcCcx1bru}Sk`FN^4t(v)q$@KpQnX^K7}R)WDJj|tkt}NbbW4_e#w3X zJtb%LU#b!Jj2E|O{&_?%G1a^u|c?@Pe^W7qF~IM6UN2%{#NK=V&pdW=cGRC>!RR z%%TcpGF&UFO*BkMt#aGwobEP46wVGiJ{!Xv2LYkQbslrG-`4#tiGy7F$GY3E79)OQ zco;xZAFCXn{=}GITlOIkoXtp^iSF__43x$5xf=T7b4$7}6zK(86nzAJxpzf5S)`To zATN41rZ-sTu|~Tnhj46B@v^V^4HV+2z#}%2bWPB2CqGv#KTSBs)%t+|l|a2d;vTdVo|;U}vH z%#bP9x$m)|uzg{PyIbPB!=X)OF;+MFN8qb-cR-p|gKrfI1H%mAlMiQTSMkN@jNG3n z`LP6K?2C$L7I1-L=nTF5dtUDu-toWiG#Pzo^T^1L>DGVv0skVcZo1vFH|&9;&y!_w zgzQ}FSnhO~H|$Ye5(V%EbME=9@#^S#R}<`076y6kdly^r*D_71M#hpaF?OOUDQ3-A zPz^Wa{D}zkLKCS79wNdhkG-+zix5Ioq^DHpi4O&%6U3)T`)zUc!u!a@B5YQ$u_gX7 z@aMbOe)T2%tgR~UwYKRMj;*{`?4zD<)S)eGYsD6ZN!th+#x+0HW&Wqo042+Bam&yO z#%}LWR;1?!#@8!lO%+pQS=YY(80( z8VVOgu>g4}@}EgO|K2nFgiOcnBYJ>$uSF(!UTbbVJ`wfYtrpp68XFDJVo$cg`la}( zqvcKhc6T+hyv$Ggfr+RI%_v&aJSUn#*EZ?R|Kj$Nj$U)EypYo7n^FugBLJ0DSM5mX!yTlcJ_R(q$X^{yIy(uNl zCfgC!=(~qo%)|S5lPAZR>Dcy6uP})j_p@uyhXfD#{KOn;VI4wO@mPUX7u!*Q%_K95 z?Y_3EeIaGm!tkU|y?%Wga@JfbmC{0%3myHAr+T(h(F55k=C2x6`YwkE=RBLpr*7hZ zL^g>q9u5Ob;p6Z0)LuG2{J8Cmx8FAZn#qYcOnKGgTfE?n>tmMuN;QwZu2gBMXGxeA znVZ@#aEUhhYRi>^H_YUgHu z-Y?G#?UU9l5WFeEiDm(O*8((V1(>dhv2zkkh)(dg1uK5jORnwetpiU(>$cmQCkj zLL_E?V4yi z1QSCWFsnOlg`X*8W~(n#MqO^^1-3DNG-m{I40+~7S-HGukuaSs^-QO?pNTmvqz404 zcw*;Rmxq#JsV^Is{I!#-bV+IzJnrM+(hJAUk4Yzy88a_3R6jksw5Ac`ZM-NH8$=xw z)4MBqqjz`xeADgjtkAc?UWIo;aLKi7D&)i!%`jSnuifAlt$w*GoWNk36=y=f&eBI2*6ioIF7X1%7)*20I?XmpG8;^CfM|pZ8}7nY-3zCaP?5`TB)j4Gl*(#;kR>~aUb z??LITwLtcW-X-IkcGGQ47XCbX&yyPdGTupRm3?{bdAkSttaE^SV&0Mi7YR3pxV?r} z#wcf8(?lA1aUe!4ycPLwj|;Wr`_qIu@|bqGiv6PvR?Xp~XJS4c~AHEvTj|4fn_)em_;MA6kAz>c=`M%wnRCiRTiI z0k6?T8A!$=+W1`FnBs^CUgw=AM7RYDCviD^Ea_*xWBlj*B+5<9vzi=9D*9rwPhSZ(;9kw40L}(t5I$7<$dWjc1Q6oaaX_9%3R>&Ag z0~EIk>NLPZLOO5AlE7q1N@TBB$SC^px>3j|PVLIGds-1XRD*rX1$9okJYirm{+O^q z))E4hL;ZRn^p&1+t~-`Z*z@Xg=bgEDOtjbbz0oz?uTf?EXYcnq1(K;%Fn6Z&Sf_b* zrsAhZ2TE)A6qJ!DvfB1QM9eFEfa}yARVL`*DWM-wXDW1!cJY_eA>{m6cJ+z9S_yjk zVjESxPvn|$gekYjCizw;GG7 zLlJDeAv@#mRPuIGucSAZ+D#6)(tgG-V+*dXbb=lp(v;gh=3P;qOb>DDE>TNxJdc>Opte5l*@DLtZ&gDwlCsR*9vMN2Nh-3VSsk%|j5J!mlB zo{s`Sucw3A0imwXacFr1K0at9L;pyy#eo3_E(fB(Zk?=wj65@@-%iazA9#olQ9%NNOCEl0s+U3Jyh0ty|6XuR2?!b#NQu0&phw>MeeQm zcrpn|8|J)tyJQp#!jN4&47eM$(dvN+4k_LiINnb<*$+G6TPG2&6{{0hm(zN8GA(k_ z)un2Lt84H6X_sH(6XMy>l*r24j5T{VXo0NICE@wGahD>;bFGm>+~Zp~!7aQQ{xp@{c}p00^bt-qtlz*ilG`~|X8h+NZSqn5ZMj}0adG2d>55zm|Jy}U`O3DbrSwCE?1uxT zqT-B8Y*%LV>PSi2 zJ@bAWXd~uf@Z?0K>&U=xA{Bp(mIZ71UAcR|u&7eKX)Awg&&evi!_9kdbgw4O(}2dA z*%;l9CyQ$EN-{UtLbXHCd?N)y^=|4?e1L!cK8WT@AVFsL)Ir%Q8D67C)am$=W3A*C zr^@uWl^SY={&eUGSt2)ehR^yQy?~M{!Ue&Wq@;-rA2F58nGOg#;f|nvC!=w2Skza5 zJz8KoLd)cjr&yV&u-LAncFAQoTH0jS4;D1-wETzUJwgjfoQ>V_?tfDlN;2`T4LcoxO@0!j{6%;D?VCEGc-3S!mg)j4mZ~0i*K^ z7{jt^OjIPw@%%u?y>3vf!rgbtITo@x)pD=&;rRE-5y5ClE4|qRFts4KSt(mXvG+)aBLT{C3 z1>IXmRQ2IdTaUHr(iSMh9xDebPiH`YYq#nIm|VKaIhk_H&AIH)JX<$&tqQZMHt%X^ z_SF?eBA-qw?aQrQ))pj9r_G#Jfh@&m!byp8XfZRmFd>2swBmdpoi|^XBoXLr%UfZ_ zWcPTt!m1I;paUTNyQ_O9=Y5Ugvcq~Zxs?3!#by@7fSGi%jRk=0yN?|{eYtBPV3^P8vT8QKFyoA&I%yWa}M z$*kk+7xr)$#zuB(Lt2_u#tK0j5%mi+^U=qNuWL|s_g$;ouLtYbhkHfYzs1)aZR@QW z;*P;(WwbwxSDl_r6y2E27;!Stk$9xC>s%=XPpmBv=NN%MQ zQ3sNMuqYRXT~|x;}2lX{okX2caVhaXBNmzwWr7 zL8ZfFGb7L7LJwLR4#AtS?P!k{73kC3js5e5qx;ROo0kEvN^F+D;odr?7TL$`t4Y;3 zI|na10bVsRjqaG!mwo%j?P0k7*(82EIRZ!i-g)^;x5aSpc5H-9v{x}Rf_V+D&poua zM<=|dcWkT`O+WqKWA9}ey}Pq~;u{#u65Kop@|f4Ii{}0cxWsKY^P(lAXqE!W|C4Y zq_GijSuKmHagpbzb447~S&OM5=%eo&8C@3JvlFsKHZI4%}1115+$GOH?QAv`c;ZwzgowuXwcLG!-CLToukR_(Z_Kh z&ZQQwA`=q~Q^t}9ebZ=Qg*^i!u|;JuzQiRTMtppfh3z4T*8Iu8rG{yA;QrQk=Kp4m zbL@oiDgdp#_>A-_~SiB zOD29u;h+i?akvnJ=o{JWbN{--oV>~nM93xVzRUin(oI;j(CRy(Rpy-_rvE8mgbTHO z7xVn`W_~M6L14f?4>=J|r*SZf-Xrd(fh^^91niWQk^wz{8?1GiFcw8b4-upDonLjp zAp+)@)oP6?PMYpsj51%}_pM%2#a+f1^k`^{4d)_Kl;ZQ)W;>6E^|LfW;oluF+U%IU z4V`9WOP?oqoywd2d6wHGwR%Ix&&VZU9nVqZ5=hr2Z}9u4F>~)qd);C}14!Q~UF55R zT(nbrRiWtRn%5*-#pr{HcWHNs%YzwNsFz?Yb}TUDOY7(i+0n+?`j*ZvNG6PSs7DK)9uu{`27rH?H%2umKg8x1(vZT@6cH`iLv)~ z#j7bSNpP2k)+3kg)HQ6nhWzVNm6qa(G_t9FXsU_PoCSJ`OG2XhF5?^`X%=&57FSMH z-h%Tjw6?@SgnBC7oq8*{8VhV9Md?&DbD0}niHULs5eLFq^yffc{(jSM%C(ky;4DGs z{M8a;s`Q?WXyR*^qc@v93_DMz1$_pk=-`ipCRM{}LxsRB(7cXVq<#sAV{m)|8owW! zdDBe{il=^>B_~S@jzUKNx~zEktIw}uY#L!x=t)AiV^wpRh)SxF2A6eTOE4J{p1g`i zX3AGmj!{xB8d!@EsOvsO{);yIx%z}UP<}sB#aJb?du0toADWYDtw%FMspESoMK>*b ztrD7rgFlImi7ZY(tLaIbH|tGrs8G0f7TQ2CMWz&8mrOf888XtQ#V-pFPKx}ttKKe9 zP^R(_O#2Fjg7%dk#u z{lt^y6RW#7#Hv>@#M*xy)0gska1*@kCXUuG{WI{UQS!O1LHTz}Drnn*+=yW5`MRTQ zblt>K%3Nc4-e9K9@gAX6j@LqKTgwZ<-FqQ74N(eB^Y^jr?~Mnfe#G?fP12u-B>61A z+w3lYErzrIym#5GJND)L9bGu9Swi#NZm-Nqm*}f{l|j$S`dQ5IkQm0(VAUXka*qA} zu!ri?oqAwnTwpm=*U?x6gycUzE;_GgERz^CBn*4V3#gcaEj*^9tXBz;cy2!M# z{P;6_&jx`-csS5K-BlYm8kjOwOoy|#|3>?0nas*fPF%j$C*4tHKJ@FSfvsndA4_6S z#(Y-RQcfiHh_>ak{aqf0Fwe3wOZ0NM*Z1Y{^ zjm+$FmW?lC_%(^ZLa7;)H2M8+^On$!alwUyxCU~Gq$TRG`YODn=`8x1h|LrV$WRn) zIm*XmiT+OP=v3f82JRC=q5l~1TdeC__}07djoBW?^gDcP5{YgSvHNq};6h7s_@Cte z?B>6B@#pmaaEJ7W3?)r;X=^8Lwlay_1H@hlxm6Qkw}(7pCr4d0%0t(jq5NjDoEDex zxQnav>9ocz;&anEZn3NMv{T{>mgDN+Zqif7w1yyv;}>|n1i3@!llcr9|bz^}t zQ!Lvu*-I#ID^YJZm`;P$$K%k2O5Ymvinefxh499LoW^q_qz{OdcsokAy2xIbW(`CO zK3cOfx8igI3yxcM#;c3Q(6Lmr$L?KcG!L!oIT@L7Bnq06ZlEbLqNZ$c5@{d@@X@eO z{4efWe~LJNOS?O4Jn*3y{}OuKxa@Uva^Q1Oy6knfsz@KID7fp)={O4*~c@R&sEI(=acbUaItaE<+!qITT=wNi&Mv~sto$8 zVFraul_7kpN7VByGR}trHYq`+qo}LsHR(Z1D@JiBNrt6Goe=fpU?KJSe22}4$v{e{ zZJF&9DvFr~CwY~dq82{wg1H^*t(r*#^6=BPeR%5JGN{L-yFrTcispN8!N?iE6BX{6 zq$0X(EgUmU^zp{WVADh=EkUEIK(By?db##p!3adLpZpt8HHnYSu?RP;eu|~$lHW5DV7jVm^W+C{VqaGfy z0zdtSQ!0e^Q&MgAPV$$0Z6W)8%*&%9+XltDR5)xX{k$I{9;>Zt216%FQrO~?Nkoa* zr)l&8y8OHVGX&<9=+1}KkU4ny@zkv)snuQQ;W-!vO}hbqyAZeO_%s_LSWf6)zzLie zBixx#s-Nf7<&Y#EFF+cr8=V*W-S~RkAm{6S68X+DxM3CQ ze1}waner?n#@QQy2}E!$nwE_a7vFKW${0HWU&RFX_L24bVPpJsGBQ7|nwb0A{bNRK z>*$BGnXCH5kSZCKG@FPx3c>03*h;iRXUn+3HwHn`wFWGnTg(QumqLl3r>`A})R zUa(By18*t>h{bNy$EB7_jz&U>y#w>{u%VusABGM+GbSQk^sH}`5J=!+k z`Uzz%oE)sMEiaqrXpYNL37zpoT!aa$6>}tIHF@@qY4421?pT`=@5$v~Z_(w`{}J|8 z>zLr}bSz~1a`_IjI=@*Epi5#5x4d!*zVKTSA+-`P{qp7g@c_C!|4XMtnQ2;_2JkSp(U9%kA}Ex=EwMc% zaD0)eaw7(1h|wD{oyaG2ELbJD`=pHaQFQ+iVFGeuiH$X)Ii9^u@dhR;g|JgBikHvY zV&s$Be;@6!)uoqwT2cp#kB~3MSm3Q>sgXX0WC6!i4Z$`se)z}TQZsX*-h03R?}f3` zJ&P;XDsSO=dYlP96{7*{KgO?%Z#Lu=sTVRgDw)ydZtI`tr48vG`S(jC3p*dKI_G$M zCG9`KQ_pM`E=F+RhUhh@HkfsHRV(=~3K3~#K@vVLwZTrkC?tD8Rbo3Bq#wp5L!BL) z_Yjx{kNY@c7m!1A$Eq8Fc^_I^G55kn79dv=s2F!0H>M>(>K(0&6p^{59jTD`M{n*9 z3F3GWpVlipM68S8o6neIx^G{4_Z51PmIlO?Z5z8EmZr``G#a=a9(fwqK8A{|h~O>M zM!Cb#a1Owa8he13c{?rS39K;?mSd>>g4B=mMi ztkW68fP^UiN`d@hCw}1+T-+cK=RX+>fq#fdy5s*73gj2{@n;G|@Lweaa7aR&O@C7* z9CD^MuBK2+W5_Sm4yZLXgzxD;d zA&+c0liv;bt98}>CcXsxZi&Ck$Y<&QfRg^2g(NchZ^-D+E%~p#{By5%#zQ(baR%t( z{bHZg@P74uHN4*hlFKhr>CYMbVv+u+CnOQ&WN+ePZ0ZDfB5x@rAq_xsPb^4m$;lJ~ zwY0aBhCodLPo#yoIk^P5IJrSwAP^rf&p#8`BduPTIvZP<+Ctd=Fx0Sw+8`}tAV%uO z_DJqZ5n^cvQ2(6**`bk!8cq-g2U8P(8N|lf^v{L*C&%^ggH;Lwh1l4e|Dv|ck&MPCud~I032NGpg*D%?M;w?*DGgJC40Nyj2H6N{E)ZyE=Y7s9eGsPnEqzJ{*7L_ zJDHl{aRRtNc%1)Q0DK@24+vle_(S961@Rzj>DL0V`#rIwC;#8e!pqAg`1i8# z^73#Z`_$iTL4wF0^EZv3_fLMIP7q5QQzyLV&wo{`hbglD032%e_DGuUSJSB>`8Yc> hdjQvO&<%jBZD%ON3HrOPd3gmuym&z13uPI+{|D1L4$c4o literal 0 HcmV?d00001 diff --git a/firmware/Config/LUFAConfig.h b/firmware/Config/LUFAConfig.h new file mode 100644 index 0000000..0ec4635 --- /dev/null +++ b/firmware/Config/LUFAConfig.h @@ -0,0 +1,126 @@ +/* + LUFA Library + Copyright (C) Dean Camera, 2017. + + dean [at] fourwalledcubicle [dot] com + www.lufa-lib.org +*/ + +/* + Copyright 2017 Dean Camera (dean [at] fourwalledcubicle [dot] com) + + Permission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose is hereby granted + without fee, provided that the above copyright notice appear in + all copies and that both that the copyright notice and this + permission notice and warranty disclaimer appear in supporting + documentation, and that the name of the author not be used in + advertising or publicity pertaining to distribution of the + software without specific, written prior permission. + + The author disclaims all warranties with regard to this + software, including all implied warranties of merchantability + and fitness. In no event shall the author be liable for any + special, indirect or consequential damages or any damages + whatsoever resulting from loss of use, data or profits, whether + in an action of contract, negligence or other tortious action, + arising out of or in connection with the use or performance of + this software. +*/ + +/** \file + * \brief LUFA Library Configuration Header File + * + * This header file is used to configure LUFA's compile time options, + * as an alternative to the compile time constants supplied through + * a makefile. + * + * For information on what each token does, refer to the LUFA + * manual section "Summary of Compile Tokens". + */ + +#ifndef _LUFA_CONFIG_H_ +#define _LUFA_CONFIG_H_ + + #if (ARCH == ARCH_AVR8) + + /* Non-USB Related Configuration Tokens: */ +// #define DISABLE_TERMINAL_CODES + + /* USB Class Driver Related Tokens: */ +// #define HID_HOST_BOOT_PROTOCOL_ONLY +// #define HID_STATETABLE_STACK_DEPTH {Insert Value Here} +// #define HID_USAGE_STACK_DEPTH {Insert Value Here} +// #define HID_MAX_COLLECTIONS {Insert Value Here} +// #define HID_MAX_REPORTITEMS {Insert Value Here} +// #define HID_MAX_REPORT_IDS {Insert Value Here} +// #define NO_CLASS_DRIVER_AUTOFLUSH + + /* General USB Driver Related Tokens: */ +// #define ORDERED_EP_CONFIG + #define USE_STATIC_OPTIONS (USB_DEVICE_OPT_FULLSPEED | USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL) + #define USB_DEVICE_ONLY +// #define USB_HOST_ONLY +// #define USB_STREAM_TIMEOUT_MS {Insert Value Here} +// #define NO_LIMITED_CONTROLLER_CONNECT +// #define NO_SOF_EVENTS + + /* USB Device Mode Driver Related Tokens: */ +// #define USE_RAM_DESCRIPTORS + #define USE_FLASH_DESCRIPTORS +// #define USE_EEPROM_DESCRIPTORS +// #define NO_INTERNAL_SERIAL + #define FIXED_CONTROL_ENDPOINT_SIZE 8 +// #define DEVICE_STATE_AS_GPIOR {Insert Value Here} + #define FIXED_NUM_CONFIGURATIONS 1 +// #define CONTROL_ONLY_DEVICE + #define INTERRUPT_CONTROL_ENDPOINT +// #define NO_DEVICE_REMOTE_WAKEUP +// #define NO_DEVICE_SELF_POWER + + /* USB Host Mode Driver Related Tokens: */ +// #define HOST_STATE_AS_GPIOR {Insert Value Here} +// #define USB_HOST_TIMEOUT_MS {Insert Value Here} +// #define HOST_DEVICE_SETTLE_DELAY_MS {Insert Value Here} +// #define NO_AUTO_VBUS_MANAGEMENT +// #define INVERTED_VBUS_ENABLE_LINE + + #elif (ARCH == ARCH_XMEGA) + + /* Non-USB Related Configuration Tokens: */ +// #define DISABLE_TERMINAL_CODES + + /* USB Class Driver Related Tokens: */ +// #define HID_HOST_BOOT_PROTOCOL_ONLY +// #define HID_STATETABLE_STACK_DEPTH {Insert Value Here} +// #define HID_USAGE_STACK_DEPTH {Insert Value Here} +// #define HID_MAX_COLLECTIONS {Insert Value Here} +// #define HID_MAX_REPORTITEMS {Insert Value Here} +// #define HID_MAX_REPORT_IDS {Insert Value Here} +// #define NO_CLASS_DRIVER_AUTOFLUSH + + /* General USB Driver Related Tokens: */ + #define USE_STATIC_OPTIONS (USB_DEVICE_OPT_FULLSPEED | USB_OPT_RC32MCLKSRC | USB_OPT_BUSEVENT_PRIHIGH) +// #define USB_STREAM_TIMEOUT_MS {Insert Value Here} +// #define NO_LIMITED_CONTROLLER_CONNECT +// #define NO_SOF_EVENTS + + /* USB Device Mode Driver Related Tokens: */ +// #define USE_RAM_DESCRIPTORS + #define USE_FLASH_DESCRIPTORS +// #define USE_EEPROM_DESCRIPTORS +// #define NO_INTERNAL_SERIAL + #define FIXED_CONTROL_ENDPOINT_SIZE 8 +// #define DEVICE_STATE_AS_GPIOR {Insert Value Here} + #define FIXED_NUM_CONFIGURATIONS 1 +// #define CONTROL_ONLY_DEVICE + #define MAX_ENDPOINT_INDEX 4 +// #define NO_DEVICE_REMOTE_WAKEUP +// #define NO_DEVICE_SELF_POWER + + #else + + #error Unsupported architecture for this LUFA configuration file. + + #endif +#endif diff --git a/firmware/Descriptors.c b/firmware/Descriptors.c new file mode 100644 index 0000000..5ec042c --- /dev/null +++ b/firmware/Descriptors.c @@ -0,0 +1,245 @@ +/* + LUFA Library + Copyright (C) Dean Camera, 2017. + + dean [at] fourwalledcubicle [dot] com + www.lufa-lib.org +*/ + +/* + Copyright 2017 Dean Camera (dean [at] fourwalledcubicle [dot] com) + + Permission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose is hereby granted + without fee, provided that the above copyright notice appear in + all copies and that both that the copyright notice and this + permission notice and warranty disclaimer appear in supporting + documentation, and that the name of the author not be used in + advertising or publicity pertaining to distribution of the + software without specific, written prior permission. + + The author disclaims all warranties with regard to this + software, including all implied warranties of merchantability + and fitness. In no event shall the author be liable for any + special, indirect or consequential damages or any damages + whatsoever resulting from loss of use, data or profits, whether + in an action of contract, negligence or other tortious action, + arising out of or in connection with the use or performance of + this software. +*/ + +/** \file + * + * USB Device Descriptors, for library use when in USB device mode. Descriptors are special + * computer-readable structures which the host requests upon device enumeration, to determine + * the device's capabilities and functions. + */ + +#include "Descriptors.h" + + +/** Device descriptor structure. This descriptor, located in FLASH memory, describes the overall + * device characteristics, including the supported USB version, control endpoint size and the + * number of device configurations. The descriptor is read out by the USB host when the enumeration + * process begins. + */ +const USB_Descriptor_Device_t PROGMEM DeviceDescriptor = +{ + .Header = {.Size = sizeof(USB_Descriptor_Device_t), .Type = DTYPE_Device}, + + .USBSpecification = VERSION_BCD(1,1,0), + .Class = CDC_CSCP_CDCClass, + .SubClass = CDC_CSCP_NoSpecificSubclass, + .Protocol = CDC_CSCP_NoSpecificProtocol, + + .Endpoint0Size = FIXED_CONTROL_ENDPOINT_SIZE, + + .VendorID = 0x03EB, + .ProductID = 0x2044, + .ReleaseNumber = VERSION_BCD(0,0,1), + + .ManufacturerStrIndex = STRING_ID_Manufacturer, + .ProductStrIndex = STRING_ID_Product, + .SerialNumStrIndex = USE_INTERNAL_SERIAL, + + .NumberOfConfigurations = FIXED_NUM_CONFIGURATIONS +}; + +/** Configuration descriptor structure. This descriptor, located in FLASH memory, describes the usage + * of the device in one of its supported configurations, including information about any device interfaces + * and endpoints. The descriptor is read out by the USB host during the enumeration process when selecting + * a configuration so that the host may correctly communicate with the USB device. + */ +const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = +{ + .Config = + { + .Header = {.Size = sizeof(USB_Descriptor_Configuration_Header_t), .Type = DTYPE_Configuration}, + + .TotalConfigurationSize = sizeof(USB_Descriptor_Configuration_t), + .TotalInterfaces = 2, + + .ConfigurationNumber = 1, + .ConfigurationStrIndex = NO_DESCRIPTOR, + + .ConfigAttributes = (USB_CONFIG_ATTR_RESERVED | USB_CONFIG_ATTR_SELFPOWERED), + + .MaxPowerConsumption = USB_CONFIG_POWER_MA(100) + }, + + .CDC_CCI_Interface = + { + .Header = {.Size = sizeof(USB_Descriptor_Interface_t), .Type = DTYPE_Interface}, + + .InterfaceNumber = INTERFACE_ID_CDC_CCI, + .AlternateSetting = 0, + + .TotalEndpoints = 1, + + .Class = CDC_CSCP_CDCClass, + .SubClass = CDC_CSCP_ACMSubclass, + .Protocol = CDC_CSCP_ATCommandProtocol, + + .InterfaceStrIndex = NO_DESCRIPTOR + }, + + .CDC_Functional_Header = + { + .Header = {.Size = sizeof(USB_CDC_Descriptor_FunctionalHeader_t), .Type = DTYPE_CSInterface}, + .Subtype = CDC_DSUBTYPE_CSInterface_Header, + + .CDCSpecification = VERSION_BCD(1,1,0), + }, + + .CDC_Functional_ACM = + { + .Header = {.Size = sizeof(USB_CDC_Descriptor_FunctionalACM_t), .Type = DTYPE_CSInterface}, + .Subtype = CDC_DSUBTYPE_CSInterface_ACM, + + .Capabilities = 0x06, + }, + + .CDC_Functional_Union = + { + .Header = {.Size = sizeof(USB_CDC_Descriptor_FunctionalUnion_t), .Type = DTYPE_CSInterface}, + .Subtype = CDC_DSUBTYPE_CSInterface_Union, + + .MasterInterfaceNumber = INTERFACE_ID_CDC_CCI, + .SlaveInterfaceNumber = INTERFACE_ID_CDC_DCI, + }, + + .CDC_NotificationEndpoint = + { + .Header = {.Size = sizeof(USB_Descriptor_Endpoint_t), .Type = DTYPE_Endpoint}, + + .EndpointAddress = CDC_NOTIFICATION_EPADDR, + .Attributes = (EP_TYPE_INTERRUPT | ENDPOINT_ATTR_NO_SYNC | ENDPOINT_USAGE_DATA), + .EndpointSize = CDC_NOTIFICATION_EPSIZE, + .PollingIntervalMS = 0xFF + }, + + .CDC_DCI_Interface = + { + .Header = {.Size = sizeof(USB_Descriptor_Interface_t), .Type = DTYPE_Interface}, + + .InterfaceNumber = INTERFACE_ID_CDC_DCI, + .AlternateSetting = 0, + + .TotalEndpoints = 2, + + .Class = CDC_CSCP_CDCDataClass, + .SubClass = CDC_CSCP_NoDataSubclass, + .Protocol = CDC_CSCP_NoDataProtocol, + + .InterfaceStrIndex = NO_DESCRIPTOR + }, + + .CDC_DataOutEndpoint = + { + .Header = {.Size = sizeof(USB_Descriptor_Endpoint_t), .Type = DTYPE_Endpoint}, + + .EndpointAddress = CDC_RX_EPADDR, + .Attributes = (EP_TYPE_BULK | ENDPOINT_ATTR_NO_SYNC | ENDPOINT_USAGE_DATA), + .EndpointSize = CDC_TXRX_EPSIZE, + .PollingIntervalMS = 0x05 + }, + + .CDC_DataInEndpoint = + { + .Header = {.Size = sizeof(USB_Descriptor_Endpoint_t), .Type = DTYPE_Endpoint}, + + .EndpointAddress = CDC_TX_EPADDR, + .Attributes = (EP_TYPE_BULK | ENDPOINT_ATTR_NO_SYNC | ENDPOINT_USAGE_DATA), + .EndpointSize = CDC_TXRX_EPSIZE, + .PollingIntervalMS = 0x05 + } +}; + +/** Language descriptor structure. This descriptor, located in FLASH memory, is returned when the host requests + * the string descriptor with index 0 (the first index). It is actually an array of 16-bit integers, which indicate + * via the language ID table available at USB.org what languages the device supports for its string descriptors. + */ +const USB_Descriptor_String_t PROGMEM LanguageString = USB_STRING_DESCRIPTOR_ARRAY(LANGUAGE_ID_ENG); + +/** Manufacturer descriptor string. This is a Unicode string containing the manufacturer's details in human readable + * form, and is read out upon request by the host when the appropriate string ID is requested, listed in the Device + * Descriptor. + */ +const USB_Descriptor_String_t PROGMEM ManufacturerString = USB_STRING_DESCRIPTOR(L"Dean Camera"); + +/** Product descriptor string. This is a Unicode string containing the product's details in human readable form, + * and is read out upon request by the host when the appropriate string ID is requested, listed in the Device + * Descriptor. + */ +const USB_Descriptor_String_t PROGMEM ProductString = USB_STRING_DESCRIPTOR(L"LUFA CDC Demo"); + +/** This function is called by the library when in device mode, and must be overridden (see library "USB Descriptors" + * documentation) by the application code so that the address and size of a requested descriptor can be given + * to the USB library. When the device receives a Get Descriptor request on the control endpoint, this function + * is called so that the descriptor details can be passed back and the appropriate descriptor sent back to the + * USB host. + */ +uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue, + const uint16_t wIndex, + const void** const DescriptorAddress) +{ + const uint8_t DescriptorType = (wValue >> 8); + const uint8_t DescriptorNumber = (wValue & 0xFF); + + const void* Address = NULL; + uint16_t Size = NO_DESCRIPTOR; + + switch (DescriptorType) + { + case DTYPE_Device: + Address = &DeviceDescriptor; + Size = sizeof(USB_Descriptor_Device_t); + break; + case DTYPE_Configuration: + Address = &ConfigurationDescriptor; + Size = sizeof(USB_Descriptor_Configuration_t); + break; + case DTYPE_String: + switch (DescriptorNumber) + { + case STRING_ID_Language: + Address = &LanguageString; + Size = pgm_read_byte(&LanguageString.Header.Size); + break; + case STRING_ID_Manufacturer: + Address = &ManufacturerString; + Size = pgm_read_byte(&ManufacturerString.Header.Size); + break; + case STRING_ID_Product: + Address = &ProductString; + Size = pgm_read_byte(&ProductString.Header.Size); + break; + } + + break; + } + + *DescriptorAddress = Address; + return Size; +} + diff --git a/firmware/Descriptors.h b/firmware/Descriptors.h new file mode 100644 index 0000000..5b4bf2a --- /dev/null +++ b/firmware/Descriptors.h @@ -0,0 +1,110 @@ +/* + LUFA Library + Copyright (C) Dean Camera, 2017. + + dean [at] fourwalledcubicle [dot] com + www.lufa-lib.org +*/ + +/* + Copyright 2017 Dean Camera (dean [at] fourwalledcubicle [dot] com) + + Permission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose is hereby granted + without fee, provided that the above copyright notice appear in + all copies and that both that the copyright notice and this + permission notice and warranty disclaimer appear in supporting + documentation, and that the name of the author not be used in + advertising or publicity pertaining to distribution of the + software without specific, written prior permission. + + The author disclaims all warranties with regard to this + software, including all implied warranties of merchantability + and fitness. In no event shall the author be liable for any + special, indirect or consequential damages or any damages + whatsoever resulting from loss of use, data or profits, whether + in an action of contract, negligence or other tortious action, + arising out of or in connection with the use or performance of + this software. +*/ + +/** \file + * + * Header file for Descriptors.c. + */ + +#ifndef _DESCRIPTORS_H_ +#define _DESCRIPTORS_H_ + + /* Includes: */ + #include + + #include + + /* Macros: */ + /** Endpoint address of the CDC device-to-host notification IN endpoint. */ + #define CDC_NOTIFICATION_EPADDR (ENDPOINT_DIR_IN | 2) + + /** Endpoint address of the CDC device-to-host data IN endpoint. */ + #define CDC_TX_EPADDR (ENDPOINT_DIR_IN | 3) + + /** Endpoint address of the CDC host-to-device data OUT endpoint. */ + #define CDC_RX_EPADDR (ENDPOINT_DIR_OUT | 4) + + /** Size in bytes of the CDC device-to-host notification IN endpoint. */ + #define CDC_NOTIFICATION_EPSIZE 8 + + /** Size in bytes of the CDC data IN and OUT endpoints. */ + #define CDC_TXRX_EPSIZE 16 + + /* Type Defines: */ + /** Type define for the device configuration descriptor structure. This must be defined in the + * application code, as the configuration descriptor contains several sub-descriptors which + * vary between devices, and which describe the device's usage to the host. + */ + typedef struct + { + USB_Descriptor_Configuration_Header_t Config; + + // CDC Control Interface + USB_Descriptor_Interface_t CDC_CCI_Interface; + USB_CDC_Descriptor_FunctionalHeader_t CDC_Functional_Header; + USB_CDC_Descriptor_FunctionalACM_t CDC_Functional_ACM; + USB_CDC_Descriptor_FunctionalUnion_t CDC_Functional_Union; + USB_Descriptor_Endpoint_t CDC_NotificationEndpoint; + + // CDC Data Interface + USB_Descriptor_Interface_t CDC_DCI_Interface; + USB_Descriptor_Endpoint_t CDC_DataOutEndpoint; + USB_Descriptor_Endpoint_t CDC_DataInEndpoint; + } USB_Descriptor_Configuration_t; + + /** Enum for the device interface descriptor IDs within the device. Each interface descriptor + * should have a unique ID index associated with it, which can be used to refer to the + * interface from other descriptors. + */ + enum InterfaceDescriptors_t + { + INTERFACE_ID_CDC_CCI = 0, /**< CDC CCI interface descriptor ID */ + INTERFACE_ID_CDC_DCI = 1, /**< CDC DCI interface descriptor ID */ + }; + + /** Enum for the device string descriptor IDs within the device. Each string descriptor should + * have a unique ID index associated with it, which can be used to refer to the string from + * other descriptors. + */ + enum StringDescriptors_t + { + STRING_ID_Language = 0, /**< Supported Languages string descriptor ID (must be zero) */ + STRING_ID_Manufacturer = 1, /**< Manufacturer string ID */ + STRING_ID_Product = 2, /**< Product string ID */ + }; + + /* Function Prototypes: */ + uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue, + const uint16_t wIndex, + const void** const DescriptorAddress) + ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(3); + +#endif + diff --git a/firmware/LUFA VirtualSerial.inf b/firmware/LUFA VirtualSerial.inf new file mode 100644 index 0000000..21d2d12 --- /dev/null +++ b/firmware/LUFA VirtualSerial.inf @@ -0,0 +1,66 @@ +;************************************************************ +; Windows USB CDC ACM Setup File +; Copyright (c) 2000 Microsoft Corporation +;************************************************************ + +[DefaultInstall] +CopyINF="LUFA VirtualSerial.inf" + +[Version] +Signature="$Windows NT$" +Class=Ports +ClassGuid={4D36E978-E325-11CE-BFC1-08002BE10318} +Provider=%MFGNAME% +DriverVer=7/1/2012,10.0.0.0 + +[Manufacturer] +%MFGNAME%=DeviceList, NTx86, NTamd64, NTia64 + +[SourceDisksNames] + +[SourceDisksFiles] + +[DestinationDirs] +DefaultDestDir=12 + +[DriverInstall] +Include=mdmcpq.inf +CopyFiles=FakeModemCopyFileSection +AddReg=DriverInstall.AddReg + +[DriverInstall.Services] +Include=mdmcpq.inf +AddService=usbser, 0x00000002, LowerFilter_Service_Inst + +[DriverInstall.AddReg] +HKR,,EnumPropPages32,,"msports.dll,SerialPortPropPageProvider" + +;------------------------------------------------------------------------------ +; Vendor and Product ID Definitions +;------------------------------------------------------------------------------ +; When developing your USB device, the VID and PID used in the PC side +; application program and the firmware on the microcontroller must match. +; Modify the below line to use your VID and PID. Use the format as shown below. +; Note: One INF file can be used for multiple devices with different VID and PIDs. +; For each supported device, append ",USB\VID_xxxx&PID_yyyy" to the end of the line. +;------------------------------------------------------------------------------ +[DeviceList] +%DESCRIPTION%=DriverInstall, USB\VID_03EB&PID_2044 + +[DeviceList.NTx86] +%DESCRIPTION%=DriverInstall, USB\VID_03EB&PID_2044 + +[DeviceList.NTamd64] +%DESCRIPTION%=DriverInstall, USB\VID_03EB&PID_2044 + +[DeviceList.NTia64] +%DESCRIPTION%=DriverInstall, USB\VID_03EB&PID_2044 + +;------------------------------------------------------------------------------ +; String Definitions +;------------------------------------------------------------------------------ +;Modify these strings to customize your device +;------------------------------------------------------------------------------ +[Strings] +MFGNAME="http://www.lufa-lib.org" +DESCRIPTION="LUFA CDC-ACM Virtual Serial Port" \ No newline at end of file diff --git a/firmware/main.c b/firmware/main.c new file mode 100644 index 0000000..6b58f5e --- /dev/null +++ b/firmware/main.c @@ -0,0 +1,239 @@ +/* + LUFA Library + Copyright (C) Dean Camera, 2017. + + dean [at] fourwalledcubicle [dot] com + www.lufa-lib.org +*/ + +/* + Copyright 2017 Dean Camera (dean [at] fourwalledcubicle [dot] com) + + Permission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose is hereby granted + without fee, provided that the above copyright notice appear in + all copies and that both that the copyright notice and this + permission notice and warranty disclaimer appear in supporting + documentation, and that the name of the author not be used in + advertising or publicity pertaining to distribution of the + software without specific, written prior permission. + + The author disclaims all warranties with regard to this + software, including all implied warranties of merchantability + and fitness. In no event shall the author be liable for any + special, indirect or consequential damages or any damages + whatsoever resulting from loss of use, data or profits, whether + in an action of contract, negligence or other tortious action, + arising out of or in connection with the use or performance of + this software. +*/ + +/** \file + * + * Main source file for the FabScope firmware, derived from the LUFA + * VirtualSerial demo. + */ + +#include "main.h" + +#define BUTTONPORT PORTC +#define BUTTONPINOFFSET 3 +#define BUTTONPINCTRL PORTC_PIN3CTRL + +/** LUFA CDC Class driver interface configuration and state information. This structure is + * passed to all CDC Class driver functions, so that multiple instances of the same class + * within a device can be differentiated from one another. + */ +USB_ClassInfo_CDC_Device_t VirtualSerial_CDC_Interface = + { + .Config = + { + .ControlInterfaceNumber = INTERFACE_ID_CDC_CCI, + .DataINEndpoint = + { + .Address = CDC_TX_EPADDR, + .Size = CDC_TXRX_EPSIZE, + .Banks = 1, + }, + .DataOUTEndpoint = + { + .Address = CDC_RX_EPADDR, + .Size = CDC_TXRX_EPSIZE, + .Banks = 1, + }, + .NotificationEndpoint = + { + .Address = CDC_NOTIFICATION_EPADDR, + .Size = CDC_NOTIFICATION_EPSIZE, + .Banks = 1, + }, + }, + }; + +/** Standard file stream for the CDC interface when set up, so that the virtual CDC COM port can be + * used like any regular character stream in the C APIs. + */ +static FILE USBSerialStream; + + +/* button latch state variable */ +static bool buttonState; +static uint16_t buttonDebounce; + +#define BUTTONDEBOUNCETHRESH 10 + + +/** Main program entry point. This routine contains the overall program flow, including initial + * setup of all components and the main program loop. + */ +int main(void) +{ + buttonState = false; + buttonDebounce = 0; + + SetupHardware(); + + /* Create a regular character stream for the interface so that it can be used with the stdio.h functions */ + CDC_Device_CreateStream(&VirtualSerial_CDC_Interface, &USBSerialStream); + + GlobalInterruptEnable(); + + for (;;) + { + + // consume input bytes to prevent blocking (don't do anything with them yet) + CDC_Device_ReceiveByte(&VirtualSerial_CDC_Interface); + + // take an ADC reading and emit it over serial + int16_t adcReading = ADC_Read(); + fprintf(&USBSerialStream, "%d\r\n", adcReading); + + CDC_Device_USBTask(&VirtualSerial_CDC_Interface); + USB_USBTask(); + } +} + +uint8_t ReadSignatureByte(uint16_t Address) +{ + NVM_CMD = NVM_CMD_READ_CALIB_ROW_gc; + uint8_t Result; + Result = pgm_read_byte((uint8_t *)Address); + NVM_CMD = NVM_CMD_NO_OPERATION_gc; + return Result; +} + +void ADC_Init() +{ + // Based on advice from http://barefootelectronics.com/xMegaADC.aspx + + // Configure PA0 as input + PORTA.DIR &= ~(1 << 0); + // Configure PA0 as non-inverting totem pole with disabled digital input buf + PORTA_PIN0CTRL = 7; + + ADCA.CTRLA = ADC_ENABLE_bm; // enabled, no DMA, no started conversion, no flush + ADCA.CTRLB = (1<<4); // high impedance, no limit, signed, non-freerunning, 12-bit right + ADCA.REFCTRL = ADC_BANDGAP_bm; // Internal 1v ref + ADCA.EVCTRL = 0 ; // no events + ADCA.PRESCALER = ADC_PRESCALER_DIV4_gc ; + ADCA.CALL = ReadSignatureByte(0x20) ; //ADC Calibration Byte 0 + ADCA.CALH = ReadSignatureByte(0x21) ; //ADC Calibration Byte 1 + + _delay_us(400); // Wait at least 25 clocks + + ADCA.CH0.CTRL = ADC_CH_GAIN_1X_gc | 1; + ADCA.CH0.MUXCTRL = 0; // ADC0 + ADCA.CH0.INTCTRL = 0; // no interrupt +} + +int32_t ADC_Read(void) +{ + int32_t res = 0; + + // throw away 5 readings and average the next 128 (software denoising attempt) + + for(uint8_t i = 0; i < 5; i++) { + ADCA.CH0.CTRL |= ADC_CH_START_bm; // Start conversion + while (ADCA.INTFLAGS==0) ; // Wait for complete + ADCA.INTFLAGS = ADCA.INTFLAGS ; // writing 1 to INTFLAGS clears it + } + + for(uint8_t i = 0; i<128; i++) + { + ADCA.CH0.CTRL |= ADC_CH_START_bm; // Start conversion + while (ADCA.INTFLAGS==0) ; // Wait for complete + ADCA.INTFLAGS = ADCA.INTFLAGS ; // writing 1 to INTFLAGS clears it + res += ADCA.CH0RES; + } + return res >> 7; +} + +/** Configures the board hardware and chip peripherals for the demo's functionality. */ +void SetupHardware(void) +{ + /* Start the PLL to multiply the 2MHz RC oscillator to 32MHz and switch the CPU core to run from it */ + XMEGACLK_StartPLL(CLOCK_SRC_INT_RC2MHZ, 2000000, F_CPU); + XMEGACLK_SetCPUClockSource(CLOCK_SRC_PLL); + + /* Start the 32MHz internal RC oscillator and start the DFLL to increase it to 48MHz using the USB SOF as a reference */ + XMEGACLK_StartInternalOscillator(CLOCK_SRC_INT_RC32MHZ); + XMEGACLK_StartDFLL(CLOCK_SRC_INT_RC32MHZ, DFLL_REF_INT_USBSOF, F_USB); + + PMIC.CTRL = PMIC_LOLVLEN_bm | PMIC_MEDLVLEN_bm | PMIC_HILVLEN_bm; + + /* Hardware Initialization */ + USB_Init(); + ADC_Init(); + + /* turn on main LED */ + PORTC.DIR |= (1 << 5); + PORTC.OUT |= (1 << 5); + + /* set up button as input */ + BUTTONPORT.DIR &= ~(1 << BUTTONPINOFFSET); + PORTC_PIN3CTRL = (1 << 6) | PORT_OPC_PULLUP_gc | PORT_ISC_BOTHEDGES_gc; +} + +/** Event handler for the library USB Connection event. */ +void EVENT_USB_Device_Connect(void) +{ + //LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING); +} + +/** Event handler for the library USB Disconnection event. */ +void EVENT_USB_Device_Disconnect(void) +{ + //LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY); +} + +/** Event handler for the library USB Configuration Changed event. */ +void EVENT_USB_Device_ConfigurationChanged(void) +{ + bool ConfigSuccess = true; + + ConfigSuccess &= CDC_Device_ConfigureEndpoints(&VirtualSerial_CDC_Interface); + + //LEDs_SetAllLEDs(ConfigSuccess ? LEDMASK_USB_READY : LEDMASK_USB_ERROR); +} + +/** Event handler for the library USB Control Request reception event. */ +void EVENT_USB_Device_ControlRequest(void) +{ + CDC_Device_ProcessControlRequest(&VirtualSerial_CDC_Interface); +} + +/** CDC class driver callback function the processing of changes to the virtual + * control lines sent from the host.. + * + * \param[in] CDCInterfaceInfo Pointer to the CDC class interface configuration structure being referenced + */ +void EVENT_CDC_Device_ControLineStateChanged(USB_ClassInfo_CDC_Device_t *const CDCInterfaceInfo) +{ + /* You can get changes to the virtual CDC lines in this callback; a common + use-case is to use the Data Terminal Ready (DTR) flag to enable and + disable CDC communications in your application when set to avoid the + application blocking while waiting for a host to become ready and read + in the pending data from the USB endpoints. + */ + bool HostReady = (CDCInterfaceInfo->State.ControlLineStates.HostToDevice & CDC_CONTROL_LINE_OUT_DTR) != 0; +} diff --git a/firmware/main.h b/firmware/main.h new file mode 100644 index 0000000..99b0783 --- /dev/null +++ b/firmware/main.h @@ -0,0 +1,65 @@ +/* + LUFA Library + Copyright (C) Dean Camera, 2017. + + dean [at] fourwalledcubicle [dot] com + www.lufa-lib.org +*/ + +/* + Copyright 2017 Dean Camera (dean [at] fourwalledcubicle [dot] com) + + Permission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose is hereby granted + without fee, provided that the above copyright notice appear in + all copies and that both that the copyright notice and this + permission notice and warranty disclaimer appear in supporting + documentation, and that the name of the author not be used in + advertising or publicity pertaining to distribution of the + software without specific, written prior permission. + + The author disclaims all warranties with regard to this + software, including all implied warranties of merchantability + and fitness. In no event shall the author be liable for any + special, indirect or consequential damages or any damages + whatsoever resulting from loss of use, data or profits, whether + in an action of contract, negligence or other tortious action, + arising out of or in connection with the use or performance of + this software. +*/ + +/** \file + * + * Header file for main.c. + */ + +#ifndef _MAIN_H_ +#define _MAIN_H_ + + /* Includes: */ + #include + #include + #include + #include + #include + #include + + #include "Descriptors.h" + + #include + #include + + /* Function Prototypes: */ + uint8_t ReadSignatureByte(uint16_t); + + void ADC_Init(void); + int32_t ADC_Read(void); + + void SetupHardware(void); + + void EVENT_USB_Device_Connect(void); + void EVENT_USB_Device_Disconnect(void); + void EVENT_USB_Device_ConfigurationChanged(void); + void EVENT_USB_Device_ControlRequest(void); + +#endif diff --git a/firmware/makefile b/firmware/makefile new file mode 100644 index 0000000..01c39de --- /dev/null +++ b/firmware/makefile @@ -0,0 +1,51 @@ +# +# LUFA Library +# Copyright (C) Dean Camera, 2017. +# +# dean [at] fourwalledcubicle [dot] com +# www.lufa-lib.org +# +# -------------------------------------- +# LUFA Project Makefile. +# -------------------------------------- + +# Run "make help" for target help. + +MCU = atxmega16a4u +ARCH = XMEGA +BOARD = USBKEY +F_CPU = 32000000 +F_USB = 48000000 +OPTIMIZATION = s +TARGET = main +SRC = $(TARGET).c Descriptors.c $(LUFA_SRC_USB) $(LUFA_SRC_USBCLASS) +LUFA_PATH = /PATH/TO/LUFA +CC_FLAGS = -DUSE_LUFA_CONFIG_HEADER -IConfig/ +LD_FLAGS = + +# Default target +all: + +# Include LUFA-specific DMBS extension modules +DMBS_LUFA_PATH ?= $(LUFA_PATH)/Build/LUFA +include $(DMBS_LUFA_PATH)/lufa-sources.mk +include $(DMBS_LUFA_PATH)/lufa-gcc.mk + +# Include common DMBS build system modules +DMBS_PATH ?= $(LUFA_PATH)/Build/DMBS/DMBS +include $(DMBS_PATH)/core.mk +include $(DMBS_PATH)/cppcheck.mk +include $(DMBS_PATH)/doxygen.mk +include $(DMBS_PATH)/dfu.mk +include $(DMBS_PATH)/gcc.mk +include $(DMBS_PATH)/hid.mk +include $(DMBS_PATH)/avrdude.mk +include $(DMBS_PATH)/atprogram.mk + +program-dfu: $(TARGET).hex + sudo dfu-programmer atxmega16a4u erase + sudo dfu-programmer atxmega16a4u flash $(TARGET).hex + sudo dfu-programmer atxmega16a4u launch + +program-avrisp2: $(TARGET).hex + avrdude -p $(MCU) -c avrisp2 -U flash:w:$(TARGET).hex -- GitLab