From f2d4d6b20658286f666d89e3e6a6a8eea4ac7f9a Mon Sep 17 00:00:00 2001
From: "ivan.ruzavin" <ivan.ruzavin@mikroe.com>
Date: Fri, 6 Dec 2024 08:07:01 +0100
Subject: [PATCH 1/5] Added release hw to new-feature/boards_cards/13

---
 .../board_curiosity_pic32mz_ef_20/board.cmake |   5 +
 .../board_curiosity_pic32mz_ef_20/board.h     | 126 ++++++++++++++++++
 changelog/new_hw.md                           |  30 +++++
 .../boards/board-curiosity-pic32mz-ef-20.png  | Bin 0 -> 23706 bytes
 .../board_curiosity_pic32mz_ef_20/Boards.json |  16 +++
 .../LinkerTables.json                         |  20 +++
 .../Devices.json                              |  18 +++
 .../LinkerTables.json                         |  39 ++++++
 8 files changed, 254 insertions(+)
 create mode 100644 bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.cmake
 create mode 100644 bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.h
 create mode 100644 changelog/new_hw.md
 create mode 100644 resources/images/boards/board-curiosity-pic32mz-ef-20.png
 create mode 100644 resources/queries/boards/board_curiosity_pic32mz_ef_20/Boards.json
 create mode 100644 resources/queries/boards/board_curiosity_pic32mz_ef_20/LinkerTables.json
 create mode 100644 resources/queries/cards/mcu_card_5_for_kinetis_mkv44f64vlh16/Devices.json
 create mode 100644 resources/queries/cards/mcu_card_5_for_kinetis_mkv44f64vlh16/LinkerTables.json

diff --git a/bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.cmake b/bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.cmake
new file mode 100644
index 000000000..0a267ed1e
--- /dev/null
+++ b/bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.cmake
@@ -0,0 +1,5 @@
+if(${_MSDK_BOARD_NAME_} STREQUAL "BOARD_CURIOSITY_PIC32MZ_EF_20")
+    set(BOARD_PATH "include/boards/board_curiosity_pic32_mz_ef_20")
+    set(MCU_CARD FALSE)
+    set(SHIELD FALSE)
+endif()
diff --git a/bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.h b/bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.h
new file mode 100644
index 000000000..8de624cf9
--- /dev/null
+++ b/bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.h
@@ -0,0 +1,126 @@
+/****************************************************************************
+**
+** Copyright (C) ${COPYRIGHT_YEAR} MikroElektronika d.o.o.
+** Contact: https://www.mikroe.com/contact
+**
+** This file is part of the mikroSDK package
+**
+** Commercial License Usage
+**
+** Licensees holding valid commercial NECTO compilers AI licenses may use this
+** file in accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and The MikroElektronika Company.
+** For licensing terms and conditions see
+** https://www.mikroe.com/legal/software-license-agreement.
+** For further information use the contact form at
+** https://www.mikroe.com/contact.
+**
+**
+** GNU Lesser General Public License Usage
+**
+** Alternatively, this file may be used for
+** non-commercial projects under the terms of the GNU Lesser
+** General Public License version 3 as published by the Free Software
+** Foundation: https://www.gnu.org/licenses/lgpl-3.0.html.
+**
+** 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,
+** OF MERCHANTABILITY, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+** TO THE WARRANTIES 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.
+**
+****************************************************************************/
+/*!
+ * @file  board.h
+ * @brief Main board pin mapping.
+ */
+
+#ifndef _BOARD_H_
+#define _BOARD_H_
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+#define BOARD_NAME "Curiosity PIC32MZ EF 2.0 Development Board"
+
+#include "mikrobus.h"
+
+// Mapping
+#define MIKROBUS_1      1
+#define MIKROBUS_1_AN   PB10
+#define MIKROBUS_1_RST  PJ12
+#define MIKROBUS_1_CS   PD9
+#define MIKROBUS_1_SCK  PD1
+#define MIKROBUS_1_MISO PD14
+#define MIKROBUS_1_MOSI PD7
+#define MIKROBUS_1_PWM  PD15
+#define MIKROBUS_1_INT  PF12
+#define MIKROBUS_1_RX   PC4
+#define MIKROBUS_1_TX   PC1
+#define MIKROBUS_1_SCL  PA2
+#define MIKROBUS_1_SDA  PA3
+
+#define MIKROBUS_2      2
+#define MIKROBUS_2_AN   PB11
+#define MIKROBUS_2_RST  PJ10
+#define MIKROBUS_2_CS   PC2
+#define MIKROBUS_2_SCK  PG6
+#define MIKROBUS_2_MISO PG7
+#define MIKROBUS_2_MOSI PG8
+#define MIKROBUS_2_PWM  PD15
+#define MIKROBUS_2_INT  PD10
+#define MIKROBUS_2_RX   PE9
+#define MIKROBUS_2_TX   PG9
+#define MIKROBUS_2_SCL  PA2
+#define MIKROBUS_2_SDA  PA3
+
+// LEDs
+#define LED_1       PJ7
+#define LED_2       PK7
+#define LED_3       PJ3
+#define LED_4_RED   PB0
+#define LED_4_GREEN PB1
+#define LED_4_BLUE  PB5
+
+// Buttons
+#define BUTTON_1 PJ4
+#define BUTTON_2 PJ5
+#define BUTTON_3 PJ6
+#define BUTTON_4 PC15
+
+// CAN
+#define CAN_RX PF5
+#define CAN_TX PD5
+
+// Ethernet
+#define ETH_RXD0   PH8
+#define ETH_RXD1   PH5
+#define ETH_TXD0   PJ8
+#define ETH_TXD1   PJ9
+#define ETH_TXEN   PD6
+#define ETH_CRS_DV PH13
+#define ETH_RXER   PH4
+#define ETH_MDIO   PJ11
+#define ETH_MDC    PD11
+#define ETH_NINT   PJ2
+#define ETH_CLK    PB14
+#define ETH_RST    PJ0
+
+// UART
+#define USB_UART_TX PF4
+#define USB_UART_RX PD15
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif    // _BOARD_H_
+// ------------------------------------------------------------------------- END
diff --git a/changelog/new_hw.md b/changelog/new_hw.md
new file mode 100644
index 000000000..e35400b59
--- /dev/null
+++ b/changelog/new_hw.md
@@ -0,0 +1,30 @@
+<p align="center">
+  <img src="http://www.mikroe.com/img/designs/beta/logo_small.png?raw=true" alt="MikroElektronika"/>
+</p>
+
+---
+
+**[BACK TO PREVIOUS FILE](../changelog.md)**
+
+---
+
+# `DATE`
+
+## Changes
+
+- [`DATE`](#date)
+  - [Changes](#changes)
+    - [NEW HARDWARE](#new-hardware)
+
+### NEW HARDWARE
+
+Support added for following hardware:
+
++ [Curiosity PIC32MZ EF 2.0 Development Board](https://mplab-discover.microchip.com/v2/item/com.microchip.portal.evalboard/com.microchip.subcategories.modules-and-peripherals.communication.can.Others/mcu32.dm320209/1.0.0?view=about)
++ [MCU CARD 5 for Kinetis MKV44F64VLH16](https://www.mikroe.com/mcu-card-5-for-kinetis-mkv44f64vlh16)
+
+---
+
+**[BACK TO PREVIOUS FILE](../changelog.md)**
+
+---
diff --git a/resources/images/boards/board-curiosity-pic32mz-ef-20.png b/resources/images/boards/board-curiosity-pic32mz-ef-20.png
new file mode 100644
index 0000000000000000000000000000000000000000..1c458a98f0b6f079e128a2f6a5206e0c6911a6b2
GIT binary patch
literal 23706
zcmce-WmFtpw=S9h!94_R+=Da_T!YiN1(!6925;Qm-62@;5ZqmYH11AtcPBVp-o3y5
zjdRXDHtvtxV^r6ws%K4Kb5+e+6{f5xje$yx`sU3W43Lb3>g(S3pA8xD^}kyfJoLIl
zv6Inuc=HCc=b!Cu5)&rLn>X)TEY!6ewG`y}A-2}6U}IY&6INGiyI1s^H-aLrc3_C5
zi6e!PiJ66s5Y=f*2Ni{du@IFemjauDow$j)g^WAYM9p1M9pY{Y;WMTZ5vCAy<$on$
zZQ=-~aJ9Cwao~3qqWTZI{IBhQP6MeZ{sZD@DMTgu4?_wq1!W3xTc`;IA1gZxgpG}Z
zf`^aQhzG*W34t(EaIkT30@-+g?A$DDJp5dI{G4nQ|N2qAvV$6%@~cWn{fpV_kr0)+
zqoW-^5a{CK!s_yg)fQ?7Was1K1F~@dIXGBe5iAaFHjZFd78?iZ|Dqsa;sAkK*g0C*
z+EDyM5o~1Z<S0b-D(ZjgU~TtrvNjI?veT=@fUaOWAUiADKRW#f&=~S>oShTY>OYtp
zLx3h$Ce|i4jt;L__J3pT%xxWQ9n5Y27o`7v`M+cEYFh<`fAjdC%3^K(Zx#-YlFqMc
z{L3K!Q?!G+o1F<z)x^Qp2?{Zhbbb|+`X6oV_{E_nU`Jc1x~;9%e|bvzzeJ|s;AUl`
zV9>O%F}8JaVEk`7m`H#fO@yfa@fr&|I}01PIy(pdCtm(fY)owI{A_Ih301H)wlH=3
ze?z(WIXPcJ{~h!-W{km(;Qu4o7{YIA3$+HnDr{j5HZuX**_csL{M(HD;<i?{&{xK<
z(tY|5DHIg=K{gJKU>k@DNJ5C}RcBTU3uAr`J}xeZF)s%T4~G$$1;WM2!vcnwKv;~p
zIr)ruz-(;XCLI6OU&0pR^p9u%tH1GUe?Be~Q!aKRHWpqmyD<yjCr&U6*vN$Im6E9u
z#K@G>l#Pq?zxpddEnbHf*y{f?oqq=0KOw;{W8v`XEVqA+2sIP?f3>VEDE=b~_`#5W
zqFaax@{e0hjH&*0+Twp=f&V)V{*$bWxydWh|Bbu<6XsxR>gWQ7nuwacTI>H9PQd?_
z@D5<-|Gnt{ch37?iT*!?-~SiU|7BK)IoQU`<TY0Uss2$0_)k*#Pp1I?M}Pgtwf`mo
z{TKW-tNqjbcRqbR_;*G&v3Vs8ea*Mb1;1L~ywL~(Nr<YuW*k4cC7LYguZDU5T`_CE
zY{TK%2_5e5=VPk*XqlBi=_?hB4fn~T^L8D{J9u|tdFRdv0y(PBw%&tra@4aUBZ$c$
zgJeEp(9Q^&nVM`1O2Y(~+;}%v9-eS$MgNR{iF!HH$-L7)EN$i4EEmXl;_DE4@?NDb
zty`KcW4c>?KwFyiF<eGm!=JN$V`KmSXM@l7uYW;bhfKVw-fe*)rKQcM%M_o$(N91K
zFpKt*Cg@Hm^f{J+GqtTH)C5lZvoLa{vrMWv4Q??D%$TrjAh7pFurz568R{3pg{s-C
z4t=-O8c~WL>P{L=ZzvueJ;{>X-xYdZ1%kFy)e}FyLBfuv3RAO6&h1K-(Ygl(?=s2b
zzo(vvLVRWuyWy9JLY%zB=G7_zm3B_~`}uqK=AE5U=Rf?V_Rx3yP8pc_@Vnzap?h{#
zYOT2(6V>ElYpz3!^@Cgr%i768_fE$P*T+A)x73>%4^gYet2aK0Co?5mg@t^#@FKng
zxZeqY_B%Y@X#0$M+h2pkJ_f}iTC#}oYPDR>$Gz=(OO37}7YG8yN6PC;;Bh>iiAT0S
z2=wy{L4)8@p7(}^SAAlSOG*;ev%Z4SsiA<o{u_!a!m^i=`s<rx4~I84EGSE=Y3n7x
z%f%X{st;Rn-IV2=F5Y_{FI_V>EmdPTOUYNzruSpQb!Jwc8`WgwlAh~WRULON(>{-V
z*kX@2&p0nBjxA`nz(nGJ>>-Ej&8jt|o+dz-{rl}(m13<)gV?F^UDFwz@-g%1$89F{
z_D6)QO(XrAj+?ocj#8eOH)5U-l`yKrMYqUKII%&Vte3DkI58RKRrlwzl8u;`=i?Uw
zpNm-JJ0C%8fm7g$Yg8<54qlg*GA=W6@#llgIk`KSZknyg3;wRaY4LN<&F%X>lGPy`
zxWkWjw3oVnLc=T`y;^jW;=)9Q&yWV~x$`w08NM8qdnP?=iijF>)~kQ!$5fRqWtW*-
zz7y>GJwU*g7I5*Dd3j~{bn>#1;rXC<Vc2n^>!X1?c7vT2vg^S>soeeoJ2ly@iG-hh
zKHq=2d_xiRnSrsiN{xd{tl<GZw-y=ElG1|9PBr2}R(pvAHaieISz}75%~K@NA%gAQ
zBs*!lnR1c4dVuUwD>h4-s#iB!`3E*cFj6_y&?JjF6%jdjw<x7unAcNP&U_~t>x>vy
zuksOP3c)f;8Cgh19vgusV4OdiKG#4OUr*_;0I5Xmdu=mc-7AxhnHn*^kBSfPKJA68
z7a=DFu+>Y5$Kf*}TPw@z<S5AgvJO_Zur)ss;@|ePV0!!`a;+wk6k*N1jnecjiq+<C
z$cT&QP5a?)9(XneaWa<>7H7xFeW{o09n&}!?4D`ULTiQpiSP=9pkY)w`!!aEc_Yf(
z@au0KW_(B$T*Plw>YxwZIsL)x+U35Gs1a=|GRE&u<M-YMgTr+8c{uan3<?PWOD8%<
z<rCB~%bZWQpR6c)(upMWp2j+)7LOIJyf$ts{>lwDAniO{Tu515Em9R~_<N8`a&jYA
z=nq}BoJ0j{N0MnB@~075S%)2D@hvn}_V?$sS!H!F6k;9`SegMjoNmB1&i8`Xo6^>Y
zT~2Dt0@61ZPB7;&i<X7{D+z_&z(c(DN8{~pO|d^4R+GZy<?<x;NYJgn7j~6I?UhbQ
zjz;QwIeckuF*AWaM{*+VEVS3sNJSqNIGw};_}u4BH8t^u4hz%?_hH2!qO4Oh8zQFz
zg)fQS3K|7DEV4-$3)=oBlhWyoq#T%95tgj#w{GZbuilGfq}<Q*zC4cO2<Rf$rlrN-
zAAyV^q)9;W23sdDbvC|;RyWcDHDz1~1`SLH{7x$$hmf)~3BU9MzD0-E6Pkr{79kjd
z;m|SwP%_>f%R?()Aj_<dF_QwU@R(EpZTt19x3|1<P!Q}hPSS0ivOU1xPWA$nmTtzL
z_g&`MdW;u*X6l=$`&I<uIP(Y*!~U>_b^Z2vyh&@{jXNj+zEHOLoH<N$bM5S4%&$-!
zIVSmdu8`N(f3-%YDyW(@wYstARumeWj+54Q--$SCJ{2!*yAu2)U8v=8V((1uPF`f_
z8h_sAG9_@wyoq!IIoy$yg{To~2bSSml8`i=cU(D3U2^dcDU{|-9CL%b;&)6F?xz8V
zDGl=t4}@|R+<fkREyzGU<Hvd7E=|K+Z#!a-b;M6CSnNxm0$lDsjvgS^ix{)9OPkFx
zFAO5ao!#Cy4Ji_0fTGsjZ8}|o8GWvwPPY#34td*^lz&YeIBBJ(n_Sd=GNS4jLTSa#
zBKgscUK|n{hvKfL=DJL0Kq!_NiyAvfc@~h#q=y^`2Od_eK?Bh-!*nVUOOsmt0_uJU
z=uftxv9+W~H86Heo?J9J?7Es*htI(19xNeE)DO<*&)F{_qWdc@ikY|bz$y20$4rK<
z{PS$oPTlY~W1f$Yc^i(Fiy4vD`^=69lnOwk!}>LS)5Y8~9hx{Oqt-qcUMH_6<3_)^
zy$eASHGu31oE@JH!M-6%`!0?`AYh*B4u54%TC^aQ;xI2NQ_k<Nz!?YM)TlI3K~+oJ
zX7~N;>03n&Syx?4z<gbH<1!r=(Y9FJaY4F#^xS@J%a-X5VK9zCQ(&8GSpM3Yj-=K{
zwGoc$kuTNW1jl#0X_O*IlPJ{qSft`x;iZzvV=ICYXL=lEse>)UhRvfwKKm_IBluwn
zMH@RP3SHtcLZ2@jUYN)jsXnP6Qg5NU-H)(boqL?$!$T`Fe{cxNDT%I{djbG&;owz`
z0zVtYIh$ob*a(?n;hE-dWf15Tl)EY2=D-f?6i?2>np1&>%}~GPythNkiQ-MZ+5Bun
zSYCHb2)~h2vR*jMe6B@A?sBqUcuuD$)|4_4cd$s^FSS4O8B$0WO4)F4Z@-L<K~L0P
z;z(ZZQwY-qBX2t&>{p+Kp-GJHJggk$0Q_%Gts~Yu(EtegP*;^lTFh5dBLa^Yp-wX0
zAGJ-RkB^z^979J(q|>F{U4K?0csLX+tjKUvmaYKTvYDgz+=l_IH^OHIT{D;!4eokO
zNkl*4z#>Lp(O0I)s;@CNRFj4YaT|swXZi2+ANH9fEp9~1fri^lb#i*APTJNs4g>j~
z0}gK5$X67`SN)`^#TKfWs%QGBei7^_Q+4b|JF!2A5^ReCOG>uVy}r|rzTYBMuY=3`
z;w~23ldRRWcjEgCpE)|}@`|D`&MyU~m0*<AiyYBQv0`pa-TAdjgL?ILjs}HJfkG}e
z2#{jwloiis!(G2mzNo}sgO-VI51*pCLVwQ56!n(g`(&5z`rL4RN#u?`l2&SwMl7F^
z3iMn8ztTmatc4Y4!AE>s?Q=obrZ$(R*Br(fe0zWRmD4=T4&Fa^EKW5{+@|xdGun3Z
z@JOURJcAj#>3r_{>r{NQx-bxNdxY9p&Ax1N_gj0Hh`mLVU}MMoba}>@d#lWms4s(N
z2BuzMKf}8n9@n{ZfxDqzRLeOa_0U^j>y-i-rXHQ4PaInnZ^_V6g$7D;O579veNW9W
zqU5ljz_|8sD*mIN;ku?K0pEf8?cF`$Oo^t}(cdtR0cVIWCA@T%nNc*g?ZcY@vv!cv
z4W|t~oz{E^amA;{odje{nWU}{@#CiEB@7ZMW%`$oMh)GXnzm;(@83UO4RanovC<91
zUc^X02;jKx9^fI%Cxf5fq>Vv>aip}$6Z`Ip=E^S)Gy=%A=ex1WfN{aW!z#7z?8~CE
z)}>vtEhGCtucUxETUG5SyURH2!LJjm&yg>xwy2-Wb)@T>nK7v2u|!}p0=b^gRAIxF
z2#%#-88O*#ey4b&bGoROztu@GKdr1bG6a-X(fK^@X`U2AO0bS0j?aWEa!S>Ih;vI)
z`U%ilpS$L?g&gAJ&*F@&STQTNeK#FEQq65XwL>$R<@^#gfIHt-?9SlH>DnB>kC<iW
z)LDLqgo%q6T}=fRi$%F^Bi^#+&gJrUgxqF5yg`~lv&eK!Vn&t;`dTvgyR9-h{L=yC
zgCj1xgsQ!#Jns*@Mug40tq3k?a|{`aSbJzljRRL&sN$MEV}x>dWLG7E)YSE*F{@Sb
z#Z|Njx|yN4K~r!sf<T@RLKk5vp1_n2<-k3qvnj!Sr%HZ8UR&#Mo#os-G5Xt~<SIRW
zCx1(uXwUM_lXDznh|GfKm991Sg<G^PR^Mf4;)g2GZ)3vCB6PS_)Hem4l*M@6QDBks
zMVoSv><|oqd6C~m8Ou1@&pO#g?dYMP6On?GQa*k~+AMcybxltHOVfTfW#PbiUr=DJ
zX+R}fzj<&ajA(jL0d_;Wrqw>!**P8}=0z?|wm33bhbGw2+CL!{){Kn+3XctkmPr7~
z&Th?wdjs<FhUKH7^>gqnjU{>%GSr9@Z<s_WK)-0^ElIAo5;)P^E*97BF*yLa`T5z#
zdh%3ORfBAp`<U)p)E2yz+^S#Q=8Mu%F0_L`z;8HcE_n4rLMhX}ch1r;G`dEkl%z6j
z5t;^PY^tc>@(anAjKHQ0=|A|p7l&4&$OK6k#bYzk(hXr7V0P&3z&0?B?z!(?r>S+{
zZv`?F*P=Z#5Z({cS5Uqs38+cgZ?@!HF=)Ozg<dmA33affq`z1?Dgh|=i`@r?x}6R;
z?s}4L{FDU(Se9NDw}i`C4AwEMe`XAkQO%fOY+ZOK6{4T4KhKO`+{|}@B`nJs8f)JZ
z#zuvX2hqWfR03nINZusPrLx>J!^9=p2Lm;~suTrY6Zz|3@<y?+W_0wx*b3V{fU*c$
zkbV~=LC%htn)fZ{Mn5}N%!YMF>Dl+UzpR|ky<o0iN6c5DWNdRan;CXB3MWA^ZBK=l
zNaRvQu}lzn;SAks%esS{BMu&slf*s)=psGhVQf+-e4%1hSGwfl2*R5_cV_)_vXK-r
zg*#!p_&>{Sb8J?A9Ksq4IJm<J9X)>F-R-*#BK@siSuC_a22d}q4G6y89PJ|cAlUDJ
z96qJ=x^}aIL_t$=+)b{w(4X%)wDF9bg4u}t)NgH~PuPr7>5ejq&59QwR_c@_;`uX)
zH)Ne^nB54}Wii;oVn0R5-;^=URjK4BI%UWsf0Jd~-LWV@Npp;y%yHdzD(|>;Dleuw
zj1eCEyX?Yt=)tf`Plk!?0ngt}xaz=|f~GDlHLtU>mUW1+^IgtSm$aRmedMtpnLl6*
zm__e?tS!4O`1{05o|}hv`INl}o|54Me4%c7t$=kFIrqGILsJchEaf2-Ub0wKd{{n#
zJT14WZN$AHgaw57ha|CFk8UnPn}B$;nI?Lxdb&0VJfnl3Lb8=ep`L8KcbT^hH)Z&U
z-ffh{AFs1R<?)BPOm9bZt)|*D;b@6(GQKOFsJpGX-?dnR76lae)?#5^kB%F^s6&!4
z<m!v>jJ15ZZ}Esx5mnDEdagRPzJ3>exbeW77FV(lQZn=*haXE%vBCEGAruN#+OWE9
zMEE@Il<<}~1~j^`fn4Oin=&3Q%y;CIS7S(@pU!Y575}XFfC|cB^XNQbc6y*sM9_r5
z(&g^#<&iV})3p?l8{Xv#&nPkB5O%~$!p|SW-sMjaTJK4SdtV83M8vgiG7CK;w3#9a
z2n}(OLcta&Me4a)_S)K~=TDpO(H{kej_C;Zio`Qy<GMGc?HZDA4@P$RP95i`4(%U{
zUWC(0EN{1ok4@q2_bAeb=H{DS-_p`vCRr@y)u0>r5IH^ZFB^3Rt8*q9m5^}o>2^CH
zz+0v<>^6Bjp}izzQ}8>+T3Kc2{93r}^#N&-Z!Vl`k2>0@e!O>d8k8|jtwvoP%PXU(
zqlo-ErBVtI9`5;~;B1m<FhFT(#c`4FLcO!2@KcFmF8Q4N4zr$zo3MU%KriI0Cw||}
zSGOeQdS0DakmyJBMV&+^UN*zsLHCd}_bgc;ECn;I-nCo_SGxZ0-a?`w;7P5}k2<F9
za^x+ckULU$-IsSdANnT-@ycY=I(y{*ifOFc6U=pyJ#SlYWi7j^LgKL-2-n<Mqf8Tc
z!v_d1@KE0Y#`;nt8F0|0nXHmgUCZ+c8Sc~59shW7*OMd)rHouBek&MEigGGke#7F4
zy@p`YI$hwh4L~9lwfGial*_7F`t{~7{y>m}ah-~eWkllcjp|=PTun*`H-61A_EvAQ
z!=_NrtZ=A`*hH8ZYPoUMa<`7SsbJ4%HRcZ%J@B6NG0~su9c4D;a!2WUJ;VM&Nsjq@
zbf!9$p$O>#u^fng{+?kJQ-YU^CBx_~OW91mY&70s>x&B0QI`l&7Q=%Ilj88T^yi5Y
zUoZzYB=en>lk5Ybzfoe%IUpcxLIeU^t9aw!f-k?vHSrQ9%;juq2M;zld~OqbNPu$B
z)Adgi1lit~PQE{<!1Mbb$Ic}`cbNhbgfG0edJu+s^mG^KboSW{SSD7NdOl$0<x%qv
z=1iE|-;RTYpU-11d0t>I5e$)RiyMt(S%>R?5%Z%kEreq%T+EjngXM<X+iLL8-2R@V
zcjCk|D`=BDBRj#(P9BG30FxW}1coMasA(K7<*BQB0Tsg6cxp(P36XOP$lvq~^tPv)
zYOIh4l1$U<=^4m6VmN>P@bGE|XVU;w?F8LHT|F{sO<^j9-`wa9XdhiWm)$}jZYej3
zs7t5KODYVPsnDO+4QVSvqgpe0>emZADzq4ocwVY-u}K;j=EGJAm-86;505?GBDoJo
zZ25YuQvy!@rNRLT6%=%Z`})E$tClML1dO!7M&Q85-vV)NDe576l}g{WK5sO|57Pja
zgg{l_A<bFRd;&~i8lIN!7An!7e~CQ#HjKX`q^1-f9NtI@=N11wKF~OcWl@Bq*B-oh
z!q)m?0BxcoO6CRGCCMd!BlCC=2+K?5lv}7V!{R9iswuylWEKb6wfYvmTbS>fV$4Zg
zYHbo7wKr#W`nko#%bO3wJwOlqybEZrcaDoH;0o^*)b5aEC##%eQdz3${H6J$woTE=
zIr*85%H@(H?QJn$`cO)Lbz-S<Ux`K>9V`yBi%^hOd*#Hpt_OyVAqObcAUd=O*sM-7
zp#g<g2J0vn7Q$(0%rc^gQx7N)ZstvzN%19e_*LL-IdJmKnqPT1k`71}^-^&0Y9sl0
zi<Dmx)y@t?MZOOfzn=r*Hh!mx3bWON9XnZQ9-5Cy;=|$LBFRkQ>4ikh@es~OCaL>Z
zU?Z1eYgxvrt|5}0WD7rgSib2=Pv0vG9%i#zvKs%hH^J|Mv#?~G$8O9JGJKp4-pbiD
zcI9<8i{J(Xn_J&q6^RUyx&WjYdxI_sWN;(6i6aVhSRsPFBL?XM6Dp5leoUyQbR~O=
zT@pfLI~wS-6s5F7SEHMvJ$^yUkuzotJA-)EgOd?T<9k<pY%L*;!lT!hMQI}589Vog
zS-w4i>M_fp<Ix9m!$ygcDe5DaxblE_I16Sn|MPPky>wg?HnriJI<BvZ45jRj7+X=f
zN4MzRf#suw*$irv@f5>9@9eG@`DL}l(7M?I8S<Mw{NnOl)R>Y(=aL)$K57osu6Lfe
z$p#Vg80r~0TE*wcXrsPw747ez@E{bji+sNO<hYqiBg-~{9V9^*;Ur|mxwh7Y$HU_>
zJmb*Vohna)4MqCq_xY@hCFpeyR{4%wz_@TkHY^hsz6;K>-bns7Jj%RQR+^BEnrI5M
zFphVw0eKk*W<T#|gT1^0W|BT|WU8>H-0j_XCq6x3R?p1u%=v7Ju%lBa8g_y>Egdcs
z^C&?;BlbZC#(_m>h)#PTr8r5{;k^JKe3Nh4j7k0M+`ul{9^3Cgb|Gf^(ag2+zjWY^
zk)+p(gmQmXDjgx(A11jiqX@ti(Y@P}5sHcG5>3Gm0P@$C32{^QFq~Aj9KCYNX5tdA
z76&qmov(<v2wRuoN!Mg~Hl1uJD*8k4<$Vm82B!8=l8y2EHYpbcY8kShJ_e+!h<t8_
zGdt&~(xq9oO~~*G(#z?W5LWuirC0;H*+6L(%@%Wm>vOQr#GQ|fME8rpB_kkc2#W%P
z`U3r=MME?3P#G)x<*DN~#!mKE@q865`oCpmc+9n^JR>hEG+p}K*-ZM&eMjr}J~yoL
zJa-EwNtfugNZiDwWv4grdN+0>Qxiy^b<3|Ro3F~5uFK4_+LJp_jh?PUcfmI*K{+w5
zJo+%K86lAwd#)0rfdsc7n}S))^%Y$OPc;<~;+ghC8Adz=8z}mTtmXBDQ0x#NG{9GG
z(9u(<NCebC*<{_WV!v=eOEriosFZVW3LE%v<`tvd*P{aKDF?;ZD#fF~N=&RgWVB_)
zm?rQA`wD_6f$yN^X{DzU6hzI_aM{-+BzOgdd*Z*C15whq1s|MAsT8Sg(2@2o6|C?l
z-PhB5(sEi~uq_~;Z;m7%zr`uq_Lp}%L>{k5x|jrU)){MyEgr{3PcxzpB(i5z;dq!9
zX)hkJ^JsUGN|{4qediap{_LBLWRt?J;Q9WlLvP7xcH9QIc%Fu^kHk7;-+uT8lB)LL
zIlPPfJ%~?j=#h5iArfxLFmB0po4I;N8kpF4GOE>S|3Q`?y&HSZ<xDV}H_}|EKY#6W
z(GUf|Ze^rqf_TFM<N=YPWT=sL+lmc@`5(q#dPz-1icO2_I3x0x2UJp^hL@xN^gcss
zy4>$;a@}Um@{iZeXP~v=53~zSF>UO{bz7zXy&(e{P}8%)j5QDD7pMPTmoa7uimWD5
zMdL^q=VW(FpS--}T!hEvsFtYAJUY5C;m^sE>Y2@zeW#<+GgLAJVBE4xU@fX9+-3k&
zgjV6Sth@wV0S$lnJSF^8B?Cw<TI6X8n!Cg)eqKXz{oq%r{Pvp`di=}?=2K5)E#KB#
z+ucEF-N3s|n%tL~xaV{@Hoes@$B-_@xu#O_N=o=*Lb$xQTlW}?nW<pWi6fhYeS`u4
zjGiu5wGuuT!5NVu2~{g+|LQx9g%n)~dcKLX5y8p^)gVryoSOt;0+YtMI4CnUXWSei
zpYa3WL~O$P=7%v3F;p?DJv~l`fhcCS={;vcY?D|}iHhu;d4>Z)suSGf0papC8K^>f
zjIeZ`&jR$TSOJljKj(-3!JVLCW0hp=-?U#1X9>Q%;m98Pp<?Blf^;AGJb#eT%QL1t
zEK;I%_36ZDavFDse%2zkkEw~?AzQC3(d+KdT=r$gU@T>wSY6p!bH$)H6npnB_nJi6
zxj$;AaeOSaE7X-&V%qt;0UEhn|JFRif=2p)j&FEwW+LYUEIJQ&r^5}M?YX{TqQy-g
z@a?xog}m-I(Nnqj79A`!g@Es-w=WEKXiO)T6hTPcKN+c2C;&Db<e7|H=|8N&FF>fO
zPyH73%aW*AQ#-R_^1+>))D@i>4+Gs%US&r)&2$vwr|t;tHWdwLEm-+id_}T-)Q^R4
zu_nptjDbk^N0wKPvZFVt@tDo4T`IVIp@fqXAh}}Ua3HM?GOC4yB*QEsPV~q)GU7)Q
z9(+x4eK!WY9J{kXnh4GU4n0yj^RKBij`;;j;dvM)XrhcUp{PeLf@D9VFW|nb%~r=+
z;3k3X*j%lA&OZsHYk1=n|0c#z1$*Gw&qB=g6E|Z^X8O^{5yf9$s+|cEM{#R^pCArI
zM<kU6g+uk_jjN)szO0D;67ixxV|i<L_H+t)3afA<Xg_@*V!21hT$OA*<z2oeK}azW
zPyBY<VwR@xDR`G)KvjX+d1aok<q{$v+?ksXr^!CdspCG~z@0XQsD!9@-~xWZ5zIlE
zOW8Lg3i`}3ExbKoVJi2<ABMk|Sh?DZcY$z?(rOg_siG}Zz#RI6Gn}s56y?hpL=}<K
zN{oUF>qEp5Ka|J5z<=&=T#3Uy6aU&XtD5`B>kLOjqhZgQc~jtf4+AR4y1;2$2$DPe
zJyn1z5lJwzfS=2n;&Ve8Vnx1!s%2P6@(&8e#6zpuk2HKJEK$eTai88k{Cdxv&TXdD
zhH5|T_brN--8=_}_9ZG%IqLVCOqf1zaOo`06WPb8fk;~PhtPZUmQ#<!nL3Qgq1~!&
z_V35SkUC<tm{tPCY`T5!GtQsrma1s`*_l_Dg>RM`n`H5VHDS+pWBcnR^fO&a>FPq=
zc9scWt<%#+V^bo?SW03IA2~!kuQ0Ek`s|P>XH-9QV6Pz)V%|I6dnMW-7s6t7Nz}7l
zlL{J#L}{Bg-4p)yAn0<hyRL0$g=o1H2fCe*7jN<<Ur_iO`S~9@D7i&8YJD9rJ^Gk9
zp9I76L@N3H{w>q2U3*Iqdu59<%`hhnBQ^EA6ewU1{f9d3>BG_B2jx4CDW@U*580hx
zjN!hCt@8?3t(v830T{7ATVY%#`F0!m7x5qs@1j~22cDbvBgvWoM8;4GWIldiNJ7?6
zF>31R{usg#Sv}j1;v_j^9~wo8!`g+KKcNLy3F~3-6Hxsejy&=Hhaj7mlwf0r)>jY5
zNRL>+3fJhQR(i3jFSRVMC=sooYP$bKoGd5DT@7_-dSRf@(<54vWy;ud&_s8Lk4izc
zmaeYE^9GPgDZ8-A%#S9h7aX%v*>{^|?|;D1?U%EA%UfQ+Ov}+f#U0EG*f9Pc2YolO
zVmf%cWqK2fKXe7m+8C4@`(b8=(}dd|SIWIOoD`AR(9o}RY?`OBQ9A?psRVu8Aet<Y
z9Gwr`gs7<tWk-YJ;Of;zO4fa?6RJo<hTlp4)%>Miomg8VX=C;MIqt!&Zc3bUj!#&J
zy44$lo@A1ooSyc_Pd$ImylFktacgCMD7mWJ-gITVJJBCYhnK6jinWWiUU#roK@&wR
zhM1ZCok6|n<R*%--!mq3i-&8s%7p8^jbnxV{Vl@9Z<)}$TI2q*evVxa#L;e1*dHe~
zMw4!ujUf6v>lzciP}3~MltN8HUNjfRfUHm>IH2(7#}2~L-y!+_$g;|p-jU7+*3&Wb
z4f5xMDO<9)@s*c;Nl`N|XBTonj+Rq47ePm$uFJCD307Lu17$pg^j%L)tr9ck$%2x%
zO-6dQyZ<mTl$(07CgoU;z?@JnN2?%%PLE~V{Q3dF=Nem3W&%BdL-WR=PwC#j8TkH(
znVwO{l{rWO(V_=AA@O~P%P7k@Ii{P1L)tGO<HHvyEWQ^96~1c{aCL?|(nwO7^o@H8
z6NKwOFy57yT%v4Yecu0DU{9ZYo>LUzZQ)FaB~R+21Gb@gZm(tj_8Z-g2_`7u<jJYv
z){8KI4*Cj1Fw`c#P2>)~UoY&9oWKafmf$ay!COtk^^-+(*n3W;GU`X)3`MsdhlP5$
zJT6#jrs($%$cMhQ42;;aMwmx^6_FHkwio?=)TK7Y%(k{{>qxHWvCrF=TY=)j{z=eu
z^1G#uts`<_MX)<LwOHlV%L8f7!8H#@?6YGV-<ztqto|C?7xqB^zr9S%W!5;(fAsVX
z&05<OEv(bR&e@YY9;rrLgk|i;NL}d-q{;aP52$U$F<Jm&7(-yJ#QY4Vwc(Mo>+LVz
zBF+7O2ng=7VP+Qh!c|bah!4Ls#-l!!)^0@>>X1<WOkU7xkEAC3=n)h9Env=)s;n1o
zmRPUgCvr>~4VWn+jUiD5&fP-3Tz!4-k+jiXe%_Kgg_Zpi7i_jp^8Sx*zF&l_*QnEd
zhU^1g(iRy8(~tt4dS~1Md})2dJ`ATuG`b$UlpbZJsG}=bq1cV}CPEN+@6XiU-JR~0
z6@&hsqwjJ3flU?1xxNY<g7O7{;{E-fZbxgE$u2$1s`40`&xJT?Bwx$*jpq6p(k%u{
zMp#aYm6YT865|^S19U$^4;;oO`5I(jf-Ya{1JFE4_h-e--`OO-%u`yB^8jDbd3ps7
zf6*>?hX5eY?5$iI=FRs+wLuPc5xLEvsp%MUqb+Lk4ZRGgg=M-IQp_ZFc<!f8#%+`=
z;i1QSd}nVUP_Mm5%q=hra?ZwJvi~RYbE6EoY93B|jJeImLpVafF5j)6v_BQEUF@M-
z3=VvfdR}6_G3R>*XmQR418zFIoj$BO@vBpuUV(r8j|6o4P5$2(UpzH8Ovb+xuZv-y
z4eJbcZPB=}=z|Tq&O4qP7M>U97)e}(j(#Zg{7fk#!C=g65yi(^;7tC)qtv8h%o(u<
zBJf$s*}vuVO0h3vBom7Mr2$g#pNK_8vQUkzXPEo_Eov674};AwqS2cOk%g+STUU3d
z>Y01BRKv}Be)mM|gJDSi#2X)DU<<idD$_2I<G%lC3w0Cyd6OP{>iT8suNPWxPJQx0
z;K<0A!5NO3IO2<wJauRCt>{^P58+D>=HVl%D$1g6?%wLY%2j$nhb&MgdxIIl+*lSZ
zS=ofok?3R<d-Ne-{nRU*oFr{yxd}CgEpQ+<ulUE&y_Fd|CL^MP0RuD$@Kk0JUqHec
zX_6MHO|3n;{qr%x@HY`jw*@z&`k~`ytZYL7Uc6$mN=Y*15Ca*%)Gm`x|GtuEh8Rxm
z=6VqkEz=KW8X$%?4;b7EGmWKI<Uwx1*W?v^?0Dp8!tx=P^SMR(slM4q^l<{6kj>F|
zSdtGnay?i677cdxcKsr3lrFuZRHc#)p&VxSBJwDG^fXHT!(kh)UaQAR|7a4!N?C$h
z8QF6^A^MAoB<K<A8GmDo(TXeNFI>G>wnx&&Or?SgA$ykbt<NDjM~7wBjL(hb6~1l!
zUw%B;E@Ki*ULNOq756P_!N$hk@U7kE4%FN8hU~FeWuwArq2|=)V3aZgVKONl0DX5-
zsYDN;;3f&oLlhFgDl#;is|;aq*AsL~Zq$JAnydV!k<%^7ABbI!>w~pJZnLBfZskz}
zC=vVe@-KKX5x6O%xVWq-!x&L|pMr4b$}?$Oaeg2Q8O=dtb#(?}xiJ;M``ezVla%dH
z3=Lbhr_LuWp3WrHpx-j0YqG5jlnMUDV41Z<6f9B+Yg>mt!$*|x)8{vbMFysoP2uTG
zXKPhRY)_a~ibO-Z>}j-c5|m09p!l&Wt4~sSe1nse^t6(A-3-PiPDw|X*~ZONy^X9n
zn_utY1M!T{v5WE2HYuTe=)^9jh?zjjjLZ+DmR!+jQ|?$cH9^h02L2saYPG_by7Fz8
z;Cm(0=@`-iJwlViq!Ov<Xm5e1$FX;v{ae%IQ5hmP;;#X_=P;+#8hjf?K-lC+YHN(?
zb<27|erJ&E^OSOa-~^M3QSrPuM6i(JZ2N5KjP)@o@?~<h=wUdb_IXq!Po1fnfo9cy
z4V!5qRz`E7;}n^sjrA?DCNZ}HEYOe&NRyMNteRV9)E$9s0ZT<?Xcm^VOnq8RaVuNR
zqsMFFq=h0Zb{XMSF?MSD`^T!Q%9UwR8j|<PL?kCqe;&O?MnIOHlH(}9!)!X?UZvJ|
zhrH(;ZIj=uD*_>k*UB<zNHIpnjPEffqO-~3Y+WR(MeSJy4D<(@gns?X8Pu6ap`Xjy
z`&vs;%v{^}A<mNxsZfqJHJ<EVM34-ZjF*+9Al2Ka`bH~nKskkA!UBm#(yC_8Q!QC{
z=H7qq5BWM@bhol8!KAOV&o}s9&2>Be80BHL9`~naa#+X3cJH=fM_60EeA5I?`m#da
zYM&eRlewigzS}XP+%bNgG<nY*j0c%Dd;8#%;b!zc(d|<O4qD6xJXZDE$DINtMePHA
zQ6$>?Ho8w0*<uWmzYzQ?3D<KAhTOS(-Y3Jch9=^Ko8#*BVHdF(=|`sqrUb+DN6VF>
zOR(D$tD!;hf^t7xgGjS0SLt-xq`nuJYpyq~D9%<YGfRrs*4^@DmqoGi_#R++C06aT
zA5n<$VLo@?#F|v%N(LH*GlK?jqtu2subO`XMfw7R53=0o5=|_}ztTp7)G?*SCJ*B=
zT<~EPG7MiLhNpj}{*37T0q~3HOktIkNvuk>c^^PqiAXDog2X1VY%NhP|NQIS_Ben9
zvT*{jDl1hHZqBaO1Ygcrrn(bZK9f*=z8V}l;&bfOjPb#U166-R+3xJ0$Lj`%9Ghhq
z{*A-R^LhD%&clQJJcu>%Fqsl38Xb3zVp<)T1QZnQP&WO$!xgBIih)W<$tV|^5IO%1
zMqkKg;jb9H#UUr|t9hO_%ZliSO_m_FX@SIquCt$cU<^rfloeEExKy17Q{==BeL9Dc
zwV(2DS)&L<+T}+`=2Y_f#-pw?%uc?&6H9A?hB3^hx-1P?cE^ro@(%R(UX1R9`({?3
zWPT*G?);7(C@Gs_133Tf(v}$#C0^;7AohD#c#Qs}wuuV&;E#321W{r8X=bQR#BqTM
z98K<=<PHFvn3lzcFejI=ga(B;NQ@}Jv}j2`oltj}I{ZuE?s_2n;{!RhVd=QAy?^Bb
zT{ASHmLu$=D{|kFJg}XX5yw9K7;A<2jez7}xmqT1(ZosI9{QMnk=m^A1IXYdZ|vf$
zaN&V#EO6qbD+O7QypI=QnUw@fsH-sVXQnI8{?0yHir<Cy6uT-(VHD*gib_KiQM$x1
zpf~$ZZ_iB4?e5sxv=q(=cYTATCZUGVKzSSyU_EvLy(@GWD^)!nNk3%QofH>GnPCej
z`t?<(phcDHIx-Ry2I||{HKT#aMD-%|3)bC53{#1$dzbc<vq_9u@23XBL|tS?7w75H
z{6B|Oq@p>>J%j<O0;eqt-#TB*hy5;YC#!8erKH_oFuUT6N%S+?9-3}mo<tISZjfZ|
z|0HI+2Or1yM1Jc~YFDSMflITP?xEq<L?~17t->!u$l9f>K|gFx)qrnm52vQ>@;|P}
zX_vEbMm*iXXq`ai)})F+*B~i%gMUN$L#Q(m?WfDq!|a>0#O}|Q^h3CK_+w}?4??Uj
zwjwd<q6K<u!?w@duk)~&pXUxpYRIHoH2tc4)73j`kZDW}DzpPNDW~;P?DMLo$r0oa
zUTGolal~tLO*5^)XxS-VYW3f{uA~atm!7BY1JM^L^Fvw}x|$r{`sL^rV=IhoX1J#P
zJ>s0vcR8=8*(ja4n$u*IploVYqF0EMnI_r6iH<XdQ3(>%_L9ry$LWz{g48AKOZ*Ok
z@GkgJgEpegVpOecZEGy&nDONrrt*{-zOu+LGT>jNYJ|+Y$Yl7Yiydw4Sqzz*@;(E7
z-Z|X8u1g&?>?X>lTC`akRm{<-*kBCeAgW&$f4NmsdmKH5u^MzEhYS--tZf=6%h2OF
zpHe>*WK;7!5${iPQV~)LJP^CD3I>tiv!j}^s-<Rje{tj7Z{XR$?xYY$2;W*??r%A9
zw|wIm{^1}1oM$EkK*=iVZ(`+^tCCeo!nFSm#&LzcRw$hB^QrsJJxJ-uUjS|A{N6c%
zjtHP{ds38Y<pIzSe_U2T7G43K6>@(PGCq)!x$nE-`wLp+L@w*}wI8z|{aFbyV}AMs
zthpP!Och1CffxBbAM;4qO)nhAuUhm_$0YA{`2p4AU}<{Ov0N{gk|XkhfgxxDF|Z3c
z%9$o-06Bl?u^%D5`z`fk4!%rcJO#Rj))q<nL3(<6>#or0I{8zcPtWU;v)hI2C++(u
z%3dQJ2xo9+qFaJ2KX_2t(Vkk8wNCyhJ?A>TLy=frhP5MF-w?9LH+(E2Lu=TL8d^X#
zLU3*%GBENNF+eJ0;+&`&97BUX;16ip;WqHX+wEZjxSml?W<RzBX0rBDAQ}2({55>g
zu0CfE2I@&hL@u2yH)mH+O%fs!>z=J!fBCsxX<62Q*jcBOWvaU3<^4iwQ(m^YBM1!=
zMC`BaMHerv+X}&XFUC=4nLOb6w#hr}ZouuA$R*bN?eHlMhFG(k0y6>^y)?_vILG#Z
zLCivt!FFd|$)5P-)!dx+=!b>(2!wG)Lnf~;KqNi(ou=97cpd!0zNL*jxaR)Z*^nEn
z9=ExiDE*xJSEdV-ORd*|bd*U{mlr+qErQ?HA7{qmHzt%-jB_=SWv>01GyK$p@lC=~
z7sunpb+8*RGPf-p;g`EHhszy>lh#W`1GnuDrCb7<Y40LC$3Rko0T9((8mUINNrT~8
zdXe98t1nddEyAHCTu(ES2DdFf5sz^J04JelZS-Ea{mpEMiA{3Er%S<`Elnb;25i-F
z6sV`Mv%gCg$O4i|l3loj+BCUedDBT~P@%wnglk<Se@ENOOCzhc>CS3Xqo6UGu%z3|
z=(k79c7b2x-*H>4^itxGQvQgpx`79;x7tS-fDK2>{415ZPMJ}|b$gm|cpL5U^cp9+
zmS_Cs7D&DF1n$}OArEGBBZ<9)H{ix_e+v9n9^fC<I^<Z~wc-t%UMSJhoP3W@;71H&
z-u0M%DLSPWXb`*TR{Eqpiu1uzuh}kXwb4Ba%bD2I<(j>E99w>jz5jKIm37reyrK|&
z`Coh*Ki3(;M5!Yw5|aHFwP{;x>w<Q71^{7-s*{}X2&kZnKLvkIAyMlhPem_1z{f5i
z8$bV`$jk0ahI5NT%W|O}V_tql1pr-{IkA`@lO&Grh-;!OHUlla<I-|k_=36z#&Nqt
zKoobjbb(Q=8YNCgtH4nY$lh65wu+o_JN`veoXEI~TALTjg!Gr4tdEyTE)kej@L1n+
z_Mnh;Pa@K%&zBt+XE8Y7Yx3g<^mTS74q`vvyy=!8nA@jt$A1n?nMsGU+kPyN=GXmW
z;AQ2%{OLV%LI0IvGArDpp6@6}pfaHCfnnq?x7QryffJ+4Vtz?VoS2##+xkNW$=^z`
zIACI9?Xv%v@Q7>P$S<a|gh&elqj%bzpIzMo<0Cg>Js-6vuj#gBG1nPhCnnd^Zmf$=
zYAg=#Yvvi3r4Su2|K~bM4bTEE8Sv)&ZPvz$YSMW|M?xeOO#pK@2p0hUi66eigg575
zjcA`;{UzTbm@D}CN8gRl%Z<b7)6Mw?8Zg#`C`t;xjLT)!i$@gO?slBgfbaaHlF&6e
zC^_E71_#idvi7?#)zWrKrv<clxJfed)hXb%!RG@wBHw<PROGMbe0vqljmm$)4L^J{
zG3$Zu*K$wsG~p$bkS7F>xR$CY2OBfhXPfi)MBbM7f%uV#Ti8y=6Jf-s78#gn@$1)9
zHOoeIHHvOVwUZsY-s{H##sSww*vr^@<d(;ZTkcG6)W0Pi^G1LsW6iSN@F__HD+S#4
zkx_%-VEL~z!r9I9ea!j%gO9)5%lW3BfZKNuITQI&dJwvXU$m-}yVuEz2eQwp_r2i@
zM=#JbNPqx;9`Ab=S>^jYyh1HsUb^x*<oMK+u@@w%0KvKeR9*h=68tpp=XCjw3jnu5
z<L#-i)PASv22%9Y^mk1|5mEMm#uEO)RA{B@CbFn3?1Cb<^qn<nwFNF6AmmQWuX=O*
zz{M`9cMqNNT{P4l(A)0yz%J!*FwK~#3gCA{?z5k7@DZtKdnW!mz8Kphju*bzhLvEm
zWPB0V07+LsoGWL4>Vyb5Jg@sM_27-nWtn|D)t4V*9$#%sKc?vsafwG|-+Z6IIr-i(
zm(UP|$W8sR5l@F`Dl3E_1l{|QJWp5rq)ZW-!!fuay`rek&#d)!a(z2uZsp-H`*Ap_
zfjr|S4@-#ud_bOGt$0+A`WQ8|=<UM}B953$rbVLT&pGKTnab}pAhy{JepI`DP3hkf
zG;R12IB@evH>pH~rOJ&kBS1=(Cyp*_+~~>9)BA+IO{~e+qGlwJ;`OOCSUle7?ZdcB
ztndr^&dCEx3NZf4qo+>AVBf{u9re&R6tZ;kW>bJyt%li#XTSctp3RMN+V;u--@!Xc
zfn{yLFSoah$=>)X3GV<*Ao*bS@H+7D5A$L<f<9!uxtv(wg|y)#T*pK4s!6FqAE7v5
zuz(r|W7uXYLpTE-D&F81y*bMA=}<!-obw8wWZw7lp1v1efVV?RJ|EN=sxog<6T>Hr
z(wKHfm9HZ3ZkW%mg5KX+%FXZdWy~qsd*(|4Xtw|%&urlG>>rp*z2Umld@gX8`xQBu
z<dFNe(@uk?o&__5oOqOvSzq<tG7PjGk`;wIDuv<<dF{4@o*Mt`8H2Vg!n<=c8*CZj
zWQqf4e<T_i8377tilbFjf0X?;kNB;c4KT|ix&R9QP50c@NY9Io+50;|cwt<d!V_yN
z5}4Y8<Z;dXYuT8Ztg}jB|C*S0>cL)z^56`xa{*Fk{cM7>=%k!xGUpXzU;k%kux_Z-
zl<`6Ms=JX%u2v^KbdjM+Hi#2|9m0-u6BDbeZEEyF$vv7a(Xkm2I`%{dZV|6g?M;B=
z*;Vf8)l#tH^vYv2#$UAuIfYlDQX*_a(^Lyu6BdI5Ug%+;+fUVs6W@xK%=IFR*YQgg
zO>Dtn3V{91U>x`a6{r_9T6``)<A@#s4)a0zBc65yBpfIN;sS!uzH~*TpbWngRwpgU
zhM`wQTBLj(&l71-6u=nhdV8zPvb&cY&bb*WlrWWQik2?Pz!5nb>(_UC+wWeNxJpL%
zl;uQ9xs2OX{0^yq#q$$`CbmlI*8*unODU<3d&;py0VC*i0NlewN46~q+^VYDQL?;Z
zq<EUsxT|_1pn4dYcVHd#t+Yv_XwcR@E$R%;#^Ejwhm!3kVqP7bWua0zuh{Md2s#57
zP!N%b!I^$|71whIk~QjYOy5wP4z)B<$KOazd|ibz@2mP-T0VLT7YAJaxwfkRXkFmk
zNxt4SbKpmHO)kBkYY`AnONPrvxHIu$zK*+Vo(KKoDqEhXxa`w_4pSB6Hx>FT6=Xjs
z>6t7cqe?HFC}P%Oo`lp7jCUQ~onuwp+~O<5gNV)iCi48l0>T47X@{Am@@q*!L&SxV
zk~H79cBlq5x9I5NsNb_qqt9xDMYzpodBkm;poonj2@VF~@^#1;7Tj!28M1I!tTLcM
zjN3WlNIi7dcUA<*y)Kd2gt*$Cdm?};C0}IH72?^tdW0PF-u8a{okg_t{N_uh@r_JU
zlUP#PD4qK`|6*aN21%QX-%?f!(d*NyYoE7`=RSf*4EgS0kw{+-xf{ux_ruii%Pp4u
zwa6n`i_eu8^V9S0{LRy9@8WJpSI+}E<SAWAt^J0fM!$E!%n<B6hG+W_*5Ke|NfIoX
zF(VnQt1Ay!8QZxmN_~kAX?(n{u-nQzUE3*Y?>`}TCD`pa<L@mNu=Bpo23LpXFr8QN
zYJ9CTk!Sc;E~iNXy~Bk$AWxx-47~}soi!pxjevPSH1(t=idwNXQQ0WQYGS^t=={e2
zx#p7=KFsI?A*Bp;_tEmr*CkXle*MSVA@S1}0~onmB=f=7bcI&7!awB77<e^zf^ir9
zxC%{d{%Ti^kJ8yjPUnbxK#Gp#9QCrvGJ-uTn}i)t#92toA8A=hfC;>G<1cO<v;v$g
zXzTOVk=5ViW?vyJkw=#oMUm#}m+KTC$^+*!5{$sp+#UQq%*E7h59}t6_wN%T4O_)t
z(v=*VGawy@Rkn_JLUj?YB|!r${vT*k1VRrFX--U_gAhAwc*7QS!}ibEjJYJ%{-vKA
zr+@ED<pT|SEJT~<yJg7tO*m~03Y?rXty&~o?4yD@`#?g?5$VPju)!HFey^c}1+GOr
zLfvocSiv-wJa(i54Nw|d+xb=00rffwgU<?XJ%%2L6Q}EuGj{q|fnMGB__bUz&f&_;
zaFp-5niGYxudWXDtgTd!oET%G*O9Mb!;rq;Gsxl}X(mT-T<&|;@y(um32gN8eU6z$
zT+b*DM=+|zvJS4$EdcR>IL+!^(^5H8;D-ZA=3uob{8hd7uoC7zO&&h}ju^*Q2`6vF
zzM;G}K=+9C<fjyh2>cyW{J)Nab*hsQ&^wAb^(+rknb&0{NOa$h18zv4zg;f$`G8f7
z8@aoSM?am%`1rw!yc0$YpD<dNryApWw@`<@ZbN>$u~rD*5j_IE;+pPJst+~Kh)WP=
zyFIJBS7JN^Z^g2ODs0Ce4t$K8xy5|!`%8g@uk~NERxKK@d#><@8ys5}HQV~o4yZqg
zWXgbe$j?&|*v88}<0LfdTEFFIhI_R5Htu<4j6I+}tL1Z*y3uigl3MW>b77C<TEcPC
z`q*}*ue6iK474%|kx&Hc=#8KD45t2?1_HgLL4rsk_o7lCH;rFcdOLg82Ua4t)sQlg
z641VjJ5*g-G`&YNq#-Fz5U@k8X$q!Ch_2cE7H<(?`R*X9U;!L&^yI6>kA5LppM8r;
z-*JIt<s=^cay7Qm=8%PxH$hy@CWfvVSEgX|I5{?@{io3D)<(l!|NcCdZ+kNAeLgoQ
zkkv@ejo$*MQxk*Dm{6lup(GzETp_=K6-XVCm&YH8c+Vo~`!qQIVL)E4v9Xuk-4ty#
zp_XSBhq^`{z!!aByMa3Hr}P4ol#1GkWwzVtA_ANfUw_MVCCshIFZMd?-aA14JA7yy
za-+=ejV@4^uEQR4Qa5nShYW#iA$s+&{q~v@7*Oo+{d4g8fg{=SQM}I@B^|JRw9<g;
zDJw>Gaq+XE;DEeIU@>nuY5<X=jG!oZe7hQRpSzjCqCYVpmaL2S2Xj|k{xU0`%LMCO
z(=TxYbOckU%m)2d|Ne?e^9B?r*_CUQ*gzGm!~kl%kNt64;^T*QTKxS2F*Qr4*yYR{
z1ajtORqlOosybnx;~4y8LJ+8=*ARKd*ysf@_Yz%ua_+n42!(E_R1(41#)OejJC1Jn
zAgcO8zQgU?Le0*auaTx)7$A>$q!?1k9cX?N)$c)mCH-cxj+w?hRq~G4ijgcohI}km
z8^x_Sh4-cB8|@!|q9ydwjqlt08ZV9r1`y%ZYr5Au-?~qIsrR{QkU_E@Cq0V7fU4pk
zygTYgP6;&m@{x+BFfniOn2qj3cWyupTTI6(nR}5^Zh1E4%XkZ6^fb0N86(X?5?cS9
zQhfS~oIBfCvB)FM#EM6117@?ZsI@bX+@V4)r{p^~j%{k8Fe9^Ij@aZHZT|trUpf;*
z%(ww~{`016=mQFhpRV_i?k*-xgeR;Ln37#3wr}n15!zZ|bufOa$o~AExVNg>feI7<
zPcdit)`a7BaiyeTbV|o)Mt>;@fsK+-x<SBEBAwD~W5fuRkQS8&>8{b;EiF>gFzVs=
zS3K|T*Y|Z^oa;L0bJVPvKGn`xi<hyyD$`}vX@-FQ<bA-^cb%t~2pW`MM%ie@v60J`
zt(!2cNelh>r3GgXo~?MS5_M5|$d}aEw@BWX;i|Ftk(IK>tcC)3nD^^z_+k9Htn%qC
zY_nDY)F!2sAgzWe*T<|v8YI1=HowQwlS$bt?L4ukqhq*UNA(ot30r7wftI&?$PiYz
zCOKSj1J(Ho=OTBvAzqUD(Jeyk^f_?}JaSazF9F_riQt|wa38%ACw8N-VnkDAe5@^M
z8n0iosJ~W9r03(v(F2d6VuzPXcc+k7d6=6ou=%n}x&?0o?I3s1wG;9zqtK=KR_;^V
zZH$($?Drs&jVS!o-alCr1zgGNtPKWfGKDwx1^Cq;w5hS56(jmAyRFX|c8t;*mXJA&
z?-SyW`ME5S7*@Hz)1b;~gBO1ZkE4f?+;H{@o7f|oep)Q^++F`f4VFURlbe!C)?po*
z@QFyhSfoJ;OAd0LUfmcm&6;8hk=EK)e-*C|25Y5}$4@(bDwYd5pqTaQQw<K69`uN0
zqroz2n5wZM87@2WqwT5GySSEl_o?h;!abA_P|MOBvex4(<m&!O8`LK|VOE<TsQAHS
z^LvQFlNr}^&En|?$HTB^^vo>1jA&w^r5Ag#Q+iAu@`PU_QvKsL*79DxD=I%N`AyBZ
z2J8>cV#AF4vaOygRMlkQ5L7g3yai>l+#<%@Snp5UR9YYM|BM5@>=^wIK!;ib75W`-
zpi9?MA<?C)_hik@-biSrQtKs0^FjHobhXMK8qLo;&w2dTz*Q5{juUiaOMA2?Q}o)v
zM99Hh5k5i`Z&br@rEvbQXOK(0*AROk$we=UAL-r6Yul*b;cc$Z%)u1KFNfmf+Igm-
zE25<m{=~DjOA^J%&6V=}wUMnDa^@`$OP47H^gV)FjY6fwZYd{r7)MgaqnSyCD>gjq
zRtboMg|OpVh5;<ov$j@)4sg@`6K;^3I=kWHvX-6tDB=1|FZAB(759vu0Ga@*2QTIn
zySY@9@c!3##B<FU)^GboI1aK(?e5CfCx!{MGHbXu(rjQ)Xx><MsgayBB#pUbc}$Xu
zjIYm*KzmyrJ&fDE@v71vPx?C(PcV3D;KsE?r3O_`45w1gXTRPXy&bIX!O{HCgH_hR
z;34#XyDPX$KjiD7n#4j`onX+flQF0fy?Glrz4(>)pg>u<hp$bfdc2&5T_BOgV5JvG
zx68i3=fybR;W^Zt7FfQJ*j(cm&niI}*=-8bv1|6E54DYNn30T!A1|i;M9n=SkV^66
z`p<PgPAL3XGNI*_J{*y(JX&wc?~cz)E<7WT#0z5UPg$Tp1IM~R-ips)oUqTw8DLfg
zlg#^Gz5`EJ3mxsucXKkcmeUQPp4V9U%XH@$|8LCM;;*mRb91Pif4*l56Skgy7hN`*
zb>x?#UxT(7*s0MplDUKFPMVknTZ1nDUGCZ1s1{j{4BxcCj@Lu+@}w^Ds|<IFzA5<=
zM+YyMxi-=YpLX^WHIJ>Vj}XI?xzH_7rl04XJpszO&{4eRWAZz*m=k9^N0^&6DzBxw
zS13v;pKTg!zV+qs6=sEcM;aE?=$-9^WUrz5?lq9Nb5xizS&viP&83h$rB1)<mjwp3
zzJfXb@n_z)B#cV|O-ke3+;i^aZkV&_w>-5un^OvKW_n(y8#6M|f26{Pilnm7pJ+oO
z*oNI`d*7*Dt|&=pkHzN%W5k1Vfsm+tUv_-`!?{&@6$TOlQYJQ|AC<=^)v-wod<;3*
zEXjU-QgEBBAr!b~V=Afe3=@nl+5yTaICg!;kAM=3>Abi>R)+KYy75tK#y+k${1~#Z
z!)+~E%ongoFH@)CmbJvOj0e{BrQUPTw%$rmNcEnJycN{sH9W!D8mG;dzTt@b_bU~&
zclk_jU#-Io_QaZEba2gI;pgwk3+%MCHzti9>9pKM#`PQ0lTAKrS5N1olI^7!H|4Uu
z#yXhh)NebEI4n$ye0l)`t5*Vl&%lKF-gzsMce9ee<yqSIEpwcR56=V+x5UmYt<YvB
zQAbNE4|l670mlMcvPYbYEicX%_~}MF2x2lzQt9sc0%e**!w?zT==<M;TA9-Q_7cBQ
zBYqNx1{FdMOee+*`iZ<@m^26Y_!(Sb>*jffyZHADQ~UQBsp9P4kJv3fbNB7++DA`0
z>1Q2WU276`Ds@xa_w!`?0&23-L)}N8+7}_<H=F~gLea9Q7eHlTtmkvwBISi68)mXy
zU{E1>>$3(Xc2eKgjOF)+6*J*`mA%I3359A9cOt3qHZ=C0{EP8|v6>g0gvm$#*2fSy
znxvd0HcRs;PeoRaTT=Si8CH6l8YB^euP9`*?HNi6x1HhjxFpBqi+$G8f`D1ks?@#P
zNpsl3Hp4L*^g}D@P4ejL`3Z*CWv`lpl6!>jBvXCmRWT<!yP;c}S}8vZjH{ICw>V3J
z?ub4g1xsD4#SHX*wJWIXxY}1Rw{yyD8>%S}LH$*^aSp|VI$nI4#pionQdIzjsvam%
zo(9&Rj;YL@aG6T>G{O-k13mT{mRGz<`Uc^4N=Py1p&9{nmu(dL?yoWTKpx%0^bQ=9
z1<~b)ZLw^dz|xMgrb8~{Ic-JWL~x8M&)I^-1SePD4!)-X<UesU60cV|q(i0duR`~O
zyUV{?dt6IUB(Iykg5*Wv65n-G+$d0{vUll_AymHs-?|WTza8WG+A+K}2c&+6<npjM
z)G?sgn0O<kugtrz6Ov!kw@h?a_|js2eIQwvQug_t-jEs{<))`}!@$N*>ANF!#}qpd
z|39J`YVg3LMngv2&oT%kiRoGBc^FE6I|9hw#oR4FZ^b?k;1ZK1Vl2%Ze1`)4t)J>j
z{Jrlyv5U1RoXu|99G3Y-$)sXJ2~KsnZZhF0SIe+yIAWz1KLxgkN)f7B&c_Uw10>5u
zgSLnRGuQ&&!YyfXPoLTi3+g=Vh4yamvs5g*hz4xnEkZ<NF@6(WHEF=vHK#I-cLzFO
zniFNE9A06y8E#K&8eMe`NJep@6+e6l>)X&0_ShQIrYIhFO1YaU{fZOsl~lIWup5zR
zY}2<Sm)xcB2<W#cUQwwyR}6H}Ceose>G1F)4W(zs@F^k66jQwwX3Qv&@FDgO{^S8W
zC+hn+48U>p*z0gDWos(O{HL?25mn?+Z3latw&`vfESl%RDb_*6b>#mr^Lv^1n>+L+
z<#JP2Z5QL)Gd_YODpp&N#irhGiuY;kAB}znH480utqk?8CcH_T_dVv@{ZYMnB7>PG
z1jwHIf#!d>BV0Ql2Xx$Vz@>c}z8ZUW*$&O--5Fo!D}yeXGlwW>3FG`pxBIK7n0SY@
zD7aW9>`gbOq5Bg;S?=ax0o3w}@w;UBzu2m19D^ek-eec@eC5a<t^VpYuB>-L9UdoB
zD1B%|fMk>SO^Aqi33<uK1tcfIi$tq{pGtO~GR09uI!8(}Bs=RDuR2kLZTL%nd1B}B
zh{po+N^~cV^14!@MWj1lrC{kw)A7fq47R_=pTGe}lT)~IE_aW8f`=rk5C>2RXLAt1
z>mh4-bbsP>D8vqNu9TCk8?05zuEM8I>A3MW{KRKxzc;{9iRQuET=;Se&O@my<cj}3
zF9hzJ(5Hk5YfHW7KS!M`3&3I?7uDK*WWQhrW?5F7129KTPz%Cg1(2iY>ah)BLNnrB
z9=ICkVmP_wjCjQTmQSa$J{bqauXnZErrrbmoq$9=?DM>Dy`avk1PtXM>MF>N${&bz
z-r0D<?|BsCZwg1(XL`YPweMGtg>JL2%nWDi#tj_St!}6{lUMCMT~JM!#lA~9^c2~H
zq6l=cyH#_qE(E#1?_Ab|0@z5KmH;08v>Jpqt8ya|NY%p2EkO|CmI62GPNt8?QE$ZO
z(ufsRvrSn5CT<~{0_|ll1Z6^bc-nbuHkNmQjkrp0LEKRhJh(KP>I{wg<h`O#Ux7sM
zpBa{*D=T=8CK-O{5poW;;K@6`cfoVAwISeg$_L=hq;41V#ir<j!Du*_e$u#=88=gg
zgKY>);V!{nF$4T9gMd3Go{%H5KQ(Cz)<a*tV+^GWh(MxJnjyPJs}xU;XIXeE<_!-z
zDY#};64LOy$crXzH_j=|MM<v(-nP!NnpySmk_iTvWQ0f8Ogb9#;SH6he6Ono_-9WY
zYUO5z^dWh^S~nP5KTSA3r>;^a<rm1K%V7{Kdl;v!XS4M&iGgiNpln}olTg}uZ(?Yq
z6dp`W{j+zKI=#~VnOeR|Mah16ZOirexe18ggz`A(496{v4f#~i346fX*`-de%)UgR
zFRpMB(VF#lyHQ9Pzl6FQ99JZ;(8&923@_sp1|Tn@N=Z-xd2xmH|C>q2(L-N3efedG
z7KNiucvInCpM*{iMYgltUeq@95WV5Z%7W)){g;xJ8ObF-2UOF81K8fLKdn-<o;h}U
zOJCNHUlnU9#j#&gA9Nw0x9#y`vV(sc0J>81Ka3w8>@*}N=^A>MFL+W~itSZy)dfqg
zms3!qBY|nd`BFt3b*ua^T$u^22^Xy0cL`S3oqXSCd@#njfQ5YjL(VOhhbN1xa!B6;
zZp-&Yrmy*XShZtirRYP?4#b~_Mo+9u*pG0e()0ZTGnkcF1|-4Su9mwK6t%0HV1!I@
z$o?_n80;!j<%4+9nKm!f`5QzlK+f<-9>A+kIjvY?)AuNkTrk(l<@Ybj^q0Ica8GVv
zBtWpJ_p#K2(6jotMLYXXzF&P+LHGC07#&`hg5EE?dUL)TLkP7OH+{5g$%x;!Eh9$M
zZh(!PoKI<qOpjgnPB=&^IaO}WV26Iyyt|YJ@I!OkFOpBaL+^V|`xDv-C4#6b*=yWz
zcO)KG+`Q-#h|^lW1ZTI=%U1idlWD$0+F@ql!r$s#k{;!#qz|(&A<LdWGuQ!lCw5RN
z$pP?G=_Y?FNh(nY^xbyZ|42br;v~r0@->}KB8TiL)BE(wz4Ck3dGqIA%E#Oa;#vY|
zdhLyY<9dA_o^b<K*W}lYqnNIk`R3N1p$k0jofrIU3$ohh<@Zk@b<V91dT(elh9qX$
zc>303@BeU~vs?+mIbJrh__LTn&9uy$V-0}$O>CH4Z1Z_B_0uKx>R!?@#Sc-wR0A5;
zP-vg+OOb0a^|_`SK9J?wiC5Ud5$+#*jZOSp)?Pc1E;*UsqAyc^+%`gYImaCTsxR=6
zGa2PES2XV;hOcs)IqKJ<)?l2wxHsv9F;>h8Jn%;g8ir#n3vf=-H-z;(9A8#l-pF~j
z7?>-_DQ!qu+qfd7k2VTKdz7hLpjhSR)_>6s>5Gf_qaBnZBTo{uro3I*QumiU2%})Q
z$D2$UH5402LC9e7A6|!52&B?H|EsFj8(&e+#6exF222olxMMnUn#gU2U@SP{^FK2J
zQun_!ZjA)rKFQ?z#O_PN7TI-jQiLheG;f!!?x}W!-Cy-R6Q5+$598^0n|9(CWmMOA
zJNNL9zoeFg?<h|UIfa^|L#sjMf_-2tck>CAt)lIE;abwXyNS8L8{AsFbe8*=2l&pY
zMUf#ho3_&L#GD_rgL2oMGWQ4W!2s%ris)QGWDD^J&cfRkl7X&K5dDhvlC<Ha1U@Ns
zeb<zS;ICibBrP{043dA1s%JK3o^bRhUOIP8GgkOjjTU}l6v#qoyn*)(6CUuxCv{6b
z|NfwM`wDZiOj_EVk(RXN#;F>r5}BGh3W>c96I7!OMM46SmZNq=$fk`ogVqI97!gMJ
zS4$JGLr#jVcCIbE3wDy|v`ZwMVrz1t;wl+Qu_?Ja1Y(E*u$!v<{lTg5$p@qI4|*~w
zffhf{=_MBy&tmvX%v<_8H*<x9RwKynsm(I)Yida>2Wg9i|7#eSbZfnZ?`^G^(vG>*
z9VZX<4;#r~>h2j<oU)AWx5{6&)~niir$QZtDz4ijmJpnJX~x+5C80am2_a2g(}-D-
zq(V++{Vdkf81%Y~5b|8G%&Jjoh71S+|0IF%$N3yn5oa)$Wj5&qLJ=rWCq!1Exs9*D
z<RmdDA4mXJtX{%z5~z1Lyn#vtY&|z>9k;J&(_obZVklkWbPUFf8p;i~yK}mVjf6$K
z|LJtn3XPdG4dj<~e@jEKJWwG9rP%OewFc5pj!U^6ag-ek><jKB3w?t=>R0yt-KG2-
z)DCFtKJ;skQjUMu8p~*C?J4{+-HCcahlInpB+Bil42OB^IN28#;?JZ461&NNK8H!j
zUW%^t%XKVBF<A*(b26HsO>>9#mKAO+I+lG`x*VGNTS8COKg$Lv?u1-!G+!)z8CcQJ
za%xg<)3dj&eNk8RKF)v7c`f6B#uDUp+4caqkUIf9nOQj{+!M}ZH4>=yaAMgouye6A
zQ)cK;ljc0~+pkSzpnEKUwaQ++$}Fk=NfjTT2ty=CYfy0ejCx)kV{bb4);ohB;LaDF
zDV0=_1=127<Bwf|%E0L9VY~xQwQiMdO3k-x7Dv+P!}J$%@#NgV{IbD!oZnj*-v3tT
z`5bDEO0^^@58>JCx9N_eg|#S1h<3IprD`^U8ykkcQ&#Ma+2k3A?^S6!VZv0b0#XXu
z#p!vUSv5+VZfHg+ZxD8DPiWf;^tODAYA>|G&YK;rt|4>V2Lm)||M&;uTS>%$SW|Fu
z=(~p4#fVzlKUgO+43u$A$RaJz%p*mt59%oO0MS%14XU!4dI*K4_T*^NTkUwcv#gJ{
z>+M*jtJfvT2mj%<Jk`Bb`t&>hhOYdEcwNzLRjQn*0u`QJ?$vtDP;_`J_%nH<<aXp!
zq8anMN2}b#5|Ri<&MWvncZX(-Nl=B$Ne($>HFUQ&UH(%Hd9X7~A6%;UNwuy<lys`n
zvFUzwI8sGs2knz{F!BqOm#h)1VA#<G){;{6t}Z8!)X=h4`sbQr1b(q-1UWWmdFx1o
zf&XFXzD=WU=G!*FX3e*kh@RERrOD^ZmH+MC#M|`cw_eCir&fPY;%m`~Nk3`mJvM0#
z`8rXiQh#)he=tNru}+w+UfKn5Wc<<29W5@p$)i4Q66qd1K<WMF;k1n{aO>saTy+e`
z0)>w$K6Xzkjab(6Yg4sA*S>+H8a>?<;E>E&tsN7OE?9%Rz#ivQlvWkFx6?PlpA#L_
za6{t)?GC<z*M3;aS%5}CwQs(9ng)Caqz$>Y9&0ZH0!fdbJ^VWoZ4en5u12I>D2j*J
zZE;^`>e}Ux@`P?Mv0(b>0!fdy7kv#w#j@LX9{L}KtiA6dN<SEd$S`;_%gs_P0Nv7z
zUB$C132o>^mo-I4bl4m|_V~)PRZTsn2*dqw>n1zL7+G&$y}3bn7!Nl8W;*!KOz~B5
zmP_Y*ht<f+2(7}JiE*Gj)S=v%+_{J!9R*b#k-~#fGZZZwU~erR`pp~8&Mw0|xnNAG
z4Uk0_r<MXJmx*n@3#-UNiuxc-N`JmV>SN^$pwl$*i;nC1HVpk%<htFS8_*@4rVLqg
zwlRRcgsL)tw`A~pB|0^7<)X~3(0g7$3@&*mn$DKrxmGZrtYGQ<@WKyueeySXlD3nd
zZ_p@GtA++-^s5!(uqZeeuVmQuRZy+6W&i@Lkl8g+|5*E@oxQ}vCAuPMoV{iN?in>b
z2M?hb)Muin?~Q%7;w<H!N$GRPz0v!eFOK=Y6Enzhv8*?9xR03u@FkPXI|6P}Q0+sD
zJL!wPDTKKn1~*#Gvsb;Xceg|;j$Qdm0i^c^P4LFaCY(u)V2=>?BIhM{!Fbv$vn&%E
z`Pu*cV}fc%V5@h`XtG1czjJyMJ_+V!-KSPpSa#27>#wdp{SkKmy={)eAQKCt9R8W1
z-?szgO`w9M;>i#n*L40(X+;8OdcPa;YwS%dEpUsoY0!S@uJ8G%?-18aG{GRp8MXm%
z1SWZmo4}tFi|8lO54P`XNf4ns_+V66KoF=j39Z7Q$u4eL7%Ob9%AFYB$%~IH_!K@p
zc-#GO*=zA7J4HBTJ5{>R=!I#V1RW@HII&;HR(%^s1CZkynMyeOpGL1Oc=b;?E&<9g
zoZnoFj-ymf)?FI;ZAAxFX4hYgl~;q_Zw=OBX^!x#x5HyAWZ&=oyat`}(H8Oft>RAF
y?s~Us=Kdc^bLm6ip5&9ddN*tj#Q*d0K(;YUUHNmEYW9EY;oz4#s%6U7;r|De8$MM4

literal 0
HcmV?d00001

diff --git a/resources/queries/boards/board_curiosity_pic32mz_ef_20/Boards.json b/resources/queries/boards/board_curiosity_pic32mz_ef_20/Boards.json
new file mode 100644
index 000000000..f497bd9d3
--- /dev/null
+++ b/resources/queries/boards/board_curiosity_pic32mz_ef_20/Boards.json
@@ -0,0 +1,16 @@
+{
+    "uid": "PIC32MZ_EF_20_CURIOSITY_DEVELOPMENT_BOARD",
+    "name": "Curiosity PIC32MZ EF 2.0 Development Board",
+    "icon": "images/boards/board-curiosity-pic32mz-ef-20.png",
+    "default_device": "",
+    "soldered_device": "PIC32MZ2048EFM144",
+    "category": "Development Systems",
+    "mikrobus_count": 2,
+    "sort_order": 6,
+    "min_pin_count": 0,
+    "display_socket": "NO_DISPLAY",
+    "sdk_config": "{\"_MSDK_BOARD_NAME_\":\"BOARD_CURIOSITY_PIC32MZ_EF_20\",\"HAS_MIKROBUS\":\"true\"}",
+    "necto_config": "",
+    "display": "NO_DISPLAY",
+    "package_uid": "144/LQFP"
+}
diff --git a/resources/queries/boards/board_curiosity_pic32mz_ef_20/LinkerTables.json b/resources/queries/boards/board_curiosity_pic32mz_ef_20/LinkerTables.json
new file mode 100644
index 000000000..c10b090ab
--- /dev/null
+++ b/resources/queries/boards/board_curiosity_pic32mz_ef_20/LinkerTables.json
@@ -0,0 +1,20 @@
+{
+    "board_uid": "PIC32MZ_EF_20_CURIOSITY_DEVELOPMENT_BOARD",
+    "tables": [
+        {
+            "BoardToDevice": {
+                "device_uid": "PIC32MZ2048EFM144"
+            }
+        },
+        {
+            "BoardToSocket": {
+                "socket_uid": ["NONE"]
+            }
+        },
+        {
+            "SDKToBoard": {
+                "sdk_uid": "2.11.2+"
+            }
+        }
+    ]
+}
diff --git a/resources/queries/cards/mcu_card_5_for_kinetis_mkv44f64vlh16/Devices.json b/resources/queries/cards/mcu_card_5_for_kinetis_mkv44f64vlh16/Devices.json
new file mode 100644
index 000000000..17c5635e8
--- /dev/null
+++ b/resources/queries/cards/mcu_card_5_for_kinetis_mkv44f64vlh16/Devices.json
@@ -0,0 +1,18 @@
+{
+    "def_file":"MKV44F64VLH16.json",
+    "family_uid":"KINETIS_V_SERIES",
+    "flash":"64",
+    "icon":"images/mcu_cards/mcu-card-5-for-kinetis.png",
+    "max_speed":"160.000",
+    "name":"MCU CARD 5 for Kinetis MKV44F64VLH16",
+    "ram":"16384",
+    "sdk_config":"{\"MCU_NAME\":\"MKV44F64VLH16\",\"CORE_NAME\":\"M4EF\",\"_MSDK_HAL_LOW_LEVEL_TARGET_\":\"mikroe\",\"_MSDK_ETH_PHY_CHIP_\":\"NULL\",\"_MSDK_MCU_CARD_NAME_\":\"MCU_CARD_5_FOR_KINETIS\"}",
+    "necto_config":"",
+    "uid":"MCU_CARD_5_FOR_KINETIS_MKV44F64VLH16",
+    "vendor":"NXP",
+    "compiler_flags":"",
+    "linker_flags":"",
+    "tft_socket":"1",
+    "sdk_support":"1",
+    "installer_package":"{\"package\":\"mcu_card_5_for_kinetis_mkv44f64vlh16\"}"
+}
diff --git a/resources/queries/cards/mcu_card_5_for_kinetis_mkv44f64vlh16/LinkerTables.json b/resources/queries/cards/mcu_card_5_for_kinetis_mkv44f64vlh16/LinkerTables.json
new file mode 100644
index 000000000..c34363054
--- /dev/null
+++ b/resources/queries/cards/mcu_card_5_for_kinetis_mkv44f64vlh16/LinkerTables.json
@@ -0,0 +1,39 @@
+{
+    "device_uid": "MCU_CARD_5_FOR_KINETIS_MKV44F64VLH16",
+    "tables": [
+        {
+            "BoardToDevice": {
+                "board_uid": [
+                    "FUSION_FOR_ARM_V8",
+                    "FUSION_FOR_KINETIS_V8",
+                    "UNI_CLICKER",
+                    "UNI_DS_V8"
+                ]
+            }
+        },
+        {
+            "CompilerToDevice": {
+                "compiler_uid": [
+                    "clang-llvm",
+                    "gcc_arm_none_eabi",
+                    "mikrocarm"
+                ]
+            }
+        },
+        {
+            "DeviceToPackage": {
+                "package_uid": ["64/LQFP"]
+            }
+        },
+        {
+            "DeviceToSocket": {
+                "socket_uid": ["SIBRAIN_SOCKET"]
+            }
+        },
+        {
+            "SDKToDevice": {
+                "sdk_uid": "2.11.2+"
+            }
+        }
+    ]
+}

From c66d5ea69ed87a4b8a439699c36b8b8a8a0b26a2 Mon Sep 17 00:00:00 2001
From: "ivan.ruzavin" <ivan.ruzavin@mikroe.com>
Date: Fri, 6 Dec 2024 08:38:23 +0100
Subject: [PATCH 2/5] Updated folder structuring

---
 .../board.cmake                                                   | 0
 .../board.h                                                       | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename bsp/board/include/boards/{board_curiosity_pic32mz_ef_20 => board_curiosity_pic32_mz_ef_20}/board.cmake (100%)
 rename bsp/board/include/boards/{board_curiosity_pic32mz_ef_20 => board_curiosity_pic32_mz_ef_20}/board.h (100%)

diff --git a/bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.cmake b/bsp/board/include/boards/board_curiosity_pic32_mz_ef_20/board.cmake
similarity index 100%
rename from bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.cmake
rename to bsp/board/include/boards/board_curiosity_pic32_mz_ef_20/board.cmake
diff --git a/bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.h b/bsp/board/include/boards/board_curiosity_pic32_mz_ef_20/board.h
similarity index 100%
rename from bsp/board/include/boards/board_curiosity_pic32mz_ef_20/board.h
rename to bsp/board/include/boards/board_curiosity_pic32_mz_ef_20/board.h

From d34387b870aea4ff8a35af9e343f3d5b20761224 Mon Sep 17 00:00:00 2001
From: "ivan.ruzavin" <ivan.ruzavin@mikroe.com>
Date: Fri, 6 Dec 2024 08:51:08 +0100
Subject: [PATCH 3/5] Updated folder structure for queries

---
 .../Boards.json                                                   | 0
 .../LinkerTables.json                                             | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename resources/queries/boards/{board_curiosity_pic32mz_ef_20 => board_curiosity_pic32_mz_ef_20}/Boards.json (100%)
 rename resources/queries/boards/{board_curiosity_pic32mz_ef_20 => board_curiosity_pic32_mz_ef_20}/LinkerTables.json (100%)

diff --git a/resources/queries/boards/board_curiosity_pic32mz_ef_20/Boards.json b/resources/queries/boards/board_curiosity_pic32_mz_ef_20/Boards.json
similarity index 100%
rename from resources/queries/boards/board_curiosity_pic32mz_ef_20/Boards.json
rename to resources/queries/boards/board_curiosity_pic32_mz_ef_20/Boards.json
diff --git a/resources/queries/boards/board_curiosity_pic32mz_ef_20/LinkerTables.json b/resources/queries/boards/board_curiosity_pic32_mz_ef_20/LinkerTables.json
similarity index 100%
rename from resources/queries/boards/board_curiosity_pic32mz_ef_20/LinkerTables.json
rename to resources/queries/boards/board_curiosity_pic32_mz_ef_20/LinkerTables.json

From 6003e1a1e6da3ccd30927dd447ebc9cf4bb8f6f0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Dec 2024 08:10:24 +0000
Subject: [PATCH 4/5] Remove old changelog file after moving it

---
 changelog/new_hw.md | 30 ------------------------------
 1 file changed, 30 deletions(-)
 delete mode 100644 changelog/new_hw.md

diff --git a/changelog/new_hw.md b/changelog/new_hw.md
deleted file mode 100644
index e35400b59..000000000
--- a/changelog/new_hw.md
+++ /dev/null
@@ -1,30 +0,0 @@
-<p align="center">
-  <img src="http://www.mikroe.com/img/designs/beta/logo_small.png?raw=true" alt="MikroElektronika"/>
-</p>
-
----
-
-**[BACK TO PREVIOUS FILE](../changelog.md)**
-
----
-
-# `DATE`
-
-## Changes
-
-- [`DATE`](#date)
-  - [Changes](#changes)
-    - [NEW HARDWARE](#new-hardware)
-
-### NEW HARDWARE
-
-Support added for following hardware:
-
-+ [Curiosity PIC32MZ EF 2.0 Development Board](https://mplab-discover.microchip.com/v2/item/com.microchip.portal.evalboard/com.microchip.subcategories.modules-and-peripherals.communication.can.Others/mcu32.dm320209/1.0.0?view=about)
-+ [MCU CARD 5 for Kinetis MKV44F64VLH16](https://www.mikroe.com/mcu-card-5-for-kinetis-mkv44f64vlh16)
-
----
-
-**[BACK TO PREVIOUS FILE](../changelog.md)**
-
----

From c69624bb9b46c3ac99320b7d7426f92976364886 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Dec 2024 08:10:25 +0000
Subject: [PATCH 5/5] Updated changelog files with latest release info.

---
 changelog/v2.12.1/changelog.md         |  1 +
 changelog/v2.12.1/new_hw/2024-12-06.md | 30 ++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 changelog/v2.12.1/new_hw/2024-12-06.md

diff --git a/changelog/v2.12.1/changelog.md b/changelog/v2.12.1/changelog.md
index 8e4bf4b0f..80283c88a 100644
--- a/changelog/v2.12.1/changelog.md
+++ b/changelog/v2.12.1/changelog.md
@@ -68,6 +68,7 @@ Support added for following hardware:
 
 + **[2024-12-04](./new_hw/2024-12-04.md)**
 + **[2024-12-05](./new_hw/2024-12-05.md)**
++ **[2024-12-06](./new_hw/2024-12-06.md)**
 
 ---
 
diff --git a/changelog/v2.12.1/new_hw/2024-12-06.md b/changelog/v2.12.1/new_hw/2024-12-06.md
new file mode 100644
index 000000000..33f979fc4
--- /dev/null
+++ b/changelog/v2.12.1/new_hw/2024-12-06.md
@@ -0,0 +1,30 @@
+<p align="center">
+  <img src="http://www.mikroe.com/img/designs/beta/logo_small.png?raw=true" alt="MikroElektronika"/>
+</p>
+
+---
+
+**[BACK TO PREVIOUS FILE](../changelog.md)**
+
+---
+
+# 2024-12-06
+
+## Changes
+
+- [2024-12-06](#2024-12-06)
+  - [Changes](#changes)
+    - [NEW HARDWARE](#new-hardware)
+
+### NEW HARDWARE
+
+Support added for following hardware:
+
++ [Curiosity PIC32MZ EF 2.0 Development Board](https://mplab-discover.microchip.com/v2/item/com.microchip.portal.evalboard/com.microchip.subcategories.modules-and-peripherals.communication.can.Others/mcu32.dm320209/1.0.0?view=about)
++ [MCU CARD 5 for Kinetis MKV44F64VLH16](https://www.mikroe.com/mcu-card-5-for-kinetis-mkv44f64vlh16)
+
+---
+
+**[BACK TO PREVIOUS FILE](../changelog.md)**
+
+---