commit 5f04d6e65ec2c2a6e76be850e465683dede1185f Author: Magnus Date: Fri Mar 26 19:42:58 2021 +0100 Initial version for testing diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..bb8a448 --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +.pio/* +.vscode/* +*.map +test/*.md \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..a4660c9 --- /dev/null +++ b/README.md @@ -0,0 +1 @@ +TODO: Write the documentation for this project \ No newline at end of file diff --git a/bin/firmware-debug.bin b/bin/firmware-debug.bin new file mode 100644 index 0000000..219497d Binary files /dev/null and b/bin/firmware-debug.bin differ diff --git a/bin/firmware.bin b/bin/firmware.bin new file mode 100644 index 0000000..0594b86 Binary files /dev/null and b/bin/firmware.bin differ diff --git a/bin/version.json b/bin/version.json new file mode 100644 index 0000000..b1052d2 --- /dev/null +++ b/bin/version.json @@ -0,0 +1 @@ +{ "project":"gravmon", "version":"0.2.0" } \ No newline at end of file diff --git a/data/about.htm b/data/about.htm new file mode 100644 index 0000000..b8bc86b --- /dev/null +++ b/data/about.htm @@ -0,0 +1,78 @@ + + + + + + + Beer Gravity Monitor + + + + + + + + + + + + + +
+
+
+

Beer Gravity Monitor

+ This is a piece of software for the iSpindle hardware and will work in a similar way. No part of this software is copied from the iSpindle project. +
+
+

MIT License

+ + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to deal + in the Software without restriction, including without limitation the rights + to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + copies of the Software, and to permit persons to whom the Software is + furnished to do so, subject to the following conditions: + + The copyright notice and this permission notice shall be included in all + copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + SOFTWARE. +
+ +
+
+ + + +
(C) Copyright 2021 Magnus Persson
+ + \ No newline at end of file diff --git a/data/about.min.htm b/data/about.min.htm new file mode 100644 index 0000000..6403562 --- /dev/null +++ b/data/about.min.htm @@ -0,0 +1 @@ +Beer Gravity Monitor

Beer Gravity Monitor

This is a piece of software for the iSpindle hardware and will work in a similar way. No part of this software is copied from the iSpindle project.

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

(C) Copyright 2021 Magnus Persson
\ No newline at end of file diff --git a/data/config.htm b/data/config.htm new file mode 100644 index 0000000..baf2606 --- /dev/null +++ b/data/config.htm @@ -0,0 +1,330 @@ + + + + + + + Beer Gravity Monitor + + + + + + + + + + + + +
+ +
+ + + + + +
+ +
+
+

+ +

+
+
+
+
+ +
+ +
+ +
+
+
+ Temperature Format: +
+
+ + +
+
+ + +
+
+
+
+
+ +
+
+
+ +
+ + + +
+ +
+
+ +
+
+
+ +
+
+

+ +

+
+
+
+
+ +
+ +
+ +
+
+
+ +
+ +
+
+
+ +
+ +
+
+
+
+ +
+
+
+
+
+
+ +
+
+

+ +

+
+
+
+
+ +
+ +
+ +
+
+ +
+
+
+ + +
+
+
+
+
+ +
+
+
+
+
+
+ +
+
+

+ +

+
+
+
+
+ +
+ +
+ +
+ +
+
+ +
+ +
+
+ +
+
+ +
+
+
+
+
+
+
+ +
+
+ + + + + +
(C) Copyright 2021 Magnus Persson
+ + \ No newline at end of file diff --git a/data/config.min.htm b/data/config.min.htm new file mode 100644 index 0000000..d996a67 --- /dev/null +++ b/data/config.min.htm @@ -0,0 +1 @@ +Beer Gravity Monitor

Temperature Format:


(C) Copyright 2021 Magnus Persson
\ No newline at end of file diff --git a/data/device.htm b/data/device.htm new file mode 100644 index 0000000..a5eb600 --- /dev/null +++ b/data/device.htm @@ -0,0 +1,138 @@ + + + + + + + + + + Beer Gravity Monitor + + + + + + + + + + + + + +
+ +
+ + + + + +
+
Current version:
+
Loading...
+
+ +
+
Host name:
+
Loading...
+
+
+
Device ID:
+
Loading...
+
+ + + +
+
+ + + + + +
(C) Copyright 2021 Magnus Persson
+ + \ No newline at end of file diff --git a/data/device.min.htm b/data/device.min.htm new file mode 100644 index 0000000..94220f7 --- /dev/null +++ b/data/device.min.htm @@ -0,0 +1,17 @@ +Beer Gravity Monitor

Current version:
Loading...
Host name:
Loading...
Device ID:
Loading...

(C) Copyright 2021 Magnus Persson
\ No newline at end of file diff --git a/data/index.htm b/data/index.htm new file mode 100644 index 0000000..bcd1cd3 --- /dev/null +++ b/data/index.htm @@ -0,0 +1,153 @@ + + + + + + + Beer Gravity Monitor + + + + + + + + + + + + + +
+ +
+ + + + + + + +
+
Gravity:
+
Loading...
+
+
+
Temperature:
+
Loading...
+
+
+
Angle/Tilt:
+
Loading...
+
+
+
Battery:
+
Loading...
+
+ +
+
+ + +
+
+ +
+
+ + + + + +
(C) Copyright 2021 Magnus Persson
+ + \ No newline at end of file diff --git a/data/index.min.htm b/data/index.min.htm new file mode 100644 index 0000000..144df21 --- /dev/null +++ b/data/index.min.htm @@ -0,0 +1 @@ +Beer Gravity Monitor

Gravity:
Loading...
Temperature:
Loading...
Angle/Tilt:
Loading...
Battery:
Loading...

(C) Copyright 2021 Magnus Persson
\ No newline at end of file diff --git a/doc/AN3461.pdf b/doc/AN3461.pdf new file mode 100644 index 0000000..6847d27 --- /dev/null +++ b/doc/AN3461.pdf @@ -0,0 +1,6313 @@ +%PDF-1.4 +% +1 0 obj +<< +/PageMode /UseOutlines +/Names 2 0 R +/Outlines 3 0 R +/Metadata 4 0 R +/Pages 5 0 R +/OpenAction [6 0 R /XYZ null null null] +/Type /Catalog +/PageLabels 7 0 R +>> +endobj +8 0 obj +<< +/CreationDate (D:20110922114033Z) +/Subject <416363656C65726F6D657465722073656E736F7273206172652073656E73697469766520746F20626F746820746865206C6F63616C206772617669746174696F6E616C206669656C6420616E6420746865206C696E65617220616363656C65726174696F6E206F66207468652073656E736F722E2054686520666F726D65722070726F766964657320696E666F726D6174696F6E206F6E2074686520616363656C65726F6D65746572206F7269656E746174696F6E2C20776869636820616C6C6F7773206120736D61727470686F6E65206F72207461626C657420646973706C617920746F206175746F6D61746963616C6C7920737769746368206265747765656E20706F72747261697420616E64206C616E6473636170652073657474696E67732C207768696C6520746865206C617474657220726573706F6E647320746F2074617073206F72206F746865722068616E64736574206D6F74696F6E7320616C6C6F77696E672074686520646576656C6F706D656E74206F6620906765737475726590207573657220696E74657266616365732E> +/Copyright (Freescale Semiconductor, Inc., 2012) +/Author (Freescale Semiconductor, Inc.) +/Creator (FrameMaker 7.2) +/Producer (Acrobat Distiller 8.0.0 \(Windows\)) +/ModDate (D:20130326101537-07'00') +/Marked (True) +/Title (Tilt Sensing Using Linear Accelerometers) +>> +endobj +2 0 obj +<< +/Dests 9 0 R +>> +endobj +3 0 obj +<< +/First 10 0 R +/Count 8 +/Last 11 0 R +>> +endobj +4 0 obj +<< +/Subtype /XML +/Length 4594 +/Type /Metadata +>> +stream + + + + + application/pdf + + + Freescale Semiconductor, Inc. + + + + + Accelerometer sensors are sensitive to both the local gravitational field and the linear acceleration of the sensor. The former provides information on the accelerometer orientation, which allows a smartphone or tablet display to automatically switch between portrait and landscape settings, while the latter responds to taps or other handset motions allowing the development of ’gesture’ user interfaces. + + + + + Tilt Sensing Using Linear Accelerometers + + + + + 2011-09-22T11:40:33Z + FrameMaker 7.2 + 2013-03-26T10:15:37-07:00 + 2013-03-26T10:15:37-07:00 + + + True + Acrobat Distiller 8.0.0 (Windows) + Freescale Semiconductor, Inc., 2012 + + + Freescale Semiconductor, Inc., 2012 + True + + + uuid:ad0e2bc7-7827-4b54-bc0d-9a9e77134fdb + uuid:7d92d774-dc98-4992-8227-fc98e66f25ad + + + + + + + + + + + + + + + + + + + + + + + + + +endstream +endobj +5 0 obj +<< +/Count 22 +/Type /Pages +/Kids [12 0 R 13 0 R 14 0 R] +>> +endobj +6 0 obj +<< +/CropBox [0 0 612 792] +/Annots [15 0 R 16 0 R 17 0 R 18 0 R 19 0 R 20 0 R 21 0 R 22 0 R 23 0 R] +/Parent 12 0 R +/Contents [24 0 R 25 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/XObject << +/Im0 26 0 R +/Im2 27 0 R +>> +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/T1_0 32 0 R +/T1_1 33 0 R +>> +/ProcSet [/PDF /Text /ImageC] +/ExtGState << +/GS0 34 0 R +>> +>> +/Type /Page +>> +endobj +7 0 obj +<< +/Nums [0 35 0 R] +>> +endobj +9 0 obj +<< +/Kids [36 0 R 37 0 R 38 0 R] +>> +endobj +10 0 obj +<< +/First 39 0 R +/Parent 3 0 R +/Next 40 0 R +/Dest (G1002298) +/Count 2 +/Last 41 0 R +/Title (1 Introduction) +>> +endobj +11 0 obj +<< +/Parent 3 0 R +/Dest (G1003573) +/Prev 42 0 R +/Title (6 Selecting Portrait and Landscape Modes) +>> +endobj +12 0 obj +<< +/Parent 5 0 R +/Count 10 +/Type /Pages +/Kids [6 0 R 43 0 R 44 0 R 45 0 R 46 0 R 47 0 R 48 0 R 49 0 R 50 0 R 51 0 R] +>> +endobj +13 0 obj +<< +/Parent 5 0 R +/Count 10 +/Type /Pages +/Kids [52 0 R 53 0 R 54 0 R 55 0 R 56 0 R 57 0 R 58 0 R 59 0 R 60 0 R 61 0 R] +>> +endobj +14 0 obj +<< +/Parent 5 0 R +/Count 2 +/Type /Pages +/Kids [62 0 R 63 0 R] +>> +endobj +15 0 obj +<< +/Rect [333 416.88 333.18 425.88] +/Subtype /Link +/A << +/D (G1002298) +/F 64 0 R +/S /GoToR +>> +/Border [0 0 0] +/Type /Annot +>> +endobj +16 0 obj +<< +/Rect [333 416.88 558 425.88] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002298) +/Type /Annot +>> +endobj +17 0 obj +<< +/Rect [333 406.86 558 415.86] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002305) +/Type /Annot +>> +endobj +18 0 obj +<< +/Rect [333 396.9 558 405.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002307) +/Type /Annot +>> +endobj +19 0 obj +<< +/Rect [333 386.88 558 395.88] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002317) +/Type /Annot +>> +endobj +20 0 obj +<< +/Rect [333 376.86 558 385.86] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002433) +/Type /Annot +>> +endobj +21 0 obj +<< +/Rect [333 356.88 558 375.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003297) +/Type /Annot +>> +endobj +22 0 obj +<< +/Rect [333 346.86 558 355.86] +/Subtype /Link +/Border [0 0 0] +/Dest (G1019440) +/Type /Annot +>> +endobj +23 0 obj +<< +/Rect [333 336.9 558 345.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003573) +/Type /Annot +>> +endobj +24 0 obj +<< +/Length 1918 +/Filter /FlateDecode +>> +stream +HWےF}W[Feⷵ )?8  n6_3kW*I4 =ͳlu{62<ݬk0~-* P&iASԥAzʗGzឣ8,Ö͹}9I{l8e 'V>?J?NHX;q^(=g\Ek'/׎6/׮'L;%j +쾪6<T泻ե{1(E$sV42uc +dfm3~,PBc B7r&PG$C3=4:78 3cCg1%7n_3|Ekཱུr:mejj\v`WȌB.WmRUgNmٹnSHMGG[@@]w܇8䰅Vތ + }pd&8$-+: BnBsbn[aa R +KÒ#K$ # G(_ $Écϩh +qTv*Ǒ7V= gv{V?ޑ|]j22閣v<֜|B`fI'8i*]lw*Q5xAc.IYmBS:fЏ!0=OG}i/Ci'ƛ^Bg`[ 1 ȉStz5oIRb#JT)e-0k>;>79Ug{&.oFw2BEe˅1gPH|wAԂ/s29:q.1 'YFi*^h6!@PڬN.={?|ӰsF^9|̴ 0 <i>]#SpNb 9eL1vڽSO-0'Lc1WnεaC?qE`XL﹵0,f!8AG7ں-F38u6Y&2=wWƼhz;13> +stream +x+27ѳ047256Q0B=conjgif``dTd˥kA # +endstream +endobj +26 0 obj +<< +/Subtype /Image +/Length 6634 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 300 +/Height 122 +/Type /XObject +>> +stream +JFIF,zAdobed     $''''$25552;;;;;;;;;; + + +  ####''',,,z,"B +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw;!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?DI%)$?׾Y\jK?2`>bc1r=:KW.-|a #ٙ!~I2@r0M@G;_>q +|<$zb`V[e_gmۦ^OBjq?wܳrV^2{)spaGMgrFYyF>2;>r1,ў@O_Z&QĞN"2"2!`UK)mv6?tr՝\kMCN;墳{:Rv65u=sւƸ"}E$I +I$RI$I%)$IJI$RI$I%)$IJI%=ӫqi>CX>.IOOXiY9}t6I?D9z2JRI$I$*]Vf4t] HI:WRBQ≍}AFB>s~&x4U! .>3ntߪc~ѯ[{L9_c 6Oz~FKJ@> 7'-\P9++\tln ʛv>-NK\kw^c3+ +*Em  Ғ;˯2ޑy]`92?r,_Uz̊ d]Fn=#&g[[紖75NCػJ$?R~\.ӺCr^)kϺ'Wuw[$VߥcXߊz,=} t6 qU~OYK +cceɀ})~k_xոRƱxqT*W"2±T#!ao_[:ռ[)xuZ܇ʬ{ nc "}a60:[,UMۀsys%>MYz]6>ۆ˜pY?}sMFޓ~Bj}-x tGX Vչ-uNԺ{zE>[f: ))ڿsOE 33ۇzmː+s\< ^4'kD~^Yo]ﮘZWĄz!p& ̄J~c6pۺj7Rȍ<uc;۝ۗYA5 T>+z[M80x1c?}W.S@sk×Z/qm#'..{ǒ>!zZWQRڷَZ5G;VGGyu,jim6οU%DD`e)$VJI$Rݸ749ey07F\o?Fmy7ʋbKkJ1'pΥHWcn7!~]կxV0-mcq. l{C{5gdӾgfTT)k*,Kw$QOR.4-vg,Dw{ks'ծ7 ﱆZ_ln.t~hIO}HWzy`wZ-k}sht,7g"i <][Sl`dYT֋+N>(zM6ߔ RĂ}%2\>`ʳ?3Z==B~[.}f3nSk6&5ۮnV.,ee-))%/gSp!?z&+֛isN浮kGz_S=c FE݈#PG\>O}؝Fk'FY[l#A)֯[Z_2g汏rB>uΫ b]Cnh@5ѿsrrgQZ/P>>y@kDR$HRI$I$$I)I$JRI$I$$I)I$JRI$I$$Ju]du7w5lIO\1alΣx']UG"b2-o1^3k9,dSդ]3~f~=4cbYc.q }JJRHM}n]Jgozx=('T(쭻pcG%⚫n%Jfg9 '@j4ߑ%3Ir^>n{pێwmgtVhǮLD +W/ֿaVly4XtB#ut@;=!9%;7]to#"ܗ`We- ֓'E)j}[^C >69?.w}BA8[+0\;ƯJJqt;V9=G6~nJo:^KeY0k K>[켇M`VѬok9^#yRюfgd]"X$89Yf-[T\OԬ w[%ίoHO>쎛Ǩq,}aϩ4.ʷǒŅSfj6}kwm&RSbzkd{}zQ_>Nw=-[dFvo; :Pfc\ڵ?4I5=XTXⓧdri{_`/ 2Z3ilz\M}6,պ0ȑ:.$)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$+.eai[S{U4 $}7g;CMն +#1m} 6"RIM .:m>=]mkPGN?#nw]mk'qNI)N&.m~e5W!-h{dpatRf kFa$F-LhcD0B;_M!U[Xd˚:)$?/AηXu/}M.? +Xxtc+ }05t#h2I)&spq R N9dmtSOItcuUH$JRI$ +endstream +endobj +27 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +stream +hޜwTTϽwz0z.0. Qf Ml@DEHb!(`HPb0dFJ|yyǽgs{.$O./ 'z8WGбx0Y驾A@$/7z HeOOҬT_lN:K"N3"$F/JPrb[䥟}Qd[Sl1x{#bG\NoX3I[ql2$ 8xtrp/8 pCfq.Knjm͠{r28?.)ɩL^6g,qm"[Z[Z~Q7%" +3R`̊j[~: w!$E}kyhyRm333: }=#vʉe +tqX)I)B>== <8Xȉ9yP:8p΍Lg kk Ѐ$t!0V87`ɀ2A. +@JPA#h'@8 .: ``a!2D!UH 2 dA>P ECqB**Z:]B=h~L2  5pN:|ó@ QC !H,G6 H9R ]H/r Aw( Q(OTJCm@*QGQ-(j MF+ 6h/*t:].G7Зw7 Xa<1:L1s3bXyeb~19 vGĩp+5qy^ oó|= ?'Htv`Ba3BDxHxE$Չ"XAP44077&9$An0;T2421t.54ld+s;# V]=iY9FgM֚k&=%Ō:nc1gcbcfX.}lGv{c)LŖN퉛w/p+/<j$.$%&㒣OdxTԂԑ4i3|o~C:&S@L u[Uo3C3OfIgwdO|;W-wsz 17jl8c͉̈́3+{%lKWr[ $ +llGmnacOkE&EEY׾2⫅;K,KhtiN=e²{^-_V^Oo§s]?TWީrjVQ=w}`嚢zԶiו8>k׍ + E  [ly邟~_Y53rW򯎼^{7so}x>|쇊z>yz + +endstream +endobj +29 0 obj +<< +/Subtype /TrueType +/FontDescriptor 65 0 R +/LastChar 124 +/Widths [278 0 0 0 0 0 0 0 333 333 +0 0 278 333 278 0 556 556 556 556 +0 0 556 0 556 556 0 0 0 584 +0 0 0 722 722 722 722 667 611 0 +0 278 0 0 611 833 0 0 667 0 +722 667 611 722 0 944 0 667 0 0 +0 0 584 0 0 556 611 556 611 556 +333 611 611 278 0 556 278 889 611 611 +611 611 389 556 333 611 556 778 556 556 +0 0 280] +/BaseFont /Arial#2CBold +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +30 0 obj +<< +/Subtype /TrueType +/FontDescriptor 66 0 R +/LastChar 169 +/Widths [278 0 0 0 0 0 0 0 333 333 +0 0 278 333 278 278 556 556 556 556 +556 556 556 556 556 556 278 0 0 0 +0 0 0 667 0 0 722 0 611 0 +0 278 0 0 0 833 722 0 667 0 +722 667 0 0 0 0 0 0 0 0 +0 0 0 0 0 556 556 500 556 556 +0 556 556 222 0 500 222 833 556 556 +556 0 333 500 278 556 500 0 0 500 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 737] +/BaseFont /Arial +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +31 0 obj +<< +/Subtype /TrueType +/FontDescriptor 67 0 R +/LastChar 176 +/Widths [250 0 408 0 0 0 0 180 333 333 +0 564 250 333 250 0 500 500 500 500 +500 500 500 500 500 500 278 0 564 564 +564 444 0 722 667 667 722 611 556 0 +722 333 0 0 611 889 722 722 556 0 +667 556 611 722 0 944 0 0 0 0 +0 0 0 0 0 444 500 444 500 444 +333 500 500 278 278 500 278 778 500 500 +500 500 333 389 278 500 500 722 500 500 +444 0 200 0 0 0 0 0 0 0 +0 0 0 0 333 0 0 0 0 0 +0 0 0 0 333 0 0 350 500 0 +0 980 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 400] +/BaseFont /TimesNewRoman +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +32 0 obj +<< +/Subtype /Type1 +/FontDescriptor 68 0 R +/LastChar 121 +/Widths [278 0 0 0 0 0 0 0 0 0 +0 0 0 0 278 0 0 556 556 556 +556 556 556 556 556 556 333 0 0 0 +0 0 0 722 722 722 722 667 611 778 +722 278 0 722 611 833 0 778 667 0 +722 667 611 722 667 944 0 0 611 0 +0 0 0 0 0 556 611 556 611 556 +333 611 611 278 0 0 278 889 611 611 +611 611 389 556 333 611 556 778 556 556] +/BaseFont /Helvetica-Bold +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +33 0 obj +<< +/Subtype /Type1 +/FontDescriptor 69 0 R +/LastChar 169 +/Widths [278 0 0 0 0 0 667 0 0 0 +0 584 278 333 278 278 556 556 556 556 +556 556 556 556 0 556 278 0 0 0 +0 0 0 667 667 722 722 667 611 778 +0 278 0 667 556 833 722 778 667 778 +722 667 611 722 667 944 667 0 0 0 +0 0 0 0 0 556 556 500 556 556 +278 556 556 222 0 500 222 833 556 556 +556 556 333 500 278 556 500 722 500 500 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 222 333 333 0 0 0 +0 0 0 0 0 0 0 0 278 0 +0 0 0 0 0 0 0 737] +/BaseFont /Helvetica +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +34 0 obj +<< +/OPM 1 +/OP false +/op false +/Type /ExtGState +/SA false +/SM 0.02 +>> +endobj +35 0 obj +<< +/S /D +>> +endobj +36 0 obj +<< +/Limits [(F) (I1.1013760)] +/Names [(F) 70 0 R (G1002298) 71 0 R (G1002305) 72 0 R (G1002307) 73 0 R (G1002317) 74 0 R +(G1002330) 75 0 R (G1002358) 76 0 R (G1002433) 77 0 R (G1002509) 78 0 R (G1002533) 79 0 R +(G1002549) 80 0 R (G1002814) 81 0 R (G1002940) 82 0 R (G1003043) 83 0 R (G1003204) 84 0 R +(G1003216) 85 0 R (G1003259) 86 0 R (G1003277) 87 0 R (G1003288) 88 0 R (G1003297) 89 0 R +(G1003323) 90 0 R (G1003375) 91 0 R (G1003382) 92 0 R (G1003519) 93 0 R (G1003573) 94 0 R +(G1003580) 95 0 R (G1003623) 96 0 R (G1004545) 97 0 R (G1005724) 98 0 R (G1005835) 99 0 R +(G1009341) 100 0 R (G1009643) 101 0 R (G1009648) 102 0 R (G1014295) 103 0 R (G1014746) 104 0 R +(G1019440) 105 0 R (G1020355) 106 0 R (G1020383) 107 0 R (G1020390) 108 0 R (G1020394) 109 0 R +(G998329) 110 0 R (G998330) 111 0 R (G998361) 112 0 R (G998362) 113 0 R (G998413) 114 0 R +(I1.1004000) 115 0 R (I1.1005548) 116 0 R (I1.1007507) 117 0 R (I1.1009627) 118 0 R (I1.1009702) 119 0 R +(I1.1009706) 120 0 R (I1.1009753) 121 0 R (I1.1009754) 122 0 R (I1.1009791) 123 0 R (I1.1009908) 124 0 R +(I1.1010358) 125 0 R (I1.1010707) 126 0 R (I1.1010711) 127 0 R (I1.1011474) 128 0 R (I1.1012673) 129 0 R +(I1.1012899) 130 0 R (I1.1013107) 131 0 R (I1.1013350) 132 0 R (I1.1013760) 133 0 R] +>> +endobj +37 0 obj +<< +/Limits [(I1.1013763) (M9.83109.Equation.Eqn23.)] +/Names [(I1.1013763) 134 0 R (I1.1013811) 135 0 R (I1.1014407) 136 0 R (I1.1014408) 137 0 R (I1.1014409) 138 0 R +(I1.1014413) 139 0 R (I1.1014784) 140 0 R (I1.1015797) 141 0 R (I1.1015878) 142 0 R (I1.1016308) 143 0 R +(I1.1018580) 144 0 R (I1.1019320) 145 0 R (I1.1019334) 146 0 R (I1.1019347) 147 0 R (I1.1019360) 148 0 R +(I1.1019373) 149 0 R (I1.1019435) 150 0 R (I1.1019962) 151 0 R (I1.1020376) 152 0 R (I1.1020398) 153 0 R +(I1.1020420) 154 0 R (I1.1020433) 155 0 R (I1.1020449) 156 0 R (I1.1020479) 157 0 R (I1.1020820) 158 0 R +(I1.1020826) 159 0 R (I1.1020931) 160 0 R (I1.1020933) 161 0 R (I1.1020935) 162 0 R (I1.1020937) 163 0 R +(I1.1020939) 164 0 R (I1.1020941) 165 0 R (I1.1020943) 166 0 R (I1.1020945) 167 0 R (L) 168 0 R +(M9.11407.Equation.Eqn38.) 169 0 R (M9.11934.Equation.Eqn40.) 170 0 R (M9.13317.FigTitle.Figure4.Roll.Angle.Error.Surface.for.001) 171 0 R (M9.14658.Equation.Eqn27.) 172 0 R (M9.15935.Equation.Eqn45.) 173 0 R +(M9.17585.Equation.Eqn25.) 174 0 R (M9.18308.Equation.Eqn39) 175 0 R (M9.24208.Equation.Eqn11.) 176 0 R (M9.25637.Equation.Eqn33.) 177 0 R (M9.27007.Equation.Eqn28.) 178 0 R +(M9.27158.Equation.Eqn8.) 179 0 R (M9.39877.FigTitle.Figure3.Definition.of.Coordinate.and.Rotation.System) 180 0 R (M9.41934.Equation.Eqn34.) 181 0 R (M9.42696.Equation.Eqn6) 182 0 R (M9.44496.Equation.Eqn39.Eq.54) 183 0 R +(M9.49740.FigTitle.Figure2.Simplified.Transducer.Model.and.Equivalent.Electrical.Circuit) 184 0 R (M9.60481.Equation.Eqn36.) 185 0 R (M9.63999.FigTitle.Figure6.Definitions.of.the.Scalar.and.Vector.Products) 186 0 R (M9.65537.Equation.Eqn36.) 187 0 R (M9.65613.Equation.Eqn35.) 188 0 R +(M9.65870.Equation.Eqn38.) 189 0 R (M9.66087.FigTitle.Figure1.Portrait.and.Landscape.Screen.Orientations.for.a.Tablet.PC) 190 0 R (M9.73662.Equation.Eqn37.) 191 0 R (M9.75266.Equation.Eqn24.) 192 0 R (M9.77239.Equation.Eqn9.) 193 0 R +(M9.77580.Equation.Eqn1) 194 0 R (M9.80123.Equation.Eqn55.) 195 0 R (M9.82859.Equation.Eqn12.) 196 0 R (M9.83109.Equation.Eqn23.) 197 0 R] +>> +endobj +38 0 obj +<< +/Limits [(M9.92026.FigTitle.Figure9.State.Transition.Zones.for.Display.Orientation.Changes) (P.9)] +/Names [(M9.92026.FigTitle.Figure9.State.Transition.Zones.for.Display.Orientation.Changes) 198 0 R (M9.94687.Equation.Eqn26.) 199 0 R (M9.97146.Equation.Eqn42.) 200 0 R (M9.97246.Equation.Eqn29.) 201 0 R (M9.99837.FigTitle.Figure5.Roll.Angle.Error.Surface.for.01) 202 0 R +(P.1) 203 0 R (P.10) 204 0 R (P.11) 205 0 R (P.12) 206 0 R (P.13) 207 0 R +(P.14) 208 0 R (P.15) 209 0 R (P.16) 210 0 R (P.17) 211 0 R (P.18) 212 0 R +(P.19) 213 0 R (P.2) 214 0 R (P.20) 215 0 R (P.21) 216 0 R (P.22) 217 0 R +(P.3) 218 0 R (P.4) 219 0 R (P.5) 220 0 R (P.6) 221 0 R (P.7) 222 0 R +(P.8) 223 0 R (P.9) 224 0 R] +>> +endobj +39 0 obj +<< +/Parent 10 0 R +/Next 41 0 R +/Dest (G1002305) +/Title (1.1 Key Words) +>> +endobj +40 0 obj +<< +/Parent 3 0 R +/Next 225 0 R +/Dest (G1002317) +/Prev 10 0 R +/Title (2 Accelerometer Output Under Gravity and Acceleration) +>> +endobj +41 0 obj +<< +/Parent 10 0 R +/Dest (G1002307) +/Prev 39 0 R +/Title (1.2 Summary) +>> +endobj +42 0 obj +<< +/Parent 3 0 R +/Next 11 0 R +/Dest (G1019440) +/Prev 226 0 R +/Title (5 Calculating the Tilt Angle) +>> +endobj +43 0 obj +<< +/CropBox [0 0 612 792] +/Parent 12 0 R +/Contents [227 0 R 228 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/T1_0 32 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 229 0 R +>> +>> +/Type /Page +>> +endobj +44 0 obj +<< +/CropBox [0 0 612 792] +/Annots [230 0 R] +/Parent 12 0 R +/Contents [231 0 R 232 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/XObject << +/Im0 233 0 R +/Im2 234 0 R +>> +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +/CS1 [/Indexed [/ICCBased 28 0 R] + 255 235 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 236 0 R +/TT4 237 0 R +/T1_0 32 0 R +>> +/ProcSet [/PDF /Text /ImageC /ImageI] +/ExtGState << +/GS0 34 0 R +>> +>> +/Type /Page +>> +endobj +45 0 obj +<< +/CropBox [0 0 612 792] +/Annots [238 0 R] +/Parent 12 0 R +/Contents [239 0 R 240 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 236 0 R +/T1_0 32 0 R +/T1_1 241 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 242 0 R +>> +>> +/Type /Page +>> +endobj +46 0 obj +<< +/CropBox [0 0 612 792] +/Parent 12 0 R +/Contents [243 0 R 244 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/XObject << +/Im0 245 0 R +/Im2 246 0 R +>> +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 247 0 R +/TT4 236 0 R +/T1_0 32 0 R +/C2_0 248 0 R +/T1_1 249 0 R +/T1_2 241 0 R +>> +/ProcSet [/PDF /Text /ImageC] +/ExtGState << +/GS0 34 0 R +>> +>> +/Type /Page +>> +endobj +47 0 obj +<< +/CropBox [0 0 612 792] +/Annots [250 0 R 251 0 R] +/Parent 12 0 R +/Contents [252 0 R 253 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 247 0 R +/TT4 236 0 R +/T1_0 249 0 R +/C2_0 248 0 R +/T1_1 32 0 R +/T1_2 241 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 254 0 R +>> +>> +/Type /Page +>> +endobj +48 0 obj +<< +/CropBox [0 0 612 792] +/Parent 12 0 R +/Contents [255 0 R 256 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 247 0 R +/TT3 236 0 R +/TT4 31 0 R +/T1_0 249 0 R +/T1_1 241 0 R +/C2_0 248 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 257 0 R +>> +>> +/Type /Page +>> +endobj +49 0 obj +<< +/CropBox [0 0 612 792] +/Parent 12 0 R +/Contents [258 0 R 259 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 236 0 R +/TT3 31 0 R +/TT4 247 0 R +/T1_0 249 0 R +/C2_0 248 0 R +/T1_1 241 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 260 0 R +>> +>> +/Type /Page +>> +endobj +50 0 obj +<< +/CropBox [0 0 612 792] +/Annots [261 0 R 262 0 R 263 0 R 264 0 R 265 0 R 266 0 R 267 0 R 268 0 R 269 0 R 270 0 R] +/Parent 12 0 R +/Contents [271 0 R 272 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 236 0 R +/TT4 247 0 R +/T1_0 249 0 R +/C2_0 248 0 R +/T1_1 241 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 273 0 R +>> +>> +/Type /Page +>> +endobj +51 0 obj +<< +/CropBox [0 0 612 792] +/Annots [274 0 R 275 0 R 276 0 R 277 0 R 278 0 R 279 0 R 280 0 R] +/Parent 12 0 R +/Contents [281 0 R 282 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 283 0 R +/TT3 31 0 R +/TT4 247 0 R +/TT5 236 0 R +/T1_0 241 0 R +/C2_0 248 0 R +/T1_1 249 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 284 0 R +>> +>> +/Type /Page +>> +endobj +52 0 obj +<< +/CropBox [0 0 612 792] +/Annots [285 0 R 286 0 R 287 0 R 288 0 R 289 0 R 290 0 R] +/Parent 13 0 R +/Contents [291 0 R 292 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 236 0 R +/T1_0 241 0 R +/C2_0 248 0 R +/T1_1 249 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 293 0 R +>> +>> +/Type /Page +>> +endobj +53 0 obj +<< +/CropBox [0 0 612 792] +/Annots [294 0 R 295 0 R 296 0 R 297 0 R 298 0 R 299 0 R] +/Parent 13 0 R +/Contents [300 0 R 301 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 247 0 R +/TT4 236 0 R +/TT5 283 0 R +/T1_0 241 0 R +/C2_0 248 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 302 0 R +>> +>> +/Type /Page +>> +endobj +54 0 obj +<< +/CropBox [0 0 612 792] +/Annots [303 0 R 304 0 R 305 0 R 306 0 R 307 0 R 308 0 R 309 0 R 310 0 R 311 0 R 312 0 R +313 0 R] +/Parent 13 0 R +/Contents [314 0 R 315 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 236 0 R +/TT4 283 0 R +/TT5 247 0 R +/TT6 316 0 R +/T1_0 241 0 R +/T1_1 249 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 317 0 R +>> +>> +/Type /Page +>> +endobj +55 0 obj +<< +/CropBox [0 0 612 792] +/Annots [318 0 R 319 0 R 320 0 R 321 0 R 322 0 R 323 0 R] +/Parent 13 0 R +/Contents [324 0 R 325 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 236 0 R +/T1_0 241 0 R +/C2_0 248 0 R +/T1_1 249 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 326 0 R +>> +>> +/Type /Page +>> +endobj +56 0 obj +<< +/CropBox [0 0 612 792] +/Parent 13 0 R +/Contents [327 0 R 328 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/XObject << +/Im0 329 0 R +/Im1 330 0 R +/Im3 331 0 R +>> +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/T1_0 32 0 R +/T1_1 241 0 R +>> +/ProcSet [/PDF /Text /ImageC] +/ExtGState << +/GS0 34 0 R +>> +>> +/Type /Page +>> +endobj +57 0 obj +<< +/CropBox [0 0 612 792] +/Annots [332 0 R 333 0 R 334 0 R] +/Parent 13 0 R +/Contents [335 0 R 336 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 247 0 R +/TT4 236 0 R +/TT5 283 0 R +/T1_0 249 0 R +/C2_0 248 0 R +/T1_1 32 0 R +/T1_2 241 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 337 0 R +>> +>> +/Type /Page +>> +endobj +58 0 obj +<< +/CropBox [0 0 612 792] +/Annots [338 0 R 339 0 R 340 0 R] +/Parent 13 0 R +/Contents [341 0 R 342 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 283 0 R +/TT4 247 0 R +/TT5 236 0 R +/TT6 343 0 R +/T1_0 32 0 R +/C2_0 248 0 R +/T1_1 249 0 R +/T1_2 241 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 344 0 R +>> +>> +/Type /Page +>> +endobj +59 0 obj +<< +/CropBox [0 0 612 792] +/Parent 13 0 R +/Contents [345 0 R 346 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/XObject << +/Im0 347 0 R +/Im1 348 0 R +/Im3 349 0 R +>> +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +/CS1 [/Indexed [/ICCBased 28 0 R] + 255 350 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 247 0 R +/TT4 236 0 R +/TT5 283 0 R +/T1_0 249 0 R +/C2_0 248 0 R +/T1_1 32 0 R +/T1_2 241 0 R +>> +/ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/ExtGState << +/GS0 34 0 R +>> +>> +/Type /Page +>> +endobj +60 0 obj +<< +/CropBox [0 0 612 792] +/Annots [351 0 R] +/Parent 13 0 R +/Contents [352 0 R 353 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 247 0 R +/TT4 236 0 R +/TT5 283 0 R +/T1_0 241 0 R +/C2_0 248 0 R +/T1_1 249 0 R +>> +/ProcSet [/PDF /Text] +/ExtGState << +/GS0 34 0 R +>> +/XObject << +/Im1 354 0 R +>> +>> +/Type /Page +>> +endobj +61 0 obj +<< +/CropBox [0 0 612 792] +/Annots [355 0 R 356 0 R] +/Parent 13 0 R +/Contents [357 0 R 358 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/XObject << +/Im10 359 0 R +/Im11 360 0 R +/Im0 361 0 R +/Im1 362 0 R +/Im2 363 0 R +/Im3 364 0 R +/Im4 365 0 R +/Im5 366 0 R +/Im6 367 0 R +/Im7 368 0 R +/Im8 369 0 R +/Im9 370 0 R +/Im13 371 0 R +>> +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 236 0 R +/TT4 283 0 R +/T1_0 32 0 R +>> +/ProcSet [/PDF /Text /ImageB /ImageC] +/ExtGState << +/GS0 34 0 R +>> +>> +/Type /Page +>> +endobj +62 0 obj +<< +/CropBox [0 0 612 792] +/Annots [372 0 R] +/Parent 14 0 R +/Contents [373 0 R 374 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/XObject << +/Im0 375 0 R +/Im2 376 0 R +>> +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 29 0 R +/TT1 30 0 R +/TT2 31 0 R +/TT3 236 0 R +/T1_0 32 0 R +>> +/ProcSet [/PDF /Text /ImageC] +/ExtGState << +/GS0 34 0 R +>> +>> +/Type /Page +>> +endobj +63 0 obj +<< +/CropBox [0 0 612 792] +/Annots [377 0 R] +/Parent 14 0 R +/Contents [378 0 R 379 0 R] +/Rotate 0 +/MediaBox [0 0 612 792] +/Resources << +/XObject << +/Im0 380 0 R +/Im2 381 0 R +>> +/ColorSpace << +/CS0 [/ICCBased 28 0 R] +>> +/Font << +/TT0 31 0 R +/T1_0 33 0 R +/T1_1 249 0 R +/T1_2 32 0 R +>> +/ProcSet [/PDF /Text /ImageC] +/ExtGState << +/GS0 34 0 R +>> +>> +/Type /Page +>> +endobj +64 0 obj +<< +/F (AN3461_rev3.pdf) +/Type /Filespec +>> +endobj +65 0 obj +<< +/StemV 138 +/FontName /Arial#2CBold +/FontStretch /Normal +/FontWeight 700 +/Flags 32 +/Descent -211 +/FontBBox [-628 -376 2000 1010] +/Ascent 905 +/FontFamily (Arial) +/CapHeight 718 +/XHeight 515 +/Type /FontDescriptor +/ItalicAngle 0 +>> +endobj +66 0 obj +<< +/StemV 88 +/FontName /Arial +/FontStretch /Normal +/FontWeight 400 +/Flags 32 +/Descent -211 +/FontBBox [-665 -325 2000 1006] +/Ascent 905 +/FontFamily (Arial) +/CapHeight 0 +/Type /FontDescriptor +/ItalicAngle 0 +>> +endobj +67 0 obj +<< +/StemV 82 +/FontName /TimesNewRoman +/FontStretch /Normal +/FontWeight 400 +/Flags 34 +/Descent -216 +/FontBBox [-568 -307 2000 1007] +/Ascent 891 +/FontFamily (Times New Roman) +/CapHeight 656 +/XHeight -546 +/Type /FontDescriptor +/ItalicAngle 0 +>> +endobj +68 0 obj +<< +/StemV 140 +/FontName /Helvetica-Bold +/Flags 262176 +/Descent -207 +/FontBBox [-170 -228 1003 962] +/Ascent 718 +/CapHeight 718 +/XHeight 532 +/Type /FontDescriptor +/ItalicAngle 0 +/StemH 140 +>> +endobj +69 0 obj +<< +/StemV 88 +/FontName /Helvetica +/Flags 32 +/Descent -207 +/FontBBox [-166 -225 1000 931] +/Ascent 718 +/CapHeight 718 +/XHeight 523 +/Type /FontDescriptor +/ItalicAngle 0 +/StemH 88 +>> +endobj +70 0 obj +<< +/D [6 0 R /XYZ null null null] +>> +endobj +71 0 obj +<< +/D [6 0 R /XYZ 54 448 null] +>> +endobj +72 0 obj +<< +/D [43 0 R /XYZ 54 564 null] +>> +endobj +73 0 obj +<< +/D [43 0 R /XYZ 54 510 null] +>> +endobj +74 0 obj +<< +/D [44 0 R /XYZ 54 731 null] +>> +endobj +75 0 obj +<< +/D [45 0 R /XYZ 54 473 null] +>> +endobj +76 0 obj +<< +/D [46 0 R /XYZ 54 425 null] +>> +endobj +77 0 obj +<< +/D [47 0 R /XYZ 54 492 null] +>> +endobj +78 0 obj +<< +/D [48 0 R /XYZ 54 549 null] +>> +endobj +79 0 obj +<< +/D [48 0 R /XYZ 54 330 null] +>> +endobj +80 0 obj +<< +/D [48 0 R /XYZ 54 257 null] +>> +endobj +81 0 obj +<< +/D [51 0 R /XYZ 54 312 null] +>> +endobj +82 0 obj +<< +/D [53 0 R /XYZ 54 471 null] +>> +endobj +83 0 obj +<< +/D [54 0 R /XYZ 54 655 null] +>> +endobj +84 0 obj +<< +/D [55 0 R /XYZ 54 675 null] +>> +endobj +85 0 obj +<< +/D [55 0 R /XYZ 54 487 null] +>> +endobj +86 0 obj +<< +/D [56 0 R /XYZ 54 426 null] +>> +endobj +87 0 obj +<< +/D [56 0 R /XYZ 54 109 null] +>> +endobj +88 0 obj +<< +/D [57 0 R /XYZ 54 683 null] +>> +endobj +89 0 obj +<< +/D [57 0 R /XYZ 54 560 null] +>> +endobj +90 0 obj +<< +/D [57 0 R /XYZ 54 330 null] +>> +endobj +91 0 obj +<< +/D [57 0 R /XYZ 54 149 null] +>> +endobj +92 0 obj +<< +/D [58 0 R /XYZ 54 501 null] +>> +endobj +93 0 obj +<< +/D [60 0 R /XYZ 54 676 null] +>> +endobj +94 0 obj +<< +/D [61 0 R /XYZ 54 731 null] +>> +endobj +95 0 obj +<< +/D [61 0 R /XYZ 54 328 null] +>> +endobj +96 0 obj +<< +/D [62 0 R /XYZ 54 351 null] +>> +endobj +97 0 obj +<< +/D [46 0 R /XYZ 54 294 null] +>> +endobj +98 0 obj +<< +/D [48 0 R /XYZ 54 703 null] +>> +endobj +99 0 obj +<< +/D [48 0 R /XYZ 54 476 null] +>> +endobj +100 0 obj +<< +/D [50 0 R /XYZ 54 553 null] +>> +endobj +101 0 obj +<< +/D [51 0 R /XYZ 54 530 null] +>> +endobj +102 0 obj +<< +/D [51 0 R /XYZ 54 478 null] +>> +endobj +103 0 obj +<< +/D [55 0 R /XYZ 54 581 null] +>> +endobj +104 0 obj +<< +/D [54 0 R /XYZ 54 603 null] +>> +endobj +105 0 obj +<< +/D [59 0 R /XYZ 54 441 null] +>> +endobj +106 0 obj +<< +/D [63 0 R /XYZ 72 64 null] +>> +endobj +107 0 obj +<< +/D [63 0 R /XYZ 276 398 null] +>> +endobj +108 0 obj +<< +/D [63 0 R /XYZ 273 119 null] +>> +endobj +109 0 obj +<< +/D [63 0 R /XYZ 345 116 null] +>> +endobj +110 0 obj +<< +/D [43 0 R /XYZ 54 56 null] +>> +endobj +111 0 obj +<< +/D [43 0 R /XYZ 54 45 null] +>> +endobj +112 0 obj +<< +/D [44 0 R /XYZ 54 57 null] +>> +endobj +113 0 obj +<< +/D [44 0 R /XYZ 54 45 null] +>> +endobj +114 0 obj +<< +/D [6 0 R /XYZ 54 61 null] +>> +endobj +115 0 obj +<< +/D [61 0 R /XYZ 187 335 null] +>> +endobj +116 0 obj +<< +/D [46 0 R /XYZ 207 432 null] +>> +endobj +117 0 obj +<< +/D [58 0 R /XYZ 221 508 null] +>> +endobj +118 0 obj +<< +/D [48 0 R /XYZ 248 555 null] +>> +endobj +119 0 obj +<< +/D [48 0 R /XYZ 195 709 null] +>> +endobj +120 0 obj +<< +/D [50 0 R /XYZ 377 559 null] +>> +endobj +121 0 obj +<< +/D [48 0 R /XYZ 245 336 null] +>> +endobj +122 0 obj +<< +/D [48 0 R /XYZ 195 482 null] +>> +endobj +123 0 obj +<< +/D [48 0 R /XYZ 193 263 null] +>> +endobj +124 0 obj +<< +/D [51 0 R /XYZ 473 318 null] +>> +endobj +125 0 obj +<< +/D [62 0 R /XYZ 197 357 null] +>> +endobj +126 0 obj +<< +/D [51 0 R /XYZ 244 536 null] +>> +endobj +127 0 obj +<< +/D [51 0 R /XYZ 159 484 null] +>> +endobj +128 0 obj +<< +/D [53 0 R /XYZ 112 478 null] +>> +endobj +129 0 obj +<< +/D [57 0 R /XYZ 458 156 null] +>> +endobj +130 0 obj +<< +/D [54 0 R /XYZ 180 661 null] +>> +endobj +131 0 obj +<< +/D [55 0 R /XYZ 187 681 null] +>> +endobj +132 0 obj +<< +/D [45 0 R /XYZ 182 479 null] +>> +endobj +133 0 obj +<< +/D [54 0 R /XYZ 348 417 null] +>> +endobj +134 0 obj +<< +/D [54 0 R /XYZ 197 365 null] +>> +endobj +135 0 obj +<< +/D [51 0 R /XYZ 468 644 null] +>> +endobj +136 0 obj +<< +/D [55 0 R /XYZ 56 493 null] +>> +endobj +137 0 obj +<< +/D [55 0 R /XYZ 203 587 null] +>> +endobj +138 0 obj +<< +/D [56 0 R /XYZ 232 433 null] +>> +endobj +139 0 obj +<< +/D [56 0 R /XYZ 235 115 null] +>> +endobj +140 0 obj +<< +/D [57 0 R /XYZ 198 689 null] +>> +endobj +141 0 obj +<< +/D [57 0 R /XYZ 166 337 null] +>> +endobj +142 0 obj +<< +/D [53 0 R /XYZ 117 530 null] +>> +endobj +143 0 obj +<< +/D [60 0 R /XYZ 133 682 null] +>> +endobj +144 0 obj +<< +/D [54 0 R /XYZ 182 609 null] +>> +endobj +145 0 obj +<< +/D [6 0 R /XYZ 54 67 null] +>> +endobj +146 0 obj +<< +/D [44 0 R /XYZ 306 63 null] +>> +endobj +147 0 obj +<< +/D [44 0 R /XYZ 306 51 null] +>> +endobj +148 0 obj +<< +/D [43 0 R /XYZ 306 62 null] +>> +endobj +149 0 obj +<< +/D [43 0 R /XYZ 306 51 null] +>> +endobj +150 0 obj +<< +/D [59 0 R /XYZ 178 497 null] +>> +endobj +151 0 obj +<< +/D [46 0 R /XYZ 221 301 null] +>> +endobj +152 0 obj +<< +/D [63 0 R /XYZ 275 436 null] +>> +endobj +153 0 obj +<< +/D [63 0 R /XYZ 72 70 null] +>> +endobj +154 0 obj +<< +/D [63 0 R /XYZ 398 319 null] +>> +endobj +155 0 obj +<< +/D [63 0 R /XYZ 276 127 null] +>> +endobj +156 0 obj +<< +/D [63 0 R /XYZ 345 117 null] +>> +endobj +157 0 obj +<< +/D [6 0 R /XYZ 333 432 null] +>> +endobj +158 0 obj +<< +/D [51 0 R /XYZ 222 210 null] +>> +endobj +159 0 obj +<< +/D [51 0 R /XYZ 241 147 null] +>> +endobj +160 0 obj +<< +/D [6 0 R /XYZ 333 432 null] +>> +endobj +161 0 obj +<< +/D [6 0 R /XYZ 351 423 null] +>> +endobj +162 0 obj +<< +/D [6 0 R /XYZ 351 412 null] +>> +endobj +163 0 obj +<< +/D [6 0 R /XYZ 333 402 null] +>> +endobj +164 0 obj +<< +/D [6 0 R /XYZ 333 393 null] +>> +endobj +165 0 obj +<< +/D [6 0 R /XYZ 333 382 null] +>> +endobj +166 0 obj +<< +/D [6 0 R /XYZ 333 363 null] +>> +endobj +167 0 obj +<< +/D [6 0 R /XYZ 333 352 null] +>> +endobj +168 0 obj +<< +/D [63 0 R /XYZ null null null] +>> +endobj +169 0 obj +<< +/D [55 0 R /XYZ 187 681 null] +>> +endobj +170 0 obj +<< +/D [55 0 R /XYZ 56 493 null] +>> +endobj +171 0 obj +<< +/D [56 0 R /XYZ 232 433 null] +>> +endobj +172 0 obj +<< +/D [51 0 R /XYZ 473 318 null] +>> +endobj +173 0 obj +<< +/D [57 0 R /XYZ 166 337 null] +>> +endobj +174 0 obj +<< +/D [51 0 R /XYZ 244 536 null] +>> +endobj +175 0 obj +<< +/D [55 0 R /XYZ 203 587 null] +>> +endobj +176 0 obj +<< +/D [48 0 R /XYZ 245 336 null] +>> +endobj +177 0 obj +<< +/D [53 0 R /XYZ 117 530 null] +>> +endobj +178 0 obj +<< +/D [51 0 R /XYZ 222 210 null] +>> +endobj +179 0 obj +<< +/D [48 0 R /XYZ 248 555 null] +>> +endobj +180 0 obj +<< +/D [46 0 R /XYZ 207 432 null] +>> +endobj +181 0 obj +<< +/D [53 0 R /XYZ 112 478 null] +>> +endobj +182 0 obj +<< +/D [48 0 R /XYZ 195 709 null] +>> +endobj +183 0 obj +<< +/D [59 0 R /XYZ 178 497 null] +>> +endobj +184 0 obj +<< +/D [45 0 R /XYZ 182 479 null] +>> +endobj +185 0 obj +<< +/D [54 0 R /XYZ 348 417 null] +>> +endobj +186 0 obj +<< +/D [58 0 R /XYZ 221 508 null] +>> +endobj +187 0 obj +<< +/D [54 0 R /XYZ 182 609 null] +>> +endobj +188 0 obj +<< +/D [54 0 R /XYZ 180 661 null] +>> +endobj +189 0 obj +<< +/D [57 0 R /XYZ 458 156 null] +>> +endobj +190 0 obj +<< +/D [61 0 R /XYZ 187 335 null] +>> +endobj +191 0 obj +<< +/D [54 0 R /XYZ 197 365 null] +>> +endobj +192 0 obj +<< +/D [51 0 R /XYZ 468 644 null] +>> +endobj +193 0 obj +<< +/D [48 0 R /XYZ 195 482 null] +>> +endobj +194 0 obj +<< +/D [46 0 R /XYZ 221 301 null] +>> +endobj +195 0 obj +<< +/D [60 0 R /XYZ 133 682 null] +>> +endobj +196 0 obj +<< +/D [48 0 R /XYZ 193 263 null] +>> +endobj +197 0 obj +<< +/D [50 0 R /XYZ 377 559 null] +>> +endobj +198 0 obj +<< +/D [62 0 R /XYZ 197 357 null] +>> +endobj +199 0 obj +<< +/D [51 0 R /XYZ 159 484 null] +>> +endobj +200 0 obj +<< +/D [57 0 R /XYZ 198 689 null] +>> +endobj +201 0 obj +<< +/D [51 0 R /XYZ 241 147 null] +>> +endobj +202 0 obj +<< +/D [56 0 R /XYZ 235 115 null] +>> +endobj +203 0 obj +<< +/D [6 0 R /XYZ null null null] +>> +endobj +204 0 obj +<< +/D [51 0 R /XYZ null null null] +>> +endobj +205 0 obj +<< +/D [52 0 R /XYZ null null null] +>> +endobj +206 0 obj +<< +/D [53 0 R /XYZ null null null] +>> +endobj +207 0 obj +<< +/D [54 0 R /XYZ null null null] +>> +endobj +208 0 obj +<< +/D [55 0 R /XYZ null null null] +>> +endobj +209 0 obj +<< +/D [56 0 R /XYZ null null null] +>> +endobj +210 0 obj +<< +/D [57 0 R /XYZ null null null] +>> +endobj +211 0 obj +<< +/D [58 0 R /XYZ null null null] +>> +endobj +212 0 obj +<< +/D [59 0 R /XYZ null null null] +>> +endobj +213 0 obj +<< +/D [60 0 R /XYZ null null null] +>> +endobj +214 0 obj +<< +/D [43 0 R /XYZ null null null] +>> +endobj +215 0 obj +<< +/D [61 0 R /XYZ null null null] +>> +endobj +216 0 obj +<< +/D [62 0 R /XYZ null null null] +>> +endobj +217 0 obj +<< +/D [63 0 R /XYZ null null null] +>> +endobj +218 0 obj +<< +/D [44 0 R /XYZ null null null] +>> +endobj +219 0 obj +<< +/D [45 0 R /XYZ null null null] +>> +endobj +220 0 obj +<< +/D [46 0 R /XYZ null null null] +>> +endobj +221 0 obj +<< +/D [47 0 R /XYZ null null null] +>> +endobj +222 0 obj +<< +/D [48 0 R /XYZ null null null] +>> +endobj +223 0 obj +<< +/D [49 0 R /XYZ null null null] +>> +endobj +224 0 obj +<< +/D [50 0 R /XYZ null null null] +>> +endobj +225 0 obj +<< +/Parent 3 0 R +/Next 226 0 R +/Dest (G1002433) +/Prev 40 0 R +/Title (3 Pitch and Roll Estimation) +>> +endobj +226 0 obj +<< +/Parent 3 0 R +/Next 42 0 R +/Dest (G1003297) +/Prev 225 0 R +/Title (4 Calculating the Angle Between Two Accelerometer Readings) +>> +endobj +227 0 obj +<< +/Length 2232 +/Filter /FlateDecode +>> +stream +H|Wr|Wt̋ =>6f-:ap& GnD"HʪIE~4HɖImm, #Z +aOO; d!{0 XaC*e< +mBz܋3? `OcV4ێvI䧙 WGC9B %o(W{m]]z3o[}F봗HObq0gAdJśG~Ex& 9q 9~'x\?EW?%⍌DG};AG0~BOM]r 1]i©|u߱Wb`e"$rnS.߿C@ C?HR4pJ`\e=O%Wt5=73%z/(hb7dI}`3n +D ؟a$ +X9gaj(Q$f6 p +vuGr c pW5Q_JޱgҢnRR}x9Vgį}Qw$fF#]#nH^Y+fsUCcG[S×ԈVtʀs̩)Fy.A_[ J.>6dq!Uh!悅ՙ'ƻ: 2>Q#=*{9|*x` +r|C~+?:Cb/J~*rI"mj r0½=8n@dgGA9ZjԄ8D+뉘p + K +O +a}%ƿ_>0#0>nAS3 n?^VrE>Qw BCwŦu?b[gl3 P;ƈcHObvN*:47-;(llӼ5r0Qx65eflW^>,3.'fj.4D3'/LI1'B8v1y~qi^H7 +b.LQoh' >{h~*@ QN+aQ2$k<7<ӝx7@$E"@DۖKjq7G,ɳ)ЇnzCFW+0ډPՆ. \ F{,DW-dW54moy99te-׋s`q[%o!u\+ +S?5Q C'kEn܏7l_b/ B֘^G02E\_ $yhcaJR,mf%:[49? $Gum>Q##VЖeF+FsDjh0FGۥ'V)1q0"2%řq8Y{aX2* ̸b cC9jbx#мTV [[dt zYX W;R&THoV|Fa"m+ܶZ?O1mQ& 85+%[?fʞH7Wv* dfNYp&Z%@ VF3='4KeWF[IP uIpWKdG>GH^hCR'{C"`) .hW :~M֡YAKSC~V\U ԙ/YzH?6\VY>{d^~ &W!NB%FJ_Az?{(5 p d;y+%9. $4gD1 LvrkF|SVw5s]"lSVېj%ԹIjzCR?:dWfꙃ?;gll9sЁr:AIexg+d]p֦Mlys;{QGzdz$AhOS/&{7+5HG2RǖBZH>KbĽNѼTpύP'#Vș^Ή{IՆ%_% +endstream +endobj +228 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +229 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +231 0 obj +<< +/Length 9695 +/Filter /FlateDecode +>> +stream +HW[8~ϯУM.l?[t2:n_ߑ|K&@Bd[:|?7&eV3#RXsߟfFP\hfb >I<{+ؾrINK&W2/0EQdUGo8`/zab *o$x{^۶Khi2}bW\0Ysf-7ml0y$n] oӢd{,:oba4J@\tlwًr׵Go;I#Xez<19Ue\lHM>Do`a_nݱfP mi5 /fMz7HT2zzV( +E2AA)ZSa`5{Gg  s+Ĺ,ƍ]f*vV~r=kCRgSFKycNeGwd !]C!"rQxRFmXOT+3pe$|(9BPIB՝P1:U(iqCK=&Xx +hx兝a{bFKb>ӏi$A LL@g{< %'`jREyh}HYpEɧ*&l]ݷOuI`a@Xq2dy+w5,yvNl&T +{zm'KPm&bRà:E9G1FRU{r>A2+%E^NN©k!X=Crqb"8"|2Z#џ连p[Ιq-Sq &CXn5\%׽@Gb(1c} dkll>UͮS-[1PAYzЯxо$6&)zMhΝ +khJ÷7 rCت,$gdm'2h`eg[l~jJwOJv&>}'_bo)t&":N:sP@}@nHO`>i?|(bԸYCIqBYbX(l>sCFCɎ!뼴lDDB, +oB3ZbeZWY; .\g0dL>H3U%^Hs?J=w6\& +ҥT8KqRX~EMa)qp.(BߢL +\Q} R ζLFT:w`-6IZG W(-"*)]ͭR$I$=!Xk{؝rT +< By!W\>q#͌f$_N޾'c& 66*O1z6'{-ִN =rڭ%BMR#aT\¸<ֆ!%*U )C7 ԛWfxS:I̕9B* <CYAn=(BJL2Ubʧ)/ph0Uv]*xjS4osN.ȫi29 @z6oA"hŸ_PCY3t"k؁6+=7C +2Db`҅OۀTP $JppKi/)Z!@@Gs~K&HSy0qsC32hIk&^CW9(_ПQ(?h4;KQ3 pQDu4!ZTι +t&AARG^Q-O- RQ5x$bVc&T_j PE3 +1fuVq)|:D;ƻ*Rj^(ٱ|< rwŗ%p>RoRoxOKRYK(|D]Laɗ~5߰f}xgߋNEVܖǗŶԄ{47-/Xro2ܨ{?S^+g_p}Es'@t)/yEOiOU 4/xRw҉I{=NW쿜uCJ0 .͋;w,}ol:ٱcU_{v +mx]&dFq⽴r+o\;oמ8uǮùy2 =;@/KK[` |aٷWo-H6=7_w|u5-e>fJx%v};{2W{_8Ǟ-_/o_74"/LgtaGؽHm٭bf򑨭^xvLdN.7 +dO. E:dWx%~e +燝EL'CW~d!k·ݷpXL@S^FPha Ns& )9ChԔyhQ a +RfqAlF0&j}!^x:5LQd*©N֥_ё:X<ɥ`:`EY0LQZ"IukƎ42MM;;Zl%]}WӲcS˦8:+Bp%>2~vDWqHnMcZPRtz< F@OWރOhN{/?Y/H&cO=kWj~ +L94!=<#]j4=4iLZYPՊoUπl'N/DZe]7 2b;emhBgz8b] j @۽ɖtA9(3컱/X%h 8Q,HC[@z6(|g P|hIV}们 Ph]B咟6U]~-+g(EŎ*..=^?g6Ғ~yHڶ\IÓ 48~8.7=V$D7N2+ޮ`Rt]ı^k"TzW-j[a/lԾ`KL,^XA#(MvsUTr&^i=Sdɗ4h@ё LMFG!ҏuԮ("c+]-}Bꌇ~I 6> 漽izHxJ;ʆ0{y;HYLd6 C6|>SRQp +H.pTXܧD'G+o YeR]wjR6U,EoĚ@n90 up#.9wH4%=D} +ݮ 6@nJpҵ X9&D\WGg`"L>>Tޣ {WlXC9S$M=x_ꢤ$+Cyt@MGeTPFz0"o'Ύ Eޘv$r ~i̅6aBzVr)]Ai3a yXN%΍t[.he_sE1[v'\X6$f@Gx(Jd t}+W+JF}+@݆t F+0 WzjT(:sTsݑF2GV)fE&)Կ3 +e]r_, GsD<2FT)^O䂺59% FĐ_ %Җ()&KDFC"ni0+e:ƕ Ź)r% D`|'iH3vу̘#BXBsfqK&lErA .d9z 6 kOq0sC ?ogg#\j=j;Zkq|ǿn_wן{Adm-XaM/y?o\-mfubcX`ߟ͝xcV ƈɊ],CzͶr[W]G?5lMC-mAfnL3g46ג7-C%gنtk{[Tjj[PuC,a0x@oưLo$o(z|; ܧ2c:s*c?0EES4 b:~XJh+y<;mVn0d-U"h/%b3t/6θޚwˋn|<_I'Ύ9)䭰2 ĿP}/c8U'O p<ݬGѹf8=yGP$ &HK:&rF3&݂GZ,BKMW,UFGϡ$~Vhß8#BZ<2A-hX]ⶽefC]I W(-#L;,gd 0{~@EϴY$t'3Fbb#uHZDCPމnkك@TW9 JPÇh7r6" lA[Rq pBظJa˱9S^F Er5-I< w ,|gdA{G ŖTAGZ?iKJ=؟7Ba'.>t\I8:r(oYxK4 [Q)r)p9%@޹Z0訝Piۈ歇(Ζp#@h!AlW[%9Uo˘5 Q1aMAϵǑ,+I+HfH{Դ3X*(̤ KT^0QNj CÁɀ05<zSFވ+\gٓkit@mUK"2+-39E h4kDF`$F 0i!)d_VDNFC=9(ETy #cŨ4>×58pR]v%‡&?$w>\.yy!KԞ=6ڇ*)7 + 4_&ё=\b:x-xDj1GA%T5Z0m6%bqH5a[P!(:` vZn#6~P%]QJ`J +W/䄦߈FwOݶ(jJ<~GEnٗG`Ϡ3&~B%bQ[o4KRb@&B"-OdsnO ix6$vSPV+kF-@F4-Rd쉬=J:hi -ˑW۞2 hCg{sL(lgj$6[/} ~Qo!eMZC:{}$A>HPJ \1Gvx5%T1"_F,О@TuvE;L 0QPQ&}f{N<*k4RVnNY\kc0JFv!0s'"5&^DQo~,248kܗa5zO%vFEg@<PypBhRI&DyRSaZE樓stYP7OC66QHN@RJM)M; Tg?__׸v?ٮeY[~+d/t?_Bg;F bQ&@sSׯ貖b/fLA ~߃NJpKz/[P"%[dO/24:E>~ ˷i9 Ty~QT*4L9J`'ag,^l=)VjK^Lm1ily8l#U[Ԝ?-`|C3\} Pk\|&dXL*phB6t!9M$et>6:>,}u0#8h z)&q ]:6vR5j Uǝ˖d /C%4IRru@P=/$nr/+W*u-F^`w'H+=(xN׎'wmh^@ x``tYh-SPR)ì[ +8Ѥ#V146z >t-C:>up(V(k 9d|?*}Yn,-t`0O1Lx}{ܹh>'/ޙ|5fV9K4Ô3ž R~]І@G=r0°AIU#JQZB>$ %šPdxgvs6ϖ'|ѱ@=Z{Ul&5-9O -ݓ#›X<* OtsD<$M'cMљ?Ɠ[$LpDC _;.w@Qr^{g`[Fqx,>qT2=] i9"x=@7`^giMP㺥F`ɕ3"8ݝ }IXm'skֆLّpl?ed7 f}\"7|OX@ }^Iݔcjkf,X+Kbɍ/mNᦋjܡ[?݉U=gUf{$Uk漐'DycA>; *A`JM5#]_͝1FTŸ7>vXM5VCԷ bQ+ʎH_9ј/WčknɒN}a-&TǢ"M!2}* mip$/KIF,ZM`X"qEWnۚ`50NiC dï ky`5.ԥt(!z JS a,;1k,raV!' njDHJim6l+a;?F +rjTug2V a4qm2DZG%iiE +^fRIkCeZe,=+yx`1V6۲D)bMAH![.n~k9d)w/ T~iu@ aѕ"8~^"" n36κGoQCkS>tsiʜh\'aQ&{5>K*cL@ݾ]neV_^ ~僭Nk*1ۋohKqh԰HuU i:(/>X!*Mۺo[$2IvK$FMR061&e9T?^ h{>!Flzm]+%'Z2dNvmc]tjD!*Y}DHz  QdXS0 *xpn!['upKb2xdArUzd"6Nxaz> +stream +x+27ѳ047256Q0B=conjgif``dTd˥kA # +endstream +endobj +233 0 obj +<< +/Subtype /Image +/Length 158369 +/Filter /FlateDecode +/BitsPerComponent 8 +/ColorSpace [/Indexed [/ICCBased 28 0 R] + 255 235 0 R] +/Width 524 +/Height 406 +/Type /XObject +>> +stream +hz}\Seu1 ƛm +203@i T7sBH)c( +1j\D`h/pwsyOݳu;}0 0 0 0 0 0 0 0 0 F%ŀ dJ)$=fna P+5bDT[ؤ%/p G'$9. /py^Ge`H~Ǘ@g-$ +`z;!|b. +}eJ@` 4 ^\x0Y?x⓱>V/\e /'3_B4XuGX'r,`ň\O)dZm7. Oo}-[nL"NOҟ-ݾ#ED]RӶln ۳7]?gd_CqxAvn]x&ppx,F;9/"s \d!8X/!˫a, ?7yqQzd_H`ɧ32d rlzi~S3=,r9]n;3`_|cm +b>$ )4x|+Gb08@?9X^Txa8rD=Ҥrm^3m_. !"@ːkOa,D? kr tnMň x*$Wap}R?} q\ R SVF20Z%迎c ,XEђ +>G{C7|ȅƴȷ8sqL(A ~eWa[UzO..w Q"dm5`~A2O+_:"He.h~>%X BU $PG,v>sAMƁEkM|1D\co^Yg׾ϣtOA.xC>؄vi\l;.zGii9!|HKą+ zO|Wg!Ѕ"ȋvaH 'e!iQ[f_}T W]8濂 Eˌ{o$瞂%1/C|X?t2~;F>Om|L3'#Xi_I Ģ_e](;`޻vD(KWOoÿDҁUx9F0c- ی agr9sq ? /AA䍓FH b\FR?Y Ǣy y_{#ɂ@m~ kˋ3u +p W!| BZz`pSTFa,eo/V NwsqF;Osʐ / 1BP0SYXQ"x;\ny_!<A$r.ʋteֈ܌[qi[V{P~AY^Po\=3|e9SΆ }H ż/{P`mۺ` \yfp'%N쮉&[*86|tCo|Vs?=~]-(y d5_Ђ/[GE^#B8לizy;}wj`) `ݑ78J }'v\~h%Gt}iZ^-Sx!,>~1yz8xXĭKzaǖأȀ? D~*Ы3 !%ΗBj/ _mO.=\O܏Osu#硣a!X/@BT*^+bxWBi?~A>[Ԥ}On:m?("e9]= _e ")}!Aa'V>]vA^ +M4HQkuY*`JSr0B)ɳLp7&:Yc:"a\؞+g5wH)-YP}i\Z@h +[6 LCJUXɐD( Sc韃XSZ?c ob H``92-~WTU.ڶUUUD-*6kV'C޸Cnzv{h8 +#\hDTs?jO8Lq`ɞ2=Yt'}R 2Po Z|Ȅ=\Y3r;=o{27~C$];!q-u$N{387V oXxd)2O9' W0+z7:A.g y%|_p46dxR0Fr0@.c{c8wp ěZTqz]HE~>z+^^ +kD>%' +bi(p+B$>zkQ׮VG*"yƐο7>[Oq@Qghc)/l',H 0do/ @Y x62M!:'(ɖո0\y+C֨}A b|~RUV皶;I3e_Y ƟdgH3_ON'''WCMNƲ1A%mH`[cP(5rrqa{Y(p 0 LcQkf%΄) d2aGhheh訵hV gQJ,5{{!+SSa<>Gyٛe3 3=EEGF&Tcfy{Ts0nt@6NZWA$w2 !t̫3T*eIXc@_ĐLϤdLߤ„O5h(414+s}^xh׆ٱB1H75)%yf\bt2tSU_f㛼CD5\9uk52;ʦIntzjV Vcscm˸^:g'V9 +Өjןpl[{oެ 禦b_.1*N+6Yc{Sr`$j>/W(*qZRCؚ(X*$-u7ELZ̘DTX[P\9oaj3s|kQ+(By-4W f +a>cPP:@c{\H)Q `}bZ %ZUSg45n^$i„Qf)FoSc H0/ȳ+cA.RUgD"4c"\7bNij_Kx2o.Žp,a\S|w9n^v,zNL_(JJw{oI {?A55 M4&Ŗa cyUqeNcmIBӓWv襤$ (S I B +{,NEmvbf0.|u$8X3%M̦nD`X@@x(.Dο}'vQԽͺΠ(.T-) rbr;S"|On0&ޢՉuXVtxz…;V@}f HC&0'T{?B o x|k.*r[[9Vo. +538b4WSU_;wPӥ1wtvj:!\\$WVU"Vjb]S"Y?Uu4juWW9-Uy9qjyLW24`ZSC{;3curM?IsDZyR՛-'Eg 0څwҤ%%s:*Hw S*71aP8 &3~& + oJ,j,c*Kz{zyŃ)c^M@Y?"ك/zjzap Ld4jy@`ٛ(`kW]] ++`;F,78# +Vsq皪 n؊҅t~y =w״_=Ǩ\LoSتV :\2L!;HRvNI-\vC-Cfyfm 3q9۷8Js3gfL-H ( & N;11(4Dݑwqk LcA=YL%e2H_DH5:hdHM_j%RKHuEQr[d9+4dvZ& ͱ paƶ 5qC,$f9L'(;a] +'ڻ*** +*fL2θ[CbNθS3&3}54:0( +%ZיX[?۱;w:q(;S:;l8Ju|xl/h.0׈{;Bz; 0K^W{[T:]c,|_{w6ْnhFTHӺtJ)Q;c"(MDה4bMːHQwacdSZׅHﭭ$lv75 U&HfƠ\Ყ(֢׃xIjsoap- +2 +LU9R_ADJd6TFUJD5֬i^^eUn: +੯ZЧתlzDQQ}jF#MLdX|ɘ2ʉ⎚ ^eyyU G٣+8Zkezqkg!z`8=lwGi{M +X#L'HP s02h~ӈ!dXS_wYm2dtE#٭OT +FzW7/ɻ XN&DxmמNRg;YyUם qXNT'ljY$2HnYHνREoH\DžLE&aapwwSg&aC?4Y0WDM))B5^kw/0*]^,m5B*%ӱAYBߦX%Q]sDuf@<-lNu*K֯ɭ#qm5m!f3;2b4W>{ 0@m^^U>Nj͑Mݬ^'Z3d)Y5H6钩s"DcJgC$nU*AR9$ΞsB7Ǎ]3yQfLmVx§8VZ?Jc0xAI4&'Ij:bqg}a$Ԕ[ЅrqT 1>(׉M*AY,9a^V.Ħ,f:I>e2@ :dqL' GyVU P0JrVv~tc;S V˖a`n`?<LͶ + !M0cBM,,||"{ӉƸƲKYٛX2XΉ%t)q IF,Iqiba S+XYh4Z|?P9,:. \BM OS#>WJ;$MSRu>M&T&k"ӃCt"ZGG܅Z^'HEi(\.0.H4ZU"S/H`"j:ښ& +nWCDVGp8<}cCͮ2uFq od $b("9?c9ONb6)\(Չ\0L.e` 2V7vGe s1D@b["I8摭DC̉J?ctÙ%$NO+'& _pP[j 9pzvxpbHYi[[iah`fֿ=-AR_S@i[{wXvmv*)Sg:.>8滧_wD'WsWSz}Q3%>>z)Z><E^2-Lڌ҃wtuE\b65">_߾r8h/ACb$d,aN";z@ H@W Ś)QA<%QKp;,EBͤ@*"O$PD]JOm~0[<[S03Pڠ5:Aǃ3͜p_Dx +0ע@Zk) Q_zz@9JKJUI:Bъ%u`zIG'TܥupSQL했㕉U\  2VXR;Yqwl|&C\RTs( L ϑ{L}ga +![i4  +DƱ1`[ JD UtuoIS2щ|t"/ Q.jR̼D>z'9tFolŀ8vav%pk`w*:״^(`}}]O;q+\a?#M* OmT"qHp3%Nt\ ]}tNDA +$:@!אB 4K$U(e`Ui dPifhUNoxs?c7 z; +a3)Uֲݬ%(>1[dF t%`YjYL.LH4,*m|JP^לQiGnNg-ZUj,["I#*qZIIlf~7h,(Ze$uyiocoj7$%GuD /$&FBD$EԐڑT:!VKD*z +F^b_~ 0`޸qę=U6,7Ӧ*ٛpjE‡(c*AjQT"mt/]B8Y؂Za[.6 +U)Rz~MQX9 [_~ݔQ҇x59Ns׉s\.mh.`Ki iŌog?Ftܡ[iL f231F| ^4>ƮS6VUlqLfO@ #cG(z٥5wa=҃z.ֱ3Lxdjj͚ +e0vGҊ^ ]S=}cgy.]˷]1Ԡb7Trו6RZ .ŃގTn㶌kzyo 1 "z| <%DjURր"Xl QaUZE|1CY, +n![[@@K1V +iM3\*x˂D>&`'wl稚ɫ(~#>.Ŝ~D5mE@}srGPP\VwgTWyQ nI҂zĤ͜J*T!>R.j04ySSʪvs Db˹Փ(p|٣MDuL* r<him¤ 0@'*8( Crj7$L"=F$E"gH5MmE肦m< *f[: W: +2Cv(kxN +:]2/lӏ{EE}w +]ޠ>hoG.g==?zoڀN*,!쒝;rۋKZqlڥcs7^%(x-~x#f-nKd~z}4iX!$1@1gXV>(?)jJQ>ә$ff5[ .KH{'7O{5"f;ɝVC0u2Rgp/(N: D#ə,lpWB@^~Alzq5kG)~ˠmU@͘ohfK?˅2v1Dը#~ޭ<R35bQ:<\Od"Y)?ԃ}ЅW2("DD^=.*С-90%mS; UDI]t 4&ˆL̤$0,hP|E=c}>IxSngjPun+^Z9na*J̕`QQSZzg|šHt Kת9G!O|[ݫyᛇ /l״u+11,ԣFa.ح"dJ +Ul=F(%;-. +Cy3fui>5D3Unco4px62FU ~=$MuCm+}%T9j-K5a/Cq+94~?. 2A0F\fzr:ÚAz֎tJ^M{ăcc# 7N2Ϩ9+TdR^JS\96p|G(r\I9+/=ͅhP Pa%-b4#1ݺ8;fc".;N%@;dlx'|zprĬLO +$* L4Y760TZ:;*Z7Y2tw9 0R u GW\=~_my{N\.naH9^9 \龩R +Y9Y +ZOeiQ20sV a}ϨGcpڤB̢dRBJ%!2Cd ѮtnYbh2-+JlJN߽/?J1jRP$vݰ &,nlqvYyW,_uAɨnT;À"jNtlHXniq^5?nm*)޴^Q(ADxnuW՜Hep3W6<+Bnk]S~ Lxdbΐ8/Z9%<9dBe"Nv_ȁ& Ve5{ͦՊ qߚzӛS_tԐM`]jrx;VWb(J^=0hj8T{Ed,kuSRXw2*uPw IbOR>[0Oc9tPCUXP9epm̉&'[\L+AGHsII3.kuptbY̯А+W(eؗZ2J.D*&<ڠa JJUds'Wm庼Үv߿\z?=RR{3^\p Kpphͷ.UWI/O/Z JWD,K{~̅:[t&%QN T2y2xDhLvd_cϠ'gm޶#{=A]WZe؜y>ڼ<>=A̮w=Z/HC?}緬6TA'a+*}hTrP Zo1>af!qԫFMʰ\v**JV]jq"^RGn>k;Vf뉔kεSܼ_t,Zy_z${k]u\|2 FA{sK$=+ D3d}`o(?\|&G[IkھL6^{5;f-6.$:{Fncᣔk+e$!ާt+ܽ-?~_?yF^ i6A fQhbEpv,ƪ;'6e>9;p>j׫C%[ﷅ83'%V/ gwo~,Dq?xwĈ hX tPI3I@Ȥt.Ȍ8=0LkQC#~3u7A{ZJ_s\g#7)ƕAhںᱧuex[{UW45 *F$P* +Ҡ]n@mKH )/t.^-@u#٥LA{VZiAXK Q%V@+(`!ݼ6ȥ=Q (|qի۳I`ߓhqq :|BIt(: ;e| dK?~)~߉'"wxV PM$oo,S)kP۠#9P3-!ΛZ+_}nL=wʤzAԫ{ol_ˡOiL99rco3 Uw<7?o*oE5 PX,  +r$j6h,ZlG:H`u;|Uq>$蛘1/*=OzO}$tcw?>S $ 1*"&{ +\ Q-*g=1=3\uNP8P VcWYl)D9IǶw.# P\?>93?gO˟_ρ SD3G&ksIkRo"b`H{ +>ІF8 ++3NP^}<ԀHuySS2RaVp3D'|eI iMI\kiO_b"^ ;IJ7^|#H@@ e]e.Fԧ(uI\Zm'iD&2Pom=hwoy n}^VBCP{A&jK;^lVkL>ZA=f\f'A\F^Qn QiLj B@:0c.b~V#69=0lcJj۠7QkU ̘Zeqwn$&cmPmQ7^{mkV*J53 +wK䒻ݟPM_hb?"옯n_έڧGfh  @.mP %tC%УN?'nL17o[a@c8/d[G 298'Ss=ձyΞ"quvV34 +ZNk/YS<_W{JXn;~3/K\P +Ո^;YQOR~c+mYļYN-QLKvnޠmS^+W !r f@ߌN,xUo*ʌi%fLlcNE:ZɊaݬ}$j[lS݁9\_R_<~߾O\o~믿ף6g~z¨3'4RIQIdm`#] ]kSw*ܾ}_ +mo\v8RgPd`^w;k=ssRim0{+ +Z*œZjnPw/^g:zЅ7<œ]AcD5>Yl僸'0<a9 5=(s|fm>mWUvwt?Խ}?;TWTTΕ+.a1²d,$Jy|U +Ťc~SԪ8 7T^1N A>Cu/fZ/NmSԘ"̻&ӊ1$Ȳ>zfs3n/ʰЋ`K*9Gh]Fma_pjT:;$~*i羬@J3x4K߼ȧWId[7SQHNGb}'˷K]AATbgn-F<(UW/8VJI FeFe& Fq%s&=\I^~|i~%{CiC[ά.dPػ|Eb6M9M4m('|,x+!ʥV3:B˺itq/ LE콒Ș[ki~teٍ&kP c[;a ԤŒZu ;[`9AQgUP u\=uܯEZl$R2Bq %a !< m T6p:m_enXzVkŝuYy|k\ߦ{!*4 ˠS]wN-cD +CQU;BD+ɣqV>go6q3vNI$TȈ߻~o3=C7F5Epn)wD~uT돏kr : .\e$y7) >)`ӄ2x Ϥ1Tyܮ sf3ug.nޙ*ll'_ww^gb x5=99TLO*$Z:>Df,+}+!9j+g7 ?ꩧn?< +_tj :'y, Rx6~Hb@q\S6x#-y$Dz렳:odjp ++.TwV\a/j1`X4Q,,hNg+mҺ! AHHT"5#ArUs.kz:x2k4w:;;QojsZfwWY9=|[*s D~N~?y}^YӸĖWqx\=}Nyx]do9Hq9PTO~VK_8;Z7Wuȩ H {_] mOвYZZڴ=k#[[>O?~& )w5^2%3Jc4v惿!R#UI~ٻzh9:7PY 4tOzN%^N땸zDUfz1\tĉk7nj,aK_cO_Zz@X++ߘYVj DiH&)<*gەK*Έ:1_ڗñSϯ ztAE00vAz}VjAIQm|=ɎVBכǿ9r7ŵI Oq8:?NllXnܘM +$No,UްL7{Z+|!Wp1t~=T&猥ܑ9-]R!ȗcA2%sN'g#GZʪjH嬉9IYw2r,uFÙV{}o0w>tpe:Tr@e 1\@ M]Kc}UU}S@ 7a\/Ez>hP ;S]tF\?rɮ}ℌ3[f +,Ssc+ P@|akpr H 3_}K&HTٙm+ _!:0EQ>EpidI`hU1c4(z0~h#+Ejt|uŊEbnPa'APak6$:Mb,M[== \_v9B@>_¹LQ.GqcuBWiQ{t?_Wayifiܓ1?[+_vk]ـ#2na.Za'-_^QW'=`Z _%{^Kd )szɀUzfq*tY dZ$e|@䍩y" jnwJ;ϯWR;|c 7\Xܸ?1<1Œ븂+bWkV;6Z*`QF;/Rq& i + NESi}HYBrkM[b<E*3"-8kK5[tPk$#Cn@-K}{NL${ +T5PH`"[ڭYQG z; $pV`P +6=-GOj'yX& + 0OeliH`-%ȸ1NC3Ke- eLt3WOؙ+ ĵۛ Prl"c'-eMvg­rP~݆X*W -AP:| >,s5jJUy %4޹~G k9;k9̗-eup +V8 =Z +xaïMml6U;bp.ER2lNR#Bs-{} +&Ɖqn* +G8%d2C+(rEi[02# :n'>Fn-$0i FBCM{ +b50H)/Ba,0? pCD4" R+NGCx@my\~}{-Ȓۀ*?`~ʖW +iLcɁqASCmSKHM'턮w^VRFR7&3#`[ ^{pr{ysavm|V[U"%u^+n9z=uJ6Vy5WG"^Ӻ2K2^H?LI% 9o|Nꛚꞡx`T*ayEaP͖IE ٥syV%[莬ÌczTZATO45۞El$+ + 0N:08s*xgǛnso(ndN fwħbL΍2Nń!mc2F(htl[Rp SYr)hcS* tk`j(s}{pjGjb<5@:u}(866^׺<0cw__])ڵsvt2iOn{="7` <ܬpig|q~~1gϣ4$Lb'Tv +xJsW`FNcd%Ea +,rXA%;f8!=>CX`m ϵWUBP$΄ޛ?nm^DG7{t0=O+'gJfg*ͮ<>)wrN֩YގGsVOdζ jJK˧66gr+Z M%t.j4 1 +\X׈j.a; Zx4 +^̠H'گef#m Ex/a_vs`dU~ŗn&HeA%O7KWgMMv#"@;goq%n1jQ<I(}'0M!sJ냁 oiWo}|%bP`؂Bfܛ$>w ^>蛶vw 9lY'[x{`BQQAr 䡴Qhyq"PqCav>rEqҩ~L嶾d~޾Hxo&s$-_" +˃3u=MfDgw*F^.cヤ5.w\eV\+q%t:^$)(r^VRYFB#W'tn4'$d&;rΝ;ЗROd'b0=\:6?1aUˈ4^tr \/pp,GpݺXj3+]N]$p}FFl8TFqYp2'*N4O,!"MC!Νauror@V` +_͸> )^Qa SH]#Y'HEFO LTwl !&#^O O$o4!8AmaZ ]b 7V6]b6ڸ"={rԼ#bz sNkoaPle֭*clL"+w-U65ѹ2՞񺾱yzpjR-QėH;4" 1ݡD1۩:_[qv*RIDJD—c^y(&f_ڳgϝ;{ I$@*wo|:0]5:h">vᅳzFeXkݮ>ةDG~F0DNc=fkhD3y8BGS;mr hBHjPqՂP |0+tu 28Wm4X͟XDrNh~r} Ybcw3"ɀ(NZL!uMxjղ; nlF(&}jlm1__<0Pܳ8??Ѷ.+zUb`ֺm'!/7}g>YPmM +(:=946\t>/A*G`Ύ 4nn-K#t?=VcݠTh)8#bOI..̹ ANtč])qYӃkť7};bvc`/S,U㏤] x1nL)3}e i s"B(m{~]kAXjy47 +ma0s6,D!-9%]d.:0&M[0ı#etWL418aŹd TYi* k8 "*>[1[dQ6ƒG6WDZ }# CʎS +U7:6T:\Gɷx0l%ݜWuysC@ ߆(A ~3~Yce--!Sܰ#81?4`y\P +ǔ G1/ӽH,ъUN+{yVwr:4PV=KAX9U94?&efdĴsl'97N'͖MOXe}j+g *^ŸJ1?5>>5P < gpiæÕ0lIO"6(un|1qe ')U)1zȩU#d"Wo+K2xz[eZ)&/.pbO?|OWϨ7ݷT7.yOT'e?)U"z]R9g`|ߘojW)'66ʖ6J[:EOiq"5Dt{1^^^^;A%拹P鬱҈n|j)n)mc@%%rr +&M?v⡌f}n`nl1VZǖ*kzʼ B)zFO'Puu T0DIJD d#9"E)s6 #*q"[a aU5*F@rN@pǩ l!N V#8EL l:~PT.i +L,>8>4o@!)̢0-8֊!Xf|.Ao|n =ۊ#"xT% +Yam?qʴq=ݓrQۯ^f^>=,576*Zʪ~}{s3ϝ:bi[Xta:s- u}oqfnfq>[c jH䃍ɸ"D{)iHFrk51D)_9ƶ_|dj$bP7x_K]y r&C&Sv\ϔ +kjw9r=:TGxy%iVu:KUy:9񩺪Vq.Ҧ4qȆCQw<{ښFNIMDgoc0zCxa 1Yr.b09Oya* UeTuW Ol,MNUw}`#ĨF3A>r +e!kRԼC` +=)3s# el4U[ DZk&"p +4F(AY].MA-)e^ ];$aA쓙%B ;gAƒBtpVVin5Ud"P7Њ +9S1)8 EBv|2e3DgXh*$ #2 pL@G0%5j6(xދWyuykL"ŸV@qe*N".,h`KM@Y +ڑy\.@$ aHb0+_Ud+vJ/($b}w^cԛ ZopjBھoꂜK#/g1Ϯշ8Z׃mC@VOߚ'n1^α]U6R 'fc/ b0R'2`sS$P X&ɲE>SFl+aQ bX9 8;Nl p3\xub#&Dt +;R8h4$'1m˶817LB(J㓄Kѝ0]}A!IF#Bi>W{5gُ.|oa(=g~‘dNkמ\}(~3L&_؛VW/}GidTSюYw[#@ЋySb*wLj8 CiTJH nWVZgaJύTzP?TnoJN @Wjĺ0}hM1pA"h㨷%կdޔ>YVhz![2tVB nգ'Ԗ EV-椈4*}zE>跪{FUiE`*;5e@~i5^f* I$(ʁ%R9lf/ԍBl8#w??x[=&ɏ^{W]ZZEbnƕ|ݖA\xSWKwgn悁.@"iM +;LX8?"&3 +<2X9Bhh4 8< 4h"b1\1]FSoNfͽ`pLMHMQ\(Aûo?|DC#vP  |znN|t("X$YwKI]҃8! D ֭GUVD7e!Γ¹h]E&D"91H #0bUұI %r.4ke2`2PR@m?ODXd EC(7;>" Nn=n;U:6G}e @U}719:]p/1/}bqG/&f>l|{b; -::off3f4aɬ0GS( r墇)q2y&/iA(3I$5\08H,LPdGcVp"b4~ʞ,g˩gkjj2nM 'TٴP_,vTfdPqu j "%TI +Jaz +4Իy1 ջ,lA Ad$rlu-jd*wq;%*v2/@dǗևg'gМg9Zۼ]֔z䓁W߈[||G +'?~ⳔD7?=uuݽmJWo ig+L Ӆ|1&f&TD 5n[ss|B&\X`.p`#0bbX @fD %$Y aMV&W3F6/%\;wVAAǙ {E X̐rᥢ0mUʶ)Ғ3I$vKq-.";07gf{}6gspߍ pmgDoPud(jnTq8\No#!ɥG53%A\^GJ4d"8"#ED}}d N+_=nCb PPu=z,U*hfT ڮKl=$d؂FO R*-Rx*`]:M|]n>=Mg_}۹J[^yؗ $GI[O!}({{gG-Agi// L3Hp{dYuT0;%z; ۋ&̆(20yt t Y:L #'Q0XGRB9 Bꅴl<J޸tv:YP8# +tQQjW}򚜇Ϫ8P*&Wym4o>u$‘(((fP`Dܷv0;ۼ.ߌ : DŴh:] PIՂEvι.uhMdTFeN8tIQ'w K`e"*Ww*6(Ee}^M H\5E<|A1 E-A#s^Wn xT >OJ|ykjerXhbW[x'\uk5z%7_sPɺM}9o@YȺpE$hb<0 뷇ވȃ7A{b!\e)0b h8ޚ Rۗgfx*ʿy`((8o޻ C* W'6.W]/$p_|bٺ뗖5 .MQ"~HMt8fw0XE)ӯQM]A\Qg46ހj{?=kҪ"9EWˇen6 CO;7F#[XyG2GH!g/H`v +5},Ț㯯RTES#.$tPinu  +҆ycF֬_&-{F(JJlM#̏O~tTyMm6EOT~o+ZlePř$D1qܵ{% L1?!lV^.k~Q.H$NiD: +gc4@7@a8?яzŕŃ_5fѢ´0P 6Qll*{<^q~ ȦFƈUy%o[%c ċmRLj@9P!=jh^%"뗡网?6#*&Ntd.#(nAQc~' P4JNCPAUsP\ף,5VfzDF5POwye{{J [UO.;ʣ NPӸcgOU6|;}֫dND:|gjDaḄ;͇T/˟(Ϭ`nV,Ti& $@(Wk2uD$b*b@yfs3d0 x "ȍE(yFji7ǧ=lSlB]P"UǹȷVvu|%&nN'غb~GO]EI]V@"ͰyBγ<>8]oMuIř A[U018BD28ev +hfS χߖ43֞Jz+XR*6}5Cav;YT$jӄѧT\g!JіPK*p׵Nc9軀OM9;zZ4ΞBvp0&K#hk;7r!\ŻD(5ճԊJ)좊n E2˰K0:Be1qEe:>oAeD.AF!8B>@ ?=!4X2{ĪqI #.du>}{07J jl*T^*]r5JSt 0oH]PZ`zS3P3=پw/:͜?,h J~2V}uG4o_]IShZoFHe.YHh5Z`f2<@&y0򄉤(?҈D"M3 2ǣ1 9(LbI,v RKYVv6ܨ̼N0AۮχRhÚk7EXHM-JڒXӂ5{1?dt7,a\6$Q +)Է62z4% nڂ:ipvaa3SBzwD+o\.Ws>N7i{yL隗 JUb?fJ%4֭iy&,m䆃Մ[y,* +K$mإtWQw;ÙY| +k4iDűK1 +'QUN {mrdv>sXk77o?$jAToUAgRV|us3ωS>:m+M +߉d=;]39' .$ȸ}?sIÎvf:I BΣQQţG ǥ1h$`q<F@av4*Rآ}miϾbLD-Mn8-0T@{_<UUu EEi7n<QW\/杏c 6XWb$ + =Dî8a6`H3ϵ j}OjhtIGKx|#4R2T2:ؔ):tK=TY_5мPՄj?OK/Zv%M[tP<;"FXfqFN\9;oL) ʠS*S{;.v7M N$R-Z:=2u2$AJY߻m/EᜇJ-vۂe8VVu?{5PELpR}.rjT#H[9a,QJaW N +ո̅Y,_=Kx846O +V;;:gկm K OZZ׿|GHݔ|dp_E<{~&V6ۚ䶩m;1Dv`ug:>ᠴMn=G+M{^5x}SSGk|,R_ܺ&4T L!@^!t0BEغik$fD|Ah9f6EhA&jVτ9(,.Oԇ!BYk>2HmR CV}F(!p4@QyDUm2tUx"-U|7/zMkKխ!"A(QP(4̠+#S4e zy%AY0zNfBi᥻s@?ո[קE\*ZVF׊ WfQaznPh~)lt6e]-*s5,nEמwׯmrA!h;oꇟ$ +?_R~ l):55 žM/4O)lhP :ކaIg35K++ˁ@\U5Fb +(g/ϭn%ߍ{ܽ<5;MNOszw*d' @fWZy Dyn0bròx:Z{~'~W;yMM‰D}g86H.N +߳sF}1( OH-дӅvZ=cmL/j*Lo ʆ/AhtfTTzס\ +^faq)v9~ *ږD$.ZU0j=Y[*>"QY%DnEA`=36-svP2G|>5|@D]_ٱтJTԫF2(ߩ] +bsURtFR/x5Έ;B0TF"R{0^'2tTCfޜW6 sIYL #ә %b.f6Ia#L} J+C0H8#WVB" +Ort7P}:;D:hJ^riIEat9!'HWsn+^T~ !ų'٧V7őla.EL01Q@s$>HZEBDd6EF؁]w8IGAI@!' +r`*&pddE|  +Kb"H>w=hE"$AS#mJ9Hqb1zƟsHk+ӗ~~lጠpc#n^[,ȼt1Ѵx`rMJ6\/< y(׳U_ۤvJ~zkE)`8U6^:ãP ǎl1]meQdu0)(.%^ ͐h5hەI)cw !*ԭuSƠg6ЩjkI>mw5.?>AEkta͙{{wsR_aHNkiq%! bfFfzʵpAޱb-d읇99Ԕz3fjxiXDDl%w(æ*V^T@}2Kf/M%vDǬDž*˭?x_7{b?U)%FlNdYMCIcҝ骲Htn"R!1U;ο_D~^JYu)oU> +Jx{Roעӧ L|&L@d)Yn5=ujӦ]0:3lͪ;Z?hi)(Z1S)EU!f OshCOD([bwp>55UqEB57ASד򥆦\gHhxGs=E.JbRžKrLf7=|PB!~2~)Hu~}]aX*O1}y+-&7~s#mjdw.#tX + Ivљ鞽2z|B0{^*W$71/\YdKx ϯcTI]a^CDt.s5#CJ]h_)o̥oMxUv H=޾_o/cJw8vVnWW~{O3@5C˯ͱ9;Wݣ^iw4ͦ-i(@»IMfІeh 0H^iQwNk֟>+ylòS+dk|L`T}Ux8|bXbх0= v+/___ 5nL܍(Ee,<]ЌnY^˼[#@p1z"yD;qQ(ky2QylDP%т[99}CuLZ*`6 b*!St+]Y5sKr_*5i^tř>eRg,1=8z6?.KQ_,vv^(|ѶlРPж@3N1K@*>~۔p?T~Ց̪;5؈ƹ%>Vw~r܎¤Bb ÷z}:>w0 /Yvw4ʕ^H94"yp U;Z5 =\_Y'W"gaC™jՈ;C:r8t.e.Qv-:MYOXxfH繒nC1Kk%`j!ף833Gӭ hN 1blx;KG,wNKyqcԔdADž6%ݻqiiHl@D6a&S Bŧs&I[@M1^] \¡]z(yȷ΃F J@:CZq#-D VAGzAjq;AͲV2 8~3(,ߥ +D.NJ2ߡKv@z~h!rxЬ=,{a1H?[lNj[;E;==k*P_%¿}6Lvʤ{;^ZrUasI{{JWԼmtj4"fDEC1C"H>B9,V5>-OG@ +HH)<;#x!|ݙMkb(( + fskbTKxP4:ar/6nBD>ok~¹lJ;7ڠ)-%F%q 2Uŗ oS y guŀSⵦ?%ʴ|*4ƍ/ K]]2V|$ 4âUD4∍ H V[r#Ns AE=׼aIӾzmC%6W4l9̪?})5_nRbMĉsnX%vS.ÖT;]x ĭNi]StPvؚ%ٛدpO?O=ehpDM5`>Xn^ ^@)R>O|sԲܓʴ).[h|b2H~A;8hҺ)ԆBLfkjn_21Z+ `&|p[̤ & +ic!a[2o_)Wxʍ)x%fS^Ϣ2Bf(<_q9exU|T70$^2RVm⧒jK]BM ttGנ:`:d򆒖~4Q )?k]L􀝧jixٸ ¤Ʌ"0 Q/Yz<IGf]]‡k[`5eݫO<Z:s"#4 +*k_E~opz)1Q f&}U[45qѳ>jhbcSYA WΡӘ`ަuj\8{nǰ͉.vO +5867gN HՊX,ޔ(x']'ƌ__E~֮9(:)=5>yV}>M̄Y̺v-OpKBp㛀*vb |x<]m tz +FdjRhWƴB8f9ȫ%yve>U;xhq?u&C9A%5Mւ\__O*kǂ{[,?lqBJm4vvV +5HLZohHD1"LdKKz pD=Y_UwYPrEԓ&* F,d(y,G#pD!:>^fޗod +P>g޲n :%9BL`!:*pFT9s3MK=RJg`kwSSz~z3uH/^ 5a5ǯ0T^T?Rh{ ygm)X ᬼ9"^5}7&.~ƗGx/FwM>_ k/GVhtB`0l]K Hzw̶H\[wR*>9+iJ'^ kHWߢD TT҅_MjHC-k%.fѽ$o7.jWc9tT(]~Ci]G6fte]u]_-uuwwMbϹ(E>ƹ|;Gƒ!1⦑ ͛h"@O'nHX% B RC6Xπ3/(rnjjbe݌j(.Gob悪Fa܋ҘHzqk6ZƸ lwRQ&a@eK{{BjjAVS^RĶ5`{pMi=pg`*k _̱ֆbwUM#=C<6}!յu*7 |dxV$Wm< 7 X,͊V2bLbK3$6  +gIՍ+t?8HKJ>.m1%r6l@!`;h +XF٢85nFM&ٶj{US!){2(O7FrvN@c+T֒C%!֧SAg,BuE=eϢ{: /,:(.$0c(p2z_yF"3X^F:t|1n_fe| Dp QӴe4V@ ƣ^0N#P[}4#X{ Jp<.(UJ\~lEF_Ɣ~zYmrMګmX+L&b芭X\zH6Մ$ɹC~ϑܵ +c:j+˙~[Íp;F@WRt{ac<ϙ<0//me|hLkujQx@Ld&zB"YhABvCiQ[uˆ"onX2@ hAKA "(T'qKdK t% +]Ɏգ㖏DŻEl6CbH$d|YޭO xVK o٤Hk "s6U_O8=" Yne?91,VkEbNɹh6+dqM8M2/NĺcV>uH{; i;_V$1DuL9jX~ ^Kf$$ֱ X<(u~|Qӳ+ O|,A`xvaJ(Ug{@*n֗m姱01 r z7_/%yi( fw + $ FDP4&_2,tL.g.WT R^{uI8RYD ;I&3Ok*~iᐒP ;vϡUYku4Jq<뚪o}pߖm$hN6^Qп#ػ؛ͽ]Ϫj&'EB!rAHEh}3 D Guݭ_~ׂ'v +Fӱ6o!ͶazAUKf]&appC_@ϭEb#b`Ȣ֭mVZٟUIVyV_ f"? jN +J6q$(5 k k,w? +95GINsKUQ}wnqR^t + dž2ϊg ٺuy4]y<233+.dkp7n?.1Lvuڍn$%-W<4&D lSr}9Fa"m_tjɜ|X #DǏiO|g 9p1h+W^/oa +q;5˫<WwAWP;^Mα?^Ngr=y+a6I<ʢ.R:%*KU16TZpY dr*b6!觳i95Y&7_zuxzfꖖk$#C Ε}xy6R):UQ /=Uȇc 9bAO1u7]]=on__`K}׿;ti +*w`~gt30z1n6|>d&&g`"!Mg`zf @3Pt" +"da#nӢD!<ϊ5m +zLކDdbKv1H$bb2K& P/cV- EMy}k,`C#=ŵuXȳq2WWZ٣lI͒R}}C:C͕̖-o?m?"ό\qɃ.Zܰ[{^gx' A0;j!UM6(A).Зeųǥy@&1ITĘH$zwh 0WfҺ1ZfM%rᇽc'G:c,Ca+Rҭ|[Kݭʣ,I`?|ޟzxk+;_\wl?'~T%T<ˡ32I`HzFB`Jׇבn?qGbg ڹٜpfF)tfÁg ~Ì:Tpk7RSdۉ]U_q4^=bKWZdp.D6d<2.Bc[WBi5!χ% HhC,LH4ơИ(L_SKk={} R2h! +B$@@&M(w$-`xtS0m C| y=Vq:+Su5%H@s 41sO-jz@/7@ㄷ0gϞ74SjI8%^§q˩mǘn5muDEY>}!e0*ތŴ=knY9\Xќ)B_P\;XMii` " 40 &5R^p"=N`0`2H33vvli5̆Dη&Ф朑=@>[wK9bN¹AX6^}yj?x|[^Ә_p.RST,K#i;4GMTos .eCP4i +10AJ# (@KQ%F[Ĭ`#%Zbj+hY#I[29"c+5Odj uGe[s3 ITWҳNucчs -!_JbYz?$J9Pj= X9O{?l䜼 Ba\l`+ &2-ˉe{ة{1h[]zm@,Ϗ?}"Ңt62 " $<FJ'>,p@*@,bn+&=D[ÜZy'ys>EӸQ/R^ɿ*bn폾7~J?mIx1(̚։ MDGxw!]p;ټ ӘQ, ,m 4 [Pk'[j(4`(ZCm y6ĚeX I$"( 0A4yT;]Q٢l6it:!Ga#lpb3Sǟpo;/_˶5geM @aQbk]Z,z3fۘHdNq??HGӸ_Rsu'f񓙶ec'T\N-c{I)"-wW(TzvxcO3dc"P `[P8+eJ +fgg)"f  4L"aͤG8 & HFiLI8i:q͡3EtN"IӼKŝ涏.eV_m/_*dh<ZUVKmij0r-u!f{t%|_!,RQ¸ŏԜ}Q'1{ %|^fI ݛ敆֒ Z7 + ͧҭx;zwA]т֥֯<'$ivNӤ̥g$3U >ce_.UTKVoY~#O%b YexE;9~V+f]7˯=3і V]~mh $-*$ap}dt@C4dD(h:dӨD)Dɴ&3(y'O;@́,:;k!CH+$dࠦBD!0P@If q,t2DХW 3-GJ֧ؒʢyTvy$@Pm}}^eIzmu\dOsnnw Ej( ݻ NY. &^p|yvjbw5|wgrGdhZW@* ^.+r$SPbpї{A13wVp"ՃYYo۲ߨڽ5i `9ޮU˸Bx˿}OS7y-q +I+Җp7oDž8];&OƄ@'fS$HeҀc 1H5 bfŽܼf* "l$DHLBF!14DJ2lϮ¤ &DDkB2(t|NZk%hK W:;z ZIdxZ#ӱ Y[I6;.J*l:9PP<(Š>I?w)*|~B݋죸BSQ*5pX6ZYh?%_KqGMȋԫ&,`?i>YNHQF>c ]뮼]xWXXeyPAqDgs:"?-Y*/I#&BPL&2@6:ۤiBjtW1^S޵h]ܚSc$*yo0OmbKy'WoOjhսN(Dw jA;%=O(RkE$Qʌ&$IXh 搌b!M3H!Xdţ/.PXzFft&a!љ0Fbh:SqbC(4NBiCɢt%i8a&k3E8yU-\--;J Dl(R\W‰v"㒎6LtP.-)m/{K<7?l]?(zF>YH蔷[bx=?& /.zwOxN=sɃcU_/>5{?Q{ Y8lƴM{kuʷutp<'`2y\N' 7i$MB),I[h:#D*h0h& +ev kĢdLP80\{FNyTEԆ"'Q(!f(}^>~*LLbuVNZܪʾ{q_">5Ou M׸3k|HkV\z 6-I/J$ #6KeJ ݝoˎ4O\PѼba֒=voJdjoJ>}r={/V;3ƝqlT$wlq63iL 6 ̩Fbi_a|'5e\b-.˟?dN,^x0fT/r˃XX -iTȄtDp( ciJ,,h$B L@(3tv2D4(L"C,j4%2 D=3g ̴ϥ  +L7U ãwqZVwe(pfɣb/k&8U:BbRi5d`4P)9aCq 8@(g'OhΕHR +ǭ^`r#HGF\y[(ZuʥV<\ژ<DVww?U]nC,pX##&4:C,,_<媢# &CLZwjorxMu+4uڴk׶SǞHKq;1':t +;T^hR7쾝_xtv^vuK2}ݧZC.8V}43_nzр;v4S 7/"fPJFмҥ\Qل"C4DDڈY!.:%"|菢ĮSU3k[5mEw\10q7_o^oDMiwdә9P: FPad> XC*MQ+g^Fu?`'2 (piĨ7bIa0& 9XKhw].EB9|+e< uY/Trn)J+mTg5^p_s{:AxeRlP?"oXde_=ھ+VjvlwL#E&YӜ˽碠T96 vLM/_ܪQ-3% {a`_uA.V8 }o?<]ˡ/?xS?Uvl2 i&UPW͉>*Lj4,ni4!6W HyP'Ҿ.,|/Ǒ엟<{|vswn=)Y-Z/  ⮷M%=S$%Ĭ84D"'ɖؐ%HCՀ $8k4Ic1&&uxJJA8$ı c9ЂH+ƭS-Ued0*hUGKv\cY_ծRRx<>|$Σ[ǓnD^.-ޯld?}i*kDuњPVuSgC'MMkO #ZF,ɧb W %Й|z&]ZdW=+  =S@-\a_V[p%3t+Q}nfD^/6W>=7+U}&@(gӈ٭wYkD2@KXz5`_KGNݗO}GQ:7d_<[ "@YBot'0zLyF-`zT +&;Hq"AdFpk(ΑaLXa"&#]U:ߞ X~P|.LoǼ_mU$Ve3Kt&H56U}Bбx_!E½g" ~D761n-ה4&N\Ud`Qz4ݻS8yI*=;4׏.<+#|! 9S>η.ٺm|~gu13SW|2U`OnϨu1m歨\ި6> 90`{B$(r($ f-v!qH3P,>i}*`4X8 JI#X6eC%}BlM4Db1&dBWRp Y;K /IIb]Krai!r/< Owq#Ωp\xՇ|$CM =|έڟ 0L-+|QwdCڍE9"ލ,<N2ʔN$͎;m;X>Fk_@!#`Leҹ9pO_\fAhqUKV~|mA3'X\6g>8TNƠ8i"L( ˡ0~e"He˳5,FRlJAf1!ҰX_`eS(l6Pii'AE I h0Q$Qo5njLd+t-2be;Ʉlv1%D!;CcW2",Yf]ZM8Z-a؉Lxq=}_ +VN10>rآOƐ 0C Ŵ?Ww<>+ԒD^,V7X<⬷~^xݿ+wbdu$6 R+緟Y> Yw:W\u0P|Otv5>Oqj QoqiܫI'bƋ_0Ο}:K'gdq8 8#z4ńٽ3C@ rߦdcnVeQa<=?U8[[Ez85$=v{'I'x# `H+z~2r. ܡũ22) aД8&Tު$}$<@8[շ}be5zP# yl!.c&+bl&+'&AVTu0Сlm~wGw^d=o8 GgZcz)gkQk  G.(jyqmM8!Ut?I./hOM:k3ZlPt+׮ ~>VG?Wkhy)ǧvx5ΉGUdg*YYů*e'FY(HxMEknzN<>GlN^Za2rj &ELJtߚDٓo p}?)nQY+!w_kkODP  (`:<О2Q]\xi/SjaSOQ]Ģne`"gZi$<+Lc&ݏgG2/״9&Cmg۫pnq(`F̾@U7+lEdeÂ`;K7nmN^~xzK01+.>Na])!uW"ٖ'd.xn3Nc*\fw+rܔGTޞ1z<|ul{ݥ;%bG7?/Ѝ=**SaL0)ȵQRWF l"_ԙʋ*=pQ] bDuxyHI( $1"R"r1LFX#bMk?m 0l{ͫ -QVKL*(J@in1+$²bU(nf7Js.hqГYFzwwo*.({IŧzXF/4ײ1Z_uoM=ǚj77z>Z;F6]ʩw1-7#_p]HS6^Q \vPSf˧^Wu :.pЏx Ë}j_]\n?.3xz !CQlݾ{H5zƻ}R]rwˮ+`?8Y9jߵbC*v̊Ar +!<ģ(?:*7M]&/nx¶͵sA雇dU`E3DbQ +!vf&i$F2jjւ N9%yxuhp($Q3 y-#6b'1UtGt-bAgQ &Y sui)ĝ +uTana w!aEX^Z{xyYhR[2/IJ7\Ym8%we.B-%d^:z'M|.\2<<ڔ&.8SFomnczuaSBkx{= :|&cy~C&=j>0RR0HnK33[=SkK5om e{zMKן\:~YAGp'㮉t-a!u[`dhFs`tNnSФ#|׀mdysODM2$hjM "$ +1HlfrRˆy0v?w a32- F +\$& gv1Xd,Z,w+Xc ]P5%h9mKcr $^/dcAw(¢) /Mϗ|>T4<,s53D"AJ궨V:;qI`6wǤ^۶^`xgGS+gP8Z[8 *[⮴$<"<[9,{WN 5&{!BHh׈i@)~|0 O:lvriL}_9{ Co龀*]kD.+4R$"$1Q4 Fu]Uݶ2ڲ206c1&!mj&L&ONFoe;Bӆ?b4mdCMI7ofLEi4bAA++ZEADfVmn,fωJn7G:G-Kiaqmι}a_ olzg]7Y}as}.j޹?Pg*]zU?!j^VTi/(95X43mRinyןQ ͘ pT|y/N;_|V6D^ %z{JԒe fAԯKlEP]Uo Fn&M33ԭ-n79Ei[r0oޮC^t9:/oYdP^K6 +4Ã)4 +Jg$I$SYvw[@-tN=>"f$S=&ARj+$pfÏq2()l"Cc JIZ+B=DX 1333P,CPR 9|P+2j%܉V153ϰ + oJ~Nٰ2T[;a:r?ԩv\}{cVւ!j(LD nEVL2!nբuwTcMM㣖P-VB$6|HʦĀ(Ca% 3FärdccaxNtLm[qAL+]Qoʠ0̗ u~Ÿ \6]ߓo`d|odN9tݓ7CmOe]No|G%s}"̹;DLp[xOݡgKD/$S +f[m(3h"}hsh>([JmVN~͐{Rt;שw +/1/>awsmsSЂU +!rJ}>g@2G0E #$&#0B!X`i梢ʋ@ "Pa@AD ++idrDH"q6z9@ CT(&H3ݣZb! zʮYBvmt>td"\ݩk8CT//K,l@p1qS XW;O?_Ŕ7; RΩD>E뎪̜v2(*?w6f'D@]Ϣ?j ^\r SwXtacXE31'h3ǧ~ìJtwu+ ꘕ*m'BI"¾sCC=mA1gd jlz.?|Vz Ը*L= +ǃy=移dwuէ:ifygSMeD6!4G`$L- cd2jxN  hA@`!&DYa.o}N᝚-аpi$0R"RbV7ȣ1|%IS;bN5%C+ j:GeaNpXoK1]c^!5YbťKJÔVɖ S %%SV +sb(Xs/gŸMwEw};~, +dwWݣ7+|Ne>i4Nhl(Ƥoyf4ZSI=pǹG~2<%VW>/:wd +QZu"h]ɦ_P+LYA~u V; lLTώݗiᕇ¢BujY]L^ZMp!kz2)z|_ I56z_+Y62B%i"d,<#4⡀Cay18!BI- ~R" \1&=8(Fs[ZANq+d4k@L eb!-!"Z#b 0m~mk뛧~~؀+1r2sz*Bz mަSdӲb;Ħvڞ|{nEa5;}0Sw).77C0z7:ӳ><#C2nD` T`J2/??w̻ksb$cpy{5؝ONY_7Dڷ/|G jٛj!x|~z60/|VUKk6d'T/8;<ޥ{ +k/LW3C.}+|yh0-I`ioz۩P_r۷JO]K%RYۓZ>H5gwߥ]9}SG_;!&\Mv[WZ<(a"2͙f&d(LLQ ܑIfQ6B RuLe^XJ#e.̘)It4auWb;$kfD9cY͉ar$1=?{90YoQ)q`<;jCo2\?y6sҼsS{'p\9lJ 66\̿644 DA5$HDcP2حZmfcj-4RgLbbRV(.QuuZbSG(qIafP%]s}y':*%"q҈RS|c)4\ݩ~V*dmU :LR>ZD1"T*6& F>0DD9 ++$jA|/#C. vD4Σ@zG(\ Btx XR=FGQ ]PרZ?C?|9#)8"Z)bZ|  _ƿu1rMQLj:;U%- +LꗬD>yӺ79stMƃ}(9v?C<1jۺ@rvUرM9p!<?pLUTp(wGuUJ)W( Ls8tmM*aٕyZ\ߎN%Z{ĸ,!3s*\gͥcNߤ^1BL:&f̐iMJZ -GN{YV~SJI^L }d-iS"A^qx9-@$bT +ֈYRjN$zӈ.C|(:އ7¬P琚iyE&8EєApæ>t, +0 H +35t!OA1R`Q)l%"]m*cV0:|>& +Do;Cs+&WDzozĜ(Db[nc"jلXdj=W=2P,]| +㚜2v^Tm御FTqE (Wi;KJ 7UqtK mq0mj.j'ʾkZ鯺5}T*ScpRq!ZWbgcZxecf0$n.EwFk,b{eKO>~i*ÄBU/4te4+8㟦"ֶB Icf#v߯J_6f+ԯ6>{x{`HEC\k@4ȥbgf\0.bCA艹xه(*)`~Iϛן?sBj@tc!F4N \ss*ȣ (q)(xlmrmEe%ZC*7r]k y|,OO)M +喐aVl!29Uc--B儴H+ϒ +N ?n] Llgoeۤ1Z;0w-&-1')3sU}"$#,}x~bDIIjm(KLNyxRYI|Lc"$ 'x K't#a#)a%1IPHԄf{NWs0%`N~IV۝#l""H-DQ{."*K!SH*޵0|$ +k 3!O܁O=Xb5tTi0%qpz3 iA<tOh!"jTU `"`rVO.t\e_blm Sfq(nW,^^$Wa:rӹ54$3SSTp ~GTrۡ`h~%)9*|Sm>d{ x +2WYFھ)Zx@_U1g,ҙW;A@v$|h> JyGgZ SHrсl/,{<8s뛘l<-rw/xmzu}1jD8S6: I1,zbHYw**34ɣIé!63)W%5"ӚޏD\L!_cmG˝3Ruui\oT CV+w^ +$CEP|L飓]kLyh$!SDXQ%L#:KŽ fęɡ.c ]Rpli8Xs:-K`+g0@ @zErk@>zͮdSvV bL⢡ӅMw8L}ffBVf$=^cJd0jVXxV/-`N/Q2ʾ1;0tCO?{֋9?* w~_)VOԀRPhhD +?R*e&>"hZJ/D|#R&O .aͱ9EB?wrVb MpVv&)/+`(nIjwOof W +$ wvAv9f'GgdKC F#Ir]$ } FDhƧh> +=!uCXT)v`3QHh!>>@d棣hk >qn9f\ed Chf rH_;m:3(k0ң?): o_/*ZsvG3`Xȳ = /9y,ē1u+2!4㮆'58e0C1ipYVP + _+M/Ƿ1L=xVl xx~p'4 ]V`1uux ~[t=kwՖˤo,Lkio{^\e%VnHm'/X]\I- WN@WlHkni*p?-AR EBXJtaNRQBZ`&$:dS =:t XQEc0]Kwx0+HytG\_n" +%9MCzhDJfh+" }2"׬"UK'aP ᢪ͖i5m!ƚ/yntfLW2/]Mb,n[phYjm4dj^nHbuO_93+ccZU7^TVNt8=\=~uPD`Blaz1@ScHK h啻ݡ5bI#S?צ ͉.ҵ6PQ1e)%KexDHhP'q8,p82\Q0EDT`F-yTH$H2R./Vf +\-䐈247T?jfL\!&PqƗ3̵hY"o"bi:j@YlVe'p8JvO;z/83mEg2IMyZ))ckMf=!wZ__~3fP!X})x 5F)=cAeٟ_E' ̠Mppއ3q'o`,=w^ڗ%d=Ԅu1K6ڙ>{% H{| +J6e㈇xRM_ϩ$jΘz^¶Ye&tdƧH%.%\:!ƤB`CdMn @*~nlc&a!qдݳA(J"{{ 3s + +O=.4F!x +N +ksTlehD}`h.3d<3QdESDY(yn\ɷVy-wNG,9T^Z\erYTAxfexWcvZ](hOo+=ZFkpy Bc +%1y/H:I~V,2LCpW+BFX!Lff!Hϕ0 49cxUekzP7os&ݗ|^%Nj:Mx~{T)" +{%7 Ken|\Tf߫Vn{",n _f/OB_}sv>sjʅZI%f3^I5f +X}ae /Ƥn1.* ++9[^CRj/VI S`/ CP,^`'u ( 7\ YLfix[dv)JSs闩UR+>-yjZŕGFQHWh,$%ҳ+TV_lKOitvqœv7BW(ե]|z6βy3SR\G0s&S4%5IMl>z_>@uz`4podMWu D +~2~Y76<JX6-,;ط b7-w&|Q"2n-kY{(\mZR0yfH YmR7,kOZ[Q%憓ٲgN _Y%l[.3R*pfEf2V._E ytqqݓ>si(YjP3M| ȓ'6V 4G VGʗoUCયtW$[ZR3a^km $gLDrܭwJıV!1PldIxzY̬f3A8OɰH"LO m<{\5s\ o?bJ6}Bˀ7t3bϾ~LS[fí + 9 k +_K IpJdpE/*<{ ?2O雿z gv˓u=z.WQdfMpN0*'`XGi`hUQEE +N +4/ʸB!KS4䟌:du%5Nv!zbSR.] +|+$z'J|2~8 ٩h=uɆL^/\\s9Mbw9\5 +xGthƕ5B= -ꚯ*]Pt-T`HKpPeu80h؂@=?Ù$ j}|.&y÷f;/ rЂ=Q۶yln1k{w1y>nU]t^ulއ&2$Eyo. L^l4\9Lìx>e3LZen%x\%q>B,p>g;fÍgL~ggMz6XWonĮ渝X9Qu|uKRē +hnPb8.qREnK.Gz9S@>+5u#@ d;ix3}ZCXw2戟/%׋Hv7&tH %B| pb'hM 2 =] @3N+N"=]$"n{ιSVVmcejPkllVCXkhʞSۃ<479xs̡ރ'/njX\ Ap#ZW:>Vq=n+Ns`+DĈmd&X}\Ǜ)gR}>#KyF仳5*pDul5' %x^_NY/a}D#<%Ј ~0`l\d0aBnu4cC6cI{u +%.dc0QGFh8L\]9J}qn"`ԕ[)-W>fp [ as.wzەеs Fo726*Md4ndTM.4߳og:shtPdCg|~ȱwuuhxtagM@pR -ԍtI!yЙ6:p'I̫n +P:% nĬ-/f3]jJ{}&Hq>qIexB;,Y=%BU}V5 "`3RΜ[2AIk8+1^\a>H0</yDݟsň$|yRrS?b̡yo?(UUcW>YZsyuA{8>$s5Fhh^9Hg:ƻ$Y8v02ĐES+&B 55;üځe^W. ۤDbXѝQWF؋=h oKoJʶօѱΕޕM c:G{O-,8wNu>^lmn:J$(CZmUi0B3fP+8&n/y8'qyP#.AqC +kmw2}"vt7Y;^#aP?6wK3΀z8BPN]b|;Ԓ@ K|f 9>񆾀cT Tqgx&JE4f^OH̅@*[=MoRjBqXA8O,Q\7!!Wosi8(e[ )?ZGf(" + Ѽ*\ +CGoAc5:QvILXKNO=4+xFO,M+cu+̜YmhllhYj]p<2=aizhucve\Y9i,2.IsG^\|ӸWW-3`efI^% iu2.:Z9>xR&yLI+4u1~8[%Ұ!`Eاh.F R{L>^es=f>%3gt֠\eI)JɌ^A 3{넨R>FKAT +$"/c&|WêH3WMu'#bkVh(RwnVo3Q񅇗X:8fO2Lï@ܐ@ iN5$.DflH{ta:b5a|\MjD͖C]i`$a!k,G@Ȕ׉DE'AӮ[ʽ(vdcw2Wix޶?G_uuֱΑхgͪ$dCfLNVXF-m-E =$=D(գc}nm|wRh!̫\nvC/(1SWe$a,c$`=Bȥ;WXs!zg0A_.ٕ3-+իW3FVV{&[fJ3 e,*+kف4BJdEJM`tA/+8AY6Aqioƚ|&:!ըl==GH5rN4\jgadGpHmԡ⻔t,}éOʭpO% QQI9n= }L ~],!dKE!Fh`,̒krD-KV_g +v 8; Fi?^@Iri#}x tZiMPRD0Z,kѣT/^HExm<т@z0Z^єGFg|1%DV$: vkEsJt#!ubbcWCUEq/k>]m`2)2S9eqk#8J|Wcf9VmdfU3կ\/^,0}jΥ{P T*_ P9m{oLfxc7A-n֓*.=SSnC6RԨF WC~PB&s^6)UCk¥Gd @j&u}k+J;E)R"ʹ3Pd SF "5t&ajGԝ(V$Y9%_A BFdY^`+$svNb3oT&(;T% ?^a2w3{Nӗ=}{ O#/eLan.qvgIc+%fH!|Yw7PLv;!*zJa; rlAEzwf(-w.?zP'>t)QjZR]\o#v~:T +2S8uJl ,ͽ*YG d +=aԮ^/"uOe/n1'_ܯfKfkmLFOTe +2^ϜY ̈́P݆%6h%I\,"usU"V`ڪ*a  c8 aW;T`ĞK y,-h _a5ka[$ +k|]}+>I]qo~GfDdq8,VjaQUzrrq*P*`n^ sE"k^4>\""[ckiƥQ:.uG$`~$7Ҡ|d*B|K#jOV 6zeq]x0+̏ YM" NV3˸,~"IYq$ .Rq +Q\NϋAZ]w4<#wA,:BUZeOG(ևߟ]h=l^>oKK)V}t0@s>lZBXN?Z GXȗ2l"T3#` 1>n-6|H؟l.~cM%uQ__>Mu ‚=([pIE[)9}a1#?E+=:4}۶ӯ_,#f/ol +QXeFyf^1yĵ.3}f)Ǿ|*i/<˜#Tm֎s^JE!}qNw̥0K{RbkTÂK%g7ѣ6/(ݷR߼v)ƿ):#ŏ=XY}Wjk.\{_8WB`Ϛi}RS2g01"?G?a +[Rr4Y8!!7g`['d빱, #;|!҇SGףwW~o~߹t#cw1Ou\GEMtMm~ocqZ : k|ȢT&/fh'k/S zFB'^U=5ͤ (taz6˼< +kIEgc0FYg/uwJPQ1wqxK0z#z|`&yo@ +NחԋxpSd@k= Tj O*%ӻJz8)-Rh:nL͇7}Jc<[e2)ۿ7QdI[Ę& ]UVmZv8PIpa2ݡTq).@RcJv}gb a]bx@s,4Јg)C09l3 ~[C"9w?}0iٛ]TFW5L +L`$Kbci I +3x&Ⱦ@q|D̜x<q6C'@yNv}@Дصłg +.tF'|k|N>5uP0wh#iet&ݶm?w~ۭ=sǙ q[)+7 b^#;J1+ + +l&cc'Hxݹ/s"55fx#XH1NU֚^m 8RN@:0I`hdF`XwFN !,˛=<Rx4~H ֩u@(хVzlي4zu8bn3G0cI WvmJŭ!@v>RAO)fYxۿ^\h?~rE5ts 734]qwrǪzI[C|'_!i/Rg n&@B .2Y-lPfQi]LI$cXO+ [ƵrIŵH;ɌtMIX +8Sa K /B4 7杗ݳ <*B]+?|Om8~c֛ѓ4QM6᲏',҇eqĘ~#z.ۼDʵw!TbY`jA1 7Jd%ue ԙdasRU1+R ؚ-.>.wɌB9 ͭCőLUZZexH-feAU^w_}MǏwM7v?ƭ@?_u|\;m@Q0=7S_Hmb\Ԛx^\8.Z1? w؇ +ir֫OJ~RRArNJ5߰]g&QON$''w$W$WDvu +C{ZDk.`3r%S|׮{ń3wm`t`ƺD@{1ޮgs'4FG`ܛqԊ×}6"/TUˠF- +cM,F +L|Q.3FxdqnQ LV3}BH+vx+DBuFt%Aj]j[X.o7lkmYar]z1T"OQ6)fNɃX:5h/eWeBvț}RGo״蜥>oܑ{kݪ_l|( +D^ +UK96,1H,]K!%l>df-˔#&M]KN yOuvJJD-v ё|Ήd;~rI`/ !E~TOݏoSgn;.5?q~+.5>D8nb7^ō}A;͇R +/32ӳ<.0ْB.+"FBDžD n`ΠhՐ9 K'R8ĝ;FlB!AH D B5alc."EV;wPT ?!&l8m:[YH~H0#ZٟPtBt aqj8¹T(ɚVNsst^\1/oùF9OUؔ)QT4$38?AA@҆W'̛|uiΆgGcRN 3)m5vL&Jo2}yi<2a5;)msROɾ(J(*/ iNċg #KԣN mU%2JN}Lde/>EZ-V*l$Tav|skmgv-aI`³R,(7i!\6hF]ǹpۚU)T?ח]2=eEo~|RKD.ҲrccrB#X tվy~xES6 03u⓹.x,ͷ {5Ա'-&vԄFƀ09}xJDF +$tNn/$O{klm9bn]gގ ^bfR!f`jTɬn XhvCE#0ӭ}vTN7lL8 izQҨweCMSoMg'5XYʞ3I ~'[s-M,J`^T^H٘Ő>؀i4vV\IZ7j0a +F9Dln>}KjW] )))%LjMΟ^|~QFD3:Kz{CR&D]VAanW! + Ibs:`(1>& #TZTd;z=wח++ :wy*y'&Ē;&G4[ݍ/tV၌q@ v/J7AC{Ko_5jUA~VaY#Uz4k GڶbYe˲2EڊuS*__u`2)b$uncG!CT ݮkJ-. 6_3c Dn&a]Nji3٬)|٨ƫ6 |Է,6gshChr V_.](>w=h'mZjBS@K;Mn? dLSzFo`5]AA}c qX ++\悗S^FSWh=͞&xM~~ R Ӯg­r+mL=EPX_pgu! N*N#g(r,g 4Kܣ}x .3^v=KYRn +;-nZ/*QL@B+\J Rۏg[6]Gv`(Ƙ¯E7ҏۗet)ݦ P/L4ŅNDM+!9°q3aX &PYM`S29A]33IA܎퍅KCv_~?C'6Wgxb2 m;ѣ @5d,Q.g@q`FddNa\8QoF0% ѵmQFk]8js!Iحq_j:-^CG.J`m̞cv1J+ƕU{ -rL)vPn%Ba-XVnEb"1Ï۟yXڝwd? Oy;U!{jF4C V`c2i~zBIƣBV,R;7&b)Ňxzj/.e#v]~!r3GE!!8_1bj.M>SBIQIoĝT4- nBIDHD2bL)TGQ0**Aऴ$LLofaXWsWXChO?-^*΀\}&7q;@̌^p?uE3S-S^b:w[ ese 9tl{XSz][ cyzLsJzU{Zr}Aނ#: _g2QY/#֑ݨߦHv=j}]M_jQ̉^DoUa5#B% CJ=p kMw7.}poO%^l8}ܙAgD9>qE2{ͽz {bSJBTrF܎E@X稸*%T$8e[cO@!Oҭ1ڂuuɐDb3s#,Z&?_'TkDoo4kJM+'JBXw5:iFRؑEqiUɅQa +)$',<^pl0eFP6/>& 丮D/E6 ^G^fhAa9(<66 rW jKā(!wV+[M*ѵ?XqT0k2<7gD6ݹ80 +eH;Td8T#2pR/[ bW2nG5m:Hf0رzzchѮ=8'Aϱ OvY2G357?/<R]#NeZ$lRt&ۓe1NJA!7uzmlK~ezXFųCm#aQ:-zt ?TC +A@h_k6e6p85k&͍}'6@-M%z'xeCMA%k5vM +sC).* Ad$E +lP^^NٹFH +/@ؕXWՑ=Ѽ?~VW7 &`npkYa+MFA_fL%L܍'CAqut+Rx +pTqn] + Ы;-K?ā +9V!n4w T6 huNa{ UUȑwd㱹:6e(Ya uG(YXeyD6~jj?XOcNQؑ>p+H=tپÚb@2 ̭~`G'Li' ! V5'cY5CpEk +2܏Oipa:UonO8Hѱ! )}P53J)(Դ }&!r +<P Q +3hZY dL("fH&aKH})ꂂ$>'Q|^69<q,7!Qܑ)y͟j颗rp$9[M()^Bsdm Qjž 0t4A,nqn,EV<t\6(1E$=ؑƁ*xt\gǵ"Rj1[ɷ6ĵxB:F 10נ6uO)5 I .X:QK*}&A4QFJw8-91G7 < +xwlȁO}rb)G$쌲/D'])6N\W씺Ir~uօc]Raׇ_Km) AҰN .){R TYˎ +ʹқIՀj%(P[ۜL(Wkq7/m)/ Qפ(P>--i~&bsl]=Q3TU]U& ?~'m/>$d>wOdw9[ua$D ?Ut|NF$vmXd³O܈T=odSڔj}v +$aʰt-e{{4IGUVkKQb_G7qDI\׊(!)q-E +q ~!6䗗46>FD (,ynԭo*$Jz_Pٰi̙b敋uzdӌZLX|vFjLP;5cfta*^J :0$]LJ%$ G)fsdIcmb_# tDZ~93UvT>U{;t:V 4ɻ\)}pDsx1g P #4U 4 Nā ]r NG,^exDq7/Uq* Ww][k@onYΡ3];]zPYDSJi~9jP(v! #(4Z]汣G AVk7/@YïDs KdFOpx5kɺBnfsIts fH%.ih".(PdVCJ&RR!?_(ng'2y\aZcal>MK+#9[BF_>!YK-- 7: ZoaGI!lNF YFmz'eXU,s{](Pe.Z1m9P+Dsچ_owP>>r.;RHq7*_T/OLd){5JnsXyZҹGiNd#=͑@zgUDvip+3=[`RUAVJ ??YY%xpr]ڴuZ,u~02m'&1OWj6)8;Nm1ts+^Lێ 1&^/DN +Hõ "qkҗ0ꎴ{\nad5\ +:Ls@3op>G "2R1 clj~pxEa>IGLk+3DQ޳%/Q}/>zá7AIadcdNG *Q`o{,[ֲ:_7Mt-u@>NNV6B +Lr^CR-z&?yIjtaz-|m%XG^Y_/a8'mFGlv3oz;~ Wl0/̣04]2F(_S +kkx%qy>,P$oyb ~b3$DNn_i.)**(eN#~LIKN MstDdURy~o@w˩dzk3 ĭd8ws@> N͐Z$Y֍Q E9+rQ޳1S|F짳yd)[J[/7W$V#ȭ*@D(* Ճdg+m7[qtK_w9ж.ƌFX'N匨^'NFQwX X= e^iKq~|vj~ӆwN1r/ܵwSK2&#ަַ{7iOD67&qF-޵A*Fc1 ~1+w5AQ)=6Vnk@c3@%\|~җ|ޡ&`UDHPDfG eNS>YV. PWg-^P?U _ՠ47hJΪ3O}ׯjifEyqx}Hҿ \<3,&}.:EJ;.RFG# aȅ-dĵI]^$"Ziu 2@م1P`{D (gJcÖ,;ngES#b8qC (/wmY8{FzrG7VF,FR#9@r>+b +xƲzo;1f֗;ϏZfco~H7x +_g/Gd5/MAq5!*`BɍLqu`{CN] Õ@rZU| Ի\7C~B¯J|5|{Ǭl^[SE P#cE`L+XDJ/_N{9_HH?s&gt + 5 MfDy'ri`aKIlb'L#kӋ[b[DHa贲%tNcwG~D#Xyާw!`vd!IrPj3vӳe|؊-[! j֑*~Pq 0aĆR<-Lq$W[fcGJ$/kHCR'd^3*1',~0ڽӥl񠤕̄+њK[G +}vř,טiŵɋVѤǾT ]rKq{Pc _{#fE0֤QaUʊrL~̓gO.&e~ +mK\m4jq!qgN<+ (ܾ*dЪu`fɑ sYl+ rHcrJh3RFa];3fJ.KԔxjfo!B^10ÔB4cQ%^ӥ.bBw1SS#+eݖFl;v֊żeiӦ^W):lϖ4vtF_ 6 Q362 MyI*{RU@L WDQm.,,w ug qWe̓086ح2K&SS:AV=]qO|W KSgβUQ*M +[,QEU*U(ݢ9Y9g܄ެyS .z%Gl~@-q5uSԻACX^˄&I4oW|5=qIUT?9޹z?'Ke䕑_{V Is,.PP X;?–o۠HHY Dj^O!3q`Y(r0핑rۜ_bIW%J[NC`tnS EruL5%oἫ ݑ%8{tRԌn`%)fS% >IN =cDsf^r&*'\9m#˅nor -fe#/GOE}!7ssJ." +mѾOPjdiRӷz( +nPw8+ޥ f9BҁVF 7esrRKMCJIv;ċ6 + fZl9 c⮧CkY_lE9I 띳hK2vT KӮ< 4li/^%7~UD}2{z H\_~4]/KY_ot4iջ"^aj9 E{h5=l us |vMtջv,;JD\BJ(xSH[( o'2IXZd4 { ^9ALҜᐆB92LLPEBRsx[h~٢Nn7_'/7nGͥYc] +eQ;xga>.lX4 PR{&urFܤr{eI_uQ + Uʱ"6AzV +:/*kLL{ÐVKGm[sE u*Aepބr: +Xɱ-ͼ +S"T)AŒ)YyG7{ +"ץ6?/P 1o͖BzWbY6`*Xte8+HTЌuT+R~V=JZa͈\ק&U6cTFu׼z~C\k+fuM{U*1}>j - +lMp˅XUي,mdyvYh1\BEVr@nlCnO*ٜ`Ty`UڽMXPv*/>| T񓓗;rN|r"/=4ozP=޼N J%R-n_UZ[*+:XSI;l68].LG(*`Ifo#)`pjʎnH +:^KL\cF"RB k҉LQv_`X}o ]KN6bҔo=РV9ϵSl刣bn7,npNt'F.(еTp@H.inz]M\'%fVrR 䆒u*|uArOXjeP4h.񓿞`2zhpYJNʦvNNUIo~!F5`.InI_ vZK)hrԉ}{ +BAf%![ #cMֹRYs݅bΤ2 +:m5Ay몟m;c>{Ԏ5Yj4~ b]>Q8.p3Yy'cX +Ѣs:9: wӦw[T?[z@៚u+,ݺ +N[r擿531ffΣEG'U(_FJBq%L3qWֱ65xem:p8̗ |y) $JҔb^F?'9 A%b54覊 9hvjS2m[JzKL0([<ۊo_Xh2Po; o65Phwht +PϤXvċ}{-7~ҎIQƐAN[ +k6.IQY#sYȅm.˚0U~͊csڃ5v"7DRnxvDhb:]8Q;+5בWjDfOli^|!;0dGG:ODWp>? Ig=rJ ?<-X3 L>S3c]<=ۄ[)'[٢(5N4uђo#d^7EÏZxTۚǨ^]W;x :i1*LGD(k +Rz;3 +^~mZ!+y1S$%9dOLɜSQ2L9"2E?}7b탳~ n YiŰ+ ]O:imdV8> bNfZɦEoqẢXyRe#; X|UyH?kaodk #3# =0%\2 qlr|>9si'Kda OZ/V9?pDX?7G9SE]6#21]A<ɬ=! +-V!l0!zy|zל<)(i8"mfy)A3N}Mbos/P'Ӣ+xxu}cJLҍ!“%)0J/e˂/DL\tDX*cWJ{ڴZju@6ktn,TKڕꇑ9r=NT +~EGm&Xph7]lSVE܌`Kp_ n-v`3NtT#ak2eN ER`tiK ڗ%Đ HܬI|_vo:F9qz'PDGUs%manpR?ڠd U~/`杝5g_}tm2o?ƋTS klu[Ԗ…4cn9asf-Nz16(mrIBgƷY F&/4tƽ%㜚 ۨg5ӣEHxB(t-!4'â4io\n5(ֲk~٨<ϊ {>Xi`T[*EU`IZk /|B]Xh 3#Y}0ᰓ>+MlV٤ +'r_y.sG4vA(질&sJ0Z rS}¬7^e[ +} ΪukUzMU]yBo[:4u)F;0_c9\tշ>~sWj?IpYۇ6:INa7}{UQh`}8[[չu ŧ5VT! qU8$Hx# U>CS87;)7 +)Ѧpvt)t > :N*{ګI+k8Z%D*wa!rgʂ3E辰F s Ӧ?,~cܙx:lG=ڠG`!Tv_5Ǡ2TD+f kk`5?EEjA8!wr@8Py]rވǝ*.u~\jYd2V[?fk@}PS1Û +ƖH?I=[\-Jm3ճxƥj נz(q'ߝEE禋جx}Nf4. ֧9t6NzLn{f+`1Ap{8DjTrDMܹvיUU\3}KYa$ג<9'&ycǚԉY*\NMikZV ]TQ`Mw _7s Lɖ(LMRwAgGl~ѪEҢ4`U7_k}CYK^>o'Oぎ?=^EQ55Z`Rܤ~ .(*/׉*q_y`W)ŕatk1r^^5ncLuӭUɽr"r3`(wD88B҅S.Hx3֤ͩxA?:!kW/$ۓ{Cx@ܜ0AgT ȁ.tΆ {iZ=]i?K{qgg2_|1TW)VO5ϔ(el]ֹr˒.nG lo#RC:@fp>T4Prվ7w;m/R=XɖϤ_g!|".(/Ẹ[ EW` Ge &Zk<t(4ZTuXxՉ c:ӦrJU .Gz7"6~*ypً4]?:ҹt1(+Ore.>3ZV +aDmpT*%u̇0'ʾ%;/#D +mPhxNx%yԝSg0,țc]zb]sdPW(H +cA)ˋeP ˜)))DɀFr yb(jņ_.s37{rA%`z9]fIhN%`<5lVajQT'Z7OEH<<_+Fۍ 6ew*6C(*,|  UʢFpFvF^p)z{p 6ȆϠfhnl <ƳjtE2ҧ6lL;3HxlP),Y7htZq`xU-eն| $pdC[f9>μ־v}f}%)9'P_H5ÇeyZӍx`}Q%te wm|RE&tjMA hٶI2"XSS"h{iXm1ؿMcQy$Y+ yA)716褸um4ϷOvwVTWɶCx%+\ Sq:Cj7'{ 1F,8n?SkVE7Aݹ"ވn uUZ'Ԡ2S.TP_djaQm{Pxe9W6e>p-("l.mMKNi~kMVbV{b#` !mm@̀"Dѣr= F8nf-˕C<0{6 7{[`C=M=OΚtqss6~\p?~=S8o\q1!#5=uDUeb$:Xg@'&يɵi 8I|0%Kia1ɴ,Yt~+O1h5qk9$ N KO cTL!yʷHhR{O-`MQ#(" b$rP {t*u!(a$,ˮn"Yt6oc dki-ttaf5P'2nIT0 XD{,`u\̾ +'T'`'FqPS'U^WY/j 2ƈ~pU8+#pe+a&(5g1p`RoC?D!4 3PEf͂ɲ nѾ.,{IZiy$Ϡ]=7F䱏/|'_ոrnqIJuIS6lݛ{@ǿ*zus:xݯ7l^ ro?CT! ^0xUj[ |}$jRmй=1a/Q6{Ƭz%xtCc 4XO~j3IrfMNXB 7~19G*i.1ư<"Eky:ah7Ri,5 邸 N"&oADiiMыdmO?]]):+T0~_uP[(ǧSPa'4Fr1&2\4Q̣Վ oIbqaheTK.Nke5_9qg4wՆfeN>W.6Q#L߈(~eGhQ|A Y@K勪f4F/J ~one-s(Ts׻5z~ihSOx4@ѷ~E˃~`@ + e7?<3]%;?-*pƔM$ P8VUc +;'XH%AkRr/=v^ELbT^"NA[s؞ +m4KsoG^qf$̼<)DžӖ6ciGR u {O/Jh~+,xHɧiP"71_B} +EVNqHL)P[|$fz]#گ#j%jGlM" YܕVع?ZQvH290y{+yvFM YGz J5,Ajp#:QFc:)&֍x z} H#Y]FC`\2ۦJ'n18w/$ +,|˗M-b0mg<ꙑ5VVfIq !7UPoHKt9-ާk 7U͍ &܂m!xۚ`4&&ıa٫ڠCd$G̯6b`mmP:שac&; A w?"]!hP[doV̎ڹYѫ!t }gp,54;=S({q*)GNۀ-@ȕM0x(ԒwtWsEyv0c"lfAjem7(<X(^}U!³?:I]!H &ovR:1x\AȎx\v{몢ӌND}&u,w)6 J|&̤'goҸdw [_ux([<H/ԙ")KG&|3-ȇV/n +% :0f @:' J[!BrS x}lrZAq.jic!CVrAT~E y,5:]PbrsVyK8(ӵ?>17Ň'X0867%c!QXo-aIl^bb`u2%Ys3}n= +V:t(f"Dy~ *"(F6X.j& $@RBPAD# tZ ;Nt =,m`y{Mvk? (y:Lx\}oK@Vt:P$<%s\@0 MM;S"YX~u׋Y;o6(0nmN\޻7Sw]{\ )ȹgM r|ɭ2R00Dڻ/aZ2Vlntry/O̢EgY܍6J$-EyO"us] 0 Cē#Y%P k ͇ +D!\6?"(Ls;Z<\[$[?g74gw:Oi͆2}"yՐƆ&pf^MY%~ѥOWe{Ea 5Pӵ2QQi)Kb.[a TUhAb%2`C r?&cYR*ʽ6^V:Q21ݽ^5banL@P2}ɂ=:r Mh ,?AjL8â'6 Y>yhV{˻1E36~S{~&Ngmu͙= 1aRoxE1rwպf|/hFp;], Z:H0lf'ڵQ  +Qiaa,Բ#Y\MyDкn^egiExȽq$c +`A+ [w!޹n- + >z\M۽…m[P;ei.I9KQ-WJEsYu Yڐo(Pz$v(%9KEGUo r0k*79nvE[ȴ/~OB_50y3: OgDf^GS~r<垃ޣŊ:P6+b7a6܊U4(d/^)i/z0Vp-Ck,+Pg M0"8:SkYʡGNm +ysˌ oıܳ6ZɣڈLO3_Yν MA1 &`'3ӑd!~Sx:r9Ajqc~C +⚯XJ%1_pf6fiE_@e.jy[BT%22, Ǿ$p搻ME(B=Y5d2*0vNEX1'~Jb55T8RjtS8OezSL7g&'~hdռ$,H )oꆣ zdz婾?u3ly腫W<;4mG;/wQ`_UGijrg8VҘ/FT;dPµp&L}@[IJabX%(wd=>"hߨjxm|{#y'/F+_j6Af-LRne&"!'3&&m kZ +ia^[H&#I#'?!?qޮLٴ9z >ODZ{Wg:Tz4_^89`vxiPA` @B`-FՉ~?F؏D +Q r 9QėO"`‹n]!J_u:fuh\C%EPvymyzXB =E8\EE+m*ӻ~3w28oSR|6Uը@T  oRS8RXv"QDOn1 ٯ#Ewӯ +JT?]|h?\SDyl|MXyI<>Rvp=*=oiB3o˫GZi| rRc`jcA@) ,HNjrF67;akͬY h)dmQG;XROLZz7ژ ƼJF؅|^2@`4\ۍ.ǠH5GI*2j~$+C0tEkHJ!6ݪRLW T ^l8S'wq.ڋصׇ4@K+Dojzi?hjmfV9a)YݐgN3oTT1Y㯋y=e>?e p4dJy1I7SW8!ek\âZjzj3rcA"iyMjO?&jgH&Oqܓ^(Xv?bk0?X\-֦OBB]2/^}\wXۑ¬z&~ o nbINTg\>"=@A !i(RǬjjMcJ~V,%DD>햳{} Uؿ隓l\eVbj{eoT1{iߒ)K1C_ Iu(ڡvT2m6\T憝$=K6\ c~gkH5) +}6V5~/?̀"su55-ݳz2yQG<ٕ.HߧZ^v(+"1c4ٓIG͉19MQArDž{bFJƘ-6 =JG26oKTD۰!vTpνJ9!jEnQM)uEN}ǟ]%^ GmRhגltjQBDpX´J3)%k ,;s8qb2]? _@P/[Iyb +RŔnɁs:դ* r&njlTӈZ%~e YŇE_ J+[L`mM +: e0p0TT[Sj 䰩W)KAO~beb+LҘ/:uq:K~N35p#ybݭ[3BR i^+Ram81 4D~LU> 5T'u  H,|/U콇9+؝b2dS\Cl'_Tg=zq`7wו YL9rC6^~ -{$^},b=?ySAB5E5AM&UoYcn 1: +0_Մ΀@]5R4fg69^hjtЏkZĘYCI6.N}޲N_hnc6Lۜ)a+&x A,O˄yf,)OO;$8+:ÃYu/>=nIh+AUsuukwm:_)Z qLc/IW!c=k Q_13R`˦$0mrU[),T>NW{Ոt$ c<72ĉhA~#E u@+MjgWc)z 19 qsԾLي !ꇵȋma 셳D ?~ybn㺻 ]WlYe'ܓf1fZb +ѢF v9$qQ8EHbC2q0`PeiUʾy!{iyN]<%$i=7gEE7$sR7a5pMDak#jk\0j(iԕT(D`F*uPS#XBC'E~rՒ.~͖XQ׬EGչ< KԉDY67ȘDа 64 Y_ x_yj +QNsz>84*R(4B@h(D5׭+QKtCO nLIJ>< (#MOeĎT!855;kdp0iC~Yױy7Y]6quh:/uD,u?x 5Зgv ̾|`YR뀙TCᶳ'5Uo>~3(|eꊲ^#lY) *44r"ysF'p%☗7)̒ ;9ZYӎN*S'I(jmąFpNlHX]̅ p?8@6?cN>8(}׃*7=NKEs-rH;07 glOk^ *dk8XHKqM +4,u3'Ut}/( +<kϨ2.ljNjC`CjC X37"e!$eVo1'Mh:dB=%ƉLoTIxU$Oo =Ƴ; X}po\ +-(7$K9oX&=N*5j^*̞+ؾQQ[C0eVeW + gFPӎHAIb7X}9{m~*Q4p; 1c[_@}4^þ]8{NM;#ѭ(R]FE'L5_J^MfՀ:Wة0}6 HϾ:,0x-[-?ÖB nbeMsE.= A%aAG.+pŃqj5^F +*&1)2)v*a e͢FxhS''ZF[q,0쟷jsjsTґ^iLooIB7$u67fy)Mfšy}?W@~pn2 +޹Y#=_k <<Pä>Z+ +`X.*pԥBBxh_,DY`MqAL*z0íRSGÁd)L$ާ.;iO}%¬$FGhj׎HFE*$>DÈ"?IeqW2b[Dq;wT 3c f m37WG*$s"c=2A\,wN`hVc"A_k=~s t2>ݠVs'-s2/652IAjO74H `Yָ=kv]Td'P.\%W+}pZP/O+^XPmC'SC [[͡Ƕ3eʿCoO_aB \>td@H·-x{QS JhXwE +?^+Ѿ X6//92INQe.-Q@eI>*ʻ_de5(4|brWW mJ>WqL۽1|yhݹNW0w5oM.pxjƈ aQ(Fe͍e%Df q8gdh=m&GS@UyMಳ +T)MzV#Bؘt"S|aq*"Ä29椭3cRjC.%:8azpzYh;8K`#@i :=4{yz;o: 3~[ 2Y=?lnǹIp0LvKol)>JH{F upi#\cҔ[>Q{ L wpsN[_,Z[Wnșa(:P +A*kZTp4dŲ[Y`C$uj/jOWt|__iI?T +OV|XWI|moZ-4uYkLן`aGS]{6B$nᄑH`2T5:3R𮟣z$>;edђ(6/W"0+sR_jӡ.\HZ)U-XyҘJ~7{q?\~ ;͑kw6?9 䛧T-)n+ho8,.T(Ѕ3'Ѣ7.BW8]: $\G0^vv G}'+&(w`}HUF~*g͒e) _+oT巶oZ˒aFE?sH=#OÀZ] Z,6 3 7c& y \W |i/ ܆`%ߌ +~箢5Fӯf1>TK4U;_<,F/hqנel# J.0t NQf 1hPahTGbsXoX:00{6M>@4&OAE/۶F drUF\;cx籂_ڣKѩ")XkOe%0B۝&1As('sa5u~ә7%'hˣ`N&˒ݚзiV{tGy]4^ٗ¸4K*XHY|~#*gۑ-$AЃ5 =E}:i}čj |K1Uad|sX<ᰎ6؛T@R"#,`] ix:L}OMfI90+5u2MC 8"PDhe(?#*իu[O.?$oqqPOYV4~㓧;E VT%8[flIÄ~HRg>k;ƍs EP0B gL`5T͸h$t qc*OQ6ztzّFlqx0(U Xy'u:|WQsbSðɄּ(a0C궮S/9N5鶓l]A=׹E֌k>0V)7-[ ,?|t' +V>1riqP38l\-v,fX0Fa [wp1ڍSꌝ.M% Oj_AϋO̒fVEo{JÝ/7H`YV{(:[údt_FWjPV$F,mE+cC9^D~F`VwУkT^ڎyC@AIMOu$ܶF+|5ީwQ¡ZwA=MIdl,J' RnVոK/;4U&(4~ +IB;OAǁvB*k# +6:JZ< +(L633Ӟ{6TWn~ tP;u ӿ<3|2Aą?Ojۺօ@ŒsOT{q5F2$`M^Q.i4і.FkYo@mr9X*CiIRh$rR{Ե׹enZWϛ-,n[Ί&5'9 8G_q<>&m4r\b&,ٲ|Oc ';(LrxkAxdvLȤR|EbX٨=&'Heuj)WHeS\QX#ddc(=嫇\+)|\#M_xT# σ%KRro6OaZ[`Ɓ%E7FP )|" a+qw> crLs !8(d=V ,ײ0<R]8NW ."0K8 AKv̆̌=$H:FF{Ԕ(4RUmaX #1dopڏJR8,tŭם9wf[S-8{ݫ#ϖ+'QQCշXpzxFqۋ>^G+\\r=<z]^0QlZ`{` cNUU]e~M)}'uؠ􋾆`L0_{Ȩw岂q%/ 7K U3Sy:l܉u}KW`7 S7ί ֮͟?7dyʔ݇B}OGfSTMI0COkYwi5 {n4{񭋀&š!1UkBQ(Ae!da{L(:6GCwnsm.T3ve +N_x@dE͞.LhDX< !g\P׵,α$ ɜIFS#na_Sfa PWڢs昄M ]`n̙=WY)5??{T@ߝooa[cCGf d/.Rq2a*y 'p>%\<{m\$ThJgH Zl D(=*'m|-X OJu +D-샏}nSH~Ick} e[҆:R")3 +ſuxw;'r|Cb7W F +>8RWw5{mfORQRaQ:>ט!v^co]i)nw5骐;Rm%6K]yi/&K"ԃ842Lt%ȉ6 {f΃Zt0>%,bzKB)ݱaIXMҼ 16F\(Jnw1(s1V>3ZpSGvݜ/?vh;reyWxJϟkn9nKsϑ<Ԓ-ײџ?Y[ͺTYӪ/׳|0M\b,`2`Ԧg-M Iys, +ϸ= %Y}f)GTLF>|V?ɏ\-$E)ß/ڡyf N=;c3 kl1ūm\ME.Am=fgu8uh!CyiAJÀw:t0!ҶU}E.E#%ƉZ`mIssa3h])N뜦"b#M2AbeXMHݍl'y=6d J)xʕ$+XJ[2\%3ood~%8j'Qhy)1u} Ycd|V#5ثϥs)op쥯/R3['%pC$@P[E2g)&W9 9.4uekx/~MG;|~]v~H%&!w E`} i to1+$r>a<ՈsS;uG;c\wE #Ă̌Ő6OD ~2]uo`37 $&/BR aaCE8̮]Pїec9N!(X{|9 +ƈstIҊf^{/uC*v?Mɋ )ꋞ[Nۚy9}f_ {3,i㌐hbĘ[O5qF%AD_!hHAA E"ҽ8K2,rqť,H ?LMbHV9BܺphQ;,F. DEG0<Ƈհk jyxX +XU5]3 6&z~JCToLM ̥xt_ =j!<(b:yQ!;*9+hB+D)ӝV7ղ&PWDj Wt|Lk`v!qg@7)pt-svm[n>J^ h"Xsd!2[+#VQB7Nmc#Ē#Ot@vqlVoMW>@֦>)k}rߞSuN] зh%9IsƤں'^a Wvc~b&}Cwg$gVΆMQ3 Ebk^{.D:n_cFxree1tB8 ol"5q?-j|P2:Y2;v0~ʈJW펊h]qzTlrz|NZ**uZ[I]Z{QSXfW뤂\!:V61tU~~@H)Ajm֬lT$ni6WQDϮMPgۦNt,VO=^~tIG -d9Sɡ lAZD+ Ϥc#o(.Zq?[;⵷x@|zh&U;C޾q_[0r>q+]UkJv~'9g~M~CT!qsk"0 VQct%e568+qJ`e.Sl:N˹{f2ؙjW{se;ˑ0rILU⡇[w"gojUۖ׿Y&]q ʀJ$AthӾC-10c~_-NMLj NyyK@Mz.P?Yչ8'^Y~,/x=/dbfiý6϶Du`&kbPOWTů.nLD'֞WD}|$NhԷ*s8!@]㶑*Aa7'IrL01_N Q G}& +,rVbC QT:™?@Y1y$@rƈ*7JZHɌN~Y6)D )ؘNG J=awGZMZ:fSJly%z1NG? +T۞L  SC%+\:/<\5*={Tmu0o:LO7۶sJi뚻k1'L(~3@gAh41ELz ܛ3fш(i_Uݟ{C0\jq@|a#%0ҧ|ɤCF7@fDIv;^i +tۏ$ %1wXKux>ܭݯ>*,+ǟҶ:]~r^{::&ˣwn߿p驵 weT7{AmZ]:]im}:'kJ L.&qxX̨yxZk|k/3$`A ܋;(N X󯖙 +i| B+cWb!;r[]Tз 'pD!qSbJ?=1KP;3|'( +qRhAVb"] r#A:W/@(Nm0 +7s5z;^1@Q4#ew hNy,E S뒫$dqՄYoJᮭ1]G)oY#;-:♢ޥY$9se +߾agݿ}SW|b[QtJ2-<ؾ|VT;DsgDfPk?7XN|vJ7+N}!  UBO EMJߴngD/Uk]AEk/_vG%N:9n6y<+n6J'xu/! oz_-ٳ(v`1x"kTA`#¬V$A,쟨w(Պ̍2i9gH2:Vԭ!"26hlÀ9ҧFPG`G/pB) P\7]wߎ(r 7fnMꝥ\⧣C<~1o]p"L[Qyi{FzapVLl .<eܺO.TԲyZJvGgڬf]KNvT^h_?REg{[k!LTuOo'ZZf[t##Pe@C||Vo)w<E P;$Ƨqe?W_~elr7+Da(㞗H޲Տ ʤKξexNpRRJܤ;tYN#IYI.6w)a)R6kMpPSkYuC~;hRsx*KJU>-&)!LB n7@{vJҴL9Эb//vR֚qի}j莉?_X|[cE\ޝk2frńᦾ.ww_ho_:zf˾kUv؍6fvܿ^@3ϰy%=5עaK )av2(^c," rk͛frS ہ{Ѫ7?I<؛?J~O&9sub$@ioU[$;jjr69]Vr0;6QeBL +ņ V7("b/XfR%f$c4;ao0Z EJ&[بHc! e%A +mSɕ] sJێhEO&Cf-[sh[1FPRH[K\C}wz "{/KnvXy@ZVs%ejB:UG>O:'j{Lse܈_?m!-.E&Q¢aEDT9TBbxP`}Hc" QOo}P-]0ou|xv ,x W*u)Jqzb$6qbDUg$Dpj +KIٳ0 2ꆧK9[;; 7bqݸTFgxUbzqmw*Hիsn,49\ȼFˆo?'z9Ϛ6\=>0::hn^8Dh5U{;#n*ڳXxo1X`:s㫔Jߚ{?id(/lt0ަd&\0%g*I2`%-}y2._\FW96\;{cVvvd?9' LYx\({+%˃ .7J6% +( JIGVw$v#V) d5&?CmMxN ijASehZO\}Y”_ X*T@fT(a eG"^ihokm$j'6F*pр]7 (Vω{8F)]'7f=Tw C׻W<\\÷7aZ+.a6v+Z+LYnN1Ee:2=zBɩ/FB(@Oga+MmF}94ޤ2}5M4iɅ=Vn, +L|@K@Kc0&]u||F2xkُ?lã?\9( %(R͘)v=_>ӁYZ&Aθ7Dp&)tW(n W5*q؞L츗||0ED\c#jlCPF=I1$(uK$ŽQ;`g gPnJ ]-ے5ӽj:/SP$&~SZ<vYV`$`eWP N:MUFy~7suZs'埾˧}ٛil| ޔ4a3 +Z r/3Jymu_( +f72V? f~6ExB x&qSb1զ;"]]|'K}E@ըp^TH^K&S(ld u`j'pd;J8sNU(@M2!]Y-AHCYG,VͩH%mK +V$fg2F 9XQ5|$,2VGDu[HAnS E|;olِ9?_o~8pxt=E)g2cW 682sbaa]Y[4{mb$| Ɨ(FKL$a[ln3ܖd1i|D0L%`H tU6Z%#I9AbxyQ|}u]*8\.UPvDLW $x3Y~ķ*_Rܾ`{C}m<| y>PLk/ $TBc 9Im) t_O(IGm}hUjvmoUv|ُa9=W[b⠫#ѵk@FVws.~]"dR6m*ΛO1%>XF]qEujU3t/|vQQmqD6\jc39+qDwLCHQDǺ!O&fM. ᲢvI?E*д7.,Z4cF15f uͻhfTȦo3,VPM.&o CʯT2h:ZI\^^)T&J-'*BsĢKKKҶ>Q._wpcpզ2?*P,i(O +-&XXXwˬ+cxRؗ٦n-K&Je>澛eMٻr/>E"w}ϟ,ą'199TAqJ(%g)RxT<\y=5 {p٥UxD5趲ꑌI ;lEWׄl>7{ƿ;K./#ya%]p*5fkOA, h>}x<%M_ 6)trJB̀Hsur}ct򅚣A'5"|T*s ?Y8U%XLDNhtW 3a֖Ws9 OFC/o0ntPwCEϩy+!+<{ECc){;#O'_g-aSgZ۞/(5 ]$fXSZeUfFjlBE*i}П +[Kn0DO Q~#/ގÞ> j>KKI!xg ٰ{\Zhik#&cx槒-}}BCzjÉ ʧ*#oGf|S{V5*C7](=㇑)|X#!V "Śkt 3)X$qrAC8FDyH.7 L xkN:ЙizY6oX/C^x\JR|ƒkq=@9:1Ł0RׁlD_z*&β2y㼳iFsU䋔"FF-7~dLnї)-rra %#;k(\L=p^Y喩4\F-]bt:u҅㷬"X[hkG%~E +,( ;rOM b1y:x[ oʀhAl#i{ @^܎mjvf1hHd*3T +w~{{(MU>u@6upZUZ"|ۍN^TGnw;לhO]]G_j%A]xA$ +fPL#H!Yh +x1T8Q`ٱeɬ_\H|(t%VEC.ǹ^K ^ -%Ī}*N[3rW<h{ӴrAl\7"vA"…!_ @,B6 +Dn +BQ:zZt\Z5;l09coњH!*=UgbE/u],ʙ\¥镉UD­j5qJũ2ջ_|_߻)z&wal6$ +2(ԲV\I፟)Sx}=y/R-ۧN[.~tc*^iBj4.hh.Pn%lBs z +!4I(h ^tKԖ҄zn%X(QMrYA>/1+' \Fy!"KF!ؽlMMAmaV(f-8,A1fR18y _=Ō):HA3Jr&4$sBcǧ?zt?_߿P#F;u/y =ʳQa}GKH>LЕEjJ#s`3ȓ=CZD[@8pʍAճ'2Ri$N`%4: 0݋Nd.7"Aɨ/dkh^@v7eaa-%7K֙iUw~W$C_|ZdzFRx1{5N<ʫY\\ryO]QV.N/TxJ굮 +/DAdH +PQuѬj/.;oO;d_?iVLh%4$o}౩A|f IF(DS|<Ζ7+iwAl߆6ߗ,u;~Ͼ7_>;oewbb!upӇĶ3|] +xZ2٨#լN 'CQOV\6YNP`WڻЭI,rp(|f?4>4x А/WDEA/Ӡޏѹ+eIsTs넛^xW1!_%%Ճy\ϦDe#R oOUZ5nkelr܃mSYh4{>>0ɫHahz,"nX$*eMTE՛f{^64R=H CǴ-Gm+/Ҡ\U$%lXܙ<JLvHg;Lj'!^Y҂-<ukjx|ҤxENO\7!P\>Ŏo"7=UbLtt\s Q_BV=􀖧Yukpa+CZ{wzuhht:{&AȗpS78CZF tJi>) Fv~`a +M( C"4VDžB]Rh_PQ͢MBYBaTN!R/~釡YgއU@5{Qp)j3:k&tcq􋟼euX#wB԰dƤ]W6aWƝU.^|tp~rxbO\c񦧆#eʍC%}^\JhIRFFj3Jaǝ%3_XE DWL[~^(9kk;ۚDAm<$2'~㭿n2jן~ ܡ8I!Ґ"3[ZNyM*!]䔃DѰ95z]EBJ,h4; }!@D] ]8 Mڣ!1ѨBc"(D] oEjGzNm%=;d=]k֑~}y<7Dz<JF$:*0&}AiJY!(f}}*7 é;a`aao0+f7q'Ye7 +3R׫c47D"l63 +l{/?6[mt &-gg6ࡒ`fٔF cBzʩ"~o:e"GfٮO!;>`CII8Mn ;m8846 34`,`[&pHV';G4ܻnw__ +yBf:: Dg*@@u=32 J9(m7Otp ő .-g"{AnAN4cxY]Lfo ׭1f֬b {G>1Zx..|abDη G+Ⴢ -U +K\財2E L̅}nl{/9}}N2K]mJ荎y*w72~HC-.W|'CL8mU|3y4.;1 'V̖>T59ӏ/IPnvHHVv .D\vM*9k,c?ݝx}+V] KژG@Okޜ Y)z O 0K8! f)th#F~*2D@棢@" GT5e@3`(O+!XI +;w2N0L|>]'34 +S6|ҢoN)\!`hĚl+{S2].î/{("n&]D6v(E@l0Q8aK̵#oacty^ǻ/ןo`v9x0y<IMod2pwlFDTcG&AǤ_j<[%RK,Vp5USEii9++';GN yj#[Zd8*צl陸rS?~c߭|yGDTEo6T~YX&*%\D !V,h*A BG* J15טS$*PD+"7< +ڒɏ^N84\ǔ=Ok'~iY{DrŴ!.tnN%+EED~P@?3vdOBEk rLĽ1T*g&QU3ƥ̺ K9O=]QzWg>s ~.g6R"w?nՍJwkD؜p0pa>Giriifx“̨ynOqUΜ鮷rgPtGzpl`oֺ +x xD2yGc`~8H~dD"W޵'SU0!%hʢQ |j%"%cf"BFf29L&-){nϺS@Il,q9$俾aS#}WtJ5E79{Z{)kJI狤dt=:ѱIǮ7q( +AʹJp+Ǜ漀4R'/ޓ&҈jw:RrfS9?~ Lf'R2<;-j\ئjrFPMgtcW84Vl%(RWױ_3pW>pl9Xwf̀c0FNb0Rbn@bJL/5(]`)GTrF&njc/E/V\ +ՒfG{gs~}zՌ)&|[v,ޒxiZYR]p@0Y]؎=6}d(Wso^/g|$Ά35KK#lmszۑTxJ.)>rsgqC\hk0)qg/9x|tVJaaVL 8v}RKΈRP0J3 eTs9SxzKNtNgCbSjsw/`W. UPl3ncp&K-v/û-!_,>߉v%vH&<-xlne=+萌~v@ǓplJ_G}=UjؒΆe%Sq +P1qw, Zg:*q*5آJC]z-79 QTHnK=_mAisd)."-%޽?Fؔ])s Բ[Ȑ*qͦ RYkX,c13g\ aR  ݋K?[xs_ajU'9#U4 X=6*m3~){-2$ 9ǭh9@y4Z5g,Uoh?ԜMK=)5Pc@dE)skKۇڗ UZP,<[{Wеj s|MLczrB3ˡp<66:=NDɑʣ6 *0@.q,,7sFDݰy]L2j$4: e&@˸vAـݔ3[jBc/PMMiO!}4I&zL{RoZ(זʽW dԢǔo3f-V/TR&<ڹ$f%>7޽z7l4eJXaxg_a&AKT<6c=!|QNmLϩrwMٛ@zV +lIfz7/=#ftvr[W5߿ЩaȬlۧ5}ӷ %pU #19CLj^fƻ>Lçgtp<^JwʝTVn}9x{:gqRM+wVD#8`?M6+%QL3#,&4I̛E.Pgs P @Y@.R%iW/{L%+N7HD&6. Z((X{X^%-2ѻss +!!!/~i{ooݞ&L6=cpJwSж WYwMnrz6a:NrI}}+-ǵm؊V&Y=ٻO~V`+>Y?Ks̷&UysUL*R9VsJ,,L!{OaYF^oo孤Ty2@q]%aW-MO<k@7WqbLkòzޖ ֝\ZBahfn&/EGT@!"@V22(%`֦@wGrQ kV sњ1uP\ 6R'BGM:6㪤P @M +|oӌK>_~ùJ%u:fR:N,ʈ-Ǧ4:GcWޓi8šzM܎JWqFw\FRsx5֊uxbخ`;xjl*3߽ymq)s \E:QNC +_LpÉ9،=^P4Mtf$6la~]jʡsR\wQA9oQ:7+ھ9[Dg1rdf9>nsih%]6O8'm߲WU QiRRR@,0ȅ)z`Y fD䤡CX +(@V)g %\[|+4pm&H$  R|*9S,V7.&ȏjQ(~|* ·j{wu--v!*Ĝ׫L,t:UfI7nnѡRD m_9SgV_s)NL%a 1L1p-H`ZhPCHH +`U@W4,bUPSаρ/F$KȀ! +;Cx }J4*.2SH@. xڣ{l)]^l )!>٧SiO7`OGXNi8 *9^4/$07~<, 1Y$.*x'wCr$cu,k'AfU<~$!.oc2N]c /t +)遯:xYN9䄞=Rk2)ۣQ Wu;Ѝ 'qnLsG}:򼷺p핯?1naMI7`(_wE%Vp*9ZORoq훰$T?P;M4ja7^ۛaWUY %o7%\UP_%<޸?XָjQ.I&:406pahxp_?1 +oȄ)'t=@*A t@u&i93"V:|,3 +O"L@5 #A9 ,x @Vxd>U]Q]O @Q0C`UB:Y c!de8"*r)ȞmrA NŰTlMW; 7v9UH\GJ-*],+$KFzi+׾?јoz/;a5CNWf<.RqJ/܄ʽRlEΪ-6m^>>3lftuNj\㚜!CXx>ed[e/5y=%󌰷 j:46LO3$Q[\+hdM"yw9ѽM!\3\[ղ-3zWBF}nu]w֬iQ +*mW +$ܞ{F{KSӚ%1/glL8[rT@6csG睁O/TעAa8;1nEc"#dJ^c +\i^-)fb``9( ٓҨyh)/~m84Z34ΨP& 0FT78M"_zu7T=;zST9^h*pHWZJ4{E?f>ww7n-4\w,)m7wHL-F{+%ObSzy@LҢVndbZ;!3sOXt'E +6DTl^Qh BvQFhJ]PK$cKFy~QnW>xzhe -^ B s96C$U).Qh*9Zl@8D(dp@/?9ƌMX]Rgtv҃'p/>j=CS*(Sv tse d>0D%ypu]{0H&sa^h|NF=̱DhڄqTQ%7;ZJPSxd"8gZČjf۔9O۲Ad%V|1]Q8{xl[7u"\ +x(n~ԓhNP ]D >%lK1%F^P+(uIIO&1$QbYj-r]VXhv<=Ld˶ u X,S@.\'"̑/xw¾ق!D̨8`N|1F-#{tM }e&8 +A:W+믍@v+t +܎rd&J :ǹc9|(4RCJhi&\"TtKcckfN|[\W׳߽%#?[fJFMշo$%gϷgylኳe["M35/HU@8`ug4z O +ee`^JpiT3n1s/t)(v[>隙'Uݔ.E7G#f6 i3ONL{?v bh4'n 㓷< io,ݩq)A~hog?>.\9b[VJPvkHfy$ $FG@b8;IVnh-Wvujky E,b7.0} P:Z,OޙSC*K(c0*ߛOX6  #< +L<.-Č劰:/!G/0CC5܃P\<hLBw՜8%+$٫{rRp юd`UVejw_7}pWjۇM^UW7Tliߠ\Md2ug`,Wu ]0Z~u2A{oGFTksk[j1c2hlM\mH&Up׶'|[+܎cw.XԸ). E%M|Q8dJm +~b."pi 7ECocjB78X9͈]fL68iVp4! Ϝ:m39-} +|mKã2Vy%UR4+,Up34x,Tp{&xr>5is{{ FՒSY,*wgö['ثeF-aXlMYh_~4'.?D# M 4 tN/ l 40"Ο9ݹ;Z9!ٹ@:T"}4TJ}f +a N)/2ph(P B(\VNM6\Nwu]u_.Y<ʋf]sU5'zE#kZmrIРi^3mPY8urZ q{_\cM,ʖUs_ r)Z\@Mj\ y-ZE]ԵcQ.P4z4(w0x#'M, mh;iúv#!A#z{ F?~';MFls͑2Ld#db;\o$͢:~(5ݞo}{.csK~Qsm>'wY.M+:D6UgfiȲlP$+9~i-6Z.0&x*]Q +i͟d +(+[JVhyl ++jZe +9/^vȁ[Ya@6zfوEP^pL3;G +8/$ѐK܍QNT ,xG f +/L8_c#FL za&}p05!~pSw֧0Ȅ =ǝ/pKJCqc1@ M!Q+i\^z~CXWX|wqC_:ʼn2䈯Gj3)265\lDae^GoF%hjnr/Е'|)y:m +B @\-غ*'xv/:4Vp#ӯNw!MkJz\d# GEQHB GΞiP X@`8DpH3-0YGIʌDFF @Ba0c-%YN[Mᘉp1d&b"8ژ8>`B8! +*TZ#҂o2 ҰDK3-.95z+^Utu6>zMSѱy}ۄDžpr2"]Dd +sm\wd(Pս3\O>T6%U[Z+-zJUԢjBPע3ɕ<] =Oozݧ+ZY5j>K&{{O{qDu/EɊCz|Νi9,L*6d8?;aY)5R`y7CL;fn@1tά#$(p)}fw69#gWDqU< >: siY"bDg;mZ8]dtEy +a#  +# {g%r ptGG7\*lo 74t OFN0$\ecև\R[:e-_~ePiу +z@ &sƍV, MvvnZ"В7ZEӎII!n%fNN(mpDXcl6;F  |!@#6qk'h0< 91& R\QH~ +RFh"=%8%~r4J`}kx|(XSҷeK5 ߀͉.8J\eG't7%e&Q}Ұ_0W!h6iVdV~cJZXMbGwl\v4,P?ۚmFp˃a.wI} C\c>w[ā yrc6VU ըH:ʚ*^b+ЃV%_WۛoB?2"Q1i9H"j2 2 +`FN !Jq +0@sP4E<^ wfdؐ2pM)ux% ЃNr(aJGCizp_>A  OXӰoeOv;%$t[j;XH7lX29.׵c%VOcgM:ɶHڰHUnȕ&zdL-1嗢\&wLj5;f[ Wم"-[[unĆ֞!L@yrꮟ63%8B4H$03cȧ UA39D$Q(Uù;AR"H=G3fBS/ORGT%h*Tvw¥*@^XkYj׿_+n p("a +3UtS~Z\x@owp04 N㲀i8AARDi|hA@sG@Ldb0qAɀ=D )F4@C8B'(K(*}}}tw B$p0UU4# + /My\,n@Xzڳ?k-:+Ԅgn `yPf$2v{?v$9~n;d="nkb FŢ`ibU;VhRƤ3̧?3cنD^RmֲyZ*vP J/;皪3uʰ ;r2Y44TO!)$L*ccT>06;8m$eB k|4D䠔W-?B5Bؠ +

:eGy>ѫ&#DOX p\)N.N 66~'Ռ@2.A: pWb2pE8z*'( ;Ծ̙]xww:s (};?U.T++[P +3|3Q^D]kG˶[($P[2Es7?鍖bjrmV;;Gl`aĠHc 7;0z ys_13<+(\^ݥ Ag|D@! eεw}~zls[ٓn˶- +1}rMv=r ~Κ5wLyQ H4VhbUo`cwz^)Di*4F*P7AL$6\4$`hvl2!π"1sF> hO,8=WUC] s?zG 6#0#:(^S\^>ֹ}xAkH t6ro=w{ջ>޽O>~==VlFWܚYP\_ +%TeVCVpӛ=C2[(cݛ_|˲'|WOۼvryZ3Bi;zi `!(?!+Q#U?Qp][⪪֞fיּer/T*ݚ'煮$z'ͶhV)_`d,5-Jvٳ{X C=l ̛;iJ, &* 0Sts#33*^4 .*[ o7;@khyA4>s﫧[&=>L-( xk"yzo~[pӭ'4Te5hz> KX_|۵GzŁʰt/;ʿdPh+BÒJ2f`hg=폟fw64 +:5X=t5 iQ*۱1+&Su*EVCK֮deW[ o`6\ۻq>zzh gL!!A0k fB4.#b\YK J 0Hž?1,P#|,? (85eFυϱ 'SrIJ3ϥ˜$ g}3Gm{Fowo-^t鞭=lD%+lJghh_O<]GwXӦwgSK(g3"}szL3SAy!;!?|j4Fý0&7~n32|F+ *tLl[ThVL Tf'8a'М=E1Sq%G<fZD#3? @8NsdU4!Ȅ͸4+(@ʬ ){ʊ$o/O!gjy|k]X+x ^QsA G$Ml.-,2/}`' ~?~u4٢&@%U9@_i,B,y|Wiywʤ,9gF3)U\7uǎ&K0y]ZRR+μC +M[|(,f AA"Enױu-Í{_bghb_K"n-k(ӈ$j70a9tqL-p{C JX|ļs|0"t/9ԇC#DC^#O;9;evdDP +QؙeB28KS  %5N1O߽=EڽΗ?엛20_Pr5OڶV:m۷o9uUCʨ8jF:4)sLwu>Q:/=}؁'b?ˏvwU_xo0 +"[[C̪b]7 uBݤ66Y,kmm( ڜE+?:tntJ|/)X O1L,0ȣ%Nf0>4gGH7 ;_@@;NR&n,C+Zdz}*  ԝ.ͻĨ-yȤ&K.^K0}e[;FuIW[G]V6n9~]v=<ز~ʩ38:+5>QQT{p_ +õΙG>ѣnutupyS裝L/P$1@*_)g:.dxJZ/obݍ5P e2pL4iK=_XaXCqPuRFdA%To [nLE,xxEϗ"CaWG;!m +VLF4hw# e&/2yF ؗ`2 +.DF4XI1HX~|ɦ/^{= +^UJ˽۵hQcs\?xO/.b?mO{_־H*k bam2& fp: +S-HdK"p*:^Puy5)K=HQ` wc~do}l씚@"%y瓓&mz~4຤c*Mӎu~]7 Q^/֬fqk_]vfi{yj=6}G޾/sOXo‚S7($꫊`M`"ds&*@aItY%nn0ى505+S +} NkuO]`')NEk7QōrZ9eN!ɼ,X0$`&ˆb3!,*drlN<Fp<{Ț3g_ɉONn^TxS-u4wTWln=X}hs5'{'n?6M +P)&mt1e)VοC m7֫.?g}z׼'{ۃ?g|X88DYL>862S;^=m w{ϟ[fw [ղnڏ6lY 5_8~g>=f){tF+ϪZ>[˫--GdU-sna #R !mv "J%᧾I3?ɝB>a,"8bYɲyO$Gu^ғK$o[gٶe s 6<.)CT wrd u/O|Tls/<72B˶-mm;!%47jYu۶\5?K:#?˧oW^Z6͙:ح tƓL@"oIVg&b9K_7?}'N>zꓛǶ,aۂ O^}O~5|7_{5gQ59z"JFD"*xGBU' + XڢRzźnqgp-]O +RI#BL>d7+Q*jm3neئF[7*ٲn:q\Y9S\) ) FϜnVokc獙R2J=MUګĆFbivO/SML +BT<ؿEljeB2l))21Q24I8M4\P嘑M7Bbþ;: ڶઃ +P(}eg[Kkی1waGK<̫^wdzCc)' )Ib K +aSCR,U{w~|s۫5+lܲem}wo͚;nfٓuܻ^p\J0 +C- r7~WƝIwݴ@֘6t5C#HwiM 񭢂bChJDUm_$ĉ:R1MbYA6MYed B@uQ:hpB Ea]YJ2s#p񅙉TJ(w3̾6Ѽn{U߻m[փ+Nb9fQKǡcbxou|cӷN"Q\bH`I| &rcf/~ﻻxےf>uS oc xq'zx!5{`+;T#x9F.Y9]R$-'ψCYb&NJAX"/)7*NJBIJQsҖ$H۰{T֖EmA߲mm-c4l3{7oc[w>}EYP$ h:W9GfT Eև{'n۱;?egOBH%lmVW z1hp!FL W <c*q6@l$z=nE @]/SdYl*lz2U<$8U=-fȌ.X& pMM9Q ,< L PE0!(00-Mya;˗d?;wυymS淶_նjWNz -;a#qr5>y瓭[cNz,1df2xtN+./߲~co~~b[mTДU1hE$lIi ,i1:'@Cp>tOX6s@db_fI$h1` D?AC%6O<^(՗Xr(l2: +gz( s  LRPSdNߑp-{h]/>tGOj[up~GuK멖UP:<7ky_w?ߎ-SYU,++#!֦XF~٭>߽…?]fln ?T7`0A]N{VC^ynUnUi40cjv9\&角xDÉDBAb@%7; , :CKI'&9'%; dfʲ8H@cx3xQ 4E7S!) A}#Q> +[?_s+WsCgt΃=tДu+[rĹf=gg=<տyvEqiV&H<!31|?( v狟~Yn6*J̎D)@ ড0QDl%Rwcn9% *OF* =5TL9f䖺M ++-Y֔*p{^C yinӏ=/xNp|ŋ'.n;zCa51Ai, +["& +DPe2+ yCe/)=Kvxj˹5SW '{|⶛!5)0&D=-kȯdIj-$B6;oh^ˏyzg7oѮ1-->qO~䫫7'[N5?̦TUAg`\8ܬXЊz_׀mJs} ;Yw/OV s%U@[ȫ,-'lh-0W@aԉ}%(JHAD0Ge1d`ҹk_ʕʦ#LUʺ]IFH$ntD⾤NKa*`GEXn9XQP{_7X6 $ $|DX@yi8vޙn80@ذziOo?͹sܸ^djPbY]ސC㝅}-[ .|?-3{w=fܳ%aG0@aݩxpoJt#P& 8bH +*M߽ +sK`:1Iri%L_^FSM3(x8EpnV0DD':*`%MN +{"ox&Ebn,ڸg|}SqϭlbE.ސGs +GUe*FdԲM|xQQ=1ee5 *[ {pZjhItVl`@u`<%o8kRU~Z]6PNcǤXjn +KVi,Dhk)eL2kaD ۔9x"-hAaXdƢSS˿z.t,扤u7>}vhݣߐ~ʶ֫}WOBH>x, !kU@ع Y#qcҘ[ +8.C`!a D01@⹸'EnC.ro~P]iB&BQ]o1HȨi&Ȏ#a>^Q3 &IN1}@Jނ)D*{?vԮy˒XHնd  ꃝ#E#jc;&1:pP8I&#"F;YP&!؆ cp3J.1&.TA(%.v)>#+u+9<[e9 6tu «|l&Nwz +V.?6'E $˲=KpKmȆȚquCL);2#I2h)"@-qtCR`<ʜkMr B~E9ŝJK_׍uÆm<@BX P $u hS3ܬ>}F4;V"Hk4Eh( j'n- Ҩ^|@5\u{5澇 "*&$Uт8'6FKj+-Y%D*d2#7eFgx'iUFfHɔ_k +&koDuiZd8Z,6lwd2EƁkxihHfʜ.ڐ:$ȶ@MS\r,O 01d"MH2u!ASWDŸvpGvEqAoNC i!vAnbRS4.0n:$t⒩  +O4t"'%9,8pxYuqJF3`p)AL pdg.:^z$Ȣm$a+o>8b(8QHi/h!% 'L@:q<= dt5h(. 62=D$eMT6h + >g=hJq ;e#.l07MGFP0ɮKBhr)g%&jJĝp#-4sH2WU2>#܆ݴ@?WlDtdZ%uY Umj'5fh:So2p{Jkbi(Q9jآf.Yv@{d ӡhqpP5PJdQen}iUn.חBM쌵Eaנ&`7%b 6  lG:KVA:(s)2@Msgւ`؝ !M=a'|?OBaeK#9ۿ6d/琸G ),bhKi8?yoDa20^A2q5[6 ŃƂgirc"J +g:`ȰM(H9@ ;x22O<1X\N(}*R&QQ1" R`2Pa <Pqj!prDP vmnWwbL*$UT&/(-0eT8dp%^a;?)<{ ݯ2{ 7 0"Hb %y%!0 %"Y6oH +ϴ4#23g ZavFe.2g',A0L> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +stream +hdddAAA\\\___SSSKKK((([[[///555!!!YYYTTT$$$:::VVVEEE ;;; OOO&&&ZZZ444111FFF ccc666```"""000LLL>>> UUUBBBaaa888333QQQNNNbbb))) + + +WWW 999~~~???xxx***Ѵ222㋋}}}III􏏏www###GGG%%%҃...---@@@ʇmmmCCCMMM߳sss|||eeeᠠyyy+++rrr777gggzzziiiRRRJJJvvvPPPppplllnnntttЧqqq튊<<> +endobj +237 0 obj +<< +/Subtype /TrueType +/FontDescriptor 383 0 R +/LastChar 119 +/Widths [226 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 874 0 0 532 0 +563 473 0 0 0 0 0 0 0 0 +0 0 0 0 0 494 537 0 0 503 +316 474 537 246 0 0 246 0 537 538 +537 0 355 399 347 0 473 745] +/BaseFont /DELGHO+Calibri#2CBold +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +238 0 obj +<< +/Rect [465.12 393.54 505.44 407.82] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002358) +/Type /Annot +>> +endobj +239 0 obj +<< +/Length 5495 +/Filter /FlateDecode +>> +stream +HWێ}WŊ+"E^Hg::04jM 4+i.OUԗlNEԩb[3f$/2ӌ%g uE) SŌ,'ѧޥl? i< \:YQs2_> 6ۚSЮ3@vF_.v.ֱĖ|F=GK.JB[÷!9GV;x_p?4 ` LɦJfs +FOOlh~][:_z}>͖P +ER tkmԢL]kL å7:(j_ZϋbN$Tѫpo/nTMst?á=8]`}Їw08=h?w_hзXVB`"N3 [& åż@x~\yF)ȅTѻs0Qx>93pg"{ `a8"aHO9 tIӆt.ؼ"7/ۈiАUtpHǠ!1f~I0-~2 RSw5(mKcy:H5]Yl;ފeB.3;1qLPC\+|^|7t\wN~h)9WW + -bWSWH5p@]w»x?&$.pwJ3gB9(Q&ԝsjiXhƗK-2-Ӡ! tu`?ljtL~2 ۖ7)| &N%FߞdDb͈<9.[ +d$0t\Pt:`(sXcQ`7œx RJAꍈBRZ\7""3JpZXYo1@ lPxa/:(WG2B-h.H1B[fi-n 8"5Ѝ +$/~ 2o2̒PET1(FV; 4%vbߚهWnqu[۫u\IIHO,[%5b,ng#:EXI1jtw%)lBR3q9@%(fH&)C<#n6N𤁹0bU+6WT Ʊ(Z y w8 ܢ>vg @9X-x${ Н%tB fD,''񉴾P3, +[Qa3ITUw.DI%eML\oo|M"ǬG x=f1,:2pB_.qGS<,=S%@-XKʲ-}= +@f8Hlg^zTS62H]_mĘH7P+~VIFKlIUͣ%&5tL ;S}ɫ6<1%*rT[4Zl*ɶd F2;=8tqx6l2͔= Wɖ [V-443)wk/:.:*dԚ2bVRsQ"NPsvZmӴߊ%[aX\o!iCp-2oіnlY.bYaVTSӎ##2"Ϟ'7ҕ 'k` ` {Xs]X@ +h.Tfke/⋍aSїj;zQg+s^kf8.L0B$"2lr)ɠ61/0g: +_N%W箤4uKn];x@wrwo;߀Wgb|;[w &h'44 |C7FI Ǥ6>?+,s+S_zpv6GT +|HO +y7:Ͷˆ2?1:; ]u:X-4p ɕ9` V|E|q| {r5*޵O4 JRSd)eK9:y۝NPPtRY- +Zپ QF#y`   $7r`:*y(8W(!874 M("vb~QqjiWz\"wH_g $'xO:}*H4 nY**t0lJP_-T/Ϲv6C߃/wO2zZ|̹,4[A#{<~\NW^InN2?bGr +endstream +endobj +240 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +241 0 obj +<< +/Subtype /Type1 +/FontDescriptor 384 0 R +/LastChar 215 +/Widths [521 521 686 768 549 549 612 631 493 549 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 333 333 +250 549 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 549 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 400 250 250 250 250 576 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 250 250 250 250 250 250 250 +250 250 250 549] +/BaseFont /DELGOM+Symbol +/FirstChar 2 +/ToUnicode 385 0 R +/Encoding 386 0 R +/Type /Font +>> +endobj +242 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +stream +HWK۸Wj3'vr[शhaJlI}XNmRSǕ+j/m~wbZ}\5Z6FxE k:#%W7bFr!3xj%S7q1֋l+HS;ku?!{ӭĖ$t6>N{CԷ +}Eeu7Јbrkco" Y9q:&i,vOCAyQ:G {zdD}ºf(- O8@.PlzLr$BEh.no9e/`|LZh0j'Ufrr6_7zR%8ourLZA8&| {?Cx@dMWhc]+?e ҇4q @?NFSaX(WoT;l+H 3LHk[9G@ܼADA#bh#ByQ/cѠ|TR8 B6VymJIĒB5NEjRvF +gy8#J!PW#.52]JY6 Qܳy+&LD1;H1*cbϲc.4CzlFB2G^ G*v드$fMXTlZ:N&%~ POfC7cqڲr +bEgt*' DžA";|IDLsJuJ€|Nl_zi75?'-L9Bl絲 YxYcdUHL9L"gmMÖ [Wp'D7d]*lYfh}ͺ)HkK"$fQ|9J?:Azɩҍk#mj^kmS;\a Gu#E\,Rø_!M |FK uwnk +32Ydk=&k on⼙a٢+DLϛ87R<Z/^?bcoF<Ըh0ȞM%pϽëܔPڏOsp2/0UqqegҲtbRӁ.M14%,HC{ +3vY.b0<@kf$b9an i7e?dyC!7#׭m +/o徝Qsq3Y&^́d&{d/y`op3{ӍF³Ő)(O/!@pIHMjU\fR(/M e#GN!꯷{fo5"==S]]1bSFlˍO1& I%ȸƋ\~.:v\uGfFzֹ#?d! +j\S!w:lj6]l 3 +gM%z}yC7,0jg NgN4<5zrXGE90v ;>A `Ԕ2kQ!|b/|nAAmI%Ju0ɟ'p=N%W_cHyt 0 D6X䌁DWW& %i^͔ 6np"zl}xd K\0C@sMVJ-9r7e V`"YV2y+{*\)Ғ>UI̫'֫@^.TBdG;CcW*[U9KPP^nr3hP-6ls9#4#:nBɑq$]昤sd^᭫5J+f;VPs1mX +JY}kmˁ xHxQf TJ+%,]ỎVl$F{"/71Z$^[1kr.cOaTss(>OVkk0 [7M6b6ڲw5`QK~ +p1Գ9#nrQ8e7V~R8^ւPw2u.xGX@A[+yI YE{\&iNc"_~3#L=]$Ԁv/?^mAڝ+d}cƜ' |4>x_'|N'h允GDCi8=/M>fi][o.p:)E]?B@ ]_:L뎏'[-v +endstream +endobj +244 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥kA # +endstream +endobj +245 0 obj +<< +/Subtype /Image +/Length 35860 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 419 +/Height 664 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?TI%)$IJI$RI +lvV<\@IIRX?\cH1#%ߑg2~aJzgFӇ%l?!n?%>s7?3Tx1IO$ ҝTpXS/>g,|6;jMeUj\RSۤZ?wԻHVV/uLW֟$]$:1ADIJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJLH.(U0_McIdgsH7p%=<4XD`kUޣ4 iF東.뭙 X9T$?Xz.~u ծf潘G.s纱_ e7|k]=½.:m,X]SOr=h%7]adq.~iu*/{7=Ę )IwoQ28ȫ?DoV<RSճ &?وJtfa0~tq?ڒG[\?gW]tvn0O׮?6I%9>^Mr-~1o2L@o2IO=w3f-Y?{0kNS] ?3K)r-e6vۂY*%X_Qzӻ/fd=j :<7N췝K\Ϥ؞Gt]wiw;.iVr*9Mkxk^>7/S署]pD8:,| Ob|Z_ p}l dzmÖ́.wbQ鯬usUC'Db|VO7I:W ,WGԺ~kCjiSÇz_X~ë%~E%?K|ӥeo<Z̶zOe;a5Si.CO2]a܆fj13k^CpxRRtI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$AQ*tb0}nWh\v&kG Wm*r*7‘ZX))LQl̷ ]XhgͲtȲeR꧐VN4myԔo@dQ͹PesXu'u<_9[Fˬ8|F-UѠsO^(%9Q9g|RSyDBvJ\HQ.));$rC%@:P]kCqe;` A ӧus1(=wEBa.کky$c3ܒ΍wn +vMk[ K|Ԉ<\#_,%=I4kk:GZyo'vMC2rZ+n7XCW9:\6ۛekuuR<r-_Z񽮾 _)E2>Z7BuW5P55X#2>S~_^-ʛ{d"-ubҬwF['촸ݵnypay:yec!;f,eEdcφɆN,`=m{GwWOn]e{6wZX;F)ZW4kG Up3݄j}>8X#y@UI_Y?*u2Z}'|/=LWSr^U~eb˫1N_]zQ nu+uvaY͔Qr@IX>oծ mc +J}smuV<'ctw85ȫ+Okk66<>K4:[sqh+M4I%)$IJI$RI$I%)$IJI$RI$I%!g?dI%)aٍ\pT-_8 f?4s?JJ|][mdav_^qg/gӠ6|k2J ;l?yT/ +H[sa%>q3z'E-kl?+sOq=G]kwKݸ~{7 +IgO*<XB&!$"!DRGJB桖BJB棐R5A +$%t]{xP~q߲ +$$K$I'QR!1ILIILjnms\gT;\i-> dS׺<d9g~+F\6u @y}gWDeUrS=7UK/ʬhs!: +Oc`/e_E{ܵzZJRI$I$$I)I$JRI$I$$I)I$}̢Z-`))fHUfYW꬐,DӨ[ )J}_]OȖyg·%>uo]&ӱ`1) 2:%m5%9=jf7c|w ꗜ +]EgW;Jᙌ8.7~eh̠ۚ?5HɝTC*@(N +*a%.0NJݒS D[:Mg={[ePAl@m- )^0v MKcx EȾWS,4`Vs}wWFwćDi^ˎ<]Yuv=G=n⒟4! znΏ)>ʯUoGU-*2ladk K`jWt3Npn_P̯"`SX Obߩn 漿|'}9wm{N6q!HO$YdSN[Kx{FdIwI%*RM)R&I%7/TL~IRϸ}{ǫ"|Z!|>1ls4$IJI$RI$I%)$IJI$RI$_=?aB>0ȻχuSpԸ@%ujqgE36N>H?ͼGv:6\9Ƹ}HpNH$us$yŦ\RIOCþfk~-`}@:記mԔ"=Y ta\ͬZ={ <~U}mgb\+/oŞฎTTdsoO{d))ܐ)wVxoҦХ3?FBH)HI$SBJ`T\ʉ}+u>c߁hhAVϬ .גrCAccصcPpIOGqmUQyeeTHsa8|^^OWn^CH3Onk,~F= w7;[2d+U}qk«ّ^fF=' +J}Cqt[x6ZEm}d7v83}Ϳc L{>\ac|C/m.-3$=/4QqzN1_c67r%_=N96ܗn-o@U%,I$H$_9Խ>/?õ߁^t +g}j,Ѱ&ѷߒI$I%)$IJI$RI$I%)$IJI$S_\4 =C˩Xo}~s_p5ϊJ}Od}}m^e60sHхdɢdz[)2fnqs>N.'\NUŃW8GZ<`ylӞΔ{܌rmdX=[#n2zN5$\O'lgi^}ev$)\2N8iL%{ _ޥګZWXYUR,`qN 4;"deOʼns^-c ῳWTJ3*wh;#Cv5?5T +?v{?-_݅ Ϳ_䕬WY~3 ʝdZéO'SKFj"G> rb[h0A3'# e]Zxc?:y)\sxrVƟq~Tˤ߽GKTJ84| +e?z9DV02FM"e;mi?M +zm&}g^c1K~e~Pk3ؕ?Yd?kܸX8HIOg/ &MN#Y\goGm`qBr213q5X$xemٛK_>${OX%u}7Yh# + wUf}:l{sVWzNuBO)ppDW<2(2܆ݲk{ÅW+knkql{Y@9 JfV5r}(t22\HuXpЬa,ck!c`;iܮ^Sꥻ>%JR+ͣuy=ށ2Yvv>k,uF17VXlE-ܜ L~]-w86~cau9i6l`-v_IzaռV6L]I8mK]hps&T7E /5Mُp*qkB+CzV>iuϬ=R=OOVD‘!D +=}_b|vaTl}v6Ӻ'Xahl.۪_:@o4;IDgR]> $$n.1p'M܌~q79kcw4$xBy/}hKLt+s8ǣ'/d1kk%,^~[hmVFm#摔DEڄ$c~cO$H2d݁ifSקS 9+&S+Q9ƶ6V N*V_Tǩ9Z0=!6CB;hA'^]cf3ݏgsG*7Ӂ>΢ܹn=Mpx +)+n}=SapǤ`;̯^ +܌̒ uN?\-WsYA>tq=GVoܗ>/k"|5MMP EܢH ?Xubd+6ƈh.`FFKhim.2CNШe._g;mG86!{B%_?_[rwP=HI$RI$I%)$IJI$RI$I%9?Y"ACcp+3+8^+s񛗅/^Kw9y/{MVYa)rN7RJa?vV^.}>K +\`k~Np8XKOȠT)ÁPNMkkƸ z|I-)RwPJ|R3Q)$*pZCS(-ӟL{σ?r׭Xzyh[—Һ}oϷ}ՆSt@`ϪL}Q8>3 +2}~jipB,:_ g?S}feMʾf^/֞&{a=X][+]г:vCHxNuW.B;)'5d惽ѧ ȐtR\ @#[yzZ#XhNԴVO]nZWs䓹]Q+[[/iJ:TG>ѯFE`<7svkѻi HxCu'P+Һ^6 7mmVcGj].8Q &@"fK;FY`m8oiob4@yi >r>˸%/Lv&v6[ :Y`ˁ_ISk.3VX$/y uU:uPUm$JRI$I$$I)I$JRI$I$/-ω{3J2}VRѿR\7\?ڼ`Rcջumw2}Ldd~y#c컟 9\Z?6$pB S&?7<.rYl٘7*@-Ԕ4;p^ү;guc_YfLzԜtuiINJ'lcy/F c;:1kq)asf|pV"`+ՂPGvb{J׳3c.dp\[ pc 6E3E$QAP؀ +ʰ-\vgRT +2;Bw]U} QE_kע^P&6|7<<>e8nfOd!ԋPgyFБߧs ~İX7gZjn^]ֶF9p۸l٘@N[Y3:O:ylć@>oK:Mٶ\~3H:mGu^3Ԭ8 ULebx". +a +T XpXCx|;=މ 2kVVCveZ5}9xhȥԗoRz'!7i8PsB*k%~ks8r\d߹6y ]>߆O.G;!YؒI$TI%)$IJI$RI$I%)$IJ\,p[:+ZG YZ6tKߥFۛc)Pkuԟy jFt7Zwzr*Ͷ Z #g` CO⒟S\պY&WL5N7jw%>yξ/wJŞV'ా\́_K,?_gA:X$s79݋x,?~E=?˳yZQ\Uo?_Ufi ?!IO|RFoByA-Λ,27:5:~n]Y=.E=ws^cZIeNiH>" +#BNNQgQĸRt ,IfT[mV>ǙsΤ3*?`0H(E&X?)=)!}J:5ٟњ링]c]8|ܖ4{(~F5l] ;ea}oL>n];ea6]`kOs?@N.X?iG){X..$2עiwPO jNm6/}nh@&473 ؗ;l1?sn0? 7r`wŽ12Gg0Ȗ$~FygwJ8.&I%[}c?69kṎi] etPA6X6bM5\%ѣU?OtZqٔƱnOvP_jʟY۴AT2߉/c+ZJt#X+at)d3w.I lPZpsG(=yT-i` 6>2V67 Krv4mm#uOf+n&u +MI(n!SJ_)l>7CBNAi AАinݼn,Nd7% Lsmt!s]IcWIۛ~onֻH.sGuCtꛎrmcQH\evHewG_'[?S [gU  VߥYoŤ9f/Ӊ*+131FE,UTI%)$IJI$RI$I%)$IJ@͡wP"߼B:I)_қsHp*|B4nWT&@=)kE\8U?z#%xTheշwŇoZw-ݨ{H?09GDüjY|XS~ש3ˠjyWcZe.GÏ+vx撟nʤ_m'Qk OھfO?.n=V C| [ wIOal?IFҋ1]8GA]-D()I]5=o.<WKl0%%*_oeR>'PRLŏL[gg(AH!C,{}{{~ !G`9~YZuƨ{^Oߗڢ)<~5N!&(CB0)/:OȏpzY +?2bQ?I8c(юfxXUS#CVo'Fk#ɘdOss7/)>'V++辙2kwUoY['kS,_p}Crk& 2/NOUhcp >((-ϫ{.->ni1Xs1q}FQ Z9R⤒I!HRI&EtĤQXB(R)u!**DNXVQR$.iM*RiN 2[ uH RA3ڏ#; Gѭpisl#W??=?qr?(/ʪ&S?7{jǠ枟sABOÿ +.I$$I)I$JRI$I$$I)I$Jq>׻zÜ{k;O75..5=gd?~  RS[#{ ^zp +<={uRS}sr[ߜno&cn6֟'MFΏkIm&O/:~ [qŃ$OXk~9<%{WՌ-oťp+-dz2r1$[[SZ'i\nS]/艹O?WRld8d% +IV0mu&3H 6(=$ +,S[4ay(ِREA_A<$&O$*S$rҲRDJtĢ?bDS±*$2>iŎE$Vx~;%]AWc\X0LJul#hxyIO)w#bCvpxM.45Ct~l S}Th[m ;C˝WgL[fu[ 1.C7>0?x))*ADx&z1u:sZ~Jf*. Ŋ¾ǟ ++uDcO;> \@j4' )IL~iPXӏmX +0O sKBrCյjՁghI=Ɋ]}vroPKf]M֖>(9UUm.uRC)ubDG)@|UZSJrSJE2+WJS%(r[ip X\)݋?Y~vI$$I)I$JRI$I$$I)I$JR>cm2qXwʻ5w\aIO♠E܈/2Z*XO#"y>ۚĉIO.;T*CrI5ąخS YxmЉl,))<s\GWN3g4@dgWm->fv`3='7/H+lcWpa?p]OO}ZKsm#a}pg?}=ϡ~S5 )h_ss.7] +xsir2f?7⣇4e2EЬ8KRrc$OuzMSl#=HI:\ҊHL-lV?$^ѓ³ӳLn&ZQ2cm&ݻo%`uYb>#PW ?rͳ) d5C&I=̃Fαqg ߡ_6t $.H{Ϩ%ڕݞpwT\!h+;*cꝬj+XMg.k5as&FF\b1rL +ĥ)ʌ!j)$u>2X5s[HLΡഏ"! G2>a!/@>*K3q`\ + k{<70Κ= _S]2*k6tɗSY"IJI$RI$I%)$IJI$RI$t +aՋiō-?1 )ܗ_[]Ljt܃1ҵvc gv>?$G ;`sMw`UҲFWL}JIG:VM\G$~WϫCZVvȵŦVܷOiTz}~Su9<~U[.O֪# )>2fV9թr}Cp%ԋ+{N.3k~I4H))3 (b(}K68H#.qk^f?*#b8n?UVdJCBp>Ԯ Z^<PJ292!6qJ!htQۥu +%վwWN\^re qG]WDEQUw$9zGډvc0QPRoI,2UX5LWqإׄ^C&N-?h +׏GʣsG3 ^l)$IJI$RI$I%)$IJI$RI$O֜sGP5 <x.ް]eҬz44 )9Aɥ_d~UcCs}ybxs-h"SNT?J{o,?%TߨQ}aǏnS^+I՜;mwIOeLx9rCbϧ1t_`乿u}')pZ0<|V!vknON a?\i:JJvR12(:oqtRo.ŦT%Ò>:5qRa[8mڴm0#d~Øw7?Ir!b +"-<}&ʏQ-asZiND K )bVqcu,;^?!RR6'S74{Op#m|9E4Զ;2Ě?r~C]vK^lYJ踏K?"@Y3I2cCGb}%X1JajGyZ} ^Nۈ\`xfwTkZk; o>ՒMm$Yl:ðG0F9C]IxwWA5#hXI =MeJ@2TLJbEK$mRS4\9#]R?"߬ ayYdx~Nx%ܗ'wNw>t˶*yMa-v:YkOMn`C'MI$$I)I$JRI$I$$I)I$JyG-uNX.Xq ~8j .w݃<|S}EN96z*nq48?*Z.XCI8%y_/X`:>Ϯ,~?4eSEo?֍BJ}FO+; ;GҶ\gk16GT\$6!={졿K&\j p9ty$[F/P2>zK ʖ/{'؟/ozSFJΕ?8gu sD4I2tP~%Ǵcio4}/[KwoW @=g&BϚsKop<R$ \x!\C]oe žw~e;çWT:Oq֫s*-RI$I%)$IJI$RI$I%)$IMn2z~N9Zaxޭ;?zU2 )nis~#PᑋM5@ǐ|WQGS2kGII~nr+ᩪ*?}V^PʎD|B .e'cKwjJmlTOi HAЯ!^/S} ε^mAٸGkyNzUK3b(\_Q܆ȒSʐ)ސ)z :rp&֘ X +;OtXJ +užP-?$V!DB6-%?9KLk۽|BAIFٔ3C\4] eجhLnZ \-@+g]sil1lM'Yjd]aUÕ^,@Gw7~EvkImLޔqMrNEϪG+N-|-5|3(}3o8;0^.;]~I03:*RI$I$$I)I$JRI$I$//i0 d]m?+ 2qC (yÚFny 2֫w?+L[/vuK'dĤ:>ƎpѺ6Iڰ.̼ k' XޯBcZÂ~WKF6{FT+~PRS)QiR v>dhN.ZXͤr0OCiˮDசk4aONEI&êy}#8ޡwJyiҊ7OP +ϴp~eGsqNZC^UxkuQ/fZbtt["A#Ĕxc撠iJy' ;Y^aJj6ǼsԐ U,Iā-&Bu$~s~W2PFpA~FUjm^.?%6GY>;>rVQGsuI48/Wfݳ{^[@3n`Na@FF?]I>}f%}L45K[bauf!TSt&p",佇ߚέp#+_Mm-0TC*MGgݗZ9=RY2HiӉqoѝ4u 1UuRL~KI*I$RI$I%)$IJI$RI$LoWzIƹ|*w,_t,x_SX,Σd~g[W?밟lWӐZuxRS쫕FK uY[lohp+u>G㚈RSY`d2]̹S2=n\-yF`5K,t]d)):/.e%8F๎ڟ#eqp]Áߩ#%@>qI4VpXZ1V9c}Z'Ɲ +.]{ 괾ckˮVh>rݕ"Y@$z<]6As<%m2Ыu\NE%%Ad@ЮMOeA\"Z*ѯzO؈}stCܿacQcC2@5dL(݁ +1ǒe2c <"Uhҭa^Y|\qZF{ 2yLJ:.?IUz7DW SsOt9b?kg P}V]c-dh~`cau2ݪYYo{ݷ#"_qw]fmXe^Z7BU q rr WC>S99p ֱN.jmuj{^#&VyE[YrʞKCs1S ;?阃ߔGS|Z^׵t[ UjHݠUPԟ(q, eMmӇhv=nǭ/>:GOfGLx-dN +ԭ/vӸ?|~D((JJЏ9G'),\>?LOaq T |Q!filߩS.ͺkˬoG$/9zVrj\dpnTʯgtXX+#?9Xy}jkyu miV$3I$S/3qnܐ{X +MtTYx꿗⏆軩t~ߔ/R^,M}KJ&e$I)I$JRI$I$$I)I$JRÁ椒J|;.e拟YVN&` K.oSiƻ$da[2} V(GOȧ,?t{(* F0 ,"eּjs^<˷w*-њ#ݏylZ><]ДZw~}bΠ~ +lsc>h'O~{= +ۜ}!!:Ybz5zudɟ(k]jszpɽydK+g"^чx ˟`DȨ?S[A8KK7&yP@6 ڝceu< .y +lQ} s?FFٱm|A|TK<0T?2Tv:X eK;fUl{ ? ;]USw_cw{;`(އˋ[VqbUsm׵Wf+0Jr m[3om?%|9fQcl(m`Flȫ6݄I%)$IJI$RI$I%)$IJI$S?oQKun>%pvv1^/\{ W`;~%=ۗOXKz݉A>Tko%lZޡ=2 [x))89p@+xކ/oƱ=ARgsU}Q]SRSwg?}7UuMw^?9.>>2?yRP15 {H\H},l<ʬ7Z.C9TVzHc[n5/`m<`:9F[aKd&Vd@$V?nutWR=o/QoLv\L?{fmʆKNiޣ\9v7u>oAq%q{ݩq2O(@Y[9DƁlXtU3 %#,)+#3Zb5䲺]Z}O[hw<f2փ ǺK\وM0A0XlC0;&P2YIqY̥bc`XD4H+pvA  @":y/dnNj9ʜaqrkȍ{]ׇYi{8$cadt 9Xq^UtiN ={9!0 ;qH ?5^n^[Ēb~)Qi[J\ Du2.\ׇ4kXuƜ*/xaX斻k7ħG1KY>^&4hsDvC2dz + } 7cRe9W:0;%8KKZc]kB>/ScKjޝy IVu/.[ñR踶+zR,Ƶt AWF3hvZumNuT`-[XH<ܪ亜ǜC-$%=α XK} >^g.^75t}ʮ#vIsaoq?Zp~6h 5QgM0/~){وL7/t?o;}-U?Fi$JRI$I$$I)I$JRI$I$v/gTamo ^}M)wѱ nVAi-INGs?[x "Gu~wzE]'#R?JrO"? />- M~qG95K /4 7tj8/kSV7tu Mcxp 9#;fvҤ}պK.$7Z*sճq+gofc`\CD7)|H%8H|THN9MKtx'YuVUug{ϭ^4%qm0ctaQsvs$C5*.)^CcΣ.pGx=h. +MH,djv-V4ݎ.RPT"0½um66GpZCuiiuZk\ҶţJq"{+0:dDƱo.sīX`1snvw]Mlp'⇬ V:Dz׸{%́oG}\}';@iseIଏy3k"A^ +:R^6FoF3s[M `?yenu^\ư,.qeɀV35c@>~e{\-yq!Ӧ'UFޥ뫹[S "Z{Db}SW鋥.:S˲xt}/jm=Է 馗?k(icv z I%p2uEU,,qsH'lq@N2'bqWE/m4;`qZ +>.CriQc,$GtmW{>kpDTI%)$IJI$RI$I%)$IJ^7}cl@7z?򒽑yohf܊ ~G))q;PW2qr2Yk23!w_(gb, \ze89:,?W?ϠW21Ȇ\|.c;uOQ}COzJJxl8cu&8UYgz73|8~UV=7>hkh~0 4\px\,.}c04.{L~+pJpEt}(bu+΍m^;OIOs?Vn@ȳ.r]iwaf[kOoW"WOV_*`qUgw^CAIMXiuDY#5\@o/G;WR;~EeoFp>`>%>gI-0Q{f>txP(%سAW2ƕc:}XsѰJ+ ck[LxK2p:PL9v4xNٳJ@䜮]I+1Rz6O<zOa3skye-{IihQ6:6$]̾ӑ-O,689P'G #'25@{E5:][O(A>f4H;n k}Ex8 վ%i<Ywұz #0QeO:Wak[}fcҝ6SyM8b.-uScuDr${\AktN벮cvUV7FECqa;\<ƉXe dA~)CQ;k)bH$1~{_dQ +ɵݩil u<:WN57s'nNKZ}-v,5̜|<.,f?'tnHʈ?w[rX,.>ERÏVOg^CPճË|!܅~q!T q~$pQޏh/Dm͒>S㤆`aF2hʿVkkY-gs͌Twe{Gl c1r;]F\1n<@k5r$ +5}w8Mve8*= _'ޗ[q*ʬq^ wؾtI,|?$I)I$JRI$I$$I)I$JR~8"EսfJ~t/K\Z[Nݔ؆˛q?*dn88ȶ>~ ƒoFWoź}FW՜BLai.i%>cNL{.i?ɸ6R3]twiNʧ[-·Ew_S/tZ%;fK>{}}ixrJyO52Dy]wLX~0W2'V #aYv)0fQpu?O=K/E,kMXux{cgwT4G+\YXdVk \x%#Žinݸtgd^wA|vL-~5דlc׏cmh,^B4khĨ͗4>/aƖ7NRZTWY!ķW4 iʿӱ:YM"UCW>6 U8ӄ F<hjIɼ)7 #vKBqRt)44zۇe3m[cHsiFMBysam}s*)ēbIN.SXC,?T:lLlf>u` 1Y~cXN FSM9 T5ƫ!F5|u ߾}Nm^5૲;$JRI$I$$I)I$JRI$I$ƿ$m1=dY:.k`22\%ϭv+<4IO9U?./3~^2h09|2Sܮ?ecz&Tc}nO@lIkwJy_MO]bs79yN[OMOGPSX7ȼLA@ F=,Uc{lc!>al}\+Kqhq,MgwG&lVbh(:}XpςFY}zޑ}F~UlɲxQq`eF!95ߍݶW?Isa&\2=d '2cz9pf90Pߗ~Kvpr"nFN*W-ϋ4ۂiLK);3ZFx.i]:TpS~R1ůoi>j['zN ~O6VWF-hHkL*^cF0dڏ ȧ>֣*XV0u.w~#Lz.qmVXֽÐ`>6^h el%=єR/pda5m"hX l*6!5=b,e5C>tQ_ڬ,Ʋ}IJ t$cTƼAAr挻*klpkd4VrܺX\ +}cnN crjZ6;S~&]YLS>alQt{v-np|tv-oR&}MꎁeI% gx~Dm!ޞLnhdj7XsHqs.h nY5vĝO>tn;f$t#"&O'RP.U4Y{N' qr OaqU_]I$RI$I%)$IJI$RI$I%<7Zqߐ;Ol;m{| sxl&^V {J-i;p6ޱNCNV⒞+B7-F-;0TW5i}sSHrxmU6]}SCTEwuOu%<8v ,S g|msw cb}k[_%%bf2ikkc]c`s)uo8Z&~ᡉWp&ϛ Q5c{oh`}Mec`I'D|K3el?BC_-6|Ht{a]I 1 .0B He:|68e .ݼ:Ť8M3=-%Lu?Nɖd"|UTCM-mnFU2)R̋-`R6VFRuo;.nׁו+R6lhlgsy.٧tm)uU|8m4ƁyRensfF8-v݀f?Jp[h-" D%\w3)Wv["u5ƱšyAr#Bu(AǕʪf8\do8fPg.fwe@14@8R?>ȰH i Csom<bu@~T0:^+ 9Q)@}ęQ$SNYf)wLw$nٿbL6:sȸy.o4Z?p()]% +lm2>JJRI$I$$I)I$JRI$I$ 1Y8CE0|7H +ŔGѹ>$mwS=#zԼW˪an(^:!zҳ0֋ŀyX?RSW 0IwڪKNCC/B:}J堰~~O5<:Ӂ-9_wGN-I24 ?(] M:WphRS3 NSJt²\ZVur[xHo)m +I}0!']s5><Ʃ<#8ӫ~SgUI1\GU},yq:-w>NH HSNqGy) $Ӝ ݙS&n*/rsTM3SсPr!Pr `P!Cv)܊ʆ䔌90*LRSTQ)))IK$uxN%?AMw~Lָ"\G;v%l%JRI$I%)$IJI$RI$I%)y?hK+|[o+W'2ON5qIOt/9A\ݶ9\?8 6q֭;|:u ɵKe]kK|n3mu&6VO@RS}^Ͻ>ˀ{F9.k-?v)?7S.Yq<}eUv>KV+1tIOƺs[OLCbk~_⩔((@4SiCj))SK 2t_#䒘TJJ`TJP2"7"A%"pC( `|CRu%lq,1JQLST~j%Sm 9zR*RI$I$$I)I$JRI$I$,mԸynj({j))* |ͱ >-23n-?tJ}$dcx:Zƿ{_]K_:)&]X5Z9MY )|.a,]n[]eĸgT5gJ_Z$0YS<=}pRq>f8Ly߯yї|JpvپW4nU@}r?]ѭV88O^y2|P*b +#P›ODiBiD )=€R %N>䁫 +]$aG\OF5UULUo_?by^RӺRRxPs\>&N.w"zL;zoƣFUCpqYVWu5asf$<YgqX?fi@CN#v'R "kAr#̵52YLmԴZU%"q }x L:"R$ +c_B#K|v6?~7;=g[ȭRI$I$$I)I$JRI$I$$I)gsb{uW"y^4s2][w^!$8xǶƏ'?dGY^Zɬ< IM>4^ߥҳYcߣv}/!sgY=ڷ2?r잏p’yix9'wl\Ч锽][S{#KzMW7^+~K̺:ݤ/%ĿtlH$TL +lwҸDn%?&!ȡJƏHgRt`} %N(gЭrJk3 HWԟ|qVAS%5F w*y20\a{)VGIHُ_Эs: wLh<}Cp%*%l){qc$C(dn(j̚FMLeNK_ATэŭ/#)+F7h`Yۊ&r2~J #9;`FIHUee-xuuTc5I`X9 ]^>kѶ,hwEM!?+ ]p:`3gW}v}ʯSͣ'C.çtDZv8i7ť`caf*Ģ̋ ߑttt\ށwvglLWl{mIO TJQ)!mc:AC.=F挋qX [H7𱊿]8 +۷S;@8w$&&gŖ1J$_} 8 ERui~菐e`dWZy?Eǰz^F3u"qe/" ?]Vګem,䦒HI$JRI$I$$I)I$JRI$I$C&$^a [>~c.uNsG=/ ߽JEN.~6@?X~R8vWW<ϵtkl wžҒ{K^X;iGP7q֏v{U/XqhX˪:ZRSc8AƧT0ȥ̱>GUuB +y|fftKl'n˙iztַf\D:VPqG8(泩6ckkH+2$$+G)T쩖ǒ?oUaߌ q?)D@DX]x(9 Om ov;6$ӕG**ղq)yŐWiZq3[ +.oArywfeYq-vx|)qDH܀k_*e׾7e̮ Z3s ++$l"ݺ/uKVks(klxko[p[ƸTDJΫ2:Pi926V]ğqt@\7eUpz&&WKvNk,<8s|epǟ#1W: 6Yy?J/lKcL}dY{Vn dOQ-% ZpHҭgS#RK"Me*L'A|$"~ i^6[^%lho+k@ηͽ6.?%*FTa Kh$x7]P&w`tklX{|J}RkZk. \y1&s5w7jMM c<> X'YIJI$RI$I%)$IJI$RI$I%)$IK9{K\%W3Gk??Vٺ ˭?$w?Kݍ0y;Bg +{/ZC-%=|͇jfV삜67`u?i~<}_S2>-wTOEud}N7G4xj`*Mt T[~;7 mf0ך/-iҽq\OUgV$Udp~)%]֜LoÇOp)*`~*@ ST)%RLl8WM@Uu8ǝ{|JSRRR>Rsw1=&*mRR݉8*~HG{e^USNNsl_ߩT7uH䶸'(y7#U jBZSdžB/L/Av,ԩ̨ca sjdns7XB*yB®X.<4jO U/Xzݍ?"GR q4jOc@dތQk[?ꏤ#a&$>sгlbac_t]E&s>W`V,oa:[v$Sp#מKt 5VC) .(7ku;ǺJf$RI$I%)$IJI$RI$I%)$IJI$R4zw15ưvʇ]}/nIO϶Pէ+yUpp4GЪ;-4{@hc!rS}zp}Y92ܽ.YR{q^y4#IOAR_-585l']7uI#9*URuƣSo.EO**KuwNEMzݙhk#R[}C5u0ھ}^a*^! +W:9AQ[LX=6thGӬ@2.jcXক!(^q -,{[2vzl5+-}#ĪhqY3#'dVGTǤ~ֳȝ~R14E ܧ[Ý/!4ka )8x \OF-~vhѧwC?*I;fҺþiIHꦪZ*mIbO%I)$IJI$RI$I%)$IJI$RI$I%)$IJI$S ֖)=~>ErD/iE9U  MgGj#IKe?.kp$xQc.2sO^fB>=}̗|Z~~I)qW+~t*o+V(S~or[f~ːaG[z{:[3+ nicO\;_A?[i֏ʒ^ZҤ;}rwpв@?TZv⒝XAZ 83U39?#s⒞uC"sc0~rFjKgV=4|\P{1C_q?!+*CޱX84yTq<V)8ic~{/o1] 3Ys hy2~kYqF2=x]>ku')ҡJn6 #n +,Dc%7dT7<~T?GYD!tI)$IJI$RI$I%)$IJI$RI$I%)$IJI4J{Z85<Wt՟SA8MXO ec}iOWCr+Y>B6ERbʈpwٍ]8<RS};>^]'GsuÖm+ϾuZO/1hk{Hs\iPSeFL=I-e1(mzn^=wv?zƷ?BsT?! Ҋ:^ mfg,|k-0TSIV߬* +>ԳQ[z撑tf;s.GFgJ azMyjmU*?|Z?z1Ͼ ;h?Myjoˉ[SSt|S()nQ7rg)tM0 +DW0q2O[aѩ!]-LL7n{<>N0=\F$RI$I%)$IJI$RI$I%)$IJI$RI$bR%DTLJbTe%2%ȩ澹PRr@gR֏w^Gv5Ϣ湖K^hA+˗=^aJ3!,(R!t_V m1M zG'%>5Ů9 + +}Cwq8k0qsI?3kݨsLL\))G^Yj>)|RSoLr9'1' +tHQ9#f5撝35rհns~&S5|VC3;q* OH^#bw#JR?w3V1:7O!eZ?>#mmZLIw,gnuAnA=ِ|QSRYud +2e%6Cm +J]$IJI$RI$I%)$IJI$RI$I%)1NRSJP%1%D9*Q.HRR sIH36Q`\?Xv4ޕh_BWx\9O,ʡ;@𣅟]d4*έw/e2ƖXZrI6b08K)>cXrhyBӫ76>SiͱĴ)(GԮ_]T`R?U:•(n/SaU³QS_1(Ys_!S6u Jk;-jP,V4 Zm,XOV+Xb?84GVWu1Ί};_=~V Tׯws[P *=7m {~ü%}Rk,wIM֍;N2UَVkNZQX*՚Vu:+5TZ^!%!`*@W;*%0`(' I%)$IJI$RI$I%)%I)%I)%I)%I)DH)HHhJI)H|ޒJ~ vI%?CB$B IOWusB}/I%>fIrԐSXS +eyH)r^ e$ux y5 $ +VkW$:|Ub4/AOM#k|J~ ʩ"ꤗʩ$ꤗʩ$ꤗʩ$ꤗʩ$ꤗʩ$ + +endstream +endobj +246 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +248 0 obj +<< +/Subtype /Type0 +/DescendantFonts [388 0 R] +/BaseFont /DELHKM+Symbol +/ToUnicode 389 0 R +/Encoding /Identity-H +/Type /Font +>> +endobj +249 0 obj +<< +/Subtype /Type1 +/FontDescriptor 390 0 R +/LastChar 119 +/Widths [278 0 0 0 0 0 0 0 0 0 +0 0 0 0 278 0 556 556 556 556 +556 556 556 556 556 556 333 0 0 0 +0 0 0 0 0 0 0 667 0 0 +722 0 0 0 0 0 0 0 0 0 +722 0 0 722 0 0 0 0 0 0 +0 0 0 0 0 556 0 556 0 556 +0 0 611 0 0 0 0 0 611 611 +0 611 0 556 333 0 0 778] +/BaseFont /Helvetica-BoldOblique +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +250 0 obj +<< +/Rect [400.56 420.36 440.88 435.36] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002358) +/Type /Annot +>> +endobj +251 0 obj +<< +/Rect [503.58 691.56 555.9 709.92] +/Subtype /Link +/Border [0 0 0] +/Dest (G1004545) +/Type /Annot +>> +endobj +252 0 obj +<< +/Length 3051 +/Filter /FlateDecode +>> +stream +HWێ8}Wm堥IIfd&3>m/Y mkזܒܗ=ENbEm&u9u~$"H%Sdd*ETa48.^%dۚ$(Vpۜ㌞qm*{d3$!%|UՊaPhf>-UV,a%L+2juXz}L;GR9#'CCxŦe6 QrY b_]cCͦ*7aʪ"3#@2:+ArcYR+hUG62BȏeJ/LUEO5'C!82dQu}O j|M%2b?.- <V#~^:B:?͍/c~Do*a=޴?kQhɶAM,MɊ[r~ v'*ؤ.ZˌXMꇛ|.ݘʢOpjU-lNW_(Mv/e}Lݴ+Iٝ@d׋ƴbk*Ϝ~м+f<@s+P!&\\0DBtS>Yd􌢧b]pt "Bu%Ô( q+VPbqxP||ojPPӔj?qT6A.qPI{j>2cyu+JL!asj@؟P/)i;vBӮ G:8$$vͿr4:l'sy:d<|m9>_/(PY+? WY>LLtE0|d 훿I؏2L$! bytW̊s{Ze6f!]V} +="զ[Yp c߾]4U[kFZ!Woϴ$ +ɄrQ[<@I{iY JveaLj3> +UY(>~C,/Op]\YE;Ft=$:b,\jOCCJޔ(cɘT:/.@u%T66!7_9b-1a8˦K!ڰ'̤XYӓ*rP6>y 14jv +8^? +1Xw_Q3ܐWz >exrLM> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +254 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +stream +HW]|_1"R q>+ +S;Ts8 'an?\X8j4 W?\G-$5Nf~Ry!7:au:a8WV?RHc|c__O$y[>׺tO>>ïX+p&FE)(45w/ζo~څ}5޽n6<WW]c_'eA.& [%G[U}o)E,uvN)U9mؕw1(lz}"SJKk]B|9NS&[7N_I> J(Af)"(M: 0w'{tr;Ҧ mcΨjo>?(%ҨDR bes`aW, O$IpᝐGJ R9Rfx(\}qF t kƙhM:r~HG6Å\qnKg +MSW)OjiӬ1+`H&|##mzRB i$AR5N|6Ia^~A5׬ B4̂)ʂN!7ov{^ +4w8{+i/)!C&'MJ!8쿜VE5E0+$ jqg$o2}at|*VAXaG{ ]fd(LJ\FmR4E 9:5rRO3dOWedPQ-*(O#4F`s2zJrEѦpm'UZ`Lj\ f} { +D}8\R +A49W2ETUe;=qv:[WĄ߄꛴ K,FލlޜjdjPA9ç}}|!cYՒMw1K8ݖcAu\JAlsN5l̆:hW4]HhUWr bq=ig3D;{ OK%p+cΫ,:bk0=<8Nۖ#Rp62V'ڻ2 +gj+sVv%XCXAJ9HIQ7gH/Mې@G)dwI]%/qZ%! +O ZS)0mnRʊE4r1W6_<'7A33/sd2*r&ЬĂ qviu6g゙ 92Rq91+/&qj + BvҖQu4]xԇ62si[M'Wu(Db6zeKS mƺc<xx(f#p]ve˖rLfJ׫L-q)kj(@h\nR\E%>X`t>'4N=TcF8My8)DWAH9[4Dm! +S[/n_vKoCVr0G8Rj:A&HKX$Rp XiCV8%r5aHP]wVZqN$hi 3kF 8chүL8۹m۔߬Lzo{}>ɚP^s,Gq߭SYDK9^G'7P +\QnӏU5"Eo:zUg% [oy2FG˂4I `> {9Ν)9 2]wncm,T|2dF:IZ$yvЧ"8%KbWrgVScW +`lpv~@|ZE6wLiR## 75g5H鄄]zsm%ax$%LeT왥ʽ2Eׁm넆TIKYJpse{mZ`8dphegš8<`}0/jͽY1k%Q0N +endstream +endobj +256 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +257 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +stream +HW]ܶ}_G74HbOчuQޅwd_{)DRu`z/yx?=N\5a5ݿ4׻;Xh:|h^~7hv&p #xs|۽+z-1|G0p8MG6NIM:]n߼wmlt}߽ny~9nO߇vagnzGgńx]yv<ޞnoޝ_521Z9X|8~ռ8CBbP4An2XqoJbLU}7wОNwǟ]O{6/Oow k~T|M/,\{B"$SF"p|{@}Ȭg!f^ \0i)ĘC#8<I"O?Q@pg @cz5C8 +5ܰLJg>oMdzfdt=}-~\2k (f6' j-\%ȥ\ z_1@j_aZRZӣ=_|lJeVS`Co=eڟJb +1c\Cň8hɬmKȹ́"3dRW!$لh(xvwge]+_gX*zv|OE6^*:oQ(R/fYbW~ +yOhK +\qW:IWVodVcRpU=*x(^C(FFXNkP1/ܬ^gs"h5/n_s5?A'qu1O8%̩ :yGQH]jTbVt̹ +P (T;y3-I)gĥM}ڎd?LẈ +9d՝W/:ayh)ɩFEWF_u(+yb>y;.[FVQ TD?)igZBp)CI,l7Y͉ 8澭KEDQkTv8&90ѬRI$/Yxa$鐙yJ>u$YɎ$mkohr_^=.^_be CvT,f.֐BP܌t%i9-[dRk B8(oQ'wĵx:Xk3c@ڐZpkER()Bal/BCئ$ +FO֦۸'!{h>T?.&|e=oH] %Zc@z sT{5& ʳ0R\^̂#`I9'~y~sXty}X6bcl U^s +(@P`s4&ċW,>AĎ.FzTb)H eJuҭ!@ZH:2.q !$ci.x֏-_" mY'"5X?&RN4!5HWN4Ķ4kt &ZH⻤mm12[!:C)\bNS=q^﫱F\7L^u@4i’2ݦ +"҇sVei&hȔE檻j_ET0( +ԾŶH_'A rUV D3_jcJFE{{W/2q9J̔1NP/ cUBM#ed?ayWU1Ǩ|!j +^e2wU!?K+ :@c؃IKc>v uMd0v- /%քP *6Zwt"&q^ ?I3~ƪKEMmyMH=-ܾU:d$)8auK[1ŕ!mΡa'r{s ],z>6}_e! I}V_hXJPf +̄OS +` ccнRCi^L;%ks\Q]l,%,Q#łd89sqQBz1?k++$@ |˨5 +endstream +endobj +259 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +260 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +262 0 obj +<< +/Rect [254.1 496.68 266.1 510.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009341) +/Type /Annot +>> +endobj +263 0 obj +<< +/Rect [450.42 263.4 456.42 279.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1005724) +/Type /Annot +>> +endobj +264 0 obj +<< +/Rect [471.6 263.4 477.6 279.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002509) +/Type /Annot +>> +endobj +265 0 obj +<< +/Rect [141.18 249.42 147.18 266.64] +/Subtype /Link +/Border [0 0 0] +/Dest (G1005835) +/Type /Annot +>> +endobj +266 0 obj +<< +/Rect [162.54 249.42 174.06 266.64] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002533) +/Type /Annot +>> +endobj +267 0 obj +<< +/Rect [304.86 342.66 310.8 357.66] +/Subtype /Link +/Border [0 0 0] +/Dest (G1005724) +/Type /Annot +>> +endobj +268 0 obj +<< +/Rect [326.16 342.66 337.68 357.66] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002533) +/Type /Annot +>> +endobj +269 0 obj +<< +/Rect [540.06 391.62 552.06 406.68] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002549) +/Type /Annot +>> +endobj +270 0 obj +<< +/Rect [66.3 377.64 78.3 391.92] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009341) +/Type /Annot +>> +endobj +271 0 obj +<< +/Length 3406 +/Filter /FlateDecode +>> +stream +HWَF}W#eZ" ؉3< X<8n:)s_sKvˠn6[w=/0`FP7z?f}U}[Py~)ܺ/-2<}N\C%W*w}#C$`QhAEI.J&0EȄE60s-xy=SJ鼟7#'\ +=rSPm5^^ˎyM[vfDv +?dY̍M( +͜Eë́y p<%~Ɇ7׆C_Ttyf:iGS4R]thO#zOS.Yy)mURr4 )+Fup}lҎA7T8jlH, g`ܘl\6m4(CvC E8T'ѸB[ͱ߽)>|lWC)J8E|C3) !x"pw PV+C2WƀMN͆iuݓd눮1$3r{0b#HV0f: {Z.Z&HM c50w xfgT +b2T;~G aZ:,\Ҕ`l׾G´+PR/a +y$/Y^gʍRf@ y(E}[H`qVāiȚhno+p= vSvʽM'z|]= `f +P[x!\ pU9؀d:^ +bJ m6hJ݋ag >#є_3 G_ӄp;) Tx\ߪ|VO=m^s왦,0t߹:Vr B"$+wt^(#+צjn(MlMʾUrQtֆׄb(/;.c_Gܮ(Kщ0ՓظI$a`f&0#;xZ7-cceE3= JZ$HSz6  ssffRVK1oKfzdt6h^\mnM LgTWW! [1ϊs-7ӟz@xO-+شki+ȃa~Fu<2cq+wViMrݤC esr-һg +5&n՜57< ReqI''9A4wXƂ^x}˲>{TCÓAOv]zv.诎$} >h<<~]A*Z+fIņ6L/&U.BW (U Ky!V|Fϛ +fBh=>pMLLُ"g ?e_KE? ,fEM:5eN"uV2$dAg8V7 +9VJՔtX_zBեfetDEZ{ ~ 'ښh]WY;a2-cxPL (AxY+E]շD}`X9 2YSj5,9n@Np勝O鐐(?!(~#ؾh jA3[fXˮiA~jKK*͋!sV{O"ڼh}NzƊ'|*9|.U'wزF&B|M0_o %>ãw'hw-@̀#c;k!~8臺5rBCW>n{X %*t  ӳ'؝{XuX pȡ%[6]$ B2Ec܏owE?\R&Fc"K S#{VV%6?WH^0F OPDk3OQyjZ,a\ua`pCD DjKApM>?CiܜqH#"?]B5 ·iMln^i.odkY_8oOZA^8}Z}z%;⒲P_iE@[2NI* x-sAw,UδТrU (ڮ/ԂJοs4i'bՙP&icТ#8|Uʚe~K MQk]Yu1݁'t0XR]uJ7";'F5P¹,eՓ۰pvL+6J>ه!S|4]a\[ή%u:Evnt!nbO *ہ77&GĮ +$L-L.: +ӛ',ۈ qTqk h8?sN4i/ ̣ftVe? ;tKĨf Y/ +w,~}<\R\ `CgXPGٓ;4α]=6adHǧlkMlM<>mALy.pHC9OUPV,-,g~ybd/b +2%,`ұWHS z+i Kw:vA7?ue@3d"SSG):1jvLcDK7똕e zޚX^]-fBu;g)oT` +endstream +endobj +272 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +273 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +275 0 obj +<< +/Rect [245.4 709.56 253.2 728.1] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002509) +/Type /Annot +>> +endobj +276 0 obj +<< +/Rect [216.66 709.56 224.4 728.1] +/Subtype /Link +/Border [0 0 0] +/Dest (G1005724) +/Type /Annot +>> +endobj +277 0 obj +<< +/Rect [54 363.66 111.84 377.88] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002533) +/Type /Annot +>> +endobj +278 0 obj +<< +/Rect [250.26 234.66 308.58 248.88] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002814) +/Type /Annot +>> +endobj +279 0 obj +<< +/Rect [245.4 383.58 260.22 402.06] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002533) +/Type /Annot +>> +endobj +280 0 obj +<< +/Rect [216.66 383.58 224.4 402.06] +/Subtype /Link +/Border [0 0 0] +/Dest (G1005835) +/Type /Annot +>> +endobj +281 0 obj +<< +/Length 4085 +/Filter /FlateDecode +>> +stream +HWے9}Wm %t0;3766hvITnfh2J9KZ^-֛.ؼW5wzX{<웦|e?gp=֐KSaլXسժ4M3_51#ǫJfl>qh>6$ʴĊf~fv\DRtK(0fŭkz]6/y9r3{ܬWռt긣[a Ejn4"E uCpBœl<|r;齷s,AAvPP.A(y@H@HA:(&鸤/^6k֦\dyἤqrGh$e-R/w_[b0D a^<+lV>"ZpU67ůon{`w~3AS.v%05fv{v|߰lb/w {4 Qaz +Bm{@DRK~VuYTڥV-{?ٲ6DoŴ Lu0E.K=R,Kl?7EY~P_Ob23` a$=k_qQRT[Uvt}\px1FOaeqh,d=uqf(ˀB#娧A͓PkHgÙoqksŖ"ՠ`*vM)eVBm"Ii CmNH}v=IAP/cu_# i밣޶l1W$(kTP2&..*밲6BpT^EYSj1^ϼ !m(^{Ma;W^=#*lÚ1\ASb\YK4@[ ;ڬU$Gw"&z'5ZnzaS=da~;h 1pٜyWqm@RUmB5O?9TŻ\?L| S;A\fI5sڢ / cbMqU_Hr |;/``N`W_ƪ8֞xQ}u22*v,B5B=(l\d^")*58L >?Fh>5v:,"dJy{4a4@U2JC`U3mKBI<?>Ի᠉c<9vcv&3'Mt0i]Nˡ6aJ4;犀 %d>$pNo"Lwe DR^+CxYV_fK|`YHK #iZ/zo$<(fMKHxt +d3gtEQ\+GQ)Rt3I|(tZxQ쒿2RhЊ˔7*$-`ҷwbΜGyJޑ*ؾͫkĴ/+eq{//ȃx ̅~~ ZH.xs&E@kĀpʨ ǹUPODzك+ª9MF]9bGBh12UKYUg*ZgCYf @t2Cԑj1ևJT%cW¢Ŷ2:)5(?{тXt]&8&+nE04]A^CKWltGmP LA~?e%; W!=#u~dD$7S%ɶ=ޝ9,ɭVW6e8ij]`H&YlܐE73Zhr竆qT;%|oڂ+\1ʭk654e:aWUc? +`@i ejr߯xji][wǂ' dt~WKEֻź֙?g=u&a&j\LLs,Ll0m|C^p3 4EH'.H/*n&gEy59mҲi" 7x` +6dZIe9p0R ,gQ{S5-S|t+n}\&_m(8w8_DZ +ؽ/Eri6LJ/z<䉷of[oh`B>σXfϛܦk;q*w͙$SjcVt@BF<)Ҭ. z6gV0CӆÏxF^~gʛ,V7/?&-ٓ%BavrLۥ^dV&[_fAHGRЕۭjhîfV;E34Xʦ}!fnqZ:n ǯ9:brX:@1C?qLҾٵՊbbSLn:Qr~bf(|)u<酪 M'+SjU5}C;jZqW>xNAWIf(GdCɌ)K,zٮK&N 4rfB¦{wWF N{h]'Gtd vϯ9 V->&fV!=4\,|i;vڿ O +endstream +endobj +282 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +283 0 obj +<< +/Subtype /TrueType +/FontDescriptor 391 0 R +/LastChar 122 +/Widths [278 0 0 0 0 0 0 0 333 333 +0 0 278 0 278 0 556 556 556 556 +556 556 556 0 556 556 0 0 0 584 +0 0 0 0 0 0 0 667 0 778 +0 0 0 0 0 0 0 0 0 0 +722 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 556 611 0 0 0 +0 0 0 0 0 0 0 0 611 0 +611 611 0 0 0 0 0 0 556 556 +500] +/BaseFont /Arial#2CBoldItalic +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +284 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +286 0 obj +<< +/Rect [156.84 435.66 214.68 450.66] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002533) +/Type /Annot +>> +endobj +287 0 obj +<< +/Rect [104.82 713.64 116.82 727.92] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009643) +/Type /Annot +>> +endobj +288 0 obj +<< +/Rect [139.92 713.64 151.86 727.92] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009648) +/Type /Annot +>> +endobj +289 0 obj +<< +/Rect [104.94 613.68 116.94 627.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009643) +/Type /Annot +>> +endobj +290 0 obj +<< +/Rect [140.28 613.68 152.28 627.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009648) +/Type /Annot +>> +endobj +291 0 obj +<< +/Length 3008 +/Filter /FlateDecode +>> +stream +HWn}GiW Xu kO)(NK`jޚG ENU:m,,>ۄ܏YeV_߰bm%X(.4 b;no_i{@Y [Ldd_p$I,;݊^JІ> 11>n#odx{·m3eK :faȶՕ]^~hֱ֛b:/_lǢ2f?Yhb:@\V^^Yf*f_%Qޱ枳G4f 2h2pYz09YYYSV@y־^d|p? +-@>Os)xA/%#$W*PE %(y y¢01.odeÒ!tjk_oYj=[QE2⾢T{&/n瓠Fv>SA&E5&i<gM {*|So/7$1?+D5ި5EP\+Pdž(%RcϦ&:h" s㎯( aCe9]`wR 72~7Sj̷bsX +3,9*ӞaNi}o.bsd"ddc^|fےEu y-|nŎ/n'Pce\qqŌtD8cѢ))_h]+<#qi#5{R\86(O]^bzAڧ[6fpvlM\K̺ƝNGiV;F+ Ғ_-2ȕHa69[W.unF㦯a+_&%5v Wf@skГx[փVSlV-r  &Tab/N>G%)]y>nGLPSh9j'h&H= +D(m++ ua~f4Mc )ɵO?nL$nd# IN[$rPhXhRP1~xf酬K ?1CiO9kw +r:;mœLj`j:i,KV<"mO qL E<sJN`7kۺ.NuH>Tǯ aOBB<x.uҊ)%iGR_2i'4Ѣ;:E֩3=E YY63z95̗7y0`I'Ʒ:ZQDgeqOϵ:E֧4>zs{/rpݨYX87{~HX(a9a±f XZ%q1Nr +ǥEБJv>wJKVӪ9#3`\6K [HpU\y4Pf_:AUj\b䩨i A-lwn=6mTay \(NJ-u@/er)I RFLN֜}/l[$̳=f!x 9ļ{g*LOw+񝘄e&E[ d1и(&l/]~X[w n=3|N/B$,Hvjٹ~AAj {Oշ X*SI6OM]7GE S̽ھëT/J(_fp zV:۔ +gPqTbڻ^w3RAW)W\]A'h`9NhpJB5*MSw낥WQDLO|q"J%CYľƉ{T~lnEEn[[!*12ն^81g_۲C}\!J ٳ d[~SZ!>&Xn*~c<`훅GX0ќDZs'Uvkv/Z#O|8 @F=>6ITUUTY 0ψ;YGRTMhh'U&T~tZwx7a_0 '{k41JۢT0J&'r2&}WbI<ʪ34R.&NhJE +F*[sIOYIR륥hpVB +)K;UJ Jaůs\|$|ס >KXFz[_%{:q-#Cj1 >[KTɣyJ8޸uFĭ X?ihNgk| +endstream +endobj +292 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +293 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +295 0 obj +<< +/Rect [349.8 558.84 361.8 573.12] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009648) +/Type /Annot +>> +endobj +296 0 obj +<< +/Rect [394.14 412.8 452.46 430.02] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002940) +/Type /Annot +>> +endobj +297 0 obj +<< +/Rect [273.54 301.02 285.54 315.24] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009643) +/Type /Annot +>> +endobj +298 0 obj +<< +/Rect [372.42 266.04 430.74 280.26] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009643) +/Type /Annot +>> +endobj +299 0 obj +<< +/Rect [233.22 210 291.48 224.28] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009643) +/Type /Annot +>> +endobj +300 0 obj +<< +/Length 3945 +/Filter /FlateDecode +>> +stream +HWM8Q4"E#`$^̡Xe֮-9_?HQ_m'=Ei$U^z$EIB8)ko?]ȒLab.yW~sv-YP 9 s;zD><_c Y kޅA¡u|Z/,3ega,Vt[WU걕xuՖ?"g=տ3ØH ..ye>>?9liK$Its>駀=.|wDA_^Am>"!RR*zq/<"?Е{>E]mV~읋JʗE`n(< Gq$ġKM~*"ye\0_⏐P!exsa'x}|Ώf wiu-=QlcYi5kÁՆʮc;mjg>r!o0F]YWޚ}1oӾI>hwo m+cT1)xY3<뽱'oq0&mpvEp9ʣ=cu'}D}Uc`>W)ʂؖ<~8i{~)&Ҡ-2K8mU51dҒ<1~O2,y$Vvo(_bM'We4v_VQ;>, &p^8X%Y8aAjEU}( ( +"1xkSЋĢjefeQ>ۮΝ+>`> e[?XD|mh: u{ɏ_L ]NO("}=S00&,D;}w+(!)J(M@׀vfUZ0,SH 4 KWu7](99ZG+_Po*J.$@&A&ct Z_үZË9;W%gC6ۺyU͛$2hr~Sv\K%JyNᙡ*mj҆3Paԋ RW>8.X{!BrŒ޾'0@,! WĈA0/#!w[7'=ى+7/u Dn ea ơ=^jܖZ` Sgnp3mPxWu[j̱C*<Ȕk%`T{@e %xٗG!U"OCC֡85^kgz?qD-.J rz&Cٲ'G耽Joxd Ƙ:@ׄ!%́@%Nm +ɋ,=⎷W(@q"admKN$J5xJ'>|@Wʽl2R-a-0FVJb#&:s +\ U\cqjFqLD8D"D$"[(&2- S8D腈v4 l_/tfj^hml Pv$;SKg8b T3Q@%G'sKv+ycy(3QÒ 4JcMM@n9F\nC zb8/ F'聴0т׵A8Q!&daьruTAffA7u es ʡiSx_CWYy#*\'|\K?XBsGNhw\p|QWr.a̕r+euQJ@ct}_ ΀2Z6ʔ+tk{#O'Cij?MaNgTG)2+*i ʞ+ABdWV)i i|M9`¼ڋy*ă;bI)uەk=Yzڿeafkr5OCa] _6HRy +g Cp!,Ec>7_sL^zIHNg`(T3qruvLǽc}߮ɟ!c˝cՖv<ؖCUBd"Z9/!~JJ݊6+5 'x9L+ⰎNu!\Qv.Sui 9Pf ߐ&Z+/7ѱ8bvKyLڙwC[4jr +i'R?$ަ[]M>}\8`ns"$_!+'jdR)tD%V]*yDg}]U/.S7Ьq$UHNen8fQ:Aޛk*}zѴ1e)5Oy80޵ۚs`2pxRW4YAT1\)U4ˤ!s&9lON:K#[Q3GQ&wj!K  "=n}t9CBNi[%2W*^|wͩ=SQKwpi絠z-fdPHnfpCW07 .qLȞ)|gii/eʩM3ud([q^q@2nT+5df0lS{mW&fo;P?B\A={Lk`Rȧ6 ,5Г\5з%L;pj=.6:D+7_PB>ϲڠҡjϣeMT"&F)+*T˛@weO5OQF8G|-$#' HqVI 8wޯ.Q[~f2p=?z:>Ļ+qa9?UJ9\U*lzzʁg/?jk +endstream +endobj +301 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +302 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +304 0 obj +<< +/Rect [104.1 713.64 116.1 727.92] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009648) +/Type /Annot +>> +endobj +305 0 obj +<< +/Rect [470.64 697.44 482.64 716.46] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009648) +/Type /Annot +>> +endobj +306 0 obj +<< +/Rect [104.94 520.38 116.94 587.16] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003043) +/Type /Annot +>> +endobj +307 0 obj +<< +/Rect [140.28 520.38 152.28 587.16] +/Subtype /Link +/Border [0 0 0] +/Dest (G1014746) +/Type /Annot +>> +endobj +308 0 obj +<< +/Rect [432.3 520.38 444.3 587.16] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009648) +/Type /Annot +>> +endobj +309 0 obj +<< +/Rect [54 272.4 112.32 288.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009648) +/Type /Annot +>> +endobj +310 0 obj +<< +/Rect [442.62 455.64 500.94 470.64] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009643) +/Type /Annot +>> +endobj +311 0 obj +<< +/Rect [496.8 195.42 555.12 212.64] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009643) +/Type /Annot +>> +endobj +312 0 obj +<< +/Rect [505.98 483.66 517.98 497.88] +/Subtype /Link +/Border [0 0 0] +/Dest (G1009643) +/Type /Annot +>> +endobj +313 0 obj +<< +/Rect [387.48 164.4 439.8 180.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002509) +/Type /Annot +>> +endobj +314 0 obj +<< +/Length 4899 +/Filter /FlateDecode +>> +stream +HWrܸ+ ۣ GpfjƝJQ͘M$[}flO\\ \\9~ҊӾbې7x(X($پ+Wgki-[0?}:I(dfW|P`nmh_p_avң%AWF{ynbmΔM^=g1۷ϛ~fN'Bq"2S:?5l iKȣ(vfGBZwmػE&t@{M3<ʻSVFKz\ +.ed1z}I xXmf(A*:A Bs/H(bHVh.bsJ;,M!Yc<[d%Kx ΖTcjͫq_Dw7`'2mR"z|bK˻WM 1dܛr 5Ll޻fyɐ϶Nai4;sΞܴ-opP yto`J YIbEA)d,a&Ū=ɾ4AץV*R پNF>-}}x(^/`&]˽uopl1mY#AC\cv;5 ]La^ٚxx9E|Pp2VYkNF(ww y,g޽|5wqnD=g.ԞS~@ E;m?G*+?,3(5 fs!À„ݯGS޿Xs6JYu&=@:P\Y8m߰jC49}U۪=t4ў:SF +3euKB =S @n #,SѦNM>s7z"|T}l,٩조>DN꽗 0ic~?r#+:*$Et<7ڱc$%nAΈ k|!(bC9>BtPو=A\CF +GbLIJ~2$B_d¥J eJcZ MUp>V7Y \!u9Uf=d5dql: r'z >Wz](_*rDPz1mcTif6JQGAg !Fv&SYؓhEeB&" J-D]/x܇ުiv=2zo{tJKǕ0ɦ $kvŽ3ap4Y]p=fnd_%3" xfiqTx+9/I +ZCF} ͦ"Pɨkֲ$68AJQJu2I JlRwPH6цԖ \(җ/͢ԣd`',3!>&:YuBb?h; 98 e=ZnG%*x^+lZ YwS X(?"I@are UZCs~t"$,FC,;04( ai(NCڢ>,m[1/?8FB o@/eܶỞG* P\U>J-VIB=XfI ,^Z-Yy}/xNaAI +ʋFI8bMO3 3!>YnV[*pOm%>j>=eyU̷* L fYah3]սN]!y/x2!nXa&Bj4M͞Ak UN₮\F1!Cx*bH~(6R/ڥ q _fګ Nfȕf77EE ְv}س4>L3CV:V4|n ۛk5aE(5` `iduMU eHДQAۙty5[TWj>*Xz)ϻC@!g~̨CMf2`LnhO/j(5[s _kR{U=RYls#sdE9b/ !KeqFŚtTI2j$Wj%g`Zca3UJR(yej,֕lա/@q)|8dgc1#w^Xqf\=:,Vv:Ӑ2px#oTWwz4q{~nV O=x}ںMG`[c\즜JrwGw_43†idxaJ#Bd$䷐&H8/owۘL`!D@}+CnS +8Lݠ,/?b`5gbEvu8u}B.Y|Y<< l~)]koMdj~ʼn_S+%yFV#=/U?WӶRJ$ ;Qɿ8C|F)Y& NG-Sȱ2<(2ڲ:9v P%'t`WOGocoБ56 [rp"( +K}AexvU7"䝭ZE;zaAg۝!?Ն2X)*j xJˏPeӣ{RZP lr3d+)O*5$p97%)=7sS_rDT!9M^ֆMM&EMYr-7hۢ$7lYd.Wӄzl> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +316 0 obj +<< +/Subtype /TrueType +/FontDescriptor 392 0 R +/LastChar 32 +/Widths [250] +/BaseFont /TimesNewRoman#2CBold +/FirstChar 32 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +317 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +319 0 obj +<< +/Rect [74.28 524.64 126.6 538.92] +/Subtype /Link +/Border [0 0 0] +/Dest (G1002509) +/Type /Annot +>> +endobj +320 0 obj +<< +/Rect [163.92 524.64 222.24 538.92] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003204) +/Type /Annot +>> +endobj +321 0 obj +<< +/Rect [92.94 430.38 98.94 445.38] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003259) +/Type /Annot +>> +endobj +322 0 obj +<< +/Rect [122.28 430.38 128.28 445.38] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003277) +/Type /Annot +>> +endobj +323 0 obj +<< +/Rect [494.4 430.38 552.72 445.38] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003216) +/Type /Annot +>> +endobj +324 0 obj +<< +/Length 3500 +/Filter /FlateDecode +>> +stream +HWr}W[1;T*9]uJ H"ܥXQRsz•>}Õ5)^fa&g_Õ`YIR'` Y缅vK&_2:B}wo Yr8咬--Kfl +Zd!Ι:Y.lREE%MSo/VlŮ7^z- GJt4\ ,oaoʲZWcXb-8eVo?9PQҗ,Վ lK|^i#06[yuH"UIU5jM!W wc]n7%7$ (^ H͍'ӱp?.Q'T\fC+dQV˥C~tFP$+&'8ك +P k*Z7- *w̸QdPvfbnݱPXz ,HZK"oޣ]);z#"U~֛{v}C|WpbMA SjmB8G?V vXSn +hvh^HtUDr ϻ 7M[n-]UlÔVj͵"$Ig;eO۶ڴjŹXy#exF%cOՆ|k 9B. -RDYp#a J,Y:T շgGҦ.1wiຉ_V\f[689f0\ep>p1;g`KZ==vnMӺ[#7XdYK֜AxPTA@˗1*Qqw t9,}1II:9!u"[#" .aD&ΌFoɈ+cwnox"ɽh\݄ڴ=Vkڿ@R)T:.k*ť~(>xL=Ls !2BZdUۚ"pK; = _W +年/ +Pj*'?|p~{ ĸYɂ0IK@}*![V:`] IXP]k* gχ1cAV!;[X=AL1NTz p6 ::jd:>OSmXb@Ahzoe%Dߢ2y>2`L>CA3uɌUS͛h:>:YȓՂlG_bZ~yg(BNՑ6rE|t3r.=r&+Gtwsp췳 H*"KɃCs7 {9\<=Ѓq: chh# +}nQ{ N!M7שXHmD<͋>=f ?M~9%plpQTPuZHؗcwЁ$8wSltY "W Ů~՘)kTK-G?e>yo(br(CjHH"3hz<j/FLzvBA5Y{v +wT@uhkyu:>%9uAAtĞ]i :/ߣ.iRtG3_uI[}m{jvJ& +#nFй?wϓ4L(&%Sxw쵼F㢏^ ! )\+ݤGƍ0 + XY_Xkjt!rO$YFf4:{OFinQG<8opU=Q;q{fgeqkSo=+&Z&SEN\"'"1W\j*ؑ=δ%qgTǕU9d:3Zi@p\ BKO4ɮ%iی p"r<%,ʭmg+}v+ &ذ©‡/;񱗍7&bA[)j!;aRz0GS?Jf3ڇSo\3 NF&i0c8"'OCF^tIΏ]󵯷z68o?*v}xlS۩{_\Ht1 S^]]> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +326 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +stream +HUM0WAg|ఈ aAh i)ꇚxf4MjĞ7MƻYPyik#BAZ*5T4Ns4(.^,n8ytB)AT.㴜y!灎+D*@R性7$W12Z.9]$yw>&8^XS"%vB7Q OaQF=ֵD=%_,wDz! ++!qnX7#+6Wv͂4~^V^%=u?ᄞ8iΐN?PPjRZ ڰcC|iVN Ҫ}ZڻcRQ/gHQ]M0 s!DT(k&sV2Ľ^"j=^YY"ݕ(̾Os=4 klj;i-If3r3)N{zj ( u7A+ W?X$]iߴDjwaQ +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥kH $ +endstream +endobj +329 0 obj +<< +/Subtype /Image +/Length 57935 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 940 +/Height 593 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;Q"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?TI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$zͷڪln{kDN*_7K/<I)F{ɶ_?ؾ>mK}B*un䜛+c#otft7ItZ )I$JRI$I$$I)I$JRI$I$$LL}efMάVs+ulk A0 +.7T=Cv=+K]\nlJmI)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$H9x~}ToɎcq~GJks%[O$IR~WV }^La[gUVyIMԕ/͟?m|zv]Bkpx/ZGJn}+,td_nK~sd;k<Su #+̛C c<ĸ_7Lv!ݟ7.?N6ccSC]]ma#~Fc25%'R'ar?Ji~:佇-|K=Njmm>B^+$oDt*ggJJi}+,teTuaOC`5]I%4ct=Ow.vF~f=1(ײ5D O +I)I$JRI$I$oXHv^2eOAk0n ]w|f:-96}m|uhpc߭s&=8''sDݗ9Wγؖ4.2a-Hsubx}ukGٔ͡דdoևCJv'\UҟWc>;ck ey1e~D4lm̧c>]82ek.^1^Ni]MWncm֖Y[s\s\ӡ,L.sm -:_Mlm!Mt:[Y0][ v!)Id\_gZoF3V kKZ)XҲ˨qƧ̻v=oab1a bK *mXWz 뽦̰k#̋;+u8k'2*v3T].Ǐu{c`ّvEFEw*elkG2RSm$IJI$RI$I%8=k^9M m$_VP@%5D{r>۰s)0gRoPfK,ʹ]Ŵn2q_@ S +MZZ ch)JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI*uNa*p"A3Jm$~fٚ썿yKNFMBwSu%K_[v?%/dIR_q^L?_eV=5Md[9IMԕ/ֻvvMɮVr_qdVGIM_#Wrin ưÈB¢w}qs OrLج5RN ax$힘*nCox%8kcVK~~sd~i}٥Hcٟ5u$WYd~IYU]I%4b\^u[Q7}&5N&%$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%>'1?ZzMRr=" W~oCi=s9mT{N=esvsY"ȃ%rfdfdffWg]tC|O *tȮݣ+b0MqD +KW(ur\6Ϩ3.dHH;EbI$kV-4t<1= +_pwD׵WK۸[i$'rٿk'k=>@3Y.0YQVbWMEs2q/%|4Ry{]&Ѯv fHݶ@S\M;eYw?JN>nV7U}Lڭh}v05pBJfI$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRJ/{+c`.s`5$~?gI%7RTkZ/^=c^\b %O|L~яFJsǞ}6:-w—.7ĿySu%K?+a)}9:yWSkm}))3􌼛я袙%#`wj{~a%7U/}% oeu%4ltkSݐƮ} {AK>6ME'oWRIM/f;FÎQep0|zؗ2Jiz}ecW:^tx'P[s[?ڏ%u$鑙s;7{iv3*wȘKFݖd^8x9BJi~gEYqQ[jdrJRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$*=s6ޟz}!k䴺A*羿mTsST?@f[1~D@sJ|u_Cʜ-c@hm#MoMҽ-ni?Һ杽$|:YX"Mdq8>Ksa_/ڽ?P}b;5:In{=բ NsD/Z_?S;m/e tp^]gu*d2_\ƒkZٍbBq>XZC}$UI%)$IHnŢ(~- 古5T8}/9sneٳ~4Zi$lOa +|1f mg `ljܜ;Dzv]S%A!Mc}kKK\Zni<#U,u}ύx1=V9o`꒝ WBCzr)#8[(u,~[mk{x:]C >n͹vxXa{gGp $JRKYyUueV>C\Z-r@1Kzc6̮%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$̌ZK֐tlufk澛kkm-";@ e +5A({/q~;mi:6\~ArS>WP6klh{C$LarOG4®s0+ueֽրbORI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJ\_հ]_a0׷ѽkO]3!2T8K= +\Xv#w~GI}KkP345s?'HI zW>O.lc囏Tc&jH-į@]Vsz.MphxDI-cC wsud{lg!ė}\+$뽍]\>JmI)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$cu +sv=ǣw4eԁzlK1}we[UuLq5#c`*#w\ #vq?Hż.oJ?{5w?$š, .$<0~E4ZG 33*:\m9܏&b{_l\'h\\O57mw҇_k?h}_}^h 3+^9}fŭ4՞~}oOZpk!@Un+iRI$BI$I%)$IJI$RI$Z/mnm^XIUޟP2;}d<eO=sH#VINuSR{-7)ga6qԺC afZqun0h!pal;}F0U_7tP?cC 85RSa%?k~HY{/2, gF`K}eMb]X)cQ2d9ޛ}tINI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$]?Loalt78WU,]K mԔ_geL >ַN&x[VU~eC1 Mm#hnZ`׌FeQ{K -ߍ>:nOLt\k E@Fʮ>if<?z=}7YU({о& h,ᶐ5Z71܂2#PA(4eV \BZ1Gj;6I$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%5:wޕvzcǷ#ӝ&9wAax=fz].em 2\a%̉W|G\E*ǫl˥Y0DXݡw+qƎ_\a%'=F T"{ɶLx#_1{|N~ 8 Ֆ4vse$~[o\gȏO.{4q ?Igi?^~֚˽lڴπ+OC#ӓ@${"\_\haʩc‘"\{I%I$JRI$I$$I)I$JRI$I$*v0Z궲67#l7h4VINO/Ḭ3&nϾ:gs'%G6V`g5?6{+&o/KAv&+}o3*~EQ{ ׶)2K'>VJdahgUkl8d~Ukqm閽{.6 1\8_4d7rJvIQoFۑNnK^3h6qycp e%8)v]yw2q.ծZ[FOL-sd[us2 ?"UV`emcZQ[fnI%)$IJI$RI$I%)$IJI$RI$I%4W2E6S]Tr7^JZ>Ώ:v 9e{tki$nA%zo :=nk}}Bdqh DCx$>҇u5YѹAAADI5 Zn.QO|-LX#5m!MwjncdF#PPqnXL6׭Vo i-'kIMI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%<ȴvWc/KYS@-܇N ϧ& EOd|K1l3e,zq~L .kvc&8_ G. CNX!c|ÛKfE͸ZͰG3uxݱ8;iO]NGoho X]jG?uY-% 'SjxYh;H.lLlZ^|a.F\?'x% +YYR  |,C~RזuAvXcH:4@Hg4,gÏB_f aƟ,4MDqGf/x)L3qiw[mF<4À"A[wI6 :u^uyO2~LbN&1;$IRI$I$$I)I$JRI$I$$I)I$JR h~UylS]V:2["cSS~dS ~? $̗vleaXdwfWuY\\:M΋YQV0)-mxQ[!V4LIIMnu/mZak-s\4 5wC+Zc4Zw8ߎ}/tn{v@W7 հ hܼɭjk΂4@ INH8x7'q읗T: i4`FIJI$RI$I%)$IJI$RI$I%)$IM':[t|޳[,leu%)ygĮ3C_EX @{,n?D/S\g·+- <:}nϾLF]r@D)FT̆uv7G1@>?42 +*H)rZ7{tmzO Y`kkwWcts4i3#C c<ܖcFs>>%)I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI.oau6tM:ٟUkHEC G~iOn:!eZk*41ޙִyWp_pղx!gpaCm6k{6AOaB"uW,_yZdWk{vk֫ w~ :,\@S9kE?ez x?2<"^1^D%fCM`v50|',,F}QѳL_˙gGK5wd4_/d7\??fwݦk#`AO빟X;ƣ@ z,?ޙw[]:o|yKWL)2z7 <ClY\= I0HW/\ o`A{"W佋/ZoXi{ds˜m!{ sZL WI%I +I$RI$I%)$IJI$RI$I%)$IJI$RI$I%8}]:_U0[m~כ*uu6ocZlk#BCi1H {3lgW;`Z$QBvM9u5e6Ƈ is + 'tbfշS[+ }5=>R a>&F;2Z L*E mѮ]ǑIIMI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJ^q4݁l5Q[/ﰺy 6@z:,_;L|鲮6^1&gA·|y;c^e9_c{ ӧ7}Ϳgh{D~ɕ9簟M:|SzWW͒ܲ]|nH_i\wa6ȇN K{?~>A $Ȭ̐*|l?pg_L !Fuv/VAf/gpGLvX"[ds>(>j^eϼj>$a%˽ZKx3Ϛa1W?ҷVšl-IS'۫I!?k4@ _@^6msF4殒C/_^3_g^~zpq~7S}n-.k!8cG/gOo31 ^;. ]A Qgcp%E^qOrXcsIL~-pib,RI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$9gZ/3%2h{]雱]gnbVxA uKoң*2I5Qq|@cXgswo$=So{]U6Kw4Hh/l9UnocUCHz=wUd +>]l&4INK?ޛԞ(f]{\K}4Jok,h$$I)I$JRI$I$UEʲhR8+V_ۊԔI%>U8qM}_f' /pwAG ]W?TM={ӎZ*{OWn_;"++L=;keOeR6o%LɩjBtsJO;x}E$MBI$ o[mȪ}+bbyk7:I)6OdUS1<9Mt{] 'en*JؘZ:=6OdUS1<9Mt{] %'I$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$S~.P"Cq"ͮ7>+-aƧoCh+kguWDZkŪq.\ݎo%=[u~w}V5j~k2Ⅎz7Wi:\1rίk=ÛƊ>3d,|p9Dp:do(-hU/BWx_j!ϴ? }gwz_ȉ#$yHg4,gÏBoޗ"k3Hj2/ ]}h|b<*w*qݺ۫L?ҷVk KЩߤƲvΆ;n3Ba]%V.ooJ?{5w?$*m5OcMykiKyO]O0emʈԏOVZHynȯƋ[Ղ&~F| &D9cgG54bd4\7D9w>+:94b?v\Ƶ hc/:hJ׆:'Q7`nSv]FMi 1pf:%*I$d)$IJI$RI$I%)$IJI$RI$I%)%_#Wrin ưÈBus;YE6Y1?"*_mwk?E]sԽn[@i 2({A撛*^Ywλ=ow;DY?:Jn}8oT։0$9UdaofEc \pD)f=1(ײ5D O )t*ں.V8~d +ǡcIsk|&$D}d\e09]l΍<SS6nD<5y}/q%ЦÀ?HT*z}vkN+^}"{͟?m|*YYQUB 6ߤ>ݺLMGՁp2}*ɩص1e?+%KgNoב}OAɻc+cSY?U}WOί֎ZCgXyQI$RI$I%)$IM.ߴv/s+[WRRI$8Uuqsj˦,s 86Ɩ8D^/;#l}v:ბK|cѻR55]߬F>ceEE Kw wIRNq:`4eT[\{.jKNu5 +I$RI$ o[mȪ}+bbyk7:I)6OdUS1<9Mt{] 'en*JؘZ:=6OdUS1<9Mt{] %'I$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)r]:[w@q`sH;ѨٰnK{+*[? +vZ2({?_XO7 +Ի#ͯi]Wc~Egץ]_gߤƲvΆ;n3B^JY/B~۫:ω ^5tJWu3{V ٫%0i~KuO]O-{E"5]7o^iVcgG5/ղx!gpaC[U{gԣ$qi 8H4YԨɯ ;i@V]W+{zi8VָT <Z+n׏k:[kv;{={jcz j]I%I$WF꽬71)):J펞j{{/h>S)~{ɹݱ%;$J:}iUk~甶u\j'?⒛*_av7H^<%'r^']h4o{+c`.s`5$~Fc25%'T:Momc!sj` A5[IM/ڵ;M6~= +>nKcʛ_UaWRIM)6{vccw߹qٺ[8Ԇ>|アWRIM/ٛeGxE/5SK{*I)>.6+ xԲxh$I$$I)K>ΟߵuPzT}ySh!7O;f^^Q: vT}4H-iЃ65/ļ^N#㢓׎Fؑ=V@~\_m=2KgioҪhk\yc,68wLCGm;˝O"{'.)H$n 9 +uk].xT~W _?[Gվu/uVՅa-s\ڞZj+BjSKUU42ZִCZ֍5LX=GU]?;&)68k@O;-5dT22[͵5{Mv9e`GJo$I)I$JRI$ec+k żZbgCd?+d}cx13*]F5%7RI$]31~%G%סu:O^bUGl0]Xh>2>ƶd=^ڭl{0>]IٍOQ5ns͸h oytp??_JBII$RI$I$*/7%oFѯdOܴAJĔ4mG1R>?5 +*CrZ6mvD]O$3!ienpԵODI)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$UEO綪i}ED1aZz'c{3+W<ܹēa" Gִ&fK9w;Է#ײ]d5z\4{vm* +=;2+!Chtj<:nHѝK)5|u98޳^=m~<+~mL` +#~Ea>-+lu9]nC+h4*Ciqv958lqf^EzdX>uz6-? rk>%74;}͎r'1 +8e625ǒ(DuDj>,{{ksoO\wz_ȉ#$yV 7$O;uPF/k J'ZqGE^!?ҷVk Ka.;2tV:u *qt57G&6PƂ!NZyL$B&uޣ!.E]_~j~It^#tCmitRUumk4ng\t)͆^}nO&z͊3R!uun`G{gNz/%9i;@"6Yߧ}l \ZkaSjgq?՜#,vu0x";}OS\eU{!͏4^Ip߄?*gɶ'ohyNݵ~S9kQJ/CsuU5lmev4Y[_sicKgf{kߦFfM_̩"ap⿪U02{5˞'c8<afqdâ֗~-cٙ6Y{ h>q(XxEToɎ'hJI$RI$I%)$IJI$RI$I%)$IJI%_;;b[h۰ $`:몢sUU4CZִKyOѬuxd9cj6Ϙ.F,^2ag.f3L t'iԓsuZo>"-]_/GeZ|5@cuJs@鼙:KL󹠍|Nײg]|Gm &^>sB7 2\+zvHG%Pd٥u4ockZ}qo'LalAAxZVr>tZ]V̈́8Hi,=> *)o@!;>׉F-8xmTI։q$ђId1:/Tʿ9Ʊ7lT6G.tratkV^-Xx]y9gls4vѩJrrtܛ,'spt 9?lkw[=,d]gn?k*[2njm$I%)$IJI$R.}wYܲC -`5uR?l9_qjJnI)I$J|]kcv==/9}ca._fdo Ouz6X7K~>ˡ0m$xQ~?x˯|#Ձ5D ȝI $RI$I$$I)JF;F9 hѶ4kw-> l$c3!ienpԵODcdcܖcF>>r x asAkv[s5-p#Q $JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$ӏYUMy hIӔ%KJ:WU]X][~A/ڌ~7?}SI e%7RT,ҬVIɲ2<OcT['3wb>ih6J6.iS-X{Gl-f#u.,d*CXg5mؖc'uOz}2YѪ pmX=K۹ȥݍ]O暩m۸s>)GgW݁k+,y8m0WV^8kph1Oo>: v u]#5.ǹ/>ZBӗk?=q9X+1ҳww!?ҷVk NiǸVF4Z8==2.f䓱%Sɓg0asRfW}Kma۽<|?urZ%yk-c1 r'0/_Դ^/kS>H-0 i9i)_W?}<7Kl@s؈{'2~?/+ ~X'{kkݸQsdDZnu/mZak-s\4 ~EͼX,z5ǫ?3[$[Ӭ hVKh7Xk ˨dI$bI$$I)I$JRI$I$$I)I$JRI,[DZyִJCu<0`I, +n&1>M4 ֖Ķ7pÒ@yiy4,U4hd8 3G2{A`6vkkw{{2I$tOo)zWLȘ ׃G65{Gwuu0yYA$.-!  qNY>:%wW]H]ݥG}Z];Z?oǏsIi/8s8k~)2 +Ox/]tKK^we@<5Gtցwֶźh7UFٖA1躭q7 џOʽ Scj+nCc_7*wDlI$8z۟7:Z{C5q>Ga`l[:E}c89gc 7n1 y%)$IJI$RI$I%)RcNKk2]?ڴ䮪XҺo㤦I$I$}6摒s2]K^ld:ՠ2\Ƴ^2 r/a0M5z}O6ڭie5p5:BoL3pȏtT{#q~>wy%/WTϴuW˩{mևcs\ k)[+1i\ދmvME>cҿokMny/PI"$I)I$JRI$Mqݡ zisN{K`-JGMXA:ADUnʬ9Xs'A`-57W}bڎ:{A :u%$I$RI$I%)$IJI$RI$I%)%X090IU?mtshݙ]{|))V{i&ges[}9}ySkӪ}))=fnln?"n<|w|/RN>٪k'޹ȟ(Jn~#/&?c(>I~v;fy{IIr:Ox'&F,k L8/'Zͷ3Sm՟S*>.6+ xԲxh)F{ɶ_?ؾ>mKո@!(2qjI){э\{'OK~AC%?Ilut>V^.̺lz}ָ1% &kmISK{f[c{u#hZ0Ύ7"}"}3mUkgk[" '#1z{\YE^u-D >Pw][ A5<{䗌r=)i]|Һ}%f#&܇73^4?EY[sX_Y6.`ʋLκ#bb`iǫ;y6ؤ;(q,ɗP8u'%n :r4fX}ؿW}n;԰[a/ړĝV@إ 6c9Z'>g֠zwSjzz@+VQ~'({}72Ҳ*C|txϯS-d_M5eKxvΛ-O'6}Z%\˘ӣCCdUVzGoh{D*FV;Ԃ@kӖ~ens6:piL6tX߭WwothɎXnjUO]zQ>,=*euP[>Ga{`ͱp\$$H)I$JRI$I$$I)I$JRI/=0z<8g׹cq-> 2 +\~t~|⑩%ē.c 3sU{\Ƕb7^.qZMfs,"y{Xȍ׼"~P9nHp͓ϑWt<+zELjh̒kZH$x*|촌AMv[&I$rsKj3-.5Ҽq~쏭=WNsYum]zmCKys@el>Z\]7Pnƣ +f@cpkdO: zU1۹AsQq5,nᱡ-4v3?J84;u |{^%/CZ}[YkuWE kvWQ~-7lskn&6,:` .Q;eh<]]0=k#VA8 mt)nʬP .sS`7Kl*[֯%qTZ]xt;)P)*W &Lz4Y $I)I$JRI$MXrF=z$h$N8<[i$mGs= u:MXrF=z$h$N8<Zus=cHg-e{cvmmml~sa%:)/=?}pȥ"g6`V蹢c?|Ѥ/XO_QGoҦ4TIR?Uʘ˨mo—׿L̛ٻN;SD +ndmUQvzk&9LJnO_]=ll,M퍧_ /0!]I%4_0-M[" KU!#M{C`Ȑ9B7ul}.fcxb1dӐց>ZsamLctfYSOzkwJ¾h*ӷvݬO tv;r~3IZpk@|6 P$hlL|𥉉VF6NKR_cW t%}c> tTWԦ ~IWN}7 Ĉ9Y]6v6y䪺k|5s@i>*wm(/t˯kGvK}&xN5w `z'Ohdj6n!wFhYAE9,a1^9yvm>h8NL_˙#@y'~;]B{{SmsoOB{H?tP8lf> fq0! I~Kc?5HlZ6KZ{K\$&n忿TYJ'־h yÃdxڢ^Zu`uk[K4>_K\ӻ[*}55x=-ž[Cmw۹{mcKX2WtںOϤ9e]cC"`?`qG ҸHl$JI$$I)I$JRI$uQS_e!kZ%szOx+d3`9 ^a>}l=w$OLaZ% . ;l|nK  dm__.i9އJ?Ùsu~[v7ɂZ?Q>YߣO᤹ <Ɯ5 2pmyߊNJ8KJ}D8Q;NX"MMVβ8cְ__-=&>~ 欆K]NI^Ǭz$Sfʹ 2]~<'-;4sOx8}SV|x'}Gql2Z)x G–VhρK'd6TfKO#=v%O*>֑'OOR +=i|z.\x Btg@%˺5^5"` H#^ {6U =/ltJSnFM5dQ59:ǦK΋גZ2c'\ǂ`Ko'N/[Y_%I*(EOlEH*sU~Zw]U>ڪXֵ\8 duM4"]s}J|4hta13 7O?6(m8-eeƻ5x>0 +SOQiɦmd[,ka5a?°~}CX̚Vk ENx飦[[~l>$$I)I$JRI$7|~ՍoٟG!J_Y7^G +_] ˞>eȹ<`nT2-7ٝ߉sQtFķ۾Q>٣[u]uNwcoz1*}S7Ɨd7kDvCG1K^GL⃓v2W[dZhvgW@鍵 vvUn3#12w)mI:SZ8A ~U%a}Wƨ3\][~~HpYScO G?rЗWw}uXz34.cYSuszNNwF$3?4s֏8 t /(}}sm:IְȈ8?UR7]_[eI-v澫6T&m ΎY]f4SuWhqk^kCf5^z?Umts_wRVGf>(c][svx;BHWIqTe=s>2m\,GC}fvO}:OD1IwIsay? WADQ-97P?&J퍲$49 V^O}NKtsV>v6%nYELŤ$aDzpVfqiӯܛwQ?\yߋ?Bٓ{O[K&N˰O@{Q?e?zնmQC#7^ܨz)Ó%sz%}.6\ջXV5 @ǒTS'+O9. W?E;~1gSg2cݽtatΤOͱ_Kc` RG:_y%ʱhn>%,ǡ'q$N쇻B#`rHYMAm[[I*JiLJ)LJ^RRLJ]$$4JRI$I$'I- +U][k--:AHLm=%Ӯ~, uCD/LΪ&ޭFc31 1\N{Zθxib&>_Xǚk5qkzg>hQk28d0~kei>w˫ 12E۫~=O w:{̯/Q qń?VF}7gE#*MvwnvLDg*$I`/RI$I$$I)K#'L/^ȶ[Ýu̐ O\1~cd n"^t|uO˷n9־'m |AGॷ,%p#eE{Y`jp2 +\~t~|5kG 7o?*:8)v\ vNII7ӭ#s;OԞ?H^<Út-#^#wYO}]0?<ޑ>RCFi6ӥ{}||S|{^ 9 2pmyߊ]uةNE9- +۰wXuPZLܴ΄>Z{9k}.>):{]K=bG{`E8Tz[ ͆~Ӹ?;tR'[$)w$$S.k--"isC\|STtoGXVEs_2 m,kc49qRu[ )I$JRI$I$$I)JW 6 }#]Tt2IMԒI%)$IJI$SާC8mca̤\M@˽"Ob}W,gNmS]7Br]ogӏYUMy hIӕʰlmk(x]I?F[>Uc+w]S͸z~%@-X ޳2Y^++Xվ^|&qPs}7vImk<3k=I RqvfLc59qpn6%5UM cdk@I*bTM,eHc Lu $Jgsr=r̯gFpA}&7{I;hK~wdfﲴb9{4a/DE`xON?Ra7앸 A/ :{惠fOӁV%NvWCqk'/C"k}[Kֵ\t!mMLz] 8F?mnAe5Z?kk;H#-PyUXKqvVMko᧸DB +3[G.tM珱Ԯ{5}bbs_kdvck][kO*ɱd}ftΓmԒ2mqN>Z fDF#S}p9]]>̻Ć5u>K$ߊtb#Uta`M< έp"ӿwNvQf/"۷{ŀ\^+оd[o3a2eM$2UmZp2}kzyP7ħ<ȥ6aPҜ"eyL\)$I)2I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$&NIY$"BtSLBhFԌSXۺAu8!m{% +$%TFSUշ:"M[r jcގSk$i`A2[jbёSȭT[Dip2+Q5Jӱ`S^NǑi=Zt+.AsUg}??ogT7f[Ogc},ml=\5ljeSx:({r+]Zֻpl.AM;w58ݠ&85ĭ m:v {\Ǵ99H SBd|ӱ/_UkC2yGU&Uݽt5l8|]_ҽpo(O#o^eʧMǫ6qF> { bz'O~X˱k3)KcGA{Dxo*ḷ2(0~` .5ݶ7znvzf%6[YuvA}e#R$c'~ =ާvG2z}\I6lk,$Ϊo'^yN:O^cʲ~XŰ*02us#75B>Gfpl)$PI$JR +pݑ9s>~UC=Ikt6̐Z;mO h, QD4DoY;}[ _K@,X4r?ڮܙ <"R;$5co]a/ΗzJ]%tcѥ6Ly?%lȩ<9QeU6݃GohCOO%}o6R@qM?EˢQVC!'V^GGkG0=v +NEF9oOKQy;]0?oh*;\~Ot~|G❖ÅV{voZ}Px!ө3Qx +ifڻFh^ּr'cƎi!ia cƍq=&H~)lXõ{mdN߉-!»DY؀vsR5Aq@`^<Út-#^#},k}d uZAK|SU#R& 5Qt<|eE{Y`jpC%L}GSgk~y?Ϗ3fuV9ӶnpXƒI,uI$lUUb^ .e׍Z_uJY?U5Ҭ:Jnem{NZ)I$JRI$3zoLxN?Ԧ̉e3쪛+yp7&b#Y?p;kpƿGQ >^߽ O )R\\q C-J7З=37d=,SLs%kֳ쾿g,9>ʇV{(f6e f.C[[w_ChGr APF펞j{{/h>S)~{ɹݱ%;)]f'vV;Xl|,k#A{(&Ji}^La[gUVyK.}gN]h_`,q/gGovY{> +I)OK hĢ[;^ `<.`_Iк1\ڞu3n0r~lUo_ c{givA@T:2mҶf E~sIlgex/~;,O=B]ׇNQ44}?[ --62[WONX2 +R۫s]UCZִIsKeuL9Y >oӰ|_kZ:heUQ:ɽxDk0t%hl\@1*nexxƱϱº K5 x1ٹgULEn{k#s\ZY9X̾FK\]R]E%Y1-u-/,2Χcb`qoˉ&)7 A.Q.Q%D"XzVʮ>7q8hVDwC{t둚!ݡ?ѧe]uv31ٻb(|J~<!Ai{Tsx&{k~<7n xpѮ#_nĩSk.ֽ v)p~[6m3-=*뾡dLZҷ ZA }LcIȖ9Aiy-?]|~ɡ}8i!_Lo (R%3$I"$I)I$JY$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I$2tRBtSM +iBVe%"$3#[kk=G4-@|MB>{s*9'lV7cvv"h| ?7 CwO'蜝aZ>ۻvgq25h{`wEn?i,i~xjlM{;GciӐΙ}Fq2l?Mܻ>~3w^*px4ٮmM{ +MWrNYYN`\iYC{w={mcA}oAPt}&Tw]v +ncm {\AeAJXS }Loqۿrd[[x2H?$Hpv Tc%˫׹oᬊ=2`i? VK_%S"L iiȂbY H&ng}g_L Ziw?OgO\+qwֻկj[p/H?I>t^.N/\kY?.2\,1K. AUNzUЀOLI,ժPꨩ\UM/ǐֵ9@SX]1h}vdZƒve6l.h0'@))bhiڰeokSAiJRI$I$Rx}R LUm;{v^@ +I)xBW:,n;Zhɶ[q73*5nC3kYpɢbs+!hL\o@}6_Aa0-y Zޡuh @!7J̯'ƂNƷ:7_d$ߴ0P,4neXz{kZuƿ _%g<%p4Ɂ+,uu?i }U3VWDYlȶI﵌kGV>>@S JNEXYckxq]{zN1c6ۘ4Ay:)A~,g$G]w;6` +KX7AVF@RcCpA05me8|Ӵ%;k٨4(o׌D@a_v' 5 J4j 3a2GKN|T'wrӻtk;ieAfdsw{VQpreW_^Ķ1mn65t}7SAgz6vq*Β[mvj{ms?@c_;}5.rNJp_SLJÆI%)$IJI$RI$I$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)tI%)$IJI$J'I%,$)hJJj[ӄ- 6ԟsˀQvv5}˼?+ꞺT:6EYs)`1܆V(uh=nEgV}쿬Rlc@ A3G_u͗J,usb?emt=5Ṵ@+Rwe;uǁ\UM;a$1?ID`skxo +w">N7*)!w'hmAs՝t?\KLOSӶGB l5i]U;Ŕ6VRAsNAKIcΤ\!<ݻԮF8~뿁z*`,Ȯ &a;]xdKD/ho>Cگdjmj$pG۝A |@m&]t?a=%/ҹ A<\4sHӿpAkv?E?w]>I6Sc5r< wAsNkۂ9|BTo )u@925[|8k.Ew{\4-#NS>c 25~\輻*1gpIMi'Ke堸4k0|_ȝY)ny[khs C|LAQx&X}(q]c^<Út-#^#=GSgk~y?Ϗ;*wX4|?8JCŧ]CЩg6m;=8{@9y~>NÚvE <)Nf~7K?n2ִn 9. fJiM,mUT` kZ kZ4 z#};HgcW9>, uu$J~:^WF~M,Rb:Ƌ k;ˈ@y:&./Nf=~uޛC7m?hJvzz\,dcX3f>E}VooK_ik\ =I)ut>Ǻ ǵĸg2^Ha$3+M$RI$I%)$IJI$R^XWcCZH AI${v.يuM5乎tk#Rw+hxhoMvA xLNREd\״i KH1JNI$$I)??MSȠZ:~V+˜Ifv5DV?CkG<,l\^ /c' 2R B?Si-mTrcuHw`Jr*ޥmt}Dz CrC-v/ZQIآ./C.Ҳ}nN]??-eyV,,,dQs$\f dMQ]O3=;+;gZlӝ611ӱpe}Hۻhf*?XMc#k\%MA󂬰X+h} h-itjZ<FV*%H XNf]\E5 V1h5:?%sep=ţ84 swVvPc-27 eIdmi#VP Y#go.S8OW\lxG-c}vsRnkĉN?BݶV7R +% m-\Vݮ{ϥ^O~y=9 {?yH1״=AqM1${q QVsN]==fWc@pegQ#1%eAd/lHFTf&_ҏtx&yܩYPsX>?'n`;}gMV>y[\v&s$D8Q>Oyv"9csJJ/ h"t?&?"95q%2& ]}; XÇ7.ѰX;?K[G&g OMe>iMgJQCZ/έ0}75tL{{x9*ޝ,tGoY2 H'4~QyT+Ge/[v@ Ӈo?Ĝ`kQ'uv[Ui£.sҦ>QfIDȟOT\]Φ~ -cMYt]*I,)HșɳXI)bu̚}jV54A +6 Z^`t\]m9X>)qi| +%f*;G Q]cn\5%) ql=e3tVKߌh0Mov^v>mAͫ*\ : g +Yo%(`4(xO:;f05[?IJW4waS 秫Tw}uK+[_]_=1.K{'cjI%#]I$JRI$:dI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$R$JRI$I$$HI$JY$IK&N1*$)'"pBsQPpOM;euv49kV};; v,{Tt 1"$=CED6ȲHkI Gq|ZwkG'޵0ۚ#_UȨZFkZ81#F(>f2P %W4i4ǁ]Cu"\x8~<_ʥԸd^'st w4xr4-kZ AN/kc ds[cCeƄx!~Oy$9_px=,2B<cc;ehlX22A +5K; XÇ7q,Gٿ{?'É[ldef$@ ЯF[ U߇*DW}msIxЉ)Wczv@ ӇoY5k&^;yg2ӿѰENp7.c5*=#ǙUl "=f=p$WǓΟ!R+hD'N?yvg5ԸɗjAPM_/更A&5[k 1 )6C2q{hxhǁ0QRR5ǧ#dal6>:sĪcI YX07ʬ7#>w"8Y[CwE8[?ߔgz>;"LXwiKH0OTod8{BI:C +X=5ؗcs:%Yc19.i#asdyE؝ecec]mOaiH:y6tN_& !vVFN_R|o +:̏=M`#FeQ}nul@?릁"E@u'@7@5,;:u-˞Gܧc'1 +.8<{ϟ)f0u~Z5i; y!VwhԀ{9_w`f;z{"56tzx0۷{ŀ\^)[Jɮ]׏: \ 8v%촗7w3I"<gVUtdQ~KCN5 sjxޙ;dv)1`4d3i?d^w(L;\>X׼˝eDcL˘L>;ɣ󋢒I)$I)I$JRdRI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IK$I)I$JRI$I"$I)dIJL2*Y1RQ( +$)D棐 +ﶷJ] hӒֶc=V՛Cm||_,'ˆ^7䧱f[uA5x GG$[j جoZˏ%4Zu.3s@ k3춷5fc>3}i҉ f?k\K\5U-1kG$ŷ%?$?}4 )|ô?VfֲAZ>!B\LpApRfi #__SnD!t}/&;lFd(U+?}G}̈'nańq?zձ}$zZ1en]Z6H$CcL'OQ,z~VO_cI 8hl/Xs]ʾ'Oī +N=#mutI$$$Iԫ ː)6I$bI$,Nܦji'kY?k78wp|Y=;w}G9JOvfu$u;2ul] dJ?Q͞1Çmltw3هk<݊>Ƽ{}gnF`nk=B:ɳo}1XOX܆#P:D;`fOVKqf]&ֵ̭|&5?Y:~E?^>jϽ0骽'Ac ]-,+?}`MQН? P$|&wju+v*\ Nd&.u6VNNn.ñeHx'a h}.)<>8ez>7 MwVt$ @ +}^N/!@ +}^N/!Ml-Z =yM٭u#{σ??"?)@h%nZ9晎yH1e紖qb>=9Cq6c|cˏ}6:|a5H lvk8!/e^KGṇ`K^EW-p v#T\XtbXi+|b=Ƌd6~3%r倷" gOP|">\-ϩ^h6NeEkY7:3?կNj $Jː%))tJRLI)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$N%)$IJI$RI$TI%)2t)I$*Y2t)bTbBLS8*Yϴ6nM&kq >ׁC:$|7Z8콀3+ ysM8-X>]sl{ZN`߽ #@G%I$$I)I$Jk76KnxR 4^&H9W1xg >녆lyZYxT;'2Z6Hh8$YU'ݙSp5WUSLc[$Rx}R LUm;{v^@<:NٍGqmT{C_-6 +P}-RI$I%)$IJI$RI$I%)$IJI$R2Ic]uD4GqУbd\Ngk~F4%Tc굹ԴմI}ECu.W7K=1V<52:ING;j=?FKYi!kvUc2yhP~~OStgRuJYm,?Czگƫ9ldr_\YG<[3].1Slck@kV=k Dâ@l꘹Y*Ә}GXE\vwJy`quXµkgC@ +2kda; BMykkq7H>{^dNoRR^oPA-#n?^ZGkۏ3 @}gQOipӥv>˄ x#jV?Wy=F>k?48#kݫ~Edvq1EϽIlC' +FHy[jǁݧ]|(HOK NOox&=+Ĵm6cEư[q+:o"~!#Ϗ3}ΧG˪g;Gl+]rfhD쨝378G)k7$?i“'[ci؉DJ&'*'0t\TZEFckGei[pA褒I$)$IKI)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$&N%)$IJI$RI$TI%)2t)I$JY$EK&)PĨ"8"z-ߎ%F@;26ǀ湦APAY$m}wYܲC -`4bj~c}wNBpV"U7s9k#IYo{Tni7nFn?;mCɤ}?Yw ¹ߝ[ >gB3H]sO!5X]g3 xpkt뵇4\L م{j-dYrﶫ{psHЃ*nkpvꢷXPMA#dF&P}le!zYaq1'gFw^5c@!^kC຤=ʌܗ:˨:k\deoUc[ssp02)=,7 X\ߤWЪQS؝BdPxyk;'G!">ev>65e񯀟:6wL +v?0O7tr^61I&բ!=c8]Naoh + 9 k H@dA5ܑ.;K?x{a @ Ͱ ?׻~+c=q>*i{`w y KKvkmDm&{O۝OsLFӸѺ 5,;:u-ʞG& &NI3cCۺB?.$RqrTTXo.<$%rQn;Mu!%$C;5?Mb"DAˇƤAuk|E`h|㙗V=fLL 'EѾ~p5cXCr|AlY^^Khu +" ktߠkxqT|G D?Y_ǀ'@?Ԯ]{YmӪs61'ލ>@Ǡ89y=ys|Eu%ɔ3t 6RI$JI$I%4v@؎$ڇ9^7۩F˧#sXv\z:=J=y2q+]]ϧmn-{g"@% +JN1=GkYs ^՞NڮQͫV%6_cYŵ&C·^qkƦ-.ŤbGzMm>EۚSW[[/$y}I$$I)I$JRI$I$$I)I$JRI$I$$I)I$Jk]2($׻F8Cyw>D!O!8콀 ~n%o$5WzBq +ycݸ6,m&$F|=m?H9Sg|9e}:~R»>b7m;9 B+9Cx[ c@.u'NZjZ53o.G4:  |9F$/c[`0w$:2;f 9.gg8|o广(kգZx=@CK~C`OĒ~p^@1xE;EyicA|*gr@5ib61pw=Z.׳>wtQ60=Z΅?3r&K{ˋ˟X{aWOY2D:682 XOѺAh^`E&)Tǎ^w+ ~^$V$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)IIJI$RI$I)$IK$I)ILRJ(]DQ.D(S:['9 +ۙ[e cs$W+cQ&%V7XAEC|JG#ֲ6:Z$CM [-q6Oe)N@y Rl~Uɵ%VZѫ+7ﵕ4{Dj:Ծ]vLt/넶zmpv;]:WIܪ dnm-l7S#}!NGYQs?Vc][zmpkfK\~] }D'eևu ָY^`CĆ\M.%˘rQU$JI$RI$I%)$]H{Mk^^\@qcRS4|ޣ}Bq*s6mm. &TGE~Y~e`ĮwLx*_e݃jGxCNtmԪߵz:.EvF{ɰiVu;PvF#amFK+1~q3II:]9}#kˤf^%a,qaէC,g}\7_EK/96ShcKƩۺ h[))o+/}V1oA~K0߽?/!ǻc l2mŭwĶQsںJI$$I)I$JRI$I$$I)I$JRI$I$$I)J/c,cx-s\$t Jjc=; +hl{:kr\:5; oRXzvE& &'Qht)bd\Ngk~F4%%'I$RI$I%<֟{,c04mn5#}yIR:kHCךߣsto۶9 Z;q|_(Ac/=G }kKld'kZ\.Vٙ.k[[}i] ׿Vϊ>#wqLǡ>K$$%N%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$$$I)I$*RI&IKI4JiLJ41*%[2 dž1qԒJ3QwP-v&h~ 3\#i1ɼ SU9vcG7s 'RdmeLpl6 1~JWlpupDmu6=^|>xrY%ļ96:UBVsUW}lsx> +7]LnλvNDcV v?pӼBUM ֵֵ@SU2gO W0u'9ĒDV_>] 4EL6heuhJ$Me$ 9T_eTŰUx6cN)2I(]uTT{jckZ։s$i,}cfל`̰uX׆DLx]_[.aV3Ezϵ,f֝7%;,Zzx]?<(ݼF쮯o]3j̊rls6|)Xj踽_'fcb;mu\m-kxpkWMVuV6-`wmLOZT7띔6Iq$INn~]S_ٟ f;wL/`ݍҫBdf3ox3:pNI) =VX5mVOnc61 }Y}{[Yqee?pk NUJht>7`tlK\ݎkŤZ\ƃI)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$eZZ^N$KW%I)+p{A)*LG!ջLLn9c`:[?"~WRRI$I%)R6l-wCSuq?YŮy9]LD3 k=nKl l(~wɷUdRqmՀ퓡o-"6ʈ Pyu1];~wuaGQy`x֝V^ݮ-<ki H0'.ЫPm914IJ=Ű5sd4rв &q|r5mʫo#x6>hfyS 1{òqqs'&:.Ț^-hki.<4\ld?"oens,<)П c +CXY=թcwY[~}?7'Y[PI$2JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$&N%)$IJI)M(I1pA&,{X9ԒJpĨ*[n.Fp};)ދmɳeA Μc]ɘ7Yt$zӓt_U/eby.w]#|0<,pe>gD&u,Z -;ikem\j4hQQͰŮƭMm=y<I]7<|?V=Oʷm4LIO<9WΠc Zo7Ck}~8-_on[;K}oyu *3KhiWGڸXR~T[3֛sq-\=}aw.-_~N}Ϋ/^HT/AnʭŎw274Ú1i-t7MIW$d8h4OWM̏?A]]ӯI_iox8̳엾QV>9۠9:]U/asHp=; ;+;~1gS6|3F)-7Ͻʿҵ8f3,mX{L#D+ϧYVn ng1JufSY~}Z~UҺnx~zgn;wlh +JrhGo~MuLfϞu/ n^67 ȪoXIe!}u$g9O;F:~tfAܼ#sL"˴I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JGu5YѹAAAAºq2NvXn Fqa>PM_/更A&5[k 1 )6C2q{hxhǁ0QRRI$KZ+/c,cx-s\$t $tΓe/{s$ƒI*JRI$[jѕCg e,n7?y\uIn{W1Aº(p,{I{A%{}O6ڭie5p5:B|fGHn;``Cϒnϥ`oek~m^ֿŗ@ه9\Kc D+s@ PtQE,ik]ݕhtFHAĦ3&[[Iݨ}=w'G~B.:f7%knEğcu{|d\C@,m? hfC5!x|316>̼3 +HnKo֞ZC]~;7:XwiںnC/2_i$ X\g0 it{37+qGI2RkiI%.dJ&I%.dR&I%.dR&I%.dR&JRR&%.iJRR&.{G$ho/*J#>V{Qr?zyi2oZȬ]Ke][eU(t+nmVWS{.lyXaˌo8//@D'p_}S=cfuKo>={kln}uE-OW 9,lv]n9E.sAG'#y86Z1s/dȱ%׸t$UzLn5pg[藇j6d֫w<52GӺtpnJrvj``Fvl/0n:_s.ղcO+}%8YI%9?[?V/}3vxl}'؝'馪*e4USC+5kD5hIJI$RI$I%4[Ԟ-Xwab5vuhӘ\mC6+3^k6*-}[eZϳƷ9iJRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)wW<0mmCvv麢2:ǂ5AB*3NCqvWsnƹw%s^A%6I$I%4'jtO SPu%)$IJI$RI$u?W͹59}̚qcv7}= \Ttcn5kƴo1"$F _ׄ[k[cDv]#Z|?G:mu94َKKA/bA}O6ڭie5p5:Bz,x=Kx- ڟSid6~ת=+cK>KSCh[i}&XƛnGmC]N5$w=|Jڿ!S;1dnKpY}GKv1ddYqda+>i?q Ý_bd:[ܳ'a_[k{Vc&/1?.?>36ਏ_^^Ԁ'B3'Ybۃ}i}?~i+k: ꢫX51:!JwԬc 1]**-F:aH (r9/Y w~斎XO7,9+xPzx!ٙ22%]1x7ҟ\Pxߙ[ȵc&iʿoO?Uai&_Oא],1J7G69X@`c8l׍\ tޞ3F76X11;*ipzGGu ?`r-u+ma9t:@BRMN589]qk+ $I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$KN$dׁ;$'vWms;^0G- ƨ[UΥ`K.uzp\챍9iABJdI$Eӥb~56JKE ŪJRI$I$$I)I$JRI$I$$I)I$JRI$Jꍮ=5}`. qo 8))I$V^.̺lz}ָ1% &O`ݞn'XधY%Ӻ]ϻdיu5 ߏU 2?4*t`vmh)Idkr4?I-NnXo,btJEc{!U}Wm׽q}b$s/WM̏?A]]ӯIӦUM ֵֵ@SINO_?]_benhQݧ;+;~1gS6|3k$o;#/9wȱ8f54-L/O݁-sv:) is H +I)I$JRI$I$,6FEd z:ombCox; $C6cRwlnӺtIJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I:i;X9qKgO +}fF:;AAj:5%$IUºq2NvXn Fqa>PM?l9_qjtᜯ]IJI$RI$I%)$IJI% umUT,y kZ.st$IJIdοnҎi4bNPĵﺺZIp1 c;KۑQTed ]enu^?iƧ;{.-``xvpq{]ڱcPR>Ț\kc3[U70޼jd8]I)'KcT\Lř,t.4j;4`zӺ~d7>βI)nV>;21גZ:cNII%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IM|wkEhuo#]Ȁ`)d3'-vixiЎR+P{˞C6!kGHt+>9/{tj`J_eo$F]fwocl`}/u6p=*_X:f["q=F\ls=S5˴jk3񡿽?՝{nGOĩ5yWؽ[/wi)PꯩRU湮5BY`w'K8sf f5b}RشF=mnE>ce5 h<2RSzO]N%Nv}*ևde~94e[a9V0E:~6%nYE5A-.cA^INO>wYKƥUqb;1׀k+ef=;m,sq~i}L2fI)eޫPW3*ưػo/}Wn̰mf׆ LJRI$I$$I)_ھwؽ?n?>gݷw1.W?Q6;6bQE.7܍ﮚz3IcXO/讫+6cfS^N=ZA *#tƤ; nik[Q`-쒛 $JRI$I$$I)I$JRI$I$$I)I$JRI$?wYԷ|> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;Q"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?TI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$zͷڪln{kDN*_7K/<I)F{ɶ_?ؾ>mK}B*un䜛+c#otft7ItZ )I$JRI$I$$I)I$JRI$I$$LL}efMάVs+ulk A0 +.7T=Cv=+K]\nlJmI)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$H9x~}ToɎcq~GJks%[O$IR~WV }^La[gUVyIMԕ/͟?m|zv]Bkpx/ZGJn}+,td_nK~sd;k<Su #+̛C c<ĸ_7Lv!ݟ7.?N6ccSC]]ma#~Fc25%'R'ar?Ji~:佇-|K=Njmm>B^+$oDt*ggJJi}+,teTuaOC`5]I%4ct=Ow.vF~f=1(ײ5D O +I)I$JRI$JYU^SmnvPqW4䤧}c[f q,}OqXȱ=o/DWPڲ}e=&d\Ə2Xu=Ky\\dˇU⿭dbeq{lÑCXCq۷OarLJ EK]oyX;2q:p`YN?*Sׂul{Ma&,o`膍z\z?3黥s)fX`mqƲ_m%3ߤV}O6ڭie5p5:B_60fFC]A5հm"Ouɴi!c<eiYֻm$~+)̺jq˺nn[,*.sp&-tn`ɫ"ѕwmqk̭-l<ȳ?R]潬qc*ac=uLexXG:Of --dYd[}ʁ"V q%%6I$I%)$IJI$SֺoUsΔll6k2MElu[c]G#]2C u&d̫\̜[FS'[Ip ˸I%0jae8 qk =I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$wTˢ[ $<$J힚nO}oA=jm4da,,{k`%7RTߕ?cB^YIMԕ-eWz^gޜ}TOs>Q4IRkgdYLUo'%'&OdTU:Ox'&F,k L8/ؽ *,ww[^=$ʱ^5,-&JkҬ;1Y@{K9ѕd6Oaq]I%4ߕ?cB^WvĠ4A=ÈWRIM(6{cvٵٺ[8Ԇ>|アWRIM/eOΗ_?UԒSK/J:ًUeXe~e whcY1bQIJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJ\VpzN6:ל GPS^Ƶc6{4f][ek㍌z49ckCa.{;3~z^~*._ڋt|Z`>11`:/Smc3 Ac˶n$3K6ƥVin96U?|L-ܑa,\`y7$>[:Mr\۞>13\̢c# $AJXVebGC˳Эw_͠7}M{\uq4;Jrn(vgBv5 ܵnv%tZ3'] mɫ!@u-ǚ7q}߲mh?Vdd%:,wzkcUA/y s?cvѭjuW˩{mևcs\ k$i$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$:9RI*sSu%Kբ8x쬵 _Gɾ>iϚJn}9}ySkӪ})zgK%7RT.rҗسZǞ[Eu6w򒛩*_7Hɾ>=)O_0N ngz۫?֮׹SuRѿ~7_:7YWRSKOv= j콀Ǵ)j1cd]N;}&u$vcoN8 0\ '/W\o+$]F5sE7G>/u 5=ջ11xWRIM/ٯ~73w|wc2|daofEc \pD+$Np1UhU;X&L($$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$Jp7t߫vŤlbx﬍Ki6@ܯ!k2hcvh3QqC쾭jׁ_ip7_Z9 uuGx?no+G}m|3#(mKmrkd>ie8l0״Z%͐}{ĥ +WqoX$Ft:,pR]8s鹖^fFiKoIz?hfU30+Eյ6:ɂ]Crp'uNcsI7U1u.S-qkvT&-׻3`g>7ǾhX澫v̓JtX/_ +pz -Ȧ܏VkulԱm<TqWau ,w6,G1a1s\Jl$I)I.geUתY[P qhʲl .p2dI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$SL|< 21hwU//`{lsZC,po;}]YgOɯӚln-խk1t<*h{S\  1{h!^%ڭqHYtlN6*NǃK[1+AqU}^KS;58hh򮬞Kw3h"$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJAʣ ̗zxպ۟cs4`ˎY7~y#uv5FW#n8;ҟ=9yey7d=59#jEwY BcWe?l%9$ kCna@?klG64YI/C#k\qufX|N-.?-E?.WK:6K FqН>7qcd/{?v:|ˊ_I}I÷{"Mnkû{0HJ>XpIB]KmV>CK\ !Ms딒I$$I)I$JRI$|,FI5^mӽ/MwJJq,[N&E_ѸceYP%UkNֈh{F5!h`Lbۺc֡uWWvzc7-#QgtUgѽuWW7WT[c7#CJmrszE*-kVKՏh>G+C Md5ُ~C}ANC+LnJo$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$]#L2k"c/h hmeuv4=kUN3)~bLv5x "7SKuޛ:v=;:Nm;c=;^>isw}&zv/{DYQr&zXOU`XYk:eVf2;Ji $rI$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$/G'VdWDVNZ/.6Ciz׾ޑ][.egB7l5;pps\ݍ0Y<18 eev4 4 l{x.qJYEF2O(+0si>~GpQ.̯5cqlf\"mi>'y8(f˚9uncbP %~KsG~'䝏q@k%p= q4,~;.}r\%/KP:+L}iU<-nJ[!-wh)zYL՗z-_ 6K׹R@5-_M_?;4mZ٬3+^G/U6ڳOrv5޶ִ{ezyCiDb}Qڏo%I$$I)I$JRI$I$$I) ش_eŰA6c9? >Ve-vx6ʞ!{gGb$뺧@u\#u4 [nS={YK l muX̴3Xa^=;C\v.a<8ʾoNBN~59u5]Ƈ@pkK'Uץh^dYsu%΍nJz1Ļ2n6>S}77.es7;l蒝dI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%4~AF3'u4nqq2XҺo㫩)^-aɭ\#s \% ^zzxi.wHdev5;ձ \׶` kz.WIpĭxȯl3X?H1HnUwPfE86zeVph7ln$j;\|\n}Wt} s.sm#[! +n.QO|-LX#5_uZEhI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI%tn.9o㵻 ѭmpL堍QL"h)~ul߬y$ck[u`]ǹ_YiCG*lU.Ǫ0Ckdǜ~.%kF>N,siflGt|! Q<="hEL3G=gc̸YK|iv80 +o1Ʒ8Eueo?%c7Z;Ưf7GGSDJX`ةnN9ՄZ.JJޞ]Bp@i?۬ +_Kms+.e,;^A0'QfUcZl==?W]eS% H"`0ZkњȏO.{4q wfv{ۅ*kI^|Wa-9|^{A|+:r)8OXH/KrI$I%)$IJI$RI$I%)$IJU>!n56aյmdloFnh$Y^aWbgYfMo=k}Nt1OJl+2k~m77WcYFL +^,1aLWMnfTeKmRdO|?3>ɐÓR+ZpDb +-{\\lb-pk Misn$ލ)#'<ܖfUMl;n;ALj ?̃)qcg' +Chej#N]zۚc]Pf (k҈kίZ˚8mޢrlK{X6o8{>_LE@K^b]K:ߨ<>c>ANpXv\As-:&V6G"wNJUֆ?WkK핷?6Ǜ\)fWw1m-=Q 0,RPmeC-H>t|km{exu~^ᢃ1ymK|A!0%S|iia8ܘ(_`h=2۱2ŧ3ަ>Mm2şQޛҮ`ez,%5>%mɕ.k$ '(izI$)$IJI$RI$I%)$IJI$RI$I%)ش?*6r)ʫ|i1r2I)?wCoOBKr_2?Tu^;N3G+:.s_E+zEܼkϐ+s\@&$$7U}Lڭh}v05pB̻_-wMʱ @-y;o>Ǘ7=l @xPv4n^ vdu55Atms zY$\\uy8N˪p{ÚH0D#$$I)I$JRI$I$$I)I$JRI$I$fzz~Y]TqO^2I$z3'3w3Qv3˸{sj[l|d69/?SC( k B=mɻם'u+o2jˠ5!~(,5gk#K %a6\=~jp Ctz957v{v!# q-sNnc&|~hdt?9tlC.*^y=H::f2"_! n4+7A61ِ48hgFAPyy-6ƍ=J|}ICa$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJ@ų/.U {̞L8jNTu[zgW-=թ/gEc,'q6. 21::N>^gX˷dl; eU,gޘ0 80I&?}3}G6Qf5(=.e">$'u,f<,>>=>t{-b8#b_s[VSoh-x_`T~7DlVeʰsʲ6v|]Y={GT-D3扩}?B"uWp5<\N`oY@@t"+M-&GXΡ_χ F# ?LKp6^HkCNEէN-b6kI;|l8v}6 kب}!d8 ;>eD BX@e;sqK qkq!J^C?>%8=kc42l8v=պ k$% G 8֦ٯi Ty Em?۬ +oTK#CG³5S3躻8/nOgOK^=+O^۽5ssEn ĀI^ļ44#56zWH,Wq~iqʃG^~: bq i+ƝI$jTI$$I)I$JRI$I$$I)I$JRI$I$$I)I$Jq.u̾Ua?#ۊ6TGSmƴFUӪc}kpfsu!6ήvIM|.F rk:,m&VO^hoZ"zVj{h}~]y }2Sܖ4w Tw8mI)IWYpmcXcc>;a%)$IJI$RI$I%)$IJI$SK7ٝn}Pꬵ:gJeo$I)澸Wu'),pֱřL.$h]MctrDgegu ^Q]xn 9WX[Tu.ٽ2fz~ 5~ˈnݧ;]ћoqݭPfE:&{-o{_c]VwSp)̵g>r ]wE6gX2[k ǶIeoeݴA\Jc-#B,;gwzsrYn꘵0cn7d4l1NH=F;2Z L*TU2^j5ZhA +jƾ>C>@ hѶ4iW3o-> l!dc!%i]p9Ϗ \Ƞf-yDI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$Oz]2ܷcڵh!Ōiˋ[- &DD '@?gZwoG׾džHZKc8Z=WTcZËs[SXp8_f'Rm^ẏ/~]MǻM&H3 '?W!ԽuNpSMcC_ఛB켦i~};)s,`-2@|%@u,zz}%۝_6vퟟ)v+^ks1پnʹ=}+*YETKle﨑{ D=w إq nq:{-P+\Op)oEn!+3^TKs|RL |qiblf.mi>`)~_ K.fuhuUc/5bTY[w2{5g'JinzƍK,ͼd G:0Ǻ02efSawR}}B}`k:~0:Yׁ9<lЇ[ح M}ā\ǧf KI pD>洍 3-mO mӵw~ic>9XY'en*JؘZ:=j l[uv7Ȫ=ZbxsN@:N7dU>1ё@` m0ǒI$B~my=_FU`+Kr3Z%Yq^t٥.{7?ُ4g_ՙr/.-[!;_K7ux[Wb@)G-B5ogWe ':汤JfTQRa8L(d&טa[0\XڅVi&u;Qk0~ulmc˚w:?dO~H.2G47ȷy>nyC6 +mieGϔCe>7fβh;SIRLl9 +C? sOyIĵTi,ONS2r _ {?ȵki?6n|y?z 8uNDngpZq%D__wU|!O c?+771cZ wKIL W8V+{[.6dbde﨑{ Rr>4xfk:m y_K5-Ŭ?S+"ukI>i v.&-kg?6G7!`~GaJJk6e|?G>돻NϏd5af19dN׏_r.~ԟ|Y$&gQ?KOں->s1>^tЕۯCuEԺQ9+߾Ck;L}#. Ɠ݇Y~-X?ZUXڛk6Մř },{T{F#gŏ}%\Uey,!֟`{]^'QO@#8y>bZײ^_s{\ͥh7Շ^zCkȾ̧deb cdݏY 핉1k,Y'WGafc]oC!wf^ֲ}3}>Χu;@a,6%g5]yk}g O ݥZum?i$Ͳo`}'S4-}%?S^82, '=3n֌W (uV5cnZ$C+˜ζwJk_C[,ػ5-!Um`SI=U`0AАAi- + N7dU>1NF*mnV3:sh 2H#C-d79;6̛2oSI$Jz>MaI$c9ĸsc8$N3=gT_a|!O_À@Y2٪$nim䜪>F?>hn[gȏ𾭔OkһlqDs=.Dl^c||2O9ef#4 gEf4:};u5V>#[cɨn0inCqٙC 1y"v3{?&1O}cIEr+cmӶ0`9S@fN.6K2*epmçSwLѮ\mwzxmh"3Oټ~Qރ;J+8 cmhooa#>ruRU` iW}Ӓ^K˄3c?c[X ]Qs$SwQfѦ7ƻ@<&rp>ZHN?>2<ƽY^C",k\׈wgeF&>Fum{;GciӐp\ls ;ϩ<HA?4_KU,5<x'D汿m{74sƏE6;mMԼn'-?~|^f-F d2 f=Oz,LʚH"e"DB,\{XM';kpqymVMo i)C3+ּWŷ5fͳC z?ڿޤHlt98T\OfI}ȡ]@|`݋ױmH{R֣=vc_4 Ǜ 6md_Yk6S?tpsEo|ˊChs":k|u +ْo>>-1f?QM/gBƺ??AR΂2z9ƍoDCf \sk#{*- c_\WX#{1Axk-EQ1<\BW,~WZtK$^@|^Ls%KOv= j콀Ǵ)i=uےSu%KUc ?ڪs[:ޮ5 }\iIMԕ/;WuÎVH}/p|u}/yNM͓ƴ|IMX090IU?mtshݙ]{|*L&湵0FZl?Eml7%k_eMN]0$=1N͸KN-mmjC>f$2oOF<gSnO_]=u$jYC [[Cͻ㇈\v>?u4,e\1`";K@I$5piΨUscZuk£Ob)g>k{,c k5PAZU2Xڪִֵh )Kjdv;V%6]fymt\ЁGu&FVކC+yƺi28l,)MI%)$IJI$R,vec]a!ո LLttlpo&|UKZI$I$ˮ:NC{:zBё\j`1sy;^Bce4GPƁ\NXlȺCqlMV7:ؒyU +dycGz/hKَZ`j=κ]\^Z-sӬ7kɀSzWGnZcIsN}v8'hz9 ~*?`4}995xpa,_[fnK@na {*kt8ܿڝ/Ӯ h;lK;6n;kenV[:^;\5gXk[ơ=-ڵ +~F/KN(KML֍sZ$$J9Rl9c;X&$Lt$CKH& wQe-saq E'$8Ӽ 6^r-8T;5{l`!cP ͙A_##mh5H6EH4h8jZ'FAEU1^21nKFv_Nȟki<|d0;l9 RRTI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$Pꨩ\UM/ǐֵ9@IL.հkٱXA6%01IW5Y_X.gRx [EG#իשswQǿ"r.ƵtIs!Ć00qᔨA]vY6Mۙ= f[G,f>WG՟dG>qct%ؠmEfcīb(?X}iĶ5e{}ͳǁP7uV"uo鯱܇bUrُ?iC=]#v'ϑt)w1դwS~U5dUlx{1iֺpɪv'eގ42ޫ)Z=B$I?,*ZO^Ȩ]cnӶ89 -ӕW#uV؃!#tuT~-X=Ѓ!ѲhOZ|? 1ˡ(GY_\PǸ^׏(:#Ϣm;#NF>K eiunKgN,轏 u@Ql 201oxǪex6C=2f>i=/c8߼kif5WQ]^CG ~6_?7́4|\ 8') h$W -M.ǎ&N`:9TG}z}'ovx7򩑍GdP`.n>`>&TSߊRŭŶS$v<VXʩ,".cmN&Z࣏{tF;'=36 +V+ʳ] lud 4$qf8I䖑'O2{)cՉp\77v)Gu|A~壭 BU_nEC̋\+cpc:j~+z7MNY6Xֆox A:%yz2CL^wmA s<4 +œmdISC}p/#Lۓkv_KqYask{ߴ~G&F>eՋmבz\fg?cImm'/MɺܟRrw:][} K@8Nƻw{قKfEzcHC+k}xVIJI$RI$I%)Rޞʇu=(02 WU.3I$I$ /Ь= STYVsq4'nԪCʍհ ֖~hELjhŻ%>MnIZ- :3r-7{hf3̻mnݢCO`!6+5kf3jcǩR<[ENvR׶2,9 +ic1nP-ߓW3#P9acoAc)ݬ̍ )e0X~tߵNǮУ%51{̌_c^ ^m P;tJ{}Ҙt sYN^:^GonO%{~p*vwkZqc akD ' 2mm 6]&k$Z ĂAy 9gBuNO+%kYeŸL5sbNt?b|?+$}bcF5Ѡv]oRuXu/-sL;PA-ɮ@ 7;oQoEf=I.m[CZwlnu/mZak-s\4 _Jݕ`Iq%ĹsK8$uX]MθIeOm86U1^21nKFv_NȟkiRKmf7S7* +ih {^m%iX asAkv[s5-p#Q /7%oFѯdOܴA>C2\Z杶V K\H))*I$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$lj}jzm/ٴk-,"ژd]3Wf]h1ߊ m_~ۈÚO9KaA/E^ [cChvCYcZlQ >_~[\NYEnlSThp]Kb 9TڪU[CXƻ kZ 5e@(ra}+)b'NNZ PKL? b5vX𮹸r%l3b ˄LX[0 +^kZֈS%Sʜ@3LLw:;=vtp~th̬Vrhar[[snk ==>N$/|tkқd?wϴ8G̬ۉ}y8ku9!ڿ Vִ] f-Υvmm vCtTϠ]?ۅeYN-m֏ϧm|,c#gޘ㹍Yemnȭ5c2l=Kenw\llkq#XkE=Jfhbk/t1V<52:RB_#oD.5[c^ +zpfێc[sl zNug]ױsY |v(z_B8mODyWuP +'QQuu䷒j柉|<[;4݈Lkȇ;.1#ԯO֏E|˘'ZeFz4)#_[-h2 +k!E|N}S P[gm;旧i)o6V4cN(k:|X5}:kh;cUgGܜu,F>]F[gEL{<9i1`߂E /ǵ0ո8O1-FzƿfOVc03"\d6Ƈ !~kԭt_g;D[,Lb5yEM|W4GlP4wWqnS}!>mKs?EUU2^j5ZhA ʛoTjct&"vkZ6iWa Yn:溧 ƺ]T{ =1iCӒ<_+%I%I$JRI$I$$I)I$JRI$I$$ç\6ߗ9ac ԝ`0@$M޵׺gD7 n%0zsVubFM4sXCt ȟt}g%C2fMe5tI:ɒI$c!%0q=-Ɍu)Wp +mCvp~AkqVdMoOi-#!w#:J=Opq/nwj@MHO'\X2[ƺ?i}X_^بf{g+^ٖok%ئe)\OSQzE/ VV[Ӹ8:6195$‘2$ɲI$ +q5YoO1?7n 6u&p&4k|u[{ǖ6prZÃnbJRI$I$$I)I$JR}B=Ldi]T?u/2IMԒI%)$IJ\_Xu=_P]B Moc /xootqI^zՌR|Ƕ?3.'TΩUq] mm"5 +#'pc3uL daֽK?y֓;NJ0_X1JCǾ[;'!}pmͳS haFW1?Ӱ߲T[cݵ=W1tjQW&YZAֻHXJjM,mUT` kZ kZ4 1(vFCVȓėֵls hNUHt:zwc;Vt>vFlF[L@% EnnGXt~,32Êh}o.Ci~GgOJvCdnE0I?j6caImQS_e!kZ%sh$U]x,}oEnki79NMϬLwNo[B^X JY܁ml۩5vKL=\Zon^Cd!d1et}ߝ'U_?l6ԛsz%ϡ7^,I. zt{`Bn7W}bڎ:{A :ur73;;3"q`W#+~}-Ջ3N˥쪳1e4?tRw{OD줡M_S.Z]!s\%kI$$I)I$JRI$I$$I)I(쭎1qԒJkEk08 IMԕ/ڵ;M6~= +>nKcʛ_UaIMԕ)6{vccw߹qzgzq~SY?DD|Su%Kfy7'?E3B8;+FߓSh$4W%$&$GQCea#_Yvm[*c~Ee34Vh&82)v%,qO2=6z^_%E_<5H+=X[ 2GҼd+]ؙEI1v=sX7{\CLx,KQRVGݨWPi7>p()ˁaWue134C >'=_2ح<71xo:;:yh VV(pfi{\ +'k-k|e=48o}m?<=8$ILz~{}pխ儎 Á +$u2OOegw'(cѱݖǍZ^=l{i!Du*ʪ cR9Nm98-X'!Q=k Ȫau徏:(Ub_qr#/eZ}3z8yXGϏC~TywW126b]^E`/ i:S;~Ў.OUuo@Va!X!,z2*u90dK]*p[|vO>uOCc|m1meţhs`Mw/awGkǔQ =^)ᗳӱUOϾ3q-@9 ǫwV*'ge1t6Dyz+4݄h=MN$k y?qVy֍Ϥ8zCihB$ߞ kcencs\ RΕ*I4u;Qku(t=6KKu}/4q:{rfCCO[KCZ?͟^Z (N/PZ~ nٯW{|B3 7"+'pֽ̏QOg4P,zCnl<c!Þ# 'i̟M{Ov;4*2+c@5]s8U(A #&mzcKw!8 sS%/#侇6ֆzo'ɬ>Zmc7ƻ6lǟ)3`9*Up4me2t%<%~¶S.hPe ַƚ•y]K`Hh(U՚cmI0gPUٕ5cc47[]ޥmZ#⪐a6UՁcȹ7Y!#=Vr5.au.mnO|HWj/%@ׇRXQ˅1eq. sK).< x_m5W-l֖X"Zᴉw&$zx42K+Qp~]~>QeN,ƁlZ8DV AhȤI)$IJI$RI$I%)$IJI%\ntismwY- - t ?H>:rĩͽ%5QhC aZv˾]~U6>t{~Aum EhL:\i>|կ4 76*OIp?'O?{X}v\֐\tڤ wը0IsL;9 {5XH gGOCnXˢWsYkOǷ{95Vg'D ?51?'+-nVa-w>awSvk7{xqUX7udž:],A}{=wU.s7:f脼{/sţ  'ұ3]f;ŀ?0w5Lz9@Xp@>11Ƭc-#B,?kGUz_t)^(9!uďΎHS_u1ve^&pʟgƟ}ayp^,-AAvY.M:DZV=}OYp@3zU0/1u7}w}{ZKK}G0;B>ʚ[Ph/wT=熴rJo*0,wzehjf9k3Uҹƭi-ݺ(p[c: R>Vޥ03o\5}[YƝ뙙ac:( A!0 @8SdeQC+dIKkZִ9qIjk}G5r.SqǢ)i۹n˃TmOMɵ]^enA74k60[uTT{jckZ։s*Cn]vy%{F{Z+smfoSkXlӫi\;eZA{J~=CHY>;;ns9ڋѱiy;9/( Oֵ-cw~tUY<_kmVn=dkNepi{ J[mQS_e!kZ%sS띑0c8[֒ͯ 7m8$İtZk2z9UYYMOsM;^`)JViV܇b>=*sFU+y>9ceQ۾#Og +McH"Ug\ gDeNU ѻYv6-n:ĝ +펞j{{/h>S)~{ɹݱ%;,fV>N6mmqCnl:7ٝ'Ucu}^n9࿵Y۰#^X彷 :}iUk~甶u\j'?⏋Crp'uNcsIdcwQ8El0.'/82+#J$:GI,v=9mL i(쭎1qԒJJdϻJj}̭ͥ,pkF;m{ 4#vUa] ^w]~͙jk`ȘNZC?tΟ`&rK} #4"7DN+ 9kP+|_Lۨv=bY,íu\_a .{XtjOu,pL)a׷_J7AА+Svt^y+=Jw?Hfw \ggȢi*X8:a >sULm?rjEWP}!cn&;RUNھشCť.Wt-˦ cۿ^ _ݿ.tY7Oo(oGZw?G2ȎwcGwoT~>]6_7WcC`ȖG!S5ŶfŘcKQxLj[Ɋ._t#*dxwO/_%Y ncnmW1lAA<]"?LceYqhZe AР~3+~}y/ɏ>_qk1EevCwQo:+T_FMM]Sm9 sdrWnCi*s?'tϴOT'+~yoʏ.HDlO_WpL6FI|L&&HP9~׏VF걯11UKu^^_Uc%`*`;,hx鎫\Lw$Xd1} xsI_vYufmmV1̛GMbz%zfnwIča')qCy9"k#.9UY争 9Mᦱ=W37`FO`.S^OV+p}o{L;S۪Pccencs\ \c>0iӐSpmM8<:rj.qu }@J5!m%$饴45s>~J6<5آ89UDpo̴Èե؞`gX^O`Nu陉m}JȬx$xY{}W'i<@h&QmzR6\MuV82 qr;es<:AD5_[mѹ0dH>jvk1[|vO>uOP%~N+5݆g;=ɫZH\WwW˛W'inmU2*k| V>>+W+о]Iu\DۀaE6#3"Xv4m$]^m j_T{jC+4Qi=;%/chꃇ4;>0A+1<:AJ.:XWcCZH Ai4/9t^4ovcYf; ,i>q(Lg^U\Mb~Ӫz_ΗSszWX~!uVDX?fE snsI㧦1yؽyk~%SeWM4M`Q};6mYt}m|H>++Ò=~Ybtl$JTI$$I)I$JRI$uQS_e!kZ%szOx+d3`9 ^a>}l{?cd~@%ݻ#ik5 8.t0O4:; P _^r:y?87Ts/4~n?Hr}% vi;y$?GgF_ ŭwޟ+EXZix-|8a5\>%r=3epxݦjBDG%Os-63Hi#sui朊Bv#B L{8*Z;~v co\oB|Svs#QB kXóأ_^)?Aj>|7Tʷ6ΰcVFXC%s{5+Bx}`<d!U/lƒ@TǠd`cI 8hl/Xs]ʇC5tnjv}FKis{t +˓)I$Aʺ(uQfSEE9)WQ?=iuTT{jckZ։s,N׺Fe4j-u+\)ӳ%Ƽ̀o>|@ڮȣ%hֱ +%)N=Gk)&m]lsqփ%w +wGu ggc2kY-9㦎emoͲWPI$$I)I$JRYV7f(WU+_-W$JRI$I$κֳw.i.n }G7Ižg_ݙ99Lv=mRikk>ܔo;+u Y-ZN̆VɇNSh#C _56Z޼fm6t.nB y!V:[kkh~֖c4I-?%kR/{[~$WxMÎr O̡9w஽LZ0ǹTU۲MٸF ?4nKr[&5!=Ƒ>ӹGzݛ=;`cs1[~L>jz-L{w2t^̫ܫCڛ"A{teuF50ֳCuߒ1W=SLF-yF=n;X\ `ʯHķ o-vCeY^_p@;vα .h?:[}E?Kx2, }CӿuXaccm.k`5U5>ꭥXֵ\8 J?UC`NT#n,-t{G +z"7]ZҪUm ֵֵ@M*VvSvLc-E֒*p& z`iTalc}zZ_cȉhˀ/y lV(gO׸ff9Ѓt\-ﭻ/ 9 ;GhѠ R8U]TTickW[kZֈkZѠ/;Ya@\ Z>m:c7^gGOɱclcAlkKts˚$moV?`e/}IalKj{vN?CSfaVY;-7ӣגӨc, , {em֗X Ao O}fU}>[~keZ쬱}PkԞU91}'5վ{ƞ\zjRыCq)Njhc$ZL[U5ꭥXֵ\,C>X9v{1<+-ub> r Y~[=e?{Zeh9BQ=Rdc*@veղmo9-iҤY}˿KzGN3_WK]vEm 3ڶM@Qm=m]k:ƌ1lw݋e.=*[}aW'`?omei>$4|ϊq9`VjH ciǪz3z6vtq''teDd][r&貓Im{]QP|yL}lY` +X.+pek]RwW%C=U뇑x #թ G54]匹q `Edn>UCIPV^<z ߶?]՜lL͸בX;K{^&%"@uQ%U/=:]{ܗD;t 4i¸$ sgeSu Ez΋?KD^Get{w{~fN~81԰;"B +p~mb+^<%rSqnB^O9hT7趏Mq|&~U:eߧu_^mkbx~]+Y{Y u{/'Yo?P8VrېѩnMc{(|}7³0r5Sh7;˚8U`k5b'Q7FsNvUZeZߧm_^m &>~SXeHp}g ]ڃ^U5wZ]Q EN&VӑSlus鼏{ &9i߲^77+s^EfCmk{?iUіѫYumoZMQ(\<E2Pp7!PuMSe1t6DyRˢC6V^uzxpN>N.[ W}`/bZN vOk)_2nL+oۺΊӑSnSm!0`nU[OO\2ݠ-kƚhxF6Sy42Ƈxp>(#an4}k[Oi `O]D̾5{ o9ѧvC~w#r:Qο#d;+$džZmkZ7h2{\(sH;{ 74,h~&3dhM.xr neP0+ӉDO7w<A{쟸Bǎ1b#IڕIZ2 \8)x2YcGQ.2'.0')]'}}" 2?O>IG*Ňy%h-y_Hiי3R07A5RAkØvh'ò[X#`͝[4WH {\4=Ӫjϩ_\i<$埙o9-7zHʛ CXö8fBB7g.hכfEKv.CѽU7n;kyFh=j' 8fmD0eGsOAoK-jI$PZjxeV.hs =Js:7? k,"fd9V]5{f:I%)$IJI$RI$K+}K}OWo|䮪YҺow$I$I$$I)m#3]K5tM6H5HdtAZݿ:Z>tì].:q6cj!`I:rL~sl[-)p]vx]{cnѤ93 m6? +ϲWfIC[#Mj4ӑ~UUvu .LV>]y eq=:RN}8ο)33^rr {ZڥV׸}-*0ֺ4u):~ ml8=Óĺ84k^2)-=9 ?OumI1;ٱ64!w?#b2&r \Yײ-׀m<3/?gJ,ӝ6&<nqn/ٵv{&sʧY}?J]:}u#6+QK2[OJ{5fY-{1ǵk۫kiֿih*UML6heuhh 7zmdr?VEgs$zy{'*Z{VȓėkZ.sIj d9ٶmXXkV]e˟6.$ īJڛ{u}8q.qI*IǽP&@$8%ί9Znˢ\UQi=J.YՖ>>=Y{9VZR;9;{?QBxD-smŌ{C= δѭmʸ1 LZ}49t1ѥ $x}ri ݭh9͐[7Ov篭x4c~o'm.%ι8˜KI'3S5;d[HؖkB(܆BO?I+Fʞ+{5 i|}[/Mc `<1 4'H㓬jWot~_UB^{$i,CgklƪzW.NMfLnΰn:O h?I]VU8^Ykkl19yba3&N]8ݶĘ$Nֵl9Rt 5ղl+:xV1te`sO4!x0'E_sss[ٱH" [!ָ$ho9˓oɌʼ("e$%<ZIH-XNS"'I1I:I)dI)$I*I$RI$I%)$IJI$R\ceYqhZe Zt*H6.2_K :U޷WY[:ɧ!\|A$8{zsmiSK\*q$+])QI_d{xo;}^)ż/zfKG*EX鸎u7ۺ?ҰG.oi#Nqw/WboBhU7"̆ LcY;Ͷ 5ռk·ˬWMy2ևÁU[=U~F! +/`o2Z<6GE BD}zHluʿ.\b?(ߵ6Jǟ/^|˺ӄЕ?]nU {n)?Im\~Q؟:Ct%^T< qoB[SxcAiiG O~Y>}-t啚`h{ΉZM~O[g^-0\K—;523+6]^E`/{CZt`/ml{AtBvv"+ժ&)RWj߫Wد"辟LܼiFɏ9M+;-?U^c.۰[m8\\l c-sB\Kjɿ6~Xù +@mqUUXu{#ïY#">PI1*I$Ra kՀL`mI giW:qݗ⹦O2U]+hmNphn@WA0Dxdb: %FUw]ex%q{M{us`Rّ]5H,|Ԭ#:+&@$x^̜pu p -~,Fƶӧ7~p=PwO%J8}cD~)TV-K-oicȞɨqiu$!R柢)P?ɷȊ(Н4hD'9 Sa{H| vz=MѻӝJLugcfXb1`E.w1vz/~ٺebt+~T|s^ϩe" {0<߰tUgi+[ԧ2u1nh^&ApȲy/Ye$j:yjF+_y-x6l/3J+ԍ6n&&jW7˽6$`>Nv償~JwH1A סoŰ |& Dn-{\<8> _>?u8|.XDc|9~(-Օ^](x6A%{]!zFeX7RYsn-;R AZ @;"6-.7P܊H^6xU{ۺ?Һ{b1!NE(J?<]';Jo~m;>Gx^[m1 "Ar +*VtNe{s)ۉu[lT^)7!(Tdcg㳒O:|=Z:?Kt2Ȏ6}Ǟwѩ[m{H-sHAy\$sEX*o̝==bMSػ?i2KVm-uV2< v3f<&:wSkH5L$,=C/l.݆N-Ϳl,k]Ct]WItrzOx-[WU541#EE漢umuV,y kZ%'@YGeQEy U.X[&n{ߩ&|cl/XK}kmy967}X}ɭ&T1":Cat+n>.;w[kڒN I/)W1U`[v=Cx'gihp]26{ޤfX[,n\}̸Si͇ȒOa w94:g||nS(eB=j|8d;cXS OW"\[`90T~m+D +\oh}'C[K@iJ5e3%w};8S1`sYF$!T(oo/)ghxkf~^ d5 }GtK9r80;o}(k͕qv<?)6Lڥ]Ql^4s~%M!,a`nt3!E~Ϭ\ߙkGs.v|ϰc?zgUqjYȿ>4ߚ?4 }GtK9r80'ߌ +ۮ{xHM:?s.߱Jwşw0|סPřY-u}9hm &\7퓨p\Cc}Dne580@+ک*e4USC+5kD5hos8bt5)ڂYK5 +I$RI$ umUT,y kZ.st5WnN&Ei'nSf}xpV)}&꭫ VZ湵09iVI$$I)I$Jju.(n>`kEVIYúj5 3d^6q'uo϶n{ YI%99_U.[9 G}8ZMb,vpk$JRI$x}$ 5ѮF]ϑSfN;/`-ZØ&ӡ*wW<0mmCvvJnI)I$JRp?'՗MX@pm,qi $S/#/Le:KYWuoua]ږz,[X7͜0nv1u 08dT^2)n?vO)L&Uq}}F}ni|WeynZ;pc@OJ)^-r۳/1Cu7E27}{}G0[xq2V5ni]?.Krsjlqѕ ֎䀃 ]m}ּ L[\@h8,,*θ9b ^Cd0ԬBsMmEC+*^~/ + A>E9Xd[k0x*er_Pnޒ j6zntZ~mO@+*xqs1=?.LdL2(Y$EK$I)dI)$IK$2JRI$I$NJY:I$$I)I$JRI$TI$$$tIJI$R T'I:JY<$A8A*HRR Acbeu59$JC+ȭL v ďr珫_Waȩ?KO~& eu{ܭhS#ܹDvk3'*?tYlpo0>}[ʬ/ V՛nɭl8$`,æcmfV-ƨ{"SV,{8Ilno7nCSZhs};6VYu,~Aq*V2-;9ͩmݠM49 2!=]JiZٟ^3,6c?G- 4S[X.`+ܛy/,{ǒ\]k{dβwy2Ci6Hhǒ{ǹ'RϏhqwxx C+ he#ӧ⻌4(HVG\T'M3oY>5cnfC(e^+#Ŷ#S #A"OuGo?O9Չč uHF[tyT=R׺|GO>? OUk|ĵF]lyY Rt'}/rO&w2|Ug>~I&w/=|).3<}&]7C?p;u XӺ{8q>G˪kƭwZ@x楯ϯƝՓÉ<$"AcHsNN8#n$u0>'- -,Sl i1GRs\9%,M6w4=;em 8D蚿nM822?ocYuƵFnzEe<_>gu k!9vcZf6ڤϫ[wJc{o{\K}~%ԆN2I%)$IJI$RI$I%)Eeuv4=kTIMLga\ qTݍs^KF5'rKN$dׁ;,LVK[]{O$JRI$G6ۉUWgo 엉f -K쪚umuV,y kZ.stS8C󆇦^qpbw܁YD`3mfOS],pNǃ,~Mml44߾ZׁJGMٕ,:hk;$dZ}lnk\ڸhġ핲$q%5kZ 8ց$5Gʩ\Um/ǐֵ9@Y8Nw[sss,;l^6 q1'ltv݄'GžW_ݙ99Lv=mRik+>ܔS2j5yv{Eum7m C1`0l_6#Bl,ָyH:0qi.uX2.-f=Ϫ;AE{q\+%./:[LXͩ}|yp d gAg Ǭ1Aq˜uܯ%/7Yswsk.{8mԟ]7׮zS5έd[i->Z`] aFM[@x4lxo#&[gh%Ea_ "XfO<ԃlh$>K=V:q;Ih{G"λ-ɨHZ>E{^*8=A8O4? ߓ_?n]$Ϧ:ywȩS[{};8cOX|!kGb6E4QBDj~L{C  'sO-/+7?wW?+g_1s|N(#nS6|iǒm;srOO?$IpsVn(* z5lsHLSȧ++t-xy3[⼆ltwqX +6W[=9:ߊ˂ΠxTJp2S{(/${v ?T +8j9wgfvc̛?vslapZcgN V뛇vl?BtНvXؔR*y7=FI GH-{{npȹ[[%828>]ޅE>j/|9Bu*Gséyg& >~4g^QTo ǟ; Xݗ:ƭFKMW]I:aDPa-~?W#m[k֏ R6ysp +j)IX +Sy"iw[47[uOcKIÄhK{Ț=s 8mԲcC0:Nekc9Zs cFQdnDOg5~m?"彜Ǫ9\|p69ׂ#Dkcc 9B7? Pog8 _x*{\<͌%<Zctv=5Gui+?N+K$c%ē~"C{uhkSn- ~hO ǏUj\`-i-sӴpQ%2+.od5{]kIjxVA?Oqٺ(s4\;Ivk0T˭h-UB #~L?inEAͱϚq,^_;?Xwxh8*=TF[Kk3'}_HZ=Rw`ufb5O xK~JpٝKm}dm{5= e%L(sڅ  X.z!1iks\ *!sq.,su$VV -x_ġ=J'gL[7Ons#%Norf28V.*34k:2+A]XHM*όRf|Yćl$^m.>^>he5lkK`V\4I;c;\ZܜOUɬ}΃8 ?H"xxU.RָQU=DOX\L==٬>w9e(@ƯآTI*HRI$I$$I)I$JReSMU7 8c]c[[k 1;㼲l/֬O__~v?;omב)NI$I$$I)I$JRI$I$$I)I$JGu5YѹAAAAºq2NvXn Fqa>PM_/更A&5[k 1 )6C2q{hxhǁ0QRRct?L\,}ϣ]yMzǩqvqg[MoV̜J܊Y[Cw5tfk2۟[9XqekϨI~ f~c+%mmXZ,ϫCS\}Z$n!1urM4#-074mae՘݅_۳X6Ȓֺ +X9rv^csZC] oapK`nsF% n0$sK8$u@C`_bv>\hN)2:Yq Aո"d5D9wK-05%cԺNvm&d44 N[ IQpmW>a$M)b(yÂ5d: }7L@fՄ6,`|KF܊h|KgOqӚg?`qn ,GM>;1K:xO4wOܓgu5X4H~R(glލΓZ:gHfP>?ɩ׾ i\擸} |%oƚr>hLL+SxcAkDӒ$&N)$I +I$RI4%)$$I)I$JRI$I$$I)dIJI$RI$TI%,I$&N,I$RɊt1*%H) +NsnV(ZguWl&u #ڑP( BeQNC@.m uPn^~=;'>{g;߰lݏg[lƞ*P*Zv:.Zs 2ZaV +w.60~{#ͮyg'b$$@6]hޖ.QGD>6LAߚ.'̺Юxoc-w._'o3tLn0c0>ɯ.Oo?5b|z1LJ?WUȂq74ǫ OzC7hM{#!a?{neU0U5\].5LA5."vXsKy:Ck̟m]_W[_cv/L6խpݵڲ}u~ݙ }8` 99Dzdvk7CH/;{F=a6]9ö֡VOƇȐ^F};kqk?-tP~f'k?ca^:YiY;U7RI$I%)$IJI$RI$ӛ߭]W6Wda}:{k7gcYf[k'~|g3Vs=InLΰdNfUX|mruuV\55{@?N21ū"xw]MuhlvIOFI$$I)I$JRI$I$$I)I$JRI$W~yp9sf<1whi/c,cx-s\$t c=; +hl{:kr\:5;Sm$IN՚jGMɿRef~8ǶI$q+X,ʺ?;)cUSuțx?}&蟤s{ +z}+}mp߳~n(2}&:-[;/x`>zFq%Š5X؅ eYm+5-z~·Ѳ3ulŬ~AkpnA+]eeY]=lk+or&4 0O?"[o}> `|੼]2@}h1eޭ[mdR5:o$R1-Ō$kocݴ(u7\y,|G.g[gд[u@? Q&b9ڒv9~pk`VQ!r~댧3, 'i%%)nE~F m%N?fy!H=XQ8g<}S -`޵gP G]Eφ9eq8wb㣴uSyxifEb\#O?$ˬh->,ҢƂ'hбsAxN 08ǷsFK#w}&ҙ #11K"Oy[T67F!&W-Ǹ$='w_i@w>^=  q=G5KSMnǥgmp }s[N2'/'XMogpxsgԱ9pyHöIO~s8Ow}2J6̐/)JdRS$ +RI'IJI$RI$I%)$IJI$RI$$$I)I$*RI$I$R'L:ddBɊt1)r1+?D @ qov_kii0cI_<'~PrPr,`B_ PӨa\}P A5y53-/ɲP!Pr.CNox]کӉhuZƼw#?ޟ"?&~ޡ2H[J6 +wPxխeUmCfpo`V0=7eÎR3G_Bgv^MmLU>JEͥIq>$tze-hvm+> Đ HiQ 1c}pfB׉Srqg{]&6hl^33zu'W\]ɪ/k\\鸍˴>QW_SFe %ᭆ&Xp.0#ua\"HO[RI%QJI$SKa} ]Os~ llr75mǭCԬ !'%\v׶$Zi *_mv1u{Y鬝JRI$I$$I)څ/ݹK0e{lh>q }\Ư+ls6=jeP˫Ǯ7k!\afVveOm'75Hw]UN'p1o@@KJ,52ZURww0wڍy'@8VSf5ƭR,hc ~8*=B7hIJI$RI$I%)$IJI$RI$I%)$IJ@E%wk}]kkbuƇBJAs};ksi#@cTuS-R0zwV%] Ժ\8.VXX[4 !%8Y- ^׶pZ̫I >K]. dР~ۧO۱js|}-oٍKZ][M_}nmWUsDuor[O\[xv4Mu[lƻL:($7/-}{6cqqa\Co pwRֆ"kJPi !vɏo?8|TKKu ȫۅK==/u99^8;n10VP]Sn}V345ZOMq\3SP Oҳ̸?[۽ݡp̗8g6tNv+h _h>E.8c0z?;.dkJWo;-l 鮣%6ejjfM=h浺O귪˅?8-7DMx5u[$|GF1‹>n:10'X0wW}X#@[u{OĒ\w1%*V6G`KXK8:hkqﻶTfFڤ8Oi*!Ʋ&tmVv?M"'FSH#*Hn8> wLͤdzaұ#ŭvMۯIKrwKAz>z=_dT}. n tz^HɢdmkGgF#$zoRx$9:$D'ysV>CIHRI$tRI$I%)$IJI$RI$I%)$IJI$R'LI"$I)dIJL2*RdRɓ(d:b9LSYrVH}/ȱ{house{\2x]Ibf2fID$I)I$JRI$}?vIs8oRceӑ;m=jdLLhx<8mq.Ӷ KL b{zֳ6N5s=5%7RI$I%)dYץ.κv}vmV4k摡U,5]{EnyO-hBOb$Y$IJI$RI$I%)$IJI$RI$I%)$IJI$R&~ݦ&CTv]cǰ{-Α?D+wS]A r']dddfk)5 +2^ٸ˞ww4]&kwecƻpm4 m$ &217GGTG잫wcݸ۸0q<7K鸖q1(DZi}U-$H9KyTI I$JR/P]kv6HhsLI*I)sg՛.8cq3#͕ei5bYNmy%^=[ CZw$ʗQۃsvϽ4' 6_NϡW4=Cͭ0uwo(VyjaA%}C)'Mc kO]k3uBΛA^5nZY2Hw浡̚YՑe?7G_^ @]WXXuλ As+RIy cw=ard:uy,{cFokc;x ;/3'hs.hRup2cv5|`8xZ"<8> om5J)]NlǟT>NX<`' il!7V𖏊@58:6 kEL Z4C~L3Gh,hZ7$feOZc>OYqBfk~x6D9ڒ +\7c߹Hw>r?+;2(&emp ãiDA4W.?=`:} H:h|?D$ d,tޥNh8m{Xp4VԺ^Hɢg |$~U~;~ik? +,drYKw$`Nw_3оu_u`ѐ7k70>;FsWUпUMAqmm/ph$ \Zq12KKqi 6q[O,mvTĉ/naEo$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$x}$ 5ѮF]ϑSfN;/`-ZØ&ӡ*wW<0mmCvvJnI)I$JRI$I$*][-gn*WU.3$I$u~:gxdeh%pe-{wm^I)~) t \חc\ ַN$pS奬Xn{\e0I' +}O6ڭie5p5:BxGDp~a?Cqo5R[.^G"ΐ׉?w?Iϻch,lik6|WֿNSq{6&\.5@|UرȉOIRpu}n۷6{_KUeE}mXK 23iO\̏id \ZWLx?z>ю:84Ң^ r܁˫`ŤA&3[<;jw Tk/uNSLv2{&+ȭ%$p@i cYyhQ|]v/uWEː{a'pïY66\8xxk`Ns~وd!֐ |M?Ii9a~{l(F%rZt-!óQƪʰ:< Dt*I$RI$I%)$IJI$RI$I%)2tR$JRd$I$TIK&N,IJQQ)bNTID)bTINJ]Tf68wdӴﴺIYqTw{EO r<~`Vq&]A2>R9 QV= cA.s$~S2Z 엟4jj)IO] fIj8Hi8$h `sr`0O-N5oڝ-[:hFOBU1Y,3kĺ e.{aPc8Y#F;qe7gXk{E1k[>v;t1} Ǧw9Oy Oui%.L#&Ј +RI$JI$I%)$IJI$RI$I%)$IJI%uFRk׾FחX%_7P?&J퍲$49 U_5g34_X?q+1!%:ʗn`Ğ;P:+ӆu*^o].j{lq|/N33s][Q뭌k~l\LRRNN_Ei120-׉fvXui;W nwRf5193sykZ&VJq:g[g{pC7qqKkvm/*̺juqkwzlq-pov$I)I$JRI$I$$I)I$JRI$I$$I)I$JRh{ \  $}9¹1^Ωܗ1΍yjNm/5ޝQtI!Iw +X?h7Ӷ:k=$ i5III$I%)$IJTZ/T]gnmgsodOdI$RI$I%)$INoUк#ӒֳsbƻkE\WSBgIu2sHZ7ZG"DlR u{1>qkl6X}-ޓsZĸ5ls'1`uW:Icd Pڭ:vΎ\u1S"}XMm\O ?xx>W{Կa%?w}:[Ys` k产@ku +c`;`.n7`tlK\ݎkŤZ\ƃI)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$eZZ^N$KW%I)+p{A)*LG!ջLLn9c`:[?"~WRRI$I%)R6l-wCSu$IJI$RI$I%)$IJI$RI$?VpԓeX^l}%~8|C `W<\Y3v6A'VW$C]KZgc.}uuƘ D^݇l:7p$V"D SU>jV54A )Dв4X$YQp7N.7P8@Fşz\K4>0c0-^Qmew4X˫Rb5QK/s'lkjp?AMM,qVG=ZXX n[Ǹm]֖GӋKlL\VuR g˻l[E/;֮=N8zN?tgZT{YN"^;x_)u7TsQ$9nbuW[v$?kƂxUݾS׺'l4WaLzskik}lw eĹ즏11KkO%H6+1~,}ƶ}FkkױCt[8_\:Pbm/au/6ž8`w~-Y78xguSs)kh:ﱑuc6Ŧ_/BUPcmw6#!J2@!5ώC$)Ju12I4)%t%)$IJI$R'I%,:dbTJpSJrP7<(Yh +//!ؽ>3rYF opS1S"1Ne#Q^_Vkr#~מۋ^>ImMG]O~#R:pyê/&X'kHͬytq[ql{+$<4KT|F1_ז@uzOnu[mZusLѺQ߁]W; wm}n@݇Ig͓'"|:7#IFI$JRJQͫV%6_cYŵ&w^Uݕ[dni4cѾ[nJtY?_=7?2?vwNCtw%}=c2Ϣ^+YEXcnt(UuW4Ƈ9!sX4Vg`Ʈ}O۷Α4d>?*JM̱cK2tSw;tf>>-e[&$J9eF~*~&=cuMgl iDAVzOJga}UlݱbL+i)o=O53ǧ1>{+t-/#xC.~C"Cca%  8sJr`zӺ~d7>jp{r2Kc.@8Zi$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)}fF:;AAj:5 +5;cc]6 ņ[A6|wkEhuo#]Ȁ`$HX eK]xsÚt#EIJI$R.#gkƇpAЂ +Jd:N8ǩsKI$i)I$JRI$I$$I)I$JRI$I$$I)I$JRI$bblkDz7kC!ZA%feMCqi;p08us[^&IZ[+[Yӎ]զ=k?ik++7Q`geUv x̮$xܮrE⏭6f8N*{tncwQYWѩ01|;$xςFYcW}]mUT~:7 _I;]Seh~=ywg)$Cm-glZݍkJxr؎\}$c>vϮxE?%'*!ĆZ-]Mhs h%vOS`-?ES瞕P/qy4K k]vOX'_coW{'n^/S4803lAx*T8}f{w}-8d(N:#.CrRCOjkLfLӹ5Zbڜ9G,$eWͿO3ه1!A'Reۘ֡^[qqvߓ664\2 F'cawH%IU1k2;KB`ޅ[abL[]]9aa\X_J,1G)>Ho߀/+u=63E,&ӭͶ7Q#]&.&. ælze541\a &U|޹z}kuu^bAU5\<Ыwѻ5O$nr2>-1uX,5B|׍e5RLSsk։Q}%=uL3]5Xיu \ eP˫Ǯ7k!\agf4}فjνwyA~<;ە̶Lemuν8{Oּ[t;>1Zb2[LF~d{)Ǥ } 4k$Zݛ?}L(۰ΰ\˿ulmǧƮyEmcAzƎ.uINOOoݞ>n'I-:iM,mUT` kZ kZ44RI$I%)$IM'rVX{ݝ{:lh-{4wPͯ +2vW>M +zk~'Vƙuqcmo$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$Ji](G ![tƵݣݤ:nƇpAЂ +Ӑ+];꛱ksאFIMI%)$IM.#`j]F5]IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI%:Jfȯ d]T Ye.ѩw$7LݥOǺlw)?>M?H)~W{q5j]}W v#Ȱx)A*,]VN>4{+qgZ'00em?F.b!՞ss[KJZ׎YfW6 +sctA%; 'u}_~ٵ?X;,V ί!/mӱ?J R@KpSs&~/GȤ vFfdQs``AKw֫kf=/O +dSӾ\^umæzE5Lq~?;dfs;U}ͫ.XpVI)ӺOӁN%NvWEm\Z +I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$ e}ƻӵ.55i1:CGI% Ed\״i KH1:ksi{=;h.]^o?+,{,clxkdu$I)tXMMe#ұ'4uR?l9_qjI$$I)I$JRI$I$$I)I$JRI$I$$kikX#pk˃\[,t| +JfI$$Cs.u cdsI:z}>+7g6[{n8))I`r:~3Y5]MfCmsF>0; 'Ecʯ;ovv35JuY?=M-Ǧenm7wӪ_[?V/}3vxl}'؝'goxyc3v=k_uEg5{_X4 .pKs#}l(t7Gxt馪*e4USC+5kD5hSGOĩ5yWؽ[/wi~Jߡ ja͟-{$'na{,mv6ٍC- }8pS&lat>7`tlK\ݎkŤZ\ƃJRI$I$$I)K%ͪ{z};zClv8e^f9X'I)ͻsÆmԻ(=꺶72#Ey$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)Rg9bd;uNe9{{Bu5YѹAAAIIUp\L+6>5ۃmXei%4O[?WZ]'-g+n-WRRI$I%)$IJI$RIB몢sUU4CZִK%3I$RY?۴~7;e85/[Yu 1߻>kvSq~g?C=oZ칚/>>5kgZݓl@(srۘaDi)N:/OS1-sw@pk H*e~yY94}9Y[%yWwOp1ĩ譵 X%4|G`uy7b;ԇ2&W#tfF=ƌ`4?"%y-wN@Jr~/?W33#"+t =vV:xJu)eԽkC뱄9kpЂg>]v+j|s0yXT~6-8'>я[jcۑOMCk@0O&LgӉS_ckiq<0 +9Cu~&.NM.v=6V:vNU.z}kQMuKKb@WSO]RvuU\x5؎~""uGd?' +puYtُelecK_aG%k$I$$I)I$JC/O~OAlmk OhM d6Kk27#{릩m^X+ٔ͡דdoևCJ={qifmZc D{{$I$I$$I)I$JRI$I$$I)I$JRI$I$$Oh-=+"lݜ:GmnP'ݷ~<ﭝ oZE{kX0ԧa%S`dq[mu.k׆懴ʹI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$R^XWcCZH AI$7/nV=XX,m5ٕkG]{mvzz8Ӭ.쎧3{JǤ.e nZ[k$z_cMvc;*?̺캃X*ʲ8u:V.&. ælze541\a &QIJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%8V9ln]91cJ'5۫nE[q%UŴ9ͯ0SA{_cZd8Ѥ|oue/DZkCe - -l5DĹ $I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTSRKTS + +endstream +endobj +331 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +333 0 obj +<< +/Rect [435.36 574.68 441.36 588.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003259) +/Type /Annot +>> +endobj +334 0 obj +<< +/Rect [464.7 574.68 470.7 588.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003277) +/Type /Annot +>> +endobj +335 0 obj +<< +/Length 4755 +/Filter /FlateDecode +>> +stream +HWr}W#H%[e;^W5S`RQHQ PׯIe]ӧO|]XÜaV;nRV?_ju!X).4sR7$fg6 Y缅%vK&O2:B5m-b'9! ޭsެVdmu\8ZmV,eLf9KA_FvL#sQ5eo!g+^H͍'ӱpVH*d.!Aw22+r透N +wŤDp1{ĒW +F z*vLQĂ-kr׬ٛa]WvU#M.XS|-*La'Tۺhhsl,BBxldm=fe0Ec 82 J} m0Z_(߮o#Vmjdti})f2 Gj/` =IȮ?7p䮀0,n:g7Gv>VB +twtQyQ4hdE^5F|…hCr*ۦh"/넑^VR{'F“%ܩ +vG#]nnlSwáޯFrz$!6qy;=rVᣦwhۧ x/jjh7m#ഫ|lGnSt~!q0>BsHqUzGE 7#t5.8 IF75aY:6:Dȇ"Zٌ#M"'}rv3l+>R~ vH>A SN~ ԥDŽHv0Kw8zwF-ᒭpFّc}_0PIw7u!2ĭIGCOq55?#4\3֜]),`øtd )mw0^꺑:.=wO*I's[^TWW=[:K{"A7ps?'zC8G yT_X]n1XZCkܿ&G*>,Fe=?WEM5&0Z0=Su ,1Ij2Ɉ1( MbV dsh@7ϼWXI f4 +GggzߠF.Y)9et=>,詗+)<9{~Tu) tg b ЙRлoI+oKon +/skf ^mcD2@)#Icʌ g_Mpl%okZްy2Z/^_zVG qA)*#ES2 pԚIwп(zvO޲"AR&u5X"S_ENMtAfI &&q3ƽQ|EۉPz@4ev0p0ϧ T*ujS^G4ۧj6=J?:KgMR$ϹFq]hf묛hK4hꀡ=#JPȰ֢>c)yR3HloZq*ŝCC10L?$\i$O5!OuZR|)Tu} 5FV`F'(LҗJ3TދByx#%6 +&9\zY5daZ2s@@S2F̶k ZU>nt?AU٠PUwGB}8,M|o3!eyY%(wi|dOv(ĔTs%'!4J?4= ~vqFB"=Ҵr#=O:T0p (5^q|GӅt?_+~q>4oq+` *#KZ24BL`2ME`{V)? I׻ff̏Gq[wW˒5s8zBA7p2.p,CR{g1v=z(U|-\&`ce b,;tɱ(..?t(tVs,1\' J2@:CJ>?wqD+Zr~2F)͠?LSr2[)|;sm/ع'iw.Xpu xE4gN̩bc5/3{5,S 5zj:qx\Ф?AܜZeI]W噂? yaY%kŽ:6ߤL:fF,Ct +r7.e*0rkУ9]gDml#ŨRGa2`i=Ey2dEɎ,S0  E[Kv4r(e(SĊ );;[7(Ӯz`.o R)dibFJЪiQU2i)|vfN1^-T$zgLK4bF-&-y"%(IMbef+ S)IPָ;5t˹qςDw)?+@; K̐IL=4L[a&Js\*h57꒖͚|jM iSxAZZ dA_L1=;5}e4z0_z'_ۃ5e\[_{ʨfu0ft1=":x$-*lgǝ9KOa5ε˛JjԻLВ? ~Kw|vuǷ{NYߓFґϡ5A( +ݡt!v.ńaۣbTj5хI+!C勏2ԶoȨߟbsG4T僮3@QcO(x '8rnRKZ65·TKy5#`aSK/o% VhA O(2 ܹhINf^kjw=tWXW>i+ro|#w0<`SH=C櫮C̺M}ArWkx ψx(x {8q"&Ge4үU_wTDYd\'0HI0ş?Xw}hk~@!'@@(R"ytzF; +φh?Q&M_7("P,$omKWg*BXDCȢU*ml.Mtۚ eMvEd܍-ő)ԓ>\FV,Łp?T]847$Ϋ ]zr!rg[[W{+-]qtw4$d꣤wi fAC{ШW)V8jqmZ ^h354*,UI8_86> `)5? TSS`bWSo6F`fRFF>1iT/hƱb'9n-dvB&[zA\0*g8Ph6;i13RΜݚNy3ٍ&B9v!Y +6=XX˳5 +Ѝ5Fp֟`C-oahS J3 p9vW"`Ac6!Jc3P]'Hmn$Iۍ?hrL:\mV#E6f'\OX^ +m!{OFȿ44/@)BIcW$#<,5dzϛwBdWu*/Xw[64FVv42@HHTAKV.]ߞo3yOLȋlFcG9+ըTOKYt)݁ҥi\69,^m(R,!*{$f +] Z:s>;$tV*Ic +endstream +endobj +336 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +337 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +339 0 obj +<< +/Rect [85.62 254.58 143.94 268.8] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003323) +/Type /Annot +>> +endobj +340 0 obj +<< +/Rect [85.62 180.3 143.94 195.84] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003375) +/Type /Annot +>> +endobj +341 0 obj +<< +/Length 3681 +/Filter /FlateDecode +>> +stream +HWi _*qwObW*+2X5HvM3yi/# }p}.PT6X٬Y5O# fTX +OaJ\lb|)qvO8C~VqլavNOǶ^}3ዲ*UdUjxM)RcL=CgnvhQp3:O+UdIn$}FEv9P*K܊ן[F|,p181}ŁT8V]!vxD9wg` J:ec F>yVCY +? + H{ Y\P@-&zF0Y|b%*3!cvC$2IZ(ӈ6*uGll6s1dFCI .UARU,S|I> i'y5/)m22LXnth䑱Ge&)tfS h $b7ɲ(O" !$oZX_&}EKAg)):wQT=P*Ey[(2}Iq8!FbgyNqqr:Tr7xC}$r:"0Xjv5ZH]̓)bGEf.@޷4j88C"y= +/%%¤8&P !&[K4!<1櫢{t^]l.&pHnI`wepI._` r;XJںORA;Z}|\ +*!x` ]̮nE6]ǤU}B/28.]\/.n1^&cU}@boVWE(چT\4fbw~3FÁmgr1} P*𔑰K +༷̲Uk|E0@s#{B.&]:l$P#}bұsPoL9+*#z~cqT_/O=e|w9u g| BT za#y~ECez-6R{d_ru:_Jx!J~o)L-t +⭴)_ Ղ ٮҋn\}U$P΂y;V[BE:IsjǤ߾:#Zz:xib\.\ym,T+Rx66_)Nb) i0Dd`$s˰zPO^t}<߽8X2ހx>_Q\˳o7,T;1YQUعaq.?]sLEB'`|B40g7H_Hrd"&fyQ#Z}E~S+SB] L (orB=B2cS_/ۜc4}T YӵTa$U@_;.Dg. sQͩg 3 ɼSz&ޫ`s\77ĝy4haיH٢Ǧ!#̄+ + ce*(ZIG +^p #N:FF8x-:<<'^ip! +@ۖGr༫(k]¬Wf^jwvmqx**nM8rW׾r[qLbqq6G.k8iGVʐ#ǵUǭ͓waNIu\6%E:[f$Ks#<%%g7l@e5%sMKQԷY_ h&%|qamt +endstream +endobj +342 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +343 0 obj +<< +/Subtype /TrueType +/FontDescriptor 393 0 R +/LastChar 115 +/Widths [556 556 500 0 0 0 0 0 222 0 +0 0 0 556 556 0 0 0 500] +/BaseFont /Arial#2CItalic +/FirstChar 97 +/Encoding /WinAnsiEncoding +/Type /Font +>> +endobj +344 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +stream +HWn}Wcpk_/ +4ՒpIJr9&E=@XUu:['0x4 +ZM`n'l38GŅfN*bְ$I9$T8-dBn&F6mKx^ϳٌͮ' f z6{`1iLFu`ΒS]3f:LCæo.~:-k_|}I,) +C.դYًŢ[uQ#{ˉC{sh?١Xj + +chQܺbջʹ#V5]_Wr7 vs5m]s8lw7y:mM~ЇOދѰDrR C 7mw2h%X.=AAP.N&P$Cl&@xG]XD. .cXW#Cwa0z[曛UǶlFEKZB[С< +Y;Hyt!to79ƃ9{ExDfOp]vi+` +k/2tk>nB48өld\B`iB_wSiEC::5 `trAы!YmO@`ʣ!sLgj6(ydȰTR KFEMʕ_-޻N ǨIVR{s9ySu)ixDω`5PH;=>gHWv<M7pr|GW0zb f"Sݞ2-tuֲMsoǨ<Ysl}bX +o4<㓃by} {5zE~(sJRxTgv|K;+82hfzڌjBs0PB{D.;%ѲLAADq(MB$F NPZJ50=?R'(1R .r#(#5 2 +endstream +endobj +346 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥kH $ +endstream +endobj +347 0 obj +<< +/Subtype /Image +/Length 359 +/Filter /CCITTFaxDecode +/ImageMask true +/BitsPerComponent 1 +/Width 500 +/DecodeParms << +/K -1 +/Columns 500 +>> +/Height 500 +/Type /XObject +>> +stream +&je d:Al:VAl{ o2 Ϻd2@a2@u. .p\. 뮺k_______}޿Z___ZZ_ZZ__~ﵾ[ o oX|5 a5X0 ,d0 + +endstream +endobj +348 0 obj +<< +/Subtype /Image +/Length 38610 +/Filter /FlateDecode +/BitsPerComponent 8 +/ColorSpace [/Indexed [/ICCBased 28 0 R] + 255 350 0 R] +/Width 500 +/Height 500 +/Type /XObject +>> +stream +h{mXSgU6) !IMX|`&Ykń$j=i6-nHB0=a$ BAhs|gδlkQQѭm{9k%Ylk?ss?s?w8p8p8l^N-Y"x ?`0'/(*(^ ׼ +,,YV}YWo -/%҇J\~.6pY^qA6P] X8/B(zd,.vtJ•9s~^jիsr+Z+Dk+b#(*W-/d_ä03oueOTUc"ښuPKQR:ހHpa;{&>/ȦŝSDuJY_g` *f]n㓛65kk72s/g P28[+ٖ v {2qj$i{pX'tbk,A~X_ҷn;GhLhH'5ٮ Xo"zJU- +w`6GM8:P@0c¿t`nU.{papNQ`S.BM] 8oYiS]NZ޻ +/}fxZ߳VlNħz'L2,ة ? n{`]*{{kys?]jh<4Tɓw{gyH^Ē"4o5o*ܦwSTh/} +vI#սw= +|/n4*7{ Ep[:+/H7"A54dlVI͠y[ ^vI=,T),}/lh @w2Y'jINSg>n` |)&6|)ƫ¼B6NoHA7U I!v }^[,/Yn$ݠ{y]Cy>A~ =hoUo.RCPgmt#&G +u,Mۛ,MxrJ],57:fdWPT/Z&ѫHR^"n!uC,ޡuWtoodUXsCssc \d*Yi#d*jrN7k)jLZm PVzJҫVVZiͺ|bsVNB.WeV|{QiCn7 ЍTJB"0! ʄB |1L"+3alnnЩ5k=:e5eԨ ܾ^HgowdjB:pn lnGά (jL_6YivSl_]ąe+[k'F8TBtf Q\QW(} Ym*nV6tZ`{{h41jdVOa +]AxPsw&XƲ k_3H:5YR Ej k +'9m|H=lwbclAu\M,*6xM?Li|/$(%tR uzعi;"*ʀu.r$F^Wiyycc]dŤj'8\8fS@Y8nm6 +){W"2>IɷdL@d}ɦ\#:/I9-$]Ǒ)ʀK`Ճݫ׉Wr ;:[;iZir lXv\لI[&Dפ7[;[[A+u:oI[BX[;Z$c$4FҶRgӿ1=mF` t7|EiP*kSCrW\,2cfRCSCΙ]|{4 [Aj?pqiU:Ikvvt2m&0ˀ;hF+PAvGe+Yo@qgmFƒp} t\zV@QllXlLRhɯuޚnHM% +?lZ<<{hi.awl 9od יA:.:zsq~۞,h<$NM;#w2hf?-@NgYϡimF mw̿/F2E7[ˁUk=g zWtC!Iҵbq llB S=oԭUMs+jv˅5+sdړ-@zzv9\]~rs6!69Ms5.O}z\(w09ey<ͭF< =kP**Lw9Ez:Rw!o~',;vp-G#(S =[yb uti;No{GPG_p9.G*0^`=O_HZ5BPNpzЩ՜UcJpԚ-#\F]ZӵHWp"ZPݡkL*]U,Y/^rn" +NaU9ܥ׈H}֥ ȴ+tJRc\s^ۂpN[5 ?{S!vzph\YCBH&wv8XjWgarKΪەnʇС4w|Qj'5U{ +SoԾDг":aNz.u>묵ەZנCS5ZVʪXQ VM-zְ‡tZSy φw8pR]־[ "áwv⎯JmԮV.[+V7mr.B+ +-6hۍpNcWWC^\j̥awڙV$Ulzvj2ZozCzP{POzz{Ȫ22^M?j-Rʅ5H约HΎ:tȡH/s\U677x!z }Uz㧀ꮮPW(DLG!oI&^\h̲\BVdܒ;)T5uW({"Hѣw"/=rthh,#5DsUsnx;Y9<-pCBc"X${qX4y{ǎ jb3V.S3c{θ%:o@; Nny7t Fm;$H;^ Ԯv8K9WNۤqg k%Ȫzޞy @jxhx p}P: !Hzd(QŎ8r_<۱`Nq㕊[/5&=,2Q#G + qt6Gb}=!tp;%#AeN#9Ua)VFb\Y:U:'}Cc4݈1mN9`=ǢH"чN84k=hâ! W(P υ5HM ѼVcGǠg}g@]Ϗ&sJ<8ST ۪\-%͊dosg N-ܾܶr{TJOΤ|(3x$P\}|hu D:PyjmGV|ZQSFbgYC7P78HIC `èSTܡʇ)ʏ~,I#9n@9kJ`c/o1<ީڮ0sfI6qx<1IY5s^3bST4R.T_o?Cv93ё` +r;۹۱Xo$ڋjALL]xEFrg Bqa0itt8]&Ɔo_[t A=ݹQ3O/=h^&\Th_!г,~j8@O=9-w"gt;@=Pߖ#]3wƍ'I3AnwD[ν:|W {*ç7j#Pg<:%vDƆF@M EjBt=ϠmLb4 jZ nKD 9p+gYC٫9P1hbanJ`F@P8uDCsgvܩ;=er,')-n{rJݳVwD4?ZF2PMxO8zPhPʡ:S=\c%ZhV =k(9[h_$2Oޝ"nF[jz:w;s;sOn~EC[% Ϡrg E&&jڂGCmܱ`|l?6{<ƷEO̿-IS>;9Qt"Q"`ޫy =kTa.l QrDpU-68n|c_F~NcTE? h?/О)_ ٨}Esg ܪ13)iO숍k±xlPMh P4:L bJѹK_Qp; tQ&(8a /4i&56*+uHJ̊~Օ̊N+=uA{7cnH9}+5qð2u +.BN-j.X%s@'v6dH0sCǘJ1-z_oU+>^ą5MZFt%u$҃Rs,1 +?} @HFzTsWcS&j.Z[+ܥW 5UGZ  GRm83SYg"R Bw՗' kn d =kXf3vws*̚Iy93fCѡ8PO͜ʚڃj!KZRF=׹#qJO>cB ݭHƂ&ЄsoRYT#@=_ٹ_yc<2nˌ;P$MZHNz)7o"\Y@ꚬCw7& Ecc ?{

s )|uvohS4n8q<+h,: +>ѓ;D9NCp>ʪMVI`ǜUc~\綑uF# +Zۣ?_.|??hj%I˗'续D[.gXCً҇89zʇW&L\:}eix&&Oiqy?ꦭ]\P,HR_ǹKBvk\"H( + t~Jgid܊"TR4Nn2(O'=IX +\kj629:ܯ24ST=gTp;SLdʼuVOX8YCV9gǙ:g$6N4)OOjܛT6Q 8wϼ +0ͥY )UVMW,YŅ5H +3jΝKUtn;)YK?Nޜ#K]V p^,ri4r.Ag2S,W>I,)(C_GI\_ W5(Z4DmjVqs e(Oϛ1R{r$3@받vj24gh -v =k(ޤ=|:g~:z>Ryҟ#>99oVAjSY5iI =kHM8s_BΦyJ^j$IJt d<n +M +n#B@cs_Zw'.I Kn(|hvy\YMb~~n|}j}:iFj1sM㮵+N8*V拒V U[G'h{>gf͂HFS}%Z譚̱E") +B[[͕Ǿz,srsBQ5jOt]n]GF/=|n^= n'صT:UV<#?.l:߱s$eZ`վڜz9q_|b.9)jp{H)80IpWQj еs|}j/Ar~=ULfs"OPUmyB{cD{n5|smܜIGr I&q0!0Z8JשI؜/`*`[ruIrDE`Zaӯ1o0n_:A8ŴX׎she1&oy[5k=

sh؃Il#l#FRmHT^)VL0NWk{'t~&󗩳-[){|&9`VtF.^sT5dŽ Yv:')t +9W4s,/Q0=U(ܲНQ]z"GU{qn4sװ̌RTv&:9 q`զ/^sI\L-[-=jzڨy?*4yw k|y}s@:z M.~>xPۨu_Ȯ1.ڍU,VTѢXid?{D]e⸸[59]ae߸NڶT oQup7S jh{N[5PM2j^{Tegq\-T_9v33W.tԋϩtzNV5#ekU)ߎTG*9{5w =?gg@iúQ 4k7zQ2_VlόR#S#y0l͏* +xw ͛g~WfN֭~:?2?ЩI\r_[59&r3 ?}Wdw(?RUs'febUuᇿ B$Wfg>u?p$H; >H2az{nHBi7d՞ uk^| ANIZ@ 9y+.ܺE fV̊׻7dնV 3hcuzZebS!ؤP|&~n߿oy{zo}˜!ғ[5*)}ZZ>{.G1.A÷D}Lґχh2;uoF_/>c|z~玶j[/mPv(*<̛*l)ƱqwP3D| +iJv& §;q_/vAGЙ_A:9p`9yXg0得(}Y=7l_PXNMZ69$dh Ié%;Ɏy1lKR SX"JI:M֦ + aZHrǣPfMR +@)/ 9g{iq}b/?_k׺"ʅs +GJ'ߛѝwG׌;q '2wi~Hz{9GPK-s)urssysl ~]7vD4'H|YÙ+W{wصig48SluMeH2{N9\vHo}w@jB(ӏ ώǺ$̙PķV ^UPsҪmI'zйLe$ϹgN +7Dd8ɷnR߽}g#gux?Ayp'0%޸Us*.@V|"F##9}H?.:q}!>2PϷ~&:tQ?cN󯽕Uh*7߷+rsdu빘CI`+@炻yi˃X0wA{ZCW/GzG E?gej$:DG:M]t6dLN˫*~# \j&NUp9{Fª/,f;QR݀LlF;5د ]21yi] 9}'OU(Z 8ejeMQ(S n20s+#Q[`{4o$vTW9ASk;zK6, 39e-vexsesr.˃["!;u;J+}J.9WK_\ 4~EKWt>{(؞o  B!25J+JMFQ;og"xz+Tzt{{Ƈb}àe+smЧ; }$q`ֽbRG VM; +L%Ԧ|&9v [՘0N-Tޑ>qe*k4Y:;`"US;[BFTKqPe2?g$ +m:Ȉv߇=#pgG{"S_P LDN?=߬w7e7rh[<Ҫmujϵ\&!=&bN7?~1tj875><7uDl"691I.ptϞ}?K24ThafV}Մ +*`1¼(dTm̓]ڣ?6zztdک84s4oi +zK-fPq@U6\.ܵuf$Ҋr%J¤ +5tѓGŹ3]8Pkz{J2 +/iFn2s]oeS>a \s#rv!F{ ?5tiGW#gNCtE'čRo*}iNf-LI(-RoVR`"6-MBxW 9{b=gß+W'Pfu_&⾩ޞMM*Za 9vvD("`Ii逽c"6<Oޯ\:y:?tum׾Z8EQL\'0H7w`"NtctL@oF759XT u +yGMlϱGKVM[k]\B7Ui]y˃wbԁ}]J'E{T8:5ue'arm|{n)\6p=hLs-.}D,HB~ߜ5iЯވS8ӳOB/rj.Q#*9`~-|9] .M˃଱*†bghh~ݫHH$' ʴbjr\;wqk1;*#jfRCTFB_'2ڷnXDch299F(O'ɣM55Ky`jk^ۍA`&-0?>߸1?@\#yQ37<ޞ?LIEVmװ~ŭCf4j fd/@2s].r$;3b z~>p??#Q5N|$#s-|DZ*Tm۸D*ub$ =g"Ѝ 'a1FAPoJ3zh:>P cgΜ9覬0Ȫ=9 Z:Sgëlr!_oϙ'%yJ_ut5=E Zޞ G9bJB&<ЈBXOL"=DOXT=]Tc7bhDCAORi?}rm>FnVVN's58.aO8evB`".aqN.$cMQɝT%{5f7lAoRs\rM/LRv\_O7>by0JSQ=Hd~wrJ8 q~|r@FioVN{/(Tl}AdW˵lRTJpH,&Bo} @7\{z>H5 O:wDzlH$k75ܣx/ kO +tQY +h4f<+K:qwh?B;H)zCk`U#Gt?֯EHi&w gRrR$3A%5:JmLh!a0|yI`.twPb ٿJ'ZWlp*7+'#LroXC +j&OMR +U[_a1-#1)c8JYX,ԏ5؁iгw%ÉN&֧"苠;t|OgZ-no-,C\5jnd*`"1K ؅iQyl0v{WTb УdSjO@ Dzs5f~5/O%03'3F`"EHfݱ*:>h:3|TCj +geRº N$*dՌйTD]m`նGA'ōAcOQ;hSቡDz&A?(߯Doq\kZ*_PLY5MΗX+m{A'Ԧ,&bZ$"v`r +$tHOR:D GGa"'}tķ5 )(CV-yrFA>WbRpt!@+Ynubݾ# лBrkz<Ǖ Op(j; ++.up"K)&w-\`0\̿fp3]^.Fuk*p!O\I$Vd~// }&oL@N#1nK B~-Do`M]j6&CIEhKmbXTZk՘\U5>S~jomY ətUO*CCC@뗯̌pjf=鏖)U{Q-AZS*˃V.WbZO'C龶PRBpB燔umi>dǑώ:z*HY/)^5'ڤ)ľ?&՘9~\)X[@g,EU9(cy0NĉJʪy[ ,9fr%:sy;e/E/\42Z^X`"q梑LxCTTymm/Ybuhw {́@m̂7W.ʁ9ju 袳 טQ XL|U;<<Uk}{m/=3ƯЩzЃkR[5ܞ9*([ &V&ӳ2{S6j=iM{."VJ wx@|ʩzN#ol8h:6VM.ʚ*~IVeO鳲UR[Mn"0Bkd#Jx_?G/yjCr'w9?~z[Z)qu%!Uk \EY +Z*$Od$zq^D[[."?p$˖ӡS~f=*z  u mڨ-[MrM0=iqAԳ75\+]!Zw^lLxCnsVVVj-:][n24k~⾛MMM$~Z6U^}:rPw;ٺ%'pV ZAJ_Xp2 یqIxUUiJneq0"taVsSsUsw} W]W%gtM" s~TܔEV U`n ̬W\;lK)7 40_̭ƛ݁n~ P+^o2ZMo6kd=؁ UӢΛ ܼU|3Yufw\[5F.\[;;?z VCSퟶ<3 Ko^WJ | UV x/%[*U˵bwen`i,&bRa&jݝݝ݁'.F퍶S3:|_[Hh' zSKMoϝo +łԜ_%TZ3#>]UYY9"ƾOd$8NDT'Ntv_l>q?G=dT{PG {-֖k[Ҋ{յ'eZMS9;K6iNqb \:MľOd$ I`yG/^}mAZZʜ齥5 +~o9tQ*46yO%uy㲇7A Zc!6ڀy)nR\' m9ښ^M󠿦mӂUOS{{;2h[M\zrC-dg/X5sG,Sb\YdaȳWRVW YrW0>zwv'ҝtS,Up62im{ZhN?C3'V;lAvڪ=mS.y23+c 1ifSh8 +`> + + "cd=?婮>U&确M7|mGAao}}m-չ.?tPK#~A?G2WU,({Yoqkla| NMlsD1˃H^rb ar$9U]W$ߕ#{-o97=eEˊk GB?H_-=YfrJ!V&;+jU6NZ5Cե0zBQKʼf{uuS:IkjP0&IC+s[ѲPӑ+3YRslk'R+Vd/R +UQ)&fy0<}|rxvwCI|:O'|m>%i^SwkZBEn튦N^{+%;ͽ?g6@ӫ++%.Bd'2U|hG;[5rG/TUS՝ڳI}uf+GfwVG z#UC:WU㋹y FTU|,T=^j"V`" +t"hZZPOPj?N3G/RO9|u]wjzׯ_l>:?ApܷG[۪kxҷ:qi6ǡk +ȏifE9\z̮% +lQ߫ڗViUj1! D_ ('/T}s?;ۃc'r>>oo_?rpM9]?iy9tU]k՘aYъKb~)>yM[[hO ^39^#@?VyS;A 6}zdNmϱ_(r9rڪY_e/*QJLdjDqD T|봾PhjΝ^7m_s=rֹɟU+)߶B*H/ђÈ6=k ^ ZTZPn?~b}NHƣZݦY癩=5/zǓ CjCw9XCpjiy֜mXůեS%" jZUc$XT߾|q[wjf SSSW穃o7ف97={ۃhG2jɿdWady"qzJ + V L*/bq0\rsK/4l|;dpgvlj jT!| +ZAVM+MsMv1?ql#'=_KH|S A'o(I4OEDKkʿ V vre!B3˩UK$"bLJݿuO wOowڭ[}܉{#)T1oֻXgbJ>NFxV?uWj8Ïoݾuޓ'b]oߏ5ߛܾ}z-¯߻:4tM|c %w}ɪTSĤ1ogw?>8!v`޺s'ܾ~#ҿg>u4Olc7st tw55L[sm9uQ[GG"C ƹ&?2ųsܾwg'_~|;ݏo>}ΠΕő RuN' +3W8=ϓ+U/8uyJ[i75~ﳻ۾)>$O:Y5rV-AϟY-ʒrO]PjZ2o:^פ>tBh7o>G'S3>+nvհDSnhY <:&*V-( %s}tfw3}˻C彻wy[ `ZV7E6j,\≝ V-o9PW3U͛Æ*{~tNϪ[5TJV-Y5TX;-;:UQI%fBJ#x^jWt|s@En|0?1[s?:*;6E[EZGu)Dbj/ui9] '۷?뼷jM=kɼ%+U'rZto))\܇{yyy,>GRnk&%S=n](v=0պuV-2 qL^=csU{pX6evoՎ %\N(0kR8FSĂ^DuVrwG}}߼5?psGߜͽJ!"<#oa;U˧4r~7FUA]?z-[G:Kݫ_kTU]l]6e[ĢjYr\Ԇ{=ݿy179o~Y$>yZg`7eRXT +ӹs`=/z󜽛].[(2+oYȓժ,<80qH*rF~J׽:ǰc2GU!gN[ryZX!:H* +/،uM;u+'yϞ~ 'GG/Y W\5lt]}DPSB" +.Y@? stt|kw_V +i˦c)iy&eXlZJØ"5nsL]:pGGZL85V0 ^OMZQqJZ~/ʟ,L %(&'PjO"G͗N@?,Yu|lMzhONz\I[@ŸA7|G[c 7x)~fo*"wF +V]EO7X%Xu йGR̬}ޛ0;=r~ѰoltxSY\=~Ǜs(hiiǧŅlۊL\4(tKRH.F\]4129ci{QP6U۲c>Y1ѣ֖uйCX6 P:6$}N3ɠݍ"i+mvךQ{] Hflq)q&4bir:d,gÚ)'}U5ѐH>n|C۸#0TٓGGt[#|6[Yn04A&R H7:KoB//bQ%枵 j|ĺp=䒼/3̡so00fOMRan3[Bpt.cwkU8㭞C5H@Sֿ{?MV7--й8VU9b( V-Gӭ޻f(_Aԭ sYxp/ %yB )uR ƘN|f8c5֊c͗VnEǽ=0dh #GlU:]^(tlA>UqC2ž܁nBrߡ#3Ȏ"J@[P;uPrN VO?sPl8PTfՠ3t:BD5ZUV͋qrǍ&N?k[5+BskQi^&9i=&S +FY"J{;tйTuv^D7cgkWnгY̪IeZ#bPWah@qnnM=9rx~30C' y"+82VқԄ41ƯPvjs)Aν.ÇwziXsZj*vbͷ̦ɜOfe5I7aI68,1K$w6]GF)J. &1'/NfN_8riÛxIgV7Xy1 +fu?ul#VYUow_d;8ԪNt%j n7N)$ĠsvD$qyceϓ*35w>}!w3OXĥ\l |d{K332?[緘,bY5d̍lO:s=/̚aiV1Ccr=ըާ7 yߨ +/՜.򋥓̪i>K+20B%fiX4,^BmF; %⥅YY$h+*Cïz~0hbr`‘g' U17k& ujbɼl)dci4^L"L1NwyBB}tl\`8[}i$R#G&iAvA>Vx0lrDI 7qΧRC Ge^,*"ivNsJ5p;Nj/~T+=ytAsjjJ!(܏Q 4MY)]<Ӽcg3uC߶<8=zdֻ}.M: V4@۩=O8uKtNuz}x0tYNd*{(xW96jA=1m=niH0m ;̃ΩZթ +]0E(e'Y3jJN!ye=q\@%ljIHkk.:MCz-O?qlAdaG{a߿LtlHBuqݪY̪)USȯS 3ǁeclg9i3VDvqzJ.(v}}wl%r֒7gNJ2;y `ϥMfް$OJ 5/"' adS)kg>ZJ DYL)ܱ^zɗmj.+ʋ )6G_?7s!7l5'=&爝&b࿉# Tl9i\TڥV8[f08bܱՃo5ԝMy}O/:D]4lDMj=RH6ʅ.v 3=UT l@ + mCػ+bqmV?֊V+WjwklUafXݵ9;-НU* + GUⳋ|f$PFv8Uuu.J×/rRQ׫$c[og/o k`' +;YdY5%7Ԫ%#ߛRSFfZȥ:Ś3 ZtjW+J>*kZ3 @۶apvzt{th-jtVMlU,.jIXkrD\}nL1̉4X%tn@7u˂sVon֛(sYΌgj&kɠY5tv.lGu'Z!FRH,ʜU +S;`J:KiAC^lUP%Mig-ox զdv*3f! V-X8XPGW{oY' gqnR"9&|Mc)d5"n̼3>svгFF^q>%~H=6 yAM!+̪l^0AfCIBP*]"D*T=ڑ 83~Fn0H߷ mEeV+l tp:p,M_6o S13א=[*.uCópQaq_p;;t.Bnloɴ鶦V-]QJ+ &HK/!gu(a;a }f̃OLblմynӴRH6fVQwg Ja٥Jg.|ow4<;otJ +Uk2viCo=UK8" +ctꌂ( +#yMrQ p1Ď;]@Eo+Ur:sjq8#xA…9k2ǗZ<\VCCw?Kxޝz60V'<(,J"%X \TXxW>_*Ԉ(Z4Ċq6{<|\Aj\_[`,d 4"YO!$}XYZ*F\-tuIFX3?,3ڛ}dit^?=6XbIMgSa̛bD#ei`iviEđeJCѦ8thztW0x*W>Yc +ӴfOZjGA`)WU"^$Ok+<\ /ABOQV}*wSl'U"RAP{_J!XոS1..fƹ DPH:h|CH + E# +o<AZ'v,<:e:gTJPMZ±8}-\/[cOچPns~UЩVI O vh~|W1^Z5U"Jen4NԪ%g&g04-75JsCFCs;HBZLQnDBFe=6g^Bϡ|p&sԪ% 8{N;mıX k!ۜiDe`n"Q6 Ɂ7US g# D$QK"07|bU!FZ)YHxj:$ږdJ!_`%ٶ"*wl +VW<^ 6HWToÏ4Ŧ䁿*Jk=00ǫAHjIJŭԪ%wĦd1{hwUTO4@B| +]6+BFQV%' +3>FBnP EYMx[=|qZaaV@%SpNP }X$6rb~M.i%$Աzt^ESO>!:.NGd&P\U-Jg~vFK6;O[8'k`}4+@vzCD\.d2ӆݑ89TdT5I $}ߥUa5^'R"s9^k$ӥU.Ɵ{*H—R G~|%l:2)VDX*e'UwSjwj&k!C'r`کY] )#b$V--Mw]XPP=qPGNDHԛsd&+(t%URT_T"T6X t.qP9 :`cnT]aVM~ a&l̬?]" W *xB&$TK=*jg΀,tĉnd_Sݐ4U #z/jyS#(&* >3UK8g`<^h" +VKX`ao8!JŅ9HɎa*A яs%~)Ty0@f1D]CZ.'/:FsI7E SpM,tIn3[A?q>Q_@Hm +)³sQw]m (DR +*mol:sj<4  +S@;[H%Ԫ%#? }LX +8t& L| } 7 ]&nIVyvuP`tNXpG(\sxJx#Qi:C~"G(Rn!5UK<~49+1{w2W4"b8nXG~ +euK'!(]g|UG.Ct1\"[Q{E %.80#cQ 4;MNc R G='^(fj=Gk%]<=^jbHT7 =Yr 4 +ԭB$FDpOj˥n35/^*UH +!i-v}@\g3Y8OWlpȼFc& G %I<і;vݔ!EkD u+n˙iZ(w=wv7n+%+bYe9iCGUH+dJ&OɭX$*]ݰFIݘw/3's/0{v2ʇ,) +ŵZ;T۬QXl,߾О:ŠdӇvW )?JmD÷ E$Wtm(2<{>WS5]fNHYX[[.uc*,y>!tx7 *QfCۉCϷ`H8gp +Z5_,5 VdhLP^c`O\J߶I*S M.)-3CyV]+yC۶ xTfǶŦ\J[ߪ-ajFObKFn9caf)Qbđz:@B ,bv[2Z)UZVBT  q1X.-tall=9L@5']*OV$&Hz;C)%ʭsAZ&[.%[e87UZxĐ,uYV Z; ->1<GFu(nZH9V0g9#Hx A44GȞ)@(xL*V>0Cw5EI[}tV ‚|76 + +&~@JDgL͕$&NL],+xQL'`~h}ׂ̫xL clgC{c;6sZO/jKpk9Kg3V4p\At۳y Yfrp,-o9Ǖ,]oWVlkOjپX۸>lZHX7#D8 +CВȣip⸆S? J,ʆ.4݁ȄEЉ^A3.>Y^ظZ^nU]Jx: S򮛦,(ӷ Νܵc;Id.Dnx%3x=委RfsGg^9A |Ǜ׮4KfJk1Fg}xm(&@HYZ2*]3HpWK8s73ɁY +C؅"oZbcmzc6*maз.uZ";rvS^*):X)u]- I.r WV͌>jX+4(H-xt}fZ0B)q HLFJ܌2_mlQ]i#<߿Zk>b^aw}#Șܥv-3zuV[0  E';A\,"/ˤ9 @z)_C=L}=li»az۾z}H\@rZCF%l]кۦsw\dxfOJeptj8?J0%DZ Z5Ջ {?r3f2 ؕ~{kBK!ez-fěSdT#^0xhaO!;dw-޽0;0SOonl +dL\d8)%/ Ѵm]QQ0An$t\ qe,oYnm;:VX(3fh! RSÅR]O{TT;7+e3 [D؜a#2S<x*M3%n?A%2VB5 ;^[EVhi"c>IRexܞ:Jr&ID3 ]ؖJE'Zs2^)a-`sj5 lzZ/ ,;LrMr۞CIkН+/F.^'.j]T7q6j-<Vz0"SP*$^3FeAmkx 3.YjL`k~R2goÆnS ωbzˏ7;9\-fdbKeʃͣ<Nl Hp`ݢڪ-rkh6( jnט/KU tTJ"qSӣANQ[sj_|2}t_>jYUy|>ldnuJeUռM˙Se=Z~qؒeEŚ~$Q䟿}2vBeK"9.lalo۪* ۣѽ֋8an{_?aAKN;GtW 1xHvVM$k[~>-r} YqrcM|<أY?})Hm_(Um:9Ájd`2㚩M9퇅Qu$QTˢ9~]p |ԏ! +l0l; JM`\:@=kV64\JV(0t y\o$\dFk|hLZ½q|eh8@?59דdv[+Qҩ*yO~+j4 fCc֫+ԶOt2k PՑ(炗.7R̀6ed25ZW?4$\gKoDm:+VBMǿY&[t/L +ם1ޯvvͷvieu93bDt<@Aßj?J>Nz`pϊ :bTKe}F[_x駜Q%a]ߐf t>vzUױ;7x >+"I@YӏעǃiOXrJBfA,nzwOr jkgwh;N;e9Q;g 7nf6]wGq7YF~@`j1aQ [pw6DsN̟(9a(]ȇJ9(_w͏_u젹0uͶCN\W^+_>0qX06ꛥ7? ο:_Έ> pOΏ0(5jvO?FAjOA%g+fNM?󛕗b3uT p4h<܉0}??X"֪uSJ꺧'#5c8JG&Xg߉R;\٠>6f'dO~Ȱe=24n޽=ƽ ~FqiBךWl?~u׎sjZ_y_O 0 +bgsqk~ ۩ \} vdv+ [{)@;><4+S/AwdžC)sE/5r0 3;>r_3#8xg%)1l'uK ԌZLޡs@v#;z\I@sƘmh*NSL1?X>?ۆTsOjRBONS 4x>Y+|+W;ߡ"oP嗔뽮OeirMc0F;vgu|.:INwNW$ƥ i7a>/ꨊB[NDܐB_fMlg 5ya.>g>mBh_G#]M妒53\ύ0 + +endstream +endobj +349 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +stream +hĿĿȦcieTTTн~]]]PPPCCC̴ռñ®aaaGGGLLL===333~vvvlrqiiieee_inmmrrrr|||***Ե~mmmSYYYYYZTY{v{QQIFCA!!!MLPJPOkeitzvRLLօc]^䵰zvṷzzv9GNbltrrm;GAJBK +%5-<0M7I ==UhE_ &/>YQlcz7znT{9gxa]xȘId\xx4iQma|l{as}FuEV7LW<[iiedUg6KjMu1rPx>iq=޵,2W3Vc[6  + +endstream +endobj +351 0 obj +<< +/Rect [85.62 401.1 143.94 416.1] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003519) +/Type /Annot +>> +endobj +352 0 obj +<< +/Length 2129 +/Filter /FlateDecode +>> +stream +HWr}W# i3=uNr!+% +C_ӳWd"wwft}8+NYQxiW_DPTFxMsZÒo~|;/% ;BW reY/?)>s0 +{ߛy&ثm? OLKK%Mދft>s8S1+]=v/<,UU4o$x(m:淓 ^/պ6l|ĶG<2O+?Rxޏ6gK< eu%Ur}\w髙Kg9K_X68t/jUD! ^z3"v%ϰ7曗"x=1%;\/:BvHb2̈́qo , -?݉J,Z]moZ 1~ֻS)n>Xlal*:#((uOfDh+C_c6n[# ձ@+K{ ۯWZܭqalssr!)-o9"S)co,hķu2([˔V p-inA,֟-3{H]{v윣ނ6D}8kjX`.iL嶶kyL \_RQj:.msiM:DB0I(\dVD`Eӧ97&YEP*"H ogLBOX4B9SzVi[ ]R+ ~@CQs7jil۝G$OJ.)OP]-Ml󟿸 g]اj6)#),ңdt-Ir *=ێʏR?FJ Uذah:ʴ$5]d#.gIロz`Dce4-H{yXú \wyΘDDfO$RN>ׁg5nb9w~~^˭+[$rx߯UL8=2R|}$Ss1#\_ 2"E6*RjR,,ax$#O ]ԜӢ6NX?_8,=jN@bJJҖјToRlccR="woE"j0+uҍ kHǼu3PҋČ"[[z/Knz<roS_w | bAxktܥu"Y]̃a.W`, +endstream +endobj +353 0 obj +<< +/Filter /FlateDecode +/Length 66 +>> +stream +x+27ѳ047256Q0B=conjgif``dTd˥k: " +endstream +endobj +354 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +356 0 obj +<< +/Rect [331.74 673.68 372.06 687.9] +/Subtype /Link +/Border [0 0 0] +/Dest (G1003580) +/Type /Annot +>> +endobj +357 0 obj +<< +/Length 3298 +/Filter /FlateDecode +>> +stream +HW]oV}ׯG*nx?I. $N"&}p $tl/dmR 6Mޙ{f̹s?ά!DbȆN| >B%BMN*Z'I/BZy%[n=W-ֽ5!<咽-WP!-3ZhyG-!B,.ŶQpbwkWr*^c=7'i"lEM,U_;386q"tgx=m@~WB;l[mU8lT1(a]2|@ y[9ˀ.]YSjnl0ч@"o 8[.Tm"?yTy%LJB:GGL9PA" +ˆ蟐Y3R'- GL4p 2o)kz77aPr/M kz_HMN?ysrm۪v[HazmrZUЦXoSt[MS#eM#{B XTtSXwӔTMf>Ua{z@Nȕh7`;))6eU&mFIhu]Ă^Q^mޝQ)'99}BwK).ַQVqGuKRCY hִ*o @JFܲ7'MlmX9 + Pkն>uzmz"^&^MSh9:у7]Aya;:mLY]3Qږ|j6e4Z&"6e;*^a381K=]ΫzfhVbģ:&"qn4ZhCZ'>~zSRi;;d`YS3ID`,UK;|m_++Bӟt5 }D3)KT0EÓ%Q4`JiM +ZWTv/zR vU/9l#Aջyh-v",x2JD`c|b]ӫNP'ɗp%1)\{!.F¨).!߂ )S`{&9b{f98@w[r8IOmjrq&MDeS'd~yA{|:&Wҙs>^܇d{B3̓"ǓQ,Frp\w[aq+eby$N28f-%C̮ޔ6h:8s +~ j7}dD SoD"i z9FGX0;Xǰ@I!  38"uaeFZĝQr@zГ0ad06x`#n"IDK[ڟ3"Q.˷~Gt=z.H㹠D 'fN FY=.sv`J b!dXX|oѭ!]sÙPShobu, Q(#̨Ԣ81c8su o +BvDžUM)،,Ko#K}N[p̼%?4sE=_uvX/5 +;g\4h\o0}B`l4% +,e#`u?(\l^(]xwfP; V@7-(`fzTR ~p #\$؉( :! Ѻ=%!|3Zڮv=h,GSf 0C #ooz|$L4Ni> +stream +x+27ѳ047256Q0B=conjgif``dTd˥kh U +endstream +endobj +359 0 obj +<< +/Subtype /Image +/Length 6466 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 159 +/Height 243 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?U}/va_}:\Ha.0YΗkq]bw +7^v~W]mйì{qqIOݯ?#p$h?ٟqK":IވޯDA毶S}/3򒟦?j j`o޾ff_W/eRS<z_ٗyIO_7KfoRn_g%?LJ߽/X_BۗyIO?ib7s??)}3;))c?`KG??|qN:ȳ⒟xn r%'>u~ ]vS@}:nkk^Mٯf@;zi%2"piW]lX?gYyn;]g^i)}c{*_OL~S[\->s,cp3㽍lK2?21[<>S hKk֚hPʯd5_>_p?>ď< +Kmm6QPq~?g/wIvޕmot;pxUtwt%AF#).@JE5?׹շr?>g!4r^9%aOXXӸi rpHr"8.6 =0̈́ vÔdnԃ[:a}@GWSL}hz$!B_9|?\UT?xH+ޯU|S_K*~+h~J Ci__ezrUv1ɱ84yVL_wlCuYIG {e ̢ώ"]/w~v4UXnR $.v=tvU Tnqk͠Xj8Ϳճc~4gL7gMsR 09:{^-5y@z+:uh5Vq*3<[P=35.Mu?"{俙v>3Wl3X3W\EڟoWk*WD +Y?)vU.;YWc?_WA_6|\l&f}ˀ&oJ%5ģc{CՌ%fZ֗ /0Idj,,:7y^iTX:~ '@!_Y[jaBZwKȟ_(K2;q#ug{g'Rue ʫf[^ތ k|7N_PƵ} jD1੶wQߐ:ʾЮ!_3OK'1ߕ%!}cmҬ"rW}o^<+8ޯ؁8QR}iT*edoc;U[\'HRp|@X˘}%iFV9w+n(;sG~BgOc*JAo^¼I{[kgCioojb"S?c> +n1OHpk2h{ylJh>jnx VS*-5䆻cWs!ռ [$ aꛞ|tx+؍K]kO*]2;|]BW>)q;?YxM;7P,FK}Yyho`\ȑQa/s8goۑQӻf&O-OY;;FC`s 5l)7?Wkű09=+c/z~e9?X0 ]nkuOs oOલ1w[!_3_G'1ߕ}1;?URR *Wn^uGYz?W q3./آkcmE@Ay4?0'%CCKZJ,/Y$(ߦtB*;K.? $\7c-#D撞׏%I*rdzָasx?%6ٱ [ +Aݕh;sOܢVґ^Ѽ$EˮS,~)#(KC??੶XD|տ,~UgKW[RwIH1щyvU6pO|g|^R/fὼB]; ^rDV9IU<7tvI& ms^ߚ= ۋoMWy# -c[s xk:,Ǻ7=Gۑ +{@lqlILgcYX :s?|*s^C2 +>Cv"͏Ģվ>$ wKkhvB}Wʮg3"Cc&3 -!$34+88Q;q,5ѓ7oeW-j|>P~Z,܆8H귔!)bPZ?DȹMoo+??W_.aƅ?O-6e?G~EGW2_WѬ掱*?~JvU魦 + t$.ZnZ!\uDwNa%kusq❃[,iv+~պ hE5XJi3 *ޜpi{kS- $o { *4BD#icXk-|TaB 9&Lr[B3D Yt:}Py +2.^v{~ e3kYx3pϚ 8ķX~Uڻt+\}o$O:ڼgpBx$M {(8|5FIi9o@(Q?J il"ʶAȰUng8b@"9>ZX#!"%FΧ_Pƅ='O!_=}RPtw7]xpz;UOc]{> d{<5Ө +T14#I&g: [䒟/KIP+ԿGF<;GKO;$ +={oof}S䎔7/_oyk"rwk"7_V0IO7/k)sg +n>fȦoJ|-e{W#LV}q%_6IO%Dx:IOIIJNO3gfrƹ0qgx-sMk:*+ R/RIOI/RIOI/RIOI/RIOI/RIOI/RIOI/RIOI/RIOI/RIOI/RIO + +endstream +endobj +360 0 obj +<< +/Subtype /Image +/Length 772 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 12 +/Height 36 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;$ "? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?jezݑ[mIվ /gQ7>gӿW(tQk1P}OV9\w"lݾ|z;cZMQ֙vg>M N[wJ'Ov7vKPUّveޝmng韵~Ѳ߱G ٽo;woU9q?gzIWo7[_>oqI'uV + +endstream +endobj +361 0 obj +<< +/Subtype /Image +/Length 6800 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 243 +/Height 159 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?UJ',JoxɫqnC87R/FJ5d 0@>? |hO|/Bo4K{Xh : G aס7R>G'WpLk/h_pѭ0 ѿҗ7W= ?v;8/FJ^i^[k>A/_GkW|Es 8^ ѧYHO~Wڏ[6/!Q⻷!{פP|. W"ѫc>$* $Jk4 #QC$.ώ^yo'>$;ݯ>Kܻ.:n)<W旓G?$<{t !6*ۛHkhՆO賁/ R}Nkr$4)7xk~ vhCd]kwOb7Ԭ;ʼК).N2#ƴnw +5VwBH v^ˌT1*VB+8cAUCOk PA2 +5Z5Z# +"vats^ݥڤ\<DnBn/{]-E\"Bl8>gD?칶{5CȨyԅ$na\G։l!u͵0:K?B4?/Db]GÖSye ?gnsJwFI$R?x>K[rO+?չ%+rsA2o\ntQӱXELVyO^M +y6'g lT <w7Ӝ+?V~O/cGU.$ʥԲlnP͡ :'Cǚ&Qt`-@nC<vK'#WR b:^9fQ';f;=iGAi["[~VӜwZQ!:X@Jx +ɺ2bgV1> +VdUPj| r@(,t@sR~Ct`mw8h(;7։k-q0<) < S$^P< '펗0X撛k3I[MςC*nJ8XkcD[gD0J fe UѮN ]Qe12ͣۡqXukDG!utdנv:J徲WvYB4? +@pGr +W +VcI$d0Wfrr,|ײ))`} r;]-%|O旓K kVcd~UPvݍp +qBNo ?4vu`KW6+($oMSmv'R"ܤ4*Ts?B| DJ<'E{ 9WPj\Ti4ܵ|E"?UW#i!:]#>5YuMc~hoİj6);,Iy.2ue'cשz^O V2o0Pce#wC'6L2~:(;cΛgd&1!%9́QsL<k:[sD%e5l& fW516}|@ C,ugEEǑEB&9+HX,>Fu{~?tC$9j;!͍50ImQͭ0<9-pY~Y F_nʯ\쿪YeLH0 +.O' +=bbx@<_s׳W/h ]$I%!gO+WuE} ?:(eYTRR9]M̠tVAmLx\NbS2+|/&qp7;nlIՎT0bحfq +9@[/3d~wV^|LUa46&s̟TehKsOj#6Mt oeќgV7 +'c>=S5{oil ztj\qYT^Ezmk<‰!=*&ҷXu{|J^~ȩ yLrr?;J0?whP_{٣YO<@GzG ;6B+zn>@(wQ9CDcf;y|N(]`R]?W>iXZ9lҗ&kI$U1~!|g; YTW}c*ϯidžEE%4vX oEJ}M5b-17eϭ#r[Kq*? |,vת+'ĥ'Sl}wz.Z~)O/SW;D'hY>)ICTy{q~V IJOq翩ǓĒe23#.ƴx5µqوqykGg?CJO?|hwzco2<)')>)}\A=aN|RI>%)>%;?b+׭C4l.FOR|P_qwl/Y)IK}9v.<=w0)>)(s',xjqr.( R?WxMS~*ϡ$I))ɻA!YSO9vߜB﬿Ws2r*bYMm.}^%S6^[Ԛ[48O$z$֟QdOXG1҇oԔ';ro]S_m#z=7pIO͟Ļw&Կ-;Ң_5IO?:Żr_:Żr[f{SjJ~h-;5;p> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;; %"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ??K=Yظ{oq4۝e;4Ȟc}XѨK +^l!Ko6ݷ:m%Cf%mNϲNۿG+SM+#3L|'XQmxź qG\}N^GP ,6[f6VGO?h}75=ޏSknw>olG}RMsp q[ӟP;b@K!$O + +endstream +endobj +363 0 obj +<< +/Subtype /Image +/Length 3267 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 156 +/Height 111 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;o"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?v ]Hc0N>eu5c$͇cuA[jꇲy:1X{F-1c5NF= ݁98I5uݯ҆sVz@D&Ȓtgjp,t.{~}eXGeW{o7>ܢ;fP˔ADc7< >*VUg + 幣6goN +tdPC_QpNO'ĦStԘ*fb0d>edP\gW4D^F(G%ڸukn˸tc`=H}yZ޹2p|GpvND,nL[*wF{Ӷ:auI*s+$j~ EF: +.%caYQ@t:m4R`3)kL4% g]Mwd8Y9Ùڮ19\sf;HB~&S2LnqisOS;Zi>*[YV=(ZYfpe8;#`?k'dVZK@Tobm|gpF l44bBoƯ ֲe/&O"~ܷ7{hA3&>0:N1uTb6Ytw7s I8 GP?!2n$h{1:6.gڮ뻿-ouVVkœ$1w$L9$4^":V 4$h.[Eahs +Eg^ȎSlKMhs%+hC=kdr]%fwDY +g90vHu17ܷR;Q\֜h=VHN 2_aG%]A yB€lx<(2(0EgV}6_-eTci~Cyv5 ~>R+ek5O[c16ԹߣB=K]cxc_/3AkGi^}rݗ tODsh?]gt?<"C5{YOv5ukvl|&Ty%fetoe䱮Os7N?Cx ʆ&=9E2j@hZ ݘ=n.`n] }O}u}j!tE4 Fs{_bOSZ%NUW +Lrɳz3q:mBU='aciYEArTpO=;W]~kh-o~JL=]\@3 VX^!IV-hdfW4=7VQެlo߶{G&u7Q‚Ra;K!]f%hjL72KC!4dIٱқwmM$>df c6ƵVDA['7c#X+tۦAYW^ PHuor0t JB Jx-FioQh + +endstream +endobj +364 0 obj +<< +/Subtype /Image +/Length 762 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 37 +/Height 12 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;; %"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?gO~K̾{*ܭgGm/ +CEs՗9Ńҏ=Sl}<"7{~6}F>5]ҫ3kF68[uu]\]'_NZp_m +;ߡ?:Gafz>O퍺-|T[6h> nx TBIj + +endstream +endobj +365 0 obj +<< +/Subtype /Image +/Length 3269 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 156 +/Height 111 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;o"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?v ]Hc0N>eu5;6NōlZ}f0-1c5>F= 98I5uݯ҆sVz@D&Ȓtgjp,t.{~} +ql[XՎov]wcx#!ًfe N4H:Cs@Bra=Tuܷ4rU 8)ёAկtZT] +d!i{\|5V\Asr,iZ͟5cX=0:2~kf`6;ilXyz~HudeݷhV `9+4B'EIǹ00K%rQe^4?WQ"8\/{hp3uH꘏K7+#aGOûds $Y.!ao Ej;htQ|{=]yu=!n{7!qv䞗2\m}1 9V2TxUoVܓ[0952$v[\&Iyo/\a>OPԴ s~c" :jLQ[ 6kx̬:넗UNnj~(iv컇K:3* _`X s"dᆙ.Yz9֘U; Rm5ue"ftUvVHT"uz в˻4J³@: |c%J/%̧3鮦ٵNd8Y9Ùڮ19{SԹVg;H(ov̒FGźӗZiߊ-vKq)2,{ޅ<6 +p;Y?i%)h}4stW}X.0F l4)t^Gֲ͞/w +qrg 2&dTOٱiy'_қݫ*E:sw1@xyl$QnY?)fIsG_X^)h<~浄5£/=sz{epH].:n'^fsG >[Qz<ĨJZj˫k^c nGSȆ E8EƆ> +[UwX A>*f^[e1n]Ouuz#Q u)j4=dܠ;ze< +TyeUs m)Hq=Wk,fQK.ʒ8-v %15|BudVWHhtk '>KճԺ~K4hlꅖՋ%m2y^Ccq%{=i?P^*uoоtOlތNPV߁ұkhɱKqUΝ}Bݪg 22Œ\Tz%'sm6j<3Y +V]vMuĮTu.[QxNoV0N6Ca ̪75hAJ׺=΀]owSg5ЋkOH SA-.l9,Hc ⡱lh[sXdN~5lȬo}25-=9\[<bluv9C&ZR*@d{ZX KЮ&H^w㺖5Ws͠H OћTz(Ȧ?;ۄ? \I4ͮ7ycf&&@Z[`c/C3k^ZF$z9 ;AsTa4Ч>Ҋ8_ + 9*U8I'B}Z+.IZ Dk]:ˉ&@31ZP^!ʭemȬL5>桙_5:oi4[X;ژO0SyJ[8ﲇ{BZn;Y>Dm63j0Z\؈@dIL0Z .t.u 4lrop&;-1.lhoDAFRޥ`V5oe]{pi!T&u0t.MrU' +*dѤk!-Zs[v#Z" + +endstream +endobj +366 0 obj +<< +/Subtype /Image +/Length 399 +/Filter /CCITTFaxDecode +/ImageMask true +/BitsPerComponent 1 +/Width 257 +/DecodeParms << +/K -1 +/Columns 257 +/Rows 393 +/BlackIs1 false +/EndOfLine false +/EncodedByteAlign true +>> +/Height 393 +/Type /XObject +>> +stream +P& +endstream +endobj +367 0 obj +<< +/Subtype /Image +/Length 6396 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 159 +/Height 243 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?UNίjセ>>0 +'*шJܧ>q68y/\^`:v=.IOxSGrryȥ;s7"n9߁RE'_kT֎kRS7W'YzYzȩ}t?RS'Fxm*CgJ}{|RcuggG"y֯;G"޳?m))R?9A0L%xzXȢ7uȤ؇R&Nz yw/!o]cC 5Σtc [8֋6tr(z?W6ڔVmǼUvZkH@/`ǧmINo_`'>> JM. f]Lx<t~8|!\doM)ZJ:GL w;w9 ?צ_F vCtcWyCb?.e]K'JF89ވ:/I1>__'j ]ImT%?2Ɍzla(֮Oxpؽ.l1wFU}`mD}H&2W;/+/>Aߑ|IIw?]m@Ge'tqsZKqa~ԬxQb s|a3Ԧx +NͮѯU֕#JVkiGrڈdgZmq訽Gmp_4@^jGGkv*E`cuk5$:"i +p(;uM[iEP k(<dF4}MnOY\W_?W >kNÿc_~~ڽMtV5ɏ+>_Sa1k h !z) gMOWo4>ȹ_n7|JGGܾnRR\?UX..oU_ W/^mn`mg`<;Y׳\aY{vtc< D 2r]YGaG3 /K*'PAq &i:K`)[~Ed+;A w=\rCN5<,Y cbObL/ϒ9Z?׽.EfA~lqcI܇kD4vGpVYrOJ+Yg'cU_?UTG3Gc%}'ArϦIIp`>W Jk UW*#cvȖ38iu co`=$l7<3u? y<4|L0 ^rK%ȇcvXJ.&;})gks|b>hVR;o[fnv +Ō$,ëq[GޅMTqNj^3܃jT>fL+xG{cO4FF=BZ^r| +{w Y!G:3+W9^U,]5?*>%}%^'}%Mr9N_6Y+?oS͖}7|JJK..g]_ DDect| /HETz%vrJ=XXly(m? Ed6<)[( +00o*_mư~ Y1I0X Z/{L}E}~q)QL{`. (UXv:|k^OIE. ̈́@lTRi=602ku[rWȬǧ?7|_7䩺g֏7)Z02rTk]0$_E}gs✼'cCcuIMAUWk #`ܼk@T 8.',سt-k߯NpGaSTrϙZAůs/;ws{ퟘ*ٴJ7OǏ]7:jy1ɿWEx] tӽR3Sř᝚ݣBsH'`9:B8wl><|Q,,-%2di=2Ye`=b8)12nmrNvfLdue8pk+}ԞGIiDW?v~ ~@=/V'}%V'_TG77]M 9|gU_ wU_ K$x4Kxime04lwܧr,rϝ3kw+<V +LIYK`ܢVU=t,1Y{IEyY=#-ǵep ;k YcUb|W__>Ub|W_TW;'UM"f9|ge'atMw\G] +%Kͧ̋z~QS2cԒly"\I0ւ r:;4j֐YZ6kym[>E)Z+[A-Gp]Eoc>()RaĘ'ގhlB¢~hXzZ]%[t9-lT;jAD}.6acg}Љ&\~*͕4wĤs!)n;2 ]{At +6,k~)WK;N^ksܫO!ϚHDnN.Q=^ՄtY^zy?v~ OǦO֜_y}TTX5CƷ~EC%}/׿企["MaJu_,?UX. +hG[5j{7庅A[կd]cK.d¹vbH!Vg'5Da!9Hl'pVs*sBsZ0dvU\U}d8|9wUXU]k;Q0L$Qo_B*u's[XC{^glIS<ƴH)i:6l\^O2ƆWP`: ?4g^++Wu'++Vw?>1{k+[l:bV3cKgKؿ1g&>; wtYC\ڜ}ik_K<7p꺿W[u<E eh1j|?/ d\~'_ɮ?:g +wJυV{?*ukYCT+l*mn+{+龣GQó`M#P/ԭc*m.`z4bKg0Ƌ͸IO%+?^7w|)yI{O3-{/g:kŒ^AMw?I{G3}=RoJ|]%t/LDKwԔK?6$^Iq7O郊nwu^6E8:xH߼udq?b?ZLϲTuovEfRR_*_*_*_*_*_*_*_*_*_* + +endstream +endobj +368 0 obj +<< +/Subtype /Image +/Length 76 +/Filter /CCITTFaxDecode +/ImageMask true +/BitsPerComponent 1 +/Width 23 +/DecodeParms << +/K -1 +/Columns 23 +/Rows 73 +/BlackIs1 false +/EndOfLine false +/EncodedByteAlign true +>> +/Height 73 +/Type /XObject +>> +stream + +endstream +endobj +369 0 obj +<< +/Subtype /Image +/Length 773 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 12 +/Height 37 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;% "? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?Hs3>3v!T`Sԁoٽhgu>pq:T.ƩWUNq FJQh;svvMY2pәF0#27mYg{+O6S|}}_]Y!nѓ`\ biʇj~}'gDON-xiҾSg-o+GR~;?W}/7}/.W +wU? + +endstream +endobj +370 0 obj +<< +/Subtype /Image +/Length 2349 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 114 +/Height 81 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;Qr"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?/Fx-`.乮[[Ġ7]3TЅլ q Va?w/6cZ4mn?|5vӏR$zԟ8Oܬ\W1Ҳۇ$2c g!s, \5U8T*9@fܧFgY̢$(^ƝJ꾠q~X Kl|H&@4&o]}xIc}xIOaܷ5w{2=N˻ԳUF07GesCg<>jӯ{ݺ΋ż8w +߬]ucDrSZEk`:FFPnŭ6L'wT8d#oTۍG ܒ+[@{G&ֶmNj^9:X ;~j]B*ȺW9 '#g]}!kGre̗Š^P%ո0;pqj0W% O(s pۓkG:IcHV'Jmw M>waL5{.KҺTuGșn8рy+ +0G`t1UQSN8j,VKz3wI]No ۥV@SU-x)3, 6TV+],;.:?4 hO3 !RۯKzg8= +qA]Dc@ -8*J}/ja$0;2CjooscAyoU"ZZў`YXZߕi88Ty)#$ڼ7Q֌Hxs|;PzwI|ߚ2A?htv5mUz_W/`aL]Rj>?}.vcSOx~aa@'X;eu#|2jʣ ]=_Z2ޓNb7hOܼ7WӬufIێ֪[7!cUhp:C&11wDf:WW0im°:l6]}2ְL-J v%6Z@"|Qӛ׾h{WQ绳%XXYIN[c$$QO_he}%Tiq㒱yʵx$]Aa6V@440@ɲAIyn+i㒯^82:I֧?EÕc :s(oyqO[,msw3U賈Xunp> /hSˆ el4bCU5SǵhsjJǾژzѨDž$gzn(`*[첲쵲Z+)p@WcviXiW]IrPū%gI:WzwUư}Eo_gayJItw}jB#^BiʺZywx*I_'9 RKf!j grI nl"8(o_9$__: + +endstream +endobj +371 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +373 0 obj +<< +/Length 1514 +/Filter /FlateDecode +>> +stream +HWێ6}ẈDHCmHWEnB+Ӷu6w(Y" gW*X +#bY=BH2B 1ؾW7nCڮbE6C?PeYPvW4 +iC?aml ~'o +׆[^B@C@~΀g!)1՝ʫO=ĻՍ㠀|NEDJxx|*oR׺kDӖ,I䰣kM?1i=\4Ș7L(Iw{ДEV﫲mDzo;_ y)>d`i6!8%gNU[0F_jh^3BLȢd,K0nd:'S= +{=jUAi}|G +T5pmq牝2ԅ/ ֊V5 _[3voѰ,Xb)[/sV/]U^÷ ,IQV'Ahľ:'w7< -l1g;D] mY;8t@NG1KImVۮYT8#DB:10/k^47ij>T0e;x6TT*ηa4lj8jt5|CB."隕axo<|Txք ɁN~y;b<w"BOQd6ϟ}?mxW4e`1\d3t9HPT0/p| /pJv@-cؓW{SU?3BMdi"^eEwqD\/wbF֎/º=XSH 2)F^MTgYl3ޞͨrҀXCk닞5z?xiEV@pc_@m+"Ȱ{ݟ(aCC^~:hQSa0*EE@<:\RL6llOq?6Q/k ];CYXA~¥rM5Q/@=),Y_ JE> +stream +x+27ѳ047256Q0B=conjgif``dTd˥kA # +endstream +endobj +375 0 obj +<< +/Subtype /Image +/Length 37366 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 643 +/Height 712 +/Type /XObject +>> +stream +JFIFAdobed     $''''$25552;;;;;;;;;;  %%#(((((#,0000,7;;;7;;;;;;;;;;"B +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw;!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?TI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$Nұen;"/{ݸ͍54Ỉup0}jM]Yx%vMc5h-. 6"b$rq:NwJ ,ddlsݍXbKx'p0VՑ.$Yk) n}e7@kRRFfVI5 iin[il FV1q`cQt7NvI$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRV B}M`-Eu@HHwVvMnUqk^ kl׍ŁXؽjnvU-6YZUXc.4I%))G\¶[ͬ5sK ~:+xXl6b]iuN|U~#`Zr-ȢѵQj6X=͂dtIM/ٯfٙTO\_嚿.T_onyJ*}@h_[E.H.c|OS +*ɩ:C H5p"5HIMI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJIT [j+&qh<27􏭍kw s}'4tWT"n~f8Yq@hyi-R$JRI$I$7QFM9fEuX׺KKL࡝պWKO3՟Ocvl+Khul}Yqߋ3 qwɬ.qkjk)NI,ί*酔SrluLX1}38Zmt%7r¡9.["L\CZֵs hNUK>T;m_^FK&n]7l11zT^ޡ^n}r*W鲆Z[[ip>ֶ4ՏS(]lkZ!kFa.,n-9{eCv]M4XI$6tL?J+^Ɔ=twԒS=V<52:RUz{[HגA4Xu;Nηۣ+< @lIMԕ/We5t6DyJ.O$Y{y9:$Hٸy}Wޓ1;IGIJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$S:Xuv[pƜ⽏kZvDwoJ vS2:=]JTz Ƌ+8~;*O|Wag C{+w K^i}e!ڴ蒜Ϫ8a_n%vfkNzeں,p}qao$JRI$I$:OJ^;>?lSvZxq:S/g.vߋ[60>qw%:uRT`lce>= 6YalNF\^6F Y}hFVETPz.E<=g8=@-kLC?eW}L^uvZޫXkHݴ6lN[-<.Ӫ4RZ,#WXu˞G$XI%)$IJI$SKE eu%)$IJI$RI$I%)$IJI$R ,<ͿkNU~ى /*_P?jI)F[FPXU[GÄh__+kt}칓k<~|@WRIMZz +{EݠjkƚƪSY"[s,hsL B# ؄j3Sx+qLtIMԕ/*'R}s?$ԫԞ>s_4yDSu%K4sМ:~VWh쵍9iABJdI$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$zwQӉceml1apkJoY:N]kY]6@6{OC/$$e9=el}=mi'h:x%6Qٷ;ЦY=ޅ-s@l$XSVnn7a<:EO?uu}置ڷSSbTxهZn;GhѠ6U5RX\疰總q'M$I%)$IJI$SKE e=kʳFW^ߔ)I$JRI$I$$I)I$JRI$I$$I)I$JRI$?׽y.7T=+d}Z^ꭤ_aɧ\LZѪ/^wE4KW鲌K.I&Ə*I)OgL'֟y#cfn%_7zOk'' 3oc_bcp> ):JOWa{u_ᵢ8%zed5Y[{X*;%7RTݗ^6u}9es*L=mNSkk*,q: '@@IMI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)qWrGI'OR,DпGGw]I)侴]U6.{ktZky vMi[73>ZCn}1ƌp@v65[Zwt k/Msmo/hXC} +91x\]T׍EsX+cdk@IdI%)$IJI$RI$I%4?u/4WU,]K 7mԔI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJQ{k]ck $SK7Mov>ztv/RRyU-|W83WRIM/u:mcX7I^/-ƍ{+auž:HtҮ}9mv4H"*tΝajs@ `#B U.2 ]x}A%7RT5\6?(K8TO>?MIMԕ|~V=֍Ψ8zClI$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$6Z0vVumh$C\ڙv;6Y=Cu*muYWems1Nѵ541z}FVǸ[kn'@$3VޡΟ(c[cEA_kw wZI$I%)$IJI$RI$I%)$IM,]K 7mJoWcti .|WRRI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IH1q+ʦZafߎ=;^Xl/ ;+$jҬkuڞƏO}6XN#g5aI]I%4l?wټ>cGx]Ift49kksk _VѢNRSN?Wsxgi$I$RI$I%)$IJI$RIgܫ:x~3;-@%'"g=s[i-D%: ,΋~S0vICcd͞+d^@Ѡ䚘W'uj]]XG S}uo1n9X))I%3{rCK]ֻs}-sa%:OoȾF6+7^Ķ8cp~F!Vf6o[-YhkhǸUWOiq-oM:*}>>[w7r`o{eE6YalƧF\6N։VRI$I%)$IJI$RI$I%)$IJI$SJg+ +嫪_WWRRI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$eLu81sUlF?!9 ,{- [-Fܺ,(\Ƹu{?'p2}]'6Xc湦! S'7?cՈO_|]7ذUGO $$JRI$I$$I)I$Jjgt6~ELfݷ{]Jw@;i`Wun}lٸnڂF9Zi$?3mWmhsj,cc)a%|`n&U}GfsNS[emo>}79k>v._[:a3m6; +Ua6^0~FI#MtQi̽ٙig!Ϊ=.s vSKeݒ߳R_ ֿX_1[V=L6heuhI)I$JRI$I$$I)I$JRI$I$$I)I$Ji8Kc殪V8W'>OUőeOK{RHI`d}fq1HG2#_k|}[:]{$6 ~i 2>Ym=4OL厼?t9h!rA8c׎\u/Dטּ{Nʭ. 3sqObBP;:}e.iC~#bGO˄{.yO3>Z-wXД%`z;}e9 gCQvNG\W)F;h !zu5qY5YK/!+}>nC=aZ\D"Uuϣcxiج/93 Y$O}Rw]V=Oi}x\^rlǹ:8u..gIJI$RI$I%)$IJI$RI$I%)$IJI345I;A +.GkpOD Lbeul'NJɌ[k9j9{@XYY9oߓa'h8Bͫ,ޣWot54_I9hApr?G)D +hO (EKBxN)ZRЩ k!?4?/ʖoRulv,W9=XK%Mf\_/潶ّi.?pA :J +  +hp8K~a[uOo$X|,pdcM*z ,sxFy3:Koa8O7Cx,c,ic"B\X%#Wc[qci'-nH ;GD@x\5^kl7赎;YEZu +t~̐8'Kߖ-.dwObu,L*|?w~O|Ks-neTPcMֹIMԒI%)$IJI%=C +jpǭXm~[,qq&#$:i,feWeYr_u Mŭ=W3iA': y6ާzQ5ӑcXhu |RSy%_76X+6[a0 $!>ղtUU8az sߣߣ>:C:쬶o!F>NEfACl-ecsih$I$$I)I$JRI$I$$I)I$JRI*}Wt|CLNd-[]m$K|H@$ԖUS_e!kZ%sbpӿ|\wVݠr`u^׮eEet1eu3}6hu_,<Fɀܖm7::*RXCe@<|1(7T8v[k ,.1♓>ܿ gVkϧWjLdn*,Z[4~ɑ<OW,kO&7k( ǥ,<47NwSookL|!6Ь 7Ò09}7;݈)dE*I:HPIJʦnou|N?7yEEk+X9~*^:;'Ru$INu{gD +[cNSlgI$*z5~*?ggbQRCvG~*&i+)00 2AꁪGDӏGUFʫmxD՗c?zi )'عR[_YanN66kwC2wvIA<kp>=_z;љR~b?S+oG{Ynӷv:'i {tR 84]'h~7(| I|&2o!}a%O`YYe5G >5kloV7~L <|Yc3Ik)k64C>K4?GL qMk$o].2*.hi{7RxUzSӲi˩,u6և is *j@6(LOI$$I)I$JRI$JVFc,:H;Dڔ}q>XMHI)I$JR}F赘ΟRc]T7ݕ:{}H)I$(]MY>jV54A +i$?@X]3e[ ÚD SӲ]Uzqێ*!koA{l *Cat+Pe;jI:5'@}7]n&~6U5gSf;eK"V7o yz^.'AOٽ>~>5Mdzmqk\YZz}mvYN]MonovC:iQCUU42ZִCZ֍%50N>.;/957 0Y G}Ѹo$JRI$I$$I)I$JRI$I$$I)I$nPXɮesjaknϵcIpY_HBt:Jz(m2鵵z2ͭ0C} 8fe8]`b6dUXٳeē +鮝ޘcqyO{8qԩ [cYOo'!#߷IN`,F=Mm;˵<^fZE׏#kk|ωSMCΪ`IԀ F'" GNQh=ְ~hZpUfŇ~<,2qm<%kje;ĴW ^ [12?. L^NXd$ky:I*U,yx`K cj3"Xi׳\RVNVH`Z?PϬ0Mx/evEwe=1J#j|Nc0"I$yI$JRI$HY?gk[[s:Y;C~54IL23Ŷkc\;tF}`M5*mkg$dLI2Iԕ LoVZzXYm&a %)$IJI$S_?V}kC%.োLjqk$SK!4LG=={dXGky)I$Js-gL\1c~vMwM6ImΐMOŹǨewXcc[5]@sN'wNʷbVdV1v9uOs vVc1fEud?#Qu^@mzs{RRU}<%ޥdec v3^ͨ@xhԲ2h&ݟV`~v\z. x?1Ym6fEݭmn&sķ^N=9euhﲆ>nbMc;R:zL:&,fA Pf; @IRqZB5߼jaYx:$JqʳM״cis1og@>ְ%7RCr+ckt}niDIJI$RI$I%)$IJI$R.z}mUT,y kZ.st[\Nrɉ]leKkqI.Բ̻F#loFѠrtuc2sR>du 8E,ZNݲKm0䱌15hK_aDyy~[-3ԬHNrU+7;c>SXMzX6rm3n25vD '@6@铧2tRI$JMl(w^g(l K+nnKI:wCI$VWO\fy 2'I%ARzL䶱8kۮ/':ǻ$ɶ=ffZ5]:pW t+dhnN )#A<Nj6S:oXXT:Ǚp`"2R =Y2ضQmwI9vI$JI$NS'5I+v*lJtn<ʇ1x 2\dWS..UUvlyUUDzt-c/x 3I$WI$JRI$uxm;ZI$$L5% feɱY Z`Ls8m߯WQ:PN+?xX;4P۩)I$JRI$I$Q[CeCx}ϩ䮪W{#Ex`w5JI$$I)K&j4gOdqus81:^/I+]?93cr1ﻝ ;i$JRI$t+7:7]KMD:ʋF +fTGr̦7X־ն{|W}z.?_j+h ^꟱5o Jn԰P6\Mu682 qr+I)I$JRY)衴SXΰ1Z6 PXɮesjaknϵMt_c{{dǻ[3=!Ctzq2g{Qp.mdȪ'mcgˉ%$ՌDGDb(H9d8$vxcKxP%ǒd +ֆ)&N N:rT'I:IPSk{$]ةKRVum1A +kޅeaШ|}I$XJƁïso==/1j[ߐtw=Շ]h0j ?oIeeLmu1kDS$I%)$IJI$RI$үr7kѲ7{7|`x+O#X5kh|!]IJI$RI$xyl~;~}xvNCۯ`enԙY1m~;kwƴ5RSM5c(cjW[kZֈkZѠ)SuY2j5ZhA +i)I$JRI$I$$I)SY"[s,hsL B7qիONX?v>Qu$ݓ0*~F`*ikwƁ繐ؒktYw]ؕ.N۲Gб gC\ ;h/nabW>Fv>5]SXݱwX|k>~s T!9I7zD>10RAaitPJ8-w~"#qj t P`}Bg{A{:~7 „6vmt铤ӦNW 'QJJĶ.U-Yyy%lD +I վ>ԹT.A$xC)"b!^$(.+ڮ+A_ NʲtGJI$ +I$RI$mJI$)$GJI$7Ɗү=08>Pu/M0#^(_Tw?%fDַ`]I_ U~մ^2\Itμ敞zX?*CG"j@2*(AA/u1n{50=YZEf}ROa<|vc0;ڹ:8RI%)$IJI$RI$C"㶺&$IMnx6_cg18x4l阘 UEU 9h"DBI$$I)I$Jq>f7l[o!l qızu5烙{O@.7}oQߵ]JRI$I$$I)I$JRI$7z73?."C /O?2)Js>Z*nh#eSG,mG,/KGYLmje8'ˉDVT ?ތN"OD'p9vk4']<}$Nď=W,N#V e: /ADkTGɘJ]f(K#ZNR8WS~Xڛ=ˑ<)pZ <8U;c]8H' +)M+ pԸEGk?./?YTFJ|:Psaػu}bؕzt%lL6$tmJI$BI%)$FԲIFԲC HFˏenOg<|C+qPLZ!:Jc* 1+x1-'?UYk*kXӻF*Jr yhœ<0uEEf gTZ֗8NS5&1:6Bl,䖧`^a~FqLc5Σɺi.t`m-sga ÿ"豾t9HsK'y+"lWW73"CH4en5ݲ7znv L JI$BI$I%)R>HY 3`(a>A䮪]Slaʧi<Eitfi)I$$I)I$JRI$݃7{ʧ&* {kdbn!ƭ֖nm弲sEYvca\2׋a4"uRI$I%)$IJI$RI$*C*ǵuV: cVKObZ7H^B=9?T.n^%Ie 7T#4N $IMNNӁK6UU_J;^aW}ftsjc`S1 ǔTėN%0R =]:/BL<4QJE^ #>OSO|̓R R.'?YTQQU/=ZI҅=B>y?.[l@rt!lL6L+R&IR&NI$6$H)KCx8fzǚkCDs~}cKRI$J/q'qSI",\v7dv 4 >?3NwTGS</Snn7)w"䖥Z: -̯<E2{,|ۺn.UV_cio:>c `e`hyВI,I$JRNG>;(Lϗuح3c撛$JRI$I$$I)uXCulnnEw`l5Msh',^ϫCcfS]@wqӦe1USC+5kD5hS4I%)$IJI$RI$I%5]O˛V]6ckKZH"`/yXy{Cy_D/,ij:}ŮXY%8ķMlrR<tm:I" +T$RN,? 5s$)c>Jl13:3'Ep hi2?,KmpA8R5jHNĢp4*{)&#=4[AUj{nd[-3EJ^z~_@2A ;>e?u( wuGhC_?;Re}c2틶&YCܸOo="W룚xJ[Y:I$RI$I$t'JԺIJԺ6;M-o)|.\f̫h@ +iZ-ݗI$RI1 :BԳH",R9.{ǎ X$1=|jH9caPs({ѡNܠ +usw=wk}UHn9"@X7kϾ}*V0ݐ+JU}_V:}̩䒛$JRI$I$4feuE_=:l9+`moZX:%aخ\q]I-^6< ۶ЭUѺu9>-e>etnv5Γ2z>eTQYV;v +Ell47Ջ :%%+;>1 ZxcCE6IJ6Ջopqe%sS I%i.e7f c+ulf]Fs{Ǹ)O@I$$I)I$JRI$I$/ ŏv/.Ego$mu'X~e\z`ee=5l71|AMܱ铞S-N +TI'81IJs$lb2xV09Oheň> a`v<'Z߄DIӗ.I$ƟR:'-'4Gj!ޅD> +O_T' t)p>*NW6-H5b 'IsM7em@x㾲c7%`\\9dns?CW#o]Zx1bm🆿<%еb)'~?ޔ0dn>XBP v,a%$+MI<% ZmJt*,cƉ%ma6(U_+?(ݓ33m ọDPo +N:*RIAJQ!ߘ8>)^H>L &WϜT~$)$"J+1Y^ͱHicXqtxX@.]1nm>a{| $UU$I)JEפa<+(Ǟ{IR}]'6Xc湦! 110ILI$I%)$IJI$RON]K7Qz՜?N<eX w۰?]Xg!۶d%;i$JRI$I$$I)I$JRG~^nIK&Y"C~)7C&IT̫60i|<+2 у;aՋXkrꖐ9s-zpH{t(VSݟr8Giٽ툏NȂt:bN:I]$J'I*N$t"u>H'i$p~j=k.A=~ =:x +Ǔwk6F:N[+5>! r_Mv}6Urr#"}"9NmlOa|kv&\y)ރFˀ pIL$;VIJhB)RI$*C!whqm }6V\D GedAv $tYkgޥ[a^h; ,Շ,D͌kր ;0)G.F5?"Bᅠ_?3n)K>&WkФH9*I$SKkUcW?+kG'mMaqYSus- +U9\WRRI$I%)$IJI$ROYPCm+!*y~?׺n`ַ +\XͻX[+%%; fE ,{iHeםQRI$I%)$IJI$R 6~yk}V +MsA !໕JadQu`D=ӍKb&g `=PUwKsۖum}TBp0oXU~ k, sXDxo-ク\s)]#ԳZi7K^=aFI%tPRI$X>^ s)&KLAjEu@ +kʄi):d]:d%t'I+HtI$I$L$5]>}iYRhSe>hX? wtjaAku=hZyVƓY<?Q~7sMfcvLwn=;]\›m{x*Ћl`RAGyN_>[CucUk;rrdؘG$[8't?q"CDpH rk 0L[q?Bg 4Mٴ/w'<n %Id\$DvJI$T _}mu4aNk+" CKXu[92Oiو6]si[ =i$t|$@LTrMAH& +AQˑJ^Egn#s쭶X9ēܕ=BӃuGki ZHz&-8bӣSS$K&n˙C1&I$jI$շ_CS}^?+7:m5b;y? ʺI$$I)I$JRI$ulڝ+3oُn?zs7mnUSS~X}Ogz=9ݳc_t6cw0sl+ǰ}&zO{@W[X9cqRI$I%)$IJI$R׬O}Ru;9K҉+yQV>:u/zCCiq|, S% [x(WFE2Lsy.h.k-p>-<Q G_6?X꘣k/ZR$?֊c2$}VLgs+P8m/՞\{Hc{L\L֗b`.n778(-|{e9ŧU~1F_oI-y?)ҏڇ,l]%ɝ,hZd0ٍk.`;Kpp$'[xcbTI9Dƨ&DAD򘱧0= +8QO"Ɇ2EdAKLI]:dR$RJ}FƧN3$t %*1V^a $'A? pA଎vWw/?hM +pkk ~/ʫ7k$~/fr|UI%?*I$xɶ9O\HsxARL"R:zTuŀ;*=O]g"NEڅUsRS^'0I)*I$SK{דǯgь^| 8WU.rweGοoR'I$$I)I.?; g}]gYs,YuQ,sY{8۴33>q߇s"11m[hMVc+-ԧI$RI$gT땿fUsZt&bbT^|ZGb%x7WWOl:ib]nKlfƓI$$I)I$JRI$I$n#~ɐݗcE̐vQ 9@γUu],.=eThU%#ŻV9eQ>E1~ȭc8+|UrIL +Np*Y0^-a,6׏rS{ugAYY=buD]߫ȣ(LAj|-O.U].UϪ=f| vv1+)zcM"I$eRI$JG +*G|O[- + oպ-%c=7x'K2Nx +]6YZQdJvf[a檚|dl2b8Wd'   T2RĨ䨪6g[?ھa8ыJ>QOL^} `)barc#oyPI)UC:~NU`M;X1 +¥5u`kScIerChTIJI$RI$t{/elzղ뫦Uw@iBՎԯnC[i3/&>4V꽌vJRsj?')"ưښ^HXTzOAkmŻ[Xb}v`ycF])20?-߂<ӂ5?֋V=,GC[[n۽_`׉@+VȩU湮5BILI$I%)$IJI$RI$?[m?k]l[C}L,{,#sL:9;kh<4d3ak紜;Ͷn?UE-~h.sxjI-*!PBͲ 䤒IN$d$NTI8,t,&js/Ŏ#:dASJY$}ch+O.ܐgyaW6H=Yf\C׸o[CmnaiFMo6Ua_[Gs1?,lCc><9Ws?,?,ј_c|c\2ct$JJ$'m)NPdƫ51B+U1G9SO6G39p >ܫXH̳&+xk{+ydSįF~/yk-@(fԒI"*U9_W-]T~B_6pvEn1 )I$$I)I$JRI$I$$I)KSU]^1 `zmgQ-{۝f$,|[gPkvH ,˦˶w;YS\I%)$IJI$RI$I%)$IO/Q.caLj4vWz~{瀾;B5_Yrt&<׋}duܢNyesun +9 +-$mLBI$R'ITIFԲI$ +I" +I:IJY$F7"AQs?o}z)<FT~JN:9])M)A)$7+|_޻}Yk]\\,Ť->Eu oB'LY侾s^K {E.X' X~PyQN"&I+Rv8ʆ$+ 5*7?HyةM))B҇$j܂%:1LjOQcۣ|]=uMCk+hcG0 P3r#~2%E"ZFۛ.f5EV*bFgI*bVdt\unnVjb&EMsqx:aկ̚+渂;LϥmtYϵ ˘=G9ӟwlź%?)۪Fe  +sZ?e7v6lp.~vVRTu:f_oRr+'oW? f-vT1-'%5ϻdR>C~? Os+S_*w9\y~r$I)I$JRI$I$$I)I$JR> ov6a9u5/ywe "{mVC!%*jǩPUM ֵֵ@SXT:K_;zv8^v {]}!+m%)$IJI$RI$I%)$IJ\Ǥ[j |+l{c]C>4r M:MrO--|B% +,RO BIJI*N$TII+L6L6I$mJI$;}Mטt?6lV<(KRjݏ䴦Ғ +!M4>1t򹟫C.̛|$,/^Wo] o}uaBu1ɔ2+I$M)]RT}G~ՒAu +%PӃkZlah]cEmS8˜I$unoQ$Ӓ*8c694xM 6:^A542kEen5_%GXlk,-R4T>:;KJ{:c]Mv)ucamC7ç9VzWF6k%ZVִIj\qJj}^y.NOڟmyMSSLz7Pѯ+G/kM~ci7qv$k$$I)I$JRI$I$$u]a;\E@2 j{%*묺Év]d:VuE6\v"mR`8:iUCk[=$$dIN߭?o6$!4*G B64"XBJP]k$BI$I)I$I2IZWN$mNDkjì*Mg϶+V}/g| _C*m $&FV54#5G?M[ Cʥ)M)3Wo]_{'سeъhRI+_)Bdm@aBMj-"~uocY4 +2HD!1Z$d&!B6I G LЍG B6&4#ka NB+c Jn@u-+[+?r?]KZMseW}E ~.Xj3Z`cQ5PMiͷҴ;S]{*8E@[ڥ2Iߝn}5YJ{vռ+85G rbg3ʩ:A cjx8JIVKugC,65 }+u97P oiBP< O D#>'($JnaЕpHM ZD57wۭsωcSީ+.oHGllk[Lw=~^]m^֎£D#$ x$f-K!'a}FA:C] p]4ՏS(]lkZ!kFIwLsK,%HqGhNy\:?1L!I$$I)juHGN!OǬ.vqy.qԞWmǪ;%xfwmKe]IJI$RI$I%)$IJI$RI$I%)$IJI$ROՏoHn;t#/87:eҩ]kԾYNC1!]P +/űI)I$d<;1Z\X\ Dx|@ c%qeqйG I$$I)I$Jy_Ss:e]O[P7ڲVkck FQ:[>v. s75sSVEO6ڭie5p5:Bxc=v(a1 zYہ@ Ch52gU/Yzv粆gw1lpᵛo X'VSBsMbʎk:= ^HۤI&B#kŒ"H4"BbH1&m"H4"BhF #Ч \$}\lѓ?]KhW#٣' VHƣ1VUGc65G)0Nlgٴ7Ld:u6ǹǞv?EV+@>%X͝\HZZ@@I$ҭR)JJ^S2)^SJIEMLΙk6sk##ō3x"D2#_sAV'DZ=x{<;\]H|##ۓ[yh$HBsaщ~{+YwD4/_W +>݉v\l.\Ac:Y u4\L@x\F>F%lƱpesZIM2EB$ 9b]k 9<'<ZVׅd7ȱÝٍw>,p O&m{SQk̝kg'qizE mUT` kZ kZ49tgPd3+2zm"nKrI$꒝5}j~oQ7Yci4Qfn^UyeX=K 76U,&nmkdf[ųt,k"f +CZ{lkU21q@vCvORȏkyq\PݫkiԲ#\|$O-i.s,v{"<>h ٌ֒8j\#EIJI$RI$I%)$IJI$RI$WTeldzv읢v<Oe`sy7b@%Dd2\q]Ie>%ԺoRlق۴IoS^i!W_~czceANIvLh/E>ZBjz/=5_Rǖ]w9󠈆X!=kUǩMuv3plD (ntЈBb\$B! \$!4'Z$pLB6'cg+ W@,O|3] lTz!D"ȣs7y hRIx}[H~9e3Ip^ϩ`?4GSJьDEң)J*^RSFY.%Jc)_ 'pmQL_3 \glGxr=n [KxkD Cf^"=N5Em@hc=T103s?WwÞI)w۫-;]T?}N%uR?lYqr~=U:uO2%DI%>M1NΚWIG,0$SwفnC4w sK #t-dOD*I$RIUͺXmcu3t7))?hU32vi>ukǦzFkkcdkD&O%)$IJI$RI$I%)$IJI$RI$I%)W?(8kC 85USSf>e[ٍ~zM~5TkChnE"l9i ƺi$#vmnK[IMg;PֳZ[HھZ^ޠ0rr_emsULGl$q+aT?:VgL}R7lXn-ĤUunΑk2. W=kH$[f3 ZKsb;LWӈ;T!i N0hf:~UYTӑNc^9^YtcIMI%)$IJI$RI$I%)$IJI$RI$I%)R]u}Sͭ4׾OL: ZAWRIO ŘвtlӺ$mk.' Q\U}c4qE %iiP`60oL:/gIG,0JE> \H#PAJuoWd:bdeqv={&\:F@>kLeԝ~uJ;j^\F5[r%Z][\$Ht"ЈBbmpHfeAsm#i:}˥]v7D%\߿Wݢm42kB" w=O=7~V}]/ wpy-q%/یϫ˛5O\ȏ_Ac@CVHDtU7khaϸo?{YI$BI$I%)$IM.x6_cg18x4tO +Pu%)$IJI$RI$I%1{Se cs$[xv},$cʚ^-.Q:([q3k^xrI$$I)I$JRI$I$$I)I$JRI$I$$I)I ]f=,{b)=@eLӝ\|.ifCd 7:ueX[R5\k,̚qvzupgj?26Z w9ğ5ZJz2ove~&['R6ZC.k\Jq2ׁCN?V wxK;im!w iǢ3!6|ǿ`!!Y&7me^Uz~QSKnk,[!Tc>4;Ic:@ٮ/0ט_kC63KpQUYߧm83=&ѾcΞ!%:$JRI$I$$I)I$JRI$I$$I)I$JRI$;:Gב[mhp0Jz{_oDʳYMߢL~qs_o$%ιI~#SAqs06u65@ \H#PA^zԟ[uy/s0ڬsC=$T2E<a׌;WΟ_O nxw:;cWϫYj9ik*u~Xyk^I o WH\cdhyPUuRI$%I$JRI$I$$I)I$JRI*]oF·9%+V$I$$I)I$JR^O٫k}K,skq{@0Lhbwݭ-{]xANAa}opX`~1tc۪9{h~ ;nEpl/Rںv4f.s7!qI%51Mˠѓ[mie-hƺ7< b%[YCt}Yyt~GYT^n}ͱcTX:~@ԛKq]~tDR &KS/"ڝ]>to]O{X. -:Mc qk h$i$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)J[WU. w[]V7א$JRI$I$$WYӵĒII$RRR ׾׳ua]"Kv7Pu.D,c*ck` kZ 4cZ쬑#'kdm-vq'Ii%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$\uxW6Hh8$UEv:wP˵/uxWkA&$IrW.6k}ֻ3ƺ[,sPe[ޣl_\na'u>6zi גВL\My4Y깂:p`Yp=2ϲ̚=k}n0sZ$/WMŹG^EuzN7bZ9Mz->VѩJئ*e=kC뱄9kpЂer,qac\}p~=tsq!)Icݗ\0s].,s6L{]Un63p5$I$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$*][-kn)WU.~17e3qElj>I)I$$I)I$JRsMG'5]Żٍs_b 7!1u +L<}5Ή2Tًzp`j\IRRTI%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$INNpc>;wzG씿gЍ3[whtcZ>ѓq- zbSznH7IJI$RI$S;u-˫uϣ{ꮫto̱mp[I%9?cthoG ne[ֈ>y]ר/U`ee5k}΀UP?=0cYBjȩ^U,湮湧BILY?߇yvadG hm/q2 +5u.jx]qffnc8EfN \S.^.u º,cÚH0D)m׵edk C$i$JRI$I$$I)I$JRI$I$$I)I$JRI$I$*YҺow䫪W: z~Tho3>^i)I$$I)I$f~szsuhnWTkg_7H`jJvY?_gZΘ;mؑ5v t MU[eksV h<'S4I%)$IJI$RI$I%)$IJI$RI$I%)RY¹?xIYb|CٳoΟJnI)I$JE\wX W808r*.d^Eo6mkN=45J?]uZ0붹{H+)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)Te9?7drEev>N4W꾶Hu]4km?4I$R\k[vdeo}0.Ct. i2=쩎1qԒJl4̠͵CY[ƞ{| H%'&IDI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJAʣ +del0\Iq kZւ9 5I: Q]ſ/c7Բ\\^1)s\Cw9 O$ RS N2::fFVMْ +Mu:Qm$DjvߘԽVÿ9`Qu%Z;ó>:[Kp6_FE-p:8"eޥOfI$$I)I$JRI$I$ bbP\kɢU1CJ2I)!f}rXr?ep kl8d:%Ds}A8˜okks+ĀJI%4qYnN8շ*1+lhNj.ͯv8̜-8˝s USHںOu +k4rꬬw݋m,JuYL{)8c}`Pʛ9c6tRI$I%)$IJI$R,]K 7mKWRM|dI$ R^M@%R^bvWvٸ;m|qWP11HcZu֑ <>AGIJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$r#Y qmA#EuL8g?{l_Vw7}cp#%5-NPʹ' v_`cl{]6zLykFwja_ԝvVv]cpq1N-ݾX^CM\`8?ean"oFcQciK .sč;*eۅM59}[{]6RKI۵)I$SS;tާW{F7DD>{G>Oʯ6ld}UhǝeI%8}h>޹]1n׀&n;0b'l- "{mVC!f~_7lpnfIv$ju,gU7Gv8?ik16GE.Ԫ97"u~@v}0KI#BJl$I)I$JRuR?lYqrJnT~2^pnLफ़k̠4ëc{Z< YcS]m ckZ$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)gt.{Y_s+hFf A$zTѤ,-sf 2'O_ºb579 vٲ6a8ZsMW?(8kC 85RSa%79#_ko$ˬcMҿoNgKCik 8C1+.dYg˫Xwn+oI$Ա$I$%~5yF\FG^"D*#>P֌*)uzUGpֿyV:`cZ쬑#'kdm-vq'Ii$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$Y?Z}V:طٍuXw˩ =9$kA%:$dz5Ͼ]Mق_c]{N 9ͨ~ma׍%:/a趐cof+@- ,Jp1*]- oN$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJI$RI$I%)$IJU:OgV=2lMnzI$c=-gY[}a8]7k]sq8uYɪN9,{yI%:i$JRI$I$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRI$ +endstream +endobj +376 0 obj +<< +/Length 3190 +/Type /XObject +/Subtype /Image +/Filter /FlateDecode +/BitsPerComponent 8 +/Width 288 +/Height 154 +/ColorSpace /DeviceRGB +>> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +/Border [0 0 0] +/Type /Annot +>> +endobj +378 0 obj +<< +/Length 2858 +/Filter /FlateDecode +>> +stream +HWr}WS +HDw~jwceVeS)(s7v**h8t~h~ͶH"/M&cOMn:{‡movs=#s[b݋/B.ܖmU1o𵝻 +s繻3y)_Q~6f87 Cso]rscǤ۰"GB#vP8 t0|mR?u浛:ƍB TA഍sڹkM,q$یʱpZ7ة++Wv%vwn:{ks`2}qO ؽNAr]F>_TAͩ69[PӗގGtd[{7$- mghljdrd(vGrNoZ/a A55,4pmuz}]ZUN^Vf'iMESkSپdC+Iظ!Y8O A.ʚǕ*vZԛŶ@zgWYMՐt 4 T&Jꂄ䗛;9ܛι 0 + I4;^qXQ`%^,=qHΆ73x0^Xlei7度]͖}ͭ홲L8bҙEC]#R:O,L,1%'wn<7s_.P=LM9%y\B&r{ + jn.ӂcI"a%[]f-8QzMџpקCbP!V!י[:x=ŸV/:s<묀:[b'6irU͋|Zk>|*^i鑓zBy!!%;P Wў{b7(sYo20fKjDD"T.4.EZ:^@Ɍ9Hbz [9jg&* ( \ƁoTZ/ vJ9){#ѻI\lkKDQe_\n|5.Aʶ"sŞޔ5ɖ2cV@̡d?0u0v !fsAV+ +hS<䊇E%P̂ua*˯gzX= {CX4˪ZM1/V,sZFEd`A8(QxĚ-bP0aVR{-M~2nShf S3caZl00!h҉1)V' Y$E )MA2fgeac4j(c!_p-"ٜsR=kQ[2;!"qĶM">+)w {tIKÉ+[Di^vID}$rG c M&ۆ{Ծ[ţL]Pώ~ICU!T.[&yQW٤x%ua4vHIWtSJ  %rS + :-=Ւe!d,=7Q14p=^UՑ=6Cld$3=_yЋ%֊5HSxc7?(~LEw={B .| HOzÅ`z fxA5=/8 NHҼsLh E<^g}=S؈6)XAqcyj)^9lmǠ*CUɍe;4@7# Rs63-?MӞIq"(vR/OE,5k/xNA%\.vۺr^#OGw73_]RP &x}˥Oཡ!S/ W^lѝj>>^۲3lKܴ3qArRc74r5yD2/gP/`]JR'BPRs-?Օ߱Ja-z/IpzlG_d,Nv/Zt9}j;8=V+dH6\V2&! `k6qEgI~`f +͆ Q蜒f~X4pOwO%xƠD%;7d\#bOrK0}y"| +u9_]Йȶ  EAfBi@qR~ðvSN *>cJ]ѷ}/$v?w%_g>qSśW|to Yk&BgC*~/ ?"AůĘ!“ i!ϕ| GZ^p~[P e;-U\x-h[ 0'SH(ۺa+ǒՃOw8PkA_ҙ΀s(yo~> +stream +x+27ѳ047256Q0B=conjgif``dTd˥kA # +endstream +endobj +380 0 obj +<< +/Subtype /Image +/Length 3556 +/Filter /DCTDecode +/BitsPerComponent 8 +/ColorSpace [/ICCBased 28 0 R] +/Width 230 +/Height 76 +/Type /XObject +>> +stream +Adobed    +  $$''$$53335;;;;;;;;;;  %% ## ((%%((22022;;;;;;;;;;L"? +  +  3!1AQa"q2B#$Rb34rC%Scs5&DTdE£t6UeuF'Vfv7GWgw5!1AQaq"2B#R3$brCScs4%&5DTdEU6teuFVfv'7GWgw ?TI%)$2(ƩdXګo{Y @.l}yk5 Nat_NE-*K8!G6+;϶>V?rH㈯s!;]\ `Y寷q}]dI]sTI$$I)I$JRI$I$$I)I$JRI$I$$I)I$JRC\Z7~h#S>}m̮Rm,?iyV~[w;s_w*؜8gc(GS|!U3׋f^nEY +@?%fWڳ=)Kw?_.=Xs}gRN>WaFgC.b9;2Ruh21f#W:ӥj;-p#蕾"Gbo7m }GkOQ~b_+}kX%4k뫋yߺʉp ̎W[r\7z4ᧂ|ʷ{Mł^hkDù8e9c}hu*# e tYO&ע}N(ޔFْcl9[s;L}%tӺOظV絖T}/G3G`QS{485{ S$ǥ-m[J^CMds֘/Dx=?Σsjĩi2 Iyv`-Pl$xc]z>~Zm,ؙ7}pp,{@<蒞%m+S~=.0s MD}6os~K#7WD7a\Iiypvd/?d;Cm> a))d;CLӋe88k%}&wvg:qo qmc^4"{t ; X洼tq=o#WzM~Ul{QcHԠ]3{m oYIOy~tϬnuys=夸9=?6)s]{yqılBkK~qapoޒTIsU~j5|`=LkOh<4S+e mo0l.ُo0&~))Ug}hG:N)$I,X;f?Ibt) LʺGRɋ8Ê053QeU zuc^7Kcd`ml#ȍ +gՎ6^V]p; :ұz^728I%C|'8iF\3`D<6X|Ю( ޿uщh?яV415@ +I+%(;#\܏C fƢDլ$~*eN̫nI4Þ oZU7ϿǓ`n.3DsZ?쯭aWǮ~Q&:U3eRlVcKNڛv+O_oƼxkBZX:OLS̖?s{_RˣRP%3khiIM/X~N_NjsKksʇsrzvF3v48{Y.%GK)nUm{ߠ۸U|tdߪY6 d7ñ0H٩ٮ0?m?Y~hdⓑ]XˮM˽B:W}oa'F\5xcxaTCWG?NZ${p ~HXY]n ]))ySp,wp(KC\cV߹ %ywհYױ*}EzJ}oXqҺV@eX >$SrI^nU$`wixf%/^&?PQ>\fmvgVcQ+ϴk\Ku -sY;GdXS}dB#,@8^guINf%G=Rיfec&5g]kZ_-_[*feǭ%KU}s^uMlt3} /ul~5fPh6:T86d$ƖedϫU(xXk1#VMtvz>~Msj\[֛ߍk-u`ech.jgGL8ZM4\m90N>[Wκ1CejLjȩerk< =|V7NXݑ u> +stream +xk  -.ť`Я'K &Ї.D)$8 5UPrܮ\(",ɶ +^cيQ=̝r;g>ޙsU +K!, }>Jb_21X~?paL\Z +GI&>Uƙ }?J<|?%/϶Őf^h=R[6~Q71 sC'B~|r`u|(_?Vyzo΁[*~Q/-˟SRXȯFP4(j\!+b~QNzA/BO,?˯+o_ io_v !^=}Kg>8 oY!r~%3(,O$:Vȯ?=,Ρ2o$D\;PE9^!(txF5zג?~QhVs[r~ѽQ/?X|_{vb%U/b/ٷ~$b;^~jp^U/bkvB/v}u7UjWi_B~ռa /.^])ڗ\_,(#Wͯrױ ʔ^JS,ǯѝr~9^,~uMY#3_d]72W]b94 /H5~2#YmЯ};L+9^] +$_uɊ}_i/vWUx=SBb((EH뗲/t[Pi^~Uk9h7Kb_ܯ_†_|_N_?.S/KYZP3h4ʆ&WUE1/tU+j49^~ ܯ:w/_40Æ_/1\Co%{>x3K:Pi72e X{r:2wk_8"W7pͯZV;̼/Wm +_9Sq-mߓf˶=B8~MυxFޜb pvBw[jxuw}[RLT~%y-*mxY0˳x\1,{KTܯ"l^V~9- G=8TDej/txE2,mo9X}*ZQKi~O_/u`]C.^_VwKK/*gie~b~=Q-|x%+8T]R9ss!d%gʚ .W_sRQ*~~~˕|75 \Bڵ"}b%W+w .W-סc}v KKIV=pe~_=5;=_+ÄR*9^ Ӎ<+~k%_Ԋ}m،~zV9l¥Ŧ_]_zzr(RU 77}s~鞫b-KQkxrVמՕstMXjahRx[-R)Bȯ.%Vاx׭ +/;~7f%T\\&e g> +endobj +383 0 obj +<< +/StemV 133 +/FontName /DELGHO+Calibri#2CBold +/FontStretch /Normal +/FontFile2 394 0 R +/FontWeight 700 +/Flags 32 +/Descent -250 +/FontBBox [-493 -194 1239 952] +/Ascent 750 +/FontFamily (Calibri) +/CapHeight 0 +/Type /FontDescriptor +/ItalicAngle 0 +>> +endobj +384 0 obj +<< +/StemV 85 +/FontName /DELGOM+Symbol +/FontFile3 395 0 R +/Flags 4 +/Descent 0 +/FontBBox [-180 -293 1090 1010] +/Ascent 0 +/CapHeight 0 +/Type /FontDescriptor +/ItalicAngle 0 +/StemH 92 +/CharSet (/space/phi/theta/psi/union/parenleft/parenright/approxequal/pi/minus/plus/comma/degree/mu/period/Delta/alpha/multiply/xi/rho) +>> +endobj +385 0 obj +<< +/Length 322 +/Filter /FlateDecode +>> +stream +hTMo >v~KQ5ݤ۝EZ"~N;=mGoGi4 j:rqUwʁ0RwMEp8 + ֞av?>p8M$%j2Q=+:a0pohpJWLPH,0ȚgYJ!uϒUΫUxya^$=20">0"/Nɼ]0oSY%~du9)1{6*1p<;˔ +lb]_YhpJ}m̷E: )4yLv1Ǚ[K_#D + +endstream +endobj +386 0 obj +<< +/Differences [2 /phi /theta /psi /union /approxequal /pi /Delta /alpha /xi +/rho 32 /space 40 /parenleft /parenright 43 /plus /comma 46 +/period 138 /minus 176 /degree 181 /mu 215 /multiply] +/Type /Encoding +>> +endobj +387 0 obj +<< +/StemV 133 +/FontName /TimesNewRoman#2CBoldItalic +/FontStretch /Normal +/FontWeight 700 +/Flags 98 +/Descent -216 +/FontBBox [-547 -307 1206 1032] +/Ascent 891 +/FontFamily (Times New Roman) +/CapHeight 0 +/Type /FontDescriptor +/ItalicAngle -15 +>> +endobj +388 0 obj +<< +/Subtype /CIDFontType2 +/FontDescriptor 396 0 R +/BaseFont /DELHKM+Symbol +/W [159 [987] + 167 169 384 183 185 384] +/CIDToGIDMap /Identity +/CIDSystemInfo << +/Supplement 0 +/Ordering (Identity) +/Registry (Adobe) +>> +/DW 1000 +/Type /Font +>> +endobj +389 0 obj +<< +/Length 259 +/Filter /FlateDecode +>> +stream +hTPn0 >v!NP+n`İH%D!%z#?g(A85JCBA*l+tCEg'u_Ua?-gr4j10ܼ<4/VAs,Z[,ӆNUU7he$,+.4~4 `}&𼴸p͓vcf qM8O- + +endstream +endobj +390 0 obj +<< +/StemV 140 +/FontName /Helvetica-BoldOblique +/Flags 262240 +/Descent -207 +/FontBBox [-174 -228 1114 962] +/Ascent 718 +/CapHeight 718 +/XHeight 532 +/Type /FontDescriptor +/ItalicAngle -12 +/StemH 140 +>> +endobj +391 0 obj +<< +/StemV 133 +/FontName /Arial#2CBoldItalic +/FontStretch /Normal +/FontWeight 700 +/Flags 96 +/Descent -211 +/FontBBox [-560 -376 1157 1000] +/Ascent 905 +/FontFamily (Arial) +/CapHeight 0 +/XHeight 515 +/Type /FontDescriptor +/ItalicAngle -15 +>> +endobj +392 0 obj +<< +/StemV 133 +/FontName /TimesNewRoman#2CBold +/FontStretch /Normal +/FontWeight 700 +/Flags 34 +/Descent -216 +/FontBBox [-558 -307 2000 1026] +/Ascent 891 +/FontFamily (Times New Roman) +/CapHeight 0 +/Type /FontDescriptor +/ItalicAngle 0 +>> +endobj +393 0 obj +<< +/StemV 0 +/FontName /Arial#2CItalic +/FontStretch /Normal +/FontWeight 400 +/Flags 96 +/Descent -211 +/FontBBox [-517 -325 1082 998] +/Ascent 905 +/FontFamily (Arial) +/CapHeight 0 +/Type /FontDescriptor +/ItalicAngle -15 +>> +endobj +394 0 obj +<< +/Length 11518 +/Filter /FlateDecode +/Length1 27336 +>> +stream +hw\W 0C +UEiRDD* +bMb$(M4!SM5IFcH7d7M1=le߹Ѹ9)ɺ$Q#5d垱uDX[ۗuئ$H~}r{?f}"ݏ :.{-<}ՂF[b>_4m'XEtehS} D!OYdY^{iD"녧/mo'+an@}mKg_;.[qg~(a};6E$n"꿒i'O"N?HFjqw$!I +R|}_ +> b(5;eo+zY%XI}r +D^ ZCwo?n8I]tt6t.]@ims6fet9]AWUt5mkZmtmMݪ[ovB/=tll젛aVQKvC=ݴ1@^z||G1q"fɟO =KfK2WAȽFa7MzޡC;}D`}Q]_cB>z\}Kh'IɇV-BiqѹM.Eͽ񽈧ȉh܇=NWa?:d#!ylKZWk`}G?iO~CzJaD;zBQGI$YRXU*$=)P2Jf)H +B$ ,ǗK(1,PJaR8()Zl7)QJ QRTY2fm"jD ;\ʖV3CrJYHH(iTHsl%9[f͜nlV?nJIe%]t,Grbtd2:U%,wT=i5QY9Rm0 1z0U_coժُB'tqM`Mb/rݳaf7!liZ-i d^Z垊[_X(oI=F&<鎎)}%=2zyMefFZ_}Ǡe_,L{2uo <ǼYM kg3|h|Oܓ@g5 yt'}oi[H$+ i0B_R%.g]}4%WVFGn%J"ܢd@`VGUyoŢhϺ?=JZEmee& W]{P/Xɓ;J v MZ3Ox1+OVy(r7=HyzyObR%iObm{-jME$Z+ *77؛d,"X.-+"ZRdol4P OAFI-EhZZiKjNbH6t!}Y`?_k /2:㔅/Fʁ"%+6h&hڛ!&nZ|k53hgIq9.9%x #bVdª'il UGMCXAxi}ZU%cB4+9*v׷nnwQ޺hQ5Td:imxT(H5%#38=.icÌqoollʒ\ZܓD.* 0]dDOӐ tJU͠{%l6{eYl2l*\M Hыbly"<4/nm"JI1_cS~[_s,hF'0{.& <ɳMM!vCT@QPkϺfOsxhfm:[123Dkf:yW@ a$Lu|'iGB?j|,' +;'.C";t&ڬ)B/h3TKԁre8 +Wh|ԮoZiK~ji-=8]ɡ*@^wvй(KHM,8Cv9\e0U'hIl(R39Nr/6NR46Ur;M'!p^8FE i5Iޑ!{jDRtFsFvnn,.vSH?O{rfwm+4_:V~HG>ZmCKD'AghJ8qPf .oxnl@ʸcOBoD@Z94GB$\&R!y -[ݲL ́SA0v;D6q}8%u=`!3"ڈs[ye~9_D +, >LI|ϭԟVg4þ"w:]JT>kַöoP`օ@h/FmF_c{olV'UB 9tr?-T#5!>B+ir-Jӣh5:4<=Of@OļjARiԡ6 x )G|? &CoxϫZc-6h:ΤhLKvy%]Wqo>BPtd|xWys0fxuex +b?eK/p1ec1heaf0f1f2f01&t) 7ƨgLe10j5jF1Q(g1J% 11Q(FcQ|F#fd1LFcc8#1HFRoި@DF#ǰ1b1hF#O'1aeX!`F01@3a`c !3$i|~QÌ2~+dO!w02a|% ~H73K7r 1#od)wod!r=od.[77^cx2%n"wysgyx#KS'yOpg3c o{ë3 y>W9ϵ <R]peG)OBO@M$zvBnnnnnv@ۡBWCWAWBW@C.J] +m6Aҹ0zCLZX浊8X8q:4Ʃ"8E`,11Qg1r!bZ0 +a3AdfFF #a]3@}з7WߡwwǠGGmFu^9g1V2V0DQ̘ϯg16pdSu)ZdF QŨdLbT0edFHd$0q #ÈwbDnBGߡo/OЏ?/ϡϠЧ'Lj~e%Ey9Yi)zQ vC7h^>>ku  팹6F+cc6111hbLgp3Y 'x$#Hg c1R9() CP +CfHu /77ߠBABB)* $g\>r{5nӚqkj(565;׼FNj;WeʕvtVJ]Ʈ]?v)]]w]um]{Rz}\]cU뺬KGL]R0'u+Wvt򸃝kl\S;eݙ^!j:#c+ޙݩYݱs%WHUN+-v.t/ڹн9=f헲>{rYkaV߁lɚd, z#)V;AH5[~ J^nX&"/)Sʏȫ5褌Ԩİ%1!(5RS(HթzE`VPpN~=,.~X> >.j_6MHѯ +2ɺm )9qkBt8C58uQFcTjl\+8x}gwEM.SPvvTV+ۓc6xR +c̦臥"C;䲋TE|gTVvS^u]ШB1/bkrss}<˳d}JNvs@)Xa:hL< aԔ8oM YǛ +F,ɶhUJJ>&6,&(h1P?d5*:ŤG#Giؔ`"LAU8N8=)+J@FBɩe͎^ߗ{WDY{}ufo_.\ k8CI .)bJ;=(!wXZ^9']q6,_٘ߗ]Q;cE Nh]ˊ}SV!jœs50W%w߼o^@e|in|X~K||wxUN-Av㺹וT50 ߧP=l -,;z^̣aS{"3$(QQR~ڰo$oVGFLp$.6etgkvQ|%!{ǖ\~L㘸dSQUMV39/?lПdSSOk^X9yPr[NžMTٿDSrSr6)h2J#ZG7h%Em <\Sbx/ZXe.Tda!S2٩l:> G'MϿtYӸXb Λ*{ڹfwmovΚ:!ܠCɔ]1kt+#"nޢyS \0?2196Ǚ8"֔5bBZfqNFx-(Gl|z9.0'+(\p70*W rbU^st$_@s49?9qĺl%Kʚɲ+yjrk,d5+ G[j1]Ȍ?2תy얖9-b-der&VӅqXhLiiFX߼QYEնi:2/`"9bƸK-5L*L  IJRN&`DشĔxGBpY%q䋽z+t4V\I˭Aج#T]tj\Aiն +Bm,b'ql"Rl"|7jFFj{2sI) cf䲲[Gd$jS62\vc+ici1Ĥs-&d1 [i9oMʝ>؋A};,,)SJj2&)a-)ULè T*Oգʪj]v:V3[emjQ!7W{hFL>,l9svKFqN|+K,Bw$*cs'eagfa䰨0ChRLdbdHpthCkV>~QEI׎SWoY;,_; eDZĜ#RRIiS2WJʮOT8;t\!V[У~yEUz5&96,|+6z]xحܔxSGX)+U0!`M1?:ӈf:|eyL'1r:M79'ׅd1ꧪjp4K)Aj)*BK:Fr=JcCfJe.{/b̍⾖bmW$-ojֶdS~E%/j_>7A%mgod30eGc4G"I%I۱'a" V9HȰ3DL^Y1vΛfY3 +2#F8mDmdF?:*uLjIicRUM ϟU8%;\ivFO!#"8(%2>UPRKgtjT4:7*.kac۸ݝΉϱǎ\iN54Iu1Mqۑ +b@H5lTlTBi&PaE!%wѦ4s޽w}}k;q|7=଍m/7YG ?(:ξki\J` msY߹\FrWכM|2Hq*ϮFYo^}njp_mSOUThFO;{6nV| ;Z'>{3t;p+-_"-vx(#ǟb4aI6tUk+Gj+>C)"37>taѤNv3q +TCؘ#yƓuqFsXQk5ZkejǮ:3wس涙s~vyahn,)jn 7O>ӳOOt{tSr0Xӟ܆i]͎$e _G73bQ}3c93\n ׏}iwug[h Κ22;Bc^t }aKNx,Xq+5Hk=~X$1`]Ya+Qao|fV.3_Ƈx6)B@B2$rmlv1pTƼ20J?z<->u(78ٝǰ+.ҍ]$Y78h2sGKzp1V,W ;M4t!hV ͭ++QwhS$]]4 +ԏe*aZ([왫3CL\(#mUm};ڪ»O 5cY)lKgxz;͎b{]k78=:VrW]^n6%6^<  gɑy9=-,X7ր~ȯ<4_+ȧc;߲AU:om|bؒ A^IvV+Iuj0gBoɽ}FBivxW/mb zL dM y5˗_A_2h`4앨" g_BF5Q,_ %}wM2H+*nA!W[8ˆK|us7TRǰfwiwXMVM,au5qCϢ[7PUC_ZB.RT-v3E&Qh1?t2_4Y: w)'fm.- YY( Dmi[Z9_fX/[2bT.B:^+/;./)p +#H%%f{Һ#!UV/;_eM}uby[CCWdӜ!܆w:4ua>0c]`egP >%H%]2qK--x3eqم&%FB4hM kH> eJnKs1wIJbկM)`s C(Ŕܴ), =H.>ievi)\_(%i+:L҉TPꜜ&`|::nһ+6K%k+Re)1-xJIt:KTl<~(:(%ewOJLIxid*CX:>-ŦCx}#ST">Ph3l^7T6&ޠbCGPְ6ӕ:k#%}Uѕ=Ocn8y/|ϼ0mᛘ5j :g + +endstream +endobj +395 0 obj +<< +/Subtype /Type1C +/Length 2160 +/Filter /FlateDecode +>> +stream +hތT{PSW@rڴr.mBVlٙ->Z_"U!bH~%BH AiJuNm+ծΎ;;{.=t;|swsΜE"#Evmɚ MR*y$+`:kBo (~&֪uTX.%IH" +T-D,U +XQ"*-Z*ѐByª ݸa]Kn|^ O&dhdra,aGI^)))%r6 dd P&$L?APƐ%(S%E76q hC$҅ >mF VI\^ X"%՚,B0D ,dF>Gh=vD +Q\v'.cN r6gKPcpq-7aq=̎3Fik4iZ1aUQAxAlvq nȧz PZd-̴ّĥTk3y9T2\fy60 44@*P6 j0p bˀԿ"Q8{ThKL\OCwU1mZoq5LzȄeҀ0F{Xm=Em˴'{b{H?ko -*B?c (ޥ pp0j1kQ=q⃸uNUkΖ##VA^X5[rڢcnQ,+ MӇG?(얻].olSj]_PT^UYW98N ̇|P$VijyIb*(d@\{%2c?3r^*)+h}a\w *Oʈ$ :nʃuo5D8Hz$N3*DNj0价&ѓ3|LʾEPE΃y,hi c7?0gS>(;']rHnM^곎[]5Kt*֬+}qu\qʊ +HQb X069,yܺ yX;9D#0xV{ܔ1dM,q1};i@QqL/Pk0'hvOKFP")c :*:%Wx[#\ a@;.z(΅4"%sWNH$!ڒc9dzmk;7-vjS3Oy=%$,O\_t[ ' 0;\Yc+HñF ?xE 7Ks絪/SoF27y,H ǝ+! PYTnX9ÿJmKuܧHi}jØ +q=684WA"F3-lOUkiI\^.rqXw>;Q5  +RNE<^''$mJ g[메+(M]af| +:̨8ږa=Sb+=T@߼3u.MbC5jiCM!xI]dm#M]+6~A}`jwm۱:aP# UiovՅ ;vk7咘O yb '75XùÂq盕tʣ`zq'g'c?=f9oa.+D,+[+U*Σ0|Zrl+clՎbFŝ> gך3>L1X#41 +$Kd[7l߾fw޺/o{vgfyNf:,iA($2?H9|H^LL3N,.yA#DedʂYpwsGGSI,^\l> .Hֆl:Y i#s*b 2#*؟ 9p3x& I`3s΅uQ=| #- FEC + +endstream +endobj +396 0 obj +<< +/StemV 0 +/FontName /DELHKM+Symbol +/FontStretch /Normal +/FontFile2 397 0 R +/FontWeight 400 +/Flags 4 +/Descent -219 +/FontBBox [0 -220 1113 1005] +/Ascent 1005 +/FontFamily (Symbol) +/CapHeight 0 +/Type /FontDescriptor +/ItalicAngle 0 +>> +endobj +397 0 obj +<< +/Length 4190 +/Filter /FlateDecode +/Length1 6556 +>> +stream +h9{|Tՙ9޹L;qHb2yd̄23t&Ʉ!D<(>"`|Ujk!*պe]Vj"*;Cjm{}|0X s.h}Do/݄BԒliӋf +r؏B_G~Z[nn]9zcn: a>*6³ܛx5 hP_o] 8~Yw +zHEd 320dDh<7@&́,!Yc-fA{`Dր> nP"$N A)xc,/I1jb l#;$∹pHK_j8=0'a7\|>SW&Lh6lh$5Ij)70ߋ~^XLv /+ԽXpVi9ZoH ToTAT͇81xNJE^#!Yy&zXlE11lga$e&M^r9Z7,Elbn`_-XK5ŕy6"胕p3|l6ۋMz b;/Jc+#V2'7%d%F%>rL>! :h]B +GIw̲Jv+^dago Xb"9#2 B\A'[XQryg..zkfn=+2Dzn`l+{=c>6~-PThۄ M1_,)AW)].Y7C$~HE d&3F ¿ \rXc)\BIZl*{́WI8mpQ| <0Ǩ8t/tl|"$;.1k2$8NKC$fң/*$+a(v1M>|vx.'"HavY dEut'm-]}$*Z;n6p]];9ٻ4 "HGe%EΘ^Xmʼ&#=mjzUĄؘ)FCTdDxXh^҉Z!\WyI"JEvkfV5`i$seYV^eY86KVh\5& =d{BMV[+]v  1xCsa44 0xs( AdٕD4Cib%LlԴ0W+Qj0F0r7#f om 0wx(1kSdeis6 e)+;L֚xrKjõzV1jQF )Y5۹ĽTVBn\aL!.7MJeMᦡV9JMN(hdTLx'ts4QY322fb9[ hҁ+ҭԸ \1`3R Jti/|L5_E[D5+4ڜA2dDX>hz\yX~/=>+!ehK|O肔2% EMh˜3-ነ:mSw$=JMBZ PSr/ ]v ZˮH/|aB:u4/^4}1 {/2NS_'҄t%PnR5#>ԥ * EFp"m.z5h -iՈ I2tP' fcb84 &)ץgJHb-7B> ub&Ta!yR1YxhCc7cCw`YlMȡO@ b;c +GpNi.hӀzVashE㶲7ðq!)jLtpH#D8_G_l:t;X!8U연4Xcx,=)MZu3]m5_ 9XU[x.,z'stMAJBX|o. }0 cyXתK9> Ip7wNY]>3?00*it$OǍZWj}i޾Tݷ})Y>HJ-ȈN-|'3= (L06dذ{"nq Gl6hjhlC >OBq&WuB[2Sº ^U9U9U\"+_P̔|<TPl4We[J~A39S -.SFx'aq:iv@'gjҷY*nג0jm"f(^Q& + Bub;c4)D $3, ss ˡ|CAh2ag.lUoI6g^=)=.B<VyЅXt^_b$w WJvuw:qNu!U(Ȳ!*Hȵzr``1?ey' ㍆)31xhv~.IfLlS7}_0keL!`:Dnfa8:=.2)#L$1e/5:==/=%I9ы1k1 +QEHa"}thwjAffgMmo{J Fn~z' {/a,VūU$aG1 +8t=PF+$*r:Mo| +h`J:)c׵.Ooz $RvϏb^$+joD'@oSM[PX7>k\uH ]A@ h +Hf(5H H +:H<{rsW5}r_O{l x<>Y%++Я$?\Gn^5Rnz;l:\shy[o?f hG,cevi\A+jGwk2Jz?)&#Md&5=jf%f#+l +5iz nB%ÀՄDA;0W;C80?[,6-\1{0hnS 8[+RgT5S&߆n*B?{}+ôw 0UJ + +endstream +endobj +xref +0 398 +0000000000 65535 f +0000000015 00000 n +0000001330 00000 n +0000001364 00000 n +0000001421 00000 n +0000006099 00000 n +0000006172 00000 n +0000006607 00000 n +0000000190 00000 n +0000006645 00000 n +0000006695 00000 n +0000006821 00000 n +0000006937 00000 n +0000007073 00000 n +0000007210 00000 n +0000007290 00000 n +0000007432 00000 n +0000007545 00000 n +0000007658 00000 n +0000007769 00000 n +0000007882 00000 n +0000007995 00000 n +0000008107 00000 n +0000008220 00000 n +0000008331 00000 n +0000010325 00000 n +0000010465 00000 n +0000017278 00000 n +0000020641 00000 n +0000023342 00000 n +0000023805 00000 n +0000024335 00000 n +0000024941 00000 n +0000025397 00000 n +0000025968 00000 n +0000026053 00000 n +0000026081 00000 n +0000027351 00000 n +0000029421 00000 n +0000030136 00000 n +0000030226 00000 n +0000030369 00000 n +0000030457 00000 n +0000030575 00000 n +0000030866 00000 n +0000031320 00000 n +0000031698 00000 n +0000032120 00000 n +0000032547 00000 n +0000032893 00000 n +0000033239 00000 n +0000033717 00000 n +0000034184 00000 n +0000034617 00000 n +0000035062 00000 n +0000035560 00000 n +0000035993 00000 n +0000036362 00000 n +0000036810 00000 n +0000037271 00000 n +0000037783 00000 n +0000038202 00000 n +0000038762 00000 n +0000039147 00000 n +0000039522 00000 n +0000039581 00000 n +0000039828 00000 n +0000040052 00000 n +0000040310 00000 n +0000040516 00000 n +0000040711 00000 n +0000040764 00000 n +0000040814 00000 n +0000040865 00000 n +0000040916 00000 n +0000040967 00000 n +0000041018 00000 n +0000041069 00000 n +0000041120 00000 n +0000041171 00000 n +0000041222 00000 n +0000041273 00000 n +0000041324 00000 n +0000041375 00000 n +0000041426 00000 n +0000041477 00000 n +0000041528 00000 n +0000041579 00000 n +0000041630 00000 n +0000041681 00000 n +0000041732 00000 n +0000041783 00000 n +0000041834 00000 n +0000041885 00000 n +0000041936 00000 n +0000041987 00000 n +0000042038 00000 n +0000042089 00000 n +0000042140 00000 n +0000042191 00000 n +0000042242 00000 n +0000042294 00000 n +0000042346 00000 n +0000042398 00000 n +0000042450 00000 n +0000042502 00000 n +0000042554 00000 n +0000042605 00000 n +0000042658 00000 n +0000042711 00000 n +0000042764 00000 n +0000042815 00000 n +0000042866 00000 n +0000042917 00000 n +0000042968 00000 n +0000043018 00000 n +0000043071 00000 n +0000043124 00000 n +0000043177 00000 n +0000043230 00000 n +0000043283 00000 n +0000043336 00000 n +0000043389 00000 n +0000043442 00000 n +0000043495 00000 n +0000043548 00000 n +0000043601 00000 n +0000043654 00000 n +0000043707 00000 n +0000043760 00000 n +0000043813 00000 n +0000043866 00000 n +0000043919 00000 n +0000043972 00000 n +0000044025 00000 n +0000044078 00000 n +0000044131 00000 n +0000044183 00000 n +0000044236 00000 n +0000044289 00000 n +0000044342 00000 n +0000044395 00000 n +0000044448 00000 n +0000044501 00000 n +0000044554 00000 n +0000044607 00000 n +0000044657 00000 n +0000044709 00000 n +0000044761 00000 n +0000044813 00000 n +0000044865 00000 n +0000044918 00000 n +0000044971 00000 n +0000045024 00000 n +0000045075 00000 n +0000045128 00000 n +0000045181 00000 n +0000045234 00000 n +0000045286 00000 n +0000045339 00000 n +0000045392 00000 n +0000045444 00000 n +0000045496 00000 n +0000045548 00000 n +0000045600 00000 n +0000045652 00000 n +0000045704 00000 n +0000045756 00000 n +0000045808 00000 n +0000045863 00000 n +0000045916 00000 n +0000045968 00000 n +0000046021 00000 n +0000046074 00000 n +0000046127 00000 n +0000046180 00000 n +0000046233 00000 n +0000046286 00000 n +0000046339 00000 n +0000046392 00000 n +0000046445 00000 n +0000046498 00000 n +0000046551 00000 n +0000046604 00000 n +0000046657 00000 n +0000046710 00000 n +0000046763 00000 n +0000046816 00000 n +0000046869 00000 n +0000046922 00000 n +0000046975 00000 n +0000047028 00000 n +0000047081 00000 n +0000047134 00000 n +0000047187 00000 n +0000047240 00000 n +0000047293 00000 n +0000047346 00000 n +0000047399 00000 n +0000047452 00000 n +0000047505 00000 n +0000047558 00000 n +0000047611 00000 n +0000047664 00000 n +0000047718 00000 n +0000047773 00000 n +0000047828 00000 n +0000047883 00000 n +0000047938 00000 n +0000047993 00000 n +0000048048 00000 n +0000048103 00000 n +0000048158 00000 n +0000048213 00000 n +0000048268 00000 n +0000048323 00000 n +0000048378 00000 n +0000048433 00000 n +0000048488 00000 n +0000048543 00000 n +0000048598 00000 n +0000048653 00000 n +0000048708 00000 n +0000048763 00000 n +0000048818 00000 n +0000048873 00000 n +0000048991 00000 n +0000049140 00000 n +0000051449 00000 n +0000051590 00000 n +0000054954 00000 n +0000055073 00000 n +0000064845 00000 n +0000064986 00000 n +0000223563 00000 n +0000226927 00000 n +0000227786 00000 n +0000228189 00000 n +0000228583 00000 n +0000228703 00000 n +0000234275 00000 n +0000234416 00000 n +0000235446 00000 n +0000238810 00000 n +0000242579 00000 n +0000242720 00000 n +0000278761 00000 n +0000282125 00000 n +0000282486 00000 n +0000282630 00000 n +0000283033 00000 n +0000283153 00000 n +0000283272 00000 n +0000286400 00000 n +0000286541 00000 n +0000289905 00000 n +0000292756 00000 n +0000292897 00000 n +0000296261 00000 n +0000298731 00000 n +0000298872 00000 n +0000302236 00000 n +0000302355 00000 n +0000302472 00000 n +0000302590 00000 n +0000302706 00000 n +0000302826 00000 n +0000302946 00000 n +0000303065 00000 n +0000303185 00000 n +0000303305 00000 n +0000303421 00000 n +0000306904 00000 n +0000307045 00000 n +0000310409 00000 n +0000310525 00000 n +0000310642 00000 n +0000310760 00000 n +0000310876 00000 n +0000310996 00000 n +0000311115 00000 n +0000311234 00000 n +0000315396 00000 n +0000315537 00000 n +0000315944 00000 n +0000319308 00000 n +0000319428 00000 n +0000319548 00000 n +0000319668 00000 n +0000319788 00000 n +0000319907 00000 n +0000320026 00000 n +0000323111 00000 n +0000323252 00000 n +0000326616 00000 n +0000326736 00000 n +0000326854 00000 n +0000326973 00000 n +0000327093 00000 n +0000327213 00000 n +0000327330 00000 n +0000331352 00000 n +0000331493 00000 n +0000334857 00000 n +0000334977 00000 n +0000335095 00000 n +0000335215 00000 n +0000335335 00000 n +0000335455 00000 n +0000335573 00000 n +0000335687 00000 n +0000335807 00000 n +0000335926 00000 n +0000336046 00000 n +0000336163 00000 n +0000341139 00000 n +0000341280 00000 n +0000341458 00000 n +0000344822 00000 n +0000344941 00000 n +0000345059 00000 n +0000345179 00000 n +0000345297 00000 n +0000345417 00000 n +0000345536 00000 n +0000349113 00000 n +0000349254 00000 n +0000352618 00000 n +0000353525 00000 n +0000353666 00000 n +0000411782 00000 n +0000479860 00000 n +0000483224 00000 n +0000483343 00000 n +0000483462 00000 n +0000483579 00000 n +0000488411 00000 n +0000488552 00000 n +0000491916 00000 n +0000492031 00000 n +0000492149 00000 n +0000492267 00000 n +0000496025 00000 n +0000496166 00000 n +0000496387 00000 n +0000499751 00000 n +0000502532 00000 n +0000502673 00000 n +0000503239 00000 n +0000542056 00000 n +0000545420 00000 n +0000546279 00000 n +0000546396 00000 n +0000548602 00000 n +0000548743 00000 n +0000552107 00000 n +0000552227 00000 n +0000552346 00000 n +0000555721 00000 n +0000555863 00000 n +0000562509 00000 n +0000563458 00000 n +0000570438 00000 n +0000571384 00000 n +0000574831 00000 n +0000575770 00000 n +0000579219 00000 n +0000579891 00000 n +0000586467 00000 n +0000586811 00000 n +0000587761 00000 n +0000590289 00000 n +0000593653 00000 n +0000593773 00000 n +0000595364 00000 n +0000595505 00000 n +0000633052 00000 n +0000636416 00000 n +0000636592 00000 n +0000639527 00000 n +0000639668 00000 n +0000643403 00000 n +0000646767 00000 n +0000647034 00000 n +0000647296 00000 n +0000647631 00000 n +0000648029 00000 n +0000648257 00000 n +0000648516 00000 n +0000648769 00000 n +0000649104 00000 n +0000649320 00000 n +0000649574 00000 n +0000649825 00000 n +0000650059 00000 n +0000661670 00000 n +0000663924 00000 n +0000664173 00000 n +trailer +<< +/Size 398 +/Root 1 0 R +/Info 8 0 R +/ID [ <762A470AF581D54E8F4E40A27192D482>] +>> +startxref +668454 +%%EOF diff --git a/lib/mpu6050/I2Cdev.cpp b/lib/mpu6050/I2Cdev.cpp new file mode 100644 index 0000000..5525624 --- /dev/null +++ b/lib/mpu6050/I2Cdev.cpp @@ -0,0 +1,1474 @@ +// I2Cdev library collection - Main I2C device class +// Abstracts bit and byte I2C R/W functions into a convenient class +// 2013-06-05 by Jeff Rowberg +// +// Changelog: +// 2013-05-06 - add Francesco Ferrara's Fastwire v0.24 implementation with small modifications +// 2013-05-05 - fix issue with writing bit values to words (Sasquatch/Farzanegan) +// 2012-06-09 - fix major issue with reading > 32 bytes at a time with Arduino Wire +// - add compiler warnings when using outdated or IDE or limited I2Cdev implementation +// 2011-11-01 - fix write*Bits mask calculation (thanks sasquatch @ Arduino forums) +// 2011-10-03 - added automatic Arduino version detection for ease of use +// 2011-10-02 - added Gene Knight's NBWire TwoWire class implementation with small modifications +// 2011-08-31 - added support for Arduino 1.0 Wire library (methods are different from 0.x) +// 2011-08-03 - added optional timeout parameter to read* methods to easily change from default +// 2011-08-02 - added support for 16-bit registers +// - fixed incorrect Doxygen comments on some methods +// - added timeout value for read operations (thanks mem @ Arduino forums) +// 2011-07-30 - changed read/write function structures to return success or byte counts +// - made all methods static for multi-device memory savings +// 2011-07-28 - initial release + +/* ============================================ +I2Cdev device library code is placed under the MIT license +Copyright (c) 2013 Jeff Rowberg + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. +=============================================== +*/ + +#include "I2Cdev.h" + +#if I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE + + #ifdef I2CDEV_IMPLEMENTATION_WARNINGS + #if ARDUINO < 100 + #warning Using outdated Arduino IDE with Wire library is functionally limiting. + #warning Arduino IDE v1.6.5+ with I2Cdev Fastwire implementation is recommended. + #warning This I2Cdev implementation does not support: + #warning - Repeated starts conditions + #warning - Timeout detection (some Wire requests block forever) + #elif ARDUINO == 100 + #warning Using outdated Arduino IDE with Wire library is functionally limiting. + #warning Arduino IDE v1.6.5+ with I2Cdev Fastwire implementation is recommended. + #warning This I2Cdev implementation does not support: + #warning - Repeated starts conditions + #warning - Timeout detection (some Wire requests block forever) + #elif ARDUINO > 100 + /*#warning Using current Arduino IDE with Wire library is functionally limiting. + #warning Arduino IDE v1.6.5+ with I2CDEV_BUILTIN_FASTWIRE implementation is recommended. + #warning This I2Cdev implementation does not support: + #warning - Timeout detection (some Wire requests block forever)*/ + #endif + #endif + +#elif I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE + + //#error The I2CDEV_BUILTIN_FASTWIRE implementation is known to be broken right now. Patience, Iago! + +#elif I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE + + #ifdef I2CDEV_IMPLEMENTATION_WARNINGS + #warning Using I2CDEV_BUILTIN_NBWIRE implementation may adversely affect interrupt detection. + #warning This I2Cdev implementation does not support: + #warning - Repeated starts conditions + #endif + + // NBWire implementation based heavily on code by Gene Knight + // Originally posted on the Arduino forum at http://arduino.cc/forum/index.php/topic,70705.0.html + // Originally offered to the i2cdevlib project at http://arduino.cc/forum/index.php/topic,68210.30.html + TwoWire Wire; + +#endif + +#ifndef BUFFER_LENGTH +// band-aid fix for platforms without Wire-defined BUFFER_LENGTH (removed from some official implementations) +#define BUFFER_LENGTH 32 +#endif + +/** Default constructor. + */ +I2Cdev::I2Cdev() { +} + +/** Read a single bit from an 8-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to read from + * @param bitNum Bit position to read (0-7) + * @param data Container for single bit value + * @param timeout Optional read timeout in milliseconds (0 to disable, leave off to use default class value in I2Cdev::readTimeout) + * @return Status of read operation (true = success) + */ +int8_t I2Cdev::readBit(uint8_t devAddr, uint8_t regAddr, uint8_t bitNum, uint8_t *data, uint16_t timeout) { + uint8_t b; + uint8_t count = readByte(devAddr, regAddr, &b, timeout); + *data = b & (1 << bitNum); + return count; +} + +/** Read a single bit from a 16-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to read from + * @param bitNum Bit position to read (0-15) + * @param data Container for single bit value + * @param timeout Optional read timeout in milliseconds (0 to disable, leave off to use default class value in I2Cdev::readTimeout) + * @return Status of read operation (true = success) + */ +int8_t I2Cdev::readBitW(uint8_t devAddr, uint8_t regAddr, uint8_t bitNum, uint16_t *data, uint16_t timeout) { + uint16_t b; + uint8_t count = readWord(devAddr, regAddr, &b, timeout); + *data = b & (1 << bitNum); + return count; +} + +/** Read multiple bits from an 8-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to read from + * @param bitStart First bit position to read (0-7) + * @param length Number of bits to read (not more than 8) + * @param data Container for right-aligned value (i.e. '101' read from any bitStart position will equal 0x05) + * @param timeout Optional read timeout in milliseconds (0 to disable, leave off to use default class value in I2Cdev::readTimeout) + * @return Status of read operation (true = success) + */ +int8_t I2Cdev::readBits(uint8_t devAddr, uint8_t regAddr, uint8_t bitStart, uint8_t length, uint8_t *data, uint16_t timeout) { + // 01101001 read byte + // 76543210 bit numbers + // xxx args: bitStart=4, length=3 + // 010 masked + // -> 010 shifted + uint8_t count, b; + if ((count = readByte(devAddr, regAddr, &b, timeout)) != 0) { + uint8_t mask = ((1 << length) - 1) << (bitStart - length + 1); + b &= mask; + b >>= (bitStart - length + 1); + *data = b; + } + return count; +} + +/** Read multiple bits from a 16-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to read from + * @param bitStart First bit position to read (0-15) + * @param length Number of bits to read (not more than 16) + * @param data Container for right-aligned value (i.e. '101' read from any bitStart position will equal 0x05) + * @param timeout Optional read timeout in milliseconds (0 to disable, leave off to use default class value in I2Cdev::readTimeout) + * @return Status of read operation (1 = success, 0 = failure, -1 = timeout) + */ +int8_t I2Cdev::readBitsW(uint8_t devAddr, uint8_t regAddr, uint8_t bitStart, uint8_t length, uint16_t *data, uint16_t timeout) { + // 1101011001101001 read byte + // fedcba9876543210 bit numbers + // xxx args: bitStart=12, length=3 + // 010 masked + // -> 010 shifted + uint8_t count; + uint16_t w; + if ((count = readWord(devAddr, regAddr, &w, timeout)) != 0) { + uint16_t mask = ((1 << length) - 1) << (bitStart - length + 1); + w &= mask; + w >>= (bitStart - length + 1); + *data = w; + } + return count; +} + +/** Read single byte from an 8-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to read from + * @param data Container for byte value read from device + * @param timeout Optional read timeout in milliseconds (0 to disable, leave off to use default class value in I2Cdev::readTimeout) + * @return Status of read operation (true = success) + */ +int8_t I2Cdev::readByte(uint8_t devAddr, uint8_t regAddr, uint8_t *data, uint16_t timeout) { + return readBytes(devAddr, regAddr, 1, data, timeout); +} + +/** Read single word from a 16-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to read from + * @param data Container for word value read from device + * @param timeout Optional read timeout in milliseconds (0 to disable, leave off to use default class value in I2Cdev::readTimeout) + * @return Status of read operation (true = success) + */ +int8_t I2Cdev::readWord(uint8_t devAddr, uint8_t regAddr, uint16_t *data, uint16_t timeout) { + return readWords(devAddr, regAddr, 1, data, timeout); +} + +/** Read multiple bytes from an 8-bit device register. + * @param devAddr I2C slave device address + * @param regAddr First register regAddr to read from + * @param length Number of bytes to read + * @param data Buffer to store read data in + * @param timeout Optional read timeout in milliseconds (0 to disable, leave off to use default class value in I2Cdev::readTimeout) + * @return Number of bytes read (-1 indicates failure) + */ +int8_t I2Cdev::readBytes(uint8_t devAddr, uint8_t regAddr, uint8_t length, uint8_t *data, uint16_t timeout) { + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print("I2C (0x"); + Serial.print(devAddr, HEX); + Serial.print(") reading "); + Serial.print(length, DEC); + Serial.print(" bytes from 0x"); + Serial.print(regAddr, HEX); + Serial.print("..."); + #endif + + int8_t count = 0; + uint32_t t1 = millis(); + + #if (I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE || I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE) + + #if (ARDUINO < 100) + // Arduino v00xx (before v1.0), Wire library + + // I2C/TWI subsystem uses internal buffer that breaks with large data requests + // so if user requests more than BUFFER_LENGTH bytes, we have to do it in + // smaller chunks instead of all at once + for (uint8_t k = 0; k < length; k += min((int)length, BUFFER_LENGTH)) { + Wire.beginTransmission(devAddr); + Wire.send(regAddr); + Wire.endTransmission(); + Wire.beginTransmission(devAddr); + Wire.requestFrom(devAddr, (uint8_t)min(length - k, BUFFER_LENGTH)); + + for (; Wire.available() && (timeout == 0 || millis() - t1 < timeout); count++) { + data[count] = Wire.receive(); + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(data[count], HEX); + if (count + 1 < length) Serial.print(" "); + #endif + } + + Wire.endTransmission(); + } + #elif (ARDUINO == 100) + // Arduino v1.0.0, Wire library + // Adds standardized write() and read() stream methods instead of send() and receive() + + // I2C/TWI subsystem uses internal buffer that breaks with large data requests + // so if user requests more than BUFFER_LENGTH bytes, we have to do it in + // smaller chunks instead of all at once + for (uint8_t k = 0; k < length; k += min((int)length, BUFFER_LENGTH)) { + Wire.beginTransmission(devAddr); + Wire.write(regAddr); + Wire.endTransmission(); + Wire.beginTransmission(devAddr); + Wire.requestFrom(devAddr, (uint8_t)min(length - k, BUFFER_LENGTH)); + + for (; Wire.available() && (timeout == 0 || millis() - t1 < timeout); count++) { + data[count] = Wire.read(); + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(data[count], HEX); + if (count + 1 < length) Serial.print(" "); + #endif + } + + Wire.endTransmission(); + } + #elif (ARDUINO > 100) + // Arduino v1.0.1+, Wire library + // Adds official support for repeated start condition, yay! + + // I2C/TWI subsystem uses internal buffer that breaks with large data requests + // so if user requests more than BUFFER_LENGTH bytes, we have to do it in + // smaller chunks instead of all at once + for (uint8_t k = 0; k < length; k += min((int)length, BUFFER_LENGTH)) { + Wire.beginTransmission(devAddr); + Wire.write(regAddr); + Wire.endTransmission(); + Wire.beginTransmission(devAddr); + Wire.requestFrom(devAddr, (uint8_t)min(length - k, BUFFER_LENGTH)); + + for (; Wire.available() && (timeout == 0 || millis() - t1 < timeout); count++) { + data[count] = Wire.read(); + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(data[count], HEX); + if (count + 1 < length) Serial.print(" "); + #endif + } + } + #endif + + #elif (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE) + + // Fastwire library + // no loop required for fastwire + uint8_t status = Fastwire::readBuf(devAddr << 1, regAddr, data, length); + if (status == 0) { + count = length; // success + } else { + count = -1; // error + } + + #endif + + // check for timeout + if (timeout > 0 && millis() - t1 >= timeout && count < length) count = -1; // timeout + + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(". Done ("); + Serial.print(count, DEC); + Serial.println(" read)."); + #endif + + return count; +} + +/** Read multiple words from a 16-bit device register. + * @param devAddr I2C slave device address + * @param regAddr First register regAddr to read from + * @param length Number of words to read + * @param data Buffer to store read data in + * @param timeout Optional read timeout in milliseconds (0 to disable, leave off to use default class value in I2Cdev::readTimeout) + * @return Number of words read (-1 indicates failure) + */ +int8_t I2Cdev::readWords(uint8_t devAddr, uint8_t regAddr, uint8_t length, uint16_t *data, uint16_t timeout) { + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print("I2C (0x"); + Serial.print(devAddr, HEX); + Serial.print(") reading "); + Serial.print(length, DEC); + Serial.print(" words from 0x"); + Serial.print(regAddr, HEX); + Serial.print("..."); + #endif + + int8_t count = 0; + uint32_t t1 = millis(); + +#if I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE || I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE + + #if (ARDUINO < 100) + // Arduino v00xx (before v1.0), Wire library + + // I2C/TWI subsystem uses internal buffer that breaks with large data requests + // so if user requests more than BUFFER_LENGTH bytes, we have to do it in + // smaller chunks instead of all at once + for (uint8_t k = 0; k < length * 2; k += min(length * 2, BUFFER_LENGTH)) { + Wire.beginTransmission(devAddr); + Wire.send(regAddr); + Wire.endTransmission(); + Wire.beginTransmission(devAddr); + Wire.requestFrom(devAddr, (uint8_t)(length * 2)); // length=words, this wants bytes + + bool msb = true; // starts with MSB, then LSB + for (; Wire.available() && count < length && (timeout == 0 || millis() - t1 < timeout);) { + if (msb) { + // first byte is bits 15-8 (MSb=15) + data[count] = Wire.receive() << 8; + } else { + // second byte is bits 7-0 (LSb=0) + data[count] |= Wire.receive(); + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(data[count], HEX); + if (count + 1 < length) Serial.print(" "); + #endif + count++; + } + msb = !msb; + } + + Wire.endTransmission(); + } + #elif (ARDUINO == 100) + // Arduino v1.0.0, Wire library + // Adds standardized write() and read() stream methods instead of send() and receive() + + // I2C/TWI subsystem uses internal buffer that breaks with large data requests + // so if user requests more than BUFFER_LENGTH bytes, we have to do it in + // smaller chunks instead of all at once + for (uint8_t k = 0; k < length * 2; k += min(length * 2, BUFFER_LENGTH)) { + Wire.beginTransmission(devAddr); + Wire.write(regAddr); + Wire.endTransmission(); + Wire.beginTransmission(devAddr); + Wire.requestFrom(devAddr, (uint8_t)(length * 2)); // length=words, this wants bytes + + bool msb = true; // starts with MSB, then LSB + for (; Wire.available() && count < length && (timeout == 0 || millis() - t1 < timeout);) { + if (msb) { + // first byte is bits 15-8 (MSb=15) + data[count] = Wire.read() << 8; + } else { + // second byte is bits 7-0 (LSb=0) + data[count] |= Wire.read(); + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(data[count], HEX); + if (count + 1 < length) Serial.print(" "); + #endif + count++; + } + msb = !msb; + } + + Wire.endTransmission(); + } + #elif (ARDUINO > 100) + // Arduino v1.0.1+, Wire library + // Adds official support for repeated start condition, yay! + + // I2C/TWI subsystem uses internal buffer that breaks with large data requests + // so if user requests more than BUFFER_LENGTH bytes, we have to do it in + // smaller chunks instead of all at once + for (uint8_t k = 0; k < length * 2; k += min(length * 2, BUFFER_LENGTH)) { + Wire.beginTransmission(devAddr); + Wire.write(regAddr); + Wire.endTransmission(); + Wire.beginTransmission(devAddr); + Wire.requestFrom(devAddr, (uint8_t)(length * 2)); // length=words, this wants bytes + + bool msb = true; // starts with MSB, then LSB + for (; Wire.available() && count < length && (timeout == 0 || millis() - t1 < timeout);) { + if (msb) { + // first byte is bits 15-8 (MSb=15) + data[count] = Wire.read() << 8; + } else { + // second byte is bits 7-0 (LSb=0) + data[count] |= Wire.read(); + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(data[count], HEX); + if (count + 1 < length) Serial.print(" "); + #endif + count++; + } + msb = !msb; + } + + Wire.endTransmission(); + } + #endif + + #elif (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE) + + // Fastwire library + // no loop required for fastwire + uint8_t intermediate[(uint8_t)length*2]; + uint8_t status = Fastwire::readBuf(devAddr << 1, regAddr, intermediate, (uint8_t)(length * 2)); + if (status == 0) { + count = length; // success + for (uint8_t i = 0; i < length; i++) { + data[i] = (intermediate[2*i] << 8) | intermediate[2*i + 1]; + } + } else { + count = -1; // error + } + + #endif + + if (timeout > 0 && millis() - t1 >= timeout && count < length) count = -1; // timeout + + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(". Done ("); + Serial.print(count, DEC); + Serial.println(" read)."); + #endif + + return count; +} + +/** write a single bit in an 8-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to write to + * @param bitNum Bit position to write (0-7) + * @param value New bit value to write + * @return Status of operation (true = success) + */ +bool I2Cdev::writeBit(uint8_t devAddr, uint8_t regAddr, uint8_t bitNum, uint8_t data) { + uint8_t b; + readByte(devAddr, regAddr, &b); + b = (data != 0) ? (b | (1 << bitNum)) : (b & ~(1 << bitNum)); + return writeByte(devAddr, regAddr, b); +} + +/** write a single bit in a 16-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to write to + * @param bitNum Bit position to write (0-15) + * @param value New bit value to write + * @return Status of operation (true = success) + */ +bool I2Cdev::writeBitW(uint8_t devAddr, uint8_t regAddr, uint8_t bitNum, uint16_t data) { + uint16_t w; + readWord(devAddr, regAddr, &w); + w = (data != 0) ? (w | (1 << bitNum)) : (w & ~(1 << bitNum)); + return writeWord(devAddr, regAddr, w); +} + +/** Write multiple bits in an 8-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to write to + * @param bitStart First bit position to write (0-7) + * @param length Number of bits to write (not more than 8) + * @param data Right-aligned value to write + * @return Status of operation (true = success) + */ +bool I2Cdev::writeBits(uint8_t devAddr, uint8_t regAddr, uint8_t bitStart, uint8_t length, uint8_t data) { + // 010 value to write + // 76543210 bit numbers + // xxx args: bitStart=4, length=3 + // 00011100 mask byte + // 10101111 original value (sample) + // 10100011 original & ~mask + // 10101011 masked | value + uint8_t b; + if (readByte(devAddr, regAddr, &b) != 0) { + uint8_t mask = ((1 << length) - 1) << (bitStart - length + 1); + data <<= (bitStart - length + 1); // shift data into correct position + data &= mask; // zero all non-important bits in data + b &= ~(mask); // zero all important bits in existing byte + b |= data; // combine data with existing byte + return writeByte(devAddr, regAddr, b); + } else { + return false; + } +} + +/** Write multiple bits in a 16-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register regAddr to write to + * @param bitStart First bit position to write (0-15) + * @param length Number of bits to write (not more than 16) + * @param data Right-aligned value to write + * @return Status of operation (true = success) + */ +bool I2Cdev::writeBitsW(uint8_t devAddr, uint8_t regAddr, uint8_t bitStart, uint8_t length, uint16_t data) { + // 010 value to write + // fedcba9876543210 bit numbers + // xxx args: bitStart=12, length=3 + // 0001110000000000 mask word + // 1010111110010110 original value (sample) + // 1010001110010110 original & ~mask + // 1010101110010110 masked | value + uint16_t w; + if (readWord(devAddr, regAddr, &w) != 0) { + uint16_t mask = ((1 << length) - 1) << (bitStart - length + 1); + data <<= (bitStart - length + 1); // shift data into correct position + data &= mask; // zero all non-important bits in data + w &= ~(mask); // zero all important bits in existing word + w |= data; // combine data with existing word + return writeWord(devAddr, regAddr, w); + } else { + return false; + } +} + +/** Write single byte to an 8-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register address to write to + * @param data New byte value to write + * @return Status of operation (true = success) + */ +bool I2Cdev::writeByte(uint8_t devAddr, uint8_t regAddr, uint8_t data) { + return writeBytes(devAddr, regAddr, 1, &data); +} + +/** Write single word to a 16-bit device register. + * @param devAddr I2C slave device address + * @param regAddr Register address to write to + * @param data New word value to write + * @return Status of operation (true = success) + */ +bool I2Cdev::writeWord(uint8_t devAddr, uint8_t regAddr, uint16_t data) { + return writeWords(devAddr, regAddr, 1, &data); +} + +/** Write multiple bytes to an 8-bit device register. + * @param devAddr I2C slave device address + * @param regAddr First register address to write to + * @param length Number of bytes to write + * @param data Buffer to copy new data from + * @return Status of operation (true = success) + */ +bool I2Cdev::writeBytes(uint8_t devAddr, uint8_t regAddr, uint8_t length, uint8_t* data) { + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print("I2C (0x"); + Serial.print(devAddr, HEX); + Serial.print(") writing "); + Serial.print(length, DEC); + Serial.print(" bytes to 0x"); + Serial.print(regAddr, HEX); + Serial.print("..."); + #endif + uint8_t status = 0; + #if ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO < 100) || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE) + Wire.beginTransmission(devAddr); + Wire.send((uint8_t) regAddr); // send address + #elif ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO >= 100) \ + || (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE && ARDUINO >= 100) \ + || I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE) + Wire.beginTransmission(devAddr); + Wire.write((uint8_t) regAddr); // send address + #elif (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE) + Fastwire::beginTransmission(devAddr); + Fastwire::write(regAddr); + #endif + for (uint8_t i = 0; i < length; i++) { + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(data[i], HEX); + if (i + 1 < length) Serial.print(" "); + #endif + #if ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO < 100) || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE) + Wire.send((uint8_t) data[i]); + #elif ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO >= 100) \ + || (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE && ARDUINO >= 100) \ + || I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE) + Wire.write((uint8_t) data[i]); + #elif (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE) + Fastwire::write((uint8_t) data[i]); + #endif + } + #if ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO < 100) || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE) + Wire.endTransmission(); + #elif ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO >= 100) \ + || (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE && ARDUINO >= 100) \ + || I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE) + status = Wire.endTransmission(); + #elif (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE) + Fastwire::stop(); + //status = Fastwire::endTransmission(); + #endif + #ifdef I2CDEV_SERIAL_DEBUG + Serial.println(". Done."); + #endif + return status == 0; +} + +/** Write multiple words to a 16-bit device register. + * @param devAddr I2C slave device address + * @param regAddr First register address to write to + * @param length Number of words to write + * @param data Buffer to copy new data from + * @return Status of operation (true = success) + */ +bool I2Cdev::writeWords(uint8_t devAddr, uint8_t regAddr, uint8_t length, uint16_t* data) { + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print("I2C (0x"); + Serial.print(devAddr, HEX); + Serial.print(") writing "); + Serial.print(length, DEC); + Serial.print(" words to 0x"); + Serial.print(regAddr, HEX); + Serial.print("..."); + #endif + uint8_t status = 0; + #if ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO < 100) || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE) + Wire.beginTransmission(devAddr); + Wire.send(regAddr); // send address + #elif ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO >= 100) \ + || (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE && ARDUINO >= 100) \ + || I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE) + Wire.beginTransmission(devAddr); + Wire.write(regAddr); // send address + #elif (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE) + Fastwire::beginTransmission(devAddr); + Fastwire::write(regAddr); + #endif + for (uint8_t i = 0; i < length; i++) { + #ifdef I2CDEV_SERIAL_DEBUG + Serial.print(data[i], HEX); + if (i + 1 < length) Serial.print(" "); + #endif + #if ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO < 100) || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE) + Wire.send((uint8_t)(data[i] >> 8)); // send MSB + Wire.send((uint8_t)data[i]); // send LSB + #elif ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO >= 100) \ + || (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE && ARDUINO >= 100) \ + || I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE) + Wire.write((uint8_t)(data[i] >> 8)); // send MSB + Wire.write((uint8_t)data[i]); // send LSB + #elif (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE) + Fastwire::write((uint8_t)(data[i] >> 8)); // send MSB + status = Fastwire::write((uint8_t)data[i]); // send LSB + if (status != 0) break; + #endif + } + #if ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO < 100) || I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE) + Wire.endTransmission(); + #elif ((I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE && ARDUINO >= 100) \ + || (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE && ARDUINO >= 100) \ + || I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE) + status = Wire.endTransmission(); + #elif (I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE) + Fastwire::stop(); + //status = Fastwire::endTransmission(); + #endif + #ifdef I2CDEV_SERIAL_DEBUG + Serial.println(". Done."); + #endif + return status == 0; +} + +/** Default timeout value for read operations. + * Set this to 0 to disable timeout detection. + */ +uint16_t I2Cdev::readTimeout = I2CDEV_DEFAULT_READ_TIMEOUT; + +#if I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE + // I2C library + ////////////////////// + // Copyright(C) 2012 + // Francesco Ferrara + // ferrara[at]libero[point]it + ////////////////////// + + /* + FastWire + - 0.24 added stop + - 0.23 added reset + + This is a library to help faster programs to read I2C devices. + Copyright(C) 2012 Francesco Ferrara + occhiobello at gmail dot com + [used by Jeff Rowberg for I2Cdevlib with permission] + */ + + boolean Fastwire::waitInt() { + int l = 250; + while (!(TWCR & (1 << TWINT)) && l-- > 0); + return l > 0; + } + + void Fastwire::setup(int khz, boolean pullup) { + TWCR = 0; + #if defined(__AVR_ATmega168__) || defined(__AVR_ATmega8__) || defined(__AVR_ATmega328P__) + // activate internal pull-ups for twi (PORTC bits 4 & 5) + // as per note from atmega8 manual pg167 + if (pullup) PORTC |= ((1 << 4) | (1 << 5)); + else PORTC &= ~((1 << 4) | (1 << 5)); + #elif defined(__AVR_ATmega644P__) || defined(__AVR_ATmega644__) + // activate internal pull-ups for twi (PORTC bits 0 & 1) + if (pullup) PORTC |= ((1 << 0) | (1 << 1)); + else PORTC &= ~((1 << 0) | (1 << 1)); + #else + // activate internal pull-ups for twi (PORTD bits 0 & 1) + // as per note from atmega128 manual pg204 + if (pullup) PORTD |= ((1 << 0) | (1 << 1)); + else PORTD &= ~((1 << 0) | (1 << 1)); + #endif + + TWSR = 0; // no prescaler => prescaler = 1 + TWBR = ((16000L / khz) - 16) / 2; // change the I2C clock rate + TWCR = 1 << TWEN; // enable twi module, no interrupt + } + + // added by Jeff Rowberg 2013-05-07: + // Arduino Wire-style "beginTransmission" function + // (takes 7-bit device address like the Wire method, NOT 8-bit: 0x68, not 0xD0/0xD1) + byte Fastwire::beginTransmission(byte device) { + byte twst, retry; + retry = 2; + do { + TWCR = (1 << TWINT) | (1 << TWEN) | (1 << TWSTO) | (1 << TWSTA); + if (!waitInt()) return 1; + twst = TWSR & 0xF8; + if (twst != TW_START && twst != TW_REP_START) return 2; + + //Serial.print(device, HEX); + //Serial.print(" "); + TWDR = device << 1; // send device address without read bit (1) + TWCR = (1 << TWINT) | (1 << TWEN); + if (!waitInt()) return 3; + twst = TWSR & 0xF8; + } while (twst == TW_MT_SLA_NACK && retry-- > 0); + if (twst != TW_MT_SLA_ACK) return 4; + return 0; + } + + byte Fastwire::writeBuf(byte device, byte address, byte *data, byte num) { + byte twst, retry; + + retry = 2; + do { + TWCR = (1 << TWINT) | (1 << TWEN) | (1 << TWSTO) | (1 << TWSTA); + if (!waitInt()) return 1; + twst = TWSR & 0xF8; + if (twst != TW_START && twst != TW_REP_START) return 2; + + //Serial.print(device, HEX); + //Serial.print(" "); + TWDR = device & 0xFE; // send device address without read bit (1) + TWCR = (1 << TWINT) | (1 << TWEN); + if (!waitInt()) return 3; + twst = TWSR & 0xF8; + } while (twst == TW_MT_SLA_NACK && retry-- > 0); + if (twst != TW_MT_SLA_ACK) return 4; + + //Serial.print(address, HEX); + //Serial.print(" "); + TWDR = address; // send data to the previously addressed device + TWCR = (1 << TWINT) | (1 << TWEN); + if (!waitInt()) return 5; + twst = TWSR & 0xF8; + if (twst != TW_MT_DATA_ACK) return 6; + + for (byte i = 0; i < num; i++) { + //Serial.print(data[i], HEX); + //Serial.print(" "); + TWDR = data[i]; // send data to the previously addressed device + TWCR = (1 << TWINT) | (1 << TWEN); + if (!waitInt()) return 7; + twst = TWSR & 0xF8; + if (twst != TW_MT_DATA_ACK) return 8; + } + //Serial.print("\n"); + + return 0; + } + + byte Fastwire::write(byte value) { + byte twst; + //Serial.println(value, HEX); + TWDR = value; // send data + TWCR = (1 << TWINT) | (1 << TWEN); + if (!waitInt()) return 1; + twst = TWSR & 0xF8; + if (twst != TW_MT_DATA_ACK) return 2; + return 0; + } + + byte Fastwire::readBuf(byte device, byte address, byte *data, byte num) { + byte twst, retry; + + retry = 2; + do { + TWCR = (1 << TWINT) | (1 << TWEN) | (1 << TWSTO) | (1 << TWSTA); + if (!waitInt()) return 16; + twst = TWSR & 0xF8; + if (twst != TW_START && twst != TW_REP_START) return 17; + + //Serial.print(device, HEX); + //Serial.print(" "); + TWDR = device & 0xfe; // send device address to write + TWCR = (1 << TWINT) | (1 << TWEN); + if (!waitInt()) return 18; + twst = TWSR & 0xF8; + } while (twst == TW_MT_SLA_NACK && retry-- > 0); + if (twst != TW_MT_SLA_ACK) return 19; + + //Serial.print(address, HEX); + //Serial.print(" "); + TWDR = address; // send data to the previously addressed device + TWCR = (1 << TWINT) | (1 << TWEN); + if (!waitInt()) return 20; + twst = TWSR & 0xF8; + if (twst != TW_MT_DATA_ACK) return 21; + + /***/ + + retry = 2; + do { + TWCR = (1 << TWINT) | (1 << TWEN) | (1 << TWSTO) | (1 << TWSTA); + if (!waitInt()) return 22; + twst = TWSR & 0xF8; + if (twst != TW_START && twst != TW_REP_START) return 23; + + //Serial.print(device, HEX); + //Serial.print(" "); + TWDR = device | 0x01; // send device address with the read bit (1) + TWCR = (1 << TWINT) | (1 << TWEN); + if (!waitInt()) return 24; + twst = TWSR & 0xF8; + } while (twst == TW_MR_SLA_NACK && retry-- > 0); + if (twst != TW_MR_SLA_ACK) return 25; + + for (uint8_t i = 0; i < num; i++) { + if (i == num - 1) + TWCR = (1 << TWINT) | (1 << TWEN); + else + TWCR = (1 << TWINT) | (1 << TWEN) | (1 << TWEA); + if (!waitInt()) return 26; + twst = TWSR & 0xF8; + if (twst != TW_MR_DATA_ACK && twst != TW_MR_DATA_NACK) return twst; + data[i] = TWDR; + //Serial.print(data[i], HEX); + //Serial.print(" "); + } + //Serial.print("\n"); + stop(); + + return 0; + } + + void Fastwire::reset() { + TWCR = 0; + } + + byte Fastwire::stop() { + TWCR = (1 << TWINT) | (1 << TWEN) | (1 << TWSTO); + if (!waitInt()) return 1; + return 0; + } +#endif + +#if I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE + // NBWire implementation based heavily on code by Gene Knight + // Originally posted on the Arduino forum at http://arduino.cc/forum/index.php/topic,70705.0.html + // Originally offered to the i2cdevlib project at http://arduino.cc/forum/index.php/topic,68210.30.html + + /* + call this version 1.0 + + Offhand, the only funky part that I can think of is in nbrequestFrom, where the buffer + length and index are set *before* the data is actually read. The problem is that these + are variables local to the TwoWire object, and by the time we actually have read the + data, and know what the length actually is, we have no simple access to the object's + variables. The actual bytes read *is* given to the callback function, though. + + The ISR code for a slave receiver is commented out. I don't have that setup, and can't + verify it at this time. Save it for 2.0! + + The handling of the read and write processes here is much like in the demo sketch code: + the process is broken down into sequential functions, where each registers the next as a + callback, essentially. + + For example, for the Read process, twi_read00 just returns if TWI is not yet in a + ready state. When there's another interrupt, and the interface *is* ready, then it + sets up the read, starts it, and registers twi_read01 as the function to call after + the *next* interrupt. twi_read01, then, just returns if the interface is still in a + "reading" state. When the reading is done, it copies the information to the buffer, + cleans up, and calls the user-requested callback function with the actual number of + bytes read. + + The writing is similar. + + Questions, comments and problems can go to Gene@Telobot.com. + + Thumbs Up! + Gene Knight + + */ + + uint8_t TwoWire::rxBuffer[NBWIRE_BUFFER_LENGTH]; + uint8_t TwoWire::rxBufferIndex = 0; + uint8_t TwoWire::rxBufferLength = 0; + + uint8_t TwoWire::txAddress = 0; + uint8_t TwoWire::txBuffer[NBWIRE_BUFFER_LENGTH]; + uint8_t TwoWire::txBufferIndex = 0; + uint8_t TwoWire::txBufferLength = 0; + + //uint8_t TwoWire::transmitting = 0; + void (*TwoWire::user_onRequest)(void); + void (*TwoWire::user_onReceive)(int); + + static volatile uint8_t twi_transmitting; + static volatile uint8_t twi_state; + static uint8_t twi_slarw; + static volatile uint8_t twi_error; + static uint8_t twi_masterBuffer[TWI_BUFFER_LENGTH]; + static volatile uint8_t twi_masterBufferIndex; + static uint8_t twi_masterBufferLength; + static uint8_t twi_rxBuffer[TWI_BUFFER_LENGTH]; + static volatile uint8_t twi_rxBufferIndex; + //static volatile uint8_t twi_Interrupt_Continue_Command; + static volatile uint8_t twi_Return_Value; + static volatile uint8_t twi_Done; + void (*twi_cbendTransmissionDone)(int); + void (*twi_cbreadFromDone)(int); + + void twi_init() { + // initialize state + twi_state = TWI_READY; + + // activate internal pull-ups for twi + // as per note from atmega8 manual pg167 + sbi(PORTC, 4); + sbi(PORTC, 5); + + // initialize twi prescaler and bit rate + cbi(TWSR, TWPS0); // TWI Status Register - Prescaler bits + cbi(TWSR, TWPS1); + + /* twi bit rate formula from atmega128 manual pg 204 + SCL Frequency = CPU Clock Frequency / (16 + (2 * TWBR)) + note: TWBR should be 10 or higher for master mode + It is 72 for a 16mhz Wiring board with 100kHz TWI */ + + TWBR = ((CPU_FREQ / TWI_FREQ) - 16) / 2; // bitrate register + // enable twi module, acks, and twi interrupt + + TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA); + + /* TWEN - TWI Enable Bit + TWIE - TWI Interrupt Enable + TWEA - TWI Enable Acknowledge Bit + TWINT - TWI Interrupt Flag + TWSTA - TWI Start Condition + */ + } + + typedef struct { + uint8_t address; + uint8_t* data; + uint8_t length; + uint8_t wait; + uint8_t i; + } twi_Write_Vars; + + twi_Write_Vars *ptwv = 0; + static void (*fNextInterruptFunction)(void) = 0; + + void twi_Finish(byte bRetVal) { + if (ptwv) { + free(ptwv); + ptwv = 0; + } + twi_Done = 0xFF; + twi_Return_Value = bRetVal; + fNextInterruptFunction = 0; + } + + uint8_t twii_WaitForDone(uint16_t timeout) { + uint32_t endMillis = millis() + timeout; + while (!twi_Done && (timeout == 0 || millis() < endMillis)) continue; + return twi_Return_Value; + } + + void twii_SetState(uint8_t ucState) { + twi_state = ucState; + } + + void twii_SetError(uint8_t ucError) { + twi_error = ucError ; + } + + void twii_InitBuffer(uint8_t ucPos, uint8_t ucLength) { + twi_masterBufferIndex = 0; + twi_masterBufferLength = ucLength; + } + + void twii_CopyToBuf(uint8_t* pData, uint8_t ucLength) { + uint8_t i; + for (i = 0; i < ucLength; ++i) { + twi_masterBuffer[i] = pData[i]; + } + } + + void twii_CopyFromBuf(uint8_t *pData, uint8_t ucLength) { + uint8_t i; + for (i = 0; i < ucLength; ++i) { + pData[i] = twi_masterBuffer[i]; + } + } + + void twii_SetSlaRW(uint8_t ucSlaRW) { + twi_slarw = ucSlaRW; + } + + void twii_SetStart() { + TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA) | _BV(TWINT) | _BV(TWSTA); + } + + void twi_write01() { + if (TWI_MTX == twi_state) return; // blocking test + twi_transmitting = 0 ; + if (twi_error == 0xFF) + twi_Finish (0); // success + else if (twi_error == TW_MT_SLA_NACK) + twi_Finish (2); // error: address send, nack received + else if (twi_error == TW_MT_DATA_NACK) + twi_Finish (3); // error: data send, nack received + else + twi_Finish (4); // other twi error + if (twi_cbendTransmissionDone) return twi_cbendTransmissionDone(twi_Return_Value); + return; + } + + + void twi_write00() { + if (TWI_READY != twi_state) return; // blocking test + if (TWI_BUFFER_LENGTH < ptwv -> length) { + twi_Finish(1); // end write with error 1 + return; + } + twi_Done = 0x00; // show as working + twii_SetState(TWI_MTX); // to transmitting + twii_SetError(0xFF); // to No Error + twii_InitBuffer(0, ptwv -> length); // pointer and length + twii_CopyToBuf(ptwv -> data, ptwv -> length); // get the data + twii_SetSlaRW((ptwv -> address << 1) | TW_WRITE); // write command + twii_SetStart(); // start the cycle + fNextInterruptFunction = twi_write01; // next routine + return twi_write01(); + } + + void twi_writeTo(uint8_t address, uint8_t* data, uint8_t length, uint8_t wait) { + uint8_t i; + ptwv = (twi_Write_Vars *)malloc(sizeof(twi_Write_Vars)); + ptwv -> address = address; + ptwv -> data = data; + ptwv -> length = length; + ptwv -> wait = wait; + fNextInterruptFunction = twi_write00; + return twi_write00(); + } + + void twi_read01() { + if (TWI_MRX == twi_state) return; // blocking test + if (twi_masterBufferIndex < ptwv -> length) ptwv -> length = twi_masterBufferIndex; + twii_CopyFromBuf(ptwv -> data, ptwv -> length); + twi_Finish(ptwv -> length); + if (twi_cbreadFromDone) return twi_cbreadFromDone(twi_Return_Value); + return; + } + + void twi_read00() { + if (TWI_READY != twi_state) return; // blocking test + if (TWI_BUFFER_LENGTH < ptwv -> length) twi_Finish(0); // error return + twi_Done = 0x00; // show as working + twii_SetState(TWI_MRX); // reading + twii_SetError(0xFF); // reset error + twii_InitBuffer(0, ptwv -> length - 1); // init to one less than length + twii_SetSlaRW((ptwv -> address << 1) | TW_READ); // read command + twii_SetStart(); // start cycle + fNextInterruptFunction = twi_read01; + return twi_read01(); + } + + void twi_readFrom(uint8_t address, uint8_t* data, uint8_t length) { + uint8_t i; + + ptwv = (twi_Write_Vars *)malloc(sizeof(twi_Write_Vars)); + ptwv -> address = address; + ptwv -> data = data; + ptwv -> length = length; + fNextInterruptFunction = twi_read00; + return twi_read00(); + } + + void twi_reply(uint8_t ack) { + // transmit master read ready signal, with or without ack + if (ack){ + TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWINT) | _BV(TWEA); + } else { + TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWINT); + } + } + + void twi_stop(void) { + // send stop condition + TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA) | _BV(TWINT) | _BV(TWSTO); + + // wait for stop condition to be exectued on bus + // TWINT is not set after a stop condition! + while (TWCR & _BV(TWSTO)) { + continue; + } + + // update twi state + twi_state = TWI_READY; + } + + void twi_releaseBus(void) { + // release bus + TWCR = _BV(TWEN) | _BV(TWIE) | _BV(TWEA) | _BV(TWINT); + + // update twi state + twi_state = TWI_READY; + } + + SIGNAL(TWI_vect) { + switch (TW_STATUS) { + // All Master + case TW_START: // sent start condition + case TW_REP_START: // sent repeated start condition + // copy device address and r/w bit to output register and ack + TWDR = twi_slarw; + twi_reply(1); + break; + + // Master Transmitter + case TW_MT_SLA_ACK: // slave receiver acked address + case TW_MT_DATA_ACK: // slave receiver acked data + // if there is data to send, send it, otherwise stop + if (twi_masterBufferIndex < twi_masterBufferLength) { + // copy data to output register and ack + TWDR = twi_masterBuffer[twi_masterBufferIndex++]; + twi_reply(1); + } else { + twi_stop(); + } + break; + + case TW_MT_SLA_NACK: // address sent, nack received + twi_error = TW_MT_SLA_NACK; + twi_stop(); + break; + + case TW_MT_DATA_NACK: // data sent, nack received + twi_error = TW_MT_DATA_NACK; + twi_stop(); + break; + + case TW_MT_ARB_LOST: // lost bus arbitration + twi_error = TW_MT_ARB_LOST; + twi_releaseBus(); + break; + + // Master Receiver + case TW_MR_DATA_ACK: // data received, ack sent + // put byte into buffer + twi_masterBuffer[twi_masterBufferIndex++] = TWDR; + + case TW_MR_SLA_ACK: // address sent, ack received + // ack if more bytes are expected, otherwise nack + if (twi_masterBufferIndex < twi_masterBufferLength) { + twi_reply(1); + } else { + twi_reply(0); + } + break; + + case TW_MR_DATA_NACK: // data received, nack sent + // put final byte into buffer + twi_masterBuffer[twi_masterBufferIndex++] = TWDR; + + case TW_MR_SLA_NACK: // address sent, nack received + twi_stop(); + break; + + // TW_MR_ARB_LOST handled by TW_MT_ARB_LOST case + + // Slave Receiver (NOT IMPLEMENTED YET) + /* + case TW_SR_SLA_ACK: // addressed, returned ack + case TW_SR_GCALL_ACK: // addressed generally, returned ack + case TW_SR_ARB_LOST_SLA_ACK: // lost arbitration, returned ack + case TW_SR_ARB_LOST_GCALL_ACK: // lost arbitration, returned ack + // enter slave receiver mode + twi_state = TWI_SRX; + + // indicate that rx buffer can be overwritten and ack + twi_rxBufferIndex = 0; + twi_reply(1); + break; + + case TW_SR_DATA_ACK: // data received, returned ack + case TW_SR_GCALL_DATA_ACK: // data received generally, returned ack + // if there is still room in the rx buffer + if (twi_rxBufferIndex < TWI_BUFFER_LENGTH) { + // put byte in buffer and ack + twi_rxBuffer[twi_rxBufferIndex++] = TWDR; + twi_reply(1); + } else { + // otherwise nack + twi_reply(0); + } + break; + + case TW_SR_STOP: // stop or repeated start condition received + // put a null char after data if there's room + if (twi_rxBufferIndex < TWI_BUFFER_LENGTH) { + twi_rxBuffer[twi_rxBufferIndex] = 0; + } + + // sends ack and stops interface for clock stretching + twi_stop(); + + // callback to user defined callback + twi_onSlaveReceive(twi_rxBuffer, twi_rxBufferIndex); + + // since we submit rx buffer to "wire" library, we can reset it + twi_rxBufferIndex = 0; + + // ack future responses and leave slave receiver state + twi_releaseBus(); + break; + + case TW_SR_DATA_NACK: // data received, returned nack + case TW_SR_GCALL_DATA_NACK: // data received generally, returned nack + // nack back at master + twi_reply(0); + break; + + // Slave Transmitter + case TW_ST_SLA_ACK: // addressed, returned ack + case TW_ST_ARB_LOST_SLA_ACK: // arbitration lost, returned ack + // enter slave transmitter mode + twi_state = TWI_STX; + + // ready the tx buffer index for iteration + twi_txBufferIndex = 0; + + // set tx buffer length to be zero, to verify if user changes it + twi_txBufferLength = 0; + + // request for txBuffer to be filled and length to be set + // note: user must call twi_transmit(bytes, length) to do this + twi_onSlaveTransmit(); + + // if they didn't change buffer & length, initialize it + if (0 == twi_txBufferLength) { + twi_txBufferLength = 1; + twi_txBuffer[0] = 0x00; + } + + // transmit first byte from buffer, fall through + + case TW_ST_DATA_ACK: // byte sent, ack returned + // copy data to output register + TWDR = twi_txBuffer[twi_txBufferIndex++]; + + // if there is more to send, ack, otherwise nack + if (twi_txBufferIndex < twi_txBufferLength) { + twi_reply(1); + } else { + twi_reply(0); + } + break; + + case TW_ST_DATA_NACK: // received nack, we are done + case TW_ST_LAST_DATA: // received ack, but we are done already! + // ack future responses + twi_reply(1); + // leave slave receiver state + twi_state = TWI_READY; + break; + */ + + // all + case TW_NO_INFO: // no state information + break; + + case TW_BUS_ERROR: // bus error, illegal stop/start + twi_error = TW_BUS_ERROR; + twi_stop(); + break; + } + + if (fNextInterruptFunction) return fNextInterruptFunction(); + } + + TwoWire::TwoWire() { } + + void TwoWire::begin(void) { + rxBufferIndex = 0; + rxBufferLength = 0; + + txBufferIndex = 0; + txBufferLength = 0; + + twi_init(); + } + + void TwoWire::beginTransmission(uint8_t address) { + //beginTransmission((uint8_t)address); + + // indicate that we are transmitting + twi_transmitting = 1; + + // set address of targeted slave + txAddress = address; + + // reset tx buffer iterator vars + txBufferIndex = 0; + txBufferLength = 0; + } + + uint8_t TwoWire::endTransmission(uint16_t timeout) { + // transmit buffer (blocking) + //int8_t ret = + twi_cbendTransmissionDone = NULL; + twi_writeTo(txAddress, txBuffer, txBufferLength, 1); + int8_t ret = twii_WaitForDone(timeout); + + // reset tx buffer iterator vars + txBufferIndex = 0; + txBufferLength = 0; + + // indicate that we are done transmitting + // twi_transmitting = 0; + return ret; + } + + void TwoWire::nbendTransmission(void (*function)(int)) { + twi_cbendTransmissionDone = function; + twi_writeTo(txAddress, txBuffer, txBufferLength, 1); + return; + } + + void TwoWire::send(uint8_t data) { + if (twi_transmitting) { + // in master transmitter mode + // don't bother if buffer is full + if (txBufferLength >= NBWIRE_BUFFER_LENGTH) { + return; + } + + // put byte in tx buffer + txBuffer[txBufferIndex] = data; + ++txBufferIndex; + + // update amount in buffer + txBufferLength = txBufferIndex; + } else { + // in slave send mode + // reply to master + //twi_transmit(&data, 1); + } + } + + uint8_t TwoWire::receive(void) { + // default to returning null char + // for people using with char strings + uint8_t value = 0; + + // get each successive byte on each call + if (rxBufferIndex < rxBufferLength) { + value = rxBuffer[rxBufferIndex]; + ++rxBufferIndex; + } + + return value; + } + + uint8_t TwoWire::requestFrom(uint8_t address, int quantity, uint16_t timeout) { + // clamp to buffer length + if (quantity > NBWIRE_BUFFER_LENGTH) { + quantity = NBWIRE_BUFFER_LENGTH; + } + + // perform blocking read into buffer + twi_cbreadFromDone = NULL; + twi_readFrom(address, rxBuffer, quantity); + uint8_t read = twii_WaitForDone(timeout); + + // set rx buffer iterator vars + rxBufferIndex = 0; + rxBufferLength = read; + + return read; + } + + void TwoWire::nbrequestFrom(uint8_t address, int quantity, void (*function)(int)) { + // clamp to buffer length + if (quantity > NBWIRE_BUFFER_LENGTH) { + quantity = NBWIRE_BUFFER_LENGTH; + } + + // perform blocking read into buffer + twi_cbreadFromDone = function; + twi_readFrom(address, rxBuffer, quantity); + //uint8_t read = twii_WaitForDone(); + + // set rx buffer iterator vars + //rxBufferIndex = 0; + //rxBufferLength = read; + + rxBufferIndex = 0; + rxBufferLength = quantity; // this is a hack + + return; //read; + } + + uint8_t TwoWire::available(void) { + return rxBufferLength - rxBufferIndex; + } + +#endif diff --git a/lib/mpu6050/I2Cdev.h b/lib/mpu6050/I2Cdev.h new file mode 100644 index 0000000..60c3195 --- /dev/null +++ b/lib/mpu6050/I2Cdev.h @@ -0,0 +1,289 @@ +// I2Cdev library collection - Main I2C device class header file +// Abstracts bit and byte I2C R/W functions into a convenient class +// 2013-06-05 by Jeff Rowberg +// +// Changelog: +// 2020-01-20 - hardija : complete support for Teensy 3.x +// 2015-10-30 - simondlevy : support i2c_t3 for Teensy3.1 +// 2013-05-06 - add Francesco Ferrara's Fastwire v0.24 implementation with small modifications +// 2013-05-05 - fix issue with writing bit values to words (Sasquatch/Farzanegan) +// 2012-06-09 - fix major issue with reading > 32 bytes at a time with Arduino Wire +// - add compiler warnings when using outdated or IDE or limited I2Cdev implementation +// 2011-11-01 - fix write*Bits mask calculation (thanks sasquatch @ Arduino forums) +// 2011-10-03 - added automatic Arduino version detection for ease of use +// 2011-10-02 - added Gene Knight's NBWire TwoWire class implementation with small modifications +// 2011-08-31 - added support for Arduino 1.0 Wire library (methods are different from 0.x) +// 2011-08-03 - added optional timeout parameter to read* methods to easily change from default +// 2011-08-02 - added support for 16-bit registers +// - fixed incorrect Doxygen comments on some methods +// - added timeout value for read operations (thanks mem @ Arduino forums) +// 2011-07-30 - changed read/write function structures to return success or byte counts +// - made all methods static for multi-device memory savings +// 2011-07-28 - initial release + +/* ============================================ +I2Cdev device library code is placed under the MIT license +Copyright (c) 2013 Jeff Rowberg + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. +=============================================== +*/ + +#ifndef _I2CDEV_H_ +#define _I2CDEV_H_ + +// ----------------------------------------------------------------------------- +// I2C interface implementation setting +// ----------------------------------------------------------------------------- +#ifndef I2CDEV_IMPLEMENTATION +#define I2CDEV_IMPLEMENTATION I2CDEV_ARDUINO_WIRE +//#define I2CDEV_IMPLEMENTATION I2CDEV_TEENSY_3X_WIRE +//#define I2CDEV_IMPLEMENTATION I2CDEV_BUILTIN_SBWIRE +//#define I2CDEV_IMPLEMENTATION I2CDEV_BUILTIN_FASTWIRE +#endif // I2CDEV_IMPLEMENTATION + +// comment this out if you are using a non-optimal IDE/implementation setting +// but want the compiler to shut up about it +#define I2CDEV_IMPLEMENTATION_WARNINGS + +// ----------------------------------------------------------------------------- +// I2C interface implementation options +// ----------------------------------------------------------------------------- +#define I2CDEV_ARDUINO_WIRE 1 // Wire object from Arduino +#define I2CDEV_BUILTIN_NBWIRE 2 // Tweaked Wire object from Gene Knight's NBWire project + // ^^^ NBWire implementation is still buggy w/some interrupts! +#define I2CDEV_BUILTIN_FASTWIRE 3 // FastWire object from Francesco Ferrara's project +#define I2CDEV_I2CMASTER_LIBRARY 4 // I2C object from DSSCircuits I2C-Master Library at https://github.com/DSSCircuits/I2C-Master-Library +#define I2CDEV_BUILTIN_SBWIRE 5 // I2C object from Shuning (Steve) Bian's SBWire Library at https://github.com/freespace/SBWire +#define I2CDEV_TEENSY_3X_WIRE 6 // Teensy 3.x support using i2c_t3 library + +// ----------------------------------------------------------------------------- +// Arduino-style "Serial.print" debug constant (uncomment to enable) +// ----------------------------------------------------------------------------- +//#define I2CDEV_SERIAL_DEBUG + +#ifdef ARDUINO + #if ARDUINO < 100 + #include "WProgram.h" + #else + #include "Arduino.h" + #endif + #if I2CDEV_IMPLEMENTATION == I2CDEV_ARDUINO_WIRE + #include + #endif + #if I2CDEV_IMPLEMENTATION == I2CDEV_TEENSY_3X_WIRE + #include + #endif + #if I2CDEV_IMPLEMENTATION == I2CDEV_I2CMASTER_LIBRARY + #include + #endif + #if I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_SBWIRE + #include "SBWire.h" + #endif +#endif + +#ifdef SPARK + #include + #define ARDUINO 101 +#endif + + +// 1000ms default read timeout (modify with "I2Cdev::readTimeout = [ms];") +#define I2CDEV_DEFAULT_READ_TIMEOUT 1000 + +class I2Cdev { + public: + I2Cdev(); + + static int8_t readBit(uint8_t devAddr, uint8_t regAddr, uint8_t bitNum, uint8_t *data, uint16_t timeout=I2Cdev::readTimeout); + static int8_t readBitW(uint8_t devAddr, uint8_t regAddr, uint8_t bitNum, uint16_t *data, uint16_t timeout=I2Cdev::readTimeout); + static int8_t readBits(uint8_t devAddr, uint8_t regAddr, uint8_t bitStart, uint8_t length, uint8_t *data, uint16_t timeout=I2Cdev::readTimeout); + static int8_t readBitsW(uint8_t devAddr, uint8_t regAddr, uint8_t bitStart, uint8_t length, uint16_t *data, uint16_t timeout=I2Cdev::readTimeout); + static int8_t readByte(uint8_t devAddr, uint8_t regAddr, uint8_t *data, uint16_t timeout=I2Cdev::readTimeout); + static int8_t readWord(uint8_t devAddr, uint8_t regAddr, uint16_t *data, uint16_t timeout=I2Cdev::readTimeout); + static int8_t readBytes(uint8_t devAddr, uint8_t regAddr, uint8_t length, uint8_t *data, uint16_t timeout=I2Cdev::readTimeout); + static int8_t readWords(uint8_t devAddr, uint8_t regAddr, uint8_t length, uint16_t *data, uint16_t timeout=I2Cdev::readTimeout); + + static bool writeBit(uint8_t devAddr, uint8_t regAddr, uint8_t bitNum, uint8_t data); + static bool writeBitW(uint8_t devAddr, uint8_t regAddr, uint8_t bitNum, uint16_t data); + static bool writeBits(uint8_t devAddr, uint8_t regAddr, uint8_t bitStart, uint8_t length, uint8_t data); + static bool writeBitsW(uint8_t devAddr, uint8_t regAddr, uint8_t bitStart, uint8_t length, uint16_t data); + static bool writeByte(uint8_t devAddr, uint8_t regAddr, uint8_t data); + static bool writeWord(uint8_t devAddr, uint8_t regAddr, uint16_t data); + static bool writeBytes(uint8_t devAddr, uint8_t regAddr, uint8_t length, uint8_t *data); + static bool writeWords(uint8_t devAddr, uint8_t regAddr, uint8_t length, uint16_t *data); + + static uint16_t readTimeout; +}; + +#if I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_FASTWIRE + ////////////////////// + // FastWire 0.24 + // This is a library to help faster programs to read I2C devices. + // Copyright(C) 2012 + // Francesco Ferrara + ////////////////////// + + /* Master */ + #define TW_START 0x08 + #define TW_REP_START 0x10 + + /* Master Transmitter */ + #define TW_MT_SLA_ACK 0x18 + #define TW_MT_SLA_NACK 0x20 + #define TW_MT_DATA_ACK 0x28 + #define TW_MT_DATA_NACK 0x30 + #define TW_MT_ARB_LOST 0x38 + + /* Master Receiver */ + #define TW_MR_ARB_LOST 0x38 + #define TW_MR_SLA_ACK 0x40 + #define TW_MR_SLA_NACK 0x48 + #define TW_MR_DATA_ACK 0x50 + #define TW_MR_DATA_NACK 0x58 + + #define TW_OK 0 + #define TW_ERROR 1 + + class Fastwire { + private: + static boolean waitInt(); + + public: + static void setup(int khz, boolean pullup); + static byte beginTransmission(byte device); + static byte write(byte value); + static byte writeBuf(byte device, byte address, byte *data, byte num); + static byte readBuf(byte device, byte address, byte *data, byte num); + static void reset(); + static byte stop(); + }; +#endif + +#if I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE + // NBWire implementation based heavily on code by Gene Knight + // Originally posted on the Arduino forum at http://arduino.cc/forum/index.php/topic,70705.0.html + // Originally offered to the i2cdevlib project at http://arduino.cc/forum/index.php/topic,68210.30.html + + #define NBWIRE_BUFFER_LENGTH 32 + + class TwoWire { + private: + static uint8_t rxBuffer[]; + static uint8_t rxBufferIndex; + static uint8_t rxBufferLength; + + static uint8_t txAddress; + static uint8_t txBuffer[]; + static uint8_t txBufferIndex; + static uint8_t txBufferLength; + + // static uint8_t transmitting; + static void (*user_onRequest)(void); + static void (*user_onReceive)(int); + static void onRequestService(void); + static void onReceiveService(uint8_t*, int); + + public: + TwoWire(); + void begin(); + void begin(uint8_t); + void begin(int); + void beginTransmission(uint8_t); + //void beginTransmission(int); + uint8_t endTransmission(uint16_t timeout=0); + void nbendTransmission(void (*function)(int)) ; + uint8_t requestFrom(uint8_t, int, uint16_t timeout=0); + //uint8_t requestFrom(int, int); + void nbrequestFrom(uint8_t, int, void (*function)(int)); + void send(uint8_t); + void send(uint8_t*, uint8_t); + //void send(int); + void send(char*); + uint8_t available(void); + uint8_t receive(void); + void onReceive(void (*)(int)); + void onRequest(void (*)(void)); + }; + + #define TWI_READY 0 + #define TWI_MRX 1 + #define TWI_MTX 2 + #define TWI_SRX 3 + #define TWI_STX 4 + + #define TW_WRITE 0 + #define TW_READ 1 + + #define TW_MT_SLA_NACK 0x20 + #define TW_MT_DATA_NACK 0x30 + + #define CPU_FREQ 16000000L + #define TWI_FREQ 100000L + #define TWI_BUFFER_LENGTH 32 + + /* TWI Status is in TWSR, in the top 5 bits: TWS7 - TWS3 */ + + #define TW_STATUS_MASK (_BV(TWS7)|_BV(TWS6)|_BV(TWS5)|_BV(TWS4)|_BV(TWS3)) + #define TW_STATUS (TWSR & TW_STATUS_MASK) + #define TW_START 0x08 + #define TW_REP_START 0x10 + #define TW_MT_SLA_ACK 0x18 + #define TW_MT_SLA_NACK 0x20 + #define TW_MT_DATA_ACK 0x28 + #define TW_MT_DATA_NACK 0x30 + #define TW_MT_ARB_LOST 0x38 + #define TW_MR_ARB_LOST 0x38 + #define TW_MR_SLA_ACK 0x40 + #define TW_MR_SLA_NACK 0x48 + #define TW_MR_DATA_ACK 0x50 + #define TW_MR_DATA_NACK 0x58 + #define TW_ST_SLA_ACK 0xA8 + #define TW_ST_ARB_LOST_SLA_ACK 0xB0 + #define TW_ST_DATA_ACK 0xB8 + #define TW_ST_DATA_NACK 0xC0 + #define TW_ST_LAST_DATA 0xC8 + #define TW_SR_SLA_ACK 0x60 + #define TW_SR_ARB_LOST_SLA_ACK 0x68 + #define TW_SR_GCALL_ACK 0x70 + #define TW_SR_ARB_LOST_GCALL_ACK 0x78 + #define TW_SR_DATA_ACK 0x80 + #define TW_SR_DATA_NACK 0x88 + #define TW_SR_GCALL_DATA_ACK 0x90 + #define TW_SR_GCALL_DATA_NACK 0x98 + #define TW_SR_STOP 0xA0 + #define TW_NO_INFO 0xF8 + #define TW_BUS_ERROR 0x00 + + //#define _MMIO_BYTE(mem_addr) (*(volatile uint8_t *)(mem_addr)) + //#define _SFR_BYTE(sfr) _MMIO_BYTE(_SFR_ADDR(sfr)) + + #ifndef sbi // set bit + #define sbi(sfr, bit) (_SFR_BYTE(sfr) |= _BV(bit)) + #endif // sbi + + #ifndef cbi // clear bit + #define cbi(sfr, bit) (_SFR_BYTE(sfr) &= ~_BV(bit)) + #endif // cbi + + extern TwoWire Wire; + +#endif // I2CDEV_IMPLEMENTATION == I2CDEV_BUILTIN_NBWIRE + +#endif /* _I2CDEV_H_ */ diff --git a/lib/mpu6050/MPU6050.cpp b/lib/mpu6050/MPU6050.cpp new file mode 100644 index 0000000..f8c127d --- /dev/null +++ b/lib/mpu6050/MPU6050.cpp @@ -0,0 +1,3371 @@ +// I2Cdev library collection - MPU6050 I2C device class +// Based on InvenSense MPU-6050 register map document rev. 2.0, 5/19/2011 (RM-MPU-6000A-00) +// 8/24/2011 by Jeff Rowberg +// Updates should (hopefully) always be available at https://github.com/jrowberg/i2cdevlib +// +// Changelog: +// 2019-07-08 - Added Auto Calibration routine +// ... - ongoing debug release + +// NOTE: THIS IS ONLY A PARIAL RELEASE. THIS DEVICE CLASS IS CURRENTLY UNDERGOING ACTIVE +// DEVELOPMENT AND IS STILL MISSING SOME IMPORTANT FEATURES. PLEASE KEEP THIS IN MIND IF +// YOU DECIDE TO USE THIS PARTICULAR CODE FOR ANYTHING. + +/* ============================================ +I2Cdev device library code is placed under the MIT license +Copyright (c) 2012 Jeff Rowberg + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. +=============================================== +*/ + +#include "MPU6050.h" + +/** Specific address constructor. + * @param address I2C address, uses default I2C address if none is specified + * @see MPU6050_DEFAULT_ADDRESS + * @see MPU6050_ADDRESS_AD0_LOW + * @see MPU6050_ADDRESS_AD0_HIGH + */ +MPU6050::MPU6050(uint8_t address):devAddr(address) { +} + +/** Power on and prepare for general usage. + * This will activate the device and take it out of sleep mode (which must be done + * after start-up). This function also sets both the accelerometer and the gyroscope + * to their most sensitive settings, namely +/- 2g and +/- 250 degrees/sec, and sets + * the clock source to use the X Gyro for reference, which is slightly better than + * the default internal clock source. + */ +void MPU6050::initialize() { + setClockSource(MPU6050_CLOCK_PLL_XGYRO); + setFullScaleGyroRange(MPU6050_GYRO_FS_250); + setFullScaleAccelRange(MPU6050_ACCEL_FS_2); + setSleepEnabled(false); // thanks to Jack Elston for pointing this one out! +} + +/** Verify the I2C connection. + * Make sure the device is connected and responds as expected. + * @return True if connection is valid, false otherwise + */ +bool MPU6050::testConnection() { + return getDeviceID() == 0x34; +} + +// AUX_VDDIO register (InvenSense demo code calls this RA_*G_OFFS_TC) + +/** Get the auxiliary I2C supply voltage level. + * When set to 1, the auxiliary I2C bus high logic level is VDD. When cleared to + * 0, the auxiliary I2C bus high logic level is VLOGIC. This does not apply to + * the MPU-6000, which does not have a VLOGIC pin. + * @return I2C supply voltage level (0=VLOGIC, 1=VDD) + */ +uint8_t MPU6050::getAuxVDDIOLevel() { + I2Cdev::readBit(devAddr, MPU6050_RA_YG_OFFS_TC, MPU6050_TC_PWR_MODE_BIT, buffer); + return buffer[0]; +} +/** Set the auxiliary I2C supply voltage level. + * When set to 1, the auxiliary I2C bus high logic level is VDD. When cleared to + * 0, the auxiliary I2C bus high logic level is VLOGIC. This does not apply to + * the MPU-6000, which does not have a VLOGIC pin. + * @param level I2C supply voltage level (0=VLOGIC, 1=VDD) + */ +void MPU6050::setAuxVDDIOLevel(uint8_t level) { + I2Cdev::writeBit(devAddr, MPU6050_RA_YG_OFFS_TC, MPU6050_TC_PWR_MODE_BIT, level); +} + +// SMPLRT_DIV register + +/** Get gyroscope output rate divider. + * The sensor register output, FIFO output, DMP sampling, Motion detection, Zero + * Motion detection, and Free Fall detection are all based on the Sample Rate. + * The Sample Rate is generated by dividing the gyroscope output rate by + * SMPLRT_DIV: + * + * Sample Rate = Gyroscope Output Rate / (1 + SMPLRT_DIV) + * + * where Gyroscope Output Rate = 8kHz when the DLPF is disabled (DLPF_CFG = 0 or + * 7), and 1kHz when the DLPF is enabled (see Register 26). + * + * Note: The accelerometer output rate is 1kHz. This means that for a Sample + * Rate greater than 1kHz, the same accelerometer sample may be output to the + * FIFO, DMP, and sensor registers more than once. + * + * For a diagram of the gyroscope and accelerometer signal paths, see Section 8 + * of the MPU-6000/MPU-6050 Product Specification document. + * + * @return Current sample rate + * @see MPU6050_RA_SMPLRT_DIV + */ +uint8_t MPU6050::getRate() { + I2Cdev::readByte(devAddr, MPU6050_RA_SMPLRT_DIV, buffer); + return buffer[0]; +} +/** Set gyroscope sample rate divider. + * @param rate New sample rate divider + * @see getRate() + * @see MPU6050_RA_SMPLRT_DIV + */ +void MPU6050::setRate(uint8_t rate) { + I2Cdev::writeByte(devAddr, MPU6050_RA_SMPLRT_DIV, rate); +} + +// CONFIG register + +/** Get external FSYNC configuration. + * Configures the external Frame Synchronization (FSYNC) pin sampling. An + * external signal connected to the FSYNC pin can be sampled by configuring + * EXT_SYNC_SET. Signal changes to the FSYNC pin are latched so that short + * strobes may be captured. The latched FSYNC signal will be sampled at the + * Sampling Rate, as defined in register 25. After sampling, the latch will + * reset to the current FSYNC signal state. + * + * The sampled value will be reported in place of the least significant bit in + * a sensor data register determined by the value of EXT_SYNC_SET according to + * the following table. + * + *

+ * EXT_SYNC_SET | FSYNC Bit Location
+ * -------------+-------------------
+ * 0            | Input disabled
+ * 1            | TEMP_OUT_L[0]
+ * 2            | GYRO_XOUT_L[0]
+ * 3            | GYRO_YOUT_L[0]
+ * 4            | GYRO_ZOUT_L[0]
+ * 5            | ACCEL_XOUT_L[0]
+ * 6            | ACCEL_YOUT_L[0]
+ * 7            | ACCEL_ZOUT_L[0]
+ * 
+ * + * @return FSYNC configuration value + */ +uint8_t MPU6050::getExternalFrameSync() { + I2Cdev::readBits(devAddr, MPU6050_RA_CONFIG, MPU6050_CFG_EXT_SYNC_SET_BIT, MPU6050_CFG_EXT_SYNC_SET_LENGTH, buffer); + return buffer[0]; +} +/** Set external FSYNC configuration. + * @see getExternalFrameSync() + * @see MPU6050_RA_CONFIG + * @param sync New FSYNC configuration value + */ +void MPU6050::setExternalFrameSync(uint8_t sync) { + I2Cdev::writeBits(devAddr, MPU6050_RA_CONFIG, MPU6050_CFG_EXT_SYNC_SET_BIT, MPU6050_CFG_EXT_SYNC_SET_LENGTH, sync); +} +/** Get digital low-pass filter configuration. + * The DLPF_CFG parameter sets the digital low pass filter configuration. It + * also determines the internal sampling rate used by the device as shown in + * the table below. + * + * Note: The accelerometer output rate is 1kHz. This means that for a Sample + * Rate greater than 1kHz, the same accelerometer sample may be output to the + * FIFO, DMP, and sensor registers more than once. + * + *
+ *          |   ACCELEROMETER    |           GYROSCOPE
+ * DLPF_CFG | Bandwidth | Delay  | Bandwidth | Delay  | Sample Rate
+ * ---------+-----------+--------+-----------+--------+-------------
+ * 0        | 260Hz     | 0ms    | 256Hz     | 0.98ms | 8kHz
+ * 1        | 184Hz     | 2.0ms  | 188Hz     | 1.9ms  | 1kHz
+ * 2        | 94Hz      | 3.0ms  | 98Hz      | 2.8ms  | 1kHz
+ * 3        | 44Hz      | 4.9ms  | 42Hz      | 4.8ms  | 1kHz
+ * 4        | 21Hz      | 8.5ms  | 20Hz      | 8.3ms  | 1kHz
+ * 5        | 10Hz      | 13.8ms | 10Hz      | 13.4ms | 1kHz
+ * 6        | 5Hz       | 19.0ms | 5Hz       | 18.6ms | 1kHz
+ * 7        |   -- Reserved --   |   -- Reserved --   | Reserved
+ * 
+ * + * @return DLFP configuration + * @see MPU6050_RA_CONFIG + * @see MPU6050_CFG_DLPF_CFG_BIT + * @see MPU6050_CFG_DLPF_CFG_LENGTH + */ +uint8_t MPU6050::getDLPFMode() { + I2Cdev::readBits(devAddr, MPU6050_RA_CONFIG, MPU6050_CFG_DLPF_CFG_BIT, MPU6050_CFG_DLPF_CFG_LENGTH, buffer); + return buffer[0]; +} +/** Set digital low-pass filter configuration. + * @param mode New DLFP configuration setting + * @see getDLPFBandwidth() + * @see MPU6050_DLPF_BW_256 + * @see MPU6050_RA_CONFIG + * @see MPU6050_CFG_DLPF_CFG_BIT + * @see MPU6050_CFG_DLPF_CFG_LENGTH + */ +void MPU6050::setDLPFMode(uint8_t mode) { + I2Cdev::writeBits(devAddr, MPU6050_RA_CONFIG, MPU6050_CFG_DLPF_CFG_BIT, MPU6050_CFG_DLPF_CFG_LENGTH, mode); +} + +// GYRO_CONFIG register + +/** Get full-scale gyroscope range. + * The FS_SEL parameter allows setting the full-scale range of the gyro sensors, + * as described in the table below. + * + *
+ * 0 = +/- 250 degrees/sec
+ * 1 = +/- 500 degrees/sec
+ * 2 = +/- 1000 degrees/sec
+ * 3 = +/- 2000 degrees/sec
+ * 
+ * + * @return Current full-scale gyroscope range setting + * @see MPU6050_GYRO_FS_250 + * @see MPU6050_RA_GYRO_CONFIG + * @see MPU6050_GCONFIG_FS_SEL_BIT + * @see MPU6050_GCONFIG_FS_SEL_LENGTH + */ +uint8_t MPU6050::getFullScaleGyroRange() { + I2Cdev::readBits(devAddr, MPU6050_RA_GYRO_CONFIG, MPU6050_GCONFIG_FS_SEL_BIT, MPU6050_GCONFIG_FS_SEL_LENGTH, buffer); + return buffer[0]; +} +/** Set full-scale gyroscope range. + * @param range New full-scale gyroscope range value + * @see getFullScaleRange() + * @see MPU6050_GYRO_FS_250 + * @see MPU6050_RA_GYRO_CONFIG + * @see MPU6050_GCONFIG_FS_SEL_BIT + * @see MPU6050_GCONFIG_FS_SEL_LENGTH + */ +void MPU6050::setFullScaleGyroRange(uint8_t range) { + I2Cdev::writeBits(devAddr, MPU6050_RA_GYRO_CONFIG, MPU6050_GCONFIG_FS_SEL_BIT, MPU6050_GCONFIG_FS_SEL_LENGTH, range); +} + +// SELF TEST FACTORY TRIM VALUES + +/** Get self-test factory trim value for accelerometer X axis. + * @return factory trim value + * @see MPU6050_RA_SELF_TEST_X + */ +uint8_t MPU6050::getAccelXSelfTestFactoryTrim() { + I2Cdev::readByte(devAddr, MPU6050_RA_SELF_TEST_X, &buffer[0]); + I2Cdev::readByte(devAddr, MPU6050_RA_SELF_TEST_A, &buffer[1]); + return (buffer[0]>>3) | ((buffer[1]>>4) & 0x03); +} + +/** Get self-test factory trim value for accelerometer Y axis. + * @return factory trim value + * @see MPU6050_RA_SELF_TEST_Y + */ +uint8_t MPU6050::getAccelYSelfTestFactoryTrim() { + I2Cdev::readByte(devAddr, MPU6050_RA_SELF_TEST_Y, &buffer[0]); + I2Cdev::readByte(devAddr, MPU6050_RA_SELF_TEST_A, &buffer[1]); + return (buffer[0]>>3) | ((buffer[1]>>2) & 0x03); +} + +/** Get self-test factory trim value for accelerometer Z axis. + * @return factory trim value + * @see MPU6050_RA_SELF_TEST_Z + */ +uint8_t MPU6050::getAccelZSelfTestFactoryTrim() { + I2Cdev::readBytes(devAddr, MPU6050_RA_SELF_TEST_Z, 2, buffer); + return (buffer[0]>>3) | (buffer[1] & 0x03); +} + +/** Get self-test factory trim value for gyro X axis. + * @return factory trim value + * @see MPU6050_RA_SELF_TEST_X + */ +uint8_t MPU6050::getGyroXSelfTestFactoryTrim() { + I2Cdev::readByte(devAddr, MPU6050_RA_SELF_TEST_X, buffer); + return (buffer[0] & 0x1F); +} + +/** Get self-test factory trim value for gyro Y axis. + * @return factory trim value + * @see MPU6050_RA_SELF_TEST_Y + */ +uint8_t MPU6050::getGyroYSelfTestFactoryTrim() { + I2Cdev::readByte(devAddr, MPU6050_RA_SELF_TEST_Y, buffer); + return (buffer[0] & 0x1F); +} + +/** Get self-test factory trim value for gyro Z axis. + * @return factory trim value + * @see MPU6050_RA_SELF_TEST_Z + */ +uint8_t MPU6050::getGyroZSelfTestFactoryTrim() { + I2Cdev::readByte(devAddr, MPU6050_RA_SELF_TEST_Z, buffer); + return (buffer[0] & 0x1F); +} + +// ACCEL_CONFIG register + +/** Get self-test enabled setting for accelerometer X axis. + * @return Self-test enabled value + * @see MPU6050_RA_ACCEL_CONFIG + */ +bool MPU6050::getAccelXSelfTest() { + I2Cdev::readBit(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_XA_ST_BIT, buffer); + return buffer[0]; +} +/** Get self-test enabled setting for accelerometer X axis. + * @param enabled Self-test enabled value + * @see MPU6050_RA_ACCEL_CONFIG + */ +void MPU6050::setAccelXSelfTest(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_XA_ST_BIT, enabled); +} +/** Get self-test enabled value for accelerometer Y axis. + * @return Self-test enabled value + * @see MPU6050_RA_ACCEL_CONFIG + */ +bool MPU6050::getAccelYSelfTest() { + I2Cdev::readBit(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_YA_ST_BIT, buffer); + return buffer[0]; +} +/** Get self-test enabled value for accelerometer Y axis. + * @param enabled Self-test enabled value + * @see MPU6050_RA_ACCEL_CONFIG + */ +void MPU6050::setAccelYSelfTest(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_YA_ST_BIT, enabled); +} +/** Get self-test enabled value for accelerometer Z axis. + * @return Self-test enabled value + * @see MPU6050_RA_ACCEL_CONFIG + */ +bool MPU6050::getAccelZSelfTest() { + I2Cdev::readBit(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_ZA_ST_BIT, buffer); + return buffer[0]; +} +/** Set self-test enabled value for accelerometer Z axis. + * @param enabled Self-test enabled value + * @see MPU6050_RA_ACCEL_CONFIG + */ +void MPU6050::setAccelZSelfTest(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_ZA_ST_BIT, enabled); +} +/** Get full-scale accelerometer range. + * The FS_SEL parameter allows setting the full-scale range of the accelerometer + * sensors, as described in the table below. + * + *
+ * 0 = +/- 2g
+ * 1 = +/- 4g
+ * 2 = +/- 8g
+ * 3 = +/- 16g
+ * 
+ * + * @return Current full-scale accelerometer range setting + * @see MPU6050_ACCEL_FS_2 + * @see MPU6050_RA_ACCEL_CONFIG + * @see MPU6050_ACONFIG_AFS_SEL_BIT + * @see MPU6050_ACONFIG_AFS_SEL_LENGTH + */ +uint8_t MPU6050::getFullScaleAccelRange() { + I2Cdev::readBits(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_AFS_SEL_BIT, MPU6050_ACONFIG_AFS_SEL_LENGTH, buffer); + return buffer[0]; +} +/** Set full-scale accelerometer range. + * @param range New full-scale accelerometer range setting + * @see getFullScaleAccelRange() + */ +void MPU6050::setFullScaleAccelRange(uint8_t range) { + I2Cdev::writeBits(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_AFS_SEL_BIT, MPU6050_ACONFIG_AFS_SEL_LENGTH, range); +} +/** Get the high-pass filter configuration. + * The DHPF is a filter module in the path leading to motion detectors (Free + * Fall, Motion threshold, and Zero Motion). The high pass filter output is not + * available to the data registers (see Figure in Section 8 of the MPU-6000/ + * MPU-6050 Product Specification document). + * + * The high pass filter has three modes: + * + *
+ *    Reset: The filter output settles to zero within one sample. This
+ *           effectively disables the high pass filter. This mode may be toggled
+ *           to quickly settle the filter.
+ *
+ *    On:    The high pass filter will pass signals above the cut off frequency.
+ *
+ *    Hold:  When triggered, the filter holds the present sample. The filter
+ *           output will be the difference between the input sample and the held
+ *           sample.
+ * 
+ * + *
+ * ACCEL_HPF | Filter Mode | Cut-off Frequency
+ * ----------+-------------+------------------
+ * 0         | Reset       | None
+ * 1         | On          | 5Hz
+ * 2         | On          | 2.5Hz
+ * 3         | On          | 1.25Hz
+ * 4         | On          | 0.63Hz
+ * 7         | Hold        | None
+ * 
+ * + * @return Current high-pass filter configuration + * @see MPU6050_DHPF_RESET + * @see MPU6050_RA_ACCEL_CONFIG + */ +uint8_t MPU6050::getDHPFMode() { + I2Cdev::readBits(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_ACCEL_HPF_BIT, MPU6050_ACONFIG_ACCEL_HPF_LENGTH, buffer); + return buffer[0]; +} +/** Set the high-pass filter configuration. + * @param bandwidth New high-pass filter configuration + * @see setDHPFMode() + * @see MPU6050_DHPF_RESET + * @see MPU6050_RA_ACCEL_CONFIG + */ +void MPU6050::setDHPFMode(uint8_t bandwidth) { + I2Cdev::writeBits(devAddr, MPU6050_RA_ACCEL_CONFIG, MPU6050_ACONFIG_ACCEL_HPF_BIT, MPU6050_ACONFIG_ACCEL_HPF_LENGTH, bandwidth); +} + +// FF_THR register + +/** Get free-fall event acceleration threshold. + * This register configures the detection threshold for Free Fall event + * detection. The unit of FF_THR is 1LSB = 2mg. Free Fall is detected when the + * absolute value of the accelerometer measurements for the three axes are each + * less than the detection threshold. This condition increments the Free Fall + * duration counter (Register 30). The Free Fall interrupt is triggered when the + * Free Fall duration counter reaches the time specified in FF_DUR. + * + * For more details on the Free Fall detection interrupt, see Section 8.2 of the + * MPU-6000/MPU-6050 Product Specification document as well as Registers 56 and + * 58 of this document. + * + * @return Current free-fall acceleration threshold value (LSB = 2mg) + * @see MPU6050_RA_FF_THR + */ +uint8_t MPU6050::getFreefallDetectionThreshold() { + I2Cdev::readByte(devAddr, MPU6050_RA_FF_THR, buffer); + return buffer[0]; +} +/** Get free-fall event acceleration threshold. + * @param threshold New free-fall acceleration threshold value (LSB = 2mg) + * @see getFreefallDetectionThreshold() + * @see MPU6050_RA_FF_THR + */ +void MPU6050::setFreefallDetectionThreshold(uint8_t threshold) { + I2Cdev::writeByte(devAddr, MPU6050_RA_FF_THR, threshold); +} + +// FF_DUR register + +/** Get free-fall event duration threshold. + * This register configures the duration counter threshold for Free Fall event + * detection. The duration counter ticks at 1kHz, therefore FF_DUR has a unit + * of 1 LSB = 1 ms. + * + * The Free Fall duration counter increments while the absolute value of the + * accelerometer measurements are each less than the detection threshold + * (Register 29). The Free Fall interrupt is triggered when the Free Fall + * duration counter reaches the time specified in this register. + * + * For more details on the Free Fall detection interrupt, see Section 8.2 of + * the MPU-6000/MPU-6050 Product Specification document as well as Registers 56 + * and 58 of this document. + * + * @return Current free-fall duration threshold value (LSB = 1ms) + * @see MPU6050_RA_FF_DUR + */ +uint8_t MPU6050::getFreefallDetectionDuration() { + I2Cdev::readByte(devAddr, MPU6050_RA_FF_DUR, buffer); + return buffer[0]; +} +/** Get free-fall event duration threshold. + * @param duration New free-fall duration threshold value (LSB = 1ms) + * @see getFreefallDetectionDuration() + * @see MPU6050_RA_FF_DUR + */ +void MPU6050::setFreefallDetectionDuration(uint8_t duration) { + I2Cdev::writeByte(devAddr, MPU6050_RA_FF_DUR, duration); +} + +// MOT_THR register + +/** Get motion detection event acceleration threshold. + * This register configures the detection threshold for Motion interrupt + * generation. The unit of MOT_THR is 1LSB = 2mg. Motion is detected when the + * absolute value of any of the accelerometer measurements exceeds this Motion + * detection threshold. This condition increments the Motion detection duration + * counter (Register 32). The Motion detection interrupt is triggered when the + * Motion Detection counter reaches the time count specified in MOT_DUR + * (Register 32). + * + * The Motion interrupt will indicate the axis and polarity of detected motion + * in MOT_DETECT_STATUS (Register 97). + * + * For more details on the Motion detection interrupt, see Section 8.3 of the + * MPU-6000/MPU-6050 Product Specification document as well as Registers 56 and + * 58 of this document. + * + * @return Current motion detection acceleration threshold value (LSB = 2mg) + * @see MPU6050_RA_MOT_THR + */ +uint8_t MPU6050::getMotionDetectionThreshold() { + I2Cdev::readByte(devAddr, MPU6050_RA_MOT_THR, buffer); + return buffer[0]; +} +/** Set motion detection event acceleration threshold. + * @param threshold New motion detection acceleration threshold value (LSB = 2mg) + * @see getMotionDetectionThreshold() + * @see MPU6050_RA_MOT_THR + */ +void MPU6050::setMotionDetectionThreshold(uint8_t threshold) { + I2Cdev::writeByte(devAddr, MPU6050_RA_MOT_THR, threshold); +} + +// MOT_DUR register + +/** Get motion detection event duration threshold. + * This register configures the duration counter threshold for Motion interrupt + * generation. The duration counter ticks at 1 kHz, therefore MOT_DUR has a unit + * of 1LSB = 1ms. The Motion detection duration counter increments when the + * absolute value of any of the accelerometer measurements exceeds the Motion + * detection threshold (Register 31). The Motion detection interrupt is + * triggered when the Motion detection counter reaches the time count specified + * in this register. + * + * For more details on the Motion detection interrupt, see Section 8.3 of the + * MPU-6000/MPU-6050 Product Specification document. + * + * @return Current motion detection duration threshold value (LSB = 1ms) + * @see MPU6050_RA_MOT_DUR + */ +uint8_t MPU6050::getMotionDetectionDuration() { + I2Cdev::readByte(devAddr, MPU6050_RA_MOT_DUR, buffer); + return buffer[0]; +} +/** Set motion detection event duration threshold. + * @param duration New motion detection duration threshold value (LSB = 1ms) + * @see getMotionDetectionDuration() + * @see MPU6050_RA_MOT_DUR + */ +void MPU6050::setMotionDetectionDuration(uint8_t duration) { + I2Cdev::writeByte(devAddr, MPU6050_RA_MOT_DUR, duration); +} + +// ZRMOT_THR register + +/** Get zero motion detection event acceleration threshold. + * This register configures the detection threshold for Zero Motion interrupt + * generation. The unit of ZRMOT_THR is 1LSB = 2mg. Zero Motion is detected when + * the absolute value of the accelerometer measurements for the 3 axes are each + * less than the detection threshold. This condition increments the Zero Motion + * duration counter (Register 34). The Zero Motion interrupt is triggered when + * the Zero Motion duration counter reaches the time count specified in + * ZRMOT_DUR (Register 34). + * + * Unlike Free Fall or Motion detection, Zero Motion detection triggers an + * interrupt both when Zero Motion is first detected and when Zero Motion is no + * longer detected. + * + * When a zero motion event is detected, a Zero Motion Status will be indicated + * in the MOT_DETECT_STATUS register (Register 97). When a motion-to-zero-motion + * condition is detected, the status bit is set to 1. When a zero-motion-to- + * motion condition is detected, the status bit is set to 0. + * + * For more details on the Zero Motion detection interrupt, see Section 8.4 of + * the MPU-6000/MPU-6050 Product Specification document as well as Registers 56 + * and 58 of this document. + * + * @return Current zero motion detection acceleration threshold value (LSB = 2mg) + * @see MPU6050_RA_ZRMOT_THR + */ +uint8_t MPU6050::getZeroMotionDetectionThreshold() { + I2Cdev::readByte(devAddr, MPU6050_RA_ZRMOT_THR, buffer); + return buffer[0]; +} +/** Set zero motion detection event acceleration threshold. + * @param threshold New zero motion detection acceleration threshold value (LSB = 2mg) + * @see getZeroMotionDetectionThreshold() + * @see MPU6050_RA_ZRMOT_THR + */ +void MPU6050::setZeroMotionDetectionThreshold(uint8_t threshold) { + I2Cdev::writeByte(devAddr, MPU6050_RA_ZRMOT_THR, threshold); +} + +// ZRMOT_DUR register + +/** Get zero motion detection event duration threshold. + * This register configures the duration counter threshold for Zero Motion + * interrupt generation. The duration counter ticks at 16 Hz, therefore + * ZRMOT_DUR has a unit of 1 LSB = 64 ms. The Zero Motion duration counter + * increments while the absolute value of the accelerometer measurements are + * each less than the detection threshold (Register 33). The Zero Motion + * interrupt is triggered when the Zero Motion duration counter reaches the time + * count specified in this register. + * + * For more details on the Zero Motion detection interrupt, see Section 8.4 of + * the MPU-6000/MPU-6050 Product Specification document, as well as Registers 56 + * and 58 of this document. + * + * @return Current zero motion detection duration threshold value (LSB = 64ms) + * @see MPU6050_RA_ZRMOT_DUR + */ +uint8_t MPU6050::getZeroMotionDetectionDuration() { + I2Cdev::readByte(devAddr, MPU6050_RA_ZRMOT_DUR, buffer); + return buffer[0]; +} +/** Set zero motion detection event duration threshold. + * @param duration New zero motion detection duration threshold value (LSB = 1ms) + * @see getZeroMotionDetectionDuration() + * @see MPU6050_RA_ZRMOT_DUR + */ +void MPU6050::setZeroMotionDetectionDuration(uint8_t duration) { + I2Cdev::writeByte(devAddr, MPU6050_RA_ZRMOT_DUR, duration); +} + +// FIFO_EN register + +/** Get temperature FIFO enabled value. + * When set to 1, this bit enables TEMP_OUT_H and TEMP_OUT_L (Registers 65 and + * 66) to be written into the FIFO buffer. + * @return Current temperature FIFO enabled value + * @see MPU6050_RA_FIFO_EN + */ +bool MPU6050::getTempFIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_TEMP_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set temperature FIFO enabled value. + * @param enabled New temperature FIFO enabled value + * @see getTempFIFOEnabled() + * @see MPU6050_RA_FIFO_EN + */ +void MPU6050::setTempFIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_TEMP_FIFO_EN_BIT, enabled); +} +/** Get gyroscope X-axis FIFO enabled value. + * When set to 1, this bit enables GYRO_XOUT_H and GYRO_XOUT_L (Registers 67 and + * 68) to be written into the FIFO buffer. + * @return Current gyroscope X-axis FIFO enabled value + * @see MPU6050_RA_FIFO_EN + */ +bool MPU6050::getXGyroFIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_XG_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set gyroscope X-axis FIFO enabled value. + * @param enabled New gyroscope X-axis FIFO enabled value + * @see getXGyroFIFOEnabled() + * @see MPU6050_RA_FIFO_EN + */ +void MPU6050::setXGyroFIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_XG_FIFO_EN_BIT, enabled); +} +/** Get gyroscope Y-axis FIFO enabled value. + * When set to 1, this bit enables GYRO_YOUT_H and GYRO_YOUT_L (Registers 69 and + * 70) to be written into the FIFO buffer. + * @return Current gyroscope Y-axis FIFO enabled value + * @see MPU6050_RA_FIFO_EN + */ +bool MPU6050::getYGyroFIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_YG_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set gyroscope Y-axis FIFO enabled value. + * @param enabled New gyroscope Y-axis FIFO enabled value + * @see getYGyroFIFOEnabled() + * @see MPU6050_RA_FIFO_EN + */ +void MPU6050::setYGyroFIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_YG_FIFO_EN_BIT, enabled); +} +/** Get gyroscope Z-axis FIFO enabled value. + * When set to 1, this bit enables GYRO_ZOUT_H and GYRO_ZOUT_L (Registers 71 and + * 72) to be written into the FIFO buffer. + * @return Current gyroscope Z-axis FIFO enabled value + * @see MPU6050_RA_FIFO_EN + */ +bool MPU6050::getZGyroFIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_ZG_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set gyroscope Z-axis FIFO enabled value. + * @param enabled New gyroscope Z-axis FIFO enabled value + * @see getZGyroFIFOEnabled() + * @see MPU6050_RA_FIFO_EN + */ +void MPU6050::setZGyroFIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_ZG_FIFO_EN_BIT, enabled); +} +/** Get accelerometer FIFO enabled value. + * When set to 1, this bit enables ACCEL_XOUT_H, ACCEL_XOUT_L, ACCEL_YOUT_H, + * ACCEL_YOUT_L, ACCEL_ZOUT_H, and ACCEL_ZOUT_L (Registers 59 to 64) to be + * written into the FIFO buffer. + * @return Current accelerometer FIFO enabled value + * @see MPU6050_RA_FIFO_EN + */ +bool MPU6050::getAccelFIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_ACCEL_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set accelerometer FIFO enabled value. + * @param enabled New accelerometer FIFO enabled value + * @see getAccelFIFOEnabled() + * @see MPU6050_RA_FIFO_EN + */ +void MPU6050::setAccelFIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_ACCEL_FIFO_EN_BIT, enabled); +} +/** Get Slave 2 FIFO enabled value. + * When set to 1, this bit enables EXT_SENS_DATA registers (Registers 73 to 96) + * associated with Slave 2 to be written into the FIFO buffer. + * @return Current Slave 2 FIFO enabled value + * @see MPU6050_RA_FIFO_EN + */ +bool MPU6050::getSlave2FIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_SLV2_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set Slave 2 FIFO enabled value. + * @param enabled New Slave 2 FIFO enabled value + * @see getSlave2FIFOEnabled() + * @see MPU6050_RA_FIFO_EN + */ +void MPU6050::setSlave2FIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_SLV2_FIFO_EN_BIT, enabled); +} +/** Get Slave 1 FIFO enabled value. + * When set to 1, this bit enables EXT_SENS_DATA registers (Registers 73 to 96) + * associated with Slave 1 to be written into the FIFO buffer. + * @return Current Slave 1 FIFO enabled value + * @see MPU6050_RA_FIFO_EN + */ +bool MPU6050::getSlave1FIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_SLV1_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set Slave 1 FIFO enabled value. + * @param enabled New Slave 1 FIFO enabled value + * @see getSlave1FIFOEnabled() + * @see MPU6050_RA_FIFO_EN + */ +void MPU6050::setSlave1FIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_SLV1_FIFO_EN_BIT, enabled); +} +/** Get Slave 0 FIFO enabled value. + * When set to 1, this bit enables EXT_SENS_DATA registers (Registers 73 to 96) + * associated with Slave 0 to be written into the FIFO buffer. + * @return Current Slave 0 FIFO enabled value + * @see MPU6050_RA_FIFO_EN + */ +bool MPU6050::getSlave0FIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_SLV0_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set Slave 0 FIFO enabled value. + * @param enabled New Slave 0 FIFO enabled value + * @see getSlave0FIFOEnabled() + * @see MPU6050_RA_FIFO_EN + */ +void MPU6050::setSlave0FIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_FIFO_EN, MPU6050_SLV0_FIFO_EN_BIT, enabled); +} + +// I2C_MST_CTRL register + +/** Get multi-master enabled value. + * Multi-master capability allows multiple I2C masters to operate on the same + * bus. In circuits where multi-master capability is required, set MULT_MST_EN + * to 1. This will increase current drawn by approximately 30uA. + * + * In circuits where multi-master capability is required, the state of the I2C + * bus must always be monitored by each separate I2C Master. Before an I2C + * Master can assume arbitration of the bus, it must first confirm that no other + * I2C Master has arbitration of the bus. When MULT_MST_EN is set to 1, the + * MPU-60X0's bus arbitration detection logic is turned on, enabling it to + * detect when the bus is available. + * + * @return Current multi-master enabled value + * @see MPU6050_RA_I2C_MST_CTRL + */ +bool MPU6050::getMultiMasterEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_MULT_MST_EN_BIT, buffer); + return buffer[0]; +} +/** Set multi-master enabled value. + * @param enabled New multi-master enabled value + * @see getMultiMasterEnabled() + * @see MPU6050_RA_I2C_MST_CTRL + */ +void MPU6050::setMultiMasterEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_MULT_MST_EN_BIT, enabled); +} +/** Get wait-for-external-sensor-data enabled value. + * When the WAIT_FOR_ES bit is set to 1, the Data Ready interrupt will be + * delayed until External Sensor data from the Slave Devices are loaded into the + * EXT_SENS_DATA registers. This is used to ensure that both the internal sensor + * data (i.e. from gyro and accel) and external sensor data have been loaded to + * their respective data registers (i.e. the data is synced) when the Data Ready + * interrupt is triggered. + * + * @return Current wait-for-external-sensor-data enabled value + * @see MPU6050_RA_I2C_MST_CTRL + */ +bool MPU6050::getWaitForExternalSensorEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_WAIT_FOR_ES_BIT, buffer); + return buffer[0]; +} +/** Set wait-for-external-sensor-data enabled value. + * @param enabled New wait-for-external-sensor-data enabled value + * @see getWaitForExternalSensorEnabled() + * @see MPU6050_RA_I2C_MST_CTRL + */ +void MPU6050::setWaitForExternalSensorEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_WAIT_FOR_ES_BIT, enabled); +} +/** Get Slave 3 FIFO enabled value. + * When set to 1, this bit enables EXT_SENS_DATA registers (Registers 73 to 96) + * associated with Slave 3 to be written into the FIFO buffer. + * @return Current Slave 3 FIFO enabled value + * @see MPU6050_RA_MST_CTRL + */ +bool MPU6050::getSlave3FIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_SLV_3_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set Slave 3 FIFO enabled value. + * @param enabled New Slave 3 FIFO enabled value + * @see getSlave3FIFOEnabled() + * @see MPU6050_RA_MST_CTRL + */ +void MPU6050::setSlave3FIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_SLV_3_FIFO_EN_BIT, enabled); +} +/** Get slave read/write transition enabled value. + * The I2C_MST_P_NSR bit configures the I2C Master's transition from one slave + * read to the next slave read. If the bit equals 0, there will be a restart + * between reads. If the bit equals 1, there will be a stop followed by a start + * of the following read. When a write transaction follows a read transaction, + * the stop followed by a start of the successive write will be always used. + * + * @return Current slave read/write transition enabled value + * @see MPU6050_RA_I2C_MST_CTRL + */ +bool MPU6050::getSlaveReadWriteTransitionEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_I2C_MST_P_NSR_BIT, buffer); + return buffer[0]; +} +/** Set slave read/write transition enabled value. + * @param enabled New slave read/write transition enabled value + * @see getSlaveReadWriteTransitionEnabled() + * @see MPU6050_RA_I2C_MST_CTRL + */ +void MPU6050::setSlaveReadWriteTransitionEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_I2C_MST_P_NSR_BIT, enabled); +} +/** Get I2C master clock speed. + * I2C_MST_CLK is a 4 bit unsigned value which configures a divider on the + * MPU-60X0 internal 8MHz clock. It sets the I2C master clock speed according to + * the following table: + * + *
+ * I2C_MST_CLK | I2C Master Clock Speed | 8MHz Clock Divider
+ * ------------+------------------------+-------------------
+ * 0           | 348kHz                 | 23
+ * 1           | 333kHz                 | 24
+ * 2           | 320kHz                 | 25
+ * 3           | 308kHz                 | 26
+ * 4           | 296kHz                 | 27
+ * 5           | 286kHz                 | 28
+ * 6           | 276kHz                 | 29
+ * 7           | 267kHz                 | 30
+ * 8           | 258kHz                 | 31
+ * 9           | 500kHz                 | 16
+ * 10          | 471kHz                 | 17
+ * 11          | 444kHz                 | 18
+ * 12          | 421kHz                 | 19
+ * 13          | 400kHz                 | 20
+ * 14          | 381kHz                 | 21
+ * 15          | 364kHz                 | 22
+ * 
+ * + * @return Current I2C master clock speed + * @see MPU6050_RA_I2C_MST_CTRL + */ +uint8_t MPU6050::getMasterClockSpeed() { + I2Cdev::readBits(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_I2C_MST_CLK_BIT, MPU6050_I2C_MST_CLK_LENGTH, buffer); + return buffer[0]; +} +/** Set I2C master clock speed. + * @reparam speed Current I2C master clock speed + * @see MPU6050_RA_I2C_MST_CTRL + */ +void MPU6050::setMasterClockSpeed(uint8_t speed) { + I2Cdev::writeBits(devAddr, MPU6050_RA_I2C_MST_CTRL, MPU6050_I2C_MST_CLK_BIT, MPU6050_I2C_MST_CLK_LENGTH, speed); +} + +// I2C_SLV* registers (Slave 0-3) + +/** Get the I2C address of the specified slave (0-3). + * Note that Bit 7 (MSB) controls read/write mode. If Bit 7 is set, it's a read + * operation, and if it is cleared, then it's a write operation. The remaining + * bits (6-0) are the 7-bit device address of the slave device. + * + * In read mode, the result of the read is placed in the lowest available + * EXT_SENS_DATA register. For further information regarding the allocation of + * read results, please refer to the EXT_SENS_DATA register description + * (Registers 73 - 96). + * + * The MPU-6050 supports a total of five slaves, but Slave 4 has unique + * characteristics, and so it has its own functions (getSlave4* and setSlave4*). + * + * I2C data transactions are performed at the Sample Rate, as defined in + * Register 25. The user is responsible for ensuring that I2C data transactions + * to and from each enabled Slave can be completed within a single period of the + * Sample Rate. + * + * The I2C slave access rate can be reduced relative to the Sample Rate. This + * reduced access rate is determined by I2C_MST_DLY (Register 52). Whether a + * slave's access rate is reduced relative to the Sample Rate is determined by + * I2C_MST_DELAY_CTRL (Register 103). + * + * The processing order for the slaves is fixed. The sequence followed for + * processing the slaves is Slave 0, Slave 1, Slave 2, Slave 3 and Slave 4. If a + * particular Slave is disabled it will be skipped. + * + * Each slave can either be accessed at the sample rate or at a reduced sample + * rate. In a case where some slaves are accessed at the Sample Rate and some + * slaves are accessed at the reduced rate, the sequence of accessing the slaves + * (Slave 0 to Slave 4) is still followed. However, the reduced rate slaves will + * be skipped if their access rate dictates that they should not be accessed + * during that particular cycle. For further information regarding the reduced + * access rate, please refer to Register 52. Whether a slave is accessed at the + * Sample Rate or at the reduced rate is determined by the Delay Enable bits in + * Register 103. + * + * @param num Slave number (0-3) + * @return Current address for specified slave + * @see MPU6050_RA_I2C_SLV0_ADDR + */ +uint8_t MPU6050::getSlaveAddress(uint8_t num) { + if (num > 3) return 0; + I2Cdev::readByte(devAddr, MPU6050_RA_I2C_SLV0_ADDR + num*3, buffer); + return buffer[0]; +} +/** Set the I2C address of the specified slave (0-3). + * @param num Slave number (0-3) + * @param address New address for specified slave + * @see getSlaveAddress() + * @see MPU6050_RA_I2C_SLV0_ADDR + */ +void MPU6050::setSlaveAddress(uint8_t num, uint8_t address) { + if (num > 3) return; + I2Cdev::writeByte(devAddr, MPU6050_RA_I2C_SLV0_ADDR + num*3, address); +} +/** Get the active internal register for the specified slave (0-3). + * Read/write operations for this slave will be done to whatever internal + * register address is stored in this MPU register. + * + * The MPU-6050 supports a total of five slaves, but Slave 4 has unique + * characteristics, and so it has its own functions. + * + * @param num Slave number (0-3) + * @return Current active register for specified slave + * @see MPU6050_RA_I2C_SLV0_REG + */ +uint8_t MPU6050::getSlaveRegister(uint8_t num) { + if (num > 3) return 0; + I2Cdev::readByte(devAddr, MPU6050_RA_I2C_SLV0_REG + num*3, buffer); + return buffer[0]; +} +/** Set the active internal register for the specified slave (0-3). + * @param num Slave number (0-3) + * @param reg New active register for specified slave + * @see getSlaveRegister() + * @see MPU6050_RA_I2C_SLV0_REG + */ +void MPU6050::setSlaveRegister(uint8_t num, uint8_t reg) { + if (num > 3) return; + I2Cdev::writeByte(devAddr, MPU6050_RA_I2C_SLV0_REG + num*3, reg); +} +/** Get the enabled value for the specified slave (0-3). + * When set to 1, this bit enables Slave 0 for data transfer operations. When + * cleared to 0, this bit disables Slave 0 from data transfer operations. + * @param num Slave number (0-3) + * @return Current enabled value for specified slave + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +bool MPU6050::getSlaveEnabled(uint8_t num) { + if (num > 3) return 0; + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_EN_BIT, buffer); + return buffer[0]; +} +/** Set the enabled value for the specified slave (0-3). + * @param num Slave number (0-3) + * @param enabled New enabled value for specified slave + * @see getSlaveEnabled() + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +void MPU6050::setSlaveEnabled(uint8_t num, bool enabled) { + if (num > 3) return; + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_EN_BIT, enabled); +} +/** Get word pair byte-swapping enabled for the specified slave (0-3). + * When set to 1, this bit enables byte swapping. When byte swapping is enabled, + * the high and low bytes of a word pair are swapped. Please refer to + * I2C_SLV0_GRP for the pairing convention of the word pairs. When cleared to 0, + * bytes transferred to and from Slave 0 will be written to EXT_SENS_DATA + * registers in the order they were transferred. + * + * @param num Slave number (0-3) + * @return Current word pair byte-swapping enabled value for specified slave + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +bool MPU6050::getSlaveWordByteSwap(uint8_t num) { + if (num > 3) return 0; + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_BYTE_SW_BIT, buffer); + return buffer[0]; +} +/** Set word pair byte-swapping enabled for the specified slave (0-3). + * @param num Slave number (0-3) + * @param enabled New word pair byte-swapping enabled value for specified slave + * @see getSlaveWordByteSwap() + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +void MPU6050::setSlaveWordByteSwap(uint8_t num, bool enabled) { + if (num > 3) return; + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_BYTE_SW_BIT, enabled); +} +/** Get write mode for the specified slave (0-3). + * When set to 1, the transaction will read or write data only. When cleared to + * 0, the transaction will write a register address prior to reading or writing + * data. This should equal 0 when specifying the register address within the + * Slave device to/from which the ensuing data transaction will take place. + * + * @param num Slave number (0-3) + * @return Current write mode for specified slave (0 = register address + data, 1 = data only) + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +bool MPU6050::getSlaveWriteMode(uint8_t num) { + if (num > 3) return 0; + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_REG_DIS_BIT, buffer); + return buffer[0]; +} +/** Set write mode for the specified slave (0-3). + * @param num Slave number (0-3) + * @param mode New write mode for specified slave (0 = register address + data, 1 = data only) + * @see getSlaveWriteMode() + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +void MPU6050::setSlaveWriteMode(uint8_t num, bool mode) { + if (num > 3) return; + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_REG_DIS_BIT, mode); +} +/** Get word pair grouping order offset for the specified slave (0-3). + * This sets specifies the grouping order of word pairs received from registers. + * When cleared to 0, bytes from register addresses 0 and 1, 2 and 3, etc (even, + * then odd register addresses) are paired to form a word. When set to 1, bytes + * from register addresses are paired 1 and 2, 3 and 4, etc. (odd, then even + * register addresses) are paired to form a word. + * + * @param num Slave number (0-3) + * @return Current word pair grouping order offset for specified slave + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +bool MPU6050::getSlaveWordGroupOffset(uint8_t num) { + if (num > 3) return 0; + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_GRP_BIT, buffer); + return buffer[0]; +} +/** Set word pair grouping order offset for the specified slave (0-3). + * @param num Slave number (0-3) + * @param enabled New word pair grouping order offset for specified slave + * @see getSlaveWordGroupOffset() + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +void MPU6050::setSlaveWordGroupOffset(uint8_t num, bool enabled) { + if (num > 3) return; + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_GRP_BIT, enabled); +} +/** Get number of bytes to read for the specified slave (0-3). + * Specifies the number of bytes transferred to and from Slave 0. Clearing this + * bit to 0 is equivalent to disabling the register by writing 0 to I2C_SLV0_EN. + * @param num Slave number (0-3) + * @return Number of bytes to read for specified slave + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +uint8_t MPU6050::getSlaveDataLength(uint8_t num) { + if (num > 3) return 0; + I2Cdev::readBits(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_LEN_BIT, MPU6050_I2C_SLV_LEN_LENGTH, buffer); + return buffer[0]; +} +/** Set number of bytes to read for the specified slave (0-3). + * @param num Slave number (0-3) + * @param length Number of bytes to read for specified slave + * @see getSlaveDataLength() + * @see MPU6050_RA_I2C_SLV0_CTRL + */ +void MPU6050::setSlaveDataLength(uint8_t num, uint8_t length) { + if (num > 3) return; + I2Cdev::writeBits(devAddr, MPU6050_RA_I2C_SLV0_CTRL + num*3, MPU6050_I2C_SLV_LEN_BIT, MPU6050_I2C_SLV_LEN_LENGTH, length); +} + +// I2C_SLV* registers (Slave 4) + +/** Get the I2C address of Slave 4. + * Note that Bit 7 (MSB) controls read/write mode. If Bit 7 is set, it's a read + * operation, and if it is cleared, then it's a write operation. The remaining + * bits (6-0) are the 7-bit device address of the slave device. + * + * @return Current address for Slave 4 + * @see getSlaveAddress() + * @see MPU6050_RA_I2C_SLV4_ADDR + */ +uint8_t MPU6050::getSlave4Address() { + I2Cdev::readByte(devAddr, MPU6050_RA_I2C_SLV4_ADDR, buffer); + return buffer[0]; +} +/** Set the I2C address of Slave 4. + * @param address New address for Slave 4 + * @see getSlave4Address() + * @see MPU6050_RA_I2C_SLV4_ADDR + */ +void MPU6050::setSlave4Address(uint8_t address) { + I2Cdev::writeByte(devAddr, MPU6050_RA_I2C_SLV4_ADDR, address); +} +/** Get the active internal register for the Slave 4. + * Read/write operations for this slave will be done to whatever internal + * register address is stored in this MPU register. + * + * @return Current active register for Slave 4 + * @see MPU6050_RA_I2C_SLV4_REG + */ +uint8_t MPU6050::getSlave4Register() { + I2Cdev::readByte(devAddr, MPU6050_RA_I2C_SLV4_REG, buffer); + return buffer[0]; +} +/** Set the active internal register for Slave 4. + * @param reg New active register for Slave 4 + * @see getSlave4Register() + * @see MPU6050_RA_I2C_SLV4_REG + */ +void MPU6050::setSlave4Register(uint8_t reg) { + I2Cdev::writeByte(devAddr, MPU6050_RA_I2C_SLV4_REG, reg); +} +/** Set new byte to write to Slave 4. + * This register stores the data to be written into the Slave 4. If I2C_SLV4_RW + * is set 1 (set to read), this register has no effect. + * @param data New byte to write to Slave 4 + * @see MPU6050_RA_I2C_SLV4_DO + */ +void MPU6050::setSlave4OutputByte(uint8_t data) { + I2Cdev::writeByte(devAddr, MPU6050_RA_I2C_SLV4_DO, data); +} +/** Get the enabled value for the Slave 4. + * When set to 1, this bit enables Slave 4 for data transfer operations. When + * cleared to 0, this bit disables Slave 4 from data transfer operations. + * @return Current enabled value for Slave 4 + * @see MPU6050_RA_I2C_SLV4_CTRL + */ +bool MPU6050::getSlave4Enabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_SLV4_CTRL, MPU6050_I2C_SLV4_EN_BIT, buffer); + return buffer[0]; +} +/** Set the enabled value for Slave 4. + * @param enabled New enabled value for Slave 4 + * @see getSlave4Enabled() + * @see MPU6050_RA_I2C_SLV4_CTRL + */ +void MPU6050::setSlave4Enabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_SLV4_CTRL, MPU6050_I2C_SLV4_EN_BIT, enabled); +} +/** Get the enabled value for Slave 4 transaction interrupts. + * When set to 1, this bit enables the generation of an interrupt signal upon + * completion of a Slave 4 transaction. When cleared to 0, this bit disables the + * generation of an interrupt signal upon completion of a Slave 4 transaction. + * The interrupt status can be observed in Register 54. + * + * @return Current enabled value for Slave 4 transaction interrupts. + * @see MPU6050_RA_I2C_SLV4_CTRL + */ +bool MPU6050::getSlave4InterruptEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_SLV4_CTRL, MPU6050_I2C_SLV4_INT_EN_BIT, buffer); + return buffer[0]; +} +/** Set the enabled value for Slave 4 transaction interrupts. + * @param enabled New enabled value for Slave 4 transaction interrupts. + * @see getSlave4InterruptEnabled() + * @see MPU6050_RA_I2C_SLV4_CTRL + */ +void MPU6050::setSlave4InterruptEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_SLV4_CTRL, MPU6050_I2C_SLV4_INT_EN_BIT, enabled); +} +/** Get write mode for Slave 4. + * When set to 1, the transaction will read or write data only. When cleared to + * 0, the transaction will write a register address prior to reading or writing + * data. This should equal 0 when specifying the register address within the + * Slave device to/from which the ensuing data transaction will take place. + * + * @return Current write mode for Slave 4 (0 = register address + data, 1 = data only) + * @see MPU6050_RA_I2C_SLV4_CTRL + */ +bool MPU6050::getSlave4WriteMode() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_SLV4_CTRL, MPU6050_I2C_SLV4_REG_DIS_BIT, buffer); + return buffer[0]; +} +/** Set write mode for the Slave 4. + * @param mode New write mode for Slave 4 (0 = register address + data, 1 = data only) + * @see getSlave4WriteMode() + * @see MPU6050_RA_I2C_SLV4_CTRL + */ +void MPU6050::setSlave4WriteMode(bool mode) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_SLV4_CTRL, MPU6050_I2C_SLV4_REG_DIS_BIT, mode); +} +/** Get Slave 4 master delay value. + * This configures the reduced access rate of I2C slaves relative to the Sample + * Rate. When a slave's access rate is decreased relative to the Sample Rate, + * the slave is accessed every: + * + * 1 / (1 + I2C_MST_DLY) samples + * + * This base Sample Rate in turn is determined by SMPLRT_DIV (register 25) and + * DLPF_CFG (register 26). Whether a slave's access rate is reduced relative to + * the Sample Rate is determined by I2C_MST_DELAY_CTRL (register 103). For + * further information regarding the Sample Rate, please refer to register 25. + * + * @return Current Slave 4 master delay value + * @see MPU6050_RA_I2C_SLV4_CTRL + */ +uint8_t MPU6050::getSlave4MasterDelay() { + I2Cdev::readBits(devAddr, MPU6050_RA_I2C_SLV4_CTRL, MPU6050_I2C_SLV4_MST_DLY_BIT, MPU6050_I2C_SLV4_MST_DLY_LENGTH, buffer); + return buffer[0]; +} +/** Set Slave 4 master delay value. + * @param delay New Slave 4 master delay value + * @see getSlave4MasterDelay() + * @see MPU6050_RA_I2C_SLV4_CTRL + */ +void MPU6050::setSlave4MasterDelay(uint8_t delay) { + I2Cdev::writeBits(devAddr, MPU6050_RA_I2C_SLV4_CTRL, MPU6050_I2C_SLV4_MST_DLY_BIT, MPU6050_I2C_SLV4_MST_DLY_LENGTH, delay); +} +/** Get last available byte read from Slave 4. + * This register stores the data read from Slave 4. This field is populated + * after a read transaction. + * @return Last available byte read from to Slave 4 + * @see MPU6050_RA_I2C_SLV4_DI + */ +uint8_t MPU6050::getSlate4InputByte() { + I2Cdev::readByte(devAddr, MPU6050_RA_I2C_SLV4_DI, buffer); + return buffer[0]; +} + +// I2C_MST_STATUS register + +/** Get FSYNC interrupt status. + * This bit reflects the status of the FSYNC interrupt from an external device + * into the MPU-60X0. This is used as a way to pass an external interrupt + * through the MPU-60X0 to the host application processor. When set to 1, this + * bit will cause an interrupt if FSYNC_INT_EN is asserted in INT_PIN_CFG + * (Register 55). + * @return FSYNC interrupt status + * @see MPU6050_RA_I2C_MST_STATUS + */ +bool MPU6050::getPassthroughStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_STATUS, MPU6050_MST_PASS_THROUGH_BIT, buffer); + return buffer[0]; +} +/** Get Slave 4 transaction done status. + * Automatically sets to 1 when a Slave 4 transaction has completed. This + * triggers an interrupt if the I2C_MST_INT_EN bit in the INT_ENABLE register + * (Register 56) is asserted and if the SLV_4_DONE_INT bit is asserted in the + * I2C_SLV4_CTRL register (Register 52). + * @return Slave 4 transaction done status + * @see MPU6050_RA_I2C_MST_STATUS + */ +bool MPU6050::getSlave4IsDone() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_STATUS, MPU6050_MST_I2C_SLV4_DONE_BIT, buffer); + return buffer[0]; +} +/** Get master arbitration lost status. + * This bit automatically sets to 1 when the I2C Master has lost arbitration of + * the auxiliary I2C bus (an error condition). This triggers an interrupt if the + * I2C_MST_INT_EN bit in the INT_ENABLE register (Register 56) is asserted. + * @return Master arbitration lost status + * @see MPU6050_RA_I2C_MST_STATUS + */ +bool MPU6050::getLostArbitration() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_STATUS, MPU6050_MST_I2C_LOST_ARB_BIT, buffer); + return buffer[0]; +} +/** Get Slave 4 NACK status. + * This bit automatically sets to 1 when the I2C Master receives a NACK in a + * transaction with Slave 4. This triggers an interrupt if the I2C_MST_INT_EN + * bit in the INT_ENABLE register (Register 56) is asserted. + * @return Slave 4 NACK interrupt status + * @see MPU6050_RA_I2C_MST_STATUS + */ +bool MPU6050::getSlave4Nack() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_STATUS, MPU6050_MST_I2C_SLV4_NACK_BIT, buffer); + return buffer[0]; +} +/** Get Slave 3 NACK status. + * This bit automatically sets to 1 when the I2C Master receives a NACK in a + * transaction with Slave 3. This triggers an interrupt if the I2C_MST_INT_EN + * bit in the INT_ENABLE register (Register 56) is asserted. + * @return Slave 3 NACK interrupt status + * @see MPU6050_RA_I2C_MST_STATUS + */ +bool MPU6050::getSlave3Nack() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_STATUS, MPU6050_MST_I2C_SLV3_NACK_BIT, buffer); + return buffer[0]; +} +/** Get Slave 2 NACK status. + * This bit automatically sets to 1 when the I2C Master receives a NACK in a + * transaction with Slave 2. This triggers an interrupt if the I2C_MST_INT_EN + * bit in the INT_ENABLE register (Register 56) is asserted. + * @return Slave 2 NACK interrupt status + * @see MPU6050_RA_I2C_MST_STATUS + */ +bool MPU6050::getSlave2Nack() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_STATUS, MPU6050_MST_I2C_SLV2_NACK_BIT, buffer); + return buffer[0]; +} +/** Get Slave 1 NACK status. + * This bit automatically sets to 1 when the I2C Master receives a NACK in a + * transaction with Slave 1. This triggers an interrupt if the I2C_MST_INT_EN + * bit in the INT_ENABLE register (Register 56) is asserted. + * @return Slave 1 NACK interrupt status + * @see MPU6050_RA_I2C_MST_STATUS + */ +bool MPU6050::getSlave1Nack() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_STATUS, MPU6050_MST_I2C_SLV1_NACK_BIT, buffer); + return buffer[0]; +} +/** Get Slave 0 NACK status. + * This bit automatically sets to 1 when the I2C Master receives a NACK in a + * transaction with Slave 0. This triggers an interrupt if the I2C_MST_INT_EN + * bit in the INT_ENABLE register (Register 56) is asserted. + * @return Slave 0 NACK interrupt status + * @see MPU6050_RA_I2C_MST_STATUS + */ +bool MPU6050::getSlave0Nack() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_STATUS, MPU6050_MST_I2C_SLV0_NACK_BIT, buffer); + return buffer[0]; +} + +// INT_PIN_CFG register + +/** Get interrupt logic level mode. + * Will be set 0 for active-high, 1 for active-low. + * @return Current interrupt mode (0=active-high, 1=active-low) + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_INT_LEVEL_BIT + */ +bool MPU6050::getInterruptMode() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_INT_LEVEL_BIT, buffer); + return buffer[0]; +} +/** Set interrupt logic level mode. + * @param mode New interrupt mode (0=active-high, 1=active-low) + * @see getInterruptMode() + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_INT_LEVEL_BIT + */ +void MPU6050::setInterruptMode(bool mode) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_INT_LEVEL_BIT, mode); +} +/** Get interrupt drive mode. + * Will be set 0 for push-pull, 1 for open-drain. + * @return Current interrupt drive mode (0=push-pull, 1=open-drain) + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_INT_OPEN_BIT + */ +bool MPU6050::getInterruptDrive() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_INT_OPEN_BIT, buffer); + return buffer[0]; +} +/** Set interrupt drive mode. + * @param drive New interrupt drive mode (0=push-pull, 1=open-drain) + * @see getInterruptDrive() + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_INT_OPEN_BIT + */ +void MPU6050::setInterruptDrive(bool drive) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_INT_OPEN_BIT, drive); +} +/** Get interrupt latch mode. + * Will be set 0 for 50us-pulse, 1 for latch-until-int-cleared. + * @return Current latch mode (0=50us-pulse, 1=latch-until-int-cleared) + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_LATCH_INT_EN_BIT + */ +bool MPU6050::getInterruptLatch() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_LATCH_INT_EN_BIT, buffer); + return buffer[0]; +} +/** Set interrupt latch mode. + * @param latch New latch mode (0=50us-pulse, 1=latch-until-int-cleared) + * @see getInterruptLatch() + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_LATCH_INT_EN_BIT + */ +void MPU6050::setInterruptLatch(bool latch) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_LATCH_INT_EN_BIT, latch); +} +/** Get interrupt latch clear mode. + * Will be set 0 for status-read-only, 1 for any-register-read. + * @return Current latch clear mode (0=status-read-only, 1=any-register-read) + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_INT_RD_CLEAR_BIT + */ +bool MPU6050::getInterruptLatchClear() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_INT_RD_CLEAR_BIT, buffer); + return buffer[0]; +} +/** Set interrupt latch clear mode. + * @param clear New latch clear mode (0=status-read-only, 1=any-register-read) + * @see getInterruptLatchClear() + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_INT_RD_CLEAR_BIT + */ +void MPU6050::setInterruptLatchClear(bool clear) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_INT_RD_CLEAR_BIT, clear); +} +/** Get FSYNC interrupt logic level mode. + * @return Current FSYNC interrupt mode (0=active-high, 1=active-low) + * @see getFSyncInterruptMode() + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_FSYNC_INT_LEVEL_BIT + */ +bool MPU6050::getFSyncInterruptLevel() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_FSYNC_INT_LEVEL_BIT, buffer); + return buffer[0]; +} +/** Set FSYNC interrupt logic level mode. + * @param mode New FSYNC interrupt mode (0=active-high, 1=active-low) + * @see getFSyncInterruptMode() + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_FSYNC_INT_LEVEL_BIT + */ +void MPU6050::setFSyncInterruptLevel(bool level) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_FSYNC_INT_LEVEL_BIT, level); +} +/** Get FSYNC pin interrupt enabled setting. + * Will be set 0 for disabled, 1 for enabled. + * @return Current interrupt enabled setting + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_FSYNC_INT_EN_BIT + */ +bool MPU6050::getFSyncInterruptEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_FSYNC_INT_EN_BIT, buffer); + return buffer[0]; +} +/** Set FSYNC pin interrupt enabled setting. + * @param enabled New FSYNC pin interrupt enabled setting + * @see getFSyncInterruptEnabled() + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_FSYNC_INT_EN_BIT + */ +void MPU6050::setFSyncInterruptEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_FSYNC_INT_EN_BIT, enabled); +} +/** Get I2C bypass enabled status. + * When this bit is equal to 1 and I2C_MST_EN (Register 106 bit[5]) is equal to + * 0, the host application processor will be able to directly access the + * auxiliary I2C bus of the MPU-60X0. When this bit is equal to 0, the host + * application processor will not be able to directly access the auxiliary I2C + * bus of the MPU-60X0 regardless of the state of I2C_MST_EN (Register 106 + * bit[5]). + * @return Current I2C bypass enabled status + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_I2C_BYPASS_EN_BIT + */ +bool MPU6050::getI2CBypassEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_I2C_BYPASS_EN_BIT, buffer); + return buffer[0]; +} +/** Set I2C bypass enabled status. + * When this bit is equal to 1 and I2C_MST_EN (Register 106 bit[5]) is equal to + * 0, the host application processor will be able to directly access the + * auxiliary I2C bus of the MPU-60X0. When this bit is equal to 0, the host + * application processor will not be able to directly access the auxiliary I2C + * bus of the MPU-60X0 regardless of the state of I2C_MST_EN (Register 106 + * bit[5]). + * @param enabled New I2C bypass enabled status + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_I2C_BYPASS_EN_BIT + */ +void MPU6050::setI2CBypassEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_I2C_BYPASS_EN_BIT, enabled); +} +/** Get reference clock output enabled status. + * When this bit is equal to 1, a reference clock output is provided at the + * CLKOUT pin. When this bit is equal to 0, the clock output is disabled. For + * further information regarding CLKOUT, please refer to the MPU-60X0 Product + * Specification document. + * @return Current reference clock output enabled status + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_CLKOUT_EN_BIT + */ +bool MPU6050::getClockOutputEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_CLKOUT_EN_BIT, buffer); + return buffer[0]; +} +/** Set reference clock output enabled status. + * When this bit is equal to 1, a reference clock output is provided at the + * CLKOUT pin. When this bit is equal to 0, the clock output is disabled. For + * further information regarding CLKOUT, please refer to the MPU-60X0 Product + * Specification document. + * @param enabled New reference clock output enabled status + * @see MPU6050_RA_INT_PIN_CFG + * @see MPU6050_INTCFG_CLKOUT_EN_BIT + */ +void MPU6050::setClockOutputEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_PIN_CFG, MPU6050_INTCFG_CLKOUT_EN_BIT, enabled); +} + +// INT_ENABLE register + +/** Get full interrupt enabled status. + * Full register byte for all interrupts, for quick reading. Each bit will be + * set 0 for disabled, 1 for enabled. + * @return Current interrupt enabled status + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_FF_BIT + **/ +uint8_t MPU6050::getIntEnabled() { + I2Cdev::readByte(devAddr, MPU6050_RA_INT_ENABLE, buffer); + return buffer[0]; +} +/** Set full interrupt enabled status. + * Full register byte for all interrupts, for quick reading. Each bit should be + * set 0 for disabled, 1 for enabled. + * @param enabled New interrupt enabled status + * @see getIntFreefallEnabled() + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_FF_BIT + **/ +void MPU6050::setIntEnabled(uint8_t enabled) { + I2Cdev::writeByte(devAddr, MPU6050_RA_INT_ENABLE, enabled); +} +/** Get Free Fall interrupt enabled status. + * Will be set 0 for disabled, 1 for enabled. + * @return Current interrupt enabled status + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_FF_BIT + **/ +bool MPU6050::getIntFreefallEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_FF_BIT, buffer); + return buffer[0]; +} +/** Set Free Fall interrupt enabled status. + * @param enabled New interrupt enabled status + * @see getIntFreefallEnabled() + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_FF_BIT + **/ +void MPU6050::setIntFreefallEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_FF_BIT, enabled); +} +/** Get Motion Detection interrupt enabled status. + * Will be set 0 for disabled, 1 for enabled. + * @return Current interrupt enabled status + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_MOT_BIT + **/ +bool MPU6050::getIntMotionEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_MOT_BIT, buffer); + return buffer[0]; +} +/** Set Motion Detection interrupt enabled status. + * @param enabled New interrupt enabled status + * @see getIntMotionEnabled() + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_MOT_BIT + **/ +void MPU6050::setIntMotionEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_MOT_BIT, enabled); +} +/** Get Zero Motion Detection interrupt enabled status. + * Will be set 0 for disabled, 1 for enabled. + * @return Current interrupt enabled status + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_ZMOT_BIT + **/ +bool MPU6050::getIntZeroMotionEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_ZMOT_BIT, buffer); + return buffer[0]; +} +/** Set Zero Motion Detection interrupt enabled status. + * @param enabled New interrupt enabled status + * @see getIntZeroMotionEnabled() + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_ZMOT_BIT + **/ +void MPU6050::setIntZeroMotionEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_ZMOT_BIT, enabled); +} +/** Get FIFO Buffer Overflow interrupt enabled status. + * Will be set 0 for disabled, 1 for enabled. + * @return Current interrupt enabled status + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_FIFO_OFLOW_BIT + **/ +bool MPU6050::getIntFIFOBufferOverflowEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_FIFO_OFLOW_BIT, buffer); + return buffer[0]; +} +/** Set FIFO Buffer Overflow interrupt enabled status. + * @param enabled New interrupt enabled status + * @see getIntFIFOBufferOverflowEnabled() + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_FIFO_OFLOW_BIT + **/ +void MPU6050::setIntFIFOBufferOverflowEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_FIFO_OFLOW_BIT, enabled); +} +/** Get I2C Master interrupt enabled status. + * This enables any of the I2C Master interrupt sources to generate an + * interrupt. Will be set 0 for disabled, 1 for enabled. + * @return Current interrupt enabled status + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_I2C_MST_INT_BIT + **/ +bool MPU6050::getIntI2CMasterEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_I2C_MST_INT_BIT, buffer); + return buffer[0]; +} +/** Set I2C Master interrupt enabled status. + * @param enabled New interrupt enabled status + * @see getIntI2CMasterEnabled() + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_I2C_MST_INT_BIT + **/ +void MPU6050::setIntI2CMasterEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_I2C_MST_INT_BIT, enabled); +} +/** Get Data Ready interrupt enabled setting. + * This event occurs each time a write operation to all of the sensor registers + * has been completed. Will be set 0 for disabled, 1 for enabled. + * @return Current interrupt enabled status + * @see MPU6050_RA_INT_ENABLE + * @see MPU6050_INTERRUPT_DATA_RDY_BIT + */ +bool MPU6050::getIntDataReadyEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_DATA_RDY_BIT, buffer); + return buffer[0]; +} +/** Set Data Ready interrupt enabled status. + * @param enabled New interrupt enabled status + * @see getIntDataReadyEnabled() + * @see MPU6050_RA_INT_CFG + * @see MPU6050_INTERRUPT_DATA_RDY_BIT + */ +void MPU6050::setIntDataReadyEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_DATA_RDY_BIT, enabled); +} + +// INT_STATUS register + +/** Get full set of interrupt status bits. + * These bits clear to 0 after the register has been read. Very useful + * for getting multiple INT statuses, since each single bit read clears + * all of them because it has to read the whole byte. + * @return Current interrupt status + * @see MPU6050_RA_INT_STATUS + */ +uint8_t MPU6050::getIntStatus() { + I2Cdev::readByte(devAddr, MPU6050_RA_INT_STATUS, buffer); + return buffer[0]; +} +/** Get Free Fall interrupt status. + * This bit automatically sets to 1 when a Free Fall interrupt has been + * generated. The bit clears to 0 after the register has been read. + * @return Current interrupt status + * @see MPU6050_RA_INT_STATUS + * @see MPU6050_INTERRUPT_FF_BIT + */ +bool MPU6050::getIntFreefallStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_STATUS, MPU6050_INTERRUPT_FF_BIT, buffer); + return buffer[0]; +} +/** Get Motion Detection interrupt status. + * This bit automatically sets to 1 when a Motion Detection interrupt has been + * generated. The bit clears to 0 after the register has been read. + * @return Current interrupt status + * @see MPU6050_RA_INT_STATUS + * @see MPU6050_INTERRUPT_MOT_BIT + */ +bool MPU6050::getIntMotionStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_STATUS, MPU6050_INTERRUPT_MOT_BIT, buffer); + return buffer[0]; +} +/** Get Zero Motion Detection interrupt status. + * This bit automatically sets to 1 when a Zero Motion Detection interrupt has + * been generated. The bit clears to 0 after the register has been read. + * @return Current interrupt status + * @see MPU6050_RA_INT_STATUS + * @see MPU6050_INTERRUPT_ZMOT_BIT + */ +bool MPU6050::getIntZeroMotionStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_STATUS, MPU6050_INTERRUPT_ZMOT_BIT, buffer); + return buffer[0]; +} +/** Get FIFO Buffer Overflow interrupt status. + * This bit automatically sets to 1 when a Free Fall interrupt has been + * generated. The bit clears to 0 after the register has been read. + * @return Current interrupt status + * @see MPU6050_RA_INT_STATUS + * @see MPU6050_INTERRUPT_FIFO_OFLOW_BIT + */ +bool MPU6050::getIntFIFOBufferOverflowStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_STATUS, MPU6050_INTERRUPT_FIFO_OFLOW_BIT, buffer); + return buffer[0]; +} +/** Get I2C Master interrupt status. + * This bit automatically sets to 1 when an I2C Master interrupt has been + * generated. For a list of I2C Master interrupts, please refer to Register 54. + * The bit clears to 0 after the register has been read. + * @return Current interrupt status + * @see MPU6050_RA_INT_STATUS + * @see MPU6050_INTERRUPT_I2C_MST_INT_BIT + */ +bool MPU6050::getIntI2CMasterStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_STATUS, MPU6050_INTERRUPT_I2C_MST_INT_BIT, buffer); + return buffer[0]; +} +/** Get Data Ready interrupt status. + * This bit automatically sets to 1 when a Data Ready interrupt has been + * generated. The bit clears to 0 after the register has been read. + * @return Current interrupt status + * @see MPU6050_RA_INT_STATUS + * @see MPU6050_INTERRUPT_DATA_RDY_BIT + */ +bool MPU6050::getIntDataReadyStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_STATUS, MPU6050_INTERRUPT_DATA_RDY_BIT, buffer); + return buffer[0]; +} + +// ACCEL_*OUT_* registers + +/** Get raw 9-axis motion sensor readings (accel/gyro/compass). + * FUNCTION NOT FULLY IMPLEMENTED YET. + * @param ax 16-bit signed integer container for accelerometer X-axis value + * @param ay 16-bit signed integer container for accelerometer Y-axis value + * @param az 16-bit signed integer container for accelerometer Z-axis value + * @param gx 16-bit signed integer container for gyroscope X-axis value + * @param gy 16-bit signed integer container for gyroscope Y-axis value + * @param gz 16-bit signed integer container for gyroscope Z-axis value + * @param mx 16-bit signed integer container for magnetometer X-axis value + * @param my 16-bit signed integer container for magnetometer Y-axis value + * @param mz 16-bit signed integer container for magnetometer Z-axis value + * @see getMotion6() + * @see getAcceleration() + * @see getRotation() + * @see MPU6050_RA_ACCEL_XOUT_H + */ +void MPU6050::getMotion9(int16_t* ax, int16_t* ay, int16_t* az, int16_t* gx, int16_t* gy, int16_t* gz, int16_t* mx, int16_t* my, int16_t* mz) { + getMotion6(ax, ay, az, gx, gy, gz); + // TODO: magnetometer integration +} +/** Get raw 6-axis motion sensor readings (accel/gyro). + * Retrieves all currently available motion sensor values. + * @param ax 16-bit signed integer container for accelerometer X-axis value + * @param ay 16-bit signed integer container for accelerometer Y-axis value + * @param az 16-bit signed integer container for accelerometer Z-axis value + * @param gx 16-bit signed integer container for gyroscope X-axis value + * @param gy 16-bit signed integer container for gyroscope Y-axis value + * @param gz 16-bit signed integer container for gyroscope Z-axis value + * @see getAcceleration() + * @see getRotation() + * @see MPU6050_RA_ACCEL_XOUT_H + */ +void MPU6050::getMotion6(int16_t* ax, int16_t* ay, int16_t* az, int16_t* gx, int16_t* gy, int16_t* gz) { + I2Cdev::readBytes(devAddr, MPU6050_RA_ACCEL_XOUT_H, 14, buffer); + *ax = (((int16_t)buffer[0]) << 8) | buffer[1]; + *ay = (((int16_t)buffer[2]) << 8) | buffer[3]; + *az = (((int16_t)buffer[4]) << 8) | buffer[5]; + *gx = (((int16_t)buffer[8]) << 8) | buffer[9]; + *gy = (((int16_t)buffer[10]) << 8) | buffer[11]; + *gz = (((int16_t)buffer[12]) << 8) | buffer[13]; +} +/** Get 3-axis accelerometer readings. + * These registers store the most recent accelerometer measurements. + * Accelerometer measurements are written to these registers at the Sample Rate + * as defined in Register 25. + * + * The accelerometer measurement registers, along with the temperature + * measurement registers, gyroscope measurement registers, and external sensor + * data registers, are composed of two sets of registers: an internal register + * set and a user-facing read register set. + * + * The data within the accelerometer sensors' internal register set is always + * updated at the Sample Rate. Meanwhile, the user-facing read register set + * duplicates the internal register set's data values whenever the serial + * interface is idle. This guarantees that a burst read of sensor registers will + * read measurements from the same sampling instant. Note that if burst reads + * are not used, the user is responsible for ensuring a set of single byte reads + * correspond to a single sampling instant by checking the Data Ready interrupt. + * + * Each 16-bit accelerometer measurement has a full scale defined in ACCEL_FS + * (Register 28). For each full scale setting, the accelerometers' sensitivity + * per LSB in ACCEL_xOUT is shown in the table below: + * + *
+ * AFS_SEL | Full Scale Range | LSB Sensitivity
+ * --------+------------------+----------------
+ * 0       | +/- 2g           | 8192 LSB/mg
+ * 1       | +/- 4g           | 4096 LSB/mg
+ * 2       | +/- 8g           | 2048 LSB/mg
+ * 3       | +/- 16g          | 1024 LSB/mg
+ * 
+ * + * @param x 16-bit signed integer container for X-axis acceleration + * @param y 16-bit signed integer container for Y-axis acceleration + * @param z 16-bit signed integer container for Z-axis acceleration + * @see MPU6050_RA_GYRO_XOUT_H + */ +void MPU6050::getAcceleration(int16_t* x, int16_t* y, int16_t* z) { + I2Cdev::readBytes(devAddr, MPU6050_RA_ACCEL_XOUT_H, 6, buffer); + *x = (((int16_t)buffer[0]) << 8) | buffer[1]; + *y = (((int16_t)buffer[2]) << 8) | buffer[3]; + *z = (((int16_t)buffer[4]) << 8) | buffer[5]; +} +/** Get X-axis accelerometer reading. + * @return X-axis acceleration measurement in 16-bit 2's complement format + * @see getMotion6() + * @see MPU6050_RA_ACCEL_XOUT_H + */ +int16_t MPU6050::getAccelerationX() { + I2Cdev::readBytes(devAddr, MPU6050_RA_ACCEL_XOUT_H, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +/** Get Y-axis accelerometer reading. + * @return Y-axis acceleration measurement in 16-bit 2's complement format + * @see getMotion6() + * @see MPU6050_RA_ACCEL_YOUT_H + */ +int16_t MPU6050::getAccelerationY() { + I2Cdev::readBytes(devAddr, MPU6050_RA_ACCEL_YOUT_H, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +/** Get Z-axis accelerometer reading. + * @return Z-axis acceleration measurement in 16-bit 2's complement format + * @see getMotion6() + * @see MPU6050_RA_ACCEL_ZOUT_H + */ +int16_t MPU6050::getAccelerationZ() { + I2Cdev::readBytes(devAddr, MPU6050_RA_ACCEL_ZOUT_H, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} + +// TEMP_OUT_* registers + +/** Get current internal temperature. + * @return Temperature reading in 16-bit 2's complement format + * @see MPU6050_RA_TEMP_OUT_H + */ +int16_t MPU6050::getTemperature() { + I2Cdev::readBytes(devAddr, MPU6050_RA_TEMP_OUT_H, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} + +// GYRO_*OUT_* registers + +/** Get 3-axis gyroscope readings. + * These gyroscope measurement registers, along with the accelerometer + * measurement registers, temperature measurement registers, and external sensor + * data registers, are composed of two sets of registers: an internal register + * set and a user-facing read register set. + * The data within the gyroscope sensors' internal register set is always + * updated at the Sample Rate. Meanwhile, the user-facing read register set + * duplicates the internal register set's data values whenever the serial + * interface is idle. This guarantees that a burst read of sensor registers will + * read measurements from the same sampling instant. Note that if burst reads + * are not used, the user is responsible for ensuring a set of single byte reads + * correspond to a single sampling instant by checking the Data Ready interrupt. + * + * Each 16-bit gyroscope measurement has a full scale defined in FS_SEL + * (Register 27). For each full scale setting, the gyroscopes' sensitivity per + * LSB in GYRO_xOUT is shown in the table below: + * + *
+ * FS_SEL | Full Scale Range   | LSB Sensitivity
+ * -------+--------------------+----------------
+ * 0      | +/- 250 degrees/s  | 131 LSB/deg/s
+ * 1      | +/- 500 degrees/s  | 65.5 LSB/deg/s
+ * 2      | +/- 1000 degrees/s | 32.8 LSB/deg/s
+ * 3      | +/- 2000 degrees/s | 16.4 LSB/deg/s
+ * 
+ * + * @param x 16-bit signed integer container for X-axis rotation + * @param y 16-bit signed integer container for Y-axis rotation + * @param z 16-bit signed integer container for Z-axis rotation + * @see getMotion6() + * @see MPU6050_RA_GYRO_XOUT_H + */ +void MPU6050::getRotation(int16_t* x, int16_t* y, int16_t* z) { + I2Cdev::readBytes(devAddr, MPU6050_RA_GYRO_XOUT_H, 6, buffer); + *x = (((int16_t)buffer[0]) << 8) | buffer[1]; + *y = (((int16_t)buffer[2]) << 8) | buffer[3]; + *z = (((int16_t)buffer[4]) << 8) | buffer[5]; +} +/** Get X-axis gyroscope reading. + * @return X-axis rotation measurement in 16-bit 2's complement format + * @see getMotion6() + * @see MPU6050_RA_GYRO_XOUT_H + */ +int16_t MPU6050::getRotationX() { + I2Cdev::readBytes(devAddr, MPU6050_RA_GYRO_XOUT_H, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +/** Get Y-axis gyroscope reading. + * @return Y-axis rotation measurement in 16-bit 2's complement format + * @see getMotion6() + * @see MPU6050_RA_GYRO_YOUT_H + */ +int16_t MPU6050::getRotationY() { + I2Cdev::readBytes(devAddr, MPU6050_RA_GYRO_YOUT_H, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +/** Get Z-axis gyroscope reading. + * @return Z-axis rotation measurement in 16-bit 2's complement format + * @see getMotion6() + * @see MPU6050_RA_GYRO_ZOUT_H + */ +int16_t MPU6050::getRotationZ() { + I2Cdev::readBytes(devAddr, MPU6050_RA_GYRO_ZOUT_H, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} + +// EXT_SENS_DATA_* registers + +/** Read single byte from external sensor data register. + * These registers store data read from external sensors by the Slave 0, 1, 2, + * and 3 on the auxiliary I2C interface. Data read by Slave 4 is stored in + * I2C_SLV4_DI (Register 53). + * + * External sensor data is written to these registers at the Sample Rate as + * defined in Register 25. This access rate can be reduced by using the Slave + * Delay Enable registers (Register 103). + * + * External sensor data registers, along with the gyroscope measurement + * registers, accelerometer measurement registers, and temperature measurement + * registers, are composed of two sets of registers: an internal register set + * and a user-facing read register set. + * + * The data within the external sensors' internal register set is always updated + * at the Sample Rate (or the reduced access rate) whenever the serial interface + * is idle. This guarantees that a burst read of sensor registers will read + * measurements from the same sampling instant. Note that if burst reads are not + * used, the user is responsible for ensuring a set of single byte reads + * correspond to a single sampling instant by checking the Data Ready interrupt. + * + * Data is placed in these external sensor data registers according to + * I2C_SLV0_CTRL, I2C_SLV1_CTRL, I2C_SLV2_CTRL, and I2C_SLV3_CTRL (Registers 39, + * 42, 45, and 48). When more than zero bytes are read (I2C_SLVx_LEN > 0) from + * an enabled slave (I2C_SLVx_EN = 1), the slave is read at the Sample Rate (as + * defined in Register 25) or delayed rate (if specified in Register 52 and + * 103). During each Sample cycle, slave reads are performed in order of Slave + * number. If all slaves are enabled with more than zero bytes to be read, the + * order will be Slave 0, followed by Slave 1, Slave 2, and Slave 3. + * + * Each enabled slave will have EXT_SENS_DATA registers associated with it by + * number of bytes read (I2C_SLVx_LEN) in order of slave number, starting from + * EXT_SENS_DATA_00. Note that this means enabling or disabling a slave may + * change the higher numbered slaves' associated registers. Furthermore, if + * fewer total bytes are being read from the external sensors as a result of + * such a change, then the data remaining in the registers which no longer have + * an associated slave device (i.e. high numbered registers) will remain in + * these previously allocated registers unless reset. + * + * If the sum of the read lengths of all SLVx transactions exceed the number of + * available EXT_SENS_DATA registers, the excess bytes will be dropped. There + * are 24 EXT_SENS_DATA registers and hence the total read lengths between all + * the slaves cannot be greater than 24 or some bytes will be lost. + * + * Note: Slave 4's behavior is distinct from that of Slaves 0-3. For further + * information regarding the characteristics of Slave 4, please refer to + * Registers 49 to 53. + * + * EXAMPLE: + * Suppose that Slave 0 is enabled with 4 bytes to be read (I2C_SLV0_EN = 1 and + * I2C_SLV0_LEN = 4) while Slave 1 is enabled with 2 bytes to be read so that + * I2C_SLV1_EN = 1 and I2C_SLV1_LEN = 2. In such a situation, EXT_SENS_DATA _00 + * through _03 will be associated with Slave 0, while EXT_SENS_DATA _04 and 05 + * will be associated with Slave 1. If Slave 2 is enabled as well, registers + * starting from EXT_SENS_DATA_06 will be allocated to Slave 2. + * + * If Slave 2 is disabled while Slave 3 is enabled in this same situation, then + * registers starting from EXT_SENS_DATA_06 will be allocated to Slave 3 + * instead. + * + * REGISTER ALLOCATION FOR DYNAMIC DISABLE VS. NORMAL DISABLE: + * If a slave is disabled at any time, the space initially allocated to the + * slave in the EXT_SENS_DATA register, will remain associated with that slave. + * This is to avoid dynamic adjustment of the register allocation. + * + * The allocation of the EXT_SENS_DATA registers is recomputed only when (1) all + * slaves are disabled, or (2) the I2C_MST_RST bit is set (Register 106). + * + * This above is also true if one of the slaves gets NACKed and stops + * functioning. + * + * @param position Starting position (0-23) + * @return Byte read from register + */ +uint8_t MPU6050::getExternalSensorByte(int position) { + I2Cdev::readByte(devAddr, MPU6050_RA_EXT_SENS_DATA_00 + position, buffer); + return buffer[0]; +} +/** Read word (2 bytes) from external sensor data registers. + * @param position Starting position (0-21) + * @return Word read from register + * @see getExternalSensorByte() + */ +uint16_t MPU6050::getExternalSensorWord(int position) { + I2Cdev::readBytes(devAddr, MPU6050_RA_EXT_SENS_DATA_00 + position, 2, buffer); + return (((uint16_t)buffer[0]) << 8) | buffer[1]; +} +/** Read double word (4 bytes) from external sensor data registers. + * @param position Starting position (0-20) + * @return Double word read from registers + * @see getExternalSensorByte() + */ +uint32_t MPU6050::getExternalSensorDWord(int position) { + I2Cdev::readBytes(devAddr, MPU6050_RA_EXT_SENS_DATA_00 + position, 4, buffer); + return (((uint32_t)buffer[0]) << 24) | (((uint32_t)buffer[1]) << 16) | (((uint16_t)buffer[2]) << 8) | buffer[3]; +} + +// MOT_DETECT_STATUS register + +/** Get full motion detection status register content (all bits). + * @return Motion detection status byte + * @see MPU6050_RA_MOT_DETECT_STATUS + */ +uint8_t MPU6050::getMotionStatus() { + I2Cdev::readByte(devAddr, MPU6050_RA_MOT_DETECT_STATUS, buffer); + return buffer[0]; +} +/** Get X-axis negative motion detection interrupt status. + * @return Motion detection status + * @see MPU6050_RA_MOT_DETECT_STATUS + * @see MPU6050_MOTION_MOT_XNEG_BIT + */ +bool MPU6050::getXNegMotionDetected() { + I2Cdev::readBit(devAddr, MPU6050_RA_MOT_DETECT_STATUS, MPU6050_MOTION_MOT_XNEG_BIT, buffer); + return buffer[0]; +} +/** Get X-axis positive motion detection interrupt status. + * @return Motion detection status + * @see MPU6050_RA_MOT_DETECT_STATUS + * @see MPU6050_MOTION_MOT_XPOS_BIT + */ +bool MPU6050::getXPosMotionDetected() { + I2Cdev::readBit(devAddr, MPU6050_RA_MOT_DETECT_STATUS, MPU6050_MOTION_MOT_XPOS_BIT, buffer); + return buffer[0]; +} +/** Get Y-axis negative motion detection interrupt status. + * @return Motion detection status + * @see MPU6050_RA_MOT_DETECT_STATUS + * @see MPU6050_MOTION_MOT_YNEG_BIT + */ +bool MPU6050::getYNegMotionDetected() { + I2Cdev::readBit(devAddr, MPU6050_RA_MOT_DETECT_STATUS, MPU6050_MOTION_MOT_YNEG_BIT, buffer); + return buffer[0]; +} +/** Get Y-axis positive motion detection interrupt status. + * @return Motion detection status + * @see MPU6050_RA_MOT_DETECT_STATUS + * @see MPU6050_MOTION_MOT_YPOS_BIT + */ +bool MPU6050::getYPosMotionDetected() { + I2Cdev::readBit(devAddr, MPU6050_RA_MOT_DETECT_STATUS, MPU6050_MOTION_MOT_YPOS_BIT, buffer); + return buffer[0]; +} +/** Get Z-axis negative motion detection interrupt status. + * @return Motion detection status + * @see MPU6050_RA_MOT_DETECT_STATUS + * @see MPU6050_MOTION_MOT_ZNEG_BIT + */ +bool MPU6050::getZNegMotionDetected() { + I2Cdev::readBit(devAddr, MPU6050_RA_MOT_DETECT_STATUS, MPU6050_MOTION_MOT_ZNEG_BIT, buffer); + return buffer[0]; +} +/** Get Z-axis positive motion detection interrupt status. + * @return Motion detection status + * @see MPU6050_RA_MOT_DETECT_STATUS + * @see MPU6050_MOTION_MOT_ZPOS_BIT + */ +bool MPU6050::getZPosMotionDetected() { + I2Cdev::readBit(devAddr, MPU6050_RA_MOT_DETECT_STATUS, MPU6050_MOTION_MOT_ZPOS_BIT, buffer); + return buffer[0]; +} +/** Get zero motion detection interrupt status. + * @return Motion detection status + * @see MPU6050_RA_MOT_DETECT_STATUS + * @see MPU6050_MOTION_MOT_ZRMOT_BIT + */ +bool MPU6050::getZeroMotionDetected() { + I2Cdev::readBit(devAddr, MPU6050_RA_MOT_DETECT_STATUS, MPU6050_MOTION_MOT_ZRMOT_BIT, buffer); + return buffer[0]; +} + +// I2C_SLV*_DO register + +/** Write byte to Data Output container for specified slave. + * This register holds the output data written into Slave when Slave is set to + * write mode. For further information regarding Slave control, please + * refer to Registers 37 to 39 and immediately following. + * @param num Slave number (0-3) + * @param data Byte to write + * @see MPU6050_RA_I2C_SLV0_DO + */ +void MPU6050::setSlaveOutputByte(uint8_t num, uint8_t data) { + if (num > 3) return; + I2Cdev::writeByte(devAddr, MPU6050_RA_I2C_SLV0_DO + num, data); +} + +// I2C_MST_DELAY_CTRL register + +/** Get external data shadow delay enabled status. + * This register is used to specify the timing of external sensor data + * shadowing. When DELAY_ES_SHADOW is set to 1, shadowing of external + * sensor data is delayed until all data has been received. + * @return Current external data shadow delay enabled status. + * @see MPU6050_RA_I2C_MST_DELAY_CTRL + * @see MPU6050_DELAYCTRL_DELAY_ES_SHADOW_BIT + */ +bool MPU6050::getExternalShadowDelayEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_DELAY_CTRL, MPU6050_DELAYCTRL_DELAY_ES_SHADOW_BIT, buffer); + return buffer[0]; +} +/** Set external data shadow delay enabled status. + * @param enabled New external data shadow delay enabled status. + * @see getExternalShadowDelayEnabled() + * @see MPU6050_RA_I2C_MST_DELAY_CTRL + * @see MPU6050_DELAYCTRL_DELAY_ES_SHADOW_BIT + */ +void MPU6050::setExternalShadowDelayEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_MST_DELAY_CTRL, MPU6050_DELAYCTRL_DELAY_ES_SHADOW_BIT, enabled); +} +/** Get slave delay enabled status. + * When a particular slave delay is enabled, the rate of access for the that + * slave device is reduced. When a slave's access rate is decreased relative to + * the Sample Rate, the slave is accessed every: + * + * 1 / (1 + I2C_MST_DLY) Samples + * + * This base Sample Rate in turn is determined by SMPLRT_DIV (register * 25) + * and DLPF_CFG (register 26). + * + * For further information regarding I2C_MST_DLY, please refer to register 52. + * For further information regarding the Sample Rate, please refer to register 25. + * + * @param num Slave number (0-4) + * @return Current slave delay enabled status. + * @see MPU6050_RA_I2C_MST_DELAY_CTRL + * @see MPU6050_DELAYCTRL_I2C_SLV0_DLY_EN_BIT + */ +bool MPU6050::getSlaveDelayEnabled(uint8_t num) { + // MPU6050_DELAYCTRL_I2C_SLV4_DLY_EN_BIT is 4, SLV3 is 3, etc. + if (num > 4) return 0; + I2Cdev::readBit(devAddr, MPU6050_RA_I2C_MST_DELAY_CTRL, num, buffer); + return buffer[0]; +} +/** Set slave delay enabled status. + * @param num Slave number (0-4) + * @param enabled New slave delay enabled status. + * @see MPU6050_RA_I2C_MST_DELAY_CTRL + * @see MPU6050_DELAYCTRL_I2C_SLV0_DLY_EN_BIT + */ +void MPU6050::setSlaveDelayEnabled(uint8_t num, bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_I2C_MST_DELAY_CTRL, num, enabled); +} + +// SIGNAL_PATH_RESET register + +/** Reset gyroscope signal path. + * The reset will revert the signal path analog to digital converters and + * filters to their power up configurations. + * @see MPU6050_RA_SIGNAL_PATH_RESET + * @see MPU6050_PATHRESET_GYRO_RESET_BIT + */ +void MPU6050::resetGyroscopePath() { + I2Cdev::writeBit(devAddr, MPU6050_RA_SIGNAL_PATH_RESET, MPU6050_PATHRESET_GYRO_RESET_BIT, true); +} +/** Reset accelerometer signal path. + * The reset will revert the signal path analog to digital converters and + * filters to their power up configurations. + * @see MPU6050_RA_SIGNAL_PATH_RESET + * @see MPU6050_PATHRESET_ACCEL_RESET_BIT + */ +void MPU6050::resetAccelerometerPath() { + I2Cdev::writeBit(devAddr, MPU6050_RA_SIGNAL_PATH_RESET, MPU6050_PATHRESET_ACCEL_RESET_BIT, true); +} +/** Reset temperature sensor signal path. + * The reset will revert the signal path analog to digital converters and + * filters to their power up configurations. + * @see MPU6050_RA_SIGNAL_PATH_RESET + * @see MPU6050_PATHRESET_TEMP_RESET_BIT + */ +void MPU6050::resetTemperaturePath() { + I2Cdev::writeBit(devAddr, MPU6050_RA_SIGNAL_PATH_RESET, MPU6050_PATHRESET_TEMP_RESET_BIT, true); +} + +// MOT_DETECT_CTRL register + +/** Get accelerometer power-on delay. + * The accelerometer data path provides samples to the sensor registers, Motion + * detection, Zero Motion detection, and Free Fall detection modules. The + * signal path contains filters which must be flushed on wake-up with new + * samples before the detection modules begin operations. The default wake-up + * delay, of 4ms can be lengthened by up to 3ms. This additional delay is + * specified in ACCEL_ON_DELAY in units of 1 LSB = 1 ms. The user may select + * any value above zero unless instructed otherwise by InvenSense. Please refer + * to Section 8 of the MPU-6000/MPU-6050 Product Specification document for + * further information regarding the detection modules. + * @return Current accelerometer power-on delay + * @see MPU6050_RA_MOT_DETECT_CTRL + * @see MPU6050_DETECT_ACCEL_ON_DELAY_BIT + */ +uint8_t MPU6050::getAccelerometerPowerOnDelay() { + I2Cdev::readBits(devAddr, MPU6050_RA_MOT_DETECT_CTRL, MPU6050_DETECT_ACCEL_ON_DELAY_BIT, MPU6050_DETECT_ACCEL_ON_DELAY_LENGTH, buffer); + return buffer[0]; +} +/** Set accelerometer power-on delay. + * @param delay New accelerometer power-on delay (0-3) + * @see getAccelerometerPowerOnDelay() + * @see MPU6050_RA_MOT_DETECT_CTRL + * @see MPU6050_DETECT_ACCEL_ON_DELAY_BIT + */ +void MPU6050::setAccelerometerPowerOnDelay(uint8_t delay) { + I2Cdev::writeBits(devAddr, MPU6050_RA_MOT_DETECT_CTRL, MPU6050_DETECT_ACCEL_ON_DELAY_BIT, MPU6050_DETECT_ACCEL_ON_DELAY_LENGTH, delay); +} +/** Get Free Fall detection counter decrement configuration. + * Detection is registered by the Free Fall detection module after accelerometer + * measurements meet their respective threshold conditions over a specified + * number of samples. When the threshold conditions are met, the corresponding + * detection counter increments by 1. The user may control the rate at which the + * detection counter decrements when the threshold condition is not met by + * configuring FF_COUNT. The decrement rate can be set according to the + * following table: + * + *
+ * FF_COUNT | Counter Decrement
+ * ---------+------------------
+ * 0        | Reset
+ * 1        | 1
+ * 2        | 2
+ * 3        | 4
+ * 
+ * + * When FF_COUNT is configured to 0 (reset), any non-qualifying sample will + * reset the counter to 0. For further information on Free Fall detection, + * please refer to Registers 29 to 32. + * + * @return Current decrement configuration + * @see MPU6050_RA_MOT_DETECT_CTRL + * @see MPU6050_DETECT_FF_COUNT_BIT + */ +uint8_t MPU6050::getFreefallDetectionCounterDecrement() { + I2Cdev::readBits(devAddr, MPU6050_RA_MOT_DETECT_CTRL, MPU6050_DETECT_FF_COUNT_BIT, MPU6050_DETECT_FF_COUNT_LENGTH, buffer); + return buffer[0]; +} +/** Set Free Fall detection counter decrement configuration. + * @param decrement New decrement configuration value + * @see getFreefallDetectionCounterDecrement() + * @see MPU6050_RA_MOT_DETECT_CTRL + * @see MPU6050_DETECT_FF_COUNT_BIT + */ +void MPU6050::setFreefallDetectionCounterDecrement(uint8_t decrement) { + I2Cdev::writeBits(devAddr, MPU6050_RA_MOT_DETECT_CTRL, MPU6050_DETECT_FF_COUNT_BIT, MPU6050_DETECT_FF_COUNT_LENGTH, decrement); +} +/** Get Motion detection counter decrement configuration. + * Detection is registered by the Motion detection module after accelerometer + * measurements meet their respective threshold conditions over a specified + * number of samples. When the threshold conditions are met, the corresponding + * detection counter increments by 1. The user may control the rate at which the + * detection counter decrements when the threshold condition is not met by + * configuring MOT_COUNT. The decrement rate can be set according to the + * following table: + * + *
+ * MOT_COUNT | Counter Decrement
+ * ----------+------------------
+ * 0         | Reset
+ * 1         | 1
+ * 2         | 2
+ * 3         | 4
+ * 
+ * + * When MOT_COUNT is configured to 0 (reset), any non-qualifying sample will + * reset the counter to 0. For further information on Motion detection, + * please refer to Registers 29 to 32. + * + */ +uint8_t MPU6050::getMotionDetectionCounterDecrement() { + I2Cdev::readBits(devAddr, MPU6050_RA_MOT_DETECT_CTRL, MPU6050_DETECT_MOT_COUNT_BIT, MPU6050_DETECT_MOT_COUNT_LENGTH, buffer); + return buffer[0]; +} +/** Set Motion detection counter decrement configuration. + * @param decrement New decrement configuration value + * @see getMotionDetectionCounterDecrement() + * @see MPU6050_RA_MOT_DETECT_CTRL + * @see MPU6050_DETECT_MOT_COUNT_BIT + */ +void MPU6050::setMotionDetectionCounterDecrement(uint8_t decrement) { + I2Cdev::writeBits(devAddr, MPU6050_RA_MOT_DETECT_CTRL, MPU6050_DETECT_MOT_COUNT_BIT, MPU6050_DETECT_MOT_COUNT_LENGTH, decrement); +} + +// USER_CTRL register + +/** Get FIFO enabled status. + * When this bit is set to 0, the FIFO buffer is disabled. The FIFO buffer + * cannot be written to or read from while disabled. The FIFO buffer's state + * does not change unless the MPU-60X0 is power cycled. + * @return Current FIFO enabled status + * @see MPU6050_RA_USER_CTRL + * @see MPU6050_USERCTRL_FIFO_EN_BIT + */ +bool MPU6050::getFIFOEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_FIFO_EN_BIT, buffer); + return buffer[0]; +} +/** Set FIFO enabled status. + * @param enabled New FIFO enabled status + * @see getFIFOEnabled() + * @see MPU6050_RA_USER_CTRL + * @see MPU6050_USERCTRL_FIFO_EN_BIT + */ +void MPU6050::setFIFOEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_FIFO_EN_BIT, enabled); +} +/** Get I2C Master Mode enabled status. + * When this mode is enabled, the MPU-60X0 acts as the I2C Master to the + * external sensor slave devices on the auxiliary I2C bus. When this bit is + * cleared to 0, the auxiliary I2C bus lines (AUX_DA and AUX_CL) are logically + * driven by the primary I2C bus (SDA and SCL). This is a precondition to + * enabling Bypass Mode. For further information regarding Bypass Mode, please + * refer to Register 55. + * @return Current I2C Master Mode enabled status + * @see MPU6050_RA_USER_CTRL + * @see MPU6050_USERCTRL_I2C_MST_EN_BIT + */ +bool MPU6050::getI2CMasterModeEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_I2C_MST_EN_BIT, buffer); + return buffer[0]; +} +/** Set I2C Master Mode enabled status. + * @param enabled New I2C Master Mode enabled status + * @see getI2CMasterModeEnabled() + * @see MPU6050_RA_USER_CTRL + * @see MPU6050_USERCTRL_I2C_MST_EN_BIT + */ +void MPU6050::setI2CMasterModeEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_I2C_MST_EN_BIT, enabled); +} +/** Switch from I2C to SPI mode (MPU-6000 only) + * If this is set, the primary SPI interface will be enabled in place of the + * disabled primary I2C interface. + */ +void MPU6050::switchSPIEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_I2C_IF_DIS_BIT, enabled); +} +/** Reset the FIFO. + * This bit resets the FIFO buffer when set to 1 while FIFO_EN equals 0. This + * bit automatically clears to 0 after the reset has been triggered. + * @see MPU6050_RA_USER_CTRL + * @see MPU6050_USERCTRL_FIFO_RESET_BIT + */ +void MPU6050::resetFIFO() { + I2Cdev::writeBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_FIFO_RESET_BIT, true); +} +/** Reset the I2C Master. + * This bit resets the I2C Master when set to 1 while I2C_MST_EN equals 0. + * This bit automatically clears to 0 after the reset has been triggered. + * @see MPU6050_RA_USER_CTRL + * @see MPU6050_USERCTRL_I2C_MST_RESET_BIT + */ +void MPU6050::resetI2CMaster() { + I2Cdev::writeBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_I2C_MST_RESET_BIT, true); +} +/** Reset all sensor registers and signal paths. + * When set to 1, this bit resets the signal paths for all sensors (gyroscopes, + * accelerometers, and temperature sensor). This operation will also clear the + * sensor registers. This bit automatically clears to 0 after the reset has been + * triggered. + * + * When resetting only the signal path (and not the sensor registers), please + * use Register 104, SIGNAL_PATH_RESET. + * + * @see MPU6050_RA_USER_CTRL + * @see MPU6050_USERCTRL_SIG_COND_RESET_BIT + */ +void MPU6050::resetSensors() { + I2Cdev::writeBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_SIG_COND_RESET_BIT, true); +} + +// PWR_MGMT_1 register + +/** Trigger a full device reset. + * A small delay of ~50ms may be desirable after triggering a reset. + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_DEVICE_RESET_BIT + */ +void MPU6050::reset() { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_DEVICE_RESET_BIT, true); +} +/** Get sleep mode status. + * Setting the SLEEP bit in the register puts the device into very low power + * sleep mode. In this mode, only the serial interface and internal registers + * remain active, allowing for a very low standby current. Clearing this bit + * puts the device back into normal mode. To save power, the individual standby + * selections for each of the gyros should be used if any gyro axis is not used + * by the application. + * @return Current sleep mode enabled status + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_SLEEP_BIT + */ +bool MPU6050::getSleepEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_SLEEP_BIT, buffer); + return buffer[0]; +} +/** Set sleep mode status. + * @param enabled New sleep mode enabled status + * @see getSleepEnabled() + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_SLEEP_BIT + */ +void MPU6050::setSleepEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_SLEEP_BIT, enabled); +} +/** Get wake cycle enabled status. + * When this bit is set to 1 and SLEEP is disabled, the MPU-60X0 will cycle + * between sleep mode and waking up to take a single sample of data from active + * sensors at a rate determined by LP_WAKE_CTRL (register 108). + * @return Current sleep mode enabled status + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_CYCLE_BIT + */ +bool MPU6050::getWakeCycleEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_CYCLE_BIT, buffer); + return buffer[0]; +} +/** Set wake cycle enabled status. + * @param enabled New sleep mode enabled status + * @see getWakeCycleEnabled() + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_CYCLE_BIT + */ +void MPU6050::setWakeCycleEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_CYCLE_BIT, enabled); +} +/** Get temperature sensor enabled status. + * Control the usage of the internal temperature sensor. + * + * Note: this register stores the *disabled* value, but for consistency with the + * rest of the code, the function is named and used with standard true/false + * values to indicate whether the sensor is enabled or disabled, respectively. + * + * @return Current temperature sensor enabled status + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_TEMP_DIS_BIT + */ +bool MPU6050::getTempSensorEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_TEMP_DIS_BIT, buffer); + return buffer[0] == 0; // 1 is actually disabled here +} +/** Set temperature sensor enabled status. + * Note: this register stores the *disabled* value, but for consistency with the + * rest of the code, the function is named and used with standard true/false + * values to indicate whether the sensor is enabled or disabled, respectively. + * + * @param enabled New temperature sensor enabled status + * @see getTempSensorEnabled() + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_TEMP_DIS_BIT + */ +void MPU6050::setTempSensorEnabled(bool enabled) { + // 1 is actually disabled here + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_TEMP_DIS_BIT, !enabled); +} +/** Get clock source setting. + * @return Current clock source setting + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_CLKSEL_BIT + * @see MPU6050_PWR1_CLKSEL_LENGTH + */ +uint8_t MPU6050::getClockSource() { + I2Cdev::readBits(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_CLKSEL_BIT, MPU6050_PWR1_CLKSEL_LENGTH, buffer); + return buffer[0]; +} +/** Set clock source setting. + * An internal 8MHz oscillator, gyroscope based clock, or external sources can + * be selected as the MPU-60X0 clock source. When the internal 8 MHz oscillator + * or an external source is chosen as the clock source, the MPU-60X0 can operate + * in low power modes with the gyroscopes disabled. + * + * Upon power up, the MPU-60X0 clock source defaults to the internal oscillator. + * However, it is highly recommended that the device be configured to use one of + * the gyroscopes (or an external clock source) as the clock reference for + * improved stability. The clock source can be selected according to the following table: + * + *
+ * CLK_SEL | Clock Source
+ * --------+--------------------------------------
+ * 0       | Internal oscillator
+ * 1       | PLL with X Gyro reference
+ * 2       | PLL with Y Gyro reference
+ * 3       | PLL with Z Gyro reference
+ * 4       | PLL with external 32.768kHz reference
+ * 5       | PLL with external 19.2MHz reference
+ * 6       | Reserved
+ * 7       | Stops the clock and keeps the timing generator in reset
+ * 
+ * + * @param source New clock source setting + * @see getClockSource() + * @see MPU6050_RA_PWR_MGMT_1 + * @see MPU6050_PWR1_CLKSEL_BIT + * @see MPU6050_PWR1_CLKSEL_LENGTH + */ +void MPU6050::setClockSource(uint8_t source) { + I2Cdev::writeBits(devAddr, MPU6050_RA_PWR_MGMT_1, MPU6050_PWR1_CLKSEL_BIT, MPU6050_PWR1_CLKSEL_LENGTH, source); +} + +// PWR_MGMT_2 register + +/** Get wake frequency in Accel-Only Low Power Mode. + * The MPU-60X0 can be put into Accerlerometer Only Low Power Mode by setting + * PWRSEL to 1 in the Power Management 1 register (Register 107). In this mode, + * the device will power off all devices except for the primary I2C interface, + * waking only the accelerometer at fixed intervals to take a single + * measurement. The frequency of wake-ups can be configured with LP_WAKE_CTRL + * as shown below: + * + *
+ * LP_WAKE_CTRL | Wake-up Frequency
+ * -------------+------------------
+ * 0            | 1.25 Hz
+ * 1            | 2.5 Hz
+ * 2            | 5 Hz
+ * 3            | 10 Hz
+ * 
+ * + * For further information regarding the MPU-60X0's power modes, please refer to + * Register 107. + * + * @return Current wake frequency + * @see MPU6050_RA_PWR_MGMT_2 + */ +uint8_t MPU6050::getWakeFrequency() { + I2Cdev::readBits(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_LP_WAKE_CTRL_BIT, MPU6050_PWR2_LP_WAKE_CTRL_LENGTH, buffer); + return buffer[0]; +} +/** Set wake frequency in Accel-Only Low Power Mode. + * @param frequency New wake frequency + * @see MPU6050_RA_PWR_MGMT_2 + */ +void MPU6050::setWakeFrequency(uint8_t frequency) { + I2Cdev::writeBits(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_LP_WAKE_CTRL_BIT, MPU6050_PWR2_LP_WAKE_CTRL_LENGTH, frequency); +} + +/** Get X-axis accelerometer standby enabled status. + * If enabled, the X-axis will not gather or report data (or use power). + * @return Current X-axis standby enabled status + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_XA_BIT + */ +bool MPU6050::getStandbyXAccelEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_XA_BIT, buffer); + return buffer[0]; +} +/** Set X-axis accelerometer standby enabled status. + * @param New X-axis standby enabled status + * @see getStandbyXAccelEnabled() + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_XA_BIT + */ +void MPU6050::setStandbyXAccelEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_XA_BIT, enabled); +} +/** Get Y-axis accelerometer standby enabled status. + * If enabled, the Y-axis will not gather or report data (or use power). + * @return Current Y-axis standby enabled status + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_YA_BIT + */ +bool MPU6050::getStandbyYAccelEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_YA_BIT, buffer); + return buffer[0]; +} +/** Set Y-axis accelerometer standby enabled status. + * @param New Y-axis standby enabled status + * @see getStandbyYAccelEnabled() + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_YA_BIT + */ +void MPU6050::setStandbyYAccelEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_YA_BIT, enabled); +} +/** Get Z-axis accelerometer standby enabled status. + * If enabled, the Z-axis will not gather or report data (or use power). + * @return Current Z-axis standby enabled status + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_ZA_BIT + */ +bool MPU6050::getStandbyZAccelEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_ZA_BIT, buffer); + return buffer[0]; +} +/** Set Z-axis accelerometer standby enabled status. + * @param New Z-axis standby enabled status + * @see getStandbyZAccelEnabled() + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_ZA_BIT + */ +void MPU6050::setStandbyZAccelEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_ZA_BIT, enabled); +} +/** Get X-axis gyroscope standby enabled status. + * If enabled, the X-axis will not gather or report data (or use power). + * @return Current X-axis standby enabled status + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_XG_BIT + */ +bool MPU6050::getStandbyXGyroEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_XG_BIT, buffer); + return buffer[0]; +} +/** Set X-axis gyroscope standby enabled status. + * @param New X-axis standby enabled status + * @see getStandbyXGyroEnabled() + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_XG_BIT + */ +void MPU6050::setStandbyXGyroEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_XG_BIT, enabled); +} +/** Get Y-axis gyroscope standby enabled status. + * If enabled, the Y-axis will not gather or report data (or use power). + * @return Current Y-axis standby enabled status + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_YG_BIT + */ +bool MPU6050::getStandbyYGyroEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_YG_BIT, buffer); + return buffer[0]; +} +/** Set Y-axis gyroscope standby enabled status. + * @param New Y-axis standby enabled status + * @see getStandbyYGyroEnabled() + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_YG_BIT + */ +void MPU6050::setStandbyYGyroEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_YG_BIT, enabled); +} +/** Get Z-axis gyroscope standby enabled status. + * If enabled, the Z-axis will not gather or report data (or use power). + * @return Current Z-axis standby enabled status + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_ZG_BIT + */ +bool MPU6050::getStandbyZGyroEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_ZG_BIT, buffer); + return buffer[0]; +} +/** Set Z-axis gyroscope standby enabled status. + * @param New Z-axis standby enabled status + * @see getStandbyZGyroEnabled() + * @see MPU6050_RA_PWR_MGMT_2 + * @see MPU6050_PWR2_STBY_ZG_BIT + */ +void MPU6050::setStandbyZGyroEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_PWR_MGMT_2, MPU6050_PWR2_STBY_ZG_BIT, enabled); +} + +// FIFO_COUNT* registers + +/** Get current FIFO buffer size. + * This value indicates the number of bytes stored in the FIFO buffer. This + * number is in turn the number of bytes that can be read from the FIFO buffer + * and it is directly proportional to the number of samples available given the + * set of sensor data bound to be stored in the FIFO (register 35 and 36). + * @return Current FIFO buffer size + */ +uint16_t MPU6050::getFIFOCount() { + I2Cdev::readBytes(devAddr, MPU6050_RA_FIFO_COUNTH, 2, buffer); + return (((uint16_t)buffer[0]) << 8) | buffer[1]; +} + +// FIFO_R_W register + +/** Get byte from FIFO buffer. + * This register is used to read and write data from the FIFO buffer. Data is + * written to the FIFO in order of register number (from lowest to highest). If + * all the FIFO enable flags (see below) are enabled and all External Sensor + * Data registers (Registers 73 to 96) are associated with a Slave device, the + * contents of registers 59 through 96 will be written in order at the Sample + * Rate. + * + * The contents of the sensor data registers (Registers 59 to 96) are written + * into the FIFO buffer when their corresponding FIFO enable flags are set to 1 + * in FIFO_EN (Register 35). An additional flag for the sensor data registers + * associated with I2C Slave 3 can be found in I2C_MST_CTRL (Register 36). + * + * If the FIFO buffer has overflowed, the status bit FIFO_OFLOW_INT is + * automatically set to 1. This bit is located in INT_STATUS (Register 58). + * When the FIFO buffer has overflowed, the oldest data will be lost and new + * data will be written to the FIFO. + * + * If the FIFO buffer is empty, reading this register will return the last byte + * that was previously read from the FIFO until new data is available. The user + * should check FIFO_COUNT to ensure that the FIFO buffer is not read when + * empty. + * + * @return Byte from FIFO buffer + */ +uint8_t MPU6050::getFIFOByte() { + I2Cdev::readByte(devAddr, MPU6050_RA_FIFO_R_W, buffer); + return buffer[0]; +} +void MPU6050::getFIFOBytes(uint8_t *data, uint8_t length) { + if(length > 0){ + I2Cdev::readBytes(devAddr, MPU6050_RA_FIFO_R_W, length, data); + } else { + *data = 0; + } +} + +/** Get latest byte from FIFO buffer no matter how much time has passed. + * === GetCurrentFIFOPacket === + * ================================================================ + * Returns 1) when nothing special was done + * 2) when recovering from overflow + * 0) when no valid data is available + * ================================================================ */ + int8_t MPU6050::GetCurrentFIFOPacket(uint8_t *data, uint8_t length) { // overflow proof + int16_t fifoC; + // This section of code is for when we allowed more than 1 packet to be acquired + uint32_t BreakTimer = micros(); + do { + if ((fifoC = getFIFOCount()) > length) { + + if (fifoC > 200) { // if you waited to get the FIFO buffer to > 200 bytes it will take longer to get the last packet in the FIFO Buffer than it will take to reset the buffer and wait for the next to arrive + resetFIFO(); // Fixes any overflow corruption + fifoC = 0; + while (!(fifoC = getFIFOCount()) && ((micros() - BreakTimer) <= (11000))); // Get Next New Packet + } else { //We have more than 1 packet but less than 200 bytes of data in the FIFO Buffer + uint8_t Trash[BUFFER_LENGTH]; + while ((fifoC = getFIFOCount()) > length) { // Test each time just in case the MPU is writing to the FIFO Buffer + fifoC = fifoC - length; // Save the last packet + uint16_t RemoveBytes; + while (fifoC) { // fifo count will reach zero so this is safe + RemoveBytes = min((int)fifoC, BUFFER_LENGTH); // Buffer Length is different than the packet length this will efficiently clear the buffer + getFIFOBytes(Trash, (uint8_t)RemoveBytes); + fifoC -= RemoveBytes; + } + } + } + } + if (!fifoC) return 0; // Called too early no data or we timed out after FIFO Reset + // We have 1 packet + if ((micros() - BreakTimer) > (11000)) return 0; + } while (fifoC != length); + getFIFOBytes(data, length); //Get 1 packet + return 1; +} + + +/** Write byte to FIFO buffer. + * @see getFIFOByte() + * @see MPU6050_RA_FIFO_R_W + */ +void MPU6050::setFIFOByte(uint8_t data) { + I2Cdev::writeByte(devAddr, MPU6050_RA_FIFO_R_W, data); +} + +// WHO_AM_I register + +/** Get Device ID. + * This register is used to verify the identity of the device (0b110100, 0x34). + * @return Device ID (6 bits only! should be 0x34) + * @see MPU6050_RA_WHO_AM_I + * @see MPU6050_WHO_AM_I_BIT + * @see MPU6050_WHO_AM_I_LENGTH + */ +uint8_t MPU6050::getDeviceID() { + I2Cdev::readBits(devAddr, MPU6050_RA_WHO_AM_I, MPU6050_WHO_AM_I_BIT, MPU6050_WHO_AM_I_LENGTH, buffer); + return buffer[0]; +} +/** Set Device ID. + * Write a new ID into the WHO_AM_I register (no idea why this should ever be + * necessary though). + * @param id New device ID to set. + * @see getDeviceID() + * @see MPU6050_RA_WHO_AM_I + * @see MPU6050_WHO_AM_I_BIT + * @see MPU6050_WHO_AM_I_LENGTH + */ +void MPU6050::setDeviceID(uint8_t id) { + I2Cdev::writeBits(devAddr, MPU6050_RA_WHO_AM_I, MPU6050_WHO_AM_I_BIT, MPU6050_WHO_AM_I_LENGTH, id); +} + +// ======== UNDOCUMENTED/DMP REGISTERS/METHODS ======== + +// XG_OFFS_TC register + +uint8_t MPU6050::getOTPBankValid() { + I2Cdev::readBit(devAddr, MPU6050_RA_XG_OFFS_TC, MPU6050_TC_OTP_BNK_VLD_BIT, buffer); + return buffer[0]; +} +void MPU6050::setOTPBankValid(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_XG_OFFS_TC, MPU6050_TC_OTP_BNK_VLD_BIT, enabled); +} +int8_t MPU6050::getXGyroOffsetTC() { + I2Cdev::readBits(devAddr, MPU6050_RA_XG_OFFS_TC, MPU6050_TC_OFFSET_BIT, MPU6050_TC_OFFSET_LENGTH, buffer); + return buffer[0]; +} +void MPU6050::setXGyroOffsetTC(int8_t offset) { + I2Cdev::writeBits(devAddr, MPU6050_RA_XG_OFFS_TC, MPU6050_TC_OFFSET_BIT, MPU6050_TC_OFFSET_LENGTH, offset); +} + +// YG_OFFS_TC register + +int8_t MPU6050::getYGyroOffsetTC() { + I2Cdev::readBits(devAddr, MPU6050_RA_YG_OFFS_TC, MPU6050_TC_OFFSET_BIT, MPU6050_TC_OFFSET_LENGTH, buffer); + return buffer[0]; +} +void MPU6050::setYGyroOffsetTC(int8_t offset) { + I2Cdev::writeBits(devAddr, MPU6050_RA_YG_OFFS_TC, MPU6050_TC_OFFSET_BIT, MPU6050_TC_OFFSET_LENGTH, offset); +} + +// ZG_OFFS_TC register + +int8_t MPU6050::getZGyroOffsetTC() { + I2Cdev::readBits(devAddr, MPU6050_RA_ZG_OFFS_TC, MPU6050_TC_OFFSET_BIT, MPU6050_TC_OFFSET_LENGTH, buffer); + return buffer[0]; +} +void MPU6050::setZGyroOffsetTC(int8_t offset) { + I2Cdev::writeBits(devAddr, MPU6050_RA_ZG_OFFS_TC, MPU6050_TC_OFFSET_BIT, MPU6050_TC_OFFSET_LENGTH, offset); +} + +// X_FINE_GAIN register + +int8_t MPU6050::getXFineGain() { + I2Cdev::readByte(devAddr, MPU6050_RA_X_FINE_GAIN, buffer); + return buffer[0]; +} +void MPU6050::setXFineGain(int8_t gain) { + I2Cdev::writeByte(devAddr, MPU6050_RA_X_FINE_GAIN, gain); +} + +// Y_FINE_GAIN register + +int8_t MPU6050::getYFineGain() { + I2Cdev::readByte(devAddr, MPU6050_RA_Y_FINE_GAIN, buffer); + return buffer[0]; +} +void MPU6050::setYFineGain(int8_t gain) { + I2Cdev::writeByte(devAddr, MPU6050_RA_Y_FINE_GAIN, gain); +} + +// Z_FINE_GAIN register + +int8_t MPU6050::getZFineGain() { + I2Cdev::readByte(devAddr, MPU6050_RA_Z_FINE_GAIN, buffer); + return buffer[0]; +} +void MPU6050::setZFineGain(int8_t gain) { + I2Cdev::writeByte(devAddr, MPU6050_RA_Z_FINE_GAIN, gain); +} + +// XA_OFFS_* registers + +int16_t MPU6050::getXAccelOffset() { + uint8_t SaveAddress = ((getDeviceID() < 0x38 )? MPU6050_RA_XA_OFFS_H:0x77); // MPU6050,MPU9150 Vs MPU6500,MPU9250 + I2Cdev::readBytes(devAddr, SaveAddress, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +void MPU6050::setXAccelOffset(int16_t offset) { + uint8_t SaveAddress = ((getDeviceID() < 0x38 )? MPU6050_RA_XA_OFFS_H:0x77); // MPU6050,MPU9150 Vs MPU6500,MPU9250 + I2Cdev::writeWord(devAddr, SaveAddress, offset); +} + +// YA_OFFS_* register + +int16_t MPU6050::getYAccelOffset() { + uint8_t SaveAddress = ((getDeviceID() < 0x38 )? MPU6050_RA_YA_OFFS_H:0x7A); // MPU6050,MPU9150 Vs MPU6500,MPU9250 + I2Cdev::readBytes(devAddr, SaveAddress, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +void MPU6050::setYAccelOffset(int16_t offset) { + uint8_t SaveAddress = ((getDeviceID() < 0x38 )? MPU6050_RA_YA_OFFS_H:0x7A); // MPU6050,MPU9150 Vs MPU6500,MPU9250 + I2Cdev::writeWord(devAddr, SaveAddress, offset); +} + +// ZA_OFFS_* register + +int16_t MPU6050::getZAccelOffset() { + uint8_t SaveAddress = ((getDeviceID() < 0x38 )? MPU6050_RA_ZA_OFFS_H:0x7D); // MPU6050,MPU9150 Vs MPU6500,MPU9250 + I2Cdev::readBytes(devAddr, SaveAddress, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +void MPU6050::setZAccelOffset(int16_t offset) { + uint8_t SaveAddress = ((getDeviceID() < 0x38 )? MPU6050_RA_ZA_OFFS_H:0x7D); // MPU6050,MPU9150 Vs MPU6500,MPU9250 + I2Cdev::writeWord(devAddr, SaveAddress, offset); +} + +// XG_OFFS_USR* registers + +int16_t MPU6050::getXGyroOffset() { + I2Cdev::readBytes(devAddr, MPU6050_RA_XG_OFFS_USRH, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +void MPU6050::setXGyroOffset(int16_t offset) { + I2Cdev::writeWord(devAddr, MPU6050_RA_XG_OFFS_USRH, offset); +} + +// YG_OFFS_USR* register + +int16_t MPU6050::getYGyroOffset() { + I2Cdev::readBytes(devAddr, MPU6050_RA_YG_OFFS_USRH, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +void MPU6050::setYGyroOffset(int16_t offset) { + I2Cdev::writeWord(devAddr, MPU6050_RA_YG_OFFS_USRH, offset); +} + +// ZG_OFFS_USR* register + +int16_t MPU6050::getZGyroOffset() { + I2Cdev::readBytes(devAddr, MPU6050_RA_ZG_OFFS_USRH, 2, buffer); + return (((int16_t)buffer[0]) << 8) | buffer[1]; +} +void MPU6050::setZGyroOffset(int16_t offset) { + I2Cdev::writeWord(devAddr, MPU6050_RA_ZG_OFFS_USRH, offset); +} + +// INT_ENABLE register (DMP functions) + +bool MPU6050::getIntPLLReadyEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_PLL_RDY_INT_BIT, buffer); + return buffer[0]; +} +void MPU6050::setIntPLLReadyEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_PLL_RDY_INT_BIT, enabled); +} +bool MPU6050::getIntDMPEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_DMP_INT_BIT, buffer); + return buffer[0]; +} +void MPU6050::setIntDMPEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_INT_ENABLE, MPU6050_INTERRUPT_DMP_INT_BIT, enabled); +} + +// DMP_INT_STATUS + +bool MPU6050::getDMPInt5Status() { + I2Cdev::readBit(devAddr, MPU6050_RA_DMP_INT_STATUS, MPU6050_DMPINT_5_BIT, buffer); + return buffer[0]; +} +bool MPU6050::getDMPInt4Status() { + I2Cdev::readBit(devAddr, MPU6050_RA_DMP_INT_STATUS, MPU6050_DMPINT_4_BIT, buffer); + return buffer[0]; +} +bool MPU6050::getDMPInt3Status() { + I2Cdev::readBit(devAddr, MPU6050_RA_DMP_INT_STATUS, MPU6050_DMPINT_3_BIT, buffer); + return buffer[0]; +} +bool MPU6050::getDMPInt2Status() { + I2Cdev::readBit(devAddr, MPU6050_RA_DMP_INT_STATUS, MPU6050_DMPINT_2_BIT, buffer); + return buffer[0]; +} +bool MPU6050::getDMPInt1Status() { + I2Cdev::readBit(devAddr, MPU6050_RA_DMP_INT_STATUS, MPU6050_DMPINT_1_BIT, buffer); + return buffer[0]; +} +bool MPU6050::getDMPInt0Status() { + I2Cdev::readBit(devAddr, MPU6050_RA_DMP_INT_STATUS, MPU6050_DMPINT_0_BIT, buffer); + return buffer[0]; +} + +// INT_STATUS register (DMP functions) + +bool MPU6050::getIntPLLReadyStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_STATUS, MPU6050_INTERRUPT_PLL_RDY_INT_BIT, buffer); + return buffer[0]; +} +bool MPU6050::getIntDMPStatus() { + I2Cdev::readBit(devAddr, MPU6050_RA_INT_STATUS, MPU6050_INTERRUPT_DMP_INT_BIT, buffer); + return buffer[0]; +} + +// USER_CTRL register (DMP functions) + +bool MPU6050::getDMPEnabled() { + I2Cdev::readBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_DMP_EN_BIT, buffer); + return buffer[0]; +} +void MPU6050::setDMPEnabled(bool enabled) { + I2Cdev::writeBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_DMP_EN_BIT, enabled); +} +void MPU6050::resetDMP() { + I2Cdev::writeBit(devAddr, MPU6050_RA_USER_CTRL, MPU6050_USERCTRL_DMP_RESET_BIT, true); +} + +// BANK_SEL register + +void MPU6050::setMemoryBank(uint8_t bank, bool prefetchEnabled, bool userBank) { + bank &= 0x1F; + if (userBank) bank |= 0x20; + if (prefetchEnabled) bank |= 0x40; + I2Cdev::writeByte(devAddr, MPU6050_RA_BANK_SEL, bank); +} + +// MEM_START_ADDR register + +void MPU6050::setMemoryStartAddress(uint8_t address) { + I2Cdev::writeByte(devAddr, MPU6050_RA_MEM_START_ADDR, address); +} + +// MEM_R_W register + +uint8_t MPU6050::readMemoryByte() { + I2Cdev::readByte(devAddr, MPU6050_RA_MEM_R_W, buffer); + return buffer[0]; +} +void MPU6050::writeMemoryByte(uint8_t data) { + I2Cdev::writeByte(devAddr, MPU6050_RA_MEM_R_W, data); +} +void MPU6050::readMemoryBlock(uint8_t *data, uint16_t dataSize, uint8_t bank, uint8_t address) { + setMemoryBank(bank); + setMemoryStartAddress(address); + uint8_t chunkSize; + for (uint16_t i = 0; i < dataSize;) { + // determine correct chunk size according to bank position and data size + chunkSize = MPU6050_DMP_MEMORY_CHUNK_SIZE; + + // make sure we don't go past the data size + if (i + chunkSize > dataSize) chunkSize = dataSize - i; + + // make sure this chunk doesn't go past the bank boundary (256 bytes) + if (chunkSize > 256 - address) chunkSize = 256 - address; + + // read the chunk of data as specified + I2Cdev::readBytes(devAddr, MPU6050_RA_MEM_R_W, chunkSize, data + i); + + // increase byte index by [chunkSize] + i += chunkSize; + + // uint8_t automatically wraps to 0 at 256 + address += chunkSize; + + // if we aren't done, update bank (if necessary) and address + if (i < dataSize) { + if (address == 0) bank++; + setMemoryBank(bank); + setMemoryStartAddress(address); + } + } +} +bool MPU6050::writeMemoryBlock(const uint8_t *data, uint16_t dataSize, uint8_t bank, uint8_t address, bool verify, bool useProgMem) { + setMemoryBank(bank); + setMemoryStartAddress(address); + uint8_t chunkSize; + uint8_t *verifyBuffer=0; + uint8_t *progBuffer=0; + uint16_t i; + uint8_t j; + if (verify) verifyBuffer = (uint8_t *)malloc(MPU6050_DMP_MEMORY_CHUNK_SIZE); + if (useProgMem) progBuffer = (uint8_t *)malloc(MPU6050_DMP_MEMORY_CHUNK_SIZE); + for (i = 0; i < dataSize;) { + // determine correct chunk size according to bank position and data size + chunkSize = MPU6050_DMP_MEMORY_CHUNK_SIZE; + + // make sure we don't go past the data size + if (i + chunkSize > dataSize) chunkSize = dataSize - i; + + // make sure this chunk doesn't go past the bank boundary (256 bytes) + if (chunkSize > 256 - address) chunkSize = 256 - address; + + if (useProgMem) { + // write the chunk of data as specified + for (j = 0; j < chunkSize; j++) progBuffer[j] = pgm_read_byte(data + i + j); + } else { + // write the chunk of data as specified + progBuffer = (uint8_t *)data + i; + } + + I2Cdev::writeBytes(devAddr, MPU6050_RA_MEM_R_W, chunkSize, progBuffer); + + // verify data if needed + if (verify && verifyBuffer) { + setMemoryBank(bank); + setMemoryStartAddress(address); + I2Cdev::readBytes(devAddr, MPU6050_RA_MEM_R_W, chunkSize, verifyBuffer); + if (memcmp(progBuffer, verifyBuffer, chunkSize) != 0) { + /*Serial.print("Block write verification error, bank "); + Serial.print(bank, DEC); + Serial.print(", address "); + Serial.print(address, DEC); + Serial.print("!\nExpected:"); + for (j = 0; j < chunkSize; j++) { + Serial.print(" 0x"); + if (progBuffer[j] < 16) Serial.print("0"); + Serial.print(progBuffer[j], HEX); + } + Serial.print("\nReceived:"); + for (uint8_t j = 0; j < chunkSize; j++) { + Serial.print(" 0x"); + if (verifyBuffer[i + j] < 16) Serial.print("0"); + Serial.print(verifyBuffer[i + j], HEX); + } + Serial.print("\n");*/ + free(verifyBuffer); + if (useProgMem) free(progBuffer); + return false; // uh oh. + } + } + + // increase byte index by [chunkSize] + i += chunkSize; + + // uint8_t automatically wraps to 0 at 256 + address += chunkSize; + + // if we aren't done, update bank (if necessary) and address + if (i < dataSize) { + if (address == 0) bank++; + setMemoryBank(bank); + setMemoryStartAddress(address); + } + } + if (verify) free(verifyBuffer); + if (useProgMem) free(progBuffer); + return true; +} +bool MPU6050::writeProgMemoryBlock(const uint8_t *data, uint16_t dataSize, uint8_t bank, uint8_t address, bool verify) { + return writeMemoryBlock(data, dataSize, bank, address, verify, true); +} +bool MPU6050::writeDMPConfigurationSet(const uint8_t *data, uint16_t dataSize, bool useProgMem) { + uint8_t *progBuffer = 0; + uint8_t success, special; + uint16_t i, j; + if (useProgMem) { + progBuffer = (uint8_t *)malloc(8); // assume 8-byte blocks, realloc later if necessary + } + + // config set data is a long string of blocks with the following structure: + // [bank] [offset] [length] [byte[0], byte[1], ..., byte[length]] + uint8_t bank, offset, length; + for (i = 0; i < dataSize;) { + if (useProgMem) { + bank = pgm_read_byte(data + i++); + offset = pgm_read_byte(data + i++); + length = pgm_read_byte(data + i++); + } else { + bank = data[i++]; + offset = data[i++]; + length = data[i++]; + } + + // write data or perform special action + if (length > 0) { + // regular block of data to write + /*Serial.print("Writing config block to bank "); + Serial.print(bank); + Serial.print(", offset "); + Serial.print(offset); + Serial.print(", length="); + Serial.println(length);*/ + if (useProgMem) { + if (sizeof(progBuffer) < length) progBuffer = (uint8_t *)realloc(progBuffer, length); + for (j = 0; j < length; j++) progBuffer[j] = pgm_read_byte(data + i + j); + } else { + progBuffer = (uint8_t *)data + i; + } + success = writeMemoryBlock(progBuffer, length, bank, offset, true); + i += length; + } else { + // special instruction + // NOTE: this kind of behavior (what and when to do certain things) + // is totally undocumented. This code is in here based on observed + // behavior only, and exactly why (or even whether) it has to be here + // is anybody's guess for now. + if (useProgMem) { + special = pgm_read_byte(data + i++); + } else { + special = data[i++]; + } + /*Serial.print("Special command code "); + Serial.print(special, HEX); + Serial.println(" found...");*/ + if (special == 0x01) { + // enable DMP-related interrupts + + //setIntZeroMotionEnabled(true); + //setIntFIFOBufferOverflowEnabled(true); + //setIntDMPEnabled(true); + I2Cdev::writeByte(devAddr, MPU6050_RA_INT_ENABLE, 0x32); // single operation + + success = true; + } else { + // unknown special command + success = false; + } + } + + if (!success) { + if (useProgMem) free(progBuffer); + return false; // uh oh + } + } + if (useProgMem) free(progBuffer); + return true; +} +bool MPU6050::writeProgDMPConfigurationSet(const uint8_t *data, uint16_t dataSize) { + return writeDMPConfigurationSet(data, dataSize, true); +} + +// DMP_CFG_1 register + +uint8_t MPU6050::getDMPConfig1() { + I2Cdev::readByte(devAddr, MPU6050_RA_DMP_CFG_1, buffer); + return buffer[0]; +} +void MPU6050::setDMPConfig1(uint8_t config) { + I2Cdev::writeByte(devAddr, MPU6050_RA_DMP_CFG_1, config); +} + +// DMP_CFG_2 register + +uint8_t MPU6050::getDMPConfig2() { + I2Cdev::readByte(devAddr, MPU6050_RA_DMP_CFG_2, buffer); + return buffer[0]; +} +void MPU6050::setDMPConfig2(uint8_t config) { + I2Cdev::writeByte(devAddr, MPU6050_RA_DMP_CFG_2, config); +} + + +//*************************************************************************************** +//********************** Calibration Routines ********************** +//*************************************************************************************** +/** + @brief Fully calibrate Gyro from ZERO in about 6-7 Loops 600-700 readings +*/ +void MPU6050::CalibrateGyro(uint8_t Loops ) { + double kP = 0.3; + double kI = 90; + float x; + x = (100 - map(Loops, 1, 5, 20, 0)) * .01; + kP *= x; + kI *= x; + + PID( 0x43, kP, kI, Loops); +} + +/** + @brief Fully calibrate Accel from ZERO in about 6-7 Loops 600-700 readings +*/ +void MPU6050::CalibrateAccel(uint8_t Loops ) { + + float kP = 0.3; + float kI = 20; + float x; + x = (100 - map(Loops, 1, 5, 20, 0)) * .01; + kP *= x; + kI *= x; + PID( 0x3B, kP, kI, Loops); +} + +void MPU6050::PID(uint8_t ReadAddress, float kP,float kI, uint8_t Loops){ + uint8_t SaveAddress = (ReadAddress == 0x3B)?((getDeviceID() < 0x38 )? 0x06:0x77):0x13; + + int16_t Data; + float Reading; + int16_t BitZero[3]; + uint8_t shift =(SaveAddress == 0x77)?3:2; + float Error, PTerm, ITerm[3]; + int16_t eSample; + uint32_t eSum ; + Serial.write('>'); + for (int i = 0; i < 3; i++) { + I2Cdev::readWords(devAddr, SaveAddress + (i * shift), 1, (uint16_t *)&Data); // reads 1 or more 16 bit integers (Word) + Reading = Data; + if(SaveAddress != 0x13){ + BitZero[i] = Data & 1; // Capture Bit Zero to properly handle Accelerometer calibration + ITerm[i] = ((float)Reading) * 8; + } else { + ITerm[i] = Reading * 4; + } + } + for (int L = 0; L < Loops; L++) { + eSample = 0; + for (int c = 0; c < 100; c++) {// 100 PI Calculations + eSum = 0; + for (int i = 0; i < 3; i++) { + I2Cdev::readWords(devAddr, ReadAddress + (i * 2), 1, (uint16_t *)&Data); // reads 1 or more 16 bit integers (Word) + Reading = Data; + if ((ReadAddress == 0x3B)&&(i == 2)) Reading -= 16384; //remove Gravity + Error = -Reading; + eSum += abs(Reading); + PTerm = kP * Error; + ITerm[i] += (Error * 0.001) * kI; // Integral term 1000 Calculations a second = 0.001 + if(SaveAddress != 0x13){ + Data = round((PTerm + ITerm[i] ) / 8); //Compute PID Output + Data = ((Data)&0xFFFE) |BitZero[i]; // Insert Bit0 Saved at beginning + } else Data = round((PTerm + ITerm[i] ) / 4); //Compute PID Output + I2Cdev::writeWords(devAddr, SaveAddress + (i * shift), 1, (uint16_t *)&Data); + } + if((c == 99) && eSum > 1000){ // Error is still to great to continue + c = 0; + Serial.write('*'); + } + if((eSum * ((ReadAddress == 0x3B)?.05: 1)) < 5) eSample++; // Successfully found offsets prepare to advance + if((eSum < 100) && (c > 10) && (eSample >= 10)) break; // Advance to next Loop + delay(1); + } + Serial.write('.'); + kP *= .75; + kI *= .75; + for (int i = 0; i < 3; i++){ + if(SaveAddress != 0x13) { + Data = round((ITerm[i] ) / 8); //Compute PID Output + Data = ((Data)&0xFFFE) |BitZero[i]; // Insert Bit0 Saved at beginning + } else Data = round((ITerm[i]) / 4); + I2Cdev::writeWords(devAddr, SaveAddress + (i * shift), 1, (uint16_t *)&Data); + } + } + resetFIFO(); + resetDMP(); +} + +#define printfloatx(Name,Variable,Spaces,Precision,EndTxt) { Serial.print(F(Name)); {char S[(Spaces + Precision + 3)];Serial.print(F(" ")); Serial.print(dtostrf((float)Variable,Spaces,Precision ,S));}Serial.print(F(EndTxt)); }//Name,Variable,Spaces,Precision,EndTxt +void MPU6050::PrintActiveOffsets() { + uint8_t AOffsetRegister = (getDeviceID() < 0x38 )? MPU6050_RA_XA_OFFS_H:0x77; + int16_t Data[3]; + //Serial.print(F("Offset Register 0x")); + //Serial.print(AOffsetRegister>>4,HEX);Serial.print(AOffsetRegister&0x0F,HEX); + Serial.print(F("\n// X Accel Y Accel Z Accel X Gyro Y Gyro Z Gyro\n//OFFSETS ")); + if(AOffsetRegister == 0x06) I2Cdev::readWords(devAddr, AOffsetRegister, 3, (uint16_t *)Data); + else { + I2Cdev::readWords(devAddr, AOffsetRegister, 1, (uint16_t *)Data); + I2Cdev::readWords(devAddr, AOffsetRegister+3, 1, (uint16_t *)Data+1); + I2Cdev::readWords(devAddr, AOffsetRegister+6, 1, (uint16_t *)Data+2); + } + // A_OFFSET_H_READ_A_OFFS(Data); + printfloatx("", Data[0], 5, 0, ", "); + printfloatx("", Data[1], 5, 0, ", "); + printfloatx("", Data[2], 5, 0, ", "); + I2Cdev::readWords(devAddr, 0x13, 3, (uint16_t *)Data); + // XG_OFFSET_H_READ_OFFS_USR(Data); + printfloatx("", Data[0], 5, 0, ", "); + printfloatx("", Data[1], 5, 0, ", "); + printfloatx("", Data[2], 5, 0, "\n"); +} diff --git a/lib/mpu6050/MPU6050.h b/lib/mpu6050/MPU6050.h new file mode 100644 index 0000000..4be352d --- /dev/null +++ b/lib/mpu6050/MPU6050.h @@ -0,0 +1,1041 @@ +// I2Cdev library collection - MPU6050 I2C device class +// Based on InvenSense MPU-6050 register map document rev. 2.0, 5/19/2011 (RM-MPU-6000A-00) +// 10/3/2011 by Jeff Rowberg +// Updates should (hopefully) always be available at https://github.com/jrowberg/i2cdevlib +// +// Changelog: +// ... - ongoing debug release + +// NOTE: THIS IS ONLY A PARIAL RELEASE. THIS DEVICE CLASS IS CURRENTLY UNDERGOING ACTIVE +// DEVELOPMENT AND IS STILL MISSING SOME IMPORTANT FEATURES. PLEASE KEEP THIS IN MIND IF +// YOU DECIDE TO USE THIS PARTICULAR CODE FOR ANYTHING. + +/* ============================================ +I2Cdev device library code is placed under the MIT license +Copyright (c) 2012 Jeff Rowberg + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. +=============================================== +*/ + +#ifndef _MPU6050_H_ +#define _MPU6050_H_ + +#include "I2Cdev.h" + +// supporting link: http://forum.arduino.cc/index.php?&topic=143444.msg1079517#msg1079517 +// also: http://forum.arduino.cc/index.php?&topic=141571.msg1062899#msg1062899s + +#ifdef __AVR__ +#include +#else +//#define PROGMEM /* empty */ +//#define pgm_read_byte(x) (*(x)) +//#define pgm_read_word(x) (*(x)) +//#define pgm_read_float(x) (*(x)) +//#define PSTR(STR) STR +#endif + + +#define MPU6050_ADDRESS_AD0_LOW 0x68 // address pin low (GND), default for InvenSense evaluation board +#define MPU6050_ADDRESS_AD0_HIGH 0x69 // address pin high (VCC) +#define MPU6050_DEFAULT_ADDRESS MPU6050_ADDRESS_AD0_LOW + +#define MPU6050_RA_XG_OFFS_TC 0x00 //[7] PWR_MODE, [6:1] XG_OFFS_TC, [0] OTP_BNK_VLD +#define MPU6050_RA_YG_OFFS_TC 0x01 //[7] PWR_MODE, [6:1] YG_OFFS_TC, [0] OTP_BNK_VLD +#define MPU6050_RA_ZG_OFFS_TC 0x02 //[7] PWR_MODE, [6:1] ZG_OFFS_TC, [0] OTP_BNK_VLD +#define MPU6050_RA_X_FINE_GAIN 0x03 //[7:0] X_FINE_GAIN +#define MPU6050_RA_Y_FINE_GAIN 0x04 //[7:0] Y_FINE_GAIN +#define MPU6050_RA_Z_FINE_GAIN 0x05 //[7:0] Z_FINE_GAIN +#define MPU6050_RA_XA_OFFS_H 0x06 //[15:0] XA_OFFS +#define MPU6050_RA_XA_OFFS_L_TC 0x07 +#define MPU6050_RA_YA_OFFS_H 0x08 //[15:0] YA_OFFS +#define MPU6050_RA_YA_OFFS_L_TC 0x09 +#define MPU6050_RA_ZA_OFFS_H 0x0A //[15:0] ZA_OFFS +#define MPU6050_RA_ZA_OFFS_L_TC 0x0B +#define MPU6050_RA_SELF_TEST_X 0x0D //[7:5] XA_TEST[4-2], [4:0] XG_TEST[4-0] +#define MPU6050_RA_SELF_TEST_Y 0x0E //[7:5] YA_TEST[4-2], [4:0] YG_TEST[4-0] +#define MPU6050_RA_SELF_TEST_Z 0x0F //[7:5] ZA_TEST[4-2], [4:0] ZG_TEST[4-0] +#define MPU6050_RA_SELF_TEST_A 0x10 //[5:4] XA_TEST[1-0], [3:2] YA_TEST[1-0], [1:0] ZA_TEST[1-0] +#define MPU6050_RA_XG_OFFS_USRH 0x13 //[15:0] XG_OFFS_USR +#define MPU6050_RA_XG_OFFS_USRL 0x14 +#define MPU6050_RA_YG_OFFS_USRH 0x15 //[15:0] YG_OFFS_USR +#define MPU6050_RA_YG_OFFS_USRL 0x16 +#define MPU6050_RA_ZG_OFFS_USRH 0x17 //[15:0] ZG_OFFS_USR +#define MPU6050_RA_ZG_OFFS_USRL 0x18 +#define MPU6050_RA_SMPLRT_DIV 0x19 +#define MPU6050_RA_CONFIG 0x1A +#define MPU6050_RA_GYRO_CONFIG 0x1B +#define MPU6050_RA_ACCEL_CONFIG 0x1C +#define MPU6050_RA_FF_THR 0x1D +#define MPU6050_RA_FF_DUR 0x1E +#define MPU6050_RA_MOT_THR 0x1F +#define MPU6050_RA_MOT_DUR 0x20 +#define MPU6050_RA_ZRMOT_THR 0x21 +#define MPU6050_RA_ZRMOT_DUR 0x22 +#define MPU6050_RA_FIFO_EN 0x23 +#define MPU6050_RA_I2C_MST_CTRL 0x24 +#define MPU6050_RA_I2C_SLV0_ADDR 0x25 +#define MPU6050_RA_I2C_SLV0_REG 0x26 +#define MPU6050_RA_I2C_SLV0_CTRL 0x27 +#define MPU6050_RA_I2C_SLV1_ADDR 0x28 +#define MPU6050_RA_I2C_SLV1_REG 0x29 +#define MPU6050_RA_I2C_SLV1_CTRL 0x2A +#define MPU6050_RA_I2C_SLV2_ADDR 0x2B +#define MPU6050_RA_I2C_SLV2_REG 0x2C +#define MPU6050_RA_I2C_SLV2_CTRL 0x2D +#define MPU6050_RA_I2C_SLV3_ADDR 0x2E +#define MPU6050_RA_I2C_SLV3_REG 0x2F +#define MPU6050_RA_I2C_SLV3_CTRL 0x30 +#define MPU6050_RA_I2C_SLV4_ADDR 0x31 +#define MPU6050_RA_I2C_SLV4_REG 0x32 +#define MPU6050_RA_I2C_SLV4_DO 0x33 +#define MPU6050_RA_I2C_SLV4_CTRL 0x34 +#define MPU6050_RA_I2C_SLV4_DI 0x35 +#define MPU6050_RA_I2C_MST_STATUS 0x36 +#define MPU6050_RA_INT_PIN_CFG 0x37 +#define MPU6050_RA_INT_ENABLE 0x38 +#define MPU6050_RA_DMP_INT_STATUS 0x39 +#define MPU6050_RA_INT_STATUS 0x3A +#define MPU6050_RA_ACCEL_XOUT_H 0x3B +#define MPU6050_RA_ACCEL_XOUT_L 0x3C +#define MPU6050_RA_ACCEL_YOUT_H 0x3D +#define MPU6050_RA_ACCEL_YOUT_L 0x3E +#define MPU6050_RA_ACCEL_ZOUT_H 0x3F +#define MPU6050_RA_ACCEL_ZOUT_L 0x40 +#define MPU6050_RA_TEMP_OUT_H 0x41 +#define MPU6050_RA_TEMP_OUT_L 0x42 +#define MPU6050_RA_GYRO_XOUT_H 0x43 +#define MPU6050_RA_GYRO_XOUT_L 0x44 +#define MPU6050_RA_GYRO_YOUT_H 0x45 +#define MPU6050_RA_GYRO_YOUT_L 0x46 +#define MPU6050_RA_GYRO_ZOUT_H 0x47 +#define MPU6050_RA_GYRO_ZOUT_L 0x48 +#define MPU6050_RA_EXT_SENS_DATA_00 0x49 +#define MPU6050_RA_EXT_SENS_DATA_01 0x4A +#define MPU6050_RA_EXT_SENS_DATA_02 0x4B +#define MPU6050_RA_EXT_SENS_DATA_03 0x4C +#define MPU6050_RA_EXT_SENS_DATA_04 0x4D +#define MPU6050_RA_EXT_SENS_DATA_05 0x4E +#define MPU6050_RA_EXT_SENS_DATA_06 0x4F +#define MPU6050_RA_EXT_SENS_DATA_07 0x50 +#define MPU6050_RA_EXT_SENS_DATA_08 0x51 +#define MPU6050_RA_EXT_SENS_DATA_09 0x52 +#define MPU6050_RA_EXT_SENS_DATA_10 0x53 +#define MPU6050_RA_EXT_SENS_DATA_11 0x54 +#define MPU6050_RA_EXT_SENS_DATA_12 0x55 +#define MPU6050_RA_EXT_SENS_DATA_13 0x56 +#define MPU6050_RA_EXT_SENS_DATA_14 0x57 +#define MPU6050_RA_EXT_SENS_DATA_15 0x58 +#define MPU6050_RA_EXT_SENS_DATA_16 0x59 +#define MPU6050_RA_EXT_SENS_DATA_17 0x5A +#define MPU6050_RA_EXT_SENS_DATA_18 0x5B +#define MPU6050_RA_EXT_SENS_DATA_19 0x5C +#define MPU6050_RA_EXT_SENS_DATA_20 0x5D +#define MPU6050_RA_EXT_SENS_DATA_21 0x5E +#define MPU6050_RA_EXT_SENS_DATA_22 0x5F +#define MPU6050_RA_EXT_SENS_DATA_23 0x60 +#define MPU6050_RA_MOT_DETECT_STATUS 0x61 +#define MPU6050_RA_I2C_SLV0_DO 0x63 +#define MPU6050_RA_I2C_SLV1_DO 0x64 +#define MPU6050_RA_I2C_SLV2_DO 0x65 +#define MPU6050_RA_I2C_SLV3_DO 0x66 +#define MPU6050_RA_I2C_MST_DELAY_CTRL 0x67 +#define MPU6050_RA_SIGNAL_PATH_RESET 0x68 +#define MPU6050_RA_MOT_DETECT_CTRL 0x69 +#define MPU6050_RA_USER_CTRL 0x6A +#define MPU6050_RA_PWR_MGMT_1 0x6B +#define MPU6050_RA_PWR_MGMT_2 0x6C +#define MPU6050_RA_BANK_SEL 0x6D +#define MPU6050_RA_MEM_START_ADDR 0x6E +#define MPU6050_RA_MEM_R_W 0x6F +#define MPU6050_RA_DMP_CFG_1 0x70 +#define MPU6050_RA_DMP_CFG_2 0x71 +#define MPU6050_RA_FIFO_COUNTH 0x72 +#define MPU6050_RA_FIFO_COUNTL 0x73 +#define MPU6050_RA_FIFO_R_W 0x74 +#define MPU6050_RA_WHO_AM_I 0x75 + +#define MPU6050_SELF_TEST_XA_1_BIT 0x07 +#define MPU6050_SELF_TEST_XA_1_LENGTH 0x03 +#define MPU6050_SELF_TEST_XA_2_BIT 0x05 +#define MPU6050_SELF_TEST_XA_2_LENGTH 0x02 +#define MPU6050_SELF_TEST_YA_1_BIT 0x07 +#define MPU6050_SELF_TEST_YA_1_LENGTH 0x03 +#define MPU6050_SELF_TEST_YA_2_BIT 0x03 +#define MPU6050_SELF_TEST_YA_2_LENGTH 0x02 +#define MPU6050_SELF_TEST_ZA_1_BIT 0x07 +#define MPU6050_SELF_TEST_ZA_1_LENGTH 0x03 +#define MPU6050_SELF_TEST_ZA_2_BIT 0x01 +#define MPU6050_SELF_TEST_ZA_2_LENGTH 0x02 + +#define MPU6050_SELF_TEST_XG_1_BIT 0x04 +#define MPU6050_SELF_TEST_XG_1_LENGTH 0x05 +#define MPU6050_SELF_TEST_YG_1_BIT 0x04 +#define MPU6050_SELF_TEST_YG_1_LENGTH 0x05 +#define MPU6050_SELF_TEST_ZG_1_BIT 0x04 +#define MPU6050_SELF_TEST_ZG_1_LENGTH 0x05 + +#define MPU6050_TC_PWR_MODE_BIT 7 +#define MPU6050_TC_OFFSET_BIT 6 +#define MPU6050_TC_OFFSET_LENGTH 6 +#define MPU6050_TC_OTP_BNK_VLD_BIT 0 + +#define MPU6050_VDDIO_LEVEL_VLOGIC 0 +#define MPU6050_VDDIO_LEVEL_VDD 1 + +#define MPU6050_CFG_EXT_SYNC_SET_BIT 5 +#define MPU6050_CFG_EXT_SYNC_SET_LENGTH 3 +#define MPU6050_CFG_DLPF_CFG_BIT 2 +#define MPU6050_CFG_DLPF_CFG_LENGTH 3 + +#define MPU6050_EXT_SYNC_DISABLED 0x0 +#define MPU6050_EXT_SYNC_TEMP_OUT_L 0x1 +#define MPU6050_EXT_SYNC_GYRO_XOUT_L 0x2 +#define MPU6050_EXT_SYNC_GYRO_YOUT_L 0x3 +#define MPU6050_EXT_SYNC_GYRO_ZOUT_L 0x4 +#define MPU6050_EXT_SYNC_ACCEL_XOUT_L 0x5 +#define MPU6050_EXT_SYNC_ACCEL_YOUT_L 0x6 +#define MPU6050_EXT_SYNC_ACCEL_ZOUT_L 0x7 + +#define MPU6050_DLPF_BW_256 0x00 +#define MPU6050_DLPF_BW_188 0x01 +#define MPU6050_DLPF_BW_98 0x02 +#define MPU6050_DLPF_BW_42 0x03 +#define MPU6050_DLPF_BW_20 0x04 +#define MPU6050_DLPF_BW_10 0x05 +#define MPU6050_DLPF_BW_5 0x06 + +#define MPU6050_GCONFIG_FS_SEL_BIT 4 +#define MPU6050_GCONFIG_FS_SEL_LENGTH 2 + +#define MPU6050_GYRO_FS_250 0x00 +#define MPU6050_GYRO_FS_500 0x01 +#define MPU6050_GYRO_FS_1000 0x02 +#define MPU6050_GYRO_FS_2000 0x03 + +#define MPU6050_ACONFIG_XA_ST_BIT 7 +#define MPU6050_ACONFIG_YA_ST_BIT 6 +#define MPU6050_ACONFIG_ZA_ST_BIT 5 +#define MPU6050_ACONFIG_AFS_SEL_BIT 4 +#define MPU6050_ACONFIG_AFS_SEL_LENGTH 2 +#define MPU6050_ACONFIG_ACCEL_HPF_BIT 2 +#define MPU6050_ACONFIG_ACCEL_HPF_LENGTH 3 + +#define MPU6050_ACCEL_FS_2 0x00 +#define MPU6050_ACCEL_FS_4 0x01 +#define MPU6050_ACCEL_FS_8 0x02 +#define MPU6050_ACCEL_FS_16 0x03 + +#define MPU6050_DHPF_RESET 0x00 +#define MPU6050_DHPF_5 0x01 +#define MPU6050_DHPF_2P5 0x02 +#define MPU6050_DHPF_1P25 0x03 +#define MPU6050_DHPF_0P63 0x04 +#define MPU6050_DHPF_HOLD 0x07 + +#define MPU6050_TEMP_FIFO_EN_BIT 7 +#define MPU6050_XG_FIFO_EN_BIT 6 +#define MPU6050_YG_FIFO_EN_BIT 5 +#define MPU6050_ZG_FIFO_EN_BIT 4 +#define MPU6050_ACCEL_FIFO_EN_BIT 3 +#define MPU6050_SLV2_FIFO_EN_BIT 2 +#define MPU6050_SLV1_FIFO_EN_BIT 1 +#define MPU6050_SLV0_FIFO_EN_BIT 0 + +#define MPU6050_MULT_MST_EN_BIT 7 +#define MPU6050_WAIT_FOR_ES_BIT 6 +#define MPU6050_SLV_3_FIFO_EN_BIT 5 +#define MPU6050_I2C_MST_P_NSR_BIT 4 +#define MPU6050_I2C_MST_CLK_BIT 3 +#define MPU6050_I2C_MST_CLK_LENGTH 4 + +#define MPU6050_CLOCK_DIV_348 0x0 +#define MPU6050_CLOCK_DIV_333 0x1 +#define MPU6050_CLOCK_DIV_320 0x2 +#define MPU6050_CLOCK_DIV_308 0x3 +#define MPU6050_CLOCK_DIV_296 0x4 +#define MPU6050_CLOCK_DIV_286 0x5 +#define MPU6050_CLOCK_DIV_276 0x6 +#define MPU6050_CLOCK_DIV_267 0x7 +#define MPU6050_CLOCK_DIV_258 0x8 +#define MPU6050_CLOCK_DIV_500 0x9 +#define MPU6050_CLOCK_DIV_471 0xA +#define MPU6050_CLOCK_DIV_444 0xB +#define MPU6050_CLOCK_DIV_421 0xC +#define MPU6050_CLOCK_DIV_400 0xD +#define MPU6050_CLOCK_DIV_381 0xE +#define MPU6050_CLOCK_DIV_364 0xF + +#define MPU6050_I2C_SLV_RW_BIT 7 +#define MPU6050_I2C_SLV_ADDR_BIT 6 +#define MPU6050_I2C_SLV_ADDR_LENGTH 7 +#define MPU6050_I2C_SLV_EN_BIT 7 +#define MPU6050_I2C_SLV_BYTE_SW_BIT 6 +#define MPU6050_I2C_SLV_REG_DIS_BIT 5 +#define MPU6050_I2C_SLV_GRP_BIT 4 +#define MPU6050_I2C_SLV_LEN_BIT 3 +#define MPU6050_I2C_SLV_LEN_LENGTH 4 + +#define MPU6050_I2C_SLV4_RW_BIT 7 +#define MPU6050_I2C_SLV4_ADDR_BIT 6 +#define MPU6050_I2C_SLV4_ADDR_LENGTH 7 +#define MPU6050_I2C_SLV4_EN_BIT 7 +#define MPU6050_I2C_SLV4_INT_EN_BIT 6 +#define MPU6050_I2C_SLV4_REG_DIS_BIT 5 +#define MPU6050_I2C_SLV4_MST_DLY_BIT 4 +#define MPU6050_I2C_SLV4_MST_DLY_LENGTH 5 + +#define MPU6050_MST_PASS_THROUGH_BIT 7 +#define MPU6050_MST_I2C_SLV4_DONE_BIT 6 +#define MPU6050_MST_I2C_LOST_ARB_BIT 5 +#define MPU6050_MST_I2C_SLV4_NACK_BIT 4 +#define MPU6050_MST_I2C_SLV3_NACK_BIT 3 +#define MPU6050_MST_I2C_SLV2_NACK_BIT 2 +#define MPU6050_MST_I2C_SLV1_NACK_BIT 1 +#define MPU6050_MST_I2C_SLV0_NACK_BIT 0 + +#define MPU6050_INTCFG_INT_LEVEL_BIT 7 +#define MPU6050_INTCFG_INT_OPEN_BIT 6 +#define MPU6050_INTCFG_LATCH_INT_EN_BIT 5 +#define MPU6050_INTCFG_INT_RD_CLEAR_BIT 4 +#define MPU6050_INTCFG_FSYNC_INT_LEVEL_BIT 3 +#define MPU6050_INTCFG_FSYNC_INT_EN_BIT 2 +#define MPU6050_INTCFG_I2C_BYPASS_EN_BIT 1 +#define MPU6050_INTCFG_CLKOUT_EN_BIT 0 + +#define MPU6050_INTMODE_ACTIVEHIGH 0x00 +#define MPU6050_INTMODE_ACTIVELOW 0x01 + +#define MPU6050_INTDRV_PUSHPULL 0x00 +#define MPU6050_INTDRV_OPENDRAIN 0x01 + +#define MPU6050_INTLATCH_50USPULSE 0x00 +#define MPU6050_INTLATCH_WAITCLEAR 0x01 + +#define MPU6050_INTCLEAR_STATUSREAD 0x00 +#define MPU6050_INTCLEAR_ANYREAD 0x01 + +#define MPU6050_INTERRUPT_FF_BIT 7 +#define MPU6050_INTERRUPT_MOT_BIT 6 +#define MPU6050_INTERRUPT_ZMOT_BIT 5 +#define MPU6050_INTERRUPT_FIFO_OFLOW_BIT 4 +#define MPU6050_INTERRUPT_I2C_MST_INT_BIT 3 +#define MPU6050_INTERRUPT_PLL_RDY_INT_BIT 2 +#define MPU6050_INTERRUPT_DMP_INT_BIT 1 +#define MPU6050_INTERRUPT_DATA_RDY_BIT 0 + +// TODO: figure out what these actually do +// UMPL source code is not very obivous +#define MPU6050_DMPINT_5_BIT 5 +#define MPU6050_DMPINT_4_BIT 4 +#define MPU6050_DMPINT_3_BIT 3 +#define MPU6050_DMPINT_2_BIT 2 +#define MPU6050_DMPINT_1_BIT 1 +#define MPU6050_DMPINT_0_BIT 0 + +#define MPU6050_MOTION_MOT_XNEG_BIT 7 +#define MPU6050_MOTION_MOT_XPOS_BIT 6 +#define MPU6050_MOTION_MOT_YNEG_BIT 5 +#define MPU6050_MOTION_MOT_YPOS_BIT 4 +#define MPU6050_MOTION_MOT_ZNEG_BIT 3 +#define MPU6050_MOTION_MOT_ZPOS_BIT 2 +#define MPU6050_MOTION_MOT_ZRMOT_BIT 0 + +#define MPU6050_DELAYCTRL_DELAY_ES_SHADOW_BIT 7 +#define MPU6050_DELAYCTRL_I2C_SLV4_DLY_EN_BIT 4 +#define MPU6050_DELAYCTRL_I2C_SLV3_DLY_EN_BIT 3 +#define MPU6050_DELAYCTRL_I2C_SLV2_DLY_EN_BIT 2 +#define MPU6050_DELAYCTRL_I2C_SLV1_DLY_EN_BIT 1 +#define MPU6050_DELAYCTRL_I2C_SLV0_DLY_EN_BIT 0 + +#define MPU6050_PATHRESET_GYRO_RESET_BIT 2 +#define MPU6050_PATHRESET_ACCEL_RESET_BIT 1 +#define MPU6050_PATHRESET_TEMP_RESET_BIT 0 + +#define MPU6050_DETECT_ACCEL_ON_DELAY_BIT 5 +#define MPU6050_DETECT_ACCEL_ON_DELAY_LENGTH 2 +#define MPU6050_DETECT_FF_COUNT_BIT 3 +#define MPU6050_DETECT_FF_COUNT_LENGTH 2 +#define MPU6050_DETECT_MOT_COUNT_BIT 1 +#define MPU6050_DETECT_MOT_COUNT_LENGTH 2 + +#define MPU6050_DETECT_DECREMENT_RESET 0x0 +#define MPU6050_DETECT_DECREMENT_1 0x1 +#define MPU6050_DETECT_DECREMENT_2 0x2 +#define MPU6050_DETECT_DECREMENT_4 0x3 + +#define MPU6050_USERCTRL_DMP_EN_BIT 7 +#define MPU6050_USERCTRL_FIFO_EN_BIT 6 +#define MPU6050_USERCTRL_I2C_MST_EN_BIT 5 +#define MPU6050_USERCTRL_I2C_IF_DIS_BIT 4 +#define MPU6050_USERCTRL_DMP_RESET_BIT 3 +#define MPU6050_USERCTRL_FIFO_RESET_BIT 2 +#define MPU6050_USERCTRL_I2C_MST_RESET_BIT 1 +#define MPU6050_USERCTRL_SIG_COND_RESET_BIT 0 + +#define MPU6050_PWR1_DEVICE_RESET_BIT 7 +#define MPU6050_PWR1_SLEEP_BIT 6 +#define MPU6050_PWR1_CYCLE_BIT 5 +#define MPU6050_PWR1_TEMP_DIS_BIT 3 +#define MPU6050_PWR1_CLKSEL_BIT 2 +#define MPU6050_PWR1_CLKSEL_LENGTH 3 + +#define MPU6050_CLOCK_INTERNAL 0x00 +#define MPU6050_CLOCK_PLL_XGYRO 0x01 +#define MPU6050_CLOCK_PLL_YGYRO 0x02 +#define MPU6050_CLOCK_PLL_ZGYRO 0x03 +#define MPU6050_CLOCK_PLL_EXT32K 0x04 +#define MPU6050_CLOCK_PLL_EXT19M 0x05 +#define MPU6050_CLOCK_KEEP_RESET 0x07 + +#define MPU6050_PWR2_LP_WAKE_CTRL_BIT 7 +#define MPU6050_PWR2_LP_WAKE_CTRL_LENGTH 2 +#define MPU6050_PWR2_STBY_XA_BIT 5 +#define MPU6050_PWR2_STBY_YA_BIT 4 +#define MPU6050_PWR2_STBY_ZA_BIT 3 +#define MPU6050_PWR2_STBY_XG_BIT 2 +#define MPU6050_PWR2_STBY_YG_BIT 1 +#define MPU6050_PWR2_STBY_ZG_BIT 0 + +#define MPU6050_WAKE_FREQ_1P25 0x0 +#define MPU6050_WAKE_FREQ_2P5 0x1 +#define MPU6050_WAKE_FREQ_5 0x2 +#define MPU6050_WAKE_FREQ_10 0x3 + +#define MPU6050_BANKSEL_PRFTCH_EN_BIT 6 +#define MPU6050_BANKSEL_CFG_USER_BANK_BIT 5 +#define MPU6050_BANKSEL_MEM_SEL_BIT 4 +#define MPU6050_BANKSEL_MEM_SEL_LENGTH 5 + +#define MPU6050_WHO_AM_I_BIT 6 +#define MPU6050_WHO_AM_I_LENGTH 6 + +#define MPU6050_DMP_MEMORY_BANKS 8 +#define MPU6050_DMP_MEMORY_BANK_SIZE 256 +#define MPU6050_DMP_MEMORY_CHUNK_SIZE 16 + +// note: DMP code memory blocks defined at end of header file + +class MPU6050 { + public: + MPU6050(uint8_t address=MPU6050_DEFAULT_ADDRESS); + + void initialize(); + bool testConnection(); + + // AUX_VDDIO register + uint8_t getAuxVDDIOLevel(); + void setAuxVDDIOLevel(uint8_t level); + + // SMPLRT_DIV register + uint8_t getRate(); + void setRate(uint8_t rate); + + // CONFIG register + uint8_t getExternalFrameSync(); + void setExternalFrameSync(uint8_t sync); + uint8_t getDLPFMode(); + void setDLPFMode(uint8_t bandwidth); + + // GYRO_CONFIG register + uint8_t getFullScaleGyroRange(); + void setFullScaleGyroRange(uint8_t range); + + // SELF_TEST registers + uint8_t getAccelXSelfTestFactoryTrim(); + uint8_t getAccelYSelfTestFactoryTrim(); + uint8_t getAccelZSelfTestFactoryTrim(); + + uint8_t getGyroXSelfTestFactoryTrim(); + uint8_t getGyroYSelfTestFactoryTrim(); + uint8_t getGyroZSelfTestFactoryTrim(); + + // ACCEL_CONFIG register + bool getAccelXSelfTest(); + void setAccelXSelfTest(bool enabled); + bool getAccelYSelfTest(); + void setAccelYSelfTest(bool enabled); + bool getAccelZSelfTest(); + void setAccelZSelfTest(bool enabled); + uint8_t getFullScaleAccelRange(); + void setFullScaleAccelRange(uint8_t range); + uint8_t getDHPFMode(); + void setDHPFMode(uint8_t mode); + + // FF_THR register + uint8_t getFreefallDetectionThreshold(); + void setFreefallDetectionThreshold(uint8_t threshold); + + // FF_DUR register + uint8_t getFreefallDetectionDuration(); + void setFreefallDetectionDuration(uint8_t duration); + + // MOT_THR register + uint8_t getMotionDetectionThreshold(); + void setMotionDetectionThreshold(uint8_t threshold); + + // MOT_DUR register + uint8_t getMotionDetectionDuration(); + void setMotionDetectionDuration(uint8_t duration); + + // ZRMOT_THR register + uint8_t getZeroMotionDetectionThreshold(); + void setZeroMotionDetectionThreshold(uint8_t threshold); + + // ZRMOT_DUR register + uint8_t getZeroMotionDetectionDuration(); + void setZeroMotionDetectionDuration(uint8_t duration); + + // FIFO_EN register + bool getTempFIFOEnabled(); + void setTempFIFOEnabled(bool enabled); + bool getXGyroFIFOEnabled(); + void setXGyroFIFOEnabled(bool enabled); + bool getYGyroFIFOEnabled(); + void setYGyroFIFOEnabled(bool enabled); + bool getZGyroFIFOEnabled(); + void setZGyroFIFOEnabled(bool enabled); + bool getAccelFIFOEnabled(); + void setAccelFIFOEnabled(bool enabled); + bool getSlave2FIFOEnabled(); + void setSlave2FIFOEnabled(bool enabled); + bool getSlave1FIFOEnabled(); + void setSlave1FIFOEnabled(bool enabled); + bool getSlave0FIFOEnabled(); + void setSlave0FIFOEnabled(bool enabled); + + // I2C_MST_CTRL register + bool getMultiMasterEnabled(); + void setMultiMasterEnabled(bool enabled); + bool getWaitForExternalSensorEnabled(); + void setWaitForExternalSensorEnabled(bool enabled); + bool getSlave3FIFOEnabled(); + void setSlave3FIFOEnabled(bool enabled); + bool getSlaveReadWriteTransitionEnabled(); + void setSlaveReadWriteTransitionEnabled(bool enabled); + uint8_t getMasterClockSpeed(); + void setMasterClockSpeed(uint8_t speed); + + // I2C_SLV* registers (Slave 0-3) + uint8_t getSlaveAddress(uint8_t num); + void setSlaveAddress(uint8_t num, uint8_t address); + uint8_t getSlaveRegister(uint8_t num); + void setSlaveRegister(uint8_t num, uint8_t reg); + bool getSlaveEnabled(uint8_t num); + void setSlaveEnabled(uint8_t num, bool enabled); + bool getSlaveWordByteSwap(uint8_t num); + void setSlaveWordByteSwap(uint8_t num, bool enabled); + bool getSlaveWriteMode(uint8_t num); + void setSlaveWriteMode(uint8_t num, bool mode); + bool getSlaveWordGroupOffset(uint8_t num); + void setSlaveWordGroupOffset(uint8_t num, bool enabled); + uint8_t getSlaveDataLength(uint8_t num); + void setSlaveDataLength(uint8_t num, uint8_t length); + + // I2C_SLV* registers (Slave 4) + uint8_t getSlave4Address(); + void setSlave4Address(uint8_t address); + uint8_t getSlave4Register(); + void setSlave4Register(uint8_t reg); + void setSlave4OutputByte(uint8_t data); + bool getSlave4Enabled(); + void setSlave4Enabled(bool enabled); + bool getSlave4InterruptEnabled(); + void setSlave4InterruptEnabled(bool enabled); + bool getSlave4WriteMode(); + void setSlave4WriteMode(bool mode); + uint8_t getSlave4MasterDelay(); + void setSlave4MasterDelay(uint8_t delay); + uint8_t getSlate4InputByte(); + + // I2C_MST_STATUS register + bool getPassthroughStatus(); + bool getSlave4IsDone(); + bool getLostArbitration(); + bool getSlave4Nack(); + bool getSlave3Nack(); + bool getSlave2Nack(); + bool getSlave1Nack(); + bool getSlave0Nack(); + + // INT_PIN_CFG register + bool getInterruptMode(); + void setInterruptMode(bool mode); + bool getInterruptDrive(); + void setInterruptDrive(bool drive); + bool getInterruptLatch(); + void setInterruptLatch(bool latch); + bool getInterruptLatchClear(); + void setInterruptLatchClear(bool clear); + bool getFSyncInterruptLevel(); + void setFSyncInterruptLevel(bool level); + bool getFSyncInterruptEnabled(); + void setFSyncInterruptEnabled(bool enabled); + bool getI2CBypassEnabled(); + void setI2CBypassEnabled(bool enabled); + bool getClockOutputEnabled(); + void setClockOutputEnabled(bool enabled); + + // INT_ENABLE register + uint8_t getIntEnabled(); + void setIntEnabled(uint8_t enabled); + bool getIntFreefallEnabled(); + void setIntFreefallEnabled(bool enabled); + bool getIntMotionEnabled(); + void setIntMotionEnabled(bool enabled); + bool getIntZeroMotionEnabled(); + void setIntZeroMotionEnabled(bool enabled); + bool getIntFIFOBufferOverflowEnabled(); + void setIntFIFOBufferOverflowEnabled(bool enabled); + bool getIntI2CMasterEnabled(); + void setIntI2CMasterEnabled(bool enabled); + bool getIntDataReadyEnabled(); + void setIntDataReadyEnabled(bool enabled); + + // INT_STATUS register + uint8_t getIntStatus(); + bool getIntFreefallStatus(); + bool getIntMotionStatus(); + bool getIntZeroMotionStatus(); + bool getIntFIFOBufferOverflowStatus(); + bool getIntI2CMasterStatus(); + bool getIntDataReadyStatus(); + + // ACCEL_*OUT_* registers + void getMotion9(int16_t* ax, int16_t* ay, int16_t* az, int16_t* gx, int16_t* gy, int16_t* gz, int16_t* mx, int16_t* my, int16_t* mz); + void getMotion6(int16_t* ax, int16_t* ay, int16_t* az, int16_t* gx, int16_t* gy, int16_t* gz); + void getAcceleration(int16_t* x, int16_t* y, int16_t* z); + int16_t getAccelerationX(); + int16_t getAccelerationY(); + int16_t getAccelerationZ(); + + // TEMP_OUT_* registers + int16_t getTemperature(); + + // GYRO_*OUT_* registers + void getRotation(int16_t* x, int16_t* y, int16_t* z); + int16_t getRotationX(); + int16_t getRotationY(); + int16_t getRotationZ(); + + // EXT_SENS_DATA_* registers + uint8_t getExternalSensorByte(int position); + uint16_t getExternalSensorWord(int position); + uint32_t getExternalSensorDWord(int position); + + // MOT_DETECT_STATUS register + uint8_t getMotionStatus(); + bool getXNegMotionDetected(); + bool getXPosMotionDetected(); + bool getYNegMotionDetected(); + bool getYPosMotionDetected(); + bool getZNegMotionDetected(); + bool getZPosMotionDetected(); + bool getZeroMotionDetected(); + + // I2C_SLV*_DO register + void setSlaveOutputByte(uint8_t num, uint8_t data); + + // I2C_MST_DELAY_CTRL register + bool getExternalShadowDelayEnabled(); + void setExternalShadowDelayEnabled(bool enabled); + bool getSlaveDelayEnabled(uint8_t num); + void setSlaveDelayEnabled(uint8_t num, bool enabled); + + // SIGNAL_PATH_RESET register + void resetGyroscopePath(); + void resetAccelerometerPath(); + void resetTemperaturePath(); + + // MOT_DETECT_CTRL register + uint8_t getAccelerometerPowerOnDelay(); + void setAccelerometerPowerOnDelay(uint8_t delay); + uint8_t getFreefallDetectionCounterDecrement(); + void setFreefallDetectionCounterDecrement(uint8_t decrement); + uint8_t getMotionDetectionCounterDecrement(); + void setMotionDetectionCounterDecrement(uint8_t decrement); + + // USER_CTRL register + bool getFIFOEnabled(); + void setFIFOEnabled(bool enabled); + bool getI2CMasterModeEnabled(); + void setI2CMasterModeEnabled(bool enabled); + void switchSPIEnabled(bool enabled); + void resetFIFO(); + void resetI2CMaster(); + void resetSensors(); + + // PWR_MGMT_1 register + void reset(); + bool getSleepEnabled(); + void setSleepEnabled(bool enabled); + bool getWakeCycleEnabled(); + void setWakeCycleEnabled(bool enabled); + bool getTempSensorEnabled(); + void setTempSensorEnabled(bool enabled); + uint8_t getClockSource(); + void setClockSource(uint8_t source); + + // PWR_MGMT_2 register + uint8_t getWakeFrequency(); + void setWakeFrequency(uint8_t frequency); + bool getStandbyXAccelEnabled(); + void setStandbyXAccelEnabled(bool enabled); + bool getStandbyYAccelEnabled(); + void setStandbyYAccelEnabled(bool enabled); + bool getStandbyZAccelEnabled(); + void setStandbyZAccelEnabled(bool enabled); + bool getStandbyXGyroEnabled(); + void setStandbyXGyroEnabled(bool enabled); + bool getStandbyYGyroEnabled(); + void setStandbyYGyroEnabled(bool enabled); + bool getStandbyZGyroEnabled(); + void setStandbyZGyroEnabled(bool enabled); + + // FIFO_COUNT_* registers + uint16_t getFIFOCount(); + + // FIFO_R_W register + uint8_t getFIFOByte(); + int8_t GetCurrentFIFOPacket(uint8_t *data, uint8_t length); + void setFIFOByte(uint8_t data); + void getFIFOBytes(uint8_t *data, uint8_t length); + + // WHO_AM_I register + uint8_t getDeviceID(); + void setDeviceID(uint8_t id); + + // ======== UNDOCUMENTED/DMP REGISTERS/METHODS ======== + + // XG_OFFS_TC register + uint8_t getOTPBankValid(); + void setOTPBankValid(bool enabled); + int8_t getXGyroOffsetTC(); + void setXGyroOffsetTC(int8_t offset); + + // YG_OFFS_TC register + int8_t getYGyroOffsetTC(); + void setYGyroOffsetTC(int8_t offset); + + // ZG_OFFS_TC register + int8_t getZGyroOffsetTC(); + void setZGyroOffsetTC(int8_t offset); + + // X_FINE_GAIN register + int8_t getXFineGain(); + void setXFineGain(int8_t gain); + + // Y_FINE_GAIN register + int8_t getYFineGain(); + void setYFineGain(int8_t gain); + + // Z_FINE_GAIN register + int8_t getZFineGain(); + void setZFineGain(int8_t gain); + + // XA_OFFS_* registers + int16_t getXAccelOffset(); + void setXAccelOffset(int16_t offset); + + // YA_OFFS_* register + int16_t getYAccelOffset(); + void setYAccelOffset(int16_t offset); + + // ZA_OFFS_* register + int16_t getZAccelOffset(); + void setZAccelOffset(int16_t offset); + + // XG_OFFS_USR* registers + int16_t getXGyroOffset(); + void setXGyroOffset(int16_t offset); + + // YG_OFFS_USR* register + int16_t getYGyroOffset(); + void setYGyroOffset(int16_t offset); + + // ZG_OFFS_USR* register + int16_t getZGyroOffset(); + void setZGyroOffset(int16_t offset); + + // INT_ENABLE register (DMP functions) + bool getIntPLLReadyEnabled(); + void setIntPLLReadyEnabled(bool enabled); + bool getIntDMPEnabled(); + void setIntDMPEnabled(bool enabled); + + // DMP_INT_STATUS + bool getDMPInt5Status(); + bool getDMPInt4Status(); + bool getDMPInt3Status(); + bool getDMPInt2Status(); + bool getDMPInt1Status(); + bool getDMPInt0Status(); + + // INT_STATUS register (DMP functions) + bool getIntPLLReadyStatus(); + bool getIntDMPStatus(); + + // USER_CTRL register (DMP functions) + bool getDMPEnabled(); + void setDMPEnabled(bool enabled); + void resetDMP(); + + // BANK_SEL register + void setMemoryBank(uint8_t bank, bool prefetchEnabled=false, bool userBank=false); + + // MEM_START_ADDR register + void setMemoryStartAddress(uint8_t address); + + // MEM_R_W register + uint8_t readMemoryByte(); + void writeMemoryByte(uint8_t data); + void readMemoryBlock(uint8_t *data, uint16_t dataSize, uint8_t bank=0, uint8_t address=0); + bool writeMemoryBlock(const uint8_t *data, uint16_t dataSize, uint8_t bank=0, uint8_t address=0, bool verify=true, bool useProgMem=false); + bool writeProgMemoryBlock(const uint8_t *data, uint16_t dataSize, uint8_t bank=0, uint8_t address=0, bool verify=true); + + bool writeDMPConfigurationSet(const uint8_t *data, uint16_t dataSize, bool useProgMem=false); + bool writeProgDMPConfigurationSet(const uint8_t *data, uint16_t dataSize); + + // DMP_CFG_1 register + uint8_t getDMPConfig1(); + void setDMPConfig1(uint8_t config); + + // DMP_CFG_2 register + uint8_t getDMPConfig2(); + void setDMPConfig2(uint8_t config); + + // Calibration Routines + void CalibrateGyro(uint8_t Loops = 15); // Fine tune after setting offsets with less Loops. + void CalibrateAccel(uint8_t Loops = 15);// Fine tune after setting offsets with less Loops. + void PID(uint8_t ReadAddress, float kP,float kI, uint8_t Loops); // Does the math + void PrintActiveOffsets(); // See the results of the Calibration + + + + // special methods for MotionApps 2.0 implementation + #ifdef MPU6050_INCLUDE_DMP_MOTIONAPPS20 + + uint8_t dmpInitialize(); + bool dmpPacketAvailable(); + + uint8_t dmpSetFIFORate(uint8_t fifoRate); + uint8_t dmpGetFIFORate(); + uint8_t dmpGetSampleStepSizeMS(); + uint8_t dmpGetSampleFrequency(); + int32_t dmpDecodeTemperature(int8_t tempReg); + + // Register callbacks after a packet of FIFO data is processed + //uint8_t dmpRegisterFIFORateProcess(inv_obj_func func, int16_t priority); + //uint8_t dmpUnregisterFIFORateProcess(inv_obj_func func); + uint8_t dmpRunFIFORateProcesses(); + + // Setup FIFO for various output + uint8_t dmpSendQuaternion(uint_fast16_t accuracy); + uint8_t dmpSendGyro(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendAccel(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendLinearAccel(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendLinearAccelInWorld(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendControlData(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendSensorData(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendExternalSensorData(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendGravity(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendPacketNumber(uint_fast16_t accuracy); + uint8_t dmpSendQuantizedAccel(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendEIS(uint_fast16_t elements, uint_fast16_t accuracy); + + // Get Fixed Point data from FIFO + uint8_t dmpGetAccel(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetAccel(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetAccel(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetQuaternion(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetQuaternion(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetQuaternion(Quaternion *q, const uint8_t* packet=0); + uint8_t dmpGet6AxisQuaternion(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGet6AxisQuaternion(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGet6AxisQuaternion(Quaternion *q, const uint8_t* packet=0); + uint8_t dmpGetRelativeQuaternion(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetRelativeQuaternion(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetRelativeQuaternion(Quaternion *data, const uint8_t* packet=0); + uint8_t dmpGetGyro(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyro(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyro(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpSetLinearAccelFilterCoefficient(float coef); + uint8_t dmpGetLinearAccel(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetLinearAccel(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetLinearAccel(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetLinearAccel(VectorInt16 *v, VectorInt16 *vRaw, VectorFloat *gravity); + uint8_t dmpGetLinearAccelInWorld(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetLinearAccelInWorld(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetLinearAccelInWorld(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetLinearAccelInWorld(VectorInt16 *v, VectorInt16 *vReal, Quaternion *q); + uint8_t dmpGetGyroAndAccelSensor(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyroAndAccelSensor(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyroAndAccelSensor(VectorInt16 *g, VectorInt16 *a, const uint8_t* packet=0); + uint8_t dmpGetGyroSensor(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyroSensor(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyroSensor(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetControlData(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetTemperature(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGravity(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGravity(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetGravity(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetGravity(VectorFloat *v, Quaternion *q); + uint8_t dmpGetUnquantizedAccel(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetUnquantizedAccel(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetUnquantizedAccel(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetQuantizedAccel(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetQuantizedAccel(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetQuantizedAccel(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetExternalSensorData(int32_t *data, uint16_t size, const uint8_t* packet=0); + uint8_t dmpGetEIS(int32_t *data, const uint8_t* packet=0); + + uint8_t dmpGetEuler(float *data, Quaternion *q); + uint8_t dmpGetYawPitchRoll(float *data, Quaternion *q, VectorFloat *gravity); + + // Get Floating Point data from FIFO + uint8_t dmpGetAccelFloat(float *data, const uint8_t* packet=0); + uint8_t dmpGetQuaternionFloat(float *data, const uint8_t* packet=0); + + uint8_t dmpProcessFIFOPacket(const unsigned char *dmpData); + uint8_t dmpReadAndProcessFIFOPacket(uint8_t numPackets, uint8_t *processed=NULL); + + uint8_t dmpSetFIFOProcessedCallback(void (*func) (void)); + + uint8_t dmpInitFIFOParam(); + uint8_t dmpCloseFIFO(); + uint8_t dmpSetGyroDataSource(uint8_t source); + uint8_t dmpDecodeQuantizedAccel(); + uint32_t dmpGetGyroSumOfSquare(); + uint32_t dmpGetAccelSumOfSquare(); + void dmpOverrideQuaternion(long *q); + uint16_t dmpGetFIFOPacketSize(); + uint8_t dmpGetCurrentFIFOPacket(uint8_t *data); // overflow proof + #endif + + // special methods for MotionApps 4.1 implementation + #ifdef MPU6050_INCLUDE_DMP_MOTIONAPPS41 + + uint8_t dmpInitialize(); + bool dmpPacketAvailable(); + + uint8_t dmpSetFIFORate(uint8_t fifoRate); + uint8_t dmpGetFIFORate(); + uint8_t dmpGetSampleStepSizeMS(); + uint8_t dmpGetSampleFrequency(); + int32_t dmpDecodeTemperature(int8_t tempReg); + + // Register callbacks after a packet of FIFO data is processed + //uint8_t dmpRegisterFIFORateProcess(inv_obj_func func, int16_t priority); + //uint8_t dmpUnregisterFIFORateProcess(inv_obj_func func); + uint8_t dmpRunFIFORateProcesses(); + + // Setup FIFO for various output + uint8_t dmpSendQuaternion(uint_fast16_t accuracy); + uint8_t dmpSendGyro(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendAccel(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendLinearAccel(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendLinearAccelInWorld(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendControlData(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendSensorData(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendExternalSensorData(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendGravity(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendPacketNumber(uint_fast16_t accuracy); + uint8_t dmpSendQuantizedAccel(uint_fast16_t elements, uint_fast16_t accuracy); + uint8_t dmpSendEIS(uint_fast16_t elements, uint_fast16_t accuracy); + + // Get Fixed Point data from FIFO + uint8_t dmpGetAccel(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetAccel(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetAccel(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetQuaternion(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetQuaternion(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetQuaternion(Quaternion *q, const uint8_t* packet=0); + uint8_t dmpGet6AxisQuaternion(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGet6AxisQuaternion(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGet6AxisQuaternion(Quaternion *q, const uint8_t* packet=0); + uint8_t dmpGetRelativeQuaternion(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetRelativeQuaternion(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetRelativeQuaternion(Quaternion *data, const uint8_t* packet=0); + uint8_t dmpGetGyro(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyro(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyro(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetMag(int16_t *data, const uint8_t* packet=0); + uint8_t dmpSetLinearAccelFilterCoefficient(float coef); + uint8_t dmpGetLinearAccel(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetLinearAccel(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetLinearAccel(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetLinearAccel(VectorInt16 *v, VectorInt16 *vRaw, VectorFloat *gravity); + uint8_t dmpGetLinearAccelInWorld(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetLinearAccelInWorld(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetLinearAccelInWorld(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetLinearAccelInWorld(VectorInt16 *v, VectorInt16 *vReal, Quaternion *q); + uint8_t dmpGetGyroAndAccelSensor(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyroAndAccelSensor(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyroAndAccelSensor(VectorInt16 *g, VectorInt16 *a, const uint8_t* packet=0); + uint8_t dmpGetGyroSensor(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyroSensor(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetGyroSensor(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetControlData(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetTemperature(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGravity(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetGravity(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetGravity(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetGravity(VectorFloat *v, Quaternion *q); + uint8_t dmpGetUnquantizedAccel(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetUnquantizedAccel(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetUnquantizedAccel(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetQuantizedAccel(int32_t *data, const uint8_t* packet=0); + uint8_t dmpGetQuantizedAccel(int16_t *data, const uint8_t* packet=0); + uint8_t dmpGetQuantizedAccel(VectorInt16 *v, const uint8_t* packet=0); + uint8_t dmpGetExternalSensorData(int32_t *data, uint16_t size, const uint8_t* packet=0); + uint8_t dmpGetEIS(int32_t *data, const uint8_t* packet=0); + + uint8_t dmpGetEuler(float *data, Quaternion *q); + uint8_t dmpGetYawPitchRoll(float *data, Quaternion *q, VectorFloat *gravity); + + // Get Floating Point data from FIFO + uint8_t dmpGetAccelFloat(float *data, const uint8_t* packet=0); + uint8_t dmpGetQuaternionFloat(float *data, const uint8_t* packet=0); + + uint8_t dmpProcessFIFOPacket(const unsigned char *dmpData); + uint8_t dmpReadAndProcessFIFOPacket(uint8_t numPackets, uint8_t *processed=NULL); + + uint8_t dmpSetFIFOProcessedCallback(void (*func) (void)); + + uint8_t dmpInitFIFOParam(); + uint8_t dmpCloseFIFO(); + uint8_t dmpSetGyroDataSource(uint8_t source); + uint8_t dmpDecodeQuantizedAccel(); + uint32_t dmpGetGyroSumOfSquare(); + uint32_t dmpGetAccelSumOfSquare(); + void dmpOverrideQuaternion(long *q); + uint16_t dmpGetFIFOPacketSize(); + #endif + + private: + uint8_t devAddr; + uint8_t buffer[14]; + #if defined(MPU6050_INCLUDE_DMP_MOTIONAPPS20) or defined(MPU6050_INCLUDE_DMP_MOTIONAPPS41) + uint8_t *dmpPacketBuffer; + uint16_t dmpPacketSize; + #endif +}; + +#endif /* _MPU6050_H_ */ diff --git a/platformio.ini b/platformio.ini new file mode 100644 index 0000000..9d2fcb9 --- /dev/null +++ b/platformio.ini @@ -0,0 +1,71 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[platformio] +lib_dir = lib +include_dir = lib + +[common_env_data] +upload_speed = 921600 +monitor_speed = 115200 +platform = espressif8266 +framework = arduino +board = d1_mini +build_unflags = +build_flags = #-O0 -Wl,-Map,output.map + -D BAUD=${common_env_data.monitor_speed} + #-D ACTIVATE_OTA # TODO: Download html files to FS to reduce image size + -D ACTIVATE_PUSH + #-D SKIP_SLEEPMODE + -D USE_LITTLEFS=true + -D EMBED_HTML + -D CFG_APPVER="\"0.2.0\"" +lib_deps = +# https://github.com/jrowberg/i2cdevlib.git # Using local copy of this library + https://github.com/codeplea/tinyexpr + https://github.com/graphitemaster/incbin + https://github.com/khoih-prog/ESP_MultiResetDetector + https://github.com/thijse/Arduino-Log + https://github.com/bblanchon/ArduinoJson + https://github.com/PaulStoffregen/OneWire + https://github.com/tzapu/WiFiManager + https://github.com/milesburton/Arduino-Temperature-Control-Library + +[env:gravity-debug] +upload_speed = ${common_env_data.upload_speed} +monitor_speed = ${common_env_data.monitor_speed} +framework = ${common_env_data.framework} +platform = ${common_env_data.platform} +extra_scripts = script/copy_firmware.py +build_unflags = ${common_env_data.build_unflags} +build_flags = + ${common_env_data.build_flags} + -D LOG_LEVEL=6 +lib_deps = + ${common_env_data.lib_deps} +board = ${common_env_data.board} +build_type = debug +board_build.filesystem = littlefs + +[env:gravity-release] +upload_speed = ${common_env_data.upload_speed} +monitor_speed = ${common_env_data.monitor_speed} +framework = ${common_env_data.framework} +platform = ${common_env_data.platform} +extra_scripts = script/copy_firmware.py +build_unflags = ${common_env_data.build_unflags} +build_flags = + ${common_env_data.build_flags} + -D LOG_LEVEL=5 +lib_deps = + ${common_env_data.lib_deps} +board = ${common_env_data.board} +build_type = release +board_build.filesystem = littlefs diff --git a/script/copy_firmware.py b/script/copy_firmware.py new file mode 100644 index 0000000..f6b162d --- /dev/null +++ b/script/copy_firmware.py @@ -0,0 +1,34 @@ +Import("env") +import shutil + +def get_build_flag_value(flag_name): + build_flags = env.ParseFlags(env['BUILD_FLAGS']) + flags_with_value_list = [build_flag for build_flag in build_flags.get('CPPDEFINES') if type(build_flag) == list] + defines = {k: v for (k, v) in flags_with_value_list} + return defines.get(flag_name) + +def after_build(source, target, env): + print( "Executing custom step " ) + dir = env.GetLaunchDir() + name = env.get( "PIOENV" ) + source = dir + "\\.pio\\build\\" + name + "\\firmware.bin" + if name == "gravity-debug" : + target = dir + "\\bin\\firmware-debug.bin" + if name == "gravity-release" : + target = dir + "\\bin\\firmware.bin" + print( "Copy file : " + source + " -> " + target ) + shutil.copyfile( source, target ) + + target = dir + "\\bin\\version.json" + ver = get_build_flag_value("CFG_APPVER") + print( "Creating version.json" ) + f = open( target, "w" ) + f.write( "{ \"project\":\"gravmon\", \"version\":" + ver + " }" ) + f.close() + + +print( "Adding custom build step: ") +#env.AddPreAction("buildprog", after_build) +env.AddPostAction("buildprog", after_build) +#env.AddPreAction("upload", after_build) +#env.AddPostAction("upload", after_build) diff --git a/src/calc.cpp b/src/calc.cpp new file mode 100644 index 0000000..5a724c7 --- /dev/null +++ b/src/calc.cpp @@ -0,0 +1,99 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include "calc.h" +#include "helper.h" +#include "config.h" +#include "tinyexpr.h" +#include "tempsensor.h" + +//#define LOG_LEVEL 5 + +// +// Calculates gravity according to supplied formula, compatible with iSpindle/Fermentrack formula +// +double calculateGravity( double angle, double temp ) { + const char* formula = myConfig.getGravityFormula(); +#if LOG_LEVEL==6 + Log.verbose(F("CALC: Calculating gravity for angle %F, temp %F." CR), angle, temp); + Log.verbose(F("CALC: Formula %s." CR), formula); +#endif + + if( strlen(formula) == 0 ) + return 0.0; + + // Store variable names and pointers. + te_variable vars[] = {{"tilt", &angle}, {"temp", &temp}}; + + int err; + // Compile the expression with variables. + te_expr *expr = te_compile(formula, vars, 2, &err); + + if (expr) { + double g = te_eval(expr); + te_free(expr); + +#if LOG_LEVEL==6 + Log.verbose(F("CALC: Calculated gravity is %F." CR), g); +#endif + return g; + } + + Log.error(F("CALC: Failed to parse expression %d." CR), err); + return 0; +} + +// +// Do a standard gravity temperature correction. This is a simple way to adjust for differnt worth temperatures +// +double gravityTemperatureCorrection( double gravity, double temp, double calTemp) { +#if LOG_LEVEL==6 + Log.verbose(F("CALC: Adjusting gravity based on temperature, gravity %F, temp %F, calTemp %F." CR), gravity, temp, calTemp); +#endif + + double tempF = convertCtoF( temp ); + double calTempF = convertCtoF(calTemp); + const char* formula = "gravity*((1.00130346-0.000134722124*temp+0.00000204052596*temp^2-0.00000000232820948*temp^3)/(1.00130346-0.000134722124*cal+0.00000204052596*cal^2-0.00000000232820948*cal^3))"; + + // Store variable names and pointers. + te_variable vars[] = {{"gravity", &gravity}, {"temp", &tempF}, {"cal", &calTempF}}; + + int err; + // Compile the expression with variables. + te_expr *expr = te_compile(formula, vars, 3, &err); + + if (expr) { + double g = te_eval(expr); + te_free(expr); + +#if LOG_LEVEL==6 + Log.verbose(F("CALC: Corrected gravity is %F." CR), g); +#endif + return g; + } + + Log.error(F("CALC: Failed to parse expression %d, no correction has been made." CR), err); + return gravity; +} + +// EOF \ No newline at end of file diff --git a/src/calc.h b/src/calc.h new file mode 100644 index 0000000..ae21be1 --- /dev/null +++ b/src/calc.h @@ -0,0 +1,36 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#ifndef _CALC_H +#define _CALC_H + +// Includes +#include "helper.h" + +// Functions +double calculateGravity( double angle, double temp ); +double gravityTemperatureCorrection( double gravity, double temp, double calTemp = 20 ); + +#endif // _CALC_H + +// EOF \ No newline at end of file diff --git a/src/config.cpp b/src/config.cpp new file mode 100644 index 0000000..a92d17d --- /dev/null +++ b/src/config.cpp @@ -0,0 +1,232 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include "config.h" +#include "helper.h" +#include + +Config myConfig; + +// +// Create the config class with default settings. +// +Config::Config() { + // Assiging default values + sprintf(&id[0], "%6x", (unsigned int) ESP.getChipId() ); + sprintf(&mDNS[0], "" WIFI_MDNS "%s", getID() ); + setTempFormat('C'); + setPushInterval(900); // 15 minutes + setVoltageFactor(1.59); // Conversion factor for battery + setTempSensorAdj(0.0); + setGravityTempAdj(false); + gyroCalibration = { 0, 0, 0, 0, 0 ,0 }; + saveNeeded = false; +} + +// +// Populate the json document with all configuration parameters (used in both web and saving to file) +// +void Config::createJson(DynamicJsonDocument& doc) { + doc[ CFG_PARAM_MDNS ] = getMDNS(); + doc[ CFG_PARAM_ID ] = getID(); + doc[ CFG_PARAM_OTA ] = getOtaURL(); + doc[ CFG_PARAM_TEMPFORMAT ] = String( getTempFormat() ); + doc[ CFG_PARAM_PUSH_BREWFATHER ] = getBrewfatherPushTarget(); + doc[ CFG_PARAM_PUSH_HTTP ] = getHttpPushTarget(); + doc[ CFG_PARAM_PUSH_INTERVAL ] = getPushInterval(); + doc[ CFG_PARAM_VOLTAGEFACTOR ] = getVoltageFactor(); + doc[ CFG_PARAM_GRAVITY_FORMULA ] = getGravityFormula(); + doc[ CFG_PARAM_TEMP_ADJ ] = getTempSensorAdj(); + doc[ CFG_PARAM_GRAVITY_TEMP_ADJ ] = isGravityTempAdj(); + + JsonObject cal = doc.createNestedObject( CFG_PARAM_GYRO_CALIBRATION ); + cal["ax"] = gyroCalibration.ax; + cal["ay"] = gyroCalibration.ay; + cal["az"] = gyroCalibration.az; + cal["gx"] = gyroCalibration.gx; + cal["gy"] = gyroCalibration.gy; + cal["gz"] = gyroCalibration.gz; +} + +// +// Save json document to file +// +bool Config::saveFile() { + if( !saveNeeded ) { +#if LOG_LEVEL==6 + Log.verbose(F("CFG : Skipping save, not needed." CR)); +#endif + return true; + } + +#if LOG_LEVEL==6 + Log.verbose(F("CFG : Saving configuration to file." CR)); +#endif + + File configFile = LittleFS.open(CFG_FILENAME, "w"); + + if (!configFile) { + Log.error(F("CFG : Failed to open file " CFG_FILENAME " for save." CR)); + return false; + } + + DynamicJsonDocument doc(CFG_JSON_BUFSIZE); + createJson( doc ); +#if LOG_LEVEL==6 + serializeJson(doc, Serial); + Serial.print( CR ); +#endif + serializeJson(doc, configFile); + configFile.flush(); + configFile.close(); + + saveNeeded = false; + myConfig.debug(); + Log.notice(F("CFG : Configuration saved to " CFG_FILENAME "." CR)); + return true; +} + +// +// Load config file from disk +// +bool Config::loadFile() { +#if LOG_LEVEL==6 + Log.verbose(F("CFG : Loading configuration from file." CR)); +#endif + + if (!LittleFS.exists(CFG_FILENAME)) { + Log.error(F("CFG : Configuration file does not exist " CFG_FILENAME "." CR)); + return false; + } + + File configFile = LittleFS.open(CFG_FILENAME, "r"); + + if (!configFile) { + Log.error(F("CFG : Failed to open " CFG_FILENAME "." CR)); + return false; + } + + DynamicJsonDocument doc(CFG_JSON_BUFSIZE); + DeserializationError err = deserializeJson(doc, configFile); +#if LOG_LEVEL==6 + serializeJson(doc, Serial); + Serial.print( CR ); +#endif + configFile.close(); + + if( err ) { + Log.error(F("CFG : Failed to parse " CFG_FILENAME " file, Err: %s, %d." CR), err.c_str(), doc.capacity()); + return false; + } + +#if LOG_LEVEL==6 + Log.verbose(F("CFG : Parsed configuration file." CR)); +#endif + if( !doc[ CFG_PARAM_OTA ].isNull() ) + setOtaURL( doc[ CFG_PARAM_OTA ] ); + if( !doc[ CFG_PARAM_MDNS ].isNull() ) + setMDNS( doc[ CFG_PARAM_MDNS ] ); + if( !doc[ CFG_PARAM_TEMPFORMAT ].isNull() ) { + String s = doc[ CFG_PARAM_TEMPFORMAT ]; + setTempFormat( s.charAt(0) ); + } + if( !doc[ CFG_PARAM_PUSH_BREWFATHER ].isNull() ) + setBrewfatherPushTarget( doc[ CFG_PARAM_PUSH_BREWFATHER ] ); + if( !doc[ CFG_PARAM_PUSH_HTTP ].isNull() ) + setHttpPushTarget( doc[ CFG_PARAM_PUSH_HTTP ] ); + if( !doc[ CFG_PARAM_PUSH_INTERVAL ].isNull() ) + setPushInterval( doc[ CFG_PARAM_PUSH_INTERVAL ].as() ); + if( !doc[ CFG_PARAM_VOLTAGEFACTOR ].isNull() ) + setVoltageFactor( doc[ CFG_PARAM_VOLTAGEFACTOR ].as() ); + if( !doc[ CFG_PARAM_GRAVITY_FORMULA ].isNull() ) + setGravityFormula( doc[ CFG_PARAM_GRAVITY_FORMULA ] ); + if( !doc[ CFG_PARAM_TEMP_ADJ ].isNull() ) + setTempSensorAdj( doc[ CFG_PARAM_TEMP_ADJ ].as() ); + + if( !doc[ CFG_PARAM_GYRO_CALIBRATION ]["ax"].isNull() ) + gyroCalibration.ax = doc[ CFG_PARAM_GYRO_CALIBRATION ]["ax"]; + if( !doc[ CFG_PARAM_GYRO_CALIBRATION ]["ay"].isNull() ) + gyroCalibration.ay = doc[ CFG_PARAM_GYRO_CALIBRATION ]["ay"]; + if( !doc[ CFG_PARAM_GYRO_CALIBRATION ]["az"].isNull() ) + gyroCalibration.az = doc[ CFG_PARAM_GYRO_CALIBRATION ]["az"]; + if( !doc[ CFG_PARAM_GYRO_CALIBRATION ]["gx"].isNull() ) + gyroCalibration.gx = doc[ CFG_PARAM_GYRO_CALIBRATION ]["gx"]; + if( !doc[ CFG_PARAM_GYRO_CALIBRATION ]["gy"].isNull() ) + gyroCalibration.gy = doc[ CFG_PARAM_GYRO_CALIBRATION ]["gy"]; + if( !doc[ CFG_PARAM_GYRO_CALIBRATION ]["gz"].isNull() ) + gyroCalibration.gz = doc[ CFG_PARAM_GYRO_CALIBRATION ]["gz"]; + + myConfig.debug(); + saveNeeded = false; // Reset save flag + Log.notice(F("CFG : Configuration file " CFG_FILENAME " loaded." CR)); + return true; +} + +// +// Check if file system can be mounted, if not we format it. +// +void Config::formatFileSystem() { +#if LOG_LEVEL==6 + Log.verbose(F("CFG : Formating filesystem." CR)); +#endif + LittleFS.format(); +} + +// +// Check if file system can be mounted, if not we format it. +// +void Config::checkFileSystem() { +#if LOG_LEVEL==6 + Log.verbose(F("CFG : Checking if filesystem is valid." CR)); +#endif + + if (LittleFS.begin()) { + Log.notice(F("CFG : Filesystem mounted." CR)); + } else { + Log.error(F("CFG : Unable to mount file system, formatting..." CR)); + LittleFS.format(); + } +} + +// +// Dump the configuration to the serial port +// +void Config::debug() { +#if LOG_LEVEL==6 + Log.verbose(F("CFG : Dumping configration " CFG_FILENAME "." CR)); + Log.verbose(F("CFG : ID; '%s'." CR), getID()); + Log.verbose(F("CFG : mDNS; '%s'." CR), getMDNS() ); + Log.verbose(F("CFG : OTA; '%s'." CR), getOtaURL() ); + Log.verbose(F("CFG : Temp; %c." CR), getTempFormat() ); + Log.verbose(F("CFG : Temp Adj; %F." CR), getTempSensorAdj() ); + Log.verbose(F("CFG : VoltageFactor; %F." CR), getVoltageFactor() ); + Log.verbose(F("CFG : Gravity formula; '%s'." CR), getGravityFormula() ); + Log.verbose(F("CFG : Push brewfather; '%s'." CR), getBrewfatherPushTarget() ); + Log.verbose(F("CFG : Push http; '%s'." CR), getHttpPushTarget() ); + Log.verbose(F("CFG : Push interval; %d." CR), getPushInterval() ); +// Log.verbose(F("CFG : Accel offset\t%d\t%d\t%d" CR), gyroCalibration.ax, gyroCalibration.ay, gyroCalibration.az ); +// Log.verbose(F("CFG : Gyro offset \t%d\t%d\t%d" CR), gyroCalibration.gx, gyroCalibration.gy, gyroCalibration.gz ); +#endif +} + +// EOF \ No newline at end of file diff --git a/src/config.h b/src/config.h new file mode 100644 index 0000000..e621524 --- /dev/null +++ b/src/config.h @@ -0,0 +1,175 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#ifndef _CONFIG_H +#define _CONFIG_H + +// Includes +#include "helper.h" +#include +#include +#include + +// defintions +#define CFG_JSON_BUFSIZE 1000 + +#define CFG_APPNAME "GravityMon " // Name of firmware +#define CFG_FILENAME "/gravitymon.json" // Name of config file + +#define WIFI_DEFAULT_SSID "GravityMon" // Name of created SSID +#define WIFI_DEFAULT_PWD "password" // Password for created SSID +#define WIFI_MDNS "gravitymon" // Prefix for MDNS name +#define WIFI_PORTAL_TIMEOUT 120 // Number of seconds until the config portal is closed + +// These are used in API + Savefile +#define CFG_PARAM_ID "id" +#define CFG_PARAM_MDNS "mdns" // Device name +#define CFG_PARAM_OTA "ota-url" // Base URL for OTA +#define CFG_PARAM_PUSH_BREWFATHER "brewfather-push" // URL (brewfather format) +#define CFG_PARAM_PUSH_HTTP "http-push" // URL (iSpindle format) +#define CFG_PARAM_PUSH_INTERVAL "push-interval" // Time between push +#define CFG_PARAM_TEMPFORMAT "temp-format" // C or F +#define CFG_PARAM_VOLTAGEFACTOR "voltage-factor" // Factor to calculate the battery voltage +#define CFG_PARAM_GRAVITY_FORMULA "gravity-formula" // Formula for calculating gravity +#define CFG_PARAM_GRAVITY_TEMP_ADJ "gravity-temp-adjustment" // True/False. Adjust gravity for temperature +#define CFG_PARAM_TEMP_ADJ "temp-adjustment-value" // Correction value for temp sensor +#define CFG_PARAM_GYRO_CALIBRATION "gyro-calibration-data" // READ ONLY + +// These are used in API's +#define CFG_PARAM_APP_NAME "app-name" +#define CFG_PARAM_APP_VER "app-ver" +#define CFG_PARAM_ANGLE "angle" +#define CFG_PARAM_GRAVITY "gravity" +#define CFG_PARAM_TEMP_C "temp-c" +#define CFG_PARAM_TEMP_F "temp-f" +#define CFG_PARAM_BATTERY "battery" +#define CFG_PARAM_SLEEP_MODE "sleep-mode" +#define CFG_PARAM_RSSI "rssi" + +// Used for holding sensordata or sensoroffsets +struct RawGyroData { + int16_t ax; // Raw Acceleration + int16_t ay; + int16_t az; + + int16_t gx; // Raw Position + int16_t gy; + int16_t gz; + + int16_t temp; // Only for information (temperature of chip) +}; + +// Main configuration class +class Config { + private: + bool saveNeeded; + + // Device configuration + char id[10]; + char mDNS[30]; + char otaURL[200]; + char tempFormat; // C, F + float voltageFactor; + float tempSensorAdj; // This value will be added to the read sensor value + + // Push target settings + char brewfatherPushTarget[200]; + char httpPushTarget[200]; + int pushInterval; + + // Gravity and temperature calculations + char gravityFormula[200]; + bool gravityTempAdj; // true, false + char gravityFormat; // G, P + + // Gyro calibration data + RawGyroData gyroCalibration; // Holds the gyro calibration constants (6 * int16_t) + + void debug(); + void formatFileSystem(); + + public: + Config(); + const char* getID() { return &id[0]; }; + + const char* getMDNS() { return &mDNS[0]; } + void setMDNS( const char* s ) { strncpy( &mDNS[0], s, sizeof(mDNS)-1); saveNeeded = true; } + + const char* getOtaURL() { return &otaURL[0]; } + void setOtaURL( const char* s ) { strncpy( &otaURL[0], s, sizeof(otaURL)-1); saveNeeded = true; } + bool isOtaActive() { return strlen(&otaURL[0])>0?true:false; } + + const char* getBrewfatherPushTarget() { return &brewfatherPushTarget[0]; } + void setBrewfatherPushTarget( const char* s ) { strncpy(&brewfatherPushTarget[0], s, sizeof(brewfatherPushTarget)-1); saveNeeded = true; } + bool isBrewfatherActive() { return strlen(&brewfatherPushTarget[0])>0?true:false; } + + const char* getHttpPushTarget() { return &httpPushTarget[0]; } + void setHttpPushTarget( const char* s ) { strncpy(&httpPushTarget[0], s, sizeof(httpPushTarget)-1); saveNeeded = true; } + bool isHttpActive() { return strlen(&httpPushTarget[0])>0?true:false; } + + int getPushInterval() { return pushInterval; } + void setPushInterval( int v ) { pushInterval = v; saveNeeded = true; } + void setPushInterval( const char* s ) { pushInterval = atoi(s); saveNeeded = true; } + + char getTempFormat() { return tempFormat; } + void setTempFormat( char c ) { tempFormat = c; saveNeeded = true; } + bool isTempC() { return tempFormat=='C'?false:true; }; + bool isTempF() { return tempFormat=='F'?false:true; }; + + float getVoltageFactor() { return voltageFactor; } + void setVoltageFactor( float f ) { voltageFactor = f; saveNeeded = true; } + void setVoltageFactor( const char* s ) { voltageFactor = atof(s); saveNeeded = true; } + + float getTempSensorAdj() { return tempSensorAdj; } + void setTempSensorAdj( float f ) { tempSensorAdj = f; saveNeeded = true; } + void setTempSensorAdj( const char* s ) { tempSensorAdj = atof(s); saveNeeded = true; } + + const char* getGravityFormula() { return &gravityFormula[0]; } + void setGravityFormula( const char* s ) { strncpy(&gravityFormula[0], s, sizeof(gravityFormula)-1); saveNeeded = true; } + + bool isGravityTempAdj() { return gravityTempAdj; } + void setGravityTempAdj( bool b ) { gravityTempAdj = b; saveNeeded = true; } + + char getGravityFormat() { return gravityFormat; } + void setGravityFormat( char c ) { gravityFormat = c; saveNeeded = true; } + bool isGravitySG() { return gravityFormat=='G'?false:true; }; + bool isGravityPlato() { return gravityFormat=='P'?false:true; }; + + const RawGyroData& getGyroCalibration() { return gyroCalibration; } + void setGyroCalibration( const RawGyroData &r ) { gyroCalibration = r; saveNeeded = true; } + + // IO functions + void createJson(DynamicJsonDocument& doc); + bool saveFile(); + bool loadFile(); + void checkFileSystem(); + bool isSaveNeeded() { return saveNeeded; }; + void setSaveNeeded() { saveNeeded = true; }; +}; + +// Global instance created +extern Config myConfig; + +#endif // _CONFIG_H + +// EOF \ No newline at end of file diff --git a/src/gyro.cpp b/src/gyro.cpp new file mode 100644 index 0000000..0936d46 --- /dev/null +++ b/src/gyro.cpp @@ -0,0 +1,327 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include "gyro.h" +#include "helper.h" + +GyroSensor myGyro; + +#define SENSOR_MOVING_THREASHOLD 500 +#define SENSOR_READ_COUNT 50 +#define SENSOR_READ_DELAY 3150 // us, empirical, to hold sampling to 200 Hz + +//#define GYRO_SHOW_MINMAX // Will calculate the min/max values when doing calibration +//#define GYRO_CALIBRATE_STARTUP // Will calibrate sensor at startup + +// +// Initialize the sensor chip. +// +bool GyroSensor::setup() { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Setting up hardware." CR)); +#endif + Wire.begin(D3, D4); + Wire.setClock(400000); // 400kHz I2C clock. Comment this line if having compilation difficulties + accelgyro.initialize(); + + if( !accelgyro.testConnection() ) { + Log.error(F("GYRO: Failed to connect to MPU6050 (gyro)." CR)); + sensorConnected = false; + } else { + + Log.notice(F("GYRO: Connected to MPU6050 (gyro)." CR)); + sensorConnected = true; + + // Configure ethe sensor + accelgyro.setTempSensorEnabled(true); + accelgyro.setFullScaleAccelRange(MPU6050_ACCEL_FS_2); + accelgyro.setFullScaleGyroRange(MPU6050_GYRO_FS_250); + accelgyro.setDLPFMode(MPU6050_DLPF_BW_5); + accelgyro.setRate(17); + + // For now we run the calibration at start. + #if defined ( GYRO_CALIBRATE_STARTUP ) + calibrateSensor(); + #endif + + // Once we have calibration values stored we just apply them from the config. + calibrationOffset = myConfig.getGyroCalibration(); + applyCalibration(); + } + + return sensorConnected; +} + +// +// Set sensor in sleep mode to conserve battery +// +void GyroSensor::enterSleep() { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Setting up hardware." CR)); +#endif + accelgyro.setSleepEnabled( true ); +} + +// +// Do a number of reads to get a more stable value. +// +void GyroSensor::readSensor(RawGyroData &raw, const int noIterations, const int delayTime) { + RawGyroDataL average = { 0, 0, 0, 0, 0, 0 }; + +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Reading sensor with %d iterations %d us delay." CR), noIterations, delayTime ); +#endif + // Set some initial values +#if defined( GYRO_SHOW_MINMAX ) + RawGyroData min, max; + //accelgyro.getRotation( &min.gx, &min.gy, &min.gz ); + accelgyro.getAcceleration( &min.ax, &min.ay, &min.az ); + min.temp = accelgyro.getTemperature(); + max = min; +#endif + + for(int cnt = 0; cnt < noIterations ; cnt ++) { + accelgyro.getRotation( &raw.gx, &raw.gy, &raw.gz ); + accelgyro.getAcceleration( &raw.ax, &raw.ay, &raw.az ); + raw.temp = accelgyro.getTemperature(); + + average.ax += raw.ax; + average.ay += raw.ay; + average.az += raw.az; + average.gx += raw.gx; + average.gy += raw.gy; + average.gz += raw.gz; + average.temp += raw.temp; + + // Log what the minium value is +#if defined( GYRO_SHOW_MINMAX ) + if( raw.ax < min.ax ) min.ax = raw.ax; + if( raw.ay < min.ay ) min.ay = raw.ay; + if( raw.az < min.az ) min.az = raw.az; + if( raw.gx < min.gx ) min.gx = raw.gx; + if( raw.gy < min.gy ) min.gy = raw.gy; + if( raw.gz < min.gz ) min.gz = raw.gz; + if( raw.temp < min.temp ) min.temp = raw.temp; + + // Log what the maximum value is + if( raw.ax > max.ax ) max.ax = raw.ax; + if( raw.ay > max.ay ) max.ay = raw.ay; + if( raw.az > max.az ) max.az = raw.az; + if( raw.gx > max.gx ) max.gx = raw.gx; + if( raw.gy > max.gy ) max.gy = raw.gy; + if( raw.gz > max.gz ) max.gz = raw.gz; + if( raw.temp > max.temp ) max.temp = raw.temp; +#endif + + delayMicroseconds( delayTime ); + } + + raw.ax = average.ax/noIterations; + raw.ay = average.ay/noIterations; + raw.az = average.az/noIterations; + raw.gx = average.gx/noIterations; + raw.gy = average.gy/noIterations; + raw.gz = average.gz/noIterations; + raw.temp = average.temp/noIterations; + +#if LOG_LEVEL==6 + #if defined( GYRO_SHOW_MINMAX ) + Log.verbose(F("GYRO: Min \t%d\t%d\t%d\t%d\t%d\t%d\t%d." CR), min.ax, min.ay, min.az, min.gx, min.gy, min.gz, min.temp ); + Log.verbose(F("GYRO: Max \t%d\t%d\t%d\t%d\t%d\t%d\t%d." CR), max.ax, max.ay, max.az, max.gx, max.gy, max.gz, max.temp ); + #endif + Log.verbose(F("GYRO: Average\t%d\t%d\t%d\t%d\t%d\t%d\t%d." CR), raw.ax, raw.ay, raw.az, raw.gx, raw.gy, raw.gz, raw.temp ); + //Log.verbose(F("GYRO: Result \t%d\t%d\t%d\t%d\t%d\t%d." CR), average.ax/noIterations, average.ay/noIterations, average.az/noIterations, + // average.gx/noIterations, average.gy/noIterations, average.gz/noIterations ); +#endif +} + +// +// Calcuate the angles (tilt) +// +double GyroSensor::calculateAngle(RawGyroData &raw) { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Calculating the angle." CR) ); +#endif + + // Source: https://www.nxp.com/docs/en/application-note/AN3461.pdf + double v = (acos( raw.ay / sqrt( raw.ax*raw.ax + raw.ay*raw.ay + raw.az*raw.az ) ) *180.0 / PI); + //Log.notice(F("GYRO: angle = %F." CR), v ); + //double v = (acos( raw.az / sqrt( raw.ax*raw.ax + raw.ay*raw.ay + raw.az*raw.az ) ) *180.0 / PI); + //Log.notice(F("GYRO: angle = %F." CR), v ); + +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: angle = %F." CR), v ); +#endif + return v; +} + +// +// Check if the values are high that indicate that the sensor is moving. +// +bool GyroSensor::isSensorMoving(RawGyroData &raw) { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Checking for sensor movement." CR) ); +#endif + + int x = abs(raw.gx), y = abs(raw.gy), z = abs(raw.gz); + + if( x>SENSOR_MOVING_THREASHOLD || y>SENSOR_MOVING_THREASHOLD || z>SENSOR_MOVING_THREASHOLD ) { + Log.notice(F("GYRO: Movement detected (%d)\t%d\t%d\t%d." CR), SENSOR_MOVING_THREASHOLD, x, y, z); + return true; + } + + return false; +} + +// +// Read the tilt angle from the gyro. +// +bool GyroSensor::read() { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Getting new gyro position." CR) ); +#endif + + RawGyroData raw; + readSensor( raw, SENSOR_READ_COUNT, SENSOR_READ_DELAY ); + + // If the sensor is unstable we return false to signal we dont have valid value + if( isSensorMoving(raw) ) { + Log.notice(F("GYRO: Sensor is moving." CR) ); + validValue = false; + } else { + validValue = true; + angle = calculateAngle( raw ); + //Log.notice(F("GYRO: Calculated angle %F" CR), angle ); + } + + return validValue; +} + +// +// Dump the stored calibration values. +// +void GyroSensor::dumpCalibration() { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Accel offset\t%d\t%d\t%d" CR), calibrationOffset.ax, calibrationOffset.ay, calibrationOffset.az ); + Log.verbose(F("GYRO: Gyro offset \t%d\t%d\t%d" CR), calibrationOffset.gx, calibrationOffset.gy, calibrationOffset.gz ); +#endif +} + +// +// Update the sensor with out calculated offsets. +// +void GyroSensor::applyCalibration() { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Applying calibration offsets to sensor." CR) ); +#endif + if( ( calibrationOffset.ax + calibrationOffset.ay + calibrationOffset.az + calibrationOffset.gx + calibrationOffset.gy + calibrationOffset.gz ) == 0 ) { + Log.error(F("GYRO: No valid calibraion values exist, aborting." CR) ); + return; + } + + accelgyro.setXAccelOffset( calibrationOffset.ax ); + accelgyro.setYAccelOffset( calibrationOffset.ay ); + accelgyro.setZAccelOffset( calibrationOffset.az ); + accelgyro.setXGyroOffset( calibrationOffset.gx ); + accelgyro.setYGyroOffset( calibrationOffset.gy ); + accelgyro.setZGyroOffset( calibrationOffset.gz ); +} + +// +// Calculate the offsets for calibration. +// +void GyroSensor::calibrateSensor() { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Calibrating sensor" CR) ); +#endif + //accelgyro.PrintActiveOffsets(); + //Serial.print( CR ); + + accelgyro.setDLPFMode(MPU6050_DLPF_BW_5); + accelgyro.CalibrateAccel(6); // 6 = 600 readings + accelgyro.CalibrateGyro(6); + + accelgyro.PrintActiveOffsets(); + Serial.print( CR ); + + calibrationOffset.ax = accelgyro.getXAccelOffset(); + calibrationOffset.ay = accelgyro.getYAccelOffset(); + calibrationOffset.az = accelgyro.getZAccelOffset(); + calibrationOffset.gx = accelgyro.getXGyroOffset(); + calibrationOffset.gy = accelgyro.getYGyroOffset(); + calibrationOffset.gz = accelgyro.getZGyroOffset(); + + // Save the calibrated values + myConfig.setGyroCalibration( calibrationOffset ); + myConfig.saveFile(); +} + +// +// Calibrate the device. +// +void GyroSensor::debug() { +#if LOG_LEVEL==6 + Log.verbose(F("GYRO: Debug - Clock src %d." CR), accelgyro.getClockSource() ); + Log.verbose(F("GYRO: Debug - Device ID %d." CR), accelgyro.getDeviceID() ); + Log.verbose(F("GYRO: Debug - DHPF Mode %d." CR), accelgyro.getDHPFMode() ); + Log.verbose(F("GYRO: Debug - DMP on %s." CR), accelgyro.getDMPEnabled()?"on":"off" ); + Log.verbose(F("GYRO: Debug - Acc range %d." CR), accelgyro.getFullScaleAccelRange() ); + Log.verbose(F("GYRO: Debug - Gyr range %d." CR), accelgyro.getFullScaleGyroRange() ); + Log.verbose(F("GYRO: Debug - Int %s." CR), accelgyro.getIntEnabled()?"on":"off" ); + Log.verbose(F("GYRO: Debug - Clock %d." CR), accelgyro.getMasterClockSpeed() ); + Log.verbose(F("GYRO: Debug - Rate %d." CR), accelgyro.getRate() ); + Log.verbose(F("GYRO: Debug - Gyro range %d." CR), accelgyro.getFullScaleGyroRange() ); +// Log.verbose(F("GYRO: Debug - I2C bypass %s." CR), accelgyro.getI2CBypassEnabled()?"on":"off" ); +// Log.verbose(F("GYRO: Debug - I2C master %s." CR), accelgyro.getI2CMasterModeEnabled()?"on":"off" ); + Log.verbose(F("GYRO: Debug - Acc FactX %d." CR), accelgyro.getAccelXSelfTestFactoryTrim() ); + Log.verbose(F("GYRO: Debug - Acc FactY %d." CR), accelgyro.getAccelYSelfTestFactoryTrim() ); + Log.verbose(F("GYRO: Debug - Acc FactZ %d." CR), accelgyro.getAccelZSelfTestFactoryTrim() ); + Log.verbose(F("GYRO: Debug - Gyr FactX %d." CR), accelgyro.getGyroXSelfTestFactoryTrim() ); + Log.verbose(F("GYRO: Debug - Gyr FactY %d." CR), accelgyro.getGyroYSelfTestFactoryTrim() ); + Log.verbose(F("GYRO: Debug - Gyr FactZ %d." CR), accelgyro.getGyroZSelfTestFactoryTrim() ); + + switch( accelgyro.getFullScaleAccelRange() ) { + case 0: + Log.verbose(F("GYRO: Debug - Accel range +/- 2g." CR)); + break; + case 1: + Log.verbose(F("GYRO: Debug - Accel range +/- 4g." CR)); + break; + case 2: + Log.verbose(F("GYRO: Debug - Accel range +/- 8g." CR)); + break; + case 3: + Log.verbose(F("GYRO: Debug - Accel range +/- 16g." CR)); + break; + } + + Log.verbose(F("GYRO: Debug - Acc OffX %d\t%d." CR), accelgyro.getXAccelOffset(), calibrationOffset.az ); + Log.verbose(F("GYRO: Debug - Acc OffY %d\t%d." CR), accelgyro.getYAccelOffset(), calibrationOffset.ay ); + Log.verbose(F("GYRO: Debug - Acc OffZ %d\t%d." CR), accelgyro.getZAccelOffset(), calibrationOffset.az ); + Log.verbose(F("GYRO: Debug - Gyr OffX %d\t%d." CR), accelgyro.getXGyroOffset(), calibrationOffset.gx ); + Log.verbose(F("GYRO: Debug - Gyr OffY %d\t%d." CR), accelgyro.getYGyroOffset(), calibrationOffset.gy ); + Log.verbose(F("GYRO: Debug - Gyr OffZ %d\t%d." CR), accelgyro.getZGyroOffset(), calibrationOffset.gz ); +#endif +} + +// EOF \ No newline at end of file diff --git a/src/gyro.h b/src/gyro.h new file mode 100644 index 0000000..d11b7aa --- /dev/null +++ b/src/gyro.h @@ -0,0 +1,79 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#ifndef _GYRO_H +#define _GYRO_H + +#define I2CDEV_IMPLEMENTATION I2CDEV_ARDUINO_WIRE +//#define I2CDEV_IMPLEMENTATION I2CDEV_BUILTIN_SBWIRE + +// Includes +#include +#include "MPU6050.h" +#include "config.h" + +// Classes +struct RawGyroDataL { // Used for average multiple readings + long ax; // Raw Acceleration + long ay; + long az; + + long gx; // Raw Position + long gy; + long gz; + + long temp; // Only for information (temperature of chip) +}; + +class GyroSensor { + private: + MPU6050 accelgyro; + bool sensorConnected = false; + bool validValue = false; + double angle = 0; + RawGyroData calibrationOffset; + + void debug(); + void applyCalibration(); + void dumpCalibration(); + void readSensor(RawGyroData &raw, const int noIterations = 100, const int delayTime = 1); + bool isSensorMoving(RawGyroData &raw); + double calculateAngle(RawGyroData &raw); + + public: + bool setup(); + bool read(); + void calibrateSensor(); + + double getAngle() { return angle; }; + bool isConnected() { return sensorConnected; }; + bool hasValue() { return validValue; }; + void enterSleep(); +}; + +// Global instance created +extern GyroSensor myGyro; + +#endif // _GYRO_H + +// EOF \ No newline at end of file diff --git a/src/helper.cpp b/src/helper.cpp new file mode 100644 index 0000000..a5e98c0 --- /dev/null +++ b/src/helper.cpp @@ -0,0 +1,110 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include "helper.h" +#include "config.h" + +SerialDebug mySerial; +BatteryVoltage myBatteryVoltage; + +// +// Enter deep sleep for the defined duration (Argument is seconds) +// +void deepSleep(int t) { +#if LOG_LEVEL==6 + Log.verbose(F("HELP: Entering sleep mode for %ds." CR), t ); +#endif + uint64_t wake = t * 1000000; + ESP.deepSleep( wake ); +} + +// +// Print the build options used +// +void printBuildOptions() { + Log.notice( F("Build options: %s LOGLEVEL %d " +#ifdef ACTIVATE_PUSH + "PUSH " +#endif +#ifdef SKIP_SLEEPMODE + "SKIP_SLEEP " +#endif +#ifdef ACTIVATE_OTA + "OTA " +#endif + CR), CFG_APPVER, LOG_LEVEL ); +} + +// +// Configure serial debug output +// +SerialDebug::SerialDebug(const long serialSpeed) { + // Start serial with auto-detected rate (default to defined BAUD) + Serial.flush(); + Serial.begin(serialSpeed); + + getLog()->begin(LOG_LEVEL, &Serial, true); + getLog()->setPrefix(printTimestamp); + getLog()->notice(F("SDBG: Serial logging started at %l." CR), serialSpeed); +} + +// +// Print the timestamp (ms since start of device) +// +void printTimestamp(Print* _logOutput) { + char c[12]; + sprintf(c, "%10lu ", millis()); + _logOutput->print(c); +} + +// +// Read and calculate the battery voltage +// +void BatteryVoltage::read() { + // The analog pin can only handle 3.3V maximum voltage so we need to reduce the voltage (from max 5V) + float factor = myConfig.getVoltageFactor(); // Default value is 1.63 + int v = analogRead( A0 ); + batteryLevel = ((3.3/1023)*v)*factor; +#if LOG_LEVEL==6 + Log.verbose(F("BATT: Reading voltage level. Factor=%F Value=%d, Voltage=%F." CR), factor, v, batteryLevel ); +#endif +} + +// +// Convert float to formatted string with n decimals. Buffer should be at least 10 chars. +// +char* convertFloatToString( float f, char *buffer, int dec ) { + dtostrf(f, 6, dec, buffer); + return buffer; +} + +// +// Reduce precision to n decimals +// +float reduceFloatPrecision( float f, int dec ) { + char buffer[5]; + dtostrf(f, 6, dec, &buffer[0]); + return atof(&buffer[0]); +} + +// EOF \ No newline at end of file diff --git a/src/helper.h b/src/helper.h new file mode 100644 index 0000000..85a908d --- /dev/null +++ b/src/helper.h @@ -0,0 +1,66 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#ifndef _HELPER_H +#define _HELPER_H + +// Includes +#include + +// Sleep mode +void deepSleep(int t); + +// Show build options +void printBuildOptions(); + +// Float to String +char* convertFloatToString( float f, char* buf, int dec = 2); +float reduceFloatPrecision( float f, int dec = 2 ); + +// Logging via serial +void printTimestamp(Print* _logOutput); +void printNewline(Print* _logOutput); + +// Classes +class SerialDebug { + public: + SerialDebug(const long serialSpeed = 115200L); + static Logging* getLog() { return &Log; }; +}; + +class BatteryVoltage { + private: + float batteryLevel; + + public: + void read(); + float getVoltage() { return batteryLevel; }; +}; + +// Global instance created +extern SerialDebug mySerial; +extern BatteryVoltage myBatteryVoltage; + +#endif // _HELPER_H + +// EOF \ No newline at end of file diff --git a/src/main.cpp b/src/main.cpp new file mode 100644 index 0000000..9945ef1 --- /dev/null +++ b/src/main.cpp @@ -0,0 +1,214 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include "helper.h" +#include "gyro.h" +#include "config.h" +#include "wifi.h" +#include "webserver.h" +#include "calc.h" +#include "tempsensor.h" +#include "pushtarget.h" +#include + +// Settings for double reset detector. +#define ESP_MRD_USE_LITTLEFS true +#define ESP_MRD_USE_SPIFFS false +#define ESP_MRD_USE_EEPROM false +#define MRD_TIMES 3 +#define MRD_TIMEOUT 10 +#define MRD_ADDRESS 0 +#define MULTIRESETDETECTOR_DEBUG true +#include +MultiResetDetector *mrd; + +// Define constats for this program +#if LOG_LEVEL==6 +const int interval = 1000; // ms, time to wait between changes to output +bool sleepModeAlwaysSkip = true; // Web interface can override normal behaviour +#else +const int interval = 100; // ms, time to wait between changes to output +bool sleepModeAlwaysSkip = false; // Web interface can override normal behaviour +#endif +unsigned long lastMillis = 0; +unsigned long startMillis; +bool sleepModeActive = false; + +// +// Check if we should be in sleep mode +// +void checkSleepMode( float angle, float volt ) { + +#if defined( SKIP_SLEEPMODE ) + sleepModeActive = false; + Log.verbose(F("MAIN: Skipping sleep mode (SKIP_SLEEPMODE is defined)." CR) ); + return; +#endif + + const RawGyroData &g = myConfig.getGyroCalibration(); + + // Will not enter sleep mode if: no calibration data + if( g.ax==0 && g.ay==0 && g.az==0 && g.gx==0 && g.gy==0 && g.gz==0 ) { + Log.notice(F("MAIN: Missing calibration data, so forcing webserver to be active." CR) ); + sleepModeAlwaysSkip = true; + } + + if( sleepModeAlwaysSkip ) { + Log.notice(F("MAIN: Sleep mode disabled from web interface." CR) ); + sleepModeActive = false; + return; + } + + // Will not enter sleep mode if: charger is connected + sleepModeActive = volt<4.15 ? true : false; + + // sleep mode active when flat + //sleepModeActive = ( angle<85 && angle>5 ) ? true : false; +#if LOG_LEVEL==6 + Log.verbose(F("MAIN: Deep sleep mode %s (angle=%F volt=%F)." CR), sleepModeActive ? "true":"false", angle, volt ); +#endif +} + +// +// Setup +// +void setup() { + startMillis = millis(); + mrd = new MultiResetDetector(MRD_TIMEOUT, MRD_ADDRESS); + bool dt = mrd->detectMultiReset(); + +#if LOG_LEVEL==6 + Log.verbose(F("Main: Reset reason %s." CR), ESP.getResetInfo().c_str() ); +#endif + // Main startup + Log.notice(F("Main: Started setup for %s." CR), String( ESP.getChipId(), HEX).c_str() ); + printBuildOptions(); + + Log.notice(F("Main: Loading configuration." CR)); + myConfig.checkFileSystem(); + myConfig.loadFile(); + + // Setup watchdog + ESP.wdtDisable(); + ESP.wdtEnable( interval*2 ); + + myTempSensor.setup(); + + // Setup Gyro + if( !myGyro.setup() ) + Log.error(F("Main: Failed to initialize the gyro." CR)); + + if( dt ) + Log.notice(F("Main: Detected doubletap on reset." CR)); + + Log.notice(F("Main: Connecting to wifi." CR)); + myWifi.connect( dt ); + Log.notice(F("Main: WIFI connected." CR)); + + myGyro.read(); + myBatteryVoltage.read(); + checkSleepMode( myGyro.getAngle(), myBatteryVoltage.getVoltage() ); + + if( myWifi.isConnected() ) { + Log.notice(F("Main: Connected to wifi ip=%s." CR), myWifi.getIPAddress().c_str() ); + + if( !sleepModeActive ) + if( myWebServer.setupWebServer() ) + Log.notice(F("Main: Webserver is running." CR) ); + } + +#if defined( ACTIVATE_OTA ) + if( !sleepModeActive && myWifi.isConnected() && myWifi.checkFirmwareVersion() ) { + myWifi.updateFirmware(); + } +#endif +} + +// +// Main loops +// +void loop() { + mrd->loop(); + + if( sleepModeActive || abs(millis() - lastMillis) > interval ) { + float angle = 90; + float volt = myBatteryVoltage.getVoltage(); +#if LOG_LEVEL==6 + Log.verbose(F("Main: Entering main loop." CR) ); +#endif + // If we dont get any readings we just skip this and try again the next interval. + if( myGyro.hasValue() ) { + angle = myGyro.getAngle(); + float temp = myTempSensor.getValueCelcius(); // The code is build around using C for temp. + float gravity = calculateGravity( angle, temp ); +#if LOG_LEVEL==6 + Log.verbose(F("Main: Sensor values gyro=%F, temp=%F, gravity=%F." CR), angle, temp, gravity ); +#endif + if( myConfig.isGravityTempAdj() ) { + gravity = gravityTemperatureCorrection( gravity, temp); // Use default correction temperature of 20C +#if LOG_LEVEL==6 + Log.verbose(F("Main: Temp adjusted gravity=%F." CR), gravity ); +#endif + } + + Log.notice(F("Main: Gyro angle=%F, temp=%F, gravity=%F, batt=%F." CR), angle, temp, gravity, volt ); + +#if defined( ACTIVATE_PUSH ) + unsigned long runTime = millis() - startMillis; + + myPushTarget.send( angle, gravity, temp, runTime/1000, sleepModeActive ); // Force the transmission if we are going to sleep +#endif + } else { + Log.error(F("Main: No gyro value." CR) ); + } + + if( sleepModeActive ) { + unsigned long runTime = millis() - startMillis; + + // Enter sleep mode... + Log.notice(F("MAIN: Entering deep sleep, run time %l s." CR), runTime/1000 ); + LittleFS.end(); + myGyro.enterSleep(); + mrd->stop(); + delay(100); + deepSleep( myConfig.getPushInterval() ); + } + +#if LOG_LEVEL==6 + Log.verbose(F("Main: Sleep mode not active." CR) ); +#endif + // Do these checks if we are running in normal mode (not sleep mode) + checkSleepMode( angle, volt ); + myGyro.read(); + myBatteryVoltage.read(); + lastMillis = millis(); +#if LOG_LEVEL==6 + Log.verbose(F("Main: Heap %d kb FreeSketch %d kb." CR), ESP.getFreeHeap()/1024, ESP.getFreeSketchSpace()/1024 ); + Log.verbose(F("Main: HeapFrag %d %%." CR), ESP.getHeapFragmentation() ); +#endif + } + + myWebServer.loop(); +} + +// EOF \ No newline at end of file diff --git a/src/pushtarget.cpp b/src/pushtarget.cpp new file mode 100644 index 0000000..7fdc91e --- /dev/null +++ b/src/pushtarget.cpp @@ -0,0 +1,170 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include "pushtarget.h" +#include "config.h" + +#if defined( ACTIVATE_PUSH ) + +PushTarget myPushTarget; + +// +// Send the pressure value +// +void PushTarget::send(float angle, float gravity, float temp, float runTime, bool force ) { + unsigned long timePassed = abs( millis() - ms ); + unsigned long interval = myConfig.getPushInterval()*1000; + + if( ( timePassed < interval ) && !force) { +#if LOG_LEVEL==6 + Log.verbose(F("PUSH: Timer has not expired %l vs %l." CR), timePassed, interval ); +#endif + return; + } + +#if LOG_LEVEL==6 + Log.verbose(F("PUSH: Sending data." CR) ); +#endif + ms = millis(); + + if( myConfig.isBrewfatherActive() ) + sendBrewfather( angle, gravity, temp ); + + if( myConfig.isHttpActive() ) + sendHttp( angle, gravity, temp, runTime ); +} + +// +// Send data to brewfather +// +void PushTarget::sendBrewfather(float angle, float gravity, float temp ) { + Log.notice(F("PUSH: Sending values to brewfather angle=%F, gravity=%F, temp=%F." CR), angle, gravity, temp ); + + DynamicJsonDocument doc(300); + // + // { + // "name": "YourDeviceName", // Required field, this will be the ID in Brewfather + // "temp": 20.32, + // "aux_temp": 15.61, // Fridge Temp + // "ext_temp": 6.51, // Room Temp + // "temp_unit": "C", // C, F, K + // "gravity": 1.042, + // "gravity_unit": "G", // G, P + // "pressure": 10, + // "pressure_unit": "PSI", // PSI, BAR, KPA + // "ph": 4.12, + // "bpm": 123, // Bubbles Per Minute + // "comment": "Hello World", + // "beer": "Pale Ale" + // "battery": 4.98 + // } + // + doc["name"] = myConfig.getMDNS(); + doc["temp"] = reduceFloatPrecision( temp, 1); + //doc["aux_temp"] = 0; + //doc["ext_temp"] = 0; + doc["temp_unit"] = String( myConfig.getTempFormat() ); + //doc["pressure"] = ; + //doc["pressure_unit"] = ; + doc["battery"] = reduceFloatPrecision( myBatteryVoltage.getVoltage(), 2 ); + doc["gravity"] = reduceFloatPrecision( gravity, 4 ); + doc["gravity_unit"] = myConfig.isGravitySG()?"G":"P"; + //doc["ph"] = 0; + //doc["bpm"] = 0; + //doc["comment"] = ""; + //doc["beer"] = ""; + + WiFiClient client; + HTTPClient http; + String serverPath = myConfig.getBrewfatherPushTarget(); + + // Your Domain name with URL path or IP address with path + http.begin( client, serverPath); + String json; + serializeJson(doc, json); +#if LOG_LEVEL==6 + Log.verbose(F("PUSH: url %s." CR), serverPath.c_str()); + Log.verbose(F("PUSH: json %s." CR), json.c_str()); +#endif + + // Send HTTP POST request + http.addHeader(F("Content-Type"), F("application/json") ); + int httpResponseCode = http.POST(json); + + if (httpResponseCode==200) { + Log.notice(F("PUSH: HTTP Response code %d" CR), httpResponseCode); + } else { + Log.error(F("PUSH: HTTP Response code %d" CR), httpResponseCode); + } + + http.end(); +} + +// +// Send data to http target +// +void PushTarget::sendHttp(float angle, float gravity, float temp, float runTime ) { + Log.notice(F("PUSH: Sending values to http angle=%F, gravity=%F, temp=%F." CR), angle, gravity, temp ); + + DynamicJsonDocument doc(256); + + doc["name"] = myConfig.getMDNS(); + doc["temp"] = reduceFloatPrecision( temp, 1 ); + doc["temp-unit"] = String( myConfig.getTempFormat() ); + doc["gravity"] = reduceFloatPrecision( gravity, 4 ); + doc["angle"] = reduceFloatPrecision( angle, 2); + doc["battery"] = reduceFloatPrecision( myBatteryVoltage.getVoltage(), 2 ); + doc["rssi"] = WiFi.RSSI(); + + // Some debug information + doc["run-time"] = reduceFloatPrecision( runTime, 2 ); + + WiFiClient client; + HTTPClient http; + String serverPath = myConfig.getHttpPushTarget(); + + // Your Domain name with URL path or IP address with path + http.begin( client, serverPath); + String json; + serializeJson(doc, json); +#if LOG_LEVEL==6 + Log.verbose(F("PUSH: url %s." CR), serverPath.c_str()); + Log.verbose(F("PUSH: json %s." CR), json.c_str()); +#endif + + // Send HTTP POST request + http.addHeader(F("Content-Type"), F("application/json") ); + int httpResponseCode = http.POST(json); + + if (httpResponseCode==200) { + Log.notice(F("PUSH: HTTP Response code %d" CR), httpResponseCode); + } else { + Log.error(F("PUSH: HTTP Response code %d" CR), httpResponseCode); + } + + http.end(); +} + +#endif // ACTIVATE_PUSH + +// EOF \ No newline at end of file diff --git a/src/pushtarget.h b/src/pushtarget.h new file mode 100644 index 0000000..1478e51 --- /dev/null +++ b/src/pushtarget.h @@ -0,0 +1,52 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#ifndef _PUSHTARGET_H +#define _PUSHTARGET_H + +// Includes +#include "helper.h" + +#include +#include +#include +#include + +// Classes +class PushTarget { + private: + unsigned long ms; // Used to check that we do not post to often + + void sendBrewfather(float angle, float gravity, float temp ); + void sendHttp(float angle, float gravity, float temp, float runTime ); + + public: + PushTarget() { ms = millis(); } + void send(float angle, float gravity, float temp, float runTime, bool force = false ); +}; + +extern PushTarget myPushTarget; + +#endif // _PUSHTARGET_H + +// EOF \ No newline at end of file diff --git a/src/resources.cpp b/src/resources.cpp new file mode 100644 index 0000000..15d5ff8 --- /dev/null +++ b/src/resources.cpp @@ -0,0 +1,41 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include + +#if defined( EMBED_HTML ) + +/*INCBIN(IndexHtm, "data/index.htm" ); +INCBIN(DeviceHtm, "data/device.htm" ); +INCBIN(ConfigHtm, "data/config.htm" ); +INCBIN(AboutHtm, "data/about.htm" );*/ + +// Using minify to reduce memory usage. Reducing RAM memory usage with about 7% +INCBIN(IndexHtm, "data/index.min.htm" ); +INCBIN(DeviceHtm, "data/device.min.htm" ); +INCBIN(ConfigHtm, "data/config.min.htm" ); +INCBIN(AboutHtm, "data/about.min.htm" ); + +#endif + +// EOF \ No newline at end of file diff --git a/src/tempsensor.cpp b/src/tempsensor.cpp new file mode 100644 index 0000000..72a49e4 --- /dev/null +++ b/src/tempsensor.cpp @@ -0,0 +1,108 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include "tempsensor.h" +#include "helper.h" +#include "config.h" +#include +#include +#include + +// +// Conversion between C and F +// +float convertCtoF( float t ) { + return (t * 1.8 ) + 32.0; +} + +OneWire myOneWire(D6); +DallasTemperature mySensors(&myOneWire); +TempSensor myTempSensor; + +#define TEMPERATURE_PRECISION 9 + +// +// Setup temp sensors +// +void TempSensor::setup() { + +#if defined( SIMULATE_TEMP ) + hasSensors = true; + return; +#endif + + if( mySensors.getDeviceCount() ) + return; + +#if LOG_LEVEL==6 + Log.verbose(F("TSEN: Looking for temp sensors." CR)); +#endif + mySensors.begin(); + + if( mySensors.getDeviceCount() ) { + Log.notice(F("TSEN: Found %d sensors." CR), mySensors.getDeviceCount()); + mySensors.setResolution(TEMPERATURE_PRECISION); + } + + float t = myConfig.getTempSensorAdj(); + + // Set the temp sensor adjustment values + if( myConfig.isTempC() ) { + tempSensorAdjF = t * 1.8; // Convert the adjustment value to C + tempSensorAdjC = t; + } else { + tempSensorAdjF = t; + tempSensorAdjC = t * 0.556; // Convert the adjustent value to F + } + +#if LOG_LEVEL==6 + Log.verbose(F("TSEN: Adjustment values for temp sensor %F C, %F F." CR), tempSensorAdjC, tempSensorAdjF ); +#endif +} + +// +// Retrieving value from sensor +// +float TempSensor::getValue() { + float c = 0; + +#if defined( SIMULATE_TEMP ) + return 21; +#endif + + // Read the sensors + mySensors.requestTemperatures(); + + if( mySensors.getDeviceCount() >= 1) { + c = mySensors.getTempCByIndex(0); + +#if LOG_LEVEL==6 + Log.verbose(F("TSEN: Reciving temp value for sensor %F C." CR), c); +#endif + hasSensor = true; + } + + return c; +} + +// EOF \ No newline at end of file diff --git a/src/tempsensor.h b/src/tempsensor.h new file mode 100644 index 0000000..34b792d --- /dev/null +++ b/src/tempsensor.h @@ -0,0 +1,50 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#ifndef _TEMPSENSOR_H +#define _TEMPSENSOR_H + +// definitions +float convertCtoF( float t ); + +// classes +class TempSensor { + private: + bool hasSensor = false; + float tempSensorAdjF = 0; + float tempSensorAdjC = 0; + float getValue(); + + public: + void setup(); + bool isSensorAttached() { return hasSensor; }; + float getValueCelcius() { return getValue() + tempSensorAdjC; } + float getValueFarenheight() { return convertCtoF(getValue()) + tempSensorAdjF; }; +}; + +// Global instance created +extern TempSensor myTempSensor; + +#endif // _TEMPSENSOR_H + +// EOF \ No newline at end of file diff --git a/src/webserver.cpp b/src/webserver.cpp new file mode 100644 index 0000000..35a538f --- /dev/null +++ b/src/webserver.cpp @@ -0,0 +1,382 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +//#define DEBUG_ESP_HTTP_SERVER +#include "webserver.h" +#include "config.h" +#include "helper.h" +#include "gyro.h" +#include "calc.h" +#include "tempsensor.h" +#include +#include +#include +#include +#include +#include + +// Binary resouces +#if defined( EMBED_HTML ) +INCBIN_EXTERN(IndexHtm); +INCBIN_EXTERN(DeviceHtm); +INCBIN_EXTERN(ConfigHtm); +INCBIN_EXTERN(AboutHtm); +#endif + +WebServer myWebServer; +ESP8266WebServer server(80); + +extern bool sleepModeActive; +extern bool sleepModeAlwaysSkip; + +// +// Callback from webServer when / has been accessed. +// +void webHandleDevice() { +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/config." CR)); +#endif + DynamicJsonDocument doc(100); + doc[ CFG_PARAM_ID ] = myConfig.getID(); + doc[ CFG_PARAM_APP_NAME ] = CFG_APPNAME; + doc[ CFG_PARAM_APP_VER ] = CFG_APPVER; + doc[ CFG_PARAM_MDNS ] = myConfig.getMDNS(); +#if LOG_LEVEL==6 + serializeJson(doc, Serial); + Serial.print( CR ); +#endif + String out; + serializeJson(doc, out); + server.send(200, "application/json", out.c_str() ); +} + +// +// Callback from webServer when / has been accessed. +// +void webHandleConfig() { +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/config." CR)); +#endif + DynamicJsonDocument doc(CFG_JSON_BUFSIZE); + myConfig.createJson( doc ); + + double angle = myGyro.getAngle(); + double temp = myTempSensor.getValueCelcius(); + double gravity = calculateGravity( angle, temp ); + + doc[ CFG_PARAM_ANGLE ] = reduceFloatPrecision( angle); + doc[ CFG_PARAM_GRAVITY ] = reduceFloatPrecision( gravityTemperatureCorrection( gravity, temp ), 4); + doc[ CFG_PARAM_BATTERY ] = reduceFloatPrecision( myBatteryVoltage.getVoltage()); + +#if LOG_LEVEL==6 + serializeJson(doc, Serial); + Serial.print( CR ); +#endif + String out; + serializeJson(doc, out); + server.send(200, "application/json", out.c_str() ); +} + +// +// Callback from webServer when / has been accessed. +// +void webHandleCalibrate() { + String id = server.arg( CFG_PARAM_ID ); +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/calibrate." CR)); +#endif + if( !id.equalsIgnoreCase( myConfig.getID() ) ) { + Log.error(F("WEB : Wrong ID received %s, expected %s" CR), id.c_str(), myConfig.getID()); + server.send(400, "text/plain", "Invalid ID."); + return; + } + myGyro.calibrateSensor(); + server.send(200, "text/plain", "Device calibrated" ); +} + +// +// Callback from webServer when / has been accessed. +// +void webHandleFactoryReset() { + String id = server.arg( CFG_PARAM_ID ); +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/factory." CR)); +#endif + if( !id.compareTo( myConfig.getID() ) ) { + server.send(200, "text/plain", "Doing reset..."); + LittleFS.remove(CFG_FILENAME); + LittleFS.end(); + delay(500); + ESP.reset(); + } else { + server.send(400, "text/plain", "Unknown ID."); + } +} + +// +// Callback from webServer when / has been accessed. +// +void webHandleStatus() { +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/status." CR)); +#endif + DynamicJsonDocument doc(256); + + double angle = myGyro.getAngle(); + double temp = myTempSensor.getValueCelcius(); + double gravity = calculateGravity( angle, temp ); + + doc[ CFG_PARAM_ID ] = myConfig.getID(); + doc[ CFG_PARAM_ANGLE ] = reduceFloatPrecision( angle); + doc[ CFG_PARAM_GRAVITY ] = reduceFloatPrecision( gravityTemperatureCorrection( gravity, temp ), 4); + doc[ CFG_PARAM_TEMP_C ] = reduceFloatPrecision( temp, 1); + doc[ CFG_PARAM_TEMP_F ] = reduceFloatPrecision( myTempSensor.getValueFarenheight(), 1); + doc[ CFG_PARAM_BATTERY ] = reduceFloatPrecision( myBatteryVoltage.getVoltage()); + doc[ CFG_PARAM_TEMPFORMAT ] = String( myConfig.getTempFormat() ); + doc[ CFG_PARAM_SLEEP_MODE ] = sleepModeAlwaysSkip; + doc[ CFG_PARAM_RSSI ] = WiFi.RSSI(); +#if LOG_LEVEL==6 + serializeJson(doc, Serial); + Serial.print( CR ); +#endif + String out; + serializeJson(doc, out); + server.send(200, "application/json", out.c_str() ); +} + +// +// Callback from webServer when / has been accessed. +// +void webHandleClearWIFI() { + String id = server.arg( CFG_PARAM_ID ); +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/clearwifi." CR)); +#endif + if( !id.compareTo( myConfig.getID() ) ) { + server.send(200, "text/plain", "Clearing WIFI credentials and doing reset..."); + delay(1000); + WiFi.disconnect(); // Clear credentials + ESP.reset(); + } else { + server.send(400, "text/plain", "Unknown ID."); + } +} + +// +// Used to force the device to never sleep. +// +void webHandleStatusSleepmode() { + String id = server.arg( CFG_PARAM_ID ); +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/status/sleepmode." CR) ); +#endif + if( !id.equalsIgnoreCase( myConfig.getID() ) ) { + Log.error(F("WEB : Wrong ID received %s, expected %s" CR), id.c_str(), myConfig.getID()); + server.send(400, "text/plain", "Invalid ID."); + return; + } +#if LOG_LEVEL==6 + Log.verbose(F("WEB : sleep-mode=%s." CR), server.arg( CFG_PARAM_SLEEP_MODE ).c_str() ); +#endif + if( server.arg( CFG_PARAM_SLEEP_MODE ).equalsIgnoreCase( "true" ) ) + sleepModeAlwaysSkip = true; + else + sleepModeAlwaysSkip = false; + server.send(200, "text/plain", "Sleep mode updated" ); +} + +// +// Update device settings. +// +void webHandleConfigDevice() { + String id = server.arg( CFG_PARAM_ID ); +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/config/device." CR) ); +#endif + if( !id.equalsIgnoreCase( myConfig.getID() ) ) { + Log.error(F("WEB : Wrong ID received %s, expected %s" CR), id.c_str(), myConfig.getID()); + server.send(400, "text/plain", "Invalid ID."); + return; + } +#if LOG_LEVEL==6 + Log.verbose(F("WEB : mdns=%s, temp-format=%s." CR), server.arg( CFG_PARAM_MDNS ).c_str(), server.arg( CFG_PARAM_TEMPFORMAT ).c_str() ); +#endif + myConfig.setMDNS( server.arg( CFG_PARAM_MDNS ).c_str() ); + myConfig.setTempFormat( server.arg( CFG_PARAM_TEMPFORMAT ).charAt(0) ); + myConfig.saveFile(); + server.sendHeader("Location", "/config.htm#collapseOne", true); + server.send(302, "text/plain", "Device config updated" ); +} + +// +// Update push settings. +// +void webHandleConfigPush() { + String id = server.arg( CFG_PARAM_ID ); +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/config/push." CR) ); +#endif + if( !id.equalsIgnoreCase( myConfig.getID() ) ) { + Log.error(F("WEB : Wrong ID received %s, expected %s" CR), id.c_str(), myConfig.getID()); + server.send(400, "text/plain", "Invalid ID."); + return; + } +#if LOG_LEVEL==6 + Log.verbose(F("WEB : http=%s, bf=%s interval=%s." CR), server.arg( CFG_PARAM_PUSH_HTTP ).c_str(), server.arg( CFG_PARAM_PUSH_BREWFATHER ).c_str(), server.arg( CFG_PARAM_PUSH_INTERVAL ).c_str() ); +#endif + myConfig.setHttpPushTarget( server.arg( CFG_PARAM_PUSH_HTTP ).c_str() ); + myConfig.setBrewfatherPushTarget( server.arg( CFG_PARAM_PUSH_BREWFATHER ).c_str() ); + myConfig.setPushInterval( server.arg( CFG_PARAM_PUSH_INTERVAL ).c_str() ); + myConfig.saveFile(); + server.sendHeader("Location", "/config.htm#collapseTwo", true); + server.send(302, "text/plain", "Push config updated" ); +} + +// +// Update gravity settings. +// +void webHandleConfigGravity() { + String id = server.arg( CFG_PARAM_ID ); +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/config/gravity." CR) ); +#endif + if( !id.equalsIgnoreCase( myConfig.getID() ) ) { + Log.error(F("WEB : Wrong ID received %s, expected %s" CR), id.c_str(), myConfig.getID()); + server.send(400, "text/plain", "Invalid ID."); + return; + } +#if LOG_LEVEL==6 + Log.verbose(F("WEB : formula=%s, temp-corr=%s." CR), server.arg( CFG_PARAM_GRAVITY_FORMULA ).c_str(), server.arg( CFG_PARAM_GRAVITY_TEMP_ADJ ).c_str() ); +#endif + myConfig.setGravityFormula( server.arg( CFG_PARAM_GRAVITY_FORMULA ).c_str() ); + myConfig.setGravityTempAdj( server.arg( CFG_PARAM_GRAVITY_TEMP_ADJ ).equalsIgnoreCase( "on" ) ? true:false); + myConfig.saveFile(); + server.sendHeader("Location", "/config.htm#collapseThree", true); + server.send(302, "text/plain", "Gravity config updated" ); +} + +// +// Update hardware settings. +// +void webHandleConfigHardware() { + String id = server.arg( CFG_PARAM_ID ); +#if LOG_LEVEL==6 + Log.verbose(F("WEB : webServer callback for /api/config/hardware." CR) ); +#endif + if( !id.equalsIgnoreCase( myConfig.getID() ) ) { + Log.error(F("WEB : Wrong ID received %s, expected %s" CR), id.c_str(), myConfig.getID()); + server.send(400, "text/plain", "Invalid ID."); + return; + } +#if LOG_LEVEL==6 + Log.verbose(F("WEB : vf=%s, tempadj=%s, ota=%s." CR), server.arg( CFG_PARAM_VOLTAGEFACTOR ).c_str(), server.arg( CFG_PARAM_TEMP_ADJ ).c_str(), server.arg( CFG_PARAM_OTA ).c_str() ); +#endif + myConfig.setVoltageFactor( server.arg( CFG_PARAM_VOLTAGEFACTOR ).toFloat() ); + myConfig.setTempSensorAdj( server.arg( CFG_PARAM_TEMP_ADJ ).toFloat() ); + myConfig.setOtaURL( server.arg( CFG_PARAM_OTA ).c_str() ); + myConfig.saveFile(); + server.sendHeader("Location", "/config.htm#collapseFour", true); + server.send(302, "text/plain", "Hardware config updated" ); +} + +// +// Setup the Web Server callbacks and start it +// +bool WebServer::setupWebServer() { +#if LOG_LEVEL==6 + Log.verbose(F("WEB : Setting up web server." CR)); +#endif + + Log.notice(F("WEB : Web server setup started." CR)); + + MDNS.begin( myConfig.getMDNS() ); + MDNS.addService("http", "tcp", 80); + + // Static content +#if defined( EMBED_HTML ) + server.on("/",[]() { + server.send_P(200, "text/html", (const char*) gIndexHtmData, gIndexHtmSize ); + } ); + server.on("/index.htm",[]() { + server.send_P(200, "text/html", (const char*) gIndexHtmData, gIndexHtmSize ); + } ); + server.on("/device.htm",[]() { + server.send_P(200, "text/html", (const char*) gDeviceHtmData, gDeviceHtmSize ); + } ); + server.on("/config.htm",[]() { + server.send_P(200, "text/html", (const char*) gConfigHtmData, gConfigHtmSize ); + } ); + server.on("/about.htm",[]() { + server.send_P(200, "text/html", (const char*) gAboutHtmData, gAboutHtmSize ); + } ); +#else + // Show files in the filessytem at startup + FSInfo fs; + LittleFS.info(fs); + Log.notice( F("File system: Total=%d, Used=%d." CR), fs.totalBytes, fs.usedBytes ); + Dir dir = LittleFS.openDir("/"); + while( dir.next() ) { + Log.notice( F("File: %s, %d bytes" CR), dir.fileName().c_str(), dir.fileSize() ); + } + + server.serveStatic("/", LittleFS, "/index.htm" ); + server.serveStatic("/index.htm", LittleFS, "/index.htm" ); + server.serveStatic("/device.htm", LittleFS, "/device.htm" ); + server.serveStatic("/config.htm", LittleFS, "/config.htm" ); + server.serveStatic("/about.htm", LittleFS, "/about.htm" ); +#endif + + // Dynamic content + server.on("/api/config", webHandleConfig); // Get config.json + server.on("/api/device", webHandleDevice); // Get device.json + server.on("/api/calibrate", webHandleCalibrate); // Run calibration routine (param id) + server.on("/api/factory", webHandleFactoryReset); // Reset the device + server.on("/api/status", webHandleStatus); // Get the status.json + server.on("/api/clearwifi", webHandleClearWIFI); // Clear wifi settings + + server.on("/api/status/sleepmode", webHandleStatusSleepmode); + server.on("/api/config/device", webHandleConfigDevice); + server.on("/api/config/push", webHandleConfigPush); + server.on("/api/config/gravity", webHandleConfigGravity); + server.on("/api/config/hardware", webHandleConfigHardware); + + server.onNotFound( []() { + Log.error(F("WEB : URL not found %s received." CR), server.uri().c_str()); + server.send(404, "text/plain", F("URL not found") ); + } ); + + server.begin(); + Log.notice(F("WEB : Web server started." CR)); + return true; +} + +// +// called from main loop +// +void WebServer::loop() { + // Dont put serial debug output in this call + server.handleClient(); + MDNS.update(); +} + +// EOF \ No newline at end of file diff --git a/src/webserver.h b/src/webserver.h new file mode 100644 index 0000000..eb3e6b6 --- /dev/null +++ b/src/webserver.h @@ -0,0 +1,41 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#ifndef _WEBSERVER_H +#define _WEBSERVER_H + +// Include + +// classes +class WebServer { + public: + bool setupWebServer(); + void loop(); +}; + +// Global instance created +extern WebServer myWebServer; + +#endif // _WEBSERVER_H + +// EOF \ No newline at end of file diff --git a/src/wifi.cpp b/src/wifi.cpp new file mode 100644 index 0000000..a707cb6 --- /dev/null +++ b/src/wifi.cpp @@ -0,0 +1,203 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#include "wifi.h" +#include "config.h" +#include "helper.h" +#include "gyro.h" +#include "calc.h" +#include "tempsensor.h" +#include +#include +#include +#include +#include +#include +#include + +Wifi myWifi; +WiFiManager myWifiManager; + +// TODO: ADD MDNS setting to WIFI portal..... +// TODO: Download html files during OTA update to reduce image size. + +// +// Connect to last known access point or create one if connection is not working. +// +bool Wifi::connect( bool showPortal ) { +#if LOG_LEVEL==6 + Log.verbose(F("WIFI: Connecting to WIFI via connection manager (portal=%s)." CR), showPortal?"true":"false"); + myWifiManager.setDebugOutput(true); +#else + myWifiManager.setDebugOutput(false); +#endif + unsigned long startMillis = millis(); + myWifiManager.setConfigPortalTimeout( WIFI_PORTAL_TIMEOUT ); + if( showPortal ) { + Log.notice(F("WIFI: Starting wifi portal." CR)); + connectedFlag = myWifiManager.startConfigPortal( WIFI_DEFAULT_SSID, WIFI_DEFAULT_PWD ); + } + else + connectedFlag = myWifiManager.autoConnect( WIFI_DEFAULT_SSID, WIFI_DEFAULT_PWD ); + + Log.notice( F("WIFI: Connect time %d s" CR), abs(millis() - startMillis)/1000); + +#if LOG_LEVEL==6 + Log.verbose(F("WIFI: Connect returned %s." CR), connectedFlag?"True":"False" ); +#endif + + return connectedFlag; +} + +// +// This will erase the stored credentials and forcing the WIFI manager to AP mode. +// +bool Wifi::disconnect() { + Log.notice(F("WIFI: Erasing stored WIFI credentials." CR)); + // Erase WIFI credentials + return WiFi.disconnect(); +} + +#if defined( ACTIVATE_OTA ) + +// +// +// +bool Wifi::updateFirmware() { + if( !newFirmware ) { + Log.notice(F("WIFI: No newer version exist, skipping update." CR)); + return false; + } +#if LOG_LEVEL==6 + Log.verbose(F("WIFI: Updating firmware." CR)); +#endif + + WiFiClient client; + String serverPath = myConfig.getOtaURL(); + serverPath += "firmware.bin"; + + HTTPUpdateResult ret = ESPhttpUpdate.update(client, serverPath); + + switch(ret) { + case HTTP_UPDATE_FAILED: + Log.error(F("WIFI: Updating failed %d, %s." CR), ESPhttpUpdate.getLastError(), ESPhttpUpdate.getLastErrorString().c_str()); + break; + case HTTP_UPDATE_NO_UPDATES: + break; + case HTTP_UPDATE_OK: + Log.notice("WIFI: Updated succesfull, rebooting." ); + ESP.reset(); + break; + } + return false; +} + +// +// Check what firmware version is available over OTA +// +bool Wifi::checkFirmwareVersion() { +#if LOG_LEVEL==6 + Log.verbose(F("WIFI: Checking if new version exist." CR)); +#endif + WiFiClient client; + HTTPClient http; + String serverPath = myConfig.getOtaURL(); + serverPath += "version.json"; + + // Your Domain name with URL path or IP address with path + http.begin( client, serverPath); + + // Send HTTP GET request + int httpResponseCode = http.GET(); + + if (httpResponseCode==200) { + Log.notice(F("WIFI: HTTP Response code %d" CR), httpResponseCode); + + String payload = http.getString(); +#if LOG_LEVEL==6 + Log.verbose(F("WIFI: Payload %s." CR), payload.c_str()); +#endif + DynamicJsonDocument ver(256); + DeserializationError err = deserializeJson(ver, payload); + if( err ) { + Log.error(F("WIFI: Failed to parse json" CR)); + } else { +#if LOG_LEVEL==6 + Log.verbose(F("WIFI: Project %s version %s." CR), ver["project"].as(), ver["version"].as()); +#endif + int newVer[3]; + int curVer[3]; + + if( parseFirmwareVersionString( newVer, (const char*) ver["version"] ) ) { + if( parseFirmwareVersionString( curVer, CFG_APPVER) ) { +#if LOG_LEVEL==6 + Log.verbose(F("OTA : Checking New=%d.%d.%d Cur=%d.%d.%d" CR), newVer[0], newVer[1], newVer[2], curVer[0], curVer[1], curVer[2] ); +#endif + // Compare major version + if( newVer[0] > curVer[0] ) + newFirmware = true; + // Compare minor version + if( newVer[0] == curVer[0] && newVer[1] > curVer[1] ) + newFirmware = true; + // Compare patch version + if( newVer[0] == curVer[0] && newVer[1] == curVer[1] && newVer[2] > curVer[2] ) + newFirmware = true; + } + } + } + } else { + Log.error(F("WIFI: HTTP Response code %d" CR), httpResponseCode); + } + http.end(); +#if LOG_LEVEL==6 + Log.verbose(F("WIFI: Found new version %s." CR), newFirmware?"true":"false"); +#endif + return newFirmware; +} + +// +// Parse a version string in the format M.m.p (eg. 1.2.10) +// +bool Wifi::parseFirmwareVersionString( int (&num)[3], const char *version ) { +#if LOG_LEVEL==6 + Log.verbose(F("WIFI: Parsing version number %s." CR), version); +#endif + char temp[80]; + char *s; + char *p = &temp[0]; + int i = 0; + + strcpy( &temp[0], version ); + + // TODO: Do some error checking on the string, lenght etc. + + while ((s = strtok_r(p, ".", &p)) != NULL) { + num[i++] = atoi( s ); + } + + return true; +} + +#endif // ACTIVATE_OTA + +// EOF \ No newline at end of file diff --git a/src/wifi.h b/src/wifi.h new file mode 100644 index 0000000..e5cca0a --- /dev/null +++ b/src/wifi.h @@ -0,0 +1,57 @@ +/* +MIT License + +Copyright (c) 2021 Magnus + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + */ +#ifndef _WIFI_H +#define _WIFI_H + +// Include +#include + +// classes +class Wifi { + private: + // WIFI + bool connectedFlag = false; + + // OTA + bool newFirmware = false; + bool parseFirmwareVersionString( int (&num)[3], const char *version ); + + public: + // WIFI + bool connect( bool showPortal = false ); + bool disconnect(); + bool isConnected() { return connectedFlag; }; + String getIPAddress() { return WiFi.localIP().toString(); }; + + // OTA + bool updateFirmware(); + bool checkFirmwareVersion(); +}; + +// Global instance created +extern Wifi myWifi; + +#endif // _WIFI_H + +// EOF \ No newline at end of file diff --git a/test/config.json b/test/config.json new file mode 100644 index 0000000..a55ac1d --- /dev/null +++ b/test/config.json @@ -0,0 +1 @@ +{"mdns":"gravitymon2","id":"ee1bfc","ota-url":"","temp-format":"C","brewfather-push":"","http-push":"http://192.168.1.16:9090/api/v1/V7s7vRXLqnsW3HdxxRuD/telemetry","push-interval":30,"voltage-factor":1.59,"gravity-formula":"0.0*tilt^3+0.0*tilt^2+0.0017978*tilt+0.9436","temp-adjustment-value":0,"gravity-temp-adjustment":false,"gyro-calibration-data":{"ax":-4814,"ay":1143,"az":2270,"gx":47,"gy":-25,"gz":47},"angle":90.38,"gravity":1.1106,"battery":4.24} \ No newline at end of file diff --git a/test/device.json b/test/device.json new file mode 100644 index 0000000..dff84b7 --- /dev/null +++ b/test/device.json @@ -0,0 +1 @@ +{"app-name":"GravityMon ","app-ver":"0.0.0","id":"7376ef","mdns":"gravmon"} \ No newline at end of file diff --git a/test/status.json b/test/status.json new file mode 100644 index 0000000..804a1b8 --- /dev/null +++ b/test/status.json @@ -0,0 +1,12 @@ +{ + "id": "7376ef", + "angle": 89.86, + "gravity": 1.1052, + "gravity-tempcorr": 1.1031, + "temp-c": 0, + "temp-f": 32, + "battery": 0, + "temp-format": "C", + "sleep-mode": false, + "rssi": -56 +} \ No newline at end of file