qthid-4.1-source/0000755000175000017500000000000012054762740012054 5ustar alcalcqthid-4.1-source/qthid.pro0000644000175000017500000000332212054762152013704 0ustar alcalc#------------------------------------------------- # # Qthid project file. # #------------------------------------------------- QT += core gui TEMPLATE = app macx { TARGET = Qthid } else { TARGET = qthid } # disable debug messages in release CONFIG(debug, debug|release) { # Define version string (see below for releases) VER = $$system(git describe --abbrev=8) } else { DEFINES += QT_NO_DEBUG DEFINES += QT_NO_DEBUG_OUTPUT VER = 4.1 } # Tip from: http://www.qtcentre.org/wiki/index.php?title=Version_numbering_using_QMake VERSTR = '\\"$${VER}\\"' # place quotes around the version string DEFINES += VERSION=\"$${VERSTR}\" # create a VERSION macro containing the version string SOURCES +=\ mainwindow.cpp \ main.cpp \ fcd.c \ freqctrl.cpp \ firmware.cpp mac: SOURCES += hidmac.c win32: SOURCES += hidwin.c HEADERS += \ mainwindow.h \ hidapi.h \ fcd.h fcdhidcmd.h \ freqctrl.h \ firmware.h FORMS += \ mainwindow.ui \ firmware.ui mac:LIBS += /System/Library/Frameworks/CoreFoundation.framework/CoreFoundation \ /System/Library/Frameworks/IOKit.framework/Versions/A/IOKit win32:LIBS += "C:\\Program Files\\Microsoft SDKs\\Windows\\v7.0\\Lib\\setupapi.lib" # libusb-1.0 on Linux uses pkg-config linux-g++|linux-g++-64 { # CONFIG += link_pkgconfig # PKGCONFIG += libusb-1.0 # SOURCES += hid-libusb.c LIBS += -ludev SOURCES += hidraw.c } RESOURCES += \ qthid.qrc win32 { # application icon on Windows RC_FILE = qthid.rc } else:macx { # app icon on OSX ICON = images/qthid.icns } OTHER_FILES += AUTHORS.txt LICENSE.txt NEWS.txt README.txt \ qthid.rc \ images/qthid.ico \ images/qthid.icns qthid-4.1-source/mainwindow.cpp0000644000175000017500000004033712054762152014740 0ustar alcalc/*************************************************************************** * This file is part of Qthid. * * Copyright (C) 2010 Howard Long, G6LVB * Copyright (C) 2011 Mario Lorenz, DL5MLO * Copyright (C) 2011-2012 Alexandru Csete, OZ9AEC * * * Qthid 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 3 of the License, or * (at your option) any later version. * * Qthid 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 Qthid. If not, see . * ***************************************************************************/ #include #include #include #include "mainwindow.h" #include "ui_mainwindow.h" #include "freqctrl.h" #include "firmware.h" #include "hidapi.h" #include "fcd.h" /* Flags used to select which settings to read so that we avoid polling all settings all the time */ #define DEV_SET_RFF (1 << 0) #define DEV_SET_LNA (1 << 1) #define DEV_SET_MIX (1 << 2) #define DEV_SET_IFF (1 << 3) #define DEV_SET_IFG (1 << 4) #define DEV_SET_BIAS (1 << 5) #define DEV_SET_ALL (DEV_SET_RFF | DEV_SET_LNA | DEV_SET_MIX | DEV_SET_IFF | DEV_SET_IFG | DEV_SET_BIAS) #define DEV_SET_RF (DEV_SET_RFF | DEV_SET_LNA) #define DEV_SET_IF (DEV_SET_IFF | DEV_SET_IFG) MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow), prevMode(FCD_MODE_NONE) { QSettings settings; ui->setupUi(this); setWindowTitle(tr("Qthid %1").arg(VERSION)); /* frequency correction */ ui->spinBoxCorr->setValue(settings.value("Correction","0").toInt()); /* LNB ofset */ lnbOffset = settings.value("LnbOffset","0").toInt(); // Stored as Hz ui->spinBoxLnb->setValue(lnbOffset/1.0e6); // Shown as MHz /* frequency controller */ if (lnbOffset < -150e3) ui->freqCtrl->Setup(11, 0, 2050e6+lnbOffset, 1, UNITS_MHZ); else ui->freqCtrl->Setup(11, 150e3+lnbOffset, 2050e6+lnbOffset, 1, UNITS_MHZ); ui->freqCtrl->SetFrequency(settings.value("Frequency", 144800000).toInt()+lnbOffset); /* FCD status label */ fcdStatus = new QLabel(tr("FCD status..."), this); fcdStatus->setAlignment(Qt::AlignRight); fcdStatus->setToolTip(tr("Funcube Dongle status can be No FCD, Application or Bootloader")); ui->statusBar->addPermanentWidget(fcdStatus); fwDialog = new CFirmware(this); connect(fwDialog, SIGNAL(finished(int)), this, SLOT(fwDialogFinished(int))); enableControls(); // will also readDevice() due to mode change //setUnifiedTitleAndToolBarOnMac(true); /* connect signals & slots */ connect(ui->freqCtrl, SIGNAL(NewFrequency(qint64)), this, SLOT(setNewFrequency(qint64))); timer = new QTimer(this); connect(timer, SIGNAL(timeout()), this, SLOT(enableControls())); timer->start(1000); } MainWindow::~MainWindow() { QSettings settings; timer->stop(); delete timer; settings.setValue("Frequency",ui->freqCtrl->GetFrequency()-lnbOffset); settings.setValue("Correction",ui->spinBoxCorr->value()); settings.setValue("LnbOffset", lnbOffset); /** TODO: LNA **/ /** TODO: mixer gain **/ /** TODO: Bias T **/ /** TODO: RF Filter **/ /** TODO: IF Filter **/ /** TODO: IF gain **/ delete ui; } /** \brief Read all parameters from FCD and update GUI. */ void MainWindow::readDevice(quint16 flags) { FCD_MODE_ENUM fme; tuner_rf_filter_t rf_filt; tuner_if_filter_t if_filt; char enabled; unsigned char value; bool error = false; /* Note: No need to block toggled() signals for check-buttons since we use the clicked() signals to catch actions. */ /* Bias T */ if (flags & DEV_SET_BIAS) { fme = fcdAppGetBiasTee(&enabled); if (fme == FCD_MODE_APP) { ui->biasTeeButton->setChecked(enabled ? true : false); } else { qDebug() << __func__ << ": Error reading Bias T setting."; error = true; } } /* LNA */ if (flags & DEV_SET_LNA) { fme = fcdAppGetLna(&enabled); if (fme == FCD_MODE_APP) { ui->lnaButton->setChecked(enabled ? true : false); } else { qDebug() << __func__ << ": Error reading LNA setting."; error = true; } } /* Mixer gain */ if (flags & DEV_SET_MIX) { fme = fcdAppGetMixerGain(&enabled); if (fme == FCD_MODE_APP) { ui->mixerButton->setChecked(enabled ? true : false); } else { qDebug() << __func__ << ": Error reading mixer setting."; error = true; } } /* RF filter */ if (flags & DEV_SET_RFF) { fme = fcdAppGetRfFilter(&rf_filt); if (fme == FCD_MODE_APP) { ui->rfFilterComboBox->setCurrentIndex(rf_filt); } else { qDebug() << __func__ << ": Error reading RF filter setting."; error = true; } } /* IF filter */ if (flags & DEV_SET_IFF) { fme = fcdAppGetIfFilter(&if_filt); if (fme == FCD_MODE_APP) { ui->ifFilterComboBox->setCurrentIndex(if_filt); } else { qDebug() << __func__ << ": Error reading IF filter setting."; error = true; } } /* IF gain */ if (flags & DEV_SET_IFG) { fme = fcdAppGetIfGain(&value); if (fme == FCD_MODE_APP) { ui->ifGainSpinBox->setValue(value); } else { qDebug() << __func__ << ": Error reading IF gain."; error = true; } } /* push a message to the status bar */ if (error) { qDebug() << "There were errors while reading settings from FCD"; ui->statusBar->showMessage(tr("Error reading settings from FCD"), 4000); } else { qDebug() << "Successfully read settings from FCD; flags:" << flags; } } /** \brief Convert a string to double */ double MainWindow::StrToDouble(QString s) { int i; QString s2=""; for (i=0;i='0' and c<='9') { s2+=c; } } s2=s2.left(10); return s2.toDouble(); } /** \brief Eanble/disable controls depending on FCD mode. * * This function reads the FCD mode and enables or disables the UI controls accordingly. * In case a mode change is detected to FCD_MODE_APP, readDevice() is called to read the * settings fromt he FCD. * \todo Combo boxes. */ void MainWindow::enableControls() { FCD_MODE_ENUM fme = FCD_MODE_NONE; char fwVerStr[6]; bool convOk = false; float fwVer = 0.0; fme = fcdGetMode(); switch (fme) { case FCD_MODE_APP: fcdGetFwVerStr(fwVerStr); fcdStatus->setText(tr("FCD is active (%1)").arg(QString(fwVerStr))); /* convert version string to float */ fwVer = QString(fwVerStr).toFloat(&convOk); break; case FCD_MODE_BL: fcdStatus->setText(tr("FCD bootloader")); break; case FCD_MODE_NONE: fcdStatus->setText(tr("No FCD detected")); break; } ui->freqCtrl->setEnabled(fme==FCD_MODE_APP); /** Bias T functionality available since FW 18h for FCD Pro and 20.01 for Pro+ */ ui->biasTeeButton->setEnabled((fme == FCD_MODE_APP) && (fwVer > 18.07)); ui->lnaButton->setEnabled(fme == FCD_MODE_APP); ui->mixerButton->setEnabled(fme == FCD_MODE_APP); ui->ifGainSpinBox->setEnabled(fme == FCD_MODE_APP); ui->spinBoxLnb->setEnabled(fme == FCD_MODE_APP); ui->spinBoxCorr->setEnabled(fme == FCD_MODE_APP); ui->actionDefault->setEnabled(fme==FCD_MODE_APP); /* manage FCD mode transitions */ if (fme != prevMode) { qDebug() << "FCD mode change:" << prevMode << "->" << fme; ui->statusBar->showMessage(tr("FCD mode change detected"), 3000); if (fme == FCD_MODE_APP) { /* if previous mode was different read settings from device */ readDevice(DEV_SET_ALL); /* Set frequency since FCD does not remember anything */ setNewFrequency(ui->freqCtrl->GetFrequency()); } } prevMode = fme; } /*! \brief Slot for receiving frequency change signals. * \param[in] freq The new frequency. * * This slot is connected to the CFreqCtrl::NewFrequency() signal and is used * to set new RF frequency. */ void MainWindow::setNewFrequency(qint64 freq) { FCD_MODE_ENUM fme; unsigned int uFreq, rFreq; double d = (double) (freq-lnbOffset); d *= 1.0 + ui->spinBoxCorr->value()/1000000.0; uFreq = (unsigned int) d; fme = fcdAppSetFreq(uFreq, &rFreq); qDebug() << "Set new frequency"; qDebug() << " Display:" << freq << "Hz"; qDebug() << " LNB offset:" << lnbOffset << "Hz"; qDebug() << " FCD set:" << uFreq << "Hz"; qDebug() << " FCD get:" << rFreq << "Hz"; if ((fme != FCD_MODE_APP) || (uFreq != rFreq)) { ui->statusBar->showMessage(tr("Failed to set frequency"), 2000); qDebug() << "Error in" << __func__ << "set:" << uFreq << "read:" << rFreq; } readDevice(DEV_SET_RFF); } /** \brief Bias T button ON/OFF * * This slot is called when the user licks on the Bias T button. It is used * to switch the bias tee power ON and OFF. * isChecked() = true => power ON * isChecked() = false => power OFF */ void MainWindow::on_biasTeeButton_clicked() { char enabled = ui->biasTeeButton->isChecked(); FCD_MODE_ENUM fme = fcdAppSetBiasTee(enabled); if (fme != FCD_MODE_APP) { qDebug() << __func__ << ": Failed to set bias T to" << enabled; ui->statusBar->showMessage(tr("Failed to set bias T"), 5000); } } /** \brief LNA button ON/OFF * * This slot is called when the user clicks on the LNA button. It is used * to switch the LNA ON and OFF. * isChecked() = true => power ON * isChecked() = false => power OFF */ void MainWindow::on_lnaButton_clicked() { char enabled = ui->lnaButton->isChecked(); FCD_MODE_ENUM fme = fcdAppSetLna(enabled); if (fme != FCD_MODE_APP) { qDebug() << __func__ << ": Failed to set LNA to" << enabled; ui->statusBar->showMessage(tr("Failed to set LNA"), 5000); } } /** \brief Mixer gain button ON/OFF * * This slot is called when the user clicks on the Mixer gain button. It is used * to switch the mixer gain ON and OFF. * isChecked() = true => power ON * isChecked() = false => power OFF */ void MainWindow::on_mixerButton_clicked() { char enabled = ui->mixerButton->isChecked(); FCD_MODE_ENUM fme = fcdAppSetMixerGain(enabled); if (fme != FCD_MODE_APP) { qDebug() << __func__ << ": Failed to set mixer gain to" << enabled; ui->statusBar->showMessage(tr("Failed to set mixer gain"), 5000); } } /** \brief IF gain changed * \param gain The new IF gain between 0 and 59 dB. */ void MainWindow::on_ifGainSpinBox_valueChanged(int gain) { if ((gain <= 59) && (gain >= 0)) { unsigned char gc = (unsigned char) gain; FCD_MODE_ENUM fme = fcdAppSetIfGain(gc); if (fme != FCD_MODE_APP) { qDebug() << __func__ << ": Failed to set IF gain to" << gc << "dB."; ui->statusBar->showMessage(tr("Failed to set IF gain"), 5000); } } } /** \brief Frequency correction changed. * \param n New correction value in ppm. * * This slot is called when the value of the frequency correction spin button * is changed. */ void MainWindow::on_spinBoxCorr_valueChanged(int n) { FCD_MODE_ENUM fme; unsigned int uFreq, rFreq; double d = (double) (ui->freqCtrl->GetFrequency()-lnbOffset); d *= 1.0 + n/1000000.0; uFreq = (unsigned int) d; fme = fcdAppSetFreq(uFreq, &rFreq); if ((fme != FCD_MODE_APP) || (uFreq != rFreq)) { ui->statusBar->showMessage(tr("Failed to set frequency"), 2000); qDebug() << "Error in" << __func__ << "set:" << uFreq << "read:" << rFreq; } } /** \brief LNB LO frequency changed. * \param freq_mhz The new frequency in MHz. * * This slot is called when the user changes the LNB LO frequency. Only the * display frequency is adjusted; the FCD frequency will stay unchanged. */ void MainWindow::on_spinBoxLnb_valueChanged(double freq_mhz) { /* calculate current RF frequency */ qint64 rf_freq = ui->freqCtrl->GetFrequency() - lnbOffset; lnbOffset = qint64(freq_mhz*1e6); qDebug() << "New LNB LO:" << lnbOffset << "Hz"; /* Show updated frequency in display */ ui->freqCtrl->SetFrequency(lnbOffset + rf_freq); } /** \brief Action: Load FCD settigns from file. */ void MainWindow::on_actionLoad_triggered() { qDebug() << "MainWindow::on_actionLoad_triggered() not implemented"; } /** \brief Action: Save FCD settings to file. */ void MainWindow::on_actionSave_triggered() { qDebug() << "MainWindow::on_actionSave_triggered() not implemented"; } /** \brief Action: Open firmware tools. */ void MainWindow::on_actionFirmware_triggered() { //fwDialog = new CFirmware(this); //connect(fwDialog, SIGNAL(finished(int)), this, SLOT(fwDialogFinished(int))); /* set FCD in bootloader mode */ timer->stop(); fcdAppReset(); timer->start(1000); fwDialog->show(); } /*! \brief Slot: Firmware dialog finished. */ void MainWindow::fwDialogFinished(int result) { Q_UNUSED(result); qDebug() << "FIXME: Implement" << __func__; #if 0 qDebug() << "FW dialog finished. Result:" << result; //disconnect(fwDialog, SIGNAL(finished(int)), this, SLOT(fwDialogFinished(int))); //delete fwDialog; fwDialog->hide(); /* set FCD back to application mode */ timer->stop(); fcdBlReset(); timer->start(1000); #endif } /*! \brief Action: Reset to defaulrts. */ void MainWindow::on_actionDefault_triggered() { QMessageBox::StandardButton but = QMessageBox::question(this, tr("Reset FCD"), tr("Reset FCD to default settings?"), QMessageBox::Yes | QMessageBox::No, QMessageBox::No); if (but == QMessageBox::No) return; qDebug() << "FIXME: Implement" << __func__; //readDevice(); //ui->statusBar->showMessage(tr("FCD has been reset"), 5000); } /** \brief Action: About Qthid * * This slot is called when the user activates the * Help|About menu item (or Qthid|About on Mac) */ void MainWindow::on_actionAbout_triggered() { QMessageBox::about(this, tr("About Qthid"), tr("

This is qthid %1

" "

Qthid is a simple controller application for the Funcube Dongle Pro+" "

" "

Qthid can be used to set and read the various such as frequency, bias T, " "LNA, and whatever else is supported by the firmware.

" "

Qthid is written using the Qt toolkit (see About Qt) and is available " "for Linux, Mac and Windows. You can download the latest version from the " "Qthid website." "

" "

" "Funcube Dongle website
" "Information about Funcube" "

").arg(VERSION)); } /** \brief Action: About Qt * * This slot is called when the user activates the * Help|About Qt menu item (or Qthid|About Qt on Mac) */ void MainWindow::on_actionAboutQt_triggered() { QMessageBox::aboutQt(this, tr("About Qt")); } qthid-4.1-source/hidraw.c0000644000175000017500000004553412051012677013503 0ustar alcalc/******************************************************* HIDAPI - Multi-Platform library for communication with HID devices. Alan Ott Signal 11 Software 8/22/2009 Linux Version - 6/2/2009 Copyright 2009, All Rights Reserved. At the discretion of the user of this library, this software may be licensed under the terms of the GNU Public License v3, a BSD-Style license, or the original HIDAPI license as outlined in the LICENSE.txt, LICENSE-gpl3.txt, LICENSE-bsd.txt, and LICENSE-orig.txt files located at the root of the source distribution. These files may also be found in the public source code repository located at: http://github.com/signal11/hidapi . ********************************************************/ /* C */ #include #include #include #include #include /* Unix */ #include #include #include #include #include #include #include /* Linux */ #include #include #include #include #include "hidapi.h" /* Definitions from linux/hidraw.h. Since these are new, some distros may not have header files which contain them. */ #ifndef HIDIOCSFEATURE #define HIDIOCSFEATURE(len) _IOC(_IOC_WRITE|_IOC_READ, 'H', 0x06, len) #endif #ifndef HIDIOCGFEATURE #define HIDIOCGFEATURE(len) _IOC(_IOC_WRITE|_IOC_READ, 'H', 0x07, len) #endif /* USB HID device property names */ const char *device_string_names[] = { "manufacturer", "product", "serial", }; /* Symbolic names for the properties above */ enum device_string_id { DEVICE_STRING_MANUFACTURER, DEVICE_STRING_PRODUCT, DEVICE_STRING_SERIAL, DEVICE_STRING_COUNT, }; struct hid_device_ { int device_handle; int blocking; int uses_numbered_reports; }; static __u32 kernel_version = 0; static hid_device *new_hid_device(void) { hid_device *dev = calloc(1, sizeof(hid_device)); dev->device_handle = -1; dev->blocking = 1; dev->uses_numbered_reports = 0; return dev; } /* The caller must free the returned string with free(). */ static wchar_t *utf8_to_wchar_t(const char *utf8) { wchar_t *ret = NULL; if (utf8) { size_t wlen = mbstowcs(NULL, utf8, 0); if ((size_t) -1 == wlen) { return wcsdup(L""); } ret = calloc(wlen+1, sizeof(wchar_t)); mbstowcs(ret, utf8, wlen+1); ret[wlen] = 0x0000; } return ret; } /* Get an attribute value from a udev_device and return it as a whar_t string. The returned string must be freed with free() when done.*/ static wchar_t *copy_udev_string(struct udev_device *dev, const char *udev_name) { return utf8_to_wchar_t(udev_device_get_sysattr_value(dev, udev_name)); } /* uses_numbered_reports() returns 1 if report_descriptor describes a device which contains numbered reports. */ static int uses_numbered_reports(__u8 *report_descriptor, __u32 size) { int i = 0; int size_code; int data_len, key_size; while (i < size) { int key = report_descriptor[i]; /* Check for the Report ID key */ if (key == 0x85/*Report ID*/) { /* This device has a Report ID, which means it uses numbered reports. */ return 1; } //printf("key: %02hhx\n", key); if ((key & 0xf0) == 0xf0) { /* This is a Long Item. The next byte contains the length of the data section (value) for this key. See the HID specification, version 1.11, section 6.2.2.3, titled "Long Items." */ if (i+1 < size) data_len = report_descriptor[i+1]; else data_len = 0; /* malformed report */ key_size = 3; } else { /* This is a Short Item. The bottom two bits of the key contain the size code for the data section (value) for this key. Refer to the HID specification, version 1.11, section 6.2.2.2, titled "Short Items." */ size_code = key & 0x3; switch (size_code) { case 0: case 1: case 2: data_len = size_code; break; case 3: data_len = 4; break; default: /* Can't ever happen since size_code is & 0x3 */ data_len = 0; break; }; key_size = 1; } /* Skip over this key and it's associated data */ i += data_len + key_size; } /* Didn't find a Report ID key. Device doesn't use numbered reports. */ return 0; } /* * The caller is responsible for free()ing the (newly-allocated) character * strings pointed to by serial_number_utf8 and product_name_utf8 after use. */ static int parse_uevent_info(const char *uevent, int *bus_type, unsigned short *vendor_id, unsigned short *product_id, char **serial_number_utf8, char **product_name_utf8) { char *tmp = strdup(uevent); char *saveptr = NULL; char *line; char *key; char *value; int found_id = 0; int found_serial = 0; int found_name = 0; line = strtok_r(tmp, "\n", &saveptr); while (line != NULL) { /* line: "KEY=value" */ key = line; value = strchr(line, '='); if (!value) { goto next_line; } *value = '\0'; value++; if (strcmp(key, "HID_ID") == 0) { /** * type vendor product * HID_ID=0003:000005AC:00008242 **/ int ret = sscanf(value, "%x:%hx:%hx", bus_type, vendor_id, product_id); if (ret == 3) { found_id = 1; } } else if (strcmp(key, "HID_NAME") == 0) { /* The caller has to free the product name */ *product_name_utf8 = strdup(value); found_name = 1; } else if (strcmp(key, "HID_UNIQ") == 0) { /* The caller has to free the serial number */ *serial_number_utf8 = strdup(value); found_serial = 1; } next_line: line = strtok_r(NULL, "\n", &saveptr); } free(tmp); return (found_id && found_name && found_serial); } static int get_device_string(hid_device *dev, enum device_string_id key, wchar_t *string, size_t maxlen) { struct udev *udev; struct udev_device *udev_dev, *parent, *hid_dev; struct stat s; int ret = -1; /* Create the udev object */ udev = udev_new(); if (!udev) { printf("Can't create udev\n"); return -1; } /* Get the dev_t (major/minor numbers) from the file handle. */ fstat(dev->device_handle, &s); /* Open a udev device from the dev_t. 'c' means character device. */ udev_dev = udev_device_new_from_devnum(udev, 'c', s.st_rdev); if (udev_dev) { hid_dev = udev_device_get_parent_with_subsystem_devtype( udev_dev, "hid", NULL); if (hid_dev) { unsigned short dev_vid; unsigned short dev_pid; char *serial_number_utf8 = NULL; char *product_name_utf8 = NULL; int bus_type; size_t retm; ret = parse_uevent_info( udev_device_get_sysattr_value(hid_dev, "uevent"), &bus_type, &dev_vid, &dev_pid, &serial_number_utf8, &product_name_utf8); if (bus_type == BUS_BLUETOOTH) { switch (key) { case DEVICE_STRING_MANUFACTURER: wcsncpy(string, L"", maxlen); ret = 0; break; case DEVICE_STRING_PRODUCT: retm = mbstowcs(string, product_name_utf8, maxlen); ret = (retm == (size_t)-1)? -1: 0; break; case DEVICE_STRING_SERIAL: retm = mbstowcs(string, serial_number_utf8, maxlen); ret = (retm == (size_t)-1)? -1: 0; break; case DEVICE_STRING_COUNT: default: ret = -1; break; } } else { /* This is a USB device. Find its parent USB Device node. */ parent = udev_device_get_parent_with_subsystem_devtype( udev_dev, "usb", "usb_device"); if (parent) { const char *str; const char *key_str = NULL; if (key >= 0 && key < DEVICE_STRING_COUNT) { key_str = device_string_names[key]; } else { ret = -1; goto end; } str = udev_device_get_sysattr_value(parent, key_str); if (str) { /* Convert the string from UTF-8 to wchar_t */ retm = mbstowcs(string, str, maxlen); ret = (retm == (size_t)-1)? -1: 0; goto end; } } } free(serial_number_utf8); free(product_name_utf8); } } end: udev_device_unref(udev_dev); // parent and hid_dev don't need to be (and can't be) unref'd. // I'm not sure why, but they'll throw double-free() errors. udev_unref(udev); return ret; } int HID_API_EXPORT hid_init(void) { const char *locale; /* Set the locale if it's not set. */ locale = setlocale(LC_CTYPE, NULL); if (!locale) setlocale(LC_CTYPE, ""); return 0; } int HID_API_EXPORT hid_exit(void) { /* Nothing to do for this in the Linux/hidraw implementation. */ return 0; } struct hid_device_info HID_API_EXPORT *hid_enumerate(unsigned short vendor_id, unsigned short product_id) { struct udev *udev; struct udev_enumerate *enumerate; struct udev_list_entry *devices, *dev_list_entry; struct hid_device_info *root = NULL; // return object struct hid_device_info *cur_dev = NULL; struct hid_device_info *prev_dev = NULL; // previous device hid_init(); /* Create the udev object */ udev = udev_new(); if (!udev) { printf("Can't create udev\n"); return NULL; } /* Create a list of the devices in the 'hidraw' subsystem. */ enumerate = udev_enumerate_new(udev); udev_enumerate_add_match_subsystem(enumerate, "hidraw"); udev_enumerate_scan_devices(enumerate); devices = udev_enumerate_get_list_entry(enumerate); /* For each item, see if it matches the vid/pid, and if so create a udev_device record for it */ udev_list_entry_foreach(dev_list_entry, devices) { const char *sysfs_path; const char *dev_path; const char *str; struct udev_device *raw_dev; // The device's hidraw udev node. struct udev_device *hid_dev; // The device's HID udev node. struct udev_device *usb_dev; // The device's USB udev node. struct udev_device *intf_dev; // The device's interface (in the USB sense). unsigned short dev_vid; unsigned short dev_pid; char *serial_number_utf8 = NULL; char *product_name_utf8 = NULL; int bus_type; int result; /* Get the filename of the /sys entry for the device and create a udev_device object (dev) representing it */ sysfs_path = udev_list_entry_get_name(dev_list_entry); raw_dev = udev_device_new_from_syspath(udev, sysfs_path); dev_path = udev_device_get_devnode(raw_dev); hid_dev = udev_device_get_parent_with_subsystem_devtype( raw_dev, "hid", NULL); if (!hid_dev) { /* Unable to find parent hid device. */ goto next; } result = parse_uevent_info( udev_device_get_sysattr_value(hid_dev, "uevent"), &bus_type, &dev_vid, &dev_pid, &serial_number_utf8, &product_name_utf8); if (!result) { /* parse_uevent_info() failed for at least one field. */ goto next; } if (bus_type != BUS_USB && bus_type != BUS_BLUETOOTH) { /* We only know how to handle USB and BT devices. */ goto next; } /* Check the VID/PID against the arguments */ if ((vendor_id == 0x0 && product_id == 0x0) || (vendor_id == dev_vid && product_id == dev_pid)) { struct hid_device_info *tmp; /* VID/PID match. Create the record. */ tmp = malloc(sizeof(struct hid_device_info)); if (cur_dev) { cur_dev->next = tmp; } else { root = tmp; } prev_dev = cur_dev; cur_dev = tmp; /* Fill out the record */ cur_dev->next = NULL; cur_dev->path = dev_path? strdup(dev_path): NULL; /* VID/PID */ cur_dev->vendor_id = dev_vid; cur_dev->product_id = dev_pid; /* Serial Number */ cur_dev->serial_number = utf8_to_wchar_t(serial_number_utf8); /* Release Number */ cur_dev->release_number = 0x0; /* Interface Number */ cur_dev->interface_number = -1; switch (bus_type) { case BUS_USB: /* The device pointed to by raw_dev contains information about the hidraw device. In order to get information about the USB device, get the parent device with the subsystem/devtype pair of "usb"/"usb_device". This will be several levels up the tree, but the function will find it. */ usb_dev = udev_device_get_parent_with_subsystem_devtype( raw_dev, "usb", "usb_device"); if (!usb_dev) { /* Free this device */ free(cur_dev->serial_number); free(cur_dev->path); free(cur_dev); /* Take it off the device list. */ if (prev_dev) { prev_dev->next = NULL; cur_dev = prev_dev; } else { cur_dev = root = NULL; } goto next; } /* Manufacturer and Product strings */ cur_dev->manufacturer_string = copy_udev_string(usb_dev, device_string_names[DEVICE_STRING_MANUFACTURER]); cur_dev->product_string = copy_udev_string(usb_dev, device_string_names[DEVICE_STRING_PRODUCT]); /* Release Number */ str = udev_device_get_sysattr_value(usb_dev, "bcdDevice"); cur_dev->release_number = (str)? strtol(str, NULL, 16): 0x0; /* Get a handle to the interface's udev node. */ intf_dev = udev_device_get_parent_with_subsystem_devtype( raw_dev, "usb", "usb_interface"); if (intf_dev) { str = udev_device_get_sysattr_value(intf_dev, "bInterfaceNumber"); cur_dev->interface_number = (str)? strtol(str, NULL, 16): -1; } break; case BUS_BLUETOOTH: /* Manufacturer and Product strings */ cur_dev->manufacturer_string = wcsdup(L""); cur_dev->product_string = utf8_to_wchar_t(product_name_utf8); break; default: /* Unknown device type - this should never happen, as we * check for USB and Bluetooth devices above */ break; } } next: free(serial_number_utf8); free(product_name_utf8); udev_device_unref(raw_dev); /* hid_dev, usb_dev and intf_dev don't need to be (and can't be) unref()d. It will cause a double-free() error. I'm not sure why. */ } /* Free the enumerator and udev objects. */ udev_enumerate_unref(enumerate); udev_unref(udev); return root; } void HID_API_EXPORT hid_free_enumeration(struct hid_device_info *devs) { struct hid_device_info *d = devs; while (d) { struct hid_device_info *next = d->next; free(d->path); free(d->serial_number); free(d->manufacturer_string); free(d->product_string); free(d); d = next; } } hid_device * hid_open(unsigned short vendor_id, unsigned short product_id, const wchar_t *serial_number) { struct hid_device_info *devs, *cur_dev; const char *path_to_open = NULL; hid_device *handle = NULL; devs = hid_enumerate(vendor_id, product_id); cur_dev = devs; while (cur_dev) { if (cur_dev->vendor_id == vendor_id && cur_dev->product_id == product_id) { if (serial_number) { if (wcscmp(serial_number, cur_dev->serial_number) == 0) { path_to_open = cur_dev->path; break; } } else { path_to_open = cur_dev->path; break; } } cur_dev = cur_dev->next; } if (path_to_open) { /* Open the device */ handle = hid_open_path(path_to_open); } hid_free_enumeration(devs); return handle; } hid_device * HID_API_EXPORT hid_open_path(const char *path) { hid_device *dev = NULL; hid_init(); dev = new_hid_device(); if (kernel_version == 0) { struct utsname name; int major, minor, release; int ret; uname(&name); ret = sscanf(name.release, "%d.%d.%d", &major, &minor, &release); if (ret == 3) { kernel_version = major << 16 | minor << 8 | release; //printf("Kernel Version: %d\n", kernel_version); } else { printf("Couldn't sscanf() version string %s\n", name.release); } } // OPEN HERE // dev->device_handle = open(path, O_RDWR); // If we have a good handle, return it. if (dev->device_handle > 0) { /* Get the report descriptor */ int res, desc_size = 0; struct hidraw_report_descriptor rpt_desc; memset(&rpt_desc, 0x0, sizeof(rpt_desc)); /* Get Report Descriptor Size */ res = ioctl(dev->device_handle, HIDIOCGRDESCSIZE, &desc_size); if (res < 0) perror("HIDIOCGRDESCSIZE"); /* Get Report Descriptor */ rpt_desc.size = desc_size; res = ioctl(dev->device_handle, HIDIOCGRDESC, &rpt_desc); if (res < 0) { perror("HIDIOCGRDESC"); } else { /* Determine if this device uses numbered reports. */ dev->uses_numbered_reports = uses_numbered_reports(rpt_desc.value, rpt_desc.size); } return dev; } else { // Unable to open any devices. free(dev); return NULL; } } int HID_API_EXPORT hid_write(hid_device *dev, const unsigned char *data, size_t length) { int bytes_written; bytes_written = write(dev->device_handle, data, length); return bytes_written; } int HID_API_EXPORT hid_read_timeout(hid_device *dev, unsigned char *data, size_t length, int milliseconds) { int bytes_read; if (milliseconds != 0) { /* milliseconds is -1 or > 0. In both cases, we want to call poll() and wait for data to arrive. -1 means INFINITE. */ int ret; struct pollfd fds; fds.fd = dev->device_handle; fds.events = POLLIN; fds.revents = 0; ret = poll(&fds, 1, milliseconds); if (ret == -1 || ret == 0) /* Error or timeout */ return ret; } bytes_read = read(dev->device_handle, data, length); if (bytes_read < 0 && errno == EAGAIN) bytes_read = 0; if (bytes_read >= 0 && kernel_version < KERNEL_VERSION(2,6,34) && dev->uses_numbered_reports) { /* Work around a kernel bug. Chop off the first byte. */ memmove(data, data+1, bytes_read); bytes_read--; } return bytes_read; } int HID_API_EXPORT hid_read(hid_device *dev, unsigned char *data, size_t length) { return hid_read_timeout(dev, data, length, (dev->blocking)? -1: 0); } int HID_API_EXPORT hid_set_nonblocking(hid_device *dev, int nonblock) { int flags, res; flags = fcntl(dev->device_handle, F_GETFL, 0); if (flags >= 0) { if (nonblock) res = fcntl(dev->device_handle, F_SETFL, flags | O_NONBLOCK); else res = fcntl(dev->device_handle, F_SETFL, flags & ~O_NONBLOCK); } else return -1; if (res < 0) { return -1; } else { dev->blocking = !nonblock; return 0; /* Success */ } } int HID_API_EXPORT hid_send_feature_report(hid_device *dev, const unsigned char *data, size_t length) { int res; res = ioctl(dev->device_handle, HIDIOCSFEATURE(length), data); if (res < 0) perror("ioctl (SFEATURE)"); return res; } int HID_API_EXPORT hid_get_feature_report(hid_device *dev, unsigned char *data, size_t length) { int res; res = ioctl(dev->device_handle, HIDIOCGFEATURE(length), data); if (res < 0) perror("ioctl (GFEATURE)"); return res; } void HID_API_EXPORT hid_close(hid_device *dev) { if (!dev) return; close(dev->device_handle); free(dev); } int HID_API_EXPORT_CALL hid_get_manufacturer_string(hid_device *dev, wchar_t *string, size_t maxlen) { return get_device_string(dev, DEVICE_STRING_MANUFACTURER, string, maxlen); } int HID_API_EXPORT_CALL hid_get_product_string(hid_device *dev, wchar_t *string, size_t maxlen) { return get_device_string(dev, DEVICE_STRING_PRODUCT, string, maxlen); } int HID_API_EXPORT_CALL hid_get_serial_number_string(hid_device *dev, wchar_t *string, size_t maxlen) { return get_device_string(dev, DEVICE_STRING_SERIAL, string, maxlen); } int HID_API_EXPORT_CALL hid_get_indexed_string(hid_device *dev, int string_index, wchar_t *string, size_t maxlen) { return -1; } HID_API_EXPORT const wchar_t * HID_API_CALL hid_error(hid_device *dev) { return NULL; } qthid-4.1-source/firmware.ui0000644000175000017500000000666412051012642014225 0ustar alcalc CFirmware Qt::NonModal 0 0 287 122 Firmware Tools :/qthid/images/fw.png:/qthid/images/fw.png false Ready... 0 0 0 Currently selected firmware. 0 0 0 QLayout::SetDefaultConstraint Select a firmware file on disk &Select Upload the selected firmware to the FCD &Upload Compare the selected firmware with the firmware in the FCD &Verify Qt::Vertical 20 40 qthid-4.1-source/hid-libusb.c0000644000175000017500000011343712051012677014245 0ustar alcalc/******************************************************* HIDAPI - Multi-Platform library for communication with HID devices. Alan Ott Signal 11 Software 8/22/2009 Linux Version - 6/2/2010 Libusb Version - 8/13/2010 FreeBSD Version - 11/1/2011 Copyright 2009, All Rights Reserved. At the discretion of the user of this library, this software may be licensed under the terms of the GNU Public License v3, a BSD-Style license, or the original HIDAPI license as outlined in the LICENSE.txt, LICENSE-gpl3.txt, LICENSE-bsd.txt, and LICENSE-orig.txt files located at the root of the source distribution. These files may also be found in the public source code repository located at: http://github.com/signal11/hidapi . ********************************************************/ #define _GNU_SOURCE // needed for wcsdup() before glibc 2.10 /* C */ #include #include #include #include #include #include /* Unix */ #include #include #include #include #include #include #include #include /* GNU / LibUSB */ #include "libusb.h" #include "iconv.h" #include "hidapi.h" #ifdef __cplusplus extern "C" { #endif #ifdef DEBUG_PRINTF #define LOG(...) fprintf(stderr, __VA_ARGS__) #else #define LOG(...) do {} while (0) #endif #ifndef __FreeBSD__ #define DETACH_KERNEL_DRIVER #endif /* Uncomment to enable the retrieval of Usage and Usage Page in hid_enumerate(). Warning, on platforms different from FreeBSD this is very invasive as it requires the detach and re-attach of the kernel driver. See comments inside hid_enumerate(). libusb HIDAPI programs are encouraged to use the interface number instead to differentiate between interfaces on a composite HID device. */ /*#define INVASIVE_GET_USAGE*/ /* Linked List of input reports received from the device. */ struct input_report { uint8_t *data; size_t len; struct input_report *next; }; struct hid_device_ { /* Handle to the actual device. */ libusb_device_handle *device_handle; /* Endpoint information */ int input_endpoint; int output_endpoint; int input_ep_max_packet_size; /* The interface number of the HID */ int interface; /* Indexes of Strings */ int manufacturer_index; int product_index; int serial_index; /* Whether blocking reads are used */ int blocking; /* boolean */ /* Read thread objects */ pthread_t thread; pthread_mutex_t mutex; /* Protects input_reports */ pthread_cond_t condition; pthread_barrier_t barrier; /* Ensures correct startup sequence */ int shutdown_thread; struct libusb_transfer *transfer; /* List of received input reports. */ struct input_report *input_reports; }; static libusb_context *usb_context = NULL; uint16_t get_usb_code_for_current_locale(void); static int return_data(hid_device *dev, unsigned char *data, size_t length); static hid_device *new_hid_device(void) { hid_device *dev = calloc(1, sizeof(hid_device)); dev->blocking = 1; pthread_mutex_init(&dev->mutex, NULL); pthread_cond_init(&dev->condition, NULL); pthread_barrier_init(&dev->barrier, NULL, 2); return dev; } static void free_hid_device(hid_device *dev) { /* Clean up the thread objects */ pthread_barrier_destroy(&dev->barrier); pthread_cond_destroy(&dev->condition); pthread_mutex_destroy(&dev->mutex); /* Free the device itself */ free(dev); } #if 0 //TODO: Implement this funciton on hidapi/libusb.. static void register_error(hid_device *device, const char *op) { } #endif #ifdef INVASIVE_GET_USAGE /* Get bytes from a HID Report Descriptor. Only call with a num_bytes of 0, 1, 2, or 4. */ static uint32_t get_bytes(uint8_t *rpt, size_t len, size_t num_bytes, size_t cur) { /* Return if there aren't enough bytes. */ if (cur + num_bytes >= len) return 0; if (num_bytes == 0) return 0; else if (num_bytes == 1) { return rpt[cur+1]; } else if (num_bytes == 2) { return (rpt[cur+2] * 256 + rpt[cur+1]); } else if (num_bytes == 4) { return (rpt[cur+4] * 0x01000000 + rpt[cur+3] * 0x00010000 + rpt[cur+2] * 0x00000100 + rpt[cur+1] * 0x00000001); } else return 0; } /* Retrieves the device's Usage Page and Usage from the report descriptor. The algorithm is simple, as it just returns the first Usage and Usage Page that it finds in the descriptor. The return value is 0 on success and -1 on failure. */ static int get_usage(uint8_t *report_descriptor, size_t size, unsigned short *usage_page, unsigned short *usage) { int i = 0; int size_code; int data_len, key_size; int usage_found = 0, usage_page_found = 0; while (i < size) { int key = report_descriptor[i]; int key_cmd = key & 0xfc; //printf("key: %02hhx\n", key); if ((key & 0xf0) == 0xf0) { /* This is a Long Item. The next byte contains the length of the data section (value) for this key. See the HID specification, version 1.11, section 6.2.2.3, titled "Long Items." */ if (i+1 < size) data_len = report_descriptor[i+1]; else data_len = 0; /* malformed report */ key_size = 3; } else { /* This is a Short Item. The bottom two bits of the key contain the size code for the data section (value) for this key. Refer to the HID specification, version 1.11, section 6.2.2.2, titled "Short Items." */ size_code = key & 0x3; switch (size_code) { case 0: case 1: case 2: data_len = size_code; break; case 3: data_len = 4; break; default: /* Can't ever happen since size_code is & 0x3 */ data_len = 0; break; }; key_size = 1; } if (key_cmd == 0x4) { *usage_page = get_bytes(report_descriptor, size, data_len, i); usage_page_found = 1; //printf("Usage Page: %x\n", (uint32_t)*usage_page); } if (key_cmd == 0x8) { *usage = get_bytes(report_descriptor, size, data_len, i); usage_found = 1; //printf("Usage: %x\n", (uint32_t)*usage); } if (usage_page_found && usage_found) return 0; /* success */ /* Skip over this key and it's associated data */ i += data_len + key_size; } return -1; /* failure */ } #endif // INVASIVE_GET_USAGE #ifdef __FreeBSD__ /* The FreeBSD version of libusb doesn't have this funciton. In mainline libusb, it's inlined in libusb.h. This function will bear a striking resemblence to that one, because there's about one way to code it. Note that the data parameter is Unicode in UTF-16LE encoding. Return value is the number of bytes in data, or LIBUSB_ERROR_*. */ static inline int libusb_get_string_descriptor(libusb_device_handle *dev, uint8_t descriptor_index, uint16_t lang_id, unsigned char *data, int length) { return libusb_control_transfer(dev, LIBUSB_ENDPOINT_IN | 0x0, /* Endpoint 0 IN */ LIBUSB_REQUEST_GET_DESCRIPTOR, (LIBUSB_DT_STRING << 8) | descriptor_index, lang_id, data, (uint16_t) length, 1000); } #endif /* Get the first language the device says it reports. This comes from USB string #0. */ static uint16_t get_first_language(libusb_device_handle *dev) { uint16_t buf[32]; int len; /* Get the string from libusb. */ len = libusb_get_string_descriptor(dev, 0x0, /* String ID */ 0x0, /* Language */ (unsigned char*)buf, sizeof(buf)); if (len < 4) return 0x0; return buf[1]; // First two bytes are len and descriptor type. } static int is_language_supported(libusb_device_handle *dev, uint16_t lang) { uint16_t buf[32]; int len; int i; /* Get the string from libusb. */ len = libusb_get_string_descriptor(dev, 0x0, /* String ID */ 0x0, /* Language */ (unsigned char*)buf, sizeof(buf)); if (len < 4) return 0x0; len /= 2; /* language IDs are two-bytes each. */ /* Start at index 1 because there are two bytes of protocol data. */ for (i = 1; i < len; i++) { if (buf[i] == lang) return 1; } return 0; } /* This function returns a newly allocated wide string containing the USB device string numbered by the index. The returned string must be freed by using free(). */ static wchar_t *get_usb_string(libusb_device_handle *dev, uint8_t idx) { char buf[512]; int len; wchar_t *str = NULL; wchar_t wbuf[256]; /* iconv variables */ iconv_t ic; size_t inbytes; size_t outbytes; size_t res; #ifdef __FreeBSD__ const char *inptr; #else char *inptr; #endif char *outptr; /* Determine which language to use. */ uint16_t lang; lang = get_usb_code_for_current_locale(); if (!is_language_supported(dev, lang)) lang = get_first_language(dev); /* Get the string from libusb. */ len = libusb_get_string_descriptor(dev, idx, lang, (unsigned char*)buf, sizeof(buf)); if (len < 0) return NULL; /* buf does not need to be explicitly NULL-terminated because it is only passed into iconv() which does not need it. */ /* Initialize iconv. */ ic = iconv_open("WCHAR_T", "UTF-16LE"); if (ic == (iconv_t)-1) { LOG("iconv_open() failed\n"); return NULL; } /* Convert to native wchar_t (UTF-32 on glibc/BSD systems). Skip the first character (2-bytes). */ inptr = buf+2; inbytes = len-2; outptr = (char*) wbuf; outbytes = sizeof(wbuf); res = iconv(ic, &inptr, &inbytes, &outptr, &outbytes); if (res == (size_t)-1) { LOG("iconv() failed\n"); goto err; } /* Write the terminating NULL. */ wbuf[sizeof(wbuf)/sizeof(wbuf[0])-1] = 0x00000000; if (outbytes >= sizeof(wbuf[0])) *((wchar_t*)outptr) = 0x00000000; /* Allocate and copy the string. */ str = wcsdup(wbuf); err: iconv_close(ic); return str; } static char *make_path(libusb_device *dev, int interface_number) { char str[64]; snprintf(str, sizeof(str), "%04x:%04x:%02x", libusb_get_bus_number(dev), libusb_get_device_address(dev), interface_number); str[sizeof(str)-1] = '\0'; return strdup(str); } int HID_API_EXPORT hid_init(void) { if (!usb_context) { const char *locale; /* Init Libusb */ if (libusb_init(&usb_context)) return -1; /* Set the locale if it's not set. */ locale = setlocale(LC_CTYPE, NULL); if (!locale) setlocale(LC_CTYPE, ""); } return 0; } int HID_API_EXPORT hid_exit(void) { if (usb_context) { libusb_exit(usb_context); usb_context = NULL; } return 0; } struct hid_device_info HID_API_EXPORT *hid_enumerate(unsigned short vendor_id, unsigned short product_id) { libusb_device **devs; libusb_device *dev; libusb_device_handle *handle; ssize_t num_devs; int i = 0; struct hid_device_info *root = NULL; // return object struct hid_device_info *cur_dev = NULL; hid_init(); num_devs = libusb_get_device_list(usb_context, &devs); if (num_devs < 0) return NULL; while ((dev = devs[i++]) != NULL) { struct libusb_device_descriptor desc; struct libusb_config_descriptor *conf_desc = NULL; int j, k; int interface_num = 0; int res = libusb_get_device_descriptor(dev, &desc); unsigned short dev_vid = desc.idVendor; unsigned short dev_pid = desc.idProduct; /* HID's are defined at the interface level. */ if (desc.bDeviceClass != LIBUSB_CLASS_PER_INTERFACE) continue; res = libusb_get_active_config_descriptor(dev, &conf_desc); if (res < 0) libusb_get_config_descriptor(dev, 0, &conf_desc); if (conf_desc) { for (j = 0; j < conf_desc->bNumInterfaces; j++) { const struct libusb_interface *intf = &conf_desc->interface[j]; for (k = 0; k < intf->num_altsetting; k++) { const struct libusb_interface_descriptor *intf_desc; intf_desc = &intf->altsetting[k]; if (intf_desc->bInterfaceClass == LIBUSB_CLASS_HID) { interface_num = intf_desc->bInterfaceNumber; /* Check the VID/PID against the arguments */ if ((vendor_id == 0x0 && product_id == 0x0) || (vendor_id == dev_vid && product_id == dev_pid)) { struct hid_device_info *tmp; /* VID/PID match. Create the record. */ tmp = calloc(1, sizeof(struct hid_device_info)); if (cur_dev) { cur_dev->next = tmp; } else { root = tmp; } cur_dev = tmp; /* Fill out the record */ cur_dev->next = NULL; cur_dev->path = make_path(dev, interface_num); res = libusb_open(dev, &handle); if (res >= 0) { /* Serial Number */ if (desc.iSerialNumber > 0) cur_dev->serial_number = get_usb_string(handle, desc.iSerialNumber); /* Manufacturer and Product strings */ if (desc.iManufacturer > 0) cur_dev->manufacturer_string = get_usb_string(handle, desc.iManufacturer); if (desc.iProduct > 0) cur_dev->product_string = get_usb_string(handle, desc.iProduct); #ifdef INVASIVE_GET_USAGE /* This section is removed because it is too invasive on the system. Getting a Usage Page and Usage requires parsing the HID Report descriptor. Getting a HID Report descriptor involves claiming the interface. Claiming the interface involves detaching the kernel driver. Detaching the kernel driver is hard on the system because it will unclaim interfaces (if another app has them claimed) and the re-attachment of the driver will sometimes change /dev entry names. It is for these reasons that this section is #if 0. For composite devices, use the interface field in the hid_device_info struct to distinguish between interfaces. */ unsigned char data[256]; #ifdef DETACH_KERNEL_DRIVER int detached = 0; /* Usage Page and Usage */ res = libusb_kernel_driver_active(handle, interface_num); if (res == 1) { res = libusb_detach_kernel_driver(handle, interface_num); if (res < 0) LOG("Couldn't detach kernel driver, even though a kernel driver was attached."); else detached = 1; } #endif res = libusb_claim_interface(handle, interface_num); if (res >= 0) { /* Get the HID Report Descriptor. */ res = libusb_control_transfer(handle, LIBUSB_ENDPOINT_IN|LIBUSB_RECIPIENT_INTERFACE, LIBUSB_REQUEST_GET_DESCRIPTOR, (LIBUSB_DT_REPORT << 8)|interface_num, 0, data, sizeof(data), 5000); if (res >= 0) { unsigned short page=0, usage=0; /* Parse the usage and usage page out of the report descriptor. */ get_usage(data, res, &page, &usage); cur_dev->usage_page = page; cur_dev->usage = usage; } else LOG("libusb_control_transfer() for getting the HID report failed with %d\n", res); /* Release the interface */ res = libusb_release_interface(handle, interface_num); if (res < 0) LOG("Can't release the interface.\n"); } else LOG("Can't claim interface %d\n", res); #ifdef DETACH_KERNEL_DRIVER /* Re-attach kernel driver if necessary. */ if (detached) { res = libusb_attach_kernel_driver(handle, interface_num); if (res < 0) LOG("Couldn't re-attach kernel driver.\n"); } #endif #endif // INVASIVE_GET_USAGE libusb_close(handle); } /* VID/PID */ cur_dev->vendor_id = dev_vid; cur_dev->product_id = dev_pid; /* Release Number */ cur_dev->release_number = desc.bcdDevice; /* Interface Number */ cur_dev->interface_number = interface_num; } } } /* altsettings */ } /* interfaces */ libusb_free_config_descriptor(conf_desc); } } libusb_free_device_list(devs, 1); return root; } void HID_API_EXPORT hid_free_enumeration(struct hid_device_info *devs) { struct hid_device_info *d = devs; while (d) { struct hid_device_info *next = d->next; free(d->path); free(d->serial_number); free(d->manufacturer_string); free(d->product_string); free(d); d = next; } } hid_device * hid_open(unsigned short vendor_id, unsigned short product_id, const wchar_t *serial_number) { struct hid_device_info *devs, *cur_dev; const char *path_to_open = NULL; hid_device *handle = NULL; devs = hid_enumerate(vendor_id, product_id); cur_dev = devs; while (cur_dev) { if (cur_dev->vendor_id == vendor_id && cur_dev->product_id == product_id) { if (serial_number) { if (wcscmp(serial_number, cur_dev->serial_number) == 0) { path_to_open = cur_dev->path; break; } } else { path_to_open = cur_dev->path; break; } } cur_dev = cur_dev->next; } if (path_to_open) { /* Open the device */ handle = hid_open_path(path_to_open); } hid_free_enumeration(devs); return handle; } static void read_callback(struct libusb_transfer *transfer) { hid_device *dev = transfer->user_data; int res; if (transfer->status == LIBUSB_TRANSFER_COMPLETED) { struct input_report *rpt = malloc(sizeof(*rpt)); rpt->data = malloc(transfer->actual_length); memcpy(rpt->data, transfer->buffer, transfer->actual_length); rpt->len = transfer->actual_length; rpt->next = NULL; pthread_mutex_lock(&dev->mutex); /* Attach the new report object to the end of the list. */ if (dev->input_reports == NULL) { /* The list is empty. Put it at the root. */ dev->input_reports = rpt; pthread_cond_signal(&dev->condition); } else { /* Find the end of the list and attach. */ struct input_report *cur = dev->input_reports; int num_queued = 0; while (cur->next != NULL) { cur = cur->next; num_queued++; } cur->next = rpt; /* Pop one off if we've reached 30 in the queue. This way we don't grow forever if the user never reads anything from the device. */ if (num_queued > 30) { return_data(dev, NULL, 0); } } pthread_mutex_unlock(&dev->mutex); } else if (transfer->status == LIBUSB_TRANSFER_CANCELLED) { dev->shutdown_thread = 1; return; } else if (transfer->status == LIBUSB_TRANSFER_NO_DEVICE) { dev->shutdown_thread = 1; return; } else if (transfer->status == LIBUSB_TRANSFER_TIMED_OUT) { //LOG("Timeout (normal)\n"); } else { LOG("Unknown transfer code: %d\n", transfer->status); } /* Re-submit the transfer object. */ res = libusb_submit_transfer(transfer); if (res != 0) { LOG("Unable to submit URB. libusb error code: %d\n", res); dev->shutdown_thread = 1; } } static void *read_thread(void *param) { hid_device *dev = param; unsigned char *buf; const size_t length = dev->input_ep_max_packet_size; /* Set up the transfer object. */ buf = malloc(length); dev->transfer = libusb_alloc_transfer(0); libusb_fill_interrupt_transfer(dev->transfer, dev->device_handle, dev->input_endpoint, buf, length, read_callback, dev, 5000/*timeout*/); /* Make the first submission. Further submissions are made from inside read_callback() */ libusb_submit_transfer(dev->transfer); // Notify the main thread that the read thread is up and running. pthread_barrier_wait(&dev->barrier); /* Handle all the events. */ while (!dev->shutdown_thread) { int res; res = libusb_handle_events(usb_context); if (res < 0) { /* There was an error. */ LOG("read_thread(): libusb reports error # %d\n", res); /* Break out of this loop only on fatal error.*/ if (res != LIBUSB_ERROR_BUSY && res != LIBUSB_ERROR_TIMEOUT && res != LIBUSB_ERROR_OVERFLOW && res != LIBUSB_ERROR_INTERRUPTED) { break; } } } /* Cancel any transfer that may be pending. This call will fail if no transfers are pending, but that's OK. */ if (libusb_cancel_transfer(dev->transfer) == 0) { /* The transfer was cancelled, so wait for its completion. */ libusb_handle_events(usb_context); } /* Now that the read thread is stopping, Wake any threads which are waiting on data (in hid_read_timeout()). Do this under a mutex to make sure that a thread which is about to go to sleep waiting on the condition acutally will go to sleep before the condition is signaled. */ pthread_mutex_lock(&dev->mutex); pthread_cond_broadcast(&dev->condition); pthread_mutex_unlock(&dev->mutex); /* The dev->transfer->buffer and dev->transfer objects are cleaned up in hid_close(). They are not cleaned up here because this thread could end either due to a disconnect or due to a user call to hid_close(). In both cases the objects can be safely cleaned up after the call to pthread_join() (in hid_close()), but since hid_close() calls libusb_cancel_transfer(), on these objects, they can not be cleaned up here. */ return NULL; } hid_device * HID_API_EXPORT hid_open_path(const char *path) { hid_device *dev = NULL; dev = new_hid_device(); libusb_device **devs; libusb_device *usb_dev; ssize_t num_devs; int res; int d = 0; int good_open = 0; hid_init(); num_devs = libusb_get_device_list(usb_context, &devs); while ((usb_dev = devs[d++]) != NULL) { struct libusb_device_descriptor desc; struct libusb_config_descriptor *conf_desc = NULL; int i,j,k; libusb_get_device_descriptor(usb_dev, &desc); if (libusb_get_active_config_descriptor(usb_dev, &conf_desc) < 0) continue; for (j = 0; j < conf_desc->bNumInterfaces; j++) { const struct libusb_interface *intf = &conf_desc->interface[j]; for (k = 0; k < intf->num_altsetting; k++) { const struct libusb_interface_descriptor *intf_desc; intf_desc = &intf->altsetting[k]; if (intf_desc->bInterfaceClass == LIBUSB_CLASS_HID) { char *dev_path = make_path(usb_dev, intf_desc->bInterfaceNumber); if (!strcmp(dev_path, path)) { /* Matched Paths. Open this device */ // OPEN HERE // res = libusb_open(usb_dev, &dev->device_handle); if (res < 0) { LOG("can't open device\n"); free(dev_path); break; } good_open = 1; #ifdef DETACH_KERNEL_DRIVER /* Detach the kernel driver, but only if the device is managed by the kernel */ if (libusb_kernel_driver_active(dev->device_handle, intf_desc->bInterfaceNumber) == 1) { res = libusb_detach_kernel_driver(dev->device_handle, intf_desc->bInterfaceNumber); if (res < 0) { libusb_close(dev->device_handle); LOG("Unable to detach Kernel Driver\n"); free(dev_path); good_open = 0; break; } } #endif res = libusb_claim_interface(dev->device_handle, intf_desc->bInterfaceNumber); if (res < 0) { LOG("can't claim interface %d: %d\n", intf_desc->bInterfaceNumber, res); free(dev_path); libusb_close(dev->device_handle); good_open = 0; break; } /* Store off the string descriptor indexes */ dev->manufacturer_index = desc.iManufacturer; dev->product_index = desc.iProduct; dev->serial_index = desc.iSerialNumber; /* Store off the interface number */ dev->interface = intf_desc->bInterfaceNumber; /* Find the INPUT and OUTPUT endpoints. An OUTPUT endpoint is not required. */ for (i = 0; i < intf_desc->bNumEndpoints; i++) { const struct libusb_endpoint_descriptor *ep = &intf_desc->endpoint[i]; /* Determine the type and direction of this endpoint. */ int is_interrupt = (ep->bmAttributes & LIBUSB_TRANSFER_TYPE_MASK) == LIBUSB_TRANSFER_TYPE_INTERRUPT; int is_output = (ep->bEndpointAddress & LIBUSB_ENDPOINT_DIR_MASK) == LIBUSB_ENDPOINT_OUT; int is_input = (ep->bEndpointAddress & LIBUSB_ENDPOINT_DIR_MASK) == LIBUSB_ENDPOINT_IN; /* Decide whether to use it for intput or output. */ if (dev->input_endpoint == 0 && is_interrupt && is_input) { /* Use this endpoint for INPUT */ dev->input_endpoint = ep->bEndpointAddress; dev->input_ep_max_packet_size = ep->wMaxPacketSize; } if (dev->output_endpoint == 0 && is_interrupt && is_output) { /* Use this endpoint for OUTPUT */ dev->output_endpoint = ep->bEndpointAddress; } } pthread_create(&dev->thread, NULL, read_thread, dev); // Wait here for the read thread to be initialized. pthread_barrier_wait(&dev->barrier); } free(dev_path); } } } libusb_free_config_descriptor(conf_desc); } libusb_free_device_list(devs, 1); // If we have a good handle, return it. if (good_open) { return dev; } else { // Unable to open any devices. free_hid_device(dev); return NULL; } } int HID_API_EXPORT hid_write(hid_device *dev, const unsigned char *data, size_t length) { int res; int report_number = data[0]; int skipped_report_id = 0; if (report_number == 0x0) { data++; length--; skipped_report_id = 1; } if (dev->output_endpoint <= 0) { /* No interrput out endpoint. Use the Control Endpoint */ res = libusb_control_transfer(dev->device_handle, LIBUSB_REQUEST_TYPE_CLASS|LIBUSB_RECIPIENT_INTERFACE|LIBUSB_ENDPOINT_OUT, 0x09/*HID Set_Report*/, (2/*HID output*/ << 8) | report_number, dev->interface, (unsigned char *)data, length, 1000/*timeout millis*/); if (res < 0) return -1; if (skipped_report_id) length++; return length; } else { /* Use the interrupt out endpoint */ int actual_length; res = libusb_interrupt_transfer(dev->device_handle, dev->output_endpoint, (unsigned char*)data, length, &actual_length, 1000); if (res < 0) return -1; if (skipped_report_id) actual_length++; return actual_length; } } /* Helper function, to simplify hid_read(). This should be called with dev->mutex locked. */ static int return_data(hid_device *dev, unsigned char *data, size_t length) { /* Copy the data out of the linked list item (rpt) into the return buffer (data), and delete the liked list item. */ struct input_report *rpt = dev->input_reports; size_t len = (length < rpt->len)? length: rpt->len; if (len > 0) memcpy(data, rpt->data, len); dev->input_reports = rpt->next; free(rpt->data); free(rpt); return len; } static void cleanup_mutex(void *param) { hid_device *dev = param; pthread_mutex_unlock(&dev->mutex); } int HID_API_EXPORT hid_read_timeout(hid_device *dev, unsigned char *data, size_t length, int milliseconds) { int bytes_read = -1; #if 0 int transferred; int res = libusb_interrupt_transfer(dev->device_handle, dev->input_endpoint, data, length, &transferred, 5000); LOG("transferred: %d\n", transferred); return transferred; #endif pthread_mutex_lock(&dev->mutex); pthread_cleanup_push(&cleanup_mutex, dev); /* There's an input report queued up. Return it. */ if (dev->input_reports) { /* Return the first one */ bytes_read = return_data(dev, data, length); goto ret; } if (dev->shutdown_thread) { /* This means the device has been disconnected. An error code of -1 should be returned. */ bytes_read = -1; goto ret; } if (milliseconds == -1) { /* Blocking */ while (!dev->input_reports && !dev->shutdown_thread) { pthread_cond_wait(&dev->condition, &dev->mutex); } if (dev->input_reports) { bytes_read = return_data(dev, data, length); } } else if (milliseconds > 0) { /* Non-blocking, but called with timeout. */ int res; struct timespec ts; clock_gettime(CLOCK_REALTIME, &ts); ts.tv_sec += milliseconds / 1000; ts.tv_nsec += (milliseconds % 1000) * 1000000; if (ts.tv_nsec >= 1000000000L) { ts.tv_sec++; ts.tv_nsec -= 1000000000L; } while (!dev->input_reports && !dev->shutdown_thread) { res = pthread_cond_timedwait(&dev->condition, &dev->mutex, &ts); if (res == 0) { if (dev->input_reports) { bytes_read = return_data(dev, data, length); break; } /* If we're here, there was a spurious wake up or the read thread was shutdown. Run the loop again (ie: don't break). */ } else if (res == ETIMEDOUT) { /* Timed out. */ bytes_read = 0; break; } else { /* Error. */ bytes_read = -1; break; } } } else { /* Purely non-blocking */ bytes_read = 0; } ret: pthread_mutex_unlock(&dev->mutex); pthread_cleanup_pop(0); return bytes_read; } int HID_API_EXPORT hid_read(hid_device *dev, unsigned char *data, size_t length) { return hid_read_timeout(dev, data, length, dev->blocking ? -1 : 0); } int HID_API_EXPORT hid_set_nonblocking(hid_device *dev, int nonblock) { dev->blocking = !nonblock; return 0; } int HID_API_EXPORT hid_send_feature_report(hid_device *dev, const unsigned char *data, size_t length) { int res = -1; int skipped_report_id = 0; int report_number = data[0]; if (report_number == 0x0) { data++; length--; skipped_report_id = 1; } res = libusb_control_transfer(dev->device_handle, LIBUSB_REQUEST_TYPE_CLASS|LIBUSB_RECIPIENT_INTERFACE|LIBUSB_ENDPOINT_OUT, 0x09/*HID set_report*/, (3/*HID feature*/ << 8) | report_number, dev->interface, (unsigned char *)data, length, 1000/*timeout millis*/); if (res < 0) return -1; /* Account for the report ID */ if (skipped_report_id) length++; return length; } int HID_API_EXPORT hid_get_feature_report(hid_device *dev, unsigned char *data, size_t length) { int res = -1; int skipped_report_id = 0; int report_number = data[0]; if (report_number == 0x0) { /* Offset the return buffer by 1, so that the report ID will remain in byte 0. */ data++; length--; skipped_report_id = 1; } res = libusb_control_transfer(dev->device_handle, LIBUSB_REQUEST_TYPE_CLASS|LIBUSB_RECIPIENT_INTERFACE|LIBUSB_ENDPOINT_IN, 0x01/*HID get_report*/, (3/*HID feature*/ << 8) | report_number, dev->interface, (unsigned char *)data, length, 1000/*timeout millis*/); if (res < 0) return -1; if (skipped_report_id) res++; return res; } void HID_API_EXPORT hid_close(hid_device *dev) { if (!dev) return; /* Cause read_thread() to stop. */ dev->shutdown_thread = 1; libusb_cancel_transfer(dev->transfer); /* Wait for read_thread() to end. */ pthread_join(dev->thread, NULL); /* Clean up the Transfer objects allocated in read_thread(). */ free(dev->transfer->buffer); libusb_free_transfer(dev->transfer); /* release the interface */ libusb_release_interface(dev->device_handle, dev->interface); /* Close the handle */ libusb_close(dev->device_handle); /* Clear out the queue of received reports. */ pthread_mutex_lock(&dev->mutex); while (dev->input_reports) { return_data(dev, NULL, 0); } pthread_mutex_unlock(&dev->mutex); free_hid_device(dev); } int HID_API_EXPORT_CALL hid_get_manufacturer_string(hid_device *dev, wchar_t *string, size_t maxlen) { return hid_get_indexed_string(dev, dev->manufacturer_index, string, maxlen); } int HID_API_EXPORT_CALL hid_get_product_string(hid_device *dev, wchar_t *string, size_t maxlen) { return hid_get_indexed_string(dev, dev->product_index, string, maxlen); } int HID_API_EXPORT_CALL hid_get_serial_number_string(hid_device *dev, wchar_t *string, size_t maxlen) { return hid_get_indexed_string(dev, dev->serial_index, string, maxlen); } int HID_API_EXPORT_CALL hid_get_indexed_string(hid_device *dev, int string_index, wchar_t *string, size_t maxlen) { wchar_t *str; str = get_usb_string(dev->device_handle, string_index); if (str) { wcsncpy(string, str, maxlen); string[maxlen-1] = L'\0'; free(str); return 0; } else return -1; } HID_API_EXPORT const wchar_t * HID_API_CALL hid_error(hid_device *dev) { return NULL; } struct lang_map_entry { const char *name; const char *string_code; uint16_t usb_code; }; #define LANG(name,code,usb_code) { name, code, usb_code } static struct lang_map_entry lang_map[] = { LANG("Afrikaans", "af", 0x0436), LANG("Albanian", "sq", 0x041C), LANG("Arabic - United Arab Emirates", "ar_ae", 0x3801), LANG("Arabic - Bahrain", "ar_bh", 0x3C01), LANG("Arabic - Algeria", "ar_dz", 0x1401), LANG("Arabic - Egypt", "ar_eg", 0x0C01), LANG("Arabic - Iraq", "ar_iq", 0x0801), LANG("Arabic - Jordan", "ar_jo", 0x2C01), LANG("Arabic - Kuwait", "ar_kw", 0x3401), LANG("Arabic - Lebanon", "ar_lb", 0x3001), LANG("Arabic - Libya", "ar_ly", 0x1001), LANG("Arabic - Morocco", "ar_ma", 0x1801), LANG("Arabic - Oman", "ar_om", 0x2001), LANG("Arabic - Qatar", "ar_qa", 0x4001), LANG("Arabic - Saudi Arabia", "ar_sa", 0x0401), LANG("Arabic - Syria", "ar_sy", 0x2801), LANG("Arabic - Tunisia", "ar_tn", 0x1C01), LANG("Arabic - Yemen", "ar_ye", 0x2401), LANG("Armenian", "hy", 0x042B), LANG("Azeri - Latin", "az_az", 0x042C), LANG("Azeri - Cyrillic", "az_az", 0x082C), LANG("Basque", "eu", 0x042D), LANG("Belarusian", "be", 0x0423), LANG("Bulgarian", "bg", 0x0402), LANG("Catalan", "ca", 0x0403), LANG("Chinese - China", "zh_cn", 0x0804), LANG("Chinese - Hong Kong SAR", "zh_hk", 0x0C04), LANG("Chinese - Macau SAR", "zh_mo", 0x1404), LANG("Chinese - Singapore", "zh_sg", 0x1004), LANG("Chinese - Taiwan", "zh_tw", 0x0404), LANG("Croatian", "hr", 0x041A), LANG("Czech", "cs", 0x0405), LANG("Danish", "da", 0x0406), LANG("Dutch - Netherlands", "nl_nl", 0x0413), LANG("Dutch - Belgium", "nl_be", 0x0813), LANG("English - Australia", "en_au", 0x0C09), LANG("English - Belize", "en_bz", 0x2809), LANG("English - Canada", "en_ca", 0x1009), LANG("English - Caribbean", "en_cb", 0x2409), LANG("English - Ireland", "en_ie", 0x1809), LANG("English - Jamaica", "en_jm", 0x2009), LANG("English - New Zealand", "en_nz", 0x1409), LANG("English - Phillippines", "en_ph", 0x3409), LANG("English - Southern Africa", "en_za", 0x1C09), LANG("English - Trinidad", "en_tt", 0x2C09), LANG("English - Great Britain", "en_gb", 0x0809), LANG("English - United States", "en_us", 0x0409), LANG("Estonian", "et", 0x0425), LANG("Farsi", "fa", 0x0429), LANG("Finnish", "fi", 0x040B), LANG("Faroese", "fo", 0x0438), LANG("French - France", "fr_fr", 0x040C), LANG("French - Belgium", "fr_be", 0x080C), LANG("French - Canada", "fr_ca", 0x0C0C), LANG("French - Luxembourg", "fr_lu", 0x140C), LANG("French - Switzerland", "fr_ch", 0x100C), LANG("Gaelic - Ireland", "gd_ie", 0x083C), LANG("Gaelic - Scotland", "gd", 0x043C), LANG("German - Germany", "de_de", 0x0407), LANG("German - Austria", "de_at", 0x0C07), LANG("German - Liechtenstein", "de_li", 0x1407), LANG("German - Luxembourg", "de_lu", 0x1007), LANG("German - Switzerland", "de_ch", 0x0807), LANG("Greek", "el", 0x0408), LANG("Hebrew", "he", 0x040D), LANG("Hindi", "hi", 0x0439), LANG("Hungarian", "hu", 0x040E), LANG("Icelandic", "is", 0x040F), LANG("Indonesian", "id", 0x0421), LANG("Italian - Italy", "it_it", 0x0410), LANG("Italian - Switzerland", "it_ch", 0x0810), LANG("Japanese", "ja", 0x0411), LANG("Korean", "ko", 0x0412), LANG("Latvian", "lv", 0x0426), LANG("Lithuanian", "lt", 0x0427), LANG("F.Y.R.O. Macedonia", "mk", 0x042F), LANG("Malay - Malaysia", "ms_my", 0x043E), LANG("Malay – Brunei", "ms_bn", 0x083E), LANG("Maltese", "mt", 0x043A), LANG("Marathi", "mr", 0x044E), LANG("Norwegian - Bokml", "no_no", 0x0414), LANG("Norwegian - Nynorsk", "no_no", 0x0814), LANG("Polish", "pl", 0x0415), LANG("Portuguese - Portugal", "pt_pt", 0x0816), LANG("Portuguese - Brazil", "pt_br", 0x0416), LANG("Raeto-Romance", "rm", 0x0417), LANG("Romanian - Romania", "ro", 0x0418), LANG("Romanian - Republic of Moldova", "ro_mo", 0x0818), LANG("Russian", "ru", 0x0419), LANG("Russian - Republic of Moldova", "ru_mo", 0x0819), LANG("Sanskrit", "sa", 0x044F), LANG("Serbian - Cyrillic", "sr_sp", 0x0C1A), LANG("Serbian - Latin", "sr_sp", 0x081A), LANG("Setsuana", "tn", 0x0432), LANG("Slovenian", "sl", 0x0424), LANG("Slovak", "sk", 0x041B), LANG("Sorbian", "sb", 0x042E), LANG("Spanish - Spain (Traditional)", "es_es", 0x040A), LANG("Spanish - Argentina", "es_ar", 0x2C0A), LANG("Spanish - Bolivia", "es_bo", 0x400A), LANG("Spanish - Chile", "es_cl", 0x340A), LANG("Spanish - Colombia", "es_co", 0x240A), LANG("Spanish - Costa Rica", "es_cr", 0x140A), LANG("Spanish - Dominican Republic", "es_do", 0x1C0A), LANG("Spanish - Ecuador", "es_ec", 0x300A), LANG("Spanish - Guatemala", "es_gt", 0x100A), LANG("Spanish - Honduras", "es_hn", 0x480A), LANG("Spanish - Mexico", "es_mx", 0x080A), LANG("Spanish - Nicaragua", "es_ni", 0x4C0A), LANG("Spanish - Panama", "es_pa", 0x180A), LANG("Spanish - Peru", "es_pe", 0x280A), LANG("Spanish - Puerto Rico", "es_pr", 0x500A), LANG("Spanish - Paraguay", "es_py", 0x3C0A), LANG("Spanish - El Salvador", "es_sv", 0x440A), LANG("Spanish - Uruguay", "es_uy", 0x380A), LANG("Spanish - Venezuela", "es_ve", 0x200A), LANG("Southern Sotho", "st", 0x0430), LANG("Swahili", "sw", 0x0441), LANG("Swedish - Sweden", "sv_se", 0x041D), LANG("Swedish - Finland", "sv_fi", 0x081D), LANG("Tamil", "ta", 0x0449), LANG("Tatar", "tt", 0X0444), LANG("Thai", "th", 0x041E), LANG("Turkish", "tr", 0x041F), LANG("Tsonga", "ts", 0x0431), LANG("Ukrainian", "uk", 0x0422), LANG("Urdu", "ur", 0x0420), LANG("Uzbek - Cyrillic", "uz_uz", 0x0843), LANG("Uzbek – Latin", "uz_uz", 0x0443), LANG("Vietnamese", "vi", 0x042A), LANG("Xhosa", "xh", 0x0434), LANG("Yiddish", "yi", 0x043D), LANG("Zulu", "zu", 0x0435), LANG(NULL, NULL, 0x0), }; uint16_t get_usb_code_for_current_locale(void) { char *locale; char search_string[64]; char *ptr; /* Get the current locale. */ locale = setlocale(0, NULL); if (!locale) return 0x0; /* Make a copy of the current locale string. */ strncpy(search_string, locale, sizeof(search_string)); search_string[sizeof(search_string)-1] = '\0'; /* Chop off the encoding part, and make it lower case. */ ptr = search_string; while (*ptr) { *ptr = tolower(*ptr); if (*ptr == '.') { *ptr = '\0'; break; } ptr++; } /* Find the entry which matches the string code of our locale. */ struct lang_map_entry *lang = lang_map; while (lang->string_code) { if (!strcmp(lang->string_code, search_string)) { return lang->usb_code; } lang++; } /* There was no match. Find with just the language only. */ /* Chop off the variant. Chop it off at the '_'. */ ptr = search_string; while (*ptr) { *ptr = tolower(*ptr); if (*ptr == '_') { *ptr = '\0'; break; } ptr++; } #if 0 // TODO: Do we need this? /* Find the entry which matches the string code of our language. */ lang = lang_map; while (lang->string_code) { if (!strcmp(lang->string_code, search_string)) { return lang->usb_code; } lang++; } #endif /* Found nothing. */ return 0x0; } #ifdef __cplusplus } #endif qthid-4.1-source/firmware.cpp0000644000175000017500000001520712051012677014373 0ustar alcalc/*************************************************************************** * This file is part of Qthid. * * Copyright (C) 2011-2012 Alexandru Csete, OZ9AEC * * Qthid 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 3 of the License, or * (at your option) any later version. * * Qthid 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 Qthid. If not, see . * ***************************************************************************/ #include #include #include #include #include #include #include #include "fcd.h" #include "firmware.h" #include "ui_firmware.h" CFirmware::CFirmware(QWidget *parent) : QDialog(parent), ui(new Ui::CFirmware) { ui->setupUi(this); // disable buttons if lineEdit is empty checkFirmwareSelection(ui->lineEdit->text()); } CFirmware::~CFirmware() { qDebug() << "Firmware dialog destroyed"; delete ui; } void CFirmware::closeEvent(QCloseEvent *event) { qDebug() << "fwDialog closeEvent detected"; event->ignore(); finished(42); } /*! \brief Select a firmware file on disk. */ void CFirmware::on_selectButton_clicked() { // retrieve last used folder QSettings settings; QString path = settings.value("LastFwFolder", QDir::currentPath()).toString(); // execute modal file selector and get FW file name QString fileName = QFileDialog::getOpenFileName(this, tr("Open FCD firmware"), path, tr("FCD firmware files (*.bin)")); if (!fileName.isNull()) { // store selected folder QFileInfo fileInfo(fileName); qDebug() << "FW folder:" << fileInfo.absolutePath(); settings.setValue("LastFwFolder", fileInfo.absolutePath()); // show firmware file path ui->lineEdit->setText(fileName); } } void CFirmware::on_uploadButton_clicked() { qDebug() << "FIXME:" << __func__; #if 0 QFile qf(ui->lineEdit->text()); qint64 qn64size = qf.size(); char *buf=new char[qn64size]; if (buf==NULL) { QMessageBox::critical(this, tr("FCD"), tr("Unable to allocate memory for firmware image")); return; } if (!qf.open(QIODevice::ReadOnly)) { QMessageBox::critical(this, tr("FCD"), tr("Unable to open firmware file:\n").arg(ui->lineEdit->text())); delete buf; return; } else { if (qf.read(buf,qn64size) != qn64size) { QMessageBox::critical(this, tr("FCD"), tr("Unable to read firmware file:\n").arg(ui->lineEdit->text())); delete buf; qf.close(); return; } } qf.close(); ui->statusLabel->setText(tr("Erasing FCD flash...")); ui->lineEdit->setEnabled(false); ui->selectButton->setEnabled(false); ui->uploadButton->setEnabled(false); ui->verifyButton->setEnabled(false); // process pending GUI events before we commit the block loop //qApp->processEvents(); QCoreApplication::processEvents(); // FIXME: neither works // FIXME: progress bar // Erase old firmware then write the new one if (fcdBlErase() != FCD_MODE_BL) { ui->statusLabel->setText(tr("Flash erase failed")); } else { ui->statusLabel->setText(tr("Uploading new firmware...")); if (fcdBlWriteFirmware(buf,(int64_t)qn64size) != FCD_MODE_BL) { ui->statusLabel->setText(tr("Write firmware failed")); } else { ui->statusLabel->setText(tr("Firmware upload successful")); } } ui->lineEdit->setEnabled(true); ui->selectButton->setEnabled(true); checkFirmwareSelection(ui->lineEdit->text()); delete buf; #endif } /*! \brief Verify firmware in FCD. */ void CFirmware::on_verifyButton_clicked() { qDebug() << "FIXME:" << __func__; #if 0 QFile qf(ui->lineEdit->text()); qint64 qn64size = qf.size(); char *buf=new char[qn64size]; if (buf==NULL) { QMessageBox::critical(this, tr("FCD"), tr("Unable to allocate memory for firmware image")); return; } if (!qf.open(QIODevice::ReadOnly)) { QMessageBox::critical(this, tr("FCD"), tr("Unable to open firmware file:\n").arg(ui->lineEdit->text())); delete buf; return; } else { if (qf.read(buf,qn64size) != qn64size) { QMessageBox::critical(this, tr("FCD"), tr("Unable to read firmware file:\n").arg(ui->lineEdit->text())); delete buf; qf.close(); return; } } qf.close(); ui->statusLabel->setText(tr("Verifying firmware in FCD...")); ui->lineEdit->setEnabled(false); ui->selectButton->setEnabled(false); ui->uploadButton->setEnabled(false); ui->verifyButton->setEnabled(false); // process pending GUI events before we commit the block loop //qApp->processEvents(); QCoreApplication::processEvents(); // FIXME: neither works // execute verification // FIXME: progress bar if (fcdBlVerifyFirmware(buf,(int64_t)qn64size) != FCD_MODE_BL) { ui->statusLabel->setText(tr("Firmware verification failed")); } else { ui->statusLabel->setText(tr("Firmware successfully verified")); } ui->lineEdit->setEnabled(true); ui->selectButton->setEnabled(true); checkFirmwareSelection(ui->lineEdit->text()); delete buf; #endif } /*! \brief The text in the lineEdit has changed (via setText). */ void CFirmware::on_lineEdit_textChanged(const QString & text) { checkFirmwareSelection(text); } /*! \brief The text in the lineEdit has been edited by the user. */ void CFirmware::on_lineEdit_textEdited(const QString & text) { checkFirmwareSelection(text); } /*! \brief Check whether fwFile exists and enable/disable Upload and * Verify buttons accordingly. */ void CFirmware::checkFirmwareSelection(const QString &fwFile) { if (QFile::exists(fwFile)) { ui->uploadButton->setEnabled(true); ui->verifyButton->setEnabled(true); } else { ui->uploadButton->setEnabled(false); ui->verifyButton->setEnabled(false); } } qthid-4.1-source/fcd.c0000644000175000017500000005274412051012677012762 0ustar alcalc/*************************************************************************** * This file is part of Qthid. * * Copyright (C) 2010 Howard Long, G6LVB * Copyright (C) 2011 Mario Lorenz, DL5MLO * Copyright (C) 2011-2012 Alexandru Csete, OZ9AEC * * Qthid 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 3 of the License, or * (at your option) any later version. * * Qthid 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 Qthid. If not, see . * ***************************************************************************/ #define FCD #include #ifdef WIN32 #include #else #include #endif #include #include "hidapi.h" #include "fcdhidcmd.h" #include "fcd.h" #define FALSE 0 #define TRUE 1 typedef int BOOL; const unsigned short _usVID=0x04D8; /*!< USB vendor ID. */ const unsigned short _usPID=0xFB31; /*!< USB product ID. */ /** \brief Open FCD device. * \return Pointer to the FCD HID device or NULL if none found * * This function looks for FCD devices connected to the computer and * opens the first one found. */ static hid_device *fcdOpen(void) { struct hid_device_info *phdi=NULL; hid_device *phd=NULL; char *pszPath=NULL; phdi=hid_enumerate(_usVID,_usPID); if (phdi==NULL) { return NULL; // No FCD device found } pszPath=strdup(phdi->path); if (pszPath==NULL) { return NULL; } hid_free_enumeration(phdi); phdi=NULL; if ((phd=hid_open_path(pszPath)) == NULL) { free(pszPath); pszPath=NULL; return NULL; } free(pszPath); pszPath=NULL; return phd; } /** \brief Close FCD HID device. */ static void fcdClose(hid_device *phd) { hid_close(phd); } /** \brief Get FCD mode. * \return The current FCD mode. * \sa FCD_MODE_ENUM */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdGetMode(void) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; FCD_MODE_ENUM fcd_mode = FCD_MODE_NONE; phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } /* Send a BL Query Command */ aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_BL_QUERY; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; /* first check status bytes then check which mode */ if (aucBufIn[0]==FCD_CMD_BL_QUERY && aucBufIn[1]==1) { /* In bootloader mode we have the string "FCDBL" starting at acBufIn[2] **/ if (strncmp((char *)(aucBufIn+2), "FCDBL", 5) == 0) { fcd_mode = FCD_MODE_BL; } /* In application mode we have "FCDAPP_18.06" where the number is the FW version */ else if (strncmp((char *)(aucBufIn+2), "FCDAPP", 6) == 0) { fcd_mode = FCD_MODE_APP; } /* either no FCD or firmware less than 18f */ else { fcd_mode = FCD_MODE_NONE; } } return fcd_mode; } /** \brief Get FCD firmware version as string. * \param str The returned vesion number as a 0 terminated string (must be pre-allocated) * \return The current FCD mode. * \sa FCD_MODE_ENUM */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdGetFwVerStr(char *str) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; FCD_MODE_ENUM fcd_mode = FCD_MODE_NONE; phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } /* Send a BL Query Command */ aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_BL_QUERY; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; /* first check status bytes then check which mode */ if (aucBufIn[0]==FCD_CMD_BL_QUERY && aucBufIn[1]==1) { /* In bootloader mode we have the string "FCDBL" starting at acBufIn[2] **/ if (strncmp((char *)(aucBufIn+2), "FCDBL", 5) == 0) { fcd_mode = FCD_MODE_BL; } /* In application mode we have "FCDAPP_18.06" where the number is the FW version */ else if (strncmp((char *)(aucBufIn+2), "FCDAPP", 6) == 0) { strncpy(str, (char *)(aucBufIn+9), 5); str[5] = 0; fcd_mode = FCD_MODE_APP; } /* either no FCD or firmware less than 18f */ else { fcd_mode = FCD_MODE_NONE; } } return fcd_mode; } /** \brief Reset FCD to bootloader mode. * \return FCD_MODE_NONE * * This function is used to switch the FCD into bootloader mode in which * various firmware operations can be performed. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppReset(void) { hid_device *phd=NULL; //unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } // Send an App reset command aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_RESET; hid_write(phd, aucBufOut, 65); /** FIXME: hid_read() will occasionally hang due to a pthread_cond_wait() never returning. It seems that the read_callback() in hid-libusb.c will never receive any data during the reconfiguration. Since the same logic works in the native windows application, it could be a libusb thing. Anyhow, since the value returned by this function is not used, we may as well just skip the hid_read() and return FME_NONE. Correct switch from APP to BL mode can be observed in /var/log/messages (linux) (when in bootloader mode the device version includes 'BL') */ /* memset(aucBufIn,0xCC,65); // Clear out the response buffer hid_read(phd,aucBufIn,65); if (aucBufIn[0]==FCDCMDAPPRESET && aucBufIn[1]==1) { FCDClose(phd); phd=NULL; return FME_APP; } FCDClose(phd); phd=NULL; return FME_BL; */ fcdClose(phd); phd = NULL; return FCD_MODE_NONE; } /** \brief Set FCD frequency with kHz resolution. * \param nFreq The new frequency in kHz. * \return The FCD mode. * * This function sets the frequency of the FCD with 1 kHz resolution. The parameter * nFreq must already contain any necessary frequency corrention. * * \sa fcdAppSetFreq */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetFreqKhz(int nFreq) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } // Send an App reset command aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_SET_FREQ_KHZ; aucBufOut[2] = (unsigned char)nFreq; aucBufOut[3] = (unsigned char)(nFreq>>8); aucBufOut[4] = (unsigned char)(nFreq>>16); hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_SET_FREQ_KHZ && aucBufIn[1]==1) { return FCD_MODE_APP; } return FCD_MODE_BL; } /** \brief Set FCD frequency with Hz resolution. * \param nFreq The new frequency in Hz. * \param rFreq The actual frequency in Hz returned by the FCD (can be NULL). * \return The FCD mode. * * This function sets the frequency of the FCD with 1 Hz resolution. The parameter * nFreq must already contain any necessary frequency corrention. If rFreq is not NULL * it will contain the actual frequency as returned by the API call. * * \sa fcdAppSetFreqKhz */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetFreq(unsigned int uFreq, unsigned int *rFreq) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } // Send an App reset command aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_SET_FREQ_HZ; aucBufOut[2] = (unsigned char) uFreq; aucBufOut[3] = (unsigned char) (uFreq >> 8); aucBufOut[4] = (unsigned char) (uFreq >> 16); aucBufOut[5] = (unsigned char) (uFreq >> 24); hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_SET_FREQ_HZ && aucBufIn[1]==1) { if (rFreq != NULL) { *rFreq = 0; *rFreq = (unsigned int) aucBufIn[2]; *rFreq += (unsigned int) (aucBufIn[3] << 8); *rFreq += (unsigned int) (aucBufIn[4] << 16); *rFreq += (unsigned int) (aucBufIn[5] << 24); } return FCD_MODE_APP; } return FCD_MODE_BL; } /** \brief Get current FCD frequency with Hz resolution. * \param rFreq The current frequency in Hz returned by the FCD. * \return The FCD mode. * * This function reads the frequency of the FCD with 1 Hz resolution. The parameter * nFreq must already contain any necessary frequency corrention. * * \sa fcdAppSetFreq */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetFreq(unsigned int *rFreq) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (rFreq == NULL) { return FCD_MODE_NONE; } phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_GET_FREQ_HZ; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_GET_FREQ_HZ && aucBufIn[1]==1) { *rFreq = 0; *rFreq = (unsigned int) aucBufIn[2]; *rFreq += (unsigned int) (aucBufIn[3] << 8); *rFreq += (unsigned int) (aucBufIn[4] << 16); *rFreq += (unsigned int) (aucBufIn[5] << 24); return FCD_MODE_APP; } return FCD_MODE_BL; } /** \brief Enable/disable LNA. * \param enabled Whether to enable or disable the LNA (1=ON 0=OFF). * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetLna(char enabled) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_SET_LNA_GAIN; aucBufOut[2] = (unsigned char) enabled; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; return (aucBufIn[0] == FCD_CMD_APP_SET_LNA_GAIN) ? FCD_MODE_APP : FCD_MODE_BL; } /** \brief Get LNA status * \param enabled The current staus of the LNA (1=ON 0=OFF). * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetLna(char *enabled) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (enabled == NULL) return FCD_MODE_NONE; phd = fcdOpen(); if (phd == NULL) return FCD_MODE_NONE; aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_GET_LNA_GAIN; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_GET_LNA_GAIN && aucBufIn[1]==1) { *enabled = aucBufIn[2]; return FCD_MODE_APP; } return FCD_MODE_BL; } /** \brief Select RF filter. * \param filter The new RF filter. * \return The FCD mode. * * \note RF filter is selected by the FCD; using this function may not be very useful, except when * firmware selects wrong filter. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetRfFilter(tuner_rf_filter_t filter) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (filter > TRFE_875_2000) { return FCD_MODE_NONE; } phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_SET_RF_FILTER; aucBufOut[2] = (unsigned char) filter; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; return (aucBufIn[0] == FCD_CMD_APP_SET_RF_FILTER) ? FCD_MODE_APP : FCD_MODE_BL; } /** \brief Get RF filter selection. * \param filter The current RF filter selection. * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetRfFilter(tuner_rf_filter_t *filter) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (filter == NULL) return FCD_MODE_NONE; phd = fcdOpen(); if (phd == NULL) return FCD_MODE_NONE; aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_GET_RF_FILTER; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_GET_RF_FILTER && aucBufIn[1]==1) { *filter = (tuner_rf_filter_t) aucBufIn[2]; return FCD_MODE_APP; } return FCD_MODE_BL; } /** \brief Enable/disable Mixer gain. * \param enabled Whether to enable or disable the mixer gain (1=ON 0=OFF). * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetMixerGain(char enabled) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_SET_MIXER_GAIN; aucBufOut[2] = (unsigned char) enabled; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; return (aucBufIn[0] == FCD_CMD_APP_SET_MIXER_GAIN) ? FCD_MODE_APP : FCD_MODE_BL; } /** \brief Get mixer gain status * \param enabled The current staus of the mixer gain (1=ON 0=OFF). * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetMixerGain(char *enabled) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (enabled == NULL) return FCD_MODE_NONE; phd = fcdOpen(); if (phd == NULL) return FCD_MODE_NONE; aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_GET_MIXER_GAIN; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_GET_MIXER_GAIN && aucBufIn[1]==1) { *enabled = aucBufIn[2]; return FCD_MODE_APP; } return FCD_MODE_BL; } /** \brief Set IF gain. * \param gain The new IF gain between 0 and 59 dB. * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetIfGain(unsigned char gain) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (gain > 59) { return FCD_MODE_NONE; } phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_SET_IF_GAIN; aucBufOut[2] = gain; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; return (aucBufIn[0] == FCD_CMD_APP_SET_IF_GAIN) ? FCD_MODE_APP : FCD_MODE_BL; } /** \brief Get IF gain. * \param filter The current IF gain between 0 and 59 dB. * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetIfGain(unsigned char *gain) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (gain == NULL) return FCD_MODE_NONE; phd = fcdOpen(); if (phd == NULL) return FCD_MODE_NONE; aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_GET_IF_GAIN; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_GET_IF_GAIN && aucBufIn[1]==1) { *gain = aucBufIn[2]; return FCD_MODE_APP; } return FCD_MODE_BL; } /** \brief Select IF filter. * \param filter The new IF filter. * \return The FCD mode. * * \note IF filter is selected by the FCD; using this function may not be very useful, except when * firmware selects the wrong filter. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetIfFilter(tuner_if_filter_t filter) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (filter > TIFE_8MHZ) { return FCD_MODE_NONE; } phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_SET_IF_FILTER; aucBufOut[2] = (unsigned char) filter; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; return (aucBufIn[0] == FCD_CMD_APP_SET_IF_FILTER) ? FCD_MODE_APP : FCD_MODE_BL; } /** \brief Get IF filter selection. * \param filter The current IF filter selection. * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetIfFilter(tuner_if_filter_t *filter) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (filter == NULL) return FCD_MODE_NONE; phd = fcdOpen(); if (phd == NULL) return FCD_MODE_NONE; aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_GET_IF_FILTER; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_GET_IF_FILTER && aucBufIn[1]==1) { *filter = (tuner_if_filter_t) aucBufIn[2]; return FCD_MODE_APP; } return FCD_MODE_BL; } /** \brief Enable/disable Bias T. * \param enabled Whether to enable or disable the Bias T (1=ON 0=OFF). * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetBiasTee(char enabled) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; phd = fcdOpen(); if (phd == NULL) { return FCD_MODE_NONE; } aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_SET_BIAS_TEE; aucBufOut[2] = (unsigned char) enabled; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; return (aucBufIn[0] == FCD_CMD_APP_SET_BIAS_TEE) ? FCD_MODE_APP : FCD_MODE_BL; } /** \brief Get Bias T status * \param enabled The current staus of the Bias T (1=ON 0=OFF). * \return The FCD mode. */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetBiasTee(char *enabled) { hid_device *phd=NULL; unsigned char aucBufIn[65]; unsigned char aucBufOut[65]; if (enabled == NULL) return FCD_MODE_NONE; phd = fcdOpen(); if (phd == NULL) return FCD_MODE_NONE; aucBufOut[0] = 0; // Report ID. Ignored by HID Class firmware as only config'd for one report aucBufOut[1] = FCD_CMD_APP_GET_BIAS_TEE; hid_write(phd, aucBufOut, 65); memset(aucBufIn, 0xCC, 65); // Clear out the response buffer hid_read(phd, aucBufIn, 65); fcdClose(phd); phd = NULL; if (aucBufIn[0]==FCD_CMD_APP_GET_BIAS_TEE && aucBufIn[1]==1) { *enabled = aucBufIn[2]; return FCD_MODE_APP; } return FCD_MODE_BL; } qthid-4.1-source/qthid.qrc0000644000175000017500000000061312051012642013656 0ustar alcalc images/qthid.png images/rfchain.png images/help.png images/save.png images/open.png images/fw.png images/iq.png images/quit.png images/info.png qthid-4.1-source/fcd.h0000644000175000017500000000630712051012677012761 0ustar alcalc/*************************************************************************** * This file is part of Qthid. * * Copyright (C) 2010 Howard Long, G6LVB * Copyright (C) 2011 Mario Lorenz, DL5MLO * Copyright (C) 2011-2012 Alexandru Csete, OZ9AEC * * Qthid 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 3 of the License, or * (at your option) any later version. * * Qthid 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 Qthid. If not, see . * ***************************************************************************/ #ifndef FCD_H #define FCD_H 1 #ifdef FCD #define EXTERN #define ASSIGN(x) =x #else #define EXTERN extern #define ASSIGN(x) #endif #ifdef _WIN32 #define FCD_API_EXPORT __declspec(dllexport) #define FCD_API_CALL _stdcall #else #define FCD_API_EXPORT #define FCD_API_CALL #endif #include #include "fcdhidcmd.h" /** \brief FCD mode enumeration. */ typedef enum { FCD_MODE_NONE, /*!< No FCD detected. */ FCD_MODE_BL, /*!< FCD present in bootloader mode. */ FCD_MODE_APP /*!< FCD present in application mode. */ } FCD_MODE_ENUM; // The current mode of the FCD: no FCD, in bootloader mode or in normal application mode #ifdef __cplusplus extern "C" { #endif /* Application functions */ EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdGetMode(void); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdGetFwVerStr(char *str); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppReset(void); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetFreqKhz(int nFreq); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetFreq(unsigned int uFreq, unsigned int *rFreq); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetFreq(unsigned int *rFreq); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetLna(char enabled); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetLna(char *enabled); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetRfFilter(tuner_rf_filter_t filter); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetRfFilter(tuner_rf_filter_t *filter); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetMixerGain(char enabled); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetMixerGain(char *enabled); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetIfGain(unsigned char gain); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetIfGain(unsigned char *gain); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetIfFilter(tuner_if_filter_t filter); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetIfFilter(tuner_if_filter_t *filter); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppSetBiasTee(char enabled); EXTERN FCD_API_EXPORT FCD_API_CALL FCD_MODE_ENUM fcdAppGetBiasTee(char *enabled); #ifdef __cplusplus } #endif #endif // FCD_H qthid-4.1-source/hidmac.c0000644000175000017500000006667412051012677013462 0ustar alcalc/******************************************************* HIDAPI - Multi-Platform library for communication with HID devices. Alan Ott Signal 11 Software 2010-07-03 Copyright 2010, All Rights Reserved. At the discretion of the user of this library, this software may be licensed under the terms of the GNU Public License v3, a BSD-Style license, or the original HIDAPI license as outlined in the LICENSE.txt, LICENSE-gpl3.txt, LICENSE-bsd.txt, and LICENSE-orig.txt files located at the root of the source distribution. These files may also be found in the public source code repository located at: http://github.com/signal11/hidapi . ********************************************************/ /* See Apple Technical Note TN2187 for details on IOHidManager. */ #include #include #include #include #include #include #include #include #include "hidapi.h" /* Barrier implementation because Mac OSX doesn't have pthread_barrier. It also doesn't have clock_gettime(). So much for POSIX and SUSv2. This implementation came from Brent Priddy and was posted on StackOverflow. It is used with his permission. */ typedef int pthread_barrierattr_t; typedef struct pthread_barrier { pthread_mutex_t mutex; pthread_cond_t cond; int count; int trip_count; } pthread_barrier_t; static int pthread_barrier_init(pthread_barrier_t *barrier, const pthread_barrierattr_t *attr, unsigned int count) { if(count == 0) { errno = EINVAL; return -1; } if(pthread_mutex_init(&barrier->mutex, 0) < 0) { return -1; } if(pthread_cond_init(&barrier->cond, 0) < 0) { pthread_mutex_destroy(&barrier->mutex); return -1; } barrier->trip_count = count; barrier->count = 0; return 0; } static int pthread_barrier_destroy(pthread_barrier_t *barrier) { pthread_cond_destroy(&barrier->cond); pthread_mutex_destroy(&barrier->mutex); return 0; } static int pthread_barrier_wait(pthread_barrier_t *barrier) { pthread_mutex_lock(&barrier->mutex); ++(barrier->count); if(barrier->count >= barrier->trip_count) { barrier->count = 0; pthread_cond_broadcast(&barrier->cond); pthread_mutex_unlock(&barrier->mutex); return 1; } else { pthread_cond_wait(&barrier->cond, &(barrier->mutex)); pthread_mutex_unlock(&barrier->mutex); return 0; } } static int return_data(hid_device *dev, unsigned char *data, size_t length); /* Linked List of input reports received from the device. */ struct input_report { uint8_t *data; size_t len; struct input_report *next; }; struct hid_device_ { IOHIDDeviceRef device_handle; int blocking; int uses_numbered_reports; int disconnected; CFStringRef run_loop_mode; CFRunLoopRef run_loop; CFRunLoopSourceRef source; uint8_t *input_report_buf; CFIndex max_input_report_len; struct input_report *input_reports; pthread_t thread; pthread_mutex_t mutex; /* Protects input_reports */ pthread_cond_t condition; pthread_barrier_t barrier; /* Ensures correct startup sequence */ pthread_barrier_t shutdown_barrier; /* Ensures correct shutdown sequence */ int shutdown_thread; }; static hid_device *new_hid_device(void) { hid_device *dev = calloc(1, sizeof(hid_device)); dev->device_handle = NULL; dev->blocking = 1; dev->uses_numbered_reports = 0; dev->disconnected = 0; dev->run_loop_mode = NULL; dev->run_loop = NULL; dev->source = NULL; dev->input_report_buf = NULL; dev->input_reports = NULL; dev->shutdown_thread = 0; /* Thread objects */ pthread_mutex_init(&dev->mutex, NULL); pthread_cond_init(&dev->condition, NULL); pthread_barrier_init(&dev->barrier, NULL, 2); pthread_barrier_init(&dev->shutdown_barrier, NULL, 2); return dev; } static void free_hid_device(hid_device *dev) { if (!dev) return; /* Delete any input reports still left over. */ struct input_report *rpt = dev->input_reports; while (rpt) { struct input_report *next = rpt->next; free(rpt->data); free(rpt); rpt = next; } /* Free the string and the report buffer. The check for NULL is necessary here as CFRelease() doesn't handle NULL like free() and others do. */ if (dev->run_loop_mode) CFRelease(dev->run_loop_mode); if (dev->source) CFRelease(dev->source); free(dev->input_report_buf); /* Clean up the thread objects */ pthread_barrier_destroy(&dev->shutdown_barrier); pthread_barrier_destroy(&dev->barrier); pthread_cond_destroy(&dev->condition); pthread_mutex_destroy(&dev->mutex); /* Free the structure itself. */ free(dev); } static IOHIDManagerRef hid_mgr = 0x0; #if 0 static void register_error(hid_device *device, const char *op) { } #endif static int32_t get_int_property(IOHIDDeviceRef device, CFStringRef key) { CFTypeRef ref; int32_t value; ref = IOHIDDeviceGetProperty(device, key); if (ref) { if (CFGetTypeID(ref) == CFNumberGetTypeID()) { CFNumberGetValue((CFNumberRef) ref, kCFNumberSInt32Type, &value); return value; } } return 0; } static unsigned short get_vendor_id(IOHIDDeviceRef device) { return get_int_property(device, CFSTR(kIOHIDVendorIDKey)); } static unsigned short get_product_id(IOHIDDeviceRef device) { return get_int_property(device, CFSTR(kIOHIDProductIDKey)); } static int32_t get_max_report_length(IOHIDDeviceRef device) { return get_int_property(device, CFSTR(kIOHIDMaxInputReportSizeKey)); } static int get_string_property(IOHIDDeviceRef device, CFStringRef prop, wchar_t *buf, size_t len) { CFStringRef str; if (!len) return 0; str = IOHIDDeviceGetProperty(device, prop); buf[0] = 0; if (str) { len --; CFIndex str_len = CFStringGetLength(str); CFRange range; range.location = 0; range.length = (str_len > len)? len: str_len; CFIndex used_buf_len; CFIndex chars_copied; chars_copied = CFStringGetBytes(str, range, kCFStringEncodingUTF32LE, (char)'?', FALSE, (UInt8*)buf, len, &used_buf_len); buf[chars_copied] = 0; return 0; } else return -1; } static int get_string_property_utf8(IOHIDDeviceRef device, CFStringRef prop, char *buf, size_t len) { CFStringRef str; if (!len) return 0; str = IOHIDDeviceGetProperty(device, prop); buf[0] = 0; if (str) { len--; CFIndex str_len = CFStringGetLength(str); CFRange range; range.location = 0; range.length = (str_len > len)? len: str_len; CFIndex used_buf_len; CFIndex chars_copied; chars_copied = CFStringGetBytes(str, range, kCFStringEncodingUTF8, (char)'?', FALSE, (UInt8*)buf, len, &used_buf_len); buf[chars_copied] = 0; return used_buf_len; } else return 0; } static int get_serial_number(IOHIDDeviceRef device, wchar_t *buf, size_t len) { return get_string_property(device, CFSTR(kIOHIDSerialNumberKey), buf, len); } static int get_manufacturer_string(IOHIDDeviceRef device, wchar_t *buf, size_t len) { return get_string_property(device, CFSTR(kIOHIDManufacturerKey), buf, len); } static int get_product_string(IOHIDDeviceRef device, wchar_t *buf, size_t len) { return get_string_property(device, CFSTR(kIOHIDProductKey), buf, len); } /* Implementation of wcsdup() for Mac. */ static wchar_t *dup_wcs(const wchar_t *s) { size_t len = wcslen(s); wchar_t *ret = malloc((len+1)*sizeof(wchar_t)); wcscpy(ret, s); return ret; } static int make_path(IOHIDDeviceRef device, char *buf, size_t len) { int res; unsigned short vid, pid; char transport[32]; buf[0] = '\0'; res = get_string_property_utf8( device, CFSTR(kIOHIDTransportKey), transport, sizeof(transport)); if (!res) return -1; vid = get_vendor_id(device); pid = get_product_id(device); res = snprintf(buf, len, "%s_%04hx_%04hx_%p", transport, vid, pid, device); buf[len-1] = '\0'; return res+1; } /* Initialize the IOHIDManager. Return 0 for success and -1 for failure. */ static int init_hid_manager(void) { /* Initialize all the HID Manager Objects */ hid_mgr = IOHIDManagerCreate(kCFAllocatorDefault, kIOHIDOptionsTypeNone); if (hid_mgr) { IOHIDManagerSetDeviceMatching(hid_mgr, NULL); IOHIDManagerScheduleWithRunLoop(hid_mgr, CFRunLoopGetCurrent(), kCFRunLoopDefaultMode); return 0; } return -1; } /* Initialize the IOHIDManager if necessary. This is the public function, and it is safe to call this function repeatedly. Return 0 for success and -1 for failure. */ int HID_API_EXPORT hid_init(void) { if (!hid_mgr) { return init_hid_manager(); } /* Already initialized. */ return 0; } int HID_API_EXPORT hid_exit(void) { if (hid_mgr) { /* Close the HID manager. */ IOHIDManagerClose(hid_mgr, kIOHIDOptionsTypeNone); CFRelease(hid_mgr); hid_mgr = NULL; } return 0; } static void process_pending_events(void) { SInt32 res; do { res = CFRunLoopRunInMode(kCFRunLoopDefaultMode, 0.001, FALSE); } while(res != kCFRunLoopRunFinished && res != kCFRunLoopRunTimedOut); } struct hid_device_info HID_API_EXPORT *hid_enumerate(unsigned short vendor_id, unsigned short product_id) { struct hid_device_info *root = NULL; // return object struct hid_device_info *cur_dev = NULL; CFIndex num_devices; int i; /* Set up the HID Manager if it hasn't been done */ if (hid_init() < 0) return NULL; /* give the IOHIDManager a chance to update itself */ process_pending_events(); /* Get a list of the Devices */ CFSetRef device_set = IOHIDManagerCopyDevices(hid_mgr); /* Convert the list into a C array so we can iterate easily. */ num_devices = CFSetGetCount(device_set); IOHIDDeviceRef *device_array = calloc(num_devices, sizeof(IOHIDDeviceRef)); CFSetGetValues(device_set, (const void **) device_array); /* Iterate over each device, making an entry for it. */ for (i = 0; i < num_devices; i++) { unsigned short dev_vid; unsigned short dev_pid; #define BUF_LEN 256 wchar_t buf[BUF_LEN]; char cbuf[BUF_LEN]; IOHIDDeviceRef dev = device_array[i]; if (!dev) { continue; } dev_vid = get_vendor_id(dev); dev_pid = get_product_id(dev); /* Check the VID/PID against the arguments */ if ((vendor_id == 0x0 && product_id == 0x0) || (vendor_id == dev_vid && product_id == dev_pid)) { struct hid_device_info *tmp; size_t len; /* VID/PID match. Create the record. */ tmp = malloc(sizeof(struct hid_device_info)); if (cur_dev) { cur_dev->next = tmp; } else { root = tmp; } cur_dev = tmp; // Get the Usage Page and Usage for this device. cur_dev->usage_page = get_int_property(dev, CFSTR(kIOHIDPrimaryUsagePageKey)); cur_dev->usage = get_int_property(dev, CFSTR(kIOHIDPrimaryUsageKey)); /* Fill out the record */ cur_dev->next = NULL; len = make_path(dev, cbuf, sizeof(cbuf)); cur_dev->path = strdup(cbuf); /* Serial Number */ get_serial_number(dev, buf, BUF_LEN); cur_dev->serial_number = dup_wcs(buf); /* Manufacturer and Product strings */ get_manufacturer_string(dev, buf, BUF_LEN); cur_dev->manufacturer_string = dup_wcs(buf); get_product_string(dev, buf, BUF_LEN); cur_dev->product_string = dup_wcs(buf); /* VID/PID */ cur_dev->vendor_id = dev_vid; cur_dev->product_id = dev_pid; /* Release Number */ cur_dev->release_number = get_int_property(dev, CFSTR(kIOHIDVersionNumberKey)); /* Interface Number (Unsupported on Mac)*/ cur_dev->interface_number = -1; } } free(device_array); CFRelease(device_set); return root; } void HID_API_EXPORT hid_free_enumeration(struct hid_device_info *devs) { /* This function is identical to the Linux version. Platform independent. */ struct hid_device_info *d = devs; while (d) { struct hid_device_info *next = d->next; free(d->path); free(d->serial_number); free(d->manufacturer_string); free(d->product_string); free(d); d = next; } } hid_device * HID_API_EXPORT hid_open(unsigned short vendor_id, unsigned short product_id, const wchar_t *serial_number) { /* This function is identical to the Linux version. Platform independent. */ struct hid_device_info *devs, *cur_dev; const char *path_to_open = NULL; hid_device * handle = NULL; devs = hid_enumerate(vendor_id, product_id); cur_dev = devs; while (cur_dev) { if (cur_dev->vendor_id == vendor_id && cur_dev->product_id == product_id) { if (serial_number) { if (wcscmp(serial_number, cur_dev->serial_number) == 0) { path_to_open = cur_dev->path; break; } } else { path_to_open = cur_dev->path; break; } } cur_dev = cur_dev->next; } if (path_to_open) { /* Open the device */ handle = hid_open_path(path_to_open); } hid_free_enumeration(devs); return handle; } static void hid_device_removal_callback(void *context, IOReturn result, void *sender) { /* Stop the Run Loop for this device. */ hid_device *d = context; d->disconnected = 1; CFRunLoopStop(d->run_loop); } /* The Run Loop calls this function for each input report received. This function puts the data into a linked list to be picked up by hid_read(). */ static void hid_report_callback(void *context, IOReturn result, void *sender, IOHIDReportType report_type, uint32_t report_id, uint8_t *report, CFIndex report_length) { struct input_report *rpt; hid_device *dev = context; /* Make a new Input Report object */ rpt = calloc(1, sizeof(struct input_report)); rpt->data = calloc(1, report_length); memcpy(rpt->data, report, report_length); rpt->len = report_length; rpt->next = NULL; /* Lock this section */ pthread_mutex_lock(&dev->mutex); /* Attach the new report object to the end of the list. */ if (dev->input_reports == NULL) { /* The list is empty. Put it at the root. */ dev->input_reports = rpt; } else { /* Find the end of the list and attach. */ struct input_report *cur = dev->input_reports; int num_queued = 0; while (cur->next != NULL) { cur = cur->next; num_queued++; } cur->next = rpt; /* Pop one off if we've reached 30 in the queue. This way we don't grow forever if the user never reads anything from the device. */ if (num_queued > 30) { return_data(dev, NULL, 0); } } /* Signal a waiting thread that there is data. */ pthread_cond_signal(&dev->condition); /* Unlock */ pthread_mutex_unlock(&dev->mutex); } /* This gets called when the read_thred's run loop gets signaled by hid_close(), and serves to stop the read_thread's run loop. */ static void perform_signal_callback(void *context) { hid_device *dev = context; CFRunLoopStop(dev->run_loop); //TODO: CFRunLoopGetCurrent() } static void *read_thread(void *param) { hid_device *dev = param; /* Move the device's run loop to this thread. */ IOHIDDeviceScheduleWithRunLoop(dev->device_handle, CFRunLoopGetCurrent(), dev->run_loop_mode); /* Create the RunLoopSource which is used to signal the event loop to stop when hid_close() is called. */ CFRunLoopSourceContext ctx; memset(&ctx, 0, sizeof(ctx)); ctx.version = 0; ctx.info = dev; ctx.perform = &perform_signal_callback; dev->source = CFRunLoopSourceCreate(kCFAllocatorDefault, 0/*order*/, &ctx); CFRunLoopAddSource(CFRunLoopGetCurrent(), dev->source, dev->run_loop_mode); /* Store off the Run Loop so it can be stopped from hid_close() and on device disconnection. */ dev->run_loop = CFRunLoopGetCurrent(); /* Notify the main thread that the read thread is up and running. */ pthread_barrier_wait(&dev->barrier); /* Run the Event Loop. CFRunLoopRunInMode() will dispatch HID input reports into the hid_report_callback(). */ SInt32 code; while (!dev->shutdown_thread && !dev->disconnected) { code = CFRunLoopRunInMode(dev->run_loop_mode, 1000/*sec*/, FALSE); /* Return if the device has been disconnected */ if (code == kCFRunLoopRunFinished) { dev->disconnected = 1; break; } /* Break if The Run Loop returns Finished or Stopped. */ if (code != kCFRunLoopRunTimedOut && code != kCFRunLoopRunHandledSource) { /* There was some kind of error. Setting shutdown seems to make sense, but there may be something else more appropriate */ dev->shutdown_thread = 1; break; } } /* Now that the read thread is stopping, Wake any threads which are waiting on data (in hid_read_timeout()). Do this under a mutex to make sure that a thread which is about to go to sleep waiting on the condition acutally will go to sleep before the condition is signaled. */ pthread_mutex_lock(&dev->mutex); pthread_cond_broadcast(&dev->condition); pthread_mutex_unlock(&dev->mutex); /* Wait here until hid_close() is called and makes it past the call to CFRunLoopWakeUp(). This thread still needs to be valid when that function is called on the other thread. */ pthread_barrier_wait(&dev->shutdown_barrier); return NULL; } hid_device * HID_API_EXPORT hid_open_path(const char *path) { int i; hid_device *dev = NULL; CFIndex num_devices; dev = new_hid_device(); /* Set up the HID Manager if it hasn't been done */ if (hid_init() < 0) return NULL; /* give the IOHIDManager a chance to update itself */ process_pending_events(); CFSetRef device_set = IOHIDManagerCopyDevices(hid_mgr); num_devices = CFSetGetCount(device_set); IOHIDDeviceRef *device_array = calloc(num_devices, sizeof(IOHIDDeviceRef)); CFSetGetValues(device_set, (const void **) device_array); for (i = 0; i < num_devices; i++) { char cbuf[BUF_LEN]; size_t len; IOHIDDeviceRef os_dev = device_array[i]; len = make_path(os_dev, cbuf, sizeof(cbuf)); if (!strcmp(cbuf, path)) { // Matched Paths. Open this Device. IOReturn ret = IOHIDDeviceOpen(os_dev, kIOHIDOptionsTypeNone); if (ret == kIOReturnSuccess) { char str[32]; free(device_array); CFRetain(os_dev); CFRelease(device_set); dev->device_handle = os_dev; /* Create the buffers for receiving data */ dev->max_input_report_len = (CFIndex) get_max_report_length(os_dev); dev->input_report_buf = calloc(dev->max_input_report_len, sizeof(uint8_t)); /* Create the Run Loop Mode for this device. printing the reference seems to work. */ sprintf(str, "HIDAPI_%p", os_dev); dev->run_loop_mode = CFStringCreateWithCString(NULL, str, kCFStringEncodingASCII); /* Attach the device to a Run Loop */ IOHIDDeviceRegisterInputReportCallback( os_dev, dev->input_report_buf, dev->max_input_report_len, &hid_report_callback, dev); IOHIDDeviceRegisterRemovalCallback(dev->device_handle, hid_device_removal_callback, dev); /* Start the read thread */ pthread_create(&dev->thread, NULL, read_thread, dev); /* Wait here for the read thread to be initialized. */ pthread_barrier_wait(&dev->barrier); return dev; } else { goto return_error; } } } return_error: free(device_array); CFRelease(device_set); free_hid_device(dev); return NULL; } static int set_report(hid_device *dev, IOHIDReportType type, const unsigned char *data, size_t length) { const unsigned char *data_to_send; size_t length_to_send; IOReturn res; /* Return if the device has been disconnected. */ if (dev->disconnected) return -1; if (data[0] == 0x0) { /* Not using numbered Reports. Don't send the report number. */ data_to_send = data+1; length_to_send = length-1; } else { /* Using numbered Reports. Send the Report Number */ data_to_send = data; length_to_send = length; } if (!dev->disconnected) { res = IOHIDDeviceSetReport(dev->device_handle, type, data[0], /* Report ID*/ data_to_send, length_to_send); if (res == kIOReturnSuccess) { return length; } else return -1; } return -1; } int HID_API_EXPORT hid_write(hid_device *dev, const unsigned char *data, size_t length) { return set_report(dev, kIOHIDReportTypeOutput, data, length); } /* Helper function, so that this isn't duplicated in hid_read(). */ static int return_data(hid_device *dev, unsigned char *data, size_t length) { /* Copy the data out of the linked list item (rpt) into the return buffer (data), and delete the liked list item. */ struct input_report *rpt = dev->input_reports; size_t len = (length < rpt->len)? length: rpt->len; memcpy(data, rpt->data, len); dev->input_reports = rpt->next; free(rpt->data); free(rpt); return len; } static int cond_wait(const hid_device *dev, pthread_cond_t *cond, pthread_mutex_t *mutex) { while (!dev->input_reports) { int res = pthread_cond_wait(cond, mutex); if (res != 0) return res; /* A res of 0 means we may have been signaled or it may be a spurious wakeup. Check to see that there's acutally data in the queue before returning, and if not, go back to sleep. See the pthread_cond_timedwait() man page for details. */ if (dev->shutdown_thread || dev->disconnected) return -1; } return 0; } static int cond_timedwait(const hid_device *dev, pthread_cond_t *cond, pthread_mutex_t *mutex, const struct timespec *abstime) { while (!dev->input_reports) { int res = pthread_cond_timedwait(cond, mutex, abstime); if (res != 0) return res; /* A res of 0 means we may have been signaled or it may be a spurious wakeup. Check to see that there's acutally data in the queue before returning, and if not, go back to sleep. See the pthread_cond_timedwait() man page for details. */ if (dev->shutdown_thread || dev->disconnected) return -1; } return 0; } int HID_API_EXPORT hid_read_timeout(hid_device *dev, unsigned char *data, size_t length, int milliseconds) { int bytes_read = -1; /* Lock the access to the report list. */ pthread_mutex_lock(&dev->mutex); /* There's an input report queued up. Return it. */ if (dev->input_reports) { /* Return the first one */ bytes_read = return_data(dev, data, length); goto ret; } /* Return if the device has been disconnected. */ if (dev->disconnected) { bytes_read = -1; goto ret; } if (dev->shutdown_thread) { /* This means the device has been closed (or there has been an error. An error code of -1 should be returned. */ bytes_read = -1; goto ret; } /* There is no data. Go to sleep and wait for data. */ if (milliseconds == -1) { /* Blocking */ int res; res = cond_wait(dev, &dev->condition, &dev->mutex); if (res == 0) bytes_read = return_data(dev, data, length); else { /* There was an error, or a device disconnection. */ bytes_read = -1; } } else if (milliseconds > 0) { /* Non-blocking, but called with timeout. */ int res; struct timespec ts; struct timeval tv; gettimeofday(&tv, NULL); TIMEVAL_TO_TIMESPEC(&tv, &ts); ts.tv_sec += milliseconds / 1000; ts.tv_nsec += (milliseconds % 1000) * 1000000; if (ts.tv_nsec >= 1000000000L) { ts.tv_sec++; ts.tv_nsec -= 1000000000L; } res = cond_timedwait(dev, &dev->condition, &dev->mutex, &ts); if (res == 0) bytes_read = return_data(dev, data, length); else if (res == ETIMEDOUT) bytes_read = 0; else bytes_read = -1; } else { /* Purely non-blocking */ bytes_read = 0; } ret: /* Unlock */ pthread_mutex_unlock(&dev->mutex); return bytes_read; } int HID_API_EXPORT hid_read(hid_device *dev, unsigned char *data, size_t length) { return hid_read_timeout(dev, data, length, (dev->blocking)? -1: 0); } int HID_API_EXPORT hid_set_nonblocking(hid_device *dev, int nonblock) { /* All Nonblocking operation is handled by the library. */ dev->blocking = !nonblock; return 0; } int HID_API_EXPORT hid_send_feature_report(hid_device *dev, const unsigned char *data, size_t length) { return set_report(dev, kIOHIDReportTypeFeature, data, length); } int HID_API_EXPORT hid_get_feature_report(hid_device *dev, unsigned char *data, size_t length) { CFIndex len = length; IOReturn res; /* Return if the device has been unplugged. */ if (dev->disconnected) return -1; res = IOHIDDeviceGetReport(dev->device_handle, kIOHIDReportTypeFeature, data[0], /* Report ID */ data, &len); if (res == kIOReturnSuccess) return len; else return -1; } void HID_API_EXPORT hid_close(hid_device *dev) { if (!dev) return; /* Disconnect the report callback before close. */ if (!dev->disconnected) { IOHIDDeviceRegisterInputReportCallback( dev->device_handle, dev->input_report_buf, dev->max_input_report_len, NULL, dev); IOHIDManagerRegisterDeviceRemovalCallback(hid_mgr, NULL, dev); IOHIDDeviceUnscheduleFromRunLoop(dev->device_handle, dev->run_loop, dev->run_loop_mode); IOHIDDeviceScheduleWithRunLoop(dev->device_handle, CFRunLoopGetMain(), kCFRunLoopDefaultMode); } /* Cause read_thread() to stop. */ dev->shutdown_thread = 1; /* Wake up the run thread's event loop so that the thread can exit. */ CFRunLoopSourceSignal(dev->source); CFRunLoopWakeUp(dev->run_loop); /* Notify the read thread that it can shut down now. */ pthread_barrier_wait(&dev->shutdown_barrier); /* Wait for read_thread() to end. */ pthread_join(dev->thread, NULL); /* Close the OS handle to the device, but only if it's not been unplugged. If it's been unplugged, then calling IOHIDDeviceClose() will crash. */ if (!dev->disconnected) { IOHIDDeviceClose(dev->device_handle, kIOHIDOptionsTypeNone); } /* Clear out the queue of received reports. */ pthread_mutex_lock(&dev->mutex); while (dev->input_reports) { return_data(dev, NULL, 0); } pthread_mutex_unlock(&dev->mutex); CFRelease(dev->device_handle); free_hid_device(dev); } int HID_API_EXPORT_CALL hid_get_manufacturer_string(hid_device *dev, wchar_t *string, size_t maxlen) { return get_manufacturer_string(dev->device_handle, string, maxlen); } int HID_API_EXPORT_CALL hid_get_product_string(hid_device *dev, wchar_t *string, size_t maxlen) { return get_product_string(dev->device_handle, string, maxlen); } int HID_API_EXPORT_CALL hid_get_serial_number_string(hid_device *dev, wchar_t *string, size_t maxlen) { return get_serial_number(dev->device_handle, string, maxlen); } int HID_API_EXPORT_CALL hid_get_indexed_string(hid_device *dev, int string_index, wchar_t *string, size_t maxlen) { // TODO: return 0; } HID_API_EXPORT const wchar_t * HID_API_CALL hid_error(hid_device *dev) { // TODO: return NULL; } #if 0 static int32_t get_location_id(IOHIDDeviceRef device) { return get_int_property(device, CFSTR(kIOHIDLocationIDKey)); } static int32_t get_usage(IOHIDDeviceRef device) { int32_t res; res = get_int_property(device, CFSTR(kIOHIDDeviceUsageKey)); if (!res) res = get_int_property(device, CFSTR(kIOHIDPrimaryUsageKey)); return res; } static int32_t get_usage_page(IOHIDDeviceRef device) { int32_t res; res = get_int_property(device, CFSTR(kIOHIDDeviceUsagePageKey)); if (!res) res = get_int_property(device, CFSTR(kIOHIDPrimaryUsagePageKey)); return res; } static int get_transport(IOHIDDeviceRef device, wchar_t *buf, size_t len) { return get_string_property(device, CFSTR(kIOHIDTransportKey), buf, len); } int main(void) { IOHIDManagerRef mgr; int i; mgr = IOHIDManagerCreate(kCFAllocatorDefault, kIOHIDOptionsTypeNone); IOHIDManagerSetDeviceMatching(mgr, NULL); IOHIDManagerOpen(mgr, kIOHIDOptionsTypeNone); CFSetRef device_set = IOHIDManagerCopyDevices(mgr); CFIndex num_devices = CFSetGetCount(device_set); IOHIDDeviceRef *device_array = calloc(num_devices, sizeof(IOHIDDeviceRef)); CFSetGetValues(device_set, (const void **) device_array); for (i = 0; i < num_devices; i++) { IOHIDDeviceRef dev = device_array[i]; printf("Device: %p\n", dev); printf(" %04hx %04hx\n", get_vendor_id(dev), get_product_id(dev)); wchar_t serial[256], buf[256]; char cbuf[256]; get_serial_number(dev, serial, 256); printf(" Serial: %ls\n", serial); printf(" Loc: %ld\n", get_location_id(dev)); get_transport(dev, buf, 256); printf(" Trans: %ls\n", buf); make_path(dev, cbuf, 256); printf(" Path: %s\n", cbuf); } return 0; } #endif qthid-4.1-source/hidwin.c0000644000175000017500000005751412051012677013510 0ustar alcalc/******************************************************* HIDAPI - Multi-Platform library for communication with HID devices. Alan Ott Signal 11 Software 8/22/2009 Copyright 2009, All Rights Reserved. At the discretion of the user of this library, this software may be licensed under the terms of the GNU Public License v3, a BSD-Style license, or the original HIDAPI license as outlined in the LICENSE.txt, LICENSE-gpl3.txt, LICENSE-bsd.txt, and LICENSE-orig.txt files located at the root of the source distribution. These files may also be found in the public source code repository located at: http://github.com/signal11/hidapi . ********************************************************/ #include #ifndef _NTDEF_ typedef LONG NTSTATUS; #endif #ifdef __MINGW32__ #include #include #endif #ifdef __CYGWIN__ #include #define _wcsdup wcsdup #endif //#define HIDAPI_USE_DDK #ifdef __cplusplus extern "C" { #endif #include #include #ifdef HIDAPI_USE_DDK #include #endif // Copied from inc/ddk/hidclass.h, part of the Windows DDK. #define HID_OUT_CTL_CODE(id) \ CTL_CODE(FILE_DEVICE_KEYBOARD, (id), METHOD_OUT_DIRECT, FILE_ANY_ACCESS) #define IOCTL_HID_GET_FEATURE HID_OUT_CTL_CODE(100) #ifdef __cplusplus } // extern "C" #endif #include #include #include "hidapi.h" #ifdef _MSC_VER // Thanks Microsoft, but I know how to use strncpy(). #pragma warning(disable:4996) #endif #ifdef __cplusplus extern "C" { #endif #ifndef HIDAPI_USE_DDK // Since we're not building with the DDK, and the HID header // files aren't part of the SDK, we have to define all this // stuff here. In lookup_functions(), the function pointers // defined below are set. typedef struct _HIDD_ATTRIBUTES{ ULONG Size; USHORT VendorID; USHORT ProductID; USHORT VersionNumber; } HIDD_ATTRIBUTES, *PHIDD_ATTRIBUTES; typedef USHORT USAGE; typedef struct _HIDP_CAPS { USAGE Usage; USAGE UsagePage; USHORT InputReportByteLength; USHORT OutputReportByteLength; USHORT FeatureReportByteLength; USHORT Reserved[17]; USHORT fields_not_used_by_hidapi[10]; } HIDP_CAPS, *PHIDP_CAPS; typedef void* PHIDP_PREPARSED_DATA; #define HIDP_STATUS_SUCCESS 0x110000 typedef BOOLEAN (__stdcall *HidD_GetAttributes_)(HANDLE device, PHIDD_ATTRIBUTES attrib); typedef BOOLEAN (__stdcall *HidD_GetSerialNumberString_)(HANDLE device, PVOID buffer, ULONG buffer_len); typedef BOOLEAN (__stdcall *HidD_GetManufacturerString_)(HANDLE handle, PVOID buffer, ULONG buffer_len); typedef BOOLEAN (__stdcall *HidD_GetProductString_)(HANDLE handle, PVOID buffer, ULONG buffer_len); typedef BOOLEAN (__stdcall *HidD_SetFeature_)(HANDLE handle, PVOID data, ULONG length); typedef BOOLEAN (__stdcall *HidD_GetFeature_)(HANDLE handle, PVOID data, ULONG length); typedef BOOLEAN (__stdcall *HidD_GetIndexedString_)(HANDLE handle, ULONG string_index, PVOID buffer, ULONG buffer_len); typedef BOOLEAN (__stdcall *HidD_GetPreparsedData_)(HANDLE handle, PHIDP_PREPARSED_DATA *preparsed_data); typedef BOOLEAN (__stdcall *HidD_FreePreparsedData_)(PHIDP_PREPARSED_DATA preparsed_data); typedef NTSTATUS (__stdcall *HidP_GetCaps_)(PHIDP_PREPARSED_DATA preparsed_data, HIDP_CAPS *caps); static HidD_GetAttributes_ HidD_GetAttributes; static HidD_GetSerialNumberString_ HidD_GetSerialNumberString; static HidD_GetManufacturerString_ HidD_GetManufacturerString; static HidD_GetProductString_ HidD_GetProductString; static HidD_SetFeature_ HidD_SetFeature; static HidD_GetFeature_ HidD_GetFeature; static HidD_GetIndexedString_ HidD_GetIndexedString; static HidD_GetPreparsedData_ HidD_GetPreparsedData; static HidD_FreePreparsedData_ HidD_FreePreparsedData; static HidP_GetCaps_ HidP_GetCaps; static HMODULE lib_handle = NULL; static BOOLEAN initialized = FALSE; #endif // HIDAPI_USE_DDK struct hid_device_ { HANDLE device_handle; BOOL blocking; USHORT output_report_length; size_t input_report_length; void *last_error_str; DWORD last_error_num; BOOL read_pending; char *read_buf; OVERLAPPED ol; }; static hid_device *new_hid_device() { hid_device *dev = (hid_device*) calloc(1, sizeof(hid_device)); dev->device_handle = INVALID_HANDLE_VALUE; dev->blocking = TRUE; dev->output_report_length = 0; dev->input_report_length = 0; dev->last_error_str = NULL; dev->last_error_num = 0; dev->read_pending = FALSE; dev->read_buf = NULL; memset(&dev->ol, 0, sizeof(dev->ol)); dev->ol.hEvent = CreateEvent(NULL, FALSE, FALSE /*inital state f=nonsignaled*/, NULL); return dev; } static void register_error(hid_device *device, const char *op) { WCHAR *ptr, *msg; FormatMessageW(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS, NULL, GetLastError(), MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT), (LPWSTR)&msg, 0/*sz*/, NULL); // Get rid of the CR and LF that FormatMessage() sticks at the // end of the message. Thanks Microsoft! ptr = msg; while (*ptr) { if (*ptr == '\r') { *ptr = 0x0000; break; } ptr++; } // Store the message off in the Device entry so that // the hid_error() function can pick it up. LocalFree(device->last_error_str); device->last_error_str = msg; } #ifndef HIDAPI_USE_DDK static int lookup_functions() { lib_handle = LoadLibraryA("hid.dll"); if (lib_handle) { #define RESOLVE(x) x = (x##_)GetProcAddress(lib_handle, #x); if (!x) return -1; RESOLVE(HidD_GetAttributes); RESOLVE(HidD_GetSerialNumberString); RESOLVE(HidD_GetManufacturerString); RESOLVE(HidD_GetProductString); RESOLVE(HidD_SetFeature); RESOLVE(HidD_GetFeature); RESOLVE(HidD_GetIndexedString); RESOLVE(HidD_GetPreparsedData); RESOLVE(HidD_FreePreparsedData); RESOLVE(HidP_GetCaps); #undef RESOLVE } else return -1; return 0; } #endif static HANDLE open_device(const char *path, BOOL enumerate) { HANDLE handle; DWORD desired_access = (enumerate)? 0: (GENERIC_WRITE | GENERIC_READ); DWORD share_mode = (enumerate)? FILE_SHARE_READ|FILE_SHARE_WRITE: FILE_SHARE_READ; handle = CreateFileA(path, desired_access, share_mode, NULL, OPEN_EXISTING, FILE_FLAG_OVERLAPPED,//FILE_ATTRIBUTE_NORMAL, 0); return handle; } int HID_API_EXPORT hid_init(void) { #ifndef HIDAPI_USE_DDK if (!initialized) { if (lookup_functions() < 0) { hid_exit(); return -1; } initialized = TRUE; } #endif return 0; } int HID_API_EXPORT hid_exit(void) { #ifndef HIDAPI_USE_DDK if (lib_handle) FreeLibrary(lib_handle); lib_handle = NULL; initialized = FALSE; #endif return 0; } struct hid_device_info HID_API_EXPORT * HID_API_CALL hid_enumerate(unsigned short vendor_id, unsigned short product_id) { BOOL res; struct hid_device_info *root = NULL; // return object struct hid_device_info *cur_dev = NULL; // Windows objects for interacting with the driver. GUID InterfaceClassGuid = {0x4d1e55b2, 0xf16f, 0x11cf, {0x88, 0xcb, 0x00, 0x11, 0x11, 0x00, 0x00, 0x30} }; SP_DEVINFO_DATA devinfo_data; SP_DEVICE_INTERFACE_DATA device_interface_data; SP_DEVICE_INTERFACE_DETAIL_DATA_A *device_interface_detail_data = NULL; HDEVINFO device_info_set = INVALID_HANDLE_VALUE; int device_index = 0; int i; if (hid_init() < 0) return NULL; // Initialize the Windows objects. memset(&devinfo_data, 0x0, sizeof(devinfo_data)); devinfo_data.cbSize = sizeof(SP_DEVINFO_DATA); device_interface_data.cbSize = sizeof(SP_DEVICE_INTERFACE_DATA); // Get information for all the devices belonging to the HID class. device_info_set = SetupDiGetClassDevsA(&InterfaceClassGuid, NULL, NULL, DIGCF_PRESENT | DIGCF_DEVICEINTERFACE); // Iterate over each device in the HID class, looking for the right one. for (;;) { HANDLE write_handle = INVALID_HANDLE_VALUE; DWORD required_size = 0; HIDD_ATTRIBUTES attrib; res = SetupDiEnumDeviceInterfaces(device_info_set, NULL, &InterfaceClassGuid, device_index, &device_interface_data); if (!res) { // A return of FALSE from this function means that // there are no more devices. break; } // Call with 0-sized detail size, and let the function // tell us how long the detail struct needs to be. The // size is put in &required_size. res = SetupDiGetDeviceInterfaceDetailA(device_info_set, &device_interface_data, NULL, 0, &required_size, NULL); // Allocate a long enough structure for device_interface_detail_data. device_interface_detail_data = (SP_DEVICE_INTERFACE_DETAIL_DATA_A*) malloc(required_size); device_interface_detail_data->cbSize = sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA_A); // Get the detailed data for this device. The detail data gives us // the device path for this device, which is then passed into // CreateFile() to get a handle to the device. res = SetupDiGetDeviceInterfaceDetailA(device_info_set, &device_interface_data, device_interface_detail_data, required_size, NULL, NULL); if (!res) { //register_error(dev, "Unable to call SetupDiGetDeviceInterfaceDetail"); // Continue to the next device. goto cont; } // Make sure this device is of Setup Class "HIDClass" and has a // driver bound to it. for (i = 0; ; i++) { char driver_name[256]; // Populate devinfo_data. This function will return failure // when there are no more interfaces left. res = SetupDiEnumDeviceInfo(device_info_set, i, &devinfo_data); if (!res) goto cont; res = SetupDiGetDeviceRegistryPropertyA(device_info_set, &devinfo_data, SPDRP_CLASS, NULL, (PBYTE)driver_name, sizeof(driver_name), NULL); if (!res) goto cont; if (strcmp(driver_name, "HIDClass") == 0) { // See if there's a driver bound. res = SetupDiGetDeviceRegistryPropertyA(device_info_set, &devinfo_data, SPDRP_DRIVER, NULL, (PBYTE)driver_name, sizeof(driver_name), NULL); if (res) break; } } //wprintf(L"HandleName: %s\n", device_interface_detail_data->DevicePath); // Open a handle to the device write_handle = open_device(device_interface_detail_data->DevicePath, TRUE); // Check validity of write_handle. if (write_handle == INVALID_HANDLE_VALUE) { // Unable to open the device. //register_error(dev, "CreateFile"); goto cont_close; } // Get the Vendor ID and Product ID for this device. attrib.Size = sizeof(HIDD_ATTRIBUTES); HidD_GetAttributes(write_handle, &attrib); //wprintf(L"Product/Vendor: %x %x\n", attrib.ProductID, attrib.VendorID); // Check the VID/PID to see if we should add this // device to the enumeration list. if ((vendor_id == 0x0 && product_id == 0x0) || (attrib.VendorID == vendor_id && attrib.ProductID == product_id)) { #define WSTR_LEN 512 const char *str; struct hid_device_info *tmp; PHIDP_PREPARSED_DATA pp_data = NULL; HIDP_CAPS caps; BOOLEAN res; NTSTATUS nt_res; wchar_t wstr[WSTR_LEN]; // TODO: Determine Size size_t len; /* VID/PID match. Create the record. */ tmp = (struct hid_device_info*) calloc(1, sizeof(struct hid_device_info)); if (cur_dev) { cur_dev->next = tmp; } else { root = tmp; } cur_dev = tmp; // Get the Usage Page and Usage for this device. res = HidD_GetPreparsedData(write_handle, &pp_data); if (res) { nt_res = HidP_GetCaps(pp_data, &caps); if (nt_res == HIDP_STATUS_SUCCESS) { cur_dev->usage_page = caps.UsagePage; cur_dev->usage = caps.Usage; } HidD_FreePreparsedData(pp_data); } /* Fill out the record */ cur_dev->next = NULL; str = device_interface_detail_data->DevicePath; if (str) { len = strlen(str); cur_dev->path = (char*) calloc(len+1, sizeof(char)); strncpy(cur_dev->path, str, len+1); cur_dev->path[len] = '\0'; } else cur_dev->path = NULL; /* Serial Number */ res = HidD_GetSerialNumberString(write_handle, wstr, sizeof(wstr)); wstr[WSTR_LEN-1] = 0x0000; if (res) { cur_dev->serial_number = _wcsdup(wstr); } /* Manufacturer String */ res = HidD_GetManufacturerString(write_handle, wstr, sizeof(wstr)); wstr[WSTR_LEN-1] = 0x0000; if (res) { cur_dev->manufacturer_string = _wcsdup(wstr); } /* Product String */ res = HidD_GetProductString(write_handle, wstr, sizeof(wstr)); wstr[WSTR_LEN-1] = 0x0000; if (res) { cur_dev->product_string = _wcsdup(wstr); } /* VID/PID */ cur_dev->vendor_id = attrib.VendorID; cur_dev->product_id = attrib.ProductID; /* Release Number */ cur_dev->release_number = attrib.VersionNumber; /* Interface Number. It can sometimes be parsed out of the path on Windows if a device has multiple interfaces. See http://msdn.microsoft.com/en-us/windows/hardware/gg487473 or search for "Hardware IDs for HID Devices" at MSDN. If it's not in the path, it's set to -1. */ cur_dev->interface_number = -1; if (cur_dev->path) { char *interface_component = strstr(cur_dev->path, "&mi_"); if (interface_component) { char *hex_str = interface_component + 4; char *endptr = NULL; cur_dev->interface_number = strtol(hex_str, &endptr, 16); if (endptr == hex_str) { /* The parsing failed. Set interface_number to -1. */ cur_dev->interface_number = -1; } } } } cont_close: CloseHandle(write_handle); cont: // We no longer need the detail data. It can be freed free(device_interface_detail_data); device_index++; } // Close the device information handle. SetupDiDestroyDeviceInfoList(device_info_set); return root; } void HID_API_EXPORT HID_API_CALL hid_free_enumeration(struct hid_device_info *devs) { // TODO: Merge this with the Linux version. This function is platform-independent. struct hid_device_info *d = devs; while (d) { struct hid_device_info *next = d->next; free(d->path); free(d->serial_number); free(d->manufacturer_string); free(d->product_string); free(d); d = next; } } HID_API_EXPORT hid_device * HID_API_CALL hid_open(unsigned short vendor_id, unsigned short product_id, const wchar_t *serial_number) { // TODO: Merge this functions with the Linux version. This function should be platform independent. struct hid_device_info *devs, *cur_dev; const char *path_to_open = NULL; hid_device *handle = NULL; devs = hid_enumerate(vendor_id, product_id); cur_dev = devs; while (cur_dev) { if (cur_dev->vendor_id == vendor_id && cur_dev->product_id == product_id) { if (serial_number) { if (wcscmp(serial_number, cur_dev->serial_number) == 0) { path_to_open = cur_dev->path; break; } } else { path_to_open = cur_dev->path; break; } } cur_dev = cur_dev->next; } if (path_to_open) { /* Open the device */ handle = hid_open_path(path_to_open); } hid_free_enumeration(devs); return handle; } HID_API_EXPORT hid_device * HID_API_CALL hid_open_path(const char *path) { hid_device *dev; HIDP_CAPS caps; PHIDP_PREPARSED_DATA pp_data = NULL; BOOLEAN res; NTSTATUS nt_res; if (hid_init() < 0) { return NULL; } dev = new_hid_device(); // Open a handle to the device dev->device_handle = open_device(path, FALSE); // Check validity of write_handle. if (dev->device_handle == INVALID_HANDLE_VALUE) { // Unable to open the device. register_error(dev, "CreateFile"); goto err; } // Get the Input Report length for the device. res = HidD_GetPreparsedData(dev->device_handle, &pp_data); if (!res) { register_error(dev, "HidD_GetPreparsedData"); goto err; } nt_res = HidP_GetCaps(pp_data, &caps); if (nt_res != HIDP_STATUS_SUCCESS) { register_error(dev, "HidP_GetCaps"); goto err_pp_data; } dev->output_report_length = caps.OutputReportByteLength; dev->input_report_length = caps.InputReportByteLength; HidD_FreePreparsedData(pp_data); dev->read_buf = (char*) malloc(dev->input_report_length); return dev; err_pp_data: HidD_FreePreparsedData(pp_data); err: CloseHandle(dev->device_handle); free(dev); return NULL; } int HID_API_EXPORT HID_API_CALL hid_write(hid_device *dev, const unsigned char *data, size_t length) { DWORD bytes_written; BOOL res; OVERLAPPED ol; unsigned char *buf; memset(&ol, 0, sizeof(ol)); /* Make sure the right number of bytes are passed to WriteFile. Windows expects the number of bytes which are in the _longest_ report (plus one for the report number) bytes even if the data is a report which is shorter than that. Windows gives us this value in caps.OutputReportByteLength. If a user passes in fewer bytes than this, create a temporary buffer which is the proper size. */ if (length >= dev->output_report_length) { /* The user passed the right number of bytes. Use the buffer as-is. */ buf = (unsigned char *) data; } else { /* Create a temporary buffer and copy the user's data into it, padding the rest with zeros. */ buf = (unsigned char *) malloc(dev->output_report_length); memcpy(buf, data, length); memset(buf + length, 0, dev->output_report_length - length); length = dev->output_report_length; } res = WriteFile(dev->device_handle, buf, length, NULL, &ol); if (!res) { if (GetLastError() != ERROR_IO_PENDING) { // WriteFile() failed. Return error. register_error(dev, "WriteFile"); bytes_written = -1; goto end_of_function; } } // Wait here until the write is done. This makes // hid_write() synchronous. res = GetOverlappedResult(dev->device_handle, &ol, &bytes_written, TRUE/*wait*/); if (!res) { // The Write operation failed. register_error(dev, "WriteFile"); bytes_written = -1; goto end_of_function; } end_of_function: if (buf != data) free(buf); return bytes_written; } int HID_API_EXPORT HID_API_CALL hid_read_timeout(hid_device *dev, unsigned char *data, size_t length, int milliseconds) { DWORD bytes_read = 0; BOOL res; // Copy the handle for convenience. HANDLE ev = dev->ol.hEvent; if (!dev->read_pending) { // Start an Overlapped I/O read. dev->read_pending = TRUE; memset(dev->read_buf, 0, dev->input_report_length); ResetEvent(ev); res = ReadFile(dev->device_handle, dev->read_buf, dev->input_report_length, &bytes_read, &dev->ol); if (!res) { if (GetLastError() != ERROR_IO_PENDING) { // ReadFile() has failed. // Clean up and return error. CancelIo(dev->device_handle); dev->read_pending = FALSE; goto end_of_function; } } } if (milliseconds >= 0) { // See if there is any data yet. res = WaitForSingleObject(ev, milliseconds); if (res != WAIT_OBJECT_0) { // There was no data this time. Return zero bytes available, // but leave the Overlapped I/O running. return 0; } } // Either WaitForSingleObject() told us that ReadFile has completed, or // we are in non-blocking mode. Get the number of bytes read. The actual // data has been copied to the data[] array which was passed to ReadFile(). res = GetOverlappedResult(dev->device_handle, &dev->ol, &bytes_read, TRUE/*wait*/); // Set pending back to false, even if GetOverlappedResult() returned error. dev->read_pending = FALSE; if (res && bytes_read > 0) { if (dev->read_buf[0] == 0x0) { /* If report numbers aren't being used, but Windows sticks a report number (0x0) on the beginning of the report anyway. To make this work like the other platforms, and to make it work more like the HID spec, we'll skip over this byte. */ size_t copy_len; bytes_read--; copy_len = length > bytes_read ? bytes_read : length; memcpy(data, dev->read_buf+1, copy_len); } else { /* Copy the whole buffer, report number and all. */ size_t copy_len = length > bytes_read ? bytes_read : length; memcpy(data, dev->read_buf, copy_len); } } end_of_function: if (!res) { register_error(dev, "GetOverlappedResult"); return -1; } return bytes_read; } int HID_API_EXPORT HID_API_CALL hid_read(hid_device *dev, unsigned char *data, size_t length) { return hid_read_timeout(dev, data, length, (dev->blocking)? -1: 0); } int HID_API_EXPORT HID_API_CALL hid_set_nonblocking(hid_device *dev, int nonblock) { dev->blocking = !nonblock; return 0; /* Success */ } int HID_API_EXPORT HID_API_CALL hid_send_feature_report(hid_device *dev, const unsigned char *data, size_t length) { BOOL res = HidD_SetFeature(dev->device_handle, (PVOID)data, length); if (!res) { register_error(dev, "HidD_SetFeature"); return -1; } return length; } int HID_API_EXPORT HID_API_CALL hid_get_feature_report(hid_device *dev, unsigned char *data, size_t length) { BOOL res; #if 0 res = HidD_GetFeature(dev->device_handle, data, length); if (!res) { register_error(dev, "HidD_GetFeature"); return -1; } return 0; /* HidD_GetFeature() doesn't give us an actual length, unfortunately */ #else DWORD bytes_returned; OVERLAPPED ol; memset(&ol, 0, sizeof(ol)); res = DeviceIoControl(dev->device_handle, IOCTL_HID_GET_FEATURE, data, length, data, length, &bytes_returned, &ol); if (!res) { if (GetLastError() != ERROR_IO_PENDING) { // DeviceIoControl() failed. Return error. register_error(dev, "Send Feature Report DeviceIoControl"); return -1; } } // Wait here until the write is done. This makes // hid_get_feature_report() synchronous. res = GetOverlappedResult(dev->device_handle, &ol, &bytes_returned, TRUE/*wait*/); if (!res) { // The operation failed. register_error(dev, "Send Feature Report GetOverLappedResult"); return -1; } return bytes_returned; #endif } void HID_API_EXPORT HID_API_CALL hid_close(hid_device *dev) { if (!dev) return; CancelIo(dev->device_handle); CloseHandle(dev->ol.hEvent); CloseHandle(dev->device_handle); LocalFree(dev->last_error_str); free(dev->read_buf); free(dev); } int HID_API_EXPORT_CALL HID_API_CALL hid_get_manufacturer_string(hid_device *dev, wchar_t *string, size_t maxlen) { BOOL res; res = HidD_GetManufacturerString(dev->device_handle, string, 2 * maxlen); if (!res) { register_error(dev, "HidD_GetManufacturerString"); return -1; } return 0; } int HID_API_EXPORT_CALL HID_API_CALL hid_get_product_string(hid_device *dev, wchar_t *string, size_t maxlen) { BOOL res; res = HidD_GetProductString(dev->device_handle, string, 2 * maxlen); if (!res) { register_error(dev, "HidD_GetProductString"); return -1; } return 0; } int HID_API_EXPORT_CALL HID_API_CALL hid_get_serial_number_string(hid_device *dev, wchar_t *string, size_t maxlen) { BOOL res; res = HidD_GetSerialNumberString(dev->device_handle, string, 2 * maxlen); if (!res) { register_error(dev, "HidD_GetSerialNumberString"); return -1; } return 0; } int HID_API_EXPORT_CALL HID_API_CALL hid_get_indexed_string(hid_device *dev, int string_index, wchar_t *string, size_t maxlen) { BOOL res; res = HidD_GetIndexedString(dev->device_handle, string_index, string, 2 * maxlen); if (!res) { register_error(dev, "HidD_GetIndexedString"); return -1; } return 0; } HID_API_EXPORT const wchar_t * HID_API_CALL hid_error(hid_device *dev) { return (wchar_t*)dev->last_error_str; } //#define PICPGM //#define S11 #define P32 #ifdef S11 unsigned short VendorID = 0xa0a0; unsigned short ProductID = 0x0001; #endif #ifdef P32 unsigned short VendorID = 0x04d8; unsigned short ProductID = 0x3f; #endif #ifdef PICPGM unsigned short VendorID = 0x04d8; unsigned short ProductID = 0x0033; #endif #if 0 int __cdecl main(int argc, char* argv[]) { int res; unsigned char buf[65]; UNREFERENCED_PARAMETER(argc); UNREFERENCED_PARAMETER(argv); // Set up the command buffer. memset(buf,0x00,sizeof(buf)); buf[0] = 0; buf[1] = 0x81; // Open the device. int handle = open(VendorID, ProductID, L"12345"); if (handle < 0) printf("unable to open device\n"); // Toggle LED (cmd 0x80) buf[1] = 0x80; res = write(handle, buf, 65); if (res < 0) printf("Unable to write()\n"); // Request state (cmd 0x81) buf[1] = 0x81; write(handle, buf, 65); if (res < 0) printf("Unable to write() (2)\n"); // Read requested state read(handle, buf, 65); if (res < 0) printf("Unable to read()\n"); // Print out the returned buffer. for (int i = 0; i < 4; i++) printf("buf[%d]: %d\n", i, buf[i]); return 0; } #endif #ifdef __cplusplus } // extern "C" #endif qthid-4.1-source/mainwindow.ui0000644000175000017500000004175212054762152014575 0ustar alcalc MainWindow 0 0 473 336 Qthid :/qthid/images/qthid.png:/qthid/images/qthid.png true 3 5 0 0 372 44 Qt::WheelFocus QFrame::StyledPanel QFrame::Raised Qt::Horizontal 40 20 LNB: Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter true Frequency offset for up- and downconverters. Shown frequency = FCD_freq + LNB_offset Use positive offset for downconverters and negative offset for upconverters. true QAbstractSpinBox::UpDownArrows MHz 3 -1000.000000000000000 15000.000000000000000 0 0 Correction: Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter true 0 0 Frequency correction Qt::AlignLeading|Qt::AlignLeft|Qt::AlignVCenter ppm -500 500 0 0 Switch power to bias tee ON/OFF. Requires FCD with S/N TBD or above. Bias T true Qt::Horizontal 40 20 Qt::Horizontal Funcube Dongle Pro+ RF diagram :/qthid/images/rfchain.png false Qt::AlignCenter 0 0 Qt::Horizontal 40 20 Qt::Horizontal false RF filter 0.15 - 4 MHz 4 - 8 MHz 8 - 16 MHz 16 - 32 MHz 32 - 75 MHz 75 - 125 MHz 125 - 250 MHz 145 MHz 410 - 875 MHz 435 MHz 0.87 - 2.0 GHz LNA gain LNA true true Mixer gain Mixer gain true true false IF filter 200 kHz 300 kHz 600 kHz 1.5 MHz 5 MHz 6 MHz 7 MHz 8 MHz true IF gain dB 59 Qt::Horizontal 40 20 Qt::Vertical 20 40 0 0 473 25 &File &Help &Tools &View :/qthid/images/info.png:/qthid/images/info.png About Information about Qthid :/qthid/images/info.png:/qthid/images/info.png About Qt Information about Qt :/qthid/images/quit.png:/qthid/images/quit.png &Quit Ctrl+Q false :/qthid/images/open.png:/qthid/images/open.png Load Settings Load FCD settings from file false :/qthid/images/save.png:/qthid/images/save.png Save Settings Save FCD settings to file false :/qthid/images/fw.png:/qthid/images/fw.png Firmware Open firmware tools :/qthid/images/help.png:/qthid/images/help.png What's This? Enter What's This? Reset to defaults Reset all settings to their default value CFreqCtrl QFrame
freqctrl.h
1
actionQuit activated() MainWindow close() -1 -1 494 181
qthid-4.1-source/NEWS.txt0000644000175000017500000000415612054762152013374 0ustar alcalcChanges in version 4.1: - Special release with Funcube Dongle Pro+ support. Changes in version 4.0: - New layout with IF, IQ and firmware controls hidden by default. - New frequency controller widget. - Support for up- and downconverters. Changes in version 3.2: - Switch to using hidraw driver on Linux 2.6.38 or later (fixes crashes experienced on recent Linux with libusb-1.0.9). - Update HID API. - Reduce widow width. Changes in version 3.1: - Support for Mac OS X 10.7 Lion. - Support for Bias-T with firmware 18h and later. - Allow user to force band selection to be different from the one chosen by the FCD (temporary workaround for a FW 18f bug occurring at 861 MHz). - Change default value of IQ gain correction from 0.0 to 1.0. - Use correct FCD command for setting IQ phase correction (GH-5). - Various fixes for windows build using latest SDK (7.0). - Removed RSSI indicator since it is unlikely that it will ever work. Changes in version 3.0: - Implement full API in firmware 18f (thanks Mario Lorenz, DL5MLO). - Requires firmware 18f or later (earlier firmwares are not detected). - Added auto-repeat to tuning buttons (click and hold the button to scan). - Added new RF chain diagram. - Show firmware version in status message. Changes in version 2.2: - Use native toolbar and status bar on Mac OS X - New application icon based on SVG drawing - Correctly set application and bundle icon on Mac OS X and Windows - Minor UI tweaks. - Fix qthid.pro to allow correct build on Ubuntu 9.04 (thanks EA4FVS). - Correct application name in file headers (thanks Andrew Elwell) Changes in version 2.1: - Various fixes and workarounds to prevent crash and freeze when switching between application and bootloader mode. The application can now run with or without FCD (hotplug). Upgrade and verify firmware have been tested on Linux (32 and 64 bit) and OSX 10.6. - Updated HID API to hidapi/master from 2011-02-17 - Retrieve libusb configuration on Linux using pkg-config - Remove local Qt Creator configuration from distribution - Improvements to the UI layout and widgets - Added application icon - Applied GPL V3 license qthid-4.1-source/funcube-dongle.rules0000644000175000017500000000072412051012677016022 0ustar alcalc# Udev rules for the Funcube Dongle Pro (0xfb56) and Pro+ (0xfb31) # HIDAPI/libusb: SUBSYSTEMS=="usb" ATTRS{idVendor}=="04d8" ATTRS{idProduct}=="fb56" MODE:="0666" SUBSYSTEMS=="usb" ATTRS{idVendor}=="04d8" ATTRS{idProduct}=="fb31" MODE:="0666" # HIDAPI/hidraw: KERNEL=="hidraw*", ATTRS{busnum}=="1", ATTRS{idVendor}=="04d8", ATTRS{idProduct}=="fb56", MODE="0666" KERNEL=="hidraw*", ATTRS{busnum}=="1", ATTRS{idVendor}=="04d8", ATTRS{idProduct}=="fb31", MODE="0666" qthid-4.1-source/hidapi.h0000644000175000017500000003200312051012642013443 0ustar alcalc/******************************************************* HIDAPI - Multi-Platform library for communication with HID devices. Alan Ott Signal 11 Software 8/22/2009 Copyright 2009, All Rights Reserved. At the discretion of the user of this library, this software may be licensed under the terms of the GNU Public License v3, a BSD-Style license, or the original HIDAPI license as outlined in the LICENSE.txt, LICENSE-gpl3.txt, LICENSE-bsd.txt, and LICENSE-orig.txt files located at the root of the source distribution. These files may also be found in the public source code repository located at: http://github.com/signal11/hidapi . ********************************************************/ /** @file * @defgroup API hidapi API */ #ifndef HIDAPI_H__ #define HIDAPI_H__ #include #ifdef _WIN32 #define HID_API_EXPORT __declspec(dllexport) #define HID_API_CALL #else #define HID_API_EXPORT /**< API export macro */ #define HID_API_CALL /**< API call macro */ #endif #define HID_API_EXPORT_CALL HID_API_EXPORT HID_API_CALL /**< API export and call macro*/ #ifdef __cplusplus extern "C" { #endif struct hid_device_; typedef struct hid_device_ hid_device; /**< opaque hidapi structure */ /** hidapi info structure */ struct hid_device_info { /** Platform-specific device path */ char *path; /** Device Vendor ID */ unsigned short vendor_id; /** Device Product ID */ unsigned short product_id; /** Serial Number */ wchar_t *serial_number; /** Device Release Number in binary-coded decimal, also known as Device Version Number */ unsigned short release_number; /** Manufacturer String */ wchar_t *manufacturer_string; /** Product string */ wchar_t *product_string; /** Usage Page for this Device/Interface (Windows/Mac only). */ unsigned short usage_page; /** Usage for this Device/Interface (Windows/Mac only).*/ unsigned short usage; /** The USB interface which this logical device represents. Valid on both Linux implementations in all cases, and valid on the Windows implementation only if the device contains more than one interface. */ int interface_number; /** Pointer to the next device */ struct hid_device_info *next; }; /** @brief Initialize the HIDAPI library. This function initializes the HIDAPI library. Calling it is not strictly necessary, as it will be called automatically by hid_enumerate() and any of the hid_open_*() functions if it is needed. This function should be called at the beginning of execution however, if there is a chance of HIDAPI handles being opened by different threads simultaneously. @ingroup API @returns This function returns 0 on success and -1 on error. */ int HID_API_EXPORT HID_API_CALL hid_init(void); /** @brief Finalize the HIDAPI library. This function frees all of the static data associated with HIDAPI. It should be called at the end of execution to avoid memory leaks. @ingroup API @returns This function returns 0 on success and -1 on error. */ int HID_API_EXPORT HID_API_CALL hid_exit(void); /** @brief Enumerate the HID Devices. This function returns a linked list of all the HID devices attached to the system which match vendor_id and product_id. If @p vendor_id and @p product_id are both set to 0, then all HID devices will be returned. @ingroup API @param vendor_id The Vendor ID (VID) of the types of device to open. @param product_id The Product ID (PID) of the types of device to open. @returns This function returns a pointer to a linked list of type struct #hid_device, containing information about the HID devices attached to the system, or NULL in the case of failure. Free this linked list by calling hid_free_enumeration(). */ struct hid_device_info HID_API_EXPORT * HID_API_CALL hid_enumerate(unsigned short vendor_id, unsigned short product_id); /** @brief Free an enumeration Linked List This function frees a linked list created by hid_enumerate(). @ingroup API @param devs Pointer to a list of struct_device returned from hid_enumerate(). */ void HID_API_EXPORT HID_API_CALL hid_free_enumeration(struct hid_device_info *devs); /** @brief Open a HID device using a Vendor ID (VID), Product ID (PID) and optionally a serial number. If @p serial_number is NULL, the first device with the specified VID and PID is opened. @ingroup API @param vendor_id The Vendor ID (VID) of the device to open. @param product_id The Product ID (PID) of the device to open. @param serial_number The Serial Number of the device to open (Optionally NULL). @returns This function returns a pointer to a #hid_device object on success or NULL on failure. */ HID_API_EXPORT hid_device * HID_API_CALL hid_open(unsigned short vendor_id, unsigned short product_id, const wchar_t *serial_number); /** @brief Open a HID device by its path name. The path name be determined by calling hid_enumerate(), or a platform-specific path name can be used (eg: /dev/hidraw0 on Linux). @ingroup API @param path The path name of the device to open @returns This function returns a pointer to a #hid_device object on success or NULL on failure. */ HID_API_EXPORT hid_device * HID_API_CALL hid_open_path(const char *path); /** @brief Write an Output report to a HID device. The first byte of @p data[] must contain the Report ID. For devices which only support a single report, this must be set to 0x0. The remaining bytes contain the report data. Since the Report ID is mandatory, calls to hid_write() will always contain one more byte than the report contains. For example, if a hid report is 16 bytes long, 17 bytes must be passed to hid_write(), the Report ID (or 0x0, for devices with a single report), followed by the report data (16 bytes). In this example, the length passed in would be 17. hid_write() will send the data on the first OUT endpoint, if one exists. If it does not, it will send the data through the Control Endpoint (Endpoint 0). @ingroup API @param device A device handle returned from hid_open(). @param data The data to send, including the report number as the first byte. @param length The length in bytes of the data to send. @returns This function returns the actual number of bytes written and -1 on error. */ int HID_API_EXPORT HID_API_CALL hid_write(hid_device *device, const unsigned char *data, size_t length); /** @brief Read an Input report from a HID device with timeout. Input reports are returned to the host through the INTERRUPT IN endpoint. The first byte will contain the Report number if the device uses numbered reports. @ingroup API @param device A device handle returned from hid_open(). @param data A buffer to put the read data into. @param length The number of bytes to read. For devices with multiple reports, make sure to read an extra byte for the report number. @param milliseconds timeout in milliseconds or -1 for blocking wait. @returns This function returns the actual number of bytes read and -1 on error. */ int HID_API_EXPORT HID_API_CALL hid_read_timeout(hid_device *dev, unsigned char *data, size_t length, int milliseconds); /** @brief Read an Input report from a HID device. Input reports are returned to the host through the INTERRUPT IN endpoint. The first byte will contain the Report number if the device uses numbered reports. @ingroup API @param device A device handle returned from hid_open(). @param data A buffer to put the read data into. @param length The number of bytes to read. For devices with multiple reports, make sure to read an extra byte for the report number. @returns This function returns the actual number of bytes read and -1 on error. */ int HID_API_EXPORT HID_API_CALL hid_read(hid_device *device, unsigned char *data, size_t length); /** @brief Set the device handle to be non-blocking. In non-blocking mode calls to hid_read() will return immediately with a value of 0 if there is no data to be read. In blocking mode, hid_read() will wait (block) until there is data to read before returning. Nonblocking can be turned on and off at any time. @ingroup API @param device A device handle returned from hid_open(). @param nonblock enable or not the nonblocking reads - 1 to enable nonblocking - 0 to disable nonblocking. @returns This function returns 0 on success and -1 on error. */ int HID_API_EXPORT HID_API_CALL hid_set_nonblocking(hid_device *device, int nonblock); /** @brief Send a Feature report to the device. Feature reports are sent over the Control endpoint as a Set_Report transfer. The first byte of @p data[] must contain the Report ID. For devices which only support a single report, this must be set to 0x0. The remaining bytes contain the report data. Since the Report ID is mandatory, calls to hid_send_feature_report() will always contain one more byte than the report contains. For example, if a hid report is 16 bytes long, 17 bytes must be passed to hid_send_feature_report(): the Report ID (or 0x0, for devices which do not use numbered reports), followed by the report data (16 bytes). In this example, the length passed in would be 17. @ingroup API @param device A device handle returned from hid_open(). @param data The data to send, including the report number as the first byte. @param length The length in bytes of the data to send, including the report number. @returns This function returns the actual number of bytes written and -1 on error. */ int HID_API_EXPORT HID_API_CALL hid_send_feature_report(hid_device *device, const unsigned char *data, size_t length); /** @brief Get a feature report from a HID device. Make sure to set the first byte of @p data[] to the Report ID of the report to be read. Make sure to allow space for this extra byte in @p data[]. @ingroup API @param device A device handle returned from hid_open(). @param data A buffer to put the read data into, including the Report ID. Set the first byte of @p data[] to the Report ID of the report to be read. @param length The number of bytes to read, including an extra byte for the report ID. The buffer can be longer than the actual report. @returns This function returns the number of bytes read and -1 on error. */ int HID_API_EXPORT HID_API_CALL hid_get_feature_report(hid_device *device, unsigned char *data, size_t length); /** @brief Close a HID device. @ingroup API @param device A device handle returned from hid_open(). */ void HID_API_EXPORT HID_API_CALL hid_close(hid_device *device); /** @brief Get The Manufacturer String from a HID device. @ingroup API @param device A device handle returned from hid_open(). @param string A wide string buffer to put the data into. @param maxlen The length of the buffer in multiples of wchar_t. @returns This function returns 0 on success and -1 on error. */ int HID_API_EXPORT_CALL hid_get_manufacturer_string(hid_device *device, wchar_t *string, size_t maxlen); /** @brief Get The Product String from a HID device. @ingroup API @param device A device handle returned from hid_open(). @param string A wide string buffer to put the data into. @param maxlen The length of the buffer in multiples of wchar_t. @returns This function returns 0 on success and -1 on error. */ int HID_API_EXPORT_CALL hid_get_product_string(hid_device *device, wchar_t *string, size_t maxlen); /** @brief Get The Serial Number String from a HID device. @ingroup API @param device A device handle returned from hid_open(). @param string A wide string buffer to put the data into. @param maxlen The length of the buffer in multiples of wchar_t. @returns This function returns 0 on success and -1 on error. */ int HID_API_EXPORT_CALL hid_get_serial_number_string(hid_device *device, wchar_t *string, size_t maxlen); /** @brief Get a string from a HID device, based on its string index. @ingroup API @param device A device handle returned from hid_open(). @param string_index The index of the string to get. @param string A wide string buffer to put the data into. @param maxlen The length of the buffer in multiples of wchar_t. @returns This function returns 0 on success and -1 on error. */ int HID_API_EXPORT_CALL hid_get_indexed_string(hid_device *device, int string_index, wchar_t *string, size_t maxlen); /** @brief Get a string describing the last error which occurred. @ingroup API @param device A device handle returned from hid_open(). @returns This function returns a string containing the last error which occurred or NULL if none has occurred. */ HID_API_EXPORT const wchar_t* HID_API_CALL hid_error(hid_device *device); #ifdef __cplusplus } #endif #endif qthid-4.1-source/qthid.rc0000644000175000017500000000010312051012642013467 0ustar alcalcIDI_ICON1 ICON DISCARDABLE "images/qthid.ico" qthid-4.1-source/README.txt0000644000175000017500000001122212054762152013545 0ustar alcalc1. INTRODUCTION Qthid is a small control application for the Funcube Dongle devices. It is an evolution of the qthid002 package by Howard Long G6LVB. This version 4.1 is a special version that adds support for the Funcube Dongle Pro+ (see http://www.funcubedongle.com/?page_id=1073). The original Funcube Dongle Pro is not supported by this version. Qthid uses the HIDAPI cross platform library by Signal 11 Software (http://www.signal11.us/oss/hidapi/). All the required files are bundled with qthid and no installation of the library is required. 2. INSTALLATION AND USAGE 2.1 Linux Precompiled binaries (32 or 64 bit) are avaialble for download but users are required to install the Qt runtime libraries on their own. All common Linux distrib utions have the Qt libraries packaged and they can be installed using the package manager for the platform. Qt 4.7 and 4.8 has been tested. In order to use the Funcube Dongle Pro+ as regular user and udev rule is required. An example funcube-dongle.rules file is included with the package and you can simply copy that file to the /etc/udev/rules.d/ directory (hint: open a terminal and type: "sudo cp funcube-dongle.rules /etc/udev/rules.d/" without the quotes) Qthid should now detect your Funcube Dongle Pro+ when you plug it in. No reboot or udev restart is necessary. 2.2 Mac OS X (10.6+) The Mac OS X bundle contains all the necessary Qt libraries and no additional installation or configuration is required. Unlike Linux, the Funcube Dongle will just work. 2.3 Windows The windows package is self containing and does not require and Qt libs to be installed separately. This release has been tested on Windows 7. 2.4 Building from source - Install Qt Creator 2.0.1 or newer and Qt SDK 4.7. On recent linux it is normally sufficient to select Qt Creator and the required Qt libraries will be installed as dependencies. On Mac and Windows you need to download the full Qt SDK. On Windows you also need the MS Windows SDK. - On linux you also need to install the libudev-dev package using the package manager (the name may be different depending on distribution but it should have libudev and dev int he name). - Open the qthid.pro file in Qt Creator. It will say something about setting up a target; say OK or Finish or Done (depends on version and OS). - You can now build and execute the project. It is also possible to build in a terminal: $ tar xvfz qthid-X.Y.tar.gz $ cd qthid-X.Y $ mkdir build $ cd build $ qmake ../qthid.pro $ make You should now have a qthid binary. 3. License Qthid 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 3 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 . The frequency controller widget was taken from Cutesdr by Moe Wheatley, released under the following "Simplified BSD License": Copyright 2010 Moe Wheatley. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. 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. THIS SOFTWARE IS PROVIDED BY Moe Wheatley "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 Moe Wheatley 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. The views and conclusions contained in the software and documentation are those of the authors and should not be interpreted as representing official policies, either expressed or implied, of Moe Wheatley. qthid-4.1-source/freqctrl.cpp0000644000175000017500000006347512051012642014403 0ustar alcalc///////////////////////////////////////////////////////////////////// // freqctrl.cpp: implementation of the CFreqCtrl class. // // This class implements a frequency control widget to set/change //frequency data. // // History: // 2010-09-15 Initial creation MSW // 2011-03-27 Initial release // 2011-04-17 Fixed bug with m_Oldfreq being set after emit instead of before ///////////////////////////////////////////////////////////////////// //========================================================================================== // + + + This Software is released under the "Simplified BSD License" + + + //Copyright 2010 Moe Wheatley. All rights reserved. // //Redistribution and use in source and binary forms, with or without modification, are //permitted provided that the following conditions are met: // // 1. Redistributions of source code must retain the above copyright notice, this list of // conditions and the following disclaimer. // // 2. 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. // //THIS SOFTWARE IS PROVIDED BY Moe Wheatley ``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 Moe Wheatley 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. // //The views and conclusions contained in the software and documentation are those of the //authors and should not be interpreted as representing official policies, either expressed //or implied, of Moe Wheatley. //========================================================================================== //#include #include #include "freqctrl.h" //Manual adjustment of Font size as percent of control height #define DIGIT_SIZE_PERCENT 90 #define UNITS_SIZE_PERCENT 60 //adjustment for separation between digits #define SEPRATIO_N 100 //separation rectangle size ratio numerator times 100 #define SEPRATIO_D 3 //separation rectangle size ratio denominator ///////////////////////////////////////////////////////////////////// // Constructor/Destructor ///////////////////////////////////////////////////////////////////// CFreqCtrl::CFreqCtrl(QWidget *parent) : QFrame(parent) { setAutoFillBackground(false); setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding); setFocusPolicy(Qt::StrongFocus); setMouseTracking ( TRUE ); m_BkColor = QColor(0x20,0x20,0x20,0xFF);//Qt::black; m_DigitColor = QColor(0xFF, 0xE6, 0xC8, 0xFF); m_HighlightColor = QColor(0x5A, 0x5A, 0x5A, 0xFF); m_UnitsColor = Qt::gray; m_freq = 146123456; Setup( 10, 1, 4000000000U, 1, UNITS_MHZ); m_Oldfreq = 0; m_LastLeadZeroPos = 0; m_LRMouseFreqSel = FALSE; m_ActiveEditDigit = -1; m_ResetLowerDigits = FALSE; m_UnitsFont = QFont("Arial",12,QFont::Normal); m_DigitFont = QFont("Arial",12,QFont::Normal); } CFreqCtrl::~CFreqCtrl() { } ///////////////////////////////////////////////////////////////////// // Size hint stuff ///////////////////////////////////////////////////////////////////// QSize CFreqCtrl::minimumSizeHint() const { return QSize(100, 20); } QSize CFreqCtrl::sizeHint() const { return QSize(100, 20); } ///////////////////////////////////////////////////////////////////// // Various helper functions ///////////////////////////////////////////////////////////////////// bool CFreqCtrl::InRect(QRect &rect, QPoint &point) { if( ( point.x() < rect.right( ) ) && ( point.x() > rect.x() ) && ( point.y() < rect.bottom() ) && ( point.y() > rect.y() ) ) return TRUE; else return FALSE; } ////////////////////////////////////////////////////////////////////////////// // Setup various parameters for the control ////////////////////////////////////////////////////////////////////////////// void CFreqCtrl::Setup(int NumDigits, qint64 Minf, qint64 Maxf,int MinStep, FUNITS UnitsType) { int i; qint64 pwr = 1; m_LastEditDigit = 0; m_Oldfreq = -1; m_NumDigits = NumDigits; if( m_NumDigits>MAX_DIGITS ) m_NumDigits = MAX_DIGITS; if( m_NumDigits m_MaxFreq) m_freq = m_MaxFreq; for(i=0; ipwr ) m_MaxFreq = pwr-1; m_MaxFreq = m_MaxFreq - m_MaxFreq%m_MinStep; if( m_MinFreq>pwr ) m_MinFreq = 1; m_MinFreq = m_MinFreq - m_MinFreq%m_MinStep; m_DigStart = 0; switch(UnitsType) { case UNITS_HZ: m_DecPos = 0; m_UnitString = "Hz "; break; case UNITS_KHZ: m_DecPos = 3; m_UnitString = "KHz"; break; case UNITS_MHZ: m_DecPos = 6; m_UnitString = "MHz"; break; case UNITS_GHZ: m_DecPos = 9; m_UnitString = "GHz"; break; case UNITS_SEC: m_DecPos = 6; m_UnitString = "Sec"; break; case UNITS_MSEC: m_DecPos = 3; m_UnitString = "mS "; break; case UNITS_USEC: m_DecPos = 0; m_UnitString = "uS "; break; case UNITS_NSEC: m_DecPos = 0; m_UnitString = "nS "; break; } for(i=m_NumDigits-1; i>=0; i--) { if( m_DigitInfo[i].weight <= m_MinStep ) { if(m_DigStart == 0) { m_DigitInfo[i].incval = m_MinStep; m_DigStart = i; } else { if( (m_MinStep%m_DigitInfo[i+1].weight) != 0) m_DigStart = i; m_DigitInfo[i].incval = 0; } } } m_NumSeps = (m_NumDigits-1)/3 - m_DigStart/3; } ////////////////////////////////////////////////////////////////////////////// // Sets the frequency and individual digit values ////////////////////////////////////////////////////////////////////////////// void CFreqCtrl::SetFrequency(qint64 freq) { int i; qint64 acc = 0; qint64 rem; int val; if( freq == m_Oldfreq) return; if( freq < m_MinFreq) freq = m_MinFreq; if( freq > m_MaxFreq) freq = m_MaxFreq; m_freq = freq - freq%m_MinStep; rem = m_freq; m_LeadZeroPos = m_NumDigits; for(i=m_NumDigits-1; i>=m_DigStart; i--) { val = (int)(rem/m_DigitInfo[i].weight); if(m_DigitInfo[i].val != val) { m_DigitInfo[i].val = val; m_DigitInfo[i].modified = TRUE; } rem = rem - val*m_DigitInfo[i].weight; acc += val; if( (acc==0) && ( i>m_DecPos) ) m_LeadZeroPos = i; } // signal the new frequency to world m_Oldfreq = m_freq; emit NewFrequency( m_freq ); UpdateCtrl(m_LastLeadZeroPos != m_LeadZeroPos); m_LastLeadZeroPos = m_LeadZeroPos; } ////////////////////////////////////////////////////////////////////////////// // Sets the Digit and comma and decimal pt color ////////////////////////////////////////////////////////////////////////////// void CFreqCtrl::SetDigitColor(QColor cr) { m_UpdateAll = TRUE; m_DigitColor = cr; for(int i=m_DigStart; i=0) { if( m_DigitInfo[m_ActiveEditDigit].editmode ) { m_DigitInfo[m_ActiveEditDigit].editmode = FALSE; m_DigitInfo[m_ActiveEditDigit].modified = TRUE; m_ActiveEditDigit = -1; UpdateCtrl(FALSE); } } } ///////////////////////////////////////////////////////////////////// // main draw event for this control ///////////////////////////////////////////////////////////////////// void CFreqCtrl::paintEvent(QPaintEvent *) { QPainter painter(&m_Pixmap); if(m_UpdateAll) //if need to redraw everything { DrawBkGround(painter); m_UpdateAll = FALSE; } // draw any modified digits to the m_MemDC DrawDigits(painter); //now draw pixmap onto screen QPainter scrnpainter(this); scrnpainter.drawPixmap(0,0,m_Pixmap); //blt to the screen(flickers like a candle, why?) } ///////////////////////////////////////////////////////////////////// // Mouse Event overrides ///////////////////////////////////////////////////////////////////// void CFreqCtrl::mouseMoveEvent(QMouseEvent * event) { QPoint pt = event->pos(); //find which digit is to be edited if( isActiveWindow() ) { if(!hasFocus()) setFocus(Qt::MouseFocusReason); for(int i=m_DigStart; ipos(); if(event->button() == Qt::LeftButton) { for(int i=m_DigStart; ibutton() == Qt::RightButton) { for(int i=m_DigStart; ipos(); int numDegrees = event->delta() / 8; int numSteps = numDegrees / 15; for(int i=m_DigStart; i0) IncFreq(); else if(numSteps<0) DecFreq(); } } } ///////////////////////////////////////////////////////////////////// // Keyboard Event overrides ///////////////////////////////////////////////////////////////////// void CFreqCtrl::keyPressEvent( QKeyEvent * event ) { //call base class if dont over ride key bool fSkipMsg = FALSE; qint64 tmp; //qDebug() <key(); switch(event->key()) { case Qt::Key_0: case Qt::Key_1: case Qt::Key_2: case Qt::Key_3: case Qt::Key_4: case Qt::Key_5: case Qt::Key_6: case Qt::Key_7: case Qt::Key_8: case Qt::Key_9: if( m_ActiveEditDigit>=0) { if( m_DigitInfo[m_ActiveEditDigit].editmode) { tmp = (m_freq/m_DigitInfo[m_ActiveEditDigit].weight)%10; m_freq -= tmp*m_DigitInfo[m_ActiveEditDigit].weight; m_freq = m_freq+(event->key()-'0')*m_DigitInfo[m_ActiveEditDigit].weight; SetFrequency(m_freq); } } MoveCursorRight(); fSkipMsg = TRUE; break; case Qt::Key_Left: if( m_ActiveEditDigit != -1 ) { MoveCursorLeft(); fSkipMsg = TRUE; } break; case Qt::Key_Up: if(m_ActiveEditDigit != -1 ) { IncFreq(); fSkipMsg = TRUE; } break; case Qt::Key_Down: if(m_ActiveEditDigit != -1) { DecFreq(); fSkipMsg = TRUE; } break; case Qt::Key_Right: if(m_ActiveEditDigit != -1 ) { MoveCursorRight(); fSkipMsg = TRUE; } break; case Qt::Key_Home: CursorHome(); fSkipMsg = TRUE; break; case Qt::Key_End: CursorEnd(); fSkipMsg = TRUE; break; default: break; } if(!fSkipMsg) QFrame::keyPressEvent(event); } ////////////////////////////////////////////////////////////////////////////// // Calculates all the rectangles for the digits, separators, and units text // and creates the fonts for them. ////////////////////////////////////////////////////////////////////////////// void CFreqCtrl::DrawBkGround(QPainter &Painter) { QRect rect(0, 0, width(), height()); //qDebug() <m_DigStart) && ( (i%3)==0 ) ) { m_SepRect[i].setCoords( digpos - sepwidth, rect.top(), digpos, rect.bottom()); Painter.fillRect(m_SepRect[i], m_BkColor); digpos -= sepwidth; if( i==m_DecPos) Painter.drawText(m_SepRect[i], Qt::AlignHCenter|Qt::AlignVCenter, "."); else if( i>m_DecPos && i= m_LeadZeroPos) Painter.setPen(m_BkColor); else Painter.setPen(m_DigitColor); digchar = '0' + m_DigitInfo[i].val; Painter.drawText(m_DigitInfo[i].dQRect, Qt::AlignHCenter|Qt::AlignVCenter, QString().number( m_DigitInfo[i].val ) ); m_DigitInfo[i].modified = FALSE; } } } ////////////////////////////////////////////////////////////////////////////// // Increment just the digit active in edit mode ////////////////////////////////////////////////////////////////////////////// void CFreqCtrl::IncDigit() { int tmp; qint64 tmpl; if( m_ActiveEditDigit>=0) { if( m_DigitInfo[m_ActiveEditDigit].editmode) { if(m_DigitInfo[m_ActiveEditDigit].weight == m_DigitInfo[m_ActiveEditDigit].incval) { // get the current digit value tmp = (int)((m_freq/m_DigitInfo[m_ActiveEditDigit].weight)%10); // set the current digit value to zero m_freq -= tmp*m_DigitInfo[m_ActiveEditDigit].weight; tmp++; if( tmp>9 ) tmp = 0; m_freq = m_freq+(qint64)tmp*m_DigitInfo[m_ActiveEditDigit].weight; } else { tmp = (int)((m_freq/m_DigitInfo[m_ActiveEditDigit+1].weight)%10); tmpl = m_freq + m_DigitInfo[m_ActiveEditDigit].incval; if(tmp != (int)((tmpl/m_DigitInfo[m_ActiveEditDigit+1].weight)%10) ) { tmpl -= m_DigitInfo[m_ActiveEditDigit+1].weight; } m_freq = tmpl; } SetFrequency(m_freq); } } } ////////////////////////////////////////////////////////////////////////////// // Increment the frequency by this digit active in edit mode ////////////////////////////////////////////////////////////////////////////// void CFreqCtrl::IncFreq() { if( m_ActiveEditDigit>=0) { if( m_DigitInfo[m_ActiveEditDigit].editmode) { m_freq += m_DigitInfo[m_ActiveEditDigit].incval; if (m_ResetLowerDigits) { /* Set digits below the active one to 0 */ m_freq = m_freq - m_freq%m_DigitInfo[m_ActiveEditDigit].weight; } SetFrequency(m_freq); m_LastEditDigit = m_ActiveEditDigit; } } } ////////////////////////////////////////////////////////////////////////////// // Decrement the digit active in edit mode ////////////////////////////////////////////////////////////////////////////// void CFreqCtrl::DecDigit() { int tmp; qint64 tmpl; if( m_ActiveEditDigit>=0) { if( m_DigitInfo[m_ActiveEditDigit].editmode) { if(m_DigitInfo[m_ActiveEditDigit].weight == m_DigitInfo[m_ActiveEditDigit].incval) { // get the current digit value tmp = (int)((m_freq/m_DigitInfo[m_ActiveEditDigit].weight)%10); // set the current digit value to zero m_freq -= tmp*m_DigitInfo[m_ActiveEditDigit].weight; tmp--; if( tmp<0 ) tmp = 9; m_freq = m_freq+(qint64)tmp*m_DigitInfo[m_ActiveEditDigit].weight; } else { tmp = (int)((m_freq/m_DigitInfo[m_ActiveEditDigit+1].weight)%10); tmpl = m_freq - m_DigitInfo[m_ActiveEditDigit].incval; if(tmp != (int)((tmpl/m_DigitInfo[m_ActiveEditDigit+1].weight)%10) ) { tmpl += m_DigitInfo[m_ActiveEditDigit+1].weight; } m_freq = tmpl; } SetFrequency(m_freq); } } } ////////////////////////////////////////////////////////////////////////////// // Decrement the frequency by this digit active in edit mode ////////////////////////////////////////////////////////////////////////////// void CFreqCtrl::DecFreq() { if( m_ActiveEditDigit>=0) { if( m_DigitInfo[m_ActiveEditDigit].editmode) { m_freq -= m_DigitInfo[m_ActiveEditDigit].incval; if (m_ResetLowerDigits) { /* digits below the active one are reset to 0 */ m_freq = m_freq - m_freq%m_DigitInfo[m_ActiveEditDigit].weight; } SetFrequency(m_freq); m_LastEditDigit = m_ActiveEditDigit; } } } ///////////////////////////////////////////////////////////////////// // Cursor move routines for arrow key editing ///////////////////////////////////////////////////////////////////// void CFreqCtrl::MoveCursorLeft() { QPoint pt; if( (m_ActiveEditDigit >=0) && (m_ActiveEditDigit m_FirstEditableDigit ) { cursor().setPos( mapToGlobal( m_DigitInfo[--m_ActiveEditDigit].dQRect.center() ) ); } } void CFreqCtrl::CursorHome() { QPoint pt; if( m_ActiveEditDigit >= 0 ) { cursor().setPos( mapToGlobal( m_DigitInfo[m_NumDigits-1].dQRect.center() ) ); } } void CFreqCtrl::CursorEnd() { QPoint pt; if( m_ActiveEditDigit > 0 ) { cursor().setPos( mapToGlobal( m_DigitInfo[m_FirstEditableDigit].dQRect.center() ) ); } } qthid-4.1-source/mainwindow.h0000644000175000017500000000472612054762152014407 0ustar alcalc/*************************************************************************** * This file is part of Qthid. * * Copyright (C) 2010 Howard Long, G6LVB * Copyright (C) 2011 Mario Lorenz, DL5MLO * Copyright (C) 2011-2012 Alexandru Csete, OZ9AEC * * Qthid 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 3 of the License, or * (at your option) any later version. * * Qthid 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 Qthid. If not, see . * ***************************************************************************/ #ifndef MAINWINDOW_H #define MAINWINDOW_H #include #include #include #include "fcd.h" #include "firmware.h" namespace Ui { class MainWindow; } class MainWindow : public QMainWindow { Q_OBJECT public: explicit MainWindow(QWidget *parent = 0); ~MainWindow(); private: Ui::MainWindow *ui; /*! UI generated by Qt Designer. */ QTimer *timer; /*! Timer for cyclic polling of FCD. */ QLabel *fcdStatus; /*! Label showing FCD status in statusbar. */ FCD_MODE_ENUM prevMode; /*! Previous mode to detect FCd mode changes (bootloader/app). */ CFirmware *fwDialog; /*! Firmware tools (uplaod and verify firmware). */ qint64 lnbOffset; /*! Frequency offset when using up- and downconverters (Hz). */ double StrToDouble(QString s); void readDevice(quint16 flags); public slots: void setNewFrequency(qint64 freq); private slots: void on_spinBoxCorr_valueChanged(int); void on_spinBoxLnb_valueChanged(double); void on_biasTeeButton_clicked(); void on_lnaButton_clicked(); void on_mixerButton_clicked(); void on_ifGainSpinBox_valueChanged(int); void enableControls(); void fwDialogFinished(int result); /* actions */ void on_actionLoad_triggered(); void on_actionSave_triggered(); void on_actionFirmware_triggered(); void on_actionDefault_triggered(); void on_actionAbout_triggered(); void on_actionAboutQt_triggered(); }; #endif // MAINWINDOW_H qthid-4.1-source/firmware.h0000644000175000017500000000306012051012677014032 0ustar alcalc/*************************************************************************** * This file is part of Qthid. * * Copyright (C) 2011-2012 Alexandru Csete, OZ9AEC * * Qthid 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 3 of the License, or * (at your option) any later version. * * Qthid 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 Qthid. If not, see . * ***************************************************************************/ #ifndef FIRMWARE_H #define FIRMWARE_H #include #include namespace Ui { class CFirmware; } /*! \brief Firmware tools for uploading and verifying firmware. */ class CFirmware : public QDialog { Q_OBJECT public: explicit CFirmware(QWidget *parent = 0); ~CFirmware(); void closeEvent(QCloseEvent *event); private slots: void on_selectButton_clicked(); void on_uploadButton_clicked(); void on_verifyButton_clicked(); void on_lineEdit_textChanged(const QString & text); void on_lineEdit_textEdited(const QString & text); private: Ui::CFirmware *ui; void checkFirmwareSelection(const QString &fwFile); }; #endif // FIRMWARE_H qthid-4.1-source/fcdhidcmd.h0000644000175000017500000000603712051012677014132 0ustar alcalc/*************************************************************************** * This file is part of Qthid. * * Copyright (C) 2010 Howard Long, G6LVB * Copyright (C) 2011 Mario Lorenz, DL5MLO * Copyright (C) 2011-2012 Alexandru Csete, OZ9AEC * * Qthid 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 3 of the License, or * (at your option) any later version. * * Qthid 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 Qthid. If not, see . * ***************************************************************************/ #ifndef FCD_HID_CMD_H #define FCD_HID_CMD_H 1 /* Commands applicable in bootloader mode */ #define FCD_CMD_BL_QUERY 1 /*!< Returns string with "FCDAPP version". */ /* Commands applicable in application mode */ #define FCD_CMD_APP_SET_FREQ_KHZ 100 /*!< Send with 3 byte unsigned little endian frequency in kHz. */ #define FCD_CMD_APP_SET_FREQ_HZ 101 /*!< Send with 4 byte unsigned little endian frequency in Hz, returns with actual frequency set in Hz */ #define FCD_CMD_APP_GET_FREQ_HZ 102 /*!< Returns 4 byte unsigned little endian frequency in Hz. */ #define FCD_CMD_APP_SET_LNA_GAIN 110 /*!< Send one byte: 1=ON, 0=OFF. */ #define FCD_CMD_APP_SET_RF_FILTER 113 /*!< Send one byte, see tuner_rf_filter_t enum. */ #define FCD_CMD_APP_SET_MIXER_GAIN 114 /*!< Send one byte:1=ON, 0=OFF. */ #define FCD_CMD_APP_SET_IF_GAIN 117 /*!< Send one byte, valid value 0 to 59 (dB). */ #define FCD_CMD_APP_SET_IF_FILTER 122 /*!< Send one byte, see tuner_if_filter_t enum. */ #define FCD_CMD_APP_SET_BIAS_TEE 126 /*!< Bias T for ext LNA. Send with one byte: 1=ON, 0=OFF. */ #define FCD_CMD_APP_GET_LNA_GAIN 150 /*!< Returns one byte: 1=ON, 0=OFF. */ #define FCD_CMD_APP_GET_RF_FILTER 153 /*!< Returns one byte, see tuner_rf_filter_t enum. */ #define FCD_CMD_APP_GET_MIXER_GAIN 154 /*!< Returns one byte: 1=ON, 0=OFF. */ #define FCD_CMD_APP_GET_IF_GAIN 157 /*!< Returns one byte, valid value 0 to 59 (dB). */ #define FCD_CMD_APP_GET_IF_FILTER 162 /*!< Returns one byte, see tuner_if_filter_t enum. */ #define FCD_CMD_APP_GET_BIAS_TEE 166 /*!< Returns one byte: 1=ON, 0=OFF. */ #define FCD_CMD_APP_RESET 255 /*!< Reset to bootloader. */ typedef enum { TRFE_0_4 = 0, TRFE_4_8, TRFE_8_16, TRFE_16_32, TRFE_32_75, TRFE_75_125, TRFE_125_250, TRFE_145, TRFE_410_875, TRFE_435, TRFE_875_2000 } tuner_rf_filter_t; typedef enum { TIFE_200KHZ = 0, TIFE_300KHZ, TIFE_600KHZ, TIFE_1536KHZ, TIFE_5MHZ, TIFE_6MHZ, TIFE_7MHZ, TIFE_8MHZ } tuner_if_filter_t; #endif // FCD_HID_CMD_H qthid-4.1-source/images/0000755000175000017500000000000012051012677013313 5ustar alcalcqthid-4.1-source/images/fw.png0000644000175000017500000000400112051012642014420 0ustar alcalcPNG  IHDR00WsRGBbKGD pHYs B(xtIME?rIDAThogff{׷@ "U)AI4iDHmkU@AZ)U%!`(qJ v!"8k`c7lzӇgUZi?|sogۙ9g,e)KYR|u"Z­3lZO|5Heks~@;W59 9 MH@krj_ү'r4,?>LNTfmxrtibzwWr[8*9HO wM4MK.ȍй'tt9kC G?c)~m[WTPYMɕ!(ྱormk>w_׹pK?q gQ ~ DX,f'ʽ4RrPaɧr`h[ڑ&Z(_;Ɨ5sR>U|R>sFBE|H(|xwx͜4ҳ:4 uYzB7Ǐe7zG^>x8w \™Ց>f@( ew<)][Jsxصck\ F}Y/8w}š^.- }ޗ@ (½==b;Js/?s_;R~ Tww{v#]̾GIgbӧs{ J\E_{ T d'vd.-ßP= ޵3獾#qҙR,\{Tzsy sյRUgV̀Ygp_'|`FX6_9ʁL`s>J;X6zm=v 4Z ׊-.@cƓ|G4UTT$#GW>fW GIkk _ߏUBz E.ւƍ ue.T$ fsM(Jä3Di uM0s7ΦND'{7NLL tr{zD"N8XN&&'Fggfb.}ٹ$wL(>o|D"`~>M<W =&РXF2iRikh)@nT1CJ15ON麫m]|ܚu͛Cؒ!ZM޵yXX?iY )A .f9QB_u!`q!0NZib o%$l,c%cУ%( FVEd=,fFYP&ෞ!ᡡ^ahhT~CW>/kέ^AJx 6\tmdchhy%Noy{ 4*ݏ0)pCSAjqTHKv7nCokwq.|>o7NueQ^8K hj6PTNa j +H) QuIxݍjv^&ipcT,I 0̭C^ h6k(l:4 Ҥ+kRYfv`#@m]ɕP`7z@f~tMFt2P Ԙ%#%EKAB_# 4l fI%PE:F[(@䈹IaOѼ=C֔s ϲ߈~(b95܀HO)2-rHIS 9 MϮt|j޾"-9#2@hr^eBΡ(E{,Je)KY?"?- IENDB`qthid-4.1-source/images/qthid.ico0000644000175000017500000013373512051012642015124 0ustar alcalc qV00 h&-r  (  huPNG  IHDR\rf IDATx}Yor3],6Ln`X&);JVN?Yg[;ٖtw>I2iґ($],q&a"&'~5xg0f]]]˹Ph$ / am+L"ѼK7_{]` KU}$%~+9`h/@ંL7}YP m^MزL/$ `^xL@>B(; !>jk\~zp3M[g.X $!kjjt===ݝ?H ƛ\WycJ{W ӝ@b>J8 pX۞ ,Q5R)`KK gbr2t̓3.dw߁\Bz|NWe0Eh'`I8 pv޽~73SɝnݾVkj(Zyk /xaBzSA*|EE_2pzrTnh;@ !@н@ K v@C <@{K @<@ yB,%tCy@,%XJ膶 XJ m9 `)s(t/@`)!_J膶$vל^)[ - &yck@O223x%+/<Wrp _am"13EF 3~I % .;IK@ͫ ׺laYUKJŞHu/d p{ PVVZ֮XW{~N_VʊJ75=Jܔ҂- ^S]銋r*Ј f N@>zѣs§Ա2>1l a Hر}>/ڗD"}L@. Ԕ'@.FHx |p*@je4 ?-c3 Q@kIneW {, i6-z,f/pKg/Dnܷzu_Mħyq],0-lB{%nJ/vf] _{߭7gJlK @ @ ?755{;b:`p=&?,_.Ir"249n[p{\XPL/Kr@B`qS3ܴoM y9nk8\P_몒%>wt<7F8(."S՚Lĉծy+xnwLQV^/:+¢BWY^4^Z6%~צq80p΍^831gԖM=w\o{A3׃gݽν?9W%Kޢsz"Ekuk3˱Ï?myr~twݱݶFXC>^Nýs@` ӟO n~=؏c7.e\sh;o5ÏbzW2>sryx5{a/ƽ=ws'XvN3/QVi%>8r>zfItV3< \?@o_{4cnE{kop;r}SBƈ;7tNRǠucd %ejI7x$)w `V421qDjW&u;cO=K3_s'O?&N']wY,v@oL]\w8x -Ƴrn$~{tǜtlݶ؇o;~+זd{G{.z!0)Hs]ABɒpZ(.> ~R `T|ccYQ2&E]]Ey;s|luɩ>rw߹OWd]Ͽ:1yX%vwg06'xsƕ7fe>{nwJ_[Sjjñ7s2nS/-$?H%0Hq%[/bݭyH? vV%H~dݳSzYI;nЙrȺCGSTϬJyzYwtvr'N^|5ioy9HH{5+;b h:ro. ̾oן2™{g37r90&!]a!κ_RRf톔5%tշz 9FmYv_sE"{Zg to9 WYfٴa#3oe/LH]E8M\bh>uD,ޘՕn͙Vq-]D#^1M"Ԥ(`G"͋9_[[ cAv1nAA'S[dNƤ]޷%%:::\̰uDždJիPJ p^hVY*lJnok;30)?4>A (׿/xX*]?7nڽc`5kN/9tֳoY)Q8I[w-R>L[џ|W\}m0::O󿇆G-?e I˚U&OLg:KSoxy)5lw~J_jCiwm{]cCÂ"k\c|_wKBAd^y P/5dߊS:W֬_悪٥'llo=x(YbF~%wχpWU1nXu4NO&oW&S;JeP[6o+_n?M+74㒓\nu ͩKXW?dQQtae{5.Y_lۺeZtWo{o2L.2ioR˞[nr_?Z 322d9"BKa\5_SskبY b)X?sHm겎k"wO~q`'?zDe?ܜM7ϋGWO|׻3guwu;o_s?S_2Eg⏏3>ZYs/4[5NSI;  %EE%2:9cKH+s?㟳G!G2 3ˆ1 CgcR{yx\L;nK¶7m(oOÒ˞!ftJGCC</Șa_(p%r7rf|)禍\$y 9`xDX|4x8`F_e B |*O@ 1@>,}.sCUntM˛} m\*J ]qb•s `PDkovCSsgԏ 2@֔v92k.oOsNgJܑnpj孷*V9 #H8@cS]Ɖ '`f&ыtzp%CRe Ut2ʣxĽ)7q|᫜ĵ~,mgܻ'bSWnX@9+ qc: @l.+iw4c=_JB!IQk0p%{ /qc/%l|\ q%{ /qc:N-'\ޝEJ @qTpywc\^z\}O(ӁČRQV"'s 7lRljK+ Sqc/%oT`'jЏ{~/BC nLY+y#dWiui[p>)h{d֜ڊ"W].RMjVe{vud <_F[jAX] S\Y>Dŏ\JxUQmh,u׵Tpoe7VXoj;zkuMm);{~V%T\X>bDOΜw't @ @`9!rB;<+@ @}Н@ <@E,:GwwmUnl"݊\[V{*J;j8L+kkK\I|k[]Suz6¬6i(iHh,Z>JDH$ґ LMgs %dvzXbf9y}  :/)ƉJKp"' {powr ^14 ?^Pypֹ8P_ܧϾ{nl,;g9 Tw/~}/g=Mq⼅m9|FQb5tr੏r'v[7r[TrJ= N8J][H-SS'iTt70<Ro˔=ϗWV3YfYndxĝ8G3^-\(@<<}voiNrZ0{ sc'm[/^ƺuJLset@i+Qi(^f{*.Ꮬީ`]W.KU Awm{4[{WTKDDuo_7V:* /ݞw9IPcۈlCUnT{ɩoyAUXLpUsH*// /\IJ].\$B+ \I_3KEB l% d(R6_IiKZ>W=(T"WXT}rx׼\~S3nZSxs" ڇ  pD+.)vť$)ҧkAwAngB"7 =0 8#p&@  pUg)--ue:=(Zf}#SA UDe*ZP(JGB}C0=3% R 9M$֗ҲR!cABȟELB䎯̜?O2# ǟBd 0%E h-zH 8@`!pED !~qI!0ܙC=dM_' AID!z=\%za@!L WWYQD|!< Gv =!HBFbs55i+Q~W eZy'丛P~zٶIb"] ٭ XR\.)BȟEAڵmqk׹UM\ee,ΌEOQwltu*ɓmM[{GƴqDRHtL(C+r+B X.xP"q\BC8%BUܖ܆gz#z2< -kZl۷V7>>&Bpҽ;| Fʳ'm^"$ % HYY+)-A.)*N@VYUo."^~&,RGB!$ic)oڴmڸI`}wݩӧґ>& MMX(Gg8e &"PUUn&m5šX#Gt{v/%]]6cNN:^z%S軯?JdD%@` Q&^ŒfC_sw>$#0#[&ruӧO~웘tB޾>W!##:lз_ᯭY}3uϜr>}>d4I'j, X\(`Q:aH Hφ*㚝n-{=KE2#9 / |ҝ8q >44lxȨў6q7)ʵf6y hxQUk?w7 RϠo 2I;Q;ob@`eaFqEr$|uyݮɮƉ&T/;A;ﺮN708&&\UM )gܐ!>uCî` $%c''z׻֖]w媥P;vmsI WD'DsJF`.ãG[>)D>v\r11Y;s _W̸ܻĸ=cZkchD/++g s"%S&nbb>ܠG>p55U;\] z>򀫭I7r9q|;)ˣF 1x<`Jڧi{zΚ/"/=ƵĢJqIqsC IN`CS{ΞSVRf?7SO?>?֯[7ZPJӟ{Gq1 xIFˆgA.yKwkkkyE9o'xJL/surq5CF|Lژ6HyM ᖣ/FY[ť"3O>W-K?F=BZqNz|{{?Cw/I"߃wѳ?R eE$LZ#0Ka pK?75rf'G{WlM=+##ȋTdqUbQ)&`Daܰ 7KA8 " SZ뽤 `R M-X81 奮3G}nmvw{z3)zt~ T27j7e[YYm6NW/bMdٲy;+ Ym]@c<5&+jZ-&^.|77ku<Bn=8T$]M ڴyfCJ7*A_o EVH\>#R,uo@ ԍ:Qґ ]9$ַݦMS7R}[LxעK~WT4bAQ]Ǩxo0O5kgcL$^6l`ב$EH;so\_\/Xpa3+/Uo=G+5ܾT~VhE]@Qoddظ2.68uΟ $0~EJ3UUYFdjݩSnXe폎'6bmT*;ޑ-aO~\G]qw{X{b Rޞ[nmeC!̈́KkR |掰a=ZF*CMuKH( $6TVsoI1})k}P"Uuu-"bI+ "{u_O(&kyC`zsx>w~Hv2[[N˷r'6n '.zC5uwjxfQDx AHZ ^asH:o REA7.F,# FD{OOkC02q}\"< %LF޷[;s挽7hweXgxր\ Dq.1nޅs%<"Ik>ў,s:;]}Cp! E@n>v p#<>>B"ףjXiW E|  ߴ3iLH+$@hH'5v$)PD =,z 8HE!^^%el-b H9$) ['XǕcǎŝscwaͬ|C&y3}x-/G(Fk>:yÏ˨[vmr+S:zE⚯ .=wVq2 W 괓*˧s9'5n*\+_,|-5gqg<,#";:6*MBq;2XB{cF@Fƾeg''= lE;ͫWKO lw=5 q8IItc_p˿lϿS-&u(e&lWZin^#UYCxc̎V!>]Ja"ў`5k'Y-:cW}%_`хƩHDf#2cC58Q1WUr\@,O<+ʍor=lH!1 >޺u IBJڛ>r$sCdj%p*7$6e}Jȫ^Y̷?bf= SqN sDKu6JݟXpC~-fI&=Wyy} >LAXpw mh00hGG1շIS/OClpB 7.G9]mC 8{P!=XE[a|ge]M'N-qkbʵ;w[nk|!}v*i%UF4.,b9=e55b i30ޯTxZ>x 8F@z'čo4-w󗚶+7eYCuqA1χ50UA2@F= Bü >.Sp!*eD "PY`˱Z]|H?9T\pu1 BGٻ!p Cj6ȭU Y *\ɓ+zu˖9;&rǽШ;NbЂFE;cgl ՛YPd%wA/dd]P/§nc|Da2cYEћ=jPF=Rx+CDDŽ޾^#!c'A*pBr9~=@ I :Vwwu#D+sN T,$;& -J"{ED1M{ڶ/τK=1~c/( 6Rߋ 'Owg ^c$޾AwD)"tuw]2 $|-9H#FE^߹ڈCWԠg M܇K#Jc9'\`YAL>z-a\=縆<\oC;/N=7`ڠX3Ͳɕ8,W!yj >7z&JiB\$(%L?qH5FĄ}#G]&IX<@Js+IxdRZaɮ7,G}:t(|e߉ Y.GD` c?&Ut֖V̞ȳ'"ҍN !jMA`EAxb# P@JBT(dikPc?30"U~Ӊo3LJeqs@a#!*pSlԎq!7ф0bf?;att҈D{LM6+viXi\uY?Mɼ;zQ5ͫ4O Sr Μ0\# JeyC!cɧtp{$ruש Tʼ)W'G߶, t-RZl>pZ}b&̘iUqR.<Gt';%6_†A,w,saTpp&!Z׭/wcV ##&mH7A\d=uxnhD@ b053 h`4'9bxOJ+G7tw%9IA2felDҳ~>w ~fL?9AE|Ks3u,#̦d9@D޿F.ؽC `!bTrBOX#zUQTo)iIWH?aq0uǬ8q$ $ 3`f_(}rJj`һމQD]nn!DB0a,[񜌍8,##3)z`HDπ"9H~_PY-޷Yڢjm9+̾|ݣ@n~ӟTft>@5[e=͏>!O 16D3= ~}O#_x>^L )lw^D}[[S /z}%20ʯ&* 9!qۦՍ6Q˾nR]j9Sw$ ޯ^lIOTpgbKa01^Ud:%l i{L G|/=D#Ah8i qzîf+ Zjqm'zRXp=fs (wvڵ;gӁIE v":Gq %s] @=܃TD1nv[W=3OO~SH6OTe' ɔF3K$VN ~ 董tʨpv^3"+$b͹_-$C*@lG‡$gd8͑ n&v]gMkT/A(0=6|p؂q[N_<pM"d!YIYƣ= &>Ꙭ2tBgVG.PbR ҕJxNcoɏ̪cc#dkZ+vcu;7MQaIݲ;4)#zmFR+! o>@yyI*g3 KOVqjӗeClw  zI|L3]xZ#D>6nZd k۟qjF w8{˺Vfu(f+pT :<-[BB|R;d. "U0 `pnP ۱}UwBC>xd.&z16_S\f5 g7o1r`X;X<e)*7R kL{YvA| 5v! 1>nA4~?v KrTm joQԝCC@h]ע#! @Z®C&o޴fs~Qש-Ipww@ DD =Nʠߟ ;ā@ NH=ܟF1J+T6][tl'@t\ZFrw?q\[ FNܰW".Ie Zl#$ݝ0CeubP6n䮹~Gcҷl\rZ+,;@׸!6G]g*~o74R :kd(P]VWχ>'÷x&lڼ^:I7ܸ&YDt˛h ȯG9eOqǎs[mzk&54e8YGJ 1D!tΙhN=$9}6= #“ ;"aT]DfjZRB¢tWtdU)܁X Q(Br `ppa[qe'`C p5‚D'jDƒ1C@}`FD%\I`'P[6o|vWL<,@>wq?}gm .,`*g@@AHU[^.,/){0?]4Ynޱ}GIxUH?x./ܱ&؛~eONb#c`p y׏nzIҬıFdV5V{w!kU9}Q6-8|L/qRX\NN"N' x#,d&"~Ñ>8tI&nF}KM)*QV7ADr6 $ jgJ1$#of!!2_} ۶h77S^G*wApR[TmkiW*,G!+~}c<Ӟn%=,ڸqt*9+,LGOfH@$ad;ek; 7Geؓn "r×) ! j? ;La̿Fߤf(nOn9XYHB(qah7wWߩp 7oqHx0:23 w%o$uaM+PIOp !*sq7tR3g'r4 bf9"<O|# 6!*R;v̽⋳Oۨo$/[؀ˣ9"UF| @ԱA؍U_LmHl"0dkZ2O-eI@/ P o~|J!>H="& IjЪ>B"F=>2+pMkW{qlarD!*fHmmJ &w$v D;H {olzV79%ő @0ǕqkMwc#(멧ָܼ:ԼwS'`':~ZZ336SDhǤv6iҞv]w=*⠀2BSKQD8^qM]t,NׇRG22i.9x}P|}ҊR}dwn IDAT@DXdLZ#w-]IqQ#>.lHܠ[>j85$C$<OK݈J0BTa|ȸ*H=031aI`t!?$[R *SRoHmr̂1.ߩ1Soy#1)%n̰vsIQj;&a4@ ]{rzˍR'WYYp/#=,>lE{@(ŏc0 r`3X$@SJ7X(cAzM @E$N, QSLdW'տFP0H< JQAMܜzH=l_+kֻFRA19fCBA"pNVSΙ$SfHxD5@ c5!U^slo.=`0Bs`)7 gm3dajlh2ϱ߸n{[N9_ I_~r@ L ,~|0#3M*=G@1  `wk.Dx ܡ 6paLSУ//J^"@b/L1F#ell*TddE=ˑ E]Dvy'xa T 1Dz"bJhͫMA*V}j!- w_fG<&7RߛsC wNW2;B$&J1 yǻd; X 44THݭ DE ~|@Wi @\,dlP' )@AO/dK-="($USʾ]5magtw[8?5P[xARƘTKډ+\;u$f냁=\e`@HK-6$2/`R.G ~Wtw0.8 GĀDⱙF:nx 7k a$@4P'X~7|"ƶ@ GH.aӅD"BX(]/BA'nos1@z'{LOL9hQ@~?)J~AEt? \d}JqJCF#5H=,pߊ>NE\S8 b0Le$8}l;t##D7Df,\47}̐ßj/S&"c۰Y)E{Z F|DW$d)#B&c p \٣oN1FL>&%%1RT̅H,+~< 各R8^h$$D Hή? ?*$c; ߀;</3G|uf]&g'UKm95\BW@J", gx)VrFܟ1!ߊAtfy䏎aGX37["Gզ渡d渚HQed!#mȞhżzd,dA2@ްiqa8)"+|kO0R~N.%a} n)@|xsb ؠsYx%2"ݔ "7 Klv`/|¢P%&ɤއ0_ <j@%c`T1$qy!Ayb. ;J.|%h`J1H kFD]ųbȯo/ؐ]u qVL!47h? #OWFxl7hEI|feッA0J-q|hL@:bn՚G"h\y-$T B͆!J'V:+ћvtb !U}"u7 @V[ 6 ukV 6X!0%E a"po"QO̕!QX~LA,<xCXIqq$]4dӷ9ft=R܎3d( |/Z]Q혁 N-ܻ32DyH^H+s^f# ɋ΋ )H.f D@|\pk8cˠߴL=$k[l9.$+: Bd`!Bb"&p~Qh.fE;DF(ș''cq\]HgΊE!xHHJf`3N[qY5|~іMgH=C]B3_N`D7{XLktp\hIm{hۤ7Ul 6zJa72}4naqqXh\ŒEƉᚄds=dpdLpJBZL;,wX Ee@;Wb7qIJK mAQ1k K]u.GYXP6I…@ޑb6 AhՀ6Pk" \9Y|[s֭K{<9WI'c|%\ۜ=q7Lr]alUVDf벬D|Q3=l+|Φ&QVq}Yѳ17(6Rs#kw[n&4J;q c/"<!$CKú_ yyǃԥꋤ㸊?܏ΈhNz&R Dy $$N jqR'jJuIĈO`KNCg}ȔWYX C@$:AV{3_v]5"ħ]^qeV[_c1+,+ q=)R)9zfTW3DL.xδ[ )%C;:g2k*~B.H|XA߇9Fo%9ģJS!pd\5b7;0ԨL=V*i YPtIW)ܗF< ;h$  @?>:/A/ZPDgH2BDЂ| ;%P7 2ԾX%xэ~4TǵybroV}ۈRhX,>d]b&j|"ps dT u 6 ̋'a(?tA ;w!U7&N>&Glǟ[E>DxGiMFV?IȏȊ2!*89 =DH D >H0w"Z##Q*<% NC? H ~"FDEAoo'H7 *YIQŽkJi/|.w"$=Rm]\et<^#߅ U$!r)$'qz()qApܤぜh˥WģD[Dq&U瞞ET1'<<W!:)uTKT C`XdÇy!-?F/Xm]TI! [&Hv !עĨI7`F,[,j {R{E{(72aÀ6٧ph^;2L@Pd ׻'OY.A DV7)/&$-ȇ}YL>d7w :\%0Ӱ]Ipgbjrb`l޲tv$B!RB$^ffĎA u<w&D1# ʣ`*CƷ|,gpYzWgp.@)ˬKJb?)O M\a:6nW6e+;ᯖ8TH 5WFh-!FW8#GCHߞI>XOhx`l@a\*$iȔ"HE" {yn=/3>:vR" K&Uرc.pɊDI(, ,ef ,pQV+ez@Q'?RqmUJj{bT-5諕b?V,H(L]@fĮ  3A#ۂdzy @ Jb!}< n:D@z?XeJ3 3 |-ȧM-z?1˦Ks\ >l_7\;o=u fǩqW0,'-:%WKܣTk4~3. fZ&n^( EaUoRn XkްM+BG&=J5eR{ GIAJwEG%A ld3Xl2qn0p@,G)G K&2x, HoӖ7x+v> K+_T0?@Ix%^sK]l=hK>7jcmޔԔ~篿"BIJ$f4ƺ٢74KA$!cCU .K\p`P|dGw$jĠ<2e!qp\s H h5Bw椖V?[cA[[Iv |EL眥RX٘B@*Q &$ad!E7EVUdljj$ AJZВYF?y~T/rD <ȑ#a?(ѯb-;L-> W8_iM$x̲OXgjEn#&"5 <,0K:|6[m5i=ga|A=b5:MSUL1!ts C9@zj 6+qVp{Dg!OΓ ٻkxW:, [0B1 ?"h\sY%+I5:{+\H{{NrOT"Sse>vnNS3}&j+s$:5O:4qN,y|+& 8Ό/NzJ\l ]f ĽhHC;]!܈bHMMJ&"4>9&נ(/N"O؂!``oS=""qгM c {3"8f(uw9'rFcmpHeH-|?LT "cbq5tm< +\Npaj&""_H< oLj>P2Op~tf#`pq,&1l V3̙~Bt]FI`BH6=n톔샤xxFr Nݒɑ^ř^޼eljpy{A79JA^HR#7kWrYySOLT#LDOqGW&vj^1W̩c ZHQ]Bu{;~!7+3-#tdte8iV)CB1Ut` =cf 0Wn΄ {C@}0بC $p!bkt`W dnڃB?{? f%9?iT8b Ƚacܨm <ƻc2t]% HSnF8\Gn=I_y m߾Ec%o/0 |@ `>>,57:\$ps;^6/H7' G% !b::7`T8;26Ȝu0D䁐HK3}>}nDj2!?2^,SE#7♅it5&\L$NVԙ62v9jέ6v/|7gehX.hi$ۥ!|Tt!?rkp BhIH-n62ndĪ#;b #UB Ʌ\$!н . cec`,!0[DcCa @DxܐP0!\WQ1'b/ qbQ eBA6bلDĀo f6HmwWT⺨8!]`VI ( !JE36;L &{-.@\WsHC"؄k3o@_(9+d' $`Su QTW'`Fў'{2L$*PaH~q -qX en2<=9}Lf~'YAZ(9H?}TRʮ&{r}|Zr T }A"v rZ40!a `7UO)鈈 ưD!2Ce2k0"]T%EH6I;8zIDATϵ:ˇbZchhӁ#J dn1cvDߛ}&Ր-Ų& [fi"x Bp֊3d+ a(Duu<Q13`BH.|Bpt}V FM&@,O0!RbD5PZP\Ra釔Zq&I/`,B8(!!/pdC㔺F&"nڕ3 ȟ3yӯ E 8.rD2U)<0J؇?\aɋ'em3Ub 3!G]Hsp[lRl!,pե5˂ t$$@@e2=Z4@H*/TgߍNM6 5J6akJpA "|h@!ztjAzFO*_ .wXoI_o r?^~ 'xpr_ m*[ )1! )?R~)SN/5"%HL i`>26` ށ e%9$$Lٓh\RI\!)G( wqkr{aMaWkPRBts D_FIDp/cí! F?V"žBqq籴%6-Igz1D"ĸ'#!0Rϧ s:o:Wsp29 A:Yx @dUP}Z\[ZrU$Gߨh qZeC4y8NNO/R0AQe( .kWF Ϝ:#"nv11cNPَD`PxH@+ԭ?WB\T 0Sm@ AVŅ=dj1[Zf˴fzP0I Ä y12¥AJD1!$Az@4S# >B:?Dx5R_0R# (R*!/\Ő_]W`ִɍסpn@63'^D_~\ V;ǏY6+BԺҎLj^wYymA" |c61 8,2 %j ; EZ k0Tc e󙯰~qPVM']!Na$`o;o-\\LeV*HzN8!2DO *g2Q.D.4@S1Ƚ 2i7DXO0S$X2R"Hz$ )u[F-zU^P.Oq%4 kқZ&HݯH1gQ[=V&CXק=6AhJr$A#P UJTK|vrrIZ,Np-Dž_p9@@c4 YOe/R^+XXgLyXEgVʉ'Ȳ}zT~BboG~Pѵb~wI!qžl%D)J ajnP.g[u2$b#n^|PE,%2e`xE*q@fL1Ƀq~ҢuE  > sd@ 9ay_̸'~bÇ2X "5tdsr/dC!}"P9$Y0`¯Zhk~o 9Su-eϯ_2bn-B"R,w4Tȇ!B\O".p}iF`&M^sO.Hl(_ND/S1!BANҗPnHi,s91֝Uڮ~|mzBl-|x#aåBz DgN }!I%@` ԑz\-YPFy\w/:,_gâ%Q J"c`d'$ T V^*6b ; Ly =ŲJ͸¬u.9tf ~BsI}1%/Q$"X %.$<1ء>L hqeu#qrvB >&G}\uunsVYef#N@ff&:%צ?E3I4/{=yG|lM/f%$\13s^yWo{=Y/OH1jfQ\\{wyO|};$jK-pw}u}iG'^}]lx LVv-fao1{uwuW0y]˶MMOʪ,O|0ml) ibδvЛgܭ@pXc9QH @`SI~ϐ&,M(vGI4fhS|Kl!}}r?񅟈5<?gwFOuIN,8,@ n ly{iӦs @ @ ? pq3+6i-G[Qp((eUoc|}ja6ܿ߷yq@@n!@"^ӫ]O~Σ׮ObZ-9z}2rQvou mys] b,{jki=/\kBsͦ'@ @`!pӯ{}qϞ]]m葟,RTêUe2dݚz_|ʭ6(UÞY'X+u*5(y#<@!0/u˞oh}vV)?kPn|^p()wV]k gmX+?J,OO5y?j@,К{U@@3W_>+~ #=!|ZIEp&ǩ /+X6ݗ1#@ @` 013=xzE~̊Cio 8~ikޡk`sl *ʞT+ĜL>3JQ4{ݪk-zJ@B$cf!ΞS1(b%ګNڵ0mT3:2UٴvyٳL#{NV9\Q7:DB{u2oqN‹̿c|M/8k1=#gD~=3Mt|\/y͟܃?C137P7|=}Χ9^ǩu)dO} zc=mzgyα=RkS['@ w xH=yx!o9K&" AL_6@޹6@z}8,k'vꐔC S%&o +|cr,,}^VVf;]O4% ']ͳ7moI#ى9}W艜ikb$W^}pn!-Zha1ovcgODn#98VVe;}M[||9{n >M1fÈ(vQH-GOK/HZx#4kbjgRy) ,yN+trϘks0<ӸXVc1;K];| [YՁڗ-=a Oghq{ F^4ΨU2xyϾe)R=|3 8;x.*oL_Y B ]f{.<1fj+38ӸXs)prO> a)?uF<1f{I?h)|P:OWiE>18\ 3@zjd y>&5}ƸXVb E='o}n1y袷g<\ €@ۗqb{+*sXNG8O<|+VǞW}=ʭX@(e 2P@(e gO\IENDB`(0`      a~ N!gf`YXR stsn󴸷XVQ C ,1-JOL>C?AFCCHD@EA041"&#$(%274AFBBGDAFBAFCAFCAFCAFCAFCAFCAFCAFCAFCAFCAFCAFCAFCBGCBGCBGCAFCAFCAFCBGD>C?INK/51m HMIdhfW\Y^c`TXV;><./-'&$%$!%%#%%#%%"%$"('$01/@CAW[Y\a^Z_][`][`][`][`][`][`][`][`][`][`][`][`^Z_\Z_\Z_]\a^[`][`]\a^X]ZcheHMJm X]ZNSPIMJ+/,&&# " "%##%$"$"! 031LQNPVSPURPURPURPURPURPURPUROTQOTQPUROTQNSPQWSRXUPURNSOPURPURPURLQNX][=B?k @EB]b_OTP364553++(#%$*,*,.,/1//1/.0.,.,)+)#%#% =:TYVTYVTYVTYVTYVTYVTYVTYVTYVUZWSXUUZWV[YLPMHKHPTQX][SXUTYVV[XQVS\a^AFCj =C?_da9=;9;8::7 "!+,*.0.353586697576242./.)+)#%#((%,.+EJGU[WRWTSXUSXUSXUSXUSXURWTQVSTYVOSP./,  685TYVSXUQWTPUQ[`]@EBj @EAX][364NNL)*)&('020575:<;=>;<=9<>;9<:465.1/%'%()'3316:8TYVRWTSXUSXUSXUTYVQVS\`^[_]QVS<<:+,*365365/21674UZW^b`SXUZ_\AFCj CHENSPBDBPPN " .0/353;=<>@<11."#!))';<99<:242+-+#%#==:464LQNUZWRWTTYVQVSW\YJOLy~|LNLMMK7:96984768<;587::7DHEPUREJGj DIEHMKSUSLMK!$"364475?B@:;8! 22.?A?364020!#!AA?;<:EIGW\YQVSTYVRWTTYVPUR_dbcecUWU133ADC586587LMKOROjolgkhW\YBGDj DIFHMJ`b`OPO')(:;:8;9DGE9:7\\[;=<774?A?475242!GGFCECAECX]ZQVSTYVSXUTYVQVScheMSPvxvdedHKJ^a`UYWGJI598`a_Y\YbheinkV[XBGDj DIFJOLgig]^\*,+>@?=?=EHFFHFTTQ675//,BC@=@>575131 STRHIGAFCX]ZQVSTYVQVSW\YJOLw{zad`^a_GJHPRP=@?GJIGKGOURFKGj DIFMRPdgetut.0/?B@@BAFIGILJEHFFHEGJG@CA:=;253,.-"$"ggfCFDHLJW\YQVSTYVQVSW\YKPMw{x~:>:}z}}dd`DIFuywZ^\X]ZBGDj AFBX]ZPTQ;=;ACA@B@DGEILJLOMIMKDGE?B@464132#%#:<:z{y7;9TYVRXTSXUSXUSXURWTV[XLQNkomz}9<7usoYXSCFBinkINK^c`?DAj =B?aecAFC}~|&)'QRQDFDCEDBECADB?B@:<:8;9475_b`=B?Y^[PURTYVSXUSXURWTTYVQVSgkipus9<811+98222,FJFw{yZ_\PUR[`]@EBj ?D@[`^PURU[Wklk$&$EHFLNMMONJLKGIG@CA243!{|{:>;UZWRWTSXUSXUSXUSXUSXURWTTYVKPM\`^\`^Z_\VZWQWSOTPPUR[`]AFBj ?DA[`]PURTYUejf9;9,.,.0.020,.,-.,EGEBFCPTQTXURWTSXUSXUSXUSXUSXUSXUSWTVZWRWTQVRaebrvsX\Zkol[_\SWTUZVVZWOTQ[`]@EBj ?DA\a^OTQTZXT[Xbifx{{pss|DJHOUSTZXRXVSYWSYVSYWSYWSYWSYWSYVSYWRXUSYWTZXOUSKQORXVLSPQWUSYWRXVSYVPUR[`]@FBj ?DA[`^PURTVRTUQWYTUXSvzt[]XFHCUWRTVQRTOSUQSUPSUPSUPSUPSUPSUPSUQSUPSUQSUPSUPUWRWYTTVQVXSTVQSUPSUPTWSOUR[`]@FBj ?DA\a]OTQS^_R^_Q]^WbdS^`N[[O\]P]]ERXERVR^^WcdQ]^Q^_R^_R^_R^_R^_R^_R^_R^_R^_R^_R^_R^_R^_R^_Q]^P\^R^_Q]^R^_R^_R^`R\]PTQ[`]@EBj ?D@Za_QTOaK8aF1bG1`E/bG2eJ5gL6dI5rW6oS6`E2`E/aF1bG1aF1aG1aG1aG1aF1aF1aG1aG1aG1aG1aG1aF1aG1aG2bG1aG1aG2aG1aG1aF0`N=PUR[`]AFBj ?D@\b_vH'wRgcecccbtJdYccedddddddddddddddddddeajh?mJ/YbaAE@j >ECa]UQ&ҿJ>obнԵM(\_[@FBj ?FD_[SV.˸ҨԭӫҪذɢG3jPɢدҫӫӫӫԬԫԬӫӫӫԬԫԬӫӫӫԬӫԮҧعӲN+[_[AFBj ?FD_ZRX1׵ɓaɒ_ɓ`Ȓ`͕]eߣSH4hLߣSe͕]Ȓ`ɒ_ɒ_ɓ_ɒ_ɒ`ɒ_ɒ_ɒ_ɓ_ɒ_ɒ`ɒ_ɒ_ɒ_ɓ_ɒ_ɒ_ʔaȐ\̚kүK&\`]AFBj C@j CHD`c_L(tEVRUTS|WNJMiCw}RnƊM{VRSSSSSSSSSSSTTTTSSST~RVm>vK,]edEIEj 6;7T\ZOLDeE-fB'c?$c>#c?$c>$d?#c@'qK$nI%d@(gC'fB(fB'fB'fB'fB'fB'fB(fB'fB'fB'fB'eA&c?$c?$c>$c?$fA'fB'fB'fB'fB'fB'cF0LNHSYW7<8j hliz}zputr||q{{yzzzzu~~lw|nx|r|{q{{q{{q{{q{{q{{r|}r||q{{q{{q{{q{{q{zt}~{zzzs}}q{{q{{q{{r|}r|}r||pus~jnkj j iHE@de`@>8ONHWVQ_]Y<:4ggc^^Zbb^aa]aa]bb^^^Zggc><6GE@ggd^^Zcc_^^Yghd<:4><6jkg[ZVhie?=8;93DD?43/20*} isdfb>=8vyvMMI\]YikgHIEw}{ED?y}znqnsvsrurrursvsorox|yLLGVVRx|yornuxunqnz}{FE@w|zimjLKG|}jli~DD?U[Z@?;purLKFH 0.(jmihjf-+$98153-31*ptp}~HGB/,%30)1.'2/(2/(2/(20)1.'96074.1.'30)1.'30)/,%FE?}z|?>81.&1.'74-'$x}zJNL?>:`b^cea(%  t''#"!#"&%"! &%"%$!%$!%$!%$!%$!%$!&%""!#"&%"%$!%$!%$!&%""!#"&%"#"*)' ͥKPNJKG^  ssonroHKIFD?k                           E'%MOLEFB+)" ." RTPGHDl $#SVRHIDk #"KLIFFA'%  kkfjnmGJHA@:j  ikgEGCIICk J!$#1( @    "()))))))))))))))))))))&054/USPPOKRRNPOKQOLSQNTROSRNRQMQOKQOMQPMQPLQPLQPLQPLQPLQPLQPLQPLQPLQPLQPLQPLRQMPOKUSP/.)=<8/-*jje֝163MROCHE6:7 '*(@EBFKHCIFDJGDJGDJGDJGCIFEJFDIFBGDCHEBGDFKH@FCKPM4:6WVRdc`ҟHMJcheBEB//,&%#)*(,.,+,*'(&## 02/RXU[`]Z^[Z_\Z_\Y^[[`]Z_\Z_\]c`]c`^c`Z^[X]ZbgdJOMRQMhfdМAFCKPM./,()'%'&-0-021/10+-+#&$/2/PURPURPURPURQVSLQNOURMSP797/0-;=:RXUJPMSXTAGDUSPfeaО@EBJMK9:8&('363;=;<=99;88;9-/.(*(/0.FKHV\XRWTUZWQVScge\a^?A>)*'-/-$%#8;7`ebimkBGDSROedaР8>:VXV453)+)<><8:7 $%$:;9586&(&674@CATYVRVSUZWNSPehfGGF?BB=A@>A@786dhf~=A>RQNed`С8=9cec9;9131@CAAB@CDC!<=:9<:&'%??=CFDQVTTYVSXUUZVchfjnlikj?<=@=575&(&LMKHKIRWTRWTW\YJOL^c``dc}kkibgd:@dIeI_E_AtOC_JgI`DcFbFbFbFbFbFbFcFbF`DaE`CdI[SRNedaТBFCoJ٥uКh֟iʖm`hM|cϙoנjӝlԞkԞkԞk՞lԝjҜiҜiӝjԞk֟lӝkأthFCJIRRNggcК1:8eL8M'Y6W3V5[2h>9wJ4U.Q/S.T/T0R/S/R.V1X5W4W3R/R.U2~K&`K86>=TTQbb]д|}y}{POKXXSGFC]^ZQQMRSOIHDxyvoolUVPdfb_`\_`\debPQLHGBefc]^YbdaQPLaa]XYUehdFFAQQM784llhBA>,,({|VVQOOINMGilhegbSSN\\XZZTZYU]]XRRLMLG]^YYYT\\WSSN\^YXWR\\WQPKRUSOQMs"!%$!! ! %$""!##! $#  31-͕OSQ<:6j oXYTMNK%#  ;;7IJE 4662HHC = #!proORO.-(tQPL984))$ (0 711.653440541865975775530431542541541541542541652653652541754//,,llhӨa`](`ecCHDAFC  " ?EBJPNHMKJPMHNKKQMJNKKPNNTRINKMSP?DBinl!mqoIMJ785&&%031686020$%#,-*RWTY^[W\YY]ZSWTX^[NRPBDAOSP]b_JOKtyw{zx"djh;><232),*8:7130696,0.#%#;>>B@031beceifmqo~}"bheTWUACA:=;JLJ=>;7968:8./-KLJMRPUZWQVRkqnlnm}~}]b`_a`knkbgdlro}"_ec`ca\_^364RUSJMKHKJ"$#IJIUYWMTPW\ZPURafdrvsstqhhdy~{QVSnsq|"hnkINKRRP4439:7..*NOMkljILITYUPTPRVROROcgdili_a]jlichcGLHqvs}~{"hmkJOKbkiv{}~SYYV]\V^\V^]U]\X_]PWV\edaihY`^V^\KOKour~~{"gmkIOLOLEIG?ec\pnddbUDBxtnsk}\jxsttttuswvurjP:ltsz"]a_nUάͬʛ|gǔմ޽۹ܺ۹۹۹ڸݼմ̭eKfml}"ahg[<ԗ_TђPreyQёKVƊRĈTĈSćSƊTNjVƊUNJTOѕ`~X:jrr|"ell_RFaIuZF{^Gw[IuZNcL}aL}aK|aK}bL~cLz_Hx]Gx]G~bKz`KcLXMBlss}}z""욜YWRqoixvrssowvpxwspoidb]yytutpsrmkjerrlkibMKF240LMH44.;<7`ecipn@A<==7==9>=9;;6762?@;==8=>:jqoOSP>=933.}X\[HJF230 '( ('' '''''''' '&) $C\[X\^[ BB< ::7NPL ;*QPMOOKt' (  )GGIHHHHHHHIGF $ -|}y〄{~{mmkghfxzx}|~}~}}}{~{uvsGEKG-/,"#! AGDQWUNTQMSPOURJOLQVSJQNz}{>~@CA01/453685-.,120V[WRVSbfdHJG&(%DGD`datvsBFJH8<:@BA564475464QVTQVSiolfhgINLTXVhmjtxu@z}z\`^MNL<=;AB>//-PQORVRSVS]a^z{wzzvstp\a]uxuA~}PWTy`ddTY[glkX^]QYWS[ZRYW[cb_fd]dbQWUx{wA}IJE]VMrmewpd^XOUOFXSIWQIWQIVPGVQIWPFOQKuywAx}|t]ٵ˩vâմϭѯЮԱͬ۶t_rxv!@nttwX<[P]q|YPTSQS~OXy[AflmB=xyul +,*-.+ @>9Z[X{P@@< &&$uMNI' %Kqthid-4.1-source/images/qthid.png0000644000175000017500000022443412051012642015133 0ustar alcalcPNG  IHDRxsRGBbKGD pHYs B(xtIME E; IDATxyt\}'}k+ w7Q+Erdylˉc;ętY}{Ntg'sfYږc;ؖQdɒ,ɢ(J(nEKr* "W[~{}DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDtn""k>zc\)yQ@٧X֡Ç3Xn{B/I'-yze""F+~sA'n+@DD4uɼe_hjFhd """"""b """"""4n""g|CPDX@.G!G6C.E6;, lٰ, e,ReenT#Z[P.P*/f1 |PQ*Q*˗ r"@DD@DDD DDD@DDD DDD@DDD DDD@DDD3Q]{c_渟T*K)DT pf ""ER/vNXV\-?OѼw"u\1e^şgt- DD`X\yB͕L?aXm;3FBo3Jegߕe3_`+C.0M!. dul!̛Q DD4'~4#|U2:|zӜ̡C:~B28v e ÷yF@x])Wށ ̷m@DDs=rOd_nݾQ!0g@J֡6:O-B DDD DDD@DDD DDD@DDD DDD@DDD DDD@DDD DDD@DDD DDD@DDD DDD@DDD DDD@DDD DDD DDD@DDD DDD@DDD DDD@DDD DDD@DDD DDD@DDD DDD44n""knͱ@F;)a.ߛ?w%)^9r$GAa eVRa"H!qˎ]W|75=OќxGUKGt^E/ر:N9o!qY0%"" j}$ݲgO+6|r,w| DD4W3~yYMWg>Hc ""MQ =/3ŽxBfrV}*a ""ϚmiM1t q!6D@DD4?[Ɔ$ZSh[r h!D._d ""7ߏr 8"4 m ^i?0C0 D6_՞4d|ZTfaLK.T*(/0ϖs սP(ukM8OQ( K-BXbzS@ DD@$qAOAhhllF` "Mn"""b """"""b ""ILʶ;ۥ+v6rb-*w3!D].RwI sk.yfC/C\8De2 E`""yGDZ^@u<!:tZ`5> Ȇj hHWw{>x|7m ooۺcߩB}Wc5FH)No_`{C;wɵwk8Y3hϨB=ݾs6o}U_ H9:/єtH9՟}Ν;cl!ܟB`-'QMֻRԾ}Mػw־cWODD4mR]裏3߈fį<{}u6oll>ȽEDD4s#l;۷o@Q x@ d X~ (ʰ, eqn4th!Xn\UP,.?4'u3( {&t)%Jr7G߇sݷnZT*B|t zzfb>T ;vGx#ϱtI3n۶W.G4+Wq~,:!e亮ae2]ՆM"//ZqpݳxY{lՇ, (XkVkzul\|pgd֯Ǿg2xyzm\2׶uɜvץ!ijs.45_?;g:DDܶm n۶Wvŗ^ñxΝ=x9 w4Biܨ1?KZkz+x 筷O豓Mx4ΜH.^ƓO=i~i^R؉wq{ؽs{Tu~{,y'N945G<޾k[rKҽSM>l[w!R⧯?=u ȇއ˖ࡷg^u]t  q O|yTfKx/CoD 7mǎ;|SC~`Lf};8vy?~|k*رW(_)|lk\syo}bxq?w;7/kK'Lf|Iź{o.u[෠zz"M ky[7o^~ v;oW3/SK Vo_ՠb')Xo݄YenZ ~ڼvZt]^xer?~Gݶm|g9ژΜǛGy湗xgvlڰǸBM o۳F.FЃjGJ^<ˮ\7=^?t??(?ClwD/8r;dC#~7`Νf=(4j8 ONڳ/?h fރoa"[CӵN͗ !>uUmXmZõTUEc~| E:x=ИjM.bA\ҍt@M?Իgy㺺=0OwǺc$1|>hO,z;i}ޱ(.2r<.]Bo=XckbHTCM 7b8;]֭eKqcCXh@x>9qמӚ T*<2mRھyZ ^|&R5=^ z~c:?^e0 3^lZp(˞U XdNΫ5]ǰgmE@cܱn۽{<'{]4aeit5uok߄;vo?]I<^46&=?lǥ;seWZ;vog񧺳QSoԹs~kJ( ぽw/+W.G2tZ z]mEOOZiں݁wXKimcY۶m'V<Ŧ kq45|P( +2z2_0I*r]|*2$=Ģ֯Cw_> ͛f/hZ=m<ǴX^SWͶzUxӲ?gŰyzV:-B'$z_^~9 KZ֥3~b1JxP{ph^{soۺ+ۖks<+`]h[ x ̝T.wN_F{ٽ/yme?<-kmXֆpxqw93mjw>~Ͽk.b5sVP7[y"x\s;֭Yd2qSՖ<: iP0h4 i5(:R•ҕmׁcK8eTP,[pn6PS^55zw\o`p7kz̩wN;g@}7o9UUqwu]w׿m)%}G.[:gq#xpDca[摷1<p'χY. pc\hZNBR Xn݂9p}~߰[M@ /` !wx#?ϝ58/իVs[VbRB@U盖nzY0TUm۰$ N{j` |pYK>Ta}T*S3>ʹ_om[kvlڸo>Bw}?v]b}؛קK0<@ PM.lr ˪L!( m{F.ùQ/}_ߩQ3ecmؽs;.uv !h^ BOy2Z,CX™snhU+>GgzuP,`YQ5MUuRo>Oxzo~ ۶R8`(uAwwvu/x8s\]0оe3nǏzSZMM., * Mӡ mt:  X.H$X,ukb0 }Q~p'λ/FfMD0MD#,_֊-[H$z캂޾4ޯE  E- mvʹ1C!0`&LӀEhH&r l\[l_} DZ`V?0|]W/Y вVvlpgJ@QT(J5놃x<{puDUUlټ[6D7S"w 1Ղ/N멧 ~:f%&uB\.Nta.NrADDP,gfB~&Mo?B"tC>?;pf gsSߕIQ3U'pV׿F(̇|0 +.sۜ7 Ä(^ ADDh]7t&غWJo(Kz?""ɨ 0oFy &\0~ S>qlpfY""Ej4RTUjRq*OJ) TJuM(iZM""y111Ghq7wwsEX=??23tt㫏}?8v؁[n:cq)DD4i{]u-zo^!b/2^~! J*Ju^̀RJ"VuQ.qJ#эUDDD DDD@DDD DDD@DDD DDD@DDD DDD@DDD DDDt3iqr5XRꐜhN))taCWl(pQfNc`#`Kn2",hCXDXD@s0FBAGW BD4خCڊJMU$>@ S~+FtaIh˻-bfBr0s8[hCeh! e)5Ǎ^@Ԍ ,DD Xxn=M8{ePZ ɃhPp K_(.ŕr#?DD̕r.wX܌r3?DDUZu`Qb+~"EBEz g + DD)&,5_S:" À4 GxK+} FDlۂcY(J b03l6OՈ& BnwxU45Dк| )h'I+{۾'ؘ#Ie }ݸt2ly7@W U,UH[qXiذ~9qΤ$BDS7|:-ACK#.S/ڞ[(Z? v>Cö[֡y HD^m|>;(gXeׯ_,ODhYE9zfk^-N_pm'qт o}BDN'o~,7 2G/hxN IDAT-CӉ[k盉L˞ADD]{Z = DD %~3x"$7Q]oӬ (%7 fD42xD P{ym~C^Х /7<@DD@DDD DDD@DDD DDD@DDD DDD@DDD DDD48 lV1d^? x+L|^)%8g,y~^+CXݴ?6֟@DDD DDDl "Z %7&V0^ԯCD@tu{Nf. u'J=85&x˛JilEt MxKv=,O_S7D1-P h1pp /chmN& EQ!3S<&s(jӲ\oz|Ӳ^_}?bMxwb\뺰, RytuqR?ŚC ,K]F*zrNgxTp1{&%iCn/"q!5|-$V:]#"Tjb 8̼㞈h[滈ZXhlv`w>bbvٸhQ h"ZN~ a_{~,]XP\ ɛ#-h..Ѹ跅h2"epY' BDA[T3x`*%l•r#JͰ΍BDBم&*` h6FO9+V h4]HipJwOAEAAc`#`Kn2",hCXDXD@s0L_@- /qr5XR h.)p bC 080A$DD41111QD@T(B"!B2p !$B-%oAD@Q*PBUEV+~ȵ.~O3)+߹҅p HHq'&""iB5UӠjA_-밄Z臔BTz'@BJH! T~Up% ] u h;\U CLWŵ?\@1_T'' ! (hS pd "b!` SPԡqb B@ ' C{ C/T}%{@TB* T )e5 0 1,rP`L>*Bx czFq- T>])! *ZBr*a ]Å||uts1. L*zx' ,,`toVJ\@m+郦~1\da`ԏG.jW6`~6q$=`Q(SjCaPg10'FU:1c?cDΎ-L8C!`h΀!C=1B{8@h^uaiZ?YFuQ)a(Tjd'hcd>&{D< q9\)@` "iCS? u _u996T 0_?y*$ /Sj@Qoi? CUw(B+bV'' *U7} +!+Eq$džeِEX@GPuC>>CDu&B]xxC""C Tu1@P-a O"" "# 0|PUZhһ#G.S.Q(00Џ2dsEo_T#'^W2 >pGhn!s QMZZ!ـF4L$ (]ĥ^f7. H9C누#X:1㠷W W:џNP/?`dOp\MU(*F"b0t~ES=&.( -MKL6@Q Z~䵗@( )44ifH)Q,y /ǹsO{׊^ Cl@q!fկ(|tB,;u&ږIJe˱y 4mw{݂=Qkz=^z >-[e+pwc` s;p\xҕDbBC?򔃔R AT "ViU_~\dFUUj*Z KZZGGgZw@ elټB;SYɧ$pxcA`-ˆc c _yl "?4VPO&SXvV\0u,3КRyo4}ؼi 6oڂ>?q 'ODPpIoo} WJ%]yMZOU&.cg FuT-+W-[L4 Wu7Tg5?^/b8svgξ7Bww0ik?*[pliB"bZ|>膗ec[P7t֮捛 *EѽwF4z F*Xf-V^.7q:oc{F]%P( 0Mc8 ""_O_P&&jq#ǵG4MDmذn-]wLL?P\{뒥hmiEӧ߽6qƞS^ "b e\~|Kb?бec圷U|v &zIF~v˭x=wf;F|uy 1h4JaH\/ukmTfޥ{3\|2zzzpI3`;  R ǶaYիzD"D! $ ¡Q#륇+pA%H=K.W_իW&Hkc;rPT^%@D >akQN,J7+ukje..^;p):tţ0 \== xlؖl6\.0`N8d*p(UQE@#H Kq]D"qذaÔ%Z}c8)xUdS l-|~`1B0u6\~T] Lv:@72NwG:^z;:GQ,џH5(*džaƢd088X,EQ`[62 B"H}42ӡp$`K8{^9)%"~SP5{6n܄5kVcɒ$3OjݚXֆW_;o5j.|fVDD C0M2yǶ+mnu;Lw?x>9>v sb X(T..H) jl~P c@G?lF<G(Gq8 O&X1&%HWDD y؉kp+Emzkџf'Nqj|>( C@"z{zQ.L&1@,Bu(jq##U{?TEB@$F_o\Ʀ 8.\ׅ8pBp}=}: @_O$$ I9w 4fZlݺ{mPwʕ+OE&3|31G@B"AD $';vaú 7: OOO/2Jr=??|.U@4HHs9AQ.kP3*4L@   ckpF+W= rQD!D"M׆peJ+I9ʕ+ȕsD"WlǎÛo·xۇzhS/5'8w̩ A%A"bX_ׇ^T{^+dG._8!$ Y=%Qia8ǭd2 #^+a<j0M~P%(KesֵG|!ޞ^(x"u!8Y=Pʩ4]ذ2\WB7Lds9|7 >_S)]8|M~qc[qB ?+D`j?4]$0-Kp]{auވt_W̿+UE! Ϭ6*Ã򬲅t_R pX@aB7 ˶ c;(%tB!r*\EXPU "bǶ.J2TEqD²,{(ˈ'0 tNÕ.첍brb(K?3=;v@Ui}R )k<~i<38(P*-18zzoO/Jb-[h46|J`RU:2d,TEazPLՄmsH$lA0B8p!<30L`"JlTJ 臢gP. Сh lہ\* xs?[ouk=^)Ҳ3t:=i30(p` 1ylYFQߺ7m.6әu]+ ݽB Ed2hH$2FBbBRJ׺?V2YJ`PP~ZAJ"ht/E0D8\aPAȺ.*je@S5DQ*H)E:렐/•n"0|+(JM[ />cٲe녯`0x' VC@>!P fDD nn,_:^TɓΞ=XX<:|]u8~Fu=3!iD#ðm BS4\X*a&Lucj*4COW_?$F  N2P8 _,U(׮_9}N *u7JLɆ$2 LÄP.gXl9>뿎p8<ڿu]+/wNMl\@.0LNDD (״5 ݇%Ӿ]o\Ɨxg86lA0 Y]`6z‡D"Y&_MTMtɻ.2d2q!˶1@./C<G? * pp BUU~0\τ*(t C`!J\P8˲*$$`tGUUDP.!t%҅":z|~L0I/;Mqۣ:{&Exd$DT@12@sݵ2tۏTC rqyR`׎]Po=r?"!H)D<_yRFB *D( tJ‘ M+! p¶mD"DcH(B J 20080 `%8wH$Aҭ\G.C8F$A6E_otMG49Q9a`6iu]X% j@lRq5>}}*azcq<DZtRalumÇ߄PI iL5"L"H H Lzߑp8\SXnR ?ӏ^i#_4H&|l}k8yd*E9L&@CUj >W.V4]܍O\h4"+TBppQ jLjT X**c&2 K[q躆p$rt|dڃ!zzz*Wp!a[rʬBhhHBQTtww#IAK0kW.H*@XD8A>mp@5 "w}{߄W \Kn[68o5?EʖlvP1T8[܂T*5| ΋` Xk%( Ĩٶtvu}}I N~`߃H'?Qybeap0B߇X,Сi*z{08ڵ-mjS,*jHHa:ʽPVcPöʄ; ì qK"|&B0v]"j@":t;8 W\UP*a v U_\*KXѶa[WF<GoOjJAU*SeQ.F 0D_o)M Y TovLq:`\f3A E"l[mÃWi#uÅihnnFss3[џɠgϽl6ք({'F4W`;6R T*!  C ÕK m_RX,ߗhjjiA}zzzЬ5T߳D:.;ahH5.^BʶX,"Wipm]aЈ)s%$(3r ~?VaC' IDATp ȡ+*%RIXsD"rH$ P(uӇ^S(KՉ*"h硿"VNضbl7߇~?d2w[P(λ`hZs|>hʕ+L$g9k,O%"ގvtww38qeq2v؍)7q1RgCaBʀ;! @! ]џN#A ݽ0 K[qEtw1Uz#"jMq/^ƒ \颐/J˖TG=hH5}.lF&A\4- i@@6瀨,:b(:f]ƒDcե+HRƾ4lr52Kcu@!Q-qN"4X]ţ([e|#<+<>Xv؅l6˝~J$q~+]w5Fa&D"qC_S)ؾ.Ǚg1uCk h n-Xj5\)Tnt#w]?-<ç*Ʋ,~A(EQF C/Hم@0%K*ſ:NHEQ u~wwO\|CTE u 2dr\U4( ## #`ppڠDEv݃X,kWHQHLQ@AXFoO|~$$\שj?PG`MvVnfԺ2K͠TUA?z{z180p8D"EQi*\ŷfu 7#o^T9Bʽ nbU.cp {ۇ@ܜ0hk[}#~K[r`{)G m+V}-_oYq&><|:-ĪUދϏd"YgDRST!8?{o$}}ʺᄏfP"($jc-{vw} KЮ-Ae xH]}fU^~˪{DGc3ﹾ븨Jq ?ǃyԝb&Lˊ˒X\^u9¶Yҙ(Yjt MD?]IXXZ;bx<&]3$q({t:) %R$Kh6DdU !A g }ΤwOò"NΊ"^_^{ZQ>}Uhܳ p 2h4^Q(>5U{f?dlg7,{,ʧ:HN|u$IĸG*CNȪ<$p1  ~01L9>> i VC8IxURHGi$I,.-Uϒ`C7:ɄN$KLSt]X, FcQ"44MtM|dC ` E4#aPt B1xG0t ?om x8a<FPd!.~6 hƷ C/"s5<߻ӿݺ.\#//mnm~@,~fqvs?Fvwpǜs>𿻵& _kzZ~d_uI$4uM,IzF4 PUϞLV|s0$Aզ\ni5ۢ.Kɀȑԫ5&^pt$IȊ);mnݼ%xPO$(bաhP.CBM+~@Te0k7P. !3bεEf:R*q<@ )WLR= 3_ȋ/8o66O|.ǓO>uX'fgyٍ= >ɿY =KĊq˟ɟPo G3XXZ  aQ UhL'zI$TUXk/-S\lɤɤ3DbB@g4numQn۞`8d}ch4JVg< H!vpPB7u(Bk"D,FNVcqqt:: D*n4kM&{8*˜Q, X Y*G4h4J&AT LSڭ<Drp2._׎9|_G 8qԙs2mP.>¢fp8<Y2U`{g~p2C ׽Vr ^y$|G ~:tl.K,EQdbF&QkP xtJoY"I*HӨ7h6Z$S)*!OTd:ysT:E }"1X&2FK!@ZN ZFRcaxeHv&]CSx2X0܄+B.\*Q-mD2q0,J@,<Kımzon|?{{{ԓhuO %eϾX4'>w&++zpHݢl2 {?O~̭[d3Y2,8zPk4g ׳clw_ {s>!D1)/ƛo2;sit3u(0퐳撹ˊOĄݬ^.TE%Zv3b 0|nC}ieuh5[D" Z**VE1 ĦZ2Ld$9P\`:L:>Dd0aꬬkbDLAv\{.wܩ@EU‰@ eAL%)+A.##(Ub8t8Ӑ]Q'K~D"|OV߲"쳟ڵ~ IU8r>~V,.g>#7do~'>wo_TxrrL^@vѐΐch\.x`fsl1?t'5MS<+6 _:G/"d DL M7= 8xaʌ0]=sd3+A1#ij{{{(L"$1CqcdfN[ڶy6!LiAʤLT*U4]=h4ku(B3!bE*54UŌ0=l6 di$Infbߟ $|{Ȳ(ȳWB7tEߣQoH$d2hvAB"jŸvx.w%bqq|nagAvezN: ].?BllS*O\U(l00 JȹsI%i>;ۧz-YyxwΈE2KV x'FC?w*[o__(d]א%ba eyML#`K%1 ^`0ҷd8.Z-.1d !L[$|g:DHgR1B>"ICœFIXQ\>wLXtLlQ!rĢOs%>3!NQըV,*Az븤3i8"ȃ>C6/[6F4d3t;]ڭE0 I C1zaCY@dE4Mp{{I`H"q *+pܹc{ɧh6bɅFڼ[{tڼ;d3Y.\Ʊ Rd29Jij566α_dz~ vZ4 P,p=~GoFb:켦:K$qb^z z:ȐJbF2DuzhL)Z^K4X,4jMX~o@@$Ib$av-8 P\ATŒ 4MeiiqޡlHX\Z:RVXV=Iy<ϣl YNEc!7L&q⠃IWOE;dX,/~>IP* 2/Ջ÷>6vk|_s^⅕Ӗ?ll*˸Gj"Oʱ).ghzOnd2,|E d1'x$R L pm*lv UQh;Gca _.J%Zm\.8ˠק,nCDݰ^IL&4 zTFGcIX{磨*@lF5gdK5U%cǔKe[BX,v0?/ L&Cݭnw|۶_"F.G5Tt:mҲ% Dpth,[H!~aiʋ/?Kx{2#\?OB68}F|>}3eg?+r_j (W*> \6'څ!|ya謭w{1~ҩ4_—x՗Fd{a{v+]B2/yt{3ތωw$IBbш^'v)$SIڭfMװG6Lt&%twO99&" ~EfJL*a8T : >dB(STheYI:}dYX,2 ;rn9TU#bY(x4Pȇ*!?":j dYdE>@=Kxl4Q+*~#L&pVDQHiOQdOuo\d{gKL@F\>Ƨ?0྿-,,'<&4xضL]z'T] a &)_|'.8_җyWid /$ ^ ~l/|;?0Mx"F7 }6s@/j,u]یL'abGE&ydrGeNMD2iF0#t/.ΟC$% $S)EF5|OdretCu=zD"x=ڭ6f&'i6[ 8fGhJ4&*(< T*m du1d2,/\B:fbOi5~  8f$2k4 oB.g0xx|'7~M9z>Yh.\S̩^J8Ps]`hh3'Jtq=c8i#="A2-4W<xw$?R?cOw"=Rfl.K$! ҡCq:X"Fqq3o-=e02N0MSI'8D#&Τ|O~@*&1Cg2AP-W(+:=2,\vN#IT\\}ܩGաV.lVT$IY۶MZn1L<.#Z6/zx`0V#KˋHLAtgeB߀mc:V$p2@l⪪Q\(>F~iFDȂ_*^XV= |#̐>ti8cϟ ?}O|(`~[%ñ+AhlSovUb{J?^X,3:⊮<,Y!Ke?OӂІPY(.N+)dGd YQHg2,./PV(ʸ#dB6@_ZY$x0+h6u UW4.0 =S.b1 Z9 - 3QojEc0tL5q֍|\EQ)A~Gvp E|瘣Ca8C^ȩnl*z؁m^}rސ[eJOl{JbsB3Pdܯĭ:fΈZ{ x{!b??G39,r9 ]?UVti̝QĊ`E-H$tt],ˢP@5$}o0DyN3NYY]&Ji5[b1Qktp=~GVE74{B$b2rG@Lȡj*fĠQSguh]itZK[m$$.\8O4@@EbQ E GJeLܹ T] tJ@U52;-p7]ϟ*q]6Nl&I*=sfֳg9@mU1s 71 YVT"IaB'@d.RIY[[;q"4rL%ZTŹ ٨1pp=5R'WTNC\ ttVV4G.Eڡn9> 7 fgsnW Auimƣ1H(EUT61#&l4u{M{ǡj|~ / {;-f ַu*.:JczTk-vkL{o>ʩ!0yϋg]3r}K^{ i4*C<4i-1NSTU4Hs$dn >jzHMw'19wx, H$q )rwL'%vXX,r顋(J.gqi2^o^ BE}۶x/^$Jqp}Yz}L&K"Qk䆣3UBH$4M8+kPrhhJ.%Isq$A*BT$Y\eeΡRcjOh7loΤX;& cd2.~' jxL&=n޼qV`QT7N!`pbN3-O/</=yWxwOu^;`khdx_y]Pd4'@dXn͛P\>xliwB|L `6!i*i0ŕ%,^,dsYl{̍7VR(LhdibVgN\)W( c[q[px@Ϡ IDAT?wh>Y蟋YϿqzRNW+T'w=:z(cl~Pot٫''j65_3J_̇S$f.6xCwt{  } 򸮋r`֭m|c<r<ģ(L>@բRF&qE.=| 0Uka I;T5m K2z<1{/LL&8OqsiP֩+XV|!/dqz?803U=\[-ޙ C_ fɵ_b4dn^c{^}r NK^b0<^ZZG=[g}ý^HPP,p ~sPя~D^ ٵd̈ɕ+Wvz{}z>/,0#$IFdI9mÑ(/]{=,-.-S/(C\p Uo5/$IV(H1%L&SxGV#_ a./uM#IqHRjQ(Q~GTAS56mF αa$I$Y(N)jNK*!HjƴLHdθ0LԙO8fPd +jXd\  Nyg5I$LSB-re.Jl{M$Ybcc]`%g}c=TMh((㸴ZP7 B>cPG?afWM8#c^a{e8.oMyS' 5evwO 0 0rgdjU~?{v~i׿0Nz$IbX`qa" 9iDG#Ğ0cl{BQRQTVkT9 rqe':g4qk|ϓNJ>|Mvs\VHwN&䲹]x ޜFub,a.VԚ#׃C>Lh6Ey9GQUmnAHVUQHӌ X|; Bx.] ,3~@>'ˢ:.o\ɕGrGJ28V<-Ήbdsك5wqw{r[Ճrٓm+//|)*/aկ}& ~ťG$?ɱܯzb^:qtz$%I⡇&J}),FdY&>{,XQ qNBHFU!8KL_ eY&_̣lN8LYp!}Z-\%DZHx%YƠ!ˊx_B< c:$k:iw "ub(TD2eE\N$=xO" aOlZ6V"b:+{}l&bYc\aai =Jh8i*ˋDcy@ 72I8u4MNJZDl@`:~O<`4a6(20e"=q\#Džį=oZy0u?[VUn~C^{UQƐey>3:H0n:.C@קYo`Z&h^G㱹^㸌CF1$/l/)XJJ$RѨf!$a:R-WNb^wx,N&E!1"EOiD+D)Fp64 vvvQU\.G,\Ӱm!EΛ:SNm4]#rA _Vc8Y$!W,$ a4ꂙxMkYLqGa0\t EUB I2Z881yy`1ϵWjRO|,|W?ɿ/G\!Ν?I>?8B9 8@>cWr-=B^өhSnlluCy3j|\_Gd}0G(‰ܧ>`CN=t eRT@<:.N0D=&f(#+3'(f {lΤpfah1Q[8t|A֣( (œId #6ond<"Ia㹔K%g:X1k>X__cssj*A\\*:D0us׹y#"+ 3T*tݹZbޠZad@ ,@ݥnc(iFCeYh,Jc.Fdlvjēq<ϣjgHuϘOa4=9f~rww<q1"(feY&-!pwPGÊZr9"J:.mH&V} N㸤3)2 ш~'Zh4iXVDL^pQOtN P1WO>tN!2fdqi|>*G\=f<6zjF,ceehL/$Á(`8R2f3,,. BibO G"[F %)sSJfsRdjL&1\li6n9iMU&ъƾp ^}䎎Xf ApH!mh|V9hO<NUw\RyO='K '}?Nᜨe;y򕯽}>+M׊~I&+w[sFuqq<BjŜ {w˾s_b1,˺m@L"GcF{B*$φ,}(sˠ?@QɔvD@#J"LSq\z>f0u)ZfE<gqyUQq\w2XtU#K?R2YX#0=e!)8㱍JJvEz}:.Bsa(RɄvĞiwp|^ ̤jtJC7EQiXш*L:Sj>Ȧh0HR2I<ۨ8T}e81Fª,HR 78w;@MS^yĩ2 (Ux"?^,}NA鏇D"?'g~?K^R+Xo&\|.dKw "@3;8x ˱o/pgw{G( XV}x,Ɗ,rEnhD:"E $]ujJA%̈A@,.*ZMޠjh4- < bPh֤E RX(VaV7(H>R5Dc{LRZ(nBf1M&ͦ,(B]oIh#HKZÊFYX ˈ&( V$D)D"&vT*IailIMf3G6fpDP M6jhۤR)%JK?( |Mht=h56mG.s_\֩Ω7:$/}{(g;nhqVWkW_zyTkN6>u~˿'67֪g,whm_$wӿؓ nt:eEኪ/I1鶻xp]h(B]z8٪eYdsٹO}zNoBzbCel4כFX$q )@"_aoo X {TU_;[&\m4M**ݎ!@V$VL6à7=ws=jJ̀|N;?~>jt_x+xw|?8so퉿|Ͽy98?tX[[t񮟹Vojdި)열\f?21эjyn\*;w.)qvX`Ǔ/ljPU0'ʥ XZ$NQҹhdrtMp=^N3P0 %~ Fc(+˂֗`!L) c]vw1 GB&LJ<x̍n2=[ {z"giemvu1?usn Kˋ(K^ 6A;o|ɾjIRQoh6JidsYB 2lApϠobE-oo􇤓|fgG|p8UU&J {DBͧijI̝*dsYv\QM8Yp]}ڭ6$ddLnylPUd*zLmD@a蜿pVD}2⬭O&*ckk! _\zbXjH$rq&C7p?H$ίā$IdY-&t&CX C/(WVV:Lxչ3TK.M\fye3"zt뜻A* K{u$H&ՔNàGQVRp MGUUaooO!sz, ĶNoKG}$O~IxJ%67o2Zso/ +D'.?яu=>)Rr׊ZlopUO~g?it{5;-YQq?oTRA ^fi6t:o3LG<+uqUS*s\(&zKWf!K_.nMYZ^bg{JL%N` ^'?~Hdiq``'Jsz(SX('/)JLSϭ#KLwgow]7Hs2!^O0 gx(ʬ1#RCvf3bΤQz >E9,݊zNNJYԫuAx3H$B2`ksv+y>0+Mm IDATa)slmn 8pkH!N nl{? GwyOgcoploob k\,K\zd*C?kK+G=8u&7onL$b{ױT2` jGu& V4DŽO2`}c@R4t E t:Ğkt:]:+bS3i:zC\OCg<Ѩ7p]B,KXt&M٢R09a 7-Hb8 cgv:uC,cOhOG5h|W>?DHCu]x X(XHĚo1v+ej5Vgy]e:8Μ\o}#@""U3E"xs99mG9m\ϰmu7FVzF|WS]m-nyjUSYOM~(_NÓ'YXOwwPb"I`4b>IݧCy,h:2^3$4Z Y_llRJf mQt]h GH4H9P(Ɍ/^_{uP(D܎}εsg1s#W?=OMoo_~CaV{|_/JƌI(N]שT*Uqv~ƫWX,@ {)쳕gw xSBcypeZ4-틇 ,%W( k-v;N"ù])膖n. ͵΁KAװ,pq~AlnoWeWdY Y^˲a29;;gkg %S;+dIP(9bض󠀜,E`rԛ5OY,w-9ר,Ec$JUaz1?ɪbR~g4u1W>?o|hFGt:tOS(i-^rpp'żD=d?_=G淾EXBQT: /S3 :r*LzA\o G@U'Pl_ş?),b?52^! G{',wͨo?~H @QB>,7R\^o;m<%:JB!/tW.D m^ lpiZMc[~lll๞hLbYǶ,OX KGp\zNy ]&VM2!2w_o8xuvEB!f(AptpD޶Y[_Cf9 VEVEd>S:hg34M鳧blPUf8D_TG" }mG`g{#_7߸|Hyzq_ocJ[G??7\.?t; Ywᅦ,+$IB޾7$I:aiVmY|'sf@1RSqxjNhnLT(+21el ʨڝjmECp%FQBY^ߌu#?q ]ױmb1Vr@NQvg^ölaƳ[y>e>3z$zZ&zZ-'IZ& n4]ccc]թ {xϿn9:AAլH'>c2/HIB74Me "=Oٌ,ORGWz\&F:x)#IȊMvmzmaݾ?z]ɓޒoͿf{s8T/_xΟşgARUU V$N"Ҟ} AqUUAt7I(05{_0_̳cbiKi.,3#7P$T%KdFVy>99} 4BMa $-(e{BG&DcUU(d22-cOQXys(F4 ]t3X:%"$勗(BkIRˣs:\q9>>!}!mIXDQ`\X*09?_P) S)F-,D%* _M0DK#IL'3X*a 8f2`zʌXhhX`Z (D$Ɠ)ٜbQJRDQLףVNg%0gh58GlY[kQ,_HmarNUӘNF# Fqr <%"rDa*DaD?s̔HT6a}a_,пONCDQ비`vF]~f}t??sv~~%ȯ&K(4+4=>\ 7F̂2Җ @H H$IƲlJ"`H.j4T*F`4q=87lln`9$0rl@™ւ.#vv)=ڣrtp$C*Y!͵~!kkrqvA?$ $(< $c|MU$Y 2IY' x;ArzzLA1#|&gΦL8ƶm2n0HeSA:;>e<8Ȋ̓wxC)<}]!'gD%tFxKyvK"zk_xЊm̦sTHR$j*AB9M|4q=u$crw]w.~XV+89=;z"|C׳y꿬/l˿Ȓ|>m[ %̜IBeqdս4 >AQ*2$Y R1Y^I7f տ@F3#u%S B{^'whO @z%q gntٺ:>os||LZ}x5WB5NOϑ;XbP(l5SA/=UsC/ˆfSL |\ C1A2N1s9Z%)aFt8}IE$l4!qi c8hw%h2IX*}^xKe67,IbEZ!S,FKRld]Q#_u ٌ|>"8#S QlMnE0Lem^Y;.ew5M_ڕ6$Io3GӴ,8JU+AH1/*߆%tfsc>?!uvMפy'~D&vw/~88V{8yYreu~@9(Ͻ 0 1} h_`m/fKA GQp0d8:| \M YQ(,>2 h)MTJJBR;ogҨ*Zxn+_"BSٶ 5TEc4a.fS$aO!lROt$qD.6qt:c8bS#AviOl&lxB0O(Yh_9?l`zfc^:0R\.GQ'g89:u]<~G.@rL oB$ɔnr&RBd4Y8Б we y3$S@ej;{q75 XWV/?0mO l6A*R8n&{v~ ) }*D(" EF0cQ}_fUVG˯8k)ro5I{jB"4 z_Wka"Iy0Mg,,NJh5i(BRqb`$Iۙ1GBrE8湂[1s)0dH G(s.xvv1\c%&)bm(d8,!ilxc*e*S*5=&0M3Ua٦TeTUe4-jj|1iTUkʌba0AT*2ͯ#|@QTZkT*UI$ fEgϙ<}T2RP,( 8 `HFc:R&+e 8q$p:W_Tg| @g~~$o|kŗB^ %\%0=(óѽ I2C EQGEY8AHz5'?8 ' fogEN?%\Pf* '$*UEP,0NgHjt:m jP,{l58;l6g>Ng`-$QUnGv^u6 GI@/`&q|s=ՊȚ$a2}FV'I̦hBT,vr$FmࡦiTkUDP&58;=GT4Epm+Oz'cʥrF"a<7pr|BA\2$IY,x|Y) ).hWz"[EXi?DUմy RÈxd2}ʕ0ȔUMRN{m[Vܭ]P"o[qt'a3(߶m1_/2IDI3z{[%Wo?q] QGN2Y:__r kLתNB& IZJW)+'hre}EDQ ʈئbxȠ?u\Ld}c #Z鴻 !裟l63DQ(WJAH0 * 1_9|uzj5fpqqk+eV4~J;8=9䔝]L$YʗBC<\.svzyMc$t4k:a. jMYe1Ne·O'I ݡx_{ D4Y[ ZueO $Q,N0mMد~&Ik)Z+ؿ)AxkUrDw?賵 |H 77ȷ/< ey{fb!S#_e$ARqHCMx96_}&a I;;t:c6T%g2 8lPyld8jb}~=}d"nz|ަE!> 4 |ƴLfٶO(JRbX01s9jD%8i(ln2 999삽]T 㹂:j錣c<㝧P, z&20mMV3^Gò,* a2ctR I֪~{ECV `лA"-ߦ/^<ϪUծ^,U݋Ő(rK`W|dRd; #H+Eɺh`$܎hq_g0) !ՠC+@z[ի| dA^WHuL3'PEH{{93GX4sMOd \JUU5:mZdYժrOS }@^Gє8G(q7-%t5H4 YQP5-7\]ө}n1$e@L8z}8am}MT-HRPg t|^WNlb9dEZPO{Xk5Q4ʦ4c/DQvE vF N@SUwp. gLSJ"J]׈E 0 XM}ϧs!Zk-t]#]HOwk<q|rLVz LVZss{^|Um1R)A]"w Y{tO o/q%ɍ..غv^N2_sb/eZ?$_`2x[p)e۬7XH蒎F#4MT}EcFިcYO> -_qNON\MTK̙)o6{(h/o+:7eIP-/Be[t]GK'g()3 4W,s?L<ץﳘ/Ĥ3FJ^&"0tLbr>cv?! ۶R/A̦3_ RDV ,Itض^eZ nb>uEKZR*Q5 A, ?F\Y8{}$IjdA[+};% GGGPT4M&z\:zݾo \_Cϵ*ՊǀOLiO ~|D|T~  3LRVגrDtpTk6V翴HiVҍӭ+p$1^,,KKyz}TMP({>aP()˘i=\AM7|@$6t:(" qGa|6ò,"~FVπxDQȒBz*g#D!bFP.!ai8V*yKq`80t4Mr9z9#ӵWߟ:.| SdIZ?&I |6p;M$p]ł|F4ߘ-Cer9^cvwZh18EȲT"i]QKH209?='h9B ~t$XEQt\'YZ* NO!:!JBħ~eYK+t2e0krYܐaijj;BQz!2\'p}T#Jm٘ggg(+2] OauhD:)LT@QTrX`Z&Šd:AQt[!C\R./qO}|u]8 %onPVv:ha\ $N7j #8~)<6&| udoVxaGǣJIT̷T;N( u_^_\5k}v_`>1Z:4:qg3uc&svwwŞ$IB\"A*S^o p899EeX"~.ٜ_W|;:$ 1L|@,( ɔxLZ! )Tyl<# f  *.((|D|}vvvP՛-$.z= bHX̠( q LK0`6gz"F]TG`%<~lǿf`:r~~D()'G'=ڽ2p7 hSYXϬ5Up_?Ȇ)uCg43٬|*s?Vzϲ|;i20d:B2I~[ЗV|/S0u\~5ia>&QϙΦx<^_@ZI70"2VJY0tb+~?Nh ڟe[4v$%F۲<";OןpppH.#JR&\eW||3999Y&m8f22躊y8ȲBT6t&$˙L' ј^K^Z&3~Ȳt%.sLK$Pr?.2rkT4>~bzF0FhER #\'>NMRLk%PH͝L0p LS(! 7hzC ா]glٶJY^׬{\J'r]7Ā^( "nG.Dh%#іk0N3Ѫ+]U'/^@uٜlT|X_@JIR?V@ $-<לaRuzyZIeYTkˉeb # *,!`DRF%t&INu5nBxF Uղ٢\U0d/Iv&KaIgExzH޶ JyH I: V'7\}NM=$Nd)ƌ=Х*,c_/dEa}}/9>:ƶm .lzgmCGTVu4M$#,Nt; Cs>DX~[ߠ\.#+2C*JDIb>g2"Kav4u-M Ft펐-xaY$IXXY^U]Zn9? &Z E3eQLsvHO>c2wT*uC.}gȊL(!'gȲĻkaX'1[W? D,ɌF#z>u8Ri*EuXw xX';ap-[rMsQnfYSh,/NH$:Hꏢ E5 D!?$Vnoax}f,8B[A}#I1t11$-d2C5q"W$7e#|F}whQ2:f4]ccc(8=9g61DbU]X0]`a+FHxX_ Xfo!!zbeHȪpˆ84 op*zk""T_DJR0֪K/h4p\O?ͭM>|vD"T.QO f+ <,˘ER<:΂s #:$ BEQ2,ˏBƣ bH^c1 $Azs /nGEJ%4]KodYAUFRo[J؊<댆cNNLo:"_&|bWGVvvwm+ -JQqY$ q3O8P(ZoezzcSoIDbk6eb6ea&%̮s~_7 G7QVya(d|%Yhwd6]E"RDvշ"N2! BHH<ϻ2`uk+@ ֪TE&Wɹ\.}!AT&Ib8J%C,K%9fJj zLIJm&\?9mIVuJKOCTx>#Inxii4$ iB@, 4Mutp$ԨF3tl6Gs[o) Ip A׵I_{n&iʄ^ye}awh.)q,kk-fW7YA|6g:QUWh D*2A2Lu )^J9;4Mt]G׵ "? o+ _ɝ+Љjtc<xI%ʽ׶xo_\ےwf,އ!W/eD H+n2Ӎ]^uj\/7Y\@b jj6<' 9>^|ަ֨*nOԪ $ILc/xQjW+suF£'p]En{ᅦ3bzi6HRm"Ie!h̕Vr(Bo63m]ײN#K * U.d%$YAF1b!k#Dד$awwG@aH~X& ɄdJl5vz/.XH՚7`54]$!$Ii$ժTkkMY$00 fTM}nYA!d) /7\&oAxG Y+oY%_a@X}\}| 0Xq2!ȱvC.쪵 ^SI! јb_C>9@UF1.v]a+%''({6C;*BXs8w=EV,pvڦX`Q:.煨~ZY |jL&STUV2,糱~)ԳZ'k8y>Œ&V4!P,0̘NȲL)dQ]r[J~X("ť|j\׼m3|BmG.Jδ$px4N+1`٦xDpECCVk_@B>"^kQ*f(V2 A1 qr(L'[TR*( B$4W)+{l5 !g(l\.1Mrad8p2L%a\$I6$Fu|ڋ‡!?dV+3?(^ (mb}6L~O?S<? ~o֛@TTnC9\dԖqRah6<憃a'u=Ws'FBsx*{_- `Mfٰ\tQItbQ\e˧ Dl 0L"+f:JGNrzȫIG I8, #~t2Z|6Ge<òB a T*edYF7Md9б-zfEQdjpC&1X@.0Wn"ۍ 4]c8:r1W)0OE;D$ǡ\7-%jnl$K$X;VDwX@R cb5gx7ٖMZ~>Ͽ?~N %I쪼lgn_.K)niqf?>%Ib8 Ȳ Sr;r9VGcVpd<,ZNn4TTe0Og\_uY5ofHxIpӽͫ7qs}sf ̼JiEQ1F+T킠,˸e,˘NfᖒP*9]3!(TDlt6c6xm3"L[v%ia6ł64-\E7o,3ƣXBgo2o (]n[*.~fd2\M8!X."w-'BUUj*I0  ȲLVcCYZt;:HAЏ 7 @ɯ&q$IR'IJd9c$*=^C/ i*E_-!Iqy>ޠp6}D>i*Qfp}NMQdEaժPmfeI6-no ui4j ~'bnnzFdYFį x\GTt{~O憐8<{۶Q59<<{q[Vˀ(rH?#X؎z,,خ7)j8븞x4F$aSsyr8Nfkɫ,D0^BTD{u48:>qJȒɓ޼>CU5Z&b M'n{h~+mV t6A4TM%B(Qw(k̦34]m{%i`'@xLVMºU*O~8 qMUU39^/rQܭ=O-Ja[> gt]cH$I2͸8%8fXZ0sz^cY&|OR2 @T9zFkS$fuP:iqpGbʴ;1W\]^h6f CZgϞ vu ]hur1P~-,%Xmt(8-tt]u]Ub@Q;J 0 lFAr2Cm  #&@2l:kJp8|" fYF^+4EZYoVѨ#2jvU}& 2the I2jL0觲LV;>A`ϏÐ`THi^`H g=3^=>ޅ?8ٽZYQVk>~GdA@ <6M($c,ˤnS ۂwg6DUT;~}oJ7ժrݲ%$+dYl[2)WXDjU(A7m$ܾ+}? RaފDO$W] R}U!X9v{0OPըT|IZ 5]AUTZ1t'hJ ᦨ3OPcj__QUx&| zC6 I"[?R_ܘfq2ZM\+L/S៤Bq=t?n|iRvu]{ЄP {IEw$G@tM#B~Ȥ @$@7Q˲L\4^ BWT}vxtK؊ @$)# "+4 O\&8ARث*$eX2M-  z߲o/CY0, Mn1$?hY74na,R¶\1#Ib6-60 JR|I x?H$)AP7qrOh4a( eٜ1I&Lq$/t]ôL*~DZ&ڙ<>91Mh4bc'KJ%5s߀``:U]7 ;g>2D%?QK]7?_Hҏ غ|6V~]I~/^בUIt?:xD~0&v?oAa_WfMʥgw*ޮWBU5FA@ǷF?,jve2Yo؆!=L@Whut'"28a:eL^ñl.; GoC^ue$ꪋ# z%dw*mhp0b4F[wvkfeZaXΞʆiA$i,s~Gz7=\E4j:~tX뽛.2Ȳ~:!`%bAFd]wrldI{eX#_ =n* OZшj'+4hC 4M8u%٫4%N\7SVߎ.|/"0k$~Nz}8஢yu/A%ڇu)ui"Y j"3^w/?/WPT-|0~o0L_[lASh'`]ې?\_]3NOO1Mˋ ^zgDqs Ư d M992 #1_dw `\8G)9l.o%"lʟ?dYƿ\ԕVA (W]'ON EƜ]n PlY%5$P!3aj2 Bwh'?`;}q%I҃m t|~?}sLpU&Ib٥5|׾nIyp/;?IA"ni~у^߃Ϟ5d'd2Xb;}0W\a0@Q ҳYׂOGl.9\` 0$FAZkRrIe'IAfG~~Gno-Dvsyq7Y6'cLä^ 4>5f`bGI.nTʄa`0SX "K ec-1sh)۶n74i7_=B5:mՊx͖'*r>`;VnKNOOX,%e𫯿EQTL`0M*1+{ .ϯ8>=FU[]{g]/q<0Enn89>ysx\=3yKdYE4{_x]ɇ#eÇ'/"UUs9:M}:\IڴZ-${e_Hhwqx8f<z.a0OnYE zNFȲrǽ.˓'iǿm7 Yi"j5a4f(قd\C׵b)h(7!ZRWVA\ONImqPk@u>{Jf;Ys࿋DRѨ# ~*ϟ($%$:Na<3/21ѽ\.7Ut]l QƨidHUn_iV2#*Z%n[n/ض`8pm3͋J_\(8d`ۏ;N03'8Wr86֬ 4!tFC'4_- ^ֽ)9DQ$lg7[G#5Jmz.o^ެSye'k;<&eٖ.w;о7ЃMِ?|VrL+izN-zN0 <?a9y&,|$i[ʃTJ4bb;f498̢ e~~vp0`b,IhUU0-p2 |. FMkUgWry5ח]k0}7!Q./(y.z EQ%YMH\~ XRi:z+9%1 I g^xm[nPˢD'1k\%c8>Eepfi_G9, s'(,TJEpM$Il:R 7k77N1jWJpuy5''hFKVGLJ*J9޽FT*@^U4uw$IXY*6SVyضE- e!KYmk>6yssfO +R3!)*RE4`i'=t Qc%%$aY&Up'@";rlE 'O^_%Ub{͗J~GD2 sU!܄Uj*^$A}0ΦJQg\ru)`'OOETdX׼zzAsea0)p~~~+*2(Q,+f#%e9ֆ')o^D%OrvR3ZWx2oI☣#jh6ln(DQxϻȧu+^z[mNOO8:<.?E%j;Z.}G'\]^ZRp),nD@ 9Ip}E-T5($Eި1P5KMh}?gɓ^~ <9)k߯jpJIp$ys_7_Sv6a*>^ YQrV F~vnC"3Bp$Yu6rATi;^()4 0b2cЗjb2^$Ȓ$Mt! IDATZrhl6pyA$k4WܘrDQT|}$I!_=ރ쟉%rx\?=x}(VUdl`\T8DF =nf,V7{g|_BPWs\^]ryup|tL{#J}, XoR@!_BQ|_VEDQW>0TkoYB ʂٌ4v.s) uMF>PrK;:6 HǧǼ~sj*el71 4b!+T>Qٛs,u@R t]Eĸc;iZ6,Ḳ'IRa`Yi>+\p])? ILnq='\wC̣ü]ݱw ӶP 5fjk~ ڝ6goιZTʹ'^LhȒ84[M.uM Y)UW4.I"eET*'"I2Tv7}U! 𸻗/ȡ%{= w}oከprrw;qs~~%&ji\2H!X-_,t[(*a݆, ʕ2ebUըe4M)#Ma\0\O8)2˶cٲX,hZ8cMD(Kةrd\"2$bm e8%GH+J׶Pux5%ǡi.gIZ-eo81).2ΙW(~ 1!EQX.BC׵[>We nBS}J"L, dsD@Ql(J8$Iw|K/jIDZfT\cÿ$i*K6pD b M $I|WzLnmm`2Tj_lӧx%Q)8sy`·Qnji( cZ(X-2a*GMVu$`Ϙff(x})ƍfA|w>tEAw\tZ L'36$M 4 5-,F[p*y(̰?,(J((V,Kʕ2jYm6Ӳ7?$XpgH8. Ie\2vkoBf{cbl1 S{6@MX$Yn膘t߅$LJUu"?a+%-ĀHڧ-;>Ն`yP:>91xYII@kΗ/O`63_.XOgHDR)9mYHHr-xit:m @@3tV0tEUn6c_l4[4eXkDL3noe/fQ5hChE#,\r)$Ir= YU*(r1vݹj0948yR$>4C4<{&ذ\TUXFLS&TU%bq$iJql(&Aj4FFFF̧3FCA*DBEcv%qn9q1x8# ]*X\pDh H@Q0_'$e㣃Nj1@p2Lod{UTvoHqY_@D4)`wȲR|%I4MLӢ3ކ8| "F.+#! Y)^˶9:9±m$Yb20 %zϩgW~hB ݫkƣ18%y g ¶,8w`F,M̌W\_u^<TL4L./s,% #:NK޷mmҿ铤1V|AGQ0%tChGct]x22Oa$If ^>4MYkfIPIb8޽.#Y~+_>n9\l$@dq*X~7cۏe` Lo?& ?nedz> DQ{j]r빅. [@ƚW]^w'XIY>w() JK#s`C\এ<`ްX,89=nSIv;=m3²L<;e9?0MgafM`"\ӞwX( ES;PIF74nX5j0McO9CTD$HktJ٠VO4ůVu8N $k>Z&D{,PO8(y,Y9>9a}PfwE1MeiSOӌ`el tM7{\ ?d隆e[`T*J}ax!\2L&$,c]3 Vfa2)j&FEHq֥QQw g 繂$*O~IxfUQTcnKy0H_=<KT*8]hHHt^w5bYl9{se9w@`9suu5FQx8b<adqنv'Ȋ8 NNSnjӻu{HDEb~۶V}ƣ s 50}_URAխw߇$Iw6s}(*(7ȿof~EX1urοm1mzw_ ]W\f/Ї0~PTgh0BkkF5H̬cٜdh4l*NQ0N4 DZERiE$$N(!S23$2vC^aR+|ݷyJovKz VɄSZ& Uu\PȲ,%/_b߂I痜>;0DG7nnz_3 FȲLc?M30fK@h'ΔB{a`Z gϟ:H62\#j"c<+w?w*Ţ P9*Q:O|lmӭU(i{DžvJlq$RU~5%q1'-z$2VR{߷ C:jx4v,Z9.MČx2^#2Qsuyf}}$ ./ G(Wv)`_(*˛g\St]GeH$2lȲ,}$OV+~wjZk<{?+*ggؖIJLE\^#4͛7G:m:dEsfnƨJ =n6ϟ |hU Cx&'#ce00-#Rp0$܆T JE{>֕fn=b>MHDJgdeՋ|k R{)ad-EF["#˒fbI8v[0 8?&Uw@'G[(BVԏodHSH)FkmH$2ZMsx`&34M .//ec\Kt8;;g8 CeLFc.=(<{?O 4]/A''HHz},ۢj.Ip$KB?7o4_= ς YU!zk5  uZx<%nX9BdIyGCsTCF97߼/L _}Un~.KRwA^N4KՇk:aDO)9e`eNVd7`6yGLJ9T~Ha(l6[8&b;>9EYem_q}yx{JVEc^i77=A@ hyI=ӧOLFSX8Q, Dl +{7}V qvM@Qfi$%i'LӬLYJ5>$Kh>ծ$ɻ/tM~/B$>"?'\):C85A`z._cFt빨Ʒu =UUAlS ,޽el5^w9{sFVѬ\xp+<>97+WSIzfo KF1q5(K<}rk93Ck[=b ͠ZL0-A$ ih9;;<qnhuoHUjz I/OBr6gϟi:$Nl#ܿ~ƣ1fUܿn| 1=kv2GJ%^|C'c)FǦ#[Jl6mF^T"~ޯE\*ZRDfC`ʠ?`4.r}u]<l6c ^/`*NCVՏ4UESܭ,4M0 ?!ggzMPUMU_iuZ,+./ Dd:kFj*GGu޼9c6ީl zã#JßgyJve6ʘ^R YҌziY\__R vR. YC4ʞ$vHEnA  C%X}oML|̿hԫHD瑻^SUݗiJݾJ/ :0 l6:IMl:ï2VS/I4e>vs"\j`0(_qkIkD0(LUU6C>9!nGc<21y[ש7jL&S./.\_vKL)erq~)D}Ҍ$Ix 7jUDz-<{J|Y\,9? Vl6Y,\_w%5i1 I$WnBk`i0?ހr\'`;K_E9A~w$IZ>V_ 0*_x7߾7_?o_`c/}R0Ή$v|,p}[9ޓ0땙MǤ)4[Mn7LSGc(V.*NḰI^d4f>[0NQTzag8Fu* EqD{r`qKBO r8#KS(0Mƣ1rjs%;6Ih4ېKtC\.hI0W %\O>~GjRU5 I_}?n@Mg 22璤bp4aj`GQp0dX8f`x"Lۼ,e21 vCB UӍih(2_R/dr_.MMpYUnpi1 xL~_<߯0 ?6=FAjndP*y,S4UVnC֛5Ijr;@vM'YF&3V%i,F%U]ӅA,6`׽!"*Uߧ\.ެI$=l!M899ArG`P$!bU0 ڝv!1 )ȲLݢZMa  Ϟ?eB>cKksh썢H- (\.yeTM$1ea:|iHb`6[m[UBUTtCiBrG#:k±? ]+w dIHH69J )2Vz|>g83N|wJQoԨI$$vVQO$o_]7tjBɫ0H$9g箄$Eق 5jT (dzw,#+2kPUVS* !2!O C,ˢWEklmWo8>9+{Ȓ8 Z!MSz7Sn]џLȉN!QVYppx#wכ ф`f]hQ6۝ E&efu5r'I2'st`B4[Qp8+{86IL2uTc|=V_ryO刀 '\8xx/MZ*dԴL@gX I*1>b iDr m" =24fNY'2ՊbjެsuOu]DzLJ異KN.Dv;(9'_'Zoָ8[Tt8eQlwX.BVj\b4%$ 8eL'7Ah4.J8 HٜbI)WOgؖ]h eHA$A@^nq4`$ALtM(94ImA۱(aB%/pq~%jdt:\88<(/O +J^#I%Ü_o)l. HXEө$6MzNߧjNOӄ0 ⸰ueP\c݆XrOYKr4 t++[*QrJi&/(Rz؍*iX$K3>U,î?tuMǯ}(H8)KTUJ̦s9`͆hkT9K^1NU=M|x4RPטNf tC};@^3T!1s @ns˲qK.؎M.Ȑ\(z%ZWWA@F4ufNpV@'#4MC%Mqih4z#< J҄|AۣWh5rR(0fdDal:BM$UӰmN_M0,lV~xܝ-1pGe/uHwIX 9 IDATw\"oA]ş ;LBz\_ Reҗ~b6|624FT~(PY;R떘Lr8:bG-ijg؎C9B!I2I Kb엑JuaҽAS5AF&INAłTj)^jY!q޹Ȗ־e׵93mDIHx !QP@$! IHF $!#0!lf skkeW֮KwWW类;*]U{}[O.s M_P.;Sȣ^Z\0r#( ( s0MCړdYR2І],@r*a{g;3]yZ6EA6'DE#,x0 nenL}>W.} 9HY!R'+qzx$rX(pZ2̶e4ٟt _Z'q!WJauG0LV;;u}:'?m#B8GZ20 ˥SֹR<cWمkAP@kIT*l{{ӵ~ssz}r ''pTEsqb3`ı8( m9]0]4 AQ q}7 Pv!1 U5.AV !#iɠX,NM}4]mh:V Gp!M?uҤ5UA6Y3 LK3N2ig?L' Dq4u־ eJ;nQI#1ܝEQPU D$2oàDa^j;?ywc"_^ {`qz9Te1\o&qPx% Wہ4 B~: # 9 ˜eAaȹw]UI@_|An#1zLӜVkJ[$Ş '>wgo'i$P!&[U~/",BC)UJr}ȾwpUU01 eOuX_NA&AX:'NJ32`ltiZ,a b _iRL*3UI !xXVl_fgHAn &Ã`wl^ÓGOVl9~:"]z(#iUUaed@AXiw{vP4iFP<4 (I/Ls.f A!+U]qx B{i41c&2N!PPVAgh7p*2,-4MlmoASex41EAViv:ri2-8`д|Ɗ|svjt5"6&&A7y3I<I̝wpXWAiEP,log\.#L,8БBmO&좍r0C !Gɰ{h6<'OmUӧkrzv:5Jb:rN* ;uUӹ{6ygw<|(BE֪aWgYQn3E.ZB0EAu:LS6 PJzN+vz׶v J~k 8sb88}ނK{,ܹ*g*ٱT ̚qhf`0` {lhҤs\.'z.z.}jmO,[*\C\Q0lG1jryi{=cA@L'l ¶^'V3~cT 68}ivaNJ%[-h.O.1?fP0 q|t qs]9"<ϓa0\2kR\.KW" 6X`?S9ub^z8>>NjcW( +cX.¶m8}v"d(bDQqh4.߃nh3@&2XU|יca.E6Aq*2'FnUj*:.Z&ڭ6?eY0pα[Gh5Zpq\ĜsRɆiLpks bE:xQnkihL}a?;,KT dI|m 鯿v^nu]d#B\VK.yL{Z3c+ j5DQv Ϧ N޽{hv:Bij)X bc9}(|ПGQ,>ڭ0agDW WPVJ~@JɆk\)öDM[]"NQNcgwV p  W 4(-ce1 Ӏ(Kd2SEQg s}z=- ]PVjP.z tdP٪$FҽPZ"h\)\)%y]P,e[cwE o!}K%YDa81p[H 7sl9CXsvq?0I\>WUߛKYN&cPȁ%W[)pmW إ2L+B18tt|n4l! PE2`G*y!`Y&&7EUP.@GGh4PF\ &q-de@p0@) VىNSQ 5R'H/ 3g[`rm.ךMUP*wFp]ocs2Y!TUE Cth:8v#˂Ou FT.ɔ3a ̄}KEٹaΨ'IbF39*EX` F"83ƐY^RX,U? nZY ѿT"`X5t8ъ×e"/@3(1lJyZXe|ϓk<00M mhkחg\)T*҉Js5d(?퀦1 h4/S:LS55(/d,j[P5NP Gq5E'1pCds9X :޵μ_DA! BOiEc @hMU7^TTUrY:! x*ohqT؅&(jzj=a! #DQ(HL[_qC@Q8L?sJEKEjK3' luz%n7٩u][F19~q,X )K:29VHs Kr#Nf #oeYp]ݽcVV|.A&+c bR?AOexmX%e?A,C^/]P FX&vb<n?஡pvFPbB Evm]w_6/8utҷ1 )2RmEvZL Vᥗ^Jmgԅc@6W^k +:j-T+>>|?sl. ;G E ߘzۃ _V ŢF1g+CgÚpX, p. k(WxSOĭ"Pi7ƻf.mGB#eoWނSqr9_:+iY0- }g3ب C>yAW?f LzV: ONN f.=VD׾zg|_.{ذնK/^߆mU; @T=>2 n5}?z/~UZuI .TQ^O!TU??e:;6 |m)uEF_ePX4|KΧ__@PH}coH&avu<w颪* C0-aв= Ic躞un|Ox $O[$.io| 4o#+ﬣ#~_l6 $x! @pKE4BS5O7|!#A6cW^y-ߊ~g_D{|͗ E0ӈ(ߛӘCZ  Rrrr?r/_hI?'.8xzuG n$AAO Ï-X3>Qs?KDx7'?o$ |ӟ'? !o|K  KʗQ% %mOJ?/ HI-:Af ]q[;e! |?QQ& 9=zJ _/P't̬N/zaFkkQAw?|ughw:P/c Y}LUԔ8 CXa~Y <ǯ}Syi "-я~?U_#,/{Pn; ZVsE/G߿ x ԣ DQOO'ZkQWxX$k hc@?X*y0IDAT_ۺ;^ƫ;K/DnAsyk)^_3- c?}\.߻\u'U|+߈{ն*0'HA>CN4>fs+W6Rz'B ~F }'Av'xI,ʜXQ/d_t3ۖe~eHAĦb8tzy;xwq?UwMES%XAA\9?:?+E. +R=zfsobѡ# 5,>:j'><\s`?a4es僠= X8 ßy7n8ݏ/@$Seχa7>k沿c3  .ydX7+!@K jNoq?^Wj.*S6(V޾\.W|peBcL,xw[ Or1˶K a|v cglQ8sl{~̘`p 1;N)}Ŋ>㕃V#6uC/z%[!/_lKA\NKE.xDgHW|s 1l>!yI,~v9q )$ n#۴ mпL xhݝ. bH#6!Ē}ڠϖL@ϱBAAqc:37 sK0VURi2˂e9qh* M _r-]EܖL&UwnZ0 M/  ` V iMfO+.L_7_%/ $ n^M  XO#. `H3U$ nVrԊ\%VD?VDAϬHmuv&`@N ͬ'@q86WL@5L~0Y'U_v?eAnR@~ـ3Q S^ A7 v&F7)u+7]wYAij'6i Fי :,M܄D& v7XeϪ) H# MJߦ$ nUV\E3_79꿉n߄,#HA-pݙ2uU? Ku. ,pnXU# %@ FW ']ڹ~M @qs@~ eݯ,AH}@PJ_HA<=N'HIDATX͗o]Wq_77nWZBEi %xBL`,BbA)RTIE P+RE $BJ؍'~^sZ>ڱ˜#}kK-؃*DJ @^Kք<U &z_, tFK.Cs9 ~GۻxpRTŒ$R:ZgxÛo~ǎ`,,:gyD]\ _!bQq DTB,xk}~+'gL^vlmfWqqˣn.#i`f09>³O?W}eh,OMM5˲G? ;f;<8GZ:5:Ha*m^&?SΎOEeߌ~ qL{jLՆ*YgVUGg{:3lÓĆ+G v0@5ϋ>MUwY7׆L ?rE!3FY35\VV. S:0GI @0=85?d+DBRGQ)$1*J"vsQs53Nk0o"p >ݣ2F!Z^Uɼ1 ?.GGOgqǹSL##7FY'\~秘?>[w.'[|a<\O| 1 /:4!X\$llUop(vY^|a8ytYWِʚ AV% x9F;rgM[ה]j\o ꧂"QE󮎀@vyÇ`|pgZ,R{]W=oxTCأA+A#hP28(yoAQuZ-jj {pAeY3A[ܐ ZnuyQiA[+U{A-ֲ,ϖ)حCkFkmn,*p.B0IVTwZh08Us7+n ZQUw*wp8}z Fl7PUcM&)UT)#{ʬ$nb`ʝ}l=mBL&@u計 IHr"SS$N$JGLES$%3DU1nx85Ki'ܹ1ZUVY6S_TUQ YJQ* !3o^cԤ'W#ѕbMdOC({?N~.\_~ѣ^/4ď:ʠF%)H-|… _ό yIENDB`qthid-4.1-source/images/rfchain.png0000644000175000017500000003041212051012677015433 0ustar alcalcPNG  IHDRsRGB pHYs+tIME b7 IDATxy\Swi3$ IL5x*9"RV""`$ 2iT(uVZh"U9pΝ{q||T8Ά CBF,8gee1p\aa 7U2l℄y͟?_g?ZRRrĉL %@U(/566688E?]SSjll /D7@MFF… u/ۯZJ rx! PU!#'Or8oo:)SL6-++KP 1l+++CCCҥK ӧa Ub½{lܸ޽{@B ܵkIa+V8~D"UbxTWW_tjO<==E"QEEL&Ub`9r$88Xglڴb^ TU9_зsrr(..**U<ׯ777 1 p~K]]]ssT* p ٙBmqǣGX,F }USRRG8ṡvttn+TU/^XVV}gg?C&$f Nuu5a2"իW^0bۗ8^UU5s̅ x<$B4iғ'OO`0U@U/uuuVVVӗ.]Zpa^^R(.ܿg[b}CTx PU!zP(g'>Xnoo_XX \.ommP(D"wwwWW'OlڴIKN+jnnV(2 n _D"Y_fWWWR)Hp===)Sh89NYY PU!VA4쫲X8*[ZZH$ͦ41..ٳgZ  PU!HOO_d `0t{l۶mڇUUb83>>> ؘB njҢDn(  klP("aJ045kw6ⴴ[XήDPU!PU!§P(t:LVc?9s椦J~D(&''Yfر2L,r_,,,@U;,gF$<ܹsg͚e˖<>>>svvV(ȈH$vUMLLQ, I\/3g͞={?S=UUU׮]kllLIIaX$BU@U^@Kooos۷oİl8ǫH$(~'QQQHv ÈDbCD *D^ "W^}!Ϟ=쬪xL&ATJ$LfrTSSS0GGNJɓ'kWH$17n@Xx4h@4ݻwnD"NgXuUF*bq>|DhTU.pss+++ٶ$J2ށ(@# XW/*Da666yx/^ HX 1 ؊̙`/_շD%%%>>> eU!$$ɓJ=#77788P*TU!rWkkk_z UCB l9e˖koG,*D[888L6ٳ_vdGFAGUbgϞ=|px$88:G ;wnMMM`SAB EAnnn_jD f@ \ -[5tfdd -˗//^ utK@U|ZZZ:u}cǎU\KΜ9S@U"poii|[DԩSOnkk;`޽{>>>BT*aV΂@BTR___VVS2L 2~xA>CE? %D"y!Bqwwwww alH@Uv$I{{L&{MYYY[[L&FL&7A+X@$I$LTURC&) ʕ+O\SSPWWWXX} zJVV˗rJ>3Ƞ  # WWP#:HHH~:0"|r8&'OR8CХ:z9|TT," -["$$x40??~gmmAd8rZ!znuuu &M Ѥ=z-$$08D梁Z,8^YY ӧOQG0 àWWW!'LUuH|C {8mU˗/\|r8+o... VVV( RSS#~^yCǏ @Iyj^U{d'OP(<[n'X|ԩ۷oBU95W\)..rfHΝ;uuunnn˖-Ӈְ?^ѣ!!!!;VL0lݺuK.-((8maߞ>}*kjjX,OdY,֦MPeE/>{i_Xnood2E"oX[['%%õaSպ/XYYafoo_[[{ΝzyM2e4[@ x޽{ ɓ'00pʔ):TBˬh"Q_R^+++Ag͚=j] A233UoMYà8;v$ `ڵrL p=z4))i䔔lٲeԩWY\\\YY)J]XXXBBVU, 7f /^ߞ>}:00@ dggK$???Bxܽ{w߾}k׮htGGGjҊ󼪯o]]]ARP( E^n9vƍG֔~)<- {A+Ǐ߸qΝ;$*I^*T ƍm6aat.\pΝ7%ۅB!D"dxBzjmҝ$b\b7|q[nI$ccn>H<|?~< K]]]ssT*( "`0~Pm68qbPf 3~KK˭[ܹHtڱ D%&&ھ}H$b6uЯSSSnjgg'$ (RAPu cʩٙB *r---ͥnذόԞxxx|G*`=T _Ϝ9Çq]O-::i֭w'PqƎ;WXT*[ZZt`S={>쳽{&$$ bÿ@}}H$9;;wisܬ… 999|D&=}4% &&&AR%\xէOւ<3^pʱ011)0qDG]x2<0gg炂  '1~aiRs\n_ӧO_ti…yyy@]fj$&&&t:]*7L&H$[LF̘6.soa2C7~NJo9V-SXUjT5~b>ԥ/X`ժUvvv˅BcD"ц hg޼y4D"`8NA߀ܹsνxbxx9s4SVeeC_f\tUV ¶60B ===cbbO#2 $a[M.\]]sssh篟 CTmv˱jPR677+ 5 Wrܹ_/Yȑ#+VprrKMMM\.w„ ۷opB~~~Fǿ l6D"uvvC.(jnnd2288pJ`SVuuu?渃-91t %K֬YT*bqss3L633311166f2FFF&&&枞QQQxQ_K"( `2T*Bh{]"N_*J@?/z‡.TA8οow>LIIquudBP"dw0;v'O~t:2 ô|eV͕iʚ={X,kY[[GCBBbccKKKy?ɑrD"l:ޫh4GGǸgϞuyݻw/((H/ 5*TUAԸǏgX۷o0ԔNw H$F355 HLLqm'M#""zRAuX3& +++==]E9{N< |N>?/[LURJRȄu3f BiooԬ(f333t)o U!##6P駧oذ`mmvMr܈//~f<ҬYLMMwޝ8RXuVP*A>P^^ꚜC*}>$rybb֭[9*^`ƿ}vA$ C}̙};v͛s?^Ņ;hCC˗wS_ NKSSSjjj||E"Qzz5kƎ V5acw577GGG3.<=qIDATlddF_Tu# HTu bժUԱq:6~Ba\۷{*AgΜQ*K,"4ƏaNWkq +WT Hu;w.HܲeK\\{"7l 5hUꝾqҥK?SppL&{,K$iVR[[['N&FU${5LBm|w /SRR>\{(_ :hC/;+--qAPSUAU[̙cccgGGO?9k׮566X,ЁuEYYYAAKffjbPUrf%$? 6hJX;wKMJJ:x;*?dɒs"2lZ5\!FH83j@}僊$j^ӫPv~Νoߎa`y$ -HQOJiDgmCz"##UQFFFJH$vZ~mφTGG ! H$¤Sa͚5 }?#߲LP 'H={v?u$/? By/ bx̙/ilffgϞuvv^tYZZFGG!!JD]2%Ϟ={ƍnQHg„ 8!*Iv}G}~! 'OVXjD7obbYYY;aƌ'O~/͛XxcǎJmmmL&cp?sL7~:aܱ|xTڵk'N:;;JL&q޽{)))</""<|x<޸qŋU"Pѭ)~}Mea=.֪* PG߿|ܹ+W0N$׿x"%%d~2LR H$H7D"J(Rmå=_!^D"ٻw/}zt8~G޵N\J=mllܻwoggglljj[ݻRՁKFÇD߿rJcrT,?>ӳ...}Y_CPLMMry{{{GGGggB b57'|2sL_T Ř)9sr֟0\!۷]\\T!?[k77|Rb1xbc ǚs /Ia?}يdvvvJ$\N@/?8LΝ;u$L&SPn4M!!3g:Alj:%>>믿~>cwww٦=Jiii#bSl6ƦB /HC6 A ]2.]jjjJNNf2RNX,PJ( F311 ;wnZZX#|855'::X@}1{/_jURXE"QII u3\"֭[111ȻՁǧ ,hwVsssGsssHFG{Θ1<`555gϞMMM -,,DQtPvtt~=_ .Y~=DJNNQLfXl6[rɾX,޵kWեl2!|>?99'VwAP.22JOj̉'LMMMMM{Ѝp!*086p/U$mٲNx< ocH${ Rqd[ܹIII-P(|&:*֫*HRRR|n+ߵkW?kmmW@%#H_r@6B}M.϶mJJJJJJk׮}vʕ1ʾ7f l*R兇[XXϏ%$$466UUU_}ɓUȑ#`uhPeI.2nցPX -[ @pܹ0R>pgdf X|ᤤO"vX>l\\X,V}ٮ]Μ9:#{ؘ{ȑ;v @ \tݨ( Ez֢!ӦM;{lכ$%%eݺu {M[TkטL&pTi4~:7|А޿WQ[[hiieAt9/U\ n]ggg@p…͛7O8?p8/^DϞ=_|uP vx=zrss1 WuTSN6M"޽{ݺuR{XTSQQQRR֍ֶէuXX͛7onmm={lХϟdr ð=ѳY~W՞}~G+**Ǝkjjf:;;A.If;w$44t„ p4j@i&##'Nh[R{֦}222q?f?~xAd2Y{{;J5wkW#AUP(FFFdL6&eRC nݺu̙3fdffBai<`*|~ll$n۶-===22+dN6mĉȁ#noo7Xˠڕ#AUun d2LTe&TPS[[rxA\7|yfKKKU.U?|;vl޼GRz++odLѡT*AH$ɠȐO7h'#B1ܘD=? GC*1%%ԩS...SN/VTT=zt۶m,KTRTSSSCP%߫b?UՠQϜ9s=k<,~ahh(^hV C.wvvr8Q!?`hH-<]ZRgX@fyѣG1 VPD!(7~zU'9zhuuU@3O uƍ,kkիWjH$:vӧOUKc]5~` cĤꚢs# ϟ?vXʕ+|HPݷl٢JA a0R{U.U+W k|\|wՈa6jPtd2mll-Z͛'O"+Ǎ }WX $`hI9pbɒ%٥L&sd, H4Ǵwu۷%''n"m<6scǎd J0ХGvȯ#Up8٤|t]]mllo< PPm]!BRut)bȈU!?1: neR4QCU.577gd!~_z[`!ema 2ie2d2w*.HtJQłIENDB`qthid-4.1-source/images/quit.png0000644000175000017500000000246012051012642014775 0ustar alcalcPNG  IHDR szzsRGBbKGD pHYs B(xtIME"s/IDATXoU?2Υ EJ$PxKDA 6A#D$BB(Bi[r)RЍn]}0q9w΁#f Xqc,Md =;ozN^}fuse&&&p]qp=uqs\v J)Pߺ fN[mۧΝaddup]ufħ \'NѺNCѱu% hjjbtl8<ϣ}r~>rER_D ԰rJ43>>eYDQBU&PHf֪abV!# @+}@ A{v|t8}vNJ !Z) ˆ~#_~U>hS5ee-%Q*s $oDXZu ox#!I²J*!e'vT  Z@&o!Ɂ{8 ^yU(C.M;nYO(T: ɰ0O?.]J8Lhy/>ϷaPP 8,)VF[ZKZ4Okp6%O+4ڸ)  ҩ'PZE^S4(Z܌knmm$#h%.J~bwK,lpU,@ !hhh$ʠ@: t x/)c nGm_$J Zk[eY5u E#c<.r5AS Ѻژm^A෯h l01JRD>O&Z]\3`0.n Fkڶݺ` ! KXhJ8PJLBѦc 1} 8ͩJi(,:mCJ [xzzz`Y 3@)03ҡib`o"2Rx. { "cH$"!ډ1jD @<udw@(J b\r7n |U)/skm{l\'`ys>G32J)K/\wħQO{y-/૿=3Pĝ䀍)~""q4D)$w+p\_9l ⛿?h޼`c?.„Q5;4bWh=ؼx$3-i^=~xE{OjK8vk`Ŝ֨]N`c|1DlR:`%e v^+[yzKE'.f/*c~gm{bM;ьP$fK ""hd+dj LHoVយnW^oRWQJAq׃ fXΆ*^U_'G^}lY `YJJ(%5";=d 7+ b mj W46SЫ{'\r| ϫV>^~q9Ԭ)E !rVݸpf\= I@$Gu5|g=,KH#3=NJө1xk%5緄cϺq{-|D[)q;H0 8>y`sQ,h7iwQ\~aƀ^9I?.ߌ̴$RJ@IIJI, KJRϒEz*,J}Na)IDq1vpwL")%ѩCqИahsw;XܽUu^dDt+K"෰x]|s+>}qh[@t41* I"8" s7lFCsBN(`)%{$ۖBRdG3+$0'-(%Y)JJHrw~2B戂qWcPQ.:Ŗ,< H{ɖR aᘣ}  @oFRpT=aNB CO e j3F.,!$YJe`"!E[Jnj[ED9H!*֏T7:'A۪% !SRОoG)()XIAh{ذu'lͻj@Q~&*e]Pq`1G9->96 fn_x$d%u?XI84 -Ȼ 0k81บÆlxovRW@(.CMX_XMy9i3a8aưjb( KN@6ڴJKQ/%K0 υt;jyg~ѤAk cB Mذ+nW qq5@hhm䗣?Ezt(PYgQ14oa$WC R,`ے, 2a!W3\eGk8q<8u(F]ڍ޹vU<6 5g‚rQ,19c˒8zg-\!g|myqYb97 4sJ4Ǎ*]C5Rr p֘Oy=pAMHK"KI!X)Κ 8<8ur25;DΕjLpδezSYf7+>2{X\33s4^Z]=珟.WDAqkzܰݮo(3nsAE0v%(/MDn?ltKMy"ЪYG7~劙YbE)>;~I>1zёu|<1CXv>N$Șs?=xȶ uqoypVIENDB`qthid-4.1-source/images/save.png0000644000175000017500000000235412051012642014753 0ustar alcalcPNG  IHDR szzsRGBbKGD pHYs B(xtIME#vMlIDATXk\U=ܓI&NmVb n]ԥ ..ĥ? ؍` W.ZQ]V h&d~s\;$4B2˼9y};#'Zo5uxѕjRTbg",Jc .;v!s /rB l 1PՈHbћ0%$X%(2 BU+)"RI F Ao7!k,.1ڤ EQ "} #|ڞ fߘ[8sh,e}6a$9_1rT}K؄yQ 8hXE>;Z{ӏnY]>1g8ua,%*w;\ 8sXnK:+Cdz@Fm\k){OfwCB s|QPT$ƈ(X\\PsN e%&|Jv{}3˷@`@JT%y7<m`XnyԁWcj6.#@; \IENDB`qthid-4.1-source/images/qthid.icns0000644000175000017500000047512112051012642015304 0ustar alcalcicnszQis32  $H;(*8V u⃌؄s<[OpXPSRQROX?o|_]x~DMfcPGJIJHIGKy}T~d[l]WYX^adcTyy^L;=,ORS^xxq]wI:@355TSlgMWiw~@/35,0XTdG&EauG,!BSPPQKRM| z|lfy~~}u   9&M?+- =Zx׆sY^|~Zo}vwsyJWnpYORQRPQPP{WdYl^X[ZbfdW||`N=A/QVVb{zt`yK;B567VUniNXlyC167.3[WgJ'HdxI.# FVSSTNUO }~nj|x   &L> +- ?Wwـσ mxwix̔܍t}I]sw_UXWXVVXPw~Py`TgWQSRZ_\Qzy\MM3d?PE[@N`77%524051,.,-.--,0332-,0$8JHR^C_OPGWc[HHSNPOPOOPNOURTON_ER^C\Q_mL[VW[XKQLYVZFR^D\XqA9;LoFXRUTSULS~jyTK]ER_FU[.HGB3"r[LYTTWQsudOjugZGR]L.\etBQ];W5)=6"86&5AVTWPgGBAA7d?Q^BJ8&3;978-(.FYTXSg_>(.$6cmCQ`CM-&&-00+$.QRSNQP6+8TLTCS\JeC,#),+&!.T][\^\\a`a\ZeMPb2ND6 %@GEFEFFDGBM5U7 -2UORPQSRPQROU.M7'!rS.5H  :JVN#"#!".U:&}WNMjgR\YY\QL]X[R_U\NXPYOPGuoSe^_dPEf\dM`WgDQ7hCSH_"Rc8KJWVUY>HROPQQPSVVUPPSIJ=WaHnQ{iKUa?8(LLVW\Ozcfke?Ta=f<2BCE =;'@GVYXYhnm?N/]hvFUa>Y6*>9 #:7(7CYWZSjHCBB9gBUbEM:(5=;9;/)0I\W[VibA*/%9foFUcFO/('/21,&1TUVQTS9/ECDCDDBE@K3Z<38ZTVTUXWUUVUVTZ3l8mknף < &o m~d0ϱ "()))))))))))))))))))))&   it32dr0.421/-/2,!#(*+-1(01j`I=::;:/0&.;Å`VWVU1/'.<ǂ[SUXV1/'03pir`UR>=/0'3*#EbU@'-,0(1-6.C`U>,1-2 .'BaU>)/ 1*CaU>*0 0)CaU>*/ 0)CaU>*/ 0)CaU>*/ 0)CaU>*/ 1*CaU>*0 .'CaU>)/1-4.C`U>,1.0 3+(EbU@'-,1)1.Y`l_TQ<;.0&14ˁ]TUXV2/(.;Ӻ]TUTS1/'  !!  ! *,<]TUVT2.,-631-,/0-+0/+.0,-1/0-+/0/1+=վ]TUUS2-./44( %2/"+2;?53343;@5766@83443>=475;?5321+=տ]TUUS2-14'%223+,jN9887668Arj=876689FP:833*=Կ]TUVR5%SW&.1 0-.,)'%%)-+%%$+#^X"+#&%$',,'$%$%*(1''$%&#,+<׿]TUVQ6$Uo&2)%5#s8*/ANP;,1JOK01""24ONQE.-CQNPOPF1+6J&2@QNODPNQ<(=Ѿ^VUVQ5%TS%5*.6,+UQ&5u3%[^%3r j,)dV++:'EDO$@€\STVT7#V'42%T̿К,(b`"82%`b$1 +'xa(+ȷ<%KD^%0~aVWVH0&Zȹ6.*3!i9,3XknF*4dlg:56?jgh iglV.-Rmfihgj]5.5P&6Rlgih6ifmJ+0(;A?<;7-:E*)4r!% &,* 'f_' #+,$ ')#"2&,,/)(*++)+RN(*5s^B??<9:>?@LF?=:: 0>9DM4@>)6SMHFGU VXWUSTUUTVXWUTUVSZEC*)3 kAWRVU&VZ_[ʾ˔7:=OJ7PA2Q:8P96-)gQDCGWTU SMOV^XTVYRMOUWUVSZEC*)3 kAWRVU'W^XƹhF9?R1AO2CF7>9902D*#FNCAIWTUTU`}jQVoTRVUTUVSZEC*)3 kAWRVU([T³N=G7PE>LFG@HJ4KE-L;'B5#3FB>NVTUTWSUSa{KenPWWTUVSZEC*)3 kAWRVU(SWRv8L;CLCECMA=W8:Y0;Q,:C-03/=@>USXO[ZTToNdiSUMWUVSZEC*)3 kAWRVU,TRS_FABJHHJCKPVSbQWUIVSZEC*)3 kAWRVUVSOLhI2BP4HM=GHK?GW2HX(IP%DA&82+$,Mp79EWTUTVSj[VP@3(" !$-9HWQiMVTUHVSZEC*)3 kAWRVUVONKM';B@?=HG3VI.aD/a=5S:9=<7)?,<.wH5;SU TVONTL3 #:Whk`H-(>VOePWTUJVSZEC*)3 kAWRVUTLH]|#A8J7=W2G]1QX6UNBNDO9>S&>J<81*Ia46JXTUWXYLYO,#Yɭy8"c6.D$?D/G@@F@UABJ4>:9A+DB9F7@02=00(_l]4/FXTVUpUYMUB<:;f}B,-8581CB(YC)`5?hJ'%2<91S6!Q&D2Li[7-CWTVUTVQeL\GZO~VCI_T\@fu7*0A*2P':Y+E[4>\M- *(:Q%BL$9:(*+)GdW7-AWTVUtTVRbxNXS}FRhYHOPQ[R>>?:N{z_QUYPWTVSZEC*)3 kAXRWO><&Q?$C2&/*&CSI3.CXTVUTVRefRTcywM:?<<@IJ?:<;8QZUVSQULVSZEC*)3 kAXRVS=7Ojj/0(E%$N)4M8=84+02,:S,9:1.'4 /CMC2/FXTVUTXMwxNV]mmM8=;<;88:;:99LNMU*xTVTVSZEC*)3 kAWRUU>6GbhE+-/0#4F(>D'&$%#%'78A*9?742$EF>00KWTUTWQhNWWaaO9<9:;:9X89DAGWRaOXTVSZEC*)3 kAWSUWA4>ZaM),"85#K7(Y82D0 !(0D7.T,,E$*1##,B@703QVU S\PWTWUQ:98X79;6FZNo|NXTVSZEC*)3 kAWSUWG58P[U2 =+H8H*@@542008BEJ!<6(,)+8=:4/8VTUTWPbRWPJJ@889987Z671..OYMkPWTVSZEC*)3 kAWRUVO54ETW.&(2+(/49&FC#F7(B3+A0/A65,:0;&3 3942.BXTVUTXN|]SVS@><886766567*' 8YTUrVUCVSZEC*)3 kAWRVTV;2:LPE &$2''E$0Q$=Q*DC/<:;89M(5I5;0,+510MWTUTWUMSVTWG04038765 2#!SUUVOPYTUIVSZEC*)3 kAWRVTXF04BHM(117=9!A829;B-AF"HAG7>+!-$"-.,1/8UTUVXVUVTW;"'$'.3432.'JWTVUWWTUJVSZEC*)3 kAWRVUVS417DCD1 &/-0(?3$P/&U)-N&2=+0,3( 3-)(,3/GWTVUTSUV5!!JXSVUUTTUFVSZEC*)3 kAWRVUTXC.29?>5'(75?A?G;&A4214: 777+.$$%%106UW@"/RWTVUIVSZEC*)3 kAWRVUUVS50298:,1$;'?*):11-;0"D*C#:*"!,3.HWTVUSWQ>-# (5IWVTVUGVSZEC*)3 kAWRVUVTWI/20423*((",'1))>!.C4=51!/&'#'&3.:WTU VSTVUPMLNSWVSUVSZEC*)3 kAWRVU*TW=.20.,.!'0,=*@':&',**0%/!202QVUVUSRSTSSTVUVSZEC*)3!kAWRVU(6/2-(&*2 5&2%(,/$'7#6"-!12/JWTVUVVUVVUVSZEC*)3!kAWRVU(VQ302,# # % $#$+--4(4!*"02.DXTVUVSZEC*)2!kAWRVU'TVO203-!/4 0"&&22-BWTVUVSZEC*)2!kAWRVUVTWP5/31$ "" ",40/DWTUVSZEC+(2!kAWRVU$VUVS:.14-!(33.3JWTVUVSZEC+(2!k@XSWV UVWE2/35/'#+350/;RXTVWTZDC*(2!lBUPTS RRUM:.+/20,(#!%+/20-,4FTSRSRSTQXGD+(1"c=]W[Z X[\SD823589 6425=MZ]YZ[Z[X]C?-&)+A^EIHI JIHKLF<2*%#" $'.8CKLIHJIHLE&48ᳵ s7 0,4%3(4(1y&-1 4.0B@(22-81+,47(&%&&%  74:97546#82().01237.!78ndNB??@?56,#5AĆbXYXW75,#5Aȃ]VVYW75,!78tmtbWTCB46,#80*#IdWD.327.73<5HbWB2738 4-HbWC05 70HbWC15   6/HbWC15   6/HbWC15   6/HbWC15   6/HbWC15  70HbWC15  4-HbWC0573:4HbWB2746$91.%IcWD.327.!84_dnaVSA@56+#6:̃_VWZX75-"5@Լ_VWVU66,!"$$"#$"$#"$$"#$"# /2Aƒ_VWXV742#3<97426427624633767436561B_VWWU7346;;/ (:5(18AD:889889?D:<<;D=89989BB9<;<:@D:8771B_VWWU8379,+78 :12mS?=><;;==>FumB>=;;=>?KU?>4=90B_VWXT:,W[-38 7342/-++/31,++2*a](1*+*-22.*+,0-7.-*+,)22B_VWXT;+Yr-8.& ;)u=05GRT@27OSP77))8:TSRUJ43GURSTL62<N-8DURSDTRTA/C`XWXS:,XW+;/4;11YU,;y9,_a+9u n2/hZ11@.JDS+EĂ^UVXU<*Z-;$8+X˿ϛ2.fd)>7+df+7 1-{e.1ȸA+PDa,6bXYXK6,^ȹ;4.:(l>29]orK0:hpl@;%&;Dnkl mjp[43Vqjmlknb;4;U,:9;@JM//:&q׀Ԓ׌نց"J0.:'mF1.:'mF1.:'mF1.:'n߷H1.:&p<^X\[\[\[\X`?I0.:&oFZUYXWWXWWXWXYV]LH1.:&oAZUYXYYWVWXXVXZYXYV]EI1.:&oCZUYXXWYTNMNKIJMNOVXYV]HI1.:&oBZUYXXYQJJFDKOMFD#EFKJTYXXYV]HI1.:&oBZUYXYSI\cdebgG2:_ed(cWGJJVXXYV]HI1.:&oBZUYXXMIK ?(tGJOZWYU]HI1.:&oBZUYXVNDd B+QGOYXYV]HI1.:&oBZUYYVNCh ;-UGOXXYV]HI1.:&oBZUYYVNCi6y1VGOXXYV]HI1.:&oBZUYYVNBl 90VFPXXYV]HI1.:&oBZUYYVNAp< ĺXFPXXYV]HI1.:&oBZUYYVOArƬ?XFPXXYV]HI1.:&oBZUYYVOArǾ?YFPXXYV]HI1.:&oBZUYYVOArѥ۲Ýԟ@Ýѥ۲Ýѥ۲Ýѥ۲ѥܯYFPXXYV]HI1.:&oBZUYYVOAqˡծٽϚ>ؽ̡ծٽ̡ծٽ̡ծٽ̡֪XFPXXYV]HI1.:&oBZUYYVO@sغijϵ۳Jϵغijϵغijϵغijغ¾ZEPXXYV]HI1.:&oBZUYXVNBhPͿQHOYXYV]HI1.:&oBZUYXYMJH½ʽҿܼS!ҿ½ʽҿ½ʽҿ½ʽI½ʽtEKPZWYV]HI1.:&oBZUYXYUIJDS^\YXZ]]YWX\]ZXX[]\WYOHKXB]]ZXX[^\YXZ]]YWX\]ZXX[^\YXZ]]YWX\]ZXX[^\YXZ]]YWX\]ZXX[^\YXZ]]YXMEJLX6YV]HI1.:&oBZUYXXYTKLGDEFFEDDEFFDDEFFEDEFFHIHFBDDEFFEDEFFEDDEFFDDEFFEDEFFEDDEFFDDEFFEDEFFEDDEFFDDEFFEDEFFEDDFFIKLWXYV]HI1.:&oBZUYXYWQPQQPQQPQQPQQPPOPQPPQPQQPQPPQPQQPQPPQPQQPQPPQPQQPRXYV]HI1.:&oBZUYXZYXYXXYXYZXYV]HI1.:&oBZUYXWXYXWVWXYV]HI1.:&oBZUYXYYWWX[_bdeeca^[YXXYXYV]HI1.:&oBZUYXYXWX]emrtromkihhge`[WWYXYV]HI1.:&oBZUYXWY`jstojilprtrkd]Z[^_ZUWYXYV]HI1.:&oBZUYX]irqimw_TWZUSXYXYV]HI1.:&oBZUYXWYbmogqijhPSUOTYXYV]HI1.:&oBZUYX W[dmgj̺ż_KRMPYXYV]HI1.:&oBZUYX!\djb{ÚvY9<[1>T-EN4KR-RN-SF4I?;8;<&;46(j;?IZWXW[TeUTud[RRUSTapWQfSYWXHYV]HI1.:&oBZUYXXYTVQjOB8YA=\>EV@LJJL=SA4U21M&0:$&8K<>UYXWZQo}QYOLEB?IJM@IY4J[)KR&GC(:4-%-Oq:;G[WYXWYWm^YSF9/(' +3>LZTlPYWXHYV]HI1.:&oBZUYXYRQNN(7V;Y3H`2T[7XPCPFQ;@V'?L=:4,Kd68MZWXZ[\O[S2*^ɮ|>(A\RjUYWXKYV]HI1.:&oBZUXYTMHwL!GD,MI1TJ;RKHHPQ6WO*]F'T:'B0*0,'*ss>5CZWYXSRS[XWX18ɳa)E^O{R\WXIYV]HI1.:&oBZUXYPIM'I19J9CCJF;^B:m;@o6H`2GG;;2D,(C#; PwK2JM&ODM4B&)5vvV26QYWXrWZRnP]O9¼nxPCOc8\V]oSZWXYV]HI1.:&oBZUYWJC_W-2F9-U93\==\EGPH@>J;2X85`-4N+09,'()%ht\43M[WXsW[QqOa:Qie~YJ:aJN\RaUYXYV]HI1.:&oBZUYUGAe8/G%AE0ICBHBYCEO7A=;E/HD<=>eaCJ6bxD`O~yQZWYV]HI1.:&oBZUZTDAg~C-/:6:2EC)\E)d8BjJ)&!5?=2U8#T(!G!4Nk]9/E[WYXtWYThO_K[P~WEKKJV]A>C:sSWTjQ[WYV]HI1.:&oBZUZSC@hv9*1C,4R(<\-G^7A^N/",,>T%DO&<;),-+JfZ:/CZWYXtWYUe{Q[W~GSi[JQRT\S??@;O}|bTX\SZWYV]HI1.:&oBZUZRA?e~q%78G8(Q99MBI:=MtH2!78:S6>987#:).I_V9/CZWYXqWT[ZXUdcDLUaZ[\a`E=>><@jreVYWyWYXYV]HI1.:&oBZUZS?>`yn;+7*43=7.T4-O##Q4*+!88P.0O.C*1CZQ8/DZWYXVTRUZThT@FAO`gicI<>=;\haXUSUXLYV]HI1.:&oBZUZT?;Yrm5$1:%:F!GM#VN38 !!%)('B@'TA$E3(1,(EUK50F[WYXWYUgiUWfzxN;@==AJJ@;=<:S\WXZVTXLYV]HI1.:&oBZUYV?9Qll12)H&%Q*6P:?<8-140>U-;<30)6! 1EPE41I[WYXW[PyzQY_ooN9><=<98;<;0:MPOYXXzWYWYV]HI1.:&oBZUXX@8IdjF-/1#6I)AI+(&&%%*;;C+:A:64%HI?22NZWXWZTkRZZcdP9=:;<;:X9:FDJZUdR[WYV]HI1.:&oBZVXZD7@\dN!+.$;6$M9)\;4H3 !"+4H9/W.-H%-3%%-EC:15TYX W_SZWXWR;:9X8:=8I]QqQ[WYV]HI1.:&oBZVXZJ6:R]W3!@-J:J,BB78631!9).*- ;?=61;YWXWZSdUZRLLA89::98Z78312R\PmSZWYV]HI1.:&oBZUXYR76GUZ/()5-+16;(HE$J;+G7.F41C87-<2=(5!5<650D[WYXW[Q}`VYUB@>99877679-*#;\WXtYXJYV]HI1.:&oBZUYWY=41.,74432PZWXWYXOVYWZJ373598764% $VXRS[WXIYV]HI1.:&oBZUYW[H26DKN)!349?;"C;4<=D/CI#JDJ9@-#/%# /1031:YWX Y[YXYWZ=%*(*0430)M[WYXZZWXJYV]HI1.:&oBZUYXYU738FEG4!(1/1*A5%R0'X*.Q'3?-2-4)!6/,+.50J[WYXWVXY8 ##!!M[VYXXWWXGYV]HI1.:&oBZUYXW[F04;BA7)*97ACBI='D7526=!:9:.1&'((328WXZC%2TZWYXYV]HI1.:&oBZUYX-V724;:=-3&>( A,*;32/=2$F,F$ <!,!%$".60KZWYXWZTB1&"!#*9L[YWYXGYV]HI1.9&oBZUYXYWZK043656,*+#-(3+*A#/E6@84"1((%!) (50=YWX YWWYXSPORVZYVXYV]HI1.9&oBZUYX+WZ@0511/0!"(2->,D( =()-+,2'1"$434TYWXYXWUVWVVWYXYV]HI1.9&oBZUYX)W8140+)-4"8(5').1%(:$9#/#241LZWYXYXYYXYV]HH1.9&oBZUYX(YT525/&#&$ '"%%&.//6*7#,$340G[WYXYV]HH1-8'oBZUYX'WZR5250$!17!3$' (440E[WYXYV]HH1-8'oBZUYXYWZR7153&"$##%"/521GZWXYV]HH1-8'oCZUYX$YWYU<036/$ +5505L[WYXYV]HH1-9&oA[VZY XYZG41571("&.5721>T[WYZW]FH1-8'oDWSWV UUXP=0-143.*&"! "$'-143/.6HWVUVUVWT[JI1-7(g?_Z^] [^_UF9457:;;:; :8657@O]`\\^]^[_FC3+.1F_HL MLKNOI?4,'%$ &*0:FNOMKMMLKOI,;!=%ⳋ v&= 71:*8.;.7Ր|,38%:4$5GE.%883>8212:=-#*)*+*    86<;987868%;3*+134434590 #99ndMB?@68-$7C]TTSS87.$7CYQRTS87.#9:slp]SQBA68-$:2,&I_RD1649/95=7H^SB495: 60H^RB27  92H^RB28   82H^RB38   82H^RB28   82H^RB28   82H^RB38   92H^RB28  60H^RB3795<6H^RB4958%;41(I_RC16490":6^dk]RQA@68-$9<~[RSVT87/$7BҸ~[RSRQ88-##%%$%&$&$%%#$%&$%"14CվZRSSR963$  4>;:658998975984798898559896589893DӼZRSSR9568=<0 );7+49AD<::;:@E<=:;;:BC;>=>;AD;:993DԼ~ZRSSR958:0.9:! <25iR@??>==?FqjB?>==>?@JTA?3;2DӼ~ZRSSP;/VZ069 95732/..153..-3,`[+3-/440-.30800-.,44Cռ~ZRSSP<.Xn/:1"=,r>37GRSA49ORP88,}},96=V/>Yokl6mjpP480AGC@?=5B&L30<(v*.)('/53)('/#jd"0&)('+45-'(/%0+*'('.547213(13#XT11<(wdIEGC@AFFGRLFDAADFHXeIF1C@A?B@<;=AKO10<)rђԌֆӀ#J30<)m߆ߔG4/<)mG4/<*mG4/<)nݴI3/<)p8ZTXWVWVWXT[9J3/<)pBUPTSRTTSRQQRSTSRSTQXGJ3/<)p=VPTSTPPSTVWWUTROQUSTQX@J3/<)p?UPTSP_u}~&~pYPTSSTQXCJ3/<)p?UPTRTQl'bPTRTQXCJ3/<)p?UPSTPcvZd(YRTSQXCJ3/<)p?VPSTQ|Ќ PҺ(ϫnOUSQXCJ3/<)p?VPTRTΌ Sκ)͋wPTSQXCJ3/<)p?VPTSTɋ O˹+͎xPTSQXCJ3/<)p?VPTSTŊ ǾNŹ+юxPTSQXCJ3/<)p?VPTSTɊ Oɹ+ӏxPTSQXCJ3/<)p?VPTST̊ Q̹}׏xPTSQXCJ3/<)p?VPTSTR΀ڏxPTSQXCJ3/<)p?VPTSTRڏxPTSQXCJ3/<)p?VPTSTSڐxPTSQXCJ3/<)p?VPTSTRڏxPTSQXCJ3/<)p?VPTSTVڐxPUSQXCJ3/<)p?VPTSTXيvOUSQXCJ3/<)p?UPSTPw^$֥jOUSQXCJ3/<)p?UPSTQ]{~)TRSTQXCJ3/<)p?UPTRTQa ,|YRTSTQXCJ3/<)p?UPTSSTPVhtxxwxxwxxwvuuwxxwxwxxwxxwxwxxwxxwxwxxwxxwxw(xxwwrcRQTSSTQXCJ3/<)p?UPTSSRTSOPQOPTSRSSTQXCJ3/<)p?UPTSRSUTTUTTSSTSTTUTSTQXCJ3/<)p?UPTSRSSRQRUX[]_^]ZWTSRRSSRSTQXCJ3/<)p?UPTSTSRTX_flmlifdcbba`[VRSTTSTQXCJ3/<)p?UPTSRTZdmmhcbejlnke^WTUYYUPRTSTQXCJ3/<)p?UPTSXbljbfyrZNQUPNSTSTQXCJ3/<)p?UPTSRT\fh`jñbJNQKOTSTQXCJ3/<)p?UPTS RV^gad˹úZFNHKTSTQXCJ3/<)p?UPTS!V^d\u˜t: '#2U~zFJGHTSRSTSRSTQXCJ3/<)p?UPTS"V\`Zy=0=8CL3@>)6SLFEES TVUSQRSSRTVUSRSTQXCJ3/<)p?UPTS%TX]Yɽ˓7:=NI6O?2P98P:6-)fOCCETS QKMT\VRSVPKMSUSTQXCJ3/<)p?UPTS(TU\VŹhF9?R0AO2CF6=9902C)#EMA?HURSRS^{hNTmRPTSRSTQXCJ3/<)p?UPTS(YRN>H7OD=KFG@HJ4KD-J;'B5"2D@=MTRSRUQSQ_yIclNUURSTQXCJ3/<)p?UPTS(QUPu8K:AJBECM@;YIGGI;Q?2R//J$.7#$6H8:PTSRULjxLTJGDB@>@CEINTQ`OUSITQXCJ3/<)p?UPTSTQNJfH1CO4HL,<.wG4:QS RTMLRM;*+B\mpfO5(1BSMcNURSJTQXCJ3/<)p?UPTSSKF[|#A8J7=V1F[0QX5TMAMCN9>R%=I;71*Ia25HVRSUVWKVO4,_Ȯ|?+AWMfOTRSKTQXCJ3/<)p?UPSTOIBtK EA,KF/PG9PIEFNM4SL'YC%Q7%@.(.*%(ss:2@URTSNMNVTRS3:Dza,CXJwLWRSITQXCJ3/<)p?UPSTLFH&F07F7@AHD9ZA8h9>j3D[0CC990A*&@!8 PwH/8RSTz[TQV$'4uwT/4MTSrRUMiKWK\V*0C7+R61X:;XBDMHA@K<3V53\+2J).6)&&'$ht[10HVRSsRVLlK[9Nfc|WG8_KJWM]PTSTQXCJ3/<)p?VPTPD=c7-D$>C/F?@E?T@CO8A< ;E1GB9E7?/1=/0(`o^3.DVRTSpSVKZ@}<99;b^@H3`yBZIzuLVRTQXCJ3/<)p?VPUOAF<>LsF0 69:O4;655!6&+H`W6,?URTSROVUSPaa@IR_VWY]\B;Z9=jrdQTRuRTSTQXCJ3/<)p?VPUN<9^xn:*5(21:5,Q1,O$"O3)* 98L,.J,@(/B\Q5,?URTSQNLPUOfRL]bd_F9;: 8[g`TSSPNPSLTQXCJ3/<)p?VPUO;7Wrm4"/7"8C DK"SK47 $''%C@%P>"C1&/*&EVK2-BURTSRTPcdPRbzxL8=::>GG=8:9 6S\WTSSTQOSLTQXCJ3/<)p?VPTQ<6Oll0/'D$$M(3L7>=8+/21>Q+9:1.'4.FPE1.EVRTSRVKuvLT\ooL5;9:8668987MQOSQvRTRTQXCJ3/<)p?UPSS=4FeiE+-//0/4E(>H,'$%#$)<9@*8>742#HI?//IURSRUOfLUVcdO6:78987W8GEHUP`MVRTQXCJ3/<)p?UQST@3=\dN(,"84"J6(X84H3  *5H8-S++D#+0##-FC8.2OTS QZNURWYR876X58>9GXLm{LVRTQXCJ3/<)p?UQSUF36Q^X1 <+G7G)??7:620"=G!CI ;6(,(,:@>3.7SRSRUN`PTOLM?56765Z45322NWKiNURTQXCJ3/<)p?UPSTM43DVY/&'2+'/48&DB#I<-G80G4/@64+91:&3!6<62-AVRTSRVLz\QTQCA?7654 5,+$9VRSpTSJTQXCJ3/<)p?UPTRT918NSG&$2''D$/Q#=P)DE2?=<78L'5H4;/,,8520/KURSRUSKQTRUH3733654341%!$QSMNWRSITQXCJ3/<)p?UPTRVD/2CLO)017<8!@829:A,@E!G@G6=+!-$!/201.7TRSTVTSTRT<&+().1210-'JURTSUURSJTQXCJ3/<)p?UPTSTQ306FFG1 &.-/(>2$N/&T(-M%1=+/,2&3/-,-1.FURTSRQSRT7!"#""JUQTSSRRSGTQXCJ3/<)p?UPTSRVA.1:BA7'(64?@?F:&@4203:767,.%'((1/5RSU@%1OURTSTQXCJ3/<)p?UPTS-R3/1;;=-1$;'>))900-:/!C*C#9) &%#,2-GURTSRUP?/&""#*7IUTRSGTQXCJ3/;)p?UPTSTRUG.11756+((",'1)(>"-B3=50!/&&#' '2.9TRS TRRTTPLLNRUTQSTQXCJ3/;)p?UPTS*RU<.10201! &/+;)@& :%'+**/%.#101OTSTSQQRQSTSTQXCJ3/;)p?UPTS(5/1.,*.1 5&2%',/#&6"6",#01.HTRTSTTSTTSTQXCJ3/;)p?UPTS'TO1/1-&#'$$ $#%+--3(4!*$01-CVRSTQXCJ3/:)p?UPTS'RTM1/1-$!.40"%'11-AURTSTQXCJ3/:)p?UPTSRUN3.20&!#"!#!,3/.CURSTQXCJ3/:)p?UPTS$TRTQ9-03-$ )12-1HURTSTQXCJ3/:)p>VQUT STUC1.23/'" %,23/.:PVRTURXBJ3/:)p@SNRQ PPSK9-+.0/,(%! "#&+.0/,+3DRQPQPQROVEJ3/8+h:[UYX VYZQB722467787 5314EH[\=g𞐇Uz7.b*hUnH HQ$_v7C_Uyؐ]Rw˱.dml1ݐqyUj/Kpfj'ȬvEȉA?ci?ht|nl/.(0ݞr|n)QWt y$`Zlre%59L=  %t[44eP!ZOnnj`>}iw'dovN67fk16zVXrqުOx%^yҠ{M[kN˃8awK(kI囦t?V{NՈL}Cpl^ul6[57Xe"5ת t_ Pܟ0UZ_1^ܾ1Rk\( `߉hTRE|Ok/ }egPa."V&1آ%H"X9]1<6g2&JW aB9|V$H|$~` o"LK5̪9ˏf} .CS΄#ZhE]C8$rP!$tf8n-=wKwIԯ֕EPRF+ߌ^#GgT%sUc{Y-<rMtiU42>]Mv #al UZ7 ZA=!>_10Cȓ,([ lP{6\á hkr> VaTNj[ o% Wt1Qދf} 魗'<縤 #"{_0 %% b#2Ldu\Btx!@?*iffZ p `ߟSݮScZQ.3L!XB]'Kh8f7Dq:5Q*2lUN0Tp{Q$F{mW)uP̡mgh,6 @ʺe (?ˈR0l6H lC 2@f KyW"4>k?@v眕퐬M93~I 86*Gyƥ|QJE8q "^"IF~)/ hs[~̜ڞg{IG9l58ՐzsV|%|͕#E* 44xj]2pWeqdu/A oY`"k4DJAU-5xn&^}!d^O̜{$u DX$fH31 c/P埳 `6]$[`stS@,fl.b-͞qpZLşY/zAu1ohRFgJ/ksg {JAF{xE&>a۠8-&F ^ȌJźfFҺgv 6 W-bM}v〫7jX-#tvQ!\=ׁ!Ѻ_|X8?xE9TnL@$ [/lⅷQ].Λo~*85|C5EB+u_w |hBJh:7'eS6`i79!R'rW1da7秎0*rWcF'hbA!'C+^)O2(]s hm lZ(}ߘ@Ri8cG9aӮ}#ĚyIv׹;ZueEdײ_ʡ,q6k+ΦP)-WӔ!~|c=njng("DӲҟ[6CwMq*R '❨-O2Vuy,=rݶIm; fߔ;G&XZnI9ӊ5 Z)Pe]B+vRJ՛6L_}Z1ꂴj)BFYPx`Rf5 ?KKҮU<`= pD]d}TwQ5_7>9M\?\[mԱSnPpz[˥\66@›#1׼6HX)2&'[16'M(?Ne:)RN8nOEZS/}78.L%[ n7r(L#>08smPyuΝv.,{*2>%vlPkĴNxUQ 2%\mٍcԨr0ץBB_o"짊?Kq W/䮕"Jg.\K<,= fKw4 P*0b >+6 _4MO0x\VW`oDoG3Kq;D(lm*rec[R.CN:`͋&!G0 ǎ3nk9 +Rk,ר Zoy't#zQEq&Y" p2-%+#KvbTxܝjZj#:,1zx] yT㢼t J D؊$N1C-u:r.KuU/v2j6K!S{tS =#QOSwC8>ۈpW5mZ\ozt\-noqLKgwQO/|JHL`mDcMj%sqGVy`q{C>:V0=|wcB<\d|R҆ͤ5Q9X.5ۗՏ`OqKx!6dw٣zІ:\u^{,T%L ,e#bM|rWzbgAq].N~ߡ,_GKLlIrdu7Ӥϛud9D:{odS[bYo$^ϥ݄) Bt뿽&l>RKCշ0! {y6HQ)yJWãն~gR麛:=>YJ~Tt\ 3C?g-a rc7rb41eUϥɳWMIً.QYr..rb'[J(bܒI).@:.n4x<#:=I5C%vvh쑹Tx7~7Da H~ W9 +Ԡ^?2UNQ$)?GKURBS$~tI4šV96:8͹sA.!`3gT7 du_W$Zm1%Ϯ ;V_gG]7 K+}?Id,Ox͓̕HOVEZaH!LSv)5 c0@<^ BG>K|k9dC`u~eV/IPP,s;ǗE]pµ= k 㹓]o@߬QYp}-r\.b+' o⽐&¶z8z/$ )Ȳ#gDͼe(kQ4t=׍ڵD;VEE ,W\C_jcyOʫA &Wds< E-R/xطH#э@x݆]=p/B8 !* bK G7តiRԝ|$ !+Qu+p?A\aedTb\mџ-Z1ϴJt['ռ n\S6/Ͳu֔tA>SY@|F=4IFJa~8=Ag遆Q >ذ񢰎[(05v|שGX<ǜ)7Ŝfj6` eaEi恹+cq o|I 0röJx'Q3(Q@;t(/ZbȈ% ?^Bjs"j,K6i`mO(jn_ +ܴ=-y_M<"/c| bUiD-t}q+f:,Z%ƋvrdLԧgL h`.tzg̋k=Wfu֨JMH>xg$Imf5⽡/!xzC8,h" |EYO{xW׫j.<3z* 0nz:-.^Q.wHrq{N /)3B"D2{HNjuO¨zZ˥bS?)8W> ~׶BCc)7h똑iʍ|0Ob;&? ?N| /iꯞP~0\QS(,:ˎBU dؗd70XKkR#aEPļ>o $ TL_7$a$$yu\L ba1~z< qqTa`Cƛw¿ 4$"2H6)?.̹}KeV_60:`H@|c? T(n"ׯ8=P_X -)t?=ڇݞ҇`" ۰ޗSɠTw̟``+ZE1qSЪ5?R1VA"/絔j3q`==`g|c{mz0{P\]ίN7ƁyIy#QD[!._2"ss#2H*L XL_'qSHI$?oj+CRbƠyۛ(e+0q|Wo/_JjKRC/<)"97T(6dT@m$I$I$I!"b6 X@[vUqPPe:K2e%&9#q#Q-͛ji:VB, \*j6 1fޯ?v(Æ@ެ+mK* @u-wۙ ^\Y8/S++=vܭfN'mɂ IѩwlvfCnQ\ v~#W"޸2D%Hl^qԺ"@ɭM?t`P&{>Rnh:_>[ȇc TC- }nO8 f CiI$I$I$qQ݀. xnN}Gt+%#3p4Tj&?DjlCo9. ݪ %KYYΆkZ yAͻ e[/b޸ ڤ.un<,|h53$I$J#&DL5m0re3AЇFӻM\+P"B_xPҸ~~Dh6I"%q%qތL쾺@r__ޘa~AooBG- 0>sN!_h|]<gc.GJяW@55ٰ79Ύ &NrZCzzm7cUq|f& nzB^.$tX\HseM|\ȚSe})gS `˶^2V|'O0H)Y(Iܥ@A]}3#^h%Iڧֵ4 _a-{d)]9K;uCPӹYuvڋĿ4%r^3#W[9MsjsnZ7QZer{+ k%Mf:_o0F )\W4Hģ;2R?s,a4~{zC=!Zgq Jn%|Cfv 1ޅ41B@IҪ@24x0n PuQdl>CEx4 z7*in{=BA0 KNJs/.s !˧;iwGSSgHV0Q3|sRᶘFb(D&iS=\zB?LGOQHj{ܟ$*5$ZH‘NܵwBn',d2+$mˎaO6mnUۋ4r aVخeS@վ(WAk [ʃ cքWwNVdCU,syMl>ssaY6 6}AÖ,|{JYVQ1(uK"yi2ՑOv`Pbp{mE@3lc}Z֪`W@*>;ҳ%B4^jTEPTEZrG 9)Rt}j>8_lj%x Bf \}Q`@~{k||ըRl{ h[c;yGԣL.;*Օ>4fp}׆t WF`bp`$:jer^i6񋿀ʙn߯z\ߙvC#hvO9w kМ !"' [N#QYs [әUۜ1)m}( 1[E?q<OnKY'i%K;9#wtC9ݫ3O_)}Ӥ7]ǩkd,86KL2*?S4 ꁀB 5HisV֊@qa6A!S a^>a?r#ϺyK\,Bu Ą{ ];p^z`ɴJhSO`il^ ۋK(>LîL תnta;Ax>ygS/^@nzUZPM *jd)4& GFHnK(]&~i VߔVi[Ni (eޖfb` =9)3AA?ENVh%(v0^% #NV ࡌi)ל6U-`0#X4u5nHxa'~n^<+Ҳ{a7Clu&ln ek )HxSڔ~Z=R2"?]Mc QS},іTs㙔B/0{2rCtE~e,iv/Zը:" o޵/k4gلZw@j`dڛy,{bߌ1kR5޽ˉ0*h#f\:?NeU#R jpI>=jA1w:P"$hfUDd*a;cA?;aPFVF&8?b8&.2pJN##@[-B11䉂ZS*/ULP!6aA+bb3HM[ύ@ ܨKC7D@= 'X(2`0ir8A: 'xK !&$u;ܛ2RS6 J.Jh.L\0f-vm޸CL{[kK)ӛ m@UHENTK:5a7jGHg~~bG DIu,ս"ԅlZ8vQWH6:d%E] 5WuC:9tK3ɡ'G)(d cnOA?،_Z&Ҹ@4`^VtƙO".1Wɢ&{w l14]q@VIӂr˶"a?/e@ QVzcSgЄ&ae tw`V?zκos#+9^S=cehZȱgrJˁ0BhlpE>h^b4zD:/8 8E/sk,uꮾoY,MYeš󆺝׳t@X{ ƿ|~ܿozo% r@Dʖjj%DLhDw*鐩g0-B42V? l,|WR:"DРwWKTn3'^r%hgO(vvAǼIԘ._oX$WR \OEjI!}S ‚|NTbbP''250YB!Yj] Ed 9cT$$',ݙ]Tw*D2]'=$qvU@'O0!e&>}J!,H(%Vv+]W`U\oqDBIE12%>ߜYUG& cG1BtԏL<8Gؓ eF=4)ZjQn+wrEU`'Mv}^-`QI%cqd̦'.z\'`y1{,2 wWmlijczx%W-Fkd2K #ܼzE/4Z:B1=@)R;L2[U"VWxns0dil&G≠o MђnbvC=J-`zƘIGHfsdgw\Fʺ,n笌8ld@moy=p`I@y`n|U'R8;5& xoXiǕ0N9(w_ C p**Ai3SIBTN3_Γ1wE.B-D܏6ܶ }$6BQX- C3٬ p* 8#H#c>3Kn}GL^tml)!cx}2\nBUbSjcIC`"DwPSL $d'M _c:="/jr݄`:ؠe,\7Xgn5mе@RӅ=B"ǒz=Liq(a(/da-k\ؾnqû# ڝL'70+$*+rvH}g}z=s]"S$m9"Dط OIe~z1x#Mv u =Fj6y$LD߯VD$KDjȫ0"vrю :FfhTZl7͋n z#Sզ莌PG,v99p^,ˇOW+WċU[ 'hBgti^IDnu@7*& 5>pF[.ACɬ1v`~=`Ž3W|Ƌ%vUmj) nFk昪 }1Ok8Cl䒣6:z[8b޵VJle?!Ģ9DDg&,IcBTa%UY٘OJSP:K@<#h &v}LILYߢg}&P}w-Q\}ɧT=,Ȗ 1TG 7D FRy8Caa/SxV@2nwo$U=dd _7/;r K wLryߤxCl,d*/`,|MOOpaF@i Zp܃ttsr8PdXk:iGbI}w.@Gt}ר~+|"ZzyW %{A,㿿vJuڋ2aixӏcp1VM䁻S<Qj%ᅉx? E=k>P`UoJB,}DET۝Qg*"i_4{ҍkj$dR&$MqwDGe\@wS`n=L aLt=चѠÜ~#-e.R'3µ05mJHTΚDn$DITf1[GDI&;I|uwSt U[=UGyƯ, r7h..+xѤsOY`ǹx~yiM;I`D/:o'Ix2k<`EV~:"l.?5[8OF#%I$b=_OFYqS ?ݷI!`7 Ru'-M+*qM7mmTxd7%N%|2F?VR])Pk/0EN*+]|w.v-b"9%Mk`l )_źyA~Ԑ\:0[= "}dƞ#7 VLW(,BO0e;"n \pP8N"JI$I$ uv.8mlG˵OWQ߰Eт33333333*!Fh "4rI;nI$I$oN2fsU$I$ Y\1dAqC=4 #,lWX4oy GK6ULBV!JN 2ŝP^wǘV`RBZCeZ?~=BXyq]s'K0XS$%KgѤ]g*ש3{RŨ`AEy c̼0|JNH ጶ(y˙v;HhZl<^G`'u] 1Uݼ+%d s: iPr24c T}У#G[r8^9EPc)S(I|'CYI{!08ZP&At/8@h.T`-S܀cAF!$#j7'L: $N~Z `U/0l:H[ƻxlR"m h_UUUUUQL{O6_gbڥ&tmi\ftx{.C<ÂMҐtٹA>e/.nA%* rd ibEc+ -I[;7{JL]òjm$oAX(w"o= %5csN4$xr`dIhV *@\] ZWW:*Z,ǿ)6mmm|,Qc:!}^]e \{BfO'Eh:rc{SX°:8am/ۓ)lV3X[\bt(P'tsde^i3~QbXla߹j¹pP]Կ+-rδfmCyKmn* }sIQȳ^n A29s˿J}P$ $Dh6l $I"Bu^=Immmf֗"'#znpoHGGb$4ܬ%|؄1_܅d.w@-s} uȔZN9PYpP*!hS *:u,ii3MIb<@!aӆ'+]Q)z^_kܞa}S oJ_eH>kFĒH~_|}PFW+)27?~󺾺:fWJT:ڍM&%9\/>ݰM>tڹQǍ1DљP.&+#~Db{+#fMM1nJݎ%6AL[E@5 su$C.q:RY]xdƌ]Bo_4_rD'%N;l'2Q+쫍C;!u쇅N"|اe<;-YW"5fO.,pVm-`\RrԪ%ؕߒLi&6$) TI[YFv]ugO̰ wpe9FUMwy>x>d?(Spl<5fv@H`qƶbgM%[BCg@F]{zwN XUZqL!M:@%&&r(-V})'v' _t4i>.yve/e!# Z2}A'#O# uZQ]SҰZh 5"87-W Y"6xR`k$>+'XYܼ>{?6nx%٭LFU]#Hۣ9P[VJ_]2R+Ȫ<%BʹVG_XWNoR;fDoT)ɥP\ٗv0.ɶmRݫ }$?i6wq+U#W@{y$3evyB-EIA"s\y_e񷅟;cq`]RPTPuPYCIEol}F2P p Ưq͙ƣz).Q.dE"|a$}4I ݨwKSʂ\1'N\50|xeϣX|d Ü?Af3wF/f1(j)/3(CL& !.@Ȕjބ Ns$`0]͈pAq=5 qC=m ?7V˽RN%. cd7 - RYbdi}Iɒ&r:7"r`È<ҳ_ڣˤNC3OA\>?iˠ~<*+wlog>{W^뉋ƑfqGS3WgLQ9/l~?!'@ ;OcyJsV!X\a2rEٰ /V-+DEcTIċM`,CB_ ʿGܽ9J-62? k/]=h䳃QLAͤj'2ÖTxHDj#`chEiVk%-T՜xi0oDY d0',D}`akp$P-]:%wnA"QaswiO!x<΀Ǚ1v\`ecWR)%_qQ{N$|Zd#wzDϿyxDZ0 'pənŽ`t 8qsM JB7bG}Kf2Pq@ :!?lcNf㡦1QxoʄK$ЮoXGϳ-{w6tĖPY:StuTRdmԷptxB1_ -L I}ٻQg'\Zjxr"u|Kʕxve^fb.IJϗl&Rͭ^(Qn%jNG R\({X-1:4^^06R<=n@%?QXi;d`f#AK^!skĝk E'!a#SC8֋5EK.ĂFpZ!xPBZSҢ]+-&jf9?Ơ(EgŢ1`lQky-k;v&y|'Z˫sꉫl"D\T36iJ+3/xjX3ElnYӱ^P9{K*}Y -<|~>+bk+}O(C<ρX6Ӳ;ﯩ7n'j#*R$'B>f8S1{ov7ӪLyޤ60"cH|:O*( )teRBȗ"\@rAsAIӝ~8fO{:JrI_ wv=<{7810 9y Z R]G0KHqnx䶏_]>, :9n8(X.H.4'0=ͅjZ0E Jw` ⱋܿɾ39Rb*j[VmiH)*"BxYZx{eu'BbH94˾ baɃQ} fVw,-} ˗F~ j|33g&Vo z zk cԘʻD): m?˾vU!Jgu #yBYFcx!*®ϜԀVҕJ@{ zOi*ϰ1G)yq!@ 0R|^w aMCh@OPPٱgGyN͚1"rEªNKN05I'% @ 3R&{:uyyY\궊ξkJYxBZ<_g~cy3(ׁރfXšuE\sRO-P <3a85t8+*oW r 0Mx0g7NS.M\ؕ9.Q::-ӂݻ C:*<E ٖ:VΧ*[Ճm -5_ 8) $-=g`Jar =+ \o wgܻ-h`Lba>1f9%LdcVVH6`V .ZЋx"CJ4JTGp{fd%﷙[/fj;˰Ǡ o\h#Ʀ a}bb[uwꯕ(PLR[dM ,I iN&WYv,¡nz$ da81O'h\izLwql6QKM.bH5~S`/ta" ȋq~-XTBħSRs&l/+ˇ>_yzE\&zaZ|vl9'u{ nu-iuakxMj4!ӷ?mOZD"JgSS`zh ?<ͨFb#*Ν7]X9X6|)ikBED<Mv4sG'bGSt ýK~<_ìH~+iEcDoJ9'݅.ԩQz3g穛lҨ";` Nh +2Q=&q|riqڛˠ] i`N#~|t{vχp~@?,~ہ_>-ok=hP򩽊%8p 3Y_q|0 yYgx p=_ Jg ܼ cqk"Wz<~Ͱ',xC'/`ʿ1Us-2¹W]Gn^F@&>J*xe?6_+K*\,4r Dou2P+EU_豔jis4gMmA@m{81#pj-䈔a-9yDHŴ?cB;1a*y Yfp{]ޣ/m<#`Y+BI~xz(<+&KТA^_@w2Joف -ZFl{G|!'I?)=vF}mI+whݤ{a}(KPx)F1gzohR=GCxhdeEr3CM$}\ta|v3>QۋDZR׈ٓ 3`e.\?²UBI0męrLUxcZ2v_B*:IVh ϋ5+fًڬX\#DJΫ'Sx`SH1UX&sAH;;ai|λˋ)"-P3Zcp])JC`ZN?,eĥ2ǜ4m̙0yq59|)fS}oLy* w/N4F5a}򣬀`Ӿrãm _2pP&%kMcXT'|:-WLXxV~qM<ĖK} "O+-EWqI mW~xi&gwUX8Aa-O~aJs'j,^,@2t_[ϝArv}h A p|BUh bc 7H"pIQ?&JsM!$jJFl&y7!wg˗>?6Ve_f?/vŁ)1^ ѠO Zo6ODx%;¨Ie&oXH5lrrLK-8U%ŭ3*+?q[exU# ozG!shB~fd_h1y*lh5w;Åƅ˜ykxl7кA@@TߔmmmmƤy,.snπq6 S8PNcCKrN0!NL!tU8M*XBZd(tm]l}i ;_ t T_j-cO?czq2r_yН" &7~ x =E,H0,L$]ݬ ՇdFCA%S_s6I$I$I$I$k(9)+z<@aPD ĔO&{xy6)2t4XڠS ]|XͶ[ hyhJ`ƽƏwi"a*<ݏ~;ң҇Gz\ ؍E5|4A[6(E- \pӢoy;cs2|d Ρ"E|\gJ`mp@u]1|Y2ӛge):$6uU]K[`3LbUzæ@d|/g`ֈ p8HѬp'xZ 撚>[aQvBk[q$0q#Yj{⡩_%[/_˸ /x 2QaUqH@|Pg-F G.sۇŞP~w>oL>WtSlz-#T({ l79tTU.Ёl_+Z-uf~"MBRխ~dz" k/)М_)f},l$WkqNzty̬Ё`h0_;F٦d*GɰCY)تjQQ5ٷF$4zjʑ)`U d}(J"E[ %u[ĵQ)H *թV?9x:Rxo4}gVŏi~!cQ_ zQ\&e`3hNEE]zɃK4>|zFOYX>%qАO:Ȗ[9,<:(p3T;4i:ABPcil9P"B#o챌n-N[ZGPԔV裡HПL8q17MUˇL%~w]8qAb1ji5jo[İ`=kЭ";eq&"f{7N4}F-m]{WTXSVv*[+ 7Q Hǔ^xb@vf84s nWOoX?&%UMd$A- (-paQ8b>&lT^U{q/~ ,IpG1BYwZQQ_;hPoȫ՗0)6]ބpKgs;KxcK 8XSZ a+H1}umyQ~x*9a q֑m QVT753cąe$ATQyA[eKȍI*\\ĹQ-P ivƛIxL+?e"hWQʞ{AN-\=B4Eod\$bNPJ(ԶuL`鵅!'b`uWև^`oh% bͩ%G!=P _5=p2 7_3fv?'td!B#<,DG7eZ(`Wc/.8@ً̚/.o4-&Gfjd8q[,eMuLQq+U0{>(W+y d2j!A%^ *&{#) ,9loB;K`P9`5ZOWI; FtjI:fJ#[=s CLnIL(s0V M,!w@'b#sćrn/hA?i Id~Fl#yP!ğҨ:,$ݱ+MA|7;-0WJ{6;-ۚvEX̦yQKIfsխF&-^T>;gN%V1 5 _HnJXsãπ7bcuNo7ouoҴ# : .W 6#NFklD7 ֐Ÿ'RlR(VLj<#Mj@t,z338rڜRZ^΁LY('9Qs^x>9wh->Cˏt ~{,Eo~D,QdNlo~2]l'-SU$٫( 2lJkr1 !.Gp=8@ơs/Śӳn ^X |q+sޢf6_k<{u0}|y䌠"Y#[OQab\ꖴpp̈klmţ[p^)alxo,L?q[bWe܍/eAMGE#70=>?łSõdKR HAET `53aNL[}y87E*PZDۙ4;v%dQUuOH2Cz&qep,9 ⪒ p/A DVO95:1 3>4e 'Qf1(AmUx1,~avݹR>Z/WdaPdbcm D0:EchvIX~cC36.aS<-fL$dXsuN_\ǃ;hB 3Jޒdک <B;<絇(D52gvc*SEpl,5(eSM|/&؂e Rο}YHZ"Z*VqU\L[3[|A]E9z:8Zo#C:(SiE1k~!O+;d(K탇;GDO|A]U?^ X>DTޡ9f88h)UF苚4e4rHZ˸7;5SrX to:a{_V w(zb6k_\ .~(:3>EQjLD o d2\Fj*_:!uDHzmEn2]S g"ݘiވf2,šr5T3#W0FpdRG"iUc!BDf]. qZa˸ߐ;RFD*8*sz=1!j"Wrm}5j,˝ڟ .WW]'6Ea=I-im`iP+?>W/y]aG 6E߷*4졋N!SKx6)Jc7.KH"ZGVƒ^ }&[DQ Vę.n(/N9UqE; "iZ.Z@Nl~uO "2SsS ,w͙VLVO$(lNG;[/~ݛx9+ e6evI){?Hjp|oX<.`rWj`eT}Ä ~wa%2Lr.%-,<wGJi1/kC FnԼӺT@,ùm27@n睔lw'}z :M͉5ƕ:a(|v}06ϕvУf͜| ˻a&>fOPT,kNm>;mS#4#T`fr!1iz~x lł-S~wrj6 yӽoťHb+#Aӗ$C.`k#o󥯔aO0}^F\`- nXr۰t=d^Be\pc7jwK̮ii_-7;zkæhRl)URO5%YN_yo\Mo٨|QdB+X%#{j5KJ8XmF:p|Mz`T^.meNy؜|1ᴪ)]-ҪTl7ê/yPv! N_y+ G1@;Q " 2'}8y1E*~8qM)@8vbA4Qh=o1Ո5 ʡބk}.9T2Frr+&2Om9]YAxR<(9fs։,1};Pn_ 2?gY E;Qb22'n@ NW$сt ]i3WH8HBzʟ0˙*䱰ժqct2vIP x#j&y p,L+)9~B]/wzޯ t|`)RZ0^ZlI7oL@|AXn@9 Lv3Y{"ub!0^w C6ٵ\ :ljJb7E=޾ `%lnP('b!ݻY3p]sjaUnx*W|W;/(y~e/Jmջ$aVhz<:DǍYH2[>@,ϞH(v .ajM^dSO$2jmn* ?IsI]AHV;1ByoG `t83e8aI{A<;4@ē,?apbj@htA=u\띖H 1qgܒR^)rZ+6HqFTg!u*-LcNO%MĽezur]kʭoBlV?(cX c;vy: E)k_֏8j%3sp\nw`l6 qU s]OTOFƛ h '[SS >F@09Box跇q:kDT.E jq6ĠB6֪=r̲:jK{u~Ƿ(qHss]u߮g`jcpp Ӈ0r"INFQ˃'bѫcv0.tF+Rɬ~F;#W:4j{xE%1O uKoߧ\ԭMv)*I&uy {eם$FsK&!M&_F6EfxH#'.BT\) rip'Ox(.IV@y:3Hv$Z`Sɛ}H8D$"n6A 0G@rW jh.C> ؀"eCeUlwQ26&}MNmt.$Cw7_uK1LfbV>fghc65:>="@!/F H2WU̡4BJax^>)h+SKa!#rׄ4aUݨsIoUʙU4gR]ɓ֩Śy^t.9CדuClȉ=C5g~ {@ğZJ?"=Hs/rxe͐ƼDRouQH>Ը&o:_*n£U6L*M\ ]P#b̖ 6vUF2;,U)[PI+VP[Tzn'{^UU=$':ЩY loi!P/=nU '$}zYPQ/{`1opx@٘㒺CҔ յz'r=ozo8Ċ"=vM(p1$RUEydn1μO*dic095 jP ftypjp2 jp2 Ojp2hihdrcolr"cdefjp2cOQ2R \ PXX`XX`XX`XXXPPXdKakadu-v5.2.1 4ג; z) rod"z`n|`edbW7P![I\L^􏁩qʣ]4ep FZw%*-sexʪ#;/5&1~sh32H3*\r@^0h﨡0|ƻ9Cu*P 4v^B,R2ĐmBWU&لeFk]%7F~IOwuCJuq ̈0CӱV;jy)R!@4J/<lUy6{[]'iD,KR\I,oBp v$6yvx>'MvǎSH>}p b7"S'?BVrA^7":x_pJ] fH:y$`גn|*tYԁIH^>xL6>BeY]bSm#]) 235~AkH:+6cTi (9QN}ya2d8;4HF?MA=Ys/P}Pܜm(Is+>0ttԍo:#J\bWnƘ0sɓC/~YnKQ [ݝsŢjGzLQ&4fB63Q8|8okNDm7qvkMIY5-+_ˋ~=!yN'z׵1D0tUr>kqJe:w@U z5YLb 2T0뉑߉'m ʽ@ EfŢmi!m|A{x'^Uyؐ]<_18UoDka*F rc+Ms>?f%PQ 1q{1YmHiy=*3Ul |n)QZ\KG|rNvTȭ^y%i ,*RXAyڵDumE6舵U`/D֟PÊNM=zhwʏL}=Wb'!l^Yӧ:md;`kjjSW8[7\a:r?V{NՈL}Cp_I_N dsdqw -*=;mUu^.Q A5އ% R4*64Jo3UΈ]rȸ%|J3|_¢T@`0X9]˯!| mi&"xFF^!@zpաo.sf~Cܐ we6bP -*{{}C郍:|(7f]sYa⯆XYfe,EՋA5M$D/֕z xгlw.-$`wY9 Xu穛0Kjj )ytԆ>T +#kr@)M;:3nchʅ ;Wa36&Ğ6'}uYְ1z7ުxB_F ǣgU_-QS|;|UP_$,(&k_1öx)C(`^ȴJܪ Y\,&!DF B*2]PdYn`}eiul 3;Dg~D8?WmPE="#P\o$K..`Md#6 pdxrqÛ[,kE0B]mĉw3zU$8TjnHB#:J}ʳq>p1VM!Y  6Š>=hPqz\! ;Buwױߪ0s ]~i|lvtM$0WԨQqSf/J}Yyp^t`<>o{t~d܁,޹i^Φr-Q:Mc{;cD~etxmT-Jx9lzLt\#~z;)%#k|&+Fٴ<$QOJ>{?3MHyGFTN3wkͯM[ "{4?RS"Cb*%sHFs2O{.w+TgKmȔ[R4=T8z/^P}Z`ꂲ\hCƫw2[߯|0Ϥre/]¾>P8JzC(g1.$֨lUۇR:81*nOsm4T[84 j, YXmJ]"9zimfTǔ>0xm͞ALD:x=o442!6H]qJOX!.39懽k gWeP{gկ } $D$IirQER.mH9RQ]Cd쫧WSQ]^,q}ᬈ`*m^LQJm䲴qT[qPdAǤEp\-uAI3)Q4vb5h RzQϊ:Ne Q*DO$0Dd>el@!>ېƅu*$PWɛdI;cZ/qBƉQHĴ׏a[s(H\=;KEfΝZKdYAa tDkr^_8!٭7o73}[~rҮ)kRǎu#fwHk>f௃<<%=n̚r+ j~aAِ<=b5 ]4{ 1 Vmp].N~ߡ,_LlB(r%r  Y^e{+FbtH%Bp+v@v;"rќICYa9Lub0 ;AePVI1oJMFaN8$  cĵ 1sc #lN`t9U)xRۏxwCܳNYcS0#"?'mPd"M=c<'DҎO7i.][Ҧl3)}3cʂ3)M>KSHG=Юxx*XN 2keI>泞8$|$`٤O-5#WG7VvM$qQxcqS loAR`a:8ֶ%뢇SV5沠'i֛5"q{ios_?7މ46B?DΘ¦ڕ3'ʡĜ?D)/yK4hV:䲿Bt)ɢeԈ yhQʢ[fG/t1g^dKL@Ɯ')˰{"*Sj#|TJ%[!z3s_ra12 ߗ@ UJLG:WU!kTxڹOl@~3|Z]3T"_"o=x8uIt.[iJ0&a'7Ǖ!s5' &h?TwoB*k()I$;=/[*,aT 5w'o/u^F:λ2PnSmX4axQZP9E쀌+m4?IKURBXئjks.7M*?xKWL;r:Qmia-GSoĥ%2ߚs0 sNR4Ȯnf6фk<ݠyL#Y$=z-[,gx.HVbheɅFhh%ﳘ3gYІcF]UW Sz[;N|K Z;>?Jf^CbwR9o:r2Mhb {_61!Z0,\bnE|a%G;}8 &L:”k|̀$Z% N@xA)HhKyŭ'Ϧ lX_5L=|*e ?%8 ȼ8{sæTؑx;iw-1Vu*J,"<@ŗ} Ra]A^rbDxFS &`jHQ E,lYh4r@ MUsM}j]+diCRu0CecnOMeQ19 ڍ₍o{f5܈:yvul+(h G 4*O@CgógBD's:79 la  '^&AGwW,-FH؇I:aLQ%B|Eq/0TPn3I RJFMeh8qёTYE^![≑$=()H!,rƲI:9_EHH6+4dpKd86Bt0m|&kN"{1rv>lD#D^qJ&ՀD j<Vm&@^}Isͪ[#m-SvaU'q.ykHORUG9{# aMKelm`@l|u&#ִTB~OgC13rY2kqdѓI06P{2'А#Զ ^SzT-ZjU` !‡{eaiG$ŧHc!c-[>㒬zMP>VU/{]fIPJ_B&8Xch\- -~JbZ^с|6tu+eƤE n7ٷ \P/!Vi~Z|>ĿjUTip]$~Vv z-8R7rst,E5} B3ү_?Dc]Gg+m]sE+_Tv 9qb.4d=PxFZշhYL&#Ot(r GTf|D%IBSIvqI@o?%lϗY@gV 8niYaBNS|CZe(bsb܊K8"ϾJ8ӱH/7H_Fh*m@M^HMaNu351l]*~ \KUj],{inNJ'JHW_3l sѪ)٣-N;]嚃 989'%#3[-7XAG{hUdM!#sY25ݩG\ @Eӥ˱ xG4ōkިDpVJZ4sT_$k(.8z N?*#A0bey/bBwuT=\Z,J rظ"\S_7/;׏Kh*l !ZX(@x/83ښA9HfA[8* BLCh*J m.|~ĆSɴ IWkç 7O<V!{۩Vmeq'`!L<`$9ۉ= {2*#ҩFk Ț8^ޮle@g+[q;yue3PoXk"708'~(ؑWDžꣲvfM$NI.~8 !GHnԤ0#:*N+_oV*5J9E+0ERßKH#+PG]d'j 6g^RI$SOWZ0X@Xn<;s$:xfD8U,>jt3ݳ5"kƴ:'LD)0ҙǪp?wg {c,.p uߐ7SSߴfލ94ulg=q朌s-Dd2W$.R̘/J{vu͂w(; Q620iZa@#'Yk™4zGςۏY{53YܢimXOW=pA694X]i4n/tČ7=?x,=1:T/brиt$65,^L9~c5*t[ QI|s,Ea0!6?ݎC $u?G Ж))`X#wgr,^P|+܀>{P"an=Ε]ex;G花-afffffffffffffl*QW|/ys@(r*qh:un4ww XBNk)0t|Ab2~Zv|G\\p 5Q\2x~$r;ݓZ\),חx9 vm,=eh)I5EL"ajnd%y9B?24ArSv;m P1cu!?FPrm' G<ET4:k#>.wʼָSٴ4MTEWPUD;i͋\,\ݏ{apP+r@B0^A3|^kmL 0 sn>.h ȰkKΟͰ'-ݨ  9$sCvwŧg2bGG9zeAGR[Z,}\m.וеǚw'q$]8&C:Ekl-p!٩W[ݡ^gS eل IYIeBg2 Xď:I<7?f䖼z?,ZMp3ܹJۿIS:G:sR&Eم6 *$z)Q/-j)V|\P#ͧE~7xuOl8zyU$ljZ/D8s \z֖ܿ:hPg{>=BKIS峃&RZuYo+諾ێY!%rd?'L{rq U"L?(|ox&tC4g7r>6D|Uk_)$h׬-wffJ׿ʤy)'vxmND6YDt1_*xfܧBBSŔLzF+݀ġ_BѫPd'j|bK7OyHoVf_(#*O(igODHý23QZ~ʬtcjq:[}Pi"LbK(iMAJJFɊ* [keNf`큝 r ?u $4~plt,a]ܖ\0):B«]<~C!ƄqNSM OM  ڐm>&tۗH"d5>HQ@4>ǘ]"j`7uuJS洃5z л[2vNK ["=/p3چ;Q39>Noh;!uE(JR_-3m}O ` Y0Ɇ%.@B=wG-OPnρ< vswhW)"o2*{Hи @2ƞ259  M dp'dVIeTm蝳d(4J?a-Kez('~D! ˎ4$0u|6S0ѭ@q栖R#C|LO\ȧj8՝&gjEFX Ithc&`,wEgN݋]@~2+=s]kW-~;4Ij .vejݻ6L%BAQ^\Kϝy! /3um3I046ҧcW+ࡏר1$LϓNl9ZsJ" zdє+ G ٠d29YL-1Oe` .QVr'c+sUmZZ<,'sp",gGVQn (J >&礈'E| 4]X{e FO*̌؀6 \+۸)}>o@p~L`:誑k_ᗚKH+.Ƅڵh>g3*2dZ xgm]&]/'l,Qszsk՞}C<9 *e%P&NFhpgwX1*eeVR"3gHCH5(Ɔܟsuۡ<u- Qk~ms _ꔢ;]ލ|`m%op'<A_Rdg,4E^{hE.na9tԄfr10Rzٿ T$.v06NXGd: 0ģO0 {CR` 1m1B1D(NYh]M R PGdUF =pSĿVʔr]&#aNQ7z Df OB $H ۫3dUz;~`,b;Uj]G-.|g9q՞w< nmvZE3W/cBAkX4ObrQXEvC D̯>`\5rcB6GAlWLzy Y n5k>iJ};Y6)v\pi2^%iX1È?Cg0D.tqY/,k+PE-q:_E굾'wˀ |Icj7"D~YmaIv_@U` cXOz~~*˸)*fjo.6Aڕ6FtșL?ҹg'^"?n>c\'m?.W]DyIebiz`Fxt*5}u__x+A1V9 gb-[} xbjD}Sa⼹S(Ҿœ UP2~ggl#@OϚˬeZh2rXWVi'{-q?Ri0Xd·10J"FIw s/3]iɯl%gݖ k]*jDl^B$''i+DgB80JjF`YBF(x[;=Qz/ pm5|ݛOT5z׵SC$S>`;w`ns7(q~7֘hhYl^j/0m7K%uX0ȓxo"W␋qeaf#`Q=2ʵn֜Rp\8h>*JODvӟjflee=n_+ (3|9fUt#q/o/<H:&b.{c^}&~'}'̑1j8 J4&$1 LK.vLBдߡANc0S I:]VxTHk3E 7;7=}DYm`Ujays%`WHO("zsDƠW='Y/wfQEiԂCClQj>GNΝ`vH@I05pΒ;=xIkY |˜Jo/,HyDaleR h;X2r^aVG}W}ڠe\찋zDc~f_gbv{n9ސ& % HS~t1gBps{9t "q놹R:B\r7@:KFpv}RU (L9T D猺 HA9O,yd@x}i`(i;eǶtYۿ 6uDu 8Ȁs Tt2;xØg7h Ta,NROWouu| ܇Pd =A/u슶eC5pm<txh׹6&_}|' EJaeų$KؼTYtbws g]I@lp-UJ1x:` ׉y6XCg:f7=+[Є=oY );ȧusV:X)F[2Mh,spqNQ{;g^+lUZ&5q]kdYTTX"26&|- ȆN@` *w`#:)xg)GhW?=\cxps b\]XnFѭsb1q"H=}oؽixGwxgE~IB@El志1Fśz 1/rP M{ɩPũV5H.iNLXDo3G|2C(*R^R Q5K4X"5Qdi\⩶{Fa<-{P $"dT5@2!} ok%gHj>[U e 1[b{Nj9(p@ '[?BC& "VO+7ܑmyH㐬v*OxS0e $PS(6-aC !`ÐblZiqt*JIG_˂ɀM sL44^!Z^R"fQ8&7_6GrۣZ9b _#Ieޑ ?69֋MgϠ#DciJ zpa"fMu cH(1e07qOs!U'Qo_b@h\A<zk˃^^NmD8| `0vg)-2*>v_8Z&ޙ $+cx Qgz̆<[ h:DU+b8swlv#[[V,Y<|՘$?6"ݢlyoꇪq.zrSOQe`Oo,--d*p}/P6p$x83?,c@ hG62݃~R=pcE\u>Ŗ=cs#Kw5nvh4%UI[+ȄXu:S-+ɘ& Mqg0OV؆6uF,1~lAQXf@+i{3Y;9+? Kw0))bTT?\);vyC.ei&/X*u-5i6c<< *%~AQuD~W#h""Dd_[?Gī2g}Y5MGO`n$YsHrQO+(ʢq pDb M3Z'8J߾0_uMGӵ^!$ԟ/%j.߇gH 4/ )S̍n1%V2)aOzܩ4H G~l=r\ks{$LC(jV<;Toո{q1ʽkV|5A|{:>8^a{ 뿟 ~Yνwժ9t 3cxQ"ʫwbo(dׄmWwxl0hZC($)yg,X5} "{ۖC7Y@Ez>AWRf~!A@Y] z4%J(5 =nQΊi?E=^w[@+P#=oYIlyƽնb®7.mMGud{.eA ^4#2ҨU!ph}g T(uX;H$z9$5J8܁.z٬h.Ⱦ _XCg؀V7}Q;iۊ}A8U$j.Ժ3zAPL,`srafZ̬ qݷ'nAsՀ0Ջ _>&"6K ^E8Fl7~rhpE=SY >C~Un*o jˆyRC7؋m~sE0g&EHvjYٲnRQD?.Cc[nYkaMW`K7Cy/'PL@Y fis<m1YH\1,u'7ߵkMl5Dǣ8pBMCR5 Ì HĊyZ>`jWiӟb50t ;Rx樥Ϙ $@.yӰ"Σ†ڗI3* ?)` c9?ȄZvBLvz*9B޵p o8[-1F@_ ~5u6NۘPX`ɴʐu3qhF>|kԜ8MDt) f:91DӠ``ʕNWz\3y*@!5vE8uGԖCka!RA,uS (`0RZz MȥMEܩb E'8έ-ZbW#Ig!/̡2v]@&Q5H~U^sĎsG}tͪ!6'Vgz,!''܉m1\㦧ͥG٦ƄNm7"R g'#s} "QHбEO3Ku7+yڜ tHN.{3re`/T4},t:q1ё h"7 m3 c2gJDpŠ/sg5K<#;?<=W:9k:Yۉ 18s9'=^ȗ SpQ-ۨz g$wn; ` +?}Oȷ ' `>+lNn&N@"#Zsb5SZ[ʘ`'!xq;O3c̔2>FY<$? <!.61܎6ON n蔼fdH*r٠qps5KV+jʱYD묳pB ]D,s|C x@hB(k;v6{_T,Q? ^K$3^shޗJ|vxUb/CU4IC=W8Tc[` xD'Z1Sg/Sv[aj} xlFVAs>!v uy(nm<6u$]щdY$:' tfGv8S r2W\P^A EI$I${=v92srZC{}4mmmmmmtoe 9_h}b#N''p :./ihnC'zoJɜ}?௺ˎ*0, <)չgP |-rWKhnCM=$VLeiHYZfffffffff ۙ4b*'6SI$]mz2oK'%eFy̨֝91'Vbܡ)گńHjwҘ,H1IMOZZ,}~Rf ig=.kẌ́A0,<hm%^'fgZ(8iq2wc풠(O1N9N 3`}3q֞8qGZҽ<4bnm~[<2kH: u,wTxJ!)xZHvsvmEI)xW"$ PRlNz35ERz "ބZ{g1%Srʣ*XQ.  p@բS-ρ9n kY^mOܣ@tT0ܩ!c幻zcBRVo Ez&z=u9&؈l:'lFɌQ Ps}e#ZF84a'nCʧ(g9:A`Xb]))e0ml ^'ZaޠA!`!<}M0ܣ :>$GczL'n{X56ܐ@bY'"elvfMY2|** K)$I$I$I$I$I$I|D':7`Agx$v"J"E Vh>[B6ުhE.]߬hՖA3¿yiT M[v =zYc[Z&sIr%TO>l6Qi<y]_iOǽSi t^#1_B_}AjXM*̺3#ɅPjac_QE"_{A+~DmvޔuWF3 f.a _NJi\2a@efIAZc͔{)peG=c|BD/abLUP5ho^8/21ZϗaO)r V|;.E8& `w[%{$nqDX>QIM }/@C!NCDs݃A)0Z95YkNISWsل`K_, ׎7]0 7&$FCoH"U9qΤ2fɃg0h̞_b9+j(Nμ~lmXkR/o%ϛwc_Ga9sI"@K[Far;v`G2*oDG*}㖙&%*N#W? =qRswaClnpL@ڇtP?n0n=w~`@IG qeM,lDsq^wno]+Ƿ3JERZ7H35$gm9I憦z/h!$nR, QB9^}l?faF4`so OX-( |T^ @a,yǣJRnxvcp/Cԓ< VI$I$I$I$I$gɩ+ͽuJajl&H8qB7IҢ2:o_j[JUj.gιǐ ثiƠ >BxZ| 9ƖDvl.gPdbko tm>pI"-_bd cG[b+qʞp>)aĆ>ωmmmmmT*8ol%BQ/엲:v^f}n|G}30 `5l[pX0f:䔺-u\o"AxlBKcY4P@6RH趢>N{g5_׌h옮% W8hpL1zDqJ0 :3o'Rt|%ĽJ'Pmc]H d1|39uӮ1jᦤ_km em,99&2j8 (Q'YX\`%h|0:tjkd")%-"!ߦ:PLZk xVBRYǚ{J n!4shi\g6-v r{6dB^Zo{ǒ-/0!qImToQEw-?q 55Ƹ_HTS#c% (/_W3Ҁ iJ:_)BE/;BC@z)܉\"r_m^TPujԹMϛtxy)κ:VK5ztZw [y[ׇmn17qcURq4p|B+L+Y㦌d )Y睸˛%/۵㋼{ԲbKeom0ee[eڇ]j%gS7g\"{2zJe Z$D^&B]Yin;bV\A>u&%B0 M3r9h%'n#̱}Ctf,<6nq̴uHEjyΐ%pzH *y\IAE jkAs`X(,>ծx$h[xz90%LVJNg sHGE!\KIz _D_.4F|MP&$'Sߦ7BUXJL`GH_ojq1x[݁ n}V&^_{G.(UK mIO_xFeFGh"C!% ÿX)ݳٽ@e@۪U<#Lb]aR7G[P y8 Qr˷ !x% KJYJ)V8H8A3)B_ N-Sj|y/XUVj LBYeN+?|wWWKe6E@)+ѩGW=咤~nU*wҰgZJI۸ERNpƄn7Wyc[R,w#s{]5 FHC=v1"Dd-ʧsやot] f3|BW/Fq)İb/ XW-&ѩfe[0H0 CYIGJk[LP+[y!<ƌ%l[)mRP+|4 BedTM{:++̉YɃ)>ݺN w0R*d~8?hfJ{-*:G>5*>M,s8{q/P.Mxn q.LMJ1F =>zj42l &ld.)gNV.9o:d<7׌0W.\~=ڦ!nQ7(rf;PxTQc aG bH͛ f(-lP1qhiFE'sr@nN*5~[5 HOAE߾ڛLj,Qhkl%Qkvx+SPBLؖr}|C˩hӤOН7*ҜS .&]Y;8eZ4-r57OH~s P&8;QBsUB|O>XeٺLKf`o* ,sw{`.4S [S7G -M_Tdbc;h޶.ӗY,5kiY/"~j-GMb:ϥ:OdU;DBrN7ǘWm ;:QNtl[BSڽy9̯bg6'-cWf:;xdj#@ߧP*kio9m=3$|6BI-?vsBo P{s\ɞ lcHrLXlY!03m>dޘ38>̇0wNT3 qCFR[té)۩u- 5S ]t˥wHDeB'aA#@q&1Ґ靖Q].QNuٚNZ~o,OZ:'0~[WЬ|=^߫AcxfAm85Go?kQtQphHӃGޠvp߈T& X+ %*Tqc$c׏"q"I/N_lӏx/RU(gs:)J2p!F:SqPF^ DDf܄ X&Am:obnG|+8&x5 M#!H<rv16?"u|4Ӌ/2L%+ƒcchRf:ec<<j{ BX{c\_0h TlJnT<' >pӼr8LLģ4^R:gXtB G m\ lg)JԮzk9y^U<1Z!K* Qw(ûZ,٧Z`r=\g}9,NfݣkXnᗉ>0YSwGгtRSo%}jgU/6q6maמPh1KzT|N^Ve+4(ny^;PG? `KT1wOBoVgkJޖm2~ig+ wXbw7 7 I厎}W6v{)+vWWq5*SȧIDD7=^yQ.uGŶ1-Nx,FR>f߰bVlXɻ)M`[poHA Xo,H n_4wZI 1A`>S6!ݶWНvz|G Z$MG{>:@5[_бڮdcaICI㣧 `6 tu^쎌̠eh9بVٛ0gX< JӂP#-G6vqËRwvy '>4i.>_6 LE't%%%^D#0 xn c&ai,H A?g%%8K* O}L!tt[I+mF -i$ߗ&: 06D|c9|L GR{gc#Onu,~Buzj:>6-3qjJy?粒/Af ~;<cxl0Vey9F#-5d{"L@\0!Gj4S ʼnzv)ݩFε|+yM};@ccqipW#(g bIAǚL=s@̤ 0 leßUKUfR*\PߙeAn1ta/ra7n1=,їvZ,0ol2`p".1<Gೞ59uӠʅAv idöF 2C>(͊#BYwbJ#@*)ˉ2W ݻCGV)REe}8BOxBU9%KN20SvѳvDwY*RQ_Hqg*`IoJ(tuRT\Zz\5{ OcvL•ULVs3ߢGH֔d!V,[n$YK2|zݷ҇>$d/(g$׍2p  Of4>9l2vYϪ(eX5zSrQoK"jП:֘m 3. G^\ fT=ǥdEo1 c?z:Tmnj U྅_Kp@MJ7~BN_x kZ@W}/r^Mn}JbdSρ n R+mߔyX*2*`Y jզC@v렗WE5@#BI{+d}5TZR*C}s9^E6gTq7iP>`-!F L^p43ʁ@P)4=3+4H[M7&Vꋞ$5h?\WA rY{ׂѱ2ީPU+dLLo <6g9cp1oa_ /ѕ̄r? ȄU2G&#I&*'Y\ɚC8hRKYL#%)-|9ӌ w&|ϊi _ $/Tlr1Ȗ2.Ԥa̅e0JN;K`T.u v\b5ELjƋ'ĩ#jb*jO0úo'+,? l*9)i}Dd M!8XRHcD%]Ojs3Jm`>/dsM9ǪME"TbӄR"N(s->6#lme;?MU `'&C}y_[4Z$W0អ=X/j$|M5>~Aָ~|_@SY\c csyԡ>T7{ư.H/#}~ JvpXRhS{< h)U*UMBb&rfÕڐC7mi$zgqo.O!}^8KpqL{L)AgK/;Nk5Юa5iF+q,&M'W?#?$ku +#Own5\B%5?t`hqJ-Z^ ԸO.A&& K; \a g"CTr2Nudظa5(55 Ќ>c愾RoV N;UVk u[ D|q;Mc1W),AHd݂5Dm)" grgV4eRrճ-7ք<[ mχ}8+ M_xFA=sZNVr6,&gܱ27٤/XˊT,\~@4OIZвQ9]¹y(2W'ӰhY9(M2BRR$5Z|pЭ6QyD}Ҍ2@e4q0ǫpyF#*jg0 sOX `ߎ^k2Ypp 8a#Z}[]!)[ٖLHl43N56KJJב2ƥ9 h$8Lp&jWOJc L!HV` % 0$MYV]Pbv֢7i$0$ ZRCtGv*!!l+acw- ĤB+ -6R ȷro!<8|Zp%c(۶)J# ~ &ۙjZ\?AO4܄GX*÷a:2u IMnp#/ǡ 0rM˩k˥kԠ1P Q5g;>hMVW^}ɸAUwĉ2 Wcy'9, *ۍkW3Kۢ_@sd<}]3JMMۣNv𥠀W뛮)_"$7GHq^l m)Qt :Hx+l@Vd+%eLц2. )rNr27kAVAߣ^>bkMԆRo)ȮӦ,Dl]*dM >Pmխw3&[8悈p `=.~JHk6P U ͫ*_}|lpH;鞱(`|\>F"nͷeֲI { FmcMVr본yZc*B^_Hi`f~)cshdjÂA?(^;OSh KSBW\ʲ}ld)UTۜ}G7jI'wt3ʷ xT0)\u,_zORp"c):ܥh_Vk`!p̿ar&=Bu-O0[i(sSC؝>'G* +fk^)+ds^L,*f-htK.VrÐz1ZB4w5x%ׅ"pkn(#C7oBޣ@X225_ fKŔN脞\Q'r*|߫,-̬zR .btOX=n'BؗHo)XIƁZOo n aÁ N,Yn@?rpOci牥<|Ʉy&jWS~ \UV =o#ViӈPNd*+ e,v! "iBKD8I;|޴mTvZ|n_? _炡46?ιQ B#FwV6p MQCtrȳqz,g\A\3dH158u<1NL෵A Ф M.F.8R."ZpkWWa}uj8 »:. Ȑp3Щ$7X)~W-P=?&`@ pM5S~#:)Sb2}JB犇8CG;ߤRtOa=SߓެL4Aՙ^ٻL4h&\ BHpebK]P#Ge[:5$'TsQ¤rjXh#|(x փGnQf=hhF=Z#({!q2kN^Υ X;x| M 4Xq+hw\~E@oaM ƌPރVu٠@n;t}j}buX 7Qw#]>:ӎ<2,X4PEJT! r uN-MѥdY+8g<F'X9vm!znwHAk h{ K6/({NۦHp,m%TkGEC)@~uh|CL3vۦ؏97J$XuzR[+f Ih~<}w|7/ өMτ*tS[hA`(1Vs=: |k?f'Ti%)/ۆɶVg>axƒ@ }<'bHt#5W 6f)R8[T/տX-w3Ы%1Os!KimJ˧r lg}Uʡ嵯Z7I3D3b0'iQOq9xUpؔ`T# uִ]{PU*9WR.l6 an?_*9 ]nG`PsD/ @$,"8wbXxOiL\ w꠩e]T%R9)4 woF8C/D3j>- JCkul0#9[o'u(Rlڻ <&U'ecClЗGu#!j(1 wjqޏ_A`ikx) <hiS%^mQ?7uf!x#{ooc EØKx|4{Yi#2e2Ьc۩Wlu\1]2r_ĺHnd.1lK%Do.nXMBN$(ku=^ @~{1-RF2ݰ'Сur%<tYa;Cޯz'UKw9|U`6>(~ǂ_iiWQmnE;qeYIh[ET/ۨ劸%1y~HgF禎ۇ}7oT߷9w?Gm[۫֏۱^?n3ހ7{oGodᾪb_[Q[M}[_۸4?tt lqJؾ5&JxFR1F(bct(V4/lZ UfИM&V'U~`Ž\=J_LȵVGjW'Uv1ٰd(+K(=q@-ëZm.bYe$R>ð`S}ٟVNC%FptuU"ZΗfVV7s${<~cc(( {=tz 2__yq7ĕfg뾖y9Fl{6WGڄ, =  mgzP2pagUD~Ӓ xCհBNl##,n1Z!lzA4}TCl CMw N+a,L;:IbXRMk8%Rl%LLvcL_Y?@BIyqPw30F&uЍ%]SԹB@ō?FSI41L4? JH_PDϪ0f+p"2_;\FÕVgB_%J-jƤ* (SRop48}vߖ =Q%MZįQ%G0D~(f̶lk.`<.h eK%*R.h_u Ժ"X'rvg?K0sRT$)1"h*6+AJp<Ո)9HF)6?͑B)slO 碸ߠ >vhW]Vć-rȒB;P_0g-9L0EcU|X!] 8$O_}}> 0혼x4 zPBm˄YA*17ۃ VPYta&~( mNoF!|o c!rn숥&  #Y-?֫Maxz6,L:"π~?Dl8F||<@)fxP¶虞[;A)̾bRo p2\~޸"|5К͎x{BmzNCVXB%'Z&c3Х\ T>t ɢ:& ,°cx0^aP9Ai-V\7ɠ2qFms(VyjZ}Q++~/2c&3@J|Q"RLmv7#S3?R%>i؃M 9a/^ O.F)yN(jj0(\ ܇eP2rL.I6zmAdIp@^87;ݾcs`D ehftPԓx/1˭tFDTpxUg$|GFawz𺝴wQ"gU@UЀzM6xJa`GM|#LW)dߣ]MTl cz?{kt+not/t#PUP=lh -DHcP_`_Vܺh!;(M/#ya]h1BHKݜD&UеrM@1j[B/٥p$FV|:R,BUjPMup`>EP#9s'*'!2(h揁&4dfЙ>.۝F:BɢfjRk>7{([e&UYM'sNTdYUnL~>p%hvȄز1㸉9|s-j;f£ꓡ&i=CL ^NrEłL(?BԾqr&)ԜUgAH2 nȯo;嬟RL`pye~zQpLe0cX0Hn\q2:kXDؐOp8,8_#e,n46>K%?8:#R^#>.wu|Ќ#joĐҐokZlqj "XJœFՉ5i5x`O}ٺᝢYnnM+s:#_jOϿ0 KϲNXm< #v,sET% &A mS ˥]nm~Yz"ix+!Lz:pYnP^}TN>E7ZvR)C&g98?sݧ9UdGdGAafd:6HW=zgyhnD%jYY2mD%) 7kbS=J󧑑iUţBLP6b21X5JهK@qf['-)6Նx tyC~pµ{/q" nZjS*c,G0Ә~^\gHB9\"۬ 8V+ %8ˤwMw2vIhZ@&$Ǫc P3럌$l+q=1 Ɠ}H"d~f.q<{) 'm[W2 FVFN4YC<`"Lmz^ \,> BJA`PufP ?1Q60SepѱdԦ,B"@s;j;=Ln?u)4)`T%Qە1x5.SIJZǚ ! n/KUlN ~6y1ݛ4#Z? v\Zt$Uo!7S4Ƴ~"xl7d&K3TNIU&X_bITaӉQGň0.8V.w`SaP~>cf!(A[6vr,Mb4YCDJc~J)SYnd`i}TX~fzHk.gi-i׸v05eV١I-QE~`u"@2JR~/PD ׎ifE`jFw3u&PYx%6R{ /tDxqf*)] İjaNjQ?w>]Dp (EI\)1}IS4B(:C%ce4L-$םvRo3 0hHv' "3svdD,x~?x-~t5^\ T՛qƍ*-6N*#LZafeK2r*+׷kqY˵-mёv|^P咷 `cGR멞#aҔ{TJ/_~Sj|7Y0n\ +okwG}^h?XZLՑYDYԲ^ԩ⽆5QWrcG͟9۠,o5457U;\!μ h%Ҩ%L/Yn:ad>"Ю!I.ިӰY5:]2FM|Iٸ/Btգ@KonQ=w"x`d>6M5iن-Ŷ!i؂#Krꚑ7iZx9ԁLxfᴫTJfJ]p^ ]aN/8113$6ʘȘA $MiH?<@P5ל=p~ #hz)0$mۃ@6:_@ (o9jtB 'W)^_ǣ^^_!_Ƌg9x'<7DǡUذqj>׎:xD=>e.Z$9VZ@zچ `~)4 ׯh-DCQ-:IYHdY3hK̜Y.RCBߔcMx4Muka }qg&+R*0xwC@XBEwmHchtk:KWku X|4 M5: +#IOKDh#}6촧=IhQQJ%>v$ks=V}8"_U9ZŌLiTJ>," XЇQ1 ׼eOG#qCew+Er#G*ݏf{/':!H ips Q6 G  ԍߕI^%SUX)n3L[@<5:p _$ᵂ5LW$ܯi @ oSax5){|߹ Myf(`|l""N_gs;^QtY:?:m $4 Q<TYd8o_W]My92U]+R<ݴkTj ZK7 #fS`]7ߜenSш5rW l;-WHh<h/9_6ѹd -:2iwrg1$NQog⯇[`C$Y!„q/wIJBn 2tj>5)HC0|fݟ-L(>AY*EAP|yenoыA񫑫,Œ ԏޑ[3yaTmB wW"k-5+|Kćٲ\#fn-$~(cXOI!H%A~b׾Mi}gH$?ہɴH,XMG[ }z~pN#d|u( ˌ@-zbfBmgH+SϪD5ކמބIp0WAhU: Njhat܍x`񘻽7QC d\/Ɇ@6,.GO_hFꡃ-Cnq*-[i+I= ;#:ىsa] / &vR"2&PilLp]2{F::dE`[r** RN~I %^;R)Nn PsyeH[^ٛ-/ͫbNTnp7u癷Vv.7b_NZtUSU\i[@K g̊7ϋݠ{36___G؟zފ9<Ǡe b`r}E@'A/1LrߕFZVTX4<.-euM--<(-GA_. N)M8u8 ըeX$D#B}֘#=p=_ bqlz5KN1n*7ָ? ۯ n4Fvz .r؅)t%gTTLsFSP'ƀHZ[)yC^0H@MI5ȡˢR㐅p;TJFMa4}e'Ie̕u'O>V 8XƖ@([[]`DB, h1>Ka3of`cd٭#7S.wm-ߺ Ϻr,(9#oK ;,Hr_Զ>\ngn]~A:sؐHF`K#)ϧez؎<s}|mg";C\\h\;wU'_` Pu`QPݧ1esdL270-[V0[,:iCS+2K3,Rq3v}]jϛ&Rc/RVkzqƛpX?Y{`TE巘3iSRjXt39,Xd]06?ޤ[G%At(HU+ {^-}I>Rp+]^y ށϵ@^cd<䁙/ȍn˄Ft`+k&d<ۤoa ӵ[ ; ì7%iU\DTY`~VEI,cS9M6D88(TQbhxZ2 ,ۉ߱֘$h\ܑO]4BPܮA6Heѥ01J37Χf4j;pGo,i.w ~֬)P~S v$'Z (fVXRgklzbV -^knʖ+t?˦=4(T8@+z][:!3G9R%GEۇhN N8)&GTXjʭf Yk'3r $#,  HH@hE_dEB*`2%'aVQ, Q|_-ogKym wщSz v7 EKv0èl2TN/~v8EhW [OМАiGY/o5)U1nl#8_N3]qVS 1d8:e%&`u>A<,}+G1,`i2lv #iJ:~"dKaJQPlU&'9 #p7+gC񰖄.YS: 5 `^3=iki$B8!cND=0V ,{ed%a/d < FS/z Th}8g:9?+Z}jpt__jm 2ȃ®UG_H92i4H8LFAC QE#L2+':j,Y\6M+`̎<[MNWLu͢D3M),*q/݃nG;ލ֙}XYTM4LBcۨH'߻2q1R/C,bŤy~KC''A?BgzTGHAS9~BGuǫq\ ֳdʰ!t1jyuEsʹK4@8Y0ׇ1;4x^S{CE}s$l@Ŝ$:4R>C?x {"':nI\ V >gÒǨMC(@׉gP?Oøg9m,_ I"UNkq(.I>Em))ț$ᛐN]3?s)Y9]w41й6O>^4y61[1A4aȩ|}xa[h'x'`l~ 9|0J {2 5\<]0zO=tq!8vӛ$uϫxx-^w^w"__!DU;6>f"4ا,or_O*GO}5م_hv9ivuHSM;ŷCC 4Kt$ݫ#]/mM 6|qEmjo(/V\%{Ouf~*tQ ѩFݗ{NA* I1K5%Z%a.~~ :RN-)+BT)b/2X}Bp<20IH`e'ThS$LHAAnXS\K ı40%Xο?yfLfpAr^=K#TjErJY䵲brk<M݀D6x0 ô:MH}S{ǫ>Ί6I+7-!9݁" ny1 A, 2xFCOsup|<)Q>@_-ÛLMn jJY0&QL8x7)zGVMwdPg%/rO)Sq?JJy+80d,u04y5f=0f˰4:0C"RhfX##r=DT0\&v|WɈaΞ&;9{N :#jesdJM^x]+^ U5H9I:)O|$j \*N_w]L]7NiAHYC2*omvF 5%{Rzyi߇t |`& CqurUd[qPg^6rŜ[|'UHZVzS&zy#DDԳ!|QKVucYf, jBDŽ7j:+V'`v;xZvE_kБrYZ. 8uߘ)I|MSsl~yOڕ^'k젪VLF-S_zaTˬ)/ q O@';RLy' uZH>kKbH~i>6|B=һx;K9Hy8*~F 5 Ŋ0_$zGo<48&eQBs_fP1dh5p4*S^!nk<KR#Pq \Y gd[PE4&$ A \- XR3? l!Kˏ'nb8@8/EMˊJgr +W /؇ k'Wa}qy[|)ew\BU| a\<3(Ws>7Q4de]+'1޺u;s̓0tZ)&P?mlt< {[Eq N= q~6c7l++]*#Jx&C/~m-ze1qnhF'N- Fc9[a?h UmwCQ10 ?'([]mtkpcUV} ,Xd34b @Bʲe-pcM$*w~.µWS|b_* \ a5%̜ ޠޅ4w,)̵,3 Qm+Udi(@Km!!&i !3l򆪂Q7{ g ~n":FH2L54)s0.q]w '+k{͇cB<8DӄwNyjծyE1#w?羉#8KAWQ 0CW L*+MEe5'p%zl`WYT_XOaaQvw 5np)dU+:W XEqD1vr/0i{8ݵGÉfgBui7 P7@(<< H,ݦ*5\ZԘ| ܵ|ۧ5 >`L~~(z671X PhT@(_ۍ4w+{ XuJlUDv|@{}[-!-d]4ұq8xI rNiɕ'`ŐŚay+G>rJ>A6P4wkDM #8]mDnjA >3G3sP1hՁ9D`@ uH{W2"Z% s+"n<"% 23u.[B!.C^9?Ҫƅ SZvSTQ~ȷH/t6ÃaGIHf ( )m+^s~?)'FBjPK[w*!54'#"DhP>J0JBR"T,Ry]Uw,Str+9 wA-[f?g@!cf EZ j}Qi畩ܧ\r&o2C뺜-h1>DD "=q+&m̕oa9;"Pc;3_7P?nIquD|#|'bT A#X`z cEL$^Ռm$٦qY{eb>6Rs,_B/R6f#I}7;Y~z r5BƠ1hDId$l2TX&Tpbfԙ8 0dwݵ/{673 njmr zZoXZk?*Q@rP.aU'xӬG$s(i[# HA݄w56Vo F*vիk[ǩUYf>7C`:o;csXM6 ;轰K(GC1V+œsȑ/CC eeHA{bj @0jsJ}(ajZgMtƗ]B+K:MZ%W;|ha/y$ԘRƀ .8˲0PE_28[SICs<[&'uf,6鯯T}"#f69u[NbZmi$-.-dJfB|^,0)KzfNW*fB *>k^BiM坿>LVyJ17p67J0܏@ɃFvCPh )OD x\mo˄L"қWVI&f^pjdڳDѷ%N+LSʯ_$ZJn#t4pz>W =@- v+*M0U7VAu%J\8e n 2_|۟ޖ0P020:'oOc8# '^  )r!j8a!;# ,Ln=$a5&+gbzeB^y$2C"H|a,@b ]!BEȈ3e0PBQ0Z"V,%Jn.2y# Φ1^۵ZwՌתTvQ a z?J&1nV|䔹"+:`QiZC% ]#+`=FA G_&7:KLD'7T3f.(BRO3%*/(vY cx1ag$Siz z2EņB/_xLjvHG#cI_½AEQJ'`WL4 #ts}|vj(CU33D\^ 51dOx3]GvZ#Y/n8sQbm ,\B K8?j&\-KUAٯzyl 5f%ߟ*/j9H4]UǛ쥶 2/=/UFmlREFOQ<khC :%]F SZc&\LWWxX'tşX5Qa4jO80凂_NDEшmpXp/><(ғ[nC+V768 )c-:>m<|=l2+dmX '^b4g!:%4A>O1i nHS6[H(<JS*>M|(#l؜*Tsݗp)+ȇ̓/!n1 0*"%p' QɫO%9Ͷm5ea@{ը5VQpWׁOK*kP%?{\]= br(v{qB K=MR\UCYbܳ_`}i'•Jg]5^udULWKOxQ3ͯR-ؖA䅱T1uy| ڼS'<*O@0,̑sHrP81M"/a<Ğw Qu\l :i"[b84(м bz?, -McϷ!uDc~jf%]QMUa_@PHY`"Hp \0U䧎{($R^}9 zDX#§_xbc+D1%AEvƧ)ySjLӚ,Zם6]Vf*)(q!SЫƥ1]^~y>W$@ T7`NѢ`hZdf&R uߓȦk;g=Ds6k}8?NJT =7@Xk ti/2WvEՇPHEf,{hQ֘1)>oZ(۬Mxʵzoni)a2OGrae. *ӛ֯k7f}0g\{*c:yJB>lÆ'z[u< !yYFVYUɒugE=<Ÿ^{"4|ZK=v{>Zd#\\ayp6GVe`_}΀&d.fH,._ި Պ/8qj/pwqmBr= ޯ=_CBd%ugB>*ȩЃ3f /DwX3JX55TըhGGE맷g}GſA  +wQ3s_DfnĈ a[J(ژ.^!|Ws̀?[oy\9w.^jv q:]ZKe:dPp~s3M.rDJak29lF|a$.lok^龍Ęlg/Fbi| hĤ㌅y1v0 ,>J65bޢ["5>Q3:["5veB[!V 5{EYy(hWl| C#Ϗ7QI3F7rfB >o4’ S.C%ǝpo$8ucDžls/Iqz9pF;"\4b|eKŽ>4{awEkEJ<Ͱ{&kk ˟YVͬƿ_I/d3bnJDu>)b&exV6/g&`'VkƽND#7$}-bI3eeTDH4Bv)qKER:f(lxH1NH߲aǔh4/_N&Ԁ{ x9e[xjR f7+-5*]v >2O,] r/S4Vl7\hkesBJQϺu){ G+A>̰V8SoR)Vfybnt*OeE^qIf# >.6~jOCE[={$ aprw1 2ߎv\zcnɷxEt8A~QLzdjQFb8$z7O~N@O\6AZK"KQU9gK G_kF2VT H %k{VDc*!` Lu.8f6Ҽ/!Pnʺoƒ׃< # 0@?Axj4X6v#2EU[JWwِ&R̷-wYoy8N]}I/LZyfx+OBigîO ukOϻ>+\{gXYz}]pQ:|;jՠϽs~~cg~{ͻۺ|s᯾Kgê~}߿Ag~J~4,|u㏅E GbfY8w=k~H|v-Gٷadn)L@`[ v_-_\T c]qjT3I,ل8͠AH8qI."9Mdn;$C(SZakeR0amnP}dj'{v4nTxy6GK+zR{)ON\}Fg!:g=SH"7ީxy`ҢYx-]>NοSNn`_NI`F$i/b`evq@D!b43:9ͿfB?l IpE,$ǾMî륆KM7eÙԴ\ivroYggXz*ȏpM%~T+ I$V KV\Ô)Fy(y'J\!ɉ;sAdWj ,Kxc;Ԟ%FTiy|B<|3eQyq`ɍ%sٻ^VIX<\8g a?qéOqm6TGZjA֞Bgj,DGP1䵰lVc$=jaAzoB@v?^i\-.yĕ#9}s]J[c9ޅǰ J|ԌV|M,_>LfOb}bKaLx?|:Whɶ"ԺtΥrQn_\eMfCYj!ߐIfIpx#/OIs$k˚PրoR%=V9A=nJfSzEUx!nMnIC &)4@/k v 1CNNP*?4jWO@\['GHAR<"e}/pDKGR b`(OpFCӳ#-11IWf]G:ECgދC+.|[D*8 5:Lk 6c}u6lZ#WwG/WGu0lUPm+[C}N!uA>)ޥ'4",놸GH|S4?Z- ]&lI'nuB<(l&黫qt#=7X p#Qs"!וэ?rȆ%E0vrI8t瀐o(mB,Ƅ%q0k< ʦ2y+6ř隗+Fhx7oL7gꮩN=[VylayϽ  o`bOz>c{wK6n{԰. #DdvlWrP ۆ^s$׃hA]g`9SE== NWFDžxcAoF7n *s`ÏJ}s7~)GyAAqNhҪ4܍BMԢiϧcm!cOJ尪 aYVrb|f]X_:nC̸ gEf4(U xicc2}C=|傤䠰> *w0JYž&8iE@ZbT٬, RzRK+7PklphFixW>e$|Nō>z\*[M4 pVLon=Gaj7 ൜ý2WP=Jk@R?Kin;WTm 07yz!"kղ*agB3 (-ivKھRlQ9X۠ ͇+蕸sbwo(ua瘪еΏf0~_ӦO ;z|w/ܸ jGAxJ N*Tr'a󷃊]Cr8 MG+M%{ٔ#?Gz)^6+ I^Vd. z%W5FcWS2xdWk dDHVR \a1q!D´Vxh!.!{&B@4E-k~I_O\UG_2$EnGc>U!ؑ]Xf tw-Qoʺ}KW|tQJCBn3:WPfeцΨd@_RfQ'UHcsG{9@ISKie$c} Io CK8-h d32A h]iNI',;!Ԃ@>يm?FߘEYNquG[O9,01l4Ϻ#]aꦰi0-sHJ7K Fbbl:8.K}0.+* 9d[G@ h#.j\'R ߼E껁E?KEٱ=XXxfH |,@sNMFd({.-H\ZO@ߋ"c$eX49`\Eٴk!-Mn (%a~ƅPD,OakF1=a(KFO͜t}ShE:::ﻪwU"ǫM%)٧]ܿ뿥W`A d 5D$ K2Gu8%k-FQW(T5m!$})N0@p.pVH^owZd XnxkKW_ XRe6(֭:ٻ\7d{!hr\F ;Cѕb'G#eE[~fBeYi>4aKO}rߒEuqfT\?ܨK39eDVkSH:_}kJ7h~DkI ~r;|.p?5CL{_*xaQ|}ASY&mv=,9-*(ca,OM:uu7t^H-9\~r| c') 2%BRBK:/d=O}O&M,ڵ^22%౜M?jPA|%wUa|Q˥MhR-10aˣtdpZrv)p!oac_v2菣81}OL5 qI zj[dNHl%.2Y#\ΒB ] 6C%ZS_-R51id0k]Ch=HN"I/aD#WpKQ0_Ȍ%R)c 0t]wm|U >&mC}y"v#V7 k #b8(=/i @_bTdH<*tEE [oWṶ-]$$ߒ0Pǿp}-Fx#.,bTЖ8K_紣s'!H(5R9HN"I/mD#WpK' XO7̨6!z]ČY0@EKط+bF Duۙ5$^ ~(fr@h0:G&[d7s\%~p?7`Ƅhm])?rP?Vx #d2THE bwcFNYG^)K_e+|DO'ĽHM|NFUh+RyK7Y j }x5#mW ƚ |d[U?tFs!PcmQk"g@-?ibg4vs=o ]nJ+$>닡{!D_`9{ddjmplSx;¤k쉻 tC.K[4xST tNP5O`Z iB~㓍 &Q!SLvm:I%_L P$d X[߀Oxy,?L=D;y4ڇH%;n$L|}b)v LfZttV*iOo܂-)XW=]Tx(%)V_  Yq9]&2?iY7HmR?K^3a0pűɝGygHS {SX:1{siNԵ7.@}g*h/ =u덫6Y2 g+%@"b!~ܹz^쾑(dcSP S Hsp̳^N_xH3<jGT)J;Zvf6g^ףu: gn\-~OAR&*$GL^jl=RC;|nM t\3=^% 6Wfǵ od!kS5*?]H&ϕM֙ͯ@3c'rӝo'qpf $p>L"VSYrf5r_E-\R޻MH9٦5BtZ?~;=* hT 4%; DX > MwR|KD9l8xZǛb*U)y]!'E5,<489`<^n2/! =1zpsЌ D9$I7̆IH8t1CgUKb~F&EHh"Cƴ(xW )~ 2[ȂE1!N0RO `pu\#ptQb|0c#3c;ǓXdzwlTc.Oz\J|,Fi080$~=>+5DdH)#dxk$ i)' 2F[10f ܤe.q-e;&^ˣd`MK:(IX*4j;8""jBnkJ@n 9[w}qS r/kQ7*_}W]lE(* `;%k"luح7htsBU9j/l\g1f/EF~euJEyOkÃv*E(`Gs]R9r1( /A>Ԭ;l9g5r/>,-akr*v8!v3t>13 VYG~!_]xPz̝Rpg\Km}oMXBv+/Q'"5'p[ET`\܎ÒM+XkSW #?.Ћ]+^N4au G;nʡ?`y$Lvؼ1 Y=` h~k)<C{|zc NLD>JsfZ#c]\pFxɟa^65,AxQg,l6w gR͜)~h]#;wQsXW z]%A~}UcKv cN[Mg|@Y& =FF%(/ ]wbCp8vB;jCu%LiI%,C%{6KUD )@IݙW?!0ҤF1e Y`9u{vǤWݠ4EPS3~n 9޿%|SۧX17;]znMssى@+)[ˑ]~l DYS3KaI /mRMGIb6ii7h5z2tp Bl̀x1eoA ' ;YREdiD_^3\^-d(vpG8{u# IO+E4-Cr@֑`Fh;\ph#ex d?r`;]f0aV,ӿUN,TUo\>JF= h27Ge AyLIFVg~8mEW1-!5"RߓէOx',*%> mW6,;Q&gX( o;ˡ2 .6.}ԉw"A:Ƌ适p]H'0a2$lGTi'}sQBezӴu_9mM:? w%Ke8s1x ݰs&#Tw֝m?UADN3L./}KMd>QKG:RdK%NEƧKF @xoMo͔6ܿEGl%mR?4dYS]E@X"WtT4U86ͮ_j V*Yj+S 1[_Bm 궂’90ﲬ^ê@x&ɏq #ϵ0]r -w.?l2;_&>mlϴp5ߪL.7w}uv |::Ǝ%|jcxޜ?Wi? -yK\"MJ,.bwՉ!3"MԽE%|`P/z oM८&4A N nfɫ'#x+is͵G*!SNw7D YZHwZ)02wN 伐I%Q/~3f*Qk~QQ5JKYt}@0ka$i,#bԜ=fߖhLP_)Vkp ("ޛqpAm|7d{JHg#C` "z"238;^¢폇sǝc<PPk7SY?ثepF?2܏~ ӰRttWp8"܏gYmy?&rl,~ኣOmDjc%>>hV)cxP-V 8U \ e{!+?y}I/˱ à|A'GɂZ)[uu #BοŞIXؿCNo6J Ca8l[NCrsJ@ E帪]n@#O>Y1\iMFR+Sja'e>䲖r_ǩދ8*wad[\5-2t6}m5 I S2d*((Qf?JAvS]x huV7Ƕʽa#w V pJ~]^A{3eJ欲4LY.09l$׷,\i1}˝^U\SPnz6Xui7R54P ]KE9kܡK9 ?/ԥ~>nNԁI[^./ WNۿBh _wnYz( ­߹ .fFf&%g`1D/4$,.aaI4X v?DP ["9O0qJ>x%ɮ5u-r(Mf\WN0rE?$ /fB@7.D0=^h~N+gye.JzakF [@;L[oU](;b6X(w~^Ij SS噰Ꮡ8';gjՠa TAeAFF3sN$JMWVOڙz\L4\OD?FIҸ[&g!K-#oV]9 H۪d[WV5GT5 3gQxODS`9 zg=M/CmlWZ>^O@d< ׻OZ)5vE jɵ8Kl }9CXLsIܬ2, :Lؚ(9 LQ1 C3 0:J`v1wB*->_5붛3McL(m 0ȺdmCUTW`=FcU^e-;C/Y:O&.7(Yd/#9䤞#s͉'= a8rs̃H[(Q.^a|~aHI4FEqb Ul,jybȎ$SH 1 QM&&7JxyEZIͫć$M~*qsoR 2{∶.A.뢠kb * QGۯCGFxrYp\bs>2yx|2\> CZBs$eˊP_JmjDG y{,ډ.'EVY -ZߒAIp@,) p}v :Ҽ st\nyx uIjKMwxJ9c?+מM!84O % &SƓYې ^zoAo8蘽g18ỔG#gX5 7xjN5!1m]hZ 6UDዑҕp#av]Iak=?r1N IqT`PZ1ǡY{͔dr7WsRJPoe!!%Cyqq Fj_ B0ҩSsKe,'%CE;`^P:GBE7U֢@ca_ZuXձ 5@ oYIL?bKDwQaZ j*Xg3}23QYP-4?I3=$띇cT1Z 5yVdIA# >b*| F U)E4¢{M񄡹 Q'^ EAts&vLt ͣeSA&;'d8XGuYXw3szd 7f|RX.+ԄB,&//|9BsUWT|ژEv_7hAv.`H nJmF9p}3sL T{VpØ

,LJ9ݠ=6Q:b0|2P_{yRy|j.9G+j :Ү7J#* oJZ2@'L\b{MDΫoR"WE v)і/%^+$+?Y4iq * ٥xu٘+3WA`ոCd b\Yu5G;KV/*y)"lD /ѨDcZWq!^:YQ NM+X92sa u#:80Lk_^SDz uq]^ALXQY1=!k^W6HYDYs+ k)[ % 7/5촵Z ɶG5c Iu+4I,<02r|rD>KMΪ݉U;X#u ̃4jїd}$0Wz ѱ9dRea5'~d2er^^U-C%XqEFW 9aZ:SoVHEQLa k[kFs E&hj0P!DhZV LGDJe1N֞Z~{G9z_2sՂk>%ւc@ #LCJhf)gvyc._-g/ %筆Rr:dS0##0E<6Ė٪.OhLB#Rm+cQ?u72٤T,L~Fp7AпrI>eZiڄBd^4s]^H$:_ 9 R]`x<е/nT?M4$Gy.[#exbA ˀ:9W&U fLB-<)gJ),7a :쥯ߜHj!hѰ-!6LtjaPn~!ʶЍ;0wނ@EA ,1WR3½lC_!;%_ʍ2eYC/} $j ]~T#L~&2 w˰ǢpO] ɷw~U5*^Z(o*/R%8#`KsZMD7ڼaԉ⾿)$/1vd-VdөcCFFs4X(pM ݺ>I1RәW'3XwEc|#P:hwU{isK@yQAfNSu(p$oE>I7xt@bI1!303q<ww4sF"N{M|uݯ҇PRN.H;<ឬQ`Ud{3f;+`T>칎&yA!/Bx,%m۴.M0^>J 5ͤ}"WtҠGO"4Hv I92 K5\e Pi{s`9\AIRTKEeHhtƟ}ڄpLR{^eut@A,J\?Hg02c0#m0/@'NsV!/2szPl1 ⸼8AF̣,FyS ĭ$^hOTaMYD j0??~^ nBΔDĩ=ՑѪg|^,OߊVFRՀǀ"zBJ #yn Ƣ䲗Ny^4ni# Rd;__o( mPV/o ey]'M-aeݓ lŋ?KmXKMy'UPr9Q~@]k#l +v\I[ `:mlerrS$]i3UuG=qQ^3|quZ #T39qr@j=1-nywS9׺E¸Tc/Q7Zk 9(:=-x j3 .Js2p06£ZL(0ӄ粪՞>uQFn_f-T,'f]5 Y"IWd":ȰϞX ?s(8sB Ŭ;;')4<\#;1QxMeӼN\ |E@2R q,Ɉ̑oзP a0bD6\k#^ 6{p1b!ft hajFeOsD]O}ud.Ţ*CEP9ͫ,:|T~jB4sh[wpdIpb $0tK#Q4|T.pӟU d[*IOJբWę^Chqܥ]@oŧ"xoܵc]1#~)c wm,yDŽ;6E 82q1 =aj[U.MJ BҒNjs_d 3k0{*`?o COy6 Ȕi'NR^{kq-4$;a9 bP~1°RD)(#I)9(;Wh 7GջvߌqQ2\5kzh7B&ݧ%]=C m+oM?|1*l]cKp*(?r8G le{"AMKgq[)  =65׺S.͎jcj'GTCAB?8V"u؅ {|!z-_{#UȂe7f\nzRڻ[ߛ,}xvV@%0;|9_1 UAg;oh1_L_`wqIF6RQڍx%\7()bg ̂fZ ./A侱*xPAQA߹⳸xzHR.#*(̧y9@ 9 % >'o EӗYisWx.k*k(^"nk UrsStTvZQ@[ %pqgj~U#O!0H`(SaD1՛H"d Ty^4 _Tnv.§8mc[U@9ҝeq&%U]>F?}䚜K|qݍs~&1 ͔NazMX  dȾ}_>- nG`D•Ft4YF/n֮!V[rvQek sFg.)e}<&7dQE\hح!_kn L*EFv0|D~颕,bZ5ߎG/Q}TXhOw-_FJ%~[OkY~"Z̘.ԏ22d݀#:hո}n[O^6 oeDo'܎:?؆ ܚ馗Z.e>qRg9u{inEFe)U;1Ar3Zwc-DhXYRSkw+*#H) ' X4ם& X=/.}BS:P=ȔK` 9l#k/ڨO_~e_Pbs#Џoj]II i_:rV!'[v0cz}LAi.i5[{,'d:ЩgŊc.LO]8GtR`4IE05%,>:1؞ȩ9j̏!z%.bJf;j`o!mõ;5F1 V}\Y2\szֳ@pb'm!PGl[=7Hr  w%Qxy0f< ܚx@Vކ^um.LK0,\9k0Y,[u|7|7`l6 al6 Ľl6 al6 3OtBLn# 0 $$,\9k0Y,[u|7|7`l6 al6 Ľl6 al6 Ø l6 al6 OtBJN :uBA,\+$UQgQ-r]{z\DR|Ӆw_>(5j!%Vw|th&$& G%DYYG` (+ǦL<{/kjaƛVV6 xR0_1/dٞa>N| Kq)9>مe<9e#ۜ~p7',X-㒳sfzT:/bޕՖ|3Q$K[Wc7 " ogoXsy};H}\GtV(r=2zPĆkH 0̼+wudx[Ӊ;~>+7-8|Re@ Jm{c)lk袔4G輻9 ,c"1'h24E.'0 %إ*o,:kL.Z.0&(WrҥBxFW <.KL0ma}}vm{ft5v-9u_'{?icnV Bqthid-4.1-source/images/info.png0000644000175000017500000000303212051012642014742 0ustar alcalcPNG  IHDR szzsRGBbKGD pHYs B(xtIME!*yIDATXíW]LU]Xv@l`lh!d&`Z!d>414TT0ibmil)]~]eewN)uawsf9ߜ{9wV mT m߽:\[״)P%"n +n,CV7LV5bt&6~3r7~'=urO]*eK`[Mc0P`:ܕX@סhnOզ\PP𙌛wX <5L$M9,'Ewu%YJRYdRf_K*Ks ?} vkB 엾I_줊wkWyʒa&ۛCɆ=0-iP7o =/¾ xvصi5dх+#yS. )irfbN*[O*erGFk}c`/ުntP$UՆYܚҋxll TD>|K5pK>E]Ϻ.c#!G^%qwwcUBڀ-W,(L ݈g7]`oQO޽ToQlpVg(PJ]FkȁeȨ&t*X%{vPV<"Jm^Tdۿ3_9zEKx.dž  8JPd6- &YTXWnuQ-eYE0֛1DL',WPA`k*@<˶5Me1L%UR៩4Ƨ h54OZ\V%"]6C"b"+K \*L{,: dBUIk0-ԁblr.F3_ɩ̨W"HIL%9&T>b(ф w(ņa3H}UWmE*cG?/K0H%,ӌν?8_w T?GcKSU6P[f0y5u|N3ey‘[ydmh}I)OX$ t}sGXD3=dݕg%/Sg:9ؤ.|MkOJeCXtfԉ\=n)>÷)H[Wr+/P gt|dhc,v1KJ[{j'CKEͰՙPf 93F&fS}g>7M5 HʹOp^_%-PQxT0gSH_l2`8^[ œSKl'H@#g#!`:;d 6C\sTIENDB`qthid-4.1-source/AUTHORS.txt0000644000175000017500000000067412051012642013733 0ustar alcalcOriginal work by Howard Long, G6LVB. Current maintainer: Alexandru Csete, OZ9AEC. Contributors: - Mike Willis G0MJW and David Barber - Mario Lorenz DL5MLO - Andrew Elwell - Mike K0ZAP (OSX Lion fix) The frequency controller was taken from Cutesdr by Moe Wheatley. Application icon by ~DarKobra at Deviantart. Source: http://commons.wikimedia.org/wiki/File:Radio.svg Other icons were taken from the GNOME desktop theme and the Tango theme. qthid-4.1-source/freqctrl.h0000644000175000017500000001040412051012642014030 0ustar alcalc////////////////////////////////////////////////////////////////////// // freqctrl.h: interface for the CFreqCtrl class. // // History: // 2010-09-15 Initial creation MSW // 2011-03-27 Initial release ///////////////////////////////////////////////////////////////////// #ifndef FREQCTRL_H #define FREQCTRL_H /////////////////////////////////////////////////////////////////////// // To use this control, add a frame using the QT designer editor. // Promote it to the CFreqCtrl class and include file freqctrl.h // Initilaize the control in the constructor of the controls parent // ex: ui->frameFreqCtrl->Setup(9, 10000U, 230000000U, 1, UNITS_MHZ ); // where 9 is the number of display digits, min freq is 10KHz , Max is 230MHz // the minimum step size is 1Hz and the freq is displayed as MHz // NOTE: the frequency is a qint64 64 bit integer value // to change frequency call SetFrequency() // ex: ui->frameFreqCtrl->SetFrequency(146000000); // // One signal is sent when the control frequency changes: //void NewFrequency(qint64 freq); //emitted when frequency has changed /////////////////////////////////////////////////////////////////////// #include #include #include enum FUNITS{UNITS_HZ, UNITS_KHZ, UNITS_MHZ, UNITS_GHZ,UNITS_SEC,UNITS_MSEC,UNITS_USEC,UNITS_NSEC }; #define MAX_DIGITS 12 #define MIN_DIGITS 4 class CFreqCtrl : public QFrame { Q_OBJECT public: explicit CFreqCtrl(QWidget *parent = 0); ~CFreqCtrl(); QSize minimumSizeHint() const; QSize sizeHint() const; //primary access routines void Setup(int NumDigits, qint64 Minf, qint64 Maxf,int MinStep, FUNITS UnitsType); void SetFrequency(qint64 freq); void SetUnits(FUNITS units); void SetDigitColor(QColor cr); void SetBkColor(QColor cr); void SetUnitsColor(QColor cr); void SetHighlightColor(QColor cr); qint64 GetFrequency(){return m_freq;} signals: void NewFrequency(qint64 freq); //emitted when frequency has changed public slots: protected: //overrides for this control void paintEvent(QPaintEvent *); void resizeEvent(QResizeEvent* ); void mouseMoveEvent(QMouseEvent * ); void mousePressEvent(QMouseEvent * ); void wheelEvent( QWheelEvent * ); void leaveEvent( QEvent * ); void keyPressEvent( QKeyEvent * ); private: void UpdateCtrl(bool all); void DrawBkGround(QPainter &Painter); void DrawDigits(QPainter &Painter); void IncDigit(); void DecDigit(); void IncFreq(); void DecFreq(); void CursorHome(); void CursorEnd(); void MoveCursorLeft(); void MoveCursorRight(); bool InRect(QRect &rect, QPoint &point); bool m_UpdateAll; bool m_ExternalKeyActive; bool m_LRMouseFreqSel; /*! Use left/right mouse buttons. If FALSE click area determines up/down. */ bool m_ResetLowerDigits; /*! If TRUE digits below the active one will be reset to 0 when the active digit is incremented or decremented. */ int m_FirstEditableDigit; int m_LastLeadZeroPos; int m_LeadZeroPos; int m_NumDigits; int m_DigStart; int m_ActiveEditDigit; int m_LastEditDigit; int m_DecPos; int m_NumSeps; qint64 m_MinStep; qint64 m_freq; qint64 m_Oldfreq; qint64 m_MinFreq; qint64 m_MaxFreq; QColor m_DigitColor; QColor m_BkColor; QColor m_UnitsColor; QColor m_HighlightColor; QPixmap m_Pixmap; QSize m_Size; FUNITS m_Units; QRect m_rectCtrl; //main control rectangle QRect m_UnitsRect; //rectangle where Units text goes QRect m_SepRect[MAX_DIGITS]; //separation rectangles for commas,dec pt, etc. QString m_UnitString; QFont m_DigitFont; QFont m_UnitsFont; struct DigStuct { qint64 weight; //decimal weight of this digit qint64 incval; //value this digit increments or decrements QRect dQRect; //Digit bounding rectangle int val; //value of this digit(0-9) bool modified; //set if this digit has been modified bool editmode; //set if this digit is selected for editing }m_DigitInfo[MAX_DIGITS]; }; #endif // FREQCTRL_H qthid-4.1-source/main.cpp0000644000175000017500000000246612051012677013506 0ustar alcalc/*************************************************************************** * This file is part of Qthid. * * Copyright (C) 2010 Howard Long, G6LVB * Copyright (C) 2011-2012 Alexandru Csete, OZ9AEC * * Qthid 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 3 of the License, or * (at your option) any later version. * * Qthid 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 Qthid. If not, see . * ***************************************************************************/ #include #include "mainwindow.h" int main(int argc, char *argv[]) { QApplication app(argc, argv); QCoreApplication::setOrganizationName("qthid"); QCoreApplication::setOrganizationDomain("oz9aec.net"); QCoreApplication::setApplicationName("qthid"); QCoreApplication::setApplicationVersion("4.1"); MainWindow win; win.show(); return app.exec(); } qthid-4.1-source/LICENSE.txt0000644000175000017500000010451312051012642013665 0ustar alcalc GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. "This License" refers to version 3 of the GNU General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) 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 3 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 . Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read .