From ac1acca8d749092d2a4beffb6da327b5288f52b6 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 16 Dec 2013 21:56:44 +0900 Subject: [PATCH 01/48] Add description of keyboard report in report.h --- common/report.h | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/common/report.h b/common/report.h index 91982840..71543cc2 100644 --- a/common/report.h +++ b/common/report.h @@ -94,6 +94,26 @@ along with this program. If not, see . extern "C" { #endif +/* + * keyboard report is 8-byte array retains state of 8 modifiers and 6 keys. + * + * byte |0 |1 |2 |3 |4 |5 |6 |7 + * -----+--------+--------+--------+--------+--------+--------+--------+-------- + * desc |mods |reserved|keys[0] |keys[1] |keys[2] |keys[3] |keys[4] |keys[5] + * + * It is exended to 16 bytes to retain 120keys+8mods when NKRO mode. + * + * byte |0 |1 |2 |3 |4 |5 |6 |7 ... |15 + * -----+--------+--------+--------+--------+--------+--------+--------+-------- +-------- + * desc |mods |bits[0] |bits[1] |bits[2] |bits[3] |bits[4] |bits[5] |bits[6] ... |bit[14] + * + * mods retains state of 8 modifiers. + * + * bit |0 |1 |2 |3 |4 |5 |6 |7 + * -----+--------+--------+--------+--------+--------+--------+--------+-------- + * desc |Lcontrol|Lshift |Lalt |Lgui |Rcontrol|Rshift |Ralt |Rgui + * + */ typedef union { uint8_t raw[REPORT_SIZE]; struct { From 696a7fbc6f1fc1e48948dd56c5f45462549b329c Mon Sep 17 00:00:00 2001 From: TiBounise Date: Mon, 16 Dec 2013 19:53:02 +0100 Subject: [PATCH 02/48] Fixing a typo --- doc/build.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/build.md b/doc/build.md index ae856501..2e8157e0 100644 --- a/doc/build.md +++ b/doc/build.md @@ -40,7 +40,7 @@ Move to project directory in the firmware source. Build firmware using GNU `make` command. You'll see `_.hex` file in that directory unless something unexpected occurs in build process. - mkae -f Makefile. clean + make -f Makefile. clean make -f Makefile. From 8fc26a1360a4856bdd13fc14caf339fb6841b4d4 Mon Sep 17 00:00:00 2001 From: Yann Hodique Date: Thu, 26 Dec 2013 21:16:27 -0800 Subject: [PATCH 03/48] fix compilation --- converter/sun_usb/matrix.c | 1 - 1 file changed, 1 deletion(-) diff --git a/converter/sun_usb/matrix.c b/converter/sun_usb/matrix.c index 717c131e..a61e3a2d 100644 --- a/converter/sun_usb/matrix.c +++ b/converter/sun_usb/matrix.c @@ -63,7 +63,6 @@ uint8_t matrix_cols(void) void matrix_init(void) { - print_enable = true; debug_enable = true; serial_init(); From 8e9498f066185b2bb5165c4478c681b79500951a Mon Sep 17 00:00:00 2001 From: Yann Hodique Date: Thu, 26 Dec 2013 21:52:58 -0800 Subject: [PATCH 04/48] fix hard-coded keys values provided to macro were not used for the "K61,K49,K33, K30" block --- converter/sun_usb/keymap.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/converter/sun_usb/keymap.c b/converter/sun_usb/keymap.c index 048a863c..3d724a52 100644 --- a/converter/sun_usb/keymap.c +++ b/converter/sun_usb/keymap.c @@ -77,12 +77,12 @@ along with this program. If not, see . K63, K64,K65,K66,K67,K68,K69,K6A,K6B,K6C,K6D, K0D,K14,K6E, \ K77,K13, K78, K79, K7A,K43,K62,K18,K1B,K1C \ ) KEYMAP( \ - HELP, K05,K06,K08,K0A, K0C,K0E,K10,K11, K12,K07,K09,K0B, PSCR,SLCK,PAUS, MUTE,VOLD,VOLU,PWR, \ + HELP, K05,K06,K08,K0A, K0C,K0E,K10,K11, K12,K07,K09,K0B, PSCR,SLCK,PAUS, MUTE,VOLD,VOLU,K30, \ K01, AGAIN, K1D,K1E,K1F,K20,K21,K22,K23,K24,K25,K26,K27,K28,K29,K58,K2A, K2C, K34, K60, K62, PSLS,PAST,PMNS, \ MENU, UNDO, K35, K36,K37,K38,K39,K3A,K3B,K3C,K3D,K3E,K3F,K40,K41, K2B, K42, K4A, K7B, P7, P8, P9, PPLS, \ - SELECT, COPY, K4C, K4D,K4E,K4F,K50,K51,K52,K53,K54,K55,K56,K57, K59, P4, P5, P6, \ - EXECUTE,PASTE, K63, K64,K65,K66,K67,K68,K69,K6A,K6B,K6C,K6D, K6E, K14, P1, P2, P3, PENT, \ - FIND, CUT, K77,K13, K78, HENK, K79, MHEN, KANA, K7A,K43,K0D, K18, K1B, K1C, P0, PDOT \ + SELECT, K33, K4C, K4D,K4E,K4F,K50,K51,K52,K53,K54,K55,K56,K57, K59, P4, P5, P6, \ + EXECUTE,K49, K63, K64,K65,K66,K67,K68,K69,K6A,K6B,K6C,K6D, K6E, K14, P1, P2, P3, PENT, \ + FIND, K61, K77,K13, K78, HENK, K79, MHEN, KANA, K7A,K43,K0D, K18, K1B, K1C, P0, PDOT \ ) From 92cda14f7a30f14bb3836c2369d110b2c8b4cf75 Mon Sep 17 00:00:00 2001 From: tmk Date: Fri, 3 Jan 2014 07:05:41 +0900 Subject: [PATCH 05/48] Add ascii_usb ASCII Serial Console terminal converter --- README.md | 1 + converter/ascii_usb/Makefile | 82 +++++++++++++++ converter/ascii_usb/README | 33 ++++++ converter/ascii_usb/config.h | 70 +++++++++++++ converter/ascii_usb/keymap.c | 42 ++++++++ converter/ascii_usb/led.c | 25 +++++ converter/ascii_usb/matrix.c | 195 +++++++++++++++++++++++++++++++++++ 7 files changed, 448 insertions(+) create mode 100644 converter/ascii_usb/Makefile create mode 100644 converter/ascii_usb/README create mode 100644 converter/ascii_usb/config.h create mode 100644 converter/ascii_usb/keymap.c create mode 100644 converter/ascii_usb/led.c create mode 100644 converter/ascii_usb/matrix.c diff --git a/README.md b/README.md index 536cc753..bca1c136 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,7 @@ You can find some keyboard specific projects under `converter` and `keyboard` di * [sun_usb](converter/sun_usb/) - [Sun] to USB(type4, 5 and 3?) * [pc98_usb](converter/pc98_usb/) - [PC98] to USB * [usb_usb](converter/usb_usb/) - USB to USB(experimental) +* [ascii_usb](converter/ascii_usb/) - ASCII(Serial console terminal) to USB ### keyboard * [hhkb](keyboard/hhkb/) - [Happy Hacking Keyboard pro][GH_hhkb] **my main board** diff --git a/converter/ascii_usb/Makefile b/converter/ascii_usb/Makefile new file mode 100644 index 00000000..408aa423 --- /dev/null +++ b/converter/ascii_usb/Makefile @@ -0,0 +1,82 @@ +# Target file name (without extension). +TARGET = ascii_usb + +# Directory common source filess exist +TOP_DIR = ../.. + +# Directory keyboard dependent files exist +TARGET_DIR = . + +# keyboard dependent files +SRC = keymap.c \ + matrix.c \ + led.c \ + protocol/serial_uart.c + +CONFIG_H = config.h + + +# MCU name, you MUST set this to match the board you are using +# type "make clean" after changing this, so all files will be rebuilt +#MCU = at90usb162 # Teensy 1.0 +MCU = atmega32u4 # Teensy 2.0 +#MCU = at90usb646 # Teensy++ 1.0 +#MCU = at90usb1286 # Teensy++ 2.0 + + +# Processor frequency. +# Normally the first thing your program should do is set the clock prescaler, +# so your program will run at the correct speed. You should also set this +# variable to same clock speed. The _delay_ms() macro uses this, and many +# examples use this variable to calculate timings. Do not add a "UL" here. +F_CPU = 16000000 + + +# +# LUFA specific +# +# Target architecture (see library "Board Types" documentation). +ARCH = AVR8 + +# Input clock frequency. +# This will define a symbol, F_USB, in all source code files equal to the +# input clock frequency (before any prescaling is performed) in Hz. This value may +# differ from F_CPU if prescaling is used on the latter, and is required as the +# raw input clock is fed directly to the PLL sections of the AVR for high speed +# clock generation for the USB and other AVR subsections. Do NOT tack on a 'UL' +# at the end, this will be done automatically to create a 32-bit value in your +# source code. +# +# If no clock division is performed on the input clock inside the AVR (via the +# CPU clock adjust registers or the clock division fuses), this will be equal to F_CPU. +F_USB = $(F_CPU) + +# Interrupt driven control endpoint task +OPT_DEFS += -DINTERRUPT_CONTROL_ENDPOINT + + +# Build Options +# *Comment out* to disable the options. +# +#MOUSEKEY_ENABLE = yes # Mouse keys +#EXTRAKEY_ENABLE = yes # Audio control and System control +CONSOLE_ENABLE = yes # Console for debug +#NKRO_ENABLE = yes # USB Nkey Rollover + + +# Boot Section Size in bytes +# Teensy halfKay 512 +# Atmel DFU loader 4096 +# LUFA bootloader 4096 +OPT_DEFS += -DBOOTLOADER_SIZE=4096 + + +# Search Path +VPATH += $(TARGET_DIR) +VPATH += $(TOP_DIR) + + +include $(TOP_DIR)/protocol/lufa.mk +include $(TOP_DIR)/protocol.mk +include $(TOP_DIR)/common.mk +include $(TOP_DIR)/rules.mk diff --git a/converter/ascii_usb/README b/converter/ascii_usb/README new file mode 100644 index 00000000..afd2e47f --- /dev/null +++ b/converter/ascii_usb/README @@ -0,0 +1,33 @@ +ASCII to USB keyboard protocol converter +======================================== +This converts serial console terminal into USB keyboard, tested with TRS-80 model 100 TELCOM application. +Target MCU is ATMega32u4 but other USB capable AVR will also work. + + +Hardware +-------- +Connect RX, TX and GND to UART pin of AVR. Note that you may need line drvier/level shfiter like MAX232 to interface high voltage of RS-232C. + + + +Build Firmware +-------------- +Configure UART setting and Just use 'make' + + $ cd ascii_usb + $ make + +Then, load the binary to MCU with your favorite programmer. + + + +Limitation +---------- +- This cannot see key up event, you cannot hold a key. +- Alt, Gui(Win/Mac) modifier key are not available. + + + +Scan code +--------- +ASCII code(0x01-7F) diff --git a/converter/ascii_usb/config.h b/converter/ascii_usb/config.h new file mode 100644 index 00000000..0908997a --- /dev/null +++ b/converter/ascii_usb/config.h @@ -0,0 +1,70 @@ +/* +Copyright 2014 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#ifndef CONFIG_H +#define CONFIG_H + +#define VENDOR_ID 0xFEED +#define PRODUCT_ID 0x5C01 +#define DEVICE_VER 0x0100 +#define MANUFACTURER t.m.k. +#define PRODUCT ASCII keyboard converter +#define DESCRIPTION converts Serial Console Terminal into USB keyboard + + +/* matrix size */ +#define MATRIX_ROWS 16 +#define MATRIX_COLS 16 + +/* key combination for command */ +#define IS_COMMAND() ( \ + host_get_first_key() == KC_BRK \ +) + + +/* + * Serial(USART) configuration + * asynchronous, positive logic, 19200baud, bit order: LSB first + * 1-start bit, 8-data bit, odd parity, 1-stop bit + */ +#ifdef __AVR_ATmega32U4__ + #define SERIAL_UART_BAUD 19200 + #define SERIAL_UART_DATA UDR1 + #define SERIAL_UART_UBRR ((F_CPU/(16UL*SERIAL_UART_BAUD))-1) + #define SERIAL_UART_RXD_VECT USART1_RX_vect + #define SERIAL_UART_TXD_READY (UCSR1A&(1<>8); /* baud rate */ \ + UCSR1B |= (1< + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#include +#include +#include +#include "keycode.h" +#include "action.h" +#include "action_macro.h" +#include "action_util.h" +#include "util.h" +#include "print.h" +#include "keymap.h" + + +// Keymap is not used. See matrix.c. + +/* translates key to keycode */ +uint8_t keymap_key_to_keycode(uint8_t layer, key_t key) +{ + return KC_NO; +} + +/* translates Fn keycode to action */ +action_t keymap_fn_to_action(uint8_t keycode) +{ + return (action_t) { .code = ACTION_NO }; +} diff --git a/converter/ascii_usb/led.c b/converter/ascii_usb/led.c new file mode 100644 index 00000000..d1c39bc6 --- /dev/null +++ b/converter/ascii_usb/led.c @@ -0,0 +1,25 @@ +/* +Copyright 2012 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#include "stdint.h" +#include "serial.h" +#include "led.h" + + +void led_set(uint8_t usb_led) +{ +} diff --git a/converter/ascii_usb/matrix.c b/converter/ascii_usb/matrix.c new file mode 100644 index 00000000..e1ea8e0a --- /dev/null +++ b/converter/ascii_usb/matrix.c @@ -0,0 +1,195 @@ +/* +Copyright 2014 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#include +#include +#include +#include +#include "print.h" +#include "util.h" +#include "matrix.h" +#include "debug.h" +#include "action_util.h" +#include "protocol/serial.h" + + +/* + * Not use Matrix. + * + * ROW: 16(4bits) + * COL: 16(4bits) + * + * 8bit wide + * +---------+ + * 0|00 ... 0F| + * 1|08 ... 1F| + * :| ... | + * :| ... | + * E|E0 ... EF| + * F|F0 ... FF| + * +---------+ + */ + + +inline +uint8_t matrix_rows(void) +{ + return MATRIX_ROWS; +} + +inline +uint8_t matrix_cols(void) +{ + return MATRIX_COLS; +} + +void matrix_init(void) +{ + debug_matrix = true; + serial_init(); + + debug("init\n"); + return; +} + +static void type_key(uint16_t keycode) +{ + if (keycode == 0) return; + + uint8_t mods = keycode>>8; + uint8_t key = keycode&0xFF; + if (mods) { + add_mods(mods); + send_keyboard_report(); + } + + add_key(key); + send_keyboard_report(); + + del_key(key); + send_keyboard_report(); + + if (mods) { + del_mods(mods); + send_keyboard_report(); + } +} +static uint16_t code2key(uint8_t code) +{ + // ASCII to key combination in US laout + switch (code) { + case 0x01 ... 0x08: // Ctrl-[a-z] + return MOD_BIT(KC_LCTRL)<<8 | (KC_A + (code-0x01)); + case 0x09: return KC_TAB; // TAB(Ctrl-i) + case 0x0A ... 0x0C: // Ctrl-[a-z] + return MOD_BIT(KC_LCTRL)<<8 | (KC_A + (code-0x01)); + case 0x0D: return KC_ENTER; // Enter(Ctrl-m) + case 0x0E ... 0x1A: // Ctrl-[a-z] + return MOD_BIT(KC_LCTRL)<<8 | (KC_A + (code-0x01)); + case 0x1B: return KC_ESC; + case 0x1C: return KC_RIGHT; + case 0x1D: return KC_LEFT; + case 0x1E: return KC_UP; + case 0x1F: return KC_DOWN; + case 0x20: return KC_SPACE; + case 0x21: return MOD_BIT(KC_LSHIFT)<<8 | KC_1; // ! + case 0x22: return MOD_BIT(KC_LSHIFT)<<8 | KC_QUOTE; // " + case 0x23: return MOD_BIT(KC_LSHIFT)<<8 | KC_3; // # + case 0x24: return MOD_BIT(KC_LSHIFT)<<8 | KC_4; // $ + case 0x25: return MOD_BIT(KC_LSHIFT)<<8 | KC_5; // % + case 0x26: return MOD_BIT(KC_LSHIFT)<<8 | KC_7; // & + case 0x27: return KC_QUOTE; // ' + case 0x28: return MOD_BIT(KC_LSHIFT)<<8 | KC_9; // ( + case 0x29: return MOD_BIT(KC_LSHIFT)<<8 | KC_0; // ) + case 0x2A: return MOD_BIT(KC_LSHIFT)<<8 | KC_8; // * + case 0x2B: return MOD_BIT(KC_LSHIFT)<<8 | KC_EQUAL; // + + case 0x2C: return KC_COMMA; // , + case 0x2D: return KC_MINUS; // - + case 0x2E: return KC_DOT; // . + case 0x2F: return KC_SLASH; // / + case 0x30: return KC_0; + case 0x31 ... 0x39: // 1-9 + return KC_1 + (code-0x31); + case 0x3A: return MOD_BIT(KC_LSHIFT)<<8 | KC_SCLN; // : + case 0x3B: return KC_SCLN; // ; + case 0x3C: return MOD_BIT(KC_LSHIFT)<<8 | KC_COMMA; // < + case 0x3D: return KC_EQUAL; // = + case 0x3E: return MOD_BIT(KC_LSHIFT)<<8 | KC_DOT; // > + case 0x3F: return MOD_BIT(KC_LSHIFT)<<8 | KC_SLASH; // ? + case 0x40: return MOD_BIT(KC_LSHIFT)<<8 | KC_2; // @ + case 0x41 ... 0x5A: // A-Z + return MOD_BIT(KC_LSHIFT)<<8 | (KC_A + (code-0x41)); + case 0x5B: return KC_LBRACKET; // [ + case 0x5C: return KC_BSLASH; // + case 0x5D: return KC_RBRACKET; // ] + case 0x5E: return MOD_BIT(KC_LSHIFT)<<8 | KC_6; // ^ + case 0x5F: return MOD_BIT(KC_LSHIFT)<<8 | KC_MINUS; // _ + case 0x61 ... 0x7A: // a-z + return KC_A + (code-0x61); + case 0x7B: return MOD_BIT(KC_LSHIFT)<<8 | KC_LBRACKET; // { + case 0x7C: return MOD_BIT(KC_LSHIFT)<<8 | KC_BSLASH; // | + case 0x7D: return MOD_BIT(KC_LSHIFT)<<8 | KC_RBRACKET; // } + case 0x7E: return MOD_BIT(KC_LSHIFT)<<8 | KC_GRAVE; // } + case 0x7F: return KC_DELETE; // + } + return 0; +} + +uint8_t matrix_scan(void) +{ + uint16_t code = serial_recv2(); + if (code == -1) { + return 0; + } + + print_hex8(code); print(" "); + + // echo back + serial_send(code); + type_key(code2key(code)); + + + return code; +} + +inline +bool matrix_has_ghost(void) +{ + return false; +} + +inline +bool matrix_is_on(uint8_t row, uint8_t col) +{ + return false; +} + +inline +matrix_row_t matrix_get_row(uint8_t row) +{ + return 0; +} + +void matrix_print(void) +{ + print("\nr/c 0123456789ABCDEF\n"); + for (uint8_t row = 0; row < matrix_rows(); row++) { + phex(row); print(": "); + pbin_reverse(matrix_get_row(row)); + print("\n"); + } +} From 73ab537bfc47263a11c5162bd5087203ef346a88 Mon Sep 17 00:00:00 2001 From: tmk Date: Fri, 3 Jan 2014 08:05:19 +0900 Subject: [PATCH 06/48] Add TRS-80 model 100 instruction --- converter/ascii_usb/README | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/converter/ascii_usb/README b/converter/ascii_usb/README index afd2e47f..b9c7ef25 100644 --- a/converter/ascii_usb/README +++ b/converter/ascii_usb/README @@ -28,6 +28,11 @@ Limitation -Scan code ---------- -ASCII code(0x01-7F) +TRS-80 model 100 +---------------- +Use TELCOM program with setting: 19200bps/8bit/odd parity/1stop bit +To set this configuration push Stat(F3) and input '9801D,10'. Then push Term(F4) to connect. + + + + From 22bd315b6459ea1cc0d1af456d55fb4970f36c6d Mon Sep 17 00:00:00 2001 From: Thomas Russell Murphy Date: Thu, 2 Jan 2014 18:37:20 -0500 Subject: [PATCH 07/48] Spellcheck of README.md --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index bca1c136..b76b7fb9 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,7 @@ You can find some keyboard specific projects under `converter` and `keyboard` di ### converter * [ps2_usb](converter/ps2_usb/) - [PS/2 keyboard to USB][GH_ps2] * [adb_usb](converter/adb_usb/) - [ADB keyboard to USB][GH_adb] -* [m0110_usb](converter/m0110_usb) - [Machintosh 128K/512K/Plus keyboard to USB][GH_m0110] +* [m0110_usb](converter/m0110_usb) - [Macintosh 128K/512K/Plus keyboard to USB][GH_m0110] * [terminal_usb](converter/terminal_usb/) - [IBM Model M terminal keyboard(PS/2 scancode set3) to USB][GH_terminal] * [news_usb](converter/news_usb/) - [Sony NEWS keyboard to USB][GH_news] * [x68k_usb](converter/x68k_usb/) - [Sharp X68000 keyboard to USB][GH_x68k] @@ -91,7 +91,7 @@ See [doc/keymap.md](doc/keymap.md). -Magic Comannds +Magic Commands -------------- To see help press `Magic` + `H`. @@ -122,7 +122,7 @@ Following commands can be also executed with `Magic` + key. In console mode `Mag **TBD** ### Boot Magic Configuration - Virtual DIP Switch -Boot Magic are executed during boot up time. Press Magic key below then pulgin keyboard cable. +Boot Magic are executed during boot up time. Press Magic key below then plug in keyboard cable. Note that you must use keys of **Layer 0** as Magic keys. These settings are stored in EEPROM so that retain your configure over power cycles. To avoid configuring accidentally additive salt key `KC_SPACE` also needs to be pressed along with the following configuration keys. The salt key is configurable in `config.h`. See [common/bootmagic.h](common/bootmagic.h). @@ -142,7 +142,7 @@ To avoid configuring accidentally additive salt key `KC_SPACE` also needs to be #### Keymap - Swap Control and CapsLock(`Left Control`) -- Change CapsLock to Control(`Casp Lock`) +- Change CapsLock to Control(`Caps Lock`) - Swap LeftAlt and Gui(`Left Alt`) - Swap RightAlt and Gui(`Right Alt`) - Disable Gui(`Left Gui`) @@ -211,7 +211,7 @@ Architecture -Debuging +Debugging -------- Use PJRC's `hid_listen` to see debug messages. You can use the tool for debug even if firmware use LUFA stack. @@ -228,7 +228,7 @@ Files and Directories * converter/ - protocol converter projects * doc/ - documents * common.mk - Makefile for common -* protoco.mk - Makefile for protocol +* protocol.mk - Makefile for protocol * rules.mk - Makefile for build rules ### Common @@ -264,7 +264,7 @@ Files and Directories -Conding Style +Coding Style ------------- - Doesn't use Tab to indent, use 4-spaces instead. From e0a95d4075b972ef5d623aa125e009c28e0edaf8 Mon Sep 17 00:00:00 2001 From: Thomas Russell Murphy Date: Thu, 2 Jan 2014 19:05:52 -0500 Subject: [PATCH 08/48] Spellchecked documentation. --- doc/USB_NKRO.txt | 14 +++++++------- doc/build.md | 10 +++++----- doc/keymap.md | 36 ++++++++++++++++++------------------ doc/other_projects.md | 2 +- 4 files changed, 31 insertions(+), 31 deletions(-) diff --git a/doc/USB_NKRO.txt b/doc/USB_NKRO.txt index 4751bca8..d9f1d122 100644 --- a/doc/USB_NKRO.txt +++ b/doc/USB_NKRO.txt @@ -14,7 +14,7 @@ dfj's NKRO(2010/06) http://geekhack.org/showthread.php?p=204389#post204389 -Terminogy +Terminology --------- NKRO ghost @@ -26,7 +26,7 @@ membrane OS Support Status ----------------- USB NKRO is possible *without* a custom driver. -At least following OSes supports. +At least following OS's supports. Windows7 64bit WindowsXP Windows2000 SP4 @@ -37,7 +37,7 @@ At least following OSes supports. Custom Driver for USB NKRO -------------------------- NOT NEEDED -at least when using fllowing report formats on Windows, Linux or MacOSX. +at least when using following report formats on Windows, Linux or MacOSX. USB NKRO methods @@ -47,8 +47,8 @@ USB NKRO methods If the keyboard has 2 virtual keyboard with Standard report(6KRO), it gets 12KRO. Using this method means the keyboard is a composite device. -2. Exteded report - It needs large report size for this method to achive NKRO. +2. Extended report + It needs large report size for this method to achieve NKRO. If a keyboard has 101keys, it needs 103byte report. It seems to be inefficient. 3. Bitmap report @@ -122,8 +122,8 @@ Considerations Compatibility boot protocol minor/old system - Some BIOS doesn't send SET_PROTCOL request, a keyboard can't switch to boot protocol mode. - This may cuase a problem on a keyboard which uses other report than Standard. + Some BIOS doesn't send SET_PROTOCOL request, a keyboard can't switch to boot protocol mode. + This may cause a problem on a keyboard which uses other report than Standard. Reactivity USB polling time OS/Driver processing time diff --git a/doc/build.md b/doc/build.md index 2e8157e0..bfe5de9f 100644 --- a/doc/build.md +++ b/doc/build.md @@ -71,14 +71,14 @@ Or to program with `dfu-programmer` run: #### FLIP GUI tutorial 1. On menu bar click Device -> Select, then. `ATmega32u4`. 2. On menu bar click Settings -> Communication -> USB, then click 'Open' button on 'USB Port Connection' dialog. -At this point you'll see greyouted widgets on the app get colored and ready. +At this point you'll see grey-outed widgets on the app get colored and ready. 3. On menu bar click File -> Load HEX File, then select your firmware hex file on File Selector dialog. 4. On 'Operations Flow' panel click 'Run' button to load the firmware binary to the chip. Note that you should keep 'Erase', 'Blank Check', 'Program' and 'Verify' check boxes selected. 5. Re-plug USB cord or click 'Start Application' button to restart your controller. Done. -See also these instaructions if you need. +See also these instructions if you need. - - @@ -95,7 +95,7 @@ Or use this command if you have command line version of Teensy Loader installed. ### 4. Program with Other programmer -You may want to use other programmer like `avrdude` with AVRISPmkII, Aruduino or USBasp. In that case you can still use make target `program` for build with configuring `PROGRAM_CMD` in Makefile. +You may want to use other programmer like `avrdude` with AVRISPmkII, Arduino or USBasp. In that case you can still use make target `program` for build with configuring `PROGRAM_CMD` in Makefile. $ make -f Makefile. program @@ -135,7 +135,7 @@ Optional. Note that ***comment out*** to disable them. #BACKLIGHT_ENABLE = yes # Enable keyboard backlight functionality ### 3. Programmer -Optional. Set proper command for your controller, bootloader and programmer. This command can be used with `make program`. Not needed if you use `FLIP`, `dfu-programmer` or `Teesy Loader`. +Optional. Set proper command for your controller, bootloader and programmer. This command can be used with `make program`. Not needed if you use `FLIP`, `dfu-programmer` or `Teensy Loader`. # avrdude with AVRISPmkII PROGRAM_CMD = avrdude -p $(MCU) -c avrispmkII -P USB -U flash:w:$(TARGET).hex @@ -158,7 +158,7 @@ Config.h Options /* Mechanical locking CapsLock support. Use KC_LCAP instead of KC_CAPS in keymap */ #define CAPSLOCK_LOCKING_ENABLE - /* Locking CapsLock resynchronize hack */ + /* Locking CapsLock re-synchronize hack */ #define CAPSLOCK_LOCKING_RESYNC_ENABLE ### 3. Disable Debug and Print diff --git a/doc/keymap.md b/doc/keymap.md index 3a549de6..7ef7430c 100644 --- a/doc/keymap.md +++ b/doc/keymap.md @@ -68,7 +68,7 @@ On the other hand, you shall change `layer_state` to overlay base layer with som Note that ***higher layer has higher priority on stack of layers***, namely firmware falls down from top layer to bottom to look up keycode. Once it spots keycode other than **`KC_TRNS`**(transparent) on a layer it stops searching and lower layers aren't referred. You can place `KC_TRNS` on overlay layer changes just part of layout to fall back on lower or base layer. -Key with `KC_TRANS` doen't has its own keycode and refers to lower valid layers for keycode, instead. +Key with `KC_TRANS` doesn't has its own keycode and refers to lower valid layers for keycode, instead. See example below. @@ -155,12 +155,12 @@ You can find other keymap definitions in file `keymap.c` located on project dire ## 1. Keycode -See [`common/keycode.h`](../common/keycode.h) or keycode table below for the detail. Keycode is internal **8bit code** to inidicate action performed on key in keymap. Keycode has `KC_` prefixed symbol respectively. Most of keycodes like `KC_A` have simple action registers key to host on press and unregister on release, while some of other keycodes has some special actions like `Fn` keys, Media contorl keys, System control keys and Mousekeys. +See [`common/keycode.h`](../common/keycode.h) or keycode table below for the detail. Keycode is internal **8bit code** to indicate action performed on key in keymap. Keycode has `KC_` prefixed symbol respectively. Most of keycodes like `KC_A` have simple action registers key to host on press and unregister on release, while some of other keycodes has some special actions like `Fn` keys, Media control keys, System control keys and Mousekeys. ***In `KEYMAP()` macro you should omit prefix part `KC_` of keycode to keep keymap compact.*** For example, just use `A` instead you place `KC_A` in `KEYMAP()`. Some keycodes has 4-letter **short name** in addition to descriptive name, you'll prefer short one in `KEYMAP()`. ### 1.0 Other key -- `KC_NO` for no aciton +- `KC_NO` for no action - `KC_TRNS` for layer transparency (See above) ### 1.1 Normal key @@ -192,7 +192,7 @@ There are 8 modifiers which has discrimination between left and right. - `KC_WSCH`, `KC_WHOM`, `KC_WBAK`, `KC_WFWD`, `KC_WSTP`, `KC_WREF`, `KC_WFAV` for web browser operation ### 1.5 Fn key -`KC_FNnn` are keycodes for `Fn` key which not given any actions at the beginning unlike most of keycodes has its own inborn action. To use these keycodes in `KEYMAP()` you need to assign action you want at first. Action of `Fn` key is defined in `fn_actions[]` and its index of the array is identical with number part of `KC_FNnn`. Thus `KC_FN0` keyocde indicates the action defined in first element of the array. ***32 `Fn` keys can be defined at most.*** +`KC_FNnn` are keycodes for `Fn` key which not given any actions at the beginning unlike most of keycodes has its own inborn action. To use these keycodes in `KEYMAP()` you need to assign action you want at first. Action of `Fn` key is defined in `fn_actions[]` and its index of the array is identical with number part of `KC_FNnn`. Thus `KC_FN0` keycode indicates the action defined in first element of the array. ***32 `Fn` keys can be defined at most.*** ### 1.6 Keycode Table See keycode table in [`doc/keycode.txt`](./keycode.txt) for description of keycodes. @@ -205,7 +205,7 @@ There are 8 modifiers which has discrimination between left and right. ## 2. Action See [`common/action_code.h`](../common/action_code.h). Action is a **16bit code** and defines function to perform on events of a key like press, release, holding and tapping. -Most of keys just register 8bit scancode to host, but to support other complex features needs 16bit extended action codes internally. However, using 16bit action codes in keymap results in double size in memory compared to using jsut keycodes. To avoid this waste 8bit keycodes are used in `KEYMAP()` instead of action codes. +Most of keys just register 8bit scancode to host, but to support other complex features needs 16bit extended action codes internally. However, using 16bit action codes in keymap results in double size in memory compared to using just keycodes. To avoid this waste 8bit keycodes are used in `KEYMAP()` instead of action codes. ***You can just use keycodes of `Normal key`, `Modifier`, `Mousekey` and `System & Media key` in keymap*** to indicate corresponding actions instead of using action codes. While ***to use other special actions you should use keycode of `Fn` key defined in `fn_actions[]`.*** @@ -230,7 +230,7 @@ You can define these actions on *'A'* key and *'left shift'* modifier with: #### 2.1.2 Modified key This action is comprised of strokes of modifiers and a key. `Macro` action is needed if you want more complex key strokes. -Say you want to assign a key to `Shift + 1` to get charactor *'!'* or `Alt + Tab` to switch application windows. +Say you want to assign a key to `Shift + 1` to get character *'!'* or `Alt + Tab` to switch application windows. ACTION_MODS_KEY(MOD_LSFT, KC_1) ACTION_MODS_KEY(MOD_LALT, KC_TAB) @@ -272,7 +272,7 @@ This sets Default Layer to given parameter `layer` and activate it. ACTION_DEFAULT_LAYER(layer) -#### 2.2.2 Momentary Switch +#### 2.2.2 Momentary Turns on `layer` momentarily while holding, in other words it activates when key is pressed and deactivate when released. ACTION_LAYER_MOMENTARY(layer) @@ -342,7 +342,7 @@ Turns on layer only and clear all layer on release.. ACTION_LAYER_BIT_XOR(part, bits, on) ACTION_LAYER_BIT_SET(part, bits, on) -These actions works with prameters as following code. +These actions works with parameters as following code. uint8_t shift = part*4; uint32_t mask = (bits&0x10) ? ~(0xf< ## kbdbabel.org[converter][vintage][protocol][8051] -Great resourse of vintage keyboard protocol information and code +Great resource of vintage keyboard protocol information and code - From f7bb7c4fa99e6bfae311bd6674b6a2bd8537ea73 Mon Sep 17 00:00:00 2001 From: Benjamin Gould Date: Mon, 6 Jan 2014 14:43:59 -0500 Subject: [PATCH 09/48] Added NeXT keyboard converter --- converter/next_usb/Makefile | 63 +++++++ converter/next_usb/README | 45 +++++ converter/next_usb/config.h | 150 ++++++++++++++++ converter/next_usb/keymap.c | 177 ++++++++++++++++++ converter/next_usb/led.c | 55 ++++++ converter/next_usb/matrix.c | 269 ++++++++++++++++++++++++++++ converter/next_usb/next_timings.jpg | Bin 0 -> 407936 bytes protocol/next_kbd.c | 204 +++++++++++++++++++++ protocol/next_kbd.h | 63 +++++++ 9 files changed, 1026 insertions(+) create mode 100644 converter/next_usb/Makefile create mode 100644 converter/next_usb/README create mode 100644 converter/next_usb/config.h create mode 100644 converter/next_usb/keymap.c create mode 100644 converter/next_usb/led.c create mode 100644 converter/next_usb/matrix.c create mode 100644 converter/next_usb/next_timings.jpg create mode 100644 protocol/next_kbd.c create mode 100644 protocol/next_kbd.h diff --git a/converter/next_usb/Makefile b/converter/next_usb/Makefile new file mode 100644 index 00000000..51d9de6b --- /dev/null +++ b/converter/next_usb/Makefile @@ -0,0 +1,63 @@ +# Target file name (without extension). +TARGET = next_usb + +# Directory common source filess exist +TOP_DIR = ../.. + +# Directory keyboard dependent files exist +TARGET_DIR = . + +# keyboard dependent files +SRC = keymap.c \ + matrix.c \ + led.c + +CONFIG_H = config.h + +# MCU name, you MUST set this to match the board you are using +# type "make clean" after changing this, so all files will be rebuilt +#MCU = at90usb162 # Teensy 1.0 +MCU = atmega32u4 # Teensy 2.0 +#MCU = at90usb646 # Teensy++ 1.0 +#MCU = at90usb1286 # Teensy++ 2.0 + + +# Processor frequency. +# Normally the first thing your program should do is set the clock prescaler, +# so your program will run at the correct speed. You should also set this +# variable to same clock speed. The _delay_ms() macro uses this, and many +# examples use this variable to calculate timings. Do not add a "UL" here. +F_CPU = 16000000 + + +# Boot Section Size in *bytes* +# Teensy halfKay 512 +# Teensy++ halfKay 1024 +# Atmel DFU loader 4096 +# LUFA bootloader 4096 +# USBaspLoader 2048 +OPT_DEFS += -DBOOTLOADER_SIZE=4096 + + +# Build Options +# *Comment out* to disable the options. +# +#BOOTMAGIC_ENABLE = yes # Virtual DIP switch configuration(+1000) +MOUSEKEY_ENABLE = yes # Mouse keys +EXTRAKEY_ENABLE = yes # Audio control and System control +CONSOLE_ENABLE = yes # Console for debug(+400) +COMMAND_ENABLE = yes # Commands for debug and configuration +#NKRO_ENABLE = yes # USB Nkey Rollover + +SRC += next_kbd.c + + +# Search Path +VPATH += $(TARGET_DIR) +VPATH += $(TOP_DIR) + + +include $(TOP_DIR)/protocol.mk +include $(TOP_DIR)/protocol/pjrc.mk +include $(TOP_DIR)/common.mk +include $(TOP_DIR)/rules.mk diff --git a/converter/next_usb/README b/converter/next_usb/README new file mode 100644 index 00000000..07ac89de --- /dev/null +++ b/converter/next_usb/README @@ -0,0 +1,45 @@ +NeXT non-ADB Keyboard Converter +------------------------------- + +Cable connector inside keyboard case: ++-----+ +|Black|\ +|Green|-\ +|Yello|--\-------- to computer via Mini-Din 5a Connector +|Orang|--/-------- +|Red |-/ +|Brown|/ ++-----+ + +Black - Ground to outer metal part of Mini Din 5a connector (not used) +Green - Ground +Yellow - Power button signal +Orange - Keyboard Out +Red - Keyboard In +Brown - Vcc + +ATmega32u4 connections (pinout provided for Arduino Pro Micro): + +Keyboard out (orange) : PD0 (pin 3) +Keyboard in (red) : PD1 (pin 2) +Power Button (yellow) : PD4 (pin 4) +Ground (black) : GND +Vcc (brown) : VCC + +See attached next_timings.jpg file for a detailed illustration of NeXT keyboard protocol timings. + +Power button signal line is normally high when the keyboard is powered/initialized. It is pulled to ground when pressed. The converter automatically translates this to a "normal" keypress with code 0x5A. This connection is technically optional, the only side effect of not making this connection is the power key will do nothing. + +Converter is based heavily on Ladyada's original "USB NeXT Keyboard with Arduino Micro" tutorial (http://learn.adafruit.com/usb-next-keyboard-with-arduino-micro/overview). If you build this converter, show Adafruit some love and do it using an Arduino Micro (http://www.adafruit.com/products/1315) or their ATmega 32u4 Breakout Board (http://www.adafruit.com/products/296). Arduino Micro should work fine using the Arduino Pro Micro configuration above, same pins numbers and everything. + +TODO: +----- + +I believe it might be possible to run the keyboard off of 3V; during testing I observed that the keyboard could sometimes function even without Vcc connected as long as the ground connection was good and the Keyboard In line was connected. If that works it should be easy to do a Bluetooth conversion and run the keyboard right off of a LiPo battery without a boost circuit + +Utilize second LED as status indicator for good initialization; also try to make hot plugging much more robust. + +Figure a better use for the Power button. Too easy to hit it by mistake to use for Suspend or Power Off - maybe move cap to different part of the board and consider that + +Figure out a better use for the lock LEDs. Right now they just light up when you press shift. Lame. Maybe implement proper Caps/Num/Scroll Locks + diff --git a/converter/next_usb/config.h b/converter/next_usb/config.h new file mode 100644 index 00000000..b3d188b0 --- /dev/null +++ b/converter/next_usb/config.h @@ -0,0 +1,150 @@ +/* +NeXT non-ADB Keyboard USB Converter + +Copyright 2013, Benjamin Gould (bgould@github.com) + +Based on: +TMK firmware code Copyright 2011,2012 Jun WAKO +Arduino code by "Ladyada" Limor Fried (http://ladyada.net/, http://adafruit.com/), released under BSD license + +Timing reference thanks to http://m0115.web.fc2.com/ (dead link), http://cfile7.uf.tistory.com/image/14448E464F410BF22380BB +Pinouts thanks to http://www.68k.org/~degs/nextkeyboard.html +Keycodes from http://ftp.netbsd.org/pub/NetBSD/NetBSD-release-6/src/sys/arch/next68k/dev/ + +This software is licensed with a Modified BSD License. +All of this is supposed to be Free Software, Open Source, DFSG-free, +GPL-compatible, and OK to use in both free and proprietary applications. +Additions and corrections to this file are welcome. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + +* Neither the name of the copyright holders nor the names of + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. + +*/ + +#define VENDOR_ID 0xBCBC +#define PRODUCT_ID 0xBCBC +#define DEVICE_VER 0x0500 +#define MANUFACTURER t.m.k. +#define PRODUCT NeXT Keyboard to USB converter +#define DESCRIPTION USB converter for NeXT non-ADB Keyboard + +/* matrix size */ +#define MATRIX_ROWS 12 // keycode bit: 3-0 +#define MATRIX_COLS 8 // keycode bit: 6-4 + +//#define DEBUG_ON_INIT 1 + +//#define TEENSY_CONFIG 1 +#define PRO_MICRO_CONFIG 1 + +// comment out if you don't want the keyboard's LEDs to flash upon initialization +#define NEXT_KBD_INIT_FLASH_LEDS + +//============= Start of Arduino Pro Micro Configuration ============== +#ifdef PRO_MICRO_CONFIG + +// this is the debugging LED that flashes when a key is being pressed +// comment out in order to disable debugging LED +#define NEXT_KBD_LED1_PORT PORTD +#define NEXT_KBD_LED1_PIN PIND +#define NEXT_KBD_LED1_DDR DDRD +#define NEXT_KBD_LED1_BIT 5 + +#define NEXT_KBD_LED1_ON NEXT_KBD_LED1_PORT &= ~(1<mods == (MOD_BIT(KC_LSHIFT) | MOD_BIT(KC_RSHIFT)))|| \ + (keyboard_report->mods == (MOD_BIT(KC_RALT) | MOD_BIT(KC_RCTL))) \ +) diff --git a/converter/next_usb/keymap.c b/converter/next_usb/keymap.c new file mode 100644 index 00000000..d844f8a4 --- /dev/null +++ b/converter/next_usb/keymap.c @@ -0,0 +1,177 @@ +/* +NeXT non-ADB Keyboard USB Converter + +Copyright 2013, Benjamin Gould (bgould@github.com) + +Based on: +--------- +* TMK firmware code Copyright 2011,2012 Jun WAKO +* Arduino code by "Ladyada" Limor Fried (http://ladyada.net/, http://adafruit.com/) \ + released under BSD license \ + https://github.com/adafruit/USB-NeXT-Keyboard + +Timing reference thanks to http://m0115.web.fc2.com/ (dead link), http://cfile7.uf.tistory.com/image/14448E464F410BF22380BB +Pinouts thanks to http://www.68k.org/~degs/nextkeyboard.html +Keycodes from http://ftp.netbsd.org/pub/NetBSD/NetBSD-release-6/src/sys/arch/next68k/dev/ + +This software is licensed with a Modified BSD License. +All of this is supposed to be Free Software, Open Source, DFSG-free, +GPL-compatible, and OK to use in both free and proprietary applications. +Additions and corrections to this file are welcome. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + +* Neither the name of the copyright holders nor the names of + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. + +*/ + +#include +#include +#include +#include "keycode.h" +#include "print.h" +#include "debug.h" +#include "util.h" +#include "keymap.h" +#include "keycode.h" + +// 32*8(256) byte array which converts PS/2 code into USB code +static const uint16_t PROGMEM fn_actions[] = { + ACTION_LAYER_MOMENTARY(1), // FN0 - left command key + ACTION_LAYER_MOMENTARY(1), // FN1 - right command key + ACTION_KEY(KC_BSLS), // FN2 - number pad slash & backslash + ACTION_MODS_KEY(MOD_LSFT, KC_BSLS), // FN3 - number pad equals & pipe + ACTION_MODS_KEY(MOD_LCTL, KC_Z), // FN4 - cmd+undo on layer 1 + ACTION_MODS_KEY(MOD_LCTL, KC_X), // FN5 - cmd+cut on layer 1 + ACTION_MODS_KEY(MOD_LCTL, KC_C), // FN6 - cmd+copy on layer 1 + ACTION_MODS_KEY(MOD_LCTL, KC_V), // FN7 - cmd+paste on layer 1 +}; + +/* This is the physical layout that I am starting with: + * Note: there is some strangeness on the number pad; + * the equal sign shifts to pipe and forward slash shifts to backslash + * ,-----------------------------------------------------------. ,-----------. ,---------------. + * |Esc| 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =| BS | |VUp|Pwr|BrU| |` | =| /| *| + * |-----------------------------------------------------------| |-----------| |---------------| + * |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| | |VDn| |BrD| | 7| 8| 9| -| + * |------------------------------------------------------ | `---' `---' |-----------|---| + * |Ctrl | A| S| D| F| G| H| J| K| L| ;| '| Return| | 4| 5| 6| +| + * |-----------------------------------------------------------| ,---. |---------------| + * |Shift | Z| X| C| V| B| N| M| ,| .| /|Shift | |Up | | 1| 2| 3| | + * |-----------------------------------------------------------| ,-----------. |-----------|Ent| + * |Alt |Cmd | Space |Cmd |Alt | |Lef|Dow|Rig| | 0| .| | + * `-----------------------------------------------------------' `-----------' `---------------' + * + * Keymap array: + * 8 bytes + * +---------+ + * 0| | + * :| | 0x00-0x87 + * ;| | + * 11| | + * +---------+ + */ +#define KEYMAP( \ + K49,K4A,K4B,K4C,K4D,K50,K4F,K4E,K1E,K1F,K20,K1D,K1C,K1B, K1A,K58,K19, K26,K27,K28,K25, \ + K41,K42,K43,K44,K45,K48,K47,K46,K06,K07,K08,K05,K04,K03, K02, K01, K21,K22,K23,K24, \ + K57,K39,K3A,K3B,K3C,K3D,K40,K3F,K3E,K2D,K2C,K2B, K2A, K12,K18,K13,K15, \ + K56, K31,K32,K33,K34,K35,K37,K36,K2E,K2F,K30, K55, K16, K11,K17,K14, \ + K52,K54, K38, K53,K51, K09,K0F,K10, K0B, K0C,K0D \ +) { \ + { KC_NO, KC_##K01, KC_##K02, KC_##K03, KC_##K04, KC_##K05, KC_##K06, KC_##K07 }, \ + { KC_##K08, KC_##K09, KC_##K10, KC_##K0B, KC_##K0C, KC_##K0D, KC_NO, KC_##K0F }, \ + { KC_##K10, KC_##K11, KC_##K12, KC_##K13, KC_##K14, KC_##K15, KC_##K16, KC_##K17 }, \ + { KC_##K18, KC_##K19, KC_##K1A, KC_##K1B, KC_##K1C, KC_##K1D, KC_##K1E, KC_##K1F }, \ + { KC_##K20, KC_##K21, KC_##K22, KC_##K23, KC_##K24, KC_##K25, KC_##K26, KC_##K27 }, \ + { KC_##K28, KC_NO, KC_##K2A, KC_##K2B, KC_##K2C, KC_##K2D, KC_##K2E, KC_##K2F }, \ + { KC_##K30, KC_##K31, KC_##K32, KC_##K33, KC_##K34, KC_##K35, KC_##K36, KC_##K37 }, \ + { KC_##K38, KC_##K39, KC_##K3A, KC_##K3B, KC_##K3C, KC_##K3D, KC_##K3E, KC_##K3F }, \ + { KC_##K40, KC_##K41, KC_##K42, KC_##K43, KC_##K44, KC_##K45, KC_##K46, KC_##K47 }, \ + { KC_##K48, KC_##K49, KC_##K4A, KC_##K4B, KC_##K4C, KC_##K4D, KC_##K4E, KC_##K4F }, \ + { KC_##K50, KC_##K51, KC_##K52, KC_##K53, KC_##K54, KC_##K55, KC_##K56, KC_##K57 }, \ + { KC_##K58, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, }, \ +} + + +static const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { + + /* Layer 0: default + * ,-----------------------------------------------------------. ,-----------. ,---------------. + * |Esc| 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =| BS | |Ins|Ref|Hom| |` | =| /| *| + * |-----------------------------------------------------------| |-----------| |---------------| + * |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| | |Del| |End| | 7| 8| 9| -| + * |-----------------------------------------------------' | `---' `---' |-----------|---| + * |Ctrl | A| S| D| F| G| H| J| K| L| ;| '| Return| | 4| 5| 6| +| + * |-----------------------------------------------------------| ,---. |---------------| + * |Shift | Z| X| C| V| B| N| M| ,| .| /|Shift | |Up | | 1| 2| 3| | + * |-----------------------------------------------------------| ,-----------. |-----------|Ent| + * |Fn0 |Alt | Space |LGui |Fn1 | |Lef|Dow|Rig| | 0| .| | + * `-----------------------------------------------------------' `-----------' `---------------' + */ + KEYMAP( + ESC, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSPC, INS, WREF,HOME, GRV, FN3, FN2, PAST, + TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,NO, DEL, END, P7, P8, P9, PMNS, + LCTL,A, S, D, F, G, H, J, K, L, SCLN,QUOT, ENT, P4, P5, P6, PPLS, + LSFT, Z, X, C, V, B, N, M, COMM,DOT, SLSH, RSFT, UP, P1, P2, P3, + FN0, LALT, SPC, LGUI,FN1, LEFT,DOWN,RGHT, P0, PDOT,PENT + + ), + + /* Layer 1: extra keys + * ,-----------------------------------------------------------. ,-----------. ,---------------. + * |Grv| F1| F2| F3| F4| F5| F6| F7| F8| F9|F10|F11|F12| BS | |VUp|VMu|PgU| |` | =| /| *| + * |-----------------------------------------------------------| |-----------| |---------------| + * |Tab |Pau| W| E| R| T| Y| U| I| O|PSc| \| ]| | |VDn| |PgD| | 7| 8| 9| -| + * |-----------------------------------------------------' | `---' `---' |-----------|---| + * |Ctrl | A| S| D| F| G| H| J| K| L| ;| '| Return| | 4| 5| 6| +| + * |-----------------------------------------------------------| ,---. |---------------| + * |Shift |UND|CUT|COP|PST| B| N| M| ,| .| /|Shift | |Up | | 1| 2| 3| | + * |-----------------------------------------------------------| ,-----------. |-----------|Ent| + * |Fn0 |Alt | Space |RGui |Fn1 | |Lef|Dow|Rig| | 0| .| | + * `-----------------------------------------------------------' `-----------' `---------------' + */ + KEYMAP( + + GRV, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, TRNS, VOLU,MUTE,PGUP, TRNS,TRNS,TRNS,TRNS, + TRNS,PAUS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,PSCR,FN3, BSLS,TRNS, VOLD, PGDN, BTN1,MS_U,BTN2,WH_U, + TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, MS_L,MS_D,MS_R,WH_D, + TRNS, FN4, FN5, FN6, FN7, TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS,TRNS,TRNS, + TRNS,RALT, TRNS, RGUI,TRNS, TRNS,TRNS,TRNS, TRNS, TRNS,TRNS + + ) +}; + +/* translates key to keycode */ +uint8_t keymap_key_to_keycode(uint8_t layer, key_t key) +{ + return pgm_read_byte(&keymaps[(layer)][(key.row)][(key.col)]); +} + +/* translates Fn keycode to action */ +action_t keymap_fn_to_action(uint8_t keycode) +{ + return (action_t){ .code = pgm_read_word(&fn_actions[FN_INDEX(keycode)]) }; +} diff --git a/converter/next_usb/led.c b/converter/next_usb/led.c new file mode 100644 index 00000000..24db15e1 --- /dev/null +++ b/converter/next_usb/led.c @@ -0,0 +1,55 @@ +/* +NeXT non-ADB Keyboard USB Converter + +Copyright 2013, Benjamin Gould (bgould@github.com) + +Based on: +TMK firmware code Copyright 2011,2012 Jun WAKO +Arduino code by "Ladyada" Limor Fried (http://ladyada.net/, http://adafruit.com/), released under BSD license + +Timing reference thanks to http://m0115.web.fc2.com/ (dead link), http://cfile7.uf.tistory.com/image/14448E464F410BF22380BB +Pinouts thanks to http://www.68k.org/~degs/nextkeyboard.html +Keycodes from http://ftp.netbsd.org/pub/NetBSD/NetBSD-release-6/src/sys/arch/next68k/dev/ + +This software is licensed with a Modified BSD License. +All of this is supposed to be Free Software, Open Source, DFSG-free, +GPL-compatible, and OK to use in both free and proprietary applications. +Additions and corrections to this file are welcome. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + +* Neither the name of the copyright holders nor the names of + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. + +*/ + +#include "stdint.h" +#include "led.h" + + +void led_set(uint8_t usb_led) +{ + +} diff --git a/converter/next_usb/matrix.c b/converter/next_usb/matrix.c new file mode 100644 index 00000000..fd6eb9d6 --- /dev/null +++ b/converter/next_usb/matrix.c @@ -0,0 +1,269 @@ +/* +NeXT non-ADB Keyboard USB Converter + +Copyright 2013, Benjamin Gould (bgould@github.com) + +Based on: +TMK firmware code Copyright 2011,2012 Jun WAKO +Arduino code by "Ladyada" Limor Fried (http://ladyada.net/, http://adafruit.com/), released under BSD license + +Timing reference thanks to http://m0115.web.fc2.com/ (dead link), http://cfile7.uf.tistory.com/image/14448E464F410BF22380BB +Pinouts thanks to http://www.68k.org/~degs/nextkeyboard.html +Keycodes from http://ftp.netbsd.org/pub/NetBSD/NetBSD-release-6/src/sys/arch/next68k/dev/ + +This software is licensed with a Modified BSD License. +All of this is supposed to be Free Software, Open Source, DFSG-free, +GPL-compatible, and OK to use in both free and proprietary applications. +Additions and corrections to this file are welcome. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + +* Neither the name of the copyright holders nor the names of + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. + +*/ + +#include +#include +#include +#include +#include "print.h" +#include "util.h" +#include "serial.h" +#include "matrix.h" +#include "debug.h" +#include "matrix.h" +#include "next_kbd.h" + +static void matrix_make(uint8_t code); +static void matrix_break(uint8_t code); + +static uint8_t matrix[MATRIX_ROWS]; +#define ROW(code) ((code>>3)&0xF) +#define COL(code) (code&0x07) + +static bool is_modified = false; + +/* number of matrix rows */ +inline +uint8_t matrix_rows(void) +{ + return MATRIX_ROWS; +} + +/* number of matrix columns */ +inline +uint8_t matrix_cols(void) +{ + return MATRIX_COLS; +} + +#ifndef NEXT_KBD_LED1_ON +#define NEXT_KBD_LED1_ON +#endif + +#ifndef NEXT_KBD_LED1_OFF +#define NEXT_KBD_LED1_OFF +#endif + +#define NEXT_KBD_PWR_READ (NEXT_KBD_PWR_PIN&(1<>1) +#define NEXT_KBD_PRESSED_KEYCODE(response) (uint8_t)(((response)&0xF00)==0x400) +#define NEXT_KBD_PRESSED(response, mask) (uint8_t)(((response)&mask)>0) +#define NEXT_KBD_PRESSED_CONTROL(response) NEXT_KBD_PRESSED(response,0x01000) +#define NEXT_KBD_PRESSED_SHIFT_LEFT(response) NEXT_KBD_PRESSED(response,0x02000) +#define NEXT_KBD_PRESSED_SHIFT_RGHT(response) NEXT_KBD_PRESSED(response,0x04000) +#define NEXT_KBD_PRESSED_CMD_LEFT(response) NEXT_KBD_PRESSED(response,0x08000) +#define NEXT_KBD_PRESSED_CMD_RGHT(response) NEXT_KBD_PRESSED(response,0x10000) +#define NEXT_KBD_PRESSED_ALT_LEFT(response) NEXT_KBD_PRESSED(response,0x20000) +#define NEXT_KBD_PRESSED_ALT_RGHT(response) NEXT_KBD_PRESSED(response,0x40000) +#define NEXT_KBD_MAKE_OR_BREAK(key, code) \ + do { \ + if (NEXT_KBD_PRESSED_##key(resp) > 0) \ + matrix_make(code); \ + else \ + matrix_break(code); \ + } while (0); + +#define NEXT_KBD_PWR_KEYCODE 0x58 + +/* scan all key states on matrix */ +uint8_t matrix_scan(void) +{ + _delay_ms(20); + + //next_kbd_set_leds(false, false); + NEXT_KBD_LED1_OFF; + + is_modified = false; + + if (!NEXT_KBD_PWR_READ) { + matrix_make(NEXT_KBD_PWR_KEYCODE); + power_state = 1; + if (is_modified) + { + dprintf("Power state 1\n"); + + } + } else { + matrix_break(NEXT_KBD_PWR_KEYCODE); + power_state = 0; + if (is_modified) + { + dprintf("Power state 0\n"); + + } + } + + uint32_t resp = (next_kbd_recv()); + + if (resp == NEXT_KBD_KMBUS_IDLE) + { + return 0; + } + + NEXT_KBD_LED1_ON; + + next_kbd_set_leds( + NEXT_KBD_PRESSED_SHIFT_LEFT(resp) ? true : false, + NEXT_KBD_PRESSED_SHIFT_RGHT(resp) ? true : false + ); + + dprintf("[ r=%04lX keycode=%02X pressed=%X CTRL=%X SHIFT_LEFT=%X SHIFT_RGHT=%X CMD_LEFT=%X CMD_RGHT=%X ALT_LEFT=%X ALT_RGHT=%X ]\n", \ + resp, \ + NEXT_KBD_KEYCODE(resp), \ + NEXT_KBD_PRESSED_KEYCODE(resp), \ + NEXT_KBD_PRESSED_CONTROL(resp), \ + NEXT_KBD_PRESSED_SHIFT_LEFT(resp), \ + NEXT_KBD_PRESSED_SHIFT_RGHT(resp), \ + NEXT_KBD_PRESSED_CMD_LEFT(resp), \ + NEXT_KBD_PRESSED_CMD_RGHT(resp), \ + NEXT_KBD_PRESSED_ALT_LEFT(resp), \ + NEXT_KBD_PRESSED_ALT_RGHT(resp) \ + ); + + // Modifier keys don't return keycode; have to check the upper bits + NEXT_KBD_MAKE_OR_BREAK(ALT_RGHT, 0x51); + NEXT_KBD_MAKE_OR_BREAK(ALT_LEFT, 0x52); + NEXT_KBD_MAKE_OR_BREAK(CMD_RGHT, 0x53); + NEXT_KBD_MAKE_OR_BREAK(CMD_LEFT, 0x54); + NEXT_KBD_MAKE_OR_BREAK(SHIFT_RGHT, 0x55); + NEXT_KBD_MAKE_OR_BREAK(SHIFT_LEFT, 0x56); + NEXT_KBD_MAKE_OR_BREAK(CONTROL, 0x57); + NEXT_KBD_MAKE_OR_BREAK(KEYCODE, NEXT_KBD_KEYCODE(resp)); + + return 1; +} + +/* whether modified from previous scan. used after matrix_scan. */ +bool matrix_is_modified() +{ + return is_modified; +} + +/* whether a switch is on */ +inline +bool matrix_is_on(uint8_t row, uint8_t col) +{ + return (matrix[row] & (1<DZLX}Pc=~4ux3xqCB zdhb0D%87eF&vV}WUhh}@bN(C_moUf5NYvyuM2|xwYyjAQ z`2g_WZ_oqq(C2QWZ7}*DfPMr03;*}%=D0!N27wy{ZV`hx`DLx3ihKouxbT3ri~-MS4$mVbzO5`J99A$4v-WPp`^FCw}Z2TrMnrkw}ZW-o47ad-d`^+jvoI$&3{iy z($(UnxVF6FzdXNqKuk=G|Dhnipdc^WgV)W+(cR3O*U^pj zUoRkU>1OU~H0Ram$UNehF z0=yQF9$7pV77!JDDe&UnzbEM6{GZGJk4T`ehhCDnoU5goyOXP~lasyFAGK$a{Qv#w zlKj6X{9hIz_4gSxCg{(d*3`}ZdFn=Gve`BE!Y+UT$2R<$? z4lV&cAt3=i0RiD{lG}v0h;I=P5RnlPlaP{>nQ2UjbzJxH{MXER1^qOfn2CGK}l*00#6|PqDEu(Eka>e-3OMTs#acd`trL z!vUlK^o7yW#=*TsLX3AClL7-13mbq#hD(meB0wRdg-?0U%!TTX;H$VSg1fA;+DR3y zgF~a#Y>y!N1}|LWlT#{(NA_sgg@omFboI=G6B66z?~BO0Wq;mRu&}gp_Xr6M%dPsh zD5_|fQ_ZR58J_ojf#b1q`%ABg1N7zT&=W&X?!Qj&_w~^eL_a7=2EfF`!2S&k1}-iD z5AB74Nrr_@&LSX#L!pJ97%r8d3+p3U?N?cM;?VQj!xPeZ;X1!B7k@noxQ&H@MgfZq z00JyK2N8K=Xx@ru&IQ-|NsD1Q8G;r`cA!xnt;jZOt-x6zS`g5?xE3sN>^rmKr1#px#UG8J9`blz-@T?*J*g-h>YBW zf=fD;$3RJT{;+F+^e*GTiI(j7h0>1JFCc6yJM0)4GhLz{-!`2b;VGe3res)lzLb{fq#~aniDdXbIlk)<30|_H`?69tTZjUa((H zn05$>jn3M^wh@8k*8qF?A}zpao@9z-@qYP$;$^{=AP?^a3(D-mVvJ^OwwkF!0U*3b zwxxuk3cZTh57_86#bEpntuWA7gHr#>#0d{XSlk{nGTc(y*OL2(C2hulR}Q7r3?#gayy7lUlG$Qvr(_ClK?76-a6{EzC0sTfm6iGF zpX!-Bz1qG8{Izy9S}d6F3^sjwrhZIL&6EV`JOAu%-{K-9_LzU%{S69*A?G12JAUe<@W@wd9V@ zcH>NpJ)Nx!qn<1LlR)9;{*)-toywMAAS_Dy*7_x=N3*$Q_#*GW3^9`Y1-37QW6CsY z_j$OH=2J*Jrl&Bc1x-v}bdaM4e*r^~1zA9y{eX_OUB=c6T}{jem>KFwY%k@?Yvvi@ zMnJ?a;;*21xC2_ke}lek5%}iH3#C~8Pcw+_l8h0(-p>YB#epLM-yz2Tv^DQKWkYRY z3)!#s^iVn%Ms#bi$$Vr%rax66`dN2^=+|~D2I?A)R`mnQptUAX|6xkw6`@H1eP^wt zg|a}?Pl&Pjvf@f0i$Q5S;lcuO*D5Cv9TKYW7CEH~(AJpY-xM)}BL=rLP(lEZEK@bA zBkW(Sz+00$Y4JwD5u;oB`})$B{co=U638-$J_4mNTOv027iD_RnQTx;xFj;$sP!x$ z#eTrp8W68`_fzQ6Utu6AMgP%~ZN|^pL}NFi2@mGP2ms{=ubD!Ru28bSiGpap2CQG6 z1ofQ9IL+!kzhFZXgzz5*fQbM^J?;2vRI2p?vi1)H!_;q=ka{m^3$(2XZ#oUTg#@Ds zQGfv@K+le*r~8r=rLmu6VEQ**DxvaH!xxsCm{57f!BaaTe<44uQ!+!1wU9}vZ8Lay z47w(9V!%rNDp9QYXF161%7HOIvI|`Z+3>~Sg_iU!BwygDsf%6;r~y4|&{PTkTs=xJ zpdIq`YV&VK1obr3qb$*shzW%{Tp_ZaJ-w{F+9*(J1JzsutTnMr4Y!r{;|#3ka(>1% zME3sE#Oj4+<^PnLD}kXw2es>&wIGJKn4BRRYqlp$3q?UaSA^Gq{wtoO6mgzOcwIx= zf3vah@;gu4vF2i|uO7KG!kA_$NrHhn$UX!B$%QUY9wB>5pZD!p=l&{O=mIs+o+;>y zjsbf5u*;$H|2+))mJZE71Cz8dPSS7wCQKmd2?B2%&9m44V!`>+g{ccAM^PYu-3&&^ zh@aGfwW-b)DDb}w(ZnSPY)6NI>iphi(Ustu+dThIv~oUq=@K4D8&G%+co{^4RJ#UzxX{&4ZmvBkyyCVS1`)Izf+8ai#>cKkLG5aQ z0NWN@_(E#@-qtnXo3Yn6TGtAFb4-oklf}qSxs4LnfM_)4Q!Up3-DAsws|`~`m7kQt zdcUvhVDHt6;x(YaTIcl!uxd7+SZF3E|D=-tQq_G977DCBZ7@D}4^)L;16Ecq)$)4>)ox0$UDtq+^QF^t*@NIVQ(%1vpC99H7a9npMA zi8wMnBHl+&(2|lL{ylJ+VR7QBhZBvIaO#syJaPC>ctbU?|)uW^cu_W_WQxA`% z3t=d_nsWo7?w}e_haUbVnbgSTpwcN?g8pMkn`M-u(AjHXw;AyIiks)bu~IdY3srb? z?N4;^2%^~2*oIDIL2+g$;X8b<5Le@usnmnBFRm6gRC0#XpPkfS&EU=RpY))sL%-!T zG!b3QW6DgolTOuS0JCjqwdhbY%ZNgu%Q?gtDR=S>*z?z6QJ~ zhas-`n+)ydSbxTx@DN;*ETBdJ|Ed>;ZgcR9-GzDseRS^fAklrp-?sFvwSfG~B8g^D zb1L-@dhdVh>+R?_$d-3A=D+L2*d}YX5AxpLQ1Yx7c4U-n-T zyVsH*xk1fL(xy=ruz}a6gl>E?FIX-mIhhEU&?V&4>xbg`KS7Z*c<}bqFs!105M(LB z_rla$_m7p;%|&Sp`X6P@y=ynmIvI1qX|)MNM}yODKGS#bs+}mn>UV#`dG{Y`N`~;m z+gHGwEAdS_rP9P0*qJ@oIN2O(sNXi7(K8#^Y58q(OHQA_cZ!1W{wf@{;ZmO`V;1kd z+Kbt4nao0$s2p@09{y8Gsgj!sfv-^oC6BwYqzF*KpMs!nplWm(v4sBJ-*lcnLQ9Gs zM1Kzgb-2*y#z>JOyevY!&3bk<+ai0;|GT76Ay9#r056jD<1RRBb|8PljBnT1)yv2C z%B2W@TR88TaHIy>(cz4-T7=-WYM=`WHHQmRl@ z-teF5D)%3CHTb)JFf5{D5=k-oyUIuZO%^~|{?EWm;=dZ3Q+=8LfBL$A4XColXc;8i z)<6mWtK+o%w;4zQT?zR9KgjC~Xk;p0t3JBru;m4~ zgYYGBnpMO4D?Gg9Oh)LclO5(yru4fbEyyy()(kS$Sf6X4p1lM$Bbs5uC+_?$=TQGl z!RDN)(@_Hu0cg0bvblw65kk_&G~9+xGPF$7{j1abhe1w=n)TLf3H__>3=7z8gn^MLWSO>2%+$%DH+v@ zrSOnN1-SZq`d422PfO|tP0)Sk81=tQcy<$-EQQRi>-(4c(n!`x(7Tzx1eeL^|4C#K zf#?R57r+P`ZbkPD`PTsV5>9%w;A&Qa@~`4EvHqj7=*X+KBzqsHVvp$_lJ%S>c&BA?(R7F?Veogow^|t0I?O&A6e3%o;KNP5C(gGBxP-#rvni`{Y(P#*- z!$N1zVC@P%Xk~eG#chqXsfW^oQjVlV!1l*xQC`=8jf{fvvEq~b-zqElTV;3u7FqLu zi>#te#WetT8>?-C61uZZ>#TxfupTly6l)_Luxm)Js9YnDH|9T6)RK}XG`UfRL#)$v&^hh2N4xa#=`D|}TDs5cN-Qi}yrTl_9op4Ib=vV^hx*KdenETr5WaX~ zW4$sZ{xa&v5vah=rX(rHl!ATTN}qR+u0B5SUW`JD2jS2^XUt&C4a73!lI-ffd$yUB zJL5>;(E0UY@=z1sue~{d-(wi95{cF`eYS2pJ(0wi65EA?Amlj&+9G$6uY_Q*F3-** zL-FO0wY2f@^e?BkSjNoo??oEf7?9{-CAS)s~mcWce+aAwT*siq2(ju%r$ z32Z}{+8Fa_UD(roW2mJ5RaEnAmws1e!2=y`U55MU~Ou_6FfsFx> z9{*eD2vL@e=lN8=Slin|O~%Q=z$`VBuT8+&2Q3JE=D1Ng8oaGAvrKJLN^$!EexpZ+ zSh}G=g+h88^?OS_A6ZjI$CRap!8y|&IR)D|t??o2q<6~Dnf>}jOPdCQn$-tPN(m5E zm%au(204#uQ%$%-TsHTLVrQzw4LLpiI0;u9#br)zkGQV-j`WoXwO?&Frftg^#|Da* zv}h^tFDM}%4?;P83BRt$)>zDNTRItMTSf9Z% zbe3?&S&6J~l2*sIM= zGzA9oDmZBFGOV^U1&ta~i6>O3+CNLv)>^Aigu8S;SX>k;%y(4VRUIGi;+D`R4IrBq zKfkhVxsYQL;5>3whzpix@Ub{WR29?5`z|7{0ik*tes!Qbte>9sXirTgCW;$F0*&5& zYf9p`b^Kfj5u=N2At}nb%IRcWuw&A2>P8T|Enk8f0x8Gz>f&O)pq$#cqn~t}PTW_7Y$5W#paTFv!nzq zL@z@7fKBL|!}sRC+r@+urnj`4($@QLTRn5&a@`fOdVkA36em^)y5{CGcQT41ppgin~`*CsApt)p4MOmt^5=j8WnsVDNFfGVh zU<;tQ&x1F_8rymeu-hAhP=a66NAFw%CiuTBQfZqwmIw$We;bNb^r;uHK?h_4Z16>B z)0#_PD7x8s{p@f9y+HNO0y6F#m5TxpzP@Te`u4Ds6A5N95o?ESy%)%8~7QhIVv-_{XHA_Jc;|4AU zWn?2EfDNjc*elw%ow}~FPh+bveNQ$9Vgjt|)Kv|A^6GMP$)bNAc6LGno2cj}!H999 z_~UmGE-~=k{n?lX9yW_QMVF*S(OvG&Uq$tADw+5sdvfEImmrm5+MldUDoJw-MVI39 zcwk4%2Jn$M(>api*>Hn(W^!MmnN_A|8(Eo(Ls`9?C;n_Bj6%f-O*R&lfxNwF9B=Jk zp5jSTuCMv%v*=zacXIy%6|k_o>#teVReJU)Z?!U+&CF>bdGNs@Hq!!Y(JfT6EKd)j0-P9*5(?_6S!Hm$ z6xX5ja(wI0OMP#$r>20Do;W8KInWL1-i(b20p(mI2%B544u20E-_y(nbP&7jdky=M zv#Z$4KNblGQp7&$NvX%NH#Xg7FzSh5&t0XeJhm2fa6nNM;fLjx-37JYw3->^h&wcnn%r)Pe>xu>~Xa#nLI{Gn+j*X%w04Wbud=ckJ1KE zoUwIsvoeUEe^~?UXgr8EfmfU$X>DV-YS@#P8dE-SAAx;I5=w=hS(X%jo9Nb5=GbuL zqVn+_b&nVX#X|%Meaxq}(6#7MFxAZd;SwH-V--24$%nyC44Mj!cbk;VGhaaViEc8o z${^^0&31-l*ssU@ywX^*gEL0`Wbmg0{1gL}I*Q+pC9CL>y_>(8JH1-5>mo;>9T?5toNrTQa^3{Ru0ge zMbmp6n;9%VAE&C-Rxz69tsBAEWCQdmrfNvNK((n*TJ=R&xe{g1pJT_K?Y1U(!iC_Y zO1s;W#}Tdm-oSQ?%W}*iNQR*XbQ?NrVC`W1JmeVWLW2s=>9DY57M&c+4f08GNtL}= zD|ojaXxF73y)-}Y-oHiId0;FXhCgHdaXtQINSh+fm7sfIO9#ox1sU?IIlUUoNv^+d zAKo}v-9QdxE1f3yw^>-xT}Y(BQG0OP)kQ%JSu}VYHF(8t5(U54&H~;hPo$4+yp0T7 z+=-;e+lct&_rxmY84{KKUfa>^?jZyv*Uhd9lzOD*N&!90W$Ph;?D>g|;7g*;#!Q>? zxF^AbB4yoi*i>AG^aBsh`|vw3W1i$5qBlRYPqtg!Z1<^WQni0KYgtwgFj;R$S=n}nkRFYQ61NKcU zo&-`w!|vv~;FB@B)H$-nt;HuDpU}#0j#~)jDTY>+a1_#y9>CU9C(cL6*E)<|rW+h& zf~nSyXJX=@;gwbCxr>dL=kGipzu`M+CC9AEFKkl*cv+2}+F9TXSeiI-os#PY02@1i zRt*JBu2Q7YA1>mh3I~`mRuA&`Xxm)1GcL?`YLP^b-w0xBFTRTk$$u%s=3f;w!x)Pn z`8_u6Tz(FHf5Nb|#V6|79bd?~`4uq&zf-+sB@jynJCkgHu_3DG$-34^$g1^`4<*vS zIxj?^2C?`^g5f>*TVz|5{^|Q`Kq7nyO{sFQD>?MjHK2{>mdffHY<)72?1{Xx16(x0 z#l^gp4XVC@sDF~z_{q48Y1i`m;?8-qZ^Wk7HGqpmmGg|Ph^Do5`5LedZ3vFn6{83_ zJSgDpSW9wnNug)xWvDv}Xk7EtRtTS@*lAS2zPMM<$_e7tI$zR9%DYzvs&wJG22k`e z{6b$IBc}=I*SsKw6gI9e;vJ~F)1*(s!5mt3uD+`;Y}K3qEXbc4C< ziI$QWq-rT!v#Nsh@$xYIJI}3t-OPknaWg3XQ#~aPh{8)bYul|J?S%OJ9j?yK5OrSL zFUEbleul<01Q6vXBe1k$A(Q5h=wwbRn|N75uA93Q@+E&e1>HbK4;rd$K;OaJxZgKy zUUJfF6IX^zQI_=bt_ze$x6z$jy#8VrecbCr^MSru5-(xWsCibpB4*sw9? z?2OUk@F*S~O`MV;iQGn_Ic+SuwwV^tNw^=z^&#Iy-|KU8BkOBlv*jY?G3RNE;KV|& zi~)H0O4j)heBqf*-PT%oytIngSA6u|2|y|q5|vYM`MS(siR{Rl{kvT+IVB$OG^}{{ zd~^6had1b$g?L}FEk3K>*pcr!2{E|O3N>^MU}aq|J#i;|MPQn(C|eP?p^qx&!-`N= zN0bfIET4Fzvg>P@sD*mfu`Al&iqoiLXr#mG8wuasPkXuuC(7ZlS*R|r%g9yH`n?kZ zALlRNG^f^m&eVI=7}AyGjVz{$#n+brsQ21@FNM zQ>)4UwQymjD-jP7(>bk&9`yhpFRhEb!r;IIKjl}3sz^BeD!{Z z+|BsHSesmLu)2U`eXO>)2NY~sRY?ELI|D5{ro+u|$MVoO<{ngC0}}Ez<25n5MH#+* zh3JM%6em9<*+=X1a?2;VS43iyU)ob_slUzJfd@sm39OrgXN zb(^#TStNtCTk%%)9;qC(%|D3l!$lRuPrha=ekr<@U9K3>`Z77?gx`;s)w z&It!Qlf(4A&Z;|3b{_=ZQoz8|GI5Tji2oKT87_A2UVi4_tcC&IOFc=hkf06#Z;tLyAjOiJ=?bXj?-a&FN`JlCN99Lj@_*;hx zv2ism`gW5AJ#0Nv=jhb=s2HVFRGxKt4r}PW2>rc|^n5M}bwRv+5YAnRgsy`QAK#A` zgk@MCmIpIOZhJZyr5(=J^>zsCkG&6knkrD8RK{0e&uFmi#q@UQ_+k|F`(*+^OXt|+ zu0WU%C zY2RIqnKAsz*`PGZ;}{bJ<_1ts%6-u6l-iFe6AopUv7RO-(D33fy#@sMug5Ld=Ht)M zb`}!QR~8m`_S<0Z@*)S=aC!BQ(C;F7!@q47UiLsQ1p}%A*lgIi*mCDtun%_HI2||$ zj@-I|==a~g+O2&2WmJ$<&1Zx9sW@%~7Ch{+jGl-7zHjjb-P zl83HWY|33D{#yjvBm%Lzwul3tDB)&d8}@W1DOHA&+5XK`2AQkcZY)-|j26xktBpw)F^F$8m0$#AIFrHZ}Z*w{&}Z3DG9{WmNS z|4};+HMPm>O;$AxE;dI(I{-4?FHBzha66Bv?&u*TA^ywI=)qzV_v`AYZsQXL$GfeK z#T=tu+GPjRZTF$H`#@WfcF%~MX9$u+s* zb+@@|e!GpDBZivE=kb=I)t*@S5s^=thJlx^TI(=R*`Sl#u7w#~NX6zQgT3|+Eg7x^ zs0=4Flb|~2t@;C#)%OLKAJfm83TX^$@{H@Fw+OA?799;caOKT@68;i5z*;8=Bl<=|yOh2@L=GJ9{eg@s{DL28d!>S23bp=`hU)!6-f>srSoJ$mFOdLpX$yr4)(-Hd3^JZ>^WXZ=-S)H?<_y)GhRQW zI%PJt`7(3j@UTs3f~M;$h`jj8W_n*cb614R(nBgLWdr?w+XDSNqU!n+U*J`HK!Cgl zr`33Go@07PAVoVEf6T}Q40e{d!(e|QZHY5Y`091(0D0E@P_@J|Q>&+L=GeGq z#v8sm%%&v$oF8Y_lVX`U3az${oScDvqpGHoIJ}v7wIA}G+{+YMKZJ>ZwMo`uSU6xY z0a`>py3S!V_xc{>vBuhPe?_*g?vJNj6nj6paQ$JR?_H$HT=;-X{-Qe9{eyMMXLIWo z``wu##8U}5eEY+;6?dt|h4f2ABSS&_Xhl_q5_zlWncLF>IF}R^Z^yS`50$MBLM=*w z&-f?*B2iN(<7nCH4I6HKeznAW#%2%G>>m>vUNmF(o|XnN%K{ixRoms3Ru4vAoNVs& zsgPwrNQCb#P$X>7+%5C;>!nt#(WJ<8f@4R&)s_a4uBur0y!c7R!u|Fe@3LH+AKQhG zW)9*d@|KhkQe5bVKWSp;hpt21wRlies=>D|_miT?Dt5KRcLSYy8BKN{B9dKcxs+Bc zNw7F#^?z~fjOQ#D^M23oLt0^AupQ`xTEQYb?u39^`Lzhe9ajp}+Gl8LUZ@z$k}h>(i8$qDT%+IXsX z4V@p5;^AuSfG6rBbuG9OJicn9wqO+yM1==gE~djqP~P3kT{Ex5qA2+0EX-Bn7sTHx zVf2ng{@tq%ZjPxqmBD4XPV5@FN2LXO6BzXC{7*)DzZxY*|9r8ukq|xkOY4i&J9eff zb(b9(1ZGAp`pr`<15{zz-E-TE>{k;zOOR`Tjgu2qn2)ZH@|Qi~x2)Fy9ck2P(NU>_ z`;%%HC6A|fEQF_o4j|`Z%z{Dh2xo}+mMa$@!61(v`Pj@%?sBC2U!`}>a@wVSeq=J8 zIxSvF4r@{-q4r+Mq?J@`173Jt~#kraG_tyfz&7vSjDBDp3wm!f^uEg2h#bY+>_@C?pzeG5=_wzo#FVeDv^r*$_>ze zBmOSf3PdHlsDm zec*SA?|bmOq@$ByZy9)22paZ9G(MI31ZV+u3wxOY8|#``MFEf|^fJq=L<289%pr&Tb!+YuCZ6rEZhz`wOjS`7v@qn zD&u#&j7)yCy#oDY=e1%#6+zN%BIZH3dN2x_|B*7mGeUMG1)}nHqT+E?tghi|DW}G^ zxHu~%ulv?k-Oit5G(noSnD(Q9DY_Y2+xFAA*CsB^JdW9XRVb^B+-R&kQ3|sn7%W4B zN@@lT4;NKRHTSQ_bo`=JkR55hHz6&#m$$luWpMr+DIHbl^}6QH;h>6&)|oR;1X=5* zAZcbHq1McL9ydWJJe|ual-9q2?xozEJIA2tS<&95mR$aI zM8-CCq2rF@l8B7h$%XiGNbC0f*re=x9luO-=wniogxeVS!h)6_W(P=L9D4`C?A|_t z6{ahA9rPXeCENv4=x#i=Ov~#SbrkKa1qJ4iHGZxm!8t)x1bQ?w^qvAGU$5^a&FcEr zspNU)I27h`;iZ0E$=b~8b54-M@qF`{-Qutr7ycTP%P+!AO3@2unh#0lZ6I&jS{q(_9-l$_CX=R$*&sL|(GbYLLjO$es$0y9k zk6zX$pNH0U4YaG$4xhVZQqF{P>xu;#YV@VfTxGN$XpC1d4ewEAq9g@W>AR28(fe-I zJsl;|#wxx>X@q_N8IN?~!<{WYF(VVBw~~pEv0sIRVILgpCN%*qW6OG{f5JsH6e{0^ zd0Xv4#vgdT^)=S!wSQb~*d+~m43&9e@+zFXswco7hIhBx!N^cKyg!@UhKtaMv}#v$ z#TgImBmc3DR*r1ji;eVE-vdkVNy5NNS>3P1Jhg{yZzGm3(j+0!-Mj9OdW~N6MoJxoc?IPoMOHy5egN4Np)0NQ8C?tjh&I7Z%Xp)nJ-aCn+n^R@%}|V52B_DtFNhC4`$OA z!GEed(PiHlgh@#{E6lFSMzNoIKx@NAN86>Jv&G2RuNT^MOM}&PdZkX@Xks~GnTn{B ziu%c9NL{Cdk7nmtFG%=>X)<1tPVY8N7*$DHqA&(;uD|?Yp&5Zg<2?y305jKH6snV7ia0&kNki=tQw5ZJGu+VcaQtQ}?Ac9uf`{ zHGMsA;?5}LJ>bUM2(e~2Xw8KS6UA!wg4G3LpGgh`Fy+jbg^XL2;lDqKKWI7y{g_B4 zoiL$X5C7>RjgoCXzULOr2#GEzcdDeD_JNzLfF4qb8A%ASe5H!^!5CIq5=y~yoYQ|a zz|Hnb3#9yQ&(O|Qcmh|Sy0L`b=;P_Q=$(GSBqBIy@PVIq4VRWZkz#m3O0J* zv(=9L4^FPy=$j+-{XQ?M#IY=P+rCOgN{bG(8(s~*k_sMMI_R=qfF~8dHo0P*Ay2-% zN5#&ZcA;0;%yy;+iaYycf~nm9WR#@-l}?K0ogv+t{@qHn#+X!>B7g8^<}kVJb6~I=wy-BuwOmJgP2 zJNYZre4IrNWFh?mBN^u{+o|5g*>}p&H~;E<;dRZ5rge z1k-LYQeGgYd za{>0q-5YM_h|R4pD|>6GDKQEhgs3bJGNWwRl7wQy>Q>uwPPTYjoeE*yrrfRH%SBYi z^>K18(pK?igbRJGOu|kg$Gn8jLpwo48f~v|o@7ZAuabjsZg~wVgCCoBR3t|b?tw@8 z&UmWV8H_6GX^ZB_;iz>}P>u?0P&^{%Jlb&e3;U^9+`uQ>4oyzN$qg9>B@Y`PZxzT= zak9(UTctP9P@uX-eB)_|zmLptK^{+r^D{T$#5KF%k$kGaqY9}2)#4x&UqqwC~2v=?SDhHN=qM06$N}ery<+#4-jCQrdi?Ew?W08m5 zX1k~_L~>+x@Z4(C%ww0P_ZsoLi~hiy@$^ULoQOg$0v9`oSm2wnMg~lTmW8CtI{*Q; zzsEzJN>9MtvH@g2EccLsJ0K0ZOzb129P(7utVO0X0PA?Fb=7Ekenf$yX-HcPg?E3g@Ul?IeGP$5Yf6n?o`aUO@YE74s&~4_Xym68IOde+FohDRUIQXhFMM)r| zxhN@#OX)+Om2dn*fY^Rf<3rPV)|r%U3R=S9AVNyz&3KX-;kc~QR{0vthhi7>OkcEP zeU1oDAQ7%pc5NeGWC39{y(gXa*)nuE|d)x%B7kz(DYxds4m9M$|j^ejQl7 zHcrVR&`vwK1VB)%N-R7lrgA&u$U#{@^QY*p&7x7>LC@$@Ev;Tm90#dOu5{iLjW@Gd_SIGVmO5j`k}Te>Yb*L+6Q(TyP$;ygvO zSqG^$d@dST)RVH+E*ci!7#t}6^%xR3eQS#Da(61G&6>%<# zF+&A_vZ(~&uqQ>u7|aPxLZ%&hfL70w&TpHfd72>)@mdY@<#S~ud@QzwgbBtu`5txp{&dNz3!DN{It7o3r zfVv*tiypO|HN?j!3Y?h9SNC7T32Ry%e0XzXjKl&q4Dx4NaoBt}Rg4k?1YIDSlMVOC z>_>RZl^%vZM+zeevOL$`DEbMJssrzLF}c=IL_Z&o&kiK7loV9c%eB+%N;7gmih(gC z>#?4keo=L3cUkK(@{E4Pe17n#2bQRaK`0sR5~=Eav|UCKUb1?3+x?9;Qhc@h zl6&MSZ*>n;yVq$wiZ zf7$MuFOQy{P%Dj)me8-l*dI6Y5v_rW^gY~IDjdqc?=Kuian`1xL3nm$;%3PcMNg3j zTDVO4Hr*9*4e+w9SO%74)XZesFbK_l5INAhZxP=8YsK#s5XW~Y zcb=T9vj(=$?HSey2V~ws#u68ciP;=9YVy|i^APp^848u$iiEfUupPMC)Qdb*fQ1`g z%3Pj&Fy8Bu%(=AF=#BRaoy)gUx-+MK0x`r;ti3ys@8#ix)m$19-G*K1k~#Nv>hE##O^Y^JQ6&bEU0ohzB!m87~D z(>ilL$SGl8N@zb zC>t;-?!&TxQHywg`fbKZZQ7&w%!J{18*^~XMEGew_hx?ruX=4Yoyn08|Mgf@7R zF2=how4|@*!#cOB-2;&fgMK9eFlkf>1|sQrMT|+$&VfK$QyFNZ!y6o*Px3%7(K>ue zQO3=hUFDYK8|j_W5*8I14PlC3cD=SXO16~5K)u?*9u;u3B$4T7VBg&b`DBeag>;?q=Yli8pd$jk5`Q+ZQ80&)MBGeQUc`OvUEqrcWZlc;`kPt+jD(#T^Vbu zXO2sw1tXLc$bH;2B@b2SQ#|MWg98Z+QKPw{tZu+sDu&>Za|wkYf=Lq4GbgimEUuK9 z67iVMfkv9Gmi=J;m)T;mu0)Q!TsGXMUc4cV-eX-HFNAr_=qgn@RK!ZVF%;NuM-YD- zabGo7<>hqj!X}~J8`2HZpC|~k1e|Zk`z;-P<8f%qPFuSD&bQcHjZ+jBb}S1H0xI|^ zE^*kZ?5+51nqxdEkg7-`4wNh+cgh^B#HI8TiB}XOFEUBwW!^Dm8NVFON=yr@$~x9i zjv;iGF;ct}#)B2HD<_fq=v*0{Y6Nn`Kn!k! zA6MY$_Uk2fAnw*Kwi{-3C};kpy;)}V!ZeQj5yLEl<#%?ON*SlIIIwo8rua`S~Yr8L+#qq_PwZxvT3C8aNM0GFI|Iu0?r zGAqk7+bJ-#u=GJ5K5x9thK4hvaQ5~+AwOpiIa|^|@`P@swwnGAp}E)$JqF-lzYd>K z^P;kbDXm-Yc$ok{6!P{NjmR_o@bvc7C9alTY#)_qyaxvkB3Ain;+Sb|M0 zKH4A6hE8!$M^6Y`b|5~V_NT-cRQM}nP^uwihRlY zc2y=F2ceM{#iGem0^a0QE)2;x!c7lKYW$@0=*eQm3A<|Zh`7|)Ay`A#lavT6g=186vOUj|x8jz3eXQr@ z=x!ufrg)T030Bb}1Zqe^YIUP}6u)ZYK3cGI5B~~T%Ed|pNNmbYy&=HL8c;ufbMV&4 zKb2PY8H-8}*fq_|`|`Z!!*nbq2FKU2? zY*k&FnN3e{14mm;{GIH0N)5^JFkYU?2^`VgqDmtZ5-u#WZE_3_W{RQ42Fm2bnxR+) z2d@|EGhe#a{My-*HI3M<4aJuAc>Rgm?X)A4VpY2PIE=n1eGwD{bRTP{D2gmm9?AysQ=-N*XnZ33C+Pp?Vifz(|GNF}wt(<_u0;$BP{H5q7)0EZd5UY{hXu8gSMJmd1odSHfi2Vs1moRfBe& z=Umspx*~2wJFBT9#?wi=V4d0ivLxCdf}HGjypk%NNWU7A;b6HSs^NktMCBSf@{0WeD(C?;yv0s0SmQsXD?V*g1g|5*4zu z)tCE5+pgHuuw#7|)nuJAdNVtoQkf``SYxif;< zkYJRUcAx?NxR~(7Gle5w+m#SkL;SEBWFC2vHB|0-=>_iZ?agV6PYm*MyI=M6<1CI( zKd}<{S7Ppiv?cuy{@I1VPL7o#l~0l1*IHP|UbbYFsmN1PCN^i7Q~hjKueh(csGh7k zwrVWr*pJih26#`-^F}gy@!qrKeTL1poGk;E${mEpY}u~^&*~<+cjqr;9T|$B<+kO% zp=-TBZ`>BoidR9=Zr;U87&g!0ekZQtsE-syZUg1^x=K9|-Tb=T1aA4qGo)JaBc{Uk ztBpb>Wcs5YyP-YzhOJ+bTisSiI{!3lzlX9zeTfo zX^ED}`zd`|Y*?q0q1k2A&MPEprIF^=`nsw-7@UbeAXUGv$}T#Tcy}^A6O)nztSOXN z1NJ&=C1f(n8dxY1?fS{!Fr>1>pkUS!KY`Jr!qL)E^RVaC^CNDX7-Knd<`eNEj)$_w@d7NF`nygMr5#Fz`pBei`0>Kz-Tq^Owu|bmo z`K4On_6{6kHUQ#?7Fd+8QF6k19L&eh z&Q70tBen@4Rsl!lsrxlr_Uy<d9#Yq-NKaE`j7gL}iJqnh27rCJBIG^>8&93NfDX)?QVVc&84E?(FBrzVy z!R}qD@I)w!g2l-Pyma2^oQb$JFZWHAAn=$(;S=ZF%#cOnD&y92HuLw42p%p)z1R}- z)g0KPd1LcL97i{1FD;Ijz|U?x+r~&P6%E<4^Z!NBc?PoexNSI;nnkVJqojz@)~Z;w zio_0L1l6LpiXE${QHmNtYmeAMk=Rw#-eT_+dsOY#ul>K?&*xjthm+@d?(4dj7UQVS zrzjL{4I9)J=MoXx0?#Ms5$bwk7-25E9jvwzu6@9kkG3YmAUCbo9H|sHQ}lj7s~z7v z$C{qqsZY4w6hE8y3(|&B&0)@aET5k0wmg&eTGRZes&r4-{XEP9tZ&eTH7d%lk&sVK z9uvxSR(C5V=>aMy6Q#@~Kl*W}QgtbbC8C(i(b-ij+*w{p!NIOp!DM$MM%Rb88yjd6 zkIXw{Se^ZbWf!>E>1=cNm!gB0XI6BIf2?F*1;EgKb}mpxmNi!w0igf^YSHbYOQEhB z($<#)>8~4P+dm%+Hs`)m5_14q*z{4SP-#=NG<3XC!1C)WVp>laljJ`!=@j)jOJIxT z=C<&B!rqmULT9!c3=tS1TQaWA91nHcCis311Zo`7{vV-foJ}9Laihz%t`6YsM8Gw|!Yz{laV0p-qmm#+HCP2M%maXR{Eqbu)QGNP^ZA2iAxFCw~~I_ntW zRlZv@MM&$JGA9>>1VsWIX6Q*LPr#IG`#QOU_(YwQdeOK+f4aG(f+@Qb_%uIRIi{RI ztsf!~_H=fmlBH0n!v4cO)L`$-IINgK-hNh6V}mRQ*o(+H!22Ldb-l!h4@@E(21pb} zDI}$`H#4eRVyq-Hs_HT!3kwXX-@l9OWNv=*F5P<3I`*PZJhr;!Oy53@p*}Yz1N7^! zrg%HO!Q=(wjSza}Jf9<9>4p{gg;C&mov!?8*cVFpgv{Q(N4soL|OX0VxQ(z_epmaCnj zbJYFYPZUO+yR2C&*EActc+Bhx1`SyyXfgq>lniDR08F?{LR}ufSaPjeW^zYTcaPlz zjDEZ3hNPreC5*|IWF4_;E6xAJy628>+4~g7*;mQOAUal{sGW53hln7E_VJd9xL*KF zEv2p~d`Wc=Vx{ilCeIB^NkSzLXPR@0KsZgPTR2p3Nng=T`)Aql$#K#5+?$|XDQioC zr&WN$jrSN9y6AZB0d1mwU~cw-<&|(wTVmjL*^q!zE47gt)e;@O82pPwSQ=j%Q+zzY z^_9&SVOb%8-6bRtt%6LEqwg*of_Oexu^%QoC9_y3X_)X2n_XkkJa?}`E&Oqe+> zI`-*9>{6bS6>ugmEu?Lxw6+NYuyTv>zK=36XXch*$22~l8oV)NJ9~$;HiN8jAW}A^ z7^teC-6t@LFR!U6pBCO>`!GUQM9SRkB=~#B#uz ze`dLTmWi{%ho$%#98hN|!=Nzq2n2y8(T#(BunKUg-O3tNg&q?^BN1m5Ss+-_mZW8* zLun)^e8h(NNPz^RuFF~;-$hl~!nK8Jpdh`95q(U=(^d8Gt}q5oMXpA9#uqCS{0TY|q7I3$IrPHUaMk+ad+I!U<@%SKapDJ-X0IOB1L;jbehG^v?)C zfi5(fSKCpUWy?+kd|mlUOX6{1Q3@sqXCpF+ZWg{M_d~OAK__qpPDkT>z=y7M6qaUQNM4FY-XFOF2zsLWAbvW7pmQ$H~iuNvh{wIudn)Z z#6K_9=Ziq1JWQZ600UM4b_a{8rcM2+>=@`R`7UI_F^8!C@H87h9~O#xhptKdFF+%` zDK2_TWJ_GOe<@e<$LjJ}SNjh=k^4CyITC8{MTqg=i(g}j65VOt84pOIIj&2)pUsUx z*Met82QO8tV=m_wz$bmTVwwU9Zq#fY1I6x_G1a)!JJw_*m2S%$%;8@ zbr)zfgew8HwQ7?B!;mqjPbu^%PImws(-{|-X4h^FByU_@IE}v>f<)Y_@zFEaHZ#-% zcNA~qw)0TN7zH78!Jhb|e4f_@+P==C#5H#_T|yYlG-2)bqT=>i)V(as6U@QkOfoV^ zF6e({D)?b(WG!J)OWC3-o7S7_z&Kjv<cp8UJzv?DkKC_>BI3J0_=TJu4FGx zh20v`$i;~MLGMbO%_;cEN%C|SA)M~6$`K@Fw2rN_P)c=5RYX>{h`{s|{9I^E^PfGy z)hj6yms4>byDOsT@b)~Ltw(ss)rLZK)yzmL=E3W!B(xg{B)7K;ecfO-UwMbzs`CV+ zo6e>BHqR;VIOiN6Z6mZFN&z~#-d|>B(b6ixU@_$OVIii?BvgYO{eZJR-P!0MrLY2x zor-c87ZS3-8b&V>qGx$sSW`dcmzrHeCd_3EzYLNQ`C3?2dP}`YM?FFJv%{&l5+o8? z_+*ow7+C$|sC!Y{(y9ck9p(!o8TeJKSAZ)PUGSci!Q5T6{L4t8%M-j8B+{i%+FnM% zzicTCl0suK3AIJCQIYw=Rq@1JHFU2|dD6o2D>inr>j`#r!);1?d8ztrGy{lsBNMYL z8?z!Xe-X#*Ua^#9c?v$o2cNy~Cqx(ZJ!XjRJ&}ZPUtk(ABGhWo?8UwNV|jHMUzr;$ z1|!hbF8#eqcs#%JoyV{6=o%Nb4`vMw(#iAreS^?&h1P_i!_Oi7v`-e&TFC@YAEkfo zZZKgq!D9c2K#j6Z=Cud3C)uZ?$i=6U0=*6p%sN>~0G?bWYC{4W4ZRzD`yaL6X;m$E zng>ilLkP@f;0wi=_2-l@e8uHsskpC4fJx<0cM?u?3bm@%LyGDglcesV+AaiS@lze< z>H$|g^e7p+tc8K0B0@qdJ{ICMB}O%Kc^V<+?rYhsef|;})4bi*^q~I%+*63Mu&jit z%U@Fkx#RDARC(AcqZo=FxfNTB|9qzG0c~g=P;Yv_{E3=y&W=1JkfmF`x*ET|{7zaj zhBA(o#SurylMXt?bFwoqGWT|%`*MxeN`9uz9xqUlZKI?~QKYQlrx(R>zJyxw-!8_@ zeJ=a4FT-w1Hy)MDD%0(=%MbMb@mQ&mOrOnZ_@im*Dn|{t{!N^yDmgs;`Xdm|mpG?i@B z*Lsl-?lp5L+zQC7zKx^xB*nyK#lKkZs)px+j9fA}PSlhC_j#nrGofd`;6SdJQm@lVN{wiuK z;IZ;Q0LN^7AOL0vSJ(%R>qnm6>3qRm7@_A1<#>DkfMww-8S&D{ILZOCxNK=saFSBR z^Urhy{#z#gnW&V2OA3_{?B>8&n`*$!;10s({!oCWtY?@C1;6%a71RrCfCjL+e zEGN*CzDWWK5K-?Dc!I3cxlH>4&*JA3tyA6dFhFRX(YML4y@d&DItq?k;c`UzP*)f1f9miw~OP`GL=3!X} z@+*gR1&d0E2;I_Qx%l#_GIwXy&_R~W`X3|ZS^->9PQ9pLlL9>JqM@(z0A^4^kXT^; ztLItWYukuimD4KUnjmQO7QafsY_?F}#)$fF>8F}V6>9LpLUUjxjZTFX83aQg!=AuI-Xwpt&IN!(p{V$^Po{wZEL!Ji$y~@lujpU{NxHtlyY&L=I7@PU zA@DYf`M_D{>w#0{+-~KE*6V}1k}-1%cg8MJW`}wqcTQ2(^=Hn6-H)saZ~aoAp|w}X zhV650lw5b{Q`L%u;>NVnm(0|MYh2*eVHc-01vYvOer%f!>7SPnL7Y~Z00%9vdQweo zij5iyquyevBF?5yUjG#~kv3RSZHB&w@T=It)D*vodC~FK*Q76bX+#H6w3%#T=2w;Lo-@`p)09k84vmwx@DQWX`x;BlwRs z-SF&OV0(%s$}TPUWl11fCUt;7tl{z8 zsrcD~U@@;X)Spx`In|OAP$d^BTtvq5*Td8GN2T#6{u1V=iNQAq?0)oKm!$nlQmHl{ z6L-c#zD5OeCF1vbIW5&}$c_#yZv?R+g{MI&^qxgNMyDg4pgS&Ikb|VBns7RbLPb{~ zP_8SMWtaFz+N~MuN(sn4i=X}KseLhypuXefC6zfUS%_R6ED^b+-KfnC=#a^oXS-XM zvf_!i>z=M|1_G#+<5070xgBBP`AR>9zot8ZITnKirYW*Gd`VpUm{1wH zV#fg@W&H5{=R3K`Rf|t4_zUF;gcZDx3GI8Qz2Y}$WyOHDsg!P-HgLp)FREB6R|}Qz z=c4d2mS+_IHL0i>L{!v!_**jN6m_qlr(9e4Q$rX5ytQQ4>K>$~t$7>jiLC56E3$Jn z{1Fzgjcbv%%BQ|Z#$1|<%7!m*=^vXFDjHACsOX47r%svCcf#lsT-4(eN&^fe&J61W z2TGzoymV>N>2LZPkBKCmk~@v3}`QaQ)`nEClTP_R97fl1$0)0jN z4nL?@@~P2!`5}a4Ov#7Vo1|#)TLR)0ECr{V^pzsWg{8{z1sA)Jb7R+8TGHJWYtew) z`O4kJ$(@}u5hOo~ovd(054^JYGZQ;DhG4>;FFMxyGQn%=C_Bq6Qj!&T2>L02h11>; z_2laVSN&o#p!oaN5=|HB9N&^uJmr;2l9xZ9-3Io<1`nD~T-U0rlkb%P%fwFs@v8I& z^i?G0M#SDxL9h&@q7A?MG}n~!CA0J?glBVUMn%qyKa*>tI#;v%QIEIf6p3OV2eD1k39QmM?PF|CFEHI3U8WWdO+e9YDgwPCAq z*;FqVsvEDtit>Dr2>H+CrvGzK`+XPOrhBD#xXl;h(@e_=<1a{ZTe|EIV?!Z2o4jBvSnw2n6~aW&K9=mGh}pe6fNT7sv)2k%EL4eVYel zsA-Qrb2Ejx|N3DgI_?-18hb()O6_SE&!vWd90tH*m~w54e~gyMM}9${OdVwe`0AF) zah_8EMfmLLHiroq9S2MS)Sg(D&;x#0HY-=t6ARKoHkn68ah3T&6@PB!&OS*H1!+@LW3gr_9tD#)5s6i1&g@N#HqDY8NBO5 zXmks`f#>g=);j(C4NA2$`wh2(y?>yA_#(0$SsWREeIc{AxRdsyioa*?KvejMdEK+% z+kT&)Hw^!x{c|&WOSkXkqH#DMBS5TDaAqiShS#Yt7U=d?&UYmHGBH1}f5g~m>9i?$ ztLaj`wd5S%e|2>=vlugJzN>BZ4NT+I6>;kb*c>rsn)29n6N~k-6LD64Hz};^i?uu3P#aGQ-1)bn`9;VAKcB*$v1Q~W8sK5MkO@ywq@w^$IGQ>& zHe?8CN^q5G!ybwVl6uc4g|zL7dLEM}j@-AI%lAS~?bIw+`@Dm$&PXW?X3_{d9Z`&O z8Frp@fJ=JJzo7p-)IF_mrR?XEzns24?@`V#>fIWYx2lzklKh-l4zSzAf?`Bp$2xaZ zuZezsQ0lWNh+0L*BJUMjr8JXO^74Y-ddwC$%Hg#)69%8ZQ6k0kcQtzpYa|t1 zxdvI@iS{7#%hs40D-+;}d@u^xGsM$bv0jRJ`PhwiTBA@yV?UPENg$4&Uz_aq*AwlaY(6{c!{> zG=V)sM?8@lKih+&ICn>lV9BqwXXM2dOt#A#dB#4I9G?9ak@~Z$(J&vhstcq&JFinM zQ&5!B*|+amcet2V+T{m@P?6=L`ur_J8ayR#e1m(UI*01MNsJ(fMJct}GcSXJIeLvg zkxq7tbGCw}o{}1b8i42-&KW5FG55-ysEw@@O9p4k_-Gt^zd!9tPuQdW9Dk!^YH5`} zFLniii?qr3$@DT_whf&{=o65wvvAM;v^r*{;MAh-1hPUy83D&!Fu(bTQ%1KnO`~gI zES}4&+xOxG%lhqp!Q1=l*oAC&cgCSbUTUb7Hv657hE!KQsY2#sHST;HRfNr#Ol;Gzf7jD^3o1$_iE)U9e1s}q|xK3b(Z%Hkals=%<0GVL!$sM#(0teBoCmleUy zB;pa5%lBSp`o+>1>VAxf){?Ftz5&lhAq}*I(Xt*o<~#Lu?0wbfgOGa_IQ9Du)<%VX{cat1>~$W2z9?w z%Lj|r|HKN#1)7VM%}Zzr8k zcZ4XqXJrrGeB>xtJu{qiBB82Z2AGBS{}15nYQ`w`!A3JL7lu0ZwEyo`HyAcMYL9Cb z6)_Y7+2uY#eKLF83N!V59{Z3c<#Ws2DiTMbAc%V=W~ZF+mQpst=##yOl>uHX?-}8W z^l2W1xXH_3L%m@|ZYxzHRI2#9Ew58A^|;aXm09jkT-QW1zG2CpD8@*+b69r1?Ca-T z%sl3-qX~U3UsT3b30A63u#pRRM2F;$lFN2RDc|wlV}A||RD@WvyvHmPrAF3jnnW5v z7djus^jf7CV_{+QEbJX}-0w<3Nvb#-U;+7vl_A{k@XW-+Y{24j5Ly^L&-FqSrb-A) z9rqY`E)#V1m%k$|XvC=FXFz;#n8|Tx*VRu^%Czd@I?qr{Gy_ZcRO+FKz@lO9qq)b5 z%FUF&E(A_rxAf(_@WG)kJB6qrV?C!c2L_-eyKg>`S|5zBUgdyDj5;_6c7DCL(QNt- zQAoxtjxI$3JeAriLhc^$-vm1@&>kW&!opwUiQ!|VRZ~nK%$nVoAN>A($>AKyjO&6W z^lh-DNohA+OWzz#eeOCha_%1xf$W^Y(_FBS>>}Nw3>4&fU|}6TWLMfGEAkRXQK(?` zpEXFU@VvclmT6Pvy|R5Qy{2SC`C6oGWC|5XX(ykX$T1co1r62PG}-S$InVWZ_Wwy4 zTVkuCImTN`=E(O$p0DlSoF92lJP=p#G5uuJEK@!b)@ZIf7REA3fb=5uJFRpwv(nK|0wXRe{CEa4lwE%bNL`9ojF~zP|Pm_?ln0)$Hou=4Q@jrgk z9KYTsOMOL+JwxJ^3#%um$A09%YgTxZ@FLBO`b;>$-mbiF#a2_bhVq6>WptbQ^0t%e z4FG-i`@pi))eBo9?E~<927De}_(TBOBwhY<2%SE@YmaFvgeY}k8onuZQF^(FEJ`)v zkU9(WF}HUI^xLg4IP}&cZqi}(+uOOy`C-@ z;7F*waINymo3}mvAE4Oqw?FHuC45p_$1!OD{HUI!vHHqsrYugw4mdh2Drh&cy!sbB z!+2vYrCF7h@iyFE$=AXB1m+CBW%UJDGpR0`GM9_bwOWst;LL+|h=(Az#w8;vHIfDJ zRZ6v5wtHac@PRO>5vaxY$9CsD~*Brv}so*mG^vp1imvGtkZDD#)swOg@ooUkAlQL4~|J_qy1S{8R-wr z2HQ}ZJ$$WYhMLHe785Ux-#P}xUyt@8<7(wXx_0m-RgHU^J1^o7uc6sI0SQ@8layK$ zLFsvb*Uu=g&wo0RgQ-chy7251410H_>#!cbWzQ@55Rdo^aK;J>b9+kOZksrNEnvVB=8x<=PethiSx<=gUtTVoUds>C=Fg!D#8DziHOn^D5pL}(GXbi z*Z5RlH0-4v`~{3_0mB!WJir%_I+MDWL;tg4(d+w?kO9Ien;3BTf(G?gn9+cLn6B*? zLRc2dvaI2}7((EraeAd2#u8b^G<-z>KD1d`0BahB!2&NzTN@JaKhOst)1C~3z&@;Q zGFD$IC+_@qlP7Kb@F+QpyGkY_i!5P%92TMy;cbD(pF&eY*yx90zZNh=@ADS3{6n0b zBqzHZpdwYfv3=>qh%-pTM;NG8BSpX!8k1Npf(!)#j751VV3yQW~!xOrxIu_!xklGJPJMZh+Au^OBhNgFrr9VQk-?(*4>}~ zJqXuQ+~I27^BH1kZWv@wOk&grjE(7~iX9lgRibwZ9!Wa=?z(zakudpK;{H)jucd*5 z5|x=j1a#3 zW9osoyM%I2HF=u=U3wt`ejT0Wqnlx}p|Vc`W6UR^NHhBL(SU}#%d{kz?L+GQ3+WxZ zhzL(gf$0dvK*#SSazP$(U5F1ZKvidIH9_va9{Z5}t~XuKPD$4K#4MAVJZ9qG=5jh< zw9!0v+FhIMlMYvf!g2iE81`QI@(6cWF?654k!4K8-OnX0amD+sCEe(>exg0II3GQa zU9q!N;ZJQxoUr0x2b}W4YX|D{chq#@%mZ(g=i5D;KBPsLb3=UsdxAWDZ(WI;;BeV; zkiFd5yOCD#Y5FQ4d-E-|&#S%4Am6LX0m8SL_e2YH)D!CvRi7oHm-wYe`JD@=Hlt~4 zdJvF$uKY4RoJMDD^EqJpOBH`-<7)LxlRvLw0$tFr`4HS6Q8l=lzNe(;U46i)Ct%A^ zA%Y>IlqroHb4FryHlEo9c|myAdt|;c-MdhtcKb6$c(=Y9xaD${gpVEy-WX^WmDR9l{(TF$~j}V;6 zieEm$4;dx%y>JQY4A5~{t>97TwY#dI=ru1{u5v&K>}6q-vE{J!VWs+@PqVmv6Sd_1 zJIXDGL*Z(P4)Q+UEf_!bv@e%q;UZOdWl;89tEF0JCpq!Ikm*NFxEQ|z+tX`nkj%RX z>spDm$t)WW9Xn6UI)B>ivuc#ObHz>Tg92Ruu4Fs{@AD7}>8ne7@gCW1wP7i~0M~6! zeK7ZwyZ9}lyZFZt@0klPZ$*KwHiF%JKrt=b8{qw`I_cD*Np58OZ>V!rp>B|_$EXe^ zjj^yFypQ?Ty^%gL*U3wJwv)L>=+QfcJNHz$(RS4uFs{) z?kTt?9HA(hDx-l&Yu}TY_K!TLs$C|ZX*I-P#60wS?2q-AY$wGm(;o6Gya+w&uS?yL z{VR05k3uMNOFIRipcY^1Kz3v!IoZNVqlBe+dXGL zPOjFiRahUr0{;&#{#iy$ul<&&4+EVEy^3qA0r&p=Sh~L0HpMln>_`;p-dbv-2H{L$ zWu`z1C|y4XzNpq|?}QB&TFe-&q!0Yd{slj-eEjt+IrGb+ra|FU?r?#=pgq7C7vTH5 zO|2EXe`X9BG9K+S zen2k%r3&H=z;+8Wq8XCIlqJ$uSvXq2S^nCa2itiwe*RuFRgLZ0UZ95JI{KI=E()TC z2RcT^bsqQH7H!jhx0wX;c?%MKdO?HJi9oMq`sPNbE(H75Q9sw;kPF11PQ^3$B4Q+J z!6A*oE5$GVPUiODp6o}v^y3lPe~+xHB|h63Dn@8^-Or@lOTK6yM8*2eJmXxlmT{Ug zV26#ubSUQ*{ElH`5)tKFkp)kotcE!W!8{g9pDW)+R`oXh(&uF)70dv3zFD^>m}r&^Z*-qG;4fW}pY;xDdLitciwAppEuU0Zk09!`0a>U3 zMJmW4Cxz3lrlKaj&7WNx9-XNN?vy@t@E=b(??sK+bZtDhs}-SO+gm*-d%$#9dnDoa zqHuqrS;T^@tn|P@YLcz5l4Va(gsXn&3ghid@T+aC*_Yqnmre2GRS#9(k+;q0cGq%l zl9)!e*d(1m;Z^zq$?Ri~;ULwrXRkIem1N=+R4b}r@blO50n@0ObOPQ2Su9Dqrp5g% z(E9VwYOyQ2FB7boy~1E@z*%6({Enf`pn^(dvZo;o<;5bst`zq_K-E#w+h-rE3(`al z<<`O(#kLX$aB_&Q>7~Mat@<3pkt%Mn)0b}Yd5UC$@4udIC9i1t$@|Z~`YnWKRS3K% zX|qIJR*;j#*AP6QD?Wm2w&E(XPdD_POLDIUtmdY`f(@hOdv=@X3<$CP+$Rr&Re&3@eF`@5mE0A++lzkL^)z*!Q6oNU;^sGx%`ulb zhL5o_F3mDPi64b<@Ng2Y>m%WtUg@P6v-*18J+9eRHR-E$*H`qZ**mdWeb1YihWQ!F zg*2=T$?ngVG7ssqIAk}t2`ETBU7}yAeziuJKJG1a*6|U^qN#vtVbH>gjLOO(uJ|Sc zuh>`X{b@V*e`Fkdq)Om)wp`KyQ0RnttLX>+quwVB)aOZ?1ae=PQQ|mR^Z!c_C22Mg zyv&VN;Gnuz&$Ha36LtRfnA*&lqmLa^AN@glK_~2wieraQ_4%ylYxN2KdHr%|QuHKS zQ#J*)5->8G=tYzo>TME@BRI5_q8s9Zw3yZWN!4O|Q9G@(Hqr1UF=7vOvgtChP7e)*hME>4 zXECkAe+#x0G&)z*)g}z@$9RY$Ns7SYK=kJ9^h>_#s;8-7Z@~|b znqJSWqZq`WObt0h{cputAOO*h`-Kq)VV3-_NI>%o9poDX2JwSh4fc#;mC{Ug&9zjn zEZ^HCBjI63s|*!qr+ycv#R|{i};g z_?0^6O(TiL`j2-f$B$p@1YzsI$NIPb$&~oCR%^r?9o@y-xW#`cbL+M3ek>{UII^{s zE^~@cy?w0qKY+$#-nvfxiG3NdNkaAqs5KJ*fgierAp=eo_Xzm~(~CLQJf|+l(avk* zbnrrU@S)1&l`L*|S@r7rh+9zx+pUlAG+` zvEg1~XnKw%abw_76aRl|&5AK-Jg|;SXhM*=ipxjoy85;jfjB1@g|x=&IK;3H7{AiM zuwYndgYUY-(kq@n_ox zuv^oqW^=01*F2xC51k^gTua!4Y(`nT68Y^G$LQm3SDoEbxBV=(Mwdifxpk1O0VXAh z-m}m0>}k)cqesAkJn)!I>zlauc~7rzi70haSCN%rAzm(uxj{uvPSAHxV^wHCO$wG+ zr*j{}Hj=VwUlj$g^7dEV^U$VfqK;B3zsTHb4R~iZX4NRr%vM&J!YPoc((!BGE5xVU zSHILs>xgFBj77}{w__hlcUfD{zJp$~o45Y@(J@QT4477St%aQM`_g!c_q3V+maRR8 z5iG9Vji3@Bbo5iCQ*P;7sv8YczxX!KouyY*p+T&ifK4UWQr}hy{OS)ls~C`vxHUq! zBRx1Gc4VJB2`X^U!VOJOX-V>2*{1?na}Ed((ktfC_Tr>5pC2+QJo<~8_nxpF!Dda9 zUh%$71Er_eNYm*@y>GS;?(Lbe5vV>a5ax8k?DM^q*{a!3S1dkuSCU_(rwo1Spld5J z3p<`B`Fefh+UWSgPm1n&I~Thobo|4Cw-;l|6PO8@FSI-U&p}LEEIg0)P1;h{6OeL386crZ`d+1l4PXkCrm9QGLoJPeH}j|VsXTLtj~yw!~3Yt^?q_{ zSzwM*LwejFz{I}N__xOkM5S&xI$qNR^3vdkMI(c(yGFYO`1K`p`*?M#)ZM>N3{K^0 zm4UbPIKCT81e5q75r-^9zmcSd!ngOspr9X>}$8EYv#usvndnWo_p+sVFpMpgA$4K@!r~2}TPnq+q`5SvqAJ;^Cf-0R_%D(06E2Q3tyDdx4O%rBsyM^)X0ANaRnU z34Nj}SA}{YK|ZuAY@}k7e||)<|2FLg6weRyM9vDxP}F-K#3Y)F(eM4W?Y>#=F)l)N z550ZGxJGn-EX%&6eUB(u%ys%TVSb>rm6{EqTM#{D@Bk(#NzH86lose-76ENY0`S@0 zQkeMtz4UG5R_ofvKVap*2QM@G9vy!o*&n!-h%&K zT)j%c`y`J=xSv2c{RKC{KTp`kJ^Z!;okfo?U!vg{XZr*ss}<5URrO8QB7cN z1>-6E_-k*aX{3_`=YG0%d;3Rbg?QFit#`>ThScl^QCi~IVjdT{lS@+wnNw^^Nu|}` z6t?NizSm=F4k_WGVl+TS0bpSo%a>8uFvmBSyC064m|xmk6b8jF#z7zcZs=g$^dKku zIc9WHpZSBSA-+z6Dk`%lpk7c2UbEDi=k^(XqecimwhZT7G30Z5n-3Wf6uhRcYAa(L z_t(dM-gl<*fRmm)^VUbv9iCU(EI!s9nBd@f(;T|inqrmoL6d>H3A7RcTl^>iv@dn3 zOC9=RCN*x{ZWJyN6lRBYaVWt&QFxuZNCkyH3!{*v3u&#KOVp^%Zd&(ZF=wODTbPa) z?t7aN+XG*+J>qCncN3K5iDxbjk{Yba5!}d|WQ}14|8DV8imkZ%c$A8aJp0mT3j@Dt zBVHjC%oahS7Gy0o+F;zN(Y{o;ab=)T^WB-H7dqZgrRuCc`7Kwv4wa$m74Q+T}Jkun_?6Q?#)$*k{zT7}qVF9~^ z6){Klu#~HWXQz&q!0iP@V8%JiN@@j{*n%E$fCtjWLK{p40*mle`%2@Y08u1+bk+)$ z^`uV+x)9bwom*^ZTw=}2Ui~@)}H?boZJ1=Vbhc$*qm2dXC{oXd1N#DS! z?tiQXI$4$gZIfsDXyeL#GFx?I1{ztJqKdfcVF+{aVxWO21slKl^C#6-!5l_1@o2gG zwLvK+o~XZnG8YjqzXf$Wgu%`!NKF&%H;dK8>)<6RcTJLlqLD{RE=UKXtA{}}M@$PE z{$#h<^Z9SlMruvQcc=l0h7Es*nipi7c~B(bLvIx>O1SO8Q%X44i(mbiFBl!+VzO9C z-Mie^*PDIr#o(KeMpyG%_p+|)<{j_0%s^Ib4w9JHH^or6$1d-2hsMLV>!5vi<1aJY z2z@zDSvlYr_OhT^z{4adpV39Of%#+VVP&dwNVjlq?#fx7HRK2YNGXVTI#_bwX=h+S zq@HQ#sKM*mtyQJ|(|1#U_Rl(28rg)q!?&;@Sa!&w^dN=f+$Y*BD9~{1@ABsDu`nG-VRc|`1iZ$lRODRFaz)Za!2m*l4yKJjg{lqSB|u+C0Y#w3 zdr7E2wPV|5SS+v*#`^SAVle|ca{3pqdCDl)Meb9Gj zrKtVmPQLp>rGp@(H-b8&n9JtyW0@;>Yme5u%x9{cqvE=&nR$RHS}*RVX_Tf^cK&n~ zLCO>#LD7Ie>!<2GmcjE8?Y+1Tk}+-x988TdJs%A}+$=8p*h*)o?$==2b&vJ`Tb8be z@v+7@%UD=>roD3|?htrcg6Afw)U#o=1#cBQ5FOC(|Rl1Y-q*}?&Ie}0wDU(gi3?83|W zX8YR7#ns2vT~n30TSCVlHwqcEXE^FO%p*)Rq0O{{#J~@Iil**e@Tu*3H5d;4P_(IY zTZIKQQTmP+zHxWFGWB=Iwu%tTGM%mGcB`P2j6coH(4mdu%Kq;*{$FD1$azM>S8SY5 zi^;lkaby`r%+V24?mIoWikfDUm}y3C_4x|F9Tn)hk3a?p9=hJTpO{u47lf>=I0y`e z7h(gHmfdLzY#pm%;Yd*>hYFUJI{)Hxx9?l@307xv%6t<;|iVb`9W0mx9GyWM@*~r#4}<@4bzVl>?>ap*=WHOrTaem}4P&cetj z!UgIa1~Y%$18zl@A|2B=0%>cuI*JtyC;atjLWA^|i`7Hb3hJMoHSXGqc`qiK_mj2| zQ{tYYLy7QH>w9H2^@74TuDXu!N_~u%lm=!&xlH?-uZd#4#+yXfJNxt(wjutW6t?aG zo>lYrC&aglfn;vU{SQpbDK91DNWYA#L3W=2ZqnYOo^(EN_xFs58SnZwXaNzXfpigI zbSS%7Q#M4o%DqV2GQnf8V&CJYP|KG8(pcFy#5?4U1QD;|F=J>flYqA z=2LYnvB%t(_^;TsMX|w1q#1eq2#V>U;{$eU>9|5o;EcI8i6jSB1?55?(Z69o9C$o` zBPkExJG+zJi`Awv@6hJ{>+hHg`G(j05FQZjbH!_;AZmm-8fa4to81A7ZeFk`f-hS= zpJ+uH`oowpN)e1zVz)1tC*V$#ecrCi@8=mpvbl>K?#E=ycKoOMf4jxm66vSC6 z!(u@lw*{zAYLDm7XX$>u&KQ^q`3dUEONQQm5=FpZ)_X4g)>d1gN54(=iF1Bm&COfD zH@56{(2xn|>9m;zxFqr|OZz0dL(#h)8&iE4nYRuELxed@)hvMKH*&w4aYEFAW1|Ba zLT2>^bf?YU40TVc$hYnCd@{j`XoVRv{%G}(A(pdOlfJu# zvEQiU^x4j`hp|USEY!<%&^Tq8Uj*ufX8{1V`Wci#VM`xlp@jF1BwB12Z%X{1Sqw*K zS+43lR^p~RoMS~;Ch1R(fJH_@{78YI*dxheAapFO2X$&yZ*?p9vH9xWTkR&9p|;36 zcOYV5SUsX~d+wDEo|;NKa_>zkem}Y;mD%#;KwsqHoI#M(cvXsJ8vkE|2 zZGhp<(cYp!0;;|>S>RfAeCT$|REQ8vcHUv9@(2q~RDL@2^<1=YUCN4T<_S{L8c;vB z6w7yOI%W6Lzd+1r06xbZYC~{BT6nCdIqT@t1@Qr`HuG)+yh~^tbR4VCpGQI>>FPZk z^XZPY(w<3Ad8EBYB=$!Zh>8K!k~ewch)z5C zlW2_^ZN;U;?A$G@rc`_KGhDlSDN@~2>r#}gU=ff#hNm>HOytJd9=5o^)Yj#5Y>7Dw z2qgRkRc@p*RN+^mTy^pY9L`-M;;TZ|R*g|>%JwZX2@1w?J0Ae9^rY8kHKZBAR~T^Wd5O5S-(S`d!Vr z5;MnOL)hpk;r6> zk5zhlX;w3vQ2C;d)@~OiIU+(I5*#bed6F}e-GPo=s;Ijp7gwI7fHDt_S^DZjvF}$H zQ=KoZi4HcW0mo>tq7E3yk1KqMrAgO0h)IO?>ov9qtu)Pxpg7ThC~fI3D;$w+j{9bMgJ3&Mgq z9}ZQ?DWxQIN22@S3e_h`LrX47bgJ_xhMGZbXi`f=29}MaFG}0mzgw^P zmo3nc`kYs2t))oq6jV>3Qg9EAa~}!amu}Ed=iA&{HxYT6=Fc*(O%9Zx1p(8RdeyIW zyj*sksuKMqXZf$jHxzYt)PTPF=3qUFtWK>+Y2}OM%6OtxGFY zocR@Jp~XSu<+WWBrj)d<(=hD{BkKn~hNkz{)xF#^wI`fjkXw9)$DONXqLpb%;IyThKjNC-*P7q!p z!+O}i{K5=u}jEK01hTvQll*9EjscWyA#*TL*fcKuSnaJ=~Sw^Ha`` zpB`<3+YKpVL}P1^+t))ZCFlz(Ctz#q@<0_?@e=&>*|8-)(o6k;Le;x*dmv<=4(?sm z>dzyifkNfEl-{Udc8@k51gI-$LbjCSIp%&p8iDZ{_a#$gkfo_I`hPo1zb;ovl z>T{?XLW9mJ2h%DicPw%w`+O<^uh{IhR`ODWF4+}HK+aT>j$a*cY8lmvUwP&t6y}nW zwSkn)OMJbR)4osEr}Z9~;mjR34NHz@PMe{D-6gJ| zq0~*sOm~#4G=;o}lmRV=26hhffKDr~G{+Wf3`c{h-IFc5((Ng-xe;ujp&0=^vQ>b7 z2u>62t#tF*(UxaNKx@Q7xM<+h(iXWgT1zg6-be#zz*tEH1M3`zg>X+B{{TCcA*MoB zq1oXCE7IIX?0`GM{!v|Fs4o%DgoP3qdmuR`U}4m#ET@qtIX?)32ZeHH5)@`F)|&dO zi6JOZISS;SK#u-r<*!OpxKYiDEy$_3meWbrQ&NNk62yEY_bahRO*HDnArUQ&l9eUf zX$vJM2>|mwdx0n7rye7++BKcUY{^Tg0hDh_@^=Q32>Ekbb%U&`HIH+CfVY&m4=uo` z0zN`(!^-M*dJ%#}wV+crZL>(TZ-FhzY17T6aa&JlvXs2)Qs!}uq!Y^-$m`u#W{SCs zHT4c&1gLV@#{SiSf`s^l^dArzsw+TUZuZ?fq%PJQtBk1@G{t@Bu4TsE?Ubc9v5r7) z82IW@BU9X_PgMJy=`$v+BQClMiNWy$m3HZ}@N(u(%a@7MAwIVrDNODa{qPL=`y6(d3iUjt6as+bd0X)T4 zyg)HwaOYOJHb{)AX|^I8ZhR>&CPI|32Zy9`Yh6Ut(9=b$Y=PQZ4kq%KMjdW4-N{$O z8?b-rZa&Oco*s5iYlvO517LwCkaGv%WP5s2yAPX~mv)>XTOln-IP|gTfDgno?WWxY zIs{#HYI@-*F&Qm9*>yvZB?KgVXBFj5w9d!OcsfIedMsTu{kG(r#mqf9pyD=J3yq;z zJd28R9RT{#QXN03XTfGu@g=&c5gj`jd0PXCNx{hOJo+Sz{FPK%7`mn+V>3G96R-eS zkiD27d=Qg?%o>+kW854KwJIdds~Z3fl268Z^cCHLZF1SkIJP`-DrzP?1WwCl!0V`G zT#{5d_3s9`+lpzDjcp+kUoI^%;&UUG(1c>H{X-H&ge|sWIMF~U-s*yL+yUpvX9wb{ zM~jyWb;n&xZrgBfP>&icXPj%&M`)BIa0kBzuc*kS(KsT}5Y%Z3pClei?E;cM#HT7J zzn-XTf%FeSAop1>S%44)oV&f2X#oz6>O?%YB_>4R673iWQ5yJ&kH zRwu-dHp-Ppl^RQ(nRA|Z0(-qLnAa2a4W z!5P-yn3lp?TkfkQHR=PuzN0>9ENtk(j#q4Q;SzgmHPNKJaEXnap1j)wo;i0?-YF#e z$at)ri4E@MNcbpx<4)b3N;8=em&{`zwhcY;Kq-0>T8e+VvaX-9uRj7$8)lhWbEA~j z*4JGb>Z}n~g@qwnYfGso(t6yW;KmLT_TWWUa#Y!r=R%3Ug6GZ9U+mbM&GmqMBr;L<&6lg3W_bmZQA=qvw7|$xX_*s0mSal+t{D##->L+RU+Y?lKqY=;AlDGCJR0M(18^;MCSB~M)&XOT$X%;N`_^zO*6 zEN|q#PFDw2Lef#JdKX1ZylX2lu~_Har!yurl__%?OqW#KOtzkB%81-fRm|fF&3b`( zREv|BRjJlwTqG=Ka@2-~;79=S<_P9_YTWLdDY7*P!!Y*pb zBN^pYB@bY-Jc&(%!{TDl@G_mLnuY`Y-#3Xa(z7>Y^> z0g;|SV;#q>Kzyjt9f+D_!ELaTB()iYtT?xY1bS+sR;PZ>wm_ zLXm(H$3A^dareG@gz=Sz^KVfH8&}L4nP>$qdJ@j!mQ=3IX&k?1aq|j^akmL(&9z?* zP6B>U!&t>sS#BJWQTA%(leDElT+e>dpPw~8h}w~-tPU+9Vc5#Z2N*q~{{Y=klG-!c zEq@6h{r>>IYs_ox*a%AvzuF-liV{yGjFZddHRshkIv-`LXWXXJt)V&Rikw)S4Xih? zsH}4Iu~ck+Bd#VAyJA+Zxyk#~?H7$#2%MwX;&z|qRG@KP7^h6icvQQjKH9jY+KS&D!Rnn3m>T3-d_%+O-aO zQTpzAKOQPJz0bY8r45gSd$FE%Z1YlF7sCyTi9U*HOSj%s&3lcaksy3O~I(m zNl#|tV>g8n;7^Bjbz;bogz>%BFw9Y0xe7{&`l5iy$j(hTX+nneHK9u=?9nwYDN8s@ zX&yAt!kjFCvaBbcKBlnZgK0U*BzX1w70;4NQ?ztNQD#oq)zWeh^JMwLmNpEe=dC-y zD^>|3Xg$d}s+u;Uks0nskncTBIkChGv`%S5YtLNttH&ZJ;@NguA4zl$!Ae#@NK$~w z?j35l<9gY9U8zl=;THB%Juq-U$2w&^R@Cjcwlk4qB|`^mV30g&J0{^G<1NWk9#hXc zk(V)y0nZgLDsiME8j+-pz^BAwrp>;~wmUm5K9?63FJ__kK9xeiNc4&1IoE?R)&X2+ zigKKcduyAb{T4N_l^hV9pNgbV9!gY@v@Bzg*a@n7E~L3I*;j77k5wp6uf7jKyUVPl zT(Fe$tHr7!i@#9ZlGnHp)}USYS(Ub&bLOBbJ$yrLYrE<~6upjg9LVv_SDJqLaFwYn zrflaW7Oo7Otz7>AL`_)wraD^UE#)n*l7{kpa%)v5B}~CWrX$O7@Rft#y(`Gb zBcCeLh{y^nDak$Nwj3m2bTu6t)eUf+OnrM|aRJWNGLQz=qKFy7|0*fs!*2=}XD@dw?Um6r3qP1S`}z3fmoPWbAQ3GnC&$pDxX@*ZXSnm=00lfj#$DJ&P_5NnEaP1-sXe$+`ETPo0V1Mjw{6*-`W zv*}qcL#EOJ_H(UDnCgfQ;RzVP?i8bIZZo}TSM9UPs`68`O(NppsWP-) zsfLvu!d!Pk!U<3*LB@Gw9*R%56))oEqO@wwQr*(R9rIT0Q6Q4wActE|JZHNlUoCUx zn_B8U8!6|k^TR5X&`XF~cQ)cd2bjh)$b9s+ZxnCWAfG#G5W;zF+?-_ibosMey+-KK zgreKDN+;kPIFbf1Ml+i8ZkcV3rZv=gb3+T4XJv@VP{(M#+a!ER&&yDm8ouEyg)J$DJgQ zdH7O@%1++QqXc&f<;d@%&2wX}n3~<2Q(A5-Y!J-GR7$!5zn*?7?de+5&1+K^N!mr} zlWp=GxZ7qxk=Zu>v9RN+Do{w}fs$|l z1H+X~WL zx~s{%kg+AvEY_DRHOlcF%S*4VEL$T-eNLwXwn{LdocC^0u}usm#N#cIk%Bx8G{%sx zfTDJlVD3D|J$^Lo%Z0}hlqpKe%DMIHRL3OV<7!pO*!(Nhtjpn6pO2*P2{K}`{40w{ zll6G+ZY3)y$n<%Pdpvr=b^QHDeY~#WsMh0>HYKnfbQa1}$YkcZj^QqRD~tVa;u6H*i z=-FdSk=0w2g%kiVk4T=GtKWb+vrTE+w5w*MxrC=8yU{{T;AD%8=|(^j+)g#|J}FytYe0*IabA4njAta32sLe018ViD@Gzc6lo#jl-!QB`dcrQP;WD zZYOp~IXOJZ$HYEL!c%fqXr2&;a`B{(jlcP*oyNcl}|?A$2qih)lvfafvD`pBw0@{w(c5=*YAUHQlmz{G1~ zPBOqL#?ZBHQ2A?pl}kjlz12Yr01w*a{mP26A8XTFfFDF8EnQEmq#q)k-V_ZY;fK`tdb(noRhQ;&|VXuM6} z+90N5JWO>GO4PMQax#LFNC1@_bvPd-a%9F=6>BPBp}>130!j3F@)d^GK+kK_Af;Fb z)y(rhEo`&6a3YgB7g2FjhpTbJ4*Z!J`rgGr`$bpNxS<{svK`Z`yXO*PI}o`cDG2Ob z7*^blwO=TuIMqEOIcLU1`K*oG~xz#6{SxAf{AGwZfp(=oboTY|4 zJ;Z`=4>U+x~vQgr*QUo(u6Yl^RW&j zE0zOGPd|^9ZSTo&$czzS>K-gvrYU9}xz#B^0^@@Nki|r&>I;UXx*LVS?r}|_meMhV zp$WkGsg-tzhE!OTtPe;L%RaJm^H;XpbtNr^z{ndyRCCv-s7nI!V9iL=UkO3a15pt&0z zK+mPix}ncl=eX*V=C1{)?i*Fz-Oj9=k79Jovft%7VQL(+H-)j?b!{yTsW%0sw5Sox zqrB(UQLDcmCcc!rA4furTUf%JeQpwZ_0Dls+BD7iB`R*$DOt+5sY)v5bIYGfR-GxR z)P~lZ6!zBgN}E%RsS0s9_(;gYlZ^B0>#IDHQQ)1Z+jZ93hWy&0Kejw~Kn^z3Y5`z$ zNx|vz(!DBB-PR(ObGJD((7h{p3R0T1{Zt=JZW;U-`049PS?0Apx8@$fkPh^$9mzGF zPHU1=j9m<7^jUEnQjoNqeR0V3gWe5J;rT}E*zKvAEm>YF$JHEU1#SXvtG7Okmo&O()+3=x`{W|?IOz(W=Ag}Up+mmF5*6)PmF zr5d@_s^4W&ibnWEB%XuPq>*@Ws^z4XpeZN>?(`ISW3Mh>HA$}eD&=&xz=+&Qh1hHq zp-N?YNbelQOM{xSZ9WS2$*J%9WaiOxkq9W9gdC+=<&}45ok-$wZ-^08gvQh>1su02 zAm=_jxz?9-16Y6@9qJ^P5)@RB?i4V5Gxw^Cd{}Xd zR4lsjn~8UJ5XHk(yjy4~2@N0&C%g_`%8N_7-0!cl?cU(@qSBI39#JV7Q0d`PncO~H z0lr1%8e2+2_7_G@X){_W$p^Hy+?bM<$SQYfD9$^G>T`}>8KZK26>(AMa??)_F`e2i zB|<8KhH_6cP>G|qa48v909Z*Jl6#F>8h1xr?UCI;wM~-q$stNh1dh)gLGkp5FKsi; z;YIYkWHyIdK|cZZNK!>;u}Q|trjxQD&Zg9mQh^%xEdc|XTXc+5oPHo{*0ws%thlxk zp@jC_{w&t{IwcVuG3M%ck)8($ZEc@R*;`Yf%13Cc^euq}MQcF-W8P0@{&hE{K zx##1Oo`by8^{0i><%AIWr3IV>wSlOeihrZJS6W|CYC8o?zOSDOhXOK~a(Ip_sO zUJeDR^2%EYINgl(tG?&Ky;rD;3pSU^!2{|}q^pqVbJCbDoDjWQdsi-Ll9VAk)P}%X zlkLYN(zW(wMRz3mD@Ir85S1weeR@YDUehW<9!i*$`c@WJg@qAebE+86EY{eOvzI+&e-x$k`hjN1$PgcuRK{&`-?|vREuYUOe5Som|FcME+?Wn zf45D0+qD1` zBXK$0v(Q!53x-yCSZ&7GOP(Ex-Pf)&(xfo>8>bbW^3juyU5EZVw2=XNf82A1S}=7wC5mz zYry-} z@eHdQw{ioWG|EblOI?zRj!p||?)j>6sgA>p;dYH zRld<{Iql$u9E7C-Cn`Q1ja4P&tg@)^QhkG}!(^ZCWx}RJb0v zX5eo`T0(N6y~L5%9+{?2Fk6)_HKiMY2yxwm9M4L8;W$FHOhB$`OoxZF)9FY!%(Du^ zY?9C*huml${HZ*?K*S^5IS>45Hro_c_XsD>U3HgTx7b-?liZ{u9fW#>`y*<9R0Pz`DW~{-L3cqq)UMbgUt-=1QJZLx6#w9}3wf&2(U^vya*|zI>Jj zJF3>=D{-L5gFZS^gsuL;Wg`O{dV6zK1nZ2)q@2lhDBM5+T?T6TA+;JtcC1RPMZ}O- zACkIZT+Mp-3TjihMk(&d>+#c_k{TrjGDXeoG7+wjVP=9JH&|( z!+tz@LD=OCNiL^wQwto_2gqxkD`syk9R76t_mUeC_mwLksGL%Uw4KQdPj2HaHj|yC za?iBY#R<60Ik_w)O3yIhc+)IZI1lpplY5$mxpO7#k_>+0XMVl9Ckb zK|2S*B}vEKrk7#KLN_O~Dexwj-X<-{F0z*tls2-~(0X&N7Kn(MbdMQo!*4y=kW_P3 zmOYHwJ639D(K0~Trjk~Afw2F zU7bjV7{XgqWRbK^?A=%}u;SVTeqr?hvf%+mF zI3VN`k5x=@^J2=AKHSvA_Ki#AvPv*5(s`ec7_S>w7PCa&DN)9{P~%Qn zfAeHt`iAPB*N3#?CaHLC302wAvu?$M;z8wC7M1jL^_K&swjuuj-P@{vU%LFRBkF}Z zg{9MYluA~hr6&i+rG2mJ4tsQDRE?YpGeiS!dyA4 zCof_E7KuFjv#``dM8l0H9EsBQ7ZCE&2~Qw*9{QO>dgRJU*%3{$b3mj+Ss>#$txnr! zkba`-Pb_lv^{eV{4lnU-FfWj;@ovpra`Z+mas%&dNF{1gI{G*yj{s?hQ)sqEs~{mPC8N-SGmD}G2v6}#IklWwP+q>uQ+kO(a%V8!2`qD_$dIgJ@CV< z5(gpL^QZMW>7goY9m!BR6yJMx>yIJUk}~q+>~)vQa;z(FuDXAPHp_are*UMtMHdK~YRKi>TU;Ac zGC@|q|RZaH#`uKwbb)_vy;r1yLD!x!^eC zsOA!^s;;d^cuu+DwZ~RmtXAlEdlkYnF(ligt~(PMk&w2?SHmgniOBFd>ME_CmXwtz z1gLJo1D7oF`=2dmC@8u_?oANKZL4kKl*>bD&m_1qK&35Nmi7|V=&DvZ4wUD1j8$!E z;e?euruQ6l2?mLX`5p7B#Ub+y+*tn>#nB>aW>^Wuq6J#Bo$Wg2GwR$$e`(*U1PH@*5{qdA<_W| zLOp&o+jzCWW#vj)aj>DeNlG)fCafK2It1NQdXa37#CU3$@?*Bp!b3?>NXNu8Q5l4; z-Ev=4vcOn5&Nm&koT8F1d|1efRh?@|P0951^mbFtyFfX3lO6@7*JenVzRiuJ;b*Sz zWiha|rL>^r?MO~fs;+M)gXg?JhY^&i$C--zfgR(Q!q0H6wAj{1MP({hMQ&UR)Hb$? zWToXT8`Xp*SQtpod3O^{OzA;okR3`qe(Q%&7@W`+(oYz_Mdys9Ej^` z>x5wDn9&Z@q-EbbN{aD}4pk;Ys(yQ1_N1&NZs}3!%iD95l%GK|6p#moE1xYRWIILD z_DN9HDVvk7p|o!)Cuu*i=bm+C+WeVsmq_TE!}Fao8xL)68k`NN^g`4K8TM6IY|6vT z0HCF8NWzCD72xvrSJG?B?G|1ZAYZPUhS<}0hMMhdDncE~S_B1mk)C<3ym(WF;|)ef z81Qgh&J?$0b=12$LSK%*sxs?4RN8^TN`dFjo38exNseJSv;?DSQI5FJPgQgel(A_% zNRabmEIR@!nNcHqsVMkP6!lk)Q4^hPtfeYRB|x8GJu5jS(HP|1NNcg9LU1(gy=qFq z&K5ANQ`L^uXuQ1Ke=;mcSi*9lgH6|*Hi!WFTiPmDtDjo+rsSoooDHLz9tUx(eW>n8 z+Aa23{50UDyNOPy$7*6hmSDzVl_g7gzzJH3=#T&>;>UeUwRe(0(N@EEy+pahiZ*O{ z*U{+(k`k-~k`4&?#XR{sMtV+zea50b8(rdJT6M2QNmfFNcMfBrt0T%i*onAl){K;^ zu+uQNFqikGrIe?UA7nQlp1oX}c*h!P95bAh&SQ}a+%^OoWW}X{oME6;tc-YgR66Mt z!wQofmRut$SaBI7clD{Y>PbG4QRk2jY9nz5RA<;ojKZ zl+Cq9*m;tX&#$Vcx@ya8)LOpPq?(G$KIr97IE3X$Y#@>bax!oSt2J1(M&x#91PlT^ zaaRWk8cKMrWNqZSqHT_?MZV+N@+afK`0Dr}7b+%lq*%!Ee6g7}SP}HI(_Yk!?}Gbo z;irjTrjm2$mecUPbr8Aet2K&Dm{DOE%8dHhaVdLpLeg=_{Qm$QbykJDs?)-~P{c`0 zu1r=#*2Y{$*JBq3*NaN)f;!{Axw}(s4lJ~krAQxC0B0t;vSLW&SsP_5 zgUv*PljBiAE?v6fxqb1_>h==aKko8+UO@yh>>ZC1+-N z^2QJ0t{kyZXJ$2Ify=};ZEi|T2+5K;dTkB4130U@g&YsGYAq!rQ(P_aZid?lsq;7b zBzCG8ZL#0i?$f&n>6^g35-`8QncOVU>jB{FEYyQr*DeAZ*%*yweo z1*Iz^;DUFI*Itqlk)EmSTn(DLfm%CH*sWTk4xED)9qFgrU|@$^QWSS?=hTc3im5x* zqRzlvc3`%a$=sCWs{^M~?5@A!_=jrH77aNDZ5Zo~TRq#5TaaKzT$bXX1a3Qy3BUx3>SMwC4xeV$)XQzAQf|pdYQt z_+2ZRyq*G%s=r1;h*Pi@jl-BJON4w}hCV9q5p~j2ay@b805y?Hu8)w6&7oA=JgTMM@h_)Cf-BZbelWTYM7XWor!ufPhe}W5TWeDilVa zFfx)zX}f$!?lKTNSyCT-`Y2C; z_EpmV01k9ioetKo(e|aLG9L3eQD?N0`wH;~zvInSye!plENQ&hH7&iz^!}l?+tWD_ z9Ni^{8&2jQLVOA8JH2&twRY34=ymCB804`9D>7wDxh+0%Eo=BE2b{us~$7Kmn45UyU@r?s4fjWZ=EYwCXKv={3=pHcDDYL>%XPj_QAn*DNW%W{Mztf#UL zAn!R&c~paf@LB5 z>pjw2x9csr4f(W1NJCDv-)e=p2f+$RP~GAH@2s)3hIu>Sl<4y&deX`i;*z9=4XzaJ z!9B;PB9s1gV^+qK8K)dB6TKuQTe3=NPLXyp*hj);PNfCMoJk8w2?3r?1_pJ4nWmb?xA+PG@pQPHmk0 z`L8!qQIXk+y|gLe{7=sJ=aQVbh^+?koTn@2%y(c{LQ7&h+IvT83se@NiEBy_KFhJK#=DA>zy)a!6?nzNU!UOGNgHf>h{i zq&RW`JoBFOQ#}_7UCA<27D5_!8QmdnoE^EwKV(Q9-ZamzVnl@{3uqSGL#a_t+$a)9 zQ~f&EuNd4c;okQgqcNiwS<8yibswJ}3JF)LqAx7G`VgJqhk*;vT#?s4(^E-#JVcV( zkg^v&>>T$HY85eUqYfcKBmxRgG6*A`c=_Y^9*#ELPMqOXOx?AM0HJG6m~~meRyKs= zuYL_E({bD^u+~xlX(MqQjYIU*jYVj1T^CvtjY9FBT(t+4ivJgwPbTJ+7m%K&{27iA@6{Y@(6_o|5Umx8ABeZE4< zyEd-MNGm+Y)b|iQSvA#qP6NkJ6~I?y<_J<<lL8BZgWER=di zy=;+E#caSjrMRVY-hM7N_IJQyz@UL5(@yLADWa&gG zS!{@i18*&qw18EBPW*HBimvV(Tev)q&yy|@?d4VukWw17Sr@%PGNi3(AQc^s?l}Jd zGnIK6ZDe$JNz@U1H^QfEjGK%4wiA|kGF*prl!3HHd7yCaS5Y5Ur=v!S+Mj^h%Zc`pasan8$Xb{>FZnf2FJoy&J8oj1F(rQQc1MoNA(4Dz`+~fZRBMj$DvA{tDXFqBB8G7_F77 zrqqm5y{H3d0~8IJ$_WY`#N#zo_@a%pB{t~kB}tBgv(%IKsTqvYR#NO%)=B#wlVg0-X*N4&l^WknHrAk&DL{gxkbXS#tTV1G-X8^sga?~|KvF{CGD!+P z1P`2wxHx?aOxt3@*VCjMLl)5N8l?J&)z0~G^N5PJG8E;sAtVOeBhfh?tk)||(<_=jSm^GU zg{M<(VG^9Y%9`VsM<>K@^O%O>$!RFhFs+y>&v~dP9UE`nL}D9J0_xThI-X|)czY_u zR-=Z!KMoFxyUDjifY7nIXp+!Vt~Sx;>0VD#qH*lyP<}W^VV)Yil&H8{ofz*2B%e!| z@I0~dSE-GEX4%CD_i#3FkpUVgA)-o}n)oR_QhM{GymCsFqaiOOc5~832YxAU2YUgd zoJ@77l+JUsC&d2%*lTwhBct9AYN7CEAoKN#mY0%Fk8bGWy?NlEn;1fTOf2?nusLuSV^zSDkAJL+d`S`})u5Iz)a zDD^oCU*1u!bh$Q@+)8}vMZ#pOjMe4&a#s859Mo1$ej$_4a;J!D0mP6oo}Q{@xAO&L z0yh;Xlh&Q1I@=3Lb2vQHfy%aukj5$Sts z`Qi+j68Kv!&d+a~&S^69Y=rIAcMGeLz_+}O(QT!nf~I-rpRXew0IE+%5~FfPPxdb3gZm*; zOJd63LV`Acq^}`a=Z>|E5<%lqCNV>5Xgbmq;abQi7zx4f_0;D_L~2`uden@eKqR9* z$M94l0)pEsK_NLDx?~QOKG3ASDF{~dq=n??)m@lm&U~pygOu-)yw>$`XE_Lz;U2sy zyxQC;xXP4+sH=NU(uCO_$Xe5tL1Q7xC#@SAgT2ZCd zklWshx%YTew1k`xd+GUIjPw6^FyanqQurT#_tm*(o;93jx^%Hv5JiVgtxIrScX+*i#_bd;vprMb+7B#wCR zucZD%<zohcCx)sR4;0K`w;=e8NXj_bbiT*SQvrqUtnpUX}jD&rhK=cbEwZ>BUnaITvs3u&s!rcAufPP?GQpi9r&OqDT172=ckQ(-ksf$I7vwx z`e9Y$WaXbvTv=i8kPm$qGJdwnAzZtT!%@B-2R+7p)r=0^!P*xJa0wv%-QE2vN5Vz+ z+LG|F&_P9&^UJ&h9MpG*?W^1uQO}#}JdaLw(F$f#e3oX7;>_I+)wVMlI@fVkiIpZJ zs(7;ccQ_Ub(w>M>8+MMl!Q@Rf>#izI*N_FGPMeKuF1X9nTxs_dr;8z7juL$oC(=DU zDn9gWxe5f6%_NL%<&65Nt>%**Eu}n?IUr{|ySejv$`f68b@Rn3dqkvnnkLxCPE=u-3cAuvr5WP78U}5QQORN z@%z+|Q~>0tXKBJ=AbjSq$jx6vQqjo?BLjC%2gYjeO{M^Jzbg#TJqQhIL1IYrYF>tHdn}l>cwM{KXH_K8n0>s)e%7>DUhSyd#R}% zp+c5i3EZKzVL8C>08_2)mc7llt8$1_%PIj}z7I-fE{0p|`Rqbkl5Wd!rxLKB7M9xd&Pdu5%c<`;t(v2YoJo69%GGab)T-}r zw|k2Gw6s!{LcvHtPcKUZ^P_;yMvK9D?Z;D!lRD_{)B=vpn-UK$gnA>F-Kd_aZGEeW zFE0m{Tuv3!nCLlr@m{8;nn@gLJEd%d%t}E@H!BGkJC0O+wAm?0O``J4NKs3XTHLP; zI88cCYtu+lLPk1wQ*5^zV!?Y#Rq3ggl8;#{=U!~zgQhFPBj|M{1zFm1d3<$wc_29* zz9uPoOv+!W&}2|{)w zI0))eeRX_sku6KQ&zRFscCH=DTdT^!C!kkcda8`OvO}sl>Pl&;jmfi@PTylP6keFx zUO640_&lkC;zDOiZ2CnmEk_;a6#T*iQ`aXT8f9=Qe9aH#^og^YDcQRdDvXb zi$4hOZ?7+}ub^B;OP=7i+mFd&BcUa@?8pUU3H19_07}R{Ij?g?6)ZfQ`RmEbI;Kp8 zI_Y*o-#n9-Us{L&U;&fdDhV-bF5v|sO6At4+L9;*;FJP4C<9O#dsDk|Nl@<<=H*)^ z(R_czXumiMHpG@tm5Apn3hT~|Fr^#RMnO(Xp!!0MONQgxo7#V|N%`wunqOsqgCQ;y zsV*pur=LzkonpC~HCB$L@>X@_SkoPGkmDZf&s(WZRyUtTDoRIHZX=lH2R`au#sn!B zXI7YznsGl-bFxy_fehZibC%^!nKw-a;-$?wJB6;?bZKjl{^AmQMpyJ&PHs>wG z1LMmd9y{x25?E#VQk;&rS{JW@K?@*n}+&AA8ak;)uyg!(a`$@8_Og2AX!g%P*BSsOh_fv6-4i zEVzw{V?CQmLO@$R>PhHMPknRlu#V$19%*S>Qi4jk=LbDH*G5}hiyuiPz!m3dj)b>` zk`s~5Wk;S*fv$blNn3K>4<*h@z{W=6d(Vw}+3Cj7#TB*DRbCamyh=8mgcSUo>LGVp z#r|MI(g9jik~8(A{q;7zB<)*d0<|ch9`JlB6Lu0C)H2)J0>h2&NgV-5=kprzb49bd z387+%8WLNIa1PEwa8fa!L#1@j2~^p$T9CtQalbK+{{Up;V`5YWc@xXP*D^bSqGqK| z1Bp$e9p@AdK|k<0yFiL@u*_DoilTJU?6$ybn`s^FB)pl{gKrWHz?sNDfZId>lM%8cvoj|{vrCRA4~1D+e7pt zwN0pwLj%-BaYvKeiep!56gGgT3<)X;9MnN`nFG4JgM*T-$SjqZNkZG&`eZlhsN(>V zLCN^5*wDDq&8k$bl;;!eZ^x54*BrVLZ^YQPl zq2ld^Gzrp}ZbxjD$SP0=BeUm>daIjtR6^tELu_*kLc+GBp~a#ZfvE*CO2Iy$obWnQVlz>wMc;D8jj?!n#{Sc8Jqxb}?N7S5gQd=j(Bbp!LgPttC6Qlo?Z(W;-Ny zrA5^3!o431ch?@aOToUGHbpeAXYNj@A$uK7w<*Bx-PWZ16)xvgme@#BaGE0-!a#W$ z$B$D{Jtetu@2c$qO6^{fyazngr-CgrD&?pxDSNZHOMrn53Udf?z~%I+kNoGJAYYJ|fkRh!d8FhINj>$^n*JYa za*WwfX--RF0!)M_VhMSFRB#-U*uqICyEV?b+50q&cY1!sb#CDU-Dg7*+XrNXWgxhK zu48sHob)y4YWv{o!50)O;u1%?v&sri*vTZ7<35gY^H)o7{`EROh1YWI*O_pg^Bp^v z;=kEA897RUUr?V*2X8-%HO+iTLRWO0wj<#RjM)nrBw-jNf!)r!8;1ItHL3)dQ0-Rj zTV~XDt8)@Uj;s@HkKq+l1 zIYLTRoS$DVUZYjSG?S$!7RcBp$56@t048e2;&hu!8dBqLeoJgzWnUo(QHaXiX&CL6 zu4fo4A3ayGTG^& zMN*mz1;C&{@lUj3ulPEnP~GkJt7M4wh%jwMMmsi^Qp!uJ11nk2JcG{_7^tRB3ll`! z+mQ58I^gO85<3(!*eY4cIM0vAO*~GR!qxgW+Dp zCm(OKi*Ma$GU^SHc&RCrwo$TjfI#lbDh)j;56Dw##uTG~dVs8R`6^p?zT5BINt1Q7 zyV^y1;q@nq0#fc1f=b6vTUPfuDNc6GVhX+D%pHjDC*D=w2 zd9+wB*5)lY#>pinJM9qL;XOAru#>x}-Q89kJ7d;OK`%<7sIo=AON_SjYYJ`F!oH@j z*%CYaL9Tn#y2nfe#!;TsFk+%R$dI54h)78rv7Lt*Dd>9DuVB@hQAusTeYQkxDI~7q zjQ5_TgWhrBR>e5k&6YBe)4D+o$%umLN>bZuY1MTch5Z*e5@YeH2Ta+cbO7PzT7JxFy)C+4d| zS_hY*FIfX`n5eJSfmL^tIdO5NAt^y7&eGOYG3f^~Z~(_rYTecBrCK{sCB+n{-1h+o zm_Cn%WrLWq*%#i9AG!phfOCl_2QBpF!s6oSu zP$vZXsvqR{^-V<$y~uMm+29?#f!d4@W=X4RGDd&I);6MDWwdrnQm_F~86DN>Oeszj zsVOPPBc65X4@i|LDOl<1tz-tUu#y}-M};3HlVy9xmlT~O#u5P&04KcqCb{clh38h4EP#@d z5`e4^3>xU}GURA=Elq_HFkp`EM!CttrLAZP>YikB^>RKqC+Dm)bw@@rz=;Y>J0+4t zgefh*9EKJGQVId-$bU|CD6zO>zJ)WjrIWvS1bSG;ay#mxx8LrO8fF?~2P4G=EVSy1 zlGrCCARb5=>Jxx^)7(xY++r*PY>wePvRqit?oD9d2-Z>G!Ft&}7Z3}9O58rEvQ_B# z9M(A38@1td`Dk%nn=;}A1L%-TobmAk?9Z;MCV1nhAt0tUo3xduB`SBdbC~sJnl+~w zHI}}D&7$`zD=-^U9P>DADWs`;(~aAXIb)VReyZw@br@}CKE~M=p9R}U()T8DgYJmP z2Ot80{{H}$mvN~@d_IuQ(xA+yPDd<^(`N!C2kf_ndI3Ii(y$Ina?s>{N_gVh7WWRW zVXy|r86c0_Ryet_DDrc1R8oa2X~Grt-0}@f?C44?)}@&(IlT%b4r*)#9B0CzPavtF zbA@9*+S1L&Og7fkP0i;S+@e9}*A;}G)@r%nwjn$h%=eCi08@iXdns5+C`NJLgH=>* zXQ-njtq#W=@-WaH-W9y@A5;UDrLc|P31T)>G3!y=^Hrgh65!cv>twt*X*q5s=Fq7P z5~W}z@7j*Mx*u3IMaf7^g@l}poElqs)_RXrmKeU?mnEcn47G-WQlZf8P7*#ZyGT~k zt*oW=sS57|Oh z?DeeOj_#?vE-HhKna?RI_8$6=x!Mer4@tcCN7wZ}zbUUxH1S%TaUdnt;W^JTd-_o8 zfwX!%kM#cla%q*@vutbaqH{KEDVI4fTOBUPacLuP2{_rG9~yFkr<4+o$6`RL!G+9G zQi94;+>&|LTz=|35iQkY_FSty=)9tf%GAV#hW@6s1gn`|dX!1>O{^jixMV zsFL##_AEBALUMW%I@NNSHwUoO(wBsD8BsX)SE%vSv~Ovmgfwuh1C#3~!nKZCjR?{< z5s-3roOouWv8G$zwZLt;3okO($B^a#JkBxCl}3r%l1@mZit~lIR+qEt&OUm^eS*k< z5b{zG09SU^0)BdWY=)7C(yh2B(kKHs<;-)cfJl^->`L>V;G>_I=DaRL{L&mz$URG* z9XXs;;K#M&9bMY4FAwetSqWSOBN+8_su`&6$U##v z7V!vCQn{U{9rbwXx4Ug8!mkfyw1aYVVJPxxQb2uWT!M;-?(Y<|qymC+ zQU`Y`ZJg?pCC#V3 zd3W9$ssqzgG$v@+<4Q|v{NW=fJvn;og7u4GR##L)$wMOc_hfV73BK@FYI_<^C zg~{M{jvmcBU`XmS>*Zc%v-w4uMGUpDM`TPm1e%!PX5Ms_J`Y#s$#w)>OxnmbpxCC?z_kwx|6!S z&r!)Nxgwu~k4=IYTX9s_oeEDy0zu`Hzv-q8UFM(-aQ zt&QUHNetYbUoL)^O4aVQ(Q3=H-cCEkT3M5JTiTK=H6F>b4&0N_(nnUp2k40kC%DuN zcRP+rGMrbfRq0Y>Jjih_dPAuuvX)fcg$B7MF1xt|cB#e=Jt5Zyn{@@rsZ&@nQSc%m zr5tzl`_&jj(h7I>=OEI^>ss5~SD(F9+@#AhY6wcgO17)(apPC)JxO7?Xq!K|mx#!c z#6&Rkb+2lYuue$!{pz5aY`CzTsAs9K4##zguaJ_Jsbgse85r=ch)-(Zjl16^t8kMI zE;+huN085?I+~8lnGujPEx$yQ%=}~SR3**FAx|v@U2<`n!-;sd8{F!4^(q<2tmQX$ zM#!hZBfVW9Pq#w0Mv1mWXWw~m=K*1O019eHWJ;2xDJgAvIT^?VkDi;t9Y{*BrG*ej zKMt6uBshYS;?Or>fRcHf{{Y)mQ)*U6nlEk*aUV-t_;V{nT<+{zXR|5Cqd4fwTnb7v z&$#kGH8koA^@+z^Lsyt`Qce)0t2wG_;Q~Z1$u6w8l_Ppd?gzusOo0AQ<~FY<1HU4p2xGGu3Q~r8 z^7#+1)mTy%9o*Z%BoJ}o%fI5qVLjGghtTYwssfRZ(G+qAEM%IvJeYW;WZ|a}6LHi| zG}X548Ow98EgO=_Jrtli`wdeOrZ(D2Rq0^z3H8&2`(oL)GV&SPR(B~mIU~f@*mFEw ziSrhYjN&%F;q}_)`Lyc@vl@A^f{>sy>d$plcWd31*GgKrHH>5dRmxdONJ%pm(HMGwpE!!eGgzJhwWK+gbjCyqj&o1!yoI8*mTQ&oFB|l9Zm}V3JgY6E0FN zt6@(s`xzxE0Atao8wdjR4MgExsZM+iG^WpV#`N3e?dqZ%Jt|G7EcYc{*_!NES#6-b z%36NA7#_-`X3=`0;ovWnW{Ba2D0n492d#N(47p1tAdz&S# z-3V`*y`O@*rK*!ujHQErD3sp#jRNMfu7g5{6rI4=0VQSr!=aA+A9Wmei zJSuuMmFIedD{GFD zFrSR_r#)4pZmU}_MT%T3wi_*EdR)5l`93;~ZN-*!(Q-lZ$+j`4H+%$XL?Z*Mj}?4|tETj>p=~NawiLM7+7PF4iW}2+=YrCRY>v+x z{;8e0@g3bOrdej!1|H0RlNL|n9J#7d5SeQ^Bat{g)Y%H)g%N(gn zID2++l%=_m+({dWN)}QFfg{;k%6TWz5sV@=+_gQ%_Kwbcl@@}+`y~7ldx@zAjawGs88wAp4NedAI!^#qdJOtwi%`;>Ff81Ah0 zzb5gN9~MKc+Jf_>^+T7NB*!C5ZcCvn9MZA8`U(T8agIloTslw6_lVj`V>4c~ST1O6 zsYqq!RFI|Pyo1nns^)H%vfnQ2U6WPY+YaSxL!+vXGmmMaPYtCq*%I$o)>E8?Ixs5u z@;q;YImR>LlO0#(SHzuUU3zqDGb(xT;ad^NI6U_A=gORYRDt!q(Iluk;Oj{g7}cfDZSEGkk7OK}`HKV8qIJ2k`0GF{reYS~Itxk*f794EgS zr~9N{9?G*fXq$fxJpr@k?xnNL5zjoUI(|eS!4%URPS<))CzxsL+tK2%Hlc?;sFbI{ zIp{r=YU%#~E-pOjoj&z}nRW;K<-a%c*;eiH8u1ArfPPA^lf!lw3(uR?%}8lKqCCq4 z?N{HXR&?#2Y{!^|s2_W?SEi&eJ3olkv1Xc7jT|ET9JLo5IG3p;s!iWgtlZj+ma_k#U&#=37a|0qN?ei$4vlcV^mI0X>S6prb+8%(=YToFR+m{xz zJP@Y)h6g|UYf89PYOp`&Dzd3TDmxOnN;^l64@$SQl4{vl<%@KP7PoO?e{8mjikm=6 zPCPwy$qMOpwYsxwxXg$g0ZI+8YC-s_ajfRs6)7=q8g2If0KK@|+0Hxb9`>{%Z6@%! zQo{&qbBIg85^_0Wqics|kbA}$yhY+9HTLl}mDz;>j?oXFn!H`OiNs6$As3Blc9?`C zZ>J!P^Y9p@FyrZKoX<9kW1JKQGN}XrJbh;!)iaI4+cWL6AlToG)4&FulJkKp@yCr> zWS>ZhG`mGcg-UWjlH`>-=m{I%UiFem<&(~(7S$?UihIaOQ*EuFtoI*JBkon0&jBs+ z0-kO(eTh94C0%@Z^{p2jJpPooy>DXEYLL=$djRefuM_K|#VK;gjMbE+l9%04Ks?9; z2DO0WK(@rm4W9%!M=zG9_Lp>Z=HuDS(}pAATT&42Mtl3|uJv%UTcy0!ro$D)N5T?a zSy57ok380U8gyvsp^Y~?yJ-5I-f&6eaV21%kkTj7=OJCYjwvcRR`rrpM~+Xft{Yy9 zgsAPiakj&4PM|rp4V5c#9Y3dyI3q-9wF2NoCG8%Pdmt1Ku>4ig6(*?3#YOT|x^_d2 zT;Vp})drnHu%u@R2cAA!^Qag$yMxi*Q3Wc<&OyK(emc4#X=`KvnQ;3C5PcOmrcgjv zaL@bcz-h}|_Yft^Y1fmGvY73al=tl!`?Z?Wx*p<3G@ZQG=|&vRJINXFp&`D@nHs?I$01fO=M&&KuxFra0c78gH@e0c~ zNm$y{mRXUO)K}YXY*{hUouqP7PCC}VO_452$2?^r`^knBh{~N2*Ax^i$zIiU$7xqK zr%G3(?`Tp8TbAd_N3j)Bc|BemyE z>&YqeX6;iFgoDkvTZrfEteYPZ$`%E#a&V79UTO!;n&QodQ=Od<$rh-u4c}57rAnGh zL$79edpS}^ebShs@|l|Jgy3bf_$t!(t;AK3u?pZ*x6%QyD_PO}L3EX>6#Rjaxd2vA z4AFnJ6@nmLN^mWbi5~nSnM)y9 z<`3Sfj|p_J4+;?JssKK4ym2*-<2w;}z1H zuHQcOr=?n8gm$kfB_&4yV?Tzf@xkp>=-%?101O|hXPsf0SP3A}zRup{l~&bok5S+SsxooV1)9riH&aNe+tSnb9^Dc0 zMn|QLej3+a@|a6)sArfw@NxGl&{qd8%JkPRGip97uPfla-R9KUyGPo2kb~fR z>KrWxm00b;GM246frijj6D6_;9R}0>>Xd8LA$k()89)%Fv`OzCl_bzQHT@A5;)yRM z#7l5z2f!c0OEtMmnil$6Z7JCu3+8#89<_XN*o?Psl^pAG)3N(wvgsWIpCz7SnWU)G zaf){f%wvwbK{)I956?)B*(bJ9QBcVMo~ERFX3Z{ei5AgsRI81}^v90EQ@gZy{1hv| zC~n8CKM}%cx_elFX$IDkp>$Vh4^GV2qokT1mz=tyMn6F+`RefE7Z0o&23DViV!E#B z=N8iB#d>y$KI>6iS{N&iJy5W0Z{{elbpQ_o_{`SfPKR){?YT0 z21!3RvbCHxBG~1<7-~EfE3pz>TGTQyo|L7%Kj#Wh=Yo|1@JBTti`n-mvL&Y`IN?wL zHga)Y2NK(+Zrn6x$)(j`dj8dwS4lD5jzqN~z3O#HUrdDH8suu&d=xW!I%C8V3bWjL zk5w*D4&<$#-R2x|2<>TEQQNO?pL0Zk+_RX*h0xaOUn_81)*qcpECsX|w8U{K@Yz zC5J8Sp>bmN&jdWaMJ=9KBAd0{oy|Y3?v}aBVQ+T9=FDX6N>Z_u?MHS;UsY!a?h_;l05*NgT(0Ni?*p zV-G`>c!H_yw6VREl9IIpkgSe;hzH`XXUTUajY!jsCBmh_Ty+DnNq7{vo?UU^dVF-b zy&)OoWVDh`B;@t01ButIBYM9(Cr(=Y)kHGm@(h(f+bgri(T+*MAoK9?rYKGjgsJ0_ z2qbjJI?@p-?nsVZZ8Ef_zEkj!-pAV5zeF4oIn>JX+pFPk4#wj$+7l{WYIq&vX_`jiK)>G}8M}fOjq%Ow#Fp^460*7D0U9t2tiwe5v_eWxv zJnC{v1d^o;L6P;p9dT{>DOH|IRgz0;z{YvkVf_o>%bJ5uFU}e+H9B&8KQ}2O^Mst? zRpskf@n(tJI`Vn^==bdv{{YOdh2_8qe<{WfjGZ@CZXl=X3qbem%4Jx&69I!h9{`!P)`U_Ix!-n&VZHY1(WyPl(f)ub6enM*U#)?6` z)-}1LS$EKBrw~!;6oj6i7kz0)mqM}}O7@OKxBuuik!Op4DkpRMy;RqSWp_B4gqo-gY2|a@Fp`K?0`g^nDvPdo-UsDOdSAOnw0M_vBur(#Z+i5K>EM){CO)q*>N5W87cqgS-+le0I z@ZZiHE}e{$qqS~d zXxu*282D<=K5EkC#v{%JJ#B0ct|3Gkbh?lrID7eE)Oo_#Z#|e=(s|~oe9<;b?3!v7 z`crXj_T@P0(4~;IdI?AwB>Mb5I$1YH8)PQuKWc5r&N^94l&qHAa~}iLaZbD%VoZte zwQr7Il_D`^kWxMxh}tlE9F9i1V~UndH+A6!=Y-a6O>4N_v@8~{NP!tSnwg0p$tzwk zKud&Tx@QETXEdbu9CY-1T2LGo#(Cs^j7T^*<;t{)EHa29ozzY}v`K=&Iogm>k`IMHSm4CG%83>=y_Lz3=V!G1 z1Y~nslb-KoL<(C2a@*!saf+Mpbglj&TAC`!3vjjvB32Mc0QVEj1M98ut?Z=wEem&( zZmzsrm2t3H&C!^vT1&`dVxDmWD@=3{J4Fl-d_Vk)%oDp66C3EHxi5=P*CRmXb9OKoZ^ znj&9K(Z6&bN-i16m;;I(u|4Hq2%hpusmzw+7|HfCyFE;&5m6Wvd=R$CPsvCZsIMkS z3o#1EcF#m6x40X1NonT};;){YUQ(Kzq;=1Kbz;{CT6>W90`9}{q&oCSYI-wWvQpYH zzXxqzTsZQ7ldrV1x|mD1wjngjvK1xt#YAMfkfze2zDJP)xym{~enJQsTxSoX)Mpjj z8dpiLQ29P;Z6M9k+Qq_hERvaS#woLDJ4MgIjROAw6K^VuFgU2M zO7mFJ8&GH!<0@OEa|p*g)W3+F6}D(-El+m&ZJFl}DW5mD-aO@P?L7Ab@IW0+E%HBl zG&{^IoY|3tICpnewK{zk$!w3Gq4idHr>qmH=cFAmr)>?unD*6L+Sudh-|$v^0Q9TA zaZ!rk;kUS_WwM4`?AUeSj(7@u9Mpd9tAZmhu$d$!pj1+qIUkyy?h-;(wQEv{PUMc@ zGfXp_Q;{Vve$<2#Pla$~`(2}A^>gVy* zut$828fqs%+IStJBG{tdwWaztnu9Jv*tVGoRHtUB0+qd#^GZO;KA=u2yVrUuHjlnd z(-VwW-hk#&DkIC->J&1S0C^5Xb?03nYrffT7Ck=XonsG7U-W2{+iQ~mNNMICC1f_A z9$dd=ileyktLz%rUQEB~77K76io+>an~3UlX-*ckG&v_HopxlywBdxMzL`>76CDI8 zZa8ocRp*uu`>HE*ZRk@`vSXNWq%ApCHjbRWT9D5!2HaBA2F#CX!KnT0_Ose9HH=3` zG3>5Mu4wK;(|5YLVwC|>R^nPGYLv26GCQlGxCO%ReOh|pn{#qeaD!#{Q35MntFj+f z(3C4Z2Q!apu4!0OpwD$hK?n&49eP(>c|Yov>8lLU9k~gUcCj@IGpwDZ3;0`#ySah$ z*4kWqn@qTIqc^r!9AV38=58TcTZ&P5H3{2}bkG_;apm;WiD^QINEU5e2=f zSHMW1n(aD}$ zcqyyuwk2($!?`|^oXGTu_EZkwwp?G;kW|}+DR3P3nx1Od^BC=%c?v-El0tyo2;_5B ztg>8l4lLs+>FrHdGT@v`iy&`CWr_0}N%R?zpn;t7%{gib%asDz6@H3B4$?dFtQtXh zY&U+mrKdRwj^>r>Ci@81XHm^PfLFKbgOzhG=<0kUvA99NlOA>W3sthqmbeqc zZK3r`d8ZTyRHZ2>`SVr|rc##r+VfI_s_S7jB+phA1m}x&3 zX;TgmTxDD4zjS6gdw6#iWH#f8$lj5=u6`=V6HZ05H{j^4Qx3}mi5i~O1(@;TMxM5s zVm2_^(~l2bM>R~wPV}TB(?|>2*xnCzYEh`TnR3@{Dm3jer)|<@IA4)E41JER-lUV? z?WjJXhuH;}94jhFAxP>^uDw+of#<0^q6K)8+NB{!v?Fj%GDm-_l~mDQ>?I*>toFg| z@9zV5O13UU2|$iVAPwDfRS+&JLKe|Z3*}e?!ByqvlTMM_gwgzW_LIXytfhpM7l#m19{ z+d|3a4hG>~qe?M2;~I8R{7en16}iO?$V%KtFh8etM}w|8qb><8@=etU3FXZ=2Olt} z{wO|_+o3jEKcla|pHB*ovJ~EfxIKe`c0d_D`%QTn+is6i97PLs18H_;#Y;xw>rJIf zDbCPUw;w%pTUyfp0I95Y%`rKc@nG50*|b_t)vS&~KCV^Hd_GIQc{M~JhZ=7ix+L!$ z>i5&O+nZLjUXuymFp`Ksiz#9OwflHwWzXCgYNkFEIXvDdN7Qu{#SlB^(x$>f|K zpFMhW#~*Id#cy|KGrI9>SIP~5F*#`&85lizQ)SI*Zd;oa5)0|w>rU~WRO>Nh>zP~D zRr&t_Dg(IqQ$_a(ojH5bkQ`YX`jfa!(l5*iW9V`53L@a>>Tu}U?fR(E;rdJ zMW&C2KBk`k0B<^8%F=$P*`%GMBqpZ2Zj(Dx%T#`y7;G*m;VJ>)ZDVy(wk`%0ZV+Ok;3S1aBz~>$HHk2XB4XX>OE360nw(kOA-HGJagsjjZe;#zKPDwE@4Ean22I7vRQ|WVO`C z9h0a_YEw!nacLM!i}6U$%}}l}LM?FSezduIy4$A2u> zRO8PFEO~s0OQQN~hvQSD7T1bftDo<UY&7rFum(IM$_Ms?eOW#)mbhj!lfld;O*&J98v9dwiE#z>a8m+ zDgCCfk_o})I#!p`8%a{ZB=`){hY17GPDt*guJ$hi;=_Qa>qT?A+)*aJ<4V-hG23k! z=t${aTuZ4^2WFK81BD9Mrncj=NeMq?%+|GnrG)@N9I`sqay4b-w{njmwV^;Mv*XX5 zZEtybB?-art!@>c(G|@chI}j7bPa{JfFr8Av02rKn97xeB&T`LTvn0Lsn9niSmj%t zN;hx9az}M*N=7gRLoF+_TEI}s&8F0YTos z7yY#X9`ei01TP1WrcGkgXGdR>#t0A=6iDc4?O7X@*nAK=Q%<2vtJ4>xb|fXp4`)8l z`)VX@jiZwzIFCiNxKyA}dUWN|ry2`U-E_LGx~ET15pH(buC6<)M&yIAWMktM14>of zl7J9-_f(rqy4bO(D0*UW<};D#^85A6KFheMq(v@T!05T84_0&4fwG^BVUEU+7N|xJD97qWCH)ED6_>~ouI3zmN9(BWO z;#cVeM?%AYWzW93jIFeVHsL(L+B`W|R$jk6aQ^)rDMI%_IPoMJY$&M-LIP5fy~+a^0G{*f z@2MrF&rJvf^{BiwqYb#Tg`66bTApdAQlgTP&!4Wh#^~piN}pV1ol7+;XymO&+sdP^ zEGyMg-Y6llt0bi>Jkpcw$>8p#7UU`nq-HiuIk?Y4S z($rihT;?ux`AU^0LxtB}bE4ec%%19w#Pp)ZCBm)k=hEZ{ww_=q&`=Y!r1kKsVsu0M zNfZRBWEb(UsE?^~BiT&cR&QmR*zsu_P~)RG^v|QqCY>QI-qQ`NAOqbK z*-ODu>w-C)*IQ|#u;x})2|c0#DIgDDPl}!`D+Vc6)R0$<9(ep7%4i22dQ*+5z{3h} zv)qz%ob;|o!J}J=3{{hiI!}2|iS_(c^BHF<#zDq2ie-vP3E70_<)^s8D$d1q9P{5= zLD@!?8}ANwwi)R3Qr}=sJBa||mc?-|`8Qf0$^x3cx`3>AWS_xW9cj51nT$G;a>Iw0 z?M-a5WzQzZT3S?0Yw;i}mm-1w`sj)%+DRK{0*M7ET5_P0a6Lk^9STA8j&oYxJ)#<0 zXaJOgPsLl?3Lzy%xpH?**RD+$bZ&z9805;-53CC6@1bb>&TDHcW_!C4I%>;A@>wus z{m;K#t8+&Ce2_**W^1Xwg;V?W)F|sidzqgwg%u6hFr{=I{VR)A58`Pac`GY77x>X| zvOtwTj5@V$OoqenEKW|+ryAaQZSm#t*D_u^1ZrFJN$B0uSV&hq4fS~Glm7q*Z8#-A z*0`sUKj6)J{{W_Hhr3}qg7k*TQBBTPTt8j)Ltjhlc;Ss=lviiY`Yxv?e7R#cbj@DB z3Q))>eJKSewB?LvttCgKq@`I2Bm<8MRD~e{MUbFCASi>&*IryXm7e|ZS=>2!E4pg3 zq?5NyCq?xLAiB^fWzN+>NJk)~B$LS}?q-t=q+tbMqa*|< z^3NmBJ#owDp_jJqB^gloIj5IFyQ$*l=}Z?}WSxP`f4-Tr zl!Jge^C#GA7OmMOx1kz(%ImXX$W(X5rI*=tD%w!ul&mOv#@cAQ-EM4LX3UQ|V^St5 zX_D$5J*18JDhoYGBy{Oc`e3~MotYc9lWS?SySxItRCeSZOUhcC=2TVVU6bY%WhHEn zyu7TXBLHL(jD5~kn8c+{VER3R$xb=@Yr^@B$C8e64|h7>30oPMrQi=YSSJ}Eec|h_ zHt5x^hL*@vhXZH|Nd))ut3S!rriTz>I^tM3jQhj3BVj2Vf$tv`Rm|*APSb=Elk;?| zYstY8r0Zz$pW1O1`~o?JW022wYkec8XPfLqw_l_|l{Op~*B%?o{RxMZ8DB512{>1) zJ=If9OKh(Wv^Qs8 z9q>ZCV~BUp7Nr8OH&92bDj4~*T~n!|#&b+r(upmFYPP}jNK;XegtUXW1OxyH$EzIc($h5Yvzt(oR>~&&%0h}; zWe7mX2m=XDdi1F5f}O+A3FnVSraFnFwDZ6y6O5j95|Y~|Z!G#_zPPeQ*%&1k9tJCl z`$n1U+yg7`74Fr&%bYgS;YeGlBX@T$`t^81nrbgWbQry_D6l4ce zk)Ksl8@X_8+0eWRQ;le=vXsDarO$AJfDY#Y$K9`Y*ywgl*#;?WqyiFq$nG@Zz!(Bf zfpJNpNalA`QgVW#%xxzM4f6)17jzJEaH6x{&X{Eh55&5=4li!pW_LVL zcJ^a;c<-+(EK}&{jXsFGO6=Lf(bI7__8PS9{hORY;rl9Vq$!y04X5FKO*#Aj04-H* z1vt`_5|U2ut{lD>by{`_EY8>34NbgDO~h#j>LoxOiN`VPA2n~J;$-Ew9t-yIfoMww zM5zT?3c?8W*nr9~$o;2#=~UL04tL@aF~ge4&O?LUH_ zE`dr@iAOb@BqS@TC)Z6Hnk&}({D|vlA#JeIwv~mBX~$9D&!u?}hI(eS7Y?4gI9mll zOyr*7is}9p1+i$fJsLZXG9xyf!FkHI{fO&ayqO6ae(Dx*7L*koxe3R471ca4h~pM( zJf|W_b(s)YEk6|QK_GMZIRJ|7&{Ll#8KTrdA|crmeT#X-vG!(8Iw=0CVS!y-z;>0E(z>NXST9 zgK8ixK$M{=Nk8WI*IuSkXEqqL`72#Sq^{E`N&7Tpk8NnsY^~i_3$kS{C%_C+}B}llgFWlI{(VFB+0N zs3JIy(h@<)$DM8;#;%FADbz4!$ZWP-DGa2m13O2geM9fpKkzMhu}#$d=o9Cg)lOCy?z$A0Yc>sV~n%RorX(Ma#e`D$^f?JZ1< z*ovlJeNoopTuCVjZ6gHj@Es4Xnlzr2yTiJ(ZbhO(9xI93rMH`PGFVauNK#2o(b{wG z7^^>1S(uk-k$H;+mY8QTnK0vErK9lD3ceSm&vkp)8hFnyE$=xmQ^I%#*5N|dK?=tr zN3yH!TH1w@5DLP)`QQ>yGlZw0@2gi>Tf;BRgShx5wzu^-d=>M z4qRor;{_ziZ9STBr7xieo&X}eokW)Y4vbDnVYDMQ%hu0L#^7>Kcj%QX;PihwP0K1# zD3IAwGt|#p~$%iw~t*)_(6Zuwy8HL_lvqM@+1^0D~_WrD0{I$=C zr8{RtzUbM1Sgj52Z?;YfQc4IM!5tDS8miQ^DNZGwn~(~IIp&;nt>;Y4lLjrnR_Ue8 zm;h;|-B1<@<&^@iUmYsqEQ?i!Q}FdBq|;0-N>66wdzgQ3F1bc)+Ea>w=eWsCqVF-3 zhsgl%TCff}9~!8kgt*~%2MLg)w2WW}e+64N-EpI$%@03%P0}g}3TiWlE{^nqdSr6= z>YYr55T^I706evZ$j_jo%OrC+uOm?7yMxffX>v$)(`6dP;=oYfA%{1lj1FU;KbE>b zgw~0-Tio`Mr>*y*i#(^xQ(f$uX(>+cI6?mSF_44aE1ET-LulrncpkA#JVCd#rvRToV80(+a<&kTfM6u@`D#nU zE7pac&~>gNXxQ;>P7vXhdP_xV*m1QgM(=`p=W(LEGLUr;sT=A2ykJsffS zc@^;SWZY#bT(%%BJCmGYVC0JEjWKn)O144M?oM?U$g&K^;-#ztwRKVU*EVQfLuRtx zW-93&N@`4UmS5}U>fAjdJNw2xb#-X&A@Ke(Qryj72?!u9U85^X(tFP?wYE8~j$H9? zlyo(s6gOeC+i61IaXq?+FrlIn@VM#P=u4@;Ig=Bhp@ac_l9T%|#>YeuhaL{bV{ferMbNXAQH zZVUiP>(8ODUFL_kO`NdA+>y_B0gZPwZQ6YN9A~=&oipke982?t#FQarc|Cp?Kbo9b zn2W}*dg8+^M{ZQmv`6g%%P1$1Djba?)a`i)^%7|$ zU*A(pt+ti4jIhC2S1e_eW9G#y4LjK^waqCUlz>RZKrNhN(o-!_Tf9Jp3-ert&uH7QCTe)wHT8;Q51m3VR$(~l%#j%<;3N!e5QK?+g^ zG1nQai1J7(Lkdby*Nhy~JG@NNEjB#nUD>8U$n7m#MQHrkxLl~{D%3Y52FVHx+lG4j z>#jMXX0f?&NmUW_fM3HaY=;{wPCHIrG2A_L=WJ^m1MUnKmg{3~GIDYO@8?j*xYNRv zwuc_SY8eif0KtOZTW=WYocjJcb59+(V8R*+zUrxQ+e*-sdxqHAp8|cgWs)uSXY9!` zdu_Gm5PhxAE4BKfSx$DS_bhegP269!M{9&PmztiJR^v%X3r@u-r1QW$>Ny*Z{27S> zq%Psa2PDUFx0wiIvO|mAlgub21dij%p9du)$E-G9L#v2FV z_-|wTaM%tfH6*DLyeC?K#rXIs|$T=LXhA=0Q2S2xu(~G+glkB zr6ptv^jDP*e6va(ZM}+HY1}i<*GZ;7Z?`g+E*BWk!dP>PAbJ*x12YD#r}nM136T80_!Behn1 zJNZ{Ur4vU9Y@xyD9a7e$D*-szK0bdoYavVIt=z|4QzM$cO19=4zr+aZkl;Um+49zf zYwa49c4)uFB=YY3HG-5`c->I0T!`?29$c zf}MlS9Y`Q`9h#~o(2r*t_RB#ST1Zw8KWY2esXmtsIcT}Osm!I(H3bmJJ)*|WYX`%- z;;6)idj+ksg?v6-v4MeF7N;6fd8D`&4mT&lxTfgsid0&*VcRdWMt9&Hxb;-l*%IPb z+8T)N>Sm z3yZpe#6xZPueRA+sS8_$7)n6TO5}2&poBM&5Yke2b+-Qm#Y_gShg7a)O?H2{oxpT9drER<4C99V?wmi|oH8u>x!rHia(d5j#NY;P9uo zT8BzSSLe+|9kh;W$ED0w6atlmCC^9Nc~_$y-J}Agg!AT2UO6bnaV2{0`)a7~z}iMtk=KuaKPDs zIntIb@?KV4ZD?t;&?l*_H$MR-6T(i^1#jaqYDJ1j4NzcVuw|$l*@O3S_Ay2HJBz46*N7WWBg2?3vM>!Bz<#<^;NIKR#vVIYe-?_sc~hoARKoDkbdoLjmr5k z%9LnO;!xaHR@qq!K;}=Xw=n0RjgZ3QSnKNJdo6;>+e5O-jy*r@Ie5XYe0vLF&dsp1u}22F2k2M6 z$I}Dm#!QCZE=nbgp-rz4<#q2)Gt0*{$*b^Q55ZFD(~UK0Bm7qv{{V(=s7WhRw>yi@ z3s=D6SdGgU)AqAqs=q7<(^f0*g;&3#9&FS8OpU(i3l&HX@} zsAI%d*!`bq6zYlzO1t@db*8<8gOE32Cy}on2h*flnjJ`CdgYmsk8AI9v~57`DM)2G zA1-RI)0dbQ`%_V-ud#3fKnf?(J?5yQD(`DSJEgQzJOx3M9U(jWC8z_`px2j}SEaQI z^s#_bio@Kp>JjXmyM45Qlt@R0M_Nvs)F22l5x1^;{%VMZKBLW?pHMlkEHW0oi;m{f zJH=W#D1{WAlBX~B#`F2Wv6)eX6fL~Vx^HI*>xoaRuTqaP`zOR?0SMdT~03cIu8Ozhe&>T$Ft zHsV%<Rvb5?&&FurC)-TAd<*? zcu6YB0Q#yGD_KU6SGAW(J?5H?g7Mm&t+Y}G2h{~_7CWfIeAz$ds2a4hxiXN7MpdYG zY;~rT+R%GIzP&n9bS>GADaD=3S=^OtyeD!E2%0lfj(9N#vq^$E~#%V34 zQ+t|mZG?c5q6al#44(6vh*_+`w7#2*$Z5w$1_(PnRMPH~oS93G)9k#2rzvqn436sE zW_aO7a$Co%uM*~65>@U?EENo7D4JoBs%1z=q}WfeSFd{4VvngJF(>?}tfxv{J3Ohj zn*en#VyPUiToq7JTnU`GIX9EbA5!=U`qA-L`0OjUZIuADmE}c83J2L+8qzbA+LWi` zrAR!}yZUCGZJKRyWTr&hg9<`&LRwZy`D!Xj+6t_C(L8e0{5g$$)9@icn{T-+0UlAy zaTSr58^=7WpDb64#~P>J9a~Yfy{_98)L|{MO3D@W%G^g)cvB_QOGJ?|a^uU6623sJ z;N;VLx@k?i6z%E~_9qxf_#(D>WaC1Ub|{&wrb|iA(2>inHm>(I;Jm)Fg)0jQiiWuSqHdC}$jq?yqrlg}4H#7qn~#(@I*xx`IAF z?~a~tHoFDl8&Ov|Os+CU#ddk+;flJr@>g||txx5p#|>cARNbd(g(@-%L#)_ivbP6z zN)S2xeCoctac5dymbo+K!0i?N>LO5nT+(NB&5fXr(^NH{zp+g>{Qur3VJ8!l- zYb%uLmUlX(H-bCxDXHB%pxFAe*9q;XaS94+q4=tHdU%{?mB`?#N-09lxNfc0-vGSIDIB(nKgTs zl;ma2m>E3*uXlYnr7Y<}*E&nB6=eko1xg(He23(z-#K<1QXy%VDQFHmx!vmKO80!i zq&iK+9Z79*B|&BL@R7&>k%RM^dba4h9l^9d#irz>zv(0?VI@iHyB^Ar!qZlJ6N`E- zo|GJHVGkGgVE5vo!c3&5qUft{D{)r|DN$K)KJ$%$N(xj$hIw=Q9Cvl82A|^p02Oq@ zW-gcFKB2Y8NKWjRPweL`M(ynCWes~#cz=MmZdszmEh;Q z=Epj)Et+FTTq3zK4ofYzjqYTCw1MJ$DHJGLQtd6s_UkRd_T!FjDeM80$y~lls#zrH zl+r{+r71{KT~{;Im1mx5`%y28D+Y--s;(hK^2+LE=Ftml$O;SM%*O%yRc@($@pdLgU+N#Gx5GLsacss;&xAy6Q>qmE@i7 zoD=Nr1va-O)w-3xCFQLcQcm(f$;Wn2Dwtla`d-;_ObE8QQeR0*JvVt0MLojN*2hb1 zD$In)UslYOEknbQtSVBKvKmkrY!JNuEzTTanI2>41A+?tDjy^%w*o^u6qM~!NdpJK z`s(nvTV~jq3A5TD$HGc*;!g6c{dRl(RGLe!w;@ub>3cKIIKAX8836oPt40kGYju>; zR*j^UB`Z9_GE`CEHv`hW6`^=8DZbMgD%w;}vnQ=hr|OvTr zmuket!akk16*#hx(vi=9f%SdLzUNe3#eX8INg+ED;xL1_6NK~i(x@TXeUw%Zw_RJH z1O)Tz*B&0em1Ak!)T`r#*m`2tly590-#6T>j-VuU<=;|x7W>odQxO`qKz$1Oqh4=? z?eQSgdriAVRFxH;ytY3Y=p22Z660-@kTL-Y!Klhmke3U|2LqW&^s(zbPq3Q4{KHf> z6ot>XC}fSU#s@zcsQv2uf3ik&v23%wl;vbc8OD0i<7CCB*-{}KiqwW&PDfCow0kqR zHS4oOdF&buqpsv3Ir)xi#?xBLE$ULDT&%X>w+0$?H}%-g4~}tp z0KUxuQNiANRPCPHY_%jpP=^p!6dWm6BA%po{2rj3RK^9C@gqk~K4Ria&!Ohhv@3eH zg<}J+QaV+sr1VDxEuhEX;XOlPmN!lS`Yw}rI_XQ=a=Oe@lw3h}$Y>?&JLJ$ZF+K>)&&%2&!LLt1c zgYMMjD|rb3qz-41&N|he2DvEnry_$kE3sHwZ1Xm!nMh$=&Uthl-Dz-RR2+7VTvh3F z`jXS!KV&NIV$j0V&i8O9aSfWZp<@J?&mv~`8i*s&IJ*ViHSXCAtrW>2P9dPNM4EvOQ_w`P!(qX&0n zDN;0srE#S!S|qI~z}>rQKpcS}Ro>=?vi4oOR>@_&Wx}ZnXHKwIqEe<^m zaRQuQ)d}5|WK=yo*Cp}gR!F>8OUXeyvT!g#?=`y$CwFVjDY+sazc zP&xcnnnu)@W)kbfEhz}vtc|H7HC6dQMP0_hhu+LN4~ zn5e^TA36>xXW;?N=QTft8Zsk|=xHbolCnoKoO)k2dUNov9m?$O?F}tjno~fHN0fuf zC}Bi({{VRTJG=6`GE1dPyyYqT80tSR4PROxgchrol9hPWm#Egelkr%e5*kz%V8vU3 zww;oDl;}!SM|Ltg;-VKDJ=V!}muH{Yy(SW{w=u2LOuOA*6Py?NB!(xbm$e zrD+O52qV6x$UQccpoYS6kA>~nR7C zi|ZLa8;vZnp#kSva0PGlaycnHv&j1SisH-J*tkN*wEPJOZPx8BIFZPxJ%QG@jUtDa zhAg@8`o3z?;!VEL#iv2uY}OX7QSO#CIJO&jt9yu91w{CswH%1xNJ>ET!N)Poj~a+Y z6muf-bZo10K6@s_qRLWETXS(9+C?tu9k{_uXh=aw4WQ$f$L-BpkUK|OQgS}3+kwD& zf-pe#bj49~QsXif&t?#oRwS{rO;BR%9~QQpmWbdSBhT+T|S6a)yWoq(U}Y(E@LbN1(&;2$0+nb-QGy=u6U~~LYcE6?4?pxoQwjH z4QRaEm28jOF(Ja=!BHS%+fGpy5Rls~gq5feLF5K&8kM5uiSiuI4o^DX3XxI*^w->Q zsJYX)jz+ygGb93%`hy7cmBWx2ij?Ul?rh)7)pv%rVcPNIT7Pn%~>t* zNu}t!<*}%Z4a}X5Lqa=Vp!qg9TMp93KG~&K5>8a6DnHHDJh=kh!lnsg6N!ov6 zc?|mMVH;*Daw?_iXfnfzDtWhyeu;2_yW*!#7f1g9_jSaGfy{Zk2vUIQfKE@{rXpJ6%2Fb0#P45aq2rpkyKY&cm6F}@NxZXjsF0{HB=_ms#Nl&_Nz>%ij|B4O6vO4 z-|=SFfACyy{u!#E+i*DSp3~6=OQa=T{-24(eMhf<94E|vpZ@;px}Ft)#ZNR zOi31$zoRt-mTpT*TZW6FL63CG96OkG8Ad$}{4Q9@Pyo|S=Y!UpRjE^?>sXN_C5x@Z zMPD^0ELVhbjEvx^*4*Sdj?iQQwzFw2%G*q-1)xX;TfhlBeH>Sn+Zboj?N(KfRbja; z7LwweLVHAojj9Bk^8>FwUKQyw8F$j(&p78)eDrM|c{F*0SU*%=ek$~cU7CW>>cJiP zt*$m!db+*)iqn*Z- zBe5z8RtgVM-fB`7HOWiukUL|~04v6jm+mN1)+W3HeI2>Lr-?~v$I}@H3EU1xJX0j% z;$%otP7sx29yK-cK;vMY5-g=E=-aNTO{}!G)y)dWf2yp#Go!Rj$mn-gY6mUlwVD22wI@GsXN3cM@$WEWuF6xNV51hYoTP3$$kgV^{ z;5lSxpyZ%2%O)nZERJCZpG1s&zPdOTi*gul5glV{(4}CWoBG$N@+8Ds9_E*r)h)!2ag{hRXN4SO&5S)GA$ZQl$iU7;A>jfv({`w5S;%>- zNSwDNq9a?Jb+m-xk}yZ4K;}96@ly^iaWc`w>t(v-b+fx{)V7H#g$Xf9RApL7!cek# zg`@$TS4M1UK~c)@aY!oP5xnd`0CyD=kB*q`@me6b3c%bzDJP{!WT++e47S#CR5Qq$ zVz{`Fhm;l+l=HyOIoBMk$EfKY5^19KcS7*~$i;>q6mD~^ z7rjFPtCAyIVyCgP#B<;&^&VvSft4h4Py(sDyhyMnNrGj?nwZjDLvrH!4Ze=KM}9HP za_Lu&pwzr3)$ZCgrxCr}V)<)=#9Nh?3_z&6LB?McD{z6+a{GT)*()eER@2%T`5 zaq}pU1i5ZJh;e^Hj*sq1N2w^l=bx6h$r_V6BAa7O#5Uu2TYJG!7$c=dmeXQfgdrP} zpRMurRDwc+h#R`~8KxI8=MOf4u|W6t*E^EBI%5`);LOQrw#kUon8pfJKC?Y4_S3pD z+N~dOHmD6IWvU!`fuMj=>J{+vPkv2NaGC}T_td@HLn%&2RcDZ{o#F1MItx=mzqx8f z(i?FT7GzgCNN->mBc~(Ix-nziXO-78yya+oYx{fmpILwqZf!ZjHbv2s{&og$2re4~YRsl%pL9cp?Bt;A6 zH=Nh4BEv6gJA7rFWzF3ES+09G+en*mg38tVS3ez0B~Lwai21_jJ(-Ji*cHJh&b#A`QzpO{+&V zoyv-mZ))HwbqVRu2d*iC>9NLC(_ke85~Snd8hN^?vaU{TN`?mIWna?(XVxk`Ex?5< za>B;L$amIR6qgLVRS=kmvy!IHz!K;ngUtF|soLn|i7>4tU=6`w;QC*p4u25MGqZ#* z3BmN#K*u0*JL&S~f{6NDB_Npu=bxlT@saF3D>x^((Ys9S9Sxy$cA?dCH zM_aQ`=gHQa3QH%r1q}7T%|v+TY=x&aV>W2kq}!Dm#Q{$;oPw7Ne9FCN?qZ`a>b*?W zk`9$(P>T}TaW^RLHOb^ZfsCIHSjWvsc!RFBFA%TNwMMR+9qXKy8fis@6on-T0B#r@ z$4_7t-zX>}hF01k_ZdzSu&|@F^xd3t^;9!Zkhhv%HlAel=krvmV$0yT6NBCdjYM?< zl3i;(+0QEEn`@J<55T`pxgij4?6l!2b{+`$;;4gjjFNvwIL?IB6@;Bv<-VARus7n`=6>~%esS7mUwT+FEMY{+fE-q3wx z2fN0j3v!Ul7q-sR)7&|*M&c%>*Xy%JHl0ImQf!fnVNJ6!)F~1G9L`hb>gA4Ir^j4- zBm^?xLBbnxX&m#BxZ~!l5Ic`Ms*vgYSjFvSU_YbHsqbf)sGTNlm~#tS2rT) zPbT)Hbr{AEfgUx`@ojsV%a4XJ-Cu3UPqeX(&5_J^)q4@Nr9nG@Rsh|f1yt_lq_~F= zv4W%&{9~;_SlCpe6OuU(-B&hO_gUDO@EQ;6wvwW(u0tRwlaGQcrg&?tbhes?^`h&i zT#Y4C7PMdCBq~Zl<=K#+tdZPtiss}p>srndTtOqYWn75+5mxMEq&~N|9jI{S!|5b? zxpMxUE29KfLYY~<;@DHNBr02y!sMxKzW)Fx7LEDbq4rp)-OX*5fpuVZeH4yczFLvX zKrE+W-RbiysLkCZx3ysk2{^#5axJ|W*<0$>tyeakAFcN6XlWhtJ~=9HAHaHv?jua z{tjj=6YU+sth;lqB}rEF6UYFr>h04j?BmHMg6KCShq;V;IH(Sy3<&a*u;ehHLH1RH zcx}+7a|J+T1oNl``?FkWMP!!)D<{XHsMOR;Vv{SaG)cNdTOj_9f&lB`UbOKD)Ugoa zmK4kCJdaXI`D@;m?0xXs!hu2-=G^yh!R1MNrS~JK_+zcF z8g|b=Q=#W(y{BUPon?w}+<5Dgkn4^la#nB$KJ^Mk54UbGP5~_-wzUJuq@4ZT!lRlh z&wbRl7wopAG@mwr<;p{@zP8vy4J4h;jNq?!HjeZ0W>aocZZedYQk3?5vNowh2qdU` zRm5lA($$g0di4HKAlAnf@D4-Gu4g+)%Hob zGLq5*tha(W0iLz8IxY@4+^EVSNmfrjSftE^IfRv@r9S|8e?yvfiZ>58^OTJGM1=SF zR-0FXawL@)maDDBVP;9#;&9_^-~o@a&)%rkvW(%;m!z#g6vPEX9|Y&6Od*CtZYAQR zD660<=ktB~Y1Qq;_pyIzsZJ#-gOirY&p#i-Nu{*Q9A4tN@?}|Pi59{GiVKvX=%YPY zUpnh1ooyolIoga6M}}*X{F>h^aYD|p^NHCkgs;SQ3j@@8kCM8$NeakXir!L|6s@@Q zbL-_?`X=0%)Wx%1!QJUX5(ZSBXO}8(C_qY+j%S}*S0%RG2<;Mfbljf5hPAxPSyp#u zy$SYZ2so}pqmoABgX^tsq0PlP$1LZ>R@YFK^V`4Jsz&nmf|WJ_Pft&%tXpW&@@Zco zfzYcJRry9Tr}QKx=OL?*7|%QrpSf0&(T7r?jPB+=Dy=yDl>5L>)d*0yv~U3EZLiwMF%SC3A84Ohi0J&{^+0`j6Ndu}`9Hd{_P zV{(RZ%Di;`^S%A3w|G8?#?i#9Yp=FUjUa@jPr2!DLcvEhd@KQg2QWxI)YSn&ankBS z$#n@>Dm>3#Mx$1x7Ll|%Kq(_?Nls2VR}lkXyosBg&a9t9C9cGQ*8qhPf$?>%HqtR>`A)dpuHDV9l?)W_&M3o5ZBe%4mh6g7 z>wu*wYt}0#JaUl#$QC zgIXhn2EtX1qZqGHp9`4T+Ax*lAz*#eQ&x+^gO9H1?631%DaYrRN3icTvedOAOU?Ww ztDZpgfgT?%8l2};-8P&Q%y{4se!TcryHlleRke5bszG~#nAGqpVqJJw=Uhg*h zRj%PYzZTBXViF1f4Fw#Wp1(D1gtdjXw?4RYR(hIdgwo16o@Sn-B;}-ok`I4DSH@>0 zT#}n28+XukTN0$;tNh}A;6E)`3-54n3aPVh62Ig$Pt>dw2u)ro{Ea>Z8Lt80yFCKg(0-1 zdzI60$mCClbyl2*PgmWkR1_e#g%xcfBOAJOu0*$XZq=drQ>I*IKXa2O&Lv5Ew0Xx) zR91PZK>JCjYh#PbP~uWZ11H9qEzFDoxG0{uBNYDt0RS%~ZUdGwE21eF(8tBL)>yW= zw;P&Rs`GMGoxSyFabL4GTXVpSC0jC_kUdpbdOOOHI@L39Z4utopyYJ(Kqz#mDFp5Z z?^EJldva9c#Y@|;sPoA1sO^-xLc$b~H)P>GDfueS3P|VDu!N|DI>sSxHdBF&a;0~M zvtyT(qiS05=aJ78iZEJ~l7Zu-u>FurZBe;~SduqpV>CE%+t>95vR;-SDjzJ`v zantRoS2EjfVJmHaH$S~i%Rg0ENXbgbBjcr(Cl9*ql&iU54<1IbpDv5-9@_-AfU*_1 zC?AmH?^C=Z$-dMDEF=u{rk1&nP$!tDSc>G@z{u%S2TaYDC-t zejBbQKj$2L-*TLysVxn=vz~O{rcvAJxXrkvg*PG4aq(m36uK*E2~yOruG%wM&L!fh zSgBhNGt3_EU0VMDLxtC4`D)l04=pHpo0jAO=&Xx$vNP<*FKtxLkE!y{QPQn%q1=TZ zE*&bM(~844OsOZ)Ms1SuyW8FDHOHMa|Ay0O6ae0gNatuhLg)v&*>Wt$jDIJ}@6I`hWZU-_+bxez%o+ zNoBRATZu}2C45!j^5sIk5z{=fYsd0^KZ3#0s8O=(lIT!UY)VSNJxB(k8cF$(W5ts*eajN$h( zRQC`y`_j=p{atV_GVV|tZ48Fa3UZXADFX^n<&5O==S|-JHLH%4yQ(e^Jo8V+aZVu$ z9h=T?e01g{hjQatK;hfV1fA&(B3jn52>6qOQ>^Pc@E& z^cCo>3kq@KqUP*nCzS;%Zw)vwjo%0#Re4fEl%Ubv2Zt_IJCP@+WUa)8{ScAYmoq|E zTzM*K1Yl!mKRtL2FQ^y?#DktF+p1JR)iEg1vY$aJyG}o90A9aNdo`@QTwcfh_5o0EGr;m z2LODO`*2DWj3L5t(xdl%%tR$b4a!J9HRjD54Czvm+Oy1_hONFDAtLV-Bn2p0)_y(p zR5F#JE655+C(-e%V}u!(c5S63hung+Fv@wj=cSw_J?6L4u57HjBp0pCwvn|;?Ky<2 zpU?e1UUdYxAt01&PCz{S{dHqsqr6h!Q!k-R@;llo1p2d3TcZf`l7u16!^H%B+UUxy zzD%O%jx8Og)sj+2K}?HVes?6fl1RuSmN8H6Y*eHpwM$9KP*RQuDvllQmshwrqNR+1 zT#hu(gvkY^i0iW4opI*^vd#j0GuPW!>e&rPO50xYTS*(0lki7}D(Bk^jG?!idBB#| z8d8dnB!I4Y@UD`ZXq?dPnY7DHXIepJa1`|m0~Oh(M?QCGuWyM$ltYbN_G7bDU~D(+T@qy z>AonjxKXe*sGd)x5po#hGt4XSik#g;U7Fo!6s1FM!bt_>;e(Ln_$!+Z8%`K0jzqqyn z$=SSPs=3r==Y+81*a;vjH7&g~>qD{Mw+G;nj8t0SyK(Jf%euE178XLWyV3)uD~~+6 zG{-H-g2hNG33bG@N{YGnjEq#4S_w{;Qq%}3+K&8?zI?t)i^js+Z(?$c<16M*Jmh?p zB9SqcA!)fXg3!!Y6ylZ!cBiyRC*lguE0z=cm6|lwmdlJh{Dq{Xfx9Xrzt`%f`-D%b zfWujE=Ol`mL4_9KHOM-8`D3~yZCg*bH4O(_BbUQGi0DOX)izn0a!Zje?%Sfglm&t= z4ZG-`@JBBi^(54z*~u%iv3fGl-cC21^gOB^eFx5)E&vG!81+=z@prT~y{NdybtGpf zR&aULCsazd%$XQlgU>&5qjwnVkGZvi5^{1*YHb0y zw>vxcSX!q{3v5InzU$Wx&19$oovq_1krfNQ-!$&>k$<( zG8#}TS_TlMr8x>v2bXqheKeGNBQ#s+kj()B)`2A{Un7c&-Vj?^LdMdiWM}#cnra)i zg|xwqG43U4*-E&haBd)3TL<=Ix~rW-u5^1#TM+IJzO*B9R@-C%J~7s|%}=ItLA}(` z2Gu|tgJ}TdvKBdVBDaS}y=TsL?YX5y_zj(D7NomduNMX#vc!EYvl%IQ$5pvbKb)<2 z`qcB}DO*VcNy(7B?DO<)PkH6ixIe{bVJP9-`)tK(QS@ZE0!q2Lk!Iw zd$h`fF@S|U%#>ki3K<0Wa;ir_YYic2u)l7-GcCKK=61qL5*F8E-ht0>QRV^W2Z8BV z4Tp$23i%<&ue?x0v(_``cP3m?*UJE?f!Dhoz*lygBv)rXTzAp7>kNj}R-)M_BP!}U zzI;`8r~}1`DqklH4xppIl6m98r}~>&@XFj-VXh^>xfd8ayv{p>pl9HWimWd@LDC{j zvdU*%P~%Uw!+T3WEy1-aaP#C253~wuDqS*|V$-HVbk0|Nw(eIyI&3G_d%*Sh*NE!u zH4_U-Z9%z;+>&#gsPxBuXHU3>?^fdCLe!U%O4505$2?MhIZeLsnXW}{Q&Ht5$7APj zXac%t!noq7?2RL#trxh~%>{AO&|Xo$YB|XFOtuLv!D!?)kzv$IRY~pr}OREy2PmF@;P;Dp<_F$at2O#6yQ_B|>_&S#N-1Q~;7iY*J zn|M~??ag*!oMG9?k`C<-I+4EFNpXhvp|Q)CBadz>p4aK$a)jbr0I7v9Dmc$Si6ga`e3`no7o_au6phY4fI-OI2>dkl!!)hP_rOR2OKEv0#1a0%rc0?w(^j@}OK5r5 zK-+)`+y3fLqP4@CK1IX&*%Ii)_}*-`oGJySB$Ab+j)&4U%9^u$t8(DEW4x@NNbXJv z0Otc7f$*Ppuu5_Om~c6t z04t;2i#eqSR87ljURI)@cM*Zm9;fcs)(IIv7zdFmsAP^Rz*B87oiG7Di;DB?`hDu@ z;eqj1&&^Walr1jlgl=s+Lj3bN`Mq_b%?H6n22B$fr1ph7@%5{-g*&`o%y~pEron_Y${)UiQTWTmtn5_1l%E%n?S6Sl{-qfYh zWU|_J1fm(-2}-fokt3CFEjG)2s#dUkH(>mASF^`xEu}rahHc~}K)TxIsU=6a=ew3G zaq@+T*;3>1;@+I}-7#wAT0>C_&QBa-g&nXQy}lwE&T^ER(efB;fPrE5jE#(TaN+4gdxL3gkX2@!al5UfW!k zRk;D&I@(k~<;^FbwxrhBjxPlfR(rmt4o!3GTBlPm0grf)f%_bfp0~5DwXA1}V^rK) zQRqXM=jyJgX4+@$?k$cji4ipIv6%>40qKR*Hs%8MfB`#CFg>EAToWbD9dm3X1Pimf zRIXr>k<;g{cAa^?U0+O_&C+DY8&=)Vx>vMkn91?0M@4ZVS{@YJOOO)iRMREAs{r}{ zV2_Td@+nJ_9y(NA^3R*LhP@tq&$f`Pp$IDGJb6?J{yH%7!-}&rl_%hZ@(1Ol4)K^3 z{{U+nKtHqPT~8!gMFP%4+nY*?wT{A6(rZZM-dl0XPjx>lDs z<1w>_Ezl4KGD`Um>CUSrmm^_wFr+F7}I;VU+YgbLN-a zZw`svYrGW!iAhNvcM+O=i*&aolBZ`!NF51qRYp=nr_xi1Ke_p93T&ZWnU1U;stHjw zRh6y_${UOR$*DBN0Mz-Kq5>IdVP&$QrIHSL0i1IcPwMIL?)r*t#t#0$_tducczb=I znqW*+pcN$rM>zN-pPWVR` z)SZWUz!kDG*4*gMHsMG^sZk#tWZT`zG)UR{n%3CDwww@7Ia8!GhaEx*OK4Kkoysa9 zAeB4FQKzc_^N| zk2+VP)|U9IF@%6qD$wdr?nmIJcx@=SfQS7R0ssRTr%fE%n&Qp9V1iWv*2k|Yu8ePY zW>e#Vn@fP39Mm?W=uU729-^KZ`l>dR;2`p*jX0M)&gmUKjwiUTe%gADTuW+7$UMR2 zRLd$fT%>_WSZzTr08TdK)vM$KzAu-ChCl=+Lsw9u70Er zO?h?j;VC~0-F)&n{?gCy>D^qjR;;pIksUsN;H|I!05wMc0O6XheTuJ!6ab+>UcY*{ zvytttg0K(xD{TJ&%~AgV_-5;$ARWyUuqf|Y)l{JU(kQ~jNjB$d8lK?y|u|p zD#s+8dd@4wdI?H_O1bjD_ScVhBkC7Dlf51i^^aXXpFk$mu%w>)tK;8ahQkdc1dX6% z_f?&t+(N7x)3iQ{t%Tt9!O5!4sBAe2x7<=f&nzDdcvZ7niJDtw!MRuYU9RMVe&IMEs}QQU>xh8do&a~e06ya zsjZ#F3i58}vN-H9)NmfA*3M$^3F5LwY2(P$O_zgApy)kWdw*dvu z+|^|k%S}cih_1^GCB-EmV;g}Sy8N_; z(zYTdH+jF>z8AFH<=qaW?`zVV%Ex z(_-(lTq+2fN=HIl#d}S<&Ja|)jHGw%?D3J~%QShNszO4WyE*{+)ia-*ijI3MqL78D zDtZ0yf~9?!&pKL`99ojuNh)xmEu4e(#H;3|(d;qg1G3_f0L}|Z{1vVv5n|3l&|Gt| zJg}Zb_tg|yc1s@ZTus%QL`c)t>(^xrEl0C;4Y(2s$iPv^&U5k7X-z>xZs0nQ3fI$qth1Sttbjj7~8>S#^7b^=>`W0yYa#!bG-;PD(Z z;#IXOQB^rPGUKO>s`F`)A}qGhwI)+8ZE**{E5GBU@oj=To7T*NJNeV3rN)~PxGvh> zQXBXj!N<>9M&rp%zb4sSPu5o!Lw7x0dzGI}McFFJUxy=2FJIRn?vXa+;=ajF176i? zw}mNA+a#ewzi|9Du@;C9Cvq*)$o0KZDY-JP2@&-?^TlLIloC%cpbxgUF(Ix+eWnsX z7#OFYaN-35+!<;Z>Dy;CIb({^?GiwG|(-Cp|vQEMLqfW zseB$P>&tbm7N&J}piEXh78ymwL4+slQh<^G`KfykHk)CG9@L~IT-+;PH6H3|HYlX1 z3wzjE$-~49{IzwGP%9{@E=)hIF0)n~pL4uOQoENYq4i)2XrFMD`nR~c3M)<>((Rro753q9SUyN2Cd~XGAG)@O1q7DZv42rQ_ zY1dl~``odE-b+0GY*L2YmeVDcwBDUgMhe#tem#dd6?Em%n|0u~jxjAzKjE)aSaBJe#ws?HybM ztelV{rCoh>3mZpMi$NyU$q7$CQKgXEc1c4iONw>HgaC2e zuBN8RMcfdxHYg->A{u#o_3v%nwWUqmljD%e0mrJNVKI}kJFD%JnYtDH{m{qz#+cgYQt%h5o|`_-jw-k-vsy~$AtBa%R= z+QjBph(oR?I~*LaSG5S`@hI1{!IZo-AilJLgS{n3?$rH}s5?&08lvD6{{T9F4Q+BQ z-TwfpuK72Ai)%_g;!RtUEp|ZKwar4e2vXFqg4j%T43p4wsdv3CLf)2oG^<>=^BizI zh{|DDQgPItc&+ZjxUC6oT88F-^#1_vt%!wj2q4~WI3o((Aw-ew&nk*!?<@ChS0uQm zp0~;XdMZz3qEdW%bgxK*aZ^Rq+h!FGyIUY*#P|GlIA+YE;){0~p+2T9QvwC0O|@$5y z65{A-ha@G{DQWD~2q64)_3k1Q=(b;HcP+uiADGl`Yj0YnmYaRVB`1=@r2X2NIz*_U zDY0G3i$3K`E(Go=+l+MQkVR}7QvRY=-I7|8k?DF(8rI162^_R>BM9B3c< zBQ&BWmeeXGe&(qGWR1=#Er2|7ai5DdY@>(Jea$z=Yz-l-6J9A z6og^)v=kfXw1l5uiKfjrYmIfiq9g2rz{`XlL0HFt^;HyDmqK?ms)|&l-|Z&{o*&Ky zYWKFn*R^_r*51S%;blaRmag3^!*%N<-I>!mde*hspe}T@yg`5Myk3L?ilQ+Qa zT+~}!<}_Rfnz$@7(Tq@{m39btk_ZCp3YFcupjTFR;1v!8t!QY--D9 z*aMn^GE^0{Cj^h2bFQblXq(NB*%s}4(ePtNnlgokl0hBW^m-obR4Z3lZ8uv?geKDj z7SN@nhComw*eNYLt7V~*-7*=&+gwXs+S>b5kn&%+M+MX;(d4w89}Zyn*ILPSUUcw7 ziTxE#tY?=aisHT=y5PUD87nw1GOfAfm3G+VJGo}NBJ_saxk--N01ACrAoV#s>$^mh zOmz)D4rk)qVV)u0+;R5fq$waclzKMDV1np&^)MR&fVEZ}s zt?k8}Q?U`Rdy|dH4d*1BU>=ola5se$__L|i5vPlGi##zp=zDONpJ)uBgbeahvx4Er zqsZc>O5l$XU+ikI1VfMeBqAL2?3^Y#EB#;hrJ!ZM%CXq*zYv|_ZAx(;fxcnVJ z(lB@KLNSi~`duq+vNg4CiA}#P{kzh%y0PeBRn4gE_lphX%N6QOS6_@1+Ih5q`$Z?H z+y_2csy1r|E~vRM$UApBum?|rQ#RCX7T>>-9Jtzb=gX)}#PcOvR6hEvM0mER7nH%f zJA;Ijtpt3WsS<%%3MU=-_SCyiAP9&U7$YXKjd?YUxS^m~VDtX~gO@iHNWm_I_xo{5 zThmK(a7K%sw4bjs0msO5Q&^yd0#ua(ka6EqTYGB3D0d!+I0qT6cJ6!>ZKhM~Mz-6X zajCXBP}Y4AUS3jZRq9ofwo1LqL#lTw%9eZ*JH3@I;%&Vy*hJMKExgmAAz<^zK2=;z zDnsEVUXoCgk~@f~$hHLA;M!zCanyD;78I|70C8PuN1I4FaTZ9Z$id6G6q?K#GhE+{ zbU9HO<|^9Z_J_9WxKbs~;vJJrI~mQ1k2R8|IzGuePfw5HsxEmFdrJBZs`R&!8LdBU zapx7WER`v0B=qPp^Y>QS+H+DtfV+#@a@72F4a+DUqKE{I*dGI!BLokF-_IRI!tNMo zE3Dgx4lcY*(^ts1##Hz*p|~a6oNLnark~Cm3CP`(%n{cHt4UsM9(C5&7Ur9jcuQPV zOKl)GAt0*ml~#tC5jw8I{4^oA6*;slB=iIkis^IMMwF4- zm3D6ed3dV1lS?+3n$q4DMiF#u_+!#F(z8iSwUCj5;5i4l9M*NVLoW>HE+SkWw`$9+ zz7Rr>oUKJm9RWG0dsFVNJ=iiC+(97rX(S#%9(=izQcf&|t6$ud+P39jl=_IxFk6c) zT$wA$$N^yVDbGxLvGdh4@gmSD>;UFt_~P4x^ae<%rI9Xb5o#%Z~(t6rH3D zs;Z0UVvFs`xJwIRxvwRh53LJ0_WNpa#WG$>V+pp;KT|h_3?AlyuSvB}#us>#lio4Q z*-i?Oa1dJndWB?T9FH$uX|^QBTZZ)5R`Y{(&Ojr3X~SKEssQD|mHn_)vTE;DjD035|-T29`i?p?xKeP!-+?xqW=0Iw&< zzP7dlU?BQfJ>ry7+9CH#dzKX;#-A!_!?ZfTOBEk=*B(-wQnFQ3eOVnY+X}`}u0k6)m-(0KRI)OeEde zxk0yE*s{cet8xk)kignxde#nk)W0I7kX&C^Xbm?MoO>r|#Jcg2@`wk-oSi#%YnXZKJ-x{Q2E_oU4VPbvRf}N^F#pDCanLO#@BZ$J1 zRB}4zkup$=_4YFfN<(iGj_`6tD2^I!L@(ie`p++ApvC0u8Ob2{RjcGQ57Xhp6$Frz z?#DCUeZ`+uNO7{+31}~uOmeGZ$Z4b}%bSJoCB22ic?1E=m6CVitR}cLPm&j4{{V`% z!~Xz+V}J0?S3W@@O(9vp1wi`irR|zWT-)^QIMVoQuGw}iy@sC((ico2X=$`96Xy8k z$miB8nk|Z2;)QMHl@NO7z3*Jh44%|s{uAf@7fq7}Y|_ZMZ-G^MZ9AMwLB>=DYt4E< z+_a}S$pXA|-Jd{Bbh;4Eoz~0vE*o-Fp6`NrR93|b3T=p*>nU|xcI5N)h`<1Nl0f+C zTcunJ(VEwBLa_iSDEkNFkD8;pbcF(A*Bv$llA2;>b(MJisRe4t>?8e+o5JQMp#8mW0I; z-w1FX#TX={pB_Nsogs01SXkUDZTM?O5R|2Cj3A{L7(Kv!+D$8q8meWoU9oS(OLN=o zmRmsz_$51u&oi`<@zzsHFM{!Vm5`$ir%(#efTf)D?gN*~56w+7+e=TWq>O+w)}0*M zR94#0)}&{t0XU|o+zNR_k5yE$>Km@1_R!jja;#O0VzePlMvD!Qr{o}ddqG#i?)hrF zjzE&h$Jb`8hU6+FIIE8NY4%c;Aw#H8Ijvz7`7_9yTnZ%G8$Bsf=+Pt~V z3Fqk_0ZAIwSBPprW^%b;q$wFl$Et&>uSH9BGaSpA4x}J$T26A4p6+!HJQ4k><(_Xa zT7cr=xR#t-Nk&RJ@;E$?u|wskbIE8v^KC4Rt`L-9^QjfW=O%20OO)MJpc6`TmOM~dP=FpcNw%{5HC&s;$ z4Y)0&9|~ODM-b>xWm`)*{{T9NBNc+bt`#2M(yC3mViJX*c@1|dqYk&rv; zt|PPOPVgd=EdW7H{XVJIUY5~4B(jeGMIU=lzW=juKcWdc&KA_O4-d<-7!n)F%< zBhgNK^WRGtiiN9b!8yPNl?!{B7;GGL!Rb)p$qs5RnAQ+M!Vn6Fhjn2MIIJyb9R50X z^ChH}Z6J})2Q}fSuatn6xn%P_^&1G@ga$gk7iK<6_R|g|HL104kLWKWI|l zW9i^y10ee=MUA9ad`R0(5ZG-&CvU2O8L|l}9L5JOl_PG?xx(9RjAP*e-`+khwXwSp z$tp>}>T%uUQS6o8h|_UfZ1Mz?)Ef8LC8u}nBR#}&sUwykb}gasvJszEZ*Iurt>JBz zI1&y8Ti7N!=!%wB-~}gWNzO4|(H&~&+2`UaPK`Yyc-+&8<q6MY1=mYJ5rc z(P`wwvc!p)D^DQPYCU=i_vT6?;3WJ)rY+c=DIJ?jB=uf83RUlQ^r()(dqTE@fl>7G zGWSsf^F+}wU>PnKLoN}uzG>L{-$gLQ)m1H=Q4|RB41qG{adU6DHs~PPLAh=_?l_6+O;uF+XrD%Jg zj2vl>*eDf#$tfJk`2|*3B@$j$7FR+G%WWsI9dVP>+g0AMY{tJG%z&jekTc7}HPPPj z=O!e1O`sIIc_<%4pDcX!M{&N9Sbft)8Vc8yIPljp+*H z;NO$W#Yr1}N>FuE=(hQaBBi203Ueo)qL5B|xul<7>WP(=1R&rHlAIode?dxGbz#lV zJW5l`r(ajiSE#QAC8Ug340V@yl{Or>g^}7m&~LZga#A~p=~ZtM5`(7Dr*bhlq@H=l zFI`wqy|p-Pt%UQaHxg2X>8G5?z>>+vKD(V~l`W@UmJ1&Q4&H@I(h{-F4a-UfP7gqS zO7o*!&Z225K~hwe4`+YhuW-~?r625^DOi2Hgp3aUw3kXdw@}5}Pc)Elaot=Im9wr% zRhJ^-D6@U$~aw({ejT5Q0(= z$!IdPa_>@5lkKX43dnDfJCaUw&YjqGE`jw@3J4$pU6A2f$2h0aKX-}RzGJ3Ki-w0) z8Q5(FB&ekda4#Is*!R==ILE4_L`)^cwzt{IQ_5b>MFV!;UF3oRJ^)o*)RUB#P7;L- zdOd%qI$Yb$?hD>Ig=6F8Td1zeRT8W2u)gYRJ-*R+c?xFR^+p4Hf%_5hR7T>!M0qWN z)rF)U{)e3{4(yH=UL|1k+sINGt~l}(km6EGR0%w?HrA6%V=W)#iYG?6W9lB&Joc%j zZt)@N>}ir5UB%ZFph{g)>C>66Hq%8S>iQ6!sX~;X4?(ru{{XXHe<59@=g^brt13A4 z_g6NR{l&8`Z07DiHtU+^a+C-w?2k{_)DqI8?usxlM?fmWFCvU zYEfc)Pc1vP924VQy3TS@(~tNTMvl~1ttEQ5>RTl8#JIqfgq$JvmCa49BLIaCMB~{` zw+RvMcbRucup5Hhw~NS#(~2#$Ro5K-zb!>A-I@@DkTy1*r270SL2eA7ZUH;JXS$fW zDwU4OK~y{?o zsUDItGI8~rdRCcvjR+96Za@ShJBP{6rPe14aa#i!?E2J3T2K_N#aT{3+wG|~o*~FA zf-;aWu6ZDMf!=*x{VSi3C6lI2boIJ@=IF(m-r5|OEn+(>A zXeMMAj8}j;0bui{jTHQt`ku{rOh=1wE|DIP<7wR7Ww`1KZMdQEP6spGNFKVG>+5`| zoJG~n7!N8uYvSVeT0+;uqC=G#+=Nd-kY@2G91_K|T8^*g%w`l@FHEx;Vw5`2F3 za>3ax_#}3F?aIRj>jKd%#6|8ni7`wdCFQgUJ5sUDBbm>ReN^XdWF;MpWR}4gOJHFj z1c8t|PkHaOx#b4TrsAXyR z1gS@#O4yysK8eSVuDqp50CMYI&n#e6#o2YwX6XC3k=QxVRhJE{Q+M<7&^6Q3MbbN*IIDQVs7j_FUsj@Ta%rwFbM_{Umr zXhri_4>c(VEQGk9u}~c;bbm!@Q3oEOnuxj&q3#NlrpP@(*ly_XR$O_bp-Czd;gbDx^FC8DJs&0r-UC?9Q8Be!Lv5n~N@TgL3>t`8y5 zN0#>sR(aufum18*s&NmeVmBm=k~8C1Kam4ud2Mj1&OjG0V11;WSjpNhl^;Rx4Ylrc zwHDerX-fDB_(VCoyT6~xYvGlV!kc>=+H8V@gSVeSUvw`g`q?WzJ0*R`E8&f-e_NyN z8OuN)kXL5A`KDJGu_^>-rFu?x4Y=#q85Q9qj0|LV*PwECr0uR~^<~MHnUwpwQ(Oe0 zw54#<^|{BUFSlXk?wUdw&+&T)%igCAi2g1DfWYr|oERsRfug6VFR^_Ppns#8e^3;;@ zQMDyUalocl)TIsT01dsAY^S{XxWDOM1kRbN6|ZOmoI2npTk zW~Zh@E};uf(41f#^{rzhfQ|K}6@sI=SmZ~+#%UX*E7NfYkjCz!lt?Z1rDM`3*GZJ- z6bh0@hdQ&F8(FDMt;Z6w;z#+|$gd7aLLO2`7#x5~sD0%jd&2=lbUU$09DQn1mZX4r zXFTvT<5g3>$=WF^b8?m#Q3**To_wjSN-7BL3IJI-9;$XsX#JFzS2YbGEU93vX9_+8 z6&gW8+fFmgawKA^@-B#qNOre7n~^C#iB13>s+qFWYXKX!U=CRIR2tk;%dW{%vW6SU zsarSb4xzVD@)8t;@;<>@Mrf9-a}kb8O0Yj`L5g$my_~wzb9{iH54sGbj-xfTH|s$J zu4815m1fiOWp2d{HQAt~qa^bls#e=g7QrjWE|k~rlE?@OoYs5kNYs`f*P|&4IPjvc z44zoA4B=$9a0vSDmFY0gYPA&*oKt#r9g(k3&l)6-iZ#6&w!wm@E=+|VtmjvcK1ilH zqbUG-L<-cnfRe7!DF@X^(W?Nx`pd>)j~Rp=-G$p6@`AJ}S4l z71JfDK8KGn1s$SNoD-f(2Q{_0S!iu%qK7TbzoF8nYl+fslc`Cx1=bn_XLS+aEQ1+&o5ycG<&?$Q0`n_R{kC@g! zG<_783dPz&kWfh4!5sWDYIi`bOnhS8qO~lf7SfKYp|W&N_FDVyvYCuN;`@#hLEWZ>cE>PB&#Z+wJ+OTY7oYfcm4A?BrCF=%k-rNB;me z-3%Stn70L$q=$Z>2JzjVe5+GjZqcYhLKwO&rj@uOu^8Xu@T$sK$@b+$p>{yFlG}~6 zTu(xU?k1E&(@2@=Z8!rB;aDnI>z`IJQKQGr9NH4gRvCq_go2pi1uD-ooSc*KR!5Xh znr2InLerNt?-(A6Q_C1Uk3&{Z5n7oqx9MccStv@BQs8W7m{C3yxxEx#eJSi?t!=GM z>`~Z4hl%IQr*%Q2c}!X(b}St+b#a)<8xh(dBr7E3j`Ppt0+vVeqOc(`7%Ufbde; zB?)UgLWu{_%7{GslqwMu%Ck$fQ8HXlNQ znOAJyz&pZ*4&(bQ{8X&@ed-3@Tk&{k!%q#02hLK4k20(P02${~{g=r4e2z;;{v-CpsYj9Bwo*hC|riV4E;EkuALdeH8i~tp$UKM!z zOZ-KipDXCO8sII=ITmw_H5G5N7=6XQklM5T(`SdrQmDR8!IlgtOh$G?EA5u+yNa{B zZr;z^>#lom=#Oy;rW$QLJGJ&r05a_LI-XvUkbQoT2$Ru=Ix2GAfd{5|k|{ zZwN{`?OIQIiB2<)waYJk5$-GrLHK$jPBONfDt&#bl%@Cpr1T!Hb*XXt#}#F!p|>~lezRkIP$eP zw-cutO433%GO&anvQ7^(P_yItEVQzT*b3m|-gOYMVC$$Pl+!2G0M;+d=M6M26 z94Ls~R+^NTey9tWD`a!!fyi>_&zQ)rD_@t79o?Phg5h9Wi$OxvVl4cG^sNf=+}Fn1v5kVsF~oa3HP zjw|QqmnDh4IpqZ^(mN327MQ!x+ne?rtC2nD$E7H9%Qufmietmow)kKys4g@T3Uk!+ zJo$R+i_~|!#;Vj3^(Ff5_0HpRaJwc`>&li&im(SgpcB(3xpjGAI8rskhuf92VwB^S zI6x#^iH7=NZi^jl>Boq>plK&t!ZhhX#G8 zo@=r>pkpj;J16nvuO&gUk-KVfkBrjcGjm~TbQA;?s05RYc;FllZarP~T%IV&8%ff7 zdk9Gblcal9)B0wXer*y}9^TV@KhX$sBDaSGMY-A$(61znb3D81{`3OI-z3TFp?N_? z)E&tMDBd%-$Ci0}aZ#;$+8)t!=Afx!uZS9}Rz+qF+ThEOqq<&h1bAtW94M!1mZT#am5czRjAE%g zv1qc!&o=i8wB5m_bqZ-mksQGzmPbyW-o5mnOXXUc10}U~j&Dj*oDy&cLDZVfs2_XR z1feV1+8YTc1dyK+FbVb3Olglpn#`6Ysh62pai>rY^q*ICadh}LNhM6TBf6AsPiUko zBoMR|D0+xJ4J~F$5|BGgD4um%Na79pONxGEwq?9klH%iYKE6a&@x;sWFoXzYU$TmG zTgNh7GLIUOYPBWD5K;n_k(3aHk;|_^j=s8D%;y@|3Q@d{Luvc`{%WU>6g6{7DQn!& zSM{rc6`z-#DQAqj&nhjOI#xyky~u4qU}LGR{rJ(7!pm{%y40m1^(&SR)V8c2+=E`@ z0eE>(+iA_uDO**sVJJdScV$XQ867s&Ovf8|g%N2nr`nL| zl>+ao<+{U(KTwX+8AvC)DFc=}sVziYT0vlKiEO0~UgiduxCA-?9y`gdvUS9+9wBYpqdmOr*CdyreqAdjgZs;EuIjG`{OI%?BPz zL&^zAI*Ce-tdfS${Ti+9X+)c>MxT(>L^}S}y7~H>L&v*!%~n?*3X`am^F^|hL_(A6 zIK@;5Ei_c#!cq~nDM7+><5_Bz&e66hTv24kZ_U=^XUOf4vJ_HxAxiNS{cTApO2P># z7y&!E{MAmT!2%v(&U zN+c~UGSL`4+llBrYPQwk2-eQUG8=Km+D`D!)g=lk-L$K?`l=E&4dJ8PCi!?^r6gsk z>P|*F5#Q{sx@{%vqi;0Y-olc%7Eh$2205PdSDtHJA`~`>rIUpvJiR4#>rxFi^FHS` zJ8;^{_OG8b1IutVAGj~gWICA*>{jA-tHP4`?`Atz5Ks@oDR5%BcUd&Nm%k1*)$c^= z2JZI8qt1&Z@gCu8eZ9=jK_K>OPjkS4LivO0srM0hi+19cq;_Sp$Zgg(R2+$DX&6|0 zZXA8o;BRn{5OqGJ! z10IeD$B(wP#XYXbc+*Ei>zh=IPKmnDzqFVE<^YV-s!CS+yN1o%hsb@kLeFtZLQ>%+ zNNG4w=%7Y%@nVq9xZJNY8gAh-<8(L(N1Z%gQhkaeAXBZz)iM)of`u&X^v5&(4PQQ0 zB~(%{r$}zLt~+y>aqp?N4pdJ;>#3|cEjSdWWV5gwrzaU79YI|xc|oqgfze)x>GD^S z#I2zLgR~x5&rh1UqmiawQArlG2`ud;$IzVP>ywY1kH1ozd-kIpQr^DWVkND)Q?pZ? zbIuYv^dBvA@Mcn1j>+IWc5bg?**AYUyw5zA0Y5GdE224?D;OygO+h{t!&WX;vEuVR zvm0atl%dQlXKs4`0NGs;CF9#IeV|GPI;%axxn|c5=!}^Tkd-OclAPoccaMv^xC-fK zWhrUcLJuV8Cq2TEl6;eqBvO23A>C~#rwU4&M={)S)~n>Wpa@Db0SZy?I5lK(Y7E)h zo=m970SIja1D1JJdM%eUq;`t7Dpq%77HP zYXx1wt>1r@MZL+mEf{SL=O?PMpPIHJ$#rxRrV>@)6e^BQ8Y)PU9Z6;i+vg5o5ARv6 zV^>-^ozG-<1XCI`-PzO>7|BT|IVu_Zm6N5e;b{qE0gtl(0Cg0a1L)Q^vx3`G2?Nr| z+B5CvURSK(k`#ziHx6SYFYZ%9^p)r+xS^c#1f-BZ4Q)n}x+%cKi4C?7M^rrl@fx$6 zWHg^<+orO9L`P!BiRrvHXB|C%?x^wtn@$v*6nynHg`%wR6ql!6mn}*D@W~*2dHd9k z>!(orf!ksoZYq$s|(NImJ>)90+d;!h~lk1#UmNzX5XiuS!@bwWX5O_uyX<|}d2t0>&Jo51D) zuRix1Y=V`cNms&1Bkawywtz1gN}7N5TZ= zmO!;eZbK4F#irX@T)-a)0y-1W)UFw4$|pCsRydh(R?bdG$Vuu!$NQ^#LfT4^f-;1s zmw$d~9IJ~rO=i2CBJp6x*_SX>2m+L>t8#ra%_#}-t2WWeopDcbAZdq67tKTwuX2(D9RV7qPcF&+U zpY3G7`KA5GYvF~Z!{!l!Ml#xZ{GWQh=iYy{lK%kam-ij7g_hN9x3HBB*-CNh=zjfo zYoqs~upCOT4monH6s5(4?!YTZC)#UU&bpG2gk&p`IPb4%ONmknuoPTD9JAg#tA#q? z(3k1wkTiC$b;1%?8MKdSQkDMIR?j&tv9*_7NGkvU4Ru_{CC?PbSYB(uzJPymmu+&TEuaxIX86}~7~8s1<*D*o4{q0}U*uA<*$ z5r<^F>UKJ^q7L8(E`QL{h|-%_4Xs;9>za{24j2H44P!lbW|FQ9B`q!pjHCnCnfvt) zG{B9J9#CzyB}C*>H=mOgcgd4MomA$b<27uP!13%L{q3qDks7 zJ}(+mK#u#ZAOM9pu3xgC+!eDfIHe5ts-MhzXX4%@Vq$e2pYha0QLwj6`!-uXyfIlTR zvIw(sR)RvDSxSZo2fCHBHVGJ72dkYuq8+uzFsR8wK0R2GkBeI_@0;yed7u zK!)EPQwzG4&zF}X6jL+e<^#bEe@_$$`^qml_e0VnWPjOE_g;`>KhaloYH5U@G? zlnb?)vKFY$5<9ok+ia%vSB*%q<&1>s!C+-rJo z76xD$nHtU+^X6YU&$6O0DZw--LIo;P?+ltsE`+D(7Wtl*%COW$&tV!VU=Vtp0dM)Rf!7 zT}BY9vYXV_0F%2?7Y@uIM|h-XkVzG5`|s1}3GB2Rg-Yb5ZF2+X9=h6%RRm-=pj=WD)q5BC z)b=Jl!lLZ1E`Xmmk+nSlNv)zK*Cj$cu%&hM5BuudPOFZgm2lvtJyNqBYtOUNt&M92 zoJl8!dy07u)-eaCX$cVpg(O(NTQD_5H*A#$i<4&m5JBMMy1_(*X9$*xH?JR3mYKI`l76Wi z-n%X7CvMp7sYB8NLU$VWn_bi|u**BK%$LSKQC%#>-^wMn8%O4K38gFzs8m+6MmmCX znq3N4l)@0=U}&3bMD@!I?)k-S^l#*SOio`$oV=`u1F=<(e^Zc^40|y^)AyAm5~$>N zVa|UhE2%r737Fu%8sRvY(f4PiDMNE?$K)dhPnn(D|uO?>7%B__iZG)sFN zaj;XK>?J(u`MVF5u`IToQKgznc7Rgik`d3L!UbFCU&$XGw0z$Lw8*8x|(;imx9!rnw?J*TixB^I1svUa#4t~nZ+Dpo{ z49%4H6ZHEIv_NZca2W%oIT>6b)#ZCU)>1|?NVZAGv*6dC%#T=t zrFpF7oQM=@=5419d6Y(5O@ znGdD5bnWqF%}Ut#o>pP zM7w~Dt~{{Y4dG?nKBZ)g;5HSHm!%$xPqK?qZ<33X!EI=4OxoMf`h`mwCBp$j3aHuO zClbqt8e;NRIe%d*r^aigCUCEgE$jozA-7cG$y;h^)TtnMfxn;h=SYtS`0T>grnu%6 z+7J@1#q=MOf6tmnMA58uKLGW^GS!!BkCVZW^l9iNu z+q>-}>YHH^pAM(nSZB%ihqg~E)oZ?>Xko5BI{DB%9TD%{6Wc2xf9cm@+0up81i=3FFa7YeZjrG zRoSFu_;WRCKjiPNl9KzpSqcZP<{bQEN!8@@s2^;ld{bJ08`KdQ&%!?CN6|=?szf%~ z!OdB3W%vrx(w4)dmsY1+9PmA7!kOLR4ybX!>g;bcg=I+|aM%ERwPJlQ*KR=ZEn8GN zE-J=;Gg{A+%!LIf^Fp7?mnI1rA9|?ttuj6SY^~A2oA*~BsT}*IxA%>2dx2Lb(2}L{bqW^-$FIhIiJtzK97x0+u$i$GOcZLDI|~**#vX&2NmIb z3WmU2hgRK>q%c&FbIYO4OVe;!=cQx>@PZ;hPj3kzb5hkjZu^z!@T$}ilPUoR1pa&P z_JLD_!B~y7zErh8F-yaoQmrxj19qQ6kcd`%T^f|A5*rLH=C z6sbZ%QqqmYDE|P`t8E&;Mqv!Ks-d=q)!E@mQBsmQ1JfM^LXXdG!yerY_%9ZYyOkh4mXq^U}BGV%5;?84s#$OjT@uOx`Gr{C=3AD6mhEgSnCGw_{{UTXZrN%FZN2pkwB(Lrm-Sg0(ISY5OkKC+-TK8HFk+ zDIk2`HFz=>LV`#sJ;ags>b}?^Y0-M#PCF}|xd*(df9|cx;qJKDqV?+A>M6>qUfcbE z-_zQo&*!bCN}fnk)<9oOcvZcmO_0{K7P4)nc6ycyK^~A&6i6qoD?+$&eN$;NbxS<@ z;j%`4I-6x^aOYq^2bn*2ohL53;KI)$bIYKn#AgQESuR~W2pSZ*OhR^ z?#)@&3R|A2fN3FtX*+hi}?*%_y%bEU$umLJ63K;OL#UYtmX2yLH0V?qYM1x+@r>(6x z12*=OjAHp}#GJSO^gxl~9tqM><$?+q)uU{enew;29?jt5;;~csVaIO_avy>%E zl21mK?k-L%3$gKBi0UvhnQt4SD|7O8)?wU)*-S728SkIQs}5 zf_nQCUv+N-HpxT$lD^}W@S5Jf(gSNwQd&Y%bK(H}71gb8dMgj(V}jPQg#tNsIP39O zw$!B~ZV1T7q$|TNcAk&`W2J35Jk|2o6u4#ACzjPAD|fP1#>pxe2aw0MwyU&pAh_y@ z9W!1>Bg>X+-bv-kwSy9hXO$$S1v}QDp@Wh>@XcW*U|~us$4vKf#d^xg{a* z6pUIuHrHxGM^bal(zj!_$On2Ao=0{`A0J9Z&lnZ8t^I<={GfB@DyX^X#v-6)wS_5M zvHd-jwJ;kD;1UZ^K%BuSA#Rq&dIb^B=C2MW z65PULs3)f*o^|CPiR$@0ga(J&02xzTiHWpE9bihk?C0wBOa(H z#Adc7z))RM2m{BhVG~z)v+-mo<)@6wgMD44u_%fqKR|J zFd@ZhK}c@{+gn_Y+ltB?LF74+UPm$3x3cORP90aGdSk6iX%O388XAwdk{L%M&XpK2 zT=bP4IX=3>jw9<5k`>>cb+sEYv~tIAt5*dapTVI}qXUN9N^wdUjM2k;0Vlk46_jAB zr_ERg3Mw3ls7S8nWpJZ|y-l)Q9S$qfBPGP;Y@VjHYXo)y$F#|*t?^P%TK>EG4t5HN% z1B|oij>S118PDCNQBoaAN=MYkA`W@{^o=riD`5h+GU;i+kU&bh@~HbrYk|cXLVE=5 z#_WuaU}M`#Bk~RQfhu1?lmmnD({t{nOHK-R4}w7MrA){OC`-ebIptPLCJnxa0+*a{ zxTp577&}r1N6AW3rKv$B^XQDzS|2->cb>kFEb^rbmX#FtDajbmD!gcz!{l-LW#*yDjz*JG*;?>Qg*10c9kO0DlX~DHC zC6p+7T-Swkt0+g{iWqfB@J>2 z-_2gLOC!sVxg)R&E9cEz>hOeLgBe;L;<}cJSEL+B0kTeV4LG!*jjaW`^KI?}7#zvx z&Y4=6%VX1FWjW>7tu2i>B%HQX+VY|Z=8EZ9;qVZmEvf=8{_7zU4236YLY-QYf#Zz* z%6nz9x0ab7R8BGqm(H1*kjhq#f$*?% z&bBIJ>?NY(JJ-0W1osaLorokWOtz!8VkL(0l$8*K2Sa(-;*tm+ z-c(3R<%BlCDO!{kqtKpxDN|}pcty3ccBt*ZJxxP`M2X&7-ykIkO1xYdO1>kJ_b87I z3vIxJBbnT!lzKq@mU@p4r>%Nif)*M}VJc1u2fmhets*#a=0X-%jHkY<7{!)uyBig4 zXp-&#Apt520YHrM{cl9i})%DGn7 zAKIn0*@ribk`<5*V>r=v;%St&_Z_NQkOoRZx%*BI(%jRb{&%2pO~2}*hV z)Y>0;Je1g0@>DtJAax%&p*JNp^(hI)?r0xk4F`%8I~fh{A(SVW&rW|Jq`)Y;q_1fq zIZiT>j}AwjdTrDxAt(!3&T?ra*IeFQY=i{(Q=(wGG&tXDfTq$0@^QHR{L(jLA!SQp zk?60|&JRC~R%A*!3R~M!u6fUY^cASDxhhi9zNA!bi+q|s5#iF80ZXl?s32?~FDgvq zYEy1(Z3!L9!hZ#ATKin7qCFo({8W-d=?$p?l^oViF;9ZDXnm!I(h8bBBsQLZH6&XK zaX4+kfOCR`)m0Myo1xD)U|KsiU)M?@mpunJbdrocXs>)q?5tf>krWIR+{O1X~XTRTJr zDN9pjJ4o4_5;4xSB1>sT20G&;X0T9@prx%Y4)8fvRPuHx zFgdHPYf&j$M#Sw}ejkCXo3lodxtEM(>;wd_rz-a$fD^q-1xJ}QkZuP!$p<{^YNQZK zmYkE_;ZRI!j|EB~f-(m~;aO+l9nLASkA#zh)K`$8u3%%^Lh@09JL(xpI(!>lLyoCr zscLNmV|x4R3d&LdS0T`P>kE;)Atz`cCj?Luc7UYk))iGv6BOSjQl+Q@wDR$+paiK~ ziBfrEHI=O?ZyS1dXPNd_mcpDI#?<$W`d=MY_h{KB(cq-5%yLLQ4SOqC1qpDJr;(w1 zakr@MC#_?%DfF*7D|C@P$8z-TGpkmFUK1Tl8EM3*cbwOSU99NHcIy}bJuJCe6MM0i zyFqt|k_o^rdg`0k$qmX~AyI83Ef*42dIAl25u}8c)!F(ds07xhH7=hC34Y}m^5#;i z(4AqW!b)4aHVS!sBU8D2l9L=eH}a!_tPqH~f`j2feySCNh$M`aQLSv=F-S^!hZ%WnKHhBHkI*Sb&@ zA=yp^l=2&CBRcO)BhU+fd%S^2&JAYe7v!C+ldT=2iC9j|b=qrBnzYh)1e2c=QIo`d zKFB6BFYRC14q~;v#QQk(QyJBJMO$<}N!rOe%F>@ia_9%Hg)p*$^Uf4)PERmuCU}i* zD9Wwx9QS7&tHQXQZeVsk=DEyu9QjoiNUtP94n(Oeu0wgiE@!`&FBL-_$l9cC><=tC7*4ESg2#m;31K}YA0Y#D@Boh0z+AXDpI{MHQIRxjQ$yRUB?0Qw- z%WH>sGtIQSdGX{u#hgCr6-QfmYp!(@!S^i^Z5xTE~2W=(43U6E6G; zJ{k7cZ>nZk=MuPKy;36xxt1OUSO6(VcqCgw5-&s7zA~{oVa!Y^RI`vNE{u=b#(m}&z zwUgbwKZdngpySIUYZm^Pv(noa^$*EEl}d!mwrpZU~*^Vfp6z87lP^_SC+nyc@@ zc^g>e9c`h_r9ntnBhYtNt=zdDStL?E*-l`Wm;@Yid;!zfUevjXNC-7iPQml$gqNEIOHu~zV-6r< ztMxGXB|-Tdmh`qp%WF?dNH2N7W%J`G~9iUNWu>ld`;$ zrKvo*U>e3!Nx}K*INQ^=_GQTFC$8xUA2ulMZVenEY$;x+ff(`5Dju&NmPfNE;E|UQ zthT2%6!OW&D+o|picr6Tai1SuM@!RzQ7*O52O-?n#J@B+Pn@(9oOK7E#Z>ytOUW|E z+M+|*kbNb5^}P?IG(dHGyfIO-E(-qc53m~b`TeoEPoy7={mQg;c%|g3#K}Tsg{c7} z1M9g~ROEH9vfq^_zM^7eus0%F6P5fj^LsyySwoV^-kB|^`$bvm@khw^9Eo=EkE&%j z=Zf{)CvreNd}<`8ZU>{o9eQ_smFKsZ0X}-r$Jsgm0PNJQZZDEv2@?fLN=OPPt~m}> zmfi|Hok+)aY91e+oGe@!!S3IXf9Tc(iN2E6Esk9I6@DoDwLe>n;PpM#UWeu+eNyEeIp`EgIj>{S3J&Y5DepK*$INOMsA41OsIbv;WaUY7 zI2{44tle8G03N++vohUfDMz}|bDSt8E6?4pXfLf>+q*WeQbVU7AT=x0ai?}e!tAx$ zxFNM1FR*$M{1QpND6TOtp-E7N+n&DH4khQlC?_yQAF{o)CaqHD9J z;p*!{&4%RNVgw~eYLfbS50;#wYTYWf63VqC1t^s%S$GVN;A@i`;kL1mu!y>6Q||=i zBE;gk`wl5vJQw0qsR?I?`qACqmgHC;89nEcf8AO~^#(48{k^lRqH7H-^04jx3qd@F zA5Azpu5=)Z+n)PivW?j0=r|+3xg2m$h-y-|aPL~UwGqqQMT{Qjx~qQskFtJ=okZsmbX#qw{uSDkw11QvzDn@V5p*YR64tV{sAoHt z=00lV)Nn_ME;+fb9_qc#eU-c;cgCU(JVx?s;{DIFTYN3n9-sZ}(8WJ~#LWJJ`#P1L zDe(UQv0JWci+C<8kVAlwM}2#1i##`V3qtjLAf$8(UtITBHnHT3#+geI;&7u?1%b5% zYmA|+aa)ImKv>n*!nCIV zc7Oq1j~4h~r%IjHFcRBiJA<6FT(XZQ9xvel@UHXJdL~3*Ppjb?eTU?6#|h;kKM3y| zUE~VqMnY5VBytr;>-cB(qTfMBLdxR*01JCm6zbSZDdweaIK^u`ZsB`OJ=*HHswhcP zP=#kcJpGkS#PSg1^u;f+;atQ75xBp9h=6};HuI+Imys_YE&G)344h8ocgIrP4!dVfq*B>4#Oo%Z+pi))UeJrM2O zl1GmqDJ0J#UN1*p#m2FuF9#;(yaESGq`y#O>7qV@GX5mh9#UK}Q6@9e(zK3wLC0Fs z=ah#HS$DT=NOK9=Qb!_BeMA`YDB`j7Toxa1pSZ7?JnBNPq4~vjpr&h+bhBw7DFDiS zMEruX{q`Oaq;x7PkbBBMLm+mMT6tq7E5HLDG?~vR{SKzE7=6G_0+sN+mFZqVTtkin zj$bsmI0U6ClzE?OFliJ1L|WyidnM{UG9BELk|iEo{1H@tsNo*bWui=8k14$i7=SI) zl%SJf<=JJ+)EbSjLr#qj} z=F|}aeB+2#MJZ#D7RB=U>VJQ=X%e(3fiKE8OEjc~*&cV1&g={yS2{)X#MoTHMXpl2 zz&x?){PamxAts$#J$#K4+ZvZPx+y5wPWmU2uglTpSxR6kmihK=0VjLbeH%1QQ?no+gzj3aU`bM-Ne`B}(Mt1YUnPoh@ehK-_ zZdZ{P4U#vjSY69%lT9J22ju&t=KrANb`D$xG`8D9V;7S^|( zgp+|?RIeh=6g00-RB8+)XDM4=kp0bQ`c8O6w|2F1)Jsu445o%hk4nN`zbmRVdKmC> zyPRU2LU&qPRy{|ZB|KBOIFb`>P*Lm4opuyoBYqMA+Q_(S2H78FJsbWZj90h(miQR~ zssQul`njcBv<5h7=?vB(Z+z2PrIQTz3c}Ej(O&|v0f>v^n zQPb63sr0MxRh1{rY%&%V$oA6$e&M9gc{A{WEBKM88fml0X5=zHLs>stYl<~mP7W@U z#5?+cSb~%**;>ZG)Te5L4CCjnri{pNMp?XxAE-DaB7n0k&b@G>%fpbbq-=2Z$sIX^pfvPE{gcsK zBoA&gTal&Uw4mE@tr_n}ngpN^QQO!3^%C`5zXe{IA2t`G;->*t?8@V0afeg9$E8o4oBsu|NJ>k+i_HovF^zN^xn2MZ6aztc|?j;S7 zernYEpLJz$Le|PgJsc#D-BdqR&+tmdydN}~;rAAvNO7Acp>Upf5m)!=Sm75MW~*W} zweYEY&(s#5zh6mXHva%@hYF@1T^-t>53096I#Lzsx{x!2m2LZisr!ak%M!+tv*!a` z0^@7MHSb#OoxH$8hcArQqvZF-H(l%(rY^ZpEGY#)IW_co>9QV5+imvuCjcJQoc!3P zneuK;yi&KrsUQugc>y08z~}d|ReqzDa71yb90J#qHyNK=TRLJ>T=|7OGDpi#5&V$2 z$tMb3sSRhRX(2iIz^>I3B6fg2{0Q!({{VEE%O4TWekyQc{{W}p?mp?pb1 zTcNfg+@xd>ODwCecQp)r)Xe?f==_B=#ggQ-W0IvI2_GoOv*M`w%&gKlV!1gE7m@C} zl<*JTt&#Kahi$tbAg6Ts6Kbu*d+4;J9(_)6T~%w2;z~uvLs1r^kP#pxk?ZI8>CRFt zah+Pc{J2y-1()&&_U^3yvpJOX%e2l#N0A1kB&|BK&~P^?STvOR9o$=SNq<+sWdo|a z1t=5o8tS!Pw37kWS9A&~$xuobqr1Fh9(?JPT`W?R;w`~U6=yC8=PLO{7PBMlzAZ9K zlbxb@9Wu2kGWD!v1#{e(%2&^deU0QzZ6ud9qlA|GPeK;V4-RBd%+uTorAd+`_=(w`(PF2kWR zH6((pWTdj3r`K1zwmSnTEjg{Fw6%1~QVlYTWv(QG>laz~WrKvMtfz7C$1GL7?B6A$ ziVw1{i{!JzhTjI^d$_!=QvB~azRS@msO5cZos(tlaB4vmnOkS zq<5u6jC1SH|WA2mn0 zl&s>s47RQSaFv{gEK*!0Bbv@h`3-Fx2I1>!amF;uNkVzy?DP5RVHK??!czRX7nUB! zFj;XST(Q?YtJ{ugHdEUPcM=aW1FjtWxv5gf`(;+x_Cwy_-w&g<6yA(wWx<7DXXB>i z@T)_`d@=7fB9eKMRfCTTm`EC2p=(9X?$|z(iexBZC*s96iB^V=*ikN1Sk8Mz$jKwe zo<9vu%jAa@K7u}m;iN={5uu?BCnZ@6ApG>MHNQwQjKI^ZBeOUOOGz0&C3!+r;!2UH zr^jfFg%qgn9?|$|9E+`~qFY=WmO#c69P;(^H4aVm$oA6Vj>dFo>?ktRkcxSL%2Utd z6=V4>To&(?4vt|-Qn$H0m9GT<0BfZmy;RC?5CT>8M_NjO0J_iJt2fCtNJo@ri)-Cz zZ|-v9P=sVHL)^)E}N(Z=$>EcD}>pJBs9osBxavl5|WiA zIRFoXjN=}>WY>1gIF9M?N&f)mR~g3CNoj^2a^Qp|)THi9{jWTD<2CMj{{Y(J(T(2w(PpO(G*k1!9oG{Rhwom41 zZ9=>qinQnd0J-A4qlK14B`#a|W2as#<^qsXeslp+R&UKRg$K+O5z%d-#qRYAdx5G} zsOUs^lClm@=R?od4OQx8L@X=dg|ow04i7_vc1`IRUhtETU)ktHoa3HzWPCU? z+B+S7imTYUf>XNXV^K)}kpWoGw-s4xW{bxHlC*@4aF>TABe&9a93Dy7%1#g8`KiIK z4(J516s;X?e1pgc4Gv$rKYEwjZ!yA2UE0W_xQqx(z{m9Yse6}bNM*;%ZSEVDPTcT*ZDYhP;`39FVcYxG7!-3pDo8-R^ri9~n(} zdrIjjq_ZoBnoOL06CH$+_bPs8NG*of7D(sSeGe}Bi(W1-H8~xUoV3}``GqKAQe>>D5?tn-0p@^uUOdH9>asHLPZYQsKQnC_17t$eyOwYgm@%+E zN>LMrIvr29Y)z`f{GvDd7S_%Ofg_bVOm)a;Gi}dERMfM8+L=g7PJ6jyog<3YptMLW z!zJS9ru&aA3EHF20OO@uY9-{$+vbI6;bn!7ICeIP)A9n8Ku@{s4te#el)=!kqcTeP zd8R_Q9z}@4mD;a5f#%!_RCXOgi+Br3N|Fvb((@wn3KHy?h#BNc^XT_y6)!tu*@)3U zPFi5M+DXt_Z5ikNi5WxY#U_Z(ky=y_53L15mJw-TT>ddm*B>~2m8x8p9BCwt&AHi+ z!%^sLThQ+R05wyAXQ`G2Rp*p?COBfnM@;GYs8Exn;k1=6Aqlj%wzt6H-i`^}bfh2; z!Ofw*Lbov~fP^rZ9)R(<0u4GcCC;tGxth35Xl6{yB&T!L5w4|(CEiI*7 z#%-~UD`SRQVd&*av)Z3g zxpR9>&B!Nl4r7_Wx zG3ylP6>PB9_1WN+E8roP5&r;7BAaH)wYzp&C(4YqAbKOxN&f(OrSaxkm$hxd+DOMW zl0Hg>mm+jMgwGRg(Qh7<>tjh@M5nWB82JTmji7CbY=+s4l`qmeqa%>^;auYRUHhB`*3T+>`jK&_cX<{gn_#XY~c6(ZAei8*M?N7 z3>~;TMn}m=B*A>|E0pJ;IR!Khep=R3n~j+$M)?~Wp3nitwEQnw!VV9s12p8-@zU67 z5fDm<`kGU;f!~bgnVFRPD+rGrl$5CMC9Z1zoc>x~sgg(vcd|l$xTP3BcClHrB}U5* zCahIG$x~3KV<)ptF^~x<_TY+cV$-TxXeAfomUkR1WG|0&5`$M8Rc)F)DqxUqp2=u zYg7AB-a-1hmT}xkQO$W~?{SXup*eWm=>TrRurLQKj=mJ7I=amfoz3by8$mu2(dm0| zY9Xn0c8y!@sOsB5Dmg78ViJOVeDW)1Lg#Bc5(;^S)iosJ)N|6DAn}8QkzU;^ zUg^fbB%|uvhu^KR&T`?Rv&D_`WS;dJTe1|ERNQ1J5^*^0N%a5$`DqjzeZ%TIZq5>q zg@Si0J|}N8P4})eaI{23<~XCK7q}Fbn@|c*%~3Wu<-w*UHr(zeT9l)eDM7)4q1(WH0&tMmZE~Bj3IRz=>d42&DaTbryu9#wCZ(4pt(!s%?xY}idT3Cp zrYDp)0uth6{%JO3kN`hbUq4?;Ugwnu0T#oI9xK@fMid<0K=xNsa@ku5p1!ame-P11CC)+ww&wa64Uu}03Ni*3=OKrD}yYbgG3Do+H`L8~? zsFt8k@)>y{W1mi9s@eWpK2E7~Vl^Cz0|zQhRUUrYVV&i(R66uzFbTKvZr!R9GjF`f~Fl0(l`8q-$mnV|E_8E5Jsjg@pkZ~mGsj2{x+&m^wq}>aeI9_!bQaiaGRvZboy}9j0b4yI4wQ<#0<^zwho_bE2EOD;%`LK<2JOn6ru^s>b79BkSdp+Dqzq^tLwEl-!9>G&voBDDyVhx_iA3#VX$VS3X ze?weHX!;-#t&b_zxL+k?3~euvJ-sW`&!Q)N?MaQoq!g&<(r~Ebmbc{h_0Bt~j^@O$Qe)fWCDkjUSliR4Pfq&fX&*!vSh%2K@V%rH z@O>qZy-l(_ytshl-MTn)87_Aftz{tAIW$?aKjK+t!lPDp=9|=4+iXD@^uvxhg()zJ zUf)uWqJBzCc9Mzjsrc_pc;pO`v}4B|)yC)OfpI9pOAPSJA&|9UPL;1_Jwlq?^5Ww3 zgeW6GLk_Re1f_d=_g0Tds8QOGj(khW+Kx1*9#ben$?NF3>h;rI$`ge?lqGhA?MC;L zf_-(y%ktFYLyE$5O}z_m(IB$CpOo|KT3YhU6f0Cv6sb zoL(8)_G?Amw35_v&QuGkM1WG1_uzlJo~AA{NJ^o&?o;s8qDenBaKb#b{G!&-4QT5_ zX$Pucr~*D(*YxN4N+=XFr!5272!Z@+>iQiFlQ2 z7OTvJgf@hzh3)}+d3vx#afR;S>=d0{L+xueVgv&j2#Tq@_4 zAC*?Z+SM5i9;CwM@d`xWl$VtmDoYchq$x!}`IzZem!{^f5oezpJKa`jNeNP3Qc8Uz z^;I1FL{^!Wm!504g9Q!+aw;x>N64Dt52iE9u&k@yW&l_H=$@Y)Ab*bDRBHO1|oiA$G-aa4GjBNLrVSggnlDRl&;R zua!EH*htm#8Bd6529c|b{!@j`!(GTo@CZ#y&}Zn6sK$=%dfc{10uf7YubZyS1p6?R z3NG4WQE9%)JTwK7>6q$J_6(d4X|4}*ik?ymNh#NI!79k~Tl^G)R=o0sl&$Y;`+!*^ zI9LFWi;%3}q-T7h@zuefLStJVipmI&Z7(EXty>aOJb51K_WZ{cwGOR@(vgkLzq_BX zbFZC?)_i>`Njm!C03iA=X1ya?@#vDIaT4MY;o5inm1XIAhrs%rX!;cO#zyo;OX^yQ z=Y%K#Jadk8D#db=;Fi?2ufjoJfbwB^k^ z$34nG2p+8Fo9ADfbg2=;(i4rUQ%P9)HspNO^MJ+I@5e2okvgEm1Rx>F$OUjb#7sY|2idy;g+D@)RS?@U=g3(n$WdH5mh_GTHwCV3A)r&WcKa{PgI@i>j?l(QK8J`O3n4H>l_5qx7d`zNq>z z{{Rzoy9rKpcA7$YkOkQQ4u4`#Dv4h8=8L#VTAtThbKvvE(my|yRl=#zvD1YKPAm2y zM!k&_5Tunp>VIRNm1XH)lCM&%?Pyw~gp9POrD|ot!(e070Q=Q%+aJjHlIZJ6 zK2V$?Wz-@)^^%Z~7F?L6P= zd_uBx)CH|6OJ{H$%H@iF-T5cqXID()*9;wDOs`VeT;1?Wr7LzmB#KJM9e7azw$jb+ z8%k2WB*dAt`*#%XKN+rD_q7Es2Q~r^EFb$T$kVV?tRaNsJo8q5oW4vRqDNt~5Uo38&YsEq~!EaIqn{+ z%3hyJ%lplp_^VC%#pO^X6p$31<~x9-^f}KzimeYO9VsRU9<+VdWJD!F%Yg);0Yf(F zAoM54x~U!sOTX%#8Cq^>xWeAsL6h4_SUkJyp*)-|`lTFo(ofEl8OW(z;J(UU@PDoH zap<33E6>Mp%e9(sxY2J-{>FFqhr2)DD~94OR6fmZ+hh~40At&`G^pe3Ts7RY24lEC zVt@IS^CORZLX*SiE!GV$B11P>Y!}~=A;PY~vCCp`M&n-Rt-<7!B4?v?q+PM*-q3)L zFuNs7=07_$l265&TM^wshYGCs)nz0VB`pF6k6PiUIIG09s5-rAH9&O8BmJ&b;l3yF zD7Y8z(&C(+=>UDseJ=y_nKs7L_f9@qRNI9OB?4j>=>GtLFq87+R{^J3YiR{!>g%aL`Dq#X z>si#Ap~n)Jbw$|Y3Oi?a4rjb~W~m=ZmtpIamejdB-dbn7u!)OSIV2%XHk|b9-CnbK zU;!#(P@cPe*GNBi6~fwkN%0?6vitgC4x_xa9HqCF0S-z^R7au|TRe#YUBrAKZxh>z8cLBLJr3O`f zw=te!D!rvjQT7AN+e+qNU`I+^k#~lTsM=4u;a|o$t_Yu`H65x13zgOd$}CHoOR%Iq z%8-dD2||jHqIvRh2N>wA^2avwZ7Vw+kl_j$!CH^Y-HOS2E62+<$LcZ54beNKYF!`O ztjg7K!C%87Yf1omk4o_Fzv067@u)GoKM# z5#<5HC{8cWIIP@}jCu^Xq4QT73w%P>LR&ty6Pm&;v6gnX9SQa2Lnf^K5-XNbYhCh= z%X7+qgiWalI?eT=Bba6*pdXLMo8|dY@NKyPOSoQScx@{{KM}4Ee@szxFOI9!kGDsg4Bk0g&9<|xkpG|)T(X=^kye#D8mkFrpd%`II zG~SuLNmkBGxgkkNJ~^fp`D0mIcP#0r)WGCDES!5ybNb>mrWR0ua6Snc!S;1N+}0b2 zhXzPWPh4ZK&r|y}E}4Y2tmv0~wJl6XLLulW4uW@XQ3E5|E5P#H5uWX0aPj@lb5`dv zIrwL~x%rEGYupPcT7e@UbLX#XfgP13qB~s1d8Bf!Vd&UeDfOQ$zNdL;n}{u|hO8@> zGUS3e`wcg><%>EhJ2rT4YfjE+E0U#W=Bi=1K)RGAmcUpf3}Bu_tKg1!0Q%`mO|sY< zc9a8vd=5H$Ye(pqq9d+PqUBGP_Mt%K!y5?4a=TjEe7JSScEsVvpGrr6)eTcCZ9I!@ zg@QmC@6Y?O^4E}@3ny!Y!G8S^Qd@rLGp7vO&oH=MhTz zb4bUQ2OE-*mc^wc^u$08eMh>XkaX?F=+vj}wwaR=4WjgwGQnC}Yyx*Ef-nFCliUHM z>W<#vP}l%Z0eu;`Nb44Ssx3xY|H*?DGk8b)Yxj{ia5*Tdf=C4cgz4D1z zNLAi3Kp=pqO?~lDWH8uPd4M^C*Z$sK8RyowEtb;v)uV*{cF-`P-T?LmBxmmOHMD&% z3*jyaddB>c#ran8=1ZI2nQ2nWx|@4h>FO2Z>7(Q7oKi*J+>PI3Z$QV(%9vPfqBDgA z0yz_!*cyxoDQFz@IPvNDeS)ESP9)4;x^e7xK2hFKjvei4aE^JxBen<4UXPStl#v7t zX8Hr2HZ+QBVGV$GY*-_rw)FA!9(^fVBR00utOaACCvt)HcjCHX=~$?bt&@G4EtQeEIRl{t^8TEuQ*5IQ*c&&ErwFDpO@8E6D$Iq-H=MhETw%u^(>1RmdPmzQRWn)2IJvd zN7Hoae-b{jemr6iC$_jAWC?nl>KWAx23SG3Mv zpx^d)$x;pw-CPAL)GsX~yaS(}wl~3!(LIu{lG3$vJCX?avsR*tzy$8+kA^NCaT|t7CnjASWemD*-qs09BTQ5`7iPshi;ym*yX7L2c0{M&utzt0Z&pr9*&L z5EKmr#tk`Nol)lUAhmbk%{{XU`RSH8$Wyw&SZ4Wov1g)-XZ5S#j z!SsOi2Rw2J9QRhAMTh*SH1(3ilqC6OOy2;snw&}{u4qX-&uL1U;3khqSRz4A>;)J5 zs>V}KHUdfze`EKWyltnflE(nXeeKO{*yD@DaZkk**DwiGdyvJ|CzIdbVq)ueQT zB)ra@h)TH~?WB?MW9IAXt=C;iZL~7<)lGD5P}+gbOBu!z22OH7z#s2Nd(qro)Dha9 zVTo#M&090mXjAC(*)1oT8vw{Va!O7)0&ob(^7S60hXdIpUE;{r;ldu5uq~xG4%ZPI zKDV$&Rr2^&)M@K0VM%V-%2r0zm9&x%vlP*0yt{LGA~d8%O4v+}&12vk?ORypHzf1+ z4Cgf~VFb1?=_*e`dLLzWU=*E&Lz7<{hKDpthteQJ7$wr9q+vs9bP7K}7~PH1Ad+JP zrE7#RdNfL>beGbIbW5n;zCYr9&pFR?-`C|iLVlvr56iZEQLy^_jX6Z;WBp=jX3f0p zJ!(71tDClE@WouV4W3r=-nl_^^9?kGfox86a1#|6m@)!CScbp??RoM>GH1L00lMS9 z|5c+5&J1mEbDQYY+c69a3^1;>#@h2!EiME{07~V*xs9}))JBlKXZM+Fq+vjVw%lBK z95rPB7}_V1>+^V7EJTmU5>x~vL?uV00Di$`(wnKL%rxOv6mQ9NUM6L4;o8~c1Kf_| zvbW$$4V(H}rygy(TV+OqSvKCM0T~jKd;)$cu@ZpX&v^JR8OWX9G8t4YHV`ywdjXh3 zL&}4gmERv^2N1GHRQk}D_b(D^ZRM2jZ|ccAG-lS$MdW>V>&kY@{{KQyS z5R}L-g#r$vV(GGnkg~nkmiY%L;TK^dTavJq3-!&NQgKRV?MGn32`-pDUhG#tSBPgO zAoSjj^4f(mL>~$s18|iCZ!1*F+~ZMFT>#o-Xh7aFXlCl5WM`GLQo)`N&#{Z0fZmQ0 zUhvbC<$@~78h36xY@Jw2loPpRR)2%EB~tSc zsYFbkmY;QtHwW7FQ(gI8uHxk1cPk#ViEkfpBXlLXWy9oV&D6?I2bXkHAiPhGw&48h z?PoCR11)zL(!enLfp^k614yutiy0bXcXqk1f_4FJ$W&>wq+FC#z9v~MOi4*G8J9i{_EzzD6oR1!Z?fS$ij!= zbdc@VWZ|!lK+H%mBC428nFHqAybK4CknPSFjDpOy2nlRGW&b`F=7%jRLenB}1)1T` zv-FKWo<(4m4X6{0NC<3M+WDtqzMEF!C;6&b^n>xjM|P_DNEP@CD<0%Z)m)JXRB^Lc?(=2G&+m?r~f-7VKs z(D>Ce>q9B1KS$6g+*GhYq4IK2yupYeX@ZV=@OsXoj&>*cp=WQ(1Md;=Q>>u7?G%vG zHOOox+Lc&-2`5`gB9bV!yZyDNS7*VLUZb-o=hDW@9KK{1L&TVaX#)Us`)tFms#G>HIDHHEGPyb1S|D9)40=EhUwNAKzu;t~uge)p_O7$(MT4_e$b6+&`Z^Z0wx5h1a(Ka)aQE~=dq zqmDdR@^mqdQ1c)$HzTjNj}viZ1n}>A1;(vh-(8t6lziR&Ylp^b^3XGF!=GoBYro@V zUTS2YofPP_D)}26!y82C$E%hmA{V8gon&$VRuJqXpKf-p|xAlv=3Zc!IX{Vy&T`Cmmj#n@?-gDCdj*N5%G>lFC*j%ckVI9#VQj^wIs_b%YnYuB?r%Z=^7({iA#-o6+4Z zU*Zw@FKd876}!K$QyYQ=;np9IDCzS4+J_{aeYElT9qpD>IBYQ5%v#yNj4u~RfxYZ@ z=N&s6FAP5YbM{5?Mx}Wx>1i))t+9W^*}C8pn@8%%L5%ZHIpu^2P{h?xVdKzG16;oi z>JoJ%w8fUa-$xLTq||6ZWzVS+RSM=of#Rb1gI4rdY6r&aD;u}eJ?jMkAmfJWp z$NzxCGe{edy)J?eVMrJ;M^u>uVBK=#GX;q!bL_3Y>aRq>>djTF#4@_Urz_nC!NMp9 zKC=nMi&%vq-*V;^gSDOb$;_C(?p2x4R~SXQ?m+(s5=Lf}Er0ACKFnx7YQ|q`&65qaW42dd!=k5>Q~`A+aH-RmPFx zcOlp7+qtU?xtE%DIlcGj%Xs$TX_ep4qTq7FpV$c0 zG=@P!g6y?HAjQsZ^?Ye#F?5XOteG4y#xGT>U$FGC;duyS{Rzc@$876}mphG1ru{{K zG8wgUntf~IR83f6wl7axX^iMAS=+Vkuc~|eYS{YT4uv<~{VZ9&iy#rk6x}AO>|#JD z!^%&Y@S)YAsl|Z~!Q*<17k;rm*DasX#3@@|$X9mghOm4|y2!!2*b&y?&)mJCuZxZw zKd9wRrnja3w}gEuap-3%QY?doKqb&l3QtUj&%ZrS2hZ%}=1P4geYY=Ilw7W3l&dyl z_^z6Le)q&UzDp0Uv#3Q?YA+!*;ZCs_Qi z?KW^GlhGiCU)r-erXngf*q3i z4dfLu9?hw}#zzS1fRDE3Ys-yjm52?0kS1}d-Fm-z*YUILgLbY7rew3hWb3)|j1t#I zTq3umd66uo8%D7+8{Xun<{uF1D!%uZ^QUGhxy{Ls*D7u33NaL<=@m9+rUqT!=W5~+ zmE`~{Lp}KeI%%}Q6F*pZ}R*;xqba%3APsRTV4y zJ@j|&ddO{c{372uHbiWmN#ZVa{bG3rvgC;#LiF`%HD@fiVq1+Q@S41s{qe7WUTEn^ zMUM=%JuS|l8J%CGBA4VXlzd|9pKdEUB83Ed1&WE5m2$?>&1Hi4Tq(tT8!suuViIS} z{A1?Y?$WSaZv@^y7L$k)WkL6Xco(qloI<=nFR&gkdm~e-pz0u~bs%40ZVq_W>h^7m zAMpduS=W)GHWzPDSNzw{n@m>&JP2T#2c9T@MBD0=&TnVxBWDEv0jB=}fWyb#RV=2y zJ0BZ6Jlepemm!kuA1-}3=aTbFhLat>+3cJTy|fU1p_LgN>DMprhjBLN+h*%RoA_=E zMlgA4;0H-mq7_(xk0{z=6V(H7*?hlBqgW>2mT!a8etKm3Q(2nuSIEMbogh8ngQ=lG zc2-TPf`KQk1FH2U7>32#D*Zd+=hc;BNC8d|9{IXmwO2P~7x5%Zt!^ngeP;^dW4LkY zVzpx9?prQ#yZiO#VZ#7H<=EZ_iGt=uak*dG`TFh>vpHIVR8Kq}EP8v%J*9!xrI6v8 zom{?r4IZMe>ihV=Bfq}NuCQfr_bZUEnVp+cLa%gz$`qB6SQ4TriG)<MQ?QWlzuhM-+V-&U!VMv;{yDRFLYCqfN#{Ui>gN^%&~YGPbXS`!2bA?q#<) zkDhKJUN^sRjFwazPo_A1uv+Fe=_;CUK_>f4Gznxc1yiF>U)Cc?N=%M!&P+I!9_<+w z49+QT*m6GjP%K{anEQsDPZZ=$rVs5_Lar$ac|Bnc8{k{|`(-l0iJa+sPW{TH)AT&a z{KKf5Uz%xea4;+lB?~V1Hx@GWdqEtw|J5?hGe!KU6d(Nu&|k8JxW2D5v#=XhQvM95 zW^|+nKt(&66tcl^)jy2*g)$Br0}fHK%_37;}r*SRuC2^rWEXgam}urKHx#c1OgJHE!W+ zh!de2oU0_qrmjq;T`OzqD$R3J@5<5j-ccyO4V{b6&k12Ik}qpD4Lg1 zDo)%cx?*O2pvk<$0zCe1U~q0i$YGbK;fpDXo6~fs&z%o4qo4hKHdD$|xDlhP)Fvj8 zKmW#XWl=t3-m5BZTt^6`FU62GBiv%=x2@fBfBLsK=D6EjNo@6O4_@!2seGk2&(qL~ zmP0l&LCoe7o4F=1j?QdfAS@&n27n|A6qIQx!AsA7<}scuW@9U|y|fd5*WkvyFaXth_(`dGS!>AlMvdrChY zr^fq$&2gMU8vd6BE+d4>diUn~nd{%B8FXL#rX8w0#$YpClav$+jT;c%3t!>)D_H;g zv3_615c5gWKYu0v=8S5D`-V*0vz8O^DAz%X!{D98uaDB1M#yNlXz_*xfhq;WMM@M} zr(#r?8tbITuIIl_kmn9XiTBCqOaC1TN&bIdW7>wHh0Ig1G&n1KSOQ}nTPV-a6FFVQ zZQloyHo#Dw1SN1WmMl9NkKae@H~ZQ%Uh{Ri3amm(!waeyu3!mKuL($>Q|f027U57tZbiYTuG_Use-~_^&==#>2;5>n331;YgR+foG|Fgt3P0XMb9} zpTHZkpE>``DOE+;wz_yN~+A zgTFjB*pFD!kr{pY^i?4+F95_Js;)@QB|*{-FcBnPe$|3glE6(`o`4z<6c9`?1h zAlL%og896D&E3JOG|=-D4UI9vhSUDqWsSW{(7r>3)o5|W?OTZXlF+zQq|3+4&zF8G zjha*3UFNDKB4B%-Y1tbaDcN#{#QKFxgOOone|1iC7-HnP>UkjLb)}6d7h}KYnJ>uI ztml0A$=n{BYVRof z;iOPSJ_reHwgF?6E>b6x=(rmjIo@}dW2fJCa{RY@dBkr}Z=>(Ou6N<`%2_xIa4Zv) zlmn#01%h-EJSw|B8+~q-SX19?e*aSHBWG{ZK#q`0%h*uLhGv~dip2_5)PWu;Taw{~ zzUmJ%jaD;G_y_T-s|M0h4V3)FCLzS;Aq7Z~8(YoC>rzUPtm@{|S-LN{y{gzt4)F>v zIig%fn{(k}bC}}t8O|X>Ck5r$bXJ#ywd{+cfF{^~w3j5dUO4>6%~=$~ju_?~`oq`d ziKHW@vkBTPJTqXn^4k^F9F0gF;sdd?uo>1J0uwl@fQ$BwZxE1GxJrHF{iIh_h?0y4GaYXxh_MX~M}o?NMlQ0z!6mPX)*?gQDq< z&(|K3S>N+wAIyV5wTljFe)=7mCi+JmZu*XDv-F$i^^sFbL2O69VD3k7dOh|J09?a&H@fb+o4egn_pjx0LkrFW_ESCH>jZnpW-od&cC10tY$pr)pu377uZfw{P7HVVwOcdXZZ|5UlJW;#Bg3#6>b z4;%YFq;doeVmn}RoYA{D|Jgjy;J6=oel&(?$>5nPtL+|w4Qlw5TSru@YA~{d9|@Nx zUYJRBXbr!}UY-B*4^Z93iTD$%-CZxo2V9QAC>S-@7D$E1&>-o{p;oH}oc-tD96WZM z{V;DtutG?8FAEp=UAbn~i)Lb%JNjS4u`3vu!(ysi!>2iC4D;$j+P0hV1Izpb@VE&68|vXp{$gjLR`LpLL;VFXwX zppCYp>^a1YD#K>b)?Vt}WZNbRx1%M+qEWX`p4HSXlGt(OdG_l=P2%>00}1nU3k>(D zo9dv7J)yM5KCME{N`9IC|79ZO@>Z0q5mBg5ja12u zxn?|fZP<&sB)`UwVD5z^my*oo2pF9bLq0exkO?FHy`@z(=CF0%(V&1e^uv35V9Y8@ z|0PA#%$=U}j7UlYve5{|dmWj%y9(|DXSyf&mw5@1Fytu8y=omVgk=nNv*D6QxUr;Z zripFWuiG~`GPQ{5Yy2M%tBsZ$^P4QIPw7^cxhGp-W&xp)7ZmzAvFk2+1h;V&653fE z@YT0}s$(fe^||pi%_UJr_Q_0;+jwXi z+*6O6VS&84#A3S{7YpmcKk_LTT-x`UnA=(gzG_~1ZBAYF%5+-X%ErZJ24VWr3Y)BQ zXhi&+>?Y)UUYdE1)=1>)+|I?lx0$1cTZc|^$t7|~LIrAtO7jl=V9+9iT9!&jEjQCu zIYDPgj|Qv)Di~G;KMk81Y?{NO%4?$SdAOQqeXF0D&HFU2x_R%&*v$%DHTIQr*-1v) zKUXDXi>K3XPO!^G-t`b8R_Oaf#4O^D--IEwnO+jVtUIkPpR!KMC3~1Qa48UQx&>t? zxDl*&+s+4;t{v|FAq+gHS~A!WS;I|n72v@E!%X&_=#Fd_pG%|83|4!Pz5@Z3U$&3< z+;3UbPCvF+unzTQOxt^;L=IIzq7<&{&Nzr?aWmbM>b(cD<8lYO5fdQ9rGCTd@62Iq1c@U*z2u=5cW@Kt>C}m}%{<=#LAjq9Fd~W-+tT%lW>35G zH3!6!{$5mM!#(v6GYbN`a;b5P07^1HFVR7HeP$tjKH|h<4V4M(CzSQ`}xH z%~;-!_S&o9Oy{S~m~DC>@Hbfzcbmwuh-BrF4p(HtR3HUK-)qC=+qAxW*Y^cGJ#v>IqIK>+$!O#km1aWY=Q_13J~+E~x3luAi@;=fI zn(-TyWq=}-oe1RySe>RlJEB}y;Rc1eELL#i;*7WEEquprMxjR-i z3eW5W>^`V(zDFhauiYcrV)E7QnLgt62?jTw@9r14mMfIWgeT~x|9Oxb>b#T!C1DMk zm>z%1(WwXaIIDgtJzO(EHefNg(Syc4k4+cXtrgVEvc2a!EGY>5^W_dr89xDkmkVy<6C*%x8 zXl$QO6$aPl8N#{UqQz>PI+I%r-@IRDT$br_e@G;nZih5v{@d68tv$Ig9v zMJQ7zZIn$NmHETUD2mOFW%gOQhn3!0qE2iWYl^l^g{dI&FjRr}+GsWm@Sy$6lBS|L zjq$2(9A*G1nLxnJEw!J7+Fm=;X4X}&oX=k;U+=0_PU(Z2@O7UV{}Ok$HeB zAJCWn7v%O771fxJSauwrKi{*Gd32$>eal{zpVJ*0E9We}_saG56VKFf(VN~Nab}`( zMYdD`o+2@U?E3 zhJBI=VIqjhhPY}P%ikNNg+UnmgXYL6&QcH*f!=*?%FG@Q!=ZAs0u2n`$+>M*@JyB{ z_2VyUV3pR!IR%#9r$+idBM?~qpwbXm8>_RyKLC_bOWsjyS@D$hPG52q!g)!hTQkoLwBB%%ZC>5siEc}iUIw4$cSy;F7fGj zYqRJO;o!d4HREr8bv9DHr_8xA;I(;|8;S2+Z3C{{q@~Aza_?AsZbo<17s!xt-|LsD z;$_nRrFU~NRoxT)uEcOZ(Xj?s*<{(|2okBC3)uM*T@&sBQBQV$=G|dZfxi&LI-Js!wtA`SrT)38h9SG5 z_*^Yi)*CqY5e{QDhbj=t-6z3c%io8u8f1h}Pe$c)bMrBhNg0do;SVO;5a%%ROz}(^ zi&K9O3H%4pM&gg72(Hh?VXvRTXuoZ499`LN?VZi_Hd9rtQNAVVJZ9Wa-uuNyYl^Wx zh}Rg2=Qt9gUh_W3Ter%#Bbqu|E6Tn+zMM~7Rtt3KO_;}4cn2On=unjEgS+JYbcV*g z)^E$l1akt z4@>{FU=m$D!REp7EeQF){I68YRigh7t*?eFbvHHM631)lUFi9ZyG2Vx!1RA!ytEMg zBYKG6-6%{kMXIJT)Cr)pcM@t06(=xrCW?IoLveEnrltNsE)6eH}TXciTSQ zd^xnmdYZ?-AG*=G*giAT9kzrabInx)Ty9xc5>1j%-;xjNaT5bs7a4E<0rGb@%^6~l z5j8=+JH)G7>P;CHvisdL(R6f4Z~)T<8^6`)dr~=wRC)0TL};?9$-1^43rO8i<98-; zElB&88_P0KvAug(8J$leu?TOGLdJNFCAm zmsEF9yd`IqK{Ah>tiz0-(2`jh%HyUZZ_z?=v^hSIp_pd~f(so=*)(K_a1dV%yzGF$ zlx-9{S;(HScFDKTEo}O$a@e->qs`>#1`+=u=^mkoa7sYD&3P1GLf8VgMt5+_BinrW z6{c5%T(aHCo^t$-5B;Y|0j2G1hCbd88C9Yqpu>KJ!XBchIG#xz3cEy*JF&G}z7H`a5wcf#^e8gh z8|~m#WBBcwooPyM<&Iza#QlxSZ@8zhP`$NZKKH=WQ9nK;GJ6eENS~aJHP7!)L~^1z z2~{=u_)KB%$2RH;>2z=!lgg+=#vRd-r;X_d7|OwMT&M1(U$tA~;y8=mk0axkPoqVu zdJpstDFrA#{%*P8*~JXm5Gp%8pg)O-6>S6W@5{Y~UPKfm6cK{L7tUejqsbr=YkZ(H2>Bc=NmNRdN_zJPmM#S1jf1z7{{F@0e3VU=N57uV8#iBa zMHcY!aLa~&ZgYuFW@B$;%~D~Q$|pJ;Iyz!Jy4ep%crdkoo3A^pMqFh22CM-RqQaiz z_rl^Z4W$vt;j`jRJQKF>sFzV@CG%^=gECwpefu|u3pEA=gu;9LhhU<7gXym=~h zi6lqqe`JBt*K=FcwU)V^+1ZD`_-!G2{Uo@21@o=ZenkB}Q=}G`!_1&dfEQ-x2~>2s zQ4aM*G|HZ$W>G8HL~Xnrjk`&fitx9q^jiOl%xWpkv)H6>(c)>)rA(;EJ+8gXvv+@G zy{E6(zhZLi{Rtz&%|HfFV)RICYdyc4b*_SH+McLht{8$HaLEobGjnKDYIEL)c4NkU zexH8;zoVhh(9D&T{f>N7s6@HB`Jn7+-fQh&hruH*E1WWfD6!%SLcKXK=$(Bs+3t59 zI3$DFvvq0N_eR1{5Nb!8v1pu+r6jaHGX7K<+nlt@@A>&zJ8*+A*3wKM=%JCv+dhB3 zlyB-g!dSJyrq*Mh>#!7USx@Z{&ERmRrOh(;=lhA~MM9ob=USwC^iLlRm_n2xaF-yi zOeM9WGw?3T`yYV(5`7+<*^<=}Atq_z$Na6d$=zE8#4T4MGlM4wR~Kfl}di1b>X=P6pnt1Ez~66AGbA9V4JTUk_0 zf+ZkcPO0>038U2Ms;;K(;xX|WZfEEN`XOLK_Ef$kutZ^{Fz~;2*(oH=vRxzIEsm}1 z`pS05PT~s!V6Ki}$mz3X9DfxO(>_EB(c|Y~*>gTcB9A=h26co81g0W8SNV_E9FT zeMrgi`2?SWJ~s&0xOOJ- z{&6ylz!8cXM*=A%lm@DDXn=}`+26yc)RXzTm-L=cM4rwa#{J0oDi^r0@P{0HHRr8a zr;l?yYPBFkWBHUeuB1wqNdPQ4?d8fx8qm2Zy72LCEK#J152(rLE!Os9m6MRf3Cr=jO(EZ&}USYPonK$uBM~7EKDYh{Vf*M+b9VFCVj*V>+vm)+w5na z==$aKfUahFrN2-zr!@nr>>ON!`n^Qs`)4R@Ua~TF5xY6QwJW;W7|PhWl|16b7>BV&H!dllsn{T$wLcH*qI^00aW8UdHtW(;$hu*0Wo@=9iOYas%qF6wcZa5(Y{^nT2t`Nh$EHC5H7O(iIq)x;|f=d_h zzxs$ETQMU_Xv!!BP%wB#MBnVY(uem;36yNNFuluxvc0i(-t2hfx2h<&FcjUceCvty z^*yq-KOzajwctE%on4G7OSsO=xZ&|V;bt~GNeYp}#ixEdazq7CUd@OpMo*n4%Zktm|`V1?lN=qG>YAQu-KeN+^R3hTN zudUoh4YNl}N+EI8dqNEosA9i&`~^x@M4uh}6HGE&2irqN^rhM0Y3GjYc4c#AkiSBvb@O_ilikJJynkh+f<}Aozhk-!7f{daNL}bH( z4)n)$W|Qp#$jEQAj9L)|dDljC9-`S>^XZlkw+GoiRfnV~(TVPtC9^O>#YPhmMa?vL z`}>vUj+*v(mZ+@Pz9BxI1zF_}G0ZPsv0Ivv?5mF9I%GV*gC z##1yI7#g!aP0Tu5q~;Z@wQgV3!mF+G8L95+OsK=faWMdW73~Mro^h8Nyr>^*YCL!L zxN=(f4&LoYGeV8ro$Jgb8^dx2h(Ty_kd1nN8c znYMk63;lRHB(E&l)!>2SvFXg$f(8 z9QkD_!W>v#uFFcu4R4%|E+yr=ocd|sd$h6{z=i)Tnwddt35HlRg0{r3L;<4d#1QC5 zxZ!7}{1&c%s&Nr~O@S=nRew`z=JVX~YVQ4K{;g#eOwMOd6>c1zIgobqe5yapCt4!B z?FpASrXj3bcWnhBN7)V6#4DMgQY2tOaoA;I>jtkUAd(d5_RxAM*1Fz6=wlAsLjyJXWK;DKIcHK%%d~Qn}`BaiieC)(GXcv|n6b zQW^|vFq#lOc49e@frBm#DH}~=7#`+ieY4fDeI5Vc1HWsh_E~nORllZ&e?93#{89_H z+Y`jJ5TVp0)bA3<6^Z>Xiraxvualbx?Us4M&G+-FthR@+@lI<*4~UzAJ#8%UYbYz{ ztW8|pO*45aL!w!xgz!dGUS7d|NL?UG(wCt9fhkV9O&9ekKshA2Cq?o~wfhjv81*h{B5r`7w9T7$^_vzIe`)b;NESS zuM|g(qi+u5XWieLkcvEg0F8sTA__(r#ce$9hJNTdF(WMJoL-UODO_nipN4%I#=%%A z1dJIys<FG@SH?sfxRiA#UNeB(4k<1$kcQPA3tYL zvcmPF%W6t6eSiP~-esQ?DfseDtAS0T#~aK^|H6qT3;=zQvc80+4$m{R_e=?P8=cS{ zTE+z-`AKpZQaDq>kQo&f$FD@aN8Uj>s&&+ZyB3$hO^x5G z+VZ#nj|=!Kl-_GAse83|%&1Og#bZ}r%>4#;!+$K5!IP4-I=v|>9N+BwrW z!{Pu6sI(nG>1{;{)DB&^A=dPJEAZtmt2r)Y2dZ;;y!G~cc?&QQH$7HGpPhzk-Mu$N zmNShfIsy+U?+ia6PAnz2EE*Nm{&dos!Jt$yv|ZZj9HK&R@5KpLutVV*&66=SXoPY~ zWI`e^nv^MfGqV z*74iXP5@+l`JhUH$arwhom*s?)l1Ih{}NUu;?GzNCeCa~O}@#gKGWH%X%ciBFOE0( zGnh8*6sCvqF)`K5Fdk$jvCSCLx-w@fmL;+fJmz~+%?XAW%d3|il|)wi7?J7we5~~C zwYO#G`GIlXAWH0nzdxs=AB<#FK877kDmKc6?-yu55&nP>(cz-8{X-6@QN~U+TM|Ao zt`Vf|o7yWVjItK@+@61QI9Q41vl$4#0Ysex@YWoC$GRYV_--U%HaR{pSDcyYHc^lN zBie}sBa8VZ({2=~BK64~e$?gw>eZV?6OVyDiat(aINy#2J2xB#g9VSiXzSIIrvDQw zmf%3(A24O_NzvElW3JW1lTX%VTuuMxU}=&I7cV2*9miR|y_vPA6p8T{_3}n3h6^!Q zLj|@~hErJn*JgDFAMA>L+;Ti9`w_vsmd5hOQ%-u0PC=2iFz%8p;jg3LMPwFBWNvIj zHBKA4z}s0X4GVHJG)BVY&NT28Ik}zoFS~1wn7q@8q1I~k3HcV5C~LMz&+YU1w2Bpu z>hDW)GD(lq&JEne>QpwjAzl5l>SlA1NCc^IpI%Sp8z~%*O7D)g6`N@2!6%oV+j&gv zFOAcoerOuv0@B;QlRsTI`5skm!#A`yT$JP#+#QCmLlB|SKWn#9vs2LCT1<2hMwR+! z)btMJV|oUeZ(4>Re=)1)`{ym3-yy%bWxlt=gRA#P8=euZwg`n^+!Iy_%>|-=OTwx+S6W{WC~}V^8-yte{Qme_9E3d!<~=8y-fdD_ zCiAm}eD_RIQ-x?%zM~Wid{DV5UO?$L&PxbLp?n&=N8d>J_nf~rTtIG-qcUo9EvW^q zu~LE;Ac4gZK7robKXi{GqS*{k^(O`-dkGV3w;%cS0BoD_Lkr0_;9Ya7DY|S70se~f zGfTwRXDYQfpNCv8H5AN+=opF_#@-5HFKCCVmbt&k?7fG3ZIndpL_hw%f(Yr>7UAFh zkyc!G_4hfN#+JBEEhBQV+~h{uc=9XH{Na?;B6^o!poy4i_OT zeJpH`l9YEjl0JNSKm2>K-?-%Ydw+=%bgu^WhP`Zz93JjnQrv#i7UjEyYvG?ZCDs9l zHb(b`po$?Rd))FR{my%G%GnblJ@=-MV8}{tZCAiO3fnk!8)-g6Kc5*CKT#<1pw%I- zE?tFs*Z|ENZJlgF@8Rf)<(l+Z^X{{c>S&IVK-re*ihoghT-zWK&6}bQJ!AezarMcE zM!4Eudq=UQuG@kX_k3nK9|QXvvFn%VyEGbp1(xN;)D(FnM3N8YvqTu_&-1YRqn?>p zOCX1wKp=cS$e8FvNPk7Epy}tn)G58k(i2vz`yiA3bt@TQ1`W17KYWDoxVUhW8wxt` z%HH&3WD`HoOhG>qLHUQ!kkeuvi;H+$5s!0PmQuhJ*suo`O2!~{FOyFE{h^gmS~ImHneAoQ%CZvc@3e@#Vl9wan+@Vfibi5U5&yoLmGel*wD5t9`*X!R9~uks5EeS zYzFWXvJ%MFfMI?RiJk#cN01IkC!iV9&0+Pz0xY(*dQUEO&oE?Wur)--q6@{4smErs zfA$0C5|MQ61n#pTGfQ}eKgP8}PT28qt$Z|I@KAQ>JD-%bk}H;Q@#yCgG_c2e9WVD* z17&)H);(fN*)r%F7}pcXVuhq9F>WROtRfwL9k&^-xALKeBK%wGS*~H8d_s7Ou?hO6 zZF9)3IGNDmgLu|h5Sj}#XafRo|2UoM&v4K^$Z62@Y)HLjf=Pz>>XaEn5EtjrrL}ad z^y)2Vi!#9XHve9{<*~EAHka!XK-=qWS&ICjN^Vn^V8-&aKgX~l4|YMZbBrj^pm4cc z&_;Tt_je|d7ZWmt5u(rOJoe&e?vd?wRn&G`(WkQ4TxpV7W|?G65wuQ_F|x13(o5nL zd9tfBHFqkJi0Eo|$-0j$6B)sp@#lxMVqPqhoLHVR#=+wqus-l?#*l7sik7ArP!yZ? z&4Km1)Xgt8Q=Ub~weM8~H)fGIgYTiZin>T(iZGw1syF~hQS*Wewfq*~kDmRI#GORvr^oQG^c~+TI z)PXtamzzfhZ;oxgngi*-t^X0ehkhrF90r%U#F?k17%QH+)w$b-r3Sr$bz?Kr#2 zX30k;u>R)kuCGbP6km5R_dW!%qN^33H}C<(St@XBJp-LrUcc+dbKC{0o;g3rDl5`| ztJg}Ht1*4O*;b-#x_{?nGLIBWP@=-_nQwlwf=~e7Dh?Vjye*&eYcfd3v>GbQBRa+& z;+Aa0NiRziIh{Yu^Ck;1*9)Xt;CrPV@o9HW%kHyRE&Uq#sx@5H(KqQZc$PG^RZw;- zeTCUg-&I%qk$Dz^KBy`d%VoEs3&V6NDO@Bc3mH8X8zH z=b^yzQ2S;xxF0)xlo*_6WX-|W+PTiNYj88406O)cE&gm4`xZeN8Bw+ZVp8JUqEuxV zmgmjV5yHq%te3TUyd|&s1Ww+1;smI9<2(ttzC_ko8Axx zy+*3lc=Gy5;$xMeT{isoUBEN=mD1a-A2dSlO^@qfk$O+_{n?K#*ETl_ ziCLS&%L?l8s(77D&Xyj+W>Q&*bq?N^9^R;W|9L0==4`?)!C&h1&qL~5@G0wTw0NgV zMNm>7P>RI(oi8Y(UmGNgtfB-=O&Neu1%2zvRV1uhMy)#WD;BfTWu}55`ZJX(aouPQ z1dFp@FKc_O!_4e)v5k}FY^&VWCPuvXE@a@5$5|DrONP2$1BGF`sBElgPfcuXua&s` z$y*(~sm5^pH0`j^_Sol14ZUAakMtADPMG+XG^3#k35CXyDe7E#>D5}0ZXBN7JA0mK z=8vi%cbXsUf#{HSCX?f^nPK7()QO*IBE}{o0j`-ubD-|z~%hC%rUweiG`DdVL77X6;0a=qz$%aR?O1?^-AnHQ! zG4!->|3GSuuE}z9 z6(K$B4|;mmiJuF&09;=FZrfL^^VGV!-_St{=1nOf-&He*>-MYjg{~hHp#r8KlPgok z{`72iN}AzlM$c+cJi#s2$dj%l14lE@~vjcZd-+gakaNrj0|plU3TArkPI;(drsKw5*4t^6pl?41r(S*jqv2fx!YwHp>u=Jw=8FrPsF+KxJo`ag zR;82$djRR{&2vLhCheBZ1&*65)M;x1iE>979Z^38DQZFFJN`;XBTs3CIF){BbKg?= z1veSu4hKJ7b_}iyYA2N9^j!E?s4OM$hrHb= zf6z!u-2jt}bWV1k92)6a8&q;jC3119wBD6)gYTmJ_VKV3+MZA+)K4?Yl(V4p%(bR0 zS$d`QE0!Cxy^?Y37_Pvd!`>k2D}0OX!K-u3TcxTzbuv&l0fd#~9|v+)GwKyG(R!6) zLw3fQX{(CVrO8{VNlJYV?p%rG%hg*)9A)I%4sBXpoHFkTZLKzyI}cf78A$gb%#q{L zqwBEn@t2-uGIc|e5aL;Ju>na^6noBkSJZ>3t+yDektIzv=4^zW(eMho5u9SUE6XW} zI&+G4tL2U$wx;n2zcmR$fOBf_RgUFzHKerh*yk2mZc?eLBCz;HrY;OOA|>i$N1;p6 z$WnQ83g^^!(tS_EO%E;D)HSU=STfYdl zroy*;w1@0j!DYWk@3@{J{Vmk0vO?i-P4XqQ|)s;8O=^@R&7H3 z*p`uLxF&VY!lsycqS#S9%9YEKQa(XfMxN0+k4;68_0fnj+K=@Dwp`z_eRm&=@K*R_ zvPk95;weU-K|Oiutq&}=JzA&EF7^y&^rI*jP%lO}D& zQWDv6JW{qnCp)q^f!=GWlflg_h*9I%^(bcY+*akyM3*~$(Wg?7+Ji~voH()5!ntuv zd!ufHD7IxFxmmvXtL+b0IN#b7$cY~3LuXDK>q+iPq8c)`K^Z=vT39wb;4DX%eZvuTiCUmzO!=M z5#}P7-z_wyt7;lN@(Q{Pb|BB;%KTR=!iIh!>`eHSa>A zNl8%|-bu;lYYB^hfZwT=Y4x3y^?)%lXsWKWu@)DuQ^ZV5k)^|p& z*C5rhJ+j{&EhTD6V5vn%t`2(C#>E-6>8oneppqjrdUYE)W96#ni>gysi0ExA3Xs51 zB=p5_^ja$24NvRqnp#8q5?q2EOHn<{xv1DwhDuXanCgO`#JblxaAp3Yh=qFO}mod zhwDpS*Gxi>a9*Z)*peLCxFxWpta97!IH)v@Wq5T;Qg1G7Kt7hl5`IBeml~T=bR2mL z!bhK=rwQe|Xi-PVL8>X&RLa!ii93|8?qro5oO^RqsElL8Suw{rFTHk1qTe+w$+Gl& z+u|}*5~2`*LXSbxo^5U1r=QOnnroRj!b*DjvG?htNl8eyyxg|gS{t0pt8r)~g!lng z)!$O+D~_IBrpq0c?h0`VX=d7_C}8u$pVQl1uwGVHe1=s=SnaBM>0yiJhuWEnK9Ipjoq?FPs?5yxm_-I1}&D?h_Lax^U8oS=Dxq*zHl804Vz0w}JE48D;lyUB#!iM25?z z@4AXZ@Z(6AAyHXWmy%uD8*Lw=WapMTob)`Yb-zqNn1mPRN^lY|K`E!pWzySb(Np0- zl!e{36x2hKhSTXrfXUpReZ@}aKe6ubuU5haGNj`pBy{!U)J3TO04Lc+igV@){0d<3 z%EK@g6)I0`zDOa`Kqsa}SDLa6eKmTMXAGBJV5EhW5y?;Ln~ zkI7YE7}yQ*4tr@CP>#aI+UG<(j83R96THpC_7oKq`Fbwq_E;Xq*Hud1IQ=*=|m=+=}h5Jx9f$m6fX zX$(11C(3q2hm`E8PVaE2@>-lZ__^YwQ5;UxDWz{JMn{24vyZrbO19|TS$B&gjitfn z*QO!qy;*B^(;%UXn-4bg3C|*w`sy_kd3thDg(bNJ0D6kCE@eo(={0RjW3+j&dF1X! zD!q!H%I$Y&Xd7gFe<#aYPi&(|ueUsE=BU~?xH6{kgImy)goLR%J~iPr>>)(+C#7?2 zBF8QXEi7@e*}3P@yp)c`VJG9yUy#?+P5^f4<3^ipQ{Q#4?7u<44u3ev@4)+&^4CGU zxI9(0yRo$b;0Lr)f^qB|&3zv7VN?^xohp_fA+`3Ck7$>dgP0OC=&HOeTvE>#bYry= z?wOA_b0;2w=l+tuG4XB0NaC&i$kJ6M2~%5LS~i6a%pB}E$6EV2Foef&k;o+f0P`#3 z4;JO3;l*7`aY_`FE<ETLvT$C?a$1b#`Bh8jhJ(=ZJKLW!I*d0`zk#sC5r4)p*mE%TEWd)>tx= zD&r1JXws&sDJopG%Z{b?XPNYSZKMxpI%Bh;Iv0dcwLP}m4rSKqaVeDSwi5Sd*;}9h zm1JY;XzD+@@~NcTj)k;oTaKE%!PDpuTqCgUts0kdCFS_Y3hg^E?$qr;RvTBM!jz-9 zoy`!{3c$qZdS{9@Ej@4&TNfBC&PuJRceBIGj<-osC(%9Rl#G%>RF92oP@yf?cW3O2 zKc{_WFJZ@P$5y;kyXVaiK04T9S?+dA!=G+Led68NXMmBd*7M`}S%T6-5(%WDJhKfOOWF&Ix?{MUr ze6;H=F{1Qy&&y4==W@MET2*QHK?TO6jlmnrkW>Oj0N$Q`+0AcOw$d8!M`}$byG5r< zwA@8Wie0)T5!WF~Sw`Hp+ERBVBLH(4?yn;(^%K;4@r$JE{ST?rVDzj$k1tQ2NW7Cx zzB#`flml~P6(ugPwPi$Z-g)yN{{R$xwK(B^i;Kil$ntt zI{b`pQ|?G*J2&$w_+Pd!Ff^U93V<70=kQ4P8EG~_Cy7Cl16 z+e+Ud-8J=^!FIXai>Q)`s$gXZjlI-%%WcAymY0H|oUD#SC=Zj&wGSNB)jLP+I$WNa zEp`cDlp0vt) z@Jo@KDoDl_k&dU=T?2c+SghJE<70b?QT1ic;!@qYD18s9rwI65oN%WElg|U?Ip@hu zsWW7yu!IuxgydyI(l{MFFllyt9@BKI)>{4UhZV|1X zXw-GhklO*)+ZakztP|J5y2ekFu9mpjL~Splm~dO1ixG1aq;GjoyRp)wl?(*(8TF^U z;PM`f3-{-z)D|})=)!`QG6CE@91eW_RoxorP};QpzD=q{y3*a*cLpVe$PPEKb}tmI zE+=vF)kfo{a*DQod5SQ}s)RC1qS{UV3VTp#4JoIzezdS#;alCf z+SyQ(B`gi8Qnz+t1mxtUIUlzNr#g)3%SM>e8a`hTZdMj%-DCTZ^?yUW<9Q`HB1Jg#c93E_P?_w_PO6OUuw&lW%_B5`-Zx`dD7$$btapo`)E!$_2_=UJGlsgDTTYdFr46c9CWDn5{8#Le^Nx!%w$_GabYdzBcU!KW@KZtBcU6VG2iKUa-C@y z?yJf3OI#pY{O)2QV0p@lTV+acg((gO+*4qIk3=Yp4qVPFd(Nt{+4N)9tM;9M$C*CN zNLGV+34UlymQ;ly-pQ#7!q>Q+idUd>j(czGpHuEZL2#Pr^*=_hPL7{5&or_)$y4#i zhBIl|uyp4RF1P;xaxL>5V(Qy%nGA;zum|?Wq{EMYP>) zdmY~u0Re6EZ~^TZ9P{vLZk~3OzI6?W3tbgGCS)M9%(oY2R2yLbB^Q4HAO zp^POcdp_H~uXjJ|@Ko_`vlv)+&K@oTlg)gOI_MuJ_1hfO({&ZbBM-l6w?=vjCAJpZ zPP-v(7mw`%ioPo64qg2{b<*BR0heWJSn^}3VMYmE-mW>QCIl#mLWM&&b%^C~19 zd?8;w>oCb3Pq_~M57B={<_rE-P1deJzVMs$15Z)JFZZRTWVq?=pt8Q+VGU9yz@YSIShvLQ&z4TX8UK-ZB5ly zi+s&A;`?^)a}gOUY@sPu!bsktP?L`Wd+;j0<0h@PYfWG0c4?ixx(r6)MwC#brQnsg zwG?Cx*jvRpJ;^?*^R%lZv#Ck7+3J3z$)cC0&JmP${hLy&TylA^T<#Lvjb#gQZKmNI z6z6eJ+?W}7cU3}`^9S^v*4?0Jto=4yidGpUMe#2jNq>J|3U7wER$GT3J z{{X_RnyB`xfO7O&OMZUUy@1)=i7z;?gp~8=wJTb(IeG`4aZp=>O`a&a(~Xs|ZxEX; z>?H|6ixEpkKhIbFrltCZbYrS*%aLJ(+YuzCh;O-db%ipA9BX@lfgCnDjGVcSxgb<3 zZmF?c_@2!BW0tW79LSDLx-)bVQzc~))Pj?MmeA8l4XA^;N=8;nfdk_8Q`JjVE$P)Y z_&;9Je$|iCutyZ*xlK3o`5rZG%UW74Qrxug!ohKY8*-B+z|i`TPU2Jwf$vv$cP#R% z4#hfQeNQ#FWQDEYse%B?j#8gcsfQA^?ea#TxJ9sQTa(u3-diY4E1Qdoq$P$<5~QnY zxvgM;a0tahYzV}H*loN5NalBuIsyFxw=5TX}HoY4g|29!XX!1P7<<|IlrHHDjd9V%QdRo?xR{JJi9iZgLay!Z--cx zl;E}t%L62*9-13R{*Y1~O?a|ew3HhgmYYO-fs$B(X&0qswIvP&NGb?Ri%L#OPR*p_ z(#arVEymLRj)P`AM?PMjjiM-3K=Ki?dCJo)i12IA-P!$ zyL@SEGZyP?hJ`x9np2GV^i(Z8#!6L}60Z^tGLi|r_&suhwLrE#F{Q3^Dp5j0lahHP zfJVh~?qzImL zz1}>kxZ@4mR-!C>ZRbf@;6;$?9d6>n5{DhyoR+z*M;JNh{_3AOF4*3jk!6vuAnA#c zXLjh6sfmvHY!nl)spJv~O2Ie;6OQcFamBb+HAIbdw{cm!ux)KO9@s9%V%v15>W+eB ztl;D9M_gCT!OB|OpU>p`jeEy0L&qFSnuj#w{{T+NVk8GNi_N^@2t?4L5_`LVHP`-1 zR`yiJg+#=mU9E!SA~He;=-s2rN=ZElT9uDr?yf{(36Z5=bTmN|0th_vamePncY(>c zN7B4Ae!}g-Oy}*drLM)5C&3md;m3OHBd4`(OqDX0pIP{0J4r%MFfst~ zuFlf)FV?+3d$nHe4yxw+YJ0L;5|wTw^GL=5Nh;4gcUK(o?o256i)D#d7;RkLxTZoO z6bS26es3ewOF1jp4=vcoPGdF6>o~JHLnb%EX!@_xy4^Cl0()^}gF@)j|#BR~HmwLzo(rl$Pc=GSg}YVOL@|ZO4h`YOuH5 zuNRG59(Bg$Dr}+)W=y#YeZmu*BkF}-hV?7%*Mp_g=6b2-msj~di}fd~Xyxg6v{)ZI zV|`WE{K;np$TxjJdqg9$vO2Vad5kJ`( zk7qv$;;sul5U$`88<0z`B0H-1K#~&KQifDqE;>m_qafe-abtE>rq`<> zOpK_>MCq)|Zb>p;PTtkmQdE^GMGgakpp>N?#zyaz);UiuMTXK|K2O=bCF!tf^zhZ~ zl;vL)8eD(-BN~;)^*;{px0|#$#_4EwIYaF>8$FYS1qeOo32+aKzN+m>y||HgsYPN6 zNXK>oHDv31)|9g7+qR#xY72eR<9b|Fc5oynNJC8q!CQqTK?CYwV<6FGP zam#551D~bL51fv5ucdEWw=?FyTjav>;*2TFZ`{|-mv)D>+b(YD7?W?p(8iZHn(9* z3rffe4hNj>RtZl&pb_h<(}#ChMr#kbE;4&HWTOBhJ;g`;_4L|!+O&Rkm$Oc)x>{S- zUi9Kw-f8xLenQJ?Qc6@)vnwDca)OBo>H%^JbdeJdAsh2x_wlk8D>+e4L8fYYxfJ)Y&IdjHH&UtuM1;X3Kve#sd zGUIfC36`w3b(iGHN)iHs@D-J$5J@9xI5<8P^7`y~u*)ixn^bAS9*w?s3b_NZJmZCO!DK_@)(ocDptr!iHofr?SYAq`o5#^Fqj z^;GgDu%z|wJgUIc4QRd^H7f4c5g=*@+lSaji4dV`PTon%7;(}vr2)9$a^`vD*Ze(s zQuX|KPPp?+c0B0|?66Q2cPOPw&nyy0eRKL&{{VVTzqg9BAJ(&sv{;n(`>DIzU4Nl_ z@bgmMnA4XXD{q%8%LAicSCusAhw(%bRD1A)QO5Qn`o=W;2tXTdO?%4S@gxKtElMT>G;w zfpmh+is32gaHB(pk4@!`jkelW2_?k=wIGAYoOI+eH+#OKo=r3MogXFoPgjFU>T&vr zrw7M9FP1g1<5xXB8tHf3@PqD(-f>wVhNnnCN=`Z@v?L6ki5!XLRh93F_DOd~ty<4T zLvkCt+;OMA17av)@56<}Dd_UCkDHdYZP6z8sramMiI*s1aWS_(20k}-lZ z4ss4E1*&XZC~Exm_f=~stA>UdVK&AVl*vzKl!TQb8E_MX{b>0s#LK=jUh{8+eu1LM zzL~F0c-P%6+pDh~l)j)=>$K@H*jq?khgKO{vZMsB&;;^H_^YS5R&&&oCOPdwu3(|vSaUz*OmM5WCy+ZbWimf42W z9h+OueyNW2Wal*0?-+Q1`~}(MU16;onoxUTD?n@mgr4ww$?wfEnSjSBPUWdXAO~=q z_wvD}&c#m-(X^{0ISDy9?>xZvV!b$H;PU3<@nnYi#w*^iTJ&W3&bnA8=P3=f*`Wz> z18Zf#Ig$=ik;s)Snr?%2ze?eTn!h}-sdFswrVt$=$+8SEr98EqV3!ng-Rq30osL7#wV+!4CkMyxqnx|E0 z+Y0ZeQbxQ>kk|>d#f&poVjzZL+rxxPC1wI+%4r;CP;c@qMPL@-yMiLWlaVlxG zm7%on9I|?=*HZNBE*L|A%UW*a?EC7H+EeB_vPIrQ>j}Z^BX*1I%9aARWm^V2vrz9W zSQogK?j6b0ETI=+XDYe&ZJ{lh7)f{|o=QT>vFgQi{+)Sak0O^(ql5ndh!N7{jtrQZ z-OZ(6_B8Od(wha-U@A$tfzPS>n92C);<4YPiD^nm5>kMZ+%}O(_(B!#6~%<^C8>?{ z^|l2s;+ZSaFDZD)lGx|V8RcI7Kj6>Hr~J-gD;=r+^bbECwQJ}m)Z#Q#Bqwvu!cZz# zEGB9)53~bSF>OKD5JnOWT2=%lHVrc37Ec^RPcHx$oDPnBcI z2}(ATFHLK#ua{eBpJbmcSVTtet18UDDc0 zY8ePAi1qIBUZ4+pSs;!WJ;RPx(H#oWdkVQ5Yz5&$vlcc7#%C;9CbLb zyb-r2FZMrL$1h6MdX^o2cL-yI6Kbtr^h7(3@+S=ieuFdxAxePzZmG=dJ*f&n}V&IX_hRBryrB#KUl*@EqBytq@@|F z=rEr@p3q8Hx)Qz@RG#b}>a{d2+Wl|T5w2QU*>ZI(oI!>XjqXTN+bL})Af$vS z?)0z*+~i{-tl{x7uaf{meK<=g3OiD9;t#H_&JM`6!qrjPx?CHE-NppFRB7YUL@6>F zP-()it=vkQ2d-Qg=0$hl;o3eYQ?^j#yoJw*8e>Pqc75Uwr_@(c>}z$Z-4VYuRHR6d zz1!Of-hkT+kfY2i9*#~a%FQEEv!QM8+aE>t=;Gr>GA-R>jVZCY081VG`tEWLM~9%}^_hn-s6Sb4V9knj)`*+;_M_5w(8JKUz~O(wfk zh?6z-w?-NFS0#oVySD;JU@gAcpi=v51z{&DO1AoZiNO{18fjx+V(BlF^POg!E5fFs zwaQ7gT_yNlD55;1bq>BZL|C;y59}6rZ{2%H_lRu-J1n%7ZW!$pKs&)8jP$N>mZc9^Ue*ZCI}-ZizqPbHML zu-ukZryWv~o?~y_?(6HT*6FDRoxWN$d_7G)w%Lr+QSH&xR;f-F!k01riclp-8;?$z zu76ZmFW%UTcbeoVZW!hH31B>?T2cn>o{1$}asbCtD&^AJrq!!12G*S!1s3fy5l>pK zlVzWDSdQ0Kyzl`o1!r+e$O!4myq#`2lO5>`3rH=6BoJ1m0-TeM zS;r{n6m`Cov*~Np2pYCU=HqgX<+Zzdr7 z4@WI7X&Xpr1#Mwonn1w?N+YL+?0i)R<0C<}TZmGDQWcyE`doJ7Z2VU*IiAj}s~QP$ zg(bodB0=fT9IDaKxAt_jy*+!mTH@Vdm~J;B6oKfh9q9lc9IHR(imMB2QgDT21#>Fy z0A{DK+Qo{*Wi*b*|T*n36__>BEcGJqFEZ7HRWuEx83w20!ajor*}T$ zdDV$6Y4bfcyUJps<#L*s>q=0TyGAyxYhJ;Ru}J01D#u!c@a?@ehmF%w-R*Gv*DgeA zeAd`Y&i8Y0k3@3GNK(87J+pYVuTaImY8`#2F4LWSM~@oSb3^@uK_z9jnmO7%5~AXY zK_MeKIIkO2=RHMZw9)#Hq01HzN>bL;l%LxkK6_-FQ#pHFiICviEjK7}K=W%G#k9$k z3wZN^k-O1Z*at2_c_Wo_4aM&`ogzqxn2B4fQe(CVO8}_hun#a3@J4(quP)cU8KNt|c-HA|s3znrw~kBYKL`0r){GAOa0?ZlSofdDJ&M%yzprr_6d% z8s(Iw#g!x+XPyY}H9nlPMqk=KOut-DNbtf~8dTjSPl{gy#*{+j+3qS!fD|nl$mVKs zq;JjX_NGpL$i>cBXR?H++`}w7LdjBw2vHbl;P(}JsuQCdefwS6#4u9ZU7CuB@6A|T zHif6;-VBXbe73`l3+m0HWW-19)=wmbuc9%5=z@7yr>T;T2IPEKp+ZvE!D4AXt@Mf9 z$uGB|ZTFo*%rsq{xHQ~g+el}%Lyk5vu^?m6QCA>x60dDLTQ3(VcDs(GzTZ%&5K^_6 z%|K-VY3^(g3FtuOp0yFb+?lxD(|x;ZttmCemLuD(w)@9wSSxTL0Vx2f!lJMg?;`izew z@=1V87kMa9I}7V81C~8J^6=%#u1yhrm#H-qHmg>bx5Kcp9Vl^*%?`M%f_Ihe$jMN^ z9ZB|8Qz?y?S#7vd+Jo!dr5pj1$mXqi4%zK`Z5ne(@f$`%5^`=+oxe7R)}k<^HH?6h z({bybg1paDX~9M-pZXtb`Z7CbJlUF1k2S@=z`IIzavQ&=O~qmRq84VM#=Ot0pn2CAKjk4iEK*+)0o!BYrbAil?vF`#@jSmjP5k* z%&80pROooN22!3`*rlr-eF5t=2H})lF+T3(ol||bLx~Y7aScqG+X<4dumMU*BRI(K z85tSKebuuVxZF{HzU$2+DY)(iAlvPCQ6R=ciU`6H$xBhlDq6Bg9YRt;@pW6WXG#t5 zew*l0j+@eDlRZm!3Os+SWr2H%sT-SPvFV96IE4*|C3(ncassfBr8d&RBL_VBRSD+L z#lKym%8=vlGWHyC#DJw7o}>Ugc~!E8cz0#Gz`nDo?RMnEby6QmlG&x zbZlFR%1282S>)vP={$GREYEt@@ZURoj3gz+V&5ko+WC`ieNeUihEq!aLo(n^yR@YY!ML*W*7{a=blbKu7kUoj) z{{W<~i=0bJ*ToG=^R35@p)4n}YbC#co|&(-a}FcANcz+N0L-t897mYkt|MxPm@c6X zO$7*Zs2fvXMXg`kM9&BCf02nt3K<>rt)`Nuia|J8z{iQ{S{Nu+L!A-N9yqOsdX$+7 zI7UF*Nf#!(Cqsu=wAuhEZZn&Tx^iralId8iKf?C|jUi3Ba(o`qJAgSj7(IUFM>tGW z#JS%N2sUW*PK_l0{zP%h@-JCgjWE$hOoykZ*BPsX+K}p6r z@kw~eW70V5 z1ol&ad7nn1sT&jq{k-v$%wn>2!ipvR^WA^*FRv%)iI<{vYiuy<>T&iOZG`Rx#dc(b zjl9X`o}JmFU1_`CmAE}vDAid!Tp)hLWC_L))7f5OS|@2!?{Mw`|}E~&8HnWY5-%qTie>|_jskCfKQ z!zDnFIbe)pwprL|dRK@UaR^YdH?R|ezp9*p>*-!@NXE9KtKD*`IXf$|3R?kDi+}(! z3b3AC*--<#pdTM~)#RJltBF%b)b^&-@miJ3vl&l3j(oqTbyCf=OO65B02H45WbNjE zr-fb~N%0z;t+fGl$8jFQ^Qiy~6S+K&Jz1@^DJIP3xVPIZ&3VI3Ng@=h)61~TxHA}C zU9;~=n&cmXsQ@b|!9Yk@1QLw$@2WQD6s0B71{4#5v?Q+uAo@UMC$2Ns9FBgv_0}?N z7VRrBohPd8vFQq9M21hg8Gx2Be)J5%zdB*?)F0UYC#Q0{V zt6upr!%ID)6j$jUT!lnbcf9#2!7i&j^WRuDqN~BCNy>7z$9)sC-`1RMM+r^Qg%h5M z&PfNyCxl5?DLBe;xII%-ys;YyMetgq@oVMiSE zoc+%qUS=2P;z_vNCquTkZi^~(nM^`&;KxIbDPghf-HL}?P?d*Ll>{wm+I?KB&y-fyV3 zh$CE@mIbCDaV;wWrxKMCg?hnWDTY3F1CDr3eoBlgF`7ux&Qo_MXM6C#&v$})O4!Lu ztiKUq&Bq9ijpuWV&M*KO9y#Tjsra#IfnwEH3pJYL{OF9f+lY0|!A>cB$tm1QfW}8O z^ccnlEFKo>i?xe{I%WF=vm{H1{3pE-;#+Yp6R|+_9R*iBP1QGzW2hXuT_Pef!WoQ~ z+iPburv&>e)XMj-lZ`n;BbVT-CauO_?HgG@B&j47B!lCSP(FHNy%n7>`d0J6dB_TB zPOPK>-RYHNdul;&1tlP%AP%KT$@zNI1@7T#PLi1!_Yk|2lb9`}k_kpVFJ*bNhBeOK zP2rYmJ0&MXP!binJk*~{rbjOt=>GsFq|5AeE3sj+`DV`n!nYN*DG8LU@)gbNS=dVm zJAn8;KC0-CCYkJc_43Zm(YEJIvM}^mYEW;_gHjahh)F&BQa~N#;<~g_+V>HbR~`<8 zP<5h|wn#gKiL1 zIr&9!$}n8lCuDLu*(o-@3Fivb+AmQZj`3ka=?N%ve$q0aIUgGB`#+gl;#_WXw`4C;W}Z)FR9!SZl4xH&<0A9l>&PDvt5O!^`*L8**7~L zrm@{E7YBXNZ7)2OJi?TmpcJp*sC4CCo}VI6t2uH($^EQ=>v=A*cbyVW*zZJ;<8C4< z$`X}+#DkQQ4tWv=Gt>-LS4R+D2ew;^1e}6F1pRPNhpL~3{H4D-?E&Sy zO4hLYRHCv@?bz$xRekR11*csCdjo00N)^xBT)8Q`NYfv=9-E>ks@*O(XZot#b-3@P zSQsA+XKoHLocDag6qif(rtYLPl@r;OU=!iq2j8uli%~?oCe>+**bQ1*kjQa8TQL79R>VMtch1#{-1fn5Ip#i=88x!aSn@8IpyWrIV+y<6VdDmCI_*-BbUlJl5s zB^`N#lb)4tUbVf(DYWUGL3M{BMVm6NEhZuoq`dkGN)S`aVn%rn8t48JYdtd`Pb*8^ zZ~o?7;$0n=8Ob9IY;idBPjMRtd~zz{isV@g4MXqB!z9U3E;zX<4zH3y-JfSKX|GB- z6ywRu9B%CptLaLdd$U^0Y6B|;UYO{41p%LJL>`pt9k{JZLK3S?#H)VY$pt)!J3#~- zUvWNB29V(q7+cCDrIaNFO7wv!18GnMl-J-aoWz|<^mntJM(96kTUsMQF zTTjVY>1qw|X_`~Z_g^Pz={J}*OHH^3({O&*BhBB59C?r%vP0_X6fw&Otyg?c)QY=Z z8MsN_^Q&jGkd-A#LXO-30u+*xxMzJrH~k zkBu?v4Pm8Lq`vO8x5`?wv;?f3p!Z|dUHjCzXDoNZ+I{>HTkw18?zHoPO5eP;LPXj)@JJ|>km6a6?g(s02TE~uRO{n$ml~SBcS^cYv2uf1cakOVY zE@}mT)N9oD#oWBrF@htv6||$hC>R9S7Fa<_;*Ft`Eo_{=(eB$FV~6q-t*196`e8$# zqJ5umS55gTT?L-eqfrrul;z6Ja)4CSp2^}1&X8MK=&-e5Czl`qJu8=EDc1BXrj(MV z+qorKC#l6gaQBRMy)|Turu99g=?vQ>t;>9PcR6*FLX`q1uCvI!by_@*!R2 ztvFJa;t+s5Iag!Or60KG$BpCu4XX>SzFeIdtQ>;c%zJH_nGPVfOJTJ>g=67iDJcpV z+vCcs?JP<)L?tMdDE7Dqz|xDi6s}hrb;`wR4?~A}VW@Wvs|33pvy`CtXC{+rRJd<3 zUs}fGsQi_~ImQ0~6m=yjed(45(3*Q`lEcw+&vy=o@?h#pI6=VRq$S{6H9KbD`ock zpN^$v#@G83-QkL{;dw>CX^oEPH6lnDY1U+VN$|n&2cN}O$C(`Ya5v=d{Y$APv!Nlj z-Tqo%c}_U$-Ak%*2}t-YsXKPII)jsfIdiT);>5W(C!dohM3ubK&ca+!AgG0W5_u3x z@JEU3UgY^{S`}&#SmE`{;5gdQ^xf$wRxp5jfIRA=)jV#Mc5s_@g}B2z!FA%b6&{&B ztn{vonQ=AzRh5i#rk>}=*@AYqUJ? z4)x2XW_G69mkOO%rd2TE1D~gYwGc2ijDdhKA~!!MZBH&cY{k=-XhnqW+=j}xf}!){ zH3`0JJxQxl)H|HS`J)a6_6&`vaHT|{N*&~HII85!44tD`Dd1^tbctn+uHCD`*5<{c zBZ~_FBX^_*LPtZ_m^}xskZ|Q_dtTcbKy4*)-azdR)DJ_LIPWLFt!&e3XhWQ}tDl*v zvODlU{{W*Kd9<;@(4DMcFNo=jHZ zC(mQ1tVd;blvF{^N$(jc2fIA^*Fx~RTnm>Ew5sj0RV>?>R9UU1N3>;Iim(!K=;34I zCb{cZBW=z@XK^c1Pd=E~lS~mWHw#;?xon*-7<-z-E))an_SP|)PSPPk%b7bni7mLI z*kuyiLOEq=0Me*z$TJXFan&z4DGldvt}2VJb+7>pYTLRJJYnkd65)VA52Dgr_#OIa-+1^@to1u~+LT*EhmomO#AbLcOXCQ4>NgH|`^{W?5PmvAT zk)>`#RPAxa_DXLgVC+fVgUs^6d^z`5%v5m`h|TWoHTCTZSHdWiMtJ~!TnZJ$?j$Xe z%Jtr%Daj=!YQ|N|n86t7T~O9yN~v-~$B`;h{{Y{?^|Ir5a!s(xX{ls3+JYO9rD0Bv zT+z4$e%ve{5nLhVuYR@9ziGWN&E5>@wpg;2Eis={raISx8(PW1Q0RNX9Kf!Bo5W5a z+*|B!TH{cT^Rr(SP6 zUU?&?1BwIUt$}ZLd)Bwg!N47=ut&>Q$Ce4&MQ4smHEplzb;lnyZj`fd=I^G()(iKW z@QBM%VLTiSpaL9u#UlgYo?wB}xwBOk-F`Xk(x4-x0uO-hsMA3uw>K4~XOU8leO!-R zda3^A!;G^L#RQSC1eFe>#;=nvyt*$4$}!vE^QCSPZ8wF@mR(b8VN8NPw>|vo&eKvN zN^LF4R7or?0jCiD;McvD{ZVRJ&yO=* zIQ5do`#GMA9J@r5Nu2wJJpFCc3rAmYGxJ zsfh_~2qj858S%*V z50acLC|SC+r8T**52T^XJi2&Qn`mUGEXZgl%P3x~>Enik5ep(-q?BqaJH(m(I{ zDkH|ST4K-=pj6>>XW5U#Qr;SEIvUiKq$njzNyl~;e+@@?&jZfl+EUwl15Q1Yp6*BQ zR;libW*e?WK4X%#DQ75FEifEk!9y2ns64 z$;z9HX(Q8LGm7Ciljh0v4k1~g0GCY0NdTVBX#oD%9G{R>h7TKTFu-w8uP-S%2`DKC zzq}r4CmH4K>T^%I5h230Wkd{P9o22e!#rlj~ZN4m(ht-#E;k|ZT5b-a?3gWLz- zr(1rqYB@+;H}aFbl&@yud%11+b$64#lN&(d1_DsjEMMHQY$CfwxR{!LBD zT&BXxK~mI7C%m5e$$4?y4x!~Vv=2dPI3ZtUOQhQ5Mg>V_TSr0#AaRLBBXm_QA99kD zYS{^K!05)Qd`VKD-15lumZkMH_Zx{u64F-@*HnUiajBHtQG1#V$vl=J2jj(Iuw`SKN6TW!wUFR&y#k+x$82dC(Xt5;fu z#o}DRo?&bwIsKLu_v>s?j9t-OlAcQ3+e2WAR6?CmKC0hZ1SxNww*-iU1=#QUyshenZeQE6gX3?^S{75#6K@UnU1 zyW_8ym(-<;t)=9vAD){z+mXnQ<6l*Lm=z7qBWR~XQG0bV`ht+yO0nh=GmKYdP*Qx7iMry?Ga2K zB}-{bBbrDBAzse^0GAc*pFP5m>}NKdV0GkuwHIrGC2(}fHj(00&q6yf5#g~SHNmhS zVb8Jy0ZBeQ&&p|ht|>>Hgr$ob*c(PdUFEoUpTkkMY>&%|r)089lgR|A6ORsb-|jTh zw76Jwji=GvI#!P?;*u*UDG$>%r=0D?LVyNxPI76cP2xnZ(0WL1#9*Z=ATQD!kE^XF zHks?#TV-J>>YobQyG+smZr>ryf->3)m66l{IsAC;tlMvrn|U_xLyJlpbPQ*bkGJRN zPC8dvY7GUbTEFSp%8xO&$`351X+2V*-=7L-F>Z|kmYr8+=>&v&V>rku>PYL)sPWFLX-LkyNPEtu2NFd<)N73uzYd03+;x?t1wGKYk72uF5zD@q- z_)?bW-Op-=&s)9isczvnXl@LUoE~T9r9Sg+nGFX}z2qUZpeUCK?oJYU(lGZOBPgW4 z;hrR*RFo(M1^PR&f(ZM+?x#Stj4K50P#s2T;ocYOsA)%^KwMQMoaBw?pV;$0yyK;7 zg{GdgNiN)!@z|ZgwE9I{mywQGAg2U)kyn$T9Tw4yHlL9-+3UQRU zcB>$B!5HrKSE>9>)^{_yW}tn-6SH?9dH2zKwL@I9C8apfBoYg1`0EwwztTy%vfcXGkU$5OCLYSSUkFno~6+e%cT zvxR}5WhvB8&Wg>JLLOT$F$68Q5Uea^#hjq>BO8J1;ZN$}mF56Tu1kWp2>=$=xDnsX zCz1B_uXn35W<*3}wi{ajA*GiFN;7~mc@y7(>c&l3J*m?)r8UsOBVB8$Z+5HIw^fmV zk|eBQIKav0NMv8N6o(32yUCDNIhCla{I#_<>vVPYFFz>s-cZOmB`2PDW8&`XPS&kC zY`c`A44Eask~TPy2|mD0VeU^O;LF-kcGVGgmoI4Tq$z98!MNumuS!<|=Le-Fw>GDi zR1OFoI*(!as>afM85l&Z3WiR#MYrYi0S=)jB%$4)B=k7w z0q)7HWcKvU;dAOFQ4Y8drndq|aVHtAjw$stcOaCUVMC=!Vtd_^u+)oVtdgUJ7Y8g3 zpn_^oWziOk<^JENtch)ja4!0Xe9!DL?a7UbJE+adDSm%PE0r@)DlG=M@mdGhc^!AT~^Hl9{ zG_zK}brWPuiby0hR8miY<|@t59#7D9U4gwxc#9~;j>B^#sw0?0R-8CMR&YwQ+yNZ= z*G4=upKQs^V^&cNxUj%wv*^mo5>8a5bkBE6ch{`F?u#KwOK3!Pk`yz{h;hf{da{iq9*CTHGH;i3eqrqPoi{wlE@^+90 zPJNj)seoBfNK%u`VM{#EvaDSnY-3t#d2oz&BU5+eQi%kIa56?mb`LBJ9~!N$T7DyH zS|YEqUof4i3dznp`c%&kx6?FIl&LtrN_{N6(vX#*)!>qFg?HB8&Bst2VGDByYJyNo zLi>}`B>Yt*dr|5e9ok*J`AohbI<^*`%?D^t!sZF+2YSIa!u^4vgr8ykU zBQ}YvP$CSMIpcC#C!fV#C98D4p0+90Emr26X*mlFJGgKA93}yzW}u zvq|gq$=jb-Gs>lwO>ucmo>Cok-#CiVb(a({RE3ZM!5vQIkUO$PEa6N=YI~i^>wJ|u zTH*+$ly;d%XzK8#l;C6v#U$0ENA|u*TNZ1h?eA&}i9ue~IIIMx)z+n2g3&7DYqd1P zjkzW)a^A$OD4u!fJOIsgwY!G8awXdJYPIT7KIf-mdDPhN+IF_KzyzfWBbu;zc;cJy zEn37b)*YJOmlVeJ6tdDtNdwYPLQ+XebK-G|>cfUI?8#0|)KSKRNZtD|vlnkat~mR? zx=`MXzpguPDlt$XoHnHNtFrq7G|3FLCKF0+!j!E68x#Rn4hK`qJpudmNizJa9;=-d znMZ6nuEtUnvOo!Nrv!I&@5d}wd0?R`Ox7`+`D=rF{6EypkL)i;Xi&<5Cq2Lq>B^G1 zq;AZ-8$)e4w$w~Ces#4Vo=3JSB=}%p(%5W2bdr98{ed|PoVaC%lB{LMR00pIW5dR~0?jQ=$qGb*!c?p(LdsH*vOc$WBhQzrne}T^V_{O_ zt<*k4cyTEqz*U{YJcz(oFi7XuJcnx1!)>-_zG-f*4pxoB>5euR9`6;vp}2EA{%T7* zOEqrZsaJ?-DM>jQCj+l{T7B$IpH)h?#@N$dc_9U}$N|p)cb{M#-l~d7E;^((uy?4E zvRf(Zx0Vk&^Rq=pRE??9m3BEo(Q{_D7aDU)L&WV;kbNRKa;LbQ7u9pX+T%_2!CxWB zKy9$ z@y1PVGg*10tft)Ze$|XNiEiC3=}7=%wi)>drkNTFHI8B+-!8q2g*%#2Pt@M$(JJq* z!?x&@`-$g{7JF2v{X{4d2aXRc{B=lqNL$v%l(WojKASf+G}EhSrz1HDCl~AqL#?;0q|A-; z9g*588rKrl%2s&I1`baa>i+rT9&8QN|Z3ZgyyV$DuCUN%oq!h z;bb7EU>R9>qz{i3<>hhrUgNWE(26e!ku@N+ve7?e?tb+=Mc@>NiBXiDz21>I__5}0&c zk=i7nDM}s1Jn{(7PI#?x#}t*fMpAiNq@A4KsQ76UMYfq&wo8$_RJGc)vQm{Eo4c`1 zmsD9ELoB${jx9*s*=&HMfN(iyrChvgV{ZTw8c3LAdq`UBcBLexsPmRn%#h-KPPMFCZS8`WZSwbh zZe1C!gE}Kkp&>}Jq!31MzP`LxHIOk&tb^pdWIqcd+2)xFlO3=DDyZ(6i?uV9I1v__E{B3kWMw$w&F zFAkMZD3Fb~9FU+sO#SN5BzACV2e}exHYOfzwakjb7UDyLXy^?{?fN#r>Pe7}%{@7D z&TCr;CAceXU17Am zs~e0znOSabqO645_-UpdLYs0bi8v|+T?d6S>m4O$(kqQFDhgvrbFxW1#(5gIm8K=> zlM*hYogJIR$DMf=)?5n+gjI&!3+SM+oM4fJ)IW}qnfI3%hl&!_*|0DP^hY7x-?;Sf z_Gh{f$L;P$6gymkb-BwnJw%M+C-7?0g zklPlL6DCPoHzi@BwFF}wR5vHCF}tTAu1&3)P1>=_^~1xYF9Oe~7=`C*h}@!voel({ zW6{YS{KqO=Ytx!}<*T=V(Mov?bIm1}a(?%ExL@TY2WQM%ipM0O1e_rOAmJm?2?rQR z9XbaqdP-J+lYxwpjC|F+BVC!wO+;qamWUP>&^i^Tuj(q+zOJiW$H{npnbuxq=U?)m?aT#rBHIZjybR(RaE^OY4f$!7ZU> z1a;|1E$zs-Pmc_(MKTnY)H93|(zAA9ac>ivaQbMJ=)msuu|=hQh29h4DLW)K2QoK* zzPa@gr?qr-W9YYZZw_qNn=Ch9yGupV^y=HTHyMR3k=TrY^6`w3G%`Xj_A$95`4(;IS#$bHm= zA;hH(seFjXROcOPGtan;`o>4eQ>{0tuX<(UGfqvB3CWRC7lb8XVT*44`?aRn#m=krti93707#t7$*y(t8ZLwvuy-2FjtdUS-KG?lG{pd~r!==G({ zkjUJjwcoABF`o?9(W0-5{0y8&g3J|I=ErBUE0UC}*M$m_YtRo7Quk8yM%UBD2>cYm z#H7jhzh|1IjI}qrpLoql_2xbM+FU9Hw=HZd+I9i=t5lI2zD9r)4~Qhz=;=z5q@JfZ ztwm)AB;zVqQQewSz)D*yPcnWw=k3vF(HGT8DKNRHVdR{ro;iy8OXPWZeoqtle;LWe zVQfkPvepR#-6Zv|o4UCx^ERGN)Rx^zIj^QZMwcja^@k3Wq{a`HB!u>3(m1!s&&+;$ z^0m=REKQ;OOS)miXHV=;cl_miPu7pOBVB4okjhiO=J~^I_F*HYHg|lr_Qqc*?*7#O z0P`#2hOjDDzSS=FMI+s58A`e~T*ix*~NJ#tei?VWHaZV7W4Dd*fy zYNl~5Zc1C|I(sU@m2$MBf}+^e=*f_8t*N-3x&ytQTEPwHaR6tYD!)((aDq9G@m;=| z43Sb1JVImB<>@+n{Lg&8cRuS*HRSL{{V)18h7l2 zjwBFy0tS3dBh>g3;w41kaMF2uf8AZvyR+mQ;71m8sH<((-Nsdnm1n!xT`|FZ2^Un^ zZSt;2?4U-5CR|=&Sdk&e9N60_KU$R@M2?)h$Oo34Z7rn$B$2!3u9VX^r!1T}gRgsY`T)?N9^&F`k5iIf~aLoN!6Ob4Q`+Sny@k!|Gi|`8;t+%`mMO zYQAXud}blJdD@ku;g-_OpronZs!m%{f%WpuN9-Dg-t>z$o73Dqx5&y6nXg=#OOCnd zq#cV2B?CMCB@SK`>#VO@R!0l0*4VcG!e?yYg=uQyg6ucZ=Sl4x10_hp2_pkNpdQtF zdK6tTrPnu3>Mb&zOL0I`uS~kKkrf9A2}vZA@J=u?PljvdBaGzbvdc#iwl6Jy|{ti6If2aR4B6K~rIBM~J~zIsDZKkJ`s|Dj7jm)P-*3 z53Zy-)+_eqh;uH`t`dChPe^_oq{u>+v;}^Mo~NJ1(xZWEP;i7~B}gDEkWj^a4u&;? zF|+c|T9h(tGPp*Qd>t3$?{2kUVW8gBwLzP9L}rp!=F&X-zl0#~)LP)6M6JkC1x?yBp64G26YnLVUDmrdnQGT=${-Aip?1JGmF z<5Fv8zKwC$R}1a>8m%&?BWu$oT^sCD5UiwNgrPYqCmXrqv-RwGVTv)w{>Q)i5*i<@ zd37?4{7a&t(ih8RvRl$6>Gv-Z-P;=98EQ#y&Xf)mK_KI_NX7{uZ^t!Lmlv(^qv)#) zo0WDRuGVtkCF$QFN#I!Z?eHm7Zw&t!=vErKD^i2Xkl$OeoLJv z7bbOo6D&4+3r{5JtpZ{FYO2?opGCC?My5Oj-6Teg)2N8u$tv?kQe!DiJODeEq?D(a2XaXxxO~^C z<Uw6m?c$L&)OKUC4+L`nWaBl^T31|XiSl(l+FS>1E=hp3O7rWYM{eHIJ0`(O zaITwsg-|zlVmWk_?Y<)7#xFRgSzDpSp#?!r$khq1zRL7f}eDzT>)q`l9Z*f zy(s_?bAU>2d!9I((Po^yeeZtH+O?{y3Ll`<){)GYI$PK?|LQ1V@i1_ zL#ZhWE;w*D?kBs#s&6HkW8T|#_fX(vH=Bf#y}%_3NQKUO}yIYmXBh|KtcfsQ79xHLms|W^d746V$wfpTW8Pyo`#brsX^-Ilou}i{1vwo z+_jsIn|=#zMu#>F@_jAkf9NQ=EcN1gk+Vg0CU@gC0OJzBu`&# zqgY1O=UiJNSek$mVLLG?bqWLEmIiW9F5!y&{{Sn_vBf*SPusM=wd3_1`*yYVzANLO z^f}i2n_6`h(YrI7;0ceSFLqECpq^i~2tOTJTqR(hD%n=^;g^lE)o(c^KT;r&06g{; z4~*4qf4D%p>RXl0*%eGdl{M#~ppJ+tIOW~w?H?6dd?`zfafZU)a`V=wHj*)qLp}bW zN5@}j>5p~W zZ=Od!l}%b=+E=Jq7e`FF_fOAcJ~tlBEdg#2d(@&ZbA$03vL)M$JtoY!MaHAZXf=rC zTV4w0px_<^U>c~b*I02iyo<%^){8`?B>_`qT)|`|3qn$#O$kF_uL{QOU>-)W{XnwA z5{?!9S@eJWKEdhlROhUc-QhBxvuazM8&eWd8qGD?QP^ARxm(jG;I+5}f~0|xq$fT& z9EMFg@pk7L%VUG4CD|+p)E5%mnGf5oXk^8Xl_g0=4o2dnsVAVoSmrUES}pxOJ5}1G zd82mQA`sh=#JOou4JI;HRN{^RQkIn~2LPR^8Rt-~d#F{YIDvk+2h$~=Ix*XEFK9{Y)~bW<9?0)D~niwp=K5Bqs_+;nO68@mJL7o0ZY|rnX#gU)*7YbpHSi zw9SuJILlHkNSh*h5K=^T*5cNT-VBayJ_TGLRw;dy>6u;unNN6 zV5219=L$Z~Vy=EH+i!EM7N(bKP09%gep3$I6w=h_aUlv>*s|(ZxB?C^5_8E_O7R-^ zWp?Rfg9(P^-D5C?JQ<#sea~leMQB)D-4 zsU)YcA((3^ORiv#s-46SuIr3=*J5ZZLr*gFAd?*qN8i0jILR3AJkLIr_BgRg;FFKR z`F14;>oLlI#`*sMnNZEXzjxO&Et8mnZSfL@6oo`eopEYq4{~$hp$SUUj3loqK9&yZ ziCQf~+?(v^_NFd38-2msTx8q|l+sI21i0&*@<89a3MT<4o<{1DUk;tonxgME7gJn`3#9^jxWI)bb-FCQ8y4RyYK)2T5)$0t zQZQ1M$v{pB@AXtKSE(%8Et?dE!`9p=oZt+c;~uPhgTky1H0nzltd>nDXSy+Qm2Y*~ zFFg%mY_QoY32ZE25CW5rQbkw#%}t#>X(WJ6yzMF&&J|wYrOtlW+|}NlS88SyyDI6_Rq=)}nEY9%7=l%fl|%?w9RjY0{2aEedf?vek(x zQ_hs(C~qz)Az4~eoujT!X~&7$n$35J&7Q$=YI~}fXUtSJcC9nFCkjyS%7>%PLmb6I zc(Hf2+jwnc()R0&WlEJR&So&&l(_19JbsD+%1P}LjE;MKRr5_sShh<0;h&;q&4W*? zmTl2naa&5cmxMs!&ua4KroAo{c&d<<%}iL$hMI44&MRO_0&tY6&=N6>4ZMX*_z;#M zqf=a6j!&8keioMwLIb!_3Gc?!^VBa%wi~qSb+&e?7W}Im%Kbd@%}Mwyt-krv5T%x) zFiK8)olZ$3+w<4Gq{X#uXXM(gN4=7Hn(XX5rx0$Mzf;V5745^PTydo^%HyG>DJV$v zRICz4M}NdY<{9D2zulbF7j#XC&7#ipcE(|%B8O_~nqoqZH|;_|lHVc}qO^m!;}nNP zFeL!Ok(QK$xD&XmILPJQjP$MYbsm_|7EM=Z)OTMrop!hjn=C98Jo6}GD|kz13t7Zn z$q7mHlrlm=Bb(J@I7xR^#eAQ4`X*R@ou-qP^><&wosgv~-5X^2cB@o5cW*s%Hpy-8 zKrOynTCgy1oGDlw&fEeIF;elq-(rBP1Br(cCGGhu^R^jmlfIH%wTJ8AH<4=xJ*lno$cV@(S6gC8Pj$v70H{N zn{&m-CC6A>XpW*nP*>h_j1K@0eRz1jp=u+(&#Lt|ppT+tSaz;Bs_y>)=VUWp2HKxA zDL^Y@YDq}u2*wEb@m(jw$u`@)k6LM)o!NxBceB8L3M2rM^X#L0i5&XuO28csbKP9k z#2v}H%)*qSmI3ht(d%6|!+XS=29(yCn$a2qw6N%1`;3lJ|ini z%EO3A+(MMRZS=d653JL!nP9pRZV{37bSx!GT6YYqBw%#T4?&uZTs0+!Lc*N}<2kim zku~|Tp|-8^*0t@z5XkhfN_vsXyuVmkqm?+exc>li^zYFhN%T$0EzVru`DlvTQRmtY zUCt$<+i;U2Kz<4?VGE8Ggbb-GAvsEWRRf->6<6zM8jdVyhN86F?InkzMrtL#5@Rrg zB@Qg81d!7!Dk*TCs^&J+ zFBI>V`@Bniy3un@&6^YyM3*tOWw)Mlvr=%cu0K&)kAZ%?+;22>NzL7z{<5^1k4L<5 zP*Ccc`?>!Bu^r*_vK(tshSXA&$7MlDARP9Y<_JA;T@N65PF}GYG zT;x2bLEMMUH zazQ1>4gn+pJyqalo_K29p?81me#N21>G?e(IP$oxZVLW)Uq6yLd$8Co8fR6=j?{TK zW~HFNB}_K*np=+}>S$7vl#r5h-|1I7O8SS@BP=Tl-_IG|2z<{K(QddC=0J(i>jZ<{e*PDXjp{Jx>ZGs!+)pSdUO0qH2u0Af6H*MGL zdS!<#tj1LN(pk4Oxon3J-)N!K91=PF9z#6y+#}o|yTfx?FHBzJw%wao+oRdukmye6 za#n%ZJPL=RG6Hi_sg~9)aYmlLJeV?c{naXvWG`Y|46I>$h`>qPyE*T!uT$KyrnNr3aW>SaHq}T z_M~@+48n}+9DY@~mH^(vtt5!$YD$l2rIVew!Z!>M5^-d3=45SQ#HHUf!qqwjmf0yH zOIY)FoqbIn&9{0e{XhePK;O)Yhiffgq3i7M`#v&*LYq!a}{2BHRMB>wW&ZiYKy%evP#H5Jz3h*CqZ7&TRTh@1Ixp|=C7>L zT(GG#@jYaA=i45WXB16BTAt!_yKBELD%asW1l?ZKvE-z!Dc>PSc?vy()bQnw@SJ;d zRc+ZVqU7?O9*Ug$-vd^U3MR+34Lf?2>FmgqhY98o7L@^?9B&7ec>bdX<2JiKhtPeO zufVf^8&_r8X524Y4*d1b>cSYGc9`Qf*x^7pBB-HqA3OG}t<-JXu_FKxnsL>aomHuI z1)j-aj}Z_=c=s7j&uK0tfLK978fd5}DMdt*dH_!_F;&~Q4K<~p-`isE23-59pYv#t z-449rdDSTHZ#hXy)KmLV38$rBVcIP5nR8Uwz1wy)c z2nUje(5!eZC!&Vf9|PGgT_!irVYaxE2X@y$CZ_tFX;*l2t1Z?&OB(q-7UWL3OJ(%D zr(SW#K`QL`BoKzwfHQ!Uqtt2>z-0wp*MzKg_PJ|0?@w!!_bcnPahI_dk@9|5`i~|& zzN40SVxpVr7V0CRBPks^sP(T&4lO&|P$>rlch>ZeNlAO^Wm|?YNa0bC&MJj$ZuIe$I+bL141-+-##JG`EgemyjLgD^`G&dR7aNej zM0ROT24uH)(d& zryw0iJ!^HR;HhzeLR1u@g!NfUF_H+$CaBALUrnaSr&3Z=2sF{>g{3My$L^}yvfW`n zX46t(Y6v#D`hHT}Dw`z?q=kir5T)`wlzCT&>aFdIk5|d}f1_iG%QKa4ueQn6!u2XN z^QVL>8lW+2LL89yCu6nsY$-V$leL0MhB*O%FiloGcez5kaJttr%JZs+ChXE$Sw_`3 zklcjs+IfIV0Z*$3pDKQG?*~+C8FTI7Qy@i-#l5#y(u-0ymAJoJlb5m62X9;wDTm4m zb+$H)w%LuwKcBI4Wx*4*Pn;IRPmrS4cMPd`7#QXN9IFUp&aq<2Z->$B<<)w6&8)!~ zM%;V<0G9~y!V=liZ!Jr0eXYUOoF@PkBzF%{81_~;)gQFbVd9bXDXGRfa~Q2W6Jco5 zv)LmGO~3^p

@XmJKcAQ;0k~eV`$yn*LU$ki9w*Grb9 zMAgEXbp^f54s0|+Qk0~T&uUT4UNz$5&zf2198T!{D_iNlor^(-CbAo4DJo04^4Raj zrW0h)ku6)4>#_=_g(QO5LryT-fjo{$l7cWgB=g7^=T}rx^MwlNqy0U;J=y73{{R=- zQZzo9X$m`0V|1-&(kJTH%&4BZJdSWVo>kA%5K#Jo#&eU?uYb>7`W*Q(>Gx#qGv~ik z>2%sZQkE?us8X->NRa5)Tv)jTl8?^Y@;ZZ@e3dxSHaItT<;$0Jk8O!>WXO{x)Otj1 zD*BlEDn<(D5~s_`NRs19O13wjh3TOMN*stnKse`8YXi}Ab-lMd!4fYwlz|Q#8w#K5RJD$b^YJmr>$!ubd67Sk#v2xrmkblea6mGRnH+lI3#i- zo+>`ImY3S4Aw_~tJC*Q%5ZALAOC%Jh+4-)zIB{xc9X~|j-p#r4lDzhT)dY}v44yewx?PH`|-XOtU6IN*rxZg8|QoRUCRK`J;K#dE_|o)gBLuFs*5rFwR4CaGe> zO-|y(Zof|15h(&hg`}?z6pw+p z9OvswcXcBUnrdUWSQo8V?}Et+`+1P2qoQo)*)dxwLKL(Da#RqIfO!z45>5^)!dl#z zXEzQ}`j$V_`aM>k3&{luw{3s+{(mfv@z%&R-G<+3M57=U{PVO3N)S%)m174dndO{v zt(y0G{+3{bjv>1Im)aQc&sPRKvj*iu74FwRT44&?E zp@vl67OY`>uq#@U6zcPYf=Y&a`H}ajVMqZA-V!m>u4|?CeBE4Vi)&`TI2@@UC1B$j z>&m{8c@Z|*)Lb`py`?^HE1H_YAJ+HBBh$LRacg$kcF^;?cL9QOcHj#74fH?P73;SS zT!*R}k+l;NsmvDI{QywW%9+>?GjzuS_=|aCocWAxCNItO|*`X0EoDM+w#ysjmx2bQIYi z$HB%n9FtL=ABC$=JPNQ2>*PE0QeG1_(>k8;8Awhv^pc=Yc|oY(4;%)-QyjF`yEz=0&=ASv&ke30tYWwhCl4W2b)q`Q%)1y5u6+Vl_YiOt))4|JIh0b(xS8x zjzCjn#i7LR1SwvjgGUtIvRtH3>SD)jb}2X`*)*EHc2>7+z6WPB+#LuK`aBH0Y3;#ynpDCMwD z;08}3F`W2QSSVq%v)UDqpibe_o(UZODt5m~wn(;H;>3`zKWW(ul8v}R8d65wc=V@Eb{Lz0%Jq+K3MOeBR7gtiYZxaHlC zZ9=soNOfhR-=YdqwDK9}jDzWN&vJqF)Q5pryGz_DnPrINF?xkH)$Mt}+SHYV5>W6@ZcgazMw1K?moi z_tCRX-&VEnbFyf2%8xUSdCBR4)b#kN!s6mL?Jl7p4utcj8-%zCvE3q<9aQNlVKFw5 zux)ge=f{lFBYN_uE=OxkyRCA2F&n@>(wKX-Fff`lzdFs&8^I z)5)l~E||i~cF#j@C@l7&M1?Dv&r{;BUw5vf)7Hy(IX;$sH!`3z^3(qSo!i)&+T|pa zG_1H8QOOruL`(kyr+#qD6Ext|l_FgEr&eJUrM42u$NNZ}apF=ob$6d#)c+tU) zL8jnbboUS~5*n1-Z7M9Frsl+RvIS)+UJ?L2xnu8FwV~8SVWx3si`{2EYAAt9e<;e7 zwQlB=rANe!bm%GvA+)EG7DAf=C_6?~j(~xKfIJ91hdP>StxKhfoJ3pfS3;I{>{&Sj zzvHU<;d;0BitJ^Dg>~i5yxiLy+g?qfl2L-$;7h1*8MUP<3ni22rQ0V89Fcf={a=X6!sP{U0n35?R4$m*(BWm3J`grS9D#ck!&;uVY{qS8i= za+_{PQ~58)dQOm2mQ^Wo&DLpKOtv$#;V7NQX~sMI@k%(N7bE zNyt_dKm!#W@@nGO2Xyt3{T;-;0GdE$zfE+~cR2Scb7J1xVNS+1VM_!~> z&LQ!igZD}67HvqG2nte6mf|fT&^z#>-|eq%d7|;CzE3wU8BTwKvb{ExzNLhYrz<29 zJGu8`2}u|Ookis(3yE|}wv4i;0+h4xNgT#<6g_wyX~zEmtu(}DAY>>X31DoS&oL+o>2Mn{eDN1=;0ShmxA_xT!{?K?H8DeTm-fy{yc z@9WU=tKWmrO#UlcfY`PBfb;vEQQFSb4@i;f{2lc}wzIQysZj|}Qa307JGy-Qs?4%$ zS)3%|EsIlLG})TUZD2ibdBBd^8^|dtN|H#5*RocML{s<%^d!-v-umBni0^73-C87MzDUu}9h^FmSEE>k%mr3{x2 zAITlNAt^(r;Hg1K1ZM{XD5A&n=24N3 zd^Z!ab+w{givw~aLysi3*-D&f;j`$BE7Kz*$C%Cl$lIFbePI!>>#V=ptssz&&;{=1 zGq@5`aok36%bCSb^#_)33FhfE+U>e`Si2@eU`b)_$VE$?;R8E>z)vjW=c+eSan{Fm z+T0y0J)qFSOO7{z*Ox)#{`&3J>R}~RzwmSE@#K#_2CYFIZfUEN#iZlTm_mwij$;|d z3Q6VO4L4|3!`h}1P}}J%kpO*Z!Q=oOy;ReA*As7%RRJL}qpkEl;zkrywEPpx82RaT zjY1Qs?S)RCsyb9T)R%cZ1V`03)w?1vL2_D+Nv=^2wk4#LC=Aq%G!BG*FIp$N6mlgoP11ROpcyzB%L!Ciwmq#|I z8J_sn;oyA4Y zdx~&7^U!+-F;YEy<$V)ay&>paJ9-O_x=0ePd%{pU4oCw&%vDQp;)T-c_h{TU*+5q! zm2Mzo;RB9-+NP@}8A-(@$i}lOa(#8k-K-fzO<8?}grP0BFtm0IljwzR>(rHc{yO!o z+Xlm9TcDJp1BwU7o@t}bB+HWQ*-jO{`7b!L%&l3-KYQY*T|>3&MTxgomA2eBH=#$G zhkic=dC^gVsGUzM$lRN@bsmRmd`YpHn5CEH+b!<)j{%SiMM=WGyTh0JtEY5MMwTQ+ zQ?5J|m9*l5qlAw20q}jC>*r>V@`2WRRvdeBla?zI(lzaq}&vp-uU3yE) z?OJpB1;+lm7rpy`4UIMio9zOqk^vDM8a+3b>gb%!zN7 z5}5552I!=OtsoPWI2NE(PohBQfII4w*3jgqNL=1^vXCy3TUwk6+;E>jdoj45SQM*S zc~5H%StaF4vs&UZ;<+~3ojp%dTv1Yp$0N%FmMXKk>YJ_fCOy&gme8)%w$Ly;OpsOb z8sXGrgq1}aV0lw+ZMz&ax||Vp3KB9EYb1a(oGYd(TfsKvIPR)qJE6x>0V_)hM&8i& zsV5xyk4BQbeUNeaM7>OuJ`*SXvncS*;7L@3erIkgxhms8LcbI#14gO8J~ zaOJbg7l}5x8#}w}{vI0ik$VuFDfRa69pLmTKP&kjM zVmRbgu08GcR^u-Ajg^G}u!k{~fTWN!k&NPt=M%Nwpvvw#iNfFkNK0t!(pFSdI&|i+ zbKOyv%Prs}4ECu~x8+0)#|I~=#xkz|0FJTGmKh%E8whu~==FJvXbZ)1^h#7F$b=KWmZ{TU%)=DJm&HW7C(9b#sokd@kUn zySSxHAw3BPau56ICZ6I3tkP%^?6-i18wm($#1-ReN=7s4QLJF;S)SeJXK5)7spOZ` zu^k~Hw%sY-q;tmZW1mix<*pQm8AA`V6>cq(T5$^Pl9XWKJojLO&zP=HwfRYLZpu<2 z-R;8(9GrxO0n4a9HMaNVJH}l@9Sq36$A*HBNWzMQZXNaBv*VhnBC(EGJ+PBRmx)lL zxuS0J#Dq3|+qbgH9V98ywB=2w>vn}DCm8GNx895y{8-;?4= z&O53(aMTz3%(my>u1?Q&wFQFjG^CXRamac{VCmsckQ`IC8OljglF(>#$;JUr53iMZ znc9@xtCM^_UU#Y>v#b^X{;x-Qb7Z@ zDkI}PeoE6GO6-i0w9(ue9hcmc!qhGfn8jH`Y_DrX_p2id9X%7vms)A!EtcpdGafui zvfq&E4Lv2nuOZE6X~ zPc)>3bLZYlyQ&j*J6w{btwfF8ITA{<-`A~d({7?I#uIHv3Ju5`NXl{Jli${h+;?JJ zWHjI^!qfpNDJmK3%dL6xo0D#il-!a{mY$oJZ;tNh@DvogeNy592 zJQ}#H$h=QlCM~&=-%v^x^41(HNB{(qatHtck&c}QO5(*OYf_Z7y4p690NfIzo?M6f z>w7OvZ6U`=a?iq-h&<-JLkG79$aNG8`^A;41+nD>xjI zM&3n0W4TqyzEZcFIj|c_uh#i@xtCN86L zAT|iJrzL$z4jgCJYUkAHL;6Peg()Dp0qiHc0SE9`Mv=L~*~^vG`8Y=ChXj?U2Pd9t zNu@PSy{mLfYwrl}#9NvB0Zccz>S9*+PQbJRoP&d!LlWpxl2EjeWX^RPx%lMe zIL9ttHOVW~&c3#vkqX*W$ijO_pkRNRX$0$toTa+rVt{#VWuHerIL%CQ!Z4{t6CAnR zw<)yFvEwfgIAdqgI*L7`SlcgGd;B)7u`RY{_cY1@JKcTNWaILg7him5_yD#qy5!+ z>NnDfmd2BEcG+~TDC~0L2?|#*71F(}X$<29BOJVI&;Z~lWQ^vMEV`$5m0=m{j+N6D zX&jAx#tAMTs;sBLkH20*Lr!lBAacMpys3!gAfa6Q_VTSu+WHCY@OzVrJ`3{52N}bD z@s{$_os$w%k6KN0sa6!A(Qv30XK#4N&DOeWiZO%w9ro0at+G%^@His5%6+Qg9n~`2 zM;!E(g(W<&asKM(&aNj$CrDchSzOTu-)WkUI%3w9HxVTpdnBmj0GKRw#$@sDM}Jj zOtsON~16(?`SK=Qn>PpL0Ft={2@RuQP7)ez z2^~3*26NBGn2wUX1onkY93E%1z^?~NOapq|iO-kl*f_3i8hAoZYqQqW`nI!GjbhD_ z%DVgxTC<6Ims_GNTceD(4ig46c&xM#hLEDllmST#K9dPPmU-tG7!?^I#jQ?l&frc- z#yR^3+^4vjHd|>##lIO%AzZsR0dqMd=jZsbUavOC66t*s**lvF^o}#jsjjF&LOWuP z47!=>UirI!_!)fV))ZWAVJZmOl%BOC)0|h;dPKP8j$3h-=s;4G!X3y-&mihlkbPhS zObNGwFu6=_P~?=WJpGmES!O&Ew02+s22_O}e;37E`7y?8WQo&ia_Mp`m}KK6q)xbo(p0YQzPf&wYiX8SZ?|m) zu8t^ucXc%Rv{j|Fu4)u3s!EpA%yW4i$k!I-JQ7)TK^@BJk8Mqu5mR-EwWKMelWU4fQbI=1dmQ7@ z9sMvnxyA2#^Hgd(oSVhg?Bt1Zh+BlEC{9v@r6iyvAs{6Q$OE1`vqWnG7PP+1mt4+L z6c!41W1oM9X=u^Dat;fmkZ=OAS!2@TR;#nr&Ffm+@r-h1Z*Nxm5o(=zsWqEc=(qWX zLM^d`Sjkf@v{KqYz&jE*{1JsKCzV>7snsh@aN0p6VlhhnMJodyzMX2kk!d z+s`K$`7zGBr|5NFV93;Z1`td_?`d%C)QG7{$q*mT7mSWx1a zpT*0acJI*AFTZoquPsx{Ns~D!?ORV~2!kg)$1&7bm#tLe{Y_Kk>Z!b#Uw5js<-^q&`0FcD!(zGwYYHTD1tU9o z_tI)hqYAn5WqQ+54@fwL6U&l%R*!xcmEd-br^hL!59xxG0~$dGVOdr&frEq30~w_L z;Ivdjk{fIV1C?hxNXR3mNax6Ww8pYa!K2BF95yF&RNYFwCjlMgRvo-tT}No!hnHUJ zR&?Za5F|}$80Jb(JaZZ3PkK);VehTOPDe_6A30KaX8@D!_VpD>LnUrVs?Ul~ZSpb; zwaG(xc|Z(EmpH(_5N=EF4A6|EK$Eeq|Y1Z3L5b^bL>r_|d&}~9g z>cTl3oOG{EPPxF5Au(pjVIg0kp~4aesV9{!ax`0Ofyo8M+;=DIBlWLT{-6% z<@f7!ttTEJ#FV^+^~z5#W^vZ6@X2y!<+q6uG`zA3)=pNW;{%ybfu-r#rq=Spk)K7v zM_&qZU7pMk90Equ%yS=tydf4wRFxR7xE0iI$mPsdYnENdZ(~%5@~zGzwIvS_N>qgu z)|aQLBYfAl9~F~><4=+=R;htLb8lX8gp#l^^3#MH9kzLl+YGql(i9qLr1MhL zd=E<1MdWnIZ*M4vpvntTdPD%IT7Fp9Xq-nbrZw2(H`P_ z5lD|TmQ;d50(tZ6Tjs!17WnTpm8mLowA@F)SF4>nyv?pAQSNJQr3V{3O!Mo{HLdML zm$opgLJ9%e8|^!&qT#|OQBwOz;+uK1fTfhRH;(>U40Fj>m02;HjXOrfk*YFmp8S6uRrd#E(=j*df3W$W^OKBr`0Qw`I zdi?b%b5Oq(w&Oy#FouUUZ6NOIIpfz`t=D*Soo$J>*vUBV=UQV;DnZrMh=-aXDb5Ej zgbMPe$_dU-LDRmjo*L*GJVd)L1PH;1;p9hWvuCt+LxlVkr#!wfQr&0d`KdHCCT_Z# z)hgW*Q^AIuki%ng@K15?#y(ooT6uPJ`|2{<&T4IC3j`#C-GNeVF3XZ{QC)4b*)$a4 z<=={zNP^T=t%gbz0OYR4I6XaHznoJ|!sm0gMNx|DNC0J6Yz&U>g0hx5V`i>Tx*~Jo zOJa0{I+EFW?hQ{2bXas?boMWX) zWy)Nq?Y8SuSo5or&>L{J4`z~jj1FhJvAYF?hq{rJh$N@CeZhGuW4Q?t<*BFL z2xYd4!c?uhQbJOYdJGd%X;&MpHp*DJtqA9xxCESX?#)K7SKUb-ZpjxnRtsrbaC)SI zd5@BjgIzM#)22t7i75y>;z+|_gSo7gABbkX`IW(70dAGd1L+I_?Wsq;xyrIg-kiMJ zK`TJY$Rn11I=DDL!)LVxg5h;r?XFe6*lzOtf<$?^h!lZ^;|TF{&faw(xea+1BxFPTGOL15@TIkjO*?#rw-DUub(hZ zN6A>PvZ&SDR{9u`r8NWYC9?tSgp~x8fyh?W=^O6Uhi%Ep1zE~L#ZEYTZTHoy=3K7} zTk-ADyHLkzge6K*3D15y=h!Qttb9AQ+;olSQ8gY4MU6;FZ)Wb$tmB#R<^KBUhBud% zR#_Z4T^x)wP4Nx(sJDZHI=G(tmFayca*1$mb;0Pcn~sp;O5GcZvyHWBUhPmBO4<

uw+cIC zl7duo^W^+=kshm9HMoNJxC(c0I zj-dN1rg(e6S8qBy-D?CBa=9^ik7Yz9Ag{Js+U*>DYX{J62;<1MHkO(`Sc^9PZwp{8=>nLSI3rgGyvHq@w4N}ht0;1cJY0-k+y z?5S1LLP3|Od# zVs*|WSBh1I4do$R&yMP@C|lcQvc0|VMN`8KO7Kb%95|E{xkyTsdV4g#$`k%G?O2^3A5!)nuz7%jzD;im0QwawKEF1eJsDW=aX z;Us~Np1KD@S*`MC%z-);%42bDu00w(xw4{_Byv-nuo60x;44f}Qgl}=np_ntd=ixP zy{Fr|O>#otQWlRj$7YWl=CaQVW7?#l%apmwZMB>vGC^0ax*pQQ>V(qYNhK|#ao>=4 z5C<;dk~))7-DJv9%pX5qreH7|D^kiafy}is8u}oE>nqw;mX?>B&+N78ap((s=-uGx5{>E*D0aq_r0DDa9Oe?0Mk# z(_V*Zr>0MFU@RrHY~(P2NEpw_T^y}RX}#&|Hk`I;R6>5#pR3CV8Fg6k@2xSzaTCd~ zrGGHXtH?=5pDmyPBsMS<49{rw5Ufp5Q_sL5Z z`?R)3{B};Go_=2HZM;X)wt25Jx^$kwBXW>JK_uf9;V&X4tdf|-r3jX$!gI@=HC($v zE#S0*6(t+8udNFi`?crE#w_cO=B=W4Z{hX6bY#eOG^Tr0CB*M|4~5e{%u|whS!q%V z)7v_Qf?HRdV{jc$Dz&sz7B^?!S9ocT!Ud61T0_SuO2UFtKpe`jNydAs#fifH7(V+q zm#>Yjxf5dt7>ghwDauj;N>ABjm1DqktzihhOfo)rInLX|$QJhzDVS|O;pBxp{{SwW zzCPhgrSRs_dT>jf0y>x3;l&qJ0u$3Dk5((BTHuEdBC6qjyxm=oWoxu}Moi==_U-Og z#9-%X2}sXBg;9-pq_}Hk(6O%e8ICu1VNjI&3zQV4`Nj!A9R3DC=UXf`(ncz7T@;7r zH)3_d+F`;w5(Z3#5sY&Au}jgwyDQk+763RLgNijNilQ6b`zT=2)s4R^9w8yRVY)unr zV*Bq>-!=zm8hyr=pr)2jBZF6z$nn5Jop2Hrm)k4IO8iAZ_`47zhqotQQj|=H>M1z^4Ry$2zW=Zs8M~nOVlp zUKyHz!t~@7t)$^4)c7Azq=iTbUd<^49hpa>dHmJauGqBVR#zU$5wH`3v7wsKVOzqB zW&~U%I3H0I$)r+|5Y%`%JR)&kCW1fFCPk21!(XW~} z7!ny}xYJOTsT)u?HUJ+gF;^O!j?hacJ6Sz2fuCi1T7p{%ZI+Rc3b28d5zypxsE(W4 zm5EN#;Z7B9NF0IXTAl2gLG3*vdIMPm^BAo!Hv;L zjMYXop0{x)vSL$c>QjP1C)@0+zcoEq!j_w^V$w8QdhYpYC%cqf~?jq2Jaz6o*(M> zk{oS`V?D}N1!`Xnb)(7JVyQj*in4ki!&l3PdQuKk*BCXWl&Co3l?1#O<)@8wQgki!w3R8uG=~m40F&0F%4sjMkW_Z#k)}Om z95lIuQYNW#6)9yqasVWA>-Xu>%?&~zl3R86AH!`n zR7qQkI7(7G@^PO4X^o;V8!8GZAw0W>O0alqsNT|(EV{ZhIFp{VTuZITl7gfyeV!4^ zp&;ap^)<^gX5G>z`rn05@ZMFH-F255T)U08&!jZbt(_P(ru1%aD6D1vD@hxZvb`-xX4_-cFlm!%2V0}ZAnqj%g(mT6&NWR;d`RjkzJx24$5Bc&nRt62iaHB zczI!GhB5E<%T$Yv-B$F^b=D`OmO;)(W7hyDcdDp664GRt=@{)0q^OSrR}P=zJ)+ZO zajSlhX}wDAwRUrHFW~|z(o&)u&o%8PSd?PAg^u#^?~cDJ*+ae zRTe-cw*g8(9P?3|Zp5LMMo2;vjHd+h9LVwJJ~L8lN{Dd;CnYC1@UFaSD}yQB(M@V+ z5XI76y|8eHk0pAkwJe0FrAp?X0Z&@h4Wm)q6jQlNby(fda_;$RJX8rJBnVWh;3y8c^?dZ%sw_sss_quaFoXp(`7FjN z+(HQ4k`F`Z(+-N(vb1!ElAC-v@u#%kokp0F;&(Q3gDoJm`u(O0G zBMSTU!^LJ8_afNoY$%~lCw@rX)bg&qk)pBwWpWfYVM*kAky2eS-I_#*O1sH&EJC1O zTWQ>&psq>Bcs)Kkj3lI>6r3l#Q{AACHx7^nTNa-yz$j!%H@r+CUw zq!IPl+xUKQ^45^!fmV9et*z}dEiPcFX9W0Q)5OOUCxJR1N>#a0=RV08#s>5FDZcar z+J1TvoyiPtB=YG?SnT9^Iaws3Ia4>M8y=u?e*J2fJPTWC9%idAtploSbYMFlgmd3s zXQfTPuc-mN1DyJ+5dxEtuJKr8;?Z$E^|Y?fASmYuBy+CD`WNiDtL~a~f|N5pdO-7x z^@As>YmYB&DR$@Z5_UGDgU-6k=v&B;y=`M?C6u-&PAeNgUVO$*G4t1-tc~qPi@Q56 z;mRBM`vrgVE8+FbCENYk=T=-_x-vc&?W^t#{{ZYazi6-iWqd=NtlsYlTcCk(lgJO* z*Qu@kaWccfp=lYwPd@H-vO9@wY2K9_C}iXuR;4RE@mrZdOMwNnob>0=(mcqyXz`8VPu=IUG9;zj?$Yit zmWXIrb+jb5u#lywsbFmZL}w?KYoN7cJ!y2*v9zv$;#HqcLW2w@bVm$n7Y5raDc+`* z+loRGl(upTMpmFQ3Ukac_5QDwcecp6>bt^|1$~ea%V36GT0^P`+p$h<9Ek@VNHuC{ zOUDQ}ZF^p;uyHqaqs>d~**ip;i+#q{0#?&)p(zOtZc0Kx3cw)tU=LeEDD7%T$a?-f zvDHH?FLYN4D^L1}IDcj17L-lDMrlqbL4g&;w(^-a_MX`5s0jhZxZ0GJY-cAY0|U_n znvVHLYo+Q9M;k@4EplV&R4zNxl-O-@<*RROqLhTEVoFjI=;Y;RI3Nce3GpJ?X4Lwt zS!!G0wfXc}a++dPje*w|>YQznxbq+{XaJ00;E-`t%B49e*)!h?Q@;8schTj#eJp6Qz%d%xsX&!IV)~?p8OiE_`xlyd{NX6Lk+2>kjq6)k+dne z%^_TYJ?TC5!|D2r)6KId!QJ|w(exT`Opbj#Ql^q?zPYltDCfz{0$`Mk zJ3WC*a|>&MU>yEsLKECROv=X8MRuqtM4l&lOzbB|oO5!9ZBr>-{EWG~IEQR_h zINCFV>&<;Wk#1+@a^UKzI?6VQ(VB5`?{}RgG7M*~P?r_>=!te{mz1|&ZNw=~xRjwo zVp5~Xa|DFfJ#l+THK!UHk}I+hCfwyhlNx(%rE#R8Ztp^aLt;o%4y1&sU>-qA#^Yuq zQ1M#DBI~F04z0dLwlyU(B!!&pg#%sO<`{>T89S_5gAt z&M}g$-8rO^JzlTDT^n|_XGuXz6e zYPUUfwd=c6%t(uPXrR8%6qP)V@#;_`I9GqG6~m?0=ANbQx@W!X-==h0e@BbKx7>nG zRQYfJ0MS)2NK~XF&@M%Eg>K}pNPN}WT2?|Veoy+5nR7028o-@9Fk%bJo6iq$^Lc$F2{v0@1=Mws&` zkjhv-HJDf{PQ7KTt%Cpbc(xy75eZnKQguvm0 z8l5SE$P!e>^2SQOq%zWo_$5G&=ZO*4SKfbY>Jnkf%W-+h0fNS*4c@T;C_< zzpHdOy+76R;lipn#T`rJX&r59dt=T>|e*QY9%wAJnv{iYdZE=RaHqUwhCWH^N-DJ2hYNpEOQcAdnL%dK_#+^3IBr3X*J zujtJ-4Mw%&)Z$W$^86Kzhf6P1-=@NLdrZc)IQN~%Y?TI*hYM-IIKe7IhdjU=d33Gr z=#Cz0SaVs@TJWxGEU2hVT6+Zn-c(y}BbG9Pym!<6iqUIY^|pu8(?VR7&zeMaPlc;_ zZEIE(NXoMzS?ARU!k}$%gI3)lPi9@cyK8A@J*1_Swy>O$wMAZ#$3vc3@2{KsyqU5m zl6BGc`F$5lp~9o5(=4gET(7UeRraoy9cgX?q-WAf%8;Rj437cmnwn|W+(xR=?y0nu z?rmEM0AVL1=N~md+ijMbEw}D4h+ZFSlmmPWPfGN117oROaWDN|5@1Ae^9{c^Jo0 z)~WtD$hXS7v#TN7qd-mKHqSMV`X53ZX*~8gms~+lOoY0;9z>E3Cv&2#Tim!c5-f!_ z;ZudsIfUe-k@eW`80ng=_?Vv8O51POb%otah8jabO)|6;A4x3|c7e4#`J7;M0=&Oe z&6ftIE)J3Rf2X}ON3ZnRd$>}RdVf6{wHArtb&=#-ueze^5=-&SfDye&OKRK@qEis0 z4artc?+;n3!;1PvdQVZsWio`=GUINEB`R#CX-O$R1#10|G862pKZ{yRQ0hHF4OXig z^4LYDD+_t1ijtLf@=5fujzM`RxFF@8Nh)MKP{>#~HImYZVJAw|Ho1GT2{kWVel ztb>u9leAZtq|cRRkKK0pN44wzm!*b-Jz!Yth+@f9L2T@Qj{So8Lq?fZq?AV zb(ZUJROB-@PM>XvA#H~Pj}?LwgWZARE00pNt54kI6s2EOZy@_Cr}$FiQ0;bufI)`Y zD+tfloQ&Y(+5z@g*=b?-SIPM9d2U=5hY@w8y>X&+#g^%JVe9J?XGxfm5Jzc*6sPKh zf-*6&KCI`UBv9JQ${W>f>1$%#-65tF9g=rAwYuZYfTRSco>)md`ESQ{P56yI)XWIl zMg2z(*4(U0oQZNU^Q~c6Z3P|68F$>Y1~phA?zJ1=RHGTm1{k<#A*Kk&X3hS6ZF=GUXu)&qNOJ|w(WHM5!;^( z^v0o=cG8xso!K{dEC-C2ns3bLL%ifp&1c90)UXMNLH8^iw zSL5V>Yq1vG#92%QM^yOEI))@2uBAxZxF`Tpk~b$KCm1;)e@q4j0*WF>a`goju4Z( zcSq~X(!C==Ek=1pDO7gaw6E}U{-#xxI;QI0mz63_us#b8No=<1%SbB(6r}nq-kyUX z1K(J_vZkWi3Chx@LBQ_xz@*n{j=O!j%5^9!dSmWvZF|ztQi%ylh#3G7Iu4x&N?)p+ zLr|=0LW+l)jHkal>*zGLl2YvacV6K<(r{c`J8y$rQ-4HgS^9TQPYvoR+L|Pj9p=8J zD&N`R#?-F`C%kPwzUpY>4dX-GTYBYcmo(b$&Vvrv&txPv^V>_%TR&c$y3&Hu5wVq~RvuYy>ep=2p2%>dDFIl(DJsg- z(>riMCmB99hKu1HoSPP<)fec>g!-P!T2jvb76ZktE#7<~uR@jXk&jxL(68>H9Zq3+Q%^eOlF`a)#6mZZZ%V#|`+lH=b1 zyU3xnoH(W94V-Nq_*FjeTI?;?fp$wp$8Fa*vimhSpGXWHppUM~X^Qh2YgY|g<>JhX zOYS!0r!C;IF)2|5{eoJ$T96J*wv$q_<2;J7clhfMU7T+i1 zKCZTE=Sr)=(;BN*XiZl#MdHVyozvHwo9dY^<0j+Uwvmjh&^R3ji1ySqhAjHc+05zp zu8%E(w$V7DwL_BPNlKE^)6GCD0FqOU#DbtH$4}W(`>mBM2XnufDM`nP?)HpgwQB3M z)}587w2Lc|d3gy-vzFODWP_B2g%Ec*0{s*X#B)-P1}fgKnpk%GQ)#p4e@5sqYcS<{ zoJvrQw*3D9_@W(U)A~y3V0TpBr`%hP)RvnDGIwPz?Cgfng_2J2k_SAFUKIz`JT=nD z(??lw{{T|Cc!?3w=S@1aslYcUDi}%>fHxDhZTR!67B!kv+%KJIv_*ORTp{_pY__Ek z(pL@5zz$fzS;_e-HDXH(J7*w_~aVC^u5yQWw=W=>9eCe z`)Y{dqXf3MTTlmThfTcs`m%6ph}SI$y3#^ha1bOkq1*`Nj()M4=w2RMU|uhiV&1J6 zc}=DR@)F&r({-nUG8E=|GzT(ATw|fHuFflOK*OEXZoEiNZ;2!h z(4~C)b)e^9DL#rY205N}#-=?N-xWI%l?E%SZRJ2 zI`n-rsCBckCx>tn$U=~nFFuO?rl5~vmAHbQL!DQe$4nzeTCTQ7F43+lMCkInMn@ut z0>XC;oE^U!V_VDB)0Qx>}E5oVWL|LZ7O^;Tlfk| zIaeY{sVdvIw>jLJ|qI_Oc# zLU%Tix4(lap$mcgkbGg zGD3jmk&*%B&FZ;*oEzflpHuonNgZaZ*~yJcK5xSL6W#5?)pa(q^NU+4Lxehmovs%W zj+n_VF!B#By~3X#j~>L!@?uSS$x(wQLQAPBVJpbpw1M80W1n_SH0dZ;dDqE$lKiwa zC3{?30Fcv6vftEMLXJTx+@}}M9+K1)tmc*3ZrUaqJtJEd-q(Y-J9x20<1smVCSERCop>Z{8C09qfIQ_MFFx3IN3 zlK3Gw+=0~N$2Aq>Uu<}5czh|vCBDhk0Fmh6;~y12TOzvLF)mDi9%*Y%^?FJhJAfF# zz*jE(j$*WNg3oY|!aLN5i*6}Qr*Uo2y_h{RI{SP5RrfeDeMX&Reo^>-uTJz@scGM7 zwf_Jj59Fk$7cTtMBYSS!UjZdJ!Ar!0_iLh_PQ|5#G!v9zM4oxgb9a(DocDU-(xhQh zEw7|^ER3N<r z$puPEa1V87XHuP`+QJk{)S!0vfm)X7N{eV9r9&7ZwV`-c-e42VSG6g*^I2?)rv~^4uYWiP?6MQoo`!?t?h_e+Iy5KIVwWSDgfu1tR@sxc}A5ol@Cbo zPCL0~ysc^qN!y*N+5t7`=bRx}Ym#xae07G^g(XB}_1bGL%^ZEm(SOsQ`s@%?Mv_4BGNlxGhNlMHp<-e3WC4`krlCFw*gAr>D(()HZ-vL zIc+?E?&tpiWmTfpN4>2e6s@v5H2Z0zQI?LHzO;nlE?eBsFI7D_M`ENQeL*{^72xjE zmzK^QKIc8p9X$em^&dsx_MCRvQe+1k0AwXZW7SfvG_W-CobNJ;2YXxm5(!kxH15$l64d<*^Iq7IBG<$<(P89%m>;nNkafJ?lg1IKX4yeZJ{{ZzC z&keYE{-8>3m#yqTaFD~HX%0Slfv_wPehKaXV00NH8hy(mqszKq?;_g*Dps{`QdHvh z?;!{yky#C_^dpuz5-ZmSr%IEoEv-zrNpZL_WFj*~z);v$NhuyDb`C+KLR#Ouy2N;) z2o3gy#e|PQ1rxiL2@_oCE0BCOo#B?3Mw-+Y0t_>G5=~sMRu6 zsx5P1ThOSM3p{6JCG{t7p2}z|VpE=thX_{V$heV$Km_u-)-u>h4g|DD;4zbv-Ca6N z)61uFo3-HazgB5<+C6M>V1+tYU0;z!nMhRj$R#~MspgolT=gX6S*=#{A?zvAl;HXS zSW=X6xFlzp9P`LzbEplgvqiy&9#}#*dPI+cDsgYQ$%gcY?6-HLxgi~ad6jKZYjOw~ z?)V78z7QL*aa&~F>@^TnRa^O^GQS0x_zVRc=M_9ITo~21>m+Eb$hWl!0djB^N^~p~osJA_ z#?isYRUb3Fd0o;fD&PYGBR6^V&tX zIxy1MUR`+S1dN3Y1IVPLob>RjeT$v6#D*JRWVTodbP?a-R__CD@@`t<+RUqqud@mR z%|&Tz0Su!covH9SImk7^u9iq)-v`m@{*}X_&93&nLK~Coz>iELPpwj))c2J+4}Jdj8jQ)|dP z$1b77sT*_+p5=9$+gW3^CFlx6%VBP%8^T;s+Iz=5bH;FaVx73GrnLtLlc+9o8fsO# zLRf-`+vBkKE+iEO3FNJg6m!lJ))RnoFv+ON43KxjK9f)Bnq1lqQkEo~Z)@}4$w<~*FLKC+_x?d z&Rk==Yv{Z9Yr*yEDD7SKKb%3gKG=3Io4AndjzFzx-V_1=P#MQEq~oZ{E*NQ+HG|7` z=C_%O%r82S?0-b1Uebk(4@h8u2pF8e#TwV`E5kAB0C9nev54(_~X$} zaLx}pZQ*RaWNi}{p`Ew(t;2|^PB_wBbqPyn1tW0g6q0#^)K`g?dG}>XUkB-$Z6Bmc z8a#^?rscVI+f-@P3(|6}vSVphuX|S0>vh|Mu{MUlJ9ed|m7JV)NCTfUS}dw*-zJo{ zr6?9P0-BpmiK3x8F4;Ub(Hq6@|V69Cd|c1pqm89Qk{5P@O9AmB1U!AnwIS zyax{~fE1ozaQv0(`d*>s$M<+XQ}vdDIvsLY>YB8Ys{AobgSfWpQdQ`uo^#z>n^9Ow zw&3*XN!Hqt9y-GJ0@wuSzXG?%K7id_IeBNyOO%XUkQV|-2MR4HWcLpG>TjV|T7O(Y zP+`*KdGin!0Nal-m5k@(u3VacxX%E3ppJbjqP~S>x0S}2(A3+zQuMXu4t-5OoaGOL z*PphzwQ9DS$D_J#KiF^n(O>+^_;)EOZtrwgGWWU?LdW_2Ywi`y;tYfSO<(-V_;4RD z&6e`IDpSfUA6=DKezkq^F^4C-lBA?4b0AWt6x(hWlBBHU1f=(xOhC?lI^7*BTCfT; zw2ok4@~OweqRkejhKSsIzN~GD2yib;?n;nz%&?q_fN1q+PPQB>1acV_I^psmrCR0J z5aSX(?u9e}!cvgZLHR+d^GDB!nt0f|092)t2no-MbCaKxo_*zBHK|TCztEgzS?>-f@Yjyflpjgd1N(80yIIO# z44B2Ia#qdCI9C2c(ZSC%^8Wx&T_bT@my|h#;}}m$-t36meK`$dA7x0>A(UipZ`-=7 z29l;sV)<;?wG|)&2P4=pHAi38a^vpm$z)pR9jXO`cL|hXQhJkmqDqDeFN3-x#SV=;AZ~+|g>o~{XswZxV zMY*JtPSjW#y+MfRaf4#U9f4k0}+X_)i9&;%N00V)JW5$x` z?OSTM$3?F8x0wPcX{S-s10)0cs!MRa+T<;2VtZ>!k1X;(9ch;i8Ko&JXI4K@)!>h} zk0VR)ZHKRQ&9>fcmhDq;Vizr}pvO)%nJN;}W3A|({k?5yK9K@oMtMB*pq@XFgytrq+cR1 zw&h15)v~SlUrhHJLgVY2^4?Mbal%xffy)G>({SbuyH$PwwnlYs#9Gl_kWL zr6X|1KS)1CO>12+Jo}IbGxwgU?aZEUsq1~wiaNV7t<2Wf|dhCFjW- z)h)@LJI?Nx36tMx1ueNP-Rf;8xOWQB_YigCO@z0rC!s1K7~G5moD6&)Qh#&nri<4R zEK~O_h!T*sb>6X2$r`1X(df0%NqDXk;v1Rf0JgYop8HOYU6pE zE^Md3`m?LgPT)EL@lsoAlADAjZXkB4$@OBiNV+?64K(IL8u&gnnCMq(+8o?BEF89w zdUs%&j7uICqZ5xVeA=v!E?HY=O>inJYtSzVPQKrr&yXXw*vgba^hwXG(oIo1?;JSW z7mJKE6q4#%d?cw|IgEY!g7Bx0@i=W|y=i&&IWw4j!mD$PI2v{uj46=YP7(VW#(~t^S5Vz}>VDo|o7sW867_sH({i(wIM6U!V;Wg z9F*y?P6x6|&K#GKHs37jxy>mN-BP7Fv0Ks{Y~Z0or=&B3 zRPL;RwazoA&zCjrs%^KVJXf(K=LsDL$xk|)%M#IeZIf%@Zkw{cp}JDzPmo)5k<

{Gv)?tUU9FJ)4KVEBQ`#{F6xwVY! zLKL1rs~`_YBbhY@)TPwlb;UeNmZc~XqDl3tlS|d|P&3h4YwJI_<(m%5}y>nNQ&hTdUo%0ZUjyNX7=|R!^+@ zsRirG!&ly|QJ^)YG>j+NQ7=o67?&N+J|Cof4mx!|6bA3bJx_TqEU^)^sGRl@w&&N* zt*M?IlC>3O@nzLw#_>jOpX7ekI*U|I(=y_{siv4HaS_aAJ+&%H>M@L-o;4rPGZAdn z5ag9?X)QY00QFLl=;PxiqjE0N=Aen)qJdB#DLY3he9~bn)ONM)$nDP}IbbI>=Eg9^ zCgP5)+U-W8`{}t?R#+SjwmWd2tXhtjUw#~B9_-n{P-H#}j`Qjg0p-@Z0wYnS+MYz2 zWxcHgpf;kH3eO;+%hjJ%afot)k%k2_e_eTyH5G6iC={-O8+uE#+Coy)hjz zBit=>8*M5`UCII^FDlMX{iNp@>)nd}vmxij(18D&pazV$9J?bO`+HDP~Dnk1wHmCqFN#%@p@~S8ICUf7~(bd{c z*5ntHZgGd3Q_GIjh98ct;4CK!0DDKuD$LeePTb|K=dI>U81Yf&jXaq-Q)H|j)PbB7 z<8QY$#dc39&MfKWFt%_0a;6fL70P5fwICE=5_zA1j=y4jYFT&k#^V*{#TvkdtdOF% z;+%2#_Vl*5@}h8{6XJRL{Z;D2CLEadPm`VxQK!l7VU<6?w@}#}fpJ~X&6O&8IT=p6 zTssFug>u4s`2p+ANA)hW*H)c7Z@4$9?#W#F(pXCSbR4#Xf(K?(%bJMKeL}AsSk||N zEfb$%vf(8|u|f`gcuhy7U9NXYEjd0)*0#O^ezbb}dWCrz@M)&$K_0H3)qP77b6K6s zzsVwxbGY6We!Si0yE1IZ06ih>6)iz%NcCfC5IT1nm2f=ATi2G&#fD@BHsegVu#oY_ zIcKLTh}vTBw%uAn)7uDp)P-`u&UVyEPZrdbwCaMAke&NcoQ{Jgrxc-%xH&Rpo@uv{ z+@F)X^!<`-gs@nJE!U;CP|#sX+^q8S26LW#jw!cQXbbh3PQ#OQ)wZ{hosG)4A+hj! z=N!Fft#Q09N2qP@H98gg;~m)NEI8D%6pVe3K2)mltu#)pySO+LdwEIQIc>;P(l&$ z=BbOuslRG9qD}JmCgP?XS{n0(a!Pj(Ng!Yh;-lp<97fcItOXU9RGvydVxmtld+AF# zTS!q#cP(i`O3*W$^Z*+3<%bmVdx|`ri`8|n0>LbgYVl-)SjbSns6008EUd4oEsebW zeu+H0>!q}H)yr&wdeJ(9JF#wd#ao+kFQh24;&9+nNy<)n4D_yM)~q_+=X33CT9De% z7NL(tJh7f<$Kt5_1=c}vFF74unLCg%yC*!(?zyh4Sv|ISvxCT}@69X2OP;cg4m4R8 zmgCx%TaxXvYjMCNZc>W5Is!oNS^_{B>Tr4U&ONm#xAyXMZOL)awF51uLV>^` zDPPT!E6;`qsqTzYH_PfeoVe67O|-sPqlc3%G4FF2x=u05;}IRq4XRjJJp4HYRqduw zi<>MkjZ*Esr20rO?hUq{eMtl!b;|BK&!mJFGNI{|5>=kO@mXm}ZGQ%w#0>(Bj_Y?0H>DM|~2t552h{1S48R-09E1Y`02k>H6b?%@e0-#ibQcTpamwPb{w_t+L#;>zxyMwnmX2_|!RO zD=3uA%%=)MLJrb9y$`!jEb6T)8!0-r*a^TXQivZtb2;ooiBD_GIVo}Oe2;(~Ki^LW zP)xxkO(h`UC^i&1cXAbYY8-euXNz}7M=Mk5MI*8I$z~jm)7s-6HJ5b_ne>TF@m&y- zl!Pe^+)@w%dw|+V9r)>JIy731Mu|6ubk3W4Zjn?OhHn`Z@VTkBR)bg!w2@i9c=S*5|)BicIP1HZ$FC_ zSo;u8Djk>0tJP(3a>)4P>>CcQ;q8jr>et5`TarBK6W(pci|bmsZ3!Dj0OT?2H4)=? z6?9yk8s?MH8i-$JT;3^rv5KZ6L}@3dK59M#pssHSlA;^z)ap<<0#-(R2P{_M4d9m$ zm~L-K0ZQzNBzFPJAXf3!`*7I>Nao28dndV(+kQ*)$sR(S*Do-Z0@NW+2qa}eA*86B z`$sD2W?OVyk8FTe;y_P6{C~XHGkGanE|GQpu$LcU$!**ea)L0&WPy&JC$0y!x@DN8 zG|HDDAgQD&J6E5r9QoH?l6%)DCTJxg6U_sJxbjo&<!P zhcJG)XYSGo4lP^5pAV+cFe|mX;O3;6QrfJb>C1D=(!xdACsI}w6#GgXHk zS93+PPd90HN=uJOLy2W&0YM`pBvx%Gt2D=rNz*I`6avGlklJ!^0dYL(Fp|)arxx=^ zJdPX{%<6YmI?@uB!d3wQu2Bc>);!x)?Zb|NyRIeY@7EK|nY+`bbc?Stg_ca_6W$bE z72#5$B|t80e2)IqS2uZ{qf!c2agGtl`f@q-<@1ADmjd>uh*an;g!igJ0Q`N`m%Gg( z(Zu7zIz8#o7IL|e_a~SNbOVashZ=D}v=XMs1uIF)RqQp*NrQA+{Wl^!KFTzW{oOj| zuRa^NmoycD&D+Uk{oL|F4gt=mefCm#_Pb=D?mmKgbv5l_O4{bq6VPY8*0lXsJ9E>R z9Zha=M3kcnP6t9N$(42B)TSFliF<#htn#5CdO)OYA3bE`f*To9dipu7TVF^~Q)wk# z0LUlCq=VA%rixMC4n0(!VoTOrq;w6cR5x2E9YI0OC}jl=_CdXeuQOhpQ){=(^s%{z zQOI>A1XX3xYPzF~UvFmQEFPn8tH17(SWL+f98=9aQ=D!9@;(HQmY?pn+e>=`v)*aI z03&GbR*LwIDp!0>V#GoElqe z;#^>Oj3R#Ab_=TAtHHWIDF_5-WW3X+%JYXxxM(1Qc^T#(w>DLlkhwY*z+) zjb2?|P5ETo`62GRv!aOyySlsyFE)3fYCt2oc&E14r&F{p8|uejNR0gSq{p$idq!=| z?NG{FanDQe)@}0at*F=FYq)CdRd|hWgFgE$_N|f3Xh|yoGSNy>QV8zC5$(XID11)h z4ZhNB(Dh{Y;iag z>5oYIt2d{Fl2mlZ)b&t%p*FwnLz{^7mdwu7fI$lQ`ulT}SWyM7p+|A>H7k?m_T(w2 zVs>j!_aog=^DZ}}R{@@VE1^L~6mai(Ch|%0#?`G(B}FO$JxiO0X?~y7_kAxtH(fhE zTp7tikRNRNTUFF#=fa(B%&z9}j|R#gdm#yBhD(c5mG&u4cPMx5rM~0JVP-trLlGQo z?OSg$Q0r&*VEyXJV~qaS(WEClQuiSFT@lM|_V;U?i>kOl^MVxO3?Ezz|pjNgx=oYsq#waZH&tFR$wJA!&q zX`v}@Xx=`ft5A5ix_zP^>b7JaiS>1)$$xT66oRh)oT=JOlH-Rgvw_|*&b7l+uP3rg z4W$V?iuNbc^>pP)MM2rib;;*X>bvfen!ApcxIb@@<0dn%G;pQ1cAbYKr=Xhgr|i$M_|zW0ZoZlcTKX!wMgMnqJaNoQVsKEw!i&5ZY1`$a;rbec^m}j}5qs92}M# zWT`%}o^`$)afjO#NaWUPC#iep+kYk-E-Kjp#Uudibi0A#NgsNZMp9N2&XB+79z)Wvxff6D2^jwNul{9xHe@)i*>V6254pH!mUnp9rLKQ` zOz`k-#(8+xuv-UrFpw}vJnP1B>2=3C_7a{z{@dcJW9D{UmbQ&~OP8+YOleJzdnLV{ zQn&PjI8oV__IHyWflsuv`Il1zq;3EwmPa~q z96h|bi3!t}1*CvfTZpm>R0#xnC&1QF)5>b%S0=9<8cnMpJ(lKot;bS8&O)e0*H%)u zmO;h|Jt|`xOUk*Omg{ zd3!2e8Kt?PwOHJ?ZddR^65jQxBXJ2h$UR4mWU!?xvuLLTbSEaIzUB{t63Fl5n)KDb zvRH8qFcd#yRNBpmiy)z3G!|426ber&aBXd=C7^{VL>@!9)PO^IE;!;tN!&Y=kytFr zOKRHOa--Dj!KqLs47Yn*%tB%2(D6`Dq@JYo#y)y#?3{3HQ*MHug)L(rCt8-seo-Bo zyD+Q)lh9(3BI|K&Yr`?pgmuDs)pknC%dwFWke`Me-H(Jp73~cv440Zis#f%?8%gQY zyVp{S48|l&P`b!dctVzx_CTe4xeWJns~1S{re3pee0lNNTWpzX?NktefzWO|w{_+0 z@u-_nS0-zR4ouFW7Rqg(I2#gTJa-UzAd!+!EMqyR#pwrEVHXssDVSIK3dRW@vG*!} zuQ+vm;my(&y7wu7{OHDGMmxz~)a6?WusIS^p^s;cM5V*IrG?2WmKxj=WMM@+&oVQN zcXX<`B$K`fmY+0~lw#YDWH7>>mG*vQ`2&&kdK&lUk`i*bPY-Kk)0DYaDC3Of@55bdV+>77(h~{ulZ+*dkyeg` z(o*&Ow!2G*nKdF>VKQ=%lCqrh$n}bMy>OoMVztk_T*SLtEz`}jW3PQt_etiq!0Mj- z()ZJvkDDrUOnq)({-zR55{{4phkPhUFeom@rD*NjsL> zNe7>HYHEvAxelyGRLL7baa&MSpq_lr-hIcFGu=hX8>>i`^Gj^)AcCE~83&zKQ;Xp; z{{T&%G51^@e9*?LJ<%xKZPJM90dBC>lH}rdvu=4<>*$_d+E~TL=F--E)Ny4wD$0&C zQkw#v)Yn)xsS=)y%FteU#*Plub*-@D-~5hww4=I2MXft|aVsf+;x?RmYsNiC!2G=a zN_MnZ??zHrIfEUP9Fkn?{_5yUPXpp!Z8n+Gu5h&Tx`m?Unk3g;Q?D{PA=fYnZ3b8ejdnrwF%n+j5*y3c4_!>R5`=%8v^#H7`lJXxt!9X_3R{RmClNlr7~ zeU|%HUORyb7(M`wn53@hTl!WK9__l_@@mAF&t&9-TYs`uC*Mb%_-bC&z8*tpx1_At$@! zs{>f@>L!|M*BR)?&Mp@Ar$|oKghx_|A*`OKZo~1KhfKFZb=J#Kz$Xoa44uUE<>Sm# zd=y-_8$CW~y{-=5;D|3l-kS*p+i*uSkt-zoIndsSyA-U5@l*%b2e$!Q^&PEN`6v>Q zwp3I>ZNNs=U=T2WVxWD5R{cFPTx*neS;uDT!U$13^HqvcSK!J~aCFr)VOkdOve{bT zG*`(xoB*Gewl$$H&B__M+Y(dokXCtt-`5>+@>Hvb78W&bt9cg&)hTI~%qG%LBBvCf z3P((Wk@MB@t++3zEOs4BbF^9S5LKq1LOkMf5L%wDNiDPh&sC`N`xDQlONxiw%0_Na zYUP~y2TNO+vdD)v_Z`P2VD3*wz&Rg1HJ%>F^irK&ZVAsUD1tq>sny2Vme7SeYg;Kw zIc{iy8o- zsnwSCJB;PQxD50Hv|Mx?TX@CB_X!C}BeW>=N33(_Orj)+6I^CoXCu7Zps5Q&lAs9% zInV4=pO&2O6Ca%t)RiN6dpp7CaNr+s)nT@7k(Na9$;Mryd`%5$l-hd@N>tjEFj|JQ zxcagxMQPHSe#d-8NweWz*yG<`?%^=djI?FB}K$NkLe!O7R)=`lu z(#&|Pbxr&Sai?%x$0#YNHiNN<*8QcrujQRxO7dYVJdHVT#5#0tUBB79ShzPj_K z=E-K+d0`<(w1>D2+>))>&OMc5`77zWPNLWPe#?G{9fxthvl?dHWpU8jmf|vb`al85 zgUYUwR zw}1~r^{3~i?aoWr4W-vqqPLky&oS^tbgvC#@WD+y-lI6wsC{9VZkwF9_GDlHl#$GM zR=Dx07)jR!Nno_W(+NY->@y}QP4jWb0ZYHJPTD~Imq)oJ$+Gl)$hVSqB0)$V9Zgu1 zAxwSQMJ*vjNm@6-Z1ze}&O0%WKzn>DJ8)&m3Ji87Zly&9J4)0_F`iidohtW@cG0)e z>SW_6!TsHES8^TU!*aVRI&SF53ONFA!5+@~e0xps>6=S;G{TnqE_6M)C1<%fCltr4 zEjNYS+kJ~1^(Z&bWLFdk&$6^T9ZhJ_Jgi+0j7FxmdH?Bbpcw?_xklOU+wWTI~mxrwvLiQ=gBya4`aY)Vq z_13-*A*Li+*0$}*Xj~STOyEpnk%Q@h-Q()bU3%I69LZ)UyogIx-43VS3GvXO3PL;E zX$t3`U3Ee*inh)u@0`83t8A(#z?pGMMcYC`n0f-_j4TgTM=oPY*rU2;@X9*MkVaDe z?Y_FSu5q1hDpHzT8&Xxcq@j3+Zk=x02*_1Q5#92|T)hd&v0exhIAZ z+}{UoEe5V~*&K4e=tnGvhu7y`h>b2{z7d9#+WIOx3FXh#NhaNNOHzy|8Zi>e6b4*( zAxEY;pBiVfGb#nzA|yg`I+W{cLvFTGuS<814hF(LGg`FsZLd+nE7`fX)TJkGbCOBT zWf?|%qdCTS<+mcHSk^s0i=!qd&i zDF7fN0eR*+_hPJ06LAV|ozpi5r1`M2>G(^Ii&F{R?zGuFkX6af9WP4K{ZdJ&u>)cGM}-_8VkLvGmohdZw}4M^dwlW2ZCJ6%71T zi%OMh1xPJvy9{QWu>*t@jR)n4bYlOpL=B3-G$Z{E&SOaMU41{F$JjY7$W#Bfvy0abZL4zsj zQQ;wp3MmSZ^J-SrAF)bMRm&Xfslh5aXOe01Rn2MH3JM67XKQkaQd@%FdUyIgYeSl0 z@Jf?$j8qN)5D-Vq1wWLo42Pn~Zx6+J$j&c$!j{^~6h=F@B-fzOQiFvV1o)C^?8SY| z)nv3WHKwMIhc-G@f^+5#0gsI)l{Kao`EPEbKvB*^aGC&r(eNUl8;<CLC9B4pi+^yy-jg}{ zmZf#Td6FWwG5-KYhct6(M)YcFTaZ(+AB`8-Rl_>XQ zER)ayTG*8#nFx}@8H1u$O~q(d(vj)7o@YHN07zDI=(JKqlg$?dl6tt6qGJg$CqFZ96j@b;U#U&evD!@FtXP;i5gRMduK@Nu!tYtuB z#;hwmX%_{@g%UfjNP7Xc(tZ&f{%mLBuL~s9Ewj$J1d2^>lS3io8 zu=suAg^i#bWDf5d_S}>Q`$k75&!R}{T@-P(N2v`V<%RB90H1^C{M~C&TYw?P8^A$1 zD)_4s%!B$g2;4*d@gk;sH7BD5mF%xzHpFBwPD`ale7Wtx zz^xJ1m+;z_pG0#$CblwH=Q~CgLU~|&Xw{=w9CLMaJ#~I(2wv=G0P9Q;PObM~m| zmqop;wBDZ6@U)E0D!Y>6UM(V1tC)?eQ^8nYuzH3CG{bO!mm6~gl6fee`tx5LCht3oC++`1(Uug_t;!{EBx&8a&G z&OMbx%~?aHIruC%;&Yz9naAL(-pYdVN*Z3(6t4&3?*5(?M&3IyI&@@$c1(Eyve>@`Ug zxTU8G2})EmR?dXtZPP^Brs?>03oXhe&Qo$9MCQo~SWi=f=?rqg^n1w9I^l8qsT#k# zp(COiZW7gKST^$|)IuvsIF1%Wc^kaP2F*$vbl>> zg^20e+k1|7pm!u>06T!EYip?~*yBVWgsgP~*IiLbQZRPE=tTIL9Z@C4Q5g>~R8$8& z-Zcv;N!!cd^s5VtNLOWUSWhJ|-~+!PRe8IgDy~IFuuU?3!`YX}mniP(RAypgxY^h; z>urSPYGb>!N#)3UDrdz8R;hM7qllCdaJHpeCnpn0LE2W}=t=ll>*0aQs?9$(Top4q z-6i<4yL_t`MRf>k zC{mQH;AigFjZ}pjE2C!M7M^+Oo~FFV^xSN1#&8F+lwH|UtTNZJSnPuSI^H}KNp5uc zD>Wn>ow*?L@uv$$OHr=XDT2SQu_gP&vm2?;cX}mcsQJuBbf>6dDQ~aR9Z+{KnfUG$6oG~^#=+-4up)SZZHTVu0B$JO1u(ATPw14sBSh{ zT8U3sVxfzBO|;udZ$6R7q*b1|rVblOOFDmv(UH8DAt_k@06Ul7uTa8Jw5S}U{N}O4 zrJ*u-i4AD@c4tT)uydc9wvS}Kk2c_a?7}HgDoaFTJ_}I$fKu3-@SsmlpCvWv#f541 zJ4}!k>tmOK&->}lGWLw%16gG3w0J_PJ(`-%NJwwe_0`YxGUb^5S5YE_0GTPAGv0Q< zlzM+owMwW3H-a2-&B12wUc1WmGeUyf7CC$Ur$hXSI)7|U%tD8S4yn8-}-FaK& z{{YP^?m1r#?d#slio#M{b;HZ{)%POn{jQV$05q?-<$N)=hJ!(Dq~IxIne@IFjdyEb z-iknQC`yu`q>^xYSEVhoK|*na5PS`43Q#-|1Hie2 zt*|n$MDoURF`BwKfX<}Wvb@8Dd|P4{xo}DZ7$w5X%WXiY84akmm7qAvb{*v%u-rf? z#Q_(N+Q;2{Ovy0q0tKb`h@|KLKJY5YqQ3F4cc#s;uXJA zTwjvKt>{r~V%GZPCD{(C*AJYlET5_ckB5(jkXMc4($VFFW3`_x>)Kq8Qw-QsZ7w*q z{-RzJS>Doo5xQOD-y>;jimr-*BI_Xq*CQd2gzN>Ol`r8BN1kdM zxp2zhT_VOUDrQ1=7dH}jd=r35MsvuLDAK%B&|14eU$hSrZc;SzuGcp&49-M%Www_b zbAH7ow3iMDujx<@Cc>2-MZ`{y3pZP$++mBO8EkT)C>abC9rj4LGdtfZ~x+Ihsdv;>t9a8e34ZVF1h5;0r#rP9ZA;MycgNEMN-PFHzc)!Zc}P zA;WcD-_HzWMRcVo9aY+d6msz0@e1-jpER*!mpndCvwo?h$E?<3PA)S|-{;{Kt<_Gt z>p>YibC3@&xkwxzJjHK}I~E zbNVY&4K!!&%_#H3{{XM#hFSGStVBjMc9Llj-jg%5^SH-kmAQurYqU~|ap;8{bNZe; z>u;0;w)U!<$ppXw-B`EKGGC0p^OYv+lO!# zyVGIa#5-z`Fb_XSVxX<5Aq!4QkB)Lr$KUO%Q-+PSo6J?Xf=9V4R!4B%UrT{h>2!W& z87x;DI!93I8)mz2PwIHQK(y)GbVguCzgyIx)b`5&wi3dWy}g5^3@htYrGw0NbxUjO z{JlHGhp%kdLqUW$v`cU5Z@4>6&SQT(6(nc;pRSzlCrCMH{{V!qNVm#q-qE@KVEnX> zdH4udUtLFaMz7M^hf-PbMoDbPkcSYAE_j={oNw_{yQP7{Yy~;GtI0W?FRLR0*yS(MloDTf>n!l#TSmh|mc|70Nnv5C!mkB9LZ#B<1@;X6bYKt}H zl#QuvC&MK2uAkwx>d~h43ro~(I=fu^V23S8NmjwLAwfOl99J{iVyWvr&O)T6uoS=m zr=iVs6m=##S#o1$L}a0@=t&6NHu&UY<*%SoP7Sl+aX0V6noiXl?h~(99XYEe%etcR zB2y|{7!k@`auQU68CrlRUT;ji3X5nM&>>5<>I>6K4qWbOw%X&7f~OR;rRNe) zB9?;4-O#CH832&-txu(Nr1`h&6IThdiUK0r({GTJhclFwJnB^1y)C4j!@n6g1~FsT zlH)yOhjg=Prx>(|@Rc*%_nwg*meho)#H=_Da?+Ncsf?8zWa7R&*FkVHr^BPNxq>QaCuWo|WIGdgeQjpjnT(j4udpU8!SYGdg#nEq$vmdtU-)3(Q zUf$4mhi1xZ_i&Qp7Sk}++S6|e=Y{%NN{A3ni6y zuaKxLqb)T2yx9s@(b*j@cL`YjFul!0#F7-QQ7` zTH(Cg3}&yl3AS00vdpP1HuU7lYi`^Q&n>n|=ge|YIL-k-5iLGQ!b#m<2kqavX(OH! zjN>Wor_cQP`5`<)vuaBwu$GNeb6v(`>Jk$*Pj-S!0PI4-y@)BtQL>TGZAgiyLPk4v zDEhIyQ^yqbqBw`FJ=lW{#;wgqL}+SvA#S!DacWV>9agoRcMYS$o8_U`QKh?71SBWX zBmQ%rs=kXsyJUB+Ps#mxV0zrYPVP6^eMjO==FO)p)(bNTi6X~#H%6v7u1n>Op29LI z>i+=5{Y}LUe9obhCf%lO%)c2f!&9kClF2|wWhznHqCyrzN2Tdx1#JSW*Tc(_vV<)J zoE+pNa_*#Hu+WQ5T`!o#oCkk*aKpuD?^3E%N z67@azO6a(HLgjazaJuRy!?PDD-q5ngLWG0UC%?a+g%@2-7XJXm2)FsLU$$FVc04p8 z&;#mWr%83yHUU~s)rJrf4#cCGTvtrvyLLv9~MSZ86}K0Z|f(xDB*zAGmp527)Ql4?`Jt8{J3c`4f_D7o_exYio{{gQi(x14iDt3+?wWa8u5y%w;@)NpPekT(Vc`)8J1+Fffm!~x1rO$SIzg3j{7a_-nl#p@tKuXRB)~g=0^*&duV92v6 zV@}V~KS*ly`hQQF)=nxdHP4Uq{F2+FQ?0if4YJXx8M1{%DrOg(DQdVZ0lg~0+5kZt zNhI&?$xU<4v`z49JIK_H#ZAp}7SrBnke1WPY*T4QGBJgN%OPFHt^1|_076{umTgmg zx!f(Y?G3btV!S1L|$9YsLzW2p!q!UtOn5$@xU(OmL4QRNSXqY_@sL!j8sQh~V~;6cX83UKDrj z!=8$M9`y9bJ+SA&pT;K{wsvbo7F65YHk5hMZQ|krv*~&voSwV#eWd%fqS#3GI14&#iI;72d~L~2IP%lxPa`{)NysoxMoucbDQIbT8(g&s$TDp2g zngc$4cWPqP&~FH86qnpC6X@j#$s_#JUq_mwhU(9S^pz=Vpw#xipMz$j^UD^9LwCD_ z*9)A9OrkiDl@%40r?eR65;g^#6#y~@X~INJcRx;9Q==!wV=xw(A;$M9&FMfuPoTY| z?r>+8GL!6#UX>C|hp*QQmGbR!D@zeuYf4;LLK{+mDQmPsP>?qjDN7+J zH=AvW-pfjo^{(47GD@Pl8g0^uyLPzaXiC%wSi*O0=6Z9lk@`%TV;OYYe0(3UOZ5he zN0T#BQm92HnzsD1F{xzh89Y;u2VGnvy>*HiVZy=?mWC1AAt?bMoC!J4uy<4@0*W;Z za#BLP7{BOn2|=O7MVtaI=fuMpOzbqr$iR8S_Xc*aQd zk4pMIJ{OA`PqXq3Zl~(=%Qf)XcWHMoZ>jA&Ws4?DuC}SqM`Z;;#5K&kaqvgM&-t}C zw9B0A%W9-vqg$<(_YoZ|B|)D*kf4+y1xw_91Arv;DhHr6$ENO0Xq+8Rp8$SWTQ9L8`t z)?T58Qp3tUztP%{q}RF5dt>E4B8wW|dgFDv&V|^9%ZrAWN^%=Y8v%TY$x_3rPJXpX z6$ZM=m8p0?dYgBBbEiaHc`0?%xS>v|2Wor(3&tu*A5%$P_UV1R+a<$;Iyz#v8N}v8 zZ6_s8sT;Rsm4So3TTqmeHtjGyU8?LBZ4)C$X@@1;WZc#Rl2-tgKx)4U*r`J;kiEW| z5*31!fr5H>SA_6tH!pEN6n>FEQS{ZN%M5dl-@e!7^jFt(v+sJ+f>cr(b+Ub7MC0Tj zd{rgkLbuy4#Y-t#X1BMrMo==IS^dpMZmA(?{YtZGFq+=_T>cTDxv)*%l3|I}Ns!x!EUhSx?t^r$0R;m&W~dK3qp$ zO}*bRn;zuKJ0)R7gscQB1CmHmhI|xizK;8ynQSQfJ$dJqd%<@K*i?k8a0yljSBS3e z(Z?va%RR|^&!tGXxZ4dGk2x(!U=Y$&>Whj9&rk};_T+a^+k`Bv2q}~vR2`8OG(H`QW-%DR(bLm zIUw}SX>&`}PxJXOE$nQ*X(t@(u z6cVmUWw6>55)@G8QW6rn_3=*}VHG3cr=-*^UPT2hvb%NT@JRKf3H(Y%r1!1G2WMNN zM?_bxHrJkQm9ksd=njvmx?CY-k(>dv^9G^u+*629WoY`YTqixppCjHW{f$+jv`4!4 zeFnSb-sL%!#)B0wBs9!4ETo01L&;NWM&bG(TGUbi!v6q8R6f}ScB^zaVq#Px#%Yb{ zP660}oz;jZob43VN)wmbdLDxe_+u<{PhzUIPx3uNLQ5{~bF*0Kp0v-ap@F2Y z%%S#i=7mZm^f~ED1fV&PwPboq08)F|W?r4W7Lc5Iiqx&(WSrL?MNoEqG!m0VapctE zTjFh;l{Q=Rr4D@3Ph#Qe?a#|yV3$&)snrCfN>YN5pJ}c>;2f_v;suFFe+u_SIpyNt z;3m5D@Y7NrS7XSnLwZgL=6TmPirk$H*y)L-wiHs0+X99P`r@>>z)J9?a;=YjL?tUb z(0n=8mmTd>l@x>R73j%7g1^Qlr;-Nkt6#-Qo_lB;iuVK0m;3A6(gRDu$p@}E(pf4B zR_0aA^#_+PjAZm3$kMUWxssSq!aYkh9S8s{4<7 z#}1?`vrCR5V@H=zqMrK0Be=7p68_T8WF+rvB!E^kRz97$Otw89eXc`@kkV8Tq#!Lx z+>(+&J@`?TlRpnfc3A#9KmbETaXo4~}w&Iep+7*U^ z)R32m2`d{;NY2mU5d=pV#fqk~f z+-@(R?mY)1_o^er8138iv>!HGuchmfopNf+uBuAUBBi=g0X@U7A|<}x;pT`Stbidb<+9J@#7-m$F5uhrzug;H#s!T^G`4Y&mfBg4kLAdR>JNr`NPe}%W6OhKu}Tp9QSu~14=2Cfg5mF8d-sjHM_LwhRopv?0BdxH)NbFfSB&%uUNzYO8)Oyi25gIw{g5=YURml@ z-JJ5xEC^1X;bNbQEw*H8DPkXQ+LQp$R@DHb%z7bN_8*VNhNCR7Cgk@veuVuy)8Xp5 zV+>LDqXjO1p#kEnw)t>kJ!@O8#cE5eGWv#lcGI7#f1S6G?gPIyR)p+YlzI;8vpA`A zv!=msw7|H+dP{E)sJ5=q4+D|V@)cVZZtH=bweHEaj+^BC<5Q9|%;g2Zy34x-0SY85 zc5~fV2M%~gKUp}5mq7FzQ=g%@k(V7k2}n5fLC?jCrY+YNU=?=FZtYXC7(EBBuC4&; zsrRjOZnH|d$Xt7L2b*R(h8tlUvQ$TT$;VHRzP#ObT#&-$kFvNnK{NazJ~M_ZHXF{b!u(?8Ri zDEeNbG*WpZ%H?pZ=J!;UDPy=Oid(1LQf}?`X8@sD@%Sd2afK~loyu8J1G_Y;)~?Fx z!^qBZQ}U#bzh2D0m7kkQZ6s`|3mrLy9(3st=V2qhnwV)R+=VEDm5`!3=A7X)D~{ir{Bw~M|?NNCfjF6pSb^i|uul09IL zznXB2(B@XWl%2HErHhT}`7NnOb2FSuIrPmuG?co6ka2^!`*Bf{sMEBK%k)u%_mC>p z`WRLfG*+LAetIaRatKAv(fmo|)HJ)mw|7e3Tu z(Iqyiq-W=@JkI$o70L8s?ftHk{{S?vxb1v0wq?kuTD}=1k@45u+qd?*RzJNf?m1r! zElbQ)ZzDMH^$P3O*7%vgTShfgnwDo zI(K5B)+d)9)WAxJR?fa0>RqJ)a?h@uY~>#1EH9sRR?DBRDU) z*&=ym;I`DEf$(|q2Rk7O?1P$sNxpNq*?j&2WYfkJOR`^LhuQU|^IplI46w+^PHR$?#eMY^D z%w4;S?hN--??euJ-BXC(oOW({LpbDoK1ybiLf(1RC;(P=;MUaYDCjCEXt?Gu6r<9R z?+&Zb$E0#`-fJm4c1z)KJn2NOcj#$K6h~?aQh9A2B=~x&=)4dl6DMj=PSxP!BqU?e z`2KpMEw>rg*VOC>gKG#mCz$2WrAwdU zBaO_qryNmImA@!ZBbiD2-mhDNEqFW`2HG>*!a14)7ItbsaBYm2BWD-Wp0(FO{9`~^zWooxP+;$lp@~5 zcJ}31c}JhByJeL)6oP5mHe6d$TN_doK;@CRcOMR!N`6X?-3pnB%>WFIys^*K;CZW` zjcSvu6iG;I6%u)7kV(0_JSTbDka?!K@@>0C>TPn&umA)&-V@UxVy&JLl}WmG&8Py4 zdYMR2=$-x@YN~B1TX{>MmHHrNp6!~N^P*>3bp@^Tq4wKY*y1-ZvEZcl{B^z;weB*U zl#`7X{p|oHMU^MCZ|l-|{M81!$4Go--N7L^M>Dr?!Rg>Jj(oeRJnk~;OS?o&ZpzZ# z^pvJy?E}?O=^C0$)h+eUVJh%LBz@Y`E?8ZY6zZ7Zwu`b5%S8?^C0lxA9%rXcgZ=dx zCB?07gajxlX-Ee-Bf68jcAEN^i9;O%k&toi6_~CkXmKv>0O04wxouwsoy)dK>^mK0 z_>QcUK3ORw<35)&@mE4mWii}bWVq=|ZJ=S!MJH(P@2+TJ!ri{&TJ*5fXv%pMZaqP% zlpiR4aMhMQren5g4Z=@k(x0{^Z4yDKy9akgV1H4rBm_{~P{I*R6^Qp~{PYao&v z3CBFua^;6eyl%M`>J&WO=!tQ&lG42(Mh8>zoRxL)KD_$VkFF*11A!!v=EII;Zsnhg ztuUGHxS-^T3t0z{H1TA8q~0MF9JaSXR!QZ{)m*#PaBFm^vp7?Pz|@JsBi$saKqRR4 zT)Y?r0&rxWNPjQ{4?u&x+#ZAAk1*J`u z0uzEfQV+yw^6$rvDBjv-Gj$we*rcEY#cdmhi6C<|-yKrfM)M_ct6*DuTkPCGPzTb=l5y$S>Ad}ByS8h90derDjNYD!4%tevrdb>676$ZeXJ-Y=3Q@YbJI8@ zkvzw&c;lX}db3wqRleJ)F0n`(QsZ+-BOL}wrB}^)uP@IT7rj?`n!Sle=jCr9Aau`$ zYrW=+;hg&G7gn^>Q=zZV7+aE?FDJ*fN z=4D`ao^>$b(TM$)bI6q+wvTeyrd(POu!S@gy&(J{laGs~Lo}*LMakBb6u&f5Mh7e& z>WDfVE}?CxrD+)6ln_bp<~>x!mu!<{$#F+sN3!4LLQ|2f6XeBg2Op5oB?u%860zu< zj31cu6%xO)w769x2-}hrw-BXg*?>FGbx;xY9;vs$dIT%=*)ZggU1g~XN>z?SaL=ld zJ3iqdXj8LaSJ?egSRW~_x#}Y)W>LVB<@Q>WjhvU5k#>y*0t}6=FA6JKPy=jjA7p(K z;sy^YuA(fh2`xEvvm_61B0AC+47DpV92i;jlyRP24rx?JR`E{70H-pLI&@WX z&S|?y*+nZ}86lGFR&{(tOPBdzAKbf} z$dw>QloHgnHOU7G=#1c!d5Y)FTEmfUK~JC~C~snj9K8WdAf;(bji?nkcVMp|pBxIl zEW0}*P*PNN_4i6#t&p0Va<<2d9_XLWuBvk?^Mqihnn62xDMQBx6%EY|1CBVPpn8Eg9~F2dB$T>9S^D$iThBCST=Zoe zc~f6^2$AZ!wwG><3q`<8Qer2zQX45tP7-%CGsuC@oo;OaX=$oX3u>N)sN?`n-19$v zqb=p3l{|$Fy!rA!7mZ3-jV;|9B}i>sRVgk86gH@UJ`e`Ex_liDd$^Y*lZJD2v}*#} znW&<~xwmrqlt-1ZXk(~+WNls#*x_dw3I_(S*ix@L_Twh|bh%oj-Q7Z3d(9qYproK- zDL^V5fW|=NPg>&zXPYGj03M`r2g4PH`!JCDP*75KgPvp8TEjYmoUoZM%Gm?=${ShtstKE=@j?r(vP(l)s@Kfn+ z+vWY2;)K-~uv8BbIZD*XImEza{zJa3T5T=hnf?fgPtj1J~JJ^vroPZc&?JE4xs= z>RC?EGCA|Dcl%tsb;3h$GQX-gRD|p&Demd(tW#y*D739Qt3@tLkBv(SqPG;5+aD$ zb!#NWTY!$Cm2&kQ3fX3HjWuN)FPo#K^-i+T_T?CCYl~Eo$susw3mq}YB%j%2p6aKy z=AzU0d&FU2l_GRV@%txVAfW|$_$~7#NggMiLd1CsBM{te3FH(QP#+&E-v$KYq1eNa z>bZocu~APy0o_^T%<}e$gd+}9B-c!hD{GGHgl&1}5}s=;{+aco+of(R-4 zkvKf_ipEoyWt~j4<8cp9K6B>RH3j-bVi5rM9Bm+0!>=^qcox$jMYGkP4&=_n{@5!UhZW4EDyjd%B(t_*UCKB zNjb{Xzm|QUC0%NzMjqNu(Qw7$&kxdj858b|6Y$oUia7Zd&b`Fqw+%a2T7La`OKv5? zl_CKhsoH%KGtiu8*;LWe+KeQVZopcw08q_i-o^P&r!mu%^8FDbAAYU%5;pdsTc2gh z&l$LM;BCoIU)R0B-b;;-S8ENjawPJ9d_m z5;?0bBo9~3UJ<8nkG6NVfQ0vXz{M7-Ymyc?cFTzI%ZIEsvfh}~FBL1$N~EC~Pp`i; z)vCDPWu0JMqe$s1j44w}TYgQ-aC9M}o@qi-I(PzVu=lria1^Dsg2y~|sp<09q-m>* z$x1s$Mh_(R;2)Bc)XGt&QN}6SC7cnG%w1=1p0ud;Q{pHnoaAF+<=vcg_19?JHmYmQ zB}9Z39DH@iTs5$+(WoFfAx(wIog82*BOz$VKVLfQnNBFoboNOqTGZQ^Jb}+T>d?C6 z%TUCQ&$Y5v#LLCKq6SJ_d<7@sq%L1{`cSj(^}k^8m;UjcJ!BmIeKAGC5{oRIw zo>*G(kBL01m83lDM0R%=iP(1f0Y{(2C=(PCb8}Uh#)f>6?y?lM>H(jPtL|X=y@9-lUGCdn%tyyl(!xu&|&(9fH3FDv54s z=UbB^;~nNU9BfCyHH`CIS)z<$_#!V9COJ+>%DGaAdYbPDCAM4(N;+=t$4`ovPP0Hu zs%@*gWdU5lZ1OaeTJ3zpmyn!zGNLPm+vwdtk-?55U!v_yc-Hl8R^h#^-1=wa1LUU| zoMYF}-o!=Pwvb3lt>A?FGfWAz+5q0Gqsk!i+Zf>1?{jShL@HF(p5mCK0rJ(;oH`QO zCru;Xq}SS`S<8(6qMpm%Z}m2i)KJnJNj&*<&n~rSaMOrZjVWiHXu2WbrCgNyc7Qi0 zU>|%{VG<36N?3Y(>LWNp+uNR0<9dr{Y3<9F@>Wxnr5!paJkP~Smu!nny5(_mM!kiB zC}B7W2fmO!#ceQ7)UzuDchw%DXhVrRr@8DRy{%E)B~8Sh;O+wzx4hRycB1H46>JDW z3xg=2d=iCVpB&ef@uyG5!D`bi+7t7>pOIDc;8F^_d-O!Pq?`2IGN*jJVigS4`r*Dc= zn&&M9<8d`@hD2vo^;yVH7IW1qu9I!D%%l~#32EKLW7kS;ntNV(=4E%+F+$e;cgio z!Ro9%wYzfc>iU_uEK+AAYx{HQh)FDT0BLa2xg3xbW;; zbZ4m4PdvBH+acNA=zu^UHE40XuNx9KU=@mfH_R1?aX<=m#oaZ6jr=B;NI)f~#a4JC<>t8q%wmpTo-Dep|)wKk8t zd#|S6TuI46Z4M$j6n36i!#6l7r-g2@-lnbic9#6!8cRuU zvPWjx2s;o8y%t*lsQquO)8u_S5!CPP9U~aVd%A(~*Qt6@hS^-mkGvFw6)7q?=n1RG z1SHdIqgd;6#Y!q%OTWnqd9*Pr;b0W)#chb{o1GY?10AAs>#q|4a#?vqou_UvC}`o< z$UPPh&sLMEQHtlXO4-b}@_rJ}FOHod0qG~FG4WGRX5wFPBxPzKkB*&TseJte5zyfC z29!VlM@nRFMCwFUZc`D`by$WiKt*s{s=Z-{mr%MaI zZN&XP=tG4vW4hQF{g3;;dg#R$T$oBqPLR>3P9WT)Y&(;1bo*)MAv+G{_L^a`yz(U7 zS;~UE^&cRF5w19Ju0lsc5^W zcKmJrvraub^N))aS8qyrDy>f;pr5D1hFelLtKE)&`x1R&HE7W@=)K?jTPyx)Uvb*_ zUu1857F}OGsmCsT!oKKT{{XeJzvh+q9j}HKVf}87v>m>V4iBhTcC{_>Gl0At9OF2z zNCja;FJQstk5zcAg!YOE#^R%ZDu~dXXmVWB`rsUZyL$8fa<_lFs`Oft^fup4P6jY4 z&eF|>Y#QC{s1pGxPlv%gsvTsr#(o1*kEUcURmKRP5ehusX-*{xQh&}+2jZqV8Zz${ z;TA=L>dW46W0btnRv!Z@NCUVhpNAviT+R|*4ePbjB0k_tY$;A9D;UP$zCeo7Z8H9~ zNl?$h4&xrbyHfuEdG|ou342f6TU3Cc*>Q!1l9SJwJh9)J#m7e7BB`}KVxE@XWIWkR zVM^@J*AbsrKWM7$n(Vgp-qc3UoSY(g+fGF6-B1`00<7Tj`M%{OZrLF_m@3*x_#s<` zJ{wGTQ`$6;oSYnT2Oh5KZhkqA`D?E(^F_-f(#?``k=k|*C!CC zdQ+4MPcrLiX!=C+=iO6VMT#4&GrlSxl`S{{S;AG5j+LY#yP)3Q%FxAMPSL*(Mz%2- z)GHg1Q{FSutr@yuC|Vee1~ckHSD!XdRi_()`F?Xr&Xk?A&J(AkEeb~DsJGO2j8yFW z8T--fh*{Z;WR(f$J*?HRwsc5fa$ZwHWc>(I_&*mKjJa551>^rh5#g`40qVE+bPcoC&+gbM! zZ(y}L3c=@+yi}s;VvhmOGnWXq`Vuz+FhM;%wH91n$hd~GJ0)Yfjugu#n4z6HB}yf= z#w8<}O8QplQQMDjYtAHxI|c6Kj;9so47YMyPI5+0DbgG^63}#{Z(d0!+G^3p$r~?m zZL%b)Qx3F(;mWcGbJOorb9ScG3d`YO^gDV~w`xj44taM9#>9?X!SAES*JNFEMNw@= z6_-$U^2tY9&$+EQl2Nd$_LVFVf>ai!aD&X8b+2oNgXuMZ4>62YTnKY$jX;K$oB_!s zC%kOwPWKgB=G)qWsSXzyK}r?NzrP(Rau8MMma~ps1t@K#p=fY}%Cy?jqGJ`=7B;9G z%Z^;#3P0rVYbmotCoSAx_W8X^mV`KRyp!q!@K>}ljh=#t`0GDy`6~HjPuxhTa3xaY zFPHbf_t0#S+E7uIDJjn^Fn;fKOExxvkdl5X${P##O^vQ($G(lfK{w{L(67wgL#qQAc_1uK~1R?j(3%RaP79A|`b7Q_FPo?P&w< zQ>}(HXcEkyG?eR^0UNLaeRTKc>QWM-HYe6In%t%vE#U}4fb|^I`z2l3AHG^4&Uj2z zIgKo+m6Rzw{#*(|blebuwYz}??&aB^zf%y~YHza%AbfeRNsQ1&)gJteoPXO^jwR%> zQj#IQ_hFIgLzoA8%gE{M74ANmg};B9+#P4@lpe>)Q`j1M?R1V^wb~`V+D;1Fhz<{q zM|CG%wbjWHe9hH94$|Ldpsf5@`<0T*it5hC>H58@dmTQApSTug-0c%@xfJribGsq@tjnKiwu zPL%AnuSC4-!914i^@MJxz}GH>`tx4fj+H1ONKhSlR*N6W$;$FZlV-J){JoC&EhX_P5R+Og?pkn3KN9WI3gf)kFXpT&xmj6KXnZ;&m~7Q}li zY$bRq2zzpmsGkaKlLeO)U2{u9N|Z?C-&iolR1!jcRT0Hq zqON3c+tIrT)3)Rf9p<*T8R*ZY*w#yF!OrC5k@C~>BOwRVAw$E$y`nM__U>h}Gqm&` zsYX5LAR88O|*;=;B#0^ zM{+R7$FNh|i!7#}L}%Qo%^WIogLi*o*cF9aZY9I{{abO*4WmCbOB%M9@>VcY>cwT) zPm;8xl8`EWsQ4=8{E;T(TpCW;_Xkp^GlHSYnPuH?F(m;aTZ>aCKUGgZimU+)EhygE zJ5NDS9a`H=UliWef~03}k1C{=(&|a_J=}E?4XQQ5GfW}*0}4AZc~*3*cfCd1y6yGo z?6HtqK<2a8KOi+5meR$J3&~jkl_ZZ=N8qVn4;*P0r_enTCWR!aIU9yf54WXSH6skt zb-@1Kj(N!DdZ%BN6L!M?0KsS;r=4tXOxd=ii}clwp*^@NR(cVRSj|irxLKD9-rLfy zg~;(lM{U3lHgP?s{?SPv3#UqWPNHG8?~4#V^N3nrd2oVC&JM)kT>$0J6{^OLDP@{e zhznK=GKmjdrYR$-OXM7N9W&jN*1e4(rkd=OZZ{z6)KVKV)RDWmXCB{@tR}T3y_K}v z7Swh-k|ZT8pr|Cd>6GmqcIT~ci+{C5f!V^0zdZn@w_Rvu1xZIyj=O@t-C8^iI%ws3 ztkLc)te2rQ{It6CbzKyea%2_ESqP|Jw6Qy2VVkA0;WvX?iUfG~5<)}u@|c#`jTlLb=bf%-Fx3&BuG>ONkTz7k8?I#XEmTau7= zk72B6)wY}aNd)dFT2r4_Uy8Y_nmStGo?EzU8tlxrtrlyY&&(njvx`p-(UuZ_MCP%9 z%=5>0#vB#GV;NANnWFCKMD?YXT*{Olbw~>d029>*Jx@xoI7`GUMuLlUa#od*cY5sb zY2~*oVm!p4rEREq60H1HJGb%X*4vR`qf1!r}S}~houhRP9uY=%_JZp81 z*9Sc3TohbB9%=c9d`$^;l$TC2mYe{rawr`8h#;R3Y0}BUyEWzb(XD(txytjky4xqQ zKAVk9*W5?1j zu;Qkv_rj!YNl7azJNgWQlaBh)U~%P{`>m_!qaESCmSvV@NzqS3L*#}Q>t!KCbs6dG zrVUraZ7k)jYqeTK4>lCy97D$gZ+EV*EnTnW>g_jbvMK^0i*Kf*yLSD&kaLcFy48C= zDqD{sgO5qF00+?kBbUckmIb!UMsJJqQ(Qi{zAq4=xZ{OBbj!#=`obIu>+0oQg>`Jk zn<1v1AziYGCz;MoagK_7Mbs&HsFK>yNzeI2lkw)e7Ue9xb$Ry+P90MD`%PO*!y`X~ zm^j`YXI@;;T*6&aSDpCf+50L9XJfROa?)_5c9`xys-N-wPC2fpIi01|G{5>a1GIl^ z652Nm^R8`U`_7yWAr!-iMhBx**ib}MtfX466Iox!-Ih|#gnyPKz@ZS@1Xq~DpQ zwN=T~SomS6owud+A}f+%AUdX!c7-p%nqc8a5%m`g^#eES8-+2SXRx`#9VW$B!Uxt5 zPFc<=`s2hMTJ6?bwq0eanYOy=b|iPFxE*hwAi5j@ewqx9c4EbC+k- zT4~F4wt`apIW0Dow1slr%bzfLRWRUs*MGRcX+$!Wtff7`Vy+3(Wn4p(X3TkV6rfb| z%L`h)M+cThbJsOhT$B^6r=Wm$6%3x7)7ScV*4c6Wyb_}0#E8IKfnA{)1e|AAQu3i-y?(owjks~$mOkkw= zo|PlFMd!5$Z6JU#)L_(p+RT}g5fUV4BuaV3A+{SyDq4=r00w=1aBu;~I+H|gQPlHK zp>gC#QDNrPyeSJEMmn5VR3rXknG&~5hH)y;z_oj;79xjZT~-b~m5g~UE@R(ELuel-YyH&D(^{E}MZW7ehpe}TFGw%Ml8|tM(ESkyARi3+ z>H~0sWqZRBoE$)khOK9@S_ zY0hQEl_+N&fuRe_6J3u3UF8=SIx~ZS}7KzeaIl7|7rSy~-P$RnwQ(xyn)Bwh9 z8p8=qf%o%S-Z7Eq$+7>|hscx9p8mmjilLEnbR7mob zx#X%k9SKnwQ;8&Hvw#6U%4XiBD7dt#OIa&fSsRLp=bUn@V_sO2ZJ6zuIUSDG4yPu9 zqtx|2zF&5{FJpwS3L8!i+!LPfWjQNN>K5Rt6Xows5y1u;S8#;789} zC)qEyWF>c7MA#@^&crvr7lS+u`cSaR5)nK_wik#)>@z!>X^T|QRJ!g=v zY0YEid>Y`=<<-k(7`Zj@Y>MG%ovJ-M`Fxb%wRVw;7Jo%aN6X5ZAvEuuDmh_gyK>T!yqIK>do(U%6VxJ}hpWjp6CKypi1uZjuTs0eq7d)oy$YL$mVHv;SIHMl!1()-dOe073XOwJqCVCWR~e#IU3u0ycTYZ z(G&HR;!J4owH7RBsFNyFi0wNRW0>3Z#2>lSzMbzn7+N&@TAtZ|k9W09ceC@9FywNT zqb=vNaAySV>7Hl0ocKV#-%IPXG?UxEr`rfhdXi(w10JqpKD<(hTcYq1VU!dEo6{p9r4elk0}X@3)v@|UFB zPW2(n0ukt*sv)7>%bBIR`}3{Oh4H7QDW1ct?SLNy6to9U?a6Ys(ra_PvE1!5FI)6q zOT;dN^T_vN$v?loswmAm z-u}?%BhmI%$K*Tz0M~bgpSQhr{{YOBs|j>nMW<)b>&N!8SNzhx`fm4Le4J>Wyx4WDR?-N*>OjZM(hGlATwQ6qK_M# z;zXM-6ShsTxomaG>TQqCDQLE$+Q8b7Rgr}PGqC!_dO9p{$qlk!>U_8A4B2$qp(r)B zE0uka4GqOj9UDarNyH19+_>A^ZHP9g4xc(J?2;7f6_A`Ltw*0B>2sxAXS}hcbe*?R z>DbN~y2{>D5X$`;DMCk}pnA85f#d+ra5-k994_H)vsdcN?y;J~?&#YM!b_~R5tTmd z)TPxHnr$ctccZkNcMv)eQT{&bJy)#nQ6*foh1*YAAfa(>G3G*XfS@o`tgRpwV`w2c zzyqfuX`dWng}HyBo()c1-k}&`lcoH*{{WOq$U4@N=U};*p$i23TXi^@YhiS&TvYQuPjvpA`alS2CjcIWR32iwDASh)c2+6@2&2!VGWUOay zcI?18NzYOEJL{mdV))=z*}iDmVm+z7FKb%kVXjuJz6}Wtom(^5$Gvt)r~l-ZLhPoBh1_@x*(le=f0wV5+&u*xZ@zSsJEobhzKuIVY+t}xpn;(!}( zqC!#O#(p|%OU*hE5-^n#F@)}swbOaFMd6S=ID@=71g(ULFE_9-9BRP&zl(?Mj&oN%Y3evH(jCW$4OCc)> zLEKL>SxYW<#a@pw;a00EhSr%v9!fSJ(D(BnHEeP&ce;-r>UcsDme3s9R6FtCT9+3a zyDx%z3T-PFQsiwzXK37!lUZ^%YMrP^3Qsa=(G0YZ0)ltv#NGfos+&*P5#VSvbZ?{2awdk#1R8 zN}EpIyV86{arf(DZRZdUUZ3=RwnHcJ<`+i zmg{Z@Qse;Iopb~B!Ns5edJ+#RRd3XnHEOe}U$&+!cB3W)Sf$?4!q6o}OTocW+(rj5 z1_3#*mDK3-<;^K#i|GBA(mi8ErO{!It1MemPyITkBXyaU?FFh>hp1oGPf819IG2>M z9nzA~aa+11cAM}rGTM3bK$1GzN+331F zkW=1|nf-a{I&EG|anngUi@N@#N6nqa11Fz-Y!F=KgU=bMYnCusOP+3~+#HHjzF4np zX@$yAQgYBz2vB;?fMKAJB)cJ1vF zLwF=-cTh3w$@wW-bYqUX)5?yuAQc0*ktf3*+}4r6-vizt3AgW7Kq?zbbLus{7LY(f zTX0|i26^+|*um;Kj-ssbqNc}eNRb4w+8xLW9YVQs2f$-Arap=*A~0<4_#mYR zDnDDwt?aUW%jBt?v8WKFpe_FHmqjc-!vWO%6vsfrg#DI# zhpL>|;gjviOnFSV+cw)xNJv;IKygK6sE$J!0Q&07Ov7`WwsOO zU>-p2>U=8gxA2ze>KtwG*>SQ}gn_(|P(6MsagD({w6gk`X`axb0xV<6Yj@!SbJLis zeKBXKjEW(6>2z}_(};PX^GrD6daS3A9=glA zRm>HkgM|A2I_eqR2Dw8*WJ^k6G`0h(T2Ym@RDBc?@K41{;Q2dClBUbdxY``TQrQ_H ze_XSUdr0o7`goDdJE&TXy98JZo{$k`NM>qmj7edMB-QiyQ-<({YhD-h?HD zlsu&<45vJ{j=el<7S0VnFSKFUi)K4ul}J+YwF&5;4>C_eI@J9Fy4PA7#&TzNsa90#XRV2YDE+k~k+Fxb29k zaJsda>qpq9BP4o{O#0~b$h7h{xH$;vDdID3DTNfel>xOp`WmNr!*6oatxO3Ft)-?K z9srNCQ8o0Lt^+?FN?3LZ(*dmQX-foj>KD+Q_X^>^EsG19XO52A7TTK)T9{ZuhdrdL z0Qh%THmeTU7Qs0=QBb;6tu+u6m3FJgDtyonEI^RS?vRyq>Tqg4!DBNZ2GW(}1JnJ~v7XgK43!lSb|pN@mybsS zzn(hOeTN%B-PyWaCkK9T1w2}xajT3aHzf@_=M5>c;($OWp+re>ZF8rh8ZqY&76R6mTn%8A0@(x}^$(NUoMN&r zJ3b#ztIO?V#g=@oZu|TjIE7}lX=(Q6t&Y0#E_U?X8%&gq;W%t7pcu~a$z2FnerluQ zLn>C6c|ksal+nrW=6Y4h#nBO{x@%BRjFz^bmJ*Dj_46OpJVauP4uvK9){DJT{}x z)ULlZC(=&#dVzun%9FH%-ah zVKwCWK8d~yS`*4CO2R->XTWr+o`SOtQK{|rr%Q%0E;|1JWbC z8Q|F`wo3Vt$d9>Gt{AUXzo<(ZDtrjnN29F`s%FxXH?~MhR0t=L=Z@<1w5l#iGsg93 z&*^6Ix^>v~t^MvIxu)`jfRs8+smoG?mHPot_bEIb26_Q|g4ZqT2l61CC7Q zkd$r-x#?0}a7BqFnCercA*RmacBdo&t;)$6Jk5H!AqZsr zQSz9znyk7hD8J#`?#S$U3w|=*?2v#RaUccf0V^r%f#Kmu?hZKO9Ku3^lChru0D@@* zdy`EtrWUj(WA6i%5ATZct*tuD_k%Ir-us7ZNI?obii)`pReAa3xk&phEx1L=@=>~J zAvZ^vLWUB(+4ee|{rc<~E;;9~0CVXTgW;2!}zHKKIF8ZsW>C zuT9LC0&+Y770IWP+;rt=pg8mvb&KzT1IBfd!pN zw^9ik8^$~R8m_GkKR)FO1TqxtmF;CD;BWCO?yhZL^R#qhYi}sBv@L;pp7jdMx5@(3 zxk~Uz`ro@#Mr_(r=WM;pv#xt;v6Z3K$aS?QLuk(T07wet0R!1l{trBuTHZTz71%7L z_KQp8P`oK1+L!3cZqL6aYVGZtu2F$0+Qa+KXlubYoRx{wDpZ^(+yq9NlXQ{`p0Ft4HTu+ zgnC1AQ;<(RiS^Ze#`~OU+)`@LkP!s6j4_#QiDbvnt3!FwKr`Rl$tU*lUWaZjwgEa`{yu zo-juFzLDux_$C*Klc0)J9qW zprZj?H=yYu@e9P-SS?_p^xi?>Q z(pI*q#qc`Gx=x>8RWH+!F1%k+T$c~^YwuOG#z$rL;5{kt?aX>#O2F}?&7-Bf8Fe3>YyXhq^-nalB?%f&!bNCU?UcWWL0RdeKG2rR87M#XrL>OHJ667b zek~<4MmZ{@893SIV$8hVRrEUQi~BPE9)D=UxP{XykXwJQs%qx57)PQ&z@Cn@LRelY zoF^gYdsy+)(dC3PF-Htx67*@+9v(4Je`9|8Ud?9WtVzV9t~3WOk|cquRTHe8JoNPh zH=m8tE9Dv`F1h7?IBY>;W}AA6oVR_8ku8(2Uzte6Eo%d|DYNISd%YTazuhorwT)Ck znLv%;+ztC1%m~a7W?~J@>xWUKAVF{`1Ce{8ONl#Oi}GqJ69n52h2`Q0M& z+0Z?C)66;6Lm`&?wRwaLNEO9cty&%Oqp7_G?g^rx@>H{W>#OXkbEkV0? za^`&~5i$RMkFmh!>3&)I8NJQ;^KFg{3^NviydLRh%s){ptBm z)5uK|q+rRV0Xt^U2Xg7NymiKH?8+Nre0}9xM)<31()ZPKbR(2qr_;!@!H+1%bzh7? z9dAT`XQyQA6bFRmYfEe5DtLAM6yW#@A3v=?!93=$!^5bsA|tg@JM&yZz}T$83GPRn zjOLJUID+lL=n*(__Kq9lIxgj#P6cKg@Y$4)D`X;h_kU`=CX7^ktVt}1<*r-WTQy zWUGWP#*>~D>fh<4%WjxUTAy-`Bjxlu9vxOeJ_UD?X1&T$k;ut9B8@lv<1 zJ4f~)1>wVA(!uCp-ZcnA08eZ64Ui|nK}&PToN%R$lBj zVfd%6^w+$~jvwTf>*=*ydt8D#9h0Nc{W&bkwva)GSJ))=kN5mdCTqXH>-nUEBAb!U z*56KkWAyAaIX=odzU+j0JqOV=_jS3=dtToqn3Uz=9D#8CcUTrwJ59fFg>>8cXE%tv#|f;hH+mSdTfRUa8d%%&bsxHrvB2(CO`ZnH8P&*aPGV66g5QISOT>0Dt0 zd#Zvi=UJQxD+hUWerl@MTk+`mfi&!_`I(h106e#+9q10EcUGOy#MME*^^5B#POqri z>$%7r$y@gPXDQK<^*SJroUOn+XYZ@a9Q;?eD2 zTpXkJEt!Q~cciznzSEp^8YOU2+T&L_Eo}4B z)yqGgr{V0%FYyo7QZ=i}@6SwG;)GU;=BbG<8;)GHjG}NNf&*5zTrUfoboRGM-N?YK z96Kr=&F51F$-i{mO)(wpP6i=Zcqs|zh~uFb%DjJW=HZ?K=6F7j9+Dx^vLYF3VdpB(^A^Vxa-90PoU;=TUBHP#VK(dQpfVre!=g348D&0i|*&s&I`Zg1`;JfeLKWsgUS) zB$n09MJhAi)prhb5wS{dDwEs(GJL{~-Efchj*0->KE90bm~i_@3?YJJH_hQE`)3nb zdM6tq)xMOngjY@_)CJ@|55Wo)_S_)w)yfc4+18ReZIfk@jU$b9<@U~eJ^fIyG!QRtS1gpIus0}{Ne{>>T%%0Yhjc5EMAfrygbN8cA&>qb>52l@b zg|nD)v)+`{D*=nIRTqo?Av<2&gIfL)R`6oycwewwQKEZOxdwgz|D`8@&-WPp;=(F}o-#skB?2%X)a|308MJo;0YNRzcg( zWyQrrhNB*ytmg}Lzm^5DY~+&^m-Mq2SRu-{9n!Ds-7R-hk%~wKBWj{i-G7*Fh~o0aVq<6;3yqFZ&6&(vU_k*l=2YR z9&e+GBl{L$O|T&llF#MY-TR6nt&H&v%i+GZOGEw8YoNf>y8OKkA}~lx1%jO07^Sac z)-2h#_G8BWevDFGRZP$fZoH`nCAn{^xUK*Oh(n;Se)m-t;`eUwJ2TfQDk0$DRNbmi zJBfn6P~5{2FEm12qr`wfsohJK@P!zqK-#W(VlkX<*(l&$^-7Um>xoO5Q=oj0<~|ms zu>Bbqceex3^zB=dr%lfkmYND&MG5m63Z+Zyfy>a?{P^}e+V3+6c%~dk6JfZpuKjYT zz8cf1PTPh$i76YDj;sXx&IT%fx7187^{?xm=M%yQzDb_YADSw3T(kDb!bx7GvyG1c26&c&Vk%VPiO^PLE z0h)pLahj#q^u1D~iLT6+Qb+8MhZY-OqxszKxBl*ZJtQon%eWfT^DH5|&pA+2`!Xn} z6wS}e*PZ*=$a9sm>?h+y%Vw;jqZnDg#x-@wqK`*Oq1r4lxxkB8zk{jd7$qt}S6R@D z*wb=zkA}68R+oZz-+3@$z&X79J^GGU+?1(P1zgyFL<>iK$epY1o?nk8(!8j42Bx9hyM)~RSyj=>sT*IQ>pi;>^o zFqZxWjIcFwZ+^Hl+hy$8J>(C&S3fq(4{uvoE6sL$3{Tlwt$_UaEamFCtjO-QR-6t ztP#WEt;P3{VeUo7cn*-=-Dxi621D^WVVuPlf#7B3REhSKw^0&m;|6wwGW7OakQ|@>#$CZ?el><-}&&7h1mZ>nkQ1QEyk3MfUU|%G1 zeDcpUJ$pfNM2`1`b+T2 zUqGF1wWxhzDk@rpASkx3!-WaJuEP<_-XJcp+(l3=$yz^rVh%MVw19t4a01Py-K;dk zJh`+at6$=tcL{Tf$c5eLxJ9~!am$B#XfP7;W2CD#FEukk)zWh{+J`LpFOCD1Kgk~T zTx>-y(7j1mN7$)T2;ng>xUt zQz-tGw3o~ZMwq4c$dqf!ab0}QAv^5SC}WC<#_1C6yS~{{Na6XJ*-ni75kNvF2lK0^>mEi@msWV?#pS2^x`NYpd^gXhc3aHrI@LZiDE#6)}lghqcCO)YoE) zI-{X``z1MC7PX|vrZ9CMKSb_LRHa2HV6S!1CRbJ`e-cd^X=x3$PWtqVmR&rYYX}FEw4AML(snMt2t+6N@87PJ^HrSHy>72b-uVp1k)!Fvk$Br0g)<@c6>q^J4ces9<$T3^ZR&$>2ZM_Bq`yIozJgH z-dH;sTKFiVtmmjkj;*FBTZ8cDsaLiK1oB?;o*^us#zl(Cc>UFN-t~Jn!YJ%5E5)#zv;rNHm`!#m6%& z2A;(QC+=Ae38Jo(gfq6tm>UcD4TgVvxz|<*jK$=y9`y7sGuDv)r$ z6U?nWv}eMBu(jd8jUXLwI`9lp45fZK=AsyIbTRqkw>n;JkRr4P0ZMyv8honJ5buAx;329W>Ks``s=#R?>9ob33DKVj4XNgcZMec+AN8=6lNRb zAV*F;_(Ws|r5v+UuJV@%$-q3D{*Od68Os4(mzbH>Mfxi&z=V66T9Fx zBNPc!(=-Bx(KpfR42}B}*pT*$&5UKY13;G{dY0+LFo#HyV`Q_)t~=vhVV8||MgA3I zmvpzAU6J&Vnv7EsXKieY@iU>;pwFc|zhVtY#gJDj;hS6x-(%B_<t04GNkEU9ku(pu&_J4|LE|hXFiq=J#0_7(rB)6B97C?+zy@bz&se7DmD3 zy2Umoi{DvIlBXV?dKXGTGf;$G;S1l$eWhJ*4yC?uosn^c-P^PMEUagUDr!bP08OpY4K0qFb zgEJid0*pl#6cXCe#ze$iqB%zytMILgL9ytB1ekX@;#;NRt3(M!t{)#MiJ^UP(cyZ` zl$6-vtTbbxY;lpCRq+1afu{Hw#dDfum0sSQU#I!z+t zr1>cUH`GWw#!ZZz^O2bEXUTvfMh2PWshlQIx=Q0q{XZXZvDr|Kjil-Mf$3>^KiYg~ z`e=#2!h-TajO|DlvG@L#eDxpEXMmF;8U$mt?{goh{h$=l7QT;3s)x}RWQBx5V;7;3 zPvIwPY;MD!gp7|XJ&(oU(CdOX^*t3!PsSyCHO9L2;ZCxI`CY!M$jFa`=Pr#rsPEs2 zN(Qz*^X^%6e_aMNYkeWPj<>ttvR|$KED~pT~uH2z`Ivnj|LjXrZzLV zW(g6&*Ej{^6RE}G$<0^Lydog_9(Ip$La=@{rw5O7I5D)M>^bZ3;&Jzqveox2pwXec zcO=pm#sw&|TiPc4Q3idAAC>ng#Hw2+?Eo*){VaS%CwB4cNzZTh^gY9$m+}A3?rh87 ziCnZO>^!`cb~JV=lbNaWKjFDXPPO*=DT=nySIqeFgG&dj3bMY_K4JViLkX4)G53@s z=c#LF^8F>eHb?#T>RD4}yJ$pAY{c6?Qxv|5hNmjU&say3!>L1)?Gz%a=wt_VRw6vK z-@(6{eQZn3ch1+_LVQgX3#pwoN8Q!tl@(UkJ=OXKN9Q>l(p0WXQm+xzcfGSrDqVQM zt$YZtqL z0%rLNei$%rr38cz^B&d!)e07xcJ}jLW%CNBi_h0ClCDl_68nDD1S*opOV8tJTN^xp z+C6P7_UnFtST(R6YG_gi2f4%SwALCN zOQtRyKdNiYtK8mlDZB5LLvDxI=u_|~eTS5%uv{iu7#z$s5W`JuTTy&6-+=a}rFS<^ z)N^3CVey3hc770WrejJsyYEHfVC?*4OS9qv&&h^%gO+j{C_40WU^-vh$C;qBC=rh%9f1NOr@3=EGR`6J8;yy!0-WM;|^V zz7m~@MVb=03J2JHI(X4@wwm6iS?K{L zS=2daM$W&D)Y2%tjm63=D`vmH5~)!3w;n~mpZgF`)YLcDZTx}lJ0a3iLB#f1?B%wE zGNW70u~0bz8?6egTIp;o?6B(9S5eG4lNiu{TiWB4$yV*li@t^M(0kXA`u3hr6sam} z8bmJ_*-Ji{qHbyuvyq)$pT?Ut8bHob!PxTfDV?WiZ1Zb`O}rEKI8uMu(|q^k2XROj z(pOtj$w}KIkEZFIJ`CBy0u@ba9~iOQY! zBp)<1ZgKcLNXFv}r^C{H2oYlN)mxzy3S?uIsC{5XJOCx=CKT>Rrlm^|`Ri}*_&ICW+ z7$64ROkf@%AJ(R>{}z^YI+gdjiI=jQw!zxunL!nb`D10heOM1i1TaTCaV*7zUbH) zDknM+aaWc5=;k5cKymF_{Zs9qCA>jVx~vF3-r!1cu9iZN_ah)W_@=xzIV|%czTvm= zeeEqg&;kQsBlatv^md@R z{`c&KsfBzE+JuTTHt$#T`~`6SY~-=Rgpv(sLQKY>WRPdRcvYob{+sm9g+Jf z^;!Wn6)?jG`ox;uSD)8Tu((IB76-O1Ht=`UaCL$YOa0c^Den)NDgQ|MHiZCo&Z^px z4&9%D#4&knOik85`8td$S(kLmZ6*em$Ew@Bq7#RW{xW4RP;|2(klkqXfR~T>-B;Fd zmJlCPtsRAz5`rBK1K}8%*puZrBzi)LRMXY05_8ud)+I3KmOj>zI26K#&ImsDk^DJE`$pkxYGJ zUQgl7=F)&wNxxf{7AIJIg~a?f>;f`#Fp;H)w}8Z(WN>$vjrh_Ej=G`#V|MJ!PA2D> z&d8^5{NdC0hk;qWy|(%$RUQRFPy|UGc_-f z@2-Ao1BOde-bJE;i+a77mD#_NDjgH$7{}{+#BWd{@u`LfZ>~RqmB!4)UQJ zg4;b`TDn|jQ6)xK)3^S#c-cR3$Khu4c?b5TAwV4}kj@N=?)nBiRIHrk%5orgD;oD4 z+hT4ZSF4DND;4@QT6HODaZ13>%PefliFa0eP~uLn%lQ6{$qWTvl{h=ZWKcsRL3{Kb zai?F^RaE7V(jGIxaa8WS=bIKKSqhDo5`j$MyRQ4dRx$e?f-<<1^U=le1{7_i$!|pB zDuNv?x~u$x7h;)7C$GcD(XSZ4%Mv!43w@$$%t@4@Tso|Lt!$v|Z}qhpNDSWRC@8AC zc199VT}?(uyrq)n_ZhIal(wr;k%&g4SvaJA6?h3R5j=|l_d54x#$~FEB)>pUq*>TT zRYnlv>P-uQFLIIy{HHZr zG3iq6_?!y(8wVZ<ihrl=@}rG<#H9Y&Tgg?Q9q#Ojj`|{hN@N1<Q~vib-*Z;~2pirsxF}HFc|UakiNO zIUHK{52b%p#cXapaRsESJZ@Rj_Cl=wti9$6%Bcw;|rq$O6`zdhx zN;o`6(FH7fB%5v#P9+b^rN!HZyQKlY%ntLyMr90`}@*fOmRitI>T{yjNYFwxiij|R61#AV0NDg z79xqyggjj=(C2C8<#KZ59|@;SEW3KNEnh0rD#v4q(JLO|bd)7f*fhdd53j*Ktkw{u zV8$CGt~|Us;w7?`kxqCivaj{^5WI zhX|W}iuZ7nEYQj{Q-SCPBM(z_Lugp5LRi_&Q4IrB;6#`anf#RHh5Q&1=h;;vcQy<1t%_%Zb(PN8YWlQzazI?|GNppU@ zDW)4z`{^hI%g{gtF5_qA&sg!I2zy+J@p)K1gzG3u;@D5VtY)d*N|l3KYR&pFE}l{8#kCz1cm)cdDtnbea=Ix&Y@dd-rBxgZlw zO8y}uN2~HZ6R)%SLBv!jyh0%iEdOAf+_RV}+ChqSM>tbm5(IOjEX}5gOHG)0*Olt( zn=tBYnbT{q7{^Dy%@=v)p%EutJ`;j(`(*1k!j5>lq)Qi5!6e$UziCadGVQBr&@Be;d|^Fg zKEu)&j3pPWEs4aSawLhGy9acRaJM5!o@2sj}4oD(I-D^ z_k6f&@-KrRjFiEvL1QTE{efnnBa<9U2usve??qUd%UJS#xcZn=(3?-kH)f=O9moYY zQ!)JN^0}k48Ov1jTnMnGVF}*+pdp`d0+g+8LjWYN4*uv#b5`c(Gs3oA%;bx+VTg+S z@uXPizUGi9%}%hM~v21h6ec>2w0=@oYyGqTCByj@+hj! zfIgx3v17^Jl}YK6MzRrD#7wQ^{u~jb>_)iJGA%YH*#4b_a}=GO*=FWD9@oZvC-_qL zL95Y){Z`l)tE^eA& z$<|3q>S1XNxyxKSO4(FA^g$DMH{*H*b-XhqRE9*}j<-6ncXWys3Bj$d+I`VEUOQUj z%(ZvVs)jj6zSQ?@(`nn1N03fAOF}4$eE6Y3gBupX@!_3E0W91UyE{#=R3Hb+#sfvS z24fEFuXp_GX`)XQP^s!t5Sl!S9x8Zdip1*~+6z%; z(ucf{rzwy#A>n8bKb`3flLOsD5tD9M8JRxljt!^0<~Gt|B~U1(7N5ul9$Srp;10x3 zwhWTyGz`F!*C!zF*F9pMGWFD%brG4_q556F4rt7UkKw9I%-xvvk8GetoTb#3ajlqGROw}k4aWA7T0(iV_WoTTEV{RnEzbQIj{ZgiC0fcRj7C5k_-x`&JMd7M4~huNFa@G5jIVtzv`b z4cO{)Q*acxq^5H#xsc<<;!*Pe9w&39$9>&T7@AnD;7WIISDuCDO<^nyxB(mK(z|qX zeM`Q{pMPbhjPbn8cz8IA2o=~GP1twrq|P%S%zZ^tkzyR1+Nu`C*8^;g?RLc+3#%)g!x@NG_R^6hPi}+|qBE=hBn$gm5tIS}L6Gs~;RVnf zq2`oO@4(6406~HLT70^(09}&(hr~6q0t*WXJdEjb`7TwlKbIoyTYj_dIp2RN5MyL`2*)<@( z@a*9}hy5Bt+W>IoV+IscVvokb1rBpy1vC&p-gPZ4-78)(Sx@e&U^>FwVdHqRPskWw z%STh#$~YsgCVr!oXn+@z5a%W_PW8jw0SNjFs3}qW`a=QPiwDD`4^c`%FM*XVWb>EH!GLlNmt%xoqXGy>A%)t|og8g8X&7ldiHsY_xFU6lw9vTA5Q z9#aJz?~Vxk4K2*0*_P^j2)*|$@rh}X!>_9sF~{Tf!T#;sMwG{^BQtIgSm$5Br`X>{ z6H;Vo{`v(HUut%Cr1s4Ga{sdSNg`(tk8YOswx`coqcI;vPP%I*>Q@V6h3Cx~{nXHP zX0-&3#TkK41WP?j%9UA#6>yO1rTpSb`5Rh7yv$0Xq*Pzef zW8WlCY+)L>?N6qXjJ?R8CyTuhDcQWV<*P~w>W_iUYQLYd3}H3%(9^{tWEy_y{HD^4 zDANcV%E8;(I-Zm|-KuEoRJ&RT?&=-YVU@h|$}vsn!*;6qlddXJkd~$Ef;C?>fNPsa z0UN~;@1?>e+bO=BEOoK<>Rj9vpD&7or#(3Gr<9d5!s3RnykM^+n3S~*$P|5P4Rzuf zy3Q){J`{UIjRBhRGyX>S?Qy;X6Z6%EkoBnb}PFyrdL25mZwmt`rjp55z#^b$Xw$s+eW%i&isum;a$dC}k; zT1k7L+uklie{8A;n?~@l1cBo_)akLgaylKH4pdcyTKzXV#%|IG-b{|g*g{LtOb)7e zHSTy$;^I>&l8_UhG+KbbldY4}+Wrw?u@OVLLZb7D;`}j;c#f>X+ z?Xl(R&a3Xey}{ip&q=l8YM$;AcX~e0JR4=}9At_OHcG}}OK6+lIUBzoHeOb`t;3Sg zLJ3m4>C5}lBcDZIgXmSlNu-w8$ElC{Dtp8Za;FK@B(vN;g?r+TR&x1V42E}98K`qgC7G%w9E0dFZ*1*afe}`oIzG@iPpFmJ`{*D z-HvM$GfNnl-$mj|H~7eH;ZtkeAm}k@j}X06ypbQA_@U@wgvw(k2nm=h$DFNHV(Tfx zI}~l?ZRX%ho!L44&)G9VEoXs0bkK&{_W8lk;^)GNb#%MM?+=3Y*3?)rnOxkOVuWoI zh;H>}4M<#BNLpY~h@&wH4rR1&ZWE?Mhq~+mee;FBj;3kQv2C?dAW6VR1bm_~#0=uh zIL}>uGoEt-vE8F~?bek^!!U6S8i~ltg16#HyuTY^LjtdOqq8Gx!A!y-1P?Y-l8Y1D zXTSNh!<8L+iphb-keBPlhiBiW=jckn#$a-92oNnP`;LD1!X$F3qZ!HRB2t34ATNw~pXMtzaC* z*e&Xmh#MVkHr*XF=GX6$o{=e)CmQP+Q^&+APR~+rXWf0b3&&T!urB##%_%@&@+j)k z-GJm))cI{tV*Z3isA$6Gued?_u^I_=Urb)b^7}bbVeVa$d&F`YL+#Rg3KOzXcE-Tg zPvceO-Dwlt5}z3fJX}Ffh#gQ8iIaue)1qj0H``a9nwqU~SPI&3#1L6+!>jur#ym82 z`8v>~6MngDGycHPp7FRuqBDEk#%i5u_R1=AQ36lyjlqm4ho}f!L3*zqCk=^o?SGvkQ1 zNQ~OGNZPZV>N=_$Lk=GIzErQvk7{tMB5<=a zWOJRKIpOW zl_T?fxtJ&oM8)7zx>RIa{%w`!m9l zghzfs19ZVTWSr3GXHo9}l**?1!jsYxQR2XW3>?y z94BGt5L4zrLg_aX-!HMCc%5>|se(2EiU+ng9p_2BX<}4nhUyNG11Ll-?})5-3dm7SidmSC+18e*|Ce z_T1d`8w0&Fi46@+yO9e{z*R)uA$6F++=GUYf^200l<=% z7LyFGYkspE*!@vNL^l|aHs-=}xXik!R!Xh_EE^xzJlH29^Myk~RknB%YJLnUdJE^? z|0Cw4odFyFV8Ach7}Sr?o@V%&sXRH)vU~~`+W+$tN8-9`uJpL_4PVW;X)2>Q!AcpZ@~F^l$oV&3?C~3Y=%jENe&Am?s!QrBj*@I?U{< z1GXq%E?b($WVh}=ak&}%UkN>I2~)8rz6i3Ied?x$-+D7qpOb9>pb2+ z*MrE3natU}r6TtG9};S6#J!IVEvKj`d*^M6ZOsf(ka{oC9)g}H{n+qWnSxZ*0$Vcq?Z$sUB_tI!ze?Q-*sa2rvszAk?DCs<3{B%-GlwQK zF0`$OJW3K7Z4h&Y!^V*3NH#LubWomCGfOac?%H~6k2S>8oJ3Sc>X9U>dvhs@%TLnGhn{MMJqARi1vO5pgn?T$@UON(4QxT5425r@E>kmK z|MN%tJ#4%juGM`1eb0u^{L?5O{N$!z)cSYZyrBQNs(*X&-3LPvhER(Cm4I0(xz^9x z3zm`)?PRFdYHHQkN;P8oZp9(SJ-NY z{{p53{sO3Sh+KKP=hVlB*l0FW$d#WKJsT}obU%5yRAb!#zY^q64u3uT3)uhP<3Jly zz|xNcfuULN@81-t8o1la`%t)?klc63$S1iBG1SThCB(yj3<@|O`bg*vO7BCiiWi9o4^1uB# z;Nf_czV#EMiB&R5IO_4~;OAxjpe6JqP0ws1CED<*0TXf-g6v)DI7w95)(V5kDYNfE zdUQ2n2J^xkNz`F-OxejCR$YrxcOM$Xy7=&N?_Vl+QU2JF91yEzh@%z#i(g%(;+%0+eVLZVdG`g^4J-5H5aM$;i>YLNXL0ydPkYj zQI#>&i&kFd#9QVIG!FJ_<`ZkCi^f*=u1Oc|x<74&kaPsJWmH6Nx2E!<>Qad>R)J;s zN6+M4VpfK~VN?u>bnGKW$?qL1s($ zNHyzUKxNVm!Y?b~PKh;if%X#{;cLC}zkqMpm(5Fe!3>?@-=l8-tH@jjYp?|$xmYCq zd!{~TnJ>zXjASU^bv-9+Qk(%+bF7dK){mQHL|&UkSagHwVr)w!C5A~>U8K{+cD|V~ ze}U0)*}&LBLm8wyrIsy!o7dTxTwqoY$3o3xhQ)27ZpN|0E+O22`g8YEI=Ni;FrD?D z3Uip;QX)A~%hFvkTl0*`9T1$4E(d)lYhyl0TVj^U{729`+;| zYi7IFjoYw3;znvr=3m1goal1Je?rQ(J#+p3`OJSJ(i$cH+inPFLABCTeo=!q*0E5p zxBk2T{Gal=L7U9@|E;7a>-lBE;ZWK7|I-LpN%8+9A>-*^K$1P_Pp$ttObx6sIjpe% znCb#0YW%l{KR<>31#~QYz1Czt;=v1<6S`GD?cz_L{8t$)oRjEZn~ld$RB!)j71PE< zPo5%$HBSHO>Wr+HmtP&G&Lpw=U|+n&LhokhQMh#f9|L=;@gTEJn!$wWQ0Vu6Y`yZj zc^fi4=`OkJ&dTJ7TSWzQ~2-jfqPbwq7KK<`xhx@ch8> z534ILFnidMpS`%bL+6{Yu6!+Yt;B`%)nb4}+|oewFJK&TgSZzlN(^5@+bsTn%)NC~ zTVK~M8j4e-MN5lA3V}k4yL<3p#oaY%acwCM!HR2ehu~7AXmQu#TA;Yoliz#pci#6q zRvPZJ^Uh>Sjvgdl{GjG1KTHVy2OUq1S#1~vN@xOMQ7QKA?7l3a6+DU~G z9J7nwyHZhfz6qtTc&pc3e*rfUzn)5CyL40FT-{Gp8Hlnayt?a>#RvyE zJVyC_vpFT**rx(yWB)6zUmjTv0j0b*pwS2iFcBeKQ$SzuI#ZB7Y=$cOYRi{1Zo^d(G zt1#@_@m+}{zu!TAZ($fSDT}$SN+B61F ztgoC2Bd0l%<3pL0Ay8$>VfrE2Pd3OaV~3f0rDcZ+*AGb)YW~fWsr_lqFtJlcF;esJ zYjJ~$g#ks(V~3t&!9Ao_#5-sKL9(QWBt#jZ?3(>M?#Ei+>MPiU@`p(YS*<>d73jmy{y4`lZ6hB(8k|l=#$9!zu8)ZLqVytAm zm1^BK`jKw%OJa0J-EF0EB>=)2Zo2eVGTauKH>clzX!9Ls86;`zPz?*UFSETZ{*=89 z>^-LXqYt%GbG{lB4gGTyUc6&{O@y)Sk_6gWa1`=Vc&;zA1Z9Tmd6EDP(i+hnr3a1A ztmm;Qnbsb!Y_epm~Fan`#Pw%cqa*>x^laAnf= zMvLcN76#UG79Dx#O(qYIiYquYY`(8hUgIjA1}tZS`~cGZZWUTJ)&l$8VaO zK`8R*j1gC(QZDpAcQiVK43%d`@%7)Q)t*#TdH>QqFt1qte@5;= zYlM!})oe-7d&q0TV~iCDP|-bF7HisDN>1(MEH*YUmUfgJ8E{C^mBaF!=%Z2_6G^h% z?=wP&9AQ6HRHP}dZ}s%P{6L$MWy8!sR6^`gG@^G$EH#LSM8N0C5|t>iZ}f zzwj@uh_rh<8C%g-B;9Ncrh;pWmMcaTq3lL2bli=0vD}%Fy86&Dxvl8_SA##}yhsix zjp*J{iFkqS4By&(a?!~?@i6DBrjv&ahwE92o6xFoeJHQ@BLr&>b{z1fu9IgQK zD;5KkR(x1ly$zF8X=(;Gg!B(*jg5~58+OYS}`%xS?UkcZGT4Q zf;{C$e^b8ie}07KX;n=AT;>l)o+oj1^GUJrZqVy8122nHp8W#EXvKPOq-Dw!)PeWj zoJ(N%XY$JV*B=B0^?&XX82Oijvlm{Nbc7!a7|dxL+ALa0|M_KP+lbJ3BKK0+ZwKPv z+^*1VqSuDyS1N>{xTuCjP^t~8$!KUGNXmp9r_($?LOBhk8g7+uhD@j0qWNWdX3}*O zFN0#tXAj4=E>>ioD-$u&SeVNWWo&(}N!v;hQul@h&4}C^O&cqfw+uE;y!hM27J(0q z6nIT<0!H#Z@PPP0ljm{pA{@D1)4za1H|_Yp0NCwX;xI<_hGy+K)uCmhM35B+CCoh6 z;-!(g4sO8-)=|=M+ge2RLo6Tb`@jd(DQ~)q$|+U8#p9IS>5d5}{jD-YoYwlzIymw5 za|T#)g0_+%=Qe{}(_kO@GHvbmR>^hV7u=IY^6WEYa=I^_{Y74AXl*D&hvtKp;#4?< zY*GErTH1B&XIZ*^6F*%GYZs5oYsl%U6)}ja&M3!t##1v!VcOmMX-i`g|w+5#PKzk~2RKC@YfM8wsM zk@FfHP!{gmredl}hBGe#!^l&p^lYFhI;tQj8_*ao2jZiNa>tD4T2mXx#r0Ho%$vH( z)HH9h$rQ&fnH?^dH6DrD6QnkoCgxk{7eWd%T(3=cs6B7x3sF|C-ODtLX1x$~w=9`f z&1-L1hodsLS$`F5wJ5t=2VTwCLo%Rts^PR7aK;SHO`GGUp~R-BN>?Rrh6dQ#Yv-oW z_o&X`A&3UbC^lH0;*S8t4nMPI-$%*^Bdt#Fh;-ft6pMpqE*mq>P#nq=NSFbW|9+sv z3fjUP)Xe^4ZNxaNP|-Prs{Lm-a(09_H$gOXQ7`g!#A&&SOlvF7QMpNE+H#8HS3P+q zlLi?>tu4^h9*-x_hUP4V{n_X0Jtw*nU&}Ke4NQmPnjR}9pGA(a{4^vZPGpOtU-!`M7|&6~bSd2m$xPSMB;69ePeQ>ntv zWM=Lh?=3vFz0{!8S~i(HXVi#!YG~8fVc%56a9opp5ZD`T+dVK;H<{C+%JZBzi7`=> z;6{faY%z|z$LFxoK+`wd(M7m<$(wMhIB;=hPf;orua5yY6b`4bf}bRY4O=)B-`M@| znYkb27%Ar~DPetmt-b7SaD4Bz+6Z4Fu!38?!EVEGYE#3$MAp|81QT`)EGZOjt)*U{7@CmScB^pc zKwEN?Z97Hw3zWq^ZwnQg9j zqM2?<_m7#OQcb&8b?%sAFHyaaLU6odvhi7nxyTW;T9Ci{L1oO~vWNwP5)De+`fNzg zMd-iXoGn?8olR8U+yqzbN1V3sdDhAT>`~`8{QzR*^@yG+wfc zaJwuZCvVs_8U6mkV#SQqjK|&ySJ>oo;{#C~7ejH0*LeKqHdo7=Y^bBgASF>(a!k=)`Jb#A?z2 zHECj$|6gAk$7n|9%#|`TQF-91zCicRE1=@h@(5&^A;!#Xd(@2M->H*kq5_MT6T9@; ztq@}dM@3o2{4~a$YXOO!y^OiziMW)OM(wgs$QVanT}vyWqKF9XeJ`I7GkX?=GeV5< z!Kdtv*G{{dm>1LTY&7B^A_6mm0H@1|k-tL3ZE_WwC;)2+giI21#JNVr{9e2K0|#tb z7Wm_$ZFWcJ)pxQcV_X|ZU~J_xtEv>_Bj{5pRcJSCq?x;R9o~pX|?+^5n?OewwJ45vqBB!5mI$Yg+{t z-+qMwHZ)9}XI-=margpjabhC*dV9EPx^Ov57G|$&$Rbfx2^br7QHA+pu@tl- zh*@~1kn2kU&(hD9l-FLgN)^oL%<|-DFQ;FI3|%Ggvg`Om zb9qxij>Si+x~c6P;R)T3enp8JdhRT&ET-KW_%mjFd_pl;e3ua`Vx~c(^#h5$p5zX5 zs-K10qv2pcg`P$pq2TCr$w$gT?iz&o%Z$VfD*sZ{6_Ry3K+vk)PaE7J6T(;S_zg9Q z6*xFJR5TH&4rbhG<6B=sgWe$I+~ruXR`!X5QTPs{;y4d;cqa^1a|%A=-_6h|yiAAg zu1G4?!w?m=*w}Ihc`D8ngUDZelphj5B`+U;HDZ~7ZC}wJ7ZwNq;Jk)IF20CQ5VQ#K zx_$|^eiotpyO12j)`DavBr+nGD9;&F$X)0&a&r5u|5>4e-wKuz3Q;X#gek-mOdsi; z)xckTkpPj^kMb@?=hDIk5Zb9^)TWGgXNf_-=OsFltExaS4Ry%>3?Ta;?FF@QK(N|k zgT)yV0x`pLIPmSb;bC!Ss+)G;@eK)BLGcS&C}x}SwbqXp7)nUUjZY`*dnwXxfqHY< zK%kEdK%GVC941cJNms=MiZrlEIn2p|gAr^g2zGCfSaGHW_LC+ri7}QYB7h)Da3Www z+R=Vj)RUqZFY*7gch%w$LZa^f=$H+WsssER?dllKPMXd6ReR%+U!%cg`ZbpNW8*}E zwc6<^{M3?&h1U4(EDh9a-4SQ2re88-tskA81NJ)aaD@BrKKv@e#}CN+3)o}AUkn*m zGpH7A{vooeP?UE2@S|w2?M=aSV_B0B0}%JBw`L%u)lwvP?6Ac1pW9rlca2>bJ))y5 z-W3qIejAd#8d~`a=&MsPgZtKEAQW5s8>`dJ(c1Qs7FvO| z66wlBw-e?Wm*4wEjFhIMRWt$@BalP2^u!o zcK(T!y(1HSo#wVTUHX}ZV;e!Ek~-LzG3vWL(hqAPf(c8Zjs_-EB~CyAM)vcRWb{v! zwQ8l`MYC9`_Y59v?J_bIok%N=mn4R=n0gex-=&V8DD?Dn1SZXrOl=ZREgbyU6RMG| z#+$3Kj1vn0`;y zv*2{8z8dAXf(w)g)X>x3%U^NqZmPceO33Z-Jx~-e?j0}+E=mjUlPSC&5wvR<-~HCR zte~*eSRda=mF)VbZsn(0N2ZUk_R~via87FNH5 z8~6h2w>*$8B1iDFD~=y^uBtZ8p6^=bFW@gALoH$Rc2XEhcSJ4o5}QS3-&1~rq`s{kS-#BI@{gU!g05BrmnyDA!C2=Mio#rQ;~SppHsE@ z+OxPaU8aynu03S-`|4CZ-_&O#tjq2iWxuSlzW}WIfLzzpVgf?wNdp0!|E?nPV74Io zQAF2^k|pG!^wa6K5$aHlax-7yeZR9UHwcq_PYT7#?_NIEGlx1-;+ z$G*Gll>hwBd2RRZ{Znw@k)I{eiOhY|GvSe>j2jPdQO(pQ_xaUdfYlw_e$8_9u-2a- zH8k0%z$HnjlgUbKvHMb*^Yxp(?xzes{-?;lfSeq`(bS`eXSZIjo(}pSA$H;a%@CPS z&aA_?jb8sM(L0N6wJy;<5w#l8wzBYxi=AhLHH5m3`b49QCk~fwiN!V`IGw z^(wL@YF{E?$%qE!(WU9)FJPFeD1S0f*WA_&rWs?aMq~{8pV`J$0@y03q27m9JsAjTKy=-CTd!75^qvhvcue3&s0UtS@QjN- zVYmH%TUwxN{2glQJ(1Gg$AGRf831(#J@V1%N;ZD4i#ckGj`;dTi<_seHA0k%)XP+K zhuM~1#By4h>f3bZWQG9NKaL7)CR<~RlW!}=b<5N=zW_Wni0!X04p&4dm&*bF@Eo^TeW`c_d{VTj8>0@js|oi<0x~Dvi~uc zcGKb0g9xUMqZ+xR%`*phNY=uugUZw{k@C$<6lS^aRpY(LYW1Wc4rP2tWxVGu6$GU!) za@*Zh(SJM_6cHlAU_hn9Au?NMuqfvPyV@J10X5BsL^hNd?y=M{*?a=G&B}m- zwB#0vG5C)`#~7L2+-jo?y2wL8FVE9rOj8W;!U`I8_>ttRUYX{AG!}G$Iz9qjpXMtz ze_@{eP+PO2iWQ{w{7UDoMw*Y9!>d7@KEFh?($p2eK_9>CHUG(7UzzZ~?Wv@qtEBzB zU*2V2|D4f}X7cLy(VOk)g;D6icP_NbZ*X>HNp%ozY6K z>urs^uY+iZZLGy$6nOR3wK0QUOG(C5fmX@lIl%5ZC6w3yqt=CIfxa zZUF>`N&Q7nA1}Qj+#ltI+wpY!xZlp>6+e#9aiAvRIm&aY@jq~h zk{uy>YD1ct z>D^jMFAyaUp4iylS6wNvaFO=A0iQ+IcCeI9N!G)SMZ$8`c(FH?#T1ml-xS?QiC=*u zp&ys53UAm@)p`RdW&5FK=S117N=yJQM06(322I}KJv!LMIaXmc^5cr@LFoCaTr<_x zA;&t9c~*ho$yS+3ABjX)2n<%ZzAf4!M&fJll^97GO6S6&%>|L zS2p#mIO>%=$=zB>Bmi-S-@(g+^eMW$1TRO+I!AWHsGb~_g&Yt058)G|-7Mvcmi*`t zT<(#VKd0->fScq9f!FFm-BB;H%sxb`Y=`tbSHYjDDrah6p5hqcxwMMd{<8l<`Ae^* z5l6(_i{#w+w;YNyj3bi19%Pw8WKxe0e^`dJD4H&IQTQIGET%sy}eX{VHm@Ey}Es3osCORbH)tp1faS-NPSs zNL);uPix3@s5Y?2)MEl->4kr!Z3{+CmbY{4Vn`cZ^QK6v)b96x!&{zjt!ZG@?2>#y zpS!iN!~DiYKX#Y(hl{awzb*J1lbftw&}33hsJHd7W9r$rb+)ql^yxR-NFk#6xsq4@ z+h*BLie;vRLrHA>upYlwV|g=Xr%&kL1!m%WNxy4BbxsPB2Y>3X^*75Xl-Q~>d11T5 zxvG;Gm>ea(L+}Z>ik}hCp}@`h0+A7t{}vgs)9x0b&$O?wcoW0FneB(NM;wPmSC@Db zVR>C-uU$~$8I@&4mWm|6q|3Im7~L4`9!-yJTjO@=D(AJn$Q^9@z7~r<)u+C}%t)m4 z-Q(89#D%R3w~^Y0%*#0AWK_=kuZWVGWNY6(_Gt8D6E_kfE`mFS%xxutcDo z7l;IA!j^^Nh{5XnW;El})5d2;kHS#Fqt8`meki|$OMS`iLvBF%N-Xwd-EnIp-O!x{ zinjf!M7yr={mcTX)hnclaWTp07q*b`Tq;I6yhGXX|!C>0S;Yk5wnw zn438wA!O}bEkAkXhy-7i{4qKvSStrjZ^r%ep%Uu}`F4_kxqle` z%bqnL;Sh80gVzUq|EH$(tM0j5k-%e0s+?$$1vqXE)F^{SIzV$Je|%izE)d6w2x!t? ztIFnipR>6&=vk{*>3C@PmZv#hC$6Ay-L4xvPAq%XStMZeC`0g;`26*5cqirmydzd= zUs==pI%ia;FPsY*E-otXHs{Xo_BRnK!N_Ed0Ce9Qt3BRZ4ngk(d##2IW676h9VEw} z>lm6EgQypuj(_^rx86ljDf|T#RWkZjBaoS^z)tCAy@#mxt&qCNnc{@%H3B}W(t{ZC zL?qczPuQzfIY-ZfP$vvw~q;%>7z4MfdnQPhjl=>x=T5 z!qw?stRoo*g?5Ey$l@~;L48y{xjn#`7!x+`X9kX1xf{k~ZLCN9&Bh^>VRUJnt_{LJ z67pl0L#GDS?Tq$|>bu$*Ovc$Bg~)C781ZAVYESuA;8gId?wFq8W!Ouzu{NV^ee*ow zAryN-M*F1DtGML$T&H5ZVMsNGhO#_rORL7s`)kZU>cXeu+HbJ2oR6B`!QL=ZXEG4r z8`vS~F2$YyLXYRa&?5=G!>3Y=vsj|f*MqW3xWPZvI+C^(U{Jc!-~HN{rzS_PIlOoC zo6#|zaZBcR2cu(>8EBm%oDt@Ka10*?N{Ai=oFnF$($UDjJP1{D~<{Ug3dox@c%I{4^F}4D&nUoEB}(v@B%x@i~8Qy>Z~3! z)4U*)(N|9OX?ExYsX|}sjV?l8A?0qE+SoTm7M7mi!R&|@hH+nyC;~Z1Sui`pC9^+> zV##OZ&Yr50>Jvq*s#g@18(J%UuNJWk{s%9& z!T@ir&OiT`lXA-}$Gx3dyNf>fXRy&sIjmz*m(BVFPdC@=)ZD^JjF`;StWsRFseuoe zTE8QUA&x}j&m7NSIO?G3kkBR!=QtNHm^?!<%peAa*t};uzdCS2-l!x(e%d1s>k&iS zKcIc8PxfnZMmw()*`eJt=_R|Ufk9p`uL~a`4SkEcy=7e>d7%^afTRKeS4A=ZE_=TPUgJg+4g}iD zcEK}M?C%OeH0Boo0(|{qZ18Mi6zqer+wgOzj{ErS$MQhY`|_5d`lLDvICA<&p0v{P zZCZWON;ifIRwSgbVsH)Ms7Zp1B5|$^-t^dvs9Au)0m6samrAb-ik4mXQEqqMKl-@u zt|nDI{4-wU#LbnsjWloWrc9t#kPAK+u{pyUAMp|5soR(__D z)}NtBGS2Cr_nt6|0!N7qUrixJg%o(_w&@5RKD@6hR3Io1g|pbC5bKiP?eY}OC5+7$ zo@JbwPEe@&gub4N82iYL>yerenR(#*sgh@dx1bQb{M&T}p@1pe-}bztJ9k$*A&?XL z&x=Zj>(8@N*~n$L+CLr>g%q`d1sP77itc#&?rfz7g{z71;9cvjbt*MT5`sw#w7VBr z4q)+aI`OhH5}yj6h|8WjXqKo^ZfEydEp+6dVKx-1679o}Wb<(RzLu7z zKN>x(^+j5TWzS{JLsP^UKr|H7o013jq^(nG2$>A8YnmbGRbV{H-WbmzTSba4G$k%f z7mCkQ4|*Lyz&i1Z9x7{hZ zX51AZS7WLl6jN9VN!SAR!0D=GIR+OH!0=aR<3v;!h+g9HI_m@?P;3vxR1=N>OK*5EDT@~6Jm-kdc{ZyN&z$Zq+N^1Y&+9GLQlF` zCMG?qvCqr8`l0Pe&z1I%Yj|v*X{Gy3oF2LbNN+0$P8@QlS!YAZU?5cCaFJ(bhy!j* zQpyf1o@peMIz*t0&T~RTo*=@Q@_Ot;|NPJTwQW*zj~w5wQNx%!wvd5M3Y;#T=AUWnGZh zx?h|)u?8@kTE+P06NUR4qhi!_pJ?D^x`Z4WAB5d0>h^tHXN#4a-yRchStjPZC;X09 zKqV#^bczC=DX94NkI!yJ`fQZ1K#_Y#Swe0)b1&!` zolTFJC`uOi$??r&rA+w0?*?+X9R7z-Mk$Jr7P-oG!F+o8QS|bAQNln3On$q+$G1HfObEt&i{kHu^7WPn7AV#!Qg6bcuxCM1?Y9*R&)9C33eS~VIT}tz_rO_R^I~#zftbzEyGy` zYv7}w)|&yeBxFC6q50$cyADdM+?LHZC9hV9J1OgbYtqXfsB5^Ged9RWg!3i5)bMJ9 ziLdA$4ah_QvZDp7ah0BL4YMCTFXD1UR;WsU-r)C&3t69WemPdO;p$xj@f*k_xgQW# z@Qws1TowrTQeN70FtZTUAUCw@AQ_q=wWIg;)Rdb_8R3Dkrf|t9hUS2f+%PDt;PYo5 zxvd=WF3c2xQ7f3mlVOaH^809BGOH0}L4a}KGbjX zUfQz8mm)0yl(&VQ%PdUA9pF1}Owy%|4A52J!HTJQ&eONh$F4yoaYcqJZA=ueuiJPW z>o!zzP-fciNr{s_Cjf@w@NO!q4?UCR-uPUf=H4uBaZPUb#$w58@V@GTOfkUoa$tm6 zKPk3B7>}q~zqKGyL~GXBakoOWj2_PXQM)89HBm^;4>t`{UIgKP9y@=6oDOePxvv{M z>|x}WmIq0{wXJ2(F6O^M1eKO&`d%79M+LJZhqFf}CgLTcTQO^i%@KLcDKtM~N*Kv}v8O+O_!k*zDc@z`-!h*zOM( za#2;!r7P|YB)2}4*X#-WUgS8&7a;@XlwJ80*@sa-M}VkoK{P*;(($g{b()@9405ob zeeSsW(_;k}+vUXzcyPkPhh1w3={XDhTnm=S6m@&!q}J!ih9_`~?(;rL`@HdB@4*v)S#DKffK=r7=87J7}$gI66D(r1gdX=R0>AG@cv zOO~*D*tq5lv2StpoW*^HH$psl5Wz2qVZ^-V#uKMq&l8o~FLf|n+4VaI1aIo+iY|d! zLcHU@5e%tQq?o3=T^cFGB8}fe6n!x|462qn8;08qGMn3aCfDEk4CA<{+si@g`QQYh zp%hEO>EqI^yn5{AYT zC);(3k*Qo(v+I<_QYk9tdTJB0BJW}NGVjnH9YVXmB{BdBqLq)rab1bgDLomiJok0K zhbQ~jwb*_K6mfDlqO~f+%4V7$$8;i2MKhPL9;5Bd=r#4daNqb+z&lbaC!7G>vX|Oi+LKRw>bs^ zv5aUS2l;C0om^GSKk%xmfI4I&SEDa!CN1}v@2$^b_s*STOT>B6N-h6~Qu>#s zGA4bAUqo;yQPa%Yanl?SL~m0^=V zqKsxY=O70uw8IkLbr;ehiYPsdaWtq*aX`s6IZ$Yi!7rQUpjA$?$tZ>;e{ta4ZWwl= z`JC?>uZkd!1M5PRRpB`C&XSN7_iW4y<%;%E#f7;@T=FUf2}t5FWC7gj78)2wF=h>T zh4P7#shJ?CU)feq%7;NKBQd9-;24RLwEhu}arVBrnDq?*hr_<3tF8HP5{Fr+yhEr0n*L zJ%nUO>K1Grw0aFNF7JQajXkch%{}{Ct2C36t`$9gm#*DCoAU8M5@Vv+N+R4gtQBA1 zf}658*GDC9-e@nzL}-$jNhNr6MmKqkMPZe`2BZL8@(raG4hdmqjl<+R+mRNC);1q} zX4_2t$1{L5jd78(`p=L-^isxBdYrwJtVYQgXl^U9UzNq(Di!i|P}nt1yUP4yzV-cb zw7S3dptUJ(SmClxMw7CX2@|kia!*xV4?{u&&UIT*G}X?HDtFR-3&abGJP(N%InxHAxhO-_4@ z4MVUtzqj&E+n&$iS$NY^uz1z;=-X!2J}cn*w2=lQ;_*4GM(U=#e?&z-LpKDXQy>-d z#geInGq*|BbnQYal<2Yp@Q}oE6D`9%vN2~~U3%)7)hnl3DCsSE@*b}~bkIf`EIdyx zdYnri+tEsPgWT$8mLGKSOKXgue2wl}vm^DJI`h1?2B90mDPI<;){8HF)7v_E^bc8M zG?K|LH1ZJzv=AdL2tYxxm?EL|StaK-YtJP6iEBi5mq_VDrWn|5HNQ?e@LYKiLR=QQ z9W>A9LIRpW{o~UebhE#F&`K&=NA^^?yD_6)B$UtRM}=A<5DAEvar~?*o+D|2?H4vS5*E`b3^4XaVdCuMywbDe^&QcTUE~o{u%CwLQ>K!d zZ+??^rkZmSvgj^SY9a`)4WHy7uLiNenC3S&K$T7ZYyXqWv)StzyUPsZ&>>(Gj7%s@j>oS*S`QV?`S~nde3Ld_m0)h z>Z(f@c(u=Ca(Wu)7xZ~wf26f$@3PMI5)2Lw6ESDu8g@E!{cJT$n!Zw}_0#r;V-o4k zQ4(~rldq`;&w0tWGjmYZy!}Ue5gU+s82}P__oUV)WO1Jt9TI*>pmc;WN_>!H?7@ml zedtL)oO?`{k+co!=|R>%{6!)f?5BAvkjqRHB6bGWpyU@+HsFi;vC#ONN0`;Ya<_0p zKH?i`DnTcC3410aJrVA4fY0P%VUVVg^|L6cq>JhmeJF)sP_FJY;qj4#Ua8I8^u7Ws zNUEU+<&5hcR8S#f)<`BNjGa%-l^4Q(7&8zVj z=RspAvMpIe+blg@**CmDlsilQnL9{0t0qi9-S$#A9$tbN8G^|PzSa%v73(TJGK91V zGh?p)B0)y1Zt^w#l?xxax8L;4d;6~t&+}!~PFqejR}vq;l%qnk zGd(&Z=-5-)z*p`xhn2RpT*~EJ=cVUA@Dx5?ai2=jvuNL?O5nl$`kU+3M;55HE+iv9 zP@ZpBGxkMW%_nFMm*$er;ADn^SDBP6t;68@Y+m3Z3=55%(3m#4)5Ri|cWjC8IpvI%_~UHw%L*}7^v5@fFv6n?E;R&Z$NNhN%_ zyhEPGv3%6AJVjbz#~x-p;Kib{Tc)6xY>r;xu-0$Aw=$=hTT4!jH!bApf+PEp8HJ1CAbbS=InN zvirj@En&X=(9mqks~FX+$r-aQ7h8^8QqC==JfVRTJ_z<=XgLW50nYVFWzW;A&I^2h zR{nLyl09EgP&G9YsPvAYn14Ft z{(LLcm%%B>9j0k_di>?bwB(=MLbo!yt&B915*p;LsrX2xR%&#{?II^X z59&WZkX#zqQ#*~9(MGO(hYlfQSx{tAca?ybIW!cqor{J0H_=jYMWpGM(HnxmA}r}i z=2;gp3K$GJy@|@0B)>G{K@*2N<3@e<56t-ru&3Ao$mH5k9$X*4*>FgM4AH^y4?r^I z@e&lOBoU`oP~;NiAisSYw5b4dJ$0#KChyuEs?AEoEM>|IM84Jn@*L|4%P* zjnyJX{zbli^*#StoixfnY~=qtUN%XIPop`?*+#=GoPy|R`!I)2H(yzPwn5(8N_&r$ z#jkD@Tk#tizlb~K1zaBDBa`v9fCUGvfr5z+5}xkL;}gtpvJt+o!oQ*H@q5psXXr#H zoh%q;>X?eFS>IW)}_(TSd=b7&Zvw7x7rNWkVc$wOX4$u8k*mt+YI17t z7+2olny|AP%jO$2CJEV`Ok<+#sQ|Z`Fem%E1`+T7KUzt_^;*?$qaNx>SR=vx6Sorb?CNxe4N=fB$hx^IyR4 zF`IntvSi=b=lD)8o(;$1+YwJ(BG;021YszU9vc;a78EqjST8qYxMvutWv4rs0jq9> zO%hgdTgB1wGr#f3D8pn1^%24>hC%4`g-Tq=Ksnj(82>#a0jaCM1QpGJVp&+5#h`n= zFxm>DWWsJ?uoPfEx1juCaSJOmZ~VgtSRMu@^DplJjnoF^*%6!PN?jHOk+5mvDsJBw z8fM$5HflrS41oen@$B^7sa4CzS^&()2_w(PeY!xCnMH+Pm#HiKm3*!R+$1HJw2ob^ zqPx%)2r+SRVdmF@;*g)_E`0QvLR>o)76r8{!9PPA;u3+pR?dJe%qw2D1AnJ9@zZ_r z!#F0aeKa|VyZUEJ zc@!r~e>x`ZbM+T64HWXO?JReiz^4+j$h@?=#l(#ayLz1FcW7B7e1NaLWhp`#6leRR z@TT1ib?H`-qg7eaiC6u1v=9O+uky}bEvE(~iG!yw{k|nvl^%XCT)~%)C+RTqqD9SM8E zDNg;^4+4Y*+x@yxNkSP+cWg;T+2CsMr53*1cEYQ_0P@y{#q4HPZ`Bv=Jnn=h9dz?Y z`1E7DFm0%=@+RwKE;2$$57Vj0z<&A30gM!G=o3`? zW2yZYz?NAjCcA7{%v#J}R35I(AMff){}kFy3SRsN-q zY#*N%njaR^-La?b5Q&4;3rn(2)RWSK-L6ads2R}dwNE!1JzP_zoX7lq0kx(`{%N*j zpyJ}?M-^5<^Ly))b6w)&(q&$oLz-8j*J`V6NV$x+r$t+9E+h$2t~s=`X2l6~hw~rp zkBNBMoSMo_{37*(UdF6Px$^Ndm;ng47j3I1w_}g;vqwsl!tR+bk$h{>TRim!Yb=Ak z10sO z?0~x<`dM3J6#<(`q52=?0jtpg#H!fW2mk6@I$sr?K zEGFvE$sCTv3!&SX(BPEp1(NeIGBCyy=Lum zt!wY|T#JVJr`~3xm(r}+glnfz_u|jiBtab<)(T6O8qnh(_06u(HHn?aW-KdSl(z=O z_V1dEDbvXWOb`6XjPnZhsESnOsO%Qg=O7$x%-GCKq$u6$?K$!KGEcP6EW*Iq^_`;> zLal?R*hN~6v255RWUO6kC|ax)Ynk~rsjpW!mBx1r%V;~l(f&Tv9{@Cu51+@~mJFhJ zc#IETtZ=>>GXNt$JX7@!U;S+e6E0!I-WV7iI0)GIg937EemH-frQ`)xBuF)lO%HV6 zd+~OtY1h~e&szvqTY@tX%F5ox%=#-{;j`A(=fOM0*S9W5r%sneUbC_&o|kgKd*ESs zmV?Uo;?KQ~KjVJJhJ4I?fM}RFDHSVlFu1+01u<-Eikf#rii!sO+&gWuWEKBrF=I@m zGHE5hvWz!gHW@xyxF9l3=}moTI7i*k6@*LI7+A*b15a^DV$r|d2(5Ogy@-zHW|rFF zbyPK_jW$eQC-x0Zz!ueEB?~Qv?hJfdkH6A)IhRd8@lD+RFK8=!jBwhJOGtHrN95GB zb_*+$$#nFi^Z=(yiDRZ&K|fQ%hASz{{pOEX&qBvyVy=E8PoG$A)GfHu#`6eT=~?!h(fBC5YnE|EMLYQa$(K z9lA_S`sa&K`ox+@>}%G{YYZlKCwKiuS)PagK;5s}$4B2b%THay0m{Y~=ucD&4;m$e zmsa=7Tm4FS>q6Cvh8dlYV(?DSOgL-+bCTCduQaomO_r;tTQxnkQNkZzUYcn)ndT_F5GnL#)JGfm6Bp`)O{cNX zYCanhjp^?VLZhF+bogJq96X9SZFn4eT8a_QAO2!mpduizB{D8eF!UGe%@=Nl?XTjI zwC_B?M0$p>7SE1S@;GQ;?-w|cw_!r5y|m}YUlT@>Iu>$~{>2sldD-^&9=EGpV06kv z><>zQ_nckPa+&ABw;%#j%NR>XjfvY+{a^+F}_}RTQti(-AtBdv&b%7aLJM zT6N0DMGuI#%U_9NLtNt53|#`wM%Q4q<{2at)CZn_P!P&(=JYo%)gfPNuO_hYdv7RR z#eLEr@3gGp2B7n)b@zU*cLhjPHd~10iHd;pmE-t>#5<>bmCyC+!a0is0}DlRi&)JB@hE(h z8qCe)9n|vF14VEtGdpy^SbhaskwGp(q_rHu2j;qs3cpm=MK3+eac^Gu&4ZTvk($c2 z7FItzXjVzUHY)O8)HJF#QJK*b2$d!LCi}AUeAbmPrG@OpvLCvSEPreh!Zf0s!dvH> zO3>-3sj=n*30|Hs6R4mS{0!em4mNY z(L*sYd=1YvTcU}Wdkm%hFTZa3Xa!+|l#vH_s8dgZPL|2F_HN()EL4aPKnOuDPRK~B z$lpeK^-g8uqE6qyiTtjukK-Ay`yK?DQ_pxZUavh89uMdtr^fZhpp6%RC_(+r@3|WF z%W53ZGmT#ZogAHyi>rLg#!8y!vS{FA+GAN<+8INnxVW-XsoV)NIU+~EpbsrlFYc?P zKN?BPbpS~bw-jFx@X5UTXj(ZqoqKujAXpG;Q9HWAiqxO&r~A!byZGRP+9gDk`{tmt z*EK_;{Hnb-L*DN2CnX&lZ35wlus3x#FW?=E4@QADw?L>mFtpy$Fhp4IG{008`#duK zLndy%?2EH1m<-;jro!3B6#m@fhfSFnuc^aG#_c}fHPwLE5b&SzEa;!;p>9BXP-hk5 zjvRQ{J?qO>YBCowf5gwzSOVVo2gQPs>S30#r@ZT9i9m_}XRp19x`Mi*7p8c6Q=wey zFkyDlO{Mj9KUW5Uz5iGb>PhdQZr{Kkl=c4hfOztK3q1+lZ|c!fbP8RW-X_M{&~})r z+-c&3;W#1vY*tE+_eAQ^bfn0^XVNKz8fy`pSd}$4DeGnSjM1e?)?^+hADsu7hnVQ6h{U*LHhX#+24k?(^r2PFfuTFAOiO0aXi9}dwK&Kb9 z;sPTw_`rBjb2#cID-n_XS$AN^iXqB*2+$WJIX>ChBz}PFeUoD=K^c8rr|Y-}Si4SQ z*TolBu+Hl88jk}VKMUHwWo~r@sO;E$sv4fcWC^d&_ zD>Dz4m?0QOn* zrm$}Ie<713;A4u1+>C{%v8>G$@{73*H>xvrN+W*W;wK?a93ki242LKGvc}{L*vB=+ z01?Ht3_@1A;ulZ`o|omSnWD3cHzmvsUn9#2!~q!WN}PlP#L5j|*PwP@0&=J~8{fJ; z8yLBUo=a|yEWN2~jsv$Au{+W>(OHcFFYZQ?ivXfZ1BhBuQEN~(RxR*zRRE&y1nsp_ zajX#*L~uCkI-@dSkg9gHBdyE4U8UFl4T2*1z~&A9_vTf36@*vY>d~Nh<0jIXL=Pz_ zGJ}?Kpse4R9gj7q1K4>lWZX7Acjx33R^nZ4_#waC$yAN_H1@(tZ!^?_7G-U0>j#O9 z#}=?)z=pPeZP>UqsN1isea+!u&Rbr}0AA3Z;9c}F{TGoKnJA%}?0PYxccA9lBhb~CR@9!iIT&jHxoW1JK}VUcJP zvi}D(y)jM;xj*=#?dor?$M40iuhd_}KGiKA!rpbqkz7yG+|tTm+}oJHx4)kpoFd9I zUN?O7xJ-48W(=W`_PZyom87| zYc@96>pmI*T+9LUy*JLd-&<A2oOOOk-Nj#taEk z$m$+Q`9j?>MNtQPR$=I_7|$sh^JemBk6|*)-^@L z;^dpzdx~t%fcT@|PiNEdd??x|TdQG<^Gpv~}%78^K3*2-a^~ImR z_PYEE%v*&wM4`E_aK-IK+8SSdYMLdYkXHsJ6`cPEh2^(uj+l?oBW3Z8`JBH%*CAJm zi%t^MbaTqG_WL|&4sd{sYf|>aHLg#8P)^HEnO``0kM8VzXZe;0hW|7QOS1^Uit4UP{|PGmAoS7~ZdAiW2E-D{p5) zNt3dFru+!G{<~ZiZpOdHT(o_QsZ5u!9H zyki$cZKWTw6MU}%mq0vZ2jb!6 zjKNQ1pd7gQf**KJJ9Q(cPG2y0j9uLHi(bISA#;V9f+Yf_4uo|Nh?<((p^R<0&6=cIaE6Kg?kSA@F~tR|P~tc=fcc@{wmt$DyhDD&C@p@dcS59IWUU2_Hgg$rlEunuHmT z|D6b!-qfp==*+KwRCn4>Bm^6@NjW>I!8=sg{lKIu^uHK!(c=Fz&6xaRIZ^{n`zjGw z@unx|-9#yEbVvKn?~?kUo9(0Ve+9d;$F*>nFaEo^NukIx4Q@7$j8WEK4+EjH`2z8c zCQ7|dm;L^Uo4$ROxAtsyuKSK03+3jTd_k|XD3Oz~cn34~sTV*SZ;WiC9U(}q)A(NQ z<+o|T-OexCXhJ`FFpRu%+%CT@b`S8m=v$h$SV(NzAr}wr?WFFL{EoH=HYnu;E4lgU zgo>%02XOL!hiD;rD6kU`Zo+5TCYD{|i}42`P6WbUv1=dNr7@nVCFhTz!`xAexlD#t za>Wh5xb*j6T?9ya+`8ch=7pM)0xV_n53#efFs13m1*}p}ME{WJcpymLx~a*i*5crl zPR*|vUsXPW{d)w=<5)Lb(@Vzx|L^_PqY8hZK4@Au>hJ@&#d?~Ky~SvGtRmwRg?`M@ z)0H_T!mhg9PX?QlK53-#d-3GOL=A;DB{klp&qMLw9~eqWFJD25fx|XD2!*6>x8dlc zd5@Oer)6Uldx?jnS@N1f>H3xKF$wQ7JyfB64*OjJ1}C?Qz-eQM)|}lk)2=FULUU#v z|M8QyMwyzy0Y}Xo6q&OR1dkK5WxThvwGhqWT?=IOc_#8Ew#?1W*y+#s-lfBAD+bG= z~qhrD; z_Da;F)lAKNVPq+X9!zX%872)Rg&Fqdx7P}iiY)IvVQyRs{5ZVwjyV$!yV&lIwy0;AKRh=n5pKZnJWr)~j>FZriU0K<<9J`Ba5gckT zFba{7@~;RY&eZHR!cQv;k|cApKCH>6k!!;R#X5-ck%Mkf13Zt1%jp^9*}hrYLMe#n z{RS+`?4u>HhOUrbr(#hre;_Dzt3nJr%IPg&! zc~rF=5?rGih&uae#-!RT(!DM6Ub?Q(t2Pe4^tF4!5tEuoCce32X_Yst?Z&D3s5;D~ zmN97y+sEQ_;NL>x#V)OePG6>JnNA;HM}GW-gPL4<>)?W~cG3iAW0 zp}IM$08l=kAeRU3$&4v5+r7wN^b^WYD9j?``!j&Z{zR#_m!$@3wz zQl9Wd2v0=I00Vs-L&H;UhrBw=NVVFjoN1;uF4T7+?JZ3x?kB zpMKXU+rjo^YA|7uIGkketT449d_MMQDhggOr`>?sDI#ndxmd<9Uby*V=14AuMRb~%|H{Y_cPiIT~jtZmdJ8YXD_ZG-7)IPhF47?t4LY#bb(64^LdTB(% zDr-_)%`CDZ(`GVGlvYi%#v;p6e8F`&Fq%z8$)h2HJAqGTYe^C17ES7^{8v$iASGHC zY-btm`&}(rq-XPogP*DuB8cLK+YvUwZBGj#i$5r>8q*fMjsXNe2SJDDR`m;}bCiS@ zIq$}I*u>vyBO>vEc2zAjXl@kV4AHBE>CyJnb5h;KR)T)@-xk!nYomWKk24dHBkBQq zy{~J-$98+C3I1>=DTyQrc$=voo-`D`yw0gxbZF=^Kcn6h1YuvqW_>o`5}pgnd)#-K zfK}p-NTt_$I*59U*qoW5(t#P=MGI5VI2Ocx0Z-(RO4^PPe?{>2JD=CPS6_aDJjfMD zJR31#kDBv0PnUJrqxe+c?3;0$$UQa1R8^0*>jstQP*b}VO4nTFk6^V&(fwh1KICGn z8EJF+{)kCryiC*1!2{ivgA)s#*nf;b+_SkJl49_HEZ2!94)2PUO5pHP+_&wQjjMex>#6QF&48o zH)W}8^Z^_?fAEfd%&XaTt*I#m1RK$F6fAG14n`UF_M7Bh?QueF-c72b1WY#>M+nO?Ssjym#o&3tM(t z5RwJ4bX#=&+P(XZok}?kN*-`lqb}EeW5);{FAm*ubdCU0oU^#^AfPms&Ncxz!JYP) zn68P#tgnV0Vt+1t!C<_Qd}-;&%!Z@UT;6y;7>9aYrSGulb0F+471L{drL*e~%BEfQ zH4S`M{o|sqBZqJ2nuB-{KSzH2OaD74c*p2AIvFcO2A%5r z@w^8hvN-!g`k|igqQBng);HBxX6ztk_U_@+E6C7)oYlV0cIn6>OU5VG&t_Nk+F38) ze87opU!2h;q6|VVESiE+^DNgApi(p2!&x`>5SVl_!wHBd`R+0#Ej>t2W^i&zk(AnFqe5Tq3}y)eFA_ zce@221=Ll$y`>hzBNh#(({A(_XDyf-z-7hIqj!Puea!3 zd$=^$qln3qZM}gGtKAae%}MJe>)#ho7OAB)13~*)uVqbwHccg;WDUDr67FZiGamkH z!SI)j7UaQoDUO$<6%z@`&~amSlC-|uIU>U@bqdPv1JjGIBi6f~cDN+6^bbc4iR}wf z)RrjCdm_jlX>HSQmQM4e<_%OAE>crTXU(lknaCq~{JeMOO^kulx30(^^g{##cdl=$1R`Cnooh1@8Mz(~yM1MfvsO^={JHd8HGt6=!Es z7Nq+qd?<4Lk+jSadVE}|sMz<;#_yFsqN&r9&&qU|8@=LE*U|Ay>%z+h=Cf?k;%ZBD z7Tj=a$(pS^YEsuSdvq0SC1MHxdZ9PEs+4M$deDQ$--peIB$V>@^Y?o-_qRp91wDD0DT3PHKuV}Msg>n@2V1WR0|MNue zxMF-n2!^@~m!~W}4wV3gm;Z_G$*b2JuOQj%nv}Uj!$7MAhj~|uY{7&ws2c+tu_!qkBbzHNEAq_sP#ZWU_=xXTgc3Y7U_MbJe%QVf(*L0s(BNq

Hq@hB8@oP|n)f@qlKCBa%zJ`i8O0!k8ip;tExX8&qflAn zVk+Y6v*7kM(3fRa&^Q|coxRFHPexRPT7&^Jzd{v6@j*X)9Jkx1uDjk8QaK+@NT&oI zB$8KL7_st0m52-y`;|5L0rYLV`o?NXZ<{qPc*vUeTFdE7OMgH z$iO-toVBW-ZAeK{uwn95&Fay1y+vL>=!@g}Lez25BiX6xfr3Vfwn^IS{8(AC4N8pnBf1S*rFXUD-xgf=oQVCj8kX3V znLcR{>(Nos#fL1HTAnWiaS;g9gC}SO6h&x=7I=>H>-4-L0GAp9s)hEAkk%3@oJw+} zs>bh`UKuDi`7v18JeXYiEnn??>n}H+B>vd@lArL1oD-D#Ytcq(#2rNqHzAKdl67rL z!nr5CaWN4RQdKFk8#I!o_79?q{Y`L_w=M(%ADJlgAU6u5nQnLL*8iaNy$;MQaQZlZ z)rvT*w{(a2eZZgp|xCE0+nniS$#?r;wr--OEnh)iNR$F=SJSA&?cehho ziZPCSqk?H0{i=&F|8s zb$?J)GQK-!$LEL_doWZi$(8v1w#i= zr5NkI%>%_k_4L9Fz=t}kD&9kzKABLXA2{@p?6A>lFcZ46)_@K|)dEySSpSvlYQ0B> z`0!>UqC%!V-wB{elgWs=5;HMgDO&9fXE%+$0M{kG88Yr?p-g$YLx!Njl1fAs-4?bz!7L~<=MBIV7(^!glg>L}g=bt&$#gSC3$5Npk{;l_ zPsl(hp7DD8?$qE>9SYL>-*KW#4IFZw%j`M;rJ2cNiT)|gEb;8`2Y@Dx`CNia;J@oK z0c-~HUu%*|TFe8jQ;2-lgi_lp+;^oUacsLHG|F}N|DJ0rZ-rljEog%@2nGV-h3;=aLEV!94~d&K&c zM^|i(L3yai>eSw#njb`Qp&6qeie+H#ThdTVM71$^%Q$~BoxC$2^P<{dQ8ymbIxu_Y zVSr8c#N};Lk?XhUUVF--y?$u9+iK>X?4GMYz}xaGXbH{uXRxjPqOUN4n=nzJp#a1q zg<2<9WG=UtxeC>5H=czRT_934SfOfxGN=I|R=7ErFcCDU{z8~n{J5E$WUv{bAY+%w)PD|qAdG-E7@6N++HuJe`@o2hBP;@^fSFmK(n|^68L9~;o@J1S?;ivj> zKAYoi6TXepZ=U}Wm7KP&=fHJ;|C7yC>Tzh^95I481HA;HCJ2J9raRLYerasIzIY@l z^eT`Al#_D9O{B_t$Y`3thuz21)8T2zQgS#Wx-lz%B>D#h>mlvO|5P9y@i@c?y&0 z#ug#3`d#{aLa)p1CWVAy4s+_G5~W$zTBmH!PmWVG7PfDWwbycK-KI|VHVW(|(>c6T z66A=@MbSJ;tV18sa$+S=KV*+LrE7$57W~?yZTy2WD*xbSM1hyaY;oth{`P*C^3>nE zh~})s$xCsLxM~;ozys#74HC5z1yY7Xn@Me6_Od6Ll&;ehMi-wdtV@g+Y!y!73%Chm zBmDBG|n!jOZ~}wW8TG z#R8U_SR)B+-t57|pPAjaW$vsq^bV$BrJ$HRTp^})8q4TEmeM2?!iq*Mo>)u5WTfn{JmSk*7;76WwKP@0*Zfwe_u(pt>R*h!{<;`4J5_3@}e^6}3!q85<>f5m7hM~=Ldy;j* z1>ej-6xRu<1lzwE8&!NVe~2WPB~(;xJ36W*q{@*+aIifIu#tG)cx9{`HU7$eOAC#A$U8-hz@ER;GoSM^}9w$%~2tMZF`e`Jd z0@NZW&N89`ntHMhUNLh%p}40?*GgXOGEl5tz~yNYB~Wb;OEu{Cd92wZAH|`H(@*er zBqJ0x^unmk(P_RTl#z?B>vW`^u58C zChl_oPKv@jyZp_su!5CPJ{gX)Fe;sm3}SOuRf3bsQ5&;s$-Q|}P|_hR3CR=R8AdEp zJD8T{c7eTbdX^PTFTkyj7etFQE_4gH6l8a6!)u`G5r1YbAzgW+%}ptz zBG&WUE7q>aBEI^xZL#PYtCbsP{CEA|p4}zU%vs;uSPrHFsmp_C6+j7oJU&U% zl)5~$h51A-*ngd{_5!LN?1J;;WOODC?p%8tPx*5AGA=3u?)>kfI!nq$9nLI$7zupP zD4HX#ea$TizGIT^eeAZ=kfMXCXyt|SC8v_1poC@l@Fm)0AHmTqZg}j1ZMdV3eZTx!gCU`f`b_!*j(K$>sFOnZ2XkE%0j`!iBJ`WM# z!R{7wkQZn#Se_%ftIRhsQ&%(JQ!lg6LM-D|C9R`C@mmFsdTLy4r>AC;Fcr>0thAj$y5{Pk0^;<-SW^bQ zCQGyLb;Ch?0u}{trJ#5oX}hO`I3F23254{z`aMA5xbZF(M1_h;#iW5#A}XSnN|ai6 zh`eBKqO>W(>?Tq&!H>%<$cbFftt`t-pzhtUhJW~=`%6r;&tEpT`K^(=vEO^vm@6pz z!*?>d(arn^#x8;#9*%XMj?j>-Ej>IIa5x z&BPN9FvdS<8C^cwPRtJacOdzL;#VA#M^pFFAHsFX2{wT7yEl6FYQL6_Pe;}j@nAUa z#Y%Ap=_)TlQpF9wtrWY04+wi+`6HImeyg#9m>bh)>A&a=WZ)y%YT?N_G0g&#aQ_vl zx?0KZrp056;_*W-%$Eyh3Z5(}A8Z$0n2=y}+wzw!-1nmt zIIq;$Z7y-p6C#6;{Lm=EK#7R0(8Q93X+=vq^eI}d|8#>i`hVH78@+^x+Q3R|UUp}{ z4xXtmsCBb$dk=Ck&`vHd8CwpBo@com+(cI;IO1xyMN=lC2gVDoLMtDLe zs%bmld<=-0(=-eNM{Xh~l0g$bOYy+i?{2(lVr3>sf3fBm#`9#gm0{_ANWQZ3lRKNs zq1vs?*jP#(5TufUAmx;f@gtPHq`Wr^T1#}@YHP%!+D`NBP)TU5GAjOo@qS_VRZ%?l z&-nDq$VX-0wmpZnMyTn&y@+>p&hp00ZhX;OIOgrM$u@^Etf$tpWM0#7*rlvX-H4ns8xt2Nl@^wHBjVm$l zu>L2=XF|+>(KF3eC&xIu354f6`vOj{=dkV3%__0_I62o;ucpit3@exsZe~5xs$@3F z+pOjJRrW#mg|I;2m@KCz6&mZKqy!~0C|WqZKJrj~ucZ76IP!`doE(y*GAEE=u3O?> z;2EPRlcn!*CE*^Kg$>4FxPUetfWal&XFLog~%Ooe`KeUQZB*Qhy*jzCI0-I0jqJADnl7`$kelDT-6lsp+P(T*{aIN#!R~9X^-WMf@zq0HJgid9ZYpZFd9U zfK&r&jV{P3v5hG`I8)d9`^Wb@T+b*Ezd(kehVS|ej$L4wVu$+%qWA#c$p<19yq@2% zyH^(&@C^C~Wn~9xFl%3p;N_7nKI9{QPYSQIc+JzRJ6n{@Wy4`GhDkWdW^{y=Nr|00 z8^^tyX2L78bWY!^vgo7!g5}w5Jfv3KBiN}QM_$#s2Be0e$dp;YYNw3)v_$JEm5JzA zzoX~-(<(Pj7j=b}1=4vub=W!hh@wjT?aIrlkpZOCHdJgH za%Zh=nfGlVobhQgo7ZK{_;2{J0R@m>o*pB6iGkwM6|Sblah0eKgG=x7ZPu5~dq4k? zrscRS>#~NBFE%p*AG;%&b*>!!(|ib4XvyXe)nDPxJuf92G8k}$9l|!7U4ivhad#uy zbI8P6E_av6-!zHln;g@U=EX-e>y<%+a)x=g%G^rO>5ILktW5h)LS7Lfcd68AT|6L7 zkTDNBgq=h63|CihJkD1r+Er{k;>n7q4r-Mu!<%a=6x)-Xuwj;RXR8V`U09~2Z~O2i zl{`Rl1R^}A)3}g&_^)q;=NkRFhY`oMK<3t$ysdNgiJg>|+NF=mf-kn>RmG}ylloFHt!-~Z#K!~EL0!w-=m9&8M|z@mJia=@IT)46 z@kMLs37WE^YVI-%xWI&S+`Qq1G*>3#4@oPn@$$bMwThPK$` zjgdhap#5(QvKl}#B?jiI^iuiQzW|S8FXQJneEO>oTx&k5O7JY1BP~rLPPPl>*J+*} zP32Hm^THcyy1UV={EJ7afPGjbZodfHRW77By(@5 zr6E0dM1N3%^1RO{$`ZHN8ER2i1q)YbwZ41YYj`E6Sh{?Cx2RxSz+ouTuXZxeA)cV3 zjefw!#KEZvw*5JC7^5O}$Mfr#w-aON9~9<$ei_MdwhVT7J2&FC&|MQF!=5>kkTt^0{P7Y@6v} z`u#XS2iB%tg*sfb=UsaR1#36q3+;Jyk{`}f>8MzE?D*LR*6f|_Ls^3xT2U{K<9mvd zEtwcuqIeClznp}O2c;AAKBG?TE8>-2l$6T|DLz=YyIJ;LKFodqht3yCRNp17%Q_ZH zYAM7Oum=d0Cj8|GNo2TnLw zZW=8-tg3Yh2sp{3^lPLyxP2Sra%fD&Wry${0(0$RH3$j9YG-pefTCP!ef^>r+PHx? zlvk#VI~W3v#fgtme;2=edl<2H!*rCq!zjpe*=7wi9tZAV4U~TseiVLH)rfO0>JYJV zDd#Y-maB{d+eQ=FMnNI`g_6U{5JYtMBK|D=vn#*#muvecx)Sh*pcjL?ui=@})*TO3 z{~o3ILY$A+0N$NPtR55aW}jrox=IP^wIw4BJ(K=jCq0JSk%@N)0>(+YT?Ps-MKgtz zu>98czK>#@QxDMrq?^jWa)=$S6Lkvqi_GA1Nv^TjJgDI`nu_9|euws__1?(p+%vzb z5=Xd{i#opBopy_>1@#akI1~$Dc`BQ#n_5t$kK-Or?>P+1^0#d;E-JobB~WjK%#Qyp zP%pg2YNcQAcxwbGh6>!7t8j#aU;{o17aDmaa#jjPvevY6$?F*jFZwd@v+js+egD%w zIV4V>63MNTlLu^*suSE9ziNnGpK)&u&Hf!HUe9R1%m@K0dHHlg$Xdl3hhT7=&muu23RBR%WcaQmyiOo(O2pCX1oQ1_P7m9;Rcu?V#?HHwI;#c3AuLR*jod9 z(pYC38ouK6iC#wz=2@h$i8E%Dig40wL91W*p46;s-;f`qCq#v1{a2Jb%@caaf~pW5cjZIOw%5+rtTuq~+#>Y$P4Ai^J5=F! zeN=|}4Mz)TL~KoE{%|gMt?SY($;|_UK&)^QYJ!8!v<|9aXfxqLV2xa!@Ucj%|KFWl zYYC5s1(pfE`9M4HShnSK>Karx=k}5mLD7eU=EtYHqq#O{)6c?q|LP2DzDJrS_a?iK zs1M*GHNX7WP9PGM-;uEAgmH&(geWkMN+^o{LD8M>8$AEE)3zvmhd{agPberXk}{D} zJy<*(7Tv(h>2fWDMF!OMkiQERIctF$#P0?`se|hmg>R7nyS{K+O2$IzaM9Hx6}TNK z9H8>Z3HwAB=0Ym1a17L>|4+1XZoPgDeKz=tpCmBXoA$%$mGfNsJo+ycS@sq0cJ{-u zkpCLET=s_TL48T6LIlQe{n|rh9PeZ7>iTF!&%qR?LY`0!Zv6 z{k6$zh`8FG(hJ-VbQg)7=2@9BnU}v*iM!twGZ_0mU6n$x@DU_s@}P=Na@PGX0Cry< zsXsA430d<)`PzhxY2mJM5-)|AKUwj%waQ2I9=RY`>Bn{_=L{>f|82$`q`OOs} zL4Lz3rA6ZxIfpxoJg8Tpq}H`jR!fdr#2-)rhYvJ{qI}JNxZIasRbkxiyCcJ#eQXV< zdt}Op{s+aIY`O5Mf@XRR0{jW%xe*o@TK4OV814J;?{EV}7^a-2v^dLe-QcuJW4duT zqR}B@H3cV75o=XqlzK-T&nxbT*ei;g>Q0}7Y^R;m7 zF!AqHlKdVveMik0{`rY9_rPQ-g}%c(?esvl2nv!K4$XlDncgSvd;z~Dp5YK>1L+-} z%{^0LrViheGF%*Zzmx~niM#i~=x5WT;I0SOu!qw44h@s6Zd=z8y~Vu8PN(m?JdI>T zcyma`bFt92jsv~j7<-pLpc`O6+66OsGuth1oI;VWQ%C^Mo87e|F7(r7g&o zjKFsiNrE9s%lJMP1;2d4gXT{2T~cvQ7IkmeRsHdJ#8xX>00vKV`%wwyP1cf{_owY0Qx3l zp-i+;{zJ5#KuCuHOdOVa%~~<`{{C^d!kzcly_Opb@6>G}uulLjP%`G;G61sy+wb8m zx!z9(p7xrAwpO?&Y^q+Fqx^pc{`wd9jz7m31KE;QVwk zk0lK_R!<@Ft|l-kwdmkP7r^jAjqmWtuYjG%kW}sLe!-KBF-iYCL-d}v$?fuQ>Zma$ z5gPb$w1}xo3q@edc3+jt#7{cBpe!`$hCO`pWQ6qSKkdri0Cj@0H9t~^Tq|sobG$5L z!ds(eeS6F4{D7=aOx+6_4`~XyRvYKv4uaC~6I|-7-xgjnBcAz##X>^{v?=4@ttRC( zzLQe)16-r)vT=Kw%o9LUPzcbvmd@&JmRa${a0Kd88+z$)xUa@;3^ioN;b|lS_pL?8 zIm&kM@3zDdY&8)Dw)P2+GAWUztf+^qgsr2ASI^K%o+{APt><%O&;~MRu2B;X^dYmQ zq8=#z=3Lvp>U^~t-3a3qGQ2>+hzsmFGNkPxlTD%swd558+3|nuccrV$r~FN>G^Vhz zWI>EbBejloo=R0|V)TjP;*ksdLHjhUGg<8iwmHxX?|tPbbE|x{mZgvsp#iWOxpzzo zYl0YAQMh;q(|NJD5FUxj(?OJV{MURElF5(O)#7$I951G1hDdXqtwalAO%5ui=j7{q z;_{yBjdQ57bTNSoVsZaB_0h+wjU)+BOSxK*3=(a~kMub#@bSgLwpqPwit~%NE4?%# z0Ywc_rQQ#p>Kd&kbWGBr4KHv~B#J2zm}7ebDhma<$_}EPfEu*hS7h|N`c?|QB){|Y zoN*@TNuW}hfr43pqwpZhRI;kDP@3z^UU~go*?OTT4}k)vn6U|7n3^wd9O~qKp~~S! ztbyNJp6Z1m#kKHuPmLSx{^`as&HDO*=9@5%?P}{;8_olcl3SNDwHH=Z`%!o|gy>G}hFtJ;R-$ub;U2RXrP7Q&HdX#>sf>+-IZs zMZL&Cfe6Lm%k}506n%zHsxqR1way^N&UBvQZyi(9%D{nZ1JYlkWeze_?UIBB=C0)w zm5f=yeHo4CLCOlBY3Ac6Kl ziXS$KYsDc6vXYatEVhL#8ecYiaC>PlMV~ebQ1Nv#$2~!dsN(*TVU9c8NoiL>xkN&>ll|w>Vx^)Q;AT#V@Qe@ z{&9fmhSlqcypL;*r;hjx_9msr{*9MMVnOMpx~{TD6=HY3WX!gnleh6m=>Kr`)=_PK z&DwB~LZQXIxLeWUUYy|GCO|3D;t(kA*5dAN!HR3}ws@gPf(LggP~7=_>GPbk&UwCX zt#`fa`!g%azW2TN%r&$3%v{sPSHWSi>^HEuA(-&7oQ$|dWTZ3m_$uA$_AAhAC)-!2 zW+BfsZR+O>eTt{iQ*NP+9Tq>y%ND%IQ%3CO7HHnvFIu%WNJN|O0d~BB-3lY?#Z5G0 z)A?tb5Mk6YsFSY8oA2iuB1d@**=p~&)6}t0G^L2Vip90a zZxU~o-Pt3O^QS@1hRe?W))mJyDrVe+m@D^w;~WBsf-|d$_TwjO_ zAh?@ZSHzyDDdd(-<6e1tnAx?Aj#`E-<4JNc{W zn?MLgSpEEGd1;0m_20Bf#v#%qv)^X=&S(Wp-hV51`!rUw#+K&sGLwAR=upk8MGexh zPNh&YK+wNjbvU=m%87~pt1r$=(pR`Z-bEF4|DvK5|4CN~=Pzd;Hz;y=Q~NWwwf8q{ zAqqNK|0T1!-%|9C$0{AOd~o-ThnKQjd#j{zZ^?p6@=oNGn9O)_x=nIkfcBet zh^`pKNl7gO1l6y_$00|12;RJ7lODC%_;b`TG`$K5mp(BaI<^y)jr??+7}tc2<4^X$ z*~iP~Ep2t)lWqRhzpXW;jO2#C?34S`NlhkmR-l3LPgIbixwcXdmSj$O{qe6_C zZgX?h%Q!GCgZZ3oEYN~8Z;dwCzmf1Kb{WGx(Zf;DI^W-s0xz3k6{m|RDz3=~U2RUp z&;wooSKzJositSG)!TO3Q<1_O^@2*^m!5;GhfwzpCkxjsSPTye`Jg1+43ExdiueaCtHIMYfd z1J2*fI-DDA$TfDk%>t0`n#w)iaOHN01a=i)F$Jwk=Kq~t?vuHO?$0}9AX{HgPOdg| z{@44CVnSX_EoGoee=~ln$rOAp-wCw@!rJI}T_Bp%s!8dzT2AlubgWA-Pn%B9byD5# z_?{b2JgNKfS(1h3^qMKlL8F0JbYq@5w;$7o`JPxBt?%75*=Zh%j>8_Jzt#4rR^s*; zVVu&LX*6qgOCzOkty@wtgUC*wHhAMs9oQ`MjBD#s_#C^zva2azQ(yQdO&Wo^uF_NC zj(Thg3?42JOL!pC=KKcGo|s!NJb9ddR4ec&lI8s2T3guI|2ppY0JT`hLJeaA^UU*2 zu2r0$alcF@Cf*UrxzIN5hTi~x1dYB4RB(%`X_%8Vf|^81olSutz`#oGE$M#%3p49w zBX0M}rd`mt))E1fzbF3~F3Joc>KyZOlTo5c?l-bF*0hmMD-#ij@3mAVm3kf8i*zs6 z7;k_r4Ip_Ok|M6iz8JDzqq3hk^$CN>E|ALWM#M7lcO9-6bZ52L{{YkpZhX!dO9yI# zN(upYxk9e=Tg>`1a+GA`Pva^(P3RD!DdJG47^n*iL$!UBJeuQM-GvjD=WYO!@dTmY ze6ueD`wj+C&1y$xgws}hjC=C}wo!y4m4;F~>3k%5Sn-}UfhGU`0m9^2|91-CqJgyb zs_Gd}78E%6Yv5b;gpTCDyl*3WIdsgF#S=+)xI9E_Vkvd|peBSRz1;SgTuZ-)x-{c6 zd3$c~X@&4Q_`5VSw&I_!Mk^nX&7D+7$}QhXOnxU5+X?EEwl~EdiRAWEyOzXk2Km-9 z3yoAvgujje4d-nmABGB= z#&CXTKMYkcjgj4w-0DY|2%dWP%w5zzZ#FD)TNrZ)Q-OUWq~(bqe6dKxsaaL#%gfBj zDw$N61ATMo?CGSE-gyA~2LSJVG;7{to5;3YWg$4o9W3L!v7fq1a3ugnv)s&YwTec! zzZ)S5&4EmGYfBuMs!Yzj?ds$-2Lh6BeKPJ(ky|pcpmm z!BP1DPEKL>8B+%HLbXaxG8^jcMnHBeFgr+Xh~vp)(=0EHp1|4RF1 zZ4t#5AO0-<%fP~(eih^gNynCLClw#P1oQ?Tv7MOHn%jg?cmAFVk=JTRG=&~-4msuEJP@BuXB~_!c>j2S}>G><(^0SjTr^!w?y!P)DqNAd{=js>0n2QZz ztj?shbXy z@xL>AK(arm3&bM+s$*XaL1BHreBdQ&c7qp+_hkmk$0&7F3|>3>yS<7HC`@&Gh^XTE zOe!$f;@kbSKn#oEFKR`dPYa+BynHP{#co}#&0o_r3v1aZ&m<{%d>|EtNB=e=)&Djk z9X{Vi&^34VRd*n=AlXh~t%qd#<;lB5IlqVeb9p~#$!Lqz6$+rUxneoBT9TaJ8S1{D za(tY+<^gV93c>zPbOJz+g2FF@cOP%qIzBv(U>%eNl*AdcKA`%YqbF;tS?5?bs5IJa z$+^6_WeU&_JCarS7!^AGfWibd9(qN-pCG&%7O{K<->CQo1c!pt_NHeETDWV|Mn35H zwD*bJrRvrls@a-asd7ehZ0u>otjqX!Qf#9Cwub-pB1vC&!@Sii_ZPSP@gBKY*JuZl zmYv>ka=m81)6aW@u~GAg*NA99RZM1?z7MV3cu?v&^j!hTb_>fvh;Es>_1m`2g|Ew1 z9ufD+hQ_HBsVXV8DSR02d^l#O80%?SO2?x)uDj))oSbnP2+9;S8zdNaJo|7Mhn+SC!Wf)(X(uDarIO4X<25c3!F z>OSG3y3iL%0f6bz7zjQcu~UuTH}7MxJ-80uYjp;ee!1@w9_loaK0z)@810g0xCSX- zcciA)sbRMcz67|ss!z`X1Eq)1aA$V}8^eNz8W?uRT zM4V82YAzN*MUl+eORnO;C?`k?(XK>sYDyS7DgrJ_TE<2Ep*EeR#8P!>ieKPDHMFC4 z_pv8?UNZ+3--veUxi6|ih4a)ED=gp4@%x4YLTG597J0D=1#O5H$$U zjdD@;-fobSwxK-wS0wGpUw$}UCBT2j%KpzE&0|8O?1gk*biC?dNbvpRGud?gH9xXC z=k6C7$Q)5evhtfH(JaI*#4T|JEONWc;AN1g0G0@t>c9O^`hg9Zat&EkOYBmF^*-}< zWVV&`CsXwbjk&cVcH!^&_$oy8^4jQEa{?CE>snl9%$x~A6`r3DlhxTu=4_Q}Wca_A}f-0O6w z*$Y0dfXBFA00*WViGH<9A(=&So4#DjKf0 zs{C}lI2R|*&z8fVo>p=&G^kf-QGt5H{voz~OC@mDCDX^*pv^Pe6DC%28Lx^PO2w%c zM9F!sm%@kx)JY&AVoZ*JxTAHO!1*BZy^yP_Z!8>yovw%CmiZ$(yo@K4Qm;CmeJE+& zhZYV)%mpOq;sX?oH&r>+HCxtAe@q$GJ*DNZS=9s)>eTufn}o^>fY?%ZT2Z| zgZU{Bopp26@-YD!PuOKVCa_t1hlrC@ys%5%R4>M=5_?C`oAFMsP3>DhFbk}`O=r?b zUvd#a@`$91^4Nib0G^1;3II5R`=?wR_>02q_}f9x^BX(i0b16I3)YZ%Zsq=9wv+dr z-#Z5)C4d|C+;v_&nmkj5cFwNyL1z7jEVN~m#lOR6nLj5?5epCGe5w3&361+r9U|If z+Fa2}C?91IUZ}Oj1xzYQ@FBE!3=zKWO#pZH+cG(fhRbnnv$Q4O@_A!!zzD@JN^%(B z6uD#ttMeB)F-|p-OjdpUdTG5*o%=aFg+M?`nTx6}h8R1BSlKV3)Vq9^605sHSz9WM zJD!dBwyQP+$s%1G_&vDg0MA-h;cYW@h#$SwQ|~*H>Vcg1sv2**9ZuZryTVcn%S7^( zKGNJy<@tfHJ3&8=b%8(g<_ZBp@fA6n9-X&_&b_=O2TP)T9B}8~3)G0L_e*+*MH;qR zZCvZlqKX>Y4)AQCWyE24lgma|WlHLUx>K*CNpkj5J|{ao@uKW*vVxH?fbB$Y<%crU z@N|3lbg90cbp=d>-I^x@5@N^(F2pDP{6alqxp7!>&}3>d&3Rnt3uuZkwF8p_JoZ#N zu>JOXB_e)Nbe*?aUsQ%hz$#fpE2nGkEsrURNdkg|L1Q%36r4Q5p(?}XVIIL=hhXF$ zXhu?}0c1YEpf|I~aX1J}9j)L{Rb{zebt}U3`Q|inZr!rEb<6T522AC3S%<^ZLWL{N z_&tZcVhf%LbL_ibG>8{8OYf1I&8R5a5PkNn-jqioZZbV76^5G)!Q|woi6|SoG~DMU zSE;9H;aYodCu$!~LpF#r4q;{&+w@PxUo|GUcue21;3okXi;}nxBoyb zo$u6K-7=*A1^)XoH#F_yqR8aS}wk0gL9Z5h*3W2pz1 zKjN`=PA|biaZSMmM+>pzGFgnr-q9pAN})UPHA1rD?!1m4TN9A6tsQHeEUpLo5v$xr zizwdYu@EgiZ+|1BS7-MRlKW=NF6r;~@tH=l%`L{Nr7LwysXKlq3(RbR!;3c0n>~0~ zn^_;1T0<3hh37e+j8`7bF)k&&mH5na{nm_l=DQ4l|K`q3Uz)p|6qI2B|~c) z8Uq5}RDDuNTN2C|IKba==v1@=M>(c1g^OpJM$IG?&AAAc-f4cFGa#$?TF{z!U3g)Y z$GA7(E|S+%D6r(AXxPj<)C;68wcU-kyJ(a4jjs4v|)qh>*^g=htr+0@YjOPawG6X#X@fISxO#I2h#*}HCM^ECP0FtAsxQ#%A*8_!~& zT^bQn1|p`ZYtL}%gzL0sIG%3z!@^+mdMW}igS4|3x7pzd;+}Dx<8PGb*l~=rhFJ0| z-G*=}w|>dp#=4ck)N2p#K^ix|-VUS$d$-v=ZKO_FFYP{W0Xf%!pVWo1K6xfx00B27 z){70d@D&E^?w#b{mF)0(%jTehtR1yW`=$gemJy(nu@~UNUtLQp85d)3g0aYIe*A88 zE%DHjDrte!{A_9J9pnDaQ@)eNd7!!FB416U7%Ej+igEatdwqU zb<>01=)t9Ha zZj7~ITM(v%Ksm}gf&iGC=ih~oL6~>r-KnSAZApy@khoz}?@v2gu4~OA+>M^O6Qt8Yvd81Vw z+G6$Z3|8jnLTgUZfui=6x;`6nQVO4^l&dehBm-MCY2arKAApUpA3+$nXdP~m zdMQ;g3;-3O;b#6(j(&v%*!Lqb`n;^WjU!*%HFU|Ei%)TMZxDW6X6X#ltT5f8Zw+m1 z1{L_kga}Q>Un9ET#r|NW?s1>TLP`tls>LgrWu4mjBL#8{>s5{VKjEr*GQ^pOj=Gf| z@$Q)#2DHo_wR4emTW@GC7cXUm%jm7wzhvOyvejm7eWvnk=-r1-%hj_X{qIY(o)dnO zjkd_MDoMBZNo}7+)`z@5y8gfol9W%88>0E*3FI5Hs1_xE{OT7nz5GgzWXGC2$Uu#F zX?Warq8tUVPtcaK91-oOY*o|k@rt$&wz#IVYNbpy6-w3q*;uc=MCRVvH>+bwW{0RP zxZvX}seQ_Fb4VPbKS&*N#l}86m_Jy#dN8CzNU-f#ua8yDaDAZm$X-hNg~j!PMSO>- zWHC1ZT5JQ9@4SFMK?kOo3{eh;&(V}B_C#O6c&|vSnpvO$7ILb$d9P_}rA{v`itaVm zyIR8{KX-x4O?A@xDh?F6Ng51aJU9JpG8jT5o#UbK>j})81(w%VF?GJ9v(QBxP{@b6 z$4Rbij9+}U&Q_a{osK`(pqlIgZ#|^tp?J&79}#OZYKT)lhs>?F*4461h?|g*sazgc zeI^ZYN6*l`3LtL4S8dH9T6vhA!4vwH2x;1#Yi(PIqY)#ljz~FO3evXtNrkJci|@(e zCR3Bj9O|T5iJ+VL4sleB$=KySPbn#6WM=PNbt_*Q(USfO174;%$-PH*=bf>1>p?Mj zhVJAeHdQf0<5cGLZlBt%jT3{{{oXd5AMRZrw92Ge^|!q-jb@}qDpZ#jI$<rv z!Z==dNB=eKd8_#zme?fd2uN5Fr=}1iM!qBk>WsZ*hG!tch{>lZ}>+)$!eoDD-)fL2PQTN|s zP1BoKUuvKQqVbB(r;xq>g;Z*-2#GC}W6#f3x<$;6QJ1UL4M=~i*tEeDWj3_KlbicO z>%jja-Uc$e;=iLa@?0nkX3%QlJ%f}-`3APMH&r&V`s@)BkXX&KW{d!bv-kn9p2NZW z>r+a12bq!Tip9c#W!ouE_Chtf#;+*9;UB=)b3H~|kM){EhfWY*-F(`9)(3?;-skEs zdHSGAb-UJ@m)XX3ReTmFO&g&;D!R6`tgJ8U2^Ual44&%0XBZ_~iw8`G3tcm;PW^2 zj%gIuYTkWKt!a7-G{ZQyWhT12#NqUYK)&zepU!v3WNVyU#fR^=xYHSbAB@cA)z!SR zIfVFTmkP@g9A176AJNuGX@1?N=}OI4&qNwA(pzo|4`@*gumwEp!P=h z)$%&Ic%j=H%ljBP;p3?WOv>b2aI8}F-(-ODiiH81Sy^%`xW=%wu(0esaw0M%fJ?MC zMuX-pp)n?=KI6dU+C*f-b_X`PVS_!TY4|zm=;8f$Xv-( z(87C>G&HGoQ-u)c4c$TQ4qf%nBtM@K;!osFcE36Fb8*|R+z6t1xlSILhP=IqeuY!F zd%zaia+k?Ddw-GbonS0J(K0z#u{>R+@?>np?y++F$f&nM=GM|lo6jxpNOlDTbLY>mhYk)oav2+$bxL!l_s*B;_j zgqVp;PiJd$A)?kV6>cAGBR2WAog$L%+Dx}9ZAi4%N+BzR{B^7iQo5X#)w*O`ojy?S zde+EW^0x?J4ft(QP8<;86P0=*ZKCL`xHOJi2r98ltt$cRyC<|TL8l2tt8E~3bY$h1&2 z7F)dH!xAYdf;EAt@O<_&Jv1)cFi(xG>Huhb)c+?2)$6Bq9J@BFe*g0N;<_@k&30K* zZNo3u6S7vC+5>V_=l|5|SVbShGij7SpJsWNv-*nmC){vhjVBD%t7IBx(%?r9J!LBZ zGGaSJa_%2!*a@F9nic?dns>!rOF#(Scju;13Qus`a>$ChjH4A|Od~-MXA!K>h66DF zTB>?dfmNVARY=2)zCnGUeKo10CHwZev0Ny{U;GEsu^s5-8YS&+|Di3`!NR*OpIA5}c1EOtm#9t}d6Y8jVSq_P-wF+mr#s0?Qq2)-58L+*d9uyn&d-=CzRhm;#hwK->@t&*QAKz?9@bQ!g+UP2=(t(Z6APj`_HXN~M`OzlU5{#&Bf_e$CVGMHnk}SyNzIsqXbi;4 zst0n;5|TiUBcse_V(;W_O*h%L3*&t61#Q_A3%InI)$IB#34PJc_s!hO)pQD1ar%Ro z+B@#?``v%sE{NBU7vAKL?Y^ET5-QCwz1DEg5>-IcrQGACH$klJK7nCx_vCmi@QH5@~IW(T`UQ+jj`^I=?&#yo_7D$<9*it zm8N>xT%F{)3-T1ib8v=%zoet{**RNx8BxzQDGZ8-lTLPc>ZpSRc8E^w2eG~Tv9QqQd9{jrY-lG| zu9slGq^8Eqv~Yt>hsm6awz2G#v=hr`Lv?V|U)x{$OB(uVH0Ku3y`2lfO#g+?*s!oOOOw7&XO?*!C0-2+XJ|TE6`PW$m|Qq*ZoN zfnd@QDgib>nI$q~tAhw$2AVgc8hpCIvur7%_0MQ=d#eCe0HWl)G$R>$NX%l31lM$-OUCiI zAobFkMUtSz`blcyEN4QypPZ6u5YR&^ntuRwAo|~k56M#kRPalW7|EnNv6swl9#=Cc zn*79+a)uBB2u;NHE3GnpMT|T2!^;MhbsfCtw$g%Ky3*mcNLxq3BC!<8>O)}4W^CVc zbCP;0X@Am(h~C=HB^ETgi$k#ifo+}uzN-7Cd3qfst+KqUjKx3Y0)&9pZUbDC#3cPj z1|J3N!kw7awb}o9AvxiFY0gsSw=A6lxh+CXVPO?S)M`|3ursKRZ}x_4mRO{TN_i-0 zu`^Jsyiy^IX);2RH6?CV z^V!JWM!$>J^sMGA1?OAYc1bz_>GMh?67lND6UimM6n?M9n&!HwJ6joV0ezQ$0@C6neN=z_D01Ca0?g98srd9Vl1P~*S3 z$}aiNVC$-wxfexvk z?fCMCBxC5Y1za0Km^DOK+|pL|(|BYgyjzP#z0THD33?H`f8x@pmcaAW34dXDaYa!*o*-F*87G@jN{X zEI=)v4Fc=ps;T}|l{yvQ$>;LaiiNAGs=_aWuo*DP+XxnCaqS3-kUzkwQCnznxF@#F zz|Utm5D%|HPQ3|vH6~-mapcb&>`DLC-G2Zl{{>UJp{>%}dwlTb;{1p8*>!|z4{$Gh znYUWJ%+XF=-I_z~^Ze5%1*#a%jCt;Z^wR!UQ2$JeMNBAk>`RKF=P(a|qH z-P(NrO~&K54*#mZ@}is#U$E1lSPs-i(zq?*3@yWAE5N!uQzce0tE>!YivWy-vR6f) zJ_{U!CR9u)dCc=^90zP0HTEfE!7D16i>VKgoWDpp2<4o%WTYHI^$dB+uo}WS4@%=y z>wDG`c;r zd}Dd~c_ul0r#92KdWgzT%e5VgM<=YRAIK`FFLcH>OI}_c*wCbKyk|*_NkGG#q5lt? zLtA$g54W)fDrYv8VK5VB(f@|iikF=CE(FXSEI7?Hci^Q~1H0OU{B38p~F zPP*>WQB%W9^Atp*O{zb}nO=nsp_y|l?+N^pFq?R~^ALh6Rr@%rNz_!DX;uXrG|Fuy z&kn}xW9WCbGeRX`>rj4U5sAs`jtb~|zXkfYtq6P=O13Hw@r zZ5wQ&;-)--V~fe)rN82XlHmkKHIy{@piJJx#-&W*sc~V2MPQI=_l)X25Wh4sLF&h0 z@`hvL#vKr?^e^JVdCPsZkmOXk^95YYAMJd}JZnm7--~|z4`2#4yluA~Wi)IqecO}e z()h{0!IoU!B|$fpUR{ie0o?~(p{M&zDDx=qV$Yv{nUT9+aKFJWU#)3(I;&aPTcKI# zd0u96SvB0s7HJvRM%7$xAAu4cJ$yB0md)gxovkwc3JdrDMq|!a4ZEk4=ND~%5tZqc zc?x(%PrFDwgeXMXG8M3KEUJdr^9O_&q3k1X3!J?4OPM=LLD1b;4qSEE|L*MH5%JFU z^~9z|dxMNwP0Z`u`(GAQGtQ2(`=+>S+n8Uff75dD>guEKN3r=F*8@Zb?RpSILR5{z z2V^!8ctPGno_XPvhR`|hTG!B&b$q}3$Ep(%tK`^R_`W%zq#U5ut&bG4raZ73(MX=619bWPVER+BH{$Pu(DgPn-6xr@G*VN33_g8o<{Fb2R zuA8F7kde%B{j5({xln9AU-BHQ{NHT#`HL5*+G>|7`l8t%Z_a954gUqgC5(L~Z`X+d z)=lP*KAWyNr$^U&y|=ZCv=54~j>|Omvr3Hm+AMty!BPI1+~xu<2agCvB%-#9lV zh(>4yPW4f)4Qu>$Eh=+L*Z#yloVQ1*H7uEkl078nt%@~IdZb|%#}M#T?*3wybnU_T z=zq`}4GElF(8s)+Z`#2Od@p?6gUA)y>*6W3e(gX1B4BR+VIn8?;PXP<)QCF{73VH7 zy4(=}4G!CVpco_IAT0|qF&n0&pFz3h72PA}sE7diiv`b+#kX#shMm!)rIcJ<6{0b6 zY6`e9y>9DlZm`|Is@MwVaBG10v0r|-$9Rkt9)>SiuCP3Pys8dwWm1ROoGD*csDS~* z0wHpGLDI?_>-KTllYXlwnD{slU)h_#i{b3M+v<|&33D5N;?+dhXNyNlEo9nP?MRv+ zbwK$8-@hp6sJQr3{yU$`{J)abqy?9FTP|p-oZSpnv$ew|L}C)+<9p1K2O8dm_LQen z1i2d^?sEIHKvtoiI-LbLB%c53Y{#L z@)Bb0;#sLZizcV!P5n|HKv@RUv$xoouIJwFrH*9P3`(K z7QKSxX4I`xXoyM`0^TenN3ip(RU!VsDxP3LC$Wev8NqH~!px_IBt^I|iG@+dra;v_ zwAP80(HNf&(|VLiW6?hRwfg0&H#(diT54LOL9YDT z%;Qww%bfk{Wxw&R*s}z%qLHtQWFuxCWQndtxIcMP_%+l)o5`9unzqKcXkIh80TZCC z3Wb=VLsO~Mv``U1^($Lxi61ss1anhv5wkFa(7lm9@oGr+VIqp~a2qbq3rUgVQhlPx zjwWrOiYn@^;Py%4kbfQOzAJn5*LsrvsC&y3$BA^zd#+S1X;8{s*r2}(lpBKXQL6wI zaR2n}kRo+UTl8|auH%|yn3{rYeYAYfMRo{gYl~besI|Le5#>;}PDYmESUE19DG~JO~ z{4Tb8&Ebnzq&Unu0?zdFnLd}}76YRlV}rpQt7Eu`Q3^Jp!Ea(9XBJyo!`KuBEg!K( z`ln{)SV1st)S%U9xKx^9XY3b9+%W^{4vhtGcx;617Fm8+ZTcIY%EbK>!r{`?az)Cc zYK%(6Vr5l8rJ2UP5vJ%*w5%q>3+>Ov_ykWB?yA*eGK}*dkcLLa^6w|LIsejN%SN`k zjHVWLCI;vBg@qKH1x$-L3XltpZ1yYLnGB^}8qSF|lx=n+pO@jNF>ua;wblVovYv;TmIXm`m_M3G-(5xB-@3*P?%iQ1M8}~KgE4Qt+pJCpp~p}SSS*z zFnZhVy2uHyuKn5w5>buY&+?{xgLw!d6%BH}f0b!Dw!`QUnMEb)$;69J_iRLKFAU1&=umy$i0WBH>VM@> zfV6}Z2M>D>hD%z`*s{A>W*d8DWFk>cI|`ag~6`A1aA zU?^SIdHlUk2EyI+jzUE8qaQ!T^M z1y@0FSCkz^JIAW4$)~J&_V?k~2hnSMe;@sNt!y%o)~^Vr;r$OFh+tR<+sS6?5N;$# zO#Gxplz|_6DtS#C7ZB%l@J`l&M&g#2VD4~i;l2Q-Go`}VP`+n?8S*&_O;vU#dGtAc zX*wO%1I2O8Y1A6$zh))pv8jDM@3Qw$6Tb9lWGFQ|KH%kkZer|{gfP=FVOMPGk87nl z!(7u$m9Cdvs5<3zIln!6+*--ZpA33{_@Synb?B39@Rz5}sWA)Wm?!pSKV*5R4%qKJ ztbBQ=G{)05dqk(x$>tt*xESx2RCOzduZ)O;LGv?fCj-QBP9xU%zaMNfpK78l+XFVr zUTz3YzJHussgLn3h&#T6OGBvEYA5|wN_sfrNVsWEwlPqJBdvdScH1O*H!}isa@ZXQ zpsd6=tz`(eI-78U18vQ4jE>cND}n-pUjeFyKfkAhMn~Po<>ze95X;^%axYc>?{S=kV+Aa+J6`L+IGxC;|l&ivL*2&|cYM z09HUoHwpdUZ7z_s2eLeKyH?e5GA0>9L-hjo?L}&<6xQaaY0*BAUs;GbF6&5fIM(xm zNXgKcc_UFYd4YDmvz_s}G#wRz+qUQL5PRG|xx-2b?!KXhllBHysG<5FYO><$X~V7r z5=Ro9Og+G*=t6ewxf5u~FbfmP`e%*jxlTg1mx?EO>e6ImZWf58A*n7MD zMAh9y(x-83#m-U10_7`~Gw61}=(ov7lSv^*hu7 zOyeKG#-?HDU@Tg#Sn792_gCzCRjsCNPQAv5tcVy zYX2h3sn;#1l;B!_wEUlgxJ9m(J*0yJa=n8}tGaYiFPBl>bp}e()=y_ALpy~HX9dWO zN0i#UJNdDNxC3K%+*h@)>-WkQ-CaEDny@kVj$&^{$qnLnM~9}*I|^?-`SD4Eh?!?r z>bsae5WJKX*!*_rFFLG^UZI^6X9??IjiLZy%;JK63t7YXACRVcbdSO*$eKqh0f!lh z#E^Gl6BzE#v@eg3SJtM)zFr{tz>FRafFPt!Oen=rdX_pYqf5g^dCae}nQv(RXLh%{ z4E`=f1t&Gm>+G-k93Eg_YVMR>_V(U~8l1e7t-cq(<#m>pQalY?du8WjG&tV2N4@xa z!V`rMb1890`Lr+pV?uHs(+`Zsn$o+W(Mh+#BWF2zDX2r|No{^QFA62FN*5AEe-eb_ zOKdi?aiUN{a{HKA`=abOMrcnaY3F|;1F95mHw&Y4h`Mn^Xu2eDy}!2XlGzkXrpcJ_ z@k74SIS~p%h?BfAwlUKG0TkKNrhk!D8q+MLzC1=P#Vaz0LX8&3y(b*szHQkum(>K_ zVrU!%AJ>Nl=eyiQTdA6)vU0S?BUtn{1g4po=YTs zk79o+_e!mr79&qU)($*V1Mb9n=*VWM`4>w0HV%v!I+JpI_^Br54UdZ_T=oP*>mR^X zi!|u^A+Zt}a!X?JXCt(os=4^Ed@E}{Ij*}xnf%J6>x)K2eiS_nL4C$06D z6fGJnw8~)~p6cdqqfErbX#MDMGg^~zbLR2t?5OKtcABNm6{CLuasOIMh@22a9a~cY zoARpH9F>~X1We@z$Zf?0kF1xo6J<_uB2Jzkq_)jGEHyZ)>liJB=Issqo=)0tNa!jl zqtbc8P?GxtIOT6#N4n(5IfPBOBcby8@g4F^hk$D^u%RKxGF7zi!{ry8wy}^qU#+P| zB1b|$SJOALtbE#m68}GF48r|LexnHa^=Uq?Rv1HUI(uKQ}8jY-3(06@QF( zZ5H7Eg=wS{Xz>ZIx8mjiq+&~(Cu7#!wa6&e- znoFbco6hWQmoG{-HZPd=+_Gh6_B)puqF->I(j2m1y5wuykkK5<>ov(3fETGz>^Tgg zqa;z10{fSfXa4|tFlh#MaKsQ68V|BA$>viY_ASNm_SiB9qkhoamNxWbz?h@M2u$tm zvuIjAmX-qCx#R>I2yM0QcQbVD>3a@1*O%{d+Qr%R4EO0}I=T?UNP$A#s*>gQt*VApKeLt^Ew0ZRrDXS~OA zL=NQq(hR?4_%S5X#?+a=`p{V7AQfz*d@JEaLq2v-j1gw{WFM(ln^%0TJI6_xB{y_@sRgOW+(5V|Y4eyL` zo}|+H^O_fJj=4<#0A4)i>T?;8$>I(;*hFjvzb~6PO=F`VwJhMGD7E^Ma#dhHA%;=2 z44)Lb%v*c4KyTcC)xBIgt9x{LAzto8#4gx+#QC1va~wzCHUAZRVMUM8Tw02mm*|3N znm3L6V}3~Ed|q22D_QwVP|H%U6ZLStO9+sCFMH7zao!(i-N~7dX2l5aO|lXiiQp9@ z$IVrb0$y=AFD6o_+RTV{i>a(Tt^{|!u@FLj*%$DY-mUeyhyXyDwwp&~Z<0m)e(8(NC?-BCP?SJ6M@4u8b|C-g8Eoaqi zsbLwagpDWC!fazX=cS83gK;?hOOrnP`j0sSbqvWM>qQ@&zrnr%yv`aVYUubBrI|voN?gA zK7r4JtCtW`Wd+4$hLIS?KWR2=S!XMnnh;jbYgB2ly-G&Q?us@t*%lUAO(kMXyZey2 znC8vu#Ljt0s)M8N3{Ew!IV6wt zi~t5LD)Kuf90@+5A>vW**K>dQFnz~+5OoOH^6pq%2k}foS3W4mnI-Hxa=G_a*a3-g zQ-C_f!9yfbB8l9o*8dM@ZyDEi&~=MKfnqH##l1MR6btTzP%OCCa3@%S;#M4j7Plb9 z3M9A`cMb0D&=&XJ^m)(w-gCa4d%yD=Ci}nlnmsdX*2-95+_Fp;>_qO62q<6ndZMmg zjuoyyIEQyXry|vQ8|Yj=;;!EJjhwPnJ@4Cd(V`iW*0oZAlI%}W7Dn1gj~@oSCmr#K zMv2llR%}d^oSgk{Q^5f2*O};vQ<;gwQz9~{0*#Dv(e9s=IRZcAz zTCmrb6g=m~TKC+6KXk;Xyq+hdkvQ-CqGFu{tDLG(M^rmn!0C}6f2Y?vQhP5f?@X=Q zId^^c@o)r3Y|Tr=+3ek$+Uj#ev6<$-&O9X}FFa+Z?Ey7^HN?bM90fPgb5Z^SZS?^ z#eV+wTvyIRbxcz7l47zEGwUr-@f3URk4(UX9Z!Aaa8SW$kCNiMky?-z_L11*vfyzm+C7t&r1JavTJ!i*O6R43Y}G~;uvZ03 z+A#phPsaDm`Z@FQ?er7(!L6e`y$0g!HjqUzn`+XOWwYWhEma%s4pk;DO^_~vOAj5T zM+A~7puCNu$hYYfK}G`2e{lbfl8rRs8MlvFIK=|2h@F0&H`j^m|H zhYs)^6K}qqoi1MHMs4{zx&NZAZB5IXZ%C9Clg`2l_lv(F1st{QfAHB%C6eglgnUv1iq)3QG{eul#Oj3e;0L7Z+un)!uL0)cFkYOVKB z8{J$3rs%-EoK0%?W35ds?&m2}WzW1cnk5+p5f#9O0XZ4WT{OT@ypXZ8@z+!WHj}q% zS}?QfqV3}2rn-Th1*l1~xP4|ZG^7m|=qT?Sgdd?|{Had8r);vc+M=BmW%2Aa_AvVG zFPb4WD!0x@6bk2f_ov3wj~&qo*j^?Ui%{DBTHc^zjL;d6!Ta zh;vTa9JL1}BX9^TK;q75J1S3NCV!}?M$iFoZ1U#{@9Mn=!}p>;J&@QEcjEW$BT*(`$RHXT;0M*1U<4Ch-*6W_#<`p%}JFN4!4s9@LAg{#x zTO>b2LwNTfyd^v}t2T``ix3s3zAfr)^Xyc4of#h?Q^ClQt9 ztWKyYBRP#+wsjMt4AoYN$?y}fjO$=EXJ{OVMlBA{*D9E&wNKr(BZb5(9Y zFB$AR;?L@DU&(O)Y3f`ru7;cdS;y^@vQN;ob*e447EcU;#;T+oC^PQ735m`w+{!ke zcJGR10nMb3&pS3b%uyJZw$MofP%u2Z^>SW(c=;?W0%+Z!;{GEUkc83x@qs#OCtR^Z zNabq4c1KzUrLHhk?6Ci*By&XCQSEl2AF>{91XXtgM>cwV?m%Uc)Tj2;P=$uZ@5bwe zs+bvm-`dO+H?<7Q<68Jhj6dSPsnlYkTrzat3Vo|I^OMUEJ0FZ-bHmrVA~H1S-$`5r z3N}qc19mAj%S8w)qvu55&U_9#IS{Br__DtRjyXucpiX_<8Lqxh9!QB}KB%g^SbB3t_ae8KC>*vR_zw=hdK0+swq$EhN-*(a)TT^__vL6o&dpo1_Os(@@$%~g7Bv?tBg>~5 z9%k7Hnm3-!!A-HBAcnf5suOcZRG6^t`nk(ka^4ppWUY4%Rz?Z@p*7>3b?A~n>LxoX zk2E`TWF(r^8`!Z+M49shr{g-f@RjEYk~o19DC@O~>jH?Aj17|y+<3>N5_%$hC)xJq zYQVl`YXC|0b;5mQkkf|i3$FzyIEbjC6#RoQn{0`=%B{H`f4Rw_^4PJ_gr{CK`kh7F z5ah!EL~IHfs>0>)0p5T@Vnsf72)N=W^HGq^2P1{DQ4QmWzi1`4DD1etJz%r?VQiA% z0a|MCRrmObH3;0Ega4~0fTTu=r><4e=LEj1?sgwi!LAATa;NDGs$5vWZz0+>4x_^1 z!NXf@xbLj<=T#$Fg*`E$SQ_cJ)4lLzwiD97njH}tHy8vv zj-nq1jaOVzvByU+$=e)D(pzi14pLHady6V_V@j3R69*neNgWiJ+@9 zh&)d<0Z%M&iyO?v6Zr}iv$DJ3=Ne}~fdJalVinQAB8N|mer|Tx`Dt#lHHQvN7Sq)k z&3%r4up(N6PEI4gaRa&R<49TgPwc~s3%%0mT>c@lavoHM;DbbM zzc)&v@`vi3g4>8-L*B0%X{oy1_CxCL!9f!8Io`Rd&I%0waOv@3vcgzPi0ix6sE!c)R%n3|7=)Z>? zle}$Khz_zQU`3Jfo1!#8mScbszEG5HDC|XriBoM_bUoS@tqYc|oa+<}^Y(kwT5Qow zi&933ZW;XeJ6$@GL#}?A$GdX(by;-CmJ|_#Lt-_;o2C~GbHosR88P>T0;M!3V)v_% zaJTo*(Ld|Q&jgISleA4!>a)dbe7m1*9LKuA;~^h+IcU9_*(W873n4I9$vHZ-@5K?+ zWf3T4pA-iw7`!sQl|}2Vs>dbmjEJQpXGlPtc-oou2Q@fSJOvchpv4OVxO5j44`5A~ zBteIt;5^Rt>`3ooiC;$0wmm5Fr+Y6Uog*oo#fz0?S0T_!#SSDNMB?^Jo1OGU)4l^I zYOe^>wOe(1sxT`=U)&)3b=VvRa_KyjMJ5FH7rz*j3d(C!;js{nW&jerV|%l&OXy0^ zr3Y*@@u^0gL3`)Yl4pDu4a{RXsPHeMEVfX0pO%Xu)HGorkX;hTPF;MO>EOuDJy+-m z(utYV0&8<1z5OsQcc<#D$nitYV^TReUZA{!1u(Ll6aKZ*P&L)H&;fov#^@7zG9<4G zb~nGc*cm{u#V06}2i3D?`5Ksi~L%7Y!7TnSTC~v@|64OQRcbH@TRj zXNZ8AY4JGwJUwViu<(}csh}HaU_z+Xx>f0jaVR`H_shrH`Ql0}l3a!L1MW|rhl!DI zPg9NKqK&smghMaTTVh)ue441si<}4VZeZ^|Cw|=YE3XH(m4@k38G$4Udm_haKGxKK zOeLD}GfIL0dwMX@OB{322TIyq+>TMBV-IL=5!0!ZRKyvl;VPWn+~POrw#gAp z4cRD{`FcS#z|Lp`WYgVtYB^siURJ2B@TVC5*y(Hd+0YGdssA|eVSLjL$0a{Bx;R}2 zhoyvZs#rVl#163i0I5e2Q&G$;IWGtUo4g(+CTaL@w=2T)LSAk>-5u-jRwva&`-Fvl z_nzd2jUVGw;3Rc4)TS;Tw&3^RWXl?s^lk0C+qAdv4gOD^R2@LrpB&Y+TV(&)Q&66q{s}u-o!OG)SVCe-{|gj{_mA7JQhm$JPZ(Q8 z8Bo%b?KH?W1Y6_OvM>m-@fVG-+{DmQYFW4R{5(Xa!LSfmZ89}m`X!5e zV|R1c=PI8qQ4B|EYcb%~_v?WTarG!tetWrTZg~-Ft&r|TvExq&wtg3SnVb5$=4t09A!(H^YAzQXMG)dj0=5XO?C!$Delk7*E5Bt1@cUi;#^8Wo2p zetJZ*rfqWAY{jL#YucVfj0O#%Fms!4+EpGG0A`+kB#SYtN415LZzJ(CP+O5};gCa1 zE)W#JsmYiC_SH#>dR7p4k>&50?tX;K4(@|-XJGks8S5s7d%G^NnmVO=3A`L`9BEKR zNQGMrB{Mm-Yy?r`sOudBX~sVRlO#p6;n_Me{(0c;emcm;} z0z&x-mEndwmTc^Sx0ht>%lN;0U7YO+-d$ySr%n?^jv~7pgse8?o33q5f#=d)#pxrR}4#+ShU9$yKl@nBDEDO^f5S4T{&1&!(&08k(`KkQtAQrDZWnKO zbI4*^$?r{swv#~766jmffpf02M~N$t>6cPH46X#NwO-`*{P3jXiDZ+Aol{ahz5^o@ z8;ExsB#tUobq%Am5cbZX1=nG`0EP3*+&ZC;(Ot)CY`B~T6gT)PgRx#={VWXRvJDzt zrhv}U8nyx*Tf5zhN`jm^X5Z3@6Zh{_U-}}0!em{a%GHbQn3zpDvRjwQgYwulx+U0Qxv9s3hqygpN>4?RNBO&J3SH zvarRDNP|e)RZ*~TDTA&{p=f-lML|gR`0fjda4~2{+752=YeCjIvOXCv?WFA6FUUF;r-OI!#7S(Y zc1RtYg)ObmNFOB1D4tLpi%Wm?P-m9p`W@jRt~fb7?6$Dw;V1&QCKQGFs)|D$Mncv$ z@%3B-7Fmx&IW>79;Ca4^`g+4s*vz|SFp_8Yf9@XvUfFUU)dKjeoLtqDNUg$Ee@r%^Vp z?gC5?(j}sPF}$9ZTMf0xPcXAbF*B2Rv!WK@_0emmnwOCoKwMP<(pVM2WmqT5T;W_g zlLhtUt0=#md>3CZv>Cp0$QRG25Kldefe{q*r25^)k=$UmB(09b?C;%ms=pT+>}%Q{>X zTACVtT{ zU~ZACGq?_inIge_BF%Q$?s)4Y_QuBBbG6JWwmMcpdJ~|_mM-%=8JIjo2ZvRwE6O1% zJl%rYw=DT&pK0FJ(bZ}Y(Uxkdn#?pn*p!J77=n zr6ie1;bC8L{(JL&jFJhmPNVgGH}6&(=Y{m@fr&E*0(^ zYUwgv0RJ%ei!pCTCzMT1s(KhAs@VY)5@|2QFUq3obyQ`zOG@{`(FlEEN-W8<^KH_| zaT<2ayG%+jLY(%xD`g*~C2x(ZqQ$$du*rG_wWIcUuyay3-t4!v;fO>!qC3UI-F8Ht z_G=yvL!>&njOU91jN0l6a_VV_Ou{3*IQ8tW1$x8=zvIFdJVSo99C{aMzXLf4KLG4W zkNM(Uk6-yX34MizDV^qsn(dklMRkgh!gaQnWgV`1yVl?I6PY^E@AfZePt^YQk=RT% z%fkL#YS|qdlujq-d(o$kecAf!wzou1(V|<5#%7e!_G@~=vRbKwLy}yadnm=!zU^MO zikT-JBDqFqWfr1>Qt)Qu>fhFu)bd9(!ub9eDl88LvK3y&zjFW_O+D2s>eQ4r&qt%Z zbuA5$b3yJDsoA1UQjW*VUJ2^~JTJNT6-u@EYu+3KH$C^Q*Rxf7b-V(IJIQLA z`~&SIQ+miMU}H>zW+o&wvtZ&mtoufK5;Eco4Sl7IdO(EH#5|#f7dRV-gt*}l7ZkA2 z{wSX=u4d21eupP6cufe6(EO4hZkbmn;?^RXCrvQu@X4V~E>>bWVGNZ_oG6Lou{?4^ zf)}gIE~vd@ca${s#ajS%;3fFTeV^l09LGLzzSCxwIhCkW{o*~nox2?XT&w>)m(aZ` zfFO~Ew(&38z_;Sq5x}1K-S;nHs10iD!r7}qV(Ezts!4LE_(ZrU0ib^NQc?pH{wG!G zO;4F(jJvbO_;vyqsTitWzGnb4opVlx-tEmCLpve-3VM5>yj(ah6@oDbH-dz%rss-p@{N1Tx`-F#Ad2_6Y7ec4qWgG;`&&KMy4+IS(`5zsN1+180S{W zl8Tb^p868sz(r5_d-S4L$R%Pe#xQ8Gs7sh$s$cC#S zt7l)KY%dmz5%?y^IGmUDCM0H_`+YQf?Ern8<|_ck?=TA=5_DEVN6vgrm1*IhGP_Tm zOsvj<4^#P|+DKX{|F2?Q8n$;%qzL+Ky>IeEq0cJ>A`+0iUGSkrX0gZeq$dly7ZKWN z9YztE3n(4;{g6d|%AtxKAFY{19YFGQ6iRX=zp@u zk~yj|GbGzz0KU#@EZ~_HvPQqx31TAz8}*hph#6;tONfbHJH-Q06nIG1HwK*d@#wqJ z$9nXV=SKdmCT-ILkLrjn;MKA#-O8@qU$ly34P)(f85z+yzrZ&dJ(l9G^-yKNYxMWz-Ya96;2a%^_IJqV0Id}$=T4qnq*3D4X%~bi-4W2V11h*K|D7c zd9N%ZI|QxhY-Q8A`zmXjQ`EV5=u4`^L(OTYf(8HAn{cfM$jSGp0wK&S{HHw2z>!Mh zI_t^P7k=JGTCw4h!Vg$tM1)1z3b!f;tmG92%ZFqrt|P|-}vL;)fW+b6wB z5bta7>WJ!I`(s@jsqYVl6z+P)gkO=zu{#@aR_vUc*1vP5-n*O)p6x-MDS-;pneWz$ z@pQD3&})t29rDW~ai8yakt1mqCI(qQFoxIh96HT&nGa zIodCXE@>s#$y0Nr3_JVku==|@lnB&yb`I4Y978$NcJ+@?@o`4Z$bPXpaB9Vh@wH7| z(#`$Y1baiM<5{W*tAtY(VTh!=$uoSQr!+ zJm%7P?@{(*5aR4*eo?HeG9BP=Qz31?B>h-rII+(;nIe-bOR=}C^vZ`7+0;mI`-Gk9 zLE~4ti(1j*f>*Rm;kOe^%y3o*Cev^MNO|-2Na9uU|hEN zf!a$zP|I|zie%u@D{Kh@^JvIGa@m|8mrZqH(WW1l3QZ-BMBls7gguN=A*<_jolG)DNjmjqmrs9vt?7yKjL55ADzt3o9%47i0f&q0W5p%&H>zvepZk;DU<3im8ZBb_E93+?Jn$l4gEDHMh#x#&akwy zucr)PK2AJ&TUk8K$L8$!R==rDZ%TbBPkz1pU*%PYNWIr?WBv5+q`Oq-oJ2x=1id5Y ze=l7y#}e?C4<`q((~|XBy?9yM_q*?e?3^4Lu&ADZVZtGD(?7L?vwI1@<@&6rXy32Z;~jbUB%iR=NQ9*vK`ktt^01yQ zQ~ZFY9ikq>{-A_`vQn-}KN=PJ5V42nP;SQvU7TIr%$|E)1>%v!QfNG(I)TO)BUz$IC;@exHBt zZ>stW@#p_VyIr_eyZq^AP`UIi)RtRo`}SGYqp5_0MkxAOpOMSeUe%r&lg~_3)xcrM zc=-(em#C~xV7i`B^pLGf4`$JcPCijGT`6Yf`zLm=mW0p6-Sn?+0M=$KD@W1yK{w=EeS}C`S)gLklF1oPpvs#i99)8d1-WJd zTY#R@(j=pR*Xl$CvPjT2%1}9VlPC zMsP^m)UnaKFr>3L)Mn4qczIx?xFjwKIJ*S%6ji(pZM5N#Bg;4M-Fm8W+r;tQCZPN++u;EF%e-upN_7UO`W3#Z9h0y zQ}SG{wY!nehiJH{aGe=at@xnB9hO{!lQD}iJl1}*+Kzs%H3E+DEd8r!rva`en% zHIzbv6Mr{R+f7<)dt1(g=BY5Vm?XVY&gUSMa`_*SFRFhx)upZc66tXKmNINYawLzg zz)QTDps|m~ZD5Rt%0jRy^ltydNaW&)&%ko5;W71gI!1p&nae}be}!J#Oh40XhL+?M zGAp6@5PmHy;yJ$Nk#-UjSZ+`bszapR$Y$Jg4S1%{<4c;9Q<(F$ zusG$8aqMv+_(6*6Nya4Yms=jAUn=wNZE2?->k`dUdG$(7i>q(&E#@YvRV#S%Je>=- z@l`qlSVS4AJ@2R5qW+>C+O3N$qThUM@*EIiMDd&5Q2o)|(<~Hw)!rL%S=*DEu^x{oNyP@(Gr+PZf43qu}*M-saSP{nZ%HT`s`?_G7$ZL+ZJ4`qz#3|A2Ig3X%jm!R>eMcTs0g zUV`8+B^=QCjExJiiEHp3SWIRfSAC|5=|j<(O}qm(oc;$te){jCq7dKQU6sFm(yg4j zb=aB6_ImX>%QD$I5S-2}z37)4LeRQfrFD*3`2MuW%RsNRj^5ymvlZo)$1+Z<@(-*3 zqRq^9I@MvE_ShwM|H{8S@-+4tXb$O@i_eAm3IBQzW(!mh!WBxa@PM&eFqA8^z#+$3n$9eEK3{ zSN;R{Hfm9K8cy`Y|89u}8J}e*VXAZAW~?gqsK6Ihvp*4WzVr!1XPOrW>VFu{%>36R z=y{2I^_HWwK8^h58}C*&i|F+cvCMc!jU{yI6b;q8XX zag$B5C-|J5pt?|QsYn$~yj~=mt$HaZx^R@%PmHXA4its$e71+jXCX8p=UVX}?YRX- zdzO`<8u)pa^hDIjENLTj@Yze^`UxIY?ZO-bUKWhmbhGR%4#QqO{~;>lFiXW})HP7{_7BCc zlB$Jv9Xkf`HsPrf8k=-<3N(E-phIxJamp-(@KA%!aJWw#flMdn{jbRc6b6 zEc4<=alh&n7Sk$zo2j-X&v#KDB9ny3wMlADTZg?am%%fOpE+Czwm7wE{1Y>T8+q|P z$~}0j7qX)6HJ1cf1-pzKnz=q*=Kb`H9pJxQR4#lXE+wnWU1siwI~u&v_I1P9b$Q}! z2ly7V<}lmS?i)73Vl96-tYy3C&XV?Mwt6RM(X7WotD`W*kAJ^URGTzPEQv<4`qJ3F zHvpm?;o=yUVF4G8o!-^kfG*I;Tl7@e$bofaUiq_Ev5UuHp6DM|Ahiwn;tp^quAypW zZ!?Ut{Ww1J*{4$S$wOh%i{uh#W!x^GT=boh_G?xYR1<2yFE@K6`HsJjmn8Byc2Cs2 zfOhvM8YR+!^_mO5`a+F3+~G{2ynOT{GfC*!vzUddl~P(utcZO(zcP;p*94SIbLmGx zI!Q>Xi}JVf`d7_ZX@^OJpBgZnID4TfCPqZ-pp=kOy~s_aw3*bqlslUR-5~I3{!u#MV z9ARcVXu`#3e;coN^o9Hr)$U~3A$!tj)wH)?AGfm2D7mdq>*M2b${P>*mzA3ivDEd= zLY?=$4&Sw%FcAU$7V`L@$e)aq#`TyD1-vm1MGi}9lhyD#xcAy!b@s%mX?ExK>-oQE z=0$s9QzW^e45OP6Sq)~-=k<!g{)rPcD}4Ta)LQnv^Px#|CH$}!wjepsY-~9IUv_wCcT7WmDzDp_q%%C0Tbf9X)i-d3o%Swe#p0L2AxZ(TOxpF|uKV)s5>R*owv} zHly&3a&O}Ty}uuNwHsGRsC-<`celTE)Nclrw<7xLLB^^PQR1T{VKgp0ZyLFyPs6A2 z^s+WB=oZ+V?Q6Z1I$GYnw7Ia+FHi}u&@HUl>P~8zu(_xgYAq3uFQBttkm(Ex`=y*U zIFF~k=A90Ec_YU3pjeEcbuepy@-#Jh6nH)RN%OJ?8vY0CeS^z<#TvW`x0m7xwl%Qn z+fH0ug=xs5Fv_{)zid1#0FoCqEu8Nm{khZ+$K4Xcca<8U1Ao!_3Rb41|Aa0cC;ml? zGa9X#EH#uvNM>?MBt6@yk!(xl(+xS~<&IgoIoizzsM}R(T})Fvz1Dk5+qN{Xb6BDZ zjFqLt4g}yI$kligzz=`fvR`)|U;Z1oD9xzq?aMpJmjiK4hndX~{xKtT1N>2flh6G( zHbbjLNxLZjx1;-}9BI2$o`=*>Ag4b!AzK#JHd9xI$JgoGL~utqspjGd2ZU^`SX|B| zDy|IH9av*D#u}VdoGtL2<^kwP>Q{MhcIQrWgYbA+Fx_OP)*AAWzlG$BA6cPWm-96S)3ugz&O-Tr}r4eu@3T^t$!(fd9-^*7BBQi8qI8 zR<}=zm&Lr4=Yz=CWun`0!b=e_Y2x9_=7QCfBy@!XJLQ7evpbXaeQnF^>GY2hBIB3& z2;nNJv>)U`xgOtDBeB=rI2q%#Fg0miQBx!%@Xx5HY+F`*bO2gB;5t$uAoX4MOAU3} zZ0azDl}{E-9Q}Q}PV|UnY{PxQ0Nv7KG$O)FS9!)DB)qgodOH*n$_fX;--vC-v!fWjoW4ypW`W~ohgRA=beGWE{jpi$`1=M_Y2L|c4{2z z6QvbYqG(=sCa2C)&3(!5?IgJhLw$B@k6E90x*A9^m_A6lVdL-rMa$#uT!cj~x_HK# z7}*bn4Gqfi69<8H0?G+Tm!EopQEiI+?>vb*pVsc_w!*jeycbZEu(ao65>S{ z{Ims~(5I6)jF~|=EZEq|;@pNduPP#^E<-XmpSl`83ZZwF|BHd-mt@CxwAT$J!@#jn zpK2Nx?WoU08X0bMX?^hP$$$UIIpe}}<7%;Fb)>Ai;9yxmh-aVv+QBy?{-bd6&87vL z3PhHXZjKd;ou#S}5f*n=G*vtE-fY#&y7n-{j~OxvKk@!awG{)Rn2HVyuuEL6Z8@e`jPA9 zx;vPeSPoDBiZeA6+?@8rRRLukSo1qqG~t~bdnk(Z-si|~McZEW+CKwK<20VUZa$x? zq~FKK$10zaLZs~#ll-Jh-TcvG2eMB8Q-ZsRpmtJW?I1&%Dd*_2={-ZuZ^nDKd8_Gk zi*NO?#u5h`Rb+hKK>7+rj_?Nned_B*E-I>>M3fKf?rnSvDp&u7UIdk^kXw=#o=}0A zPSNci1TJ){GqUP+gbeYDnewhIQCsus}3sq|6O^gUvuOuUM4u@!>adgO0Q@pqzs}j zl&if@I>z;TS6$xFMk4N7%^D!ekdwaSz2i03 zQs8vp{AgzYirkEcdb%@lG5U2Q^JdaD#C^}^@BM2R?rozm9Ltb@Hus~32D03=95F)! znu7;bx&8ckeYuUel+{mqK3}VwOxM0uWH89Gv!fi>W!JQ=s;=&PRXAP z0HT`=NHl6!wM(*$J(3wdyvtem^MC*f`z(Y%zWT3uea8w6=ex2@7CXRD7a&pWSkq1E z*pX|zciTk8_nbO=)XVMc(vQEgXwjo$@_6}Vv`T9M8lEzkp`RlZ8Zd{A?J4z%wj?WX zab@^_5M3uO*%Mk6eF`1dtDq^n5H1O%Ab%w9Ky+r4wIPvl(Nd`-PY1XGxY&%Yy|PVV zwUcQ}?!3A5^7LP3wULL-`&F8@Bd?ih-KtBD)rrMu3SZhOgy24hR)Y4Psz_l7Q4jzg z3q^2I_W_RlzD@th8F}YSS6YvaEB<>SN)#-QwM%kdEToTPd+zSEQwNuyr-337Lb(oG z{?bB2i~Eq$8oYM{A_I0xUZTGbHuD8z3#O3kLsRO|q-BnTyXC^xPpf>s89?I|HHi|WTH2||h z&s1LDfsIqz_5ArN7CX&1%{Jr6M@fV{=0uQ%<0ZtC0hgd}qJvHBilss{aF%{7F2(g` zb9X!JjkM17H7m+na|5+-fieB&=_j7^=@ZsrEffS-R^4NWBSif zRNyoDC`SI}uN{i&yyx-%pcd+KEG5xge#pz-z<3ZP!+L(UQ+w~Eb;Fr2T#jVXUShpl zLxg1pK8N#<8FPZ6ThPMbX3PLMRP0v1TPGN$s8{;D(`kA&YSpp8U${`DDv!Oh%ngIH z4dCKnE;0D3dHCb2VldRdx;bzRuJ0OSRrnX}?PZ(+>B9Evr5P9e`4Ml~F~_KKE%F#1uIN8Fjx`ya$@zP60qEaZ=Wau~vsIfSLb+*lg{E{Q$qApTS4WA(^l3Z%HzF(jR&VT!x|| zh%Hh`P~f~zFoHL5e>}XcyaijG3SE~zIPUpXuhpKR|7jj!`OQ*sTHTh$NWQi{_gjUx z&5;om3XX<74`;ia+HC!U(POmopBHw_NyC-$&0|qLxxbrt1|A zLW@27#*o#t{X;SY8E{K<IdaNKhghd=DJGd-8us#~giowQ&ruV@lnv^7HEZBrCV1J9&xdG2EgcP|_LCyQEzP^jx5>GlO6bZe?KdA7N`2HmlNS#tC|Js&iUd|Iq)jmx?Ii9TFa&8si*r- z_6-zvh@!9qk5CBpiBT$tyJ@Q)?SoTC@f-ty%aF z^0L1mXPnIy)iqx~2|;>4o%U>P#eX}$Zdf3C+|ylQ-}~WN9tek1X(OdW9Q;(}CmrYA z|K1gc!6&^KZKI_5+H?MsyyOYx@X9y8vPU5%kncj*nj(*s2Wf&62#ekwAf46aaJ0&)=@p2mMx8cYp!jUF)d~*h@Ii7X|$-{L^_MmrcvS4sn< zSF1rdrs)*~vWcPAYFjdRg`fA#6toTp^W3XNQa$L>Hu$3FdwVuH##RBnjRL9-nXyH+@Y%*ji@Cja-__yRxgbgQ0f2# zvj``%X&Ye@#p6gNbL-VinuNDSDZdH4xvA>SrD2|9;ny*t);Uajf~mNr@tL-C9zcaR z`t&Kb?AVKeVyFLJY&0Gv-*iuVzqj=XNwyU?uyJO}UpJju0Wh;~nw#|4g) zNrHOeB?^_pQ^pBO;pXUn(fI8Clwdg@9m%?=3vs!Is&IClF1vk+)S|kW+={l0?`)sv zbL1?u*m#D>6HiKEW$H}2j)yt}E@1lrvi~0^lhh+*Pb)%5)a{titWu4x0+q0hh?Ru5 zwBYDRRXRFa>~VO)aRh!shfiYR*7UE$Hn(zFzqtRhF2Lw4jKj`E6X3x8{j&A_XFY3< zQ%#(n_k{!|hs)$-D&--u@AaIsGY@C5LtoI7GyVx2*Ds8IhBt~GYWY80gcc5Wp%VnZ zvz|;Y)rI$h`nRTU)G6v&Hm`EPClfP+rU3!-FXdGCj2Uw+-s#9C>}>@-ow!XuQYH7-x;cK>Y;QQpDKB6(%}}Fl6Q_sb~R2qiiw9$RGeCh%uB7e z0e!qhus#ul66Dgxx)Zmv3Vgx>U3IzBOb?Va>;P#q|9sbucqJP1y`h~(*||O@eP`;> zE=pPxL7X9;(oBn{M01O1?VEk6-h(Op4xLHWOWBqLnKA|N{NvYHN+H@~QF1qFxyFwE zd3XM7Oxlu**!|RZz2{78YAWcAUGN^WLwZM=2C1RczZUIJOh48Q#dTZU z;L1&nd*NG)f;|c=@PXh!PJPgqDagf>iX*4$KBu#La&xuSeO$E<(r6GaG^+;Jj$YjF z@V!|I0JWW-wU6)MJhzi=*DMwqNH?j3tPW3y0EaOM=Y{0?ml}N>`!&D9wgW%f#S`kt zJxA?yZygc#B(~aD0=J8*Fb;II5>_i~TrRwy81acV2o4#j+-#g1d#sf+_UOuE4pCtW zw|(nttBB$wYO&QPi%!;WsNcN#5yI$6SbG1Ut|C;X(cktJLbMz!FkXs;yj^Y?PW61| zVU@>f)n3K3M!m*|ml(3}%WU~N6@78EHr1uxwhvKY*}G-kZ#l{{TePmM<6aliBp1NxSa<)g5o`2g@AibMxP`>if;BvhZQ^$B5?WEm5#HUm{Gke zh-dky+D;K3EPiX6sVB+MH|n0ap4(;)3iF>ru_S+ZoygV9k7`&A?T+9mzT4(5L-b_z zRxHTBYcG`O0@|wSHO44KUuCvCDtsIw^w=}{GIx2Xorg{kPmGvpJZUVa#HBPA#7_!K zrJHwI^i|`z1%jctvKK)>AU?qe^9|w12-DjZRlLF(2yc1OaublOb|I<#ex_htid% zU)WqbDeE?dJVy$L*3Yv(E3RcU_cY%u7E{iL3)P0dX8k!qD~>Q?8TPODeZ5=q%j^{{ zm#ip8yt*?sBNoY4_ypto65HmlSSH86y-q~??6{ko7q7XX8?kM(Gi@A8`j#``KvNEO*)D2t%+ZMzunz zC~G3QJyfkUsc_CBdqUoEn5-oDH*!_W3}B0YnYn(tik$W2)wWvUxpZ-sS8Lc3-dXz8 z8?o}>G1&y}xH3t9HG-2AJE+8)Hfa5Vn{zzZ zis0T1S?dfe13cN{`S1kpn&Jw z9vEu5`LSg>F#6KUlZW>7F!t!1IWr6?cJ)qWQ@|v(!lEB;a)Gt-GfS-GPsryOh1j8( zw$QLUzwzXfDxXMMe08E|^JV=>-|-(GrlXfk&{%VR10?;6HMyioWsP`mNA-!;oma+Z z3es0UK6JcEUf^X#^Ri#S#RYOxsFyKANyq!^`vWssSw-X5(LtLc2Ul3w{8`GfIj3E8bh2Q3 zDQx_SjvSI{t+%B4(2;cS*woKGl}{v!6#&ipfc329U_nJY2IYW20f9$nvdMqzwHrlD z{Ah@>rl7OQt*AHP^b#OitS8USn+hU)cO$x(s(f=RHzB(+*uibhmX;1`28UbNIK%{f%?v$329Hf!%kZvT0?h=8a zQ|TT;y1TmszsL7|&pE&E`|Esva$U?b``LT1b>Fl1eXmtc2LgfIRH;XGUAFZQahdXV zyebouPl=KkgPCJb89-hxa<@D-nV!Cly*66=jii~RG2-vJD#@cL@^v?c9d!*Odrg91 z+%$<-VCSZtgUp5f)C=e^7t>?<8x`Z5BG_gFS|V@ zbLI#8eH`SSQLu$2-lIG+9mlYt{oH}ID`XHkWalySTJr97k*`#T*{Q`Z zupm~Z(J`a3)7&EqJYR5EAvw_!EB}h#*c~LiGp>{0D(37ui?}!!d9Mm4*`aI(IrZJ~ zCNV|mV6KwLv6==|?pLk1vZqWw<+753CccDvLGDz}#4GV1q=YK#fzU_CWAPw5k>qAfG zC@*n@N98?%VkK^AzwqdjH{M@@=FeE6#TAI%mi;f`6O;Cd)T@9wUXekDkySbr(7VGNk6r9zj6C1KS_lJ%n&CRV>D0 z94qz|g=&#VrLtp_3&`xOL1pRh{4b&*jc#s}C^2_2VWft`g?3Hvj`8M+hD{4U7-YD_ zUxelkwdt)kQsl!#$>!s)ww2_>Tyw}$=IU5dSRY-`>ZJOqJal6TU_u+xlV`FAx27p? zoJPxF&6|~4`5_C~M=|i>=%I#$dFbp$P+t^HBMz@{(G>nWMBuc)8lo0`tq2=U)Qlqk zl8*|JB*8XwACj^%v?y(hq|V|2RVO(V)%BE+T8OXwP>hTu*yDaqc(YLd(fcpP0HXgO?to=y&zKuCQ*i185CX+=q-q_ zQm`4QtZ5Dpj^3g{Kp0qh{;I%yI+wDq`wxdzxVGV9IfkFYN9GW>g0u z_j_C}s}EWCrH4&h$K9S1WtTZ%1-?opt*Z{YA|L^%jaSpanmHP4Lky5#1*@ zV}M6HzCPl^&qKLjpInEz89K{{n?+_gOujgTWT*0boLv?|0oPgMZ=SjHiVX+cMT@U~ zIBa$2C|>2jr)H1E#>g3rzmv(Sv{(9We4E!2z*Tjgu4nHR$hD4~T58IuAL2i*Jq z`2}qVQ!DXc3^Dnr2DLv!yK85NLC`N23~ zI%EuL(w@|s=Dc$Ii;>iE*L`RWmK<&GNB6nN%pV(Ypb`Qsr%IPZAWN4ZL1mg0C4ZjY zqmdU8g2^;`{lrIfuT)&pX3>`?l0Bor#!8(R*a<~e==9=E0~sribjH+x|nEWUHsBgnTt z;WI8$&KCIP3xWon!$f~m0ByIxa~!K5pHvoWao{^S0yA}(UC$f!MEZ-Q>6RbPdW{+! z0<%m`=C@nwucFRJEoOK(V;a@y(N+Utv&0z2*!>G*osnC95En;U|-V2nG;$g|E` zQMNlmvS-umy(4O95wjB$7M8NqN%x6-fW1{F+f@8CNdy(&BAXn_Y7BkhZ?#=`#iN9C|Qa6O0$yQ}aZ* zFc@F8^tgX*{s-K|pf02q@Ca_5tz!PP^w6#*4d(%eeHqEtJ^*Dtf0u{!M5lTTWx({~yEw^Px_oom(!(R zxh$am^k5lPtLY|oW6^p~Yxk>!b$*7X|D7jC9U5?oUtj~A0qB{}ThFpS92IOT{>rP6 zQaArF+#%Pp2$S$uhEe0WJ8do|V5e?8beG&k+f~GMg&`k1X4t81@Bl;nM0bcbRX`%E z_0%7cE3yO1J%FLb6cc7IP$`Pvt&+uRL7HN&Cn3=(&a<`52~v$yy4G^^oD1TGX+f7g z>-5I5*3TJJDXu1q2&F(Gw03gwv86t3@{?E}DeuXhpKuqrAex@U35hEpm;J1O>UluA3TX(k*vAOTUC_03^46(q8GZ^l;b>4DVV2! zn~tNcu{oDpTzyqX zlM&;E*JY55bz+u7p;>mA;>4*yfXX|uDQ$_GDsSQg0$<+YyEXLgs6mRyrM*h$7!a>p zHf!7`51yc_eT@crhiU8=jWqSsb&Ta9BdS9s5_f|A3?(J`C2p72yyy!u_d$GCa)Q_K z@mfFw)@U-`6ZTPtuf4pL=<)4m5e?QdkSKAy6dl;st8Q$UiQ}@W9qdgfaS!x>#En(CKfhFkWa?}wDY@d^ z>3<)L|E4-mwUyw%aiID8-F~#)z6^F^-x+{-Hk&Ry-i87{L0Le?iFT+^0Rw&rMtK z!?YTo8cDp}F|RuRuODWB^hcvX4nsGYlu&Ks%O06*A)uHCNs>_Iuam<6UcTdh_0L*> z&TvMC+j+%gXQlH)x2EN=Xu%uu(&v|!fR@u86U3Q0KzZ!oESoOwLhf@u(hm2+2;_n7{bP|u65#7#TNZBA z(D|XJjDHZkoeUPI>%SWN78xMRYu=$ zt%fM8>_d|X3d#N8wDYdVM;B>5r84zmL}=8@cl9M;dZbquV{hkMMAm-C=-a2RmHAzN zG3fSs%E=P*{CUWHxcY#+A51pDvD{AEUX_Md350B*$U`l(@ZBSY_OW~>(718s52%~0 z_g|kjyXU-EVzJaJX-sM;st3#k^|~+x?0fJ$oJLtQb})@Ev3lLumlYmY7XE;gcziE_ zyXn~MUv{4XspS9qizCnBSgr?hV*BYXAJGVkBn{gYU>QDSvv9U9OAuJ8uAXQ4scwl@ z8=II^t)a%@ry*C(7w?WJE$2~ioPOa1NQsC3Uh=yn#P?2l9&-=FeyrCNbiB2uB^|cc zD#{w0(texsUwbjEbV+$$f}QH0~+&x2NH7RX?`J;#sXRA+?ft(p(nNskt% z2&L|qT!fR!HWA!9tjwDFODGoEYp;S}3NBz%;U)*gkZr_r)Osw+1*6x4Z?+0P1FE`Y z7?MM~S|;VVu7Y=B-Vi!camZ zZ^x+qIsC3Bl086aBB9|~ogB3tCN-u#ZSz*Pf2_ku>d){kNADYhUg69{VWWqxYFi$K z_2sB#n6EiL&^7Ot&26O`1;L^ErhOVE;CMNyt~guNY8Jk)Te>qqm=H2=2bS}u9V-d& z(RI9jvVG?O{K5ccIT&fnbeOA*+O?8~YI^tULbP^@Me<)l8U{XtiLVHdr^WaZqpcV2|6e3r)p)}^ zv^xw%D7OZ7avpXKUuOjltzT%k+|w8dAH&4w2TX9|SGl#vsn;S7dc*fCIrA67956+h zWS<;Jzhz$?ZAJU9bx-VT!-~A|CDBC*pLM(lkHz47;p5flbaDka zV|Z#o+VZZ&QtQZuNmN6v10NiMoEm(CdH#UR9ndcY1dDy|&GpqDevY2Cs`_ZR;GHF% zsg3J8=?$Fit|eF6otCWW;1KECsRSBBg>T$ydC+S_BcCh=u3FHNPQ^Xp0MZH$TeP458Q#!?nl8WQ0nxNXww zuP3=Q`*V&WS5Opxf-lVZBAsdYN>LS;@*3`}> z03^$bd<==6r+jR9{a^>xE#1s|RPbsbB2H8$ zR_*fZOH{7qc@Th3#{*({7~a&#kc=}fV^FC)=p`6UoTKge{LB!36*m} zEeP4qHNPYv7hN=73H_ZS60-{Ghj6nH$ZFKk`8G5V=s{zxDf{yh|7pR@Q;;}L}Dh%Ub!qZ`&DW22lSn+V*}C% z%yXbgV*q|T_BV=KYbyACZy9Bmw+4DM2D0XM%EQ5`gUtL{S3|1o5AV#{s(R>eJi+6<#*L(I-J!Bs|o}7S5^v zM&^3TQO9v5KbYm2So#kgtbw;ZSka65jDOLMh8lbFMw=s^D|o?aclPfN_)Kj^4rmsD ztRmh+R-$|fwF8ZtEGU1o{=TCep!B`*fFii9j;;2cDy+-W88x)}ptX`}YTVHxz{CsX z!$^^J24@uUfXnoTN6KxXKcM$h?*BwOSM$e)`>p8Fwz4d*{>>C@2e)-kQ#%3NhV6Kd z4ZP1IBFT{^UtLOjTd}Vdux+zF&hEnRfPS@kJ;{*mn45Kg-zD*Hv9_z&GQ}$z%r}yL zP-y47Ty7DK7gBdyi;;yV)h?6;SymB(aSCL0tgb=28ieuL`H977AbwlH(d$W{o&OHT zTgR9!Us{Sk=X4EI{HWTCaFCmGF%MYuI%l2Ox=weW{J4D3tn8xR{>cjNI=TI_V^^(x z&($5+)mH-z1@{rKO%D|Kq4M{m))Uua^ii@7raz$8)ZbKGf>-6f-qJ_GUcZAcgar#J zQ|%*1$EnuhwSENA{6y7neWwf6Yp?$UG7;HcJt*+~f0zRO)832OgX{;*_QN2fN~&e_ z%B<#(zJH0K&1XS4v^{Z1YL?BLK$z)`08PCb_d*z!nxE{p+mYZS)BhX(-I}sK&^@S9 z;8RO-SZSvbZ-?4OrYHSaDRw^ZZTx-t0|Il{(^?j~{_E{q!#JJCzhBT7&B`-Q zu@-?zu*of^>WJb<<$$Hl+&%-QHx&Hs2pC`lZ;9}_P&E;b(qDOB>Is)e-bOA1L#6fD z50eHGoWI1Ecq;P;lnx{zGRt?AOX@6(Yuyluh;Yg6ytXxRa3g_V5+@<-u--ihD11s^ z7V$=5;|RRe@Yzw*OBjlE-5e&g!OMH>=?GICw2p-jbR6 z)piCF?6ehWv7RVcC;QnDNrlshyDi1T%y-{h zeZ-oEc-Y>sq=7pVpo<`k2-YWS$N!)U++Iic^Fh3&|0^dUZ73L36zAP7E~k39`l42E z|5WG$Ra&;7RGm^p(Hj3%e#3xl+bkJwOIW{*TBSogG1g1jg?O=e%sGu%Lc)yv{`4CC zN!ZPzs}g8u5`uplj&!hcnQhvXzN+_8+(F*wmfv2@p5TrIN%-4reIU&0C!3PPh~MS^ zehF7;xu#f zx_4hXis~ZQtn2Zbp3 z8^z^Q%=FZLwow2QRuwtkftlaS9CvD#4j9~W;ZHM5l`9xFpO+M#5^UqG7X3=ewbP9% z(@Z-m*^PR|V^#QSab7GhIY491-|L0ejjq<-^XeQdU51)x<9Z<+Bh`dVX)A1rSU1y$ zj~sUzv#?qYJX;s;->Eo*U%;%%2I5tc#(2mt8ERwZdkj}}y*JJ)k_}mxsqIO7e=sMa zF0);8;5}z2*fYshm{mi(jD;i1SXILbw5o#%vl$DpwI-Rs5v&v)IO8p*e483#UfFev z)AaQ}^KazwTW?w~*_o-F-rt6;U| z0#kCsDT9{usxooiI|hHpiJD`ax#VQhL0J=i;+b5jsn~+&yB0#1PvAy3Q{02O2Pv%7 zr}&CWQ~YTP7Te1eO$O>gQnqL2paJSai4PN*=7I|pRrL50ACdx#;V2_fD{fQnoe!$M z?N<90aE%33p!uh4;X(M}Coau5KK7YQFqYigpoT)N8JlllX>0PiL}=A(&0K6M2pS3&T|#xGo&kXy3y-LGVZc$1zl#b(fvQ@X)x)T`it8vgAR5oc2D!{ zH}@-*lYUfkx(XUi+b&(U*nEr)E+MZ?S+yFqk3Zl}`NfT)+EDT%me5n9phhjb!1N{j zhVZC8sc2hqCZP@ypOIP@c2^gHt)>TMRMPPOs5W;nsUbZ@G>1IbNC#zNFd38~pSJ1# zu>Nw#W>J>rFHUV#U-HqeS0rr|F=R2K8XmvzrSuTb_3U9A>`_ zT*i&LFo}8V|A^Xq$9}{3gwd^xx7~n3bMC3wd^ABG4T%==d9=?rrKRIv?Y%0HY1JF6 zHXIBKmBm<-w_^o(U3Zfq|~-QrEClr&VR9wJWHrF-r(NT z5aAyDx`nj)c(;T4@DxHz4Y}*w%_?d={!xY!Daf?iPH@p8PuxCEtoP7b_OnTjRw*o0 zPrl7Q8SW=-IJ~V6Lo0Th)Np_1{%Rda0V@OV6=qhlN!v>?H_Y!=E=C8g*VN5J2eY0O50G_E@}LJ1R21Uk{zOGM9Jok{irh0_L@SDCO*MGxP;qJC}#9{sqD z%N%_*3q{-K7B(w|@?T_j7h=(?RVbCmQP18z*y~zsdY*#YKBbJtA>evuiS8o10rObS z4WgdODk6{D>uRPOk{c0si_TPYAAQldM$VYd6zoo|%_)_23AxW;OK}!9SV%3AXGfe* zApaPy7XCQO8HZroS0RqG)|z6Ppb0lH} zrIE1o+uF@ix=M&u;gSiC>w>8Ij{?!!0Acj7B904@-;sTrn`ni?+U*423%tU;63ng2 zBuWgGJ&0zq{3&{g%LH`PB0eNh8pv|)RlS1Hsc>90?LcaW9hj90 zB^iB0w>VLU!urbk*>A7&g@Co!O13D#4YaTsQ%-*iTy2JE?mbaGtS&WE;S8AgL1NtLWYI1#zz4e~{6h|-fV3)MNkiH4 zg*Q>(frqPvZnMBezSjj84I63Uv(?Bc|6s(y&qd!bLkIHMe^05e27cdAmZ6HS>EE3; zB@7Iy|6#SqI#%Ud# zV7Oo8{R7f?-ZyyJxeH4={!!)e3E1E76r*X+yt15`qrnW0Nfwp~yHuKd-gJgC?G-bk z4}~@-D&*1IFFzafu;qU5$~5j~fkG#VWzs0k(6@Tj0u}q@wL=MKnK8GX?pt(E5MAgS z9f*KF{fh*wizeC>D3t~I)+F=PEDdpXnJFgTVD6ikF`Gi0=8}HZ%4s~2(sTK7Pn@%? z4T5)~P?}RcJk2KIf^LmGrnJ5ro+F)Z_5vzWyirRe3qIgbww1cQxF?3d?f*qF&F@8n zqQIWIG}RbzS?Z7u>MOaQg0Gj+seY;6!H!H%R7k!5o5m1|ZI>2`TSse0WARB1BNJw{ zSa-4HjW>wn|6wIgy${`*duIs*e3%ZActai#HAT?s(L=;<7nBEcs*nbOo%SWDl0AcX zMRU1kK^FD=f|F^#)+7eUSuP-0)opOP_0+fH>mQI51Wlx&y~~dDltWpx#sOVi#|8C? z-5B6g>BY%EXK*O)=|@}HORnTa>}81s{2I*8k}|5qSNL7!Lyx`#z{vCusGRa&``z{b z!pSYbY`{^~4Zo!lY|Ry5Q6fZ}5v8;$b<;u?#3~=GUf6`B-V4?*(g5geBHM@G86tt- z*BA3x{V#rEMEC%kt|q(b0LIXYwU!|4`Jr@VrV~(~jzctpQGS7c{r!UfqR!EkY+8br zHm~T6*7;3_0dxgd+d3L%fvgS9?^Fv9QW^iGRV{OOBKOy??xE2zh6*e)ml7sj$;@)b z=+T$J4aFIvXyU)guN@6Eay^cG#-S%Kau$f-qxK&@-qOHFMdyv}h0#>+foJd;l_u9x{2ExY_uV6oQBEH9C) zmKAIsMk@XrJKpiRi(17*0<1YhHn`q**s3UOeFGq09IrEM;zi>D5luhZU+T)+EKzF# zzCmPjV?X;50X#jIA>d_+`QR~fgr|_v_lv0fN+RDNqpS+tU~$EmsfWI zJQDuWSM4_{0Bj}ZH+wyXJ1McU5BLqp){6h+Y{jOCzj)&+Z>H+s7OQXPjn3@QnTC$v(y4AzU zo{Y@oX8p|bAB^p1STBO)NA$nA{LB5rK3K@ipU-a300r8brctWeiE&EDMdx6lo&2BP ze8Qo#EVS!IqJKk+AE3E`Ug!hFmWY`+?Rcjb%w)E=LY5jdxBJksH;2Yn=dxIxn^&^3 zH^KZxeWCq?bSS`-k5(wK@3`y$iNK)!NgLQj{YJ6p6A6*oxe?RqKxMI%oYHO($OuZ@CD5$9A!T;QA+-6j1Q|F$K z@pEK+X<#3BbDa?-0ost4FwTWA?E|Kk>cId=1po+hT93YJr@PTLJY{7_m=1z&eUNpi zD;ybPRI!qHHdsupLI9y>9?pWqU!%|Z9OA;CWjpVv5#J&EUvooLl$q-Ok*B4m&#Pg^Ml!lLi_^lwXy?Goi}x>X_R#MJAh_IfAG$QBZ*bmkyfQV0s8hylfAq!k z;dj3l#=m(^wSxfCLFU7~k#&`BH%qx6Hv~F#+!A9ljN^C0pzCpAn2;r|Sv$K9@hRt1KQC%J# z8bKCV$$S3$V*&Wph`YlRER1u;2S{s7r^1{T4*k5LT5hk-wcHBFES`wMXQa~)_~Cwz zJonE?uC4zyc+S37osj~#&`}G^m(Vw0L;FZ%ZF2vac67>ad{<3Uxi0YG8sT*RT?G-h*UB=?;aPjJBRa{zLY!8#@Az zoO8e0BEQt3Ql~PpM0M3$Olnpjp84#T^om0ykOmZ3?YJ)wc*TjB8D^6^J@!klR%r1) zjY?Z8kcgHIA7}VZ{(!VsPzvv$y~lzW9Rst1f+IhiNm{rD1gtLHHd5q>9Z(5t{{sKz z%a;_hgs1-#meO-NLyv3L5^y82ooS%i(jsr%`Q z2TRYJi3YPtQfTI%rNg3~}fte-FPwu;BEW(4})1 zG|n2zE0+}T&t>@2B=H7=LzJeHKq?q0T%@p##?JYQNrNL|&!I0gwz5o48jF*`N*|eC z)!DP$PIvR+)c;bLz=_SLF&?W8o@(`96(#?sl7!y>L>j%pXSreEW8Xe@wc+L-wo~M2 z?8L83@XTUtc0MmwY@M7JIEjd>t}7}XB;#fwY1M=9k~?JK&6KJu-AmDeOH}8(nlm#q zjLq%@Im)1};AHewGj^Pmxb~GYE-G$hb}LHzMmZ%;jW=6EoepO(6b+An=3kBEiby+G zJ;(T6Tj{!-g6dp7PkX&oHOG>^m1}&j(|(_8HR7_aPxGiL-C~yY5g%9ls{LX(*W4TWYd-_&_k*w2opslxmq=`!`|%QU zs@J;2>_J-StQu1&{YAkiEaxn^w3@AUi36kxVBP84*PJGy>E1=O?+$*xVjkunw6U5- zvE$4~o=aG^RrN;@fy(J_1?^i8A$ACdLqG#atCzl!656b)zp{|rXy;mUuXDQbO0V-; zjN&uzS$8E3wmle{T`;PAq8*Z^cKt%t%A0k#(w2c-!wL6#7Fs`p$N8?q3L7^>0ORch zZO|21O@r0i>TaU<|C}!}XGN@(ng6$hh5$yzvHWl(~*(RuqAe1d|B@a43CIa(qz3 zQ?U^>C0yMbNX#IQH7kA49cM0ezeHY;`_p?XM)I185G)7~?nk~A(~x<auzWG%0FnCX$$)M$cKB+N5i&`JXCvvsr4Fg|+EtC?z$4?Rco1 ztXwI#PTNr*jL7esE;zT3E~ltr?lTElfwiHle?XAv7NFGlJ1THe5W;cE+qzURL+{`& zEY~7=7LZ`N#+|jgSwU)TCViYDPzejSOAB8M%28c=B{s+UwE{HmV)gz|BauC8NH|zI zUXVhlxJsJ=Iz&GVb~bbWO=Rb=lP*h;Mk5FloD@N6W_n3&hNx)2)>tch$j6$}+xF5EE#Vo39hKI8pZiq1(8oj0wut0D(Hk2)@ zba>nDS&D2VkHk`eZ6t-fr;3aats`V+kXN>sXH@x2dZUar?9BbzXAf`L<3(f~Y~1+l z^baV}P4(yjVW~2H9hhWFQO>qab-b;AxtU~#_)ZG1(w{YGoE=G-{C0>Nw(t3|K+mCd zL>=TPae#>#xn{qIZ!=pWkdzgUs94ag>99VjF6ob+FemgPIKjlG{%nUD0~Omy=@={k zCbG6Jr{1}4LX6Cx0_+YqKCpi>fgEClj`|_e&)x$saqrW$K_{*B5}xP1j49+zB!V=x zv9(KhWJH6Zu_!id@hgoag2a?$J7b+>8$qP%P9uVFAZx7>osEN5Gc8-#nJV-mkS*`!=I0fG;A(P*5yP-3Ta0dF^1Lz;wW!}5#>_#MtcTj5t7i!H9z{@1{DLi?Y#f!uE#LiFhTJ;TT`mBc8oUNEJ z2cre>t?lzKyB{9-)MJ{j6{6;Zk1~777ega|s|ho4@jX_{(>iP{2|TuPJvoaHUub)- zY^N_dSoeC{((#%Cx5UbIEIrX&Nxnq6+jO|QwMH`$oHfOaMiH0FKJDxe1cf@!{HUMYZR z?;$bqb#xI8WuS=c%p0^)suNI}jOk7HwJt8Vj+~pLrq|rXpqZsKWz9up)P0=a&k?k(SGiHiCz~vWLkA4ExvbhWkKpJ zqm>@Osia%z0xf1xKCf}g7<}({jOf&g;=uRtSjYaQEg08OxZff56|AQ_Dt|( z^XOsJ^)J%TH|M$@9VDVXN*7{1<_o>(w(rXgeG$i+pL(OXS<@myc)q{d+O4e`>Oaa(uh;9A>wWyY>DaE%T#d{AYMH@VXKcpTPq!hC*Ksi2q zw@*NGByq`?jZ~d~S3obqLN-xrCrbmE2V_KB(I$}EO8uzi zF8#V&FvpJnEOEb7&9%6p4lF;i36|91Myp2gYVnVe>=9^gCcG$l@~zm;g3b!NvjhF& zz0nA`=?}=Gp&5_YO>U9o$1fYSUgMQw8QY*UuXBcRidovPFS$^gt!DDvb*xzAw^MY) zK88%;u&}n|5tFJ4C?7xzCy<|NRnGoo5oxHg*HW36u^XNA3yZtj@YVkiozY&Cwt0r6 z*(B2YuQ(=l;`wc^8^De9e?ky}K=XV32UwPn_al*>yS&u5_WW|D=@XL7JkveKPu5!W zy@zY8PnSpJKZEsXMuv(R2{#yMV~ZdR7zxJqdh$}Kl=8S?vgaS^(9p@EM!$&#w7v-$ z5Jm6MC^F-b2vt}*V(IW^v9ifqAKhjwfg7(p2T!OEpAOR{X1yO!!X%*|+aoJPQi^FV zqfMp=J-v)uMBII>v&vR1RZ;2W!H(Sx@D+x{q(fMo;0c$NOT8}(o1wMtm4#+|IhC8Q z-_7eMHF_-Do)@g|m7e>`aj#XxT^F<#^S*^~%K8ko>Zf?a8Fy`Ri9^g#>kUF1-4D*B zr|$3`-M84Yw%Oc{a`e1+49=u{C4>9iUXKX zVuzOKV09xt)j>2&h#CPOOz`md6;fLalXM~X9LmC4_=;F;Z;G)B&LxRzWP1^*Pe)yZg+0Q3 z*ojV3;)T}#is!!auv(?3 zdghS;J}5L+WaAG=%^mL`Zpfw5XKl0o`I1V75dWCbR25%=Qe<-Rpx(DxyH&6@gvTDg zgyFjyPHcSUK}mjNBMq2>p+xD;9xVfbiN~#bx3khz4Ce=;6)mJf7b5avi#`B zB>!U8pbX3XQMR+{rWMD3hosyOK57cJ*I0%exi7U`kF|I{jo;Jr&exkQnlO17iflAI z+ETF5i{vPTs#UAWl)H0CMv;YBUsE!q?OwCZz@0bj$Dz2oM2@k={)rz@rCDMN)nW;f z2?x}WMUY;Y@pQiVZdfUk;Bs(LH$IGTW2FD(ZhOVz!F1Pd7}_2mDtO^=-RaWfy}bn5 zy?evj3h83k`F8Ge0ysK33qtxh250nVy2~_MtH3X^A}rMThnqtRoHRz*r&F@(d4GR$ z3OtHS%KM<49!&5wi2o_UJMh+*6Qh|yAlfm%H2m6_4YyZ|B|K1QQji7xGuj~^9zD$P z@(Z8vnc+>mylIrVd1RXL*>*rIMf+ANp~S&%$tw+WH2#2+G+3DK`PoP4=GOIVO<(Z& z?0tX7mLYMN1Wo=L?w*S!a~`lX+~Id>76}GZFQWB3M2WfxK5Q-F;a~p(SgToasq)S4 zz2i#+4Xs&*i{3vM-f|K;9xO@v{F)85c{zzuUkks#^0TTr%W@Q7ToUB6TRub>w27N}@4 za~7_`|EQPQsxOsqeCz>NTzlS!>sozX>>73Fo45WFpJweRrZgsstmeV+|?EW<;Z;fW%y|IF4 z0m`sQaZzal^e4?KnMGZXEi{_vs}I0qH8|!C4RBOLo?-Ts(HdnO7 z3XS0V{uVTgTH;1t-cjM7rtMWmyVE%W66xN{O&k7sRYLZ{W!R}b?mnNdro9)N>1p}- zPx#g^WW3sRh)CCy3&-ZfgPRgm9A0<*JXh)oX&0)8AaSU^B_K$aXOhLUQYA~JJ?JcU@J{15|_8QSSI zSEWtk*uuiEyHm#puBipKw&iWJxHTY`tq-cyAyL`R@Y_Cm_=PML(^AIUTZG@;3-2{F zI@*>jqTDw^lIciWc5_Q-2c(!cmT0Q_ZNl1A<16mA6;GDtGT9v?n=5+OO}-qp<+i}9 zzmW?UHhWqG*~(<{^%wfiv_|;$^ok*(q^g@D;FDnAo}mz>QZW-gwaBXIV5i z7yV6nO2b9Q;n7~BQ^t;zkXfQ*6&xPa>-#(s=RY7ujvMQ|v)U)KBJ(0(?2VKDxRReZoIk-mPiJp0L5Y{(cH6hwnbWNg)|Ydy+7(}A12>d1WI z*#i7NYE4TP+gSK?{oySqbSL8>gMDy4?m^hvHpQ#qel1{kVn(9kX+cn}VQA}ziU2vE zsz@A=qjVQ}%sak_0NVafh7Mz=SU(FJJd3KHZVp5h9NOEm(=2R2l3q*p$i+?=FdGt+ ziY564=u;=evt8=yAG3s#%Zw+9z$;f{6-Sm4`w(SM)iRU3NZ9NaduH60{MuW-ePr6iWL z%OWX~#9|nq)F=_J_`H@ZXKC20u@HgAIH7Gp@O3z!g|)k@LuO03YV5KgyxqXvw`0E7 z&{s3`_gd0>rz1g}d|wle-=gyRFG0_i7u945LOmPqw;OmlE5_wDFh0~$d}#&oF zqqK$}m~FG<*zT&6NnjqCQVb-xM#UgC4V_+OvY70E#ayUn~O2pQT(2nJ{v-3 zRh7Qq$Zi<}2UQKC@wxMyDGLy7-WsS7wfQPWIQ!fl8ZXWc<~9*#*HEFD=3qz0I-u%L ztF$)b)kmvV)&3~6?Cm~fhHZm-_SmTB2i!WhzuZ(7IonkgvAlkF_f9F_2y#DMsWDSj zaUJ~AU2!>aPGZ;3|7D%o7gl6PFD2zNUh+~Mm?p<=;KL`cmGg$tEyx+%+K9Th(QPbN z=$tKHgesG)a6Y){^k}M>=`ptsyb|nQDn!ohG}tcOl=OVBFg@ULqJe?Y--Dk`V!4b!42pu7*5 zS8dh#DwbKg7gc*M)C^#DJ*8tsp|uQkn>J*~>Z>z6U@cCnJc_qE8Ii82dKLM%VdAPH z7T53Y<1*#GFZlBF>=l-=G@UiVvol5V2}eZiZ%gqm-OB*&LGd^gl$1Asb6%-n6IFcL z8wt+>-%EW}nD#dB zqdol97Vb*Ye*0De*14-Mgdro2mN@sRUJT&LXuM;fTNQcM8?|Wp)$PUat!1Xq=qci7 zD$2qzE+j%k@_g5UgT_dfpbZ-e}j{ zqpOirLkvvIkx*=BuN$j=sU}R5QxEe+S$}7*_2`3|H6x|>K->9ziN-sp0Wyu5VwUTm zE)tKOw7H_>Fm|zHtq1JvJ=5DBVbR{Er=IP{$t5CamAA3pXH^fX zO`Y{dB5Kk3I-~5j!)+SpFwGBH2Dox7&nS58noFM#+Wjt^V13>*{t|18zKPJ$ONQyv z0wqbnGsPPdW%=DL2vR*?#jg@*>kESIXZ8Zs2!ntJBCx~Mpa51L>RvzA)NwFa|DK`@ zqsWrtC*N>6DS|j22g2Gk|A0z)3=3g5vex_kUksMdosVIfl1Oob<_GU;TBQm;IQ`yP z<`*wKoJrcw5qW2M37jlO2yJPc? z)LLw1@-Kq;le%XfrI!7Hc8z{T_KIs4>*fHoTiN&iI29)RcpE8Zha@}fb^3Ri3wKy4 z&-ZRil1bZFqegod`d*UkUg|ib=h(FQN&g*Z30!e5e9>L9IOWrxz3XWYjus+eo)$gD zzq8ke>F>hqWu)_goZgwlJRU7VP=?dSZQ2}#Z(sCn-#=?d(E)HX_()KG)_X1g9wQ%Z~kcU6gHhAb=$URarHM&$01W6 zyBt_A|9~>Q_`OBb+(t`tzr1?U?7jN@z*6(UT)u&k#?acoIxHTOcc)S$l8XEiIrCwt z?Rny!H2P!V;^%hQeqrVx(1?_1>@P6$agpb}UsB!@yT{y;IZqWr;h~&|jke2^ z6F46So^2ItjYk4xbnSGhQJv*2Y;85cKx#5I`RHsJ81pL}trOt4GoVN+qT}eCyDoA7;?^PM*=}Dzz+jT+M0VYBlh>vZ^lz0@ z{TB#cS%?}fVxJAH=}Te6Z4pMs<)Vk;t7au}#FnjT&{lZ_+lS6Z?}lCFwk;#jX0eut zujL~7rw0hB(P6OR@o8Yj*+h31pa!uOQSwLSqnu{a&bzxG0QT-4_K_lPYOq&kI zn+vz_kL(Cv>*ZYJ^$nApewyu~-m=MR(GrUU=aTX^QIl8eREzo61k_v0&Vx{PoC9h5 zu7?Ayu)6&@<9_G`K~iSFbP)cx*qVt)AC1%vXS)QhhYr7P9u#oWq8Hy68S+RgG;ULR zY1n{+4&2?Z>qSKBq1epP6+2d-$QGD_# z4kM~00;A|W&LF*vw-sCsW>{qh7`)?Vav!^cO`g?pc205gFm>eYMMG{SNr zu0SoOe(Br>&9dz$j58Oer<&u;lBc5G(ri>XuRJso)8OaXFT6ifew2^A_M2A{RulVe z{lfkJiQ*BPYwB<`Gwx|4Z7nhm z!LJgi&+6TLcM4gNDT>ack|OQjy|rpKvF6UMQFKUA_|^C}N8wrwHE)crRk(P4Nh?b1 zAzZh8lKdVv@AL7cH{X}2gv0{VH&H6n^$fM8kKvli2`HQ`8C16#)qX|X*ELgxE>TIb zIFcK?gL(sJH=nTF2q9XN@{Y`8^J6UX5IH9(x~t-dlu{kPeMiK;ia$|fT;}sT;1{imRLUy4WrLIbyhBv-Z|14PXa2q{ybHl zvXt+#ah=|VKh zc^s2gVSL&pc8P|2Pt0Tu=`ujc&43o6pXOn;$ZZXy8U+DXi2x8sn_eku+bZ?oXfN{rm}X@atrl%pP4|0MvHt-IK)llyc^R)Z#% zzMe6A_}JOWP&(1CiIHtFSdtp(vkXj41w8Yvq4&jg$*G_M`flMPuQ(IH!F-mKiu7vC zQ$UvqqFbfVe})Fc7RSn{2=f}FJ(Fyy^L~$u~Z@l8Nk@`RD=vx$;7g~ zoy%~wVo-Dj**J2YjOol6!I5-`_~I2ga;INO zZ&~b;g8AxLtn?ic6ArJ%!N$}pwK%sf&Tc98aDRp z`?#B(e*0Ild)RU@ZC}Ig9iojDYM6+5NrA=x#2PN{y`lbPSDf4HzhqO%?ST%F-eQpI zt~8f4&t?YBQB7qL2M0>}P>W}NI1wmzkE)B`F{{Z)?H=F6OXzG{uB3 zTbz7radRLyahBMkr#1fpCet|KW54*vlk6|h{Qg{#9iIeLp|`tKY%fuc6ej9=r|r1o z8+YJfJvEj|T7mg7W(YKPAt7K`rK9&kxC~hn+FHl@(Uc$m%}tPqpR+vAQuMezP`WtI zGgZ885IPvef54bfTQ2_uqBj3CPJyWj^Z zAYVsudabar-sgW`@#@*j7v;a{yRGmkhC}T9w_@k5jCytr^^L%*slz{VrB^S`ag}nGej`Y$+D~c{N zp_&q~e*y9AAA?EIvk1b5xmJ;~?0;SR`(&#RcuvmB(UEGiU|BU5;f3u=}|h85Ht z*48aIu;Aq2&0@N~WDf~0gP+Hd1heB-NvgOCMH1&lDU2uC#yQ_~RQR1+$xKt67S1l4 zB7bovI?KPJ@Adii=axGvyG4vX1Hkhj_E>8qC?eW<_Rq~$nzK-_()ILQWYkKj6+HWv z2A$qu)Tm|7H!V8c@>cPIjL@Y@6y~(sf9nWhpb_kH;rogsP6M(;UHXUC(`!;x#8#w! z)7q?KD(SJ*Cuw2+aOj`QcTa-}x+YwQ?!let_S$)ck$&Y;l*KPMDoVU~tpxgFnL!nO zUHETJn5Sh0=EPN8Vvw0g>M?x(EExuHEabq;!R#TldOpO+3g`{->i9~YsYIWXGMnae z5ezq~S?|8)`D+zSq7Ta;pkhqU}y`ECw!lV3& z3?#fZD=IKmkxx`=Ex^EX$XxK0g#kPo?>>S?)+Urw#s#%xTCeDL2Tk_hko7N|^CgrQCG6p)AMPYD zu*e@lph6|am4QA9^Y4Q1G3>Z#KnSHTzk7c*GIalkW~PdQL5Fc2&j6fA-LRr!%}_uV z1T-_xhJqptmC=nwK@W*OvZW786}^E#Xiwi$-DY&z=>g3Nn%VuS3Z^?EGN{KO)}@J* z_YbKY6O-L#%q|foRGNlVRC_~2=fc@l_74~wu@bFuP!DU~E9v8Xf zXFL71x;0FY8LMPMBF=eH)NMR(9#4488!IotP$V+{nYG(e<(BHI3}_+uUsp_j0MHq5L4FoqySI1ibB)j)?b)8lwNr?Nz$ zJku?+dk%ctpAGcBTBq+Mn_H(>7)XZ1>e$xJ_5c37Y)l5ppG!A490k?<&tLzJZ8^vg z5t0raZz?nLS6LgLzu8EPBc?5L{d)wqssVY% zN_`<>tE{!U@bF#3kuZ-AHhzrvLYV3m_{+6SR2K?2UVE6gkok@bMe7M}UZQz-BJgle%@0+@v&>fo zh&t80eg;KmifH~aWBxVayq|~Mz!1l^#?ZZjA%T(Yrj*gwLv}CwtEkiI@$Qj*OC$^ znqCq&cK5FyMO_)1_K&Bkw`;rVD!xS|(lhW6Ok(!^lF&0>f0MvheENRMa}M>vjQp+> zF5cbWm~0?wd&a975?RqQf3o<51@`3-IUy*rudl~ZaiN}2<1%BT5a~GmoGJS%Tyk%z_Hf|vps>3(L!1S1*bXC|u@bz-&?|<>m;$cd#p$2NNQ%7*FZ{Dax z@-nIFmkAntc77V<@YXB8wjpfaXo{%N5WZo?Ktod}c*N6mz@c{DT#MeKHn%Fx>@VUs zF{N*DQ|#zGkfygwh4jPsC1lknNd>pO>GH~juXmb1I_dnbo10DX5`!VQJ2KkduQ0` zgQ%@&EVlA$Zf>;)n|l*Pt4FmBaLXEOHqE*W!Q7mx^SK7W8Ps~?$2@mS_Ot<2u*Iwov%-kRHTL8cmFWq# zUqaGso_F-c7hTBa)meexxK1V4PYyK=V%|mc;>{)HzZx{NW2U7^#7oE&C-B5^t(4xo zqi!8f%CIQdD8AD?qTpWTuS=TMm+QWoxwH#rDN+(Bb&eA3cFu{{t5mJY9RL>FU-LrT8sLPY{S4e%OS_Y?%L@&NAk?? zhu@SFBLYXASEDIiitH0{B3JG|lsQ`HpZMBiRn~p5>kcZRF$mUfew9o_#?Hp_g>X(V zzxEqsFq~z}nj*VV@CobY&+v-t<=$a358>S}b3ek9d%;>M&iF|6WB9u-v{dPzpvC2) zA#HhRu=N*)2^-HSw#v zqjOOT!LUIkhjs;{^^fKC^dQh+CsAj^5EguHD7 zihF+*@|4{oQ+}uXs89agA$~PTKlqe?aigQ_k*a5k(!Kda3gU=$JDrk24m5^K+7ypl zBhmF0oJASyqqS0{k8FKqUHNW=b;$9D@2itI(uBjKju#)@)9#Ykq*P7HQ`o;lGxVI2 z^6i*Au?WzmFNQS50!N}oau$n@dZS@jzdcdbg!Utk?$y>gsd+7)HN45K9dG!smA6{v z`*P1_v5nOzH9_!>y_THGDj{#LD=`rzfk1GwKF~8cyhZTTzuAM^k?oVp{&mzY&puep zFO7_SL{TA?PCk;U8tEx*H$q+&1+&w0YCn~BPD{_*V*Mj-13CgW?XA!-5MtwN;-Kfm zgN^{(H{eW$&O#ELgGQd;lvIz48nwM`>Q&dPsWC7UoaNX#HIa6@FinHMo0$}cXCH*d zMD8(-DLXmB?rSv)$`&{rtDx;etUVHxpU!6{ItxU#1celADj6T?=3IX=kAuss(lRyYT2zI2<6s#_I7yzH zPsJ59F0}7Z?>jU=TNoug_A-UP550gb?)qKVFs;6;MLbpNY7qlQQ+0@QCF!q^s7mPz zZ0}?CQ^;5$%PvtSsgcgzK?B_3Nf~DNkNh4AHXKAYy%qK!dA4%KSp-G8YU%k*WPLyl zzu8%8(UHHk>M~K;Z^ddH2}KwBRF-*`uvJ_qBO0uSLS-vbH#Dq;&Z&4&OmKweRKB!E z@VU_+U}=N*I_217Q@7xbLQ#~^)7r@es?iqvtUR7Ha>$gYn`UFEQOx*sJ&3D5KOf!0 zUTq{dc%6)~G*YgDKgeTzPCax%v%R*6m-JZ+;A2WP*u;PkyL_UCU!PK~l=HzJ zk?5TM)2E0{KfUg2eZ4@Vg(pGqDnBX`?7aQOhgqS1lTcqMDO?jgme0$Yy>CwOjtlSy zAkK*G`{CkA3--*8I&@E1N7Ny3ozvK*9fvrij*$@C3eOsw2c@noHWon}`8|cVJHAxA z)5#y~M1?3amR3Wm=4OH#*=5BIkx*IA;|-od<16HquK`2n@0|Vr{aEh*cTwX1$B~JH zegYOC8xEI4z!B@h2S0&U@ie0r9|KYiqUS#CnG6N=JUYYYZhApC%e&r`@a>rXP27#& z{4-CLmUy-*yyR?JiJh%?3ofKB!2@oD{{Cl*W)N|YkE*Zg!UHv+f$pdYX?e!Oj%U+u z0VBj3#jGz|(ibc5Q~2W@W`&N;%mmj#*)}?>KC~GplJqos?As&4V`Ns84=GF<3n^JHh}` z1J{ql&)=mT6?4snuA#axU=lK_##Qof}OYP)&+D0kY3a)h9|={CV0p&m51# zv<6-4!whw}Ifkre$13XNV``+?Oo@J4U8Wy0eEqSU`CZBy;?D8}%b|!xy!h!(IakN# z?h?OE6c_7#3V5GFsbm^lz&OHt#w(iJHd7-~@E3?*xQ@wgsieR3jpY#$oUET%l$krW zRxFmW&9&7e_u6rj&SPAdcX~gA)i+Tlls$K{Si#6z=Zn5n+1ElWtpe!loK~TpQ#ome zc!|az%4EBl)Xh#x{V=yFk~yY=6;_h1 zDq>X0K$C3C6)lMx5o&vZi0~%VYBeFt(_-t8p7;Jjt0!D&N390lb5Eo;B}EbRQ3ILt z4sES{d+BNL^x94?cu+f!`T=HXnQ z(B_~E*CnRLU-xjtR`2k&^5xa~K6k9wAvN)~@$XH=d>QZb#iEwD#cRwSFI&|I-#x72qn;voPNXR737z#k!?>9o0+&z`G^g%PwGD? zY(acrD7s$HFS}G?s!SW3vBACt-x80xnd)~^nK;U`^Y2?~b6<2t8KF+8yPis}R}z`z zDR@ZV=q+4ie$+ec&oHjBdJgkjB$(?AdQIQ!XvY#_d}NEdai|K@@V6;H83DLb1d4L{ zwU)1$r)DBx6yd6sECDZMW;sbT^kAPHP8mO~fH@Fdmj+*=K=P8+%_R=3@srfD_YPBd z^bW^r9!7feEvG&(uR}CHFN2mup zUKXo$%zX~I9e>ztFShljSX)@4T;kcrWshAQlBxY%%F(q{!&11`r-~CaAIr;u>q0i-GHBdbQ_u0NYEGg}9nBY@2 z+Q!t7EGD`-RrnKWs^VP(Pq|!YSRIa4Kgi@cJ+8Kt>I{XiLYwV&C9N{HL4(BiK^xEF zuuqe7u~W;OjLsSPHBG;%(o{H^oaW8IZ_*zuRB$576~wVnaZ-*SvnFQstPf{(daVIP znf>)2^`HO0P?#PxnKkh5n}9n>II2}ZOB}gcMh27{&MN+Y^B_8xf4nQqWu`9K&$MjF zsCfWC5;aN@bkhH;M!KD{N5uJEVpU3Z>~Z*U^s%Fl&tPFhIEr30->-$WPN)U}CVxNB zBE&S{WF|XckZ7nRTx7@upxn~~N*s=R{GNzJC7^Ld`4Vr|t8PI^h>%$5see1jb$Mu4 zznwElCmngj&lI~Vv_y~pNj}wzWF?t^Wat*?k!1$w8FPGGnr*^Wmh-z2MEdniOW}Lj zH1Whb5qfBbRG(sb85rpQq=6%Wov<;s2U2JcZy?)ozPM}g09$nqmpQ+Sk`$`PB%>oX=`HEpnsE6ea&w`pM-h*lRr zq*{&Q$BUcEA-B}+QL;ivFeT=)ai#nnd|%@BN)C8Ev|1JXh<33Ds^6aH0pxOEC?iId*)TV_fa>0kZV=xZ zmAGSV2>m(D2Kj{&xymD_)I&*ogw>M&bfGFGcA|eSmj5x03Dfoqux)`Az1M+1*U$L^ zfYC4^^4e+zKPuP%_x?~-h~Qc$p1%fy&>uubf3JCz!kePfN^#`ZUDbT@(64bR=xy#l zWb7!vPyan%s$iRXexHeapoxe>g}21aoohjIhoOY(}(O=c>$@X6Q5i$VMIiUp#0cT zpr)Gs+1GD(gi3RInW;4|0Mq6#P=A5H3ls4wPF*3i&X2E+{2sO$Gob(psyOO;Oin%C9>KZ|mSm`8K;O%t-^GRUe%)S1 z?%T4!4S3It9zLzFVl`_|aniulPT6?B*1GXwLMY$sz}RnPyM3QLo7zUNl5c=$zZ65t zxY%0QA7mPTqWx7CUC?yepNiJ!`7pfd<6j^rP0)>uv6dyarR!5@TwPL7Hb3lg zMm6R-{h{$O&Oa&fPw-^Cv^zux%*KN$YygTWOno_{yOTYnqwpTN$p7kf_kZFWWzG!; zK<8h6RW`Cb9yH6cf4P?bIC}pV+|GtRt9?XuRGx8(EG>&0|1M6>xvdIVS@Jt;v4 zZd%?hp&U#fw}yt>siH<(ZjHh;?JVxVxz&Ac6s^KgK^nV$6zn&c;A?9n1JqcR{ceBo z726y*9+edwi(MD@zP9ysQ0Zl)pf*k*9xw zX4W6|D>ehgRS@dz7M;O@&J!*zCn(`gY>fQKc(>wIjy1L}7)zXI-lD~$v3F3P_uO1uC7wEU zb8vZ5YWb0^N!yqHnai=5o4@(%izu-gEx)=7po4Znxd@%+ONxicg6SRZEvjMtbcqF1 zfrfWnec!d9I8NEfpA_gZJy1GR&U-JP0@;Q@InE=?9LfMfSQ|=_x-k*vxlCl5dggEQ4 z6zFq~m0X6gZBiX&^0?Q0KbQGcm<@}v$vtWhNWIv!?y~wU_`GIr$yUOcw%3k>uQr=6 zqXeo>iD0Ee%_l&jN0t+G(`bF~_+U~U{ZMv%W<4AUI778Wbsp=wH=|D#3gaVOvR~ro z?|m!YF6Q&nb^rN3gnl6%6Z4QBPHSi%r-FzPM?pb7;&(f1HF<6&GMu8WRag2U> zN7SfrVyXEL>*x9vb=Na`?r}hpX69$!1bMR#0e_N^d=}P@)(ulUkBG_bod&;)S8aaV zrP>c4DvDOKI4F0G?)%XnbBNFhDkHLF4ly|dHX1uOfZn@Go%|?N+qXCBDzttq6(Wu! zYA5b*PgJCL_BGEWm)^~9%G5Q#}uiO*TUel?3}^VW@NpsM1k=W=0;5;tq~K z^HbTe34Z)&@fS!}g`LCb@m2C)pk=mhq5QonTkvheflA8t7Az^!9#2Y3e zN>STuTIt>aaRq1qC=Qyi@`M;O6g`C7$gj@RFZp52$Q=MH|L@6V0&CqCJt_}Vz!n-0 zObd@RxOrdUx@G_&-NoVqmoiFIr|g$aPRb=pNvtNiW`Avgs|y zfU5XZ2IRmQJi-mnQx*$z;xAbrxe9G@u~0q=mk5{KBhKX#qM}wvK@IA8mA54qh4cn> z`r8esFRbi@E_jHWv9XC5m-hOhGYw!G)P!5xpol+r^u>c#gQ4H$pG#XBHv3q5h2fa> z7wBVL^Mm%lu{eN(C|l8_-bHO;09`x3yXUmN@~PWuVxE$W*)x4cMoA-ed7nu+1&sHn z^*CCmXwdkGjTO_V^_8~vnRNM;$Ivz6UX@>J-0Hif23ruF%sVB-EEl=QI}CLWqI{N4 z5SuOvnVRrk{w?DQ?n`AlN(;6sQ`eD;J#5`21;C8yun)R#zeAd6e>jL1SGoV^9w<4` zTjwtxmCEE!*CtlaF=#U(t9o(y$I)$yM|tpX4?f?9F5qHW*7?~T>wmk@5?H^Fv&8+M z4m0gOQsbT6;lX81z-uxEnf~sKM~5-_jwlg=vcQULXHcdl=jQ5}I$t4w&o; zBRZoxLJBiVmLNAjD7}~ki7ah@9u?P|*0FGl4R*3B>6^W?!g@CQAITC{IVWzqDT*j*`c7 z>flIrTWp~JeV5R*zS5ibTcS+4x@Q6Tk6s^4@1=S&<0l>_DNPE8#HA0aTw$gLUKHSR z>7ggzOVj)rd_L=9z7)&n3W^W<8R3N5uhJBn5-*ivnqxb)y zHtD0bfzV)izt1vYbb6|AiA%aJeVc+Y$yj4sKBm+{WV331HkAn4<77AgdR@==#N%7f zVZ$&EcRKk>6#k9o17QXD_v1`OgUZJCkEaz$sZ{2u2#6vCs_SZ7#KLJXuR{wjGObHr zr!fvcrWP|f!&>79EQj}RqWo^tYNdRzzRSfjhN2h60+#A=dI@sF{jWBl!eC!_)$jHm zxaYCnhPU9Yt@)@Mj^8biGk1d6qt7pL>}1!Y-MMD$1#b!89z|bk^@w#J`%UwTJB<9N zT7LW`ci$+_nQnXwwyDx5Z@PKq(2AExyb3nl`O3$m>Yo02OD=D?E%X`E^p}eQwAi+o zTHJlx%AgsMxF%H!Vm9q3MQ==Nh&B!x0Zr`Ln|50E&&|)27140IP{pUvkJLy@+_bEj zo33VQ-8Ja%3TFFiGp2w)yc$8(i%uV5jBMcjPbko>F> z_`hHI=wAb@5wE7gTKxoNlNy&_axu>{$>~MS|0sbFZhtlg7xf0}ryc2J#^<7yyP|aBNmlJAJpsxpC99R#hPp8P45=_on1tdymVpCHZAQ2qzQw8M zbQ4#aEgZY++Tjk)3m?BKJR)}_q|&fdfw(4vcMoHJG7)Z{5+pQD7C@8M>3M4r40DC1 z@rC@yokioEV~D-!Us`GJrPIO}!)UQ-8;%f#lk*|1(QeA+;0AIwW?c*|;(_?~P3%tQ zCbe?Q#}XIVV$uQq+U%==!&EX?G-jJ&w2r`BJtUeyc~tW(x!Cg6A)^vr={8zjjicNE z?>d(A-DHtbpW=xx37rK4`co;^5lJZ6tJw5>;t;g}ttT^qg0+#7mo;O8TT{q)M?;+} zy-m~TOr7{!JOh+wJ!&i=#a8U}h_0r9A@Llk=igAh{YTi)5r=wo&9y1KyeE6bQ!U9=R~spBN>UV*9MhlrG0phGNq=<2gsJ#+8oI510H z(apRvLtS1mCeEc&uVO%_q#^cd4q@_!UvVu}oMy7#$qSWby6$hgcT|bVE}rU?+*V(T z-=-XrK?v^jLzff{Z4;S9Qg!)X3ddALMULMV^p}C38QBsNzod-pU{zPNvVtm4F~A!V z%AZ04p0LWR(gFGR;X%LMKPvsMm+l@1e`eK~80mN9(__>6!mL+8d}z*QZDj6`L7f)G zzRn8kXDkE)!~ctz2XV0i{i(=BU2U;ArPIh_Hib`z!`YSRo`}T8Bba(c;8CpEuRvvO zy1MK|C~_db`2n&L~n`ZAnK|kxzxij%?nABYTE)(DXxU__CwoAwzwVhSWE{LsihTx3KE9 zfOU<&ThccpGsQh(bx$9)nt($1y+tr13Ug#JoTEs^e-*;Sque!U1<~%@At1_IK`JyU z=lLXjVUP|`s~L~1t5Rw{D5e3{#LeXTi+N(8n}3g5o23aDy@Ns#SQ;Vx1bGfxYQd)Kd#w*_ z4N&a4n;BG(@R55MH9D=Gdwi(zzlN0zi(LkZMM_M2N}pa$SbV1w%bL5l z-%Ujc1&Vn`ds-H3wPyQHf3Bk-zvVN;ez{U!ek3j=OSQutpg1zx)EZ?0jOb@edSC8_ z6F-$|$dOVb{pV4IyW529_!hW6o=WzyGZUQ`;<6p(Zob;iPCN!|H~&`S5PrHn}&ezbeK&R zG3EJQGxhC<+ob9BaEwlTf!w^1puzDA^*GmpIDwv$s?tmW6`PYHiNhh$T3Y!xcWp$k zd@C}u8Y^gBT2$T^ohFG%3vwzNFu;AnFrUY zhlqUxx(WDib=SjcO zN~_&BJnjq@eVhDO=Q&4zv<%gLV`*nUdc~8BM2peDhLS@0^$`4s7&^Py`?u&(OT4gwS?hTHAlcz+o@08;41=z*)vbGK!(;QP4PdCwf|GT+~!I@(Fq4*b>`C$A`=rqeWHXKDwSCNj8ZKXK0_`u%NMrA__5SP!i=JJ`%ExP3WV=88$)Gvo@!_Ya9HILo#@Zb-=1Ip>!hFiNs*jhbgmM4SU83-3eGF2Hn6cR_{;j1 zE~aZcMOx(xW@rKl!A1Z8RiKrQ?=&w`J45FP=8s86i9Mf!@fteEvmuFDcf_z^Mn zUq_Hn>X#Gg5k{6w4BSa{$xT_yCkw>>TBiiWLrZyXa%I}iUKis`6-Cv?{t{Ob6@VKw zLkXxn-%Y`%`*a&Mxy2;q60Bkx6F^&)_qz!dA$^C9)Z0GU*yh`+%=Pf~U-EMmkp=$O zr`ow*;8+uYrS|PVIQ)S#;&Pr)jH?-oEpA}r*ELW=ZLOcL1&wqo2PeHBWmyg(6X4W=}kT;k|sEq>I<)uldagNP73aFj{ z2pP}ae-8eU zP0Pxib9xqI(k*WOS^ra=^nQ%R*%iX(cJz%xiE@`PA)oWvQ|G@xF68&tF^=3>l1G=p zED&II)F8ko4xq4t`R()Ml<800gqvACBta)I7rxKob=fSS6(8;FA$OFfLHTk7jdhxU z+H;UT`Tpwf;&!FILpJgboA=5^HGKOHzu=bomy&T`=Ooa__i&uW9cKYt|N7dy_TLzQ zCK?Lfbf1kuPqHWNObH`fTWMhP44l5k6w}-hdM$UDXz;VuEZ>cKLSy!;;Fgz8&uic2 zA3Rf}npQ~{Z*SNpwMOR-f2S#ir%!jYa6lMnwo^klwl6#V*N^x9p-iMafX66O^>V!d zLRbZk%akRo@p;+z(S>HwY5wI8Gjo6yzN4*yvl|2QEGNmppX|NO%D9k`NmP$`e zAlD%|M#Gm>9Etu4WQimALUQj?j`QDQQS&0l)$73%z?k=cFlMZ*CUXs~xSDX{PNYKG zLd;+<2R0&~j_bo`tbhXi>oLn6U6sktSe=;pN=^lZYzz%3xDM)qwE+M;c{*M zhp}<{Q0me=!$ufkEu%`KMC~brqh2DKHML6c!{-zXO#3L-_FnI)z(@aNyvyP3zH=(eshKAC@%F%=^RGlU_qLSmT-pQpF8G0%Bn?;L4n*kJ?a9cf|A#!6y;C8oLZ3_7IfUV}zvh$T4B=UPPO2FAi?6X`0+ruk^_6epF zoA1+}Vq{lS{{p_Et8E|#rKDwlaoJApZ(FOIv^jqMtJQ#Tb^y*GF&S7ne2|_cm$Dsk zjjJi-71%!UWd7l`A4v*4wO;X!Yje{Uq9zAdQF0zyfenyhyQwGK>i0l%4iyUhd_Bd^ z|6>xg!NXX2a}rK>nWHo+GWCA`fnLOK&x!i~T$EMnRjEr&=sPr5Uc`9V*rHbdK^z_> zYSFC$sGsNXctq|owQPC+kA&@N5g&^E4m_M_1Pp8*tJ2pSdilj~O7lz>F?TzuAhPP< z$?a4X?uhs$WvemRgj{g^ammocy-3dE6t`8mE+S9D=QS?_BJt+_;?T)UmqnvcE78PV zGLb=QGDlotMM8sWm)lGpOW?^Ba@}nxXj9P&yXn}r`ANl$a~Lm}&3cOJyotaYXQJBDajMoV zP^k&@T6ktLImCY$x-rg6Uy9F_PQBa9j{eR`OiM1EZ(TsX|2CH>T5cTGyo8g9Ob{Sz zXm+2uQfAvLSIVt`*9<2{`h-|n?Y_;AYc78EP8JG_O}J@>EG9vz)dqLrpH&QYeBN~V zu(*uQbs}%;a=v{YzgD35)9s+B(Af+Qeu}B}Dw_y7RHBcbq#VCfiRs6Fa9UDUN=cTd ziBEjnf%SgtB89u%fEu4-v1FAffw*>MN|8jB1Sre7RfWL5MelRY zwQjGEiBsw<>BnfeljH_O-HtYaSf!5#TWuA5kw;|B2Mg$<9d+jsg9FU%)qC zq6n`G3Z|sRRM-F&#;#QH^7#xIgFQrd=9_7$5J%?3mE8=NV%cl*}c0x9ie2U?Znj^IJ zqr24Oc;XimJVS4C^rpBjWV#!MjPO*?aD})Oj3(z@gJS|)@DheR=#r3Pd>eI(4rkd) zPBqilTtClz@r)XNSZ!bpAWN8|v~&I$3R72r44TzszuOdU-Bnvcn!{y2 zVqdxz`+hf^JE48ZY1X{JQO#brI~RKU*@Vli-xosWk=t-wcNf`MJ3bL6WtJ}pR29Iq zEasj{{f<|%wz+>mo@#xQV)uS;o|Ly==SP#`Gy5DAEyu_fPg1c zc*2u^4Gmc}S2mT?B%&g=wmc?X@i6+~!$VTS_4L%M(8cn;PgngvZ{I|F>&!@);92g1yyjt4VTac>ASGLs|(-1V3n z6zU9KLah1@5OxTqnEZys`rw4v7&+lB#Az}5YPugnxbQlx>qx+W-=OfizH?t4`Y>yb zQExrXNkH4sWlnBci|@8YnULSKQ2)d1e1nt-L6Qo`U8Y27vL38qyXf4ktVkVvD>qkazW7pvVzvqiR7BBF)w_WGXI z8LBe&$z^ouRW{X4<~LwKl35kBFqmp}=!3#_a~j+WuYG@hx%HKK*!bzn*;d+<->^j5 z@{B4<*=H)-GY*RTT7rp((cri0quQgYdnU$?-3#vblb)=DjOSm58_K0h)NDK)*J~y! z`R45;;y&Wlb*903x@nd9@QCUOLj?T{Ppo{#YP+>yGzr~O=SGnWVOg(nkezk6X&!JG?c?Lxpt_#$p>~&aWCBuR% zGi6N!rA!lI!KqlA<#TK7%|iRF_0UOeCFk;W#U;@0x%)vZ@!vo~v3^6}q%g6Qltwz?1Gp>?GcDm1^V2Mf*w z`6?&pmW_T-!<%@E!}vZq)RvhgAx4_|@X2GFp1D>{sBK7?ZBLiIP8zMpD@^xcznp2@ z*BmgtA`NAbdjDEAFdxi-^&!zt8KcjYpJoHk6N>#JyCyW?Bgb;yK{+h!j+1#=eo2TYb~~xBQO_3UH-b+I(XMamtsb`704Vy1oL%ZSv9c)R6el)Y34p z2=Y*s*?+AVYJ)%8FU$zQ7{2jM=bCVFBVB#=}kWHi!4c&;#NND?O}YT;2M zv|(51hOS*4>nuAF<(r9Z4JZ1JZ)Md>p$V&I7#u9pWu;6URW;>J$2ey;ZLd;d>`n>l zbr$mNY+p^7v9WXr91P1zVo;ZS{0Ws5IdwFQJ55=aBjCBIo~>=Z(o5h&$osDTP>c+H zV0bC)77J90yS(iFGy(b0uxm>_wctMx7o2`cT=koCT8Y9_`b1dSk@IH4wm4X*>FKtg zxklBJZ?7XAT}uA#$H04`DH3^4&wYz8wBKXyzdTyGreJRrUliNtxBMt_Rcb&G)J^7w zoC9x^n1s`^G2mwsR$orw_KApuJWTAH=5o}09H}QAd*6A@k8{O}`$_Ft;m+=-*}^ZY zPv}0942n-Wo{z6dO^@j}GAQv1Kq;Sz*=lcxq>yY4QcMyuG8u=Ix+GIHU1PbHcW#z) z)K{?X8R!+7=qH+0GoBIr8o0Bx(Q|(BGysQB)o9_nWZ+j5{<4hgw~sGy&t2fEkM&_@ z@aB#De#L4pZL9?Xd~8mO@!tH;F7)Rc&*h(!J?T~1ofl20dpYth_+^JwrD#&%WDEaU ziEFo+be2MQxq;V>69^g6!TH;ALPkniR@EVdWD-e072UDpyNIAmZ;hsINAdmJ*vbo; zwu>%`p05*iZgchW4f=94O`gxtu zy>SE&#sC_clM3q<@&x%3wIT<^D7|eXB!ytn4@-9-&`XBxy)cC`URJq$NnxK4CeZCA zQtK~}{QAOfmcFuYF-3;NhmN9)$Bao&OhM~ov?od1#qZ}UR&7c12jE?TUL*spXzDx2 z`sYa=478M!woKXO?nN`;-Gg7@cUZ~-acgs`qCa_j)nJt{yTPJF(2{W&;|y_S7KSffzP3uK$c zxgneOxq@HENx#m@XGjb_bFhd0h!h375$f3}Y(VqlfcFumo}9oZ9d{LlXG11=wH(D+ z#fgYY%OHXiJ|1(^zIT0U8*r~7m{kaWNXxgRIa@cgm~4a{Y^@ENuG;Jn9eUfW{_6rQ zty(|JO{D7C-NOmVv!`NEZrvBx0)-+)3q^yr6t^Np5{d;Y1SwFQ z;7+OFE&=$Aio&d!u+7>AkXup$h-*fIb#+{+vOBmOc8q(a1h&t7O>Cidc;2uAhm^U36q61-un4Q3^$LzTDl6gA6(SiqTD)2 zevkSYY0g$Ke((@YayU#bKe0Jl!QQw`c#Dn&qa)RU$DDg+L0V(+WMzw zkG&za-;+^+htn%o@sZmwuCw;-Wfp2jB+B^fJl z!n!*&4@Bh5Xt zbmDlpjRC0N&4%+2AdGGT_#QQFg;ztBh5fVY!`ozPkIZ&uR_9hB`aAqQ+j^3@Mm?-z zZOc{8+1tdcM#pNOQ?`uJ0bQPAS-QahwAlz00Lrr* zWohMCO`{N3pgB5nkiZ`8U?%UI37_W%^JW^QTpD}UfQBT5A+EpIAm=rwadL0%00Ep(ajCaju zz&{|c=Uw&viOL-Y5IdY$pv#12GL;CxwF1IJh?f|%gVXL!IkbOp^!AE5<8~8qzjhT+ zsYBN+hET$;O@$x7G2Y>KeE~LbSApcusH2t2i-3Jm$7$ERp=@vJW?!pydM_HfcXT%; zp4^kgT#D4a(0d-&%)iUw*hi%l$T%9o4pD8zk_u>9S%Mf=9d@4X&{qZXApD;x%UAnr z<~c6hhc#D8gT-JRuGx|hXpWtZ`jm+wRc{&+2PTK>bW6!nod?lcVs7T6pH9>}l3C#p zYtR|@5f71ODA-BiZ~)HKZn*F#-nbqBpz?8q?EbjXvptrn^{hmd`67LAuC3%&P#!fQ zl6TRxh{i>XeR2AgBWVxbAQTe!TJ^~ZTkVTgkH?ENWLgEq2q#xx7B{;c@&}MRt6VE* zH9UjtG%)!4C`54Qh1iiR;-KqU4$_0&v&hLVaNqkbPkHkb^Y&+jiAQYgKu8BmqheO$ zGpGXR`b4y!O_2(4I_r3J+=C?)E*%%IeN{>l`{XF+GFp{7^49Ez z!q2D;F*48LcX4G)nSK1c1kBB2tVZ%u-HW|8T+7hmR?C*z$E9fRNPi8Q_H}iB4JSqV zY-Mrld?Vfx!S#*CG+#fSPRL5Jm&q%+%q)e`)4DB+01@7tIN$?L-7EFq+gnJ79rwDD z5Ks!I>H>%CxZ&T=4TJ*Zo_f5O-ANVzc(RUyPc!! z;akj;*=x2sF<5Z+S1#M;{!RXcKQ5_E`#~KZwf^@}V-T;mFB|EhEdug_6e~@KC(?}| zJ{d$)x;qX!mT+`|{0tw zz7Iz1C92=-&R~&aQ)TuV(DB(i%`iz#r8&DF3}N{ds-qJrW`I|!f^}(I2!6;1JiRO3 zv;j>GNa6+hszX3i>u0X|LpI=&()|{Att+5M-@Ei%L4;b)q{a_f7oOUbl;*HMkN^Dm zUH)c2r184gD^>UYx!)FgdLr<2AapjwCI?m0y$LFnA%c~*sk|eApHHGsd@D131 zY_DGa7t%yREkxzVR?L%^y3;Q6^hWL}JiXC^FV>uT?A|T8ik0!j>!xHP2mz|gQ6$Nj z&;9$}*Bt?t^la8(P*4HI1PwRdqnc~g*S0b`|!rEC?baTDjo65J7{MHP~Aat{^}xtf1Zb{2&Mm-S7EWlD#gD5&Hv)gK-HH8dV1|F~0elPN3sP?Djgq!my(p=}s_GSrgb zQ=(KwQ~A+=&1oi5X6SeEan{hMzqg@9al^cW`5tK;XiW$$Km@!qnnrQ|+&bLz{ZG<& z;r_&N`n0|VEsHh(H;54bT~hFWnkIq&Eb)C#9~+%Ro5PVow+GuC$2*nIi!4Q)IPP!x zq<>Gpwe$b>sk>}r-V0-f*{~kH2x>Xc)6p@!Z=o+4YRuftaq#D{%dA3>x%Z9X=-e4H z)U;6fv5H@qUbh3w-m7s)a~KIl7^_cZ4mKuYI@_=kB(rGg)tYy z!H=1SeDF!6_q77gz}U}X*+IXez08<0ONEt}s)#yk>SRSU6HQ%CSlznpDgzjY7Y@T0 z1{8V#vHYEQ6&Nd}>9_TU~asKFK>3C~r}3_=YpNVT>Rh z+z>d&%_9r*MIFq&y<6iMkNhWb%Ek14=4PP!#nK0)zd-ikss#v4|0cKLE6~(^t-AU0oi2 zHxRzf%U5+$+=4qeeWCoStH+P+w>)|zu+?{1F*mm}aVMB{`Im~o9nEY6 z03KEneFE-KMZe>P4fMIOV)`&1 zZ=LTsWGC5rnx603?BS{!X)C&EtLkQ(<)u?>!a8(+{si+ic zmocJkw?ES2j4zD540>mST&q%M#FBF<6S)|sdAO?pbb`XzQ#y~k(GNSw9xz=&R4%<{ zW&S?gk2g;oXk$qX@2c&09Qi=1Bl0{uk6I)E7FCU}Ex-u5*G+>bvq)1sM%>Zf&DQ#j zIBRIz;-Dp}M$~B$ur%Ij@#IQ}3g_#BSu`LQj1?uz29N!g%xn^H-E+%jhMWau)-qUfWeY zAX=*Rcawb;MR-fJ*Z}$64D3;oYnxTjyaKIhwrAz0qQFcS_*SF<0-afXXlE}%3pwSF z27;**ym`=!x>1blTf}uz+6?D0T~wMi4j$tYE7(gF-7l1Go_8)^wqLnY8;Rz8;1T%& zmW3Jt80Jv#C@6@@d*K{&`M=N~2AESy3i~nUsfw-1%1{(`TX;x(ZJYTHLO-baOl$O& zyy9EWEnjdp{Zc7Nl$<-y*~BM#l}_xpUvN{Excbb&0>djTqGF%yU>i+(+yT*SI85fR zpA>j#xz;)sc>PuvD%-@gMOh{tze=+O0b!DvOBLDU4Vy5f%e+fXoyQ4h%YR3^ zrd1tW>Yx{kHNrw%GH*tk(fx}x13HfzXwNK$>hTqvI_4T8L*Wg)t(RPuzAWlJHzP`tv{bx`ZWA@@Q|L0rt9+36X{JVQoMb4gg z_r>p6w`@;vX|}tw=EW?QB6CPct+IPY%tan=oHr@%`$f+vO~el#_*=oDOX*leIah>*`*!Zk1Tjs)pTMHsFqG3P0)y;@+#i zx;C?YKn65y4%8EsrPIlDB0Noy;RAA7;O83k?J>}IS7)1 zx3`j1i7Cxa=I#m?;T3-=7;pRe3jTc)*AEGElEfo#wyNwkbkiY}J`*G2>DXv=2QA+Q zUwQp`q*=yB+-+$EIqX+63RkI_TvbOM66(A03Y}BV|7(-~N>nO)%(J0IVbT*f2DZje zRliHErj4p>bP9kSI8P%lYz)rX>d&h}lZj)!z`2AZxGNf2tvfNH;W=SY7$^dv&1^Zc z-x5A2P%qf}Ih0`eQOznimfG62P=ZAdVh1>Xi1qSVaaO#qqQ077Vv(9f;sq7q_B7g0 z*w3f=V&n0ne%L3g%z>tpaWq~%0!9HCCf^}WXWg?@)c+cR#_V3+7GU7t>Fbr$?JPs8 z(II*V;KTOz+b!n9UMOW0Z>y(AD-{TQCiJ4{KoLBXi7jVfXa`nz!aVO?=!!j?vQq4X zd}v-0Gi)_IFix0bHt_4A4t#Xiq>{OgUrik%7zq5KY@W%u!$<#q>S|8Ztpl_5&|m-C z=8``yN35%OUeSLP+PLq$er&Om(rUW4Ip9#IR2-l=t2GquTu6V2Y__%v@DDydV9$zw zlApB)WnRHRK4-8_&GnYG@O&wL{%*9uRH#sr|s~4mOY5OTntt~jW5O>o;$J5;C>foH$8w+_;=nu81hhdNFNzwVq z4`1nn>^!UMM>4DJTy>)dh$D13h2^)q25p}FWDbt)zaj04Ym!oqHE9+WNludY2@L@e z-OFfb>a&xV2ij>`tq@Aq1Ccp9Zp9(B2@)t00C`o;!#fjG9?=7L+X$T>FTG)QjH~)Si|~RlJg*a80AG5q53N zOi|PBlQugR7%n?dbm!;{HJAAI9Z-84F6Pi_o7nzw6?O7=V+4(xCS*BJoJW222<9KS z$D!c){A{-np)1#`W*mB2IlpjIE_;7PGP5I~e!K>8AY!@O^nt#xSr;vJhExh?VIcXy zju&yHjH^~6EUU6pa)-&0&cQY18b0K<2PnBb^GY58tqt5i>Mrm(^bcxM1k2P zq67i=1;&n*Y8z)o4ztPn5qG!c+x#|g8+%Llku5{dl~iL+W*kt5_m$%B9z$y7J7NZ+ zHs^i}xnu@TC`7?&=ebhAbtYfmVgEr8&z9BY<+X`u;$RKc`pGrNCw2BrA$%;BXS3mJ z83km=f}>$w=ZYkE--2|IkznMhvP1AsrZ4U8qbTOOmYek10rkd}R-OQ~)Owc=p!^FG}(6eOknUn(-o<282V=yjaYXe>l zrUW~L8*LP>kV0i!0}8m&I`kee9VFvVKMI7|kfj(XnV#$_>tc^9gigsAA& zm+AmMgK0zjtAk#C6I=aVQtJg4DSB}FvF)+^m|L)NK&WH;bC)0|T>B6p?lv*u_^6a> zXuj#%81}eTSg?bsEGSzVHSaz1YYa`dH{^R6;5p_C$cv4x2YnZ5SU1iiyc(YaeJtTRG_s_pjT)5I??JYDIiY`V;NX zVz-eK4JPs#t5)9;uaP-O`EJX;t8q{nayT6F`Ko1 zCxQtmEt|#k_Y5w^78w&Nu0AWnmDOP_@I0U?(b(M8qxA9If?CMbNLUDv(#y~7y!pNP z)x#SF<6v@DMla6WnyO9Gn>e&SH}1--51$z^=sJ0pzw+S>x)z3wDRhNvgQ#E(jFnA@ z?X-KteidPrnUM?y(~h9`xl#S%f%u=e|EcSoxKzOu!8GQoCVwKyi|*#XlIS%rzu~r;WmL=#5 zu7ew>`P#5I&Lzku?D746uHWjaIK=q9kr^YgHeV^m2E@3t+z01dzJF5SAy=_tsr4rw zswO0MX13{i@^weUBg^URw*u`y2&i6nSht7Q-~gmKo^)UG>;xo=-EQ z0kF>|09z%A>YZbXCCW&nU`K5^(;P9U(0Y#!REl4xu-Sj6FRd^h^%ONx=GkuPci9&P zK)dJXB*)Z1+{`%rO)d9n4(x*?1!7%SU5%qp- zC|oONy-79KYc{+1WVy}Tk@KOPR)CRUL%56M*YBPHAv4AjI%$J0EM!ypFjfSksb8Hx z;I2|?KZ)i0@@8p;-PLNY`Nuq`a%7J|R3^Wk7^xZ%aPP0MT6lHS)`At$#zJfMc}J8; z3!PF*ZVs8pVo2aZJ$Uk7Y7+*HgaLX);N+^OH|2R&&kAm2jDZOyHBRS^E zLxbQZfeU7n;nk}RyO@VoAy}{2H2?C(?NRiKe@s^gw!pi35GMjvyDBVuPe~XIHcle> zn0>^dBXO;zl*{r*a3G#WB0;uG8=gH_ffm*D)z1qvhGg8g7_nT5>DShE@m1LYFc`+J z8V?$KVyr4g;0T?=B}>UwHbr_|`vJKTn=(q+Waq@87Hp@0UoVU4^1EA@EoS?oXJizt zK7AqtqfPxlYJ-3rha^vQT$4MLivX2W2~&T zMA^%(yTVFwu31&3KnZPs4xUMA<{_eYX7ebj%rfSv)o#5-$PUib$Lb)iw02uhkLatv zP)bFfuQ9V?C`UkAT~W`3e(U79tWkl`CX&lxM69Ds`@sl0T1+v_qFK*}W$uecU0Xml z%Dw`!`K*ztX?Lk~50=AmC(6rkv^k;ht3R?FtkW{q@uY6rKqza z)7}`FJ}EbRKUnAU#q>nY2q4*Odl7yTs8}YIe@C?gWQE>P_6~eqmByK+z_GaE7$cws z5k8B%(~ZpyDVtqyhfx)L{TRFUyxrWurFDPRnrG~|*F)r@dqWzHc$Bl;F$(=%4YEo* zEceZIK1fm8S_Xm(z}ZcnozBP*Za)=i_ZBqS6=fi|{29j+I$%Us_h z%9)JR6!U~qQc+N@XyNHy$ylX)jH@%PWB$dsn=es*;P)!$NnZuKQBRY=560g`TV`xr zTbZZSOrGfT_VnKuPt#d8@|FoVFR`b z$eyF<(V|e(;p5Cvp;#!C!X53NYOKgj3n!L^JaZG-GzH z9Mu5BM)&(nj1)A75lT-!VaqLTXS_Ft;^}X~9^%^BGFW%1X{Fm>84V~OwA^;aJa<&! z8u@-0U%X+-NI{phzvsE<0%ZnQ7L@~<Kd^gt0xQ5?Nel%q(pM#I^9RXL(xF%7j z62(Rv##%gPl6S)EiTz~mCzZFf%3MALGw;4ez30wae@Xu>&3H7oo=ca5x6PL0Q-@dg z6Q18mlW8kZHTi5l9jAkf`5bFUIeep} za<}G|T@5Yb4*iVQ6_gooJ{=Yl0-stW@w)8ToL>_A3*^m&CTeNA9V?L4ir4(unfWRH z`h%NK$!J1x_&`U|7k=)Oo%cyEO(V2LsUDA}rkSy6kKkgi#ZSh6EplCoZ_h8+E*7qQ zZ+2FyhT>MxrS6cEx{vhM#$hHpSAy&?3a`TL#$HO~vV}}-^PLxVIOx%1w%^j(@J6rK zpC~2MV$~f3#k0hkepmpFcv+>rUY!#)Pqt@jJY$Ko;+kI3O(*j#WeJ`Y8wsdz#7ZzA zVbtOT9FF>fKCMW^G0@nJp9H~|1i#yJ-t1jksOK^N=osyiy1YG*&%hV9y- z`dwPLG+K_;GR?#gNM7W&L|ptxh_cFUStKH1>J6|{WhU>TOil-|)9Qqx)e@OvO&^rk z*LXWL&ph{FZAb;?rU_n)R7xC$mM_8oL__IF8!5CuUw>N6iK77^4CjBAl z%yZd$4l7e0_4#lk}lZO#2{=%B^n?TY@ii#7+b7E zh<*_2ms-^xvG%3{GU7)I7+{18tku1wjpwK~VQVHN@F(grvZ$ss#M4vw{!>y#|1Fqm z#2BUHapHrTtc-Z3%PXTiVkxsH2U5iNSECn#|1xIgb`MW@Fzty&9TrM8%1)uw7N&T;wX=(xH*VVBTy zx(tse9LgtwS5t=cXYp}auyRyqPw&WX?^TIU)tPar{8-!Z#SDA$$@xe-c3p0Fwvv>h za2f-;mhlAq+%O%2dj^(Uk+1nSUtwl3$-T!sHE<1W2hPLQ6wymoH8arN%6uabkZ=8^ zQ(Nq}P;c`{zs_9D+kV#-zG>f9W7^5=`Qu|{njn(S`3XbU9zHadl$(c8cr`Ps^8V)< z+iVTD>BVeL>ukF-=30aTjNq6JKg>_u9s zf6x3%FO^E|AzRP>V^SlmvPy0`U>g50i@-eIkrD)YbTj6>dsfM~WVvQ&3Cct;PlEiK zeagr3w)#1BKl8xlqyjFAI22DM>@}wq!fW0CCRiFfYC&eGW*Vr}*>!-zCuD1y3eS(4 z8uZDZ6jKe$@h%?J3%(s&I9beyrIS9#X=S3^Q@B?JUHij620ap$SvFia1J~1aHkt1t zku4vaKx4JE{4Ek8pva+&kJ+@<^S2Q655M@l+Q|0$z_Lim@S3we#jTl5$?aFA`Wl)2 z(SY3*v8?tSSrQ>0ASFNbLoiyc@?HbuM;j3;8*he6h!eMH3T`I7}_wne-z2((2OkWEDH{T+n{Wb^?L8$Onocb*7c9c zlFm_gCct@6v5>?ntcX>ct+OUE9WvPzAoz0R<0V1jnSLp$1J-2 zTJ=p2(lDH9G>yg8ug@mDYC#Nd`Xf5waNV8o`qydSuW^>RD+8yQoVNB*e|HoAmDLWdnBzf(Jl%<3(Gl0S zCaPWW0HNbJ9yKDw$M$abKg0VEG$A&=Prd|9qEN(n$=(+V`)n#pDFR*gex_tk0%Z8Q zb2;0<%}eAXeol|b{yLM)rAwUx4-$l`|8wWy|H{?+Z&ULB1G_!=b`^JCc@+{ixKiqs zX`S5T?JWexv7Wcz{XfrFumh)#@?T z8x3U_3)leqXY-hswiRE#=^LWNo;vSsL}9H9dCsdiLiIfYShZ8%3Ztd=s4pDRqaEfx zfyR%?iaPfdt@DIut|WwY=@igJ`9o!C%mrM31N@ITM)qvf6;IuMS<9Mu7nTqA#ZSL3 z@~1(J1*T>6i?h4AAO9t7I>iN1n=Xj%ZRhYPnZU^1aLBt&%A_SCHEPT`guxC2F~M;Q z$W3x0%#*$_Xg%+6%0$k)FSSu^;xzB=!4R(obwjf(J|go@S`F!0M?nmsDgj4vn~^_G zL|{7sJ!&3#hWXm-9+TK?jcv8D%wRrr$vu#5nfq3cSkR6CuC@J6`+b!x)mF$Ww-kI@ z{nk?}XBz8l09l3N%!-QlM(3VbVbjjWATOJ6cEVso7$tZRNRaTYZ!$Y1Ok^}8J!#$z z!+-9(n{^t#DONnZ6=y}C#YNW*)nrLIbOW0n=VUF zFc;M>aRvN+ll%rkA~pqEN8zTG{+uW;M*m(1iw)P-hkW;a6ZN?@g+L4hs$kz=%96kV zs}<;aAZC*;{V3&*>(@tGRhp;?3r~$3hx%s#pI6oOQ*_!v`I*rU1ZjHya=-~+pN&1SNA?!Q}twvMh3TWA}+gW3*(55Cn*`R-J{ z+#aE|EkXt4<#uL#PG@4)u)a-asi;;!S8#hFLzA_qGJ0C6t|r)Va%CD|f10pPTm4CE zrrkM(<7vm5lY&L6=lkmQ;mosl42CiJ{z%YgrFVkqSMQo6!%g$t;;TH2PnwTVH!GB~ z?B>pUKUrb1T!~mgUq!Q-AlWvh!F5Ubqy!(4b0BetiWJ!>0A+nL?V00+wi5Sw2x?cU zn!2CPL*WbQL9|z3f$~0fr~(Vh5iE9ons4UslrzCSqnDSO!Jt#0)S@nvNGT)De}|~| z9|M-Y*vlJ#nMW-BezX;{2@dB?vFZw6`n?}-d8Wk+l&~p;ywd;Rselka^%RYxw0lZ9 z%Nz9SuF6;-8QojqL{0`_fD~Zbx!=h{5SPxS;Tn*W_rj7xJq8S~Vqm1;j-aKGJ_hxy z7!L>Sr7>}@YRWE4WG8F5#J*{;=2nfTSV`$B9=k8uvb}=k}ub}6-{Vk9pq_b4CF4S7q)!YYLhHEOQ9foyz8V)ZrFF#E z2{7xPrg|I6ylUUU^xe$IXvuu_8SZfrEFLh^;F&`@;HJ*`vi%md1_V#Fz!eU9O-g72 zl=mVE9(@}A^fYwlaYZe7^%#w-3K=r_@C3Q>o_+>aC-^eqGd7K(B!Zcd5xM-y+dSqP zM!L4@KRbpC>qJ+*`o!j+JCorDt+058dL_BZnREcLgL^u<$dMl{W;z<`#MGPl9f?2u zSqwhpRPK#iG0pH2b*DbbZ*!wq$PeAMvKxr#&*s2x2WWYMba9MuNj62`(R)KmBYacW zfSzmB(JfoXfU8Unw*BDOj@yfco44(Y6uV zV5UsZlwkNiu8Uq1RL$pljSw0M_~5gqar7&Hjxl=$1k#@=#4v6}*lKtY1iYzOu#$Ik z`dBdEd+gS==6{=?_&Cb!L}1lFgH$pS2!=%~tGBv?}gd6kZKlS zxH}@wQgRww!dP&ZqHe3bcdH5MZWHp%b{-#dxdu7!EKeimRm7?jU$pnxYc?o8Hq7!l z+60{Oq4BKChU~G9d!Js?RBf(xb@oq(Y6E>f8VwW&Z*qjohA0$kYN8L=rJOzPImEkKDC$*O%aH1gzyMqkMjDyD(~Zxv9I$pcc`tFpbCPR z&7B%!-8aH{0S2U!x#Pdww4Ih}S6hZOUv$~l#4<^F!WORUzFKcwGCM&W4p`GZq_j11 zP5XILNR&xJUbTPDUqb4Ywp0s2!x&6TfgZ2*w;az*_7iO~H@Vt#SmKxyF(~T`<_`_n zVu0Q>`p4sB1#qrd69^-1tp1=jGuYeBh zbZ^*k_Z2YhupTg?k6FoqA-WM&(SCdgxmUA)^+h-nG5_bwHR;neIVX+aMKtlgeNUYdW$56CML0!;-dBK!~e=8_Am1k<$zOz--hAmJacY}VR;=A=MRF!dw+|R zc(?zAclAu)Ql}45^WDEyhDEE-QYZULG;;m@KyAWmt~EEKwWsn`T%$q~xSp7X;bo2?Z zhvY5=+o<)Zqe;4-=A*ji?uAByQwq)&6Uh|;a!tL>>I&A(K>A$B8*ir$Nw8;p zxQpc+wRN6ROha@s4k5!O^ix=?6Xh+lQLT|z#?{iM?4Q5ub7L;m8F)`RI=j!V!F+F_ zN?(lPppBo3T5Ef0@u?s!-I_E}0Oz8vP8PsP1h(w^Q?3uwcAvIqzfsXkw%}9-9{WmW z^E8vQA5LE=*2kLkGtAg0))?aPWwoC9D$jF)TMliK_{_ODgepK6N-80@9oa?f%aCnJ z2;!A?Ykl@>!gpPuV$*=~N@M$b*oS^WY0eCb7iAX3vlVy_&%$|F)a_NOb~p;J?sj>X zz0I-`Ld!}k7u9e#iqb58^V2<#28=WEB8bUh?d4B%gD>3%u>!OA)n^Yb<;}^mC^R*E zty88rVX&Kza+}~RQdHeZn-qCQD!H74%2(fM1x;_O=3XmmWBrv~U3=`U_KxPX;cgvu}yos|HZ{jyH>*Z`WYW_h`>6y3iJuKO&1@Y&L_*Yiu zZ)!`rc2%W*1^zjCZ}b^P!#n`bChS85ems200Xp{|N%WnS{LF!|J@K>hTn04Yrt*D$ zQycq?YM0GW8Ah1ENvfZHP-$JSq?3C$o~#fvEiEZEmgqaKf(y*|C?-Ib&BnV~Y3HRy z;X80#XrVUuFr3vr3)oWw7}NIa@d;UCY;tfuvtv)8MIBqtLw5cOn_xFcnk7yRJbKrJ z5(Ju4<@Pj_^kPinqqT|+&}xyOJAX?f)emJUIif#8-8aw)73+S)lY0<;`M{f-A&?t$ z7{zS|AmQf$5IzJcP~A{nm#%*rurZf@m?-!a4e_OrSm`7{it}@;%$Ru**wQJd1g(dHT z#lB=Jy+ieWiAYZ1z9qF&ji4Z**PHmQ<_$&a|I zuU1*kWHBP1F_FLs3Fe|+aMVg=^L;~8B&~3dIz6+XLG0SN+CeeccL1=7{9UzS-gFXh z4KaD{fP)LC$UNRW&|Kx#Fx1$r^3$^!tnYqxCF(34`DiWgl$8Jjm%(GOqZyOdIbOX# zWaLbF=fH8ueVJD;+UY&R(zcj6Xz#$RCrxN9k(XduuHA~`R99b#JF8b>!pTIK?5ms1 zLQHZv)CWi3&aOP)IBBx0R?x6<9h(Jn*KCeuAGU-5e1)xzHP5pbN-Fx0NKyyDO0=Ln zi7DiiQVY+`t}SFAs%JV3H};)IDLXrv?ykVIOY$>KpDGBKX=i>&&(}zRG-l3K#Q76s zLxP96DWnEN7{NGCWg^UY5Oz;Q*4V@l@I#E6Oak0ohGTd`lirARg&W zq9Vcr7_^z??9UH1k@dX$rh1=xFF~`Mvbh7xKNY1r_U>>?NJuZYY+jZFu+g=0Kpu2# zfyf*T7~}GtD}D#2LC@D&zRZ{Dl^pu+$of=ZXpu=ZY$M)x!uZq zEVeWam%5dw=g{_;l>i_FCm=z}u-*>NT>Z^W(c4Hdra9gU^*>y`8!Q7zU&GLw_mXvF^enq%n{b80+U4a z>8dZxC`)Dm+=W4)F8Z+`Zas~v*I9BAUCNHBukxMm9fiKZxhHLl0sR_vQvvDz8Zdh+ zo~E*1n7ELkZsRuU7l%eNAJn4l<7-QsqK&^Z{3mu*qePYHj(KD_{$iX%lLG#!u zM0#86D<;m$Z2c#uU43Kfq_ui9dj1>G19pigUWJ@s!AGpm0Xo_6k+jnw0ZE1`iISX0 z^5wZym4TW$DUm($KP_~3a{e6 zi-Vv9{EWsqs~rw$1YPER?8SM5;zafDU^Y1*JpH7cv55}SOHz6V~wx2 zsH>M>|LT!2aYsrOr54_HWOt_UOGb{3qVe zwWnYq3`o2e;tO$jHR0egcosuM$;$Cr+Cr*><4Q;|6*hrraY@X%g9-6zfwUx{pys)O zJ_^=d%r{4@NkE8^bzD>zmuTw~Ogpx(u}CC3*d1`mC<>cp#KJ#@mMT<8EzLYI z?UhV-v|ouUlg&qzq*mYSR0%}2qV9%0FKwF?d?OBQ=*!?&FjJmk|COsnT5G6}e)#OZ z;c616-gMQQAewoWAd(?<#=DFoX>hr&88O8jvDe8p0m^7=7YpyBU$`4Hv&x1u;WK%W zW{tvKFBwLY)>uA;hyzuv&8X{r<8ISCJu`k@mv7isp^Id9SR5c+g`A)aE(ga!Yg)cE zWyZo`f+~(XLGkrON2xBh{Hu0e8_7701Kdvflam#h7MC3UA&GG>RNV1^`>{qfbf~OO z&sEq1DeR+Mqd%iQ9@%?LUeB{ChZoPLy3aC?LXzyBwfr&YRJ(n|h?aeO$S zkDoDBP+!s(I@)N@E4$V+DA2hN*CV`aXH=V8SvvfGl7K3m-GG0e_TaO$Qbc6}{CBM)sVsP!p zY((C8In=VrmPX<@tX#%Q5R!J_@Mv_|*j49w4lFyfQg@h!2+ZvJB+Yf4xm)wv_`T@2 zLO}I&zwT?@nCL(dN#xTA)RoJI3>wN1fVsT>MRU|3EEw8oHomh|gr-q3@D z)E`AX<@JkgMyq$Na@aEfMHqF6M-~*I3xW@Yp6B0A6o+U3;4RKv$dY9|X@=z<-%8%y-yMl}Z{O|Bmx< zzHI#m!Hn6P+^4rX|8>WZ_1aSI?X}Zp&X12ZpM<8*TfF~4a6UdDv0-ca#;7j*(c7!E z&B^cX_`iGke&jz0`eT{jhS~n%CoD#k$KuVDJpph3wJQ$IlH;Yrw4#51eYysz{O{}i z@B8`xmEQ|vYG&%x#`NvmEX0;ze0%RCw6XJS_MY#j)qs1a8u?^{;WN31J}C@9OT)4d zB8owYZc=YvP{`A7!&qM6*H-8ZpFe^!@E-(k(v?;DU_|UjcOJz3Kf?< zcy$`~Ru42+z_^ISd8I0iO<36pP)#@RMNEO?yzx9jEixsyi}hG8fAa_anE6m){$Elr z)fp4J8kh7v2gC0+5Y683!Gx#*92sAKPQCV1mxn)KOZ1U2zv-LKftoI{%#$XytUc)( zxSL7mv_llGIvrvBbAfW_M-5@kg=gt>ntv29Ogt!TyeIGyk~GTp44vVX#oJ8k-Uk3L z=}?b0rl&{fM7q#QxntJ!E!`6f)EWf#-^`s@!UmdFmme{9z)`$?P!Vx4_P5GXWvzGB zB~8-Q^jMx*yxtDa;^-c&vQRNWB$`+tz1z=kcRzHGcJ(}4x;cJs>HIsh)l(SzTRaT{ zl1B+3;F01^M3N%r$mDGdy(ED}W)Q8PbY?@>L!% z+=?E1SC-E5)z9#BvN5tT_{!oXoiC5|_l%b7S=Jcd;gCVtmKYG=GoQf*>LA>QOGl2Y zfAB1Nk>@#GbAiguDHn%-!*QP8=H!L9-jvK&59X)gUWNiJvv^2Zjkalz6V6??IcZr6 z{Oe9{B#Nqic8EibJ(n#uG{?v76A!a_Drfx@_vPY*3arlxSJSj#uJbBg@>L>3Rg98` z<{F_aHe5ExsHxjv7TtnMRuD9!D509taqzteSp8narf=Z@Z;=ai!AtYPK1{+cfXi$# zAMejuEo~N=?>h75;%G69&s;`cazkLt$5+%BA!E8sO8U61RnX6BL=XY|zGj$Ho0<_* zx+NYz!@$-7;T@-e)H^g$24pej$cl2yEj(Js+e&ZC=gAJF@}E%bOf=~GP1J<3a54og zR!=vbi;aF|8u@538(@-c<+Ad@j!yZ3z5Xqqgp1#LHBheRFj2+uwZ^n$@Q7zq{^Ji7 zn*(Mr-JjV(3f$5HUT#D~9&Av@BbrK%6nUZA!jk>%qJwc0ai5D^?9o2cHyrFZd5ylJ z;1hY?org!Y-bMG1;*VtlLF$UOkyy^I{<$E7-=^|!W|LMwN!HFm3TMO;!c!KuuSR`0 zxK1ibGy(m!4kXMuT_U^bk(1KgpC%N?Ukds4?3=7rZ?0Zn^yFeEH9Z<^#98vg3lfuz zB))J2ZmyW4WwH?BjM1V=qQt{{Oib-RCm}z&P5TTE(c$NlO;%Qbbcg0&o>pb~BsVa& zBSq8fB3jh|uJ_(mWGUn>$n@9K%>Kc=ozr8zZPz_JmW8I3_zHwr--jSb;i2K!Y#pv_ z%^n~WszmOD9OyP-h>B|3(iEYzv{r{1k4g1}pN^y=%B%yPcRd!^ayb+6z!>IR-p_i_ z;s)B`p8=t(sZv`=Dp|?-i1R|q^h-#BH=C5(YEo8rXkNChlr1~B-c+{BQX|_*g!)T_ zpN06`>Hh+p{H9|^#}xG4Rp;tOwE^{o^`x;yWr zZ`~I{2o~Jkord5}aA~}88Vi~R8fY|V2*E7`cXtiY-8czu0fIv}5WtsZN3*IHvf^Y@@B%T~8mt)+Qukk=?bO~USF17I?d z$=ST7sS-E0IC;^|$^hO6dsS${JocwHHH2EmqbokKXa|jpq*(2ScFG9O-i(XO{%})e zb+#q?VWb(3l!aT1Yu$BLyGV>;4sx%b~{YkCUvt(Q2DRG1ukLQ2A z@J*hbkrC4Oy3n$`R8NnzN4fuaPsI;}>G812A6mwNGW8zT&9n?Tb_%`u-kdp@jW4b8 z&RPyT#*x`}q8v26RnBtbYXm8t_R>L?a)Asi?a7l%^viIHhQSldstgX62c@5;k>8&Q zEW;H+x}a~f`B6Uc$6C0+cwioklMhoRTZ%h-k9W8v-+}vrbFqSjOzeIDBj52?=kGJv zN#8YHeFW|IyT_ZzvM|-0>zddg-AcxiC3d~gC|*(~?Xz`G1lB(3nkHDks8&J?Rg!Dh z`AZ(mRi|QJx;oJ5qIF1(&>22;Rz1r99eZLt`+3QR4=CAP`W0kqr34g7_aG?QI%EV7 z$V=9G(j`flz3PUVww-k5?D!j4%!+V6o10cNN*cG~IWs7&!F~|e=~a-GBQHES8us;J zWl0iHJo`o5h3io7sj{FSWep;BZ$!wm7UV*QGCQDXy9(I+mZPfQHCo4sS={KAAx!(# zSCJdDwCSg7i)H{%F3QPYS%L8#I`LPF%Eht*1FFxZgn<+C#mOiGD)RT!43q3}I|KdS zBr*Xo`5z)XS~L6Vg#}8_^pY#-jC7Ezg>!HfEyz%@1O+)l)xO$Vwh3VqzfIIJXBiyt zVROai=U`|v`%WdIV%5G(=aW%Z6mpI?HOhZ7F*7}TY-Ra6I3HLC3@P>-f8~9d_nMKW zL%n?(u144CUBB3l>}VPU&lYz`8=6r`sU%gg8rESuH~tne86dFr2ey zeZ;Kj=}%XxAnmt$I)OemDGW&AeKll!W~sN_gHfgSCW+DXj2_juFrot{=7Eo`EwBqgYtmRYK(IzHv-uS(LDM@?zmgiX0lGB&%S)3wt5#D0jld8SlZ zzGp|AFuA9fA6u|MX%4JrO2wxM;GfrcsiWIyzDRZYPWG*N?K@+Shkj8E)kDBmpUdm& z>}A3=%#BJE@-zjUl+~(3s;+E`XP5X3-)#98>E=iVGd4QcJamm2JEyXs)?E{#cjInP zJ+srFRg5NXk+m6*9_NFBT7Hg8X=Np6X(HT!@iw?Fc1F376vtr%W{I7_OjHX~p9z zJX*Qbl=q|f`|{K^uYL?kdFBz*kP;nvY)+!Y7-AYG9w(b`coNCKDTmKV837` z&E?hPv&?M5t#c~R9s5zwl`RgJhsk`Q+5A)7VsTnfYqC!rEW0FiUnD z_|$i)7YG#4#Gu(#=POswJ+ENTqW)>SbS2fE{};w>SnGGU@w_YB&DUq1u)B|nVDmCc z&~Mav<-OTY+dKNz*FrP@B>cCngYK2Yn;AOfF0|{gf!DQ5yS2tG{BpTE&@g_O!mypO z{Hx<_&5vjlBpp7XrScM!7l`o*>l4x8)@#1zOEt0kIaMMY*I>P}_K#dUKzQUwV$lc^aI+7|)l{Kq#85$MxfJ`N{~!zW~t{c9|XG0k2l zBt9OsR*DY!+hlb6R`B?}sM}=`82gaA{-iAyTUhzl*VfC{&cL zpkL?S`U!kLw>ODTjo(_Gwduhy>jFBxzniX5 zl{SgxICg0w#~^%q6ye8yC16}E-YID!lV^+zg;pI4!Nn#mcX?7Txa5(d&rZKswDsvW z@AP#8-<_sE+giN{?4pu8X=$_N6g*X9hOmQHy*Bd|O&F42lblxO5R}SzwG7 zBChxyLF3+m2;UwB-eX8qKN2=03jTJeGz31UwLSE}`341DuCxrT6ZZQpNM=|80w5$6 ztvqTvpvpoB1gxaP!m6c(saVIdGt2)vt%=~IGk&ec-m;4GD8Lb}ZZfW1D)Spk^`3JN zf5M}e9+ZZv;WXziuz))nE?cGV5OWHWg7Z2=2DQ)UU~iwGHlShIn{66VEMt+eYI@A# z7XiuF31DrFjSUMK2`U&uW!DQtR8CD-hCS)LKNJQyepR_bEBG1+(xo%Rc&R z2smJo_f};` z)zeHaEzQR7Ii?h(UeJub;CB4t+{5`r=-_8R9Fddiw&!iG(UUWI%ApK)NdvR{rYr{< z)d7ZgQGK@3pL&^Po6H8C`tm&zQn@pAhyKD4z4$Iha(Ah|wh}m$0Z;FfI9nf6(0gtL*9*{+bCdH@kig9iLD&wh@$3$ZmrSFIrjmFE** z)hWidfybh-7-y$NM~U_T>gDV#RER=WWV(PX%D;wye=XG~Z7PRyXQlt9K6(rm6VO2| zC?eQ2SrnMT=ANU6UTfnWacpo}!i_!8)!Su!!^7LBtceJXXg(=pi|4aV^?yg!K(u^C zR1s0>N8TBIB(=UL?OS+&7>fw!y6)SHH)3IkA`SmKvVi|K>1a&j?NasUVTrDuZjJD@ z8m^U~3_@URCWBo|DLRf%Ipren4L8ixBvsUm2aA@Ok%m!t&9F0$uRyeq2g$@O+{6Kl zxRm88bkI5YHaX~}l|;cG9IX@8{ZY!$0F#52p3GGGyP?P_!?%T(bp$C+6CO_En-V6A z2LNOj$43$ETE7KOT0?CJAFeVm9fW?V1&UpD+`*g=c4N;1a(|5(`xfjb9xnXvZ#|$# z|5elG|GBuliMwjVrjGI{o|D3$Y5sfGVKlVZ%5qT=1H)TO9s{Guln`n09WwvqV~SPxpNgwXT3z@D})L)ZaZZ3(C%;u7&A<~a29Vq$QiOI}LQagG~J5eT!-s@2+1->!vl+Q-~ zJ32E152AxLt@5AX3g6y3wT>=C?HnCNWy7b~NvbbondoVQ$Z~G^9r6jOnn~N@h&l}u zQBi5dv-?18hYcI2@0v@|vKJEZ(GxT`&J9`9zV7`zcb$+o)ddY->koNPJ1rKOMMjY> z_X`ubzFgcgn@&YOjp0*4Rv*M}>Pk=49OUXUHFxlyZxQLyL`5gW>MnI-7b8neMbZY= zu2W7A-;UGL+kLB~cka5>860D_PWmlSIHSUo5bX*5a5AQ=>ALfI*ro^v0iv>Uwgg)c zNq5<2me&xmDzSM5mx?0J7|<)EFs`|iQymKaC8mjGn_9i@;I&cb*{!8F&}%U4-7T$a9-*{x^~nK;Q{ z=aM8L@=`FmS*@*fl}`JGmV0~u6jq)xk$;9=bb6o!jN@AwM1%OU{s~joOXtw|4R2-o z?0NGkvE%vf_CqMK)K*Fh#q5|SOLcV=CiB~Rc~r}F^D=d{+8E%vd2XMV&##-(LvhOZ zS!#W<`QsZp$L1g08m`iG@qpAH`};a_bJRF=%IPTM9seB;iEgNuzekxYez-#19-$91 z_S|@J(hFt%&Q$$FYt8$9v|eJHmCAUk{p1TX^n>xby|EiPti zT7n@JWq~~A(j0F$3j%AH=g7ZK%-(d}zWBAHmSr%sFzP+W5J9o+0f);iVsIm%TD-iY z2JB*aQD%hXew)aw_Oq|W2WH1-3r>Vlk4vfT3x}j^D{FxN>~fxUO#OyM}dpXdfeK zNz*mhuX5k6d9Y0<$@7&wGZKPH;Kz@vembKiNDgPH-{vey& z`WHsN;bondou^Ad4qEL z*AVl+2AEJo6QS9LPaCrhBR4}ne_$H_8YqH|O|<`ZvVTtfUoH6ap2Hp?yADO<1_HZt zLvYKORg_Pe&Nw2U^05cIzlhAMcz@*-1AIMo5n=<4ca7~A<0{`gytb1;@Ky;zC9heM z<5Z?FwxjiM`9JWaXop_z)?B+t0qt!*SCk!;gZ^5_nWr}`IF3n4 zb+a}&O7rn+udK&C*_$u5iw zQvpPHFl9Gn;O&GK#DmR>1G4NN!2HoFo$^KI=Nh74Xg5Mixze1c-@(>zYoE;q5RR?j zbOj3h@V}{hl@J=#XP5ZkqIos+c8b0WWB$sjQr#c5m8*>jeSyRc@JS{?kmYln)WLko zWN|k13UB1rriziVnBb>PvYyQw`OuAm;u{C~t9F})CvFm(e$h^v8m^zcZi6*QueJ2N zjgA=V3jMg#?$4&TmJM+KzVG7XXA1-tTTv?ST1MVd^u+H`!Wm9j5}7h^=DS~S z7N&Swb%phOWbitOofZ0|6sT6N3FUWb?bmlVrb@vIPX4aZ#McP7eT?vHO4M3>Ad2S0 zRb2Pkjs=@Jzh@(vqUU%K=}+dOb3jByCsC}j2C2G|KRm~dVmqgXH4_d$}}L-%2Y)&P^;sLub;u6e_L*d zlAU+4QFcq^%fPFfFnH|nS$xAaf-`DWc}bXcRD>=j^jY~{aE518xM6Zgt>dkV zV%p-1uT_Op-P1x4mgO7JrEIh46G)-MAQaiCnQkxfOBq?gqXjf+rDaIPVI|qZ!ECP> zlDeV)Q#{uh_V{RWSkeEp;3)tJJ(x4&ce5LV!ZYM{;tn~rfc_HYcWf*8?^q6)LxWsa zFV~35khuI75Rs6R-qCs&UV)HY%sql)(B`9;b(;JDZ+)%(EWws66lu1!H)++NNl?S z-r%W(I z868qS?81exgIdGdgE`+Wdg2hmXX{Lvgf>bQk@jQQ2s%&NGA#sMIv(w1X9Wcq01@ab z!Y0+V#%FtM9LCasN+_w5Ea2BuO|!hNgUL0~k+PJn3)mL7&C0p4oz5Ox?kODvLrnnqLkVB{~ZeYfU+C;TPo?YS7#vVt6<)~hkxh&=LULF_|}K=z~YJ6f84{0xtflms(h@)PTe|u;G4%r zL#nT!#r54HGZNNVmGid^NS@f}@j@OVisW;8Ws+2r4lqe1EB#p{GQH%HtS$j0c8|&&xqVgg2~oO&6W_Es!Tva#wRY~=Y0R;(CjgstixTj12y{&r| z*Voi~y-!&0 z-$CP}>5{W+6d6Vduv+G9HuT5MDm=IrX&;kUZn_XZ@@sVVj z#NU~*S;Qjg>0{t^-^Vdz+E6OY<>W8b5eT6`GYGDw;C}t-t&j<7#{JpqvqpuzA*1(B z>>+``)SW&eSw6kMv6S%$Bof46Nm4}}k_YeZaSK{#V>GMf1b=T+3dyO;e@`p%-B)g? zUFpn_QN)`TLZcN@T#ubj$ti1~es29i?G1+Hptb$(>5PKFgx{|#ux%b*`;XPc2|~_M z;5!6BW(zpMx!s;2WAfJMHHYu?gHnmF2ge7g`cZifm8Wo-%&uCOF~}qgc!xt=JmZ@K=vK;0_{b^a#CqxpLOi z`B4>!w$>}j%=yZhon}a@O3F?c@6kYY1}w%Wq55~QH@C9Cn7*j80op5#a*(FNy@vSN zmN8}by&(@wa28;%`pf!TT&B2d-jjrdwj&N*f#Igk)rP{oE~XVvm=Op#mYMoH)}+_c zIJV?2{ZZ1UlKRqI(B5RNXV!1doEpI-smqtMmG1g^QolcQDMBiuoSXzY`{!Y8#KqV= zQICh~yLoNiCcwHOT}jhMhd7tJor6UoH&MKzI+QxFiqUi$*rzsz{2#E%WNvz8I-t>q zny(rJ=3n;-+-30aRa)%SGzz<8to-;>K$4t9vRS5ccAS+7wMK6;bAjol`Lk&{bxz^$ zbu6cCUM4eI%AXzGJ2=dl_AUqno@{M>=D9C@aD*xw2L>=OJl*;F)9Bo7APy&o!_H6N zHaDSk$he6AIcK-e`TNb6e_>pVuiW(n-MZgpezeLWcpm1zv0FO>B$4*;XPI|TFJBFoT!KfC|`G33iXm;B$n$`jpAx9kc!tE?F>3>GujAVg;u z_1%Bob$#lT_29u{^=v`^e(M6ej8V|QSQzS?dhYf1-8DCY8P~5Hpn@;^riL+|0rKsL zomCKi2trONjIl3(UuAuoBLCqJ%?u#F6mK;SUWY9;%$(L3$4*LZDH~U47z(s&VuTvv zkNESsxFH_;f861|b3??-Up`PY4&YW z9~p&XT${cm#-rK6pgf|?{Zy@qp@}0!du@n#ZqF}f{FYul2>;VaR8YO$D+4BV(L}%c z$Z((dDV!+h@IH)0`|cFXDgHG|3Sx|>=R+=C3pRBa-a|YzpLWz`?3+h@X__>u_$D>w z^7%7GPwFWWFByKB)f@P%8SXFvMJK+S5;!K3$Y&h8^v0WD4S#k?;cAJ5J|>E(2rf-m zd)Q6`()8B%a zxGD>w+)Rbrln9>&#k&)TW?8FXO|1hmR|!IOO9pYMO26>Ro)s5+`{dSmgn_IA5C_>l z)YZNTt%Arp-JcZTFXLq+pte!|5COcm&0EErvDuY~(u4caU?gP<)y z4=vBY=wR^|U-KE!3RKU0lB0_VS-Y)HuC;a0lWS+6X@pnPIQuhrSj#zTT>F){G04LS zO|6N!nO`Qe3dKkiXs+kZYjv#YX!CfVtv6@XxC_q+Zp9{BndT4(4a3Txqou}-ba@57 zx&w`O1Gn`vh)LU_C7F9!TQ+YNB=f8QDzCgl%$3@ga2NO3Ix`Iz(lZC*L}pR56VvsZ zoIKnJ?NIhAaU8r#+sc>Lykx62Ezoc6tL%z!{tw4Yn#&xWnOz)GZ~<_8PZ~@k^xv$|x|3#{s_gRT=1&w5BI>GrxS0{$iV%++s`jbLqBIPNl{C ztnZGtw&~R`RD{^?0I}!$O0)P~8WI#wewEGQPqX!rzq34aT%UgXbefB&&Q@5Q z?0m<}F0*>-3(zSgOvTwCW7P~#I{SIHX&*%Tr||WWrTp(OSucc3_gL8NuQmo0&#PLlyrcOsujzAKse{2u zpAq`S^qy9`Bzq5&TXu;{g-;!-RKM0e<|dSFjK;N#ad2Uo;U_a6+VgofF5sty`Sv}} z_0cRA=eL0B9X{>Ffw;$7AGO-Z>Ms|iwovAu4{6F9sn_HM zBUhaC<}wWfI>cs#i*s=86uOhuhR!tv@_%A&#QQTG;SYZmR@Qsm7N{KzkITq&nl!sX2TR!+LtJa?msp4_+9$wpL1w-^ooQh1P`sD4aIAuGNeg;2o7To@T z8oUbD?qc|E5}!JVVe9^?f(=}?SicT6{kY3>H`l&-yCV3px6bxF!~HLeJdI!Qe^UNG zSQkExQt=oPzsF;SSFiD$A?g+{0a@$a1KCVAVHny3oN^sI=QY8p=BkmyMkf`!i58^8Lk6QH9p0 z8!tMh<|G^+fMMG*$Na&qAv0v_KrI!ut&ArT>5l?VSUev8Ot$Uv+K%Io;Njc z|FW45e9q+e0v7_W0D|WASun;pwllSAMFP@yF3%iHVcs(X^z|QuZ}5I>q7x%OY|ofG zD&&BSw={A~bncDpBQl>1LLdI9C@pp0E=<3fI}KsoY3{YI9kf|n|5Y`YC;+b{oI`C{Xynw1NF|Q zjtrHK$NpzGG0e$d6_uRME60tNyOp*C^EV3`#nGUIgrv#bwO)RS-@zA-&sjeK!72ir z9y}=-zWRPGX?9oCFiQh?rqDlqd%iJw68a@=K&c0!Z zZ=?EVVkr7`sLjYy%A`WzwttCfDIf~+j?P$uqx04rP{IquUk$wCg=i|;*aq`&T$#OA zwK~svAkHCNC$PJWmp6pajc3_Kq+1aYI{{zyEs$5G7>W)t z%@=F3UOLryvGm3}+Z zEv~n?aqai3z>WzIex?i|WSK-s2#)Lh)e5JJT+MoLSEmZG+%mil?&YQ*J6gC0&|at8 zh#iYB?>#U)NU3rpskX;cp&nTr{v3_wer_0@l~`j?tpf_!eoTz@=grxDD^xprSNf4^ z7Ci45>i7H)^X>EnVy6^8Q+pXE=cNac}EQ3Fb6A90mJs$6fNkxe5 za1qFtBj+CgAxIGXL`(Y9r1Uq6%&7BMTRM$Q8HZ4|p)O0Xlp$o!lsC;qO$dAn_+7n< zG*6=iUYG#lNLP$2$#7LZ6;~q-1U9&*7$@eEVXVtmY_FrPt(E-ZuX3lVpv#cTlh4oE z$R>Mk%0?zey{;iS)`}qAez+jCq-bv z>XJcZ1qF`)14(VhjhD%N1u20BY7XVm1A+K~YS1)${k~Z(UUSgH=0qoXC?Td6xF@* z%GG`s&4in^B1fNE{wVWp98Vx&#RE7EpN2bofBVL5!&%PtHFiUOg44NgbCd4ssTHhc zqy^m2Eef}IVcR50@0eo=nHM~B;*EofO&As=ey)Do2B}Pu6^jHw+;frLIc2Wk#n`(= zzlVjP1-h&30K6AbygCTV>H}918h%WOlby7HL^-Rb)sk{5WoIMd+s42`)tg0S;dOmv zmQJ0ilQ{Dt%Kv-K$s@Gml4K7rM`y;b`;uzC=WrLE!R1+6RPeM*S4w}3+^BH8mT!kr z>p;-1Z}y<(`#iz!-xIhh5Jq6!4o+hU6+dQQBl~t%hCYP?e^};Sg2mnNt9Q4D?Pb>= zwZqh^d#Wa?#)?2N&`jSN_h77K-N}k)36V0VSN78pzg=pM?G}a{0}P&2&E2U+W49#g zB>ojKD)&Jh0$0S|J?1eZO8Jta3TAj&PJa5rrC}6uCKputA*tqe>^$~ z6KDD(W_Hj!@uzob+kk}lpHcr*@@BSG@ju;-`G29$<4~mFmwT?Of+bi#d(HUZrWK@N41TXL6Oec;J!1t* zjaf18&ok7*@1w=RsSI&NyxEy7b?=s4x|3+O@_@Z?yK#{P+;DX8F0Xr!y5R}|R8O#^ zxw$`z3vF{Ge72!B1Uv}n1oV?D13WS>)iD~>sUWX1M%1l z-GJuE!qjp>m|Js(Lzk$ZXRD@xpKb+&uuh&VpwOX+ui8&2m8)o8##^GmrWTwe?EJl1(3 z-XOEBEhqzqjvj`p*wL;o{&DRWg&T|9RY~10#N*^F!-s}{1hs*`H?vu~AEgP$>IuWV zm1)E8XJxZA-k%1Uw8&QbvTjFP^ITR4n*WsXj0uva!%|&=oA<5?G3}^$@Kvoc32LU6 zoaI}lYjLEl>tSMXQ}R^@5M0%TC~aOPSj3dboQz}Xk3E}Veafau&#X+&i7W&f99pR} zLff8v=EY-)&t8aCdO#?p;Z(47^;?fGh^(&uGBDwcYRM5cCcD5^42P59;?s_f$_)YJ z`FMvc<^UnW3vIH#S=-}r4*9={J~T8+Y?)gCQ@o!QEB1}lKLPA6qLz;8RzExfi-~{wrqT%yvE5l(A2igMGjY5EP55ginwr@wk z9bIblQ}Yy?_?SJ{Sl|gOSeacvAFVgxBtri*%M@7{tDN4rf(QKhRb*1`Nvl@-M+Lug zw|>21?>`sTxg-=@$0ultMGe(sPx!R;_=qBJNg;-7UJ)0}m4r+$wLOvZM|$0hG9 zqG8aIihGNdW;#oe51`^qtHROaG^>yd^BY0NG<}%h6(oGe&Dib8nVpQ<|3<+gbs`GL zYzUgKD48t7R{|>1D+z@toCnO^NpAs`tStp$^OJo?>6KdqV(L4rE3+ZH=g0G9Q_Mgs zqn=#jVv;QXTd-05`pE9{!Ql0H22IzwiWS64I~2N@rRnkE&^k-d(gPR3rkMhcp+)qo z)CFp#sHm-5MI8F{(=U;#S8knDSslKjK1xdd?&EpWw>UAN62!f?hyhJF6ouM$!1kzHhFKo<^$+6N*COr)su4IAl(u( z?f_A~5UvebIvB6AlbEvJT{{@iIFaFaK9xNkN8#L&JT|=k{3w>p>E(oa!Ub9(rtMIp z!9$F@_J>#M?o9gNJ3h`n!!jfSZHSmWSC;ioYcH;C2qXHTfAJ#0cQF%_a*gVIt4vQ1 z%6}pVs1;!hJ=a1b1mzr#v3R{j(Q%`A{%SK0ApV}xh0w^8#w%!o*Mn%vCW$w_bM7t6 zrltX}+$XsaKLH%Ez6L)=v^Gk9uH{?sdfj_e#YdkLVr9r3!)|cp1Au-e*#W-x*^cQI znK98Xf%<+p#&eR||uW3T=RQ2JC}Ymrc91SHBQHaIWfLDkp^*cL+uKP@xd4dzDL^ z@2=G6zJCiQ9x}21uS|`-r9tAwh9P2PklFbH#?@ud8SxeI7v`R7+p(E{4d#UYmdTuF zOY+>ZjY47Nz;?nIYiai8)ARY~iec9!uemk;HPHF^x6CkTh~mBLs=;rUiq`-GVq5Kv z2kSM1d(7XcsJjB@zeOT{{x#R|Z%0)It0%o*qf0jPcPrY+pPYyY zBrovc$Oen!q$n}W{uZdqW+BbTbYXcRe%OuFQXJi%?fGBW75$fS75`xnhWWJBq8koQ zZ#ZNgzeW6IyKHp^!D_j>pU>yDLXYe|9E70frN8?|mt1rHR}(ddFMrg#Rlnf9*7^2_ z(AAo}vV5H9859|ZobZieZQ~#@$Pk%`!mbda;c(}>MSYO!v3pnh%DV1yz6-jz%XH*e zfc?$C%3yvB(Aob5nQeJb(OzC1nKnvpbyY8B#@JraU$l`*sw@I+uZUU zhi!h=sY=yox=jUBKF%C@8QFkuy0BxSpy`^0qlxlGM%ni{wJl#>MRifuJa9|jQPJbY zQL;WavT`hTcYj=c0>an{WT5lx_R5NEJCcE4eUI)0Zo7enOFQtbGudY*gjZqiEXc}n zAQ(K&i#JSW?N$D$EL)*!CU+WiHWJ-wbGWw75jlxytA78YQ!5g#q3Ra{aulmv2TDTM zBGPh8Jnw|Io!Zn@oCO-WC_lbznQo6-6Pz1ZQf>2rE*9uO>OVX6dI9ey?KmO<(2fiz ze-u{@J3`<(K`nZLXu=Vx)&_=tMvyURCYDsvJak}@C@35wot2dr4+A451p~vrpccFD zP0dn&DEIf_C7HEgwL*R$_EqP=)p7tJGW7yY+B5sCq9B%2O|gPIrEsB>_21BpI&@k- z36K0*jOpuNp0jE?LA9Kf$&mRF6@1`qF$kn2{g_0<(n2R_c7y4AxsZR2sngm@p2vH} zi690bC4c~`^{~1bSzgUpoQg3mQ{Ty?=~37bsPH3Zx?uMF@(F_Kw+|}FwYcNa7EQ!Y z#(HWA%44Tbr~r|ARh_OPvRV=6UyO_%3aDax^&u;!D2=slK<5)~2U+3;vpUMmC& zfRJukQoz-c9!b4J^OBZ1KIULYq?ea4;{+d~@*ni=ahvQA&CsP84#cFIvjl?|s zC@qVjMmRx9!HqP7FuCH2HxN|fkd@;x-qFAN;i4+i!b+Nh6>l-A(bMd zM6c#_I?zHp`B6)0DOIt)Xc0*}VIRLoX8SkrYaFOx{1RjwCC>N&Ht4$gXN*Q_$OR**6XVEcn@sCrxKi;jQ8t&{(P*q*m(MJ*UTEDgm}kS^xhuEci!Q1teHk0s9T{l`nS zXN{$$)*wdGUKTg{0Ak;yZSytu9yak7z763OG-}Kz73|bA$Q_&jqSw=;PtQ*gaZSkE zO?$LZ(txTA@nArnY#0_if8zQojdW7smyY;2Y{L&Uw(@~hx2BCoxeF97iCv+7u$4vJ zz+n8Pt(SS-8lcuaa%}n)N_6dtPbATTjx+LzY{270l$SVo8&lxFi4g8r0Q9@=hQ1lH zmRqdvwOYyX3AL0TLfIzI8!;k{$k&Lapytahht8*bdblg!OyuCVL}NXFVZ_t9sD3+g zZd$w`C#-vy2ag2PzV|(G>`WSSl}et?f1l4-0f;EZ{4~WUO+Fs*mYPOT4`KVAnk0(` zTFC-QsLy#I-LAqA>dC84vYai^Oq|0YICqP=AvOp0_$E8=T&|FwaImFexghLRZGZWM zAstMF%`O|`l6t_h3s%I!KQeKyKbP_ZL1JZsY-;A(DEeE#^}7jsspMPId;MRZCY2g_ zJM<*H0m#y63&JZ~QBo8jfd$(UOj%Q3-57%vaoyCl8nKgc`TiyU`1x<3WgBp4j6nu+ zOaB#!DubA$WLpnGzB!!L@vVW>aWdj4M%!2Q_RAa< zVs60f+tF#7ar!WIoo`-Xpss((ha*?@t;D2H9#gA{m!q|#g5yV;zf>Xj4rKm~2=JG^ zXrww}lc6Zjn9f8T$l!%i@_?JwK#z3_pkPW43(DHBB%&=uFXi;wu7loCnxb+=Y7i6K&+`IXTPe_zY$zWY%IAQP>_BnUXAzLW^341i)dg1Bc*n(h0 z>n=l)^xCEtx(%WLCOdS+l{hbx`zIcwWKLbq8|H^Sd0u%hWm?8&6^t0f7w9^_m#yaC zBaLYRZKMYVJEd|+Gw3@n;KT$3AhPMI{4THk!|8)OsQueM);ND;mhN-z2PeCWo#7R$JS=&hP_20v_QU^mN1{wNTQ4fV6ebXBjq09@ z4mbNxmihBD?)HyBTsfThj)9%lycf_RMZ!(#)dlu3PZMk3jSkDVvAJP4!bIq7Z}9=G z_AUW*hy>LHY!5sm&jpGz_fylqwk~_gnnH#RByJhEO(({~jC>bbEGg43E|m&BAAGr( zI(LefT6o+g)j*;48v9BzL&ESZ7H5P|YU#yR46Yw&lVRdX0}MVhB>gxwiz$?Oota4) zA#9ZQP!{W^0Bc!~b~d&CvE|_6S+Y|0nw=Wm65#OKF7K)V(bo)CRSY;e2;%WrX>+)s zhs&v#t09SB4eh&{Kv+BUXnys(xb@h`fKH5MJj#(i^-E?Pln3`R-@?#D^RA#hG-z{! z04mXAA)>RUD_mJ=%cbyNPrz|Q9%kHsGe z6WzWrD;Cy~nNxn*%VsHmdbGysG@n_zW%I1@`r3Kqg#65GMJ|KgYpicr{Xu)lrUBpX zW=>hE{~ZRb8A-KG-FTfALlF2E#(j?aALZ7|ieG>~ZA4UmE*^XrjU$$(>+jNC7Q=wG z3h7Op(~Fz^8|zN3zwrMaJ^Cl@|E~qXoQq!#*_3=-VZOXo*^*R6TD|Tq-l;mAPrB-d z$*E;jqow@{ABUe;zp;|;wc){u3FKYa?9Gwi9-7A~4*5%W?8O&_q2V!LFT2(EA^no2 zorWRVq-fP%`iGy58+)VNjy&KIXF*ry*^@Et=j=0Q_L;qB-ala7t2}GwS?gZc{kv9u$eX!c%_E}~iN{Ne6e2FNC2rQFjkTWC z@0C1jMsw^E2Sp+yQ~j4kr$f}$!9+D?|NqiO|FN})WjgBIie0zdk-#N*f4KN?O}2Ep ziD9NHQK&{R9MsCY9YAda7E+! zx|n;={7k!8PQ$1nG_#;9 z@i*`9;t@(LSqrbsR410r4{Lc+Wv5spp!D#KSsO#`1l3Me_=5Cywc&1nK8%qLD3V-; zZoVAI1*psNdlFcKWMm?=9tJVu(~3C`M>ut;=wlz5+0gn8DfXm!oPvAf0};@IiJxhV zaxm=#DAllMUY^8}R$=P&c};WVO#_PG)ztV2`$+G0uDa)Wl5d0NDM!S0v%d!QzVmFb zC4N^?e<`s`hi#I&1sZO!3goqzf50m#Qx0Zr?g$V=qQ}zfrjWTDAbI5uvZ7f-k|Wds zfKS*)r9^<@Zm~wFbj96GZ4ZUux;q~xCN{#JuN@=HY1xbwZqc1|ehXQfsY~f%r*NEk zU&><=+SHp{x^C#)A$PS7huQ|~4o7s1}D|wGtAK+LL9ZTHKp5vc;(&K?4 z`K8dHcMP$27qScr#BNwE%djTe*hH6M4XS4;XupnX3amWY@$%C2WA@W0b>zR8HzXj0 z^`0W(o&)J|ww&YFd%K2o3ogs6-K~pLIwK?~y6OSD0v4O>sXU`4O<6iE=7fpXMQPJM7DTPdr4|z9#Jd&P|Gs z#)`>|cfB*MTWOb*1j)|+ylyKF&ZzXCfYjpxR=#>9(y#~_dp`8FV0cKjSPpegR<^Q3 zbn_q5L#Gx4i^qCUFvSm*QuEf!JZ7BsZzPE)}Pq`Vj70GKZ4Pjs%S1 zqNKZ(d4j?_i^4xqT3f_w(f5<@!=xxZ% zucr@QPi#tSlEd9Y3^Mt3O~~1cY^;SJw_a>sbzn4eM7&W{0DNr&!6e8gaE3)ga*?VR z<_?4ES3pNAW!V6?ZIC6a<%lYyqwVORcK>HHt$xEdSkgS;_m-c4b0u@1%bpfI_<&>g zaVoPgMrKhlV7fMEl<$hVY}K0&ZDa+TLKNKOOIc+b#xL-gp6(~pnUJJ`v5y05RBS); zU$8VJ)yPKE%lfB9-!OujC_+<-z;G?oTe?{j1=7cWon0n_zbZl#E;(hv9X_9$4 z)5MGd?w5qOX--ssKu=RgkV~1bHti&k-%!3dKVI*6%W!puj!bRK!uDp={!7hEhSHPB z`lBF0;`8b175-oDc>;lT7uByC?p~;~G-*L+Ei;-D^X5TPXu%s+-_Cv+xF1PiNV_A# zZ6&8vhbjj%%HA_lG_wBQWB+I{g8!g_I&%@%gzX4hx~#FLAqiA+UT#f}(%e)Dh4okE z*V*mtmul;yN6zIhvrW#1zkQ#eW_TINuJL;Svq%k)P!<9t?BtBElyHdsB_dOd{guJ_ zcscnG*Rk8rfAqHW`Kb72=d1FM|BCZJY<==rLh?wv->nWB|0R;D5RYD8N^lq^iNDC%qk&`vN0)83mRa5< z>5RjrFXEiLVPCVSf|T;#x2sgiC=W8Erv)`zyXiNzvLsf8GCiwkvH?N{@)8fbq|>ow zbnKoL=lPY5?l8gUGq`PAt@;k1bpPB^ytt6W7ZBW4m~ASknXbsEg%4n{?O=+tOOMS6xr#Ohf>`qyz(1@8KmwBHwc#$6_Z z8sn(g^ef&|S2S$?M+VYiWD6?IQM3Q|L zfv(3_GX^!G(Eu>Gh`TUr`-g!PPYAJqALr+}v47h)e_S#tBlghpIcsDGe#Bj1ikcqeNgOhjD=1}O=HdwL_)bS<@ZI8=_Z zY&>$RQyM*4B|btj^G8^-n9#q*Edk11Lx~IQ;H5-sHKSbGUwIu1js&zxR z9m8QBR_|_^U0QgIlh*Upo8BMU_VLzyl$FK`T+aC-{eOw(l1DVzN8~~ zHhZ2dfzJKKFr1Up$%b8y_$!S)uYWg7;;<9DUlKhlW0r6Nls6-wfDGpQ+UBv$TPB;*Sn-X{7>k z3|jpb7depI`I%R8GyBL}le{5LkcpxbJ7KS?Db#F|Vz0h!iB3DAVGE!!I4hLs6)rxwcLs5Pa%f5~X_?X4UI`Bbgjt{@Pa zAV72*ym-L#IBlM;aArzlDSJVWlho>^e+t{3q_Trn^r3{i_CBsfG{LKxU5i{&;N$#4 z>3neG-1>ws0Blwe)?#vI|4SIgUi7TJW?hx#xJEwV={xFJ3uosRT@M(#sfN1xFhe(; zQp!&MgcT;crNq9SZ`?`o3aCi|>E8hFj_~Zn+geWp2XVM6dS<+9cK?kY%(%4^@I6;S z<|0-9X&K^@uB3G^t3=R+laRp>81xaD)}X|ZZ`)3^%60?ne+>*{%1!1 zKXP6jGTj5SkUmx=SGLo>?Z zz6dJ+K1*F+j>)YX?&I&ZPawe9O{?BbC5VK|Kb!p=@aCNtYd@;$JfW!Fbe z_qM$1@hU6^F(~z89o5v}n?Du!7%o4+LSejIqZ`UA_;w2{>j2#(#>exPIiOxGBpxuo z-_93e7j7_ifL(e|O8p9aSrh&XHkXA5yZ^dMQTNk^6&YSb zYiB#N+O?LUSjHimxEejUPZlRRH)XH2v3qmLD>E=n7F`VGt*u*M+I>2MlAh$Er;*9+-r*W7eqV-A*+X zOQiEgn#%-qlRIfsP5WBuKrvIfY-0CN9Xthb8>-YrY7^f*+O-&UM`uVW7l14on>L41 z4g~2;fKIp`Bsp3>3dsu}m>}~bU#ylqLd)fR&9l5GUET_f8!>2Cmn&a}!;+KQmJln@ z_9($nsWRe6iwdU|BvWkT@2CQA=&=73$8c41l_j8nHrBMyhb`;Mxv%oGeueAyAA|v~ z5#j8=zABie+nTL45J>VREVGyJV0@S62o8TQDA{!|u_S~4YxYWePajD%nqPh!MQm+d z*>npTeESepX1r7N0^9hp2Z^P?>>e#m@EnZMat3BGhp+DJ+j%wW$HRrmK@*^czWdY4 z0c-i0Ynq2L3RRdaN?t0SErBhcX6=x8E};VMthPr3Gi47;Z@J&FCLi&@jERYjn~3Vr zHN##^y*LxIRhtYJ-A3`O9lGd$2u6q0Pte7-@x8BU0GnlyZa@Jfw71J+s!!6!7l3R! zb_;{$i@%4NqyBs*7`}ZB<(H0bd|QUS0UCS_p!xyPU3||Kd*_;X6X!`ZWnyczb{dLN zyn8?>Jpfk==ZYoUF+KiEBu7-<_H`?~bci^3!~4cpNrTKodIH|p1z6ns1}_I`0?5;F374r(3ZTW^U3m3vZfBb z0{ESVSf*Xb*J5Obe0sYPzmlK-qBYF+#bkA3$!-;JP}d+9?ngR8e{I*KlzEinKTC8n z6YmNAn!y|`BqFuUJGn^9gs={r+s6u3o-eEVs$qbfkd_`5s^z>ae&6Dy+48m9hJEUQ z%n8neFd3jQ0ohK@#h1Tpq%?3VnnA&myHW;QY=l2JfGioz9Qeo6lGI63$@e*JwG#Jh zfaJH*B61Vg@1sZ&#kf4?Zk?Fc@oK3SN{=hWc@KYC97Fa#vItTMf;i?a=7KX{Avtw3 z5~-fFySGDbL9DDks;3ADgO>@1oV>gbdXJk+U3B~#z+<-1uZu7(3LA1YA@BsaSXP6x zgRH?GEIO^n{U4`s|6dDJ?9B;RyCV*164Q9pljHXR97U5XVJ5nDwuhM)8yYPVdr9KF z18Q@t5RiUcM~_)Fzau>iY= z2E)kj4eF0@OKO0Cxyj?b9OfO}RUd0=k2cKg11Qm!KrOOa{wpuD2YBImaxWxF8xhux-tn*FR4Bj_d^daWBc|~SCv3GQD1RNw2r*d z15|}iKFDT#kP;=6c?@Nw;E$R2e6tDZ?i>_Qjv?(9*G*7lT49HH-@E}+#=ioJ%SEC- zJgexUD5J(?_IfGWIviT&6wAiJ8Ra#-TG!1A%Gl@Xkx8-gpp?proRmzvk$E)x^n;(; zXBN*VNXKy*@N^zAh)d>Hx|Dw!w{mk*p|72u2@IChN7x;Pf^Gc1X@N)Y^p?+bC1twjY+5u2u!!?gl5jQ zLkQ@H1yom;+yb|V5OuH3d;nh+6hiQT))N+C640@@F8McSExpLciYJ}dmE$at`d#67 zRDzp85%?-Ten23aO9**NdnYRl1gHT#1ZjId0C`GQO#EnlZM=?O`X%RAX1@m}X1MCogr z92;BL#nw3!i>_L`-}yE1*l$Up+HBzKCx@_J3O5u1v9^uKJD}!&fgE#3_3YIoE}Cdb*}| z73wqk`S~X)GYm_RO76V_D&|_e%uNduDd|n%H`-~JXz4B>*(AP1{xtsJLU01k#p@^n zSUEwrJeu%3oK0rsq2CuLKKL;jIL-AqMY4WRgfwn26{k*%8LDGGk5KS_WEzj`+ey5< z-wy%X$Xf=Fu|$Fw%*FSo%=?ba~+Mq=|Ryx>tz0Oww$=Q*zJp&?AdIjBFW07!d|fcCU`@hpS1#%Z$k2sypG9 zK5P3pF^qdT%fPqeW)i*R?EGhOM{ivXB2EWhaJqn|Ccx|f5mu0gPUlCSW8%L=Ve5|# zx#xJT?I#(T9(TQ_)y<5__FMR}C;Xfnt4xvL8&Sd)0eD1Eg5W8REZ+ZO8ES-*HMXal zRBXuUbk*4|x2{xATC%v9OYd6xzU&s2+H|UDo(msGd`uX3R=NpUM^DM~g7aP&6};?FkD`7ca%Z^V-A2&xwz{(*t75 z1@+T|+jQWJWI%(@mq`_|lRjXibK`32swl{!sY!^NqRK78M&HDp-B-Yt=f%DUbz z(l;4@{er}TM~O-P^a?XV5*-tKi&Z(k+xn6*uIW#>-zR|%Mr@-cdNx<{SQDTZ2f)^R#DAMRGOJ7FAPtv!s6IIv!Sx z;;jeBXvd2;FX_HuWb(4q7AP;ThnM;);6NC5zSMSQvHG2H++=myAgakRI1Rc-QxYH>iS_f3zFUs(ssj!@CGzZd0=t#swiJzBRw?y8QRol1s0hbS5=AKOMW# zszy>8{O)}9Fk^)AWwQLc-y$9<19ah{x#E9`*x;%^&89h#LYMB(EU(4Zb&i}WKD{+L z8#}7`ZQYf!`o;96L;*G0KYC>&S&(2ljVeBg<^*k1eClO0x~7-W*#bO7aS*PC3G!*b znLK>H(uGSai~c2Ifb;&8m|7VUy18S!7W{J~{x4ByY5DI$or#vt@5jCO{t`tSnEX;t zDUFSOxjw@8l8hziS2U*qHQ+B%cdqXB9T~Y(0MVtTyxq0@`pct=N>w3~f1YXaPT`uv z&xUx;j+lQ<^j}}}zhdhGVpBe8Bt(Dk4>PEHV7r$9`#8uwif7k3t8G29hB6t7-0NW%yl;DSa#af3eUu@h zsLu^uWM~A6lJm+d;8POK=K1I%sMMHilx~>tog5W#W&Kg|pN&=9l}&AX@;>WzNCxc_ zx>$8{GE?^a@$)r5nvhh9^ii~q)#|~)$J_4qjO_stn+IaoX`zoJEK2h)c)XaY4z>_x zJVLx&{z8IGTRyJ`(M)tZCUnUjQyd1UwMifYMSeCUxNDEqp#Qf`Vo081-gGc`lPk=~-S}DP^i&ZztHNEr*uL{N)Y;^|8M&$P;N8u^K)@qk;9vx8 z_IJU0#D;4)0+2T_WlGZ$!gnn4s~nrxv-6@hZuXBV=Dp-`K<A7U~-9{kAum2qco1Zk+IY5y;c3x!>BfM_~dfeoztJK~;M~S8&2!hXaV%of#@I>zb~X zwb*SF1sL9nrmOZ62k;o(lnF={XnV%UN;9cH4cv?RbZ+X;NMdd3d6ziIOCNIY6OPJf zK2r%;7A~cI;x%Jopi)MPIw*5!g&HUoV`?}0sc^KKIlL(tH4q4p0}Zd+pQ6EXA%af1 z&N6RBGtqOQ1$=!hwN}$vcm`$reiT1BX1ERul<#f_oA^HNWdZ1WT4}54S`4M{&`4=% zo%^KYXr86f+U;2xOu$yWX9btCeKgYfAgBnjdk0=URK>O7Lv0E^Ki<~h3pgj5V}HiAxZ6&Wa>8h2r^!D7kAGj zcB1gxtRpgVX)-Tl?sl(;z*uokfWxiB;p5DimReUi=tPsg=d2uCOyidp4~8e=thB|g z+j5bMCNR7jWkGt;?QEL{iR#cZWe;eX{lncC*UUYA4W&YjD5hV$p)G25jw^q)py z!R|F`ZwKOa;aM~#7zIN*DRO2KnxM4NJT1o~huGRinXB0AtwmRxz(-+A>52yrZRfXU z2s!k#-aIoL{ah1X4HSSZY~<$`27x7e2aP`*IomEo&ks7}Ta`&yzW(9UvVg zR-t#xnKE8&vq1O^GwbwF*A2Q7Fq~zg!GB??$}-K8)_nFW^#@|TO`0R zl+BFiW%@gEfjS?Td2cuewkwHjMT)ARMI)O&Q+bse2zsK<>B9rru?BVcDqvk5`EFx- zyjy?wHaoc0?gG`&f=f>!zbZsqcYQ`^!OM~xh(p7||X3a0BnReHkHs&a) z>h9=M#Z1;p=f8dRHmJ>%oRE0k3w%U{HWaJy7Te5_#|nFbkp%l`{_6r;rs;dw8o*h8 zWlNjnPL`6g+q)OG0&A^Tc_{V#eS*LRuOAf@ukVdvHIv0a7m8IXPSgoJxu~})!XK~P zaUK->onM|gH@$`@?&|@6yzvP$Oj5p=l`+G-@hcMZwjp0~k175ltzlijAI!n+iL zfiU^a9yQn_OjIMq8{a_PMax4T$C(HpAH0GX?luGP5pvTH6Pnk zcN6H@suoUb?eUz&QfOfV`3USij^+@B9bDcxgQv#6&ZMHgaZ43vf=r7XYvNVyfxZ+y z`~@gqkLm-q*@6vH$X(PZ(@s(FEUY|WByN(W?m3&`Yhq;zrQmSqf`b~ZB!I|vVTI3d zBhawt=^6*`gu_8D{9H)NoV&5{)d1qSZGhT#=OJrvSoHIk7vVEbyGluwzaB1mN8L|| z8ZsAP;k#|5)7%`(3BOTp;>^EU2sJA|)b#B~#-^8llHj1PvbL4kK)rzAl-^@)`5Of*RFa#GknA=C{!3C$BB-SAp-h3o zr8(Y?2)?EPRvWy&u&*?2QQj+Bk#?5Z1Wr`o$hpr9qr#7}K+_-cEHI020<=$(WT(C^ z9+HTEY6-z7ewUnWrWWCBlA_Gbfahe;uLL8wtq&zN2Auh%u8zxLOu_5TFoXssmt-M z1Eix_+9DeNTWtnarUAtZ-oyTGlg=Is$i*9AEaVTu4pOT+@8B|HtxYRTbv=~wkb$z! zhX)Q+vgt9PxqNhSVEp~IHV8<>FkYIi8lg+_^XQ$vratc?5o+0olDNat+ zH=Oq7Ru4@SQOs8OP`qyf)%0dr2dj30ec5aDHjhn_s<-}&?~57qH2EtFU7F5(wQ;-R z7_F#6pf@*!7=e&eJF#0mqmapaF~>!#BjKjM+lkj21PJL))?XlPq3qKN1><*f_k z1cP&a0>B2fBYx`f4;PlS#`%Z`J7KDY7%+YfDIcU?Soft)BTbT4Py#P86s<)iQ8rc< zRBanA7E7~%?xt@xk0!O{Ttk;d{+6vhS|2E>mdO-?8WyH@a)f|HL#7(Z_4ObLHj&UX zDT4nMwukylZ<2Fmo?@4fvHUEOF~g;zmxa zAO|cfbFM>>8-3P8=65@-Pj>8U>BK{kK4|fuVdYOxL|?;lwJ!yA20Zl^WZvBgSfpe* z%_4TfI{@d=QD0I^6RS{6Z?8lEw}shJau^{!FYm?tA|K;lX0S7Poz4l>zeIeCs$5eM z^ZPkhB)=n)`#;qh^@)^UeAzO;O!LM4)N6jBR=h%;VY#c-xw0m(_KWNl_DbNoLzSzz z-e>>b37}Ht=$HA65?kOktv6??`#&`-0KWJ~JfVLNUYYXzp}9i^BgM<8oY+m4e{M+O z@bB@I{t>+LpZomhhQzb~8tnh5l@(yAiBVRWWmGa>v2w2h?z+ZztH46nZd3r`*6T7F zEvTQ?Xol)_Y${A4l%HC8$qo?Hk`d{4o9F+0UilKt!SI)eT#mX=hI`!7UdkYk|0Az^ z5~piira$|j`1_0ixVPIXh6?{AN|0G80vXnHF?P>aLJ|>K%jhQh^r}?`3!uwNjl`9=tZDeFR!Q$QMi?uM9pWs$afHBKw zg&y;bnTE#vQ~Ph_1tB0^ncX)+uS~S)xkLvL^obXil|s}?Iw1n}WQ0KwBvSwPpfCa| g+#s~*)n_Iq!dm?&#B~JD=zj-|-+%jIsQ#V*Ut$S*L;wH) literal 0 HcmV?d00001 diff --git a/protocol/next_kbd.c b/protocol/next_kbd.c new file mode 100644 index 00000000..a5a07a7a --- /dev/null +++ b/protocol/next_kbd.c @@ -0,0 +1,204 @@ +/* + +NeXT non-ADB Keyboard Protocol + +Copyright 2013, Benjamin Gould (bgould@github.com) + +Based on: +TMK firmware code Copyright 2011,2012 Jun WAKO +Arduino code by "Ladyada" Limor Fried (http://ladyada.net/, http://adafruit.com/), released under BSD license + +Timing reference thanks to http://m0115.web.fc2.com/ (dead link), http://cfile7.uf.tistory.com/image/14448E464F410BF22380BB +Pinouts thanks to http://www.68k.org/~degs/nextkeyboard.html +Keycodes from http://ftp.netbsd.org/pub/NetBSD/NetBSD-release-6/src/sys/arch/next68k/dev/ + +This software is licensed with a Modified BSD License. +All of this is supposed to be Free Software, Open Source, DFSG-free, +GPL-compatible, and OK to use in both free and proprietary applications. +Additions and corrections to this file are welcome. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + +* Neither the name of the copyright holders nor the names of + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. + +*/ + +#include +#include +#include +#include +#include "next_kbd.h" +#include "debug.h" + +static inline void out_lo(void); +static inline void out_hi(void); +static inline void query(void); +static inline void reset(void); +static inline uint32_t response(void); + +#define out_hi_delay(intervals) do { out_hi(); _delay_us(NEXT_KBD_TIMING * intervals); } while (0); +#define out_lo_delay(intervals) do { out_lo(); _delay_us(NEXT_KBD_TIMING * intervals); } while (0); +#define query_delay(intervals) do { query(); _delay_us(NEXT_KBD_TIMING * intervals); } while (0); +#define reset_delay(intervals) do { reset(); _delay_us(NEXT_KBD_TIMING * intervals); } while (0); + +void next_kbd_init(void) +{ + out_hi(); + NEXT_KBD_IN_DDR &= ~(1< +Arduino code by "Ladyada" Limor Fried (http://ladyada.net/, http://adafruit.com/), released under BSD license + +Timing reference thanks to http://m0115.web.fc2.com/ (dead link), http://cfile7.uf.tistory.com/image/14448E464F410BF22380BB +Pinouts thanks to http://www.68k.org/~degs/nextkeyboard.html +Keycodes from http://ftp.netbsd.org/pub/NetBSD/NetBSD-release-6/src/sys/arch/next68k/dev/ + +This software is licensed with a Modified BSD License. +All of this is supposed to be Free Software, Open Source, DFSG-free, +GPL-compatible, and OK to use in both free and proprietary applications. +Additions and corrections to this file are welcome. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + +* Neither the name of the copyright holders nor the names of + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. + +*/ + +#include + +#ifndef NEXT_KBD_H +#define NEXT_KBD_H + +#define NEXT_KBD_KMBUS_IDLE 0x300600 +#define NEXT_KBD_TIMING 50 + +extern uint8_t next_kbd_error; + +/* host role */ +void next_kbd_init(void); +void next_kbd_set_leds(bool left, bool right); +uint32_t next_kbd_recv(void); + +#endif From 3ee5f565ae98cc68b6dff24225b6f8f069f6e20d Mon Sep 17 00:00:00 2001 From: Thomas Russell Murphy Date: Sat, 4 Jan 2014 22:45:52 -0500 Subject: [PATCH 10/48] Spellchecking converter README files. --- converter/adb_usb/README.md | 4 ++-- converter/ascii_usb/README | 2 +- converter/m0110_usb/README.md | 10 +++++----- converter/pc98_usb/README | 4 ++-- converter/ps2_usb/README.md | 4 ++-- converter/sun_usb/README | 4 ++-- converter/usb_usb/README | 2 +- converter/x68k_usb/README | 4 ++-- 8 files changed, 17 insertions(+), 17 deletions(-) diff --git a/converter/adb_usb/README.md b/converter/adb_usb/README.md index 5301557d..d9efbfab 100644 --- a/converter/adb_usb/README.md +++ b/converter/adb_usb/README.md @@ -71,8 +71,8 @@ Notes Many ADB keyboards has no discrimination between right modifier and left one, you will always see left control even if you press right control key. Apple Extended Keyboard and Apple Extended Keyboard II are the examples. -Though ADB protocol itsef has the ability of distinction between right and left. -And most ADB keyboard has no NKRO functionality, though ADB protocol itsef has that. +Though ADB protocol itself has the ability of distinction between right and left. +And most ADB keyboard has no NKRO functionality, though ADB protocol itself has that. See protocol/adb.c for more info. EOF diff --git a/converter/ascii_usb/README b/converter/ascii_usb/README index b9c7ef25..02fa064e 100644 --- a/converter/ascii_usb/README +++ b/converter/ascii_usb/README @@ -6,7 +6,7 @@ Target MCU is ATMega32u4 but other USB capable AVR will also work. Hardware -------- -Connect RX, TX and GND to UART pin of AVR. Note that you may need line drvier/level shfiter like MAX232 to interface high voltage of RS-232C. +Connect RX, TX and GND to UART pin of AVR. Note that you may need line driver/level shifter like MAX232 to interface high voltage of RS-232C. diff --git a/converter/m0110_usb/README.md b/converter/m0110_usb/README.md index b3fb8f7e..1c344f1a 100644 --- a/converter/m0110_usb/README.md +++ b/converter/m0110_usb/README.md @@ -2,7 +2,7 @@ M0110/M0110A to USB keyboard converter ====================================== This firmware converts the protocol of Apple Macintosh keyboard **M0110**, **M0110A** and **M0120** into USB. Target of this project is USB AVR controller **ATmega32U4**. Using this converter you can revive these retro keyboards with modern computer. -Pics of **M0110 + M0120** and **M0110A**. +Pictures of **M0110 + M0120** and **M0110A**. ![M0110+M0120](http://i.imgur.com/dyvXb2Tm.jpg) ![M0110A](http://i.imgur.com/HuHOEoHm.jpg) @@ -31,7 +31,7 @@ Note that original cable used with Mac is **straight** while phone handset cable -Close-up pic of handset cable. You can see one end of plug has reverse color codes against the other. Click to enlarge. +Close-up picture of handset cable. You can see one end of plug has reverse color codes against the other. Click to enlarge. [![4P4C cable](http://i.imgur.com/3S9P1mYm.jpg?1)](http://i.imgur.com/3S9P1mY.jpg?1) [Teensy]: http://www.pjrc.com/teensy/ @@ -43,12 +43,12 @@ Close-up pic of handset cable. You can see one end of plug has reverse color cod ![Jack fig](http://www.kbdbabel.org/conn/kbd_connector_macplus.png) -### Pull-up Registor -You may need pull-up registors on signal lines(`CLOCK`, `DATA`) in particular when you have long or coiled cable. **1k-10k Ohm** will be OK for this purpose. In that case the converter may not read signal from keyboard correctly without pull-up resistors. +### Pull-up Resistor +You may need pull-up resistors on signal lines(`CLOCK`, `DATA`) in particular when you have long or coiled cable. **1k-10k Ohm** will be OK for this purpose. In that case the converter may not read signal from keyboard correctly without pull-up resistors. -Building Frimware +Building Firmware ----------------- To compile firmware you need AVR GCC. You can edit *Makefile* and *config.h* to change compile options and pin configuration. diff --git a/converter/pc98_usb/README b/converter/pc98_usb/README index 23f1b614..a010dee2 100644 --- a/converter/pc98_usb/README +++ b/converter/pc98_usb/README @@ -16,7 +16,7 @@ Connector (receptacle) -Wiring: You can change this with ediging config.h. +Wiring: You can change this with editing config.h. Pin mini DIN MCU ---------------------------------- @@ -34,7 +34,7 @@ Wiring: You can change this with ediging config.h. Protocol -------- -Singnal: Asynchronous, Positive logic, 19200baud, Least bit first +Signal: Asynchronous, Positive logic, 19200baud, Least bit first Frame format: 1-Start bit(Lo), 8-Data bits, Odd-Parity, 1-Stop bit This converter uses software method for testing purpose. AVR UART engine will work better. diff --git a/converter/ps2_usb/README.md b/converter/ps2_usb/README.md index 65e616ef..8f06fdd0 100644 --- a/converter/ps2_usb/README.md +++ b/converter/ps2_usb/README.md @@ -12,7 +12,7 @@ Following three methods are used to implement PS/2 signal handling. ### Interrupt driven(ps2_interrupt.c) Uses pin interrupt to detect falling edge of clock line. ### USART hardware module(ps2_usart.c) - Uses AVR USART engine to recevie PS/2 signal. + Uses AVR USART engine to receive PS/2 signal. To select method edit Makefile. @@ -31,7 +31,7 @@ In case of Teensy2.0(ATMega32U4): To change pin configuration edit config.h. -Build Frimware +Build Firmware -------------- Just run `make`: diff --git a/converter/sun_usb/README b/converter/sun_usb/README index 7b4f95ca..ee59fc75 100644 --- a/converter/sun_usb/README +++ b/converter/sun_usb/README @@ -34,11 +34,11 @@ Connector Protocol -------- -Singnal: Asynchronous, Negative logic, 1200baud, No Flow control +Signal: Asynchronous, Negative logic, 1200baud, No Flow control Frame format: 1-Start bit, 8-Data bits, No-Parity, 1-Stop bit AVR USART engine expects positive logic while Sun keyboard signal is negative. - To use AVR UART engine you need exteral inverter in front of RX and TX pin. + To use AVR UART engine you need external inverter in front of RX and TX pin. Otherwise you can software serial routine to communicate the keyboard. This converter uses software method, you doesn't need any inverter part. diff --git a/converter/usb_usb/README b/converter/usb_usb/README index 2ffa46ca..d0547cde 100644 --- a/converter/usb_usb/README +++ b/converter/usb_usb/README @@ -6,7 +6,7 @@ Hardware requirement Arduino Leonardo http://arduino.cc/en/Main/ArduinoBoardLeonardo -Circuit@Home USB Host Sheild 2.0 +Circuit@Home USB Host Shield 2.0 http://www.circuitsathome.com/products-page/arduino-shields/usb-host-shield-2-0-for-arduino diff --git a/converter/x68k_usb/README b/converter/x68k_usb/README index 5f1c2072..516fcd24 100644 --- a/converter/x68k_usb/README +++ b/converter/x68k_usb/README @@ -12,7 +12,7 @@ X68000 keyboard has ALPS linear switches. Hardware -------- Target MCU is ATMega32u4 but other USB capable AVR will also work. -You can use PJRC Teensy as dev board. +You can use PJRC Teensy as development board. http://www.pjrc.com/teensy/ Wiring: @@ -83,7 +83,7 @@ bit 6-0 following scan code Data from computer ------------------ -- LED contorol ON/OFF(0/1) +- LED control ON/OFF(0/1) bit 7 1(fixed) bit 6 全角 bit 5 ひらがな From a86c1e2b713e8adace45cd3c1cae397a908b261e Mon Sep 17 00:00:00 2001 From: Thomas Russell Murphy Date: Sat, 4 Jan 2014 22:52:19 -0500 Subject: [PATCH 11/48] Spellchecking keyboard README files. --- keyboard/IIgs/README | 4 ++-- keyboard/gh60/README.md | 2 +- keyboard/hhkb/README.md | 8 ++++---- keyboard/kmac/README.md | 2 +- keyboard/phantom/README.md | 2 +- 5 files changed, 9 insertions(+), 9 deletions(-) diff --git a/keyboard/IIgs/README b/keyboard/IIgs/README index 4f9cad1c..820d7711 100644 --- a/keyboard/IIgs/README +++ b/keyboard/IIgs/README @@ -1,4 +1,4 @@ -Replacable USB Controller for Apple IIgs/Standard(M0116) +Replaceable USB Controller for Apple IIgs/Standard(M0116) JeffreySung(nattyman@gmail.com) =============================== @@ -32,7 +32,7 @@ PJRC Teensy 1. Bypass #31 pin(from board) to E4(Teensy) 2. Bypass #30 pin(from board) to F2(Teensy) 3. Bypass #6 pin(from board) to A0(Teensy) -4. Refer doc directory +4. Refer to documentation directory To Do ===== diff --git a/keyboard/gh60/README.md b/keyboard/gh60/README.md index 5e0fc244..510cb5c8 100644 --- a/keyboard/gh60/README.md +++ b/keyboard/gh60/README.md @@ -80,7 +80,7 @@ See [keymap_plain.c](keymap_plain.c) for detail. ### 3. Hasu -This is my favourite keymap with HHKB Fn, Vi cursor and Mousekey layer. See [keymap_hasu.c](keymap_hasu.c) for detail. +This is my favorite keymap with HHKB Fn, Vi cursor and Mousekey layer. See [keymap_hasu.c](keymap_hasu.c) for detail. ### 4. SpaceFN diff --git a/keyboard/hhkb/README.md b/keyboard/hhkb/README.md index 92136482..7ea9843a 100644 --- a/keyboard/hhkb/README.md +++ b/keyboard/hhkb/README.md @@ -24,7 +24,7 @@ See README of [tmk_keyboard] for more. * No risks: Everything is all reversible * No need for PCB trace patching, case cutting or any other destructive mod * Can keep original controller intact -* Can change all HHKB behaviour as you like +* Can change all HHKB behavior as you like ###Cons * Void your warranty @@ -54,11 +54,11 @@ Several version of keymap are available in advance but you are recommended to de ### Program First, push reset button on board to start bootloader. -This command programs the controller with [dfu-programmer] if the tool is intalled and configured properly. +This command programs the controller with [dfu-programmer] if the tool is installed and configured properly. $ make dfu -Or you can also use [FLIP] command to program. Also the tool should be intalled and configured properly. FLIP GUI app is also available. +Or you can also use [FLIP] command to program. Also the tool should be installed and configured properly. FLIP GUI application is also available. $ make flip @@ -70,7 +70,7 @@ To define your own keymap create file named `keymap_.c` and see keymap doc ##Hardware -You have some options for hardware. Development boards with USB AVR family(ATMega32U4, AT90USB1286) like Teensy will work while MegaAVR with [V-USB] library is also cheapear option for DIY. +You have some options for hardware. Development boards with USB AVR family(ATMega32U4, AT90USB1286) like Teensy will work while MegaAVR with [V-USB] library is also cheaper option for DIY. ###1. TMK Alt Controller Board TMK designed [Keyboard Controller Board for HHKB Pro2(KiCad project)](https://github.com/tmk/HHKB_controller). diff --git a/keyboard/kmac/README.md b/keyboard/kmac/README.md index 8cfe0971..dc35870c 100644 --- a/keyboard/kmac/README.md +++ b/keyboard/kmac/README.md @@ -18,7 +18,7 @@ Move to this directory then just run `make` like: Use `Makefile.pjrc` if you want to use PJRC stack or use `Makefile.lufa` for LUFA stack. -Booloader +Bootloader --------- The PCB is hardwired to run the bootloader if the key at the `Caps Lock` position is held down when connecting the keyboard. diff --git a/keyboard/phantom/README.md b/keyboard/phantom/README.md index 8344e160..368ae97e 100644 --- a/keyboard/phantom/README.md +++ b/keyboard/phantom/README.md @@ -33,7 +33,7 @@ between 0 and 255: ### 2. Sleep LED It is possible to have the LEDs fade in and out when the computer is suspended. -To enable this feature, uncoment the `SLEEP_LED_ENABLE` line in the makefile you are using: +To enable this feature, uncomment the `SLEEP_LED_ENABLE` line in the makefile you are using: SLEEP_LED_ENABLE = yes # Breathing sleep LED during USB suspend From cb3a547ebff8e09401c7d635ed24585a7521bb19 Mon Sep 17 00:00:00 2001 From: tmk Date: Tue, 28 Jan 2014 10:55:51 +0900 Subject: [PATCH 12/48] Make modifiers 'weak' in macro --- common/action_macro.c | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/common/action_macro.c b/common/action_macro.c index cc7ac18a..d85aee37 100644 --- a/common/action_macro.c +++ b/common/action_macro.c @@ -16,6 +16,7 @@ along with this program. If not, see . */ #include #include "action.h" +#include "action_util.h" #include "action_macro.h" #ifdef DEBUG_ACTION @@ -39,12 +40,20 @@ void action_macro_play(const macro_t *macro_p) case KEY_DOWN: MACRO_READ(); dprintf("KEY_DOWN(%02X)\n", macro); - register_code(macro); + if (IS_MOD(macro)) { + add_weak_mods(MOD_BIT(macro)); + } else { + register_code(macro); + } break; case KEY_UP: MACRO_READ(); dprintf("KEY_UP(%02X)\n", macro); - unregister_code(macro); + if (IS_MOD(macro)) { + del_weak_mods(MOD_BIT(macro)); + } else { + unregister_code(macro); + } break; case WAIT: MACRO_READ(); From ebe951a445b5d774542731d6165a9c5cd56beb2b Mon Sep 17 00:00:00 2001 From: tmk Date: Sun, 9 Feb 2014 02:42:17 +0900 Subject: [PATCH 13/48] Add Initial files of 4704_usb --- converter/ibm4704_usb/Makefile | 93 +++++++++++++ converter/ibm4704_usb/README.md | 31 +++++ converter/ibm4704_usb/config.h | 73 +++++++++++ converter/ibm4704_usb/keymap_common.c | 30 +++++ converter/ibm4704_usb/keymap_common.h | 73 +++++++++++ converter/ibm4704_usb/keymap_plain.c | 28 ++++ converter/ibm4704_usb/led.c | 24 ++++ converter/ibm4704_usb/matrix.c | 179 ++++++++++++++++++++++++++ protocol/ibm4704.c | 150 +++++++++++++++++++++ protocol/ibm4704.h | 111 ++++++++++++++++ 10 files changed, 792 insertions(+) create mode 100644 converter/ibm4704_usb/Makefile create mode 100644 converter/ibm4704_usb/README.md create mode 100644 converter/ibm4704_usb/config.h create mode 100644 converter/ibm4704_usb/keymap_common.c create mode 100644 converter/ibm4704_usb/keymap_common.h create mode 100644 converter/ibm4704_usb/keymap_plain.c create mode 100644 converter/ibm4704_usb/led.c create mode 100644 converter/ibm4704_usb/matrix.c create mode 100644 protocol/ibm4704.c create mode 100644 protocol/ibm4704.h diff --git a/converter/ibm4704_usb/Makefile b/converter/ibm4704_usb/Makefile new file mode 100644 index 00000000..bc0f9fde --- /dev/null +++ b/converter/ibm4704_usb/Makefile @@ -0,0 +1,93 @@ +# Target file name (without extension). +TARGET = ibm4704_usb + +# Directory common source filess exist +TOP_DIR = ../.. + +# Directory keyboard dependent files exist +TARGET_DIR = . + +# project specific files +SRC = keymap_common.c \ + matrix.c \ + led.c \ + protocol/ibm4704.c + +ifdef KEYMAP + SRC := keymap_$(KEYMAP).c $(SRC) +else + SRC := keymap_plain.c $(SRC) +endif + +CONFIG_H = config.h + + +# MCU name +#MCU = at90usb1287 +MCU = atmega32u4 + +# Processor frequency. +# This will define a symbol, F_CPU, in all source code files equal to the +# processor frequency in Hz. You can then use this symbol in your source code to +# calculate timings. Do NOT tack on a 'UL' at the end, this will be done +# automatically to create a 32-bit value in your source code. +# +# This will be an integer division of F_USB below, as it is sourced by +# F_USB after it has run through any CPU prescalers. Note that this value +# does not *change* the processor frequency - it should merely be updated to +# reflect the processor speed set externally so that the code can use accurate +# software delays. +F_CPU = 16000000 + + +# +# LUFA specific +# +# Target architecture (see library "Board Types" documentation). +ARCH = AVR8 + +# Input clock frequency. +# This will define a symbol, F_USB, in all source code files equal to the +# input clock frequency (before any prescaling is performed) in Hz. This value may +# differ from F_CPU if prescaling is used on the latter, and is required as the +# raw input clock is fed directly to the PLL sections of the AVR for high speed +# clock generation for the USB and other AVR subsections. Do NOT tack on a 'UL' +# at the end, this will be done automatically to create a 32-bit value in your +# source code. +# +# If no clock division is performed on the input clock inside the AVR (via the +# CPU clock adjust registers or the clock division fuses), this will be equal to F_CPU. +F_USB = $(F_CPU) + +# Interrupt driven control endpoint task(+60) +OPT_DEFS += -DINTERRUPT_CONTROL_ENDPOINT + + +# Boot Section Size in *bytes* +# Teensy halfKay 512 +# Teensy++ halfKay 1024 +# Atmel DFU loader 4096 +# LUFA bootloader 4096 +# USBaspLoader 2048 +OPT_DEFS += -DBOOTLOADER_SIZE=4096 + + +# Build Options +# comment out to disable the options. +# +#BOOTMAGIC_ENABLE = yes # Virtual DIP switch configuration(+1000) +#MOUSEKEY_ENABLE = yes # Mouse keys(+4700) +##EXTRAKEY_ENABLE = yes # Audio control and System control(+450) +CONSOLE_ENABLE = yes # Console for debug(+400) +COMMAND_ENABLE = yes # Commands for debug and configuration +#NKRO_ENABLE = yes # USB Nkey Rollover - not yet supported in LUFA + + +# Search Path +VPATH += $(TARGET_DIR) +VPATH += $(TOP_DIR) + +include $(TOP_DIR)/protocol.mk +include $(TOP_DIR)/protocol/lufa.mk +include $(TOP_DIR)/common.mk +include $(TOP_DIR)/rules.mk diff --git a/converter/ibm4704_usb/README.md b/converter/ibm4704_usb/README.md new file mode 100644 index 00000000..1e29945d --- /dev/null +++ b/converter/ibm4704_usb/README.md @@ -0,0 +1,31 @@ +IBM 4704 to USB keyboard converter +=======----======================= +This firmware converts IBM 4704 keyboard protocol to USB HID. + + +Connect Wires +------------- +In case of Teensy2.0(ATMega32U4): + +1. Connect Vcc and GND. +2. Connect Clock and Data line. + - Clock is on PD1 and Data on PD2. +3. Optionally you need pull-up register. 1KOhm is OK? + +To change pin configuration edit config.h. + + +Build Firmware +-------------- +Just run `make`: + + $ make + +To select keymap: + + $ make KEYMAP=[plain|...] + + +Keymap +------ +Several version of keymap are available in advance but you are recommended to define your favorite layout yourself. To define your own keymap create file named `keymap_.c` and see keymap document(you can find in top README.md) and existent keymap files. diff --git a/converter/ibm4704_usb/config.h b/converter/ibm4704_usb/config.h new file mode 100644 index 00000000..8c2d08f6 --- /dev/null +++ b/converter/ibm4704_usb/config.h @@ -0,0 +1,73 @@ +/* +Copyright 2014 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#ifndef CONFIG_H +#define CONFIG_H + +#include + +#define VENDOR_ID 0xFEED +#define PRODUCT_ID 0x4707 +#define DEVICE_VER 0x0001 +#define MANUFACTURER t.m.k. +#define PRODUCT IBM 4704 keyboard converter +#define DESCRIPTION convert IBM 4704 keyboard to USB + + +/* matrix size */ +#define MATRIX_ROWS 16 // keycode bit3-6 +#define MATRIX_COLS 8 // keycode bit0-2 + + +/* key combination for command */ +#define IS_COMMAND() ( \ + keyboard_report->mods == (MOD_BIT(KC_LSHIFT) | MOD_BIT(KC_RSHIFT)) \ +) + + + +/* + * Busywait + */ +#define IBM4704_CLOCK_PORT PORTD +#define IBM4704_CLOCK_PIN PIND +#define IBM4704_CLOCK_DDR DDRD +#define IBM4704_CLOCK_BIT 1 +#define IBM4704_DATA_PORT PORTD +#define IBM4704_DATA_PIN PIND +#define IBM4704_DATA_DDR DDRD +#define IBM4704_DATA_BIT 2 + +/* + * Pin interrupt + */ +#ifdef IBM4704_USE_INT +#define IBM4704_INT_INIT() do { \ + EICRA |= ((1< + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ +#include "keymap_common.h" + + +/* translates key to keycode */ +uint8_t keymap_key_to_keycode(uint8_t layer, key_t key) +{ + return pgm_read_byte(&keymaps[(layer)][(key.row)][(key.col)]); +} + +/* translates Fn keycode to action */ +action_t keymap_fn_to_action(uint8_t keycode) +{ + return (action_t){ .code = pgm_read_word(&fn_actions[FN_INDEX(keycode)]) }; +} diff --git a/converter/ibm4704_usb/keymap_common.h b/converter/ibm4704_usb/keymap_common.h new file mode 100644 index 00000000..8955baeb --- /dev/null +++ b/converter/ibm4704_usb/keymap_common.h @@ -0,0 +1,73 @@ +/* +Copyright 2011,2012,2013 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ +#ifndef KEYMAP_COMMON_H +#define KEYMAP_COMMON_H + +#include +#include +#include +#include "keycode.h" +#include "action.h" +#include "action_macro.h" +#include "report.h" +#include "print.h" +#include "debug.h" +#include "keymap.h" + + +// 32*8(256) byte array which converts PS/2 code into USB code +extern const uint8_t keymaps[][MATRIX_ROWS][MATRIX_COLS]; +extern const uint16_t fn_actions[]; + + +/* Original keys */ +#define KEYMAP( \ + K00,K18,K19,K1A,K10,K11,K12,K08,K09,K0A,K0F,K1F,K0D,K0C,K0E, \ + K04,K05,K06,K13,K14,K15,K16,K17,K01,K02,K03,K1B,K1C,K1D, \ + K20,K21,K22,K23,K24,K25,K26,K27,K28,K29,K2A,K2B,K2C,K2D, \ + K30,K3E,K32,K33,K34,K35,K36,K37,K38,K39,K3A,K3B,K3D, \ + K31,K41,K3F, K40, K42,K2F \ +) { \ + { KC_##K00, KC_##K01, KC_##K02, KC_##K03, KC_##K04, KC_##K05, KC_##K06, KC_NO }, \ + { KC_##K08, KC_##K09, KC_##K0A, KC_NO, KC_##K0C, KC_##K0D, KC_##K0E, KC_##K0F }, \ + { KC_##K10, KC_##K11, KC_##K12, KC_##K13, KC_##K14, KC_##K15, KC_##K16, KC_##K17 }, \ + { KC_##K18, KC_##K19, KC_##K1A, KC_##K1B, KC_##K1C, KC_##K1D, KC_NO, KC_##K1F }, \ + { KC_##K20, KC_##K21, KC_##K22, KC_##K23, KC_##K24, KC_##K25, KC_##K26, KC_##K27 }, \ + { KC_##K28, KC_##K29, KC_##K2A, KC_##K2B, KC_##K2C, KC_##K2D, KC_NO, KC_##K2F }, \ + { KC_##K30, KC_##K31, KC_##K32, KC_##K33, KC_##K34, KC_##K35, KC_##K36, KC_##K37 }, \ + { KC_##K38, KC_##K39, KC_##K3A, KC_##K3B, KC_NO, KC_##K3D, KC_##K3E, KC_##K3F }, \ + { KC_##K40, KC_##K41, KC_##K42, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ + { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ + { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ + { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ + { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ + { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ + { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ + { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ +} + +#endif + +/* + { K48, K49, K4A, K4B, K4C, K4D, K4E, K4F }, \ + { K50, K51, K52, K53, K54, K55, K56, K57 }, \ + { K58, K59, K5A, K5B, K5C, K5D, K5E, K5F }, \ + { K60, K61, K62, K63, K64, K65, K66, K67 }, \ + { K68, K69, K6A, K6B, K6C, K6D, K6E, K6F }, \ + { K70, K71, K72, K73, K74, K75, K76, K77 }, \ + { K78, K79, K7A, K7B, K7C, K7D, K7E, K7F }, \ +*/ diff --git a/converter/ibm4704_usb/keymap_plain.c b/converter/ibm4704_usb/keymap_plain.c new file mode 100644 index 00000000..0ca4f14c --- /dev/null +++ b/converter/ibm4704_usb/keymap_plain.c @@ -0,0 +1,28 @@ +#include "keymap_common.h" + + +const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { + /* 0: default + * ,-----------------------------------------------------------. + * | `| 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|???|BS | + * |-----------------------------------------------------------| + * |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| \| + * |-----------------------------------------------------------| + * |Ctrl | A| S| D| F| G| H| J| K| L| ;| '|???|Ret | + * |-----------------------------------------------------------| + * |Shif|???| Z| X| C| V| B| N| M| ,| ,| /|???|Shift | + * |-----------------------------------------------------------| + * |Ctrl |Gui|Alt | Space |Alt |Gui|Ctrl | + * `-----------------------------------------------------------' + */ + KEYMAP( + ESC, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSLS,GRV, \ + TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSPC, \ + LCTL,A, S, D, F, G, H, J, K, L, SCLN,QUOT,NO, ENT, \ + LSFT,NO, Z, X, C, V, B, N, M, COMM,DOT, SLSH, RSFT, \ + LCTL,LGUI,LALT, SPC, RGUI,RCTL \ + ), +}; + +const uint16_t PROGMEM fn_actions[] = { +}; diff --git a/converter/ibm4704_usb/led.c b/converter/ibm4704_usb/led.c new file mode 100644 index 00000000..f76545f0 --- /dev/null +++ b/converter/ibm4704_usb/led.c @@ -0,0 +1,24 @@ +/* +Copyright 2011 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#include "stdint.h" +#include "led.h" + + +void led_set(uint8_t usb_led) +{ +} diff --git a/converter/ibm4704_usb/matrix.c b/converter/ibm4704_usb/matrix.c new file mode 100644 index 00000000..796e2d06 --- /dev/null +++ b/converter/ibm4704_usb/matrix.c @@ -0,0 +1,179 @@ +/* +Copyright 2014 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#include +#include +#include +#include +#include "action.h" +#include "print.h" +#include "debug.h" +#include "util.h" +#include "ibm4704.h" +#include "matrix.h" + + +static void matrix_make(uint8_t code); +static void matrix_break(uint8_t code); +static void matrix_clear(void); + + +/* + * Matrix Array usage: + * IBM 4704 scan codes are assigned into 128(16x8)-cell matrix. + * + * 8bit wide + * +---------+ + * 0| | + * :| XX | 00-7F + * f| | + * +---------+ + * + * Exceptions: + */ +static uint8_t matrix[MATRIX_ROWS]; + +// scan code bits 7654 3210 +// R:row/C:column -RRR RCCC +#define ROW(code) ((code>>3)&0x0f) +#define COL(code) (code&0x07) + + +inline +uint8_t matrix_rows(void) +{ + return MATRIX_ROWS; +} + +inline +uint8_t matrix_cols(void) +{ + return MATRIX_COLS; +} + +static void enable_break(void) +{ + uint8_t ret; + for (uint8_t code = 0; code < 0x80; code++) { + while (ibm4704_send(0x80|code) != 0) { + print("z"); + } + _delay_ms(1); + ret = ibm4704_recv(); + if (ret!=0xFF) { + xprintf("%0X: %0X ", code, ret); + } + } + _delay_us(100); + print("End\n"); + while (ibm4704_send(0xFF) != 0) { + print("Z"); + } // End +} + +void matrix_init(void) +{ + debug_enable = true; + + ibm4704_init(); + matrix_clear(); + + xprintf("------\n"); + enable_break(); + //while (ibm4704_send(0x8C) != 0) ; + //while (ibm4704_send(0xFF) != 0) ; +} + +/* + * IBM 4704 Scan Code + */ +uint8_t matrix_scan(void) +{ + uint8_t code = ibm4704_recv(); + if (code==0xFF) { + // Not receivd + return 0; + } else if ((code&0x78)==0x78) { + // 0xFF-F8 and 0x7F-78 is not scan code + dprintf("Error: %0X\n", code); + matrix_clear(); + return 0; + } else if (code&0x80) { + matrix_make(code); + } else { + matrix_break(code); + } + return 1; +} + +inline +bool matrix_has_ghost(void) +{ + return false; +} + +inline +bool matrix_is_on(uint8_t row, uint8_t col) +{ + return (matrix[row] & (1< +*/ +#include +#include +#include "debug.h" +#include "ibm4704.h" + + +#define WAIT(stat, us, err) do { \ + if (!wait_##stat(us)) { \ + ibm4704_error = err; \ + goto ERROR; \ + } \ +} while (0) + + +uint8_t ibm4704_error = 0; + + +void ibm4704_init(void) +{ + // POR + //_delay_ms(2500); + //while ( 0xA3 != ibm4704_recv() ) ; + + inhibit(); + DDRD |= 1<<3; + PORTD &= ~(1<<3); +} + +uint8_t ibm4704_send(uint8_t data) +{ + bool parity = true; // odd parity + ibm4704_error = 0; + + /* Request to send */ + idle(); + clock_lo(); +PIND |= 1<<3; + + /* wait for Start bit(Clock:lo/Data:hi) */ + WAIT(data_hi, 300, 0x30); + + /* Data bit */ + for (uint8_t i = 0; i < 8; i++) { + WAIT(clock_hi, 100, 0x31); + //_delay_us(5); +PIND |= 1<<3; + if (data&(1< 2) { + xprintf("x%02X ", ibm4704_error); + } + inhibit(); + _delay_us(200); // wait to recover clock to hi + return -1; +} diff --git a/protocol/ibm4704.h b/protocol/ibm4704.h new file mode 100644 index 00000000..ff8a5b77 --- /dev/null +++ b/protocol/ibm4704.h @@ -0,0 +1,111 @@ +/* +Copyright 2014 Jun WAKO +*/ +#ifndef IBM4704_H +#define IBM4704_H + +#define IBM4704_ERR_NONE 0 +#define IBM4704_ERR_STARTBIT 1 +#define IBM4704_ERR_PARITY 0x70 + + +void ibm4704_init(void); +uint8_t ibm4704_send(uint8_t data); +uint8_t ibm4704_recv_response(void); +uint8_t ibm4704_recv(void); + + +/* Check pin configuration */ +#if !(defined(IBM4704_CLOCK_PORT) && \ + defined(IBM4704_CLOCK_PIN) && \ + defined(IBM4704_CLOCK_DDR) && \ + defined(IBM4704_CLOCK_BIT)) +# error "ibm4704 clock pin configuration is required in config.h" +#endif + +#if !(defined(IBM4704_DATA_PORT) && \ + defined(IBM4704_DATA_PIN) && \ + defined(IBM4704_DATA_DDR) && \ + defined(IBM4704_DATA_BIT)) +# error "ibm4704 data pin configuration is required in config.h" +#endif + + +/*-------------------------------------------------------------------- + * static functions + *------------------------------------------------------------------*/ +static inline void clock_lo(void) +{ + IBM4704_CLOCK_PORT &= ~(1< Date: Sun, 9 Feb 2014 08:25:23 +0900 Subject: [PATCH 14/48] Tweak keyboard initialize --- converter/ibm4704_usb/matrix.c | 57 ++++++++++++++-------------------- 1 file changed, 24 insertions(+), 33 deletions(-) diff --git a/converter/ibm4704_usb/matrix.c b/converter/ibm4704_usb/matrix.c index 796e2d06..0bfda2b1 100644 --- a/converter/ibm4704_usb/matrix.c +++ b/converter/ibm4704_usb/matrix.c @@ -68,34 +68,43 @@ uint8_t matrix_cols(void) static void enable_break(void) { uint8_t ret; - for (uint8_t code = 0; code < 0x80; code++) { + print("Enable break: "); + // valid scancode: 00-77h + for (uint8_t code = 0; code < 0x78; code++) { while (ibm4704_send(0x80|code) != 0) { print("z"); + _delay_us(500); } - _delay_ms(1); - ret = ibm4704_recv(); - if (ret!=0xFF) { - xprintf("%0X: %0X ", code, ret); + _delay_us(2000); + ret = ibm4704_recv(); + if (ret != 0xff) { + xprintf("c%02X:r%02X ", code, ret); } + _delay_us(1000); } - _delay_us(100); + _delay_us(1000); + while (ibm4704_send(0xFF) != 0) { _delay_us(500); } // End print("End\n"); - while (ibm4704_send(0xFF) != 0) { - print("Z"); - } // End } void matrix_init(void) { + uint8_t ret; debug_enable = true; ibm4704_init(); matrix_clear(); - xprintf("------\n"); + // read keyboard id + while ((ret = ibm4704_recv()) == 0xFF) { + ibm4704_send(0xFE); + _delay_us(100); + } + + _delay_ms(2000); // wait for starting up debug console + print("IBM 4704 converter\n"); + xprintf("Keyboard ID: %02X\n", ret); enable_break(); - //while (ibm4704_send(0x8C) != 0) ; - //while (ibm4704_send(0xFF) != 0) ; } /* @@ -108,8 +117,8 @@ uint8_t matrix_scan(void) // Not receivd return 0; } else if ((code&0x78)==0x78) { - // 0xFF-F8 and 0x7F-78 is not scan code - dprintf("Error: %0X\n", code); + // 0xFF-F8 and 0x7F-78 is not scancode + xprintf("Error: %0X\n", code); matrix_clear(); return 0; } else if (code&0x80) { @@ -120,12 +129,6 @@ uint8_t matrix_scan(void) return 1; } -inline -bool matrix_has_ghost(void) -{ - return false; -} - inline bool matrix_is_on(uint8_t row, uint8_t col) { @@ -142,22 +145,10 @@ void matrix_print(void) { print("\nr/c 01234567\n"); for (uint8_t row = 0; row < matrix_rows(); row++) { - // TODO: use new function - phex(row); print(": "); - pbin_reverse(matrix_get_row(row)); - print("\n"); + xprintf("%02X: %08b\n", row, bitrev(matrix_get_row(row))); } } -uint8_t matrix_key_count(void) -{ - uint8_t count = 0; - for (uint8_t i = 0; i < MATRIX_ROWS; i++) { - count += bitpop(matrix[i]); - } - return count; -} - inline From 54a06c2520f6de4b33558b2203d6706a988d291c Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 10 Feb 2014 06:43:43 +0900 Subject: [PATCH 15/48] Change error no and clean debug code --- protocol/ibm4704.c | 41 +++++++++++++++++------------------------ protocol/ibm4704.h | 1 - 2 files changed, 17 insertions(+), 25 deletions(-) diff --git a/protocol/ibm4704.c b/protocol/ibm4704.c index 26441ed5..d3fbcc54 100644 --- a/protocol/ibm4704.c +++ b/protocol/ibm4704.c @@ -20,13 +20,7 @@ uint8_t ibm4704_error = 0; void ibm4704_init(void) { - // POR - //_delay_ms(2500); - //while ( 0xA3 != ibm4704_recv() ) ; - inhibit(); - DDRD |= 1<<3; - PORTD &= ~(1<<3); } uint8_t ibm4704_send(uint8_t data) @@ -37,44 +31,43 @@ uint8_t ibm4704_send(uint8_t data) /* Request to send */ idle(); clock_lo(); -PIND |= 1<<3; /* wait for Start bit(Clock:lo/Data:hi) */ WAIT(data_hi, 300, 0x30); /* Data bit */ for (uint8_t i = 0; i < 8; i++) { - WAIT(clock_hi, 100, 0x31); + WAIT(clock_hi, 100, 0x40+i); //_delay_us(5); -PIND |= 1<<3; if (data&(1<= 0x30) { + xprintf("x%02X ", ibm4704_error); + } _delay_us(200); // wait to recover clock to hi return -1; } @@ -110,10 +103,10 @@ uint8_t ibm4704_recv(void) _delay_us(5); // wait for line settles /* start bit */ - WAIT(clock_lo, 100, 1); // wait for keyboard to send - WAIT(data_hi, 100, 2); // can be delayed that long + WAIT(clock_lo, 100, 0x11); // wait for keyboard to send + WAIT(data_hi, 100, 0x12); // can be delayed that long - WAIT(clock_hi, 100, 3); // first rising edge which can take longer + WAIT(clock_hi, 100, 0x13); // first rising edge which can take longer /* data */ for (uint8_t i = 0; i < 8; i++) { WAIT(clock_hi, 100, 0x20+i); @@ -126,22 +119,22 @@ uint8_t ibm4704_recv(void) } /* parity */ - WAIT(clock_hi, 100, 7); + WAIT(clock_hi, 100, 0x17); if (data_in() != parity) { ibm4704_error = IBM4704_ERR_PARITY; goto ERROR; } - WAIT(clock_lo, 150, 8); + WAIT(clock_lo, 150, 0x18); /* stop bit */ - WAIT(clock_hi, 100, 9); - WAIT(data_lo, 1, 9); + WAIT(clock_hi, 100, 0x19); + WAIT(data_lo, 1, 0x19); inhibit(); _delay_us(200); // wait to recover clock to hi return data; ERROR: - if (ibm4704_error > 2) { + if (ibm4704_error > 0x12) { xprintf("x%02X ", ibm4704_error); } inhibit(); diff --git a/protocol/ibm4704.h b/protocol/ibm4704.h index ff8a5b77..618cce6b 100644 --- a/protocol/ibm4704.h +++ b/protocol/ibm4704.h @@ -5,7 +5,6 @@ Copyright 2014 Jun WAKO #define IBM4704_H #define IBM4704_ERR_NONE 0 -#define IBM4704_ERR_STARTBIT 1 #define IBM4704_ERR_PARITY 0x70 From 89c7b9b0974ccbcec8255ff2dc56adc7d3e82a71 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 10 Feb 2014 07:02:48 +0900 Subject: [PATCH 16/48] Add README.md --- converter/ibm4704_usb/README.md | 29 +++++++++++++++++++++-------- 1 file changed, 21 insertions(+), 8 deletions(-) diff --git a/converter/ibm4704_usb/README.md b/converter/ibm4704_usb/README.md index 1e29945d..f38cdd16 100644 --- a/converter/ibm4704_usb/README.md +++ b/converter/ibm4704_usb/README.md @@ -3,16 +3,29 @@ IBM 4704 to USB keyboard converter This firmware converts IBM 4704 keyboard protocol to USB HID. -Connect Wires -------------- -In case of Teensy2.0(ATMega32U4): +4704 Connector +-------------- + Keyboard Plug from front -1. Connect Vcc and GND. -2. Connect Clock and Data line. - - Clock is on PD1 and Data on PD2. -3. Optionally you need pull-up register. 1KOhm is OK? + DSUB-9 + ------------- + \ N 2 3 4 5 / + \ N N N N / + --------- + 2 GND + 3 VCC 5V + 4 DATA + 5 CLOCK + N No connection/No pin. -To change pin configuration edit config.h. + +Connection +---------- +In case of using ATMega32U4(Teensy2.0): + +1. Supply power with VCC and GND. +2. Connect CLOCK to PD1 and DATA to PD2. You can change pin with config.h. +3. Optionally you may need pull-up register. 1KOhm probably work. Build Firmware From 0f827cf94ccd6bef490ba889bc86c61483b1eb80 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 10 Feb 2014 10:01:42 +0900 Subject: [PATCH 17/48] Add keymap_hasu.c --- converter/ibm4704_usb/Makefile | 4 +- converter/ibm4704_usb/README.md | 2 +- converter/ibm4704_usb/keymap_common.h | 4 +- converter/ibm4704_usb/keymap_hasu.c | 85 +++++++++++++++++++++++++++ 4 files changed, 90 insertions(+), 5 deletions(-) create mode 100644 converter/ibm4704_usb/keymap_hasu.c diff --git a/converter/ibm4704_usb/Makefile b/converter/ibm4704_usb/Makefile index bc0f9fde..112b0012 100644 --- a/converter/ibm4704_usb/Makefile +++ b/converter/ibm4704_usb/Makefile @@ -76,8 +76,8 @@ OPT_DEFS += -DBOOTLOADER_SIZE=4096 # comment out to disable the options. # #BOOTMAGIC_ENABLE = yes # Virtual DIP switch configuration(+1000) -#MOUSEKEY_ENABLE = yes # Mouse keys(+4700) -##EXTRAKEY_ENABLE = yes # Audio control and System control(+450) +MOUSEKEY_ENABLE = yes # Mouse keys(+4700) +EXTRAKEY_ENABLE = yes # Audio control and System control(+450) CONSOLE_ENABLE = yes # Console for debug(+400) COMMAND_ENABLE = yes # Commands for debug and configuration #NKRO_ENABLE = yes # USB Nkey Rollover - not yet supported in LUFA diff --git a/converter/ibm4704_usb/README.md b/converter/ibm4704_usb/README.md index f38cdd16..852a4448 100644 --- a/converter/ibm4704_usb/README.md +++ b/converter/ibm4704_usb/README.md @@ -1,5 +1,5 @@ IBM 4704 to USB keyboard converter -=======----======================= +================================== This firmware converts IBM 4704 keyboard protocol to USB HID. diff --git a/converter/ibm4704_usb/keymap_common.h b/converter/ibm4704_usb/keymap_common.h index 8955baeb..c55a8172 100644 --- a/converter/ibm4704_usb/keymap_common.h +++ b/converter/ibm4704_usb/keymap_common.h @@ -39,7 +39,7 @@ extern const uint16_t fn_actions[]; K00,K18,K19,K1A,K10,K11,K12,K08,K09,K0A,K0F,K1F,K0D,K0C,K0E, \ K04,K05,K06,K13,K14,K15,K16,K17,K01,K02,K03,K1B,K1C,K1D, \ K20,K21,K22,K23,K24,K25,K26,K27,K28,K29,K2A,K2B,K2C,K2D, \ - K30,K3E,K32,K33,K34,K35,K36,K37,K38,K39,K3A,K3B,K3D, \ + K30,K3E,K32,K33,K34,K35,K36,K37,K38,K39,K3A,K3B,K3C,K3D, \ K31,K41,K3F, K40, K42,K2F \ ) { \ { KC_##K00, KC_##K01, KC_##K02, KC_##K03, KC_##K04, KC_##K05, KC_##K06, KC_NO }, \ @@ -49,7 +49,7 @@ extern const uint16_t fn_actions[]; { KC_##K20, KC_##K21, KC_##K22, KC_##K23, KC_##K24, KC_##K25, KC_##K26, KC_##K27 }, \ { KC_##K28, KC_##K29, KC_##K2A, KC_##K2B, KC_##K2C, KC_##K2D, KC_NO, KC_##K2F }, \ { KC_##K30, KC_##K31, KC_##K32, KC_##K33, KC_##K34, KC_##K35, KC_##K36, KC_##K37 }, \ - { KC_##K38, KC_##K39, KC_##K3A, KC_##K3B, KC_NO, KC_##K3D, KC_##K3E, KC_##K3F }, \ + { KC_##K38, KC_##K39, KC_##K3A, KC_##K3B, KC_##K3C, KC_##K3D, KC_##K3E, KC_##K3F }, \ { KC_##K40, KC_##K41, KC_##K42, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ { KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO }, \ diff --git a/converter/ibm4704_usb/keymap_hasu.c b/converter/ibm4704_usb/keymap_hasu.c new file mode 100644 index 00000000..7545b092 --- /dev/null +++ b/converter/ibm4704_usb/keymap_hasu.c @@ -0,0 +1,85 @@ +#include "keymap_common.h" + + +const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { + /* 0: default + * ,-----------------------------------------------------------. + * | `| 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|???|BS | + * |-----------------------------------------------------------| + * |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| \| + * |-----------------------------------------------------------| + * |Ctrl | A| S| D| F| G| H| J| K| L| ;| '|xxx|Ret | + * |-----------------------------------------------------------| + * |Shif|xxx| Z| X| C| V| B| N| M| ,| ,| /|xxx|Shift | + * |-----------------------------------------------------------| + * |Ctrl |Gui|Alt | Space |Alt |Gui|Ctrl | + * `-----------------------------------------------------------' + */ + KEYMAP( + ESC, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSLS,GRV, \ + TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSPC, \ + LCTL,A, S, D, F, G, H, J, K, L, FN1, QUOT,NO, ENT, \ + LSFT,NO, Z, X, C, V, B, N, M, COMM,DOT, FN2, NO, FN0, \ + LCTL,LGUI,LALT, FN3, RGUI,RCTL \ + ), + + KEYMAP( + ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, INS, DEL, \ + CAPS,NO, NO, NO, NO, NO, NO, NO, PSCR,SLCK,PAUS, UP, NO, BSPC, \ + LCTL,VOLD,VOLU,MUTE,NO, NO, PAST,PSLS,HOME,PGUP,LEFT,RGHT,NO, ENT, \ + LSFT,NO, NO, NO, NO, NO, NO, PPLS,PMNS,END, PGDN,DOWN,NO, TRNS, \ + LCTL,LGUI,LALT, SPC, RGUI,RCTL \ + ), + + KEYMAP( + ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, INS, DEL, \ + TAB, NO, NO, NO, NO, NO, WH_L,WH_D,WH_U,WH_R,WSTP,WBAK,WFWD,BSPC, \ + LCTL,NO, ACL0,ACL1,ACL2,NO, MS_L,MS_D,MS_U,MS_R,TRNS,NO, NO, ENT, \ + LSFT,NO, NO, NO, NO, NO, BTN3,BTN2,BTN1,BTN4,BTN5,NO, NO, RSFT,\ + LCTL,LGUI,LALT, BTN1, RGUI,RCTL \ + ), + + KEYMAP( + ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, INS, DEL, \ + TAB, HOME,PGDN,UP, PGUP,END, HOME,PGDN,PGUP,END, NO, NO, NO, BSPC, \ + LCTL,NO, LEFT,DOWN,RGHT,NO, LEFT,DOWN,UP, RGHT,NO, NO, NO, ENT, \ + LSFT,NO, NO, NO, NO, NO, NO, HOME,PGDN,PGUP,END, TRNS,NO, RSFT, \ + LCTL,LGUI,LALT, SPC, RGUI,RCTL \ + ), + + KEYMAP( + ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, INS, DEL, \ + TAB, NO, NO, NO, NO, NO, WH_L,WH_D,MS_U,WH_U,WH_R,BTN4,BTN5,FN4, \ + LCTL,VOLD,VOLU,MUTE,NO, NO, BTN2,MS_L,MS_D,MS_R,BTN1,NO, NO, ENT, \ + LSFT,NO, NO, NO, NO, NO, BTN3,BTN2,BTN1,BTN4,BTN5,NO, NO, NO, \ + LCTL,LGUI,LALT, TRNS, RGUI,RCTL \ + ), +}; + +enum macro_id { + ALT_TAB, +}; + +const uint16_t PROGMEM fn_actions[] = { + [0] = ACTION_LAYER_MOMENTARY(1), + [1] = ACTION_LAYER_TAP_KEY(2, KC_SCLN), + [2] = ACTION_LAYER_TAP_KEY(3, KC_SLASH), + [3] = ACTION_LAYER_TAP_KEY(4, KC_SPC), + [4] = ACTION_MACRO(ALT_TAB), +}; + +/* + * Macro definition + */ +const macro_t *action_get_macro(keyrecord_t *record, uint8_t id, uint8_t opt) +{ + keyevent_t event = record->event; + + switch (id) { + case ALT_TAB: + return (event.pressed ? + MACRO( D(LALT), D(TAB), END ) : + MACRO( U(TAB), END )); + } + return MACRO_NONE; +} From 902afcc509cf5d84b24f71297591cb7cb3d7493d Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 10 Feb 2014 11:05:18 +0900 Subject: [PATCH 18/48] Add doc 4704.txt and protocol comment --- converter/ibm4704_usb/4704.txt | 147 +++++++++++++++++++++++++++++++++ protocol/ibm4704.c | 38 +++++++-- 2 files changed, 179 insertions(+), 6 deletions(-) create mode 100644 converter/ibm4704_usb/4704.txt diff --git a/converter/ibm4704_usb/4704.txt b/converter/ibm4704_usb/4704.txt new file mode 100644 index 00000000..db584970 --- /dev/null +++ b/converter/ibm4704_usb/4704.txt @@ -0,0 +1,147 @@ +4704 Keyboard +============= +Keyboard Models: + Model 100 6019273 50-key (grid layout) + Model 200 6019284 62-key Alpha(60% layout) + Model 300 6019303 77-key Expanded Alpha + Model 400 6020218 107-key Full key + +Resourse +-------- +The IBM 4704: lots of pictures and info +http://kishy.dyndns.org/?p=648#more-648 + +Brochure: +http://ed-thelen.org/comp-hist/IBM-ProdAnn/4700.pdf + + + + +4704 Keyboard Protocol +====================== +On powering up the keyboard sends keyboard id; A3h for 6019284(62-key), for example. +After that firmware enters FC command mode and waits for parameter data from host +so that it doesn't send any scancode until you send 'FF'(End of FC command). + + +Keyboard to Host +---------------- +Data bits are LSB first and Pairty is odd. Clock has around 60us high and 30us low part. + + ____ __ __ __ __ __ __ __ __ __ ________ + Clock \____/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ + ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ + Data ____/ X____X____X____X____X____X____X____X____X____X________ + Start 0 1 2 3 4 5 6 7 P Stop + +Start bit: can be long as 300-350us. +Inhibit: Pull Data line down to inhibit keyboard to send. +Timing: Host reads bit while Clock is hi. +Stop bit: Keyboard pulls down Data line to lo after 9th clock. + + + +Host to Keyboard +---------------- +Data bits are LSB first and Pairty is odd. Clock has around 60us high and 30us low part. + + ____ __ __ __ __ __ __ __ __ __ ________ + Clock \______/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ + ^ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ___ + Data ____|__/ X____X____X____X____X____X____X____X____X____X \___ + | Start 0 1 2 3 4 5 6 7 P Stop + Request by host + +Start bit: can be long as 300-350us. +Request: Host pulls Clock line down to request to send a command. +Timing: After Request keyboard pull up Data and down Clock line to low for start bit. + After request host release Clock line once Data line becomes hi. + Host wirtes a bit while Clock is hi and Keyboard reads while low. +Stop bit: Host releases or pulls up Data line to hi after 9th clock and waits for keybaord pull down the line to lo. + + + +Scancodes +--------- +Keyboard doesn't send Break code for all keys except for Alt by default. + + 6019284 62-key: + ,-----------------------------------------------------------. + | `| 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|???|BS | + |-----------------------------------------------------------| + |Tab | Q| W| E| R| T| Y| U| I| O| P| ￠| \| PD2| + |-----------------------------------------------------------| + |Ctrl | A| S| D| F| G| H| J| K| L| ;| '| {}| PD3| + |-----------------------------------------------------------| + |Shif| <>| Z| X| C| V| B| N| M| ,| ,| /|???|Shift | + |-----------------------------------------------------------| + |Reset|blk|Alt | Space |Alt |blk|Enter| + `-----------------------------------------------------------' + +----------+---------------------+----------+----------+ + |` 00|PD1 04|Caps 20|LShift 30|Reset 31| + |1 18|q 05|a 21|<> 3E|Rblank 41| + |2 19|w 06|s 22|z 32|Alt 3F| + |3 1A|e 13|d 23|x 33|Space 40| + |4 10|r 14|f 24|c 34|Alt 3F| + |5 11|t 15|g 25|v 35|Lblank 42| + |6 12|y 16|h 26|b 36|Enter 2F| + |7 08|u 17|j 27|n 37| | + |8 09|i 01|k 28|m 38| | + |9 0A|o 02|l 29|, 39| | + |0 0F|p 03|; 2A|. 3A| | + |- 1F|￠ 1B|' 2B|/ 3B| | + |= 0D|\ 1C|{} 2C|??? 3C| | + |??? 0C|PD2 1D|PD3 2D|RShift 3D| | + |BS 0E| | | | | + +----------+---------------------+----------+----------+ + Bit7 is 'press flag' which set 1 on press and 0 on release when break code is enabled. + +NOTE: When break code is enabled the key sends scancode with setting 7th bit on press +and without it on release. That is, '`' sends 80h on press and 00h on release. + + +keyboard command +---------------- + FF Soft Reset(0008h) + FE Resend(00e8h) + FD Buzzer stop?(00edh) + FC Set Key flag(00f6h) + FB Soft Reset(0008h) + FA Reset(0000h) + + +Keyboard response +----------------- + FF Not exist. [Outgoing buffer cannot have FFh(00h in fact)] + FE Overflow(key event/receive data) at 00c5h, 0346h + FE Memory test error at 0224h + FD Command out of bound at 00d8h + Key out of bound + 7E Read/Parity error in receive from host at 00bch + + +Set Key flag command(FC) +------------------------ +After 'Power on Reset' firmware enters this command mode and waits for data from host, +so that you don't need to send 'FC' and it doesn't send any scancode until you send 'FF'. + +Data sent from host: + + bit: 7 6 ... 0 + en | | + | `-----`--- scan code + `------------- enable bit(0: enable repeat, 1: enable break) + + 00-77 Enable repeat(78-7F: invalid scancode) + 80-F7 Enable break(F8-FF: invalid scancode) + FE Resend(011ah) no need to use + FF End(0114h) exits FC command mode. + +Response from keyboard: + FD Out of bound - Invalid scancode + +Examples: + To enable break code of all keys. + + FC 80 81 ... F7 FF + diff --git a/protocol/ibm4704.c b/protocol/ibm4704.c index d3fbcc54..10e229fd 100644 --- a/protocol/ibm4704.c +++ b/protocol/ibm4704.c @@ -23,6 +23,25 @@ void ibm4704_init(void) inhibit(); } +/* +Host to Keyboard +---------------- +Data bits are LSB first and Parity is odd. Clock has around 60us high and 30us low part. + + ____ __ __ __ __ __ __ __ __ __ ________ +Clock \______/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ + ^ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ___ +Data ____|__/ X____X____X____X____X____X____X____X____X____X \___ + | Start 0 1 2 3 4 5 6 7 P Stop + Request by host + +Start bit: can be long as 300-350us. +Request: Host pulls Clock line down to request to send a command. +Timing: After Request keyboard pull up Data and down Clock line to low for start bit. + After request host release Clock line once Data line becomes hi. + Host writes a bit while Clock is hi and Keyboard reads while low. +Stop bit: Host releases or pulls up Data line to hi after 9th clock and waits for keyboard pull down the line to lo. +*/ uint8_t ibm4704_send(uint8_t data) { bool parity = true; // odd parity @@ -85,13 +104,20 @@ uint8_t ibm4704_recv_response(void) } /* -Keyboard to Host: -Clock ~~~~___~~_~~_~~_~~_~~_~~_~~_~~_~~_~~~~~~~~ H:60us/L:30us +Keyboard to Host +---------------- +Data bits are LSB first and Parity is odd. Clock has around 60us high and 30us low part. -Data ____~~X==X==X==X==X==X==X==X==X==X________ - | 0 1 2 3 4 5 6 7 P(odd) - | LSB MSB - Start bit(80us) + ____ __ __ __ __ __ __ __ __ __ ________ +Clock \____/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ + ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ +Data ____/ X____X____X____X____X____X____X____X____X____X________ + Start 0 1 2 3 4 5 6 7 P Stop + +Start bit: can be long as 300-350us. +Inhibit: Pull Data line down to inhibit keyboard to send. +Timing: Host reads bit while Clock is hi. +Stop bit: Keyboard pulls down Data line to lo after 9th clock. */ uint8_t ibm4704_recv(void) { From 47d812bfd67c9162cd0a491717cebb191b538ba3 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 10 Feb 2014 23:49:57 +0900 Subject: [PATCH 19/48] Add connector pinouts --- converter/ibm4704_usb/4704.txt | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/converter/ibm4704_usb/4704.txt b/converter/ibm4704_usb/4704.txt index db584970..c17d172a 100644 --- a/converter/ibm4704_usb/4704.txt +++ b/converter/ibm4704_usb/4704.txt @@ -16,7 +16,6 @@ http://ed-thelen.org/comp-hist/IBM-ProdAnn/4700.pdf - 4704 Keyboard Protocol ====================== On powering up the keyboard sends keyboard id; A3h for 6019284(62-key), for example. @@ -24,6 +23,22 @@ After that firmware enters FC command mode and waits for parameter data from hos so that it doesn't send any scancode until you send 'FF'(End of FC command). +Connector +--------- + Keyboard Plug from front + + DSUB-9 + ------------- + \ N 2 3 4 5 / + \ N N N N / + --------- + 2 GND + 3 VCC 5V + 4 DATA + 5 CLOCK + N No connection/No pin. + + Keyboard to Host ---------------- Data bits are LSB first and Pairty is odd. Clock has around 60us high and 30us low part. @@ -40,7 +55,6 @@ Timing: Host reads bit while Clock is hi. Stop bit: Keyboard pulls down Data line to lo after 9th clock. - Host to Keyboard ---------------- Data bits are LSB first and Pairty is odd. Clock has around 60us high and 30us low part. @@ -60,7 +74,6 @@ Timing: After Request keyboard pull up Data and down Clock line to low for s Stop bit: Host releases or pulls up Data line to hi after 9th clock and waits for keybaord pull down the line to lo. - Scancodes --------- Keyboard doesn't send Break code for all keys except for Alt by default. From 4ab0ebb199601c37b5fd542d8425247b626bac6d Mon Sep 17 00:00:00 2001 From: tmk Date: Tue, 11 Feb 2014 00:37:19 +0900 Subject: [PATCH 20/48] Change pin configuration --- converter/ibm4704_usb/README.md | 6 ++++-- converter/ibm4704_usb/config.h | 2 +- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/converter/ibm4704_usb/README.md b/converter/ibm4704_usb/README.md index 852a4448..6541dd6d 100644 --- a/converter/ibm4704_usb/README.md +++ b/converter/ibm4704_usb/README.md @@ -2,10 +2,12 @@ IBM 4704 to USB keyboard converter ================================== This firmware converts IBM 4704 keyboard protocol to USB HID. +Keyboard initialization process takes a few seconds at start up. During that you will hear buzzer from the keyboard. **You need to plug USB cable after hooking up your keyboard to the converter.** + 4704 Connector -------------- - Keyboard Plug from front +Keyboard Plug from front: DSUB-9 ------------- @@ -24,7 +26,7 @@ Connection In case of using ATMega32U4(Teensy2.0): 1. Supply power with VCC and GND. -2. Connect CLOCK to PD1 and DATA to PD2. You can change pin with config.h. +2. Connect CLOCK to PD1 and DATA to PD0. You can change pin with config.h. 3. Optionally you may need pull-up register. 1KOhm probably work. diff --git a/converter/ibm4704_usb/config.h b/converter/ibm4704_usb/config.h index 8c2d08f6..befed0d5 100644 --- a/converter/ibm4704_usb/config.h +++ b/converter/ibm4704_usb/config.h @@ -50,7 +50,7 @@ along with this program. If not, see . #define IBM4704_DATA_PORT PORTD #define IBM4704_DATA_PIN PIND #define IBM4704_DATA_DDR DDRD -#define IBM4704_DATA_BIT 2 +#define IBM4704_DATA_BIT 0 /* * Pin interrupt From 776ccd3e675c2aaaf6e5711a58ef2aed5a94a550 Mon Sep 17 00:00:00 2001 From: tmk Date: Tue, 11 Feb 2014 01:40:55 +0900 Subject: [PATCH 21/48] Change keymap_plain.c --- converter/ibm4704_usb/keymap_plain.c | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/converter/ibm4704_usb/keymap_plain.c b/converter/ibm4704_usb/keymap_plain.c index 0ca4f14c..a121634e 100644 --- a/converter/ibm4704_usb/keymap_plain.c +++ b/converter/ibm4704_usb/keymap_plain.c @@ -8,21 +8,31 @@ const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { * |-----------------------------------------------------------| * |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| \| * |-----------------------------------------------------------| - * |Ctrl | A| S| D| F| G| H| J| K| L| ;| '|???|Ret | + * |Ctrl | A| S| D| F| G| H| J| K| L| ;| '| #|Ret | * |-----------------------------------------------------------| - * |Shif|???| Z| X| C| V| B| N| M| ,| ,| /|???|Shift | + * |Shif| \| Z| X| C| V| B| N| M| ,| ,| /|???|Shift | * |-----------------------------------------------------------| - * |Ctrl |Gui|Alt | Space |Alt |Gui|Ctrl | + * |Ctrl |Gui|Alt | Space |Alt* |Gui|Ctrl | * `-----------------------------------------------------------' */ KEYMAP( - ESC, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSLS,GRV, \ - TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSPC, \ - LCTL,A, S, D, F, G, H, J, K, L, SCLN,QUOT,NO, ENT, \ - LSFT,NO, Z, X, C, V, B, N, M, COMM,DOT, SLSH, RSFT, \ + GRV, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSLS,BSPC, \ + TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSLS, \ + LCTL,A, S, D, F, G, H, J, K, L, SCLN,QUOT,NUHS,ENT, \ + LSFT,NUBS,Z, X, C, V, B, N, M, COMM,DOT, SLSH,NO, FN0, \ + LCTL,LGUI,LALT, SPC, RGUI,RCTL \ + ), + + /* 1: HHKB */ + KEYMAP( + ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, INS, DEL, \ + CAPS,NO, NO, NO, NO, NO, NO, NO, PSCR,SLCK,PAUS, UP, NO, INS, \ + LCTL,VOLD,VOLU,MUTE,NO, NO, PAST,PSLS,HOME,PGUP,LEFT,RGHT,NO, ENT, \ + LSFT,NO, NO, NO, NO, NO, NO, PPLS,PMNS,END, PGDN,DOWN,NO, TRNS, \ LCTL,LGUI,LALT, SPC, RGUI,RCTL \ ), }; const uint16_t PROGMEM fn_actions[] = { + [0] = ACTION_LAYER_MOMENTARY(1), }; From 294aa396da1111838050d6476ec25f0023885d40 Mon Sep 17 00:00:00 2001 From: tmk Date: Thu, 13 Feb 2014 09:33:34 +0900 Subject: [PATCH 22/48] Rename a file --- converter/ibm4704_usb/{4704.txt => ibm4704.txt} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename converter/ibm4704_usb/{4704.txt => ibm4704.txt} (100%) diff --git a/converter/ibm4704_usb/4704.txt b/converter/ibm4704_usb/ibm4704.txt similarity index 100% rename from converter/ibm4704_usb/4704.txt rename to converter/ibm4704_usb/ibm4704.txt From 428b23646129aeee5eda20f34d22846fc54a86d4 Mon Sep 17 00:00:00 2001 From: tmk Date: Thu, 13 Feb 2014 09:45:02 +0900 Subject: [PATCH 23/48] Add converter/ibm4704_usb --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index b76b7fb9..a561b38e 100644 --- a/README.md +++ b/README.md @@ -41,6 +41,7 @@ You can find some keyboard specific projects under `converter` and `keyboard` di * [pc98_usb](converter/pc98_usb/) - [PC98] to USB * [usb_usb](converter/usb_usb/) - USB to USB(experimental) * [ascii_usb](converter/ascii_usb/) - ASCII(Serial console terminal) to USB +* [ibm4704_usb](converter/ibm4704_usb) - [IBM 4704 keyboard Converter][GH_ibm4704] ### keyboard * [hhkb](keyboard/hhkb/) - [Happy Hacking Keyboard pro][GH_hhkb] **my main board** @@ -62,6 +63,7 @@ You can find some keyboard specific projects under `converter` and `keyboard` di [GH_terminal]: http://geekhack.org/showwiki.php?title=Island:27272 [GH_x68k]: http://geekhack.org/showwiki.php?title=Island:29060 [GH_hbkb]: http://geekhack.org/showwiki.php?title=Island:29483 +[GH_ibm4704]: http://geekhack.org/index.php?topic=54706.0 [HID_liber]: http://deskthority.net/wiki/HID_Liberation_Device_-_DIY_Instructions [Phantom]: http://geekhack.org/index.php?topic=26742 [GH60]: http://geekhack.org/index.php?topic=34959 From 01f02e8457d01266c6ac2a015953f0796ca335c4 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 17 Feb 2014 16:41:40 +0900 Subject: [PATCH 24/48] Change IS_COMMAND macro --- converter/ibm4704_usb/config.h | 1 + 1 file changed, 1 insertion(+) diff --git a/converter/ibm4704_usb/config.h b/converter/ibm4704_usb/config.h index befed0d5..4f82f49a 100644 --- a/converter/ibm4704_usb/config.h +++ b/converter/ibm4704_usb/config.h @@ -35,6 +35,7 @@ along with this program. If not, see . /* key combination for command */ #define IS_COMMAND() ( \ + keyboard_report->mods == (MOD_BIT(KC_LCTRL) | MOD_BIT(KC_RCTRL)) || \ keyboard_report->mods == (MOD_BIT(KC_LSHIFT) | MOD_BIT(KC_RSHIFT)) \ ) From 48d27378f4b1c6c26e42c1abc5f6af5229582c22 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 17 Feb 2014 16:42:43 +0900 Subject: [PATCH 25/48] Fix README.md and ibm4704.txt --- converter/ibm4704_usb/README.md | 19 ++++++++- converter/ibm4704_usb/ibm4704.txt | 71 ++++++++++++++++++++----------- 2 files changed, 63 insertions(+), 27 deletions(-) diff --git a/converter/ibm4704_usb/README.md b/converter/ibm4704_usb/README.md index 6541dd6d..ce9e34eb 100644 --- a/converter/ibm4704_usb/README.md +++ b/converter/ibm4704_usb/README.md @@ -5,8 +5,23 @@ This firmware converts IBM 4704 keyboard protocol to USB HID. Keyboard initialization process takes a few seconds at start up. During that you will hear buzzer from the keyboard. **You need to plug USB cable after hooking up your keyboard to the converter.** -4704 Connector --------------- +Keyboard models +--------------- +IBM capacitive switch models: + 6019273 Model 100 50-key (grid layout) http://kishy.dyndns.org/?p=977 + 6019284 Model 200 62-key Alpha(60% layout) http://kishy.dyndns.org/?p=894 + 6019303 Model 300 77-key Expanded Alpha http://kbtalking.cool3c.com/article/23272 + 6020218 Model 400 107-key Full key http://kishy.dyndns.org/?p=980 + +Alps switch(vintage Green) models: + 5954339 Japanese 102-key http://deskthority.net/post87127.html#p87127 + 6112883 Japanese 102-key http://geekhack.org/index.php?topic=52888.msg1194489#msg1194489 + 6112884 Japanese 102-key http://geekhack.org/index.php?topic=50437.msg1193047#msg1193047 + 6341739 Chinese 102-key http://geekhack.org/index.php?topic=52888.msg1176566#msg1176566 + + +Connector +--------- Keyboard Plug from front: DSUB-9 diff --git a/converter/ibm4704_usb/ibm4704.txt b/converter/ibm4704_usb/ibm4704.txt index c17d172a..877d8fdb 100644 --- a/converter/ibm4704_usb/ibm4704.txt +++ b/converter/ibm4704_usb/ibm4704.txt @@ -1,10 +1,16 @@ -4704 Keyboard -============= -Keyboard Models: - Model 100 6019273 50-key (grid layout) - Model 200 6019284 62-key Alpha(60% layout) - Model 300 6019303 77-key Expanded Alpha - Model 400 6020218 107-key Full key +IBM 4704 Keyboard +================= +IBM capacitive switch models: + 6019273 Model 100 50-key (grid layout) http://kishy.dyndns.org/?p=977 + 6019284 Model 200 62-key Alpha(60% layout) http://kishy.dyndns.org/?p=894 + 6019303 Model 300 77-key Expanded Alpha http://kbtalking.cool3c.com/article/23272 + 6020218 Model 400 107-key Full key http://kishy.dyndns.org/?p=980 + +Alps switch(vintage Green) models: + 5954339 Japanese 102-key http://deskthority.net/post87127.html#p87127 + 6112883 Japanese 102-key http://geekhack.org/index.php?topic=52888.msg1194489#msg1194489 + 6112884 Japanese 102-key http://geekhack.org/index.php?topic=50437.msg1193047#msg1193047 + 6341739 Chinese 102-key http://geekhack.org/index.php?topic=52888.msg1176566#msg1176566 Resourse -------- @@ -16,11 +22,19 @@ http://ed-thelen.org/comp-hist/IBM-ProdAnn/4700.pdf -4704 Keyboard Protocol -====================== -On powering up the keyboard sends keyboard id; A3h for 6019284(62-key), for example. -After that firmware enters FC command mode and waits for parameter data from host -so that it doesn't send any scancode until you send 'FF'(End of FC command). +IBM 4704 Keyboard Protocol +========================== +On powering up keyboard sends keyboard ID; A3h for 6019284(62-key), for example. +After that the keyboard enters FC command mode and waits for parameter data from host +so that it doesn't send any scancode until you send 'FF'(End of FC command mode). + + Keyboard ID + ------------------------------- + Model 100 50-key A2h + Model 200 62-key A3h + Model 300 77-key A4h + Model 400 107-key ?? + Japanese/Chinese 102-key A6h Connector @@ -113,27 +127,34 @@ NOTE: When break code is enabled the key sends scancode with setting 7th bit on and without it on release. That is, '`' sends 80h on press and 00h on release. -keyboard command +Keyboard command ---------------- - FF Soft Reset(0008h) - FE Resend(00e8h) - FD Buzzer stop?(00edh) - FC Set Key flag(00f6h) - FB Soft Reset(0008h) - FA Reset(0000h) +Keyboard accepts these commands from host. + + Description Entry point + ----------------------------------------------------------- + FF Soft Reset 0008h + FE Resend 00e8h + FD Buzzer(emits a short beep) 00edh + FC Set Key Flag 00f6h + FB Soft Reset 0008h + FA Reset 0000h Keyboard response ----------------- - FF Not exist. [Outgoing buffer cannot have FFh(00h in fact)] - FE Overflow(key event/receive data) at 00c5h, 0346h - FE Memory test error at 0224h - FD Command out of bound at 00d8h +Keyobard sends these bytes to host. + + Description Entry point + ----------------------------------------------------------- + FE Overflow(key event/receive data) 00c5h, 0346h + Memory test error 0224h + FD Command out of bound 00d8h Key out of bound - 7E Read/Parity error in receive from host at 00bch + 7E Read/Parity error in receive from host 00bch -Set Key flag command(FC) +Set Key Flag command(FC) ------------------------ After 'Power on Reset' firmware enters this command mode and waits for data from host, so that you don't need to send 'FC' and it doesn't send any scancode until you send 'FF'. From 7474e14d068210242b9cb59b21afce25f66e2a6e Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 17 Feb 2014 16:57:02 +0900 Subject: [PATCH 26/48] Fix markdown syntax --- converter/ibm4704_usb/README.md | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/converter/ibm4704_usb/README.md b/converter/ibm4704_usb/README.md index ce9e34eb..a3af4ab3 100644 --- a/converter/ibm4704_usb/README.md +++ b/converter/ibm4704_usb/README.md @@ -5,19 +5,20 @@ This firmware converts IBM 4704 keyboard protocol to USB HID. Keyboard initialization process takes a few seconds at start up. During that you will hear buzzer from the keyboard. **You need to plug USB cable after hooking up your keyboard to the converter.** -Keyboard models ---------------- -IBM capacitive switch models: - 6019273 Model 100 50-key (grid layout) http://kishy.dyndns.org/?p=977 - 6019284 Model 200 62-key Alpha(60% layout) http://kishy.dyndns.org/?p=894 - 6019303 Model 300 77-key Expanded Alpha http://kbtalking.cool3c.com/article/23272 - 6020218 Model 400 107-key Full key http://kishy.dyndns.org/?p=980 +Supported Keyboard +------------------ +### IBM capacitive switch models: +- 6019273 Model 100 50-key (grid layout) http://kishy.dyndns.org/?p=977 +- 6019284 Model 200 62-key Alpha(60% layout) http://kishy.dyndns.org/?p=894 +- 6019303 Model 300 77-key Expanded Alpha http://kbtalking.cool3c.com/article/23272 +- 6020218 Model 400 107-key Full key http://kishy.dyndns.org/?p=980 -Alps switch(vintage Green) models: - 5954339 Japanese 102-key http://deskthority.net/post87127.html#p87127 - 6112883 Japanese 102-key http://geekhack.org/index.php?topic=52888.msg1194489#msg1194489 - 6112884 Japanese 102-key http://geekhack.org/index.php?topic=50437.msg1193047#msg1193047 - 6341739 Chinese 102-key http://geekhack.org/index.php?topic=52888.msg1176566#msg1176566 +### Alps switch(vintage Green) models: + +- 5954339 Japanese 102-key http://deskthority.net/post87127.html#p87127 +- 6112883 Japanese 102-key http://geekhack.org/index.php?topic=52888.msg1194489#msg1194489 +- 6112884 Japanese 102-key http://geekhack.org/index.php?topic=50437.msg1193047#msg1193047 +- 6341739 Chinese 102-key http://geekhack.org/index.php?topic=52888.msg1176566#msg1176566 Connector From 5ca3bde10aa5d8057895475840800544599ea33f Mon Sep 17 00:00:00 2001 From: Ralf Schmitt Date: Tue, 18 Mar 2014 20:06:24 +0100 Subject: [PATCH 27/48] Support for Lightsaber keyboard --- keyboard/lightsaber/Makefile.lufa | 125 ++++++++++++ keyboard/lightsaber/Makefile.pjrc | 101 ++++++++++ keyboard/lightsaber/README.md | 110 +++++++++++ keyboard/lightsaber/config.h | 43 ++++ keyboard/lightsaber/keymap.c | 77 ++++++++ keyboard/lightsaber/keymap_winkey.h | 12 ++ keyboard/lightsaber/led.c | 24 +++ keyboard/lightsaber/matrix.c | 292 ++++++++++++++++++++++++++++ 8 files changed, 784 insertions(+) create mode 100644 keyboard/lightsaber/Makefile.lufa create mode 100644 keyboard/lightsaber/Makefile.pjrc create mode 100644 keyboard/lightsaber/README.md create mode 100644 keyboard/lightsaber/config.h create mode 100644 keyboard/lightsaber/keymap.c create mode 100644 keyboard/lightsaber/keymap_winkey.h create mode 100644 keyboard/lightsaber/led.c create mode 100644 keyboard/lightsaber/matrix.c diff --git a/keyboard/lightsaber/Makefile.lufa b/keyboard/lightsaber/Makefile.lufa new file mode 100644 index 00000000..6982b51f --- /dev/null +++ b/keyboard/lightsaber/Makefile.lufa @@ -0,0 +1,125 @@ +#---------------------------------------------------------------------------- +# On command line: +# +# make all = Make software. +# +# make clean = Clean out built project files. +# +# make coff = Convert ELF to AVR COFF. +# +# make extcoff = Convert ELF to AVR Extended COFF. +# +# make program = Download the hex file to the device. +# Please customize your programmer settings(PROGRAM_CMD) +# +# make teensy = Download the hex file to the device, using teensy_loader_cli. +# (must have teensy_loader_cli installed). +# +# make dfu = Download the hex file to the device, using dfu-programmer (must +# have dfu-programmer installed). +# +# make flip = Download the hex file to the device, using Atmel FLIP (must +# have Atmel FLIP installed). +# +# make dfu-ee = Download the eeprom file to the device, using dfu-programmer +# (must have dfu-programmer installed). +# +# make flip-ee = Download the eeprom file to the device, using Atmel FLIP +# (must have Atmel FLIP installed). +# +# make debug = Start either simulavr or avarice as specified for debugging, +# with avr-gdb or avr-insight as the front end for debugging. +# +# make filename.s = Just compile filename.c into the assembler code only. +# +# make filename.i = Create a preprocessed source file for use in submitting +# bug reports to the GCC project. +# +# To rebuild project do "make clean" then "make all". +#---------------------------------------------------------------------------- + +# Target file name (without extension). +TARGET = lightsaber_lufa + +# Directory common source filess exist +TOP_DIR = ../.. + +# Directory keyboard dependent files exist +TARGET_DIR = . + + +# List C source files here. (C dependencies are automatically generated.) +SRC += keymap.c \ + led.c \ + matrix.c + +CONFIG_H = config.h + + +# MCU name +MCU = atmega32u4 + +# Processor frequency. +# This will define a symbol, F_CPU, in all source code files equal to the +# processor frequency in Hz. You can then use this symbol in your source code to +# calculate timings. Do NOT tack on a 'UL' at the end, this will be done +# automatically to create a 32-bit value in your source code. +# +# This will be an integer division of F_USB below, as it is sourced by +# F_USB after it has run through any CPU prescalers. Note that this value +# does not *change* the processor frequency - it should merely be updated to +# reflect the processor speed set externally so that the code can use accurate +# software delays. +F_CPU = 8000000 + + +# +# LUFA specific +# +# Target architecture (see library "Board Types" documentation). +ARCH = AVR8 + +# Input clock frequency. +# This will define a symbol, F_USB, in all source code files equal to the +# input clock frequency (before any prescaling is performed) in Hz. This value may +# differ from F_CPU if prescaling is used on the latter, and is required as the +# raw input clock is fed directly to the PLL sections of the AVR for high speed +# clock generation for the USB and other AVR subsections. Do NOT tack on a 'UL' +# at the end, this will be done automatically to create a 32-bit value in your +# source code. +# +# If no clock division is performed on the input clock inside the AVR (via the +# CPU clock adjust registers or the clock division fuses), this will be equal to F_CPU. +F_USB = $(F_CPU) + + +# Build Options +# comment out to disable the options. +# +BOOTMAGIC_ENABLE = yes # Virtual DIP switch configuration(+1000) +#MOUSEKEY_ENABLE = yes # Mouse keys(+4700) +EXTRAKEY_ENABLE = yes # Audio control and System control(+450) +CONSOLE_ENABLE = yes # Console for debug(+400) +COMMAND_ENABLE = yes # Commands for debug and configuration +#SLEEP_LED_ENABLE = yes # Breathing sleep LED during USB suspend +#NKRO_ENABLE = yes # USB Nkey Rollover - not yet supported in LUFA +#BACKLIGHT_ENABLE = yes # Enable keyboard backlight functionality + + +# Boot Section Size in bytes +# Teensy halfKay 512 +# Atmel DFU loader 4096 +# LUFA bootloader 4096 +OPT_DEFS += -DBOOTLOADER_SIZE=4096 + + +# Search Path +VPATH += $(TARGET_DIR) +VPATH += $(TOP_DIR) + +include $(TOP_DIR)/protocol/lufa.mk +include $(TOP_DIR)/common.mk +include $(TOP_DIR)/rules.mk + +winkey: OPT_DEFS += -DLAYOUT_WINKEY +winkey: all diff --git a/keyboard/lightsaber/Makefile.pjrc b/keyboard/lightsaber/Makefile.pjrc new file mode 100644 index 00000000..1c5a9710 --- /dev/null +++ b/keyboard/lightsaber/Makefile.pjrc @@ -0,0 +1,101 @@ +#---------------------------------------------------------------------------- +# On command line: +# +# make all = Make software. +# +# make clean = Clean out built project files. +# +# make coff = Convert ELF to AVR COFF. +# +# make extcoff = Convert ELF to AVR Extended COFF. +# +# make program = Download the hex file to the device. +# Please customize your programmer settings(PROGRAM_CMD) +# +# make teensy = Download the hex file to the device, using teensy_loader_cli. +# (must have teensy_loader_cli installed). +# +# make dfu = Download the hex file to the device, using dfu-programmer (must +# have dfu-programmer installed). +# +# make flip = Download the hex file to the device, using Atmel FLIP (must +# have Atmel FLIP installed). +# +# make dfu-ee = Download the eeprom file to the device, using dfu-programmer +# (must have dfu-programmer installed). +# +# make flip-ee = Download the eeprom file to the device, using Atmel FLIP +# (must have Atmel FLIP installed). +# +# make debug = Start either simulavr or avarice as specified for debugging, +# with avr-gdb or avr-insight as the front end for debugging. +# +# make filename.s = Just compile filename.c into the assembler code only. +# +# make filename.i = Create a preprocessed source file for use in submitting +# bug reports to the GCC project. +# +# To rebuild project do "make clean" then "make all". +#---------------------------------------------------------------------------- + +# Target file name (without extension). +TARGET = lightsaber_pjrc + +# Directory common source filess exist +TOP_DIR = ../.. + +# Directory keyboard dependent files exist +TARGET_DIR = . + +# keyboard dependent files +SRC = keymap.c \ + matrix.c \ + led.c \ + backlight.c + +CONFIG_H = config.h + + +# MCU name, you MUST set this to match the board you are using +# type "make clean" after changing this, so all files will be rebuilt +#MCU = at90usb162 # Teensy 1.0 +MCU = atmega32u4 # Teensy 2.0 +#MCU = at90usb646 # Teensy++ 1.0 +#MCU = at90usb1286 # Teensy++ 2.0 + + +# Processor frequency. +# Normally the first thing your program should do is set the clock prescaler, +# so your program will run at the correct speed. You should also set this +# variable to same clock speed. The _delay_ms() macro uses this, and many +# examples use this variable to calculate timings. Do not add a "UL" here. +F_CPU = 8000000 + + +# Build Options +# comment out to disable the options. +# +BOOTMAGIC_ENABLE = yes # Virtual DIP switch configuration(+1000) +#MOUSEKEY_ENABLE = yes # Mouse keys(+5000) +EXTRAKEY_ENABLE = yes # Audio control and System control(+600) +CONSOLE_ENABLE = yes # Console for debug +COMMAND_ENABLE = yes # Commands for debug and configuration +#SLEEP_LED_ENABLE = yes # Breathing sleep LED during USB suspend +#NKRO_ENABLE = yes # USB Nkey Rollover(+500) +#PS2_MOUSE_ENABLE = yes # PS/2 mouse(TrackPoint) support +BACKLIGHT_ENABLE = yes # Enable keyboard backlight functionality + + +# Search Path +VPATH += $(TARGET_DIR) +VPATH += $(TOP_DIR) + +include $(TOP_DIR)/protocol/pjrc.mk +include $(TOP_DIR)/common.mk +include $(TOP_DIR)/rules.mk + +winkey: OPT_DEFS += -DLAYOUT_WINKEY +winkey: all + +winkeyless: OPT_DEFS += -DLAYOUT_WINKEYLESS +winkeyless: all diff --git a/keyboard/lightsaber/README.md b/keyboard/lightsaber/README.md new file mode 100644 index 00000000..dc35870c --- /dev/null +++ b/keyboard/lightsaber/README.md @@ -0,0 +1,110 @@ +KMAC keyboard firmware +====================== +Korean custom keyboard designed by Byungho Kim and KBDMania community. + +*Note that this is not the official firmware* + +Supported models +---------------- +At the moment only the TKL models is supported. + + +Build +----- +Move to this directory then just run `make` like: + + $ make -f Makefile.[pjrc|lufa] [winkey|winkeyless] + +Use `Makefile.pjrc` if you want to use PJRC stack or use `Makefile.lufa` for LUFA stack. + + +Bootloader +--------- +The PCB is hardwired to run the bootloader if the key at the `Caps Lock` position is held down when connecting the keyboard. + +It is still possible to use Boot Magic and Command to access the bootloader though. + + +Keymap +------ +There are 2 different types of PCB. +They each have their own keymap file. + +To customize a keymap: + 1. Edit the file that corresponds to your PCB. + 2. Specify your layout when building. + +### 1. Winkey +This is the default keymap. + +See [keymap_winkey.h](keymap_winkey.h) for detail. + +#### 1.0. Winkey Default Layer + ,---. ,---------------. ,---------------. ,---------------. ,-----------. + |Esc| |F1 |F2 |F3 |F4 | |F5 |F6 |F7 |F8 | |F9 |F10|F11|F12| |PrS|ScL|Pau| + `---' `---------------' `---------------' `---------------' `-----------' + ,-----------------------------------------------------------. ,-----------. + |~ | 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|Backsp | |Ins|Hom|PgU| + |-----------------------------------------------------------| |-----------| + |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| \| |Del|End|PgD| + |-----------------------------------------------------------| '-----------' + |Fn0 | A| S| D| F| G| H| J| K| L| ;| '|Return | + |-----------------------------------------------------------| ,---. + |Shift | Z| X| C| V| B| N| M| ,| .| /|Shift | |Up | + |-----------------------------------------------------------| ,-----------. + |Ctl|Gui|Alt| Space |Alt|Gui|App|Ctl| |Lef|Dow|Rig| + `-----------------------------------------------------------' `-----------' + +#### 1.1. Winkey Media Layer + ,---. ,---------------. ,---------------. ,---------------. ,-----------. + |Led| | | | | | | | | | | | | | | | | | |Slp| + `---' `---------------' `---------------' `---------------' `-----------' + ,-----------------------------------------------------------. ,-----------. + | | | | | | | | | | |Mut|V- |V+ | | | | | | + |-----------------------------------------------------------| |-----------| + | | | | | | | | | |Stp|Ply|Prv|Nxt|Media| | | | | + |-----------------------------------------------------------| '-----------' + | | | | | | | | | | | | | | + |-----------------------------------------------------------| ,---. + | | | |Clc| | | | | | | |Caps | | | + |-----------------------------------------------------------| ,-----------. + | | | | | | | | | | | | | + `-----------------------------------------------------------' `-----------' + + +### 2. Winkeyless +Layout with 1.5 unit modifiers. + +See [keymap_winkeyless.h](keymap_winkeyless.h) for detail. + +#### 2.0. Winkeyless Default Layer + ,---. ,---------------. ,---------------. ,---------------. ,-----------. + |Esc| |F1 |F2 |F3 |F4 | |F5 |F6 |F7 |F8 | |F9 |F10|F11|F12| |PrS|ScL|Pau| + `---' `---------------' `---------------' `---------------' `-----------' + ,-----------------------------------------------------------. ,-----------. + |~ | 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|Backsp | |Ins|Hom|PgU| + |-----------------------------------------------------------| |-----------| + |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| \| |Del|End|PgD| + |-----------------------------------------------------------| '-----------' + |Fn0 | A| S| D| F| G| H| J| K| L| ;| '|Return | + |-----------------------------------------------------------| ,---. + |Shift | Z| X| C| V| B| N| M| ,| .| /|Shift | |Up | + |-----------------------------------------------------------| ,-----------. + |Ctl |Gui|Alt | Space |Alt |Gui|Ctl | |Lef|Dow|Rig| + `-----------------------------------------------------------' `-----------' + +#### 2.1. Winkeyless Media Layer + ,---. ,---------------. ,---------------. ,---------------. ,-----------. + |Led| | | | | | | | | | | | | | | | | | |Slp| + `---' `---------------' `---------------' `---------------' `-----------' + ,-----------------------------------------------------------. ,-----------. + | | | | | | | | | | |Mut|V- |V+ | | | | | | + |-----------------------------------------------------------| |-----------| + | | | | | | | | | |Stp|Ply|Prv|Nxt|Media| | | | | + |-----------------------------------------------------------| '-----------' + | | | | | | | | | | | | | | + |-----------------------------------------------------------| ,---. + | | | |Clc| | | | | | | |Caps | | | + |-----------------------------------------------------------| ,-----------. + | | | | | | | | | | | | + `-----------------------------------------------------------' `-----------' diff --git a/keyboard/lightsaber/config.h b/keyboard/lightsaber/config.h new file mode 100644 index 00000000..b8de6adb --- /dev/null +++ b/keyboard/lightsaber/config.h @@ -0,0 +1,43 @@ +/* +Copyright 2013 Mathias Andersson + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#ifndef CONFIG_H +#define CONFIG_H + +/* USB Device descriptor parameter */ +#define VENDOR_ID 0xFEED +#define PRODUCT_ID 0x6050 +#define DEVICE_VER 0x0104 +#define MANUFACTURER Duck +#define PRODUCT Lightsaber + +/* message strings */ +#define DESCRIPTION t.m.k. keyboard firmware for Lightsaber + +/* matrix size */ +#define MATRIX_ROWS 6 +#define MATRIX_COLS 18 + +/* Set 0 if need no debouncing */ +#define DEBOUNCE 5 + +/* key combination for command */ +#define IS_COMMAND() ( \ + keyboard_report->mods == (MOD_BIT(KC_LSHIFT) | MOD_BIT(KC_RSHIFT)) \ +) + +#endif diff --git a/keyboard/lightsaber/keymap.c b/keyboard/lightsaber/keymap.c new file mode 100644 index 00000000..398e51ec --- /dev/null +++ b/keyboard/lightsaber/keymap.c @@ -0,0 +1,77 @@ +/* +Copyright 2014 Ralf Schmitt + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +/* + * Keymap for Lightsaber controller + */ +#include +#include +#include +#include "keycode.h" +#include "action.h" +#include "action_macro.h" +#include "report.h" +#include "host.h" +#include "debug.h" +#include "keymap.h" + +// Convert physical keyboard layout to matrix array. +// This is a macro to define keymap easily in keyboard layout form. +#define KEYMAP( \ + K5A, K5B, K5C, K5D, K5E, K5F, K5G, K5H, K5I, K5J, K5K, K5L, K5M, K5N, K5O, K5P, K5Q, K5R, \ + K4A, K4B, K4C, K4D, K4E, K4F, K4G, K4H, K4I, K4J, K4K, K4L, K4M, K4N, K4O, K4P, K4Q, K4R, \ + K3A, K3B, K3C, K3D, K3E, K3F, K3G, K3H, K3I, K3J, K3K, K3L, K3M, K3N, K3O, K3P, K3Q, K3R, \ + K2A, K2B, K2C, K2D, K2E, K2F, K2G, K2H, K2I, K2J, K2K, K2L, K2M, K2N, K2O, K2P, K2Q, K2R, \ + K1A, K1C, K1D, K1E, K1F, K1G, K1H, K1I, K1J, K1K, K1L, K1M, K1N, K1O, K1P, K1Q, K1R, \ + K0A, K0B, K0C, K0G, K0K, K0L, K0M, K0N, K0O, K0P, K0Q, K0R \ +) { \ +/* 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 */ \ +/* 5 */ { KC_##K5A, KC_##K5B, KC_##K5C, KC_##K5D, KC_##K5E, KC_##K5F, KC_##K5G, KC_##K5H, KC_##K5I, KC_##K5J, KC_##K5K, KC_##K5L, KC_##K5M, KC_##K5N, KC_##K5O, KC_##K5P, KC_##K5Q, KC_##K5R}, \ +/* 4 */ { KC_##K4A, KC_##K4B, KC_##K4C, KC_##K4D, KC_##K4E, KC_##K4F, KC_##K4G, KC_##K4H, KC_##K4I, KC_##K4J, KC_##K4K, KC_##K4L, KC_##K4M, KC_##K4N, KC_##K4O, KC_##K4P, KC_##K4Q, KC_##K4R}, \ +/* 3 */ { KC_##K3A, KC_##K3B, KC_##K3C, KC_##K3D, KC_##K3E, KC_##K3F, KC_##K3G, KC_##K3H, KC_##K3I, KC_##K3J, KC_##K3K, KC_##K3L, KC_##K3M, KC_##K3N, KC_##K3O, KC_##K3P, KC_##K3Q, KC_##K3R}, \ +/* 2 */ { KC_##K2A, KC_##K2B, KC_##K2C, KC_##K2D, KC_##K2E, KC_##K2F, KC_##K2G, KC_##K2H, KC_##K2I, KC_##K2J, KC_##K2K, KC_##K2L, KC_##K2M, KC_##K2N, KC_##K2O, KC_##K2P, KC_##K2Q, KC_##K2R}, \ +/* 1 */ { KC_##K1A, KC_##K1C, KC_##K1D, KC_##K1E, KC_##K1F, KC_##K1G, KC_##K1H, KC_##K1I, KC_##K1J, KC_##K1K, KC_##K1L, KC_NO, KC_##K1M, KC_##K1N, KC_##K1O, KC_##K1P, KC_##K1Q, KC_##K1R}, \ +/* 0 */ { KC_##K0A, KC_##K0B, KC_##K0C, KC_NO, KC_NO, KC_##K0G, KC_NO, KC_NO, KC_##K0K, KC_NO, KC_##K0L, KC_NO, KC_##K0M, KC_##K0N, KC_##K0O, KC_##K0P, KC_##K0Q, KC_##K0R} \ +} + +#include "keymap_winkey.h" + +#define KEYMAPS_SIZE (sizeof(keymaps) / sizeof(keymaps[0])) +#define FN_ACTIONS_SIZE (sizeof(fn_actions) / sizeof(fn_actions[0])) + +/* translates key to keycode */ +uint8_t keymap_key_to_keycode(uint8_t layer, key_t key) +{ + if (layer < KEYMAPS_SIZE) { + return pgm_read_byte(&keymaps[(layer)][(key.row)][(key.col)]); + } else { + // fall back to layer 0 + return pgm_read_byte(&keymaps[0][(key.row)][(key.col)]); + } +} + +/* translates Fn keycode to action */ +action_t keymap_fn_to_action(uint8_t keycode) +{ + action_t action; + if (FN_INDEX(keycode) < FN_ACTIONS_SIZE) { + action.code = pgm_read_word(&fn_actions[FN_INDEX(keycode)]); + } else { + action.code = ACTION_NO; + } + return action; +} diff --git a/keyboard/lightsaber/keymap_winkey.h b/keyboard/lightsaber/keymap_winkey.h new file mode 100644 index 00000000..510fa7f7 --- /dev/null +++ b/keyboard/lightsaber/keymap_winkey.h @@ -0,0 +1,12 @@ +static const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { + KEYMAP(\ + ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, DEL, INS, PSCR, SLCK, BRK, \ + GRV, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSPC, NUMLOCK,KP_SLASH,KP_ASTERISK,KP_MINUS, \ + TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSLS, KP_7, KP_8, KP_9, KP_PLUS, \ + CAPS,A, S, D, F, G, H, J, K, L, SCLN,QUOT,NO, ENT, KP_4, KP_5, KP_6, NO, \ + LSFT, Z, X, C, V, B, N, M, COMM,DOT, SLSH,NO, RSFT, KP_1, KP_2, KP_3, KP_ENTER, \ + LCTL,LGUI,LALT, SPC, NO, RALT,RGUI,RCTL, KP_0, NO, KP_DOT, NO) +}; + +static const uint16_t PROGMEM fn_actions[] = { +}; diff --git a/keyboard/lightsaber/led.c b/keyboard/lightsaber/led.c new file mode 100644 index 00000000..9c98f9db --- /dev/null +++ b/keyboard/lightsaber/led.c @@ -0,0 +1,24 @@ +/* +Copyright 2012 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#include +#include "stdint.h" +#include "led.h" + +void led_set(uint8_t usb_led) +{ +} diff --git a/keyboard/lightsaber/matrix.c b/keyboard/lightsaber/matrix.c new file mode 100644 index 00000000..e3eca84d --- /dev/null +++ b/keyboard/lightsaber/matrix.c @@ -0,0 +1,292 @@ +/* +Copyright 2014 Ralf Schmitt + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#include +#include +#include +#include +#include "print.h" +#include "debug.h" +#include "util.h" +#include "matrix.h" + + +#ifndef DEBOUNCE +# define DEBOUNCE 0 +#endif +static uint8_t debouncing = DEBOUNCE; + +/* matrix state(1:on, 0:off) */ +static matrix_row_t matrix[MATRIX_ROWS]; +static matrix_row_t matrix_debouncing[MATRIX_ROWS]; + +static uint8_t read_rows(void); +static uint8_t read_fwkey(void); +static void init_rows(void); +static void unselect_cols(void); +static void select_col(uint8_t col); + +inline +uint8_t matrix_rows(void) +{ + return MATRIX_ROWS; +} + +inline +uint8_t matrix_cols(void) +{ + return MATRIX_COLS; +} + +void matrix_init(void) +{ + unselect_cols(); + init_rows(); + // initialize matrix state: all keys off + for (uint8_t i=0; i < MATRIX_ROWS; i++) { + matrix[i] = 0; + matrix_debouncing[i] = 0; + } +} + +uint8_t matrix_scan(void) +{ + for (uint8_t col = 0; col < MATRIX_COLS; col++) { // 0-17 + select_col(col); + _delay_us(3); // TODO: Determine the correct value needed here. + uint8_t rows = read_rows(); + // Use the otherwise unused col: 12 row: 3 for firmware. + if(col == 12) { + rows |= read_fwkey(); + } + for (uint8_t row = 0; row < MATRIX_ROWS; row++) { // 0-5 + bool prev_bit = matrix_debouncing[row] & ((matrix_row_t)1< Date: Wed, 19 Mar 2014 00:21:45 +0100 Subject: [PATCH 28/48] Updated Lightsaber read me --- keyboard/lightsaber/README.md | 92 ++--------------------------------- 1 file changed, 4 insertions(+), 88 deletions(-) diff --git a/keyboard/lightsaber/README.md b/keyboard/lightsaber/README.md index dc35870c..bd2b3fb5 100644 --- a/keyboard/lightsaber/README.md +++ b/keyboard/lightsaber/README.md @@ -1,12 +1,12 @@ -KMAC keyboard firmware +Lightsaber keyboard firmware ====================== -Korean custom keyboard designed by Byungho Kim and KBDMania community. +Korean custom keyboard designed by Duck. *Note that this is not the official firmware* Supported models ---------------- -At the moment only the TKL models is supported. +All pcb options are supported. Build @@ -20,91 +20,7 @@ Use `Makefile.pjrc` if you want to use PJRC stack or use `Makefile.lufa` for LUF Bootloader --------- -The PCB is hardwired to run the bootloader if the key at the `Caps Lock` position is held down when connecting the keyboard. +The PCB is hardwired to run the bootloader if the key at the `one above backspace` position is held down when connecting the keyboard. It is still possible to use Boot Magic and Command to access the bootloader though. - -Keymap ------- -There are 2 different types of PCB. -They each have their own keymap file. - -To customize a keymap: - 1. Edit the file that corresponds to your PCB. - 2. Specify your layout when building. - -### 1. Winkey -This is the default keymap. - -See [keymap_winkey.h](keymap_winkey.h) for detail. - -#### 1.0. Winkey Default Layer - ,---. ,---------------. ,---------------. ,---------------. ,-----------. - |Esc| |F1 |F2 |F3 |F4 | |F5 |F6 |F7 |F8 | |F9 |F10|F11|F12| |PrS|ScL|Pau| - `---' `---------------' `---------------' `---------------' `-----------' - ,-----------------------------------------------------------. ,-----------. - |~ | 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|Backsp | |Ins|Hom|PgU| - |-----------------------------------------------------------| |-----------| - |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| \| |Del|End|PgD| - |-----------------------------------------------------------| '-----------' - |Fn0 | A| S| D| F| G| H| J| K| L| ;| '|Return | - |-----------------------------------------------------------| ,---. - |Shift | Z| X| C| V| B| N| M| ,| .| /|Shift | |Up | - |-----------------------------------------------------------| ,-----------. - |Ctl|Gui|Alt| Space |Alt|Gui|App|Ctl| |Lef|Dow|Rig| - `-----------------------------------------------------------' `-----------' - -#### 1.1. Winkey Media Layer - ,---. ,---------------. ,---------------. ,---------------. ,-----------. - |Led| | | | | | | | | | | | | | | | | | |Slp| - `---' `---------------' `---------------' `---------------' `-----------' - ,-----------------------------------------------------------. ,-----------. - | | | | | | | | | | |Mut|V- |V+ | | | | | | - |-----------------------------------------------------------| |-----------| - | | | | | | | | | |Stp|Ply|Prv|Nxt|Media| | | | | - |-----------------------------------------------------------| '-----------' - | | | | | | | | | | | | | | - |-----------------------------------------------------------| ,---. - | | | |Clc| | | | | | | |Caps | | | - |-----------------------------------------------------------| ,-----------. - | | | | | | | | | | | | | - `-----------------------------------------------------------' `-----------' - - -### 2. Winkeyless -Layout with 1.5 unit modifiers. - -See [keymap_winkeyless.h](keymap_winkeyless.h) for detail. - -#### 2.0. Winkeyless Default Layer - ,---. ,---------------. ,---------------. ,---------------. ,-----------. - |Esc| |F1 |F2 |F3 |F4 | |F5 |F6 |F7 |F8 | |F9 |F10|F11|F12| |PrS|ScL|Pau| - `---' `---------------' `---------------' `---------------' `-----------' - ,-----------------------------------------------------------. ,-----------. - |~ | 1| 2| 3| 4| 5| 6| 7| 8| 9| 0| -| =|Backsp | |Ins|Hom|PgU| - |-----------------------------------------------------------| |-----------| - |Tab | Q| W| E| R| T| Y| U| I| O| P| [| ]| \| |Del|End|PgD| - |-----------------------------------------------------------| '-----------' - |Fn0 | A| S| D| F| G| H| J| K| L| ;| '|Return | - |-----------------------------------------------------------| ,---. - |Shift | Z| X| C| V| B| N| M| ,| .| /|Shift | |Up | - |-----------------------------------------------------------| ,-----------. - |Ctl |Gui|Alt | Space |Alt |Gui|Ctl | |Lef|Dow|Rig| - `-----------------------------------------------------------' `-----------' - -#### 2.1. Winkeyless Media Layer - ,---. ,---------------. ,---------------. ,---------------. ,-----------. - |Led| | | | | | | | | | | | | | | | | | |Slp| - `---' `---------------' `---------------' `---------------' `-----------' - ,-----------------------------------------------------------. ,-----------. - | | | | | | | | | | |Mut|V- |V+ | | | | | | - |-----------------------------------------------------------| |-----------| - | | | | | | | | | |Stp|Ply|Prv|Nxt|Media| | | | | - |-----------------------------------------------------------| '-----------' - | | | | | | | | | | | | | | - |-----------------------------------------------------------| ,---. - | | | |Clc| | | | | | | |Caps | | | - |-----------------------------------------------------------| ,-----------. - | | | | | | | | | | | | - `-----------------------------------------------------------' `-----------' From 526d988a0caadc1a48bea862f605c9cee90c3dd3 Mon Sep 17 00:00:00 2001 From: Ralf Schmitt Date: Wed, 19 Mar 2014 23:58:08 +0100 Subject: [PATCH 29/48] Added basic led+backlight support --- keyboard/lightsaber/Makefile.lufa | 3 +- keyboard/lightsaber/backlight.c | 56 +++++++++++++++++++++++++++++ keyboard/lightsaber/config.h | 3 ++ keyboard/lightsaber/keymap_winkey.h | 3 +- keyboard/lightsaber/led.c | 32 ++++++++++++++++- 5 files changed, 94 insertions(+), 3 deletions(-) create mode 100644 keyboard/lightsaber/backlight.c diff --git a/keyboard/lightsaber/Makefile.lufa b/keyboard/lightsaber/Makefile.lufa index 6982b51f..25816ac0 100644 --- a/keyboard/lightsaber/Makefile.lufa +++ b/keyboard/lightsaber/Makefile.lufa @@ -51,6 +51,7 @@ TARGET_DIR = . # List C source files here. (C dependencies are automatically generated.) SRC += keymap.c \ led.c \ + backlight.c \ matrix.c CONFIG_H = config.h @@ -103,7 +104,7 @@ CONSOLE_ENABLE = yes # Console for debug(+400) COMMAND_ENABLE = yes # Commands for debug and configuration #SLEEP_LED_ENABLE = yes # Breathing sleep LED during USB suspend #NKRO_ENABLE = yes # USB Nkey Rollover - not yet supported in LUFA -#BACKLIGHT_ENABLE = yes # Enable keyboard backlight functionality +BACKLIGHT_ENABLE = yes # Enable keyboard backlight functionality # Boot Section Size in bytes diff --git a/keyboard/lightsaber/backlight.c b/keyboard/lightsaber/backlight.c new file mode 100644 index 00000000..b2820080 --- /dev/null +++ b/keyboard/lightsaber/backlight.c @@ -0,0 +1,56 @@ +/* +Copyright 2014 Ralf Schmitt + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#include +#include "backlight.h" + +/* Backlight pin configuration + * + * Alphas PB1 (high) + * Numeric PB2 (high) + * Mod+Num PB3 (high) + * Backside PD6 (high) + * TopRight PD7 (low) + * F-Row PE6 (high) + * + */ +void backlight_set(uint8_t level) +{ + // Set as output. + DDRB |= (1<<1) | (1<<2) | (1<<3); + DDRD |= (1<<6) | (1<<7); + DDRE |= (1<<6); + + if(level & (1<<0)) + { + PORTB &= ~(1<<1); + PORTB &= ~(1<<2); + PORTB &= ~(1<<3); + PORTD &= ~(1<<6); + PORTD |= (1<<7); + PORTE &= ~(1<<6); + } + else + { + PORTB |= (1<<1); + PORTB |= (1<<2); + PORTB |= (1<<3); + PORTD |= (1<<6); + PORTD &= ~(1<<7); + PORTE |= (1<<6); + } +} diff --git a/keyboard/lightsaber/config.h b/keyboard/lightsaber/config.h index b8de6adb..d971d038 100644 --- a/keyboard/lightsaber/config.h +++ b/keyboard/lightsaber/config.h @@ -32,6 +32,9 @@ along with this program. If not, see . #define MATRIX_ROWS 6 #define MATRIX_COLS 18 +/* number of backlight levels */ +#define BACKLIGHT_LEVELS 1 + /* Set 0 if need no debouncing */ #define DEBOUNCE 5 diff --git a/keyboard/lightsaber/keymap_winkey.h b/keyboard/lightsaber/keymap_winkey.h index 510fa7f7..9d558ae7 100644 --- a/keyboard/lightsaber/keymap_winkey.h +++ b/keyboard/lightsaber/keymap_winkey.h @@ -3,10 +3,11 @@ static const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, DEL, INS, PSCR, SLCK, BRK, \ GRV, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSPC, NUMLOCK,KP_SLASH,KP_ASTERISK,KP_MINUS, \ TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSLS, KP_7, KP_8, KP_9, KP_PLUS, \ - CAPS,A, S, D, F, G, H, J, K, L, SCLN,QUOT,NO, ENT, KP_4, KP_5, KP_6, NO, \ + CAPS,A, S, D, F, G, H, J, K, L, SCLN,QUOT,FN0, ENT, KP_4, KP_5, KP_6, NO, \ LSFT, Z, X, C, V, B, N, M, COMM,DOT, SLSH,NO, RSFT, KP_1, KP_2, KP_3, KP_ENTER, \ LCTL,LGUI,LALT, SPC, NO, RALT,RGUI,RCTL, KP_0, NO, KP_DOT, NO) }; static const uint16_t PROGMEM fn_actions[] = { + [0] = ACTION_BACKLIGHT_STEP() }; diff --git a/keyboard/lightsaber/led.c b/keyboard/lightsaber/led.c index 9c98f9db..c3f85427 100644 --- a/keyboard/lightsaber/led.c +++ b/keyboard/lightsaber/led.c @@ -1,5 +1,5 @@ /* -Copyright 2012 Jun Wako +Copyright 2014 Ralf Schmitt This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -19,6 +19,36 @@ along with this program. If not, see . #include "stdint.h" #include "led.h" +/* LED pin configuration + * + * Caps PB0 (low) + * NumLock PB4 (low) + * + */ void led_set(uint8_t usb_led) { + // Set as output. + DDRB |= (1<<0) | (1<<4); + + if (usb_led & (1< Date: Sat, 22 Mar 2014 12:41:45 +0100 Subject: [PATCH 30/48] Lightsaber clean ups --- README.md | 1 + keyboard/lightsaber/Makefile.lufa | 6 +++--- keyboard/lightsaber/Makefile.pjrc | 11 ++--------- keyboard/lightsaber/README.md | 2 +- 4 files changed, 7 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index a561b38e..6596dc33 100644 --- a/README.md +++ b/README.md @@ -52,6 +52,7 @@ You can find some keyboard specific projects under `converter` and `keyboard` di * [IIgs_Standard](keyboard/IIgs/) - Apple [IIGS] keyboard mod(by JeffreySung) * [macway](keyboard/macway/) - [Compact keyboard mod][GH_macway] [retired] * [KMAC](keyboard/kmac/) - Korean custom keyboard +* [Lightsaber](keyboard/lightsaber/) - Korean custom keyboard [GH_macway]: http://geekhack.org/showwiki.php?title=Island:11930 [GH_hhkb]: http://geekhack.org/showwiki.php?title=Island:12047 diff --git a/keyboard/lightsaber/Makefile.lufa b/keyboard/lightsaber/Makefile.lufa index 25816ac0..b430efd2 100644 --- a/keyboard/lightsaber/Makefile.lufa +++ b/keyboard/lightsaber/Makefile.lufa @@ -49,10 +49,10 @@ TARGET_DIR = . # List C source files here. (C dependencies are automatically generated.) -SRC += keymap.c \ +SRC = keymap.c \ + matrix.c \ led.c \ - backlight.c \ - matrix.c + backlight.c CONFIG_H = config.h diff --git a/keyboard/lightsaber/Makefile.pjrc b/keyboard/lightsaber/Makefile.pjrc index 1c5a9710..58735a7e 100644 --- a/keyboard/lightsaber/Makefile.pjrc +++ b/keyboard/lightsaber/Makefile.pjrc @@ -56,12 +56,8 @@ SRC = keymap.c \ CONFIG_H = config.h -# MCU name, you MUST set this to match the board you are using -# type "make clean" after changing this, so all files will be rebuilt -#MCU = at90usb162 # Teensy 1.0 -MCU = atmega32u4 # Teensy 2.0 -#MCU = at90usb646 # Teensy++ 1.0 -#MCU = at90usb1286 # Teensy++ 2.0 +# MCU name +MCU = atmega32u4 # Processor frequency. @@ -96,6 +92,3 @@ include $(TOP_DIR)/rules.mk winkey: OPT_DEFS += -DLAYOUT_WINKEY winkey: all - -winkeyless: OPT_DEFS += -DLAYOUT_WINKEYLESS -winkeyless: all diff --git a/keyboard/lightsaber/README.md b/keyboard/lightsaber/README.md index bd2b3fb5..9dcd6930 100644 --- a/keyboard/lightsaber/README.md +++ b/keyboard/lightsaber/README.md @@ -13,7 +13,7 @@ Build ----- Move to this directory then just run `make` like: - $ make -f Makefile.[pjrc|lufa] [winkey|winkeyless] + $ make -f Makefile.[pjrc|lufa] Use `Makefile.pjrc` if you want to use PJRC stack or use `Makefile.lufa` for LUFA stack. From 1482fe92a0c5af6f0a84396a3f9fee73d59bb48f Mon Sep 17 00:00:00 2001 From: Ralf Schmitt Date: Sat, 22 Mar 2014 13:13:37 +0100 Subject: [PATCH 31/48] Added Lightsaber FN-layer --- keyboard/lightsaber/keymap_winkey.h | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/keyboard/lightsaber/keymap_winkey.h b/keyboard/lightsaber/keymap_winkey.h index 9d558ae7..59ffd4a8 100644 --- a/keyboard/lightsaber/keymap_winkey.h +++ b/keyboard/lightsaber/keymap_winkey.h @@ -1,13 +1,21 @@ static const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { KEYMAP(\ - ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, DEL, INS, PSCR, SLCK, BRK, \ - GRV, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSPC, NUMLOCK,KP_SLASH,KP_ASTERISK,KP_MINUS, \ - TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSLS, KP_7, KP_8, KP_9, KP_PLUS, \ - CAPS,A, S, D, F, G, H, J, K, L, SCLN,QUOT,FN0, ENT, KP_4, KP_5, KP_6, NO, \ - LSFT, Z, X, C, V, B, N, M, COMM,DOT, SLSH,NO, RSFT, KP_1, KP_2, KP_3, KP_ENTER, \ - LCTL,LGUI,LALT, SPC, NO, RALT,RGUI,RCTL, KP_0, NO, KP_DOT, NO) + ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, DEL, INS, PSCR, SLCK, BRK, \ + GRV, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSPC, NUMLOCK,KP_SLASH,KP_ASTERISK,KP_MINUS, \ + TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSLS, KP_7, KP_8, KP_9, KP_PLUS, \ + CAPS,A, S, D, F, G, H, J, K, L, SCLN,QUOT,FN0, ENT, KP_4, KP_5, KP_6, NO, \ + LSFT, Z, X, C, V, B, N, M, COMM,DOT, SLSH,NO, RSFT, KP_1, KP_2, KP_3, KP_ENTER, \ + LCTL,LGUI,LALT, SPC, NO, RALT,RGUI,RCTL, KP_0, NO, KP_DOT, NO), \ + KEYMAP(\ + CALC,MYCM,WSCH,WHOM,MAIL,MUTE,VOLD,VOLU,MSEL,MSTP,MPLY,MPRV,MNXT,TRNS, TRNS, WAKE, PWR, SLEP, \ + TRNS,TRNS,TRNS,TRNS,END ,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ + TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ + TRNS,TRNS,TRNS,TRNS,PGDN,TRNS,LEFT,DOWN,UP ,RGHT,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ + TRNS, TRNS,TRNS,TRNS,TRNS,PGUP,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ + TRNS,TRNS,TRNS, FN1, TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS) }; static const uint16_t PROGMEM fn_actions[] = { - [0] = ACTION_BACKLIGHT_STEP() + [0] = ACTION_LAYER_MOMENTARY(1), + [1] = ACTION_BACKLIGHT_STEP() }; From 13fbab9d8b2015f4b81316bbdfba0705d459a480 Mon Sep 17 00:00:00 2001 From: Johan Isacsson Date: Thu, 27 Mar 2014 23:59:25 +0100 Subject: [PATCH 32/48] Show correct function name for default layer set --- doc/keymap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/keymap.md b/doc/keymap.md index 7ef7430c..3d78fc9c 100644 --- a/doc/keymap.md +++ b/doc/keymap.md @@ -269,7 +269,7 @@ Default Layer is a layer which always is valid and referred to when actions is n This sets Default Layer to given parameter `layer` and activate it. - ACTION_DEFAULT_LAYER(layer) + ACTION_DEFAULT_LAYER_SET(layer) #### 2.2.2 Momentary From 589d99b448e6085513799fbb183f6389d4df408d Mon Sep 17 00:00:00 2001 From: Ralf Schmitt Date: Tue, 8 Apr 2014 21:02:46 +0200 Subject: [PATCH 33/48] New macro: ACTION_BACKLIGHT_LEVEL(level) To have full control of the backlight level. --- common/action.c | 5 ++- common/action_code.h | 18 ++++++----- common/backlight.c | 8 +++++ common/backlight.h | 7 ++--- doc/keymap.md | 4 +++ keyboard/lightsaber/backlight.c | 48 +++++++++++++++++++++++------ keyboard/lightsaber/backlight.h | 9 ++++++ keyboard/lightsaber/keymap_winkey.h | 14 +++++++-- 8 files changed, 89 insertions(+), 24 deletions(-) create mode 100644 keyboard/lightsaber/backlight.h diff --git a/common/action.c b/common/action.c index e6938f5a..fddb97c5 100644 --- a/common/action.c +++ b/common/action.c @@ -294,7 +294,7 @@ void process_action(keyrecord_t *record) #ifdef BACKLIGHT_ENABLE case ACT_BACKLIGHT: if (!event.pressed) { - switch (action.backlight.id) { + switch (action.backlight.opt) { case BACKLIGHT_INCREASE: backlight_increase(); break; @@ -307,6 +307,9 @@ void process_action(keyrecord_t *record) case BACKLIGHT_STEP: backlight_step(); break; + case BACKLIGHT_LEVEL: + backlight_level(action.backlight.level); + break; } } break; diff --git a/common/action_code.h b/common/action_code.h index 8df86b11..50112d4d 100644 --- a/common/action_code.h +++ b/common/action_code.h @@ -87,7 +87,7 @@ along with this program. If not, see . * 1100|1111| id(8) Macro record? * * ACT_BACKLIGHT(1101): - * 1101|xxxx| id(8) Backlight commands + * 1101|opt |level(8) Backlight commands * * ACT_COMMAND(1110): * 1110|opt | id(8) Built-in Command exec @@ -163,7 +163,9 @@ typedef union { uint8_t kind :4; } usage; struct action_backlight { - uint8_t id :8; + uint8_t level :8; + uint8_t opt :4; + uint8_t kind :4; } backlight; struct action_command { uint8_t id :8; @@ -282,21 +284,23 @@ enum layer_pram_tap_op { /* * Extensions */ -enum backlight_id { +enum backlight_opt { BACKLIGHT_INCREASE = 0, BACKLIGHT_DECREASE = 1, BACKLIGHT_TOGGLE = 2, BACKLIGHT_STEP = 3, + BACKLIGHT_LEVEL = 4, }; /* Macro */ #define ACTION_MACRO(id) ACTION(ACT_MACRO, (id)) #define ACTION_MACRO_TAP(id) ACTION(ACT_MACRO, FUNC_TAP<<8 | (id)) #define ACTION_MACRO_OPT(id, opt) ACTION(ACT_MACRO, (opt)<<8 | (id)) /* Backlight */ -#define ACTION_BACKLIGHT_INCREASE() ACTION(ACT_BACKLIGHT, BACKLIGHT_INCREASE) -#define ACTION_BACKLIGHT_DECREASE() ACTION(ACT_BACKLIGHT, BACKLIGHT_DECREASE) -#define ACTION_BACKLIGHT_TOGGLE() ACTION(ACT_BACKLIGHT, BACKLIGHT_TOGGLE) -#define ACTION_BACKLIGHT_STEP() ACTION(ACT_BACKLIGHT, BACKLIGHT_STEP) +#define ACTION_BACKLIGHT_INCREASE() ACTION(ACT_BACKLIGHT, BACKLIGHT_INCREASE << 8) +#define ACTION_BACKLIGHT_DECREASE() ACTION(ACT_BACKLIGHT, BACKLIGHT_DECREASE << 8) +#define ACTION_BACKLIGHT_TOGGLE() ACTION(ACT_BACKLIGHT, BACKLIGHT_TOGGLE << 8) +#define ACTION_BACKLIGHT_STEP() ACTION(ACT_BACKLIGHT, BACKLIGHT_STEP << 8) +#define ACTION_BACKLIGHT_LEVEL(level) ACTION(ACT_BACKLIGHT, BACKLIGHT_LEVEL << 8 | level) /* Command */ #define ACTION_COMMAND(id, opt) ACTION(ACT_COMMAND, (opt)<<8 | (addr)) /* Function */ diff --git a/common/backlight.c b/common/backlight.c index 00dc04a0..558ad9b0 100644 --- a/common/backlight.c +++ b/common/backlight.c @@ -75,3 +75,11 @@ void backlight_step(void) dprintf("backlight step: %u\n", backlight_config.level); backlight_set(backlight_config.level); } + +void backlight_level(uint8_t level) +{ + backlight_config.level ^= level; + backlight_config.enable = !!backlight_config.level; + eeconfig_write_backlight(backlight_config.raw); + backlight_set(backlight_config.level); +} diff --git a/common/backlight.h b/common/backlight.h index 685c422a..525ec8bb 100644 --- a/common/backlight.h +++ b/common/backlight.h @@ -24,18 +24,17 @@ along with this program. If not, see . typedef union { uint8_t raw; struct { - bool enable:1; - uint8_t level:7; + bool enable :1; + uint8_t level :7; }; } backlight_config_t; void backlight_init(void); - void backlight_increase(void); void backlight_decrease(void); void backlight_toggle(void); void backlight_step(void); - void backlight_set(uint8_t level); +void backlight_level(uint8_t level); #endif diff --git a/doc/keymap.md b/doc/keymap.md index 3d78fc9c..11feeac2 100644 --- a/doc/keymap.md +++ b/doc/keymap.md @@ -444,6 +444,10 @@ Step through backlight levels. ACTION_BACKLIGHT_STEP() +Turn a specific backlight level on or off. + + ACTION_BACKLIGHT_LEVEL(1) + #### 2.5.2 Turn on / off backlight Turn the backlight on and off without changing level. diff --git a/keyboard/lightsaber/backlight.c b/keyboard/lightsaber/backlight.c index b2820080..59b8b4a6 100644 --- a/keyboard/lightsaber/backlight.c +++ b/keyboard/lightsaber/backlight.c @@ -26,8 +26,8 @@ along with this program. If not, see . * Backside PD6 (high) * TopRight PD7 (low) * F-Row PE6 (high) - * */ + void backlight_set(uint8_t level) { // Set as output. @@ -35,22 +35,52 @@ void backlight_set(uint8_t level) DDRD |= (1<<6) | (1<<7); DDRE |= (1<<6); - if(level & (1<<0)) + if (level & BACKLIGHT_ALPHA) { - PORTB &= ~(1<<1); - PORTB &= ~(1<<2); - PORTB &= ~(1<<3); - PORTD &= ~(1<<6); - PORTD |= (1<<7); - PORTE &= ~(1<<6); + PORTB |= (1<<1); } else { - PORTB |= (1<<1); + PORTB &= ~(1<<1); + } + if (level & BACKLIGHT_NUMERIC) + { PORTB |= (1<<2); + } + else + { + PORTB &= ~(1<<2); + } + if (level & BACKLIGHT_MODNUM) + { PORTB |= (1<<3); + } + else + { + PORTB &= ~(1<<3); + } + if (level & BACKLIGHT_BACKSIDE) + { PORTD |= (1<<6); + } + else + { + PORTD &= ~(1<<6); + } + if (level & BACKLIGHT_TOPRIGHT) + { PORTD &= ~(1<<7); + } + else + { + PORTD |= (1<<7); + } + if (level & BACKLIGHT_FROW) + { PORTE |= (1<<6); } + else + { + PORTE &= ~(1<<6); + } } diff --git a/keyboard/lightsaber/backlight.h b/keyboard/lightsaber/backlight.h new file mode 100644 index 00000000..6dc7967a --- /dev/null +++ b/keyboard/lightsaber/backlight.h @@ -0,0 +1,9 @@ + +enum backlight_level { + BACKLIGHT_ALPHA = 0b0000001, + BACKLIGHT_NUMERIC = 0b0000010, + BACKLIGHT_MODNUM = 0b0000100, + BACKLIGHT_BACKSIDE = 0b0001000, + BACKLIGHT_TOPRIGHT = 0b0010000, + BACKLIGHT_FROW = 0b0100000, +}; diff --git a/keyboard/lightsaber/keymap_winkey.h b/keyboard/lightsaber/keymap_winkey.h index 59ffd4a8..3e836708 100644 --- a/keyboard/lightsaber/keymap_winkey.h +++ b/keyboard/lightsaber/keymap_winkey.h @@ -1,3 +1,5 @@ +#include "backlight.h" + static const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { KEYMAP(\ ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, DEL, INS, PSCR, SLCK, BRK, \ @@ -8,14 +10,20 @@ static const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { LCTL,LGUI,LALT, SPC, NO, RALT,RGUI,RCTL, KP_0, NO, KP_DOT, NO), \ KEYMAP(\ CALC,MYCM,WSCH,WHOM,MAIL,MUTE,VOLD,VOLU,MSEL,MSTP,MPLY,MPRV,MNXT,TRNS, TRNS, WAKE, PWR, SLEP, \ - TRNS,TRNS,TRNS,TRNS,END ,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ + FN1, FN2, FN3, FN4, FN5, FN6, FN7, TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ TRNS,TRNS,TRNS,TRNS,PGDN,TRNS,LEFT,DOWN,UP ,RGHT,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ TRNS, TRNS,TRNS,TRNS,TRNS,PGUP,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS, \ - TRNS,TRNS,TRNS, FN1, TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS) + TRNS,TRNS,TRNS, TRNS, TRNS,TRNS,TRNS,TRNS, TRNS, TRNS, TRNS, TRNS) }; static const uint16_t PROGMEM fn_actions[] = { [0] = ACTION_LAYER_MOMENTARY(1), - [1] = ACTION_BACKLIGHT_STEP() + [1] = ACTION_BACKLIGHT_TOGGLE(), + [2] = ACTION_BACKLIGHT_LEVEL(BACKLIGHT_ALPHA), + [3] = ACTION_BACKLIGHT_LEVEL(BACKLIGHT_MODNUM), + [4] = ACTION_BACKLIGHT_LEVEL(BACKLIGHT_NUMERIC), + [5] = ACTION_BACKLIGHT_LEVEL(BACKLIGHT_FROW), + [6] = ACTION_BACKLIGHT_LEVEL(BACKLIGHT_BACKSIDE), + [7] = ACTION_BACKLIGHT_LEVEL(BACKLIGHT_TOPRIGHT) }; From c6902681e72411fbe293657a9d75a2168021a6d8 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 21 Apr 2014 12:18:12 +0900 Subject: [PATCH 34/48] Change PollingIntervalMS to 10ms(Fix #114) --- protocol/lufa/descriptor.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/protocol/lufa/descriptor.c b/protocol/lufa/descriptor.c index a46ba3ec..f9f6b953 100644 --- a/protocol/lufa/descriptor.c +++ b/protocol/lufa/descriptor.c @@ -306,7 +306,7 @@ const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = .EndpointAddress = (ENDPOINT_DIR_IN | KEYBOARD_IN_EPNUM), .Attributes = (EP_TYPE_INTERRUPT | ENDPOINT_ATTR_NO_SYNC | ENDPOINT_USAGE_DATA), .EndpointSize = KEYBOARD_EPSIZE, - .PollingIntervalMS = 0x01 + .PollingIntervalMS = 0x0A }, /* From a5d4a1f3e1f09a79ad949e7e90199548992f0e37 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 21 Apr 2014 22:17:42 +0900 Subject: [PATCH 35/48] Return when ready check loop is timeouted(Fix #115) --- protocol/lufa/descriptor.c | 4 ++-- protocol/lufa/lufa.c | 36 +++++++++++++++++++++++++----------- 2 files changed, 27 insertions(+), 13 deletions(-) diff --git a/protocol/lufa/descriptor.c b/protocol/lufa/descriptor.c index f9f6b953..d97f5d86 100644 --- a/protocol/lufa/descriptor.c +++ b/protocol/lufa/descriptor.c @@ -347,7 +347,7 @@ const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = .EndpointAddress = (ENDPOINT_DIR_IN | MOUSE_IN_EPNUM), .Attributes = (EP_TYPE_INTERRUPT | ENDPOINT_ATTR_NO_SYNC | ENDPOINT_USAGE_DATA), .EndpointSize = MOUSE_EPSIZE, - .PollingIntervalMS = 0x01 + .PollingIntervalMS = 0x0A }, #endif @@ -389,7 +389,7 @@ const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = .EndpointAddress = (ENDPOINT_DIR_IN | EXTRAKEY_IN_EPNUM), .Attributes = (EP_TYPE_INTERRUPT | ENDPOINT_ATTR_NO_SYNC | ENDPOINT_USAGE_DATA), .EndpointSize = EXTRAKEY_EPSIZE, - .PollingIntervalMS = 0x01 + .PollingIntervalMS = 0x0A }, #endif diff --git a/protocol/lufa/lufa.c b/protocol/lufa/lufa.c index eca51c87..68119d5e 100644 --- a/protocol/lufa/lufa.c +++ b/protocol/lufa/lufa.c @@ -351,7 +351,7 @@ static uint8_t keyboard_leds(void) static void send_keyboard(report_keyboard_t *report) { - uint8_t timeout = 0; + uint8_t timeout = 255; if (USB_DeviceState != DEVICE_STATE_Configured) return; @@ -360,15 +360,20 @@ static void send_keyboard(report_keyboard_t *report) #ifdef NKRO_ENABLE if (keyboard_nkro) { Endpoint_SelectEndpoint(NKRO_IN_EPNUM); + + /* Check if write ready for a polling interval around 1ms */ + while (timeout-- && !Endpoint_IsReadWriteAllowed()) _delay_us(4); + if (!Endpoint_IsReadWriteAllowed()) return; } else #endif { Endpoint_SelectEndpoint(KEYBOARD_IN_EPNUM); - } - /* Check if Keyboard Endpoint Ready for Read/Write */ - while (--timeout && !Endpoint_IsReadWriteAllowed()) ; + /* Check if write ready for a polling interval around 10ms */ + while (timeout-- && !Endpoint_IsReadWriteAllowed()) _delay_us(40); + if (!Endpoint_IsReadWriteAllowed()) return; + } /* Write Keyboard Report Data */ #ifdef NKRO_ENABLE @@ -391,7 +396,7 @@ static void send_keyboard(report_keyboard_t *report) static void send_mouse(report_mouse_t *report) { #ifdef MOUSE_ENABLE - uint8_t timeout = 0; + uint8_t timeout = 255; if (USB_DeviceState != DEVICE_STATE_Configured) return; @@ -399,8 +404,9 @@ static void send_mouse(report_mouse_t *report) /* Select the Mouse Report Endpoint */ Endpoint_SelectEndpoint(MOUSE_IN_EPNUM); - /* Check if Mouse Endpoint Ready for Read/Write */ - while (--timeout && !Endpoint_IsReadWriteAllowed()) ; + /* Check if write ready for a polling interval around 10ms */ + while (timeout-- && !Endpoint_IsReadWriteAllowed()) _delay_us(40); + if (!Endpoint_IsReadWriteAllowed()) return; /* Write Mouse Report Data */ Endpoint_Write_Stream_LE(report, sizeof(report_mouse_t), NULL); @@ -412,7 +418,7 @@ static void send_mouse(report_mouse_t *report) static void send_system(uint16_t data) { - uint8_t timeout = 0; + uint8_t timeout = 255; if (USB_DeviceState != DEVICE_STATE_Configured) return; @@ -422,14 +428,18 @@ static void send_system(uint16_t data) .usage = data }; Endpoint_SelectEndpoint(EXTRAKEY_IN_EPNUM); - while (--timeout && !Endpoint_IsReadWriteAllowed()) ; + + /* Check if write ready for a polling interval around 10ms */ + while (timeout-- && !Endpoint_IsReadWriteAllowed()) _delay_us(40); + if (!Endpoint_IsReadWriteAllowed()) return; + Endpoint_Write_Stream_LE(&r, sizeof(report_extra_t), NULL); Endpoint_ClearIN(); } static void send_consumer(uint16_t data) { - uint8_t timeout = 0; + uint8_t timeout = 255; if (USB_DeviceState != DEVICE_STATE_Configured) return; @@ -439,7 +449,11 @@ static void send_consumer(uint16_t data) .usage = data }; Endpoint_SelectEndpoint(EXTRAKEY_IN_EPNUM); - while (--timeout && !Endpoint_IsReadWriteAllowed()) ; + + /* Check if write ready for a polling interval around 10ms */ + while (timeout-- && !Endpoint_IsReadWriteAllowed()) _delay_us(40); + if (!Endpoint_IsReadWriteAllowed()) return; + Endpoint_Write_Stream_LE(&r, sizeof(report_extra_t), NULL); Endpoint_ClearIN(); } From 3c5add5f800daaeaf0abc28eae8b3c244bcc1126 Mon Sep 17 00:00:00 2001 From: tmk Date: Thu, 24 Apr 2014 11:26:06 +0900 Subject: [PATCH 36/48] Change LUFA build options --- keyboard/hhkb/Makefile | 2 +- protocol/lufa.mk | 10 +++++++--- protocol/lufa/descriptor.c | 4 ++-- 3 files changed, 10 insertions(+), 6 deletions(-) diff --git a/keyboard/hhkb/Makefile b/keyboard/hhkb/Makefile index 89d05ba1..0a256874 100644 --- a/keyboard/hhkb/Makefile +++ b/keyboard/hhkb/Makefile @@ -102,7 +102,7 @@ ARCH = AVR8 F_USB = $(F_CPU) # Interrupt driven control endpoint task -OPT_DEFS += -DINTERRUPT_CONTROL_ENDPOINT +#OPT_DEFS += -DINTERRUPT_CONTROL_ENDPOINT # Boot Section Size in *bytes* diff --git a/protocol/lufa.mk b/protocol/lufa.mk index 3489f19c..10a922f9 100644 --- a/protocol/lufa.mk +++ b/protocol/lufa.mk @@ -2,6 +2,7 @@ LUFA_DIR = protocol/lufa # Path to the LUFA library LUFA_PATH ?= protocol/lufa/LUFA-120730 +#LUFA_PATH ?= protocol/lufa/LUFA-130901 # Create the LUFA source path variables by including the LUFA makefile ifneq (, $(wildcard $(TOP_DIR)/$(LUFA_PATH)/LUFA/Build/lufa_sources.mk)) @@ -30,9 +31,12 @@ VPATH += $(TOP_DIR)/$(LUFA_PATH) #endif # LUFA library compile-time options and predefined tokens -LUFA_OPTS = -D USB_DEVICE_ONLY -LUFA_OPTS += -D USE_FLASH_DESCRIPTORS -LUFA_OPTS += -D USE_STATIC_OPTIONS="(USB_DEVICE_OPT_FULLSPEED | USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL)" +LUFA_OPTS = -DUSB_DEVICE_ONLY +LUFA_OPTS += -DUSE_FLASH_DESCRIPTORS +LUFA_OPTS += -DUSE_STATIC_OPTIONS="(USB_DEVICE_OPT_FULLSPEED | USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL)" +#LUFA_OPTS += -DINTERRUPT_CONTROL_ENDPOINT +LUFA_OPTS += -DFIXED_CONTROL_ENDPOINT_SIZE=8 +LUFA_OPTS += -DFIXED_NUM_CONFIGURATIONS=1 OPT_DEFS += -DF_USB=$(F_USB)UL OPT_DEFS += -DARCH=ARCH_$(ARCH) diff --git a/protocol/lufa/descriptor.c b/protocol/lufa/descriptor.c index d97f5d86..d88b5965 100644 --- a/protocol/lufa/descriptor.c +++ b/protocol/lufa/descriptor.c @@ -235,7 +235,7 @@ const USB_Descriptor_Device_t PROGMEM DeviceDescriptor = .SubClass = USB_CSCP_NoDeviceSubclass, .Protocol = USB_CSCP_NoDeviceProtocol, - .Endpoint0Size = 8, + .Endpoint0Size = FIXED_CONTROL_ENDPOINT_SIZE, /* specified in config.h */ .VendorID = VENDOR_ID, @@ -246,7 +246,7 @@ const USB_Descriptor_Device_t PROGMEM DeviceDescriptor = .ProductStrIndex = 0x02, .SerialNumStrIndex = NO_DESCRIPTOR, - .NumberOfConfigurations = 1 + .NumberOfConfigurations = FIXED_NUM_CONFIGURATIONS }; /******************************************************************************* From 00e9a342df752f06888d3093110a703c70985128 Mon Sep 17 00:00:00 2001 From: tmk Date: Thu, 24 Apr 2014 11:27:33 +0900 Subject: [PATCH 37/48] Fix 'Shift Parentheses' example --- keyboard/hhkb/keymap_hasu.c | 91 +++++++++++-------------------------- 1 file changed, 27 insertions(+), 64 deletions(-) diff --git a/keyboard/hhkb/keymap_hasu.c b/keyboard/hhkb/keymap_hasu.c index 0297d3b7..2f6be63e 100644 --- a/keyboard/hhkb/keymap_hasu.c +++ b/keyboard/hhkb/keymap_hasu.c @@ -25,7 +25,7 @@ const uint8_t keymaps[][MATRIX_ROWS][MATRIX_COLS] PROGMEM = { KEYMAP(ESC, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, MINS,EQL, BSLS,GRV, \ TAB, Q, W, E, R, T, Y, U, I, O, P, LBRC,RBRC,BSPC, \ LCTL,A, S, D, F, G, H, J, K, L, FN3, QUOT,FN4, \ - FN5, Z, X, C, V, B, N, M, COMM,DOT, FN2, RSFT,FN1, \ + FN11,Z, X, C, V, B, N, M, COMM,DOT, FN2, RSFT,FN1, \ LGUI,LALT, FN6, RALT,RGUI), /* Layer 1: HHKB mode (HHKB Fn) @@ -131,12 +131,9 @@ const uint8_t keymaps[][MATRIX_ROWS][MATRIX_COLS] PROGMEM = { /* id for user defined functions */ enum function_id { LSHIFT_LPAREN, - RSHIFT_RPAREN, }; enum macro_id { - LSHIFT_PAREN, - RSHIFT_PAREN, HELLO, VOLUP, }; @@ -163,10 +160,7 @@ const uint16_t fn_actions[] PROGMEM = { // [8] = ACTION_LMOD_TAP_KEY(KC_LCTL, KC_BSPC), // LControl with tap Backspace // [9] = ACTION_LMOD_TAP_KEY(KC_LCTL, KC_ESC), // LControl with tap Esc - [11] = ACTION_FUNCTION_TAP(LSHIFT_LPAREN), // Function: LShift with tap '(' - [12] = ACTION_FUNCTION_TAP(RSHIFT_RPAREN), // Function: RShift with tap ')' -// [13] = ACTION_MACRO_TAP(LSHIFT_PAREN), // Macro: LShift with tap '(' -// [14] = ACTION_MACRO_TAP(RSHIFT_PAREN), // Macro: RShift with tap ')' + [11] = ACTION_FUNCTION_TAP(LSHIFT_LPAREN), // Function: LShift with tap '(' // [15] = ACTION_MACRO(HELLO), // Macro: say hello // [9] = ACTION_MACRO(VOLUP), // Macro: media key }; @@ -177,32 +171,13 @@ const uint16_t fn_actions[] PROGMEM = { */ const macro_t *action_get_macro(keyrecord_t *record, uint8_t id, uint8_t opt) { - keyevent_t event = record->event; - tap_t tap = record->tap; - switch (id) { - case LSHIFT_PAREN: - if (tap.count > 0 && !tap.interrupted) { - return (event.pressed ? - MACRO( D(LSHIFT), D(9), U(9), U(LSHIFT), END ) : MACRO_NONE); - } else { - return (event.pressed ? - MACRO( D(LSHIFT), END ) : MACRO( U(LSHIFT), END ) ); - } - case RSHIFT_PAREN: - if (tap.count > 0 && !tap.interrupted) { - return (event.pressed ? - MACRO( D(RSHIFT), D(0), U(0), U(RSHIFT), END ) : MACRO_NONE); - } else { - return (event.pressed ? - MACRO( D(RSHIFT), END ) : MACRO( U(RSHIFT), END ) ); - } case HELLO: - return (event.pressed ? + return (record->event.pressed ? MACRO( I(0), T(H), T(E), T(L), T(L), W(255), T(O), END ) : MACRO_NONE ); case VOLUP: - return (event.pressed ? + return (record->event.pressed ? MACRO( D(VOLU), U(VOLU), END ) : MACRO_NONE ); } @@ -216,48 +191,36 @@ const macro_t *action_get_macro(keyrecord_t *record, uint8_t id, uint8_t opt) */ void action_function(keyrecord_t *record, uint8_t id, uint8_t opt) { - keyevent_t event = record->event; - tap_t tap = record->tap; + if (record->event.pressed) dprint("P"); else dprint("R"); + dprintf("%d", record->tap.count); + if (record->tap.interrupted) dprint("i"); + dprint("\n"); switch (id) { case LSHIFT_LPAREN: - // LShft + tap '(' - // NOTE: cant use register_code to avoid conflicting with magic key bind - if (event.pressed) { - if (tap.count == 0 || tap.interrupted) { - //add_mods(MOD_BIT(KC_LSHIFT)); - layer_on(1); + // Shift parentheses example: LShft + tap '(' + // http://stevelosh.com/blog/2012/10/a-modern-space-cadet/#shift-parentheses + // http://geekhack.org/index.php?topic=41989.msg1304899#msg1304899 + if (record->event.pressed) { + if (record->tap.count > 0 && !record->tap.interrupted) { + if (record->tap.interrupted) { + dprint("tap interrupted\n"); + register_mods(MOD_BIT(KC_LSHIFT)); + } } else { - add_mods(MOD_BIT(KC_LSHIFT)); - add_key(KC_9); - send_keyboard_report(); - del_mods(MOD_BIT(KC_LSHIFT)); - del_key(KC_9); - send_keyboard_report(); + register_mods(MOD_BIT(KC_LSHIFT)); } } else { - if (tap.count == 0 || tap.interrupted) { - //del_mods(MOD_BIT(KC_LSHIFT)); - layer_off(1); - } - } - break; - case RSHIFT_RPAREN: - // RShift + tap ')' - if (event.pressed) { - if (tap.count == 0 || tap.interrupted) { - add_mods(MOD_BIT(KC_RSHIFT)); + if (record->tap.count > 0 && !(record->tap.interrupted)) { + add_weak_mods(MOD_BIT(KC_LSHIFT)); + send_keyboard_report(); + register_code(KC_9); + unregister_code(KC_9); + del_weak_mods(MOD_BIT(KC_LSHIFT)); + send_keyboard_report(); + record->tap.count = 0; // ad hoc: cancel tap } else { - add_mods(MOD_BIT(KC_RSHIFT)); - add_key(KC_0); - send_keyboard_report(); - del_mods(MOD_BIT(KC_RSHIFT)); - del_key(KC_0); - send_keyboard_report(); - } - } else { - if (tap.count == 0 || tap.interrupted) { - del_mods(MOD_BIT(KC_RSHIFT)); + unregister_mods(MOD_BIT(KC_LSHIFT)); } } break; From ad4cba172b2eea37697ca531016c4c3b4defaeb7 Mon Sep 17 00:00:00 2001 From: tmk Date: Fri, 25 Apr 2014 12:19:14 +0900 Subject: [PATCH 38/48] Move macro definitions from lufa.c to lufa.h --- protocol/lufa/lufa.c | 9 --------- protocol/lufa/lufa.h | 11 +++++++++++ 2 files changed, 11 insertions(+), 9 deletions(-) diff --git a/protocol/lufa/lufa.c b/protocol/lufa/lufa.c index 68119d5e..86e9f23d 100644 --- a/protocol/lufa/lufa.c +++ b/protocol/lufa/lufa.c @@ -184,15 +184,6 @@ void EVENT_USB_Device_StartOfFrame(void) /** Event handler for the USB_ConfigurationChanged event. * This is fired when the host sets the current configuration of the USB device after enumeration. */ -#if LUFA_VERSION_INTEGER < 0x120730 - /* old API 120219 */ - #define ENDPOINT_CONFIG(epnum, eptype, epdir, epsize, epbank) Endpoint_ConfigureEndpoint(epnum, eptype, epdir, epsize, epbank) -#else - /* new API >= 120730 */ - #define ENDPOINT_BANK_SINGLE 1 - #define ENDPOINT_BANK_DOUBLE 2 - #define ENDPOINT_CONFIG(epnum, eptype, epdir, epsize, epbank) Endpoint_ConfigureEndpoint((epdir) | (epnum) , eptype, epsize, epbank) -#endif void EVENT_USB_Device_ConfigurationChanged(void) { bool ConfigSuccess = true; diff --git a/protocol/lufa/lufa.h b/protocol/lufa/lufa.h index bcee060d..195123c0 100644 --- a/protocol/lufa/lufa.h +++ b/protocol/lufa/lufa.h @@ -66,4 +66,15 @@ typedef struct { uint16_t usage; } __attribute__ ((packed)) report_extra_t; + +#if LUFA_VERSION_INTEGER < 0x120730 + /* old API 120219 */ + #define ENDPOINT_CONFIG(epnum, eptype, epdir, epsize, epbank) Endpoint_ConfigureEndpoint(epnum, eptype, epdir, epsize, epbank) +#else + /* new API >= 120730 */ + #define ENDPOINT_BANK_SINGLE 1 + #define ENDPOINT_BANK_DOUBLE 2 + #define ENDPOINT_CONFIG(epnum, eptype, epdir, epsize, epbank) Endpoint_ConfigureEndpoint((epdir) | (epnum) , eptype, epsize, epbank) +#endif + #endif From fc3a20c534c370944b7471adc60b8982d586d69c Mon Sep 17 00:00:00 2001 From: tmk Date: Fri, 25 Apr 2014 12:52:47 +0900 Subject: [PATCH 39/48] Add LUFA git repository(release 140302) --- .gitmodules | 3 +++ protocol/lufa.mk | 8 ++++++-- protocol/lufa/LUFA-git | 1 + protocol/lufa/descriptor.c | 12 ++++++------ protocol/lufa/descriptor.h | 9 +++++++++ 5 files changed, 25 insertions(+), 8 deletions(-) create mode 160000 protocol/lufa/LUFA-git diff --git a/.gitmodules b/.gitmodules index 3e34a635..17a20dec 100644 --- a/.gitmodules +++ b/.gitmodules @@ -1,3 +1,6 @@ [submodule "protocol/usb_hid/USB_Host_Shield_2.0"] path = protocol/usb_hid/USB_Host_Shield_2.0 url = git@github.com:tmk/USB_Host_Shield_2.0.git +[submodule "protocol/lufa/LUFA-git"] + path = protocol/lufa/LUFA-git + url = https://github.com/abcminiuser/lufa.git diff --git a/protocol/lufa.mk b/protocol/lufa.mk index 10a922f9..48ce9ae8 100644 --- a/protocol/lufa.mk +++ b/protocol/lufa.mk @@ -1,8 +1,12 @@ LUFA_DIR = protocol/lufa # Path to the LUFA library -LUFA_PATH ?= protocol/lufa/LUFA-120730 -#LUFA_PATH ?= protocol/lufa/LUFA-130901 +ifeq (, $(wildcard $(TOP_DIR)/$(LUFA_DIR)/LUFA-git)) + LUFA_PATH ?= $(LUFA_DIR)/LUFA-120730 +else + LUFA_PATH ?= $(LUFA_DIR)/LUFA-git +endif + # Create the LUFA source path variables by including the LUFA makefile ifneq (, $(wildcard $(TOP_DIR)/$(LUFA_PATH)/LUFA/Build/lufa_sources.mk)) diff --git a/protocol/lufa/LUFA-git b/protocol/lufa/LUFA-git new file mode 160000 index 00000000..b6c18b2a --- /dev/null +++ b/protocol/lufa/LUFA-git @@ -0,0 +1 @@ +Subproject commit b6c18b2a7c544653efbe12a1d4e8ba65e7d83c35 diff --git a/protocol/lufa/descriptor.c b/protocol/lufa/descriptor.c index d88b5965..c13a81bd 100644 --- a/protocol/lufa/descriptor.c +++ b/protocol/lufa/descriptor.c @@ -230,7 +230,7 @@ const USB_Descriptor_Device_t PROGMEM DeviceDescriptor = { .Header = {.Size = sizeof(USB_Descriptor_Device_t), .Type = DTYPE_Device}, - .USBSpecification = VERSION_BCD(01.10), + .USBSpecification = VERSION_BCD(1,1,0), .Class = USB_CSCP_NoDeviceClass, .SubClass = USB_CSCP_NoDeviceSubclass, .Protocol = USB_CSCP_NoDeviceProtocol, @@ -292,7 +292,7 @@ const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = { .Header = {.Size = sizeof(USB_HID_Descriptor_HID_t), .Type = HID_DTYPE_HID}, - .HIDSpec = VERSION_BCD(01.11), + .HIDSpec = VERSION_BCD(1,1,1), .CountryCode = 0x00, .TotalReportDescriptors = 1, .HIDReportType = HID_DTYPE_Report, @@ -333,7 +333,7 @@ const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = { .Header = {.Size = sizeof(USB_HID_Descriptor_HID_t), .Type = HID_DTYPE_HID}, - .HIDSpec = VERSION_BCD(01.11), + .HIDSpec = VERSION_BCD(1,1,1), .CountryCode = 0x00, .TotalReportDescriptors = 1, .HIDReportType = HID_DTYPE_Report, @@ -375,7 +375,7 @@ const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = { .Header = {.Size = sizeof(USB_HID_Descriptor_HID_t), .Type = HID_DTYPE_HID}, - .HIDSpec = VERSION_BCD(01.11), + .HIDSpec = VERSION_BCD(1,1,1), .CountryCode = 0x00, .TotalReportDescriptors = 1, .HIDReportType = HID_DTYPE_Report, @@ -417,7 +417,7 @@ const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = { .Header = {.Size = sizeof(USB_HID_Descriptor_HID_t), .Type = HID_DTYPE_HID}, - .HIDSpec = VERSION_BCD(01.11), + .HIDSpec = VERSION_BCD(1,1,1), .CountryCode = 0x00, .TotalReportDescriptors = 1, .HIDReportType = HID_DTYPE_Report, @@ -469,7 +469,7 @@ const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor = { .Header = {.Size = sizeof(USB_HID_Descriptor_HID_t), .Type = HID_DTYPE_HID}, - .HIDSpec = VERSION_BCD(01.11), + .HIDSpec = VERSION_BCD(1,1,1), .CountryCode = 0x00, .TotalReportDescriptors = 1, .HIDReportType = HID_DTYPE_Report, diff --git a/protocol/lufa/descriptor.h b/protocol/lufa/descriptor.h index 9ee1c04d..e0acec80 100644 --- a/protocol/lufa/descriptor.h +++ b/protocol/lufa/descriptor.h @@ -159,4 +159,13 @@ uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue, const void** const DescriptorAddress) ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(3); + +/* new API */ +#if LUFA_VERSION_INTEGER < 0x140302 + #define VERSION_BCD(Major, Minor, Revision) \ + CPU_TO_LE16( ((Major & 0xFF) << 8) | \ + ((Minor & 0x0F) << 4) | \ + (Revision & 0x0F) ) +#endif + #endif From 2db27ecedd92f79b96b5e4db3d8d0fd4822d2de0 Mon Sep 17 00:00:00 2001 From: tmk Date: Fri, 25 Apr 2014 15:16:12 +0900 Subject: [PATCH 40/48] Fix description of pin usage --- converter/pc98_usb/README | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/converter/pc98_usb/README b/converter/pc98_usb/README index a010dee2..c9bdf3d8 100644 --- a/converter/pc98_usb/README +++ b/converter/pc98_usb/README @@ -20,7 +20,7 @@ Wiring: You can change this with editing config.h. Pin mini DIN MCU ---------------------------------- - 1 ~RST PD1 + 1 ~RST(TXD) PD3 2 GND GND 3 ~RDY PD4 4 RXD PD2 @@ -37,9 +37,6 @@ Protocol Signal: Asynchronous, Positive logic, 19200baud, Least bit first Frame format: 1-Start bit(Lo), 8-Data bits, Odd-Parity, 1-Stop bit -This converter uses software method for testing purpose. AVR UART engine will work better. - - Build Firmware From 62117e7ea77bf036e4e08bb02d682311e3c3d401 Mon Sep 17 00:00:00 2001 From: tmk Date: Fri, 25 Apr 2014 15:25:21 +0900 Subject: [PATCH 41/48] Change MCU setting to ATmega32U2 --- converter/sun_usb/Makefile | 3 ++- converter/sun_usb/matrix.c | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/converter/sun_usb/Makefile b/converter/sun_usb/Makefile index 73a83e93..35c4bb12 100644 --- a/converter/sun_usb/Makefile +++ b/converter/sun_usb/Makefile @@ -20,9 +20,10 @@ CONFIG_H = config.h # MCU name, you MUST set this to match the board you are using # type "make clean" after changing this, so all files will be rebuilt #MCU = at90usb162 # Teensy 1.0 -MCU = atmega32u4 # Teensy 2.0 +#MCU = atmega32u4 # Teensy 2.0 #MCU = at90usb646 # Teensy++ 1.0 #MCU = at90usb1286 # Teensy++ 2.0 +MCU = atmega32u2 # Processor frequency. diff --git a/converter/sun_usb/matrix.c b/converter/sun_usb/matrix.c index a61e3a2d..988622bc 100644 --- a/converter/sun_usb/matrix.c +++ b/converter/sun_usb/matrix.c @@ -63,6 +63,8 @@ uint8_t matrix_cols(void) void matrix_init(void) { + DDRD |= (1<<6); + PORTD |= (1<<6); debug_enable = true; serial_init(); From 5e3f2d2b2e5065a04495f2c55fae0849966b5d23 Mon Sep 17 00:00:00 2001 From: tmk Date: Fri, 25 Apr 2014 15:32:21 +0900 Subject: [PATCH 42/48] Make NKRO deafult when it is available - NKRO is used only when keyboard_protocol = 1(report) --- common/action_util.c | 6 ++-- common/command.c | 4 +-- common/host.c | 2 +- common/host.h | 3 ++ protocol/lufa/lufa.c | 55 ++++++++++++++++++------------------ protocol/pjrc/usb.c | 18 ++++++------ protocol/pjrc/usb_keyboard.c | 11 +++----- protocol/pjrc/usb_keyboard.h | 2 -- 8 files changed, 51 insertions(+), 50 deletions(-) diff --git a/common/action_util.c b/common/action_util.c index 99a3adaa..ebe7150d 100644 --- a/common/action_util.c +++ b/common/action_util.c @@ -67,7 +67,7 @@ void send_keyboard_report(void) { void add_key(uint8_t key) { #ifdef NKRO_ENABLE - if (keyboard_nkro) { + if (keyboard_nkro && keyboard_protocol) { add_key_bit(key); return; } @@ -78,7 +78,7 @@ void add_key(uint8_t key) void del_key(uint8_t key) { #ifdef NKRO_ENABLE - if (keyboard_nkro) { + if (keyboard_nkro && keyboard_protocol) { del_key_bit(key); return; } @@ -151,7 +151,7 @@ uint8_t has_anymod(void) uint8_t get_first_key(void) { #ifdef NKRO_ENABLE - if (keyboard_nkro) { + if (keyboard_nkro && keyboard_protocol) { uint8_t i = 0; for (; i < REPORT_BITS && !keyboard_report->nkro.bits[i]; i++) ; diff --git a/common/command.c b/common/command.c index f6f27695..d2f8eb83 100644 --- a/common/command.c +++ b/common/command.c @@ -301,13 +301,13 @@ static bool command_common(uint8_t code) case KC_S: print("\n\n----- Status -----\n"); print_val_hex8(host_keyboard_leds()); + print_val_hex8(keyboard_protocol); + print_val_hex8(keyboard_idle); #ifdef PROTOCOL_PJRC print_val_hex8(UDCON); print_val_hex8(UDIEN); print_val_hex8(UDINT); print_val_hex8(usb_keyboard_leds); - print_val_hex8(usb_keyboard_protocol); - print_val_hex8(usb_keyboard_idle_config); print_val_hex8(usb_keyboard_idle_count); #endif diff --git a/common/host.c b/common/host.c index 1eafef75..2e56971b 100644 --- a/common/host.c +++ b/common/host.c @@ -24,7 +24,7 @@ along with this program. If not, see . #ifdef NKRO_ENABLE -bool keyboard_nkro = false; +bool keyboard_nkro = true; #endif static host_driver_t *driver; diff --git a/common/host.h b/common/host.h index 8ff26298..a56e6c3b 100644 --- a/common/host.h +++ b/common/host.h @@ -32,6 +32,9 @@ extern "C" { extern bool keyboard_nkro; #endif +uint8_t keyboard_idle; +uint8_t keyboard_protocol; + /* host driver */ void host_set_driver(host_driver_t *driver); diff --git a/protocol/lufa/lufa.c b/protocol/lufa/lufa.c index 86e9f23d..a43a552a 100644 --- a/protocol/lufa/lufa.c +++ b/protocol/lufa/lufa.c @@ -52,8 +52,8 @@ #include "descriptor.h" #include "lufa.h" -static uint8_t idle_duration = 0; -static uint8_t protocol_report = 1; +uint8_t keyboard_idle = 0; +uint8_t keyboard_protocol = 1; static uint8_t keyboard_led_stats = 0; static report_keyboard_t keyboard_report_sent; @@ -290,21 +290,26 @@ void EVENT_USB_Device_ControlRequest(void) case HID_REQ_GetProtocol: if (USB_ControlRequest.bmRequestType == (REQDIR_DEVICETOHOST | REQTYPE_CLASS | REQREC_INTERFACE)) { - Endpoint_ClearSETUP(); - while (!(Endpoint_IsINReady())); - Endpoint_Write_8(protocol_report); - Endpoint_ClearIN(); - Endpoint_ClearStatusStage(); + if (USB_ControlRequest.wIndex == KEYBOARD_INTERFACE) { + Endpoint_ClearSETUP(); + while (!(Endpoint_IsINReady())); + Endpoint_Write_8(keyboard_protocol); + Endpoint_ClearIN(); + Endpoint_ClearStatusStage(); + } } break; case HID_REQ_SetProtocol: if (USB_ControlRequest.bmRequestType == (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE)) { - Endpoint_ClearSETUP(); - Endpoint_ClearStatusStage(); + if (USB_ControlRequest.wIndex == KEYBOARD_INTERFACE) { + Endpoint_ClearSETUP(); + Endpoint_ClearStatusStage(); - protocol_report = ((USB_ControlRequest.wValue & 0xFF) != 0x00); + keyboard_protocol = ((USB_ControlRequest.wValue & 0xFF) != 0x00); + clear_keyboard(); + } } break; @@ -314,7 +319,7 @@ void EVENT_USB_Device_ControlRequest(void) Endpoint_ClearSETUP(); Endpoint_ClearStatusStage(); - idle_duration = ((USB_ControlRequest.wValue & 0xFF00) >> 8); + keyboard_idle = ((USB_ControlRequest.wValue & 0xFF00) >> 8); } break; @@ -323,7 +328,7 @@ void EVENT_USB_Device_ControlRequest(void) { Endpoint_ClearSETUP(); while (!(Endpoint_IsINReady())); - Endpoint_Write_8(idle_duration); + Endpoint_Write_8(keyboard_idle); Endpoint_ClearIN(); Endpoint_ClearStatusStage(); } @@ -349,32 +354,28 @@ static void send_keyboard(report_keyboard_t *report) /* Select the Keyboard Report Endpoint */ #ifdef NKRO_ENABLE - if (keyboard_nkro) { + if (keyboard_nkro && keyboard_protocol) { + /* Report protocol - NKRO */ Endpoint_SelectEndpoint(NKRO_IN_EPNUM); /* Check if write ready for a polling interval around 1ms */ while (timeout-- && !Endpoint_IsReadWriteAllowed()) _delay_us(4); if (!Endpoint_IsReadWriteAllowed()) return; - } - else -#endif - { - Endpoint_SelectEndpoint(KEYBOARD_IN_EPNUM); - /* Check if write ready for a polling interval around 10ms */ - while (timeout-- && !Endpoint_IsReadWriteAllowed()) _delay_us(40); - if (!Endpoint_IsReadWriteAllowed()) return; - } - - /* Write Keyboard Report Data */ -#ifdef NKRO_ENABLE - if (keyboard_nkro) { + /* Write Keyboard Report Data */ Endpoint_Write_Stream_LE(report, NKRO_EPSIZE, NULL); } else #endif { - /* boot mode */ + /* Boot protocol */ + Endpoint_SelectEndpoint(KEYBOARD_IN_EPNUM); + + /* Check if write ready for a polling interval around 10ms */ + while (timeout-- && !Endpoint_IsReadWriteAllowed()) _delay_us(40); + if (!Endpoint_IsReadWriteAllowed()) return; + + /* Write Keyboard Report Data */ Endpoint_Write_Stream_LE(report, KEYBOARD_EPSIZE, NULL); } diff --git a/protocol/pjrc/usb.c b/protocol/pjrc/usb.c index 393b36f7..b09ad3f2 100644 --- a/protocol/pjrc/usb.c +++ b/protocol/pjrc/usb.c @@ -38,6 +38,7 @@ #include "sleep_led.h" #endif #include "suspend.h" +#include "action.h" #include "action_util.h" @@ -692,20 +693,20 @@ ISR(USB_GEN_vect) } /* TODO: should keep IDLE rate on each keyboard interface */ #ifdef NKRO_ENABLE - if (!keyboard_nkro && usb_keyboard_idle_config && (++div4 & 3) == 0) { + if (!keyboard_nkro && keyboard_idle && (++div4 & 3) == 0) { #else - if (usb_keyboard_idle_config && (++div4 & 3) == 0) { + if (keyboard_idle && (++div4 & 3) == 0) { #endif UENUM = KBD_ENDPOINT; if (UEINTX & (1<mods; UEDATX = 0; - uint8_t keys = usb_keyboard_protocol ? KBD_REPORT_KEYS : 6; + uint8_t keys = keyboard_protocol ? KBD_REPORT_KEYS : 6; for (uint8_t i=0; ikeys[i]; } @@ -901,13 +902,13 @@ ISR(USB_COM_vect) } if (bRequest == HID_GET_IDLE) { usb_wait_in_ready(); - UEDATX = usb_keyboard_idle_config; + UEDATX = keyboard_idle; usb_send_in(); return; } if (bRequest == HID_GET_PROTOCOL) { usb_wait_in_ready(); - UEDATX = usb_keyboard_protocol; + UEDATX = keyboard_protocol; usb_send_in(); return; } @@ -921,14 +922,15 @@ ISR(USB_COM_vect) return; } if (bRequest == HID_SET_IDLE) { - usb_keyboard_idle_config = (wValue >> 8); + keyboard_idle = (wValue >> 8); usb_keyboard_idle_count = 0; //usb_wait_in_ready(); usb_send_in(); return; } if (bRequest == HID_SET_PROTOCOL) { - usb_keyboard_protocol = wValue; + keyboard_protocol = wValue; + clear_keyboard(); //usb_wait_in_ready(); usb_send_in(); return; diff --git a/protocol/pjrc/usb_keyboard.c b/protocol/pjrc/usb_keyboard.c index de798fcc..c11995db 100644 --- a/protocol/pjrc/usb_keyboard.c +++ b/protocol/pjrc/usb_keyboard.c @@ -34,12 +34,12 @@ // protocol setting from the host. We use exactly the same report // either way, so this variable only stores the setting since we // are required to be able to report which setting is in use. -uint8_t usb_keyboard_protocol=1; +uint8_t keyboard_protocol=1; // the idle configuration, how often we send the report to the // host (ms * 4) even when it hasn't changed // Windows and Linux set 0 while OS X sets 6(24ms) by SET_IDLE request. -uint8_t usb_keyboard_idle_config=125; +uint8_t keyobard_idle=125; // count until idle timeout uint8_t usb_keyboard_idle_count=0; @@ -56,15 +56,12 @@ int8_t usb_keyboard_send_report(report_keyboard_t *report) int8_t result = 0; #ifdef NKRO_ENABLE - if (keyboard_nkro) + if (keyboard_nkro && keyboard_protocol) result = send_report(report, KBD2_ENDPOINT, 0, KBD2_SIZE); else #endif { - if (usb_keyboard_protocol) - result = send_report(report, KBD_ENDPOINT, 0, KBD_SIZE); - else - result = send_report(report, KBD_ENDPOINT, 0, 6); + result = send_report(report, KBD_ENDPOINT, 0, KBD_SIZE); } if (result) return result; diff --git a/protocol/pjrc/usb_keyboard.h b/protocol/pjrc/usb_keyboard.h index c362ca3b..9b798e9a 100644 --- a/protocol/pjrc/usb_keyboard.h +++ b/protocol/pjrc/usb_keyboard.h @@ -30,8 +30,6 @@ #include "host.h" -extern uint8_t usb_keyboard_protocol; -extern uint8_t usb_keyboard_idle_config; extern uint8_t usb_keyboard_idle_count; extern volatile uint8_t usb_keyboard_leds; From 22854eb71b84a10ebad0f85841f2b99d38e1da8c Mon Sep 17 00:00:00 2001 From: tmk Date: Sun, 27 Apr 2014 05:07:27 +0900 Subject: [PATCH 43/48] NKRO is disable when SET_PROTOCOL(boot) - Command can force to enable NKRO even when boot mode - After boot keyboard may be in boot mode due to BIOS' request --- common/action_util.c | 6 +++--- protocol/lufa/lufa.c | 5 ++++- protocol/pjrc/usb.c | 3 +++ protocol/pjrc/usb_keyboard.c | 2 +- 4 files changed, 11 insertions(+), 5 deletions(-) diff --git a/common/action_util.c b/common/action_util.c index ebe7150d..99a3adaa 100644 --- a/common/action_util.c +++ b/common/action_util.c @@ -67,7 +67,7 @@ void send_keyboard_report(void) { void add_key(uint8_t key) { #ifdef NKRO_ENABLE - if (keyboard_nkro && keyboard_protocol) { + if (keyboard_nkro) { add_key_bit(key); return; } @@ -78,7 +78,7 @@ void add_key(uint8_t key) void del_key(uint8_t key) { #ifdef NKRO_ENABLE - if (keyboard_nkro && keyboard_protocol) { + if (keyboard_nkro) { del_key_bit(key); return; } @@ -151,7 +151,7 @@ uint8_t has_anymod(void) uint8_t get_first_key(void) { #ifdef NKRO_ENABLE - if (keyboard_nkro && keyboard_protocol) { + if (keyboard_nkro) { uint8_t i = 0; for (; i < REPORT_BITS && !keyboard_report->nkro.bits[i]; i++) ; diff --git a/protocol/lufa/lufa.c b/protocol/lufa/lufa.c index a43a552a..db05702a 100644 --- a/protocol/lufa/lufa.c +++ b/protocol/lufa/lufa.c @@ -308,6 +308,9 @@ void EVENT_USB_Device_ControlRequest(void) Endpoint_ClearStatusStage(); keyboard_protocol = ((USB_ControlRequest.wValue & 0xFF) != 0x00); +#ifdef NKRO_ENABLE + keyboard_nkro = !!keyboard_protocol; +#endif clear_keyboard(); } } @@ -354,7 +357,7 @@ static void send_keyboard(report_keyboard_t *report) /* Select the Keyboard Report Endpoint */ #ifdef NKRO_ENABLE - if (keyboard_nkro && keyboard_protocol) { + if (keyboard_nkro) { /* Report protocol - NKRO */ Endpoint_SelectEndpoint(NKRO_IN_EPNUM); diff --git a/protocol/pjrc/usb.c b/protocol/pjrc/usb.c index b09ad3f2..2b267d48 100644 --- a/protocol/pjrc/usb.c +++ b/protocol/pjrc/usb.c @@ -930,6 +930,9 @@ ISR(USB_COM_vect) } if (bRequest == HID_SET_PROTOCOL) { keyboard_protocol = wValue; +#ifdef NKRO_ENABLE + keyboard_nkro = !!keyboard_protocol; +#endif clear_keyboard(); //usb_wait_in_ready(); usb_send_in(); diff --git a/protocol/pjrc/usb_keyboard.c b/protocol/pjrc/usb_keyboard.c index c11995db..d1683318 100644 --- a/protocol/pjrc/usb_keyboard.c +++ b/protocol/pjrc/usb_keyboard.c @@ -56,7 +56,7 @@ int8_t usb_keyboard_send_report(report_keyboard_t *report) int8_t result = 0; #ifdef NKRO_ENABLE - if (keyboard_nkro && keyboard_protocol) + if (keyboard_nkro) result = send_report(report, KBD2_ENDPOINT, 0, KBD2_SIZE); else #endif From 37cf2607648a40bbac0b37f7e0838f240e66450a Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 28 Apr 2014 08:55:07 +0900 Subject: [PATCH 44/48] Check if LUFA-git really exists(Fix #118) --- protocol/lufa.mk | 2 +- protocol/lufa/descriptor.h | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/protocol/lufa.mk b/protocol/lufa.mk index 48ce9ae8..ac70ac03 100644 --- a/protocol/lufa.mk +++ b/protocol/lufa.mk @@ -1,7 +1,7 @@ LUFA_DIR = protocol/lufa # Path to the LUFA library -ifeq (, $(wildcard $(TOP_DIR)/$(LUFA_DIR)/LUFA-git)) +ifeq (, $(wildcard $(TOP_DIR)/$(LUFA_DIR)/LUFA-git/LUFA/Version.h)) LUFA_PATH ?= $(LUFA_DIR)/LUFA-120730 else LUFA_PATH ?= $(LUFA_DIR)/LUFA-git diff --git a/protocol/lufa/descriptor.h b/protocol/lufa/descriptor.h index e0acec80..a2db4bfd 100644 --- a/protocol/lufa/descriptor.h +++ b/protocol/lufa/descriptor.h @@ -162,6 +162,7 @@ uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue, /* new API */ #if LUFA_VERSION_INTEGER < 0x140302 + #undef VERSION_BCD #define VERSION_BCD(Major, Minor, Revision) \ CPU_TO_LE16( ((Major & 0xFF) << 8) | \ ((Minor & 0x0F) << 4) | \ From 110eea578b561f7169ea19927c54533c2b93b3a3 Mon Sep 17 00:00:00 2001 From: tmk Date: Mon, 28 Apr 2014 15:21:42 +0900 Subject: [PATCH 45/48] Fix remotewakeup of PJRC stack(Fix #121) - without this fix wakeup often fails - keyboard can wakeup once or twice but fails after that --- protocol/pjrc/usb.c | 1 + 1 file changed, 1 insertion(+) diff --git a/protocol/pjrc/usb.c b/protocol/pjrc/usb.c index 2b267d48..1e6ba871 100644 --- a/protocol/pjrc/usb.c +++ b/protocol/pjrc/usb.c @@ -629,6 +629,7 @@ uint8_t usb_configured(void) void usb_remote_wakeup(void) { UDCON |= (1< Date: Tue, 29 Apr 2014 19:42:24 +0900 Subject: [PATCH 46/48] Add Makefiles for TMK converters. --- converter/ps2_usb/Makefile | 7 +- converter/ps2_usb/Makefile.jis | 75 -------------- converter/ps2_usb/Makefile.tmk_rev1 | 98 +++++++++++++++++++ converter/ps2_usb/Makefile.tmk_rev2 | 98 +++++++++++++++++++ converter/ps2_usb/README.md | 73 ++++++++------ converter/ps2_usb/config_tmk_rev1.h | 147 ++++++++++++++++++++++++++++ converter/ps2_usb/config_tmk_rev2.h | 86 ++++++++++++++++ 7 files changed, 475 insertions(+), 109 deletions(-) delete mode 100644 converter/ps2_usb/Makefile.jis create mode 100644 converter/ps2_usb/Makefile.tmk_rev1 create mode 100644 converter/ps2_usb/Makefile.tmk_rev2 create mode 100644 converter/ps2_usb/config_tmk_rev1.h create mode 100644 converter/ps2_usb/config_tmk_rev2.h diff --git a/converter/ps2_usb/Makefile b/converter/ps2_usb/Makefile index db0912eb..1dd23c15 100644 --- a/converter/ps2_usb/Makefile +++ b/converter/ps2_usb/Makefile @@ -1,3 +1,6 @@ +# +# Makefile for Teensy +# # Target file name (without extension). TARGET = ps2_usb_lufa @@ -59,7 +62,7 @@ ARCH = AVR8 F_USB = $(F_CPU) # Interrupt driven control endpoint task(+60) -OPT_DEFS += -DINTERRUPT_CONTROL_ENDPOINT +#OPT_DEFS += -DINTERRUPT_CONTROL_ENDPOINT # Boot Section Size in *bytes* @@ -68,7 +71,7 @@ OPT_DEFS += -DINTERRUPT_CONTROL_ENDPOINT # Atmel DFU loader 4096 # LUFA bootloader 4096 # USBaspLoader 2048 -OPT_DEFS += -DBOOTLOADER_SIZE=4096 +OPT_DEFS += -DBOOTLOADER_SIZE=512 # Build Options diff --git a/converter/ps2_usb/Makefile.jis b/converter/ps2_usb/Makefile.jis deleted file mode 100644 index 4e091e8e..00000000 --- a/converter/ps2_usb/Makefile.jis +++ /dev/null @@ -1,75 +0,0 @@ -# Target file name (without extension). -TARGET = ps2_usb_jis - -# Directory common source filess exist -TOP_DIR = ../.. - -# Directory keyboard dependent files exist -TARGET_DIR = . - - -# MCU name, you MUST set this to match the board you are using -# type "make clean" after changing this, so all files will be rebuilt -#MCU = at90usb162 # Teensy 1.0 -MCU = atmega32u4 # Teensy 2.0 -#MCU = at90usb646 # Teensy++ 1.0 -#MCU = at90usb1286 # Teensy++ 2.0 - - -# Processor frequency. -# Normally the first thing your program should do is set the clock prescaler, -# so your program will run at the correct speed. You should also set this -# variable to same clock speed. The _delay_ms() macro uses this, and many -# examples use this variable to calculate timings. Do not add a "UL" here. -F_CPU = 16000000 - - -# Build Options -# *Comment out* to disable the options. -# -MOUSEKEY_ENABLE = yes # Mouse keys -EXTRAKEY_ENABLE = yes # Audio control and System control -NKRO_ENABLE = yes # USB Nkey Rollover - -#PS2_USE_USART = yes # uses hardware USART engine for PS/2 signal receive(recomened) -#PS2_USE_INT = yes # uses external interrupt for falling edge of PS/2 clock pin -PS2_USE_BUSYWAIT = yes # uses primitive reference code - - -# keyboard dependent files -SRC = keymap_jis.c \ - matrix.c \ - led.c - - -ifdef PS2_USE_USART - SRC += protocol/ps2_usart.c - OPT_DEFS += -DPS2_USE_USART -endif -ifdef PS2_USE_INT - SRC += protocol/ps2.c - OPT_DEFS += -DPS2_USE_INT -endif -ifdef PS2_USE_BUSYWAIT - SRC += protocol/ps2.c - OPT_DEFS += -DPS2_USE_BUSYWAIT -endif - - -#CONFIG_H = config_pjrc_usart.h -CONFIG_H = config.h - - -#---------------- Programming Options -------------------------- -PROGRAM_CMD = teensy_loader_cli -mmcu=$(MCU) -w -v $(TARGET).hex - - -# Search Path -VPATH += $(TARGET_DIR) -VPATH += $(TOP_DIR) - - -include $(TOP_DIR)/protocol/pjrc.mk -include $(TOP_DIR)/protocol.mk -include $(TOP_DIR)/common.mk -include $(TOP_DIR)/rules.mk diff --git a/converter/ps2_usb/Makefile.tmk_rev1 b/converter/ps2_usb/Makefile.tmk_rev1 new file mode 100644 index 00000000..59c44f75 --- /dev/null +++ b/converter/ps2_usb/Makefile.tmk_rev1 @@ -0,0 +1,98 @@ +# +# Makefile for TMK keyboard converter rev2 +# https://github.com/tmk/keyboard_converter#pcb-rev1 +# +# Target file name (without extension). +TARGET = ps2_usb_tmk_rev1 + +# Directory common source filess exist +TOP_DIR = ../.. + +# Directory keyboard dependent files exist +TARGET_DIR = . + +# project specific files +SRC = keymap_common.c \ + matrix.c \ + led.c + +ifdef KEYMAP + SRC := keymap_$(KEYMAP).c $(SRC) +else + SRC := keymap_plain.c $(SRC) +endif + +CONFIG_H = config_tmk_rev1.h + + +# MCU name +MCU = atmega32u4 + +# Processor frequency. +# This will define a symbol, F_CPU, in all source code files equal to the +# processor frequency in Hz. You can then use this symbol in your source code to +# calculate timings. Do NOT tack on a 'UL' at the end, this will be done +# automatically to create a 32-bit value in your source code. +# +# This will be an integer division of F_USB below, as it is sourced by +# F_USB after it has run through any CPU prescalers. Note that this value +# does not *change* the processor frequency - it should merely be updated to +# reflect the processor speed set externally so that the code can use accurate +# software delays. +F_CPU = 16000000 + + +# +# LUFA specific +# +# Target architecture (see library "Board Types" documentation). +ARCH = AVR8 + +# Input clock frequency. +# This will define a symbol, F_USB, in all source code files equal to the +# input clock frequency (before any prescaling is performed) in Hz. This value may +# differ from F_CPU if prescaling is used on the latter, and is required as the +# raw input clock is fed directly to the PLL sections of the AVR for high speed +# clock generation for the USB and other AVR subsections. Do NOT tack on a 'UL' +# at the end, this will be done automatically to create a 32-bit value in your +# source code. +# +# If no clock division is performed on the input clock inside the AVR (via the +# CPU clock adjust registers or the clock division fuses), this will be equal to F_CPU. +F_USB = $(F_CPU) + + +# Boot Section Size in *bytes* +# Teensy halfKay 512 +# Teensy++ halfKay 1024 +# Atmel DFU loader 4096 +# LUFA bootloader 4096 +# USBaspLoader 2048 +OPT_DEFS += -DBOOTLOADER_SIZE=4096 + + +# Build Options +# comment out to disable the options. +# +#BOOTMAGIC_ENABLE = yes # Virtual DIP switch configuration(+1000) +MOUSEKEY_ENABLE = yes # Mouse keys(+4700) +EXTRAKEY_ENABLE = yes # Audio control and System control(+450) +CONSOLE_ENABLE = yes # Console for debug(+400) +COMMAND_ENABLE = yes # Commands for debug and configuration +#NKRO_ENABLE = yes # USB Nkey Rollover - not yet supported in LUFA + + +# PS/2 Options +# +PS2_USE_USART = yes # uses hardware USART engine for PS/2 signal receive(recomened) +#PS2_USE_BUSYWAIT = yes # uses primitive reference code + + +# Search Path +VPATH += $(TARGET_DIR) +VPATH += $(TOP_DIR) + +include $(TOP_DIR)/protocol.mk +include $(TOP_DIR)/protocol/lufa.mk +include $(TOP_DIR)/common.mk +include $(TOP_DIR)/rules.mk diff --git a/converter/ps2_usb/Makefile.tmk_rev2 b/converter/ps2_usb/Makefile.tmk_rev2 new file mode 100644 index 00000000..bad958c3 --- /dev/null +++ b/converter/ps2_usb/Makefile.tmk_rev2 @@ -0,0 +1,98 @@ +# +# Makefile for TMK keyboard converter rev2 +# https://github.com/tmk/keyboard_converter#pcb-rev2 +# +# Target file name (without extension). +TARGET = ps2_usb_tmk_rev2 + +# Directory common source filess exist +TOP_DIR = ../.. + +# Directory keyboard dependent files exist +TARGET_DIR = . + +# project specific files +SRC = keymap_common.c \ + matrix.c \ + led.c + +ifdef KEYMAP + SRC := keymap_$(KEYMAP).c $(SRC) +else + SRC := keymap_plain.c $(SRC) +endif + +CONFIG_H = config_tmk_rev2.h + + +# MCU name +MCU = atmega32u2 + +# Processor frequency. +# This will define a symbol, F_CPU, in all source code files equal to the +# processor frequency in Hz. You can then use this symbol in your source code to +# calculate timings. Do NOT tack on a 'UL' at the end, this will be done +# automatically to create a 32-bit value in your source code. +# +# This will be an integer division of F_USB below, as it is sourced by +# F_USB after it has run through any CPU prescalers. Note that this value +# does not *change* the processor frequency - it should merely be updated to +# reflect the processor speed set externally so that the code can use accurate +# software delays. +F_CPU = 16000000 + + +# +# LUFA specific +# +# Target architecture (see library "Board Types" documentation). +ARCH = AVR8 + +# Input clock frequency. +# This will define a symbol, F_USB, in all source code files equal to the +# input clock frequency (before any prescaling is performed) in Hz. This value may +# differ from F_CPU if prescaling is used on the latter, and is required as the +# raw input clock is fed directly to the PLL sections of the AVR for high speed +# clock generation for the USB and other AVR subsections. Do NOT tack on a 'UL' +# at the end, this will be done automatically to create a 32-bit value in your +# source code. +# +# If no clock division is performed on the input clock inside the AVR (via the +# CPU clock adjust registers or the clock division fuses), this will be equal to F_CPU. +F_USB = $(F_CPU) + + +# Boot Section Size in *bytes* +# Teensy halfKay 512 +# Teensy++ halfKay 1024 +# Atmel DFU loader 4096 +# LUFA bootloader 4096 +# USBaspLoader 2048 +OPT_DEFS += -DBOOTLOADER_SIZE=4096 + + +# Build Options +# comment out to disable the options. +# +#BOOTMAGIC_ENABLE = yes # Virtual DIP switch configuration(+1000) +MOUSEKEY_ENABLE = yes # Mouse keys(+4700) +EXTRAKEY_ENABLE = yes # Audio control and System control(+450) +CONSOLE_ENABLE = yes # Console for debug(+400) +COMMAND_ENABLE = yes # Commands for debug and configuration +#NKRO_ENABLE = yes # USB Nkey Rollover - not yet supported in LUFA + + +# PS/2 Options +# +PS2_USE_INT = yes # uses external interrupt for falling edge of PS/2 clock pin +#PS2_USE_BUSYWAIT = yes # uses primitive reference code + + +# Search Path +VPATH += $(TARGET_DIR) +VPATH += $(TOP_DIR) + +include $(TOP_DIR)/protocol.mk +include $(TOP_DIR)/protocol/lufa.mk +include $(TOP_DIR)/common.mk +include $(TOP_DIR)/rules.mk diff --git a/converter/ps2_usb/README.md b/converter/ps2_usb/README.md index 8f06fdd0..537e92e6 100644 --- a/converter/ps2_usb/README.md +++ b/converter/ps2_usb/README.md @@ -1,11 +1,50 @@ PS/2 to USB keyboard converter ============================== -This firmware converts PS/2 keyboard protocol to USB and supports only Scan Code Set 2. +This firmware converts PS/2 keyboard protocol to USB.(It supports Scan Code Set 2.) + + +Connect Wires +------------- +In case of Teensy2.0(ATMega32U4): + +1. Connect **Vcc** and **GND**. +2. Connect **Clock** and **Data** line. + - **Interrupt**: **Clock** is on `PD1` and **Data** on `PD0`.(Recommended. Soarer's converter compatible) + - **Busywait**: **Clock** is on `PD1` and **Data** on `PD0`. + - **USART**: **Clock** is on `PD5` and **Data** on `PD2`. +3. Optionally you need pull-up register. 1K-10K Ohm is OK. + +To change pin configuration edit config.h. + + +Build Firmware +-------------- +For **PJRC Teensy** just run `make`: + + $ make clean + $ make + +To select keymap: + + $ make clean + $ make KEYMAP=[plain|jis|spacefn|...] + +After that you will find HEX file `ps2_usb_lufa.hex` in current directory. + + +- For **TMK converter Rev.1** use `make -f Makefile.tmk_rev1` instead of `make` and HEX file is `ps2_usb_tmk_rev1.hex`. + +- For **TMK converter Rev.2** use `make -f Makefile.tmk_rev2` instead of `make` and HEX file is `ps2_usb_tmk_rev2.hex`. + + +Keymap +------ +Several version of keymap are available in advance but you are recommended to define your favorite layout yourself. To define your own keymap create file named `keymap_.c` and see keymap document(you can find in README.md of top directory) and existent keymap files. PS/2 signal handling implementations ------------------------------------ -Following three methods are used to implement PS/2 signal handling. +Following three methods can be used to implement PS/2 signal handling. ### Simple and stupid busy-wait(ps2_busywait.c) This is expected to implemented with portable C code for reference. @@ -17,36 +56,6 @@ Following three methods are used to implement PS/2 signal handling. To select method edit Makefile. -Connect Wires -------------- -In case of Teensy2.0(ATMega32U4): - -1. Connect Vcc and GND. -2. Connect Clock and Data line. - - Busywait: Clock is on PD5 and Data on PD2. - - Interrupt: Clock is on PD1 and Data on PD2. - - USART: Clock is on PD5 and Data on PD2. -3. Optionally you need pull-up register. 1K-10K Ohm is OK. - -To change pin configuration edit config.h. - - -Build Firmware --------------- -Just run `make`: - - $ make - -To select keymap: - - $ make KEYMAP=[plain|jis|spacefn|...] - - -Keymap ------- -Several version of keymap are available in advance but you are recommended to define your favorite layout yourself. To define your own keymap create file named `keymap_.c` and see keymap document(you can find in top README.md) and existent keymap files. - - V-USB Support ------------- You can also use this converter on ATmega(168/328) with V-USB instead of Teensy. diff --git a/converter/ps2_usb/config_tmk_rev1.h b/converter/ps2_usb/config_tmk_rev1.h new file mode 100644 index 00000000..75dc97df --- /dev/null +++ b/converter/ps2_usb/config_tmk_rev1.h @@ -0,0 +1,147 @@ +/* +Copyright 2012 Jun Wako + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#ifndef CONFIG_H +#define CONFIG_H + +#include + +#define VENDOR_ID 0xFEED +#define PRODUCT_ID 0x6512 +#define DEVICE_VER 0x0001 +#define MANUFACTURER t.m.k. +#define PRODUCT PS/2 keyboard converter +#define DESCRIPTION convert PS/2 keyboard to USB + + +/* matrix size */ +#define MATRIX_ROWS 32 // keycode bit: 3-0 +#define MATRIX_COLS 8 // keycode bit: 6-4 + + +/* key combination for command */ +#define IS_COMMAND() ( \ + keyboard_report->mods == (MOD_BIT(KC_LSHIFT) | MOD_BIT(KC_RSHIFT)) || \ + keyboard_report->mods == (MOD_BIT(KC_LCTRL) | MOD_BIT(KC_RSHIFT)) \ +) + + +//#define NO_SUSPEND_POWER_DOWN + + +/* + * PS/2 Busywait + */ +#ifdef PS2_USE_BUSYWAIT +#define PS2_CLOCK_PORT PORTD +#define PS2_CLOCK_PIN PIND +#define PS2_CLOCK_DDR DDRD +#define PS2_CLOCK_BIT 5 +#define PS2_DATA_PORT PORTD +#define PS2_DATA_PIN PIND +#define PS2_DATA_DDR DDRD +#define PS2_DATA_BIT 2 +#endif + +/* + * PS/2 USART + */ +#ifdef PS2_USE_USART +#if defined(__AVR_ATmega16U4__) || defined(__AVR_ATmega32U4__) +/* XCK for clock line and RXD for data line */ +#define PS2_CLOCK_PORT PORTD +#define PS2_CLOCK_PIN PIND +#define PS2_CLOCK_DDR DDRD +#define PS2_CLOCK_BIT 5 +#define PS2_DATA_PORT PORTD +#define PS2_DATA_PIN PIND +#define PS2_DATA_DDR DDRD +#define PS2_DATA_BIT 2 +/* synchronous, odd parity, 1-bit stop, 8-bit data, sample at falling edge */ +/* set DDR of CLOCK as input to be slave */ +#define PS2_USART_INIT() do { \ + PS2_CLOCK_DDR &= ~(1< + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +*/ + +#ifndef CONFIG_H +#define CONFIG_H + +#include + +#define VENDOR_ID 0xFEED +#define PRODUCT_ID 0x6512 +#define DEVICE_VER 0x0001 +#define MANUFACTURER t.m.k. +#define PRODUCT PS/2 keyboard converter +#define DESCRIPTION convert PS/2 keyboard to USB + + +/* matrix size */ +#define MATRIX_ROWS 32 // keycode bit: 3-0 +#define MATRIX_COLS 8 // keycode bit: 6-4 + + +/* key combination for command */ +#define IS_COMMAND() ( \ + keyboard_report->mods == (MOD_BIT(KC_LSHIFT) | MOD_BIT(KC_RSHIFT)) || \ + keyboard_report->mods == (MOD_BIT(KC_LCTRL) | MOD_BIT(KC_RSHIFT)) \ +) + + +//#define NO_SUSPEND_POWER_DOWN + + +/* + * PS/2 Busywait + */ +#ifdef PS2_USE_BUSYWAIT +#define PS2_CLOCK_PORT PORTD +#define PS2_CLOCK_PIN PIND +#define PS2_CLOCK_DDR DDRD +#define PS2_CLOCK_BIT 1 +#define PS2_DATA_PORT PORTD +#define PS2_DATA_PIN PIND +#define PS2_DATA_DDR DDRD +#define PS2_DATA_BIT 0 +#endif + +/* + * PS/2 Pin interrupt + */ +#ifdef PS2_USE_INT +/* uses INT1 for clock line(ATMega32U4) */ +#define PS2_CLOCK_PORT PORTD +#define PS2_CLOCK_PIN PIND +#define PS2_CLOCK_DDR DDRD +#define PS2_CLOCK_BIT 1 +#define PS2_DATA_PORT PORTD +#define PS2_DATA_PIN PIND +#define PS2_DATA_DDR DDRD +#define PS2_DATA_BIT 0 +#define PS2_INT_INIT() do { \ + EICRA |= ((1< Date: Tue, 29 Apr 2014 19:45:01 +0900 Subject: [PATCH 47/48] Unused endpoint of console OUT is commentout'd --- protocol/lufa/descriptor.h | 6 +++++- protocol/lufa/lufa.c | 2 ++ 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/protocol/lufa/descriptor.h b/protocol/lufa/descriptor.h index a2db4bfd..42af0791 100644 --- a/protocol/lufa/descriptor.h +++ b/protocol/lufa/descriptor.h @@ -137,13 +137,17 @@ typedef struct #ifdef CONSOLE_ENABLE # define CONSOLE_IN_EPNUM (EXTRAKEY_IN_EPNUM + 1) -# define CONSOLE_OUT_EPNUM (EXTRAKEY_IN_EPNUM + 2) +# define CONSOLE_OUT_EPNUM (EXTRAKEY_IN_EPNUM + 1) +//# define CONSOLE_OUT_EPNUM (EXTRAKEY_IN_EPNUM + 2) #else # define CONSOLE_OUT_EPNUM EXTRAKEY_IN_EPNUM #endif #ifdef NKRO_ENABLE # define NKRO_IN_EPNUM (CONSOLE_OUT_EPNUM + 1) +# if defined(__AVR_ATmega32U2__) && NKRO_IN_EPNUM > 4 +# error "Endpoints are not available enough to support all functions. Remove some in Makefile.(MOUSEKEY, EXTRAKEY, CONSOLE, NKRO)" +# endif #endif diff --git a/protocol/lufa/lufa.c b/protocol/lufa/lufa.c index db05702a..9f8e50c4 100644 --- a/protocol/lufa/lufa.c +++ b/protocol/lufa/lufa.c @@ -208,9 +208,11 @@ void EVENT_USB_Device_ConfigurationChanged(void) /* Setup Console HID Report Endpoints */ ConfigSuccess &= ENDPOINT_CONFIG(CONSOLE_IN_EPNUM, EP_TYPE_INTERRUPT, ENDPOINT_DIR_IN, CONSOLE_EPSIZE, ENDPOINT_BANK_DOUBLE); +#if 0 ConfigSuccess &= ENDPOINT_CONFIG(CONSOLE_OUT_EPNUM, EP_TYPE_INTERRUPT, ENDPOINT_DIR_OUT, CONSOLE_EPSIZE, ENDPOINT_BANK_SINGLE); #endif +#endif #ifdef NKRO_ENABLE /* Setup NKRO HID Report Endpoints */ From abe5edcaa7c6391cb313a672910d7beb9b7d8fa2 Mon Sep 17 00:00:00 2001 From: tmk Date: Tue, 29 Apr 2014 19:46:37 +0900 Subject: [PATCH 48/48] Fix set LED for NKRO keyboard interface --- protocol/lufa/lufa.c | 1 + 1 file changed, 1 insertion(+) diff --git a/protocol/lufa/lufa.c b/protocol/lufa/lufa.c index 9f8e50c4..d60aecc3 100644 --- a/protocol/lufa/lufa.c +++ b/protocol/lufa/lufa.c @@ -272,6 +272,7 @@ void EVENT_USB_Device_ControlRequest(void) // Interface switch (USB_ControlRequest.wIndex) { case KEYBOARD_INTERFACE: + case NKRO_INTERFACE: Endpoint_ClearSETUP(); while (!(Endpoint_IsOUTReceived())) {