From bc47b562ff48cf704295fa10da5637469cec6d80 Mon Sep 17 00:00:00 2001
From: CrazyRedMachine <crazyredmachine86@gmail.com>
Date: Sat, 8 Aug 2020 23:22:10 +0200
Subject: [PATCH] ezusb driver and optional devicepath.dat

---
 ModeSwitch/C/modeswitch.exe     | Bin 247272 -> 247344 bytes
 ModeSwitch/C/src/CMakeLists.txt |   9 +-
 ModeSwitch/C/src/modeswitch.cpp |  72 +++++++--
 ModeSwitch/readme.md            |   2 +
 README.md                       |   6 +
 ezusb/ezusb-popn15.dll          | Bin 0 -> 10752 bytes
 ezusb/ezusb.dll                 | Bin 0 -> 10752 bytes
 ezusb/readme.md                 |  19 +++
 ezusb/src/CMakeLists.txt        |  12 ++
 ezusb/src/ezusb.cpp             | 273 ++++++++++++++++++++++++++++++++
 ezusb/src/ezusb.h               |  37 +++++
 ezusb/src/lib/hid.lib           | Bin 0 -> 12158 bytes
 12 files changed, 405 insertions(+), 25 deletions(-)
 create mode 100644 ezusb/ezusb-popn15.dll
 create mode 100644 ezusb/ezusb.dll
 create mode 100644 ezusb/readme.md
 create mode 100644 ezusb/src/CMakeLists.txt
 create mode 100644 ezusb/src/ezusb.cpp
 create mode 100644 ezusb/src/ezusb.h
 create mode 100644 ezusb/src/lib/hid.lib

diff --git a/ModeSwitch/C/modeswitch.exe b/ModeSwitch/C/modeswitch.exe
index b3d540f724c1d2c844a1b19e859f3a4bd30e3a49..7920046286a2db98a746083e977afcbe861419ac 100644
GIT binary patch
delta 21176
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
ORK6Tq9&VFf(EUFs^EFZc

delta 20716
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
bdzy6L%jkJh`jQ%5TBIdz#x-q{QTP7<zYX$w

diff --git a/ModeSwitch/C/src/CMakeLists.txt b/ModeSwitch/C/src/CMakeLists.txt
index b09a0bc..c1ba740 100644
--- a/ModeSwitch/C/src/CMakeLists.txt
+++ b/ModeSwitch/C/src/CMakeLists.txt
@@ -7,11 +7,4 @@ set (CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -static-libstdc++ -static-libgcc")
 include_directories(${popn_modeswitch_SOURCE_DIR})
 link_directories(${PROJECT_SOURCE_DIR}/include)
 
-# STATIC LINK HID
-find_library(HIDDLL NAMES hid PATHS ${CMAKE_SOURCE_DIR}/lib)
-message(STATUS "find_library for hid returned ${HIDDLL}")
-add_library(hid MODULE IMPORTED)
-set_property(TARGET hid PROPERTY IMPORTED_LOCATION "${HIDDLL}")
-
-add_executable(modeswitch modeswitch.cpp)
-target_link_libraries(modeswitch hid)
\ No newline at end of file
+add_executable(modeswitch modeswitch.cpp)
\ No newline at end of file
diff --git a/ModeSwitch/C/src/modeswitch.cpp b/ModeSwitch/C/src/modeswitch.cpp
index 7a65dd1..f03caad 100644
--- a/ModeSwitch/C/src/modeswitch.cpp
+++ b/ModeSwitch/C/src/modeswitch.cpp
@@ -1,13 +1,61 @@
 /* TO BE COMPILED WITH MINGW */
 /* Visual C++ compilation didn't work for me on the BemaniPC (invalid win32 application) */
+#define WINVER 0x0500
 #include <windows.h>
 #include <fstream>
 
+HANDLE   g_hidHandle;
+
+/**
+ * Initialize the g_hidHandle global variable
+ * It will attempt to read paths from devicepath.dat file if it exists until it finds one which works.
+ * If nothing is found, as a last resort it will try the two default paths from the Due and Leonardo
+ * versions of the firmware.
+ *
+ * @return 0 on success, -1 on error
+ */
+static int controller_init(){
+    FILE *file;
+    char  path[256];
+    
+    file = fopen("devicepath.dat", "r");
+    if (file == NULL)
+    {
+        goto last_resort;
+    }
+
+    while ( fgets(path,256,file) != NULL )
+    {
+        path[strcspn(path, "\r\n")] = 0;
+        g_hidHandle = CreateFile(path, GENERIC_READ|GENERIC_WRITE, FILE_SHARE_READ|FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL);
+        if ( g_hidHandle != INVALID_HANDLE_VALUE )
+            break;
+    }
+    fclose(file);
+
+    if ( g_hidHandle == INVALID_HANDLE_VALUE )
+    {
+        goto last_resort;
+    }
+    return 0;
+
+last_resort:
+    g_hidHandle = CreateFile("\\\\?\\HID#VID_2341&PID_003E&MI_02#7&3156e204&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030}",
+                             GENERIC_READ|GENERIC_WRITE, FILE_SHARE_READ|FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL);
+    if ( g_hidHandle != INVALID_HANDLE_VALUE )
+        return 0;
+
+    g_hidHandle = CreateFile("\\\\?\\HID#VID_2341&PID_8036&MI_02#7&63200bf&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030}",
+                             GENERIC_READ|GENERIC_WRITE, FILE_SHARE_READ|FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL);
+    if ( g_hidHandle != INVALID_HANDLE_VALUE )
+        return 0;
+
+    printf("Couldn't open device. Make sure devicepath.dat exists and contains the correct path.\r\n");
+    return -1;
+}
+
 int main(int argc, char* argv[])
 {
-    FILE    *file;
-    char     path[256];
-    HANDLE   hidHandle;
     char     OutputReport[5];
     int      res;
     int      mode;
@@ -25,18 +73,8 @@ int main(int argc, char* argv[])
         printf("Invalid mode value %d\r\n", mode);
         return 2;
     }
-
-    file = fopen("devicepath.dat", "r");
-    while ( fgets(path,256,file) != NULL )
-    {
-        path[strcspn(path, "\r\n")] = 0;
-        hidHandle = CreateFile(path, GENERIC_READ|GENERIC_WRITE, FILE_SHARE_READ|FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL);
-        if ( hidHandle != INVALID_HANDLE_VALUE )
-            break;
-    }
-    fclose(file);
-
-    if ( hidHandle == INVALID_HANDLE_VALUE )
+    
+    if ( controller_init() == -1 )
     {
         printf("Couldn't open device. Make sure devicepath.dat contains the correct path.\r\n");
         return 3;
@@ -48,7 +86,7 @@ int main(int argc, char* argv[])
     OutputReport[3] = 0x00;
     OutputReport[4] = mode+16;  //mode+magicbit
 
-    WriteFile(hidHandle, OutputReport, 5, &BytesWritten, NULL);
+    WriteFile(g_hidHandle, OutputReport, 5, &BytesWritten, NULL);
     if ( BytesWritten == 5 )
     {
         res = 0;
@@ -74,6 +112,6 @@ int main(int argc, char* argv[])
         res = 4;
     }
 
-    CloseHandle(hidHandle);
+    CloseHandle(g_hidHandle);
     return res;
 }
diff --git a/ModeSwitch/readme.md b/ModeSwitch/readme.md
index ef1e1b0..4efe56c 100644
--- a/ModeSwitch/readme.md
+++ b/ModeSwitch/readme.md
@@ -38,6 +38,8 @@ The included devicepath.dat should work with both Due and Leonardo versions out
 
 devicepath.dat file should contain the device path on its own on a single line. Multiple paths on multiple lines should work too in which case it will open the first valid path it finds.
 
+If no valid path is found or if there is no `devicepath.dat` file, it will attempt to open the default paths from the Due and Leonardo versions (same as the ones found in this included devicepath file).
+ 
 ### spicetools
 
 open ```%appdata%/spicetools.xml```, look for a "devid" value starting with ```\\?\HID#VID_2341&amp;PID_003E``` (Due) or ```\\?\HID#VID_2341&amp;PID_8036``` (Leonardo)
diff --git a/README.md b/README.md
index 27870f9..78efa9b 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,12 @@ The 00 key is mapped to comma (for direct compatibility with spicetools) and the
 
 It also has a cool light animation on boot which you can easily adapt to your liking :)
 
+## ezusb driver
+
+The I/O is HID so it can be mapped with the usual IO emulation tools, but it can also be used without emulation, just like an official IOBoard, provided you replace the original `ezusb.dll` file with the one from this repo.
+
+This way the firmware is fully compatible with anything that works on an official cabinet (PopnForwarder (a bit silly but why not :D), DJMame...)
+
 ## Light modes
 
 There are 4 different modes :
diff --git a/ezusb/ezusb-popn15.dll b/ezusb/ezusb-popn15.dll
new file mode 100644
index 0000000000000000000000000000000000000000..1583f47ad485e4e5a3821a015e16b4ba806114dd
GIT binary patch
literal 10752
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
amt(hMpM!IGTp?GlYp3fmyxIMEo__}vVC&WZ

literal 0
HcmV?d00001

diff --git a/ezusb/ezusb.dll b/ezusb/ezusb.dll
new file mode 100644
index 0000000000000000000000000000000000000000..bd339aaeb67ed5cebe9655b09cc9a6be3fc7c086
GIT binary patch
literal 10752
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
J?EW&(e*;VEEwTUr

literal 0
HcmV?d00001

diff --git a/ezusb/readme.md b/ezusb/readme.md
new file mode 100644
index 0000000..cdbb4ba
--- /dev/null
+++ b/ezusb/readme.md
@@ -0,0 +1,19 @@
+# ezusb.dll for the Pop'n Ultimate Controller
+
+This is a dll meant to seamlessly replace the original one from the different games (and compatible with both the PopnForwarder and DJMame, or really anything else meant to be used with ezusb.dll).
+
+For ease of use I included pre-compiled dll working on WinXP Embedded (for official Pop'n Music cabinets).
+
+## Usage
+
+Replace the game ezusb.dll file with this one and the game will read input and send lights to your Arduino as if it were the original IOBoard.
+
+Pop'n Music Adventure used a different dll format so you have to set a flag in `ezusb.h` for the dll to compile in a way that will work with this game.
+
+The dll makes the lights turn on for 1 sec on load so you'll know if the game managed to load your device.
+
+## How to retrieve devicepath
+
+The dll will attempt to open the default paths from the Due and Leonardo versions of this firmware, in case it doesn't work you can put a `devicepath.dat` file in the same folder as the dll.
+
+See instructions from ModeSwitch to know more about the path format and how to find the one corresponding to your device.
\ No newline at end of file
diff --git a/ezusb/src/CMakeLists.txt b/ezusb/src/CMakeLists.txt
new file mode 100644
index 0000000..420948e
--- /dev/null
+++ b/ezusb/src/CMakeLists.txt
@@ -0,0 +1,12 @@
+cmake_minimum_required(VERSION 3.14)
+project(UltimatePopnController-ezusb)
+
+set(CMAKE_CXX_STANDARD 14)
+
+include_directories(${ezusb_SOURCE_DIR})
+link_directories(${PROJECT_SOURCE_DIR}/include)
+link_directories(${PROJECT_SOURCE_DIR}/lib)
+
+add_library(ezusb SHARED ezusb.cpp ezusb.h)
+target_link_libraries(ezusb hid)
+SET_TARGET_PROPERTIES(ezusb PROPERTIES PREFIX "")
diff --git a/ezusb/src/ezusb.cpp b/ezusb/src/ezusb.cpp
new file mode 100644
index 0000000..3a486f2
--- /dev/null
+++ b/ezusb/src/ezusb.cpp
@@ -0,0 +1,273 @@
+/* TO BE COMPILED WITH VISUAL STUDIO SO THAT EXPORTS ARE PROPERLY MANGLED */
+#define _CRT_SECURE_NO_WARNINGS
+#include <Windows.h>
+extern "C" {
+// This file is in the Windows DDK available from Microsoft.
+#include <hidsdi.h>
+}
+#include <cstdint>
+#include <fstream>
+#include "ezusb.h"
+
+HANDLE   g_hid_handle;
+
+/**
+ * Initialize the g_hid_handle global variable
+ * It will attempt to read paths from devicepath.dat file if it exists until it finds one which works.
+ * If nothing is found, as a last resort it will try the two default paths from the Due and Leonardo
+ * versions of the firmware.
+ *
+ * @return 0 on success, -1 on error
+ */
+static int controller_init(){
+    FILE *file;
+    char  path[256];
+
+    file = fopen("devicepath.dat", "r");
+    if (file == NULL)
+    {
+        goto last_resort;
+    }
+
+    while ( fgets(path,256,file) != NULL )
+    {
+        path[strcspn(path, "\r\n")] = 0;
+        g_hid_handle = CreateFile(path, GENERIC_READ|GENERIC_WRITE, FILE_SHARE_READ|FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL);
+        if ( g_hid_handle != INVALID_HANDLE_VALUE )
+            break;
+    }
+    fclose(file);
+
+    if ( g_hid_handle == INVALID_HANDLE_VALUE )
+    {
+        goto last_resort;
+    }
+    return 0;
+
+last_resort:
+    g_hid_handle = CreateFile("\\\\?\\HID#VID_2341&PID_003E&MI_02#7&3156e204&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030}",
+                              GENERIC_READ|GENERIC_WRITE, FILE_SHARE_READ|FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL);
+    if ( g_hid_handle != INVALID_HANDLE_VALUE )
+        return 0;
+
+    g_hid_handle = CreateFile("\\\\?\\HID#VID_2341&PID_8036&MI_02#7&63200bf&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030}",
+                              GENERIC_READ|GENERIC_WRITE, FILE_SHARE_READ|FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL);
+    if ( g_hid_handle != INVALID_HANDLE_VALUE )
+        return 0;
+
+    printf("Couldn't open device. Make sure devicepath.dat exists and contains the correct path.\r\n");
+    return -1;
+}
+
+/**
+ * Read buttons state from the Arduino and convert them into Pop'n Music format
+ *
+ * Pop'n Music processes button states as a uint32_t bitfield with the following format :
+ * bits 0 (LSB) to 5 : nothing
+ * bit 6 : service
+ * bit 7 : test
+ * bits 8 to 16 : buttons 1 to 9
+ * bit 22 : coin mech
+ *
+ * @param pad_bits[out] button state bitfield
+ * @return 0 on success, -1 on error
+ */
+static int controller_read_buttons(uint32_t *pad_bits){
+    DWORD	      BytesRead = 0;
+    byte          res[4];
+    unsigned char buf[6]; // gamepad report length is 3 bytes in Arduino firmware, doubled because NumInputBuffer is set to 2
+
+    buf[0] = 0x04; // gamepad report ID is 4 in Arduino firmware
+    *pad_bits = 0;
+
+    ReadFile(g_hid_handle, buf, 6, &BytesRead, NULL);
+    // BytesRead should either be 6 (if it successfully read 2 reports) or 3 (only one)
+    if ( BytesRead != 6 && BytesRead != 3 )
+    {
+        return -1;
+    }
+
+    /* HID read ok, convert latest report bytes to pop'n bitfield */
+    res[3] = 0;
+    res[2] = (buf[BytesRead-1]<<3 | buf[BytesRead-1]) & 0x41;
+    res[1] = buf[BytesRead-2];
+    res[0] = 0;
+    buf[BytesRead-1] >>= 1;
+    if ( buf[BytesRead-1]&1 ) res[0] |= 0x80;
+    buf[BytesRead-1] >>= 1;
+    if ( buf[BytesRead-1]&1 ) res[0] |= 0x40;
+    *pad_bits = *(uint32_t *)res;
+#ifdef DEBUG
+    for (int i = 0; i<32; i++){
+        printf("%c",( ((uint32_t )*pad_bits>>(31-i))&1)?'1':'0');
+        if (((i+1)%4)==0) printf(" ");
+    }
+    printf("\n");
+#endif
+    return 0;
+}
+
+/**
+ * Read lights state and send the corresponding HID report to the Arduino
+ *
+ * Pop'n Music sends lights state as a int32_t bitfield with the following format :
+ * bits 0 (LSB) to 4 : neons from top to bottom
+ * bits 8 to 11 : side lamps (left blue, left red, right blue, right red)
+ * bits 23 to 31 : button lamps from left to right
+ *
+ * @param lamp_bits[in] lamp state bitfield
+ * @return 0 on success, -1 on error
+ */
+static int controller_write_leds(int32_t lamp_bits){
+    DWORD	 BytesWritten = 0;
+    byte    *src = (byte*) &lamp_bits; //cast as byte array for fast conversion
+    byte     buf[5]; // HID lights report length is 5 bytes in Arduino firmware
+
+    /* convert bitfield into HID Report format */
+    buf[4] = 0;
+    buf[3] = (src[1] >> 2);
+    buf[2] = (src[1] << 6) | (src[0] << 1) | (src[3] >> 7);
+    buf[1] = (src[3] << 1) | (src[2] >> 7);
+    buf[0] = 0x05; // HID lights report id is 5 in Arduino firmware
+
+    /* send HID Report */
+    WriteFile(g_hid_handle, buf, 5, &BytesWritten, NULL);
+    if ( BytesWritten == 5 )
+        return 0;
+
+#ifdef DEBUG
+    printf("Error sending HID report (%u bytes written)\r\n",BytesWritten);
+#endif
+    return -1;
+}
+
+
+/* EZUSB EXPORTS */
+
+#if POPN15_FORMAT == 1
+extern "C" {
+#endif
+
+__declspec(dllexport) int __cdecl usbCheckAlive() {
+    return 1;
+}
+
+__declspec(dllexport) int __cdecl usbCheckSecurityNew(int i) {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbCoinGet(int i) {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbCoinMode(int i) {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbEnd() {
+    CloseHandle(g_hid_handle);
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbFirmResult() {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbGetKEYID(unsigned char *a, int i) {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbGetSecurity(int i, unsigned char *a) {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbLamp(int32_t lamp_bits) {
+    return controller_write_leds(lamp_bits);
+}
+
+__declspec(dllexport) int __cdecl usbPadRead(unsigned long *pad_bits) {
+    return controller_read_buttons((uint32_t *)pad_bits);
+}
+
+__declspec(dllexport) int __cdecl usbPadReadLast(uint8_t *a1) {
+    memset(a1, 0, 4);
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbSecurityInit() {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbSecurityInitDone() {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbSecuritySearch() {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbSecuritySearchDone() {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbSecuritySelect(int i) {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbSecuritySelectDone() {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbSetExtIo(int i) {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbStart(int i) {
+    if (controller_init() == -1)
+    {
+        printf("Could not init device.\n");
+        return  -1;
+    }
+
+    bool hidres = HidD_SetNumInputBuffers(
+            g_hid_handle,
+            2);
+    if (!hidres)
+    {
+        printf("error %d setnuminputbuff\n",GetLastError());
+        return -1;
+    }
+
+    /* light everything for 1 sec to get visual confirmation
+     * the device is working */
+    controller_write_leds((uint32_t) 0xFFFFFFFF);
+    Sleep(1000);
+    controller_write_leds((uint32_t) 0x00000000);
+
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbWdtReset() {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbWdtStart(int i) {
+    return 0;
+}
+
+__declspec(dllexport) int __cdecl usbWdtStartDone() {
+    return 0;
+}
+
+#if POPN15_FORMAT == 1
+}
+#endif
+
+int __stdcall DllMain(HINSTANCE hinstDLL, DWORD fdwReason, void *) {
+    if (fdwReason == 1) {
+        //https://blogs.msdn.microsoft.com/larryosterman/2004/06/03/little-known-win32-apis-disablethreadlibrarycalls/
+        DisableThreadLibraryCalls(hinstDLL);
+    }
+
+    return 1;
+}
\ No newline at end of file
diff --git a/ezusb/src/ezusb.h b/ezusb/src/ezusb.h
new file mode 100644
index 0000000..0cc071a
--- /dev/null
+++ b/ezusb/src/ezusb.h
@@ -0,0 +1,37 @@
+#ifndef EZUSB_UPC_EZUSB_H
+#define EZUSB_UPC_EZUSB_H
+
+/* Pop'n Music Adventure ezusb.dll was compiled in C and thus used unmangled function names
+ * set this POPN15_FORMAT to 1 to compile a compatible version */
+#define POPN15_FORMAT 0
+
+#if POPN15_FORMAT == 1
+extern "C" {
+#endif
+__declspec(dllexport) int __cdecl usbCheckAlive();
+__declspec(dllexport) int __cdecl usbCheckSecurityNew(int i);
+__declspec(dllexport) int __cdecl usbCoinGet(int i);
+__declspec(dllexport) int __cdecl usbCoinMode(int i);
+__declspec(dllexport) int __cdecl usbEnd();
+__declspec(dllexport) int __cdecl usbFirmResult();
+__declspec(dllexport) int __cdecl usbGetKEYID(unsigned char *a, int i);
+__declspec(dllexport) int __cdecl usbGetSecurity(int i, unsigned char *a);
+__declspec(dllexport) int __cdecl usbLamp(int32_t lamp_bits);
+__declspec(dllexport) int __cdecl usbPadRead(unsigned long *pad_bits);
+__declspec(dllexport) int __cdecl usbPadReadLast(uint8_t *a1);
+__declspec(dllexport) int __cdecl usbSecurityInit();
+__declspec(dllexport) int __cdecl usbSecurityInitDone();
+__declspec(dllexport) int __cdecl usbSecuritySearch();
+__declspec(dllexport) int __cdecl usbSecuritySearchDone();
+__declspec(dllexport) int __cdecl usbSecuritySelect(int i);
+__declspec(dllexport) int __cdecl usbSecuritySelectDone();
+__declspec(dllexport) int __cdecl usbSetExtIo(int i);
+__declspec(dllexport) int __cdecl usbStart(int i);
+__declspec(dllexport) int __cdecl usbWdtReset();
+__declspec(dllexport) int __cdecl usbWdtStart(int i);
+__declspec(dllexport) int __cdecl usbWdtStartDone();
+#if POPN15_FORMAT == 1
+}
+#endif
+
+#endif //EZUSB_UPC_EZUSB_H
\ No newline at end of file
diff --git a/ezusb/src/lib/hid.lib b/ezusb/src/lib/hid.lib
new file mode 100644
index 0000000000000000000000000000000000000000..2b5e74965cbf4bb0102db96c33fd7c35d66e8329
GIT binary patch
literal 12158
zcmcgy&2Jn<7Js%Al9&)o!sgrd`1>ny;_-}Qr0i;9Pd>cZj@Nc_U=hP)rfrYbnXzVi
zklD*h95|r8?TrIsFPso3xO2=RZKVAJRzjR|<cQz^zp9?sUDaLHb`OS@o_o69tM{vV
z{p!_w)gHKAte1BF)O{nRUo+`+Ha#~pH*-sGzu9_BzmabJe7Bp3{z`P=Euu><(dEyG
z20!tr?=q2~fd!AQzD*?QIqsk<-+R=1n@G^mF^^J@i3AOO=h5IO^nv<!JR0~C`apdj
zdX)MG@}QyjJnH=d`apd@cr*-Mg8IMpXk?y9(C{;l#`cH=O<whA>;;}dqaU;ga~uUt
ze&o>v<|F9(=N?S}OVISk9!<dxg2vzRX!J+)2aP}X=o)Y(t>X^5j<E>3anhsdi_ila
z`P8E+j73r>?wy6g(#qPy_02;5?#AN!(%R<3^}>UtJQWJ7kCvCCO!^179&hu(qt!PH
z`8%6;sPLdt&KDjyySugAJo;9i?iE69QsTbj;(otbDd#epn9g9?wYsxctT&u;zUUT1
ziqRv&mi_M49Y^QrP)0r@-f`V}<w?_Z8c{f%=V9$O8#{k#I!z}upL-gEwJ+AHTb1o*
zz35hI)!a-vY=S6X_S|sXC`Ylek<XZ`&8JJ%y{5a++}d*LhG`iD7}dbiVGRO|yW!L;
z#a#$Iaq1f|YIWN%VT%y!SSePUTg8&wtjFlE2(gZ}dac|nxz-^>`P_4<T6XrGGWVPd
zzpW^rd#>%g->8&|yLqQks#o^hTHP>ri;&cTH+s)0ig|}ShB%C9k;WoXIV>$5V%^!R
z)!ndu^ayi#L=T%T{K(u5!-}vOZKZMFsn(rXW0+;2VXc4>Ef)85$JJU{YN6@6wW^ez
zQD2r64l%jU#-3BEY*k7MJFNyV+1Db(Ivy8yn~num=W!2K7;x>Nx(sVru2lcFSliuo
zN+Oi3*2)N2T0D^hw@I;<yZf#KCoe0JEqzmQbE(84By}uRD=t=f<?oK?7WZoPrF<@=
z!!E?*c+@CvV*;~kK$O@DL(0O<lqNqGtrc{JuJ`VKE^1y+O^YSvA5|MR?O~RbUn%ZO
zCCinDyX;iA-JS3out;d5ldsn{^MJ{HHV{>uvcwITiXE_6j3V4W=y|7JFTS6fjVu(C
zgzU{GHsVH^+{ZW^WyI)d6yg4+@#x)660)~sh}V;^h`rCLmYlF}+C*gk&3dug*e$w_
zlxl3&mga9}(im-ZQ7*W&npmtA4kIr0;w8z1Ce&YT=GmL%U@^a0%E8Y>gW`yK2s81M
z=jgM3j(!74`db%>+)G5CAtV1}5Se-((ZT@H+sJyKgTB8)bi0@6*bvd<6w!CMk3w#z
zpXf`-eF*t)(Ec9Uzku8icz!%g^ey=FBSg>edv6Sx{Up%~+&@6Z-VOQ)&kGYopI=8m
z+&`YiIHri+87KM?{O7noyGFDQnup9u4E7>qK84N~kn04Yz@Srff=*I5y-vsJHTna+
zN*Cxfou!wkhtAM3dYR7AD|DVN(M7sWebh^%beXQw2#ryS2I&g*(+wJ?X_}yMnxp}`
zMng139n|@o>F#Rf*@omYK~f8s$;(YOl8iFPlrn(FX*-MA^B-dd0rx&2RkJ1ma=bCQ
zW?U)-SiKs++Ta=3bHBL6)Gu?S8mz`>a?YHHB_VB_2Uw;QO74S7dLmLAsF%&07xA+m
z7BKU;y&LR<@&kKdMrTf9l(C6zmdC<uxn0PCs@x!E%e{{~1<k?sr188YL2ptwaf~Yf
z^i6d@24aej-aO)V@JJX&gWX_Y29pcstTl(`%sgezhu&h08H*f%X+KPO1fbUUdMxrc
z=6t~zkrY1Ol#+I;8<r(H>3!9erE}mM9I13hG+u@I*762}wZtx6g*k%hGKTf93s|CA
zNa&!Wk@%|D65kXIKgua>@W^Pa)A^S7f}Zj7hCn3x`I=2JP-k)^)LZ>{s5e`pqAp~M
zjk=U^!G}bWl$b&AvXm^w>>KVG1eYL+=;M$Q_9DwzB?ZF?Rn+!~s(>2fs?PUAlDUF{
zSD4-*nh!EOL;{n9>nn|Ev=>W6>~)w3tV}T+hgFs+dZW?Uc)p4=*XjK7vY)gcbfTWQ
z#YgS$b}x5y(M;#brLGQS!^nJbbxfC?C(Z5Q4eycYkNELVerVlu)Uz;MDWk9$PBZIu
z{P+*(|E-2D+;epE>z3SHt6Adwq{xZ(9HqYQ#QhBNV{x5mO=^tJ^_;-7&?PRxJ+*&!
zrBbTb8nrDqHNHNPT3%XxQ*uLpPUBg06bevm$X`A9dtCl%AyBSVd%A})p4$Hx{rodS
z32AYOL3I*OHAf_exx+1TQUarkTQWih4dlyYgBH<_`p3V7cA~8REU^BJr=vM|?@sC&
z>C9Z~tBdfAPU#t6VL09}&7M(K1}}apo-xZT;Tiwtht^$qhR}PYZ~QRt67?kPYx#hY
z*kZT%J5{ij{s(|Ki^Z%Z-xGxUiM6C&%38{ByO8@YKeX;gX4%776IH(Xt4~r(W;iIN
z#CJZi5SKedWWrGauG6OKmRE3MKhI|PTceIO2&9ex%kZs;A(PH7%We{y9S%0&D?Gb!
z+S@i-%>24kv`E6%E@EchY*7*Hj;V-B3fMMQjHet|v4Uiup^ns3UQ)3l^#en;?uXu;
zvuU#>Q?TR-9Z{=D+QxgsjE7@2?9_^9nrj?}O>S9>$KaR_yS$2P`a;C8iLIM8&vpo?
z-70FdAYsVlGmWwE%POY1wrd}E);w1numV-FaQFzUeZ-i!^NNlbsz4dCbwB)SiLvb&
z713PNGHl{^nz5|X^RVr!J}#HZ43l_vG4|~7QBaQjE^+)d74Zn-cs6D&o>j4qaxKQJ
ziE}Du_`HE%VPa3o&X`vrK4swhg0~6{M;LA6Wh_2}fAYbX3<a-sD#AcXeKTWudm<q`
zui|ix&Opg67_-L3cNzaw*?e@<Htw7yXTwJ%eD_gsEvG>YoYb;eOMZioRQTeg;F^v(
z81zW3d|5*^9$B@I8<PiIG2sTsPB;Z)*u*xDS(R5+RQ;TY;gVaI3+qt+Ka6+UYsT}B
zo)|Rg9OEjgz6ho~%wnj-^UGM)s3^AkqgdW~V%unO)l^DF3w#Aflnj^Dj#<mxM20-z
zqgf9<88)#^<Eqp_AJ=q_%8-d?8snuyDx%?Jwq4A)ePr0jM2_?8_mP;mI-(*SZCs6s
zG@~l&?+|Im%y_?Pq#2K3{<=srXIYIiSd9}t)*(*f*<ll}%eYuK>5m|ExZgHfTsANj
LpqalH_^7`C`XVos

literal 0
HcmV?d00001