From e5f5408540e3121d7276acd8ffc36a1b3ad77d20 Mon Sep 17 00:00:00 2001 From: Mitch Davis Date: Sun, 25 Feb 2024 15:54:15 -0500 Subject: [PATCH] Added Mechanical requirements section Fixed inconsistencies in documentation for things like filament diameter. Moved filament density from optional to required. --- OpenSourceRfid.md | 28 ++++++++++++++-------------- images/TagLocation.png | Bin 0 -> 19164 bytes 2 files changed, 14 insertions(+), 14 deletions(-) create mode 100644 images/TagLocation.png diff --git a/OpenSourceRfid.md b/OpenSourceRfid.md index b082b9e..a218a20 100644 --- a/OpenSourceRfid.md +++ b/OpenSourceRfid.md @@ -77,14 +77,15 @@ This is a list of data that will live on the RFID chip, separated into required All chips MUST contain this information, otherwise they are considered non-compliant | Field | Data Type | Size (bytes) | Example | Description |-------------|---------------|------------|----|-----| -| Tag Version | Decimal (2,3) | 2 | `01.234` | RFID tag data format version to allow future compatibility in the event that the data format changes dramatically. Stored as an int with implied decimal points. Eg "1000" -> "1.000"| +| Tag Version | Int | 2 | `1234` | RFID tag data format version to allow future compatibility in the event that the data format changes dramatically. Stored as an int with implied decimal points. Eg `1000` -> `version 1.000`| | Filament Manufacturer | String | 16 | `"Polar Filament"` | String representation of filament manufacturer. 16 bytes is the max data length per-block. Longer names will be abbreviated or truncated | | Material Name | String | 16 | `"PLA"` or `"Glass-Filled PC"` | Material name in plain text | | Color Name | String | 32 | `"Blue"` or `"Electric Watermellon"` | Color in plain text. Color spans 2-blocks | -| Diameter (Target) | Decimal (2,3) | 2 | `01.750` or `02.850` | Filament diameter (target), stored as an integer with implied decimal points. Eg "1750" -> "1.750". This is the target diameter of the spool. The actual measured diameter is stored as a different field -| Weight in grams (Target) | Int | 2 | `1000` (1kg), `5000` (5kg), `750` (750g) | Filament weight in grams. This is the TARGET weight, eg "1kg". Actual measured weight is stored in a different field +| Diameter (Target) | Int | 2 | `1750` or `2850` | Filament diameter (target) in µm (micrometers) Eg "1750" -> "1.750mm" +| Weight (Nominal, grams) | Int | 2 | `1000` (1kg), `5000` (5kg), `750` (750g) | Filament weight in grams, excluding spool weight. This is the TARGET weight, eg "1kg". Actual measured weight is stored in a different field. | Print Temp (C)| Int | 2 | `210` (C), `240` (C) | The recommended print temp in degrees-C -| Bed Temp (C) | Int | 2 | `60` (C), `80` (C) | The recommended bed temp in degrees-C +| Bed Temp (C) | Int | 2 | `60` (C), `80` (C) | The recommended bed temp in degrees-C | +| Density | Int | 2 | `1240` (1.240g/cm3), `3900` (3.900g/cm3) | Filament density, measured in µg (micrograms) per cubic centimeter. ### Optional Data This is additional data that not all manufacturers will implement. These fields are populated if available. All unused fields should be populated with "-1" (all 1's in binary, eg 0xFFFFFFFFFFFFFFFF) @@ -92,18 +93,17 @@ This is additional data that not all manufacturers will implement. These fields | Field | Data Type | Size (bytes) | Example | Description |-------------|---------------|------------|----|-----| | Serial Number / Batch ID | String | 16 | `"1234-ABCD"`, `"2024-01-23-1234"` | An identifier to represent a serial number or batch number from manufacturing. Stored as a string, and this format will vary from manufacturer to manufacturer | -| Manufacture Date | INT | 4 | `20240123` (Jan 23rd, 2024) | Date code in YYYYMMDD format, stored as a 32-bit integer | -| Manufacture Time | INT | 3 | `103000` (10:30am), `152301` (3:23:01pm) | 24-hour time code in HHMMSS format (Hour, Minumte, Second). +| Manufacture Date | Int | 4 | `20240123` (Jan 23rd, 2024) | Date code in YYYYMMDD format, stored as a 32-bit integer | +| Manufacture Time | Int | 3 | `103000` (10:30am), `152301` (3:23:01pm) | 24-hour time code in HHMMSS format (Hour, Minumte, Second). | Spool Core Diameter (mm) | Int | 1 | `100` (mm), `80` (mm) | The diameter of the spool core, which is the part that the filament is wound around. This diameter is to estimate remaining filament by treating the tag as an encoder, and measuring how long it takes for one rotation of a spool. | MFI (Melt-flow index) | TBD | TBD | TBD | Format TBD. The melt-flow index describes how "melty" plastic is. Meltier plastics can usually print faster. Formula is somewhat complex, and often measured at different temperatures. For example Corbion LX175 melt flow index is `MFI(210°C/2.16kg) = 6g/10min`, and `MFI(190°C/2.16kg) = 3g/10min` -| Tolerance (Measured) | INT | 1 | `20` (±0.020mm), `55` (±0.055mm) | Actual tolerance, measured in µm (micrometers). This field is unique to each spool, and should only be populated if per-spool tolerances are measured and recorded during manufacturing. This is not a TARGET tolerance, this is ACTUAL. If not recorded, leave undefined (0xFF) -| Density | INT | 2 | `1240` (1.240g/cm3), `3900` (3.900g/cm3) | Filament density, measured in µg (micrograms) per cubic centimeter. -| Additional Data URL | STRING | 32 | `pfil.us?i=8078-RQSR` | URL to access additional data in JSON format. This data may be unique to this spool, or just general info about this material. All urls must be https, and the "https" at the beginning is implied. Eg `pfil.us?i=8078-RQSR` becomes `https:pfil.us?i=8078-RQSR`, formatted this way to save memory. -| Empty Spool Weight (g) | INT | 2 | `105` (105 grams) | Weight of the empty spool in grams. This can be used to calculate how much filament is remaining on each spool -| Filament Weight (Measured) | INT | 2 | `1002` (1002 grams) | ACTUAL weight of this spool, measured after filament manufacturing. This is not the target weight (eg 1kg) but rather the actual weighed result (eg 1.002kg). -| Filament Length (Measured) | INT | 2 | `336` (336 meters) | ACTUAL length of filament measured in meters. This is unique to each spool. -| TD (Transmission Distance) | INT | 2 | `2540` (2.540mm) | Transmission Distance in µm (micrometers). Transmission distance is the distance at which no light can pass through the filament. See the HueForge project for more details | -| Color Hex | INT | 3 | `0xffa64d` (Light orange color) | Color hexcode. Hex is a 3-byte number in the format 0xRRGGBB (Red, Green, Blue, one byte each) | +| Tolerance (Measured) | Int | 1 | `20` (±0.020mm), `55` (±0.055mm) | Actual tolerance, measured in µm (micrometers). This field is unique to each spool, and should only be populated if per-spool tolerances are measured and recorded during manufacturing. This is not a TARGET tolerance, this is ACTUAL. If not recorded, leave undefined (0xFF) +| Additional Data URL | String | 32 | `pfil.us?i=8078-RQSR` | URL to access additional data in JSON format. This data may be unique to this spool, or just general info about this material. All urls must be https, and the "https" at the beginning is implied. Eg `pfil.us?i=8078-RQSR` becomes `https:pfil.us?i=8078-RQSR`, formatted this way to save memory. +| Empty Spool Weight (g) | Int | 2 | `105` (105 grams) | Weight of the empty spool in grams. This can be used to calculate how much filament is remaining on each spool +| Filament Weight (Measured) | Int | 2 | `1002` (1002 grams) | ACTUAL weight of the filament, excluding empty-spool weight. Measured after filament manufacturing. This is not the target weight (eg 1kg) but rather the actual weighed result (eg 1.002kg). +| Filament Length (Measured) | Int | 2 | `336` (336 meters) | ACTUAL length of filament measured in meters. This is unique to each spool. +| TD (Transmission Distance) | Int | 2 | `2540` (2.540mm) | Transmission Distance in µm (micrometers). Transmission distance is the distance at which no light can pass through the filament. See the HueForge project for more details | +| Color Hex | Int | 3 | `0xffa64d` (Light orange color) | Color hexcode. Hex is a 3-byte number in the format 0xRRGGBB (Red, Green, Blue, one byte each) | ## Memory Map diff --git a/images/TagLocation.png b/images/TagLocation.png new file mode 100644 index 0000000000000000000000000000000000000000..111ba417552b0df923bf4e2b6d2f99989827f2d5 GIT binary patch literal 19164 zcmZU4WmuF!7wFO{tRN|{G?LN^NQabkcd1A>0!v5=(nz<`f;5P9NJvUIk_*xeQg_zx z`|ka5|L{EQJ7?z1nbQ%jrt+#m@>d zl3H&~b~CZwew3XGtv`RUbh0QP790FvR9*^|kr65%5Nskvd|&;006i-Gi~A^X(Gh?B zlZL-$7hy--Q$x>Vc%(?YC2%~<7|_>5D&_ISFzf33o>Fx+WBNj>tIDEhggklx3117Z zkc}21uk_vS${zK!*jb#zOx$qND}JBCr<^-u1A0r%Z`8%adoU>cUJDWmW*j+%S(R*eB1NK}Z|ABDvmsL@>S#8bX1DS4BPJ_pbC-kum-_dW zzQ2ARy&F%$Q&eJke3A!sZ2epQ0NfU$(~0)-O|dlI>hqIc<3NFDm}iBkFM(x@4WPyVeI} zb{7H+-JU*;T{%x8#-y@0(mXmm5q0ezp$@T-n9=pI6Oe^ zz-&r~;^xSbW;c!I*3TevI1cJq*pJ)rQRbo{{?kV&Z_9IB{X;XXqr(gutGhq#fq4!} zGHW-_zMPh2D|4t$qezKUJ@;2=+G z{oQwempYV`1%E4z;_#JX-V~26mV0fxg0zdl#ne2rKKHYjCXvtc8+cKnKfh))@qLaQ zfF&6oi>-HIL7$gZ&35X$7QamCAr#_7O=6aN`|5*JKJp6C@NQ2f!u@2}G5L+sZT~cF zr+$=%$|tl1`Bsn0wXOU1wj0_9eWZ&G4>wL|UBlL5f6hN5BKfVTg*y}FB%W+K_Q`i? z@Xelhpdb3s^=nkH<1`gtXn_bJTg1a9G1j#?v&TK`!nJ``KQ8008kyq|EN+aANrVp= z)vcd-j-GoiTtr*B>3>PXsSr+VO7kON(O_scjlw(KlozL`xJyMou?`L=mrH*&gNX|M z`LiM1=)6}ZYba@uJCQOxp(d3S#@tIQS4ER7BMmUcxS6j_HOiW>5dI;&6u8L>Hgc9pIsILKZp1#cmA zcK1q!V6crt^Wav#Mq&D8aa*uQj)GT?ZbqGd<2P3QO1~>A{+~8=J>B2-SOtjXE*Y`P zdI(|ra@`(E%$1U%HqXnB6hA;?Vi<0WM8dgKNgxmjO`Z}CZP6U*`HLM=Kc5V@pEe%0 z>&uHb>Ri172 zJ^p3Cg67e%sXc*XPGjXV%wP4APUp*XLbmwKmkn1{{PWVu;x*mRXbWPeXCoVjHy8le z`T>JdLOhTl@guiiCLiwcj$bofdm6?|Umf*_H1|o@kmH;>x0pMPR#ZD?6&QDa*p~)S zZPYxqj&&ufegl>Y%UP|J$C{gWQ+6IdSZJ{wFaI*+=h3r7Yzjnd=PnM3NIlE+{^0Zh zsL8fW?ix$Dj`^3^!IScthju1CO}Ro=!#^bht@1Y1;6j|os|=xrypN^Ad;AvIr)=7c9j?}_+BD4>RVL>C6C$tQ?ti~uxA-3 zOz=B2@UX8Vi z`Vs*;-g9+SchTz^k0snP&3|%afEj<9poorxCZ&0~l4lW526K`w)G@+6_3%#eP*81& z0c>4C7fRZVSntO2>k-7WOu%qX#}LfV9w?*rJ+_=q<)4!B%@EUgB*O#G2E;b|fzKAn zt`dGE*0JF^ubU=c$F;{Uj|mk_ToRwlj@*xvGCC=-eMh5`Zk-&pam5X8&Tb)ZejHe1 zoh^;Y@?y~Bp57oT=L}32pFV+Y%mz0Oq8b)egJ-#p4}s_r2hH}pe%W=g_fq%Sv}sbK z?(Y;IYtbqxD+^gR=gH!)pP)c$*v-tYl34YfZyWWNdA^sD%rsDiVAYsxlhWVrMQ4w2 z(e#~rfn#6v<`4{a&edQ~tDw1`_734#^;F#kni1sI{=~gschj1n;x#e#;*M?iXz!XF ztT&S@5oWdqTx9whtFv;jv+nUO3-%&(HbR`^p+x9|T3Um|>#D*p9?aCJihjxffSZRz zNL}-K{zP|LjK)rg0ai*^qb;6pssJ>#vFA9OzvpPl-y=)#kO4U4v1FR$WGjBW^HU+u z#B)E>K9#n9+``*H9FF7G_-8L~hCLx%UJnvLHg!dze9HvU;Gl>QM069Gu<#Sd+n_Zy#-JiM9vF=02`g=LPtYh2eeSi}`R z0WgkFHyIpCjXPMyMsoaUYmQesFqmUNxYjy*8gT--f-72(`Y(JrOLv}X+-DOSvEBm= zWPrb!%$3?pbC+I2JNJGDU%uX4cWLx@q*52>VkU_%fP!G(8%mRPlP|vH0b&vGS=U5M zwjy~fWc~tj^h2{5{T+$a+t*cmF~S9*Ca&WpDr_&S;C`jx`Eovz$TY5XT{${?j>d*C z%;E;J1|RGh@qK;&R@nBj&r{pQJn6v@m=Ac7daX5CU9a!f^BC-4We6Fia)%s9UCx-I@`U~t_XJhf=;BO*txEeRL`?sK4 zhn7G*?6O+CcxKGShF;I86zrG?z#h>B7sT0bnS3Pjo>2HAtQcm2=Vyls2^iGKpsWin zb4pzl*Mw5h1#cV{`y9OonrkOd^TmDhB`73-b4;{R)=Vk|v7ADSHgh0DC@B#PP1CI# z<)}=Zdigrj`yutG+v^k{GhYgy>vUlUC2UZN3=+>3Nm~n5`Fb#G<>}adJi@~*uK5US z1eYy)j~5?!yS??P%+J}PlJ-Ipo3pdNz>^7(SxLoU9aY#N|5^f&`b+L}hsfvP+&HAQ z*p~H0M}=jh%Zc zl1slHs-w;KI8O)$B&Ti1t>0#HctXNod?;!q$dXmz9c?lr?_)3j)pnCTxRt?R4$Hh^g$qptmVE~`g}2H|EB zt?FE`UOu#)3zn$z`5_@G5eS`4wo7Oq+FDLNrTjt2FZ1n)2jETlLf^(Uo7)t@*L?J; zue}zC4z`qaD*=0SYl$v9!Km7DUk{+`H(TNSAHnEeLYc2wW{%!rNnxj2{!A!;qaBg` zruP70351qE1$f3hetUnF&OKicp;KYgm2NZmj+WbMAFcAc1s_#{`|YKSmL4!Vk}V|m ziH@Pa!<53l`#BRdH$PHjRrm%we8UoW{MYOY)eKb&nfz0)2nLAI$+79KS;(TS4a?Mj z-sa>ozKh|6Ko08N`lBDYxN4d9ys3kBG`e4+?c#7s4gHE8O^e}yKxhL0%lUQepYM1}Eyw zWBMPdTqM8fTqlPz@xTfp5J9=Q;I_LiOp4w;5;TlFhCh5=W4XAc`N z(drqLe^X-8TmGg4;e7|zq<8Emow1mFojrCbu8D}zhd>_Y@H3Q_e+l~j7pbLDA%NKV z4-wi#%?9mtc8>i$T#x{gF(J`snWV6(nFjppwlJua(t)_9$kJ?;Xj+Upu#$QFoV;xy zT=GH+4hkV%aMGIQdCkj*i8pf6$t3pQPi79LU1aIyB009+XjqK87QDMfSd#EDTP>68rL0erWb z5kzUh46D{Cc7wv^fZ9-=8h8&UYyQ*i!`F|2_D~ADtUU&CLQ9#SQ5LE2+mZ^>hRUi! zaC9KB$t5cEOqDx_E_fu(NVp`&pzI?x@$vvUgoDNz{=R3~Z`T3?jRL^`lB7;E9WPmf zja@J=qtQUxqGt6pBC$JI{_3(;itg&><|>twNmUCNj=w;J+@8#_OyMiSTP(6&cn%&3q73AY;g z`+s(?dm>Tv15t44g6noxwP&Wr6)znqaY^8I;FJ`>!JE6}Y$zjn3RKFP@Rh*%oita% z;IbtHq%GJ@g>ZL&xwLGtE-%|mO$s|#^qcP+@s%R=DnlN9cq9N1*dcwVV!}1cZre?Q zgUJ{SolUUqCao%)_0P}!6&I5TfiNUcY&RBj@JVq)0g5!ci_AwEid@F+J&KTk`&(&? zr31h7if__xyrL#2G&5J&I26bhdyNn2sU_)s8n0cGAeCvMN~PTtoAq5v6QXttm= z_bqqb<|cw|ym)3zjkBB7^}CeezTek8dnsD48dJ=fr{x+4j&%IB{dxyzoH>(%OyO8UQQdjMb)Sz7ZnS^(&55bJc{yv>aA)FL%>j#EF~;D!uIl-# zhaW4^w&^d(aUtJCy5erXvJ{>ULh+wszn~LQ7h;=EM(=VjYUpSuqwrk&{9NAeig)F; z6Yc&W2iY|~_KRht;mMls-kdtp`0}C?wwc#jJ7Q3Unw^`#oA4t%WONK;}`5`52BCs3s;vlFWw* zt-beI6=>TzXK`?`EcLnF#hu5udl9N<53cR7qjtZpqlKH4na$Po99NP+4jy-*Q~IR? zPl~&OmcP!fxXh%m@d~HV)B1xTT5lV{Aci>5Cw84p|E{`W9M2J zWXp5-AZ?M0Vo?70IxaAL-P_8 zRX>eJ#ij8D=>yyX-s1gZMjmG617TYJMBr4L^}F2V&`l=BG(ZB{{wEL;~d}3aP(-bHD06fPg3_4-~z9omuj?F<;LEZ?Lfb zOLPtOd2NmwccK@uKP`bbR{M6q$Va5#XZ_K|Lq+)!%m<~y2Uw_<#&UjjZYQwcNx789 z)7@Ak%x)ny9Z`7j2$%mHR=?qbpXm9=n$ju3T>4WFLv8b8Z+lIj`j&;sa@snRIZOAX z3f&F43EOnzi46}!{Z}&0b--{t*1OwK>y+=N#$DFW2{VR`+ZqafU)Zf{N_uxXs}sfA zw2(xC&@JEn5&oloZuArUPi-@A!`NXD>GN+B-7TIAg3WTsMBVqISf%VjQ;{kA&opE= z;Ve@gH7e=iQ+2H>583Vh)a{mxkq*|{mydOyu@=vrz09n$`np>!Y@cd0_uPHfrJ>IA zPfaai)&wlj!JDx6X;3i~n$q!1sLwK*I}*0HQ@Un#Z^2ALI-gn|v%7@-nDaCeP#}jG zd2TC(NDkVFzKj0$R0!7uE4aV|;fm&9jDfRi$qjA8#W5qylkwUwxzeQ#-iW_>x$v?J zS2EX(ZEXKCAQo>h$OG(a9R7!Fk2b> z;1eVHF1Lq|QJhr^$wFZqLpC3IJxCZcVt(Y%Jd)UXm-i~`>dzt~bR! zf$~c?3zRwfe@vJBxp8s;qg^}J9~0w!*%%YUr#7UPcm6@!PWx_zs>=RXraPO)vp3Z_ zdfaupFi`{7je)5TfB)fFb;c$?XaqIFxby)S3gawiVQmksg;lUx`3zg-zsAMIv`n9U z$<}AH_xR!xnr7%hB9k9mjIBFS{5hTmo%Od%$3eaQAe-noiZSeAR@`t~}Z!~jFkrE{$ z90F`w49#;q-1prnGwwt<$L?hfqaAn3*y%s*mHys02&ibF#T1i6dq69w4moJQk^H&z2=t-X?71!u>}%OqTq-vb9TUOLkl z=wh9^dq^>elhf9q1DipsLLeNkQK_b;HeYNv^!!U?G~>V&#t*C-J@K@K%%ZhXO@4m% z3q5;84x~~RBqfsTUSL1KN5|&uL&k)0@AkTe#Xr{ksa8}oyUw&L=4@PF+1Qa+9P4zR z!!T$9(LBo=>%Gn%8xbsw_xI?}T&GOEyM zi@Athi=5NZbOL`3s++wHe!z*cKT4k%-0O2#j+x*Zu`v?)S_HhZ{f(g7%plaR$<25g zv9Dh58_ggR)>{q+Y6{3yg^K}Z0=7Xcc?Pw9z^6O+B33nAqM+VV$(d;@e1puesR^o| zZ_~~Yg7ASlOF$S(kWF00dtO6=55cAje!;?-RbKqD>ii1P$a2Cz8)lFLKD zfvwn@Z!C$h))ttn4m+xxQ;|fmP+F_SzfQ6D8uWxCci0c`a7Hi^{Zbb5m}7k;VHW~C z`uV~8N{+yt(Rg`yxe;%~3hUg3KA^3WN{&3}>$|@gNC0*oak1M#bR?~j9`ei+fNj}p zu-)&xZbytHUjxV5T1d=9n~&m@Q!I3j4($4lreSa;!<{X|8;>rSluLw3mo?cWCwDG0 zX59l5aAyuJ>*hksB~M^9@To_RI8^Sv^a+gIux!YDhuVc1`}V1AdCQY(qme$kV5mV> zxyr6G@bXZ^QsyWgNt9+r?7a6`3A`6bfCP4N_nf>{k$#H{8{5TxKs%}Os&wBIKA@Lyi92R?~1=57lX|y0YW^Z?j8>j6pZ%*V`VS8 zZa@MkF!~-6y?dt~7CwP%N0kdI5-1jfc|8}m+_j#zl7*q*=9kg?ao+l@$y}?JjhO+c zT?TJplqGJXtd8)8iuxQ)Y2ft3pFG~|bLgz-D?0loAc70E&G+$Go7TB+5=emD-y8qL z&8ptK>XO_M3p}chLC?jGcb;Qt4j&SjrpHaGg)v!?^q6On0309nG5>D~h_@e_KK{e7 zIRFJ7e^1mg+YC;F-D@oz*tR_tAOd#dO*~O}0`gHwPtKj5%1Zk%BR^R_pfxTwRV&wY zRBO#U`+6Q}&{6bQb2!4re@}J1LCbf6MO|zBc`=r3?Xbvm-^|%hdkH&fz^87dSYnVJ z2}iz0HsQxwi+b~{70c$Rv1!yiMXf8*mcm78YK{_4xoJzyKhGYg{M?wSSh1w6B|O!) z5jcIQZvU$ts=0K3;`S=J=%#qJh^2_ESm8!k}yw`AutJm6@Da%9@$Z|lx z_O29D$El(xRAYvGWh|&A-tDN^`Fn=b~#F#6?y+`xF%Qo zTMK%x_q=hpkv)xmd4rKj2FQN;-QC%gK3QSfwBgL8FEp1v|{nWlOwLLhFihh9pd6d6ER`Cr(x;b8+{rNBF%>tLJ&T=@Og7#hj$3qu9`} zlDV#$-)|Z|&W6KxhTU#Tq;3XCy6)$6knZ4OH=;WtPq~aK@)#x%R6ow%WG=aB*um`* zZ)f(Zx+HTvxOWF(m(WA$bA6%ZbCu7vE8}k*P$5L?p6YV!?AOvWMej;R`!0(hc`<8I zd*lsWjogf+(U`}9_v?5VMZ1$31&--kFnyzJ@-yx|1L;MZ7J@Su`eOA(WGqNA z%agUh$Fe{0hyg@oI4w_tCpVP{6QP-kx4P_tcK0nwX_wT+S7Fz9%s`&MK3-~T7v!=W zemMB#8Vx+PuFhLZjevuMSkBLot*iz55y{UWM|1B!xMW#72!0Y+n++1?F9Om&b@VKx zt`*eLO8a=y9lus)-fud@ow+y+Tl?J}Bw+I0Eu4EOQ$+XpGz;dLK)B?U*;M60;bpZW znpb1Y98Pe`fZGt+h1rU%R})63Fdk6NXG6^;$}Hn+yv=9*UxhaLAL4@(%ZaZ<3UV3 zb-KZ2mIJ7HVMS+WKU?G2N)~WVC;h1X!;*{6yml@^alag<<*7%w^rE6z7Tcia#n@Fh8AinKKNIuxa%l z7%abW@XLIAMNwK|%1?~i_=s@;PgrNdOdSPRd|sg{}^Z#k1^?TaF0T-@Wb zTHK+iM>yyaB|kQ0c0~-)(O~M1va%;3^E3xO64p4k6?Tv~1*RRg-qu0Q3Xe$r0Ep(V zFZOOr)3iZ3pQWZhI_OV-dG%E`AV$RN)iT^={U?doz9AJEmk}-B>j7F!T`~>*Scw*Y z()7QQ{bN1a{%N7NNpP+T9<=~HG-^$0)7>d9oe>2(JKP!N8->I-T|d;H7bsI%l7wIl z!~Cx$_o#US-!?SH%YMeiXk`d~@dk0iEm&y&G#k$jADBW3jc-$Nvga$;WYZ^AzSi`p z^9pl2{8f%iVq)cn)TZ!5jPUSidWHGu@UxefD|^AL>`BDoby`rg}{tIKP9KD))H)QhXjc=bfD=>tN+ z;;^ZEOg15rFJx}&Z`exz?I4@p8#Y^WK<1`~JxF(@#4*wzf)9Jv#)k0b|G3%{lhD*; zG|F6yF;j<5tYtoy3f<^C`)J+Et7eOa@jhSkBhitd$a&y?1~hHEtvD6U zUXr?hxRLI7a5>}f_U~3M)KVIxbX+rFZOb6q(e_ zBnFk$fnNB^-X9r3$Js7~RpaUpGE+vHJq4rSV%4`_U6kEplOGSKoBC*9gchx0n%5kDfN%{H0_%x=2^1u91Na zoLb=6xRDQ%XMxc;xvbawHCzJq#$tDHzU-jgtokLt^tayM5@HbMLeKcKFFnEBVBl+7aFt#9zi zbo6G1Q+Pq(^NasNu1JeUms16~vgN$tRKCa38HT^&%6aiHln|z(=#qf3&k)@0ap;R7 zQ>fn5kHCBgTvMji?Sj@Lp6GjF%pdK`7kRmUatTuKks@Uihtn`#zf%NvQ58FCE0o0> zTBhjn@xQmrFI8sLX0@_fDq)i>3?3n`3R=hKiWY2c{$4!Y=;=84Gv)lX9hgv1BHCJqR7Au%?3!Jb}jis`dEmE4$Da&a= zx`PKVa7g}lkSr@5Y<^Bia)g4;u9RA%qj$WI_|gb>FJ8a;Roq!B`IixX0xlcpxPsur z|AC}B`-y`JE$3z=RIq!BhLs7WB};%^D8Tuf_bFSrHL1#^$`1Y8R?0+jAzmkTt=!pGrJIz_POY-w| zWHyb7-Rx>s>b|qQMXZ?nY8nr#xED?Pm)PV_DKU_JJ zEgqy4)AHltuY(U9?6axlNC(n85h`YkI;DD&E}H3hi=Lo3l$99dkQu?g;Tn<%f=wcd zQ7)ztg~A7JGT8f*AXfw>e8S>#xFRd&h|18u5r|YVp07NJo9>{3aB|h9$bo@WK82-t<@PH=b4&iGZ-z$3p+g8lj$4^9 zK7l7<5+gWtO%JD3+2{s8cU&0ZD9gN(!_*i0n(*5-;K1QU^nnG2JY6<>DF|eefaPBs z{hF#biWOz)<-wRL;zOFv@-AGj$_i&IKAY`=inhs6gb^#dpg8x*|3C^Sm&>(DECfaE zns&}Uq$gxi3AqFhC$z}`pCRI@@Mhob#J78BQI^2z+L8FK4*y!=0$7%w+5p3ma*k6U zU}skZ^3g2jk}dFPbmjtW4Wi3otsNZHs8zI=WnX`dA3XZsQ66}AnRZvkEyPmOYK12@ zFEG!)tQ|9O^AL(%&{8awXZ}70H-eY?GtWi)Qv44{G5Gu!(`Q`tOlU`FS~67G#Ov~< zm^do&G0?2>g2kNZ*;v7zt9%T{AVYld_FNmqF^qFEO+I#fvCp=NEMIy=yi)OI7kiA#r*34Vob_-{{~ySb zS83!z;APw}i4Fk}492dx!%?hirz~{443H#c?!-LXIHu<&{`@?KS+gVpJsY&}oPsjl zeXOVz=znp0-`d!j2ufX0ByJYvP1aRT?az=0RlYs67%kMS`|bL!BG-?%K5%n9BKy+F zd>yDGnI>cRsp%UZB*CG4=~%JnOa9rzAKH}R7t3Lc>=^9kW~-nUk|pyc9)|cY*Exe? z?VYze4Df0NT^;r@v#IYXNjBNL)amc;wu2PUt`Vr_(l?u9N3F5&+rTd>aer@gp>2Eb~Z}Y;0q= zcDH2*cAw>KsEheivp(qsSIq2bUvPQ55X)XKOcU(M{xyJ~ zbEmn71Zs_Me}ao$A>(Hxw8^oA0^~gfZL|i&Y9=%(Xs8b#r=!s)&&*Rn&BEb#c6XX^ ztl)}V3linAs@KCbM5JqvFN|pIitM!WM$dHGAxfZw?}}Tpb37yO_di&2zE=fF$i?Gr8vZ3)me<#~ZbheAK?0tdWJ)5HHL*8M)j zb2AHOl?-{BO=H@NXS7WZUlR<_vxT@}WV1uKg^l^r?0*9Sd#(bfQ$a8GaW?E-_?yfm zIg_+VoT8DZVtQHd%!1G@_*Y2VCP?8q{Acm9yL9;fOhg2M(OW(e$p_Z!?farPQ=FYpuW>OUwG%hj?kf!s1-QfB0l^ z&6WcKEiZic)4+K{L(+{+D?dKKhtTEn zv^7xm1?oQkz6q<~DM_qS;um;&44zBV$r*HP>Rzf~n_Jrb&jnF7V-&QTmgoqA+d6n1 z?u!O{Zod-<3fH24)$jBJ{t43dfa=1^;fHw(gVZ$nQr2SPg*RnyBD?OzJWiy9q@N-0 zYjQzYQ1@x|Wg<|}H{C2a5al1wmG;>$LigW81t;f&p;Z^DvhY3hD68$svaT>v&z*AZ zTTy^o%hSq~r`Apc_}s95&=tS*F_Q!@OhkELsAj#?yJD&c9<(_7v_9Ku5d zaQ9!L<8u@&D^dyHUYb8%*(hbXI^RdQvRcz3lMT*1>Q*3;`_CEGi+$jhwh^2KkB78r zF>VV)z%HV(b1O5nQsr=6sxRQUl)W7xs&NBJ%Yo-)QkF9V!|RNLI28YulQUWzvI0t3 zbIe%v^-2&Pb>Iyj3z5vzfk200&w*>rzq%1`(G)u>KS<6wdIQ}Qc@f2-J-EZ~mo0oq zuqq=@U6%QX2E39lUliu%?Ogo5N`Cu>jOgtdYX3NcG$wUo?SP~S8`fyoXdGG3Jck`h#I>Rn_7TjHVP&j(Wt<*ZVI zj*9~b^Tr_K%gwoJ5rv2Yrbb=-2Ti)5432Cg$TVK<=;IiU>2Pa7Mi` zwqY*#YE+pqJSaGPd5lmn(V=8j#9_G7U9H38Z`BUroe)sPE9{{;aQi`7NWBI8JZDi}#HI%t%(R%taE4|}w(p%VZZ$t%s)i>nIR z&w&bt>_8fOB|PJom@{|g>SKmib^00|TT}w!qVk24<^qi!N3DFp8y<(f@K2h3ONay% z$i_xim(ycqnGjNjxok5KRywn)-{%{S>ZaLdjAQ_~Li5MBGtO= zBWRsyl$`#E=_8c+sj^id8y~{`gy_%y9O-#;ucrn!XFF2$G;jvJuMcBSJ@4Xh*&1aM zLl~m7sAkbxKF4R|A~4X1BbF89EP8Ow1r@CI(IK!9$uTK#HvPeZ21yI_+_*Q`?qX#9 zs|Czz{3rXD+3VYh8M`}Ie=H!8aIh6hD8F<>zmlh$kmdDj?U=;}$3!GJX$6__ZI-Ld zR7HjGlMv4_qpw&QS(7+q=qkv0sL;0TMKcQ0r#$1aq!e;l!!{*L`RMC&9$Rb~nqX$? zNwl#o1)6FnOF4d#NQL1HreA98G! zdTxHeh&;IfNzU3{f~mC8F9IN`NGn_$fAOs`cE08gzg)$hYMYYR_I8PWyq>9GiD zN)IQEh|ZP_V|?oliI2`~xBKRwv&6QGiX>!=KV8}SBY#54#43+pGV{f%lUNj8{GpU> zti5otM(;G~&K{fylEXSv-$p~k}`&3-+lfni8xBpBbe|O!Y?rPK|@;b zn3@z+IqaW)eg0FsLFrm;z~u^NdA zIza6Qss>*9kC2N;5dMYe;bH>cIFuT*+w)(!=gS9^AGopdVw-4Y3h+vA2-V<}KC zRCzM6B{{A*;|Q<7Y8y=%6=S_nYC%I*5>;R&%8dmdm68wJX&_1r3gtRfYa-mBO>LWB zY#eQ_9PNvQ^38gJ5J};s3bKaveZHjzX6WZ58N6QKruepmo&~qwoHlsmXQsfT?N9?& zpG3kVh#p(nsm%|+76#-AT!z8p^M0)BLC+vbxQ+K*FM{;f3onL{n+ea?<-yc@^Fc(O zh6LlSZp;hwAM~_FmROc8(Rj;QNk)?|e-i}cC$vS|Z;0?C5#tu@rT$_XFj0kwdakH? zkVy%M^|BEZnd<(oKZ{yr6RSWoyQgfMO%+)E53`KP$E#_Ibf&{t?vTwGEiodaQW z1hP)sAcyg-YVI-hWe!1rK&9{QH~ImLcTg#I=hY@fu$w1k>pENlt1XTEKAF`;(*AEy zSmhj(3>h5mXN(tub7Qs5I>o>L@w)EumS^Jr8uDvDsB9278#qUI@4Z4Upwt)2d*mmw z^b1)gP5RfZr{34P67&=@shFlxb`ie6`43EIut{YkWg(q#1)|5dBrcx2S`PnLM5pj; zsCbeN|LM?bw(V}F8Tp>@u+1K{A=juqPhvKSRbu*Z`TJf#?Wz$Uh5MV?k(cJ;Zi9k>A3HHwgNKdOiJ+Jp!v()!*-fUO1iBM;8J20yuy5{VrPUC;ZoeV5zRy z`-U>T=dhg;Vkpf)`oRxwZqc)PO&b7cY|^Sf9>&=$s%lxy2P;LXki`tS6t?7L1DS+M zZP~$LMW*-=cr0d{j(YfyPnNKuKOWIAd_a@I)fjfn`yl=nq`}(=;)m1?bWQSzEghqw zg7@~ym}R+%mtywKBpiZF3v&@wUYvkF!#%F0`68Gf+e|X=f~PF2k}78LJ@-vw7Qp)0A%DFjgd(3HzAwpi5NREax}A;fq^K( zwia4&af{a=uKx5<>B*5KIm9QV?7dL!8^3iDzX}P^BOQ%3iO)Rb&185vnnu_GndZ|3 z9cUg$XrKu_*ExfScDqW0`Q|-g3uIb^09>x?d9{zx3f8?~Xh(O0|EbwZk#<&YrC=&p z0Ex3!?pKR3zHS4YJN*>4m+7ZYm(bFKWekzvqzu=)?zbgOz8xZ@0hjkgfPO1znTB6d z_w-Y-O;pHjUVY(*v$kdT4oP&-DYATK^U&9TEskS7h!c_{W>KkE^Rhdjl;N5-5bVt@ zo@yw$#*34FW&Rs{myl=AH}Zy09lZ-|2fznIFTxLmRV@FY!DBHX*P`r=ub=NNV-W+C zMUF2Isms~dMmzbl*e)P=kPDxtJfg#`sAKj@SrNbpYIW=1lRxY+M&&cXodB?irs=aKLT!AgZN7*ROQ&3fbC`*L*H8vfuIg&1P?j8UWVqQBU8 zH0BWOi@iGt>QS-}Tv+Fh88QfyAdpq!PKO_MCL_m`;^crEO|0ro=x>bu^Ld={VT>q{ zf>l3%&oF5{5;VFRUDzXAcLU}GhrC0z4lH>{z!p?<5jG;W2Niz=Kqq~#Dyts4q^|Kt zh4{gpK;tt_o#c#Tx$>S{G%N$K^B3ea3OSVki#7hv5SAv_E_Q(eNy{?FWEoT! zl>7i|0%#2q?2`LSF_Tm?)$@uSpg=f+5-BRhurAwy?VbGd6AN#qiO}P;Gl=jl1k(R* z5NqbInb*j^LhC63D5F0#yt8K3AlKE}L(K(-}W65e}8 z?Z^Ga6YmAvkAk`AtO?4HND`PVoEvNad#4e8F&(dtQFz&o96O*F8T_( z#H^XIB2!~2WAcOmN;@UBBYP* z`45X<>HI1Rmu=wty-+Yf+Uj>_=PwBffOZr(Ss}ViUlJV(QfAk{+fX6Xq}9^RnK5Qw zVEV1t_b97rDPIGp@pNSn3yf#%(iJpikRUvRGr9Y)(2-Lhcc}*6TN^HOPsQZHln7a( z7RTbesK^R7>;cfI<1OOV*AY@&qAx7fQD7MmNL>twIu<8E4MAP(DVQ@UzP2*?;qJa` z0(%Kp17{Orrph#3fsu>pB77-pm-=TD+o39);*yrC;$q||kR8Iu#WHX+3)w%w#{p)? z@^Y8Yw}iSzF~b25QuI7PnN5hd%(NRv%vu6uFK$3HKIl8Vma-g_5xW3mHjg-^q6aBP zF%9dav7W5fjRRYlV4#i$J?*9r$_ZF^Nv82!*z@mgeF4!&J+&|g|BMK?RsC0G}JKwMz zbrt}!GnY)V7AcDaB(L5`PUHD#eCb9o|5PmT9 z$gj5O+?}N?qRb<;1B)08@jlAp4S)MO`0@lq+xX4Ix&kcY;HGHw2delWVRWbq;sy z?MFI2mu6tHjk+GVU!7Aq;u1aA$68DLE&HL>*Eckd>7a;aZ#y)M|i=&_Se_riWDMaFEO=$654^|FsGF-U*C&P zGX+-GIg`*0D%F4V%a0-q7)k|U2c^q)K%L26i3a7rSMzj2g%<%>bavh|+CL-pT4CUI z9E436E>Vzcl$(_4Z+X~<_78>-PSN-vKJeFIqI6&0&)3mg&O zJ;^_25(B1X5CJAtdt*P5HZoc8i1gL5i|e64+DKXB6_{G@S(9Di333IETmxtHd>!J6 z<&o6iqb2SD2Q!~9R_RDTES~Xg`Y%2$Co23SWzC#TmF1aoi_*rNrUISFa<~U(&H6-v zX*u7z;Z;3)MMzqb-&Ls+j{@H+<(+4EHxvyp6OPQ2}mk)FWXpK5nNz z^mPLYU(zWAdRvWZ^v; zkBS9!L4{gflM|pXoIALJ!JOLd{bfXzF$XDi&gy4Aaci)Sobd4<+*&CQZ|}PS;;<>4 zAl~4*J>VCcJhrDkE0ZyDZ49x0)Q#%~mcF7@XCrkybNNN%`_iTG13VyfM924==UDr6i>{>`z! z!(;-^9X4VBw=_sLMHQv0|L|i)y2kXJ%v>J~O6oo18t<{DJM!uIID)ps@rMC>57yurIv1Wo+c{Np zU`DL`TvOY~AKc39NWXCQ#TBD#1-9-puz15fUGUzg zkX{Echg|3-{eJ?{1TOn>P8?V>Sdb(jG`4$I4!SzLIQ}c8LVASu!Oy5ABCKiw006tB zNGukAtX0WQjOvnj==*2;3z7zejdjby-e*cu!@gik#c7}WKWYl!5di=I*eC4R^0hQU zoK24O-o1WO$yq*$K-du3>9q5Qo+mq|hHk#OUHT?!A5raQc>n+az#WlFeNG}4{}CVR`Qz#_9nRqJ zJNQ=~TsydWc2%2g-fp^YX`eYkollLf-<<#e0Dy+!Kpi3$i@wpQWWROI2>;=&>0NOE z9wckW7VSxk_Sr0zh>z1g@(Hz4gw-qn002xt9Q9FJjO^E`6~}tyMDBclR{3QYN__-3t?oPh)=(>vZqx zs%uN`%l|H`x&J1mLVB2fw)?4%ifXTb0RR917D*cQVd@sCM0`Fv&~3-Wo~e7cEbMii zPjt|7+&Hh|*I^|sH~G~rn>|ZEzm1~W+bb>VeYyYu0Du+14#ew8T}zYNNk^^naHq7; z@79j*cyiyWDnSy2=JUsu1FtN(uV8ytoZm*JLVAFHM#rctsNJZJbw5M^006+6VOwsq z9WdGafz1-J_=3BWc27}C=(eYZ=N|fQDRyBsrQbZ$_sooeSzl(*g2O?p*hxQwbD}@5 za#~yFZ%U;}V}l;hp>5tn$MnOA|N6 z1R6Fe)a(D!g3brrQrgiXN!004jn z;YQ7)-bY{IsnXCbZDF^7izuhuCeD;!hdsFRWBoIKST?%-)-~gbjxj%;+vCWm^D2&PoKx}h z<^?_3L2H7-fyo~KY<}fg_FU$MCwd%V|9<6z9rm#A_h{dYZ$@=V{H#;!u#H*GeK$q< zyKVGx(QR|mDRFCX6uUBurPWE~i-+cXSMM^8Gy9fXP0034CTV5I{s@nKs}%ADt@FH$$ukrf07Ij>Vm9og6XbAG(}?{CSzFZ=#eM72M!54EkR_H_h`YR}sN z00000000000000000000000000000000000fU)?0_?iC3z+kP=00000NkvXXu0mjf Dy@}Q@ literal 0 HcmV?d00001