From f062eb43b3be168d22d27ff3d5550c3ba9d277b0 Mon Sep 17 00:00:00 2001
From: Kavish Devar <mail@kavishdevar.me>
Date: Thu, 16 Oct 2025 12:13:57 +0530
Subject: [PATCH] linux: hearing aid support (#230)

* linux: add hearing aid

it's just a simple python script, with a toggle in the main app. i dont want to mess with the main app because it uses ATT instead of the AACP protocol which is implemented in the app.

* linux: implement adding hearing aid test results

* docs: add linux screenshot

* docs: add linux hearing aid script

* linux: add reset button for hearing aid adjustments

* linux: remove MAC address logging for security
---
 linux/Main.qml                   |   7 +
 linux/README.md                  |  37 ++-
 linux/airpods_packets.h          |  10 +
 linux/deviceinfo.hpp             |  16 ++
 linux/hearing-aid-adjustments.py | 480 +++++++++++++++++++++++++++++++
 linux/imgs/main-app.png          | Bin 0 -> 33365 bytes
 linux/main.cpp                   |  21 ++
 7 files changed, 570 insertions(+), 1 deletion(-)
 create mode 100644 linux/hearing-aid-adjustments.py
 create mode 100644 linux/imgs/main-app.png

diff --git a/linux/Main.qml b/linux/Main.qml
index 9e95b34..983a2a5 100644
--- a/linux/Main.qml
+++ b/linux/Main.qml
@@ -156,6 +156,13 @@ ApplicationWindow {
                     checked: airPodsTrayApp.deviceInfo.conversationalAwareness
                     onCheckedChanged: airPodsTrayApp.setConversationalAwareness(checked)
                 }
+
+                Switch {
+                    visible: airPodsTrayApp.airpodsConnected
+                    text: "Hearing Aid"
+                    checked: airPodsTrayApp.deviceInfo.hearingAidEnabled
+                    onCheckedChanged: airPodsTrayApp.setHearingAidEnabled(checked)
+                }
             }
 
             RoundButton {
diff --git a/linux/README.md b/linux/README.md
index 6fcbf56..742d991 100644
--- a/linux/README.md
+++ b/linux/README.md
@@ -6,7 +6,10 @@ A native Linux application to control your AirPods, with support for:
 - Conversational Awareness
 - Battery monitoring
 - Auto play/pause on ear detection
-- Seamless handoff between phone and PC
+- Hearing Aid features
+   - Supports adjusting hearing aid- amplification, balance, tone, ambient noise reduction, own voice amplification, and conversation boost
+   - Supports setting the values for left and right hearing aids (this is not a hearing test! you need to have an audiogram to set the values)
+- Seamless handoff between Android and Linux
 
 ## Prerequisites
 
@@ -97,3 +100,35 @@ systemctl --user enable --now mpris-proxy
   - Switch between noise control modes
   - View battery levels
   - Control playback
+
+## Hearing Aid
+
+To use hearing aid features, you need to have an audiogram. To enable/disable hearing aid, you can use the toggle in the main app. But, to adjust the settings and set the audiogram, you need to use a different script which is located in this folder as `hearing_aid.py`. You can run it with:
+
+```bash
+python3 hearing_aid.py
+```
+
+The script will load the current settings from the AirPods and allow you to adjust them. You can set the audiogram by providing the values for 8 frequencies (250Hz, 500Hz, 1kHz, 2kHz, 3kHz, 4kHz, 6kHz, 8kHz) for both left and right ears. There are also options to adjust amplification, balance, tone, ambient noise reduction, own voice amplification, and conversation boost.
+
+AirPods check for the DeviceID characteristic to see if the connected device is an Apple device and only then allow hearing aid features. To set the DeviceID characteristic, you need to add this line to your bluetooth configuration file (usually located at `/etc/bluetooth/main.conf`):
+
+```
+DeviceID = bluetooth:004C:0000:0000
+```
+
+Then, restart the bluetooth service:
+
+```bash
+sudo systemctl restart bluetooth
+```
+
+Here, you might need to re-pair your AirPods because they seem to cache this info.
+
+### Troubleshooting
+
+It is possible that the AirPods disconnect after a short period of time and play the disconnect sound. This is likely due to the AirPods expecting some information from an Apple device. Since I have not implemented everything that an Apple device does, the AirPods may disconnect. You don't need to reconnect them manually; the script will handle reconnection automatically for hearing aid features. So, once you are done setting the hearing aid features, change back the `DeviceID` to whatever it was before.
+
+### Why a separate script?
+
+Because I discovered that QBluetooth doesn't support connecting to a socket with its PSM, only a UUID can be used. I could add a dependency on BlueZ, but then having two bluetooth interfaces seems unnecessary. So, I decided to use a separate script for hearing aid features. In the future, QBluetooth will be replaced with BlueZ native calls, and then everything will be in one application.
\ No newline at end of file
diff --git a/linux/airpods_packets.h b/linux/airpods_packets.h
index 2593345..3316f8d 100644
--- a/linux/airpods_packets.h
+++ b/linux/airpods_packets.h
@@ -107,6 +107,16 @@ namespace AirPodsPackets
         inline std::optional<bool> parseState(const QByteArray &data) { return Type::parseState(data); }
     }
 
+    // Hearing Aid
+    namespace HearingAid
+    {
+        using Type = BasicControlCommand<0x2C>;
+        static const QByteArray ENABLED = Type::ENABLED;
+        static const QByteArray DISABLED = Type::DISABLED;
+        static const QByteArray HEADER = Type::HEADER;
+        inline std::optional<bool> parseState(const QByteArray &data) { return Type::parseState(data); }
+    }
+
     // Allow Off Option
     namespace AllowOffOption
     {
diff --git a/linux/deviceinfo.hpp b/linux/deviceinfo.hpp
index 6e5e17f..7a4c7a0 100644
--- a/linux/deviceinfo.hpp
+++ b/linux/deviceinfo.hpp
@@ -15,6 +15,7 @@ class DeviceInfo : public QObject
     Q_PROPERTY(QString batteryStatus READ batteryStatus WRITE setBatteryStatus NOTIFY batteryStatusChanged)
     Q_PROPERTY(int noiseControlMode READ noiseControlModeInt WRITE setNoiseControlModeInt NOTIFY noiseControlModeChangedInt)
     Q_PROPERTY(bool conversationalAwareness READ conversationalAwareness WRITE setConversationalAwareness NOTIFY conversationalAwarenessChanged)
+    Q_PROPERTY(bool hearingAidEnabled READ hearingAidEnabled WRITE setHearingAidEnabled NOTIFY hearingAidEnabledChanged)
     Q_PROPERTY(int adaptiveNoiseLevel READ adaptiveNoiseLevel WRITE setAdaptiveNoiseLevel NOTIFY adaptiveNoiseLevelChanged)
     Q_PROPERTY(QString deviceName READ deviceName WRITE setDeviceName NOTIFY deviceNameChanged)
     Q_PROPERTY(Battery *battery READ getBattery CONSTANT)
@@ -67,6 +68,16 @@ public:
         }
     }
 
+    bool hearingAidEnabled() const { return m_hearingAidEnabled; }
+    void setHearingAidEnabled(bool enabled)
+    {
+        if (m_hearingAidEnabled != enabled)
+        {
+            m_hearingAidEnabled = enabled;
+            emit hearingAidEnabledChanged(enabled);
+        }
+    }
+
     int adaptiveNoiseLevel() const { return m_adaptiveNoiseLevel; }
     void setAdaptiveNoiseLevel(int level)
     {
@@ -159,6 +170,7 @@ public:
         setNoiseControlMode(NoiseControlMode::Off);
         setBluetoothAddress("");
         getEarDetection()->reset();
+        setHearingAidEnabled(false);
     }
 
     void saveToSettings(QSettings &settings)
@@ -168,6 +180,7 @@ public:
         settings.setValue("model", static_cast<int>(model()));
         settings.setValue("magicAccIRK", magicAccIRK());
         settings.setValue("magicAccEncKey", magicAccEncKey());
+        settings.setValue("hearingAidEnabled", hearingAidEnabled());
         settings.endGroup();
     }
     void loadFromSettings(const QSettings &settings)
@@ -176,6 +189,7 @@ public:
         setModel(static_cast<AirPodsModel>(settings.value("DeviceInfo/model", (int)(AirPodsModel::Unknown)).toInt()));
         setMagicAccIRK(settings.value("DeviceInfo/magicAccIRK", QByteArray()).toByteArray());
         setMagicAccEncKey(settings.value("DeviceInfo/magicAccEncKey", QByteArray()).toByteArray());
+        setHearingAidEnabled(settings.value("DeviceInfo/hearingAidEnabled", false).toBool());
     }
 
     void updateBatteryStatus()
@@ -191,6 +205,7 @@ signals:
     void noiseControlModeChanged(NoiseControlMode mode);
     void noiseControlModeChangedInt(int mode);
     void conversationalAwarenessChanged(bool enabled);
+    void hearingAidEnabledChanged(bool enabled);
     void adaptiveNoiseLevelChanged(int level);
     void deviceNameChanged(const QString &name);
     void primaryChanged();
@@ -202,6 +217,7 @@ private:
     QString m_batteryStatus;
     NoiseControlMode m_noiseControlMode = NoiseControlMode::Transparency;
     bool m_conversationalAwareness = false;
+    bool m_hearingAidEnabled = false;
     int m_adaptiveNoiseLevel = 50;
     QString m_deviceName;
     Battery *m_battery;
diff --git a/linux/hearing-aid-adjustments.py b/linux/hearing-aid-adjustments.py
new file mode 100644
index 0000000..2312b8e
--- /dev/null
+++ b/linux/hearing-aid-adjustments.py
@@ -0,0 +1,480 @@
+import sys
+import socket
+import struct
+import threading
+from queue import Queue
+import logging
+import signal
+
+# Configure logging
+logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')
+
+from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QHBoxLayout, QLabel, QSlider, QCheckBox, QPushButton, QLineEdit, QFormLayout, QGridLayout
+from PyQt5.QtCore import Qt, QTimer, pyqtSignal, QObject
+
+OPCODE_READ_REQUEST = 0x0A
+OPCODE_WRITE_REQUEST = 0x12
+OPCODE_HANDLE_VALUE_NTF = 0x1B
+
+ATT_HANDLES = {
+    'TRANSPARENCY': 0x18,
+    'LOUD_SOUND_REDUCTION': 0x1B,
+    'HEARING_AID': 0x2A,
+}
+
+ATT_CCCD_HANDLES = {
+    'TRANSPARENCY': ATT_HANDLES['TRANSPARENCY'] + 1,
+    'LOUD_SOUND_REDUCTION': ATT_HANDLES['LOUD_SOUND_REDUCTION'] + 1,
+    'HEARING_AID': ATT_HANDLES['HEARING_AID'] + 1,
+}
+
+PSM_ATT = 31
+
+class ATTManager:
+    def __init__(self, mac_address):
+        self.mac_address = mac_address
+        self.sock = None
+        self.responses = Queue()
+        self.listeners = {}
+        self.notification_thread = None
+        self.running = False
+        # Avoid logging full MAC address to prevent sensitive data exposure
+        mac_tail = ':'.join(mac_address.split(':')[-2:]) if isinstance(mac_address, str) and ':' in mac_address else '[redacted]'
+        logging.info(f"ATTManager initialized")
+
+    def connect(self):
+        logging.info("Attempting to connect to ATT socket")
+        self.sock = socket.socket(socket.AF_BLUETOOTH, socket.SOCK_SEQPACKET, socket.BTPROTO_L2CAP)
+        self.sock.connect((self.mac_address, PSM_ATT))
+        self.sock.settimeout(0.1)
+        self.running = True
+        self.notification_thread = threading.Thread(target=self._listen_notifications)
+        self.notification_thread.start()
+        logging.info("Connected to ATT socket")
+
+    def disconnect(self):
+        logging.info("Disconnecting from ATT socket")
+        self.running = False
+        if self.sock:
+            logging.info("Closing socket")
+            self.sock.close()
+        if self.notification_thread:
+            logging.info("Stopping notification thread")
+            self.notification_thread.join(timeout=1.0)
+        logging.info("Disconnected from ATT socket")
+
+    def register_listener(self, handle, listener):
+        if handle not in self.listeners:
+            self.listeners[handle] = []
+        self.listeners[handle].append(listener)
+        logging.debug(f"Registered listener for handle {handle}")
+
+    def unregister_listener(self, handle, listener):
+        if handle in self.listeners:
+            self.listeners[handle].remove(listener)
+            logging.debug(f"Unregistered listener for handle {handle}")
+
+    def enable_notifications(self, handle):
+        self.write_cccd(handle, b'\x01\x00')
+        logging.info(f"Enabled notifications for handle {handle.name}")
+
+    def read(self, handle):
+        handle_value = ATT_HANDLES[handle.name]
+        lsb = handle_value & 0xFF
+        msb = (handle_value >> 8) & 0xFF
+        pdu = bytes([OPCODE_READ_REQUEST, lsb, msb])
+        logging.debug(f"Sending read request for handle {handle.name}: {pdu.hex()}")
+        self._write_raw(pdu)
+        response = self._read_response()
+        logging.debug(f"Read response for handle {handle.name}: {response.hex()}")
+        return response
+
+    def write(self, handle, value):
+        handle_value = ATT_HANDLES[handle.name]
+        lsb = handle_value & 0xFF
+        msb = (handle_value >> 8) & 0xFF
+        pdu = bytes([OPCODE_WRITE_REQUEST, lsb, msb]) + value
+        logging.debug(f"Sending write request for handle {handle.name}: {pdu.hex()}")
+        self._write_raw(pdu)
+        try:
+            self._read_response()
+            logging.debug(f"Write response received for handle {handle.name}")
+        except:
+            logging.warning(f"No write response received for handle {handle.name}")
+
+    def write_cccd(self, handle, value):
+        handle_value = ATT_CCCD_HANDLES[handle.name]
+        lsb = handle_value & 0xFF
+        msb = (handle_value >> 8) & 0xFF
+        pdu = bytes([OPCODE_WRITE_REQUEST, lsb, msb]) + value
+        logging.debug(f"Sending CCCD write request for handle {handle.name}: {pdu.hex()}")
+        self._write_raw(pdu)
+        try:
+            self._read_response()
+            logging.debug(f"CCCD write response received for handle {handle.name}")
+        except:
+            logging.warning(f"No CCCD write response received for handle {handle.name}")
+
+    def _write_raw(self, pdu):
+        self.sock.send(pdu)
+        logging.debug(f"Sent PDU: {pdu.hex()}")
+
+    def _read_pdu(self):
+        try:
+            data = self.sock.recv(512)
+            logging.debug(f"Received PDU: {data.hex()}")
+            return data
+        except socket.timeout:
+            return None
+        except:
+            raise
+
+    def _read_response(self, timeout=2.0):
+        try:
+            response = self.responses.get(timeout=timeout)[1:]  # Skip opcode
+            logging.debug(f"Response received: {response.hex()}")
+            return response
+        except:
+            logging.error("No response received within timeout")
+            raise Exception("No response received")
+
+    def _listen_notifications(self):
+        logging.info("Starting notification listener thread")
+        while self.running:
+            try:
+                pdu = self._read_pdu()
+            except:
+                break
+            if pdu is None:
+                continue
+            if len(pdu) > 0 and pdu[0] == OPCODE_HANDLE_VALUE_NTF:
+                logging.debug(f"Notification PDU received: {pdu.hex()}")
+                handle = pdu[1] | (pdu[2] << 8)
+                value = pdu[3:]
+                logging.debug(f"Notification for handle {handle}: {value.hex()}")
+                if handle in self.listeners:
+                    for listener in self.listeners[handle]:
+                        listener(value)
+            else:
+                self.responses.put(pdu)
+        logging.info("Notification listener thread stopped, trying to reconnect")
+        if self.running:
+            try:
+                self.connect()
+            except Exception as e:
+                logging.error(f"Reconnection failed: {e}")
+
+class HearingAidSettings:
+    def __init__(self, left_eq, right_eq, left_amp, right_amp, left_tone, right_tone,
+                 left_conv, right_conv, left_anr, right_anr, net_amp, balance, own_voice):
+        self.left_eq = left_eq
+        self.right_eq = right_eq
+        self.left_amplification = left_amp
+        self.right_amplification = right_amp
+        self.left_tone = left_tone
+        self.right_tone = right_tone
+        self.left_conversation_boost = left_conv
+        self.right_conversation_boost = right_conv
+        self.left_ambient_noise_reduction = left_anr
+        self.right_ambient_noise_reduction = right_anr
+        self.net_amplification = net_amp
+        self.balance = balance
+        self.own_voice_amplification = own_voice
+        logging.debug(f"HearingAidSettings created: amp={net_amp}, balance={balance}, tone={left_tone}, anr={left_anr}, conv={left_conv}")
+
+def parse_hearing_aid_settings(data):
+    logging.debug(f"Parsing hearing aid settings from data: {data.hex()}")
+    if len(data) < 104:
+        logging.warning("Data too short for parsing")
+        return None
+    buffer = data
+    offset = 0
+
+    offset += 4
+    
+    logging.info(f"Parsing hearing aid settings, starting read at offset 4, value: {buffer[offset]:02x}")
+
+    left_eq = []
+    for i in range(8):
+        val, = struct.unpack('<f', buffer[offset:offset+4])
+        left_eq.append(val)
+        offset += 4
+
+    left_amp, = struct.unpack('<f', buffer[offset:offset+4])
+    offset += 4
+    left_tone, = struct.unpack('<f', buffer[offset:offset+4])
+    offset += 4
+    left_conv_float, = struct.unpack('<f', buffer[offset:offset+4])
+    left_conv = left_conv_float > 0.5
+    offset += 4
+    left_anr, = struct.unpack('<f', buffer[offset:offset+4])
+    offset += 4
+
+    right_eq = []
+    for _ in range(8):
+        val, = struct.unpack('<f', buffer[offset:offset+4])
+        right_eq.append(val)
+        offset += 4
+
+    right_amp, = struct.unpack('<f', buffer[offset:offset+4])
+    offset += 4
+    right_tone, = struct.unpack('<f', buffer[offset:offset+4])
+    offset += 4
+    right_conv_float, = struct.unpack('<f', buffer[offset:offset+4])
+    right_conv = right_conv_float > 0.5
+    offset += 4
+    right_anr, = struct.unpack('<f', buffer[offset:offset+4])
+    offset += 4
+
+    own_voice, = struct.unpack('<f', buffer[offset:offset+4])
+
+    avg = (left_amp + right_amp) / 2
+    amplification = max(-1, min(1, avg))
+    diff = right_amp - left_amp
+    balance = max(-1, min(1, diff))
+
+    settings = HearingAidSettings(left_eq, right_eq, left_amp, right_amp, left_tone, right_tone,
+                              left_conv, right_conv, left_anr, right_anr, amplification, balance, own_voice)
+    logging.info(f"Parsed settings: amp={amplification}, balance={balance}")
+    return settings
+
+def send_hearing_aid_settings(att_manager, settings):
+    logging.info("Sending hearing aid settings")
+    data = att_manager.read(type('Handle', (), {'name': 'HEARING_AID'})())
+    if len(data) < 104:
+        logging.error("Read data too short for sending settings")
+        return
+    buffer = bytearray(data)
+
+    # Modify byte at index 2 to 0x64
+    buffer[2] = 0x64
+
+    # Left ear
+    for i in range(8):
+        struct.pack_into('<f', buffer, 4 + i * 4, settings.left_eq[i])
+    struct.pack_into('<f', buffer, 36, settings.left_amplification)
+    struct.pack_into('<f', buffer, 40, settings.left_tone)
+    struct.pack_into('<f', buffer, 44, 1.0 if settings.left_conversation_boost else 0.0)
+    struct.pack_into('<f', buffer, 48, settings.left_ambient_noise_reduction)
+
+    # Right ear
+    for i in range(8):
+        struct.pack_into('<f', buffer, 52 + i * 4, settings.right_eq[i])
+    struct.pack_into('<f', buffer, 84, settings.right_amplification)
+    struct.pack_into('<f', buffer, 88, settings.right_tone)
+    struct.pack_into('<f', buffer, 92, 1.0 if settings.right_conversation_boost else 0.0)
+    struct.pack_into('<f', buffer, 96, settings.right_ambient_noise_reduction)
+
+    # Own voice
+    struct.pack_into('<f', buffer, 100, settings.own_voice_amplification)
+
+    att_manager.write(type('Handle', (), {'name': 'HEARING_AID'})(), buffer)
+    logging.info("Hearing aid settings sent")
+
+class SignalEmitter(QObject):
+    update_ui = pyqtSignal(HearingAidSettings)
+
+class HearingAidApp(QWidget):
+    def __init__(self, mac_address):
+        super().__init__()
+        self.mac_address = mac_address
+        self.att_manager = ATTManager(mac_address)
+        self.emitter = SignalEmitter()
+        self.emitter.update_ui.connect(self.on_update_ui)
+        self.debounce_timer = QTimer()
+        self.debounce_timer.setSingleShot(True)
+        self.debounce_timer.timeout.connect(self.send_settings)
+        logging.info("HearingAidConfig initialized")
+
+        self.init_ui()
+        self.connect_att()
+
+    def init_ui(self):
+        logging.debug("Initializing UI")
+        self.setWindowTitle("Hearing Aid Adjustments")
+        layout = QVBoxLayout()
+
+        # EQ Inputs
+        eq_layout = QGridLayout()
+        self.left_eq_inputs = []
+        self.right_eq_inputs = []
+
+        eq_labels = ["250Hz", "500Hz", "1kHz", "2kHz", "3kHz", "4kHz", "6kHz", "8kHz"]
+        eq_layout.addWidget(QLabel("Frequency"), 0, 0)
+        eq_layout.addWidget(QLabel("Left"), 0, 1)
+        eq_layout.addWidget(QLabel("Right"), 0, 2)
+
+        for i, label in enumerate(eq_labels):
+            eq_layout.addWidget(QLabel(label), i + 1, 0)
+            left_input = QLineEdit()
+            right_input = QLineEdit()
+            left_input.setPlaceholderText("Left")
+            right_input.setPlaceholderText("Right")
+            self.left_eq_inputs.append(left_input)
+            self.right_eq_inputs.append(right_input)
+            eq_layout.addWidget(left_input, i + 1, 1)
+            eq_layout.addWidget(right_input, i + 1, 2)
+
+        eq_group = QWidget()
+        eq_group.setLayout(eq_layout)
+        layout.addWidget(QLabel("Loss, in dBHL"))
+        layout.addWidget(eq_group)
+
+        # Amplification
+        self.amp_slider = QSlider(Qt.Horizontal)
+        self.amp_slider.setRange(-100, 100)
+        self.amp_slider.setValue(50)
+        layout.addWidget(QLabel("Amplification"))
+        layout.addWidget(self.amp_slider)
+
+        # Balance
+        self.balance_slider = QSlider(Qt.Horizontal)
+        self.balance_slider.setRange(-100, 100)
+        self.balance_slider.setValue(50)
+        layout.addWidget(QLabel("Balance"))
+        layout.addWidget(self.balance_slider)
+
+        # Tone
+        self.tone_slider = QSlider(Qt.Horizontal)
+        self.tone_slider.setRange(-100, 100)
+        self.tone_slider.setValue(50)
+        layout.addWidget(QLabel("Tone"))
+        layout.addWidget(self.tone_slider)
+
+        # Ambient Noise Reduction
+        self.anr_slider = QSlider(Qt.Horizontal)
+        self.anr_slider.setRange(0, 100)
+        self.anr_slider.setValue(0)
+        layout.addWidget(QLabel("Ambient Noise Reduction"))
+        layout.addWidget(self.anr_slider)
+
+        # Conversation Boost
+        self.conv_checkbox = QCheckBox("Conversation Boost")
+        layout.addWidget(self.conv_checkbox)
+
+        # Own Voice Amplification
+        self.own_voice_slider = QSlider(Qt.Horizontal)
+        self.own_voice_slider.setRange(0, 100)
+        self.own_voice_slider.setValue(50)
+        # layout.addWidget(QLabel("Own Voice Amplification"))
+        # layout.addWidget(self.own_voice_slider) # seems to have no effect
+        
+        # Reset button
+        self.reset_button = QPushButton("Reset")
+        layout.addWidget(self.reset_button)
+
+        # Connect signals
+        for input_box in self.left_eq_inputs + self.right_eq_inputs:
+            input_box.textChanged.connect(self.on_value_changed)
+        self.amp_slider.valueChanged.connect(self.on_value_changed)
+        self.balance_slider.valueChanged.connect(self.on_value_changed)
+        self.tone_slider.valueChanged.connect(self.on_value_changed)
+        self.anr_slider.valueChanged.connect(self.on_value_changed)
+        self.conv_checkbox.stateChanged.connect(self.on_value_changed)
+        self.own_voice_slider.valueChanged.connect(self.on_value_changed)
+        self.reset_button.clicked.connect(self.reset_settings)
+
+        self.setLayout(layout)
+        logging.debug("UI initialized")
+
+    def connect_att(self):
+        logging.info("Connecting to ATT in UI")
+        try:
+            self.att_manager.connect()
+            self.att_manager.enable_notifications(type('Handle', (), {'name': 'HEARING_AID'})())
+            self.att_manager.register_listener(ATT_HANDLES['HEARING_AID'], self.on_notification)
+            # Initial read
+            data = self.att_manager.read(type('Handle', (), {'name': 'HEARING_AID'})())
+            settings = parse_hearing_aid_settings(data)
+            if settings:
+                self.emitter.update_ui.emit(settings)
+                logging.info("Initial settings loaded")
+        except Exception as e:
+            if e.errno == 111:
+                logging.error("Connection refused. Try reconnecting your AirPods.")
+                sys.exit(1)
+            else:
+                logging.error(f"Connection failed: {e}")
+
+    def on_notification(self, value):
+        logging.debug("Notification received")
+        settings = parse_hearing_aid_settings(value)
+        if settings:
+            self.emitter.update_ui.emit(settings)
+
+    def on_update_ui(self, settings):
+        logging.debug("Updating UI with settings")
+        self.amp_slider.setValue(int(settings.net_amplification * 100))
+        self.balance_slider.setValue(int(settings.balance * 100))
+        self.tone_slider.setValue(int(settings.left_tone * 100))
+        self.anr_slider.setValue(int(settings.left_ambient_noise_reduction * 100))
+        self.conv_checkbox.setChecked(settings.left_conversation_boost)
+        self.own_voice_slider.setValue(int(settings.own_voice_amplification * 100))
+
+        for i, value in enumerate(settings.left_eq):
+            self.left_eq_inputs[i].setText(f"{value:.2f}")
+        for i, value in enumerate(settings.right_eq):
+            self.right_eq_inputs[i].setText(f"{value:.2f}")
+
+    def on_value_changed(self):
+        logging.debug("UI value changed, starting debounce")
+        self.debounce_timer.start(100)
+
+    def send_settings(self):
+        logging.info("Sending settings from UI")
+        amp = self.amp_slider.value() / 100.0
+        balance = self.balance_slider.value() / 100.0
+        tone = self.tone_slider.value() / 100.0
+        anr = self.anr_slider.value() / 100.0
+        conv = self.conv_checkbox.isChecked()
+        own_voice = self.own_voice_slider.value() / 100.0
+
+        left_amp = amp + (0.5 - balance) * amp * 2 if balance < 0 else amp
+        right_amp = amp + (balance - 0.5) * amp * 2 if balance > 0 else amp
+
+        left_eq = [float(input_box.text() or 0) for input_box in self.left_eq_inputs]
+        right_eq = [float(input_box.text() or 0) for input_box in self.right_eq_inputs]
+
+        settings = HearingAidSettings(
+            left_eq, right_eq, left_amp, right_amp, tone, tone,
+            conv, conv, anr, anr, amp, balance, own_voice
+        )
+        threading.Thread(target=send_hearing_aid_settings, args=(self.att_manager, settings)).start()
+
+    def reset_settings(self):
+        logging.debug("Resetting settings to defaults")
+        self.amp_slider.setValue(0)
+        self.balance_slider.setValue(0)
+        self.tone_slider.setValue(0)
+        self.anr_slider.setValue(50)
+        self.conv_checkbox.setChecked(False)
+        self.own_voice_slider.setValue(50)
+        self.on_value_changed()
+
+    def closeEvent(self, event):
+        logging.info("Closing app")
+        self.att_manager.disconnect()
+        event.accept()
+
+if __name__ == "__main__":
+    mac = None
+    if len(sys.argv) != 2:
+        logging.error("Usage: python hearing-aid-adjustments.py <MAC_ADDRESS>")
+        sys.exit(1)
+    mac = sys.argv[1]
+    mac_regex = r'^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$'
+    import re
+    if not re.match(mac_regex, mac):
+        logging.error("Invalid MAC address format")
+        sys.exit(1)
+    logging.info(f"Starting app")
+    app = QApplication(sys.argv)
+    
+    def quit_app(signum, frame):
+        app.quit()
+    
+    signal.signal(signal.SIGINT, quit_app)
+    
+    window = HearingAidApp(mac)
+    window.show()
+    sys.exit(app.exec_())
diff --git a/linux/imgs/main-app.png b/linux/imgs/main-app.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f64f2039bceba4826b0f43ec0f3a4599d6be49f
GIT binary patch
literal 33365
zcmce-bx>T<(=7@K0fGg0hrr;j!4lkckl^kF4K4}p!7V@-EDRPPxa;7W;O-OL9q!@x
z-LLB2uU^%Af4vk`>YTGVvb%Tp>eXvUs;S6gqLHE@ARu7M%SmY<ARwjzzkaC5z?qj@
zmrB5Yubt)e+z=43dY*p~Q&_ObfRh;R(z@;rpR8@oO&xR*1o(LG)a$wa$9X*jZXupi
zmatynJo@u^H*;4@OD6;=H8xHQ7M>LZ1Zo6%srOo5M*B;i-^njbpPpuZA2iQo&6hyJ
z=%c<#ym;-5s8kay$<_0=&gDV)QK+u{ks&Tg(B&7VlM6XxPuzhCjNm2mOMYSu<Pd}l
zql#Uh_J!ty8lJPejhdR~de481G<jo5Fjr5WX5Xfa<}qI}kL38WC+NoNsvuUR+8f&=
zP*i^6MNa~~d}4vQsjexxLraFjhYY>lI`d$&DV^r*oE*x@68r%z=($HCFvwjhAooq>
zn5v{9nXusbUx(tx#uO!)u&C!tW{Hi1^4uv>vEe?uaCmAbt$ZTAa-=(RXy!>=qDrCS
z6>uy+`Fe^#Hv4zH^b{|t^;i+4`UQTW`&EJvR<~p~xt(Kgb=hR=^DwgSIT!Q_^@!tw
zzWlj2i#x|&B8AOy@(f99%N&6j+eJl_hW|C}V^b$sUC*Vf^Tq0kmsGhda8`I{w~*{K
zDzhsL8D*}`kqipu_FOh78cUDVnAEb;BSd+#Z{0VnhZOw2>clH+3TuOos*Nn@=n?kt
z*7tcLcqUBk*?R|Bm}i^3@t*EBP_B=jZaI)|?-X;pMk(ISwg-xTk@(?0BY)E$ezcw6
z7*58W=+65_^xBQR#pD%&@nc$`@J66#!12Rf<JQ=+QIlSxO7q)jqOGUT3~p<$Sahqs
z)ZyE&<CqMzz+2m%_aq**wdd#O$A32BAs$CP;*%ka6N;a7P?YbkTyM5?lH1M;8ame#
z5$Oo-#+Rs8joWW(Cr1$c_Ke%RJA;cW+CS}W>&!OY5Y)9?atB^N;4PjNa%kx5Yu@t8
z3vX#xHii5xWoKIQ>uNFLc)A^_RK3k9)iLa94>;TNYF(Z*#3R>iKwzDaX>^l**;G{J
zeMZRNdd-?)B3czQlACiQx~IcdNRw=8N7}`J98FIVFD`Z^VqT?d8oYromP=c|<U&ML
z`LWyg=`=W`+qCWajWNhS$~{hK9^AgCTlpAobpchpUVd2F^1TZ5oa7Y5(XVsbn96-1
zzw*Br+E{i2E;k&N8gD<J0xq%m^lrwHvPWgm+|TDHw_bAY7`m|8S2Vofu|KK79O0$<
zw>pQZpHbsXlEOn|UTXBgiYLlEwQYp!=HL^h8E`W!GS;U@s;i*@B6zyU!yT;AVypM2
zk}d)D>7n&$vv((VZ4D)`lOU~f<mm3S{T@%i;EDh6W|GL;aYNC-cSIl2YlrP<HF8C)
zD|$@4`{C(?f|T^%S*6QdowBbiO8f1FB&*SH&i02QvdW$3JB1PDY|OOZlI+dIR{jk<
zemL4FVWir4e$J<-l_v@Ti$M6~+xyKgRHutP?K_Rux$BBg=kd~&$)gssP5(S8#{NDf
zG=x5&96q8_HQdqRb*)-B_-*}lLDVE?B{TM}J%=X=+ckIzU#dMW#*^qhsMzRs@XZ*?
z8v2VyT0}7hT;Y>US@ebyL2QIc3}di(CYRnGxjM96k3Dq>v<FmT5ZVqJKGp4APl_6w
z9yFES%nP*j&K%vLd3bo-Jmfz9F|KmF!>VXFRlZ-#u-0q7<bE83i4VfW9(4>{wzB2|
zR}qXKPTTQY^MBZqy6p^a8`iJ%_30SBT&-5rIh)D7rO&-vXg41r&~ZKTUs)|Re#AZ7
z8F{(N_Q@O1bIBWp>T#A)*Auu=t^HNQhqb4G?Mm<c`uLj1fAy{-9s;M`RHENj7_;ZF
zJpUdEFPA=bGqLR}cAGFa9NmmmuE2m#SaErUPA=JiblHLmm9g9AR>NmzW^Ocl@F6Wy
z&abUanVsEj*s(rme({;H$osxFEw-{{kWu`Cggaxn;ecDWAn9VbCa|ESgd|A3^_Ug~
zi`>Fc{b1|w4F5?@?o*-#ccg9RqTfcW$Z3B*Z~bqx1^zep*Tn|E%!I&T@XgHqIZS+g
zD=lZ|-P0voW@hFMEbtbW+K%mw=sl|M)nT^_Ie$w_0+EqlB$-nKR#1HlTv_BExDy|r
z`5gb7r)~B5cfzMfzPsZz%eSclH5Mnd8YTEBSd_y@Nuz$@EW3&?*Q6*8{jsk6jXA=p
zqQ2*YepqROGU)5p@+&LjFYEZ(jT#eIL{E_3)j968grYYdL!#Be1O#}>Rliu#caRnu
zc}Q@SDC1?3qj}$kg@yI`FU_o|Dl2<D?xjvkO8e$jRD`jx8xJW980D^{DlsszL~{xX
zqIOVtwubxPUG7{p|J&P}Yct<za5OYrx-o&4lvtgmvTa;mU0!a9KZOV0TRXKsXdgZd
zic00HA3n?rsQhEr5q^k5zf}#qbVEo&?mB5Y{z@S0m%Dy+7pWTXuOQ&lBKF;8u^1-#
zQ~T4;wM4;B1bL!?^wkG0K7{R|#W{Xoho+52zc;$UZ9ZAgR2beLMlz<0nIm6ZU?y8%
za(<x5ETZt-34p&j13X}8dt~DY^(|ZqALX@#zaa%jTLaCL2Ru|Q@CkuTplz@{w<C0<
zqXXeWTG<I<s#tl$q~@m(CI*I@K2Ly!p0v03quWs3&A`)R%+mvW%=>Ocz~w2>FMMdm
zSXo%KO@<?TZt?3Q5SoaB-Yh;On6sz9Va!&c;^XCSJ7vzj-Yk|YR`na{AFz|{HT7l{
zhpA`vYQzqa7<m#UP^f+jIM-)|#&cSKrh`IVA7TZ#%=<7PblndAhw9AvV+nO4Jr^>(
z%I_-VlMBUT7Njmi$DWkons1p@)$v=5R3G#9l8iYF{r{%0e*BFst=@18Wyuf-q#SEM
zHiJ){QU+|QJ3XA~>(=f2;Y)Y!oVh&SC@SXimxNP!C)cm|nLpkceumpkmo+BCr~+|=
zil2^I1y<bYYRGz5CiIt28Ma5WlL8+?iHw3~_Bvh2KOZiJR_xi#Z;Ge6TP<7<mfm1p
znKONhx4Oz{mBk>ONiAQPZMFUc-!^w`m{)fx-_@1rp?DC`zT*6Rg1P^X0#bKoxr`H;
zG>7xnP%Jn?eE5!|(yE~~>34O!jwiB>fj^LF^PsXL<t}Z<H|-hc;f;?)p7^4QiG9tk
z55h(Z*BX!ZSMiO11llef#qQv$Rlr*C@$tF&V;q>eyu3VFyw!TVuIRU+zp|bCbaG^C
z^OG?{=``Fr$8u-XuuwI7wKt9bIQCOO)?J(Hn-p-$?|RSU0agF7X-NqD;7V0g*?fbw
z?aFwi_vq|o0hYTt0Rv|8@pi9bOW(Nt%}{lOO#Xd)`@@UKo=tlM1?#pF)RZZ>Ty6eF
z2?106qEC2@?^Vv^fkDeZT(R4#_?M9Ko4~+(gi`IwBH`V_#eF&n+!1>dpFuBERe|P9
zsxD6V$NRc>sNvn9sIK<Fot0VlR0>@H;=ng4+P2pP1>=GtAmXr2AXJB&&j~h->i+y1
zQj||7+*IK<QHZWrH7ElH`-xFSK_d9~@%G2l0OT?16pope_vL+`8JC|CN7ReIfB9l!
z<IFM{u!7bRXeD?JVQOIfSL85;q=9b=#U!NI`F78E#cjy6duu#T(r>Tr4pa(~9EiPh
zbwC-aLYzo|{`dikc#!tL!or$Z135Z6hQ>a_CZUaAYe1kYFE1be*z^pU665x-!`%M^
z(73*>{Rg=Tk+44xO-}mXhZNKq$u)s*f#;Rb+5g{{{>RAwPlxaJ6YrkyKR33)1*-fB
zsjf~`6Z{G|>fXtVZ=(eR1<HMW5DZLAE^ZMy2J_UG?#P7a7dc1Xe1nw1<u813G4(!F
zi~Buu2DKRBTYD?SaSRGc0l*x8{!D+tY!x;9?fLneQjg;D$#uUofNy<*ZNH1A*-jO|
z#Om%2rpK+CEJiRXWaEbOo;1u-p@#f~mghn1QY%JPuxk0!TGnR={_C$eMUdULhl|@P
z;?~wo&8j9Qi^<hR#AJXU5PqJ^G%H}jkr5P5)gL8FVbRaPHOOg~^`oCyp4zvzHY1G^
zEx2af-0Uo<C?l^LiWYz6cX>GHy@*IB8x72ME8=kWyId1a3FA+11}t!4E-L>Llo;T9
z2Q<VOoYtfFlb<}bxDB2?!?nh0q^PJUb?wXhY7#thYX!==n1SOCYCb-`;Y_~f^99NT
z3?jfbHR<BmKLX}?flMG*ge$0dZ_J%yVq+6=Yddv}@}h9%@s~w|Tq1pT?>~F8UuCT3
z`E;{&{>kBz76-*%t83xc2Xx}=XFA}nkR2sI!1qk_^#1J?r3Bn{CqB=<dnz|Z_WZ4|
zOuo9pozm%>@=R%>;X(rsXL63A>2lML<MHBZLzX(<<5ygqld)@bSc|542KL<ICv1}E
zn?7P}%=UeuSg4^d2`RF@_7k(Sw@>G@Cq&;KD|XSQBOoBS_BZ0T%3NCm0h#Fc@4Ct9
zWf|j7ROaU9^qNfMFeZORIPU~+tOT`$w6_o@<^?bRsMY9q89RHs*P$PNLO-w)76U0W
zb(-*!N>ENmM?g|i(xOJsVSyd^Lk|sYqsR>j5&jzy!kCQ3V^8C?N{&j}fK{e|6WOF8
z_SX=EAFHjaW7o%ywH7nWUCN3>#7pktxsS~#LYxB<HD0VT($WN$TLc*AS80bi5@FHq
z!}!wgr+8@-P|vnUO?yuXSPh#(^mwe*)%D_5b|nA0YrP`xsB%=|QDo)s>*$~^cXZre
zX^($E!E)VIBcto?F5t<yPf2jM14Vs>La!eJ{_Xusf9HvXPRMG~d4Hpn%O5*9h<5)-
z9hSFcY`%b1WSc10Lqbfv+0n^R=eRODYWNPmyGx&<Fz`+2rBs(CJ?=^O<HK&W)9RAF
z{WyNacTY?z!B6)Ad@T`V;=e&p9=*Muu6v>FYq`dQ_@brM2@#rvz>-p?5zr<5x7WCx
zS?{{l<T0EjkS0ML1cm+pHI~wJx^%dZ-v@vI%m8FI_6CzzC)Zg(ac8=4c_4CipF7)P
ziC(3PF;s0~%GbN7HsO)oH2-nB!f<GwFRj{n;scbWloR94D!*?K1Oe0-zy2bxtR*Ha
z44II_sHcgA-5M50A#(HQ$or%>Euwc_Hx+yxHfc+Q@k+kOJRFnA4MunGcjw`^{^F^j
zeQZF;;_@jow>@#2^OGz$4kI>3ic?N91`+(H78s}|Q#the?v}5NQghp5)IdS7jrU+M
zzVrx@(%0(|d_?mNL9DuiRY88E+_b(vz2S7OY!4lS(QP*Uo2}qC)%G*&W>pOs=}Zt1
zT2qB47~Biiso2=gax(jDP8S9Xu81U!a$NWcMWqIVnUIEh&VE9f|NaFV_`nNU4Sq*R
zM-!fv8b3shj<P%Ge>aDp^I*Io;h|HRv?#;M@%Is+(sSXWeC6x_@y%KNf+8^PB;X8x
zceq+)nPP($)Y~a8*4;U5x{S^_qI3w^-2MGlG3`Op)6*0FS^kAo9xmD|y;dM6T|Zvc
znDwF!4$*nF8u2PiPW?7mE6B55&qpOww}~8+UMmElp((Vjp4~kF3uFB&x;8deI7xJ`
z97B?B>Ra?uyv=D&78aHUlU~>5v%}_wo1(0AAvZ#!N)+X()15xiz|5k2Xz1DQA<K91
zS73spy%S=<DXqpb<w5w6n$qa1DlYFfBgPt1YaS87h@@t0(0GYHfbo~T8IM}wW_B-`
z(Xim6;+y7y7gQqk?b&syOD*SrhUim`yP?Q0Uxh-?*v;lzY_+VK=VrtdY+L_SQ81T6
z;rlimb38!og8y3lYPZ$Pas!mOCh)|!NWq8_4jlMW%uwbJ-Tq4VA4OyhXrdW-oTc9D
zs&`JlRZJJ~q^#17i5pd^)~m8Bb@$^{&abNr(|_EjxZm<!85)e%!5tPb7X&HLXf2)z
zJdzW1S*&|&xe@hab((x5nX*;`%)IP>7txEg!b_JeJXJhqVPOF>_8k`g<GtuTM&v#A
zPX_wZu7W+&a_?!eJKi%wj1=bLT!!;;SbDLk4M$R4tz}Cow>~*#Xsy<`RVj@xpobVO
zIYnoD&imXsVZ?0G)HbsZ0zmeMI{geTbL53O$Bo(<qqivvKrkoOu4qYD14V2^l$xep
zyZfP6ZbW=lMgn5N{7pcr!*my?NSSV1%zP&4_E^?X@Eg%#AckZNZ&E~0dPPB2&wMh(
z1H}SeX0po+8WRVjToG7@x?0t+ztDDdiOTjOx(ZrN7gW~gii@0~098vmpBrJCQB!6L
zk?}A^{nDsvz^$h6yLXly->ou~&<v;K_1^|E#%bI#g7_Es<2Lxc(31G2Sq`OFuSYVA
zl2lZ=lO1rYw`r9Xrre>-|FO~L{aISI|H5ZVpIsW^<|Yzy;(|aEgsI{6E268`7>*zK
z()d2Ti<Rg)-BH(;p5*R^jJT1%OgdkD&BH#RIH1Rk>;fn8GAZMAccpO{_sNQ%nob*h
zX38@Gd6rQ~B^B!H<M4eme@%#U&v4@PH5euHdJ3K6_;iSaM}${N(H=dUA{z)*@!n@U
zII(f#e->G@cvWjo2bs$pKCersi}sEGj2hc{s{xiDS5s3f!N5A*Kl;qQz8xtXOD6tE
zGd*$)Sv6rqnXQMbikw7;Uq7_HS4e}N-}u>Nc1i>q59CAwX)-BF>O%|sUuok_9~tp3
z)oNP%EkT_n9#-h<P)Wf$NoyS<08m*>l6>tnG2NUkh>|SE=G?qB!GGnTZ(!;xLb*Mf
zp-hjPS6&{RfWvjBn`t0O4iFT7{jMcFYxeKYxG+@Pf@VA>h>C1!@0T_(Ww8i@q-Z<y
zBoFT4p+sKrLQHpe_tgup<J%VEu<*x6#9JR<J-4~S5J^+Oq9mlGiFExcbb-_nD@Tkt
z9IaJ4scS{bB3I2YFCTZ3z_!oAnGlmdhCL}mlJu}@BrAjAT>n!yKW7hurWYnvdyj8U
z(yqk%`d;D%zoORAR^d*e7v?r-vVSqh%AouM%FJUux~{BatV~T@&}{uKI5=1<S!Wd?
zYGDTg!ob2foeaYSO57TEI4%&&r7SI9LCo6)rO>4CGQMsI{)B>#7kg=06+<Fs_RL2z
zhd42^pB~rZ1>Jwfx(ge6;k^cfPj39mjB2BrmpxEoYsi3#cA-uk|J4MMHg7sD5xW}d
z<@$K|2gkzF(k#aXPv_MRL>U>Gek(S2<?d>>U%jQgV9Te+2cRO|9?gQK=ordty48HQ
z@g|Lxk^KqEb-SL2eC+;LyR+5xQqA2?d%15%dzt^x_G@2@htBx*RPMN6I=gD_n5wZc
zQ18f79CB+4hkLgI$s<q<eM~<Hb{zCFW6?r3D)VQuL8qmaQl@^U_h!P%@m@G(QDI?<
z7PC-=rjdG2zAlYl&z((XSVgpHH5965q}^wkW;keg<U<7D6Px+#wrsZyNCb{&G!ff+
z+`=dG35Yb3-=kl|u1{V~8#ZmI2~K>MP?aOu6mMj&nZtZbXzu-ys`ul~4*ck7%n+%e
zJLQW3Pm!g5!6cIwm<|`K=J0gL*2boT6XQe#o*W%7t&Sfm!3h$UQ=q&}^gM0jvxMo6
zvs|YwcQ$MP!&^py(O_c$Ijw3UVUkEifj?RvkC*q4+Xm(gKtz~{P`<33k#tk!$<NRC
zYN1SC{G|m3tGmAG=KST5Ra9if@3{OzLRwnrOVD*FzCv&(+kVdxM+9lCegsogR8iD~
zYTUuECkZ_GZv$cEp8K%Az6`&0b1LfzNa!{2jb}P8s8kix8swa--v%sfY;Cs$+P#xk
zL~e;Ay}p`&(%+z|w?(`so--f|<W5-~yx7yL`HUG>v2j9tesMK1&2T$dpgH!L++CT@
zKwHJZVcn4NV3(S;Epf=|TCTRegM)H8)_Pe4+Pd!9DPMQG&yllgV#Dq>=+XE2KK;|<
zn3c~+WS}|tZ*2?)CQhu3qNlP#STt{^G?7ui{_?Gr9kdicD-zTlE#7A(pKPe{F%ndY
zdr|3KyLAYpll8G;Vq(UpmU@?4ec`+NeMe^+Mn<1!BXuC-c<ud8Rx$0>+T$L<)z#b(
zI=bJr^|@!=$pq4Qd3j$JoLW=<mg?YOAaTWX84w8Q_HdDlkDIOUU_Cs%6uE=#TyIrU
zS^%U5Js#87JcKV2oJ8kl$n7b$<65zUP=!=B<Gx#9D(ammIwcUK)ulAkUzUe|geO`K
z+9s(K|EwtKt#+8S<!Tmt>c^@&i|6=de#Eo*6pM2G5T-*Sbd=p<nS=5w{CsF-P15+D
zD_-;-iR|jrdgqb&U{1Q=N^iUgh!%P7cP*t`ZYBni?bj@)rZ3U#4c|=E+{b~4WoKuX
z{>~bU$7&StFd11`1S9Ux#;!pZ69<Qwgf&y#NF>Q_$^C`EpkS1&bn#DOn3x_LXtf%l
z%Cx3vh;-W@0Z<QxvdlF(zMEJ?`?W(Wt$ys&YS0)UDzM^5mqI|`B_cB+$9W|Ymz%Hg
z(cUGaXrMCi0d)nyZMJrHeS?{e^YL+GJCXwK&OOdn_@Mw&GYGiZDl>E=Iolbd!^d^A
zS@b5%EW)LTt@a+8zQ6jWQtrSX4FUbpnn_eC<{U|^@ZwSMReWPkD3SWJEvVj*i!7JI
zvis%AmVmFhp!WBi)X!lI8QDiycO@kyg_V`zHtrUa?JEQQSpK$Od!q^0&b)CXgO*B(
zxU?GTic(7}3{*GDWO4!@RmnxX)OeH98Gt}YkLyychsR@%6AkmW?UvCl(;Z#!ML)Ue
zA#h@n##xc{WBp?x^(%sbyL|=bjZWzN;4yQWj}qWF3_cSeHJr&1^C#V#F??^Rj2X7p
zNg<-{=Rjb2ip^oAr#HW_;Jqo(4rGiZiH_*JJ&R!sU}=J&3f_7oP$+JkRKqm{z43hV
zFR)G_cC_w2r()|5<ka|BKsvG9Xp48ZV~YBq>PZx~mIr}mDya(0O$H6P5qq7UwQLPc
z9wbd+21h~d!otFL;fKuU%@i+5*e8*AtcN84EZHzC7#H=fOK~{um?!X2gqek9w&4V9
z<bS|7k3~V75dnCgoV60bU6yD?RaFrOzkHaDBSz)){<4D{WmAL`3N|GRf<`rx>lphJ
zWE(E+FSllOcD|Q^^_>P|E=SaoT&3Uni46`7{wy!wI<2+WYq7y;a@zb*z$@1`W3p(j
zJLp2b9x0eVVQO|F2xab4oC4$HpQrz99nKYxueG0c2Dq=+$daKen0;etFqdOu<Qg(E
z#r72Us1m4xj`h3PnjH;&ow4x_gn`Y03*VauMCQ^``C<)sk2)%yUqOJc<0i-<fp|R{
zbc*BX=Km5%cXDFb+3z&~bq}}OHbzds?Hh;LV_JBOJa-0dib{e);R!MGRFSGI3u&f^
zH+F;xA|DlJ-NEJ)W)$sqJMZZC-f;2r_rk)$vyJvd&qQQg_Pf()BNe}unlyd4($Z2(
z0L(u39$0lbbKz4(J6WvnJL@Pq`m+6VeLW`L#qLn5N~?o7IEtZAG?wNp3yqj*Hx&D1
zo#d*+s3E=f01AK(-E9(MS3=v7T`V7W>G@fGdRjgCi76X7Zex6Ye)zX7&(D%_b7$wE
z+1<#$$C3%$P$-myA~vefNM-ftIof?OB?f3H%Q>4&R6OU(IP{?p4Ky`gCuXFiMO9uW
zv;hy}-TSjucs%xa$G&>apD}eR+PPQq#JzvvSF{jFx70i83&ve9N3Abg_u%Bi?CeTF
zl_rlZH)ZW+6j}8SYkA>Rra%$~>R5pua&*I)*T^r+8uz)E1J0C(vw6bRKru6W?`JL`
zrE&sNQtyph<aVzg8m+g!N+W%dF?1BIUkP|;XbA8$?xuQJVQZ!r|Av5~gsc~PCx{A6
zP^)vb7>SPMvS6@4xMnuDPTRAQ;ddP7PAZ5+;aG0*kMw6n`CD=<yjU6eo<4<Kp%Mv@
zlAaz(7)&zIn8Uwy>F38aF>#pW^DLzIgE9-MQ<)X+$-!*H`=5C}xL@nI{RQhx&Cd4M
zjETYWB+H*mrjbtpJT=y1qeNjzuN1$4&KI4XD~FdlaGn^{w73?h_bzbJLVuQ*T5b<#
zh#YU^{_-BOT0iOGinkG(0!5{_Yv||?)y}k})VDua0k!<GSIf<Y5h@l)RLlt>Vn@ly
z*JbR>U28?tKW4yA-na1LfpmtUG!E;BCYGONWnCLg!+JQCEQ?~DhGe7Fy*t|4exi>+
zXT%9wG%+*NecX=?2J`)yo=zx-(q_m-h^bG}XA$^wH#z+vL;fOx9Y`Hi0ms0?;^Z6;
z&lvdb{0jl}A5znHs%Y|HQfPkwM%BG{0ofA{Gd0=uX)BQ`)8q>{4AD<-2u;mqaag=4
ziwk$upRG%86mJW{SGEkrvZ%L}G2mMO+FrhlD^Hzoybc?8NFpg0q$+u07ced>7C!A9
z2()Lbfxd}f9&&Mr9j=cP#U+5Qd+ny295-|Y<C2VtlxBMQtl{2l<ZdShR|b08gj4u#
z#^f-X3<cMv3xRDTx>lo}(6Cr2G^7jXLmuj*1cKzugd5vyJ)Yo<kwhi>h+dh<*w}4$
z>?r$oMww}Yg4a#WzUkBB2#qWzuU?^yldE?G+vsz!?;@Q{WDk2bu<Uf>99%+z*jUjw
zG!Uw)tFQA197i6=w7`XVd2!ERbFOTlX6!LROE|moRW>G2GnSRbymM-fwXbXqbDqr(
z`bf^8@c1ThovQsSl<)%)8lnqt6s;ZCrd@cP=FgIbokdK-g}Ps?`hLG1%Nz)K>=U_o
zboHX+;wm7XsYV>@o>B&jvC{ccvN8&zObtYg0KIGbsu8`vgt}WgbG75kOD*lqX&lX-
zei~<IEljYRGx?R3<ZmH?|JDL%kVa|jk|UoC{d-(*VqjT`>PB2N!O_v{)loi#b^Wcm
zuKz|>qGjOquc>pf(e1f1v2}7<Gtr#VBVZTHjlbBdSPk1-k<rr=3YB1DM?&k=C*?dm
zaqjM|D_;~E%x-siHRu)UrY-0lip_yZIB{>ez^^w%Yj4HH!vNRHRO++1I$XNB`ZkIY
z1?A>TaM_Rh<dEU6GF$CI7ThgaFl9Rl=gm+;o*GUZA*4K<Sx1|uVA~8}N6YU5Pxgd^
zdeC&{AZKmZtiY7f_2v>?bw+$+az=lTuiM~EGh_V3e;-gaJv}F(jt>;IFlB*732K3j
zR<(xaF(#~xNiuKcds6(Kj))I(<Z!=+T%t_U-knsi?q%WiRR?bkt*%m%yRb5Ic2Q|@
z^bG%y)n|ENbw~Q&0cdevhC72kLy7QJ3=>+CgSJvK?}$N1!w7vZ&Bmr!Q|O<b7v&9{
z!5`QP)db@h>*7}!&}5vQdkjbyI`__8Z!-CYog8|0&SC>QNtp4`T-KzCIDIe4@xi^H
z7ft_4!!>#^<GW^7!&FYXU82I1RsHbeFPSk3CW_6r?zDPt2zM4AgtO(7lnUkOlL|DL
z>YSEFJA+Zqp4j1wZ?k#}Ui<jo&DL5AOcn8cJGnaxO>$f?OUy1evnPczqfrlyj>P_g
ztsKs}EOPe0>S%D)z>k6Sy@2#_i|IxM7hKn_pLO{P#|4}3$Z+VHiC+KvXUA^boSL(2
zlsI6q)@%Lq-#=z;R(%!fU04+bE39kc`#l#);67SZd;$bNE(sE$?(ftPvD2uUb3bwl
zo5UePJ`@_WS{n7`;vOC~R7x)bL=`j%O1SZ`-Y5)?)}H?U$dU4I%ep`Tj7Og&|M_6P
z*L#QUM>T|drSI_KCQ2rL?q_CHITVztJFXUkMHcvkeTCNC;OzDi#?~Ko6yrsYSJ@y<
zW3zx|#jhxwLYtw02ywfGpmUf26!G~5#Y2U6W&NwO9Uk*r_w_14xDvAD%*mZU$mrAI
zbpzsBSl^oVJ5V9QI&mW+Rw3d+GE(#cIe%MVZ?&|SHQNMhs=T#akw%P+EC~gL<yBkj
z@4>r6IU#N!GB_+0wdN<WWz|<Z%yBDC^$dPQlGFp}`Bc-*)YlW^S_I&!Us~uRxZTF+
z-Kj8viI_Je>OYi?B!oMzOE1>HR&stB>*B4U$9;W^f(!s8Q+iVA84myl0X+p)z3K=|
zj&=jDe4amDXQSQ2R&zC;9CUQ*7~MabposvZ3ACh-Z(455i$P{u*@9xQ>1wvPEa}Ht
zNp^i#Q=l6pt!&}+O}CLW+Od(YyUZZAmp(y>lb^qDwFA4=zqO^sl&<KeFTIC3TLi#l
z1pv_IXg@_uNl5{iZ-7De@ZifcA<P|%UgPRPVpWzL`K!xYi_Huz%424R`U*%%BMR8K
zu1JQcm|nJ`;tRODX5obHUaR56JMb%tP!<=~ril7pPR!5u?amShw8z6SFASVJUAKpG
z41q72{cSt7`|qFC)nV)T)tet6G%z^j8Fc}Ql}XNW#M~M52AE7p2y`C*gFdJtauXK`
zhT|52Him-(kg9QPcKo5#OyuUCSt+&sO=o(OBmhR7m{9le^(7%8F`YRCnEZ%lH3eLt
z3xm~N=Lneq1^TSL(ynYvu2Qd(u<-C8$TLB$9E*l+baM8%9yRGl51_={srAfyOG`6B
z2Yy1M60&sG_`4B6QBjUW;nDhPgalpyT@7%54|iDAYbiS3-W%GNhmKuG0_oFg$|8it
zbrpoUGe>O`BqQUP^Yim_%|{63j@cL(QWJc^e@jz&M7X;OOF2wGO1}IeaWb~CDu}n!
zf`6;Hn3;2DFyXg5t0JZgbPfLKM#WW;ai=;aj5N{p4jX9dCQeLn0Ub;D{yuGLM3wy&
z`{d!0!rRw?#Y`Jssj8~J(XV&3JpA4m(`z=IDU<{(%&s*~#CEE99i*6wz1>EV8>e3p
zuk|)wO22=vPH-<K9=9Dpg#z|?mjfHia;fZCa;|d7D$95aWXEF@9u6n341m7FUGUro
z8liY`*ApHo&_UO*aM_<f1>X^>D={Qt#7hA@P*J_-x5qCyiIEt=l63UA@&Gq-0ZmcL
z62q*7MQ;QZ34x+?M>@(|@loVyOwdMboETf00~gPtUiMK0d?)+*eZWGlc&caPHDH>h
zB~f>ei*H<04oh_@2??OXS6}JB0OTwxkh8M~#+R4FitLipbhtS=d-nVEl(Mu{y}bc`
zfU0taMfldOHr)j=f79xb84dJ<I`!L?PwQ-4tQkv$x^*Zvv(q+CsF~?zqNQHJ6jM`k
z)7)=c^gur+y2`dXys2R`FDd2zIw{Qr+e{2BOo9g~>x#St9EXLj&*ZG{X1psU0-rd?
zMDDnuMYtHqsK~)uT3XaEq+({>zOUbiueUT(EzL*k^Hf#q;huz`ruda}5^>kXE{JSb
z5Lj7B6BlYQt)B?K43-3X#*<4+lKl2SZ%H9AupLmxya3FnUZ_Fx@l7q~(y*Gk-pFNk
zGkovJ`u4Z2mW~dtt36kv6}RNfnLk_9`el8@l?J{GV{e3`xqj-d5Xf#G=at18bBnV_
zc4@6e4e;(Y{xEhx5)xXzaA~H;Pg(h8hUIYM@azs1`QeA)@7h|T2YTy@ibHn4WrWTj
zRPAGmi{>T^SQ$#G6S`kx$?7!?_1;TMzZx1fR-nd~n4-{<m9AatrFBCg0sS#r{DuQt
z7`BRJ#MRY95C4D~>5S89)tKMOZRTo0n_xmuS_n|Sm!s@q;bDNYR8(Lghle?LD<wt&
z&CIw#7l*_F{P6jCIcsi!%$xZ0=Yz4aI3_0MpJ^>kBO@73;+~zWH7<<4l_?5|f=~!Z
ziq=$VN(u}nmjF}XNZ?;lY@+o++7K72fs8>e{HJf)@!edtqX2*h+E*l|dO@{8E3)*g
z6~{bq3_#%0|3q$Gow`k!$}XBKC#WR2$w-LD^3FapDy0?<r!ZNFYyI;_TU|$AQBsnE
zvgKyp^idt3)5!+#81v{G=8Twu-Ca;dj4pvrNOMwiMwXWfzkQ;LHPFq7iR~q(q|7U>
zk6&IE(|}`i{z#KND3_9jRKGM9W(BOtHDp!e?&*=BQuq@JrO8m5TwMGBv;!?IahO>K
zBa@|3!#`ZNh+)K&aY8!WvQ$_XAVo!_V09OF**~tXq2?6_7*St)tE3S#MwS%3uMYk9
z=X}3uF^A6VEXS&M?p&xD5f(sNVop!F0cp>!%@ODx!TQ%_9G2BsjxyNt)s`jAdL(_u
zq6Q1lM4Q8+$X?<VpfVd<_D6aVz|1^&2CL@`FLb__2niz_o-32*PWaIt7-T`q)FlV*
zpb;11&SnZ3?C(dF?4|=gwBJe@U;5R;=4vOuS=DSqU^{&Z(1@krf#HlWNCGXyNn0p0
z^tE)Cu3l1SCk--6__zl}`&jtc5uRkKhvXkM@^FA3IS^z`7mp9SMJAVBM3<TR?bm^y
z`MFO3uA3^&odRhrOqrGp-`zj#t!7jI1!WeC4?jJ{CLjPNiv=jNo3Hj65(FFdTXWcf
zE-oMkwHnKi1o++)izp?AAzjvtQi|Cgyw@K;E@VvkM8K!Wj&J;S!`Kf`;aJ~66^*N#
z+U(dPkr_&1Upi?%AI?ki3TNh?L#Yqfk_IB=6U+v3G0b*d4=E_ZJJ$lj!ovqFCaam0
zgqZ;|y0}Q10lbqIvoyFVN-s9n3zOqS>Z_NC%2NlzoP((i7qxH{8&G!sa?Ao!6{1RB
z&@ko;XLMN<6xR{HLk&9Mb%ACpx1it$Ug0n(lsGIdk1XVa7&A-PA1$zky1I(0F^8yV
zYXJ|*Rc?TcB0~}o9L8s7<$#O?^x~(6At2@f3t@qf*`k`}_{T5r=jVliI<4pEY>S~L
z>Tf&{a0CM&sWz5uIOGHPK;Yb8Yz)s?elM|j)$17Pp0<8MjNJJn*MwS*dez#?B7L+%
zrO#~Lhzd}onbUMj3)49D_uz2>9ny4uL!}qwB$4YR(KxE~atu=z+)S*By!LBBmbUKh
zpC^_l;w&v+hfCg&C6#>43vzc*pPj4Iofb_|0xrG(q)Jtk(Ytp7u)LW?>t}GS<nWRT
zXhB5<;jg(`H=wtW!}lt0L-73aVsd_RaDT35pg{UZgLr-h4&8v3R$?SR1x5CsnHhCG
zy#%Vl;-;Y!mWYqW6@6)3%3N?R(k(UpcinV!=~jnE0#RR!m~EQEW;SS6uW-;_y$<gN
z!XvPNyQ9hYzsdD6E#_$@#;E{}aSd{m4{OvrZ0V}NRAy5cx_e%6iipHi^vW}UCmXlS
z9TxgJO`V<7b&MCfzTT(<fR-s*>XeTdtnL<?Ppt91wx{(2BtIW`*LW>qWkGU!+{@q>
zl#-0(Xlm-}GRhtVohCs*m*3~kXRK+h3hth{<a?#2udnDWEkrUUrO77}rXrHlRqcS$
z-9dFcF|`2u60AJ@ohv(NCEk?StPrWz`JPpA(f)0Y949yT2WxAhX3wLy8A>#EY-Uoq
z753LHMlTSl5}eba|Cp_ma%ChXMa3%9Fgc>Hk~(QA-T<B{??R5!?L2dehBL@l_`9BL
z_x793jA~JTIzy`EnxKguVe{vs{NmzxJ)UA7f1j5G1X}<x%B%bmzo);D749A;Mf?7f
zu{cm+P?KYE`hKQ6k^1f>5;tRxje*P*9m2%ILPr|w3KWYqMU{o=mU<X(-qZkG1G}F0
zYremKcQaL}R~ac)P2OSg{RIO|V71!}<@yN{K*|9T?mj@AGX7^Lpeb;CXHiq6>scNc
zRCmcf|E?(lW)5H}Xr#JT6T{cH#K$<1Qa>vz&8N#qo}~uPf=bhg`JDxLbbxCL#RWrc
zk?sS?+o{xkQJ~<z>gELW*D-Oi2?OarGsDJ?y2m|+l~NCL#DtrCKpfF(nuhWPtT8jk
z0C=2pNCk|>nrdP}KiDyjI$)96r-%8BpIK(g3+pT6Ex1EB1b3Tcrn%>?|FK}i$0R?p
zjFAG2*4*Dv>m4lik1jM@1Y5}|X?Z2g3Du~;Cjz3($r<sUoYoOuJ_-n=I_9(*wKFK)
zz5vRc>X@WZNK8s<YT}%(%lf{6wc|H@YFsPS{o`<hr$d%Rhbq9Fg8zb*a;GKy{Y42<
z2mnK93|N@Pgwj)>0G1q3m(T=@GzQ?kdNnkdI8e}QH<+4!Z$nHnI5d<Y{)s&{mPfvL
z>V8%Bse4>4S&O;1BZ$~`+sM1wjeU5rNgL8i6($Se6{xQ^c{I2eqZ0ha#naQ*H{0g+
zPExYFQC-EF5$3|FoOCJah~y`>%{$t;akU0?^oWuDA71j-lhaZXotYqq19Smw98<Ku
zElb}GhfmyPzj`)qV82h;$r~11kSKpiWdms~50>JV7sQ9OK)z>YGDAzDKYxN4$+66d
zky9;c`n3BQxZux1CzYs;h{y!Wc$7*VrGI#ezYFAxc?uG3Co?djAe%?(xRD|9MLim9
zaQ7GZWYQ<5)~xu_F`QHGTrJZ(Q|jP&kUNi_MhP!U)<?M>JgLF1YY`(ENca9y{ZZMz
zbw<pFAibtM5XF_bGt2;->m@?jB-~6wN}1POOa!ZnlzOq-6t=N>$ZxxluE!-jd_ad&
z|5om+dHx=Af-`nJjW#zY#>?CdY_wO>BZZJeAcNAbp>~=8#FikL({G0C44~#@RDO>X
zKC|&&GsUl=K*JVbgG;n<VRh<YK5=VHFPjhx?k|qk^2Lc3H4H}G;ZDSjp6=s(n1%x5
zuIM~I?!gXDudk)JU(f!=xS0C8BuSg#CuwLHJ>kVL!Zw0|amnM>r{vd$5NUx62ERu3
zySZU=+G(}ToSj>YV29BrDVtkOHb{2l=bHn$SGu_UWm84oUO-m@=T>86ae`ck2`FM^
zr}s1YiNRa~M>fK9D8R)$g)(e^2YP^x@6r=6O5CG#S!K9s7+y5F8L<vQ0DZET2v)>h
zj9^i03g3kC%kE>-1z~M|MQxr5cM4^&8XrY2AheE`3b(PN>>okFQOszW5R8*#NCF~c
z1hA%orw&Fj0|6-`CNgEjECVt(G5Arp&gR9CmGZDsW|<}8;i(W>clUac(S?VHSwS`|
z7-p`fO*kO_VNK1c*8bDscP8$S1$eZ;y7qR`OfAaWqm>wTNR?w&X2qqWRDIUkWkP;c
zQ-rsDL9Cuz&(ewfFwV;Zv>q~{5N5OOwuaXk>0g`{_~A-nWhtW8w;4;{02Pvni3vjd
z+Is<vKZ{lFX)vOpt?10`-Fi|gbRfR%_JeBqY5|Q5;WY*lC|U~m0g7lq(ZR)PFypen
zSe|UzB**xyq0(4<p@gUf#`AxRhQulkSNkSM|ACc~F+nL&De9ukVSyoAp_6_@_wY_H
zH8wQVERvyW{UPdw;HVIIn*c?cfv6*NgZ7d@yqH&4>Y$gwJj%Dx1{wx5{_(MJB17Cd
zaeDwDlnDmE&7ydEOmr6k{7X|3Cz{$08f8apb|}RuCrD09j*b@%>m{g#t_n7GsS0T<
z<u`P&vVma!-lI%NFc(TxSZAz-^33tw!}|Ru<rfKr%9-Gbov2sRi;OafDj`5?K>-v5
z0sVv`3jzxQARIc?BGf=qAbk2Hez)uam>x($6Nd9N<@S>ELnn2fT7(2=dOJL8;Zspe
zC9lGy%d-fJM8E`JT6%^8*rI{ho~y<w0V1YNQOdKY^(&Z3gK<jL=z@~%vCg)%e@^2J
zT`jEprM9Uh#y!hs=$Rn$tTR1@AX*b%<?dr*Ai%x&LJed{uSH|8*z+cJd;*}!ON~uU
zjDdaJTo0X|_<d5ZM7RUa;ecNQWr4~^+lhQAT3mjfy)b1ZO74m*FcurtB(tdDeaiW*
zTF=eNO$z{BC&t##OgE?BYJ#r_U%#zPD%hY0Jc=p2`4{-F!GSbU_FX`GZqSM<vp|8a
zk3T4=$QB|4f3tdZbL=BZ+!W_Kv^kkzb?PV2_yI8cB);`&mn`c}#m>8{hX8REr=CRC
zN+UoE`(sbI$!YcKPP)98bDS549glo_{e5Db3_$d4Nfoz!g>Jv-8$a2$<4AQhwc6r7
ztR#}gDFyE}#Q`~KgKL~mR9v2*Z!AIG^+|s61VGB!v=9jmu*(>ByljjLH;@k#jR|!t
z(FF`zC_hb%o4ZVLx~M2@<I`xXd@I=ClNZ%Zj0<<`v1I|?#4gi@^33Ph$5ruc$idqX
zWXEpMvJCk+gu|dnxwfb<neZHKnWWX#QVe$5OgE2Gy=J?VgbTH#d&hgd$2~*?Wfe#+
zC$#|iY_^8eQ*`Ry;tVF8K!S#kC@6~7iPdU%H!}<x;ha!V!T?aiuDv4`>uy||azF?E
zhpm~5BK%y_wN{QxSZT5LbT@8GD3Lb@uy(RW@}eYIjbOs13~J{6NcVYKPE*At-v7`%
zAiZimfL1k<*8_0!VkNkA6>&}(1cLoqR?YHk*0#`|^oxXANQ~>gWQ^iiK0O8ce}Y$b
z=SFy`a6^7Sd9e*|#ybDd&*2;%vfMHKb5gjL1~^5oAm+B|BMxg+;-`bm{W|1VXro+V
z-{=XRzv?%g;T)lL+}E!VW}roBDgBBvzWA4>@YV}N@jNwD*ENmB6%9evUK+Yfq9^0T
zxD?>^@$qze(IC^bscuAw`OK#?NA5Vvi4eU>Ou~9or5+je3ys90p!>blqMkKU@Tu#o
zOq)HT&}{cxrU<vyu;B!Xl18P(I6!CXJ}H$nIDww$rx^qJLD_v)s7W74*^{<$+v`eR
zyc@&p%(|oVpQ2YKk!~8zt&d2<$-2#PXS!(cz?mFnq52p3FUv0;ALr_V4`yc%M?OZ4
zW?b(ggvJ9RLC1~$tY#oMu^TXDbHZHutsE00ks>W#0E<Y3k}-Sq2M8M#d4i8(inodt
z9VOh0cC=%ax=Q!ELmw+3GsSly4|iu6+0{+%>_jlCBrdUj=GQ+c+W!}I4rM;n${0uo
zI7WcGWp}2BKdX#Y6s89!r)CsAJvsDv6oEZPfKDv`V4Q}%bzeif!r*n#$`NemVq)>n
za89f5fK^SwBs|eGNreFBLLA*|>u8%_SP}~CJwcS50W>6lP=p+|Rs{=CG&ZK%VH1qs
zVoAk2zO&uiHK8X>0ZK;!$AL-9r}3pF!zRPTxJdJbbSwTDB&&Q|(nzVV4|i{l2U#jP
z1v!IKY5~1`%k8}V{h?<&ow?O)t1m~ZzketLDLlExkxY4J7udXU)aGx&O#-NaKOfDF
z(8Y^%l~y`IpwK8GH>-RQn(q~bNp~0~xu7$`RC28n{QCdsNF}-ti%@cS)OzqL*;C`9
zna^Q`W7STrh$9FBo5)&>-prLn&g5@gc-z=H(IgG@I}0iIs9B@{f>^s!`-ooLS$><Q
z_kcYpRaY;30Bs#02j{aG0r;<O_s^d>aVa{1eT4PN1$2pk3QwMA1jBI25P+}hgpoh&
zkWaiwhbA~jSTpjtcn#@R1pu9NPxA&~pt(P;qyY4N2Hf%A6s%E^zZOjKmz)#R3h=t?
zTbh`p>-xpGGY`nQOI_B>G5(hucBZ@~rC=bXU|(V@puyo-0%bb^2)JrOy-!9~(KA85
zn?CC;JfuIb|Nqj`{||-yTpmX@r}EUZ^a9{sk%IFkmo%9(l*U)YCEOH;ghW}jDc#@>
z&qbptumj6<x=gPyOZ9cT__rq`fM{Wz^F90qGZ5B)4oJGn%6tg=+w}>CTe9W63OQVS
z`!skDDfC2?-=%>(h%&n7s`8(k-5C_%ZC{}vsMyk={Lm(~(78cW@zxyA_^+$Lqil<-
zzqt_v#%~R!Rr%diLt1wzy@v~VvK<JMMuqwQ@)c$kXet4>@*2nlbnl70TR_|aK2j5?
z0RNv3H*L7!WmDqg#!d3Vy_;NVacMw2D43JnX3F(6eM4}#*5-c~2NB(2`0t0P=mPpA
ziNLo)71Wt_hZ^+Mgqk901Lo}6Y!)NHL<9#*A_dd1iwL5tOwDTo;+n#&QKr*$MeFCl
z_S)Xb7O}@H>M&EMSV4pm=#hh-M90AYxxAICf8@;XIIjixKk%X|>HBWa+h2>mKkMh|
zZ3q9O`~QDE{4T{r@fQ#ibu3gg#{u1pD(5xtpU}b1B8JaL%R?KgBAtM?Skag^n;!U{
zn(XJ{+F&q&C$K@#AaJP`sJPP(k$)5yhp&j8&|f{xT#=BIvo5hwFapB`(Eg7#Dhva*
zp`Ap=2gY2r+_8ViQ-dG2sDXNbM@w{2nZQP~>66T=B!N_J&fc2PFGggm@%)U%n~DWR
z0jlZjqo(X;@$1LQk&Wx^rLGyu2h6LMk`|lN4+l-{+h10mB6W<ta~Pj4mcCQDUwP{}
z52bl;HWGPxZ1CLwL;qyyQ$Zu(H^6u^S2K39ZhqyWn4juf>f>}XJ=VCB$$W)5$_&iu
zC;I313wzV?i;DKcd6$JUN!7FLPxqM=vJG-=k4^TCyItrC0xv18mX6<2daq(x2_m*c
zfoH)_Scf-*;NN~1hAlTEM;pGE6pMFHh6>ontWThoM<t5(hfTJYt-i6-;=<e=d(V;g
z`EmBk?K!D|Eurn#dLdUW)^8E1t1r7-D(|@t18?{3nVChmr}K($>MNIrM2#EMe4h>w
za~AoeCe(+LfCZunn3ln7!DB|*=13>j$jHx+D01=Do&~T0&Ko$J;)ML+dp)Q#@UeI2
z#{Ba=abi>LO!ak#>h)OhLS!8O$?;V{{Oxp>F2S^(*I(h7;<ho>x^wQyE7GSkfM95X
zmk;wXXMm}8B!;k;?iR+kd2zW2U1y&3I>SDR%MDo+9+Om@r<clbaEShu9)Sq`DIK|A
zJ<Pf(g@s2M(ewkJT>>m2JfK$o=|07!&lzY0XE2E<KDxtgcN$oYS#VNY(N(-RL3gUk
zI1rO7wH8B%4yL#MNL)+BTGR)}){$E@1R%P-v`s9ElGPb^r+|g%9bF>{oIfODdeomz
zc(zA+-&p0;bQi!DOIGjqmIsXe&W~==+P`;xQC7B4$PE_Rp3Hb|sdnCbClP4Ftk$~D
z6a*-~go)dHQ!YYR7PCqW*`ixL!$q|zNDS?oP<bm~g7`v)kxZcDcHz^OVSR;(b4}O9
zQQYxx9Qw_Eb}jwh)7MXdYa{qq+~46?p2OMa#KGB>Cp|U(O2#61s&KsLsKxValwXd`
zz$a_|-MC4qmM^Zh5qonp&EFkvtehxkDObqaVnp$_Uh(4g<l}2xtIUy=2mOFq@!<aL
zzzxP6d%fGiu~~6*{)0D<5mbIhX}?)pzn(oDX64*4h;HY%?|fQ5QE~FSTbT;jd2>Db
zj*%*pHNMfEK{#hc0Zv}^Y2|TJ8MbetsR=Kl>mOg5RJ3_?V0P6%Z}R5-Sk8+nZ969}
z)%%^KVGHavYQT)5FNps#k?sEQ(f4K^FTkmdVKDyjAwI?i*=jz-A?i0SwaKQD7h(E&
zy6p0xX#7*0Y<oixrnp~bMfbUVOAgHMnpJFjvgGZ5!~mV$MB4DY&zYH7woV5Yf`&~*
zpO1VIBjf*D3$U!;1ds4}JQsYovoh*CGre{-wwifm5PYSoT5bEs;z)BWG2qO%!BSo5
zvHGm>paP5`a)W}kjXp<Rx*SNfW*is}LrHWOc%vy+ie<bcLOP<-v=|p$(~%J8{kJxE
zjqXeCv1<E2R=7Bh(U|$N8zGe&{11Scm5;BV0J>UMR{g@1{Au*^kMbKfB&HV{NN__a
zs_r*h<xGNJ_RGh4>{n!Hv@fDUA-oC8c&H)ES?3Zys&z*#f%IQ~A)%&&BHPD=gisE%
zfqxmTV~g)<cob8ysi*>7@}S*i@mm|RIqPuioSjHUhF=VO>+<Ux8#itPiP7ky4P}G|
zp`Ohlp)HR-to5;mJ*mp=Tnz49m3}Q@?j3DM`Z*8G;WXl9W<yN_i`mCQW2&MNJWqv9
zA0ND+y_9W_7pUxu<c6F{c%p4@?X0Lqm9j@3zrG#{Qk-stcF(LN3y2hI6&*!CRE=DJ
z6;EW3BhuShmw8(sh$HQ@wMFC&Xb;EMSu%wkg{cD0tE^qPm~8L~Jk`UuqmVHVA$#n3
z@AL6J=gFeW+|+aW4~(S}u*d}?>eB=;$^KlGF;A+BKMl?#F+7#)Cm6IjYE-K2z&{qX
zR`m-LZAFGegA#kqOvjd6ZFotU!DY^KzJ|Rp7?1s^L0b;5o)hF+VBmQiMs#E;bHl?O
zTm7Frt60*8B_}Kj;o*e*z=4Am#Yo`6)A9|dG$9}t*V=UK4-vSGYqTNQke>g25|{l0
zDviSTkm&y(E(wo)Jyj^4GUv_UOjk<BVBr18CY+5WO?Sf_0`g}sewj8EI^qO#sxhn4
zt6C__NlGEx5;KUA;b`&qKRG#(E}rq#MyKf!|4=%W{};}ct`sEh1nx~tl2-Z5-zYSf
zla%JY#c%NYBSpZY)&2d5jmOrdIU3C%C>FB1u@@g-DL$u{VPR=uQllrr$Wk+CS!#cJ
z*$1G=PgKTZ%rqelYuC3o=A5Mc!~N9nc)Dwvl$br&%uX+9s5yy~1~&EHhF}Y@26sxC
ze4~_B?;n)ADgzY6f9D*M>g$oBu_42gcC|=I$Q#yJ$7RfJgUVylrGM9ssHi(>djca>
zsSo?Z)CwuD!+&J51TF6h{cRuHk{VD7iIGZf2nH2@mX!Irqa|U~ah>(jWu8KpRVe4L
zrA*^%BJseQ@8&q`?H@`d%U4J)wzYqD;^fo{P?lry{lZ1k{!l)RTDW|0tizfq%F^Lu
z8?<}jb3bggkM+Nr`KqY6maf~zU4lD@;O^SEhT!fN+}$mK;O^2i?(QB49vp(ZySu~f
z^N;_^!}ome?YADg_Sn02t*TnH)|``(rDPP+13LVzZ(KfG2afklc;d+t<@_W>9(@KE
z9+Tx95@@9Wh4bDs{2+@9hA)EW{7CD<UE0ie9GrgzD@K00I8O|$ENHRt;%#?}I!fBR
zS!ST8_RfOzwj5Sr=6L@!Apfyl;aaX=l202iVv#JF*`e$+5r3s^C3cglTA65Ql~;3Y
zM<epMVuJr|cHO(uVb|<v4jD}vHKg}zL%D(bxT`%3&J2+gpy97I@)#o_`0f|(?r{hk
zP3c)x;^ZmwZ&8^K>rQuIEc$z-rN&cU#b{}nnpb%q`qa#GNQOL_e$0u^+(*RS9eEMF
zOs=70oRsNi6`2Km%2#03RJ#gbV|LzPK^SGTdV`QVKiiTW0H2g*sgj|*Ka_awP~_wu
z>8Nl{A{g(xJX>Uw`$<bvFs!9|`+yw3o_jchH=zp(hRk6kqlWyTi~z-_Dr)3c*z`tg
zGA%sIXTyR%ja66MuK=MB-jEW8s{N)CnmTU1@tP^j=?lt1t&H(pBt2*S+kCk;?B>gv
z*<ccpkLSc(<La3h1o%}kkdFo;NBM4HmdRxPu;1m2iCuQmMlDXKZA(c6cO)9^4Uha$
zWewxh+<t;A`QL8UPeazRYktDl%y>nw5~HdUWeF`oO2&CuA<}5j1o##^8Qg8BuK48)
z3X!3BDNQ61uJPs2rKchpqg*9XCx);w=;b^=XI=zt*$5T>6%VFXy_JrIMGY%QJF(B2
zU4E?RS<XXu`T2eZPVVNTv`6r~k?l9tX*}+>u|_CrsrdDk9g+@(O6Wk!0c&NHo!=0x
z!!SNws5={SBMUAK^E8><PQ?gbjkCB^TW-{X&Gl||CjWMe^;|TE5q#KiPE2I<R^(jl
zyQQZ7ws8-48!~ywdX+AIoa&r(T9z5e!bnRrGSb=->`#_?=Fm_P-AHEV3{8B#Z;%%{
zg`SI9@fRXCz$vo{j{2xsm?;PXNqA5SNkBXw9xdmaCN}zmxi@$C5Xzp+kE}hK^||Jn
zTxED9JN7)C^!>an*@&i(-S|ismfv4HM*Ld!-z2+&+Ux_L;qABk77l9Lazo-oekVrc
zZ1Oq?Ql38tFCKyjZ_GrFGhR#ixAdOD+C#mZO^0(6@^FS0(jcyRMS{L$p@Fk@z+wdW
z4hV@46R%l<u66KeQAfA9Xt1xhpBYA``c+VttKEw!ywOK<nj0?HC;!LmhT}0Jw%9ux
zxaBy%=&iGIY%BHJqSt}#2-7F$8aPzkBeq+WQ1?o)?}_6Phf99%Yeb4Z9ukcSw`5Cj
z3%v`E8<hnIeN;z>9*F>DL|dV(5(KUipKw;1ze^oXSUVPHlxiAm8&~j2#OKD+4s!5~
zu~f>ATVAtDe%Ir=ia@{s2y{U*QSeJo6*&8y*&BamgJ?9L5BI~zlk+*xkgLq9Kf5zd
zqzg1Q37m=2rVXKc=OSZ^Odz$zI==|vc_A3>e#vs=1zJD-IT2hJ1mwUQUCn$!SfLRa
zvb6Lu)HXt&3gI#TQ%bSwEQd(riAT%Bx(T{Sb>@?i!k!MBG(xj@;&5zVTT4d_L?aB-
z;`HuC<)Oj-AW(PjaE7v4E&YD%vE|bCz4MN{Zr(;%!D=$;jcDiByML(s@LqL^%+yUP
zGOW)@UG{o^<JCqz$AtHsxoQv*r`s)C`vTfvA>S}x(+@|H^ufVXf#_!og6a)VmAiA6
zSrl#){<Z}2uB?&2*bw!c!Chm339`XMw7GAe48c52*4hsF_8J-kcYDlc#5;58{?6yO
zKLW)8+)0P93mR$IIMBx%qooO+e_x9Mjj6EnO3#r=p53yecazt>z5ShM)n$?&&N)*q
zZw-Ro|7=~q1g*ObQxEmv#;m5A?9EA1lB;uL#v2!GdY(lZ%4~!RuaXx_9k|uqwZi!4
zDU{!FUfaR2I^3vS&WZWuhd2YPNSwt)H3GX(+}Zl9jg6(4E#}52u=%4!PXAe(?C(%e
zn7s^&YbU5X(DwFEN<of+A<RhXaV0dAuPM2{&m{3U=+5zkGYY7zxn4ge@gTlMwLVm+
z$?e=*zScrFBJ)f{+a!nY5{vgZ?+x0Yv1(Et>@5oK@>|NEGq6uqlL70UY%b&Wp-)x^
z1G5#_OUkBl$;5`zu6ul47aiAzJe5Rxr&=sHJV!nr85oipqC|`j{~T1aYXeXZ6SXb}
z#;62@*uTR|p@JDq47`u#CbSQ_26Nvf2p+ffT?FE`QnGO`1#NR}XX9ucf#a5OXa$}h
zTY|6MN0q`3aHzASx5x#y=a3XHY}#@+Oj3(zf*8hj%bVvblKq#YkrJJT{Y7&hdIrLh
zmg|>Rc2q*H<Q_-+&!rp6?OL6+73nJv`O`ll1O?0xAB3)8kQB(idC577_N+dutP>LS
z4=QCBdgef$HsLm(<5~c_F@aL!(f7V`f=a>{L~CI-wKt&RhIIX!Og2k0ac0<K$r`);
z4n^s0kq0`*xX+KJ306>}xm<B()axP~-`tAh3`iO}8*NIs4ZO3?1V3fdhN5nDA#7Nd
zmGNE(PG|mpZJAR)9}&VW@Oqdwxg~o=zR@T3t~Ywa5<FH#v;$^|iJf>o<mI8hc(5w^
zA|q%i9PG)E6;9?_rf1In9D3%>-z*7CGooQ`y6}$&x>&N?{DHY8yM<*{GMwm&etpx`
zivq5!JUNf`-FAIA51#*u7&2<hY4>S;_L!To`h$3Up8basMux+q0Is_j<9gyB&Wa8H
zWMP<`-6YC8@AnWx$=&YV>rteyURs7eRm8_R7o3e7qVR&;sTnJAwKhvo4#%t6<#0Ep
ze=}Do(QExA0v7dS1OE(&#Hu&CRhOH-&;w;AmKTYw3U{6^(!_6k0#G>?z0J)T9;!#a
zwGE5jh!fA*yVvb2<6%_E?__H%o$~r}<|n$m0}qU*zkvIhLRl4xlp5hIHAJ#2@_WG6
zdsV+Y>g%gIJ2_&+h?z+k8#no7dGfj81;86MxS5*sN&fSLWEyfg#a)df!+UjmWw#qv
z1IjaTL%l412<qMO5Z<hO1#_Fwb&l$O-`<EX)pv9w5tt=H9jWNBax)8yA35Y*MfEf|
zjk+lfax|QjZ7@n`<)Z^n`Ivw6h3=G?P4)*R?HCrZTi8tB*^fOOq|D>YU1$eBIXZ|w
zD590_?$Ml_B5k{<Pt6tE${6vC>-_1l<1N3#kxRXxZ8Uc+_cp5;oFo_F4xYUot>Ifa
z60!q=V^C67cYupY7Bq#*h^-Tqmgnsa+8RzY_B7A&p^>=3Q=0?!ExeSL1FT~r$v^tc
zsqb$2IaZN-ss#Q%o^n`7(;90T6gn79JV(PfT5C&g8}>`RcAdSZoJ$TUuHFmvX9OcL
z4Br2hZr;Bi@y!6*@|GzoGh1q3-5{%iJo7`0-VdC~EUp|^zPNn1iK6tmk@aH;-EvJC
z>!3*;e|>zDRy5PCTQbNkb}?QtNjziVQ(J0&qYB;prxSVorhasnW=~%5S%CC#oeEmS
zCF0`*6>bTd$Ajr9Nn**t$-LHg;<E=lZ;^)Cx}wwGS$Xbx#!$bxjBJy39lyfrd=d3M
zx2v|x-^lWPC*xsVMRiB9hWLsqV8|36X=&iIQgM}lZ0d}Z!!_Y{!&;$qjj^jTLi_w*
zXk7=JjnrDwiU`Gy*LTG4Lr?JFr9Y(7z$k1D^$sv~1jKp7>V}9bCbroG(|va26T+qk
z_Dfode~3k%K$e}Hb3#Rsjb}YIX^?#8&DQov^NnvOG0=Ft`Ray{H-_Qxs*5cuzYW3;
ztoYj=iH@C1fa-?s-f$d^JvS-JD?-~%>Jh&UFH;>Of|YA7Wsnz~k+^#GZeY%eF2n~`
zyoC?8bf!?O=Qw-Je2e^|3K!TwZf2g~Z+)Fi^1%O|{>W%A?48_0Y-E1)#2Oj;T{Li&
zo?idaq0Ef7#P|lIzw$?~CB`c4!PT+t@a@?L02}_v$?lGcW>S9=2^x_DWX-X!r;F={
z9z#YAd=d{%nFNESnzxm5b$(QS?wX3kXllQ;6g|)@wNiC1qv;Liu4Lqj08+->-kit{
z>_JNveBYMH)sYyvSC9K=0h0hHylei=?`g*W$sAcA81!aX%oqrc);OH%CKn>o8q{*$
znMc4X6Y|<y*i{?*k?yMcg`SJ+P*L`?l(pD*{y=mxu@jdLv1y#T8hsJ1UY&_OBTndC
zl#ZA#7~kpgP{OLwkil+_c2{<M;TiKZS!(M6TEVoXD5$q}v*(=%$?=RH&p<L76w#*m
z1aFf=$)@6j#FOA|qxI&tYY+D%zk8B{mw-sto*&W-Jl;u09k_N1%<vEV%|7&-`^ckZ
zJtUiPKx+DrpPm$LD^Hv@e5~%(LvevRhl}%Z=@%`yZH$IgjBq5HQy@S{s78$XjjC6R
zo}r`kG@aLq{HhCA*sn<VhKX^LlaP#Z9$xDZkCETT*b=q`rKYON8kcuaws|t;t!L+*
z?wPD}$I?iumnyCDaUVf2mZxS-Tz}OMj2&Bl=r!2OPe4;kO2lhUCV`;|Q$(urRi>!u
z@b6nrlY;^c`p=jeVNyOpz|5-FFTc^@yfuU=bX!@|9DDqUHh>kwRJj!FfyX)Zkqz)+
zV^_E%nl-?o$5QEb>(6r#>41Wd4SeQv9xQ#lr?6@dD;I(3V1_uF7gS26=}E@@G-N?_
z_#K~SxI6wbd3`x1|Cb}_(e)JDui;|kL_%SCGP|&+(NQa<tvl<tYZ^BX*<c4{Q2O17
zUZ*DqzJ^xZv|4t%*Jlmp_P)~n#DqN>J}OK!YwrUJfKyU-c7*?=I9Y%zT$)>^+ZGud
zT;r<WN0gxFiL_zB3ktef`;_GU!HE(}^sfr1rCgO6HQ9$M>F`g;!lg8P$(Y>1ji|U|
zfbs(|=V8Xqu4Je4fGxOo65=7b$+Le3$}nel?2B8v4&fl1*WAcadRuf<M%dFnS+w_#
zIazFA^i>BW56%6KLaup*PB9Avb=S{+vtNi>R~x5b?i;LIs=3}h<xIPM=KkdLwC9$T
zk`PjC$OeT>w!w_>l3GQ50>0;3N>?EEN5%HQ+p&&DXZ$)sIE&1!a_i%x>BQ-3iWi6@
z_%1okUR#7AB;mRQ+NJ3$8eTbnLdrYD^}F%J88F^mvM|(sFuRt|LLo*z%Y@~i3e*G;
z6@&u*VgLA`FeFm%_}U{CuC;ujpTVQK_dG+dAJtYLOIhN|R}wT>ow(n4^EP6aAN8DR
zL6dJr?VAd{o72ar_w^cZW@OT2WIv=n9G=<dSXSk=KOo##YBN|mw?(Q80+I!0|M)R2
zujiJpETOHt+W*F%LCz^~<MeR(id&ON(vW$Ua&G(u<P?oeAP&0vEyT^&C=l8}wqZrx
zDA1yQDUHH6GkK|%k6UFJwk`N)q{+j9d=?bi<0C3|pcS#4urJpQm?#)~;ZMyCV7>l&
zF(?V2K6Ro1t6n}ljw^ro`gS=XFuvv5R%(T0vl>e?Ko|`DPZ}w)$M!~%h*0@UzF4rQ
zHY~3HKi)Go9vU4{31=0X1yDHH6mu17TaoxL^p6>Dwb}e5!}9oaU9)FXr?2TEHar;_
z%5Bn3ofL?17$*XR1CcxKN5I@qJp#&|<x}R$T0t$<CN~-wDRL2m_zmP#uXp&64XU&J
zZ=HM0H?lo?Sj`HBpWWzi_!-Va;iL2U3;2FcFfqRO`PJQcjZj?28&RRMdW&wo?xZVo
zz4Iv`c29Eo$;@}}0~J(@&$gQR#*$ap>R6_{F0Hy4p-nYE)1U=5zDkDf-*K$cYBg|G
zLj{L6{ca0Dd#RbnrE{{u0Q98Da}76NS!RN$<lc>{!6MtMjj>#qn;!M_pO)v?R16TT
zxVS1E^2K_F<`~kO9Ab+)YN6mAVZcEw=qOb+3BoCj1W-vi5n>u#b|MGAp-Vk@`DvKv
zZj_)5>IKyCD<)d4wC6z8?~1A5(T=IU6l+td=IkDKRP{0P>ihe76`?>gZC95EYOP49
zMSC87mdU=~#70;5N5tuCHsd1Dzo1`KEV`a}=z|eBuHRn5$3DQLd5apI4}YPX4P599
zzOEiTnr_=I2fSl8T}RFCHu+s=V-%1Dq~+vXOPNMkzHBQ!8auyI%gAK@)+4;{)tg09
zuU)C4x-jaobVc8mG~bAW&`@&|1ldi9aQz!w>$evLUQmPuGPXWtF$~*^9C)AjM;|^A
zV26fmm$)W^-GVeW0)F?8cXR&QGwr<H^Qw2Xr#jP~C||p~>b4?FD@bfVCtgP)7%r$$
z+MfPLD7Igl=GPPb!M4`Tl`jpM_a%3L7YAmr4aL);P1pM+-&NY%I^Poa2Lg`>XJSov
zdk&Kx4MM8)rz8!^8r|{FKIeW8fycN3U41?CvXh+mHR7z0g#96I(A3Y4&S=69%F%_d
z%^S+mzk~haYo~b9yQ%(=&TAj?AS(H2az}lg8L8#oU`&?n5x<EFj^D}ZIB_uXr)p2*
z26Gp;HD13u?rt#`TC9ed-|=;7t<+=Tdy-t(BAI<+v`*tI8q~I<IO~_By#=g(6Tx{j
zT=#CVG9Ud2*pn_tRd}rX!Y{Psv3FZnTOT`VmakJf6Ls5BypNxUL(6FzJf7I41&K#a
zuZCETgp6WcT<~q)9Nfx?`romasC@kF<8tbp>)R6)*Ln8OM!$JTkPDw5gFTxT*@;J8
zuK$WQEv5&kPadX1xz$(f?l0=#9c)*N-?$Vm^ONn5Ho`+ViA&ysQA#`4;=LITJ7KU!
zWSv6cGA@;!c<x6tl-QHYe5wm+0#`bAOo&Qz1E*C>Rwv$^T@|brXuG=tPySkXLoOsv
zHV;xabjD3OqpObkfMnq}gmMU7;D(8n(@j7KmqCNR$LI(}1^(!m!{*xcP&hD})iW(X
z<n=-Y@$3pOX=Uj8kufTwJJe&wUypTm|CdmdoH_)g29$rZJd|dX%7LQy&RiQ+=9#!>
zg8zq~J^Qp$esY_5z1!tdGcijMfuBEQq95ss++*w8GI1JDD<Q^htnp~C`_lnolv0Bw
z+{h2K?17?Q*Yu`Fx}lc7^OWoXfOZw0i|eSxi{^gV0Klc8;p*;=aS($c1oMN)o*Ulp
zkq4$?iNEtvZha$poZAA0&yEh5mfLEuw>|M^WJ|%jWp$F}vFc+0a;I~LAZrO7@yKhf
z_K)wsjiG~rgrY()_f&LzwbK!(h2A4EP+<Oy57SWdi;>~oJC2Tw{Wj(rnV}1LWOd?K
z@nDwVZ>PRsANq9nTLg7Z<P_e2tPX~n5{e^9c^lo}ihT%x9u`~~9nC?^q#WBju;-GP
zkr69h(WgEJq(-3_Y0cu|dRgdschBZFPaWO+%t?tBRdh(Eprf*{bck;;K29yf3|Dby
z)9wFBJe)WV(n5$iq%t~4&neYlulPXqcP2<efB|CT!XZiXlaBM$gE51U(9F`pOEX1w
zk468V8ibwNrMeZn$0yJp0|!Mv8Z(eFsWKYXu30WHUPm)!MRNi2O4+GF)V%nPMn-;q
zetTi5kSB%eY1HkSB_x3r9Qa?W4BODspm{)WpmA|cX#wdZq~PJ7!^V)~^}IQ2m1Gz9
zWm!b$U>5;!tG?nX56}aI3mT7H(+rrzNPBUj-*gjjvH<=WX7Qu6r}&9kB!<2cf+?QN
zhlCILN3GZ^g-9V8k>vDA98qPPO8@8owM%Z<aC;dwHLPM{VvkQxCTs+N+LbdibMu7E
z%&#6E%|nckSJ99AkZgtcV1KTV{>DZ0MM3F6UY|rU3>yG842z4ynEOmww{)5%=#JH~
zcFv9f>CZy`YFO02S1Pn<A#vT>V5y>Um+#Xt9=m2iE5uCNuq1!B+{Ev3O2E(0kFP)r
zDX=__-0|ZF_lVvd&qYK5<$Qdese4q@%gYN(O0e-gQ;+8=a>#kG#Sxv)M%-H^HDjpw
z`Qf4lwsqWf@S;L?cX1%^=A(%OsoNC05VLf3brHnCb8v77R#Y=kQo;mJe~*icvrK^$
zZNAanxw8C7DaZQTN=fvgJoWCXQw(fNnl*i?;luIZhm$aCa;Of8Ye}<oFLUmo00KcX
zB}$NN@LY%aC#Jb{S*YBiLKC|?$=BkE<OP@a;NHrN-Cg~UqJbrT{-3Q9U&56n3+8+@
z(~zZ9*a%Q(JNEF<$@%3~RqGF^AVW)&Y@_u#_v&o1@x!kcaJV{glSXWWQPLNpSux;G
zDwK0lRL;NyifO!c`~3N{U_}U|PC_^5M31rhA<l+OA*rKPzLnTz$}F9R%k?o<t7@Vc
zgARUwmU(mYVP;7~kx~(?_!<MT#*C4MhJohue{QsFf&>!b!p1Y6#P*d0>@v*<Bkk=P
zO&}z~>sC~SDk29Kh7e*jCA78a1lB~bW8r9TAI>&dX>UU?&2`H{QAC%Q)C$4iEgk)1
zKY#x+JVIF?-DPeg_F_6@C@3fr0k8P1tkuBA2S|x*uSaAdg-*P`6>Z_|gK-WDwyOyi
zG#<NT*Hzld2R*j`O04@YaY-SQtF83?;&r1z5s_k~Adp-C>&mbiEfNya;Aq8Tx5m}=
z_2*7;zM*%4$b0g3SRF_skP9h`M+ew+C|0G-g&G<friQN*V#o$%!I{FSHF#dT<2J1E
z4H6l@Advys-Q9J97y<{`Yz!*!YEaVAVL}F9x<IO6`WqV&A~JFzq~`bd_*@^jL3S(f
zh8z3^k)l5(<r(RX_{W+9ZNpGhVb>aXbJMt7y*j98lvp4A)B{0BC!^Kb^>9k8QMU>;
z42hzD<2DB|4H^==kf%ZXoKn``k~nKTWmH7P@?>X<u^1pDE&i^yr3w*ayRE<Dhd|VW
zNEDL8^bZIB&g|El|DNDQN*_Oto9$NwM<Gi=_z8{Be^?6~vYgo6c1F({yeoaIU+4Ql
zisVc?Ewm1KT>AlUTtC+ysBOE6MN^0^<@8}fa=SL_Z3jhrM|ZDLD89<k^CC&>c6J59
zj1D=0dK#*6tShFr&i8+2f4FISya~ikre){$pA%Rd_WmUG4S&jC7(lDQ`qE9W_t@Mb
zqV=&C4VqQpe6$*Y$C9(@K{ZIPb^kQE&{6jd$AEKPzagw3>^|oM$oC@VFk&P>P(l_w
zG*07l;^8s$I(*9xF7*rchoz9bN^xj?Y$^&o;JV*;D=@MppIlZg=y)>BCSD4Pzp3f~
zC9g5+d}y&O+?%CUI9ZC$9C)8iOr01eOt|XlwDY5PSW0;ppiuQ&V%N0Te>u}5QhrH=
zpC!H&8ZrP#X9{x1PXCDVI=nCDI=_PN0Cn}X_GmcPW*1}Tw^p|(Fu{k^I`~_=U*fN4
z_-CQ}3t*`qDjQyPr+lh?j}H5vT!5W}dUg-aI@^6V6D#}MdlZH4=D}ZnZ2n}n^Y+HJ
zr@DBt<dQ<He~2S9#s;q_2_DxcE0-EGz{L1hXKMC{GvAvhFuUIU=-h44O^!!WDl>!=
zmvv#lL-yaM50_!x2<65i)2ua1Y4>K1BzUR<f;FY5LR<FAB5uNCm;UTSYzKCKz&{#Q
zqinB^HcqxUuSBu_Jrhs#p2A#x6{8u`k+ri!t+Tb@+{)XBwf*g?EsMRJTGE|86skbH
z)b1_B7~m5z@pSX6c(0vgAgtYgV?Pa7#V$r?w7zU|rl}rXL0hDFV8TLuT-=ih@u+XM
z>c*=)7B5<(?WTyHDQf-C{9)1S^}Wz6(=k1~p}m)-2F?t;W}Dg2-}GQ4H>!mA^Zq@T
zy|=cTmX>NVPq)7fb|XyaW*yE&4yGfG+BR!zV4Fl1@nqR-d(q)(X(z1>0lQ~=>X)=J
zOWy+F+e+<Ak1jVaYv=-Kyc^{bO|BE3Oz$nQ)rDtXlN&9m*;RkZ;anN%c*n27SiS76
zqw^n65(>yrp0_1iq3mvsYl)f?#Sjyw*oSi@2_e3uY4YmNH;?jUr+-6Y`??R}PhRbY
zBMtw2HNf}bX5UMDoUYaaa-=aCS2PIp(fUaasqGxDHFKYZzW?0nLF!zcc<4n%Rzo$b
zdP{$3;n|x@Ysb`=G_5I{4Rg+U7`$F%Tjq9@UFk{s)9ERggC2gV{iI8T8kixxWaR3&
zGS6kd7X0aA(nO{ldD&LK`ZIm{O7|FVL9ouF7jI@$S5(?V<7S_;L}_Y!kT-kE(Ncj$
zfRdPm*8&-raC>}+j2jox8@1zH)ZPGaWx8@Si7Aex55IuOY4}SCWrRds-KhZBRTe|#
z>aK601ckgZ`kSpCj_rZ`=I}l46m+B`6)#-Q{vYR|rz6)mQflFPJnr`-UOKG&Q^qEz
z>A9nE{~pHlCJGeKXWe~=(yuwbw!7Sh&!KKdxwWq^IZHWv@G{UU8<XZkA<b~yH~&o6
zl?*%o05YfEb&&oHMaVWXUZ@**t>r)mm4D;s$r(mbwO()I*CO?6urpcbKmhx4_n|05
zFV9rCLkBV~hIQ<NSAB03ivt@XBxx5XnM~#dm|Hx5;r=@C1K^<PDsae&yoTG48*LZG
z!fk1ZN_drIa|u187*&P$l?R=j5_P55<qSS}P+sR3xTN%(mauWPM|GXq8q<I{U*Zyu
z;m?{_v=Tb4*E$%RLy|K5sqp8(1Jz3?eEKb%XMG$xLL!m5=R&15FkHB81u{bSOxnHl
z3Y0z@<`#F!gr_5JdAhM|zUP_@9_NzGlZGKTY$DySOgU0T23RcB-CdU2X~3h|GUoB+
z)p6|Z<u=RSlIYTEsjK@zV#c<4lp574JSJVoPF7hq$bPH*btr@;^PvNjiTn2C<6qPH
zIT#~A_F?+4qt0#y9`i7%w+r^*Nvl;2OIG;9h?znGfz8LvlPHu}#eg9|<5wLC>uiIp
z66KqpUSVQ#{LkV#LJ_pZ2_+321R(yq>|nBC<6Vq}?+{rdUvqd|T>DfbI^}Eyw<D9z
zB;%8sErjx6`>Q&=*XG(q__37n#?UuA7AV}~|GwKPuKWeFx*s-iGOf&Pkk%LpmEy~f
z=%8<_SubyJ@I@F~(_yp?*W-Mt{x9@7ukE0$sS~~GD66rbVVU7pyb*`OaEyvk)83J2
z!pKX+__fD(yhrXQTBi!<(v!M+Pu@Dv4*uBU!9i9p!(Rn(?Z~U3s5!}UKKt0D9Z+%d
zb6@0CtKW~mB<4I%lt?rHx{OlgSZF#Gkj?g)LEpGcT=wE!_hRUOLPQQ<Tj}1<jy9+>
zYQoS==9gYIHS|C--GO26_Fdof)ZvfX#C{^!Zhl!$PuaE{?A{#7`wjHA+-9r%@Qv?@
zQZiMES!E9pD!4wt$VEb?*8bt@UGq<;D&P678^;=efkFS?hIt`xfGH9rR&zgxc<Rjf
zg4a1p$V*2*TxeEpES{F8ZGGi8mr_c_{1%SUKCypi3F4g7newVAq$<v}*Gy1G>u-a?
z8N=<n`YI${f3Wo{bF@xl<N9xT87vRM*kXjy<#xt-XM*3aQH^k5)GiJqLO1Ex?%^Ri
zF4c6_RBySp=!>Q3jh&0!ue0i!Mdi6l)cj{84cRBdFDoo0sJkkN*L3teQc;RKy*AF9
z6T*Yjg@`s9Gh*KiALc526d1CF$0FqL)e%+TabAA6JaYYXzmNlU<FR=j@Ne&6U%zkX
zXEf2pO!xyo?Jkd(-yyF_-<CATLAM)cqMgajyt0!GFn<5X6dB<mYal;}Js&6pB49;E
zIa3fKSQmm$%HPx|z=&J3x0o3j-;H0W7)GvA02?#YWy(nmx(7+2#Qm+Dyjj)r1m2|5
zZo}(`rLlcTGD-_A{a`R85{+`)d!8-Z<bPL#<<6ic_Z!Q;XT6$&fUr4*?c*m&nf1xT
zY7I7e<4QN65_;88bqFKBze-;j#qPdd8CkAOkJR8WOxD<}$&}Hg3%wPpboAh>NHAGd
zqQdN}2JBs6<jV<MJ`9d2CijU(UnPKVvFTE&ep%>u!&<P8P#}yBAeNNrvG42TG^I73
z1pw!E{|nJPa=Y8X^j!YO#~??$#`hrsEw+Vju;LxVc8QiKd4JVgj=57&%xfJxO4iHM
z&ZJ$t@NCYqFj3==maEP1)GWiUOj8JXD_J(J5hD=9lj!?AYdI8Tj^n0#-OAVLL?Huu
zDAF1rnfJRDRIBn&Z)OQy#7!bd@A|%RgQ2!|fOj*H%ykZ~{|@IGV7@$KQu$#@9ufy4
zUD0%IJsV<LBaj#yLztTI`N4}%T>w3?*6`$_KrqP?{cYw{g{!p?&BN8>Nc^7LL1|p!
zMkgh8BgBbx@1?}(n^ee9Mw<s`ho_y{QX%b;a-A2cAh$Q+Ma)`6U2g~{#rb1MC&#l^
zBV}=Yz^FxjU_jPysmZHV))Jur*8*b)u4q;~sXG4~_<Z~>#XEP$n<bx<Cf2lj8nQQc
z#utx^KQAk7Kea$MvPL(;aRC`$TH+2G%zc@F^Y3FXZ^zr99N6l<D4pc_O!NT8jFzQL
z5l+Sxi0S%D2l4fO*4^oHSBS#R5PQAsWl>%gMuFi84_Dc~uQfOjCN%aff}6eWbiMI=
z+{Kr@lc9Ap=XzwmMW8n-HkR+@*|N3=%SXCqnDDo;MoOvMS_pO$BkW{!Sugryd#<an
zu+^P-$lply6LZ^0>slx+Fgi$3P!*BFLEfD2-xPVZl!enOkWx(+{DRmramR!YN$(5d
zv;PC@?&FX@?fdV4Uf;$EAW=p`3E-(f>sXVvuz)|ZeriGZ7f%<zQEq+XLBPbp3Q9}E
z$RIp|V9IX|x++iw)8T1pyeSMakTQ^@jSB}M;Zb%2CghILWS`b_80a#rPqNZJMD((>
zPJGB~&jf$m1%}6mDL5%f16=_c<(k1Ww8LMNI;;dBkk?$MEHr9~L^P#5p|GSlF*EU0
z$Ny7UpV(IyEQr0Jx0*Xko24&%Tb7~=bDK6(8`a>@j>jmPB;*6+XqInbX;LRfH#Szl
z%bAqX4?~DYM#gOXM+1QdP%+ZMiY2ssbOhv%Mp)Q8!y}zerY|2nXeJN-6Q^X;sNTC;
z6Z(Fx4T(h^F$<~DeV0C->&t%5jv9z6?<vc3-+oY-9OC}zjJ=_SbezrsA6`vm^6xK>
zmX(+_2TC9#Hds+kTN{omQ|??pLrKE8;JuUoiI=DUd~>Sn%+5e4%u$+WcX{JUy0ApE
z#c);E$@1%Jp+jbmj2ch8c4m*N{<3a#c1u)x9cf#tr42HLgI^IIi^-?C;ju5>yCibX
zd?e@)hTQa%;lqr$vIegvWTQw*s71yVtbhvn-duAzIvZA2zr#q@-hg{Y<i1%=D{^q4
zFht)<>y%+((;Lt3Z>4>BHT~aMz&CIBojFwc!8y%C#8U6RNH2VqPBHwtaJE;fWX7a!
z*9Q+DG-o4r!+RlLR_<WO!?<p^o~@DlD<jYJdGqy3Cp)V#RAN{&E0$^EEb3d|4<>a{
ztumNNKcTqNadx|v)?}k~Vo{inSM$GXgSK*(*Wx)U@>$)Hi&c7yonD`nxG*HAH7#cy
zK^gNRr@d7NO}tl!S<GW3`k!L9CDyteZ$=~Ong=V*mu4ZfRQ|x9s-DC(%;3RbW}mBx
z8r#JNS0W7c>paB`&nNRI_-2O)3Xky%zc*2ErwobjoaG{|NWIy(Zganb*;>tolM=U(
z7xz{f{e`PhinQR{iOW3mM|1#gBkbK<ssSfFRyEXr0tg2exXZ^FoDXpego3A(0eZLt
z_x8j(-2SLw#_Ygy;wtiwtTs8VI(C}S#l0D?A~i2|PX?pq`xEKG-iHh<Uz9f=&0$|K
zmVEa`Gn=KE<h!5Wk#GQZm}a+l!z(S}p@VON#>qw=_){bI`CjnRjdp_rjGpO2z0>PI
z$KGP=YYnt@_u%tJpGU^j0SDUWGtI-A_H)(-g_~kg;`P)Lnh8n)3rdjI<aQDQQGAP>
zmw^Q_JuDa5#LqUy#ZGT*y@Ir>l`v1WI~TAu#Yn_<6U>6xj)!rB!3U>}y(XjX+|6*<
z!o-o&riNsz6+?5O!mi4@wp;Gu&}Uo6{jEun!ndos)rDs2@pi!p{fh*@8%^E`a<da6
zj>4MMBaC&ihJCQNmn>#nCr`LQmhp6u#OiVdW6A{Y?Aj3_;poLE)}`$S$3`@|#n#T6
z)%-Jy;rdJv#t>Sbk63U))hK0+=hiMQjP;xkPJ?U5<?1N+(xs$UCby#$sEhS_pd6bI
zU>9+kB@(;k=~3uivF_(nEmR}COq66!Y!v$*Ii70ZC!9-6+Ah?W^%ynO%a!uXc7C(2
z-9;?jvCnJ`^uo$`h&`Brf<psZmEV~=%@sv=H83kIqnotf7_J8tS{v4uWn?W2hVjCC
zmMDy(uYMFH39||*_usg(6#aB74g_^S+HVESzjviZ{<_F(##5eI?7Twc*5exY4bSl8
z6yS|Ls4c=JJ+^{kp3CGNaMa@h+HEQd{Mn9Bnyyd-W_tR@khTc+&8(sHib^;=;Cl($
zQ51AE<&B2bc^TQS899J#pzPg4l^(-mO9rPq>}{9P-jMo&vAx>BtdVVc(<@)pLLe^`
zw6SW^XgeLbZxDL@{J`En>`s%P1wkoLcYhJ24T4WPwJQ;&CS{QjslKZxvIwree_qyI
zJJex@FhmC84*{O%?E8V-Y5gm{uD+r@v<>xFC4~LOd_CZSt`wE5Y64mFDo`sm%96@~
zB81}rU~ckV74w>f)-3XxZuiu(L!sq-`NC2Tj527zcWQO8Tt0B86`gk7EWt=`=FUFV
zXXF{Rj-{2FI(i3M>-U6H?$IGk?qjUBVK3n}fnY0;CnR|!Ne2n=G@}nzY!NSJlZs^m
zw<>U*wKZzN27UOP_cM>{4w86W%@b>5neExG9?HzL+I9PE@1HdO5L>%CTj=2+sFIW}
z@)0(LB#D{)G~m|fQa@S>d)C{p=NgVNAH86jf5<n&rre}qp$Toc1I;YL8Y%#%w{M|o
zWUQ?g@@RCa!!5=u>VY<l{NFRZ;|~{Sc3Xdg@kXE5(8c>;SWg%EE1q0dU1AG$Y8Rum
zj2_a~igT;HX&=@*la4m*K2IavbIPSRDUO~QI7(Um8skyr<a6$o1_Pg`iwrS!<)9H_
zsYWEGB-^xXw4&N@g&@b+mLAQP8g-CEL;cL|ZZ83F_Uh-*gV`}u4y4aqUtkE+0_M1T
zC}7R0<CPCH?yCD;sceD}k!D5laxIdQ^$$;@M?>^frT{kAU-yRu`@+xX(uL>33_Twk
zo(s^-=zjcf$k9_Wa40ws8YHRA$>;s~Oq^-C`Q{2n>F+^L*wcpNWKZmpJOMBxrR408
zv1zA=Hgu}Y0aLdG#eP%aP^pSRx|R_(1a|AI{HAzU`TxQ^YJhWfEHz{rW#_ilTnOdG
zvF3R7>5u8^Mmy1aB=H=<SLU<(itd(si}RC}@c3|$4(<&Pz{gRf(tm}`WYnfUw!e1i
znT7e}+4y8Ou^(-t!A1#|Rd6Nt54qxW{rRW-4S5+Uxi2$N(PT^D&@E~8v`8ZjN2VcG
zrXMe3NQ$^_-?{g{RlbZmswr3z<QZ0Zn-2RJ4%f^R$Xm_(<kd+TSrD7oACHS^BM6T5
zVdGu-Sm4Zvyd{@`sEj3_?jQ6nMxEOA)8!3!^(|YyAYN-8_-iM0EK<|PT;2(ZncF%c
zFQ=N{c5(_|z}y+ncX^!@#l3gKvW1Ux#reGP8Cu0?HDBO7k!8#9iB?A4qD2)f?_SY5
zuV=xl^=o0(?YNyprcf=h{~Nck*c-bk&-xh*12cr~kt_l~i5=hzA0*Xfta7?>gN5Id
zJ1~TYE?)}1xY7MYe~e8rVC__tYLhpuNlZ)+YSxhw=f*sMS7y^f9b&vA7(UoAl48E*
zv?=>IwDg;DA*3Yp4*?&sKpe15*C)9JX*++`$&#P5k6EZs(v$o#g3641dvsAXY7eR0
zYT5lIX@9pBk?NUipE7tnT~eE+BP0KaDBxZ;R&~Yh=Q<ICwHW0|gWmVtjX>D>$b~oe
zhjeFwv-}cNb{wK{G|^t|ZuA?RDF1aIna0gKA|(V}V1m(x7%iiR{)In3&@1gQ1H07y
z;Y9v<TLG(GXgDZn$QDHfJ!QF8d;7=~A{&@GVHH&BYQ6Oldfx|REiDArutPrk_4S}l
zQvw0`g$~+;|Jb7qb6%YM=FFCT8R2$J&!&Qtng6kj*Ooy0Pwy~C(|*$`q?zDt1F&!Q
zq1@s#T;({OVL^O@GZdpA@OoDQT*s>O2OTKNqjID5Y4(F2BB&2XSB@5&t<++^Adyh%
z{A{JnO2Ud}EW0_C088Qn;}b(J2F2j~@{qI(80f(J)jkgl?9bJmk!{f`cCa_X5zJXV
zqH(_S%cs1sbX#CZ$6?cK2h)bln=bUGWOWtp-4#;&^Cx=mQ8>1+L)3JCKAW`ds631@
zpz&fMC2PP{n><a_&u@KW$-wpL?YI5yi3S{+X0yyiu}vI;RZ>Ij+>pNU(nO~H+!1d*
zf9yDj?-=?&;7jacCxeqN%!MuLF_Gy=6(x_{NUe3JlK+B>xxadOu1lo*KuGL1zro`f
zZ-EJsWPKW8=pl3~Uzzp)CSp66ZaP8)AMFf~1iD;0YE5@`Yb(W?OBYodyDQ+G56psv
z&HBLT&x;h;*_(TSU*HiKY@}sxaWP?)s^klPvGFZvjb-1-V6QB_CUNEMueHCUI&V?1
zoYfosLT}jo-JSR*?PV%Y0X_<kjLOkXn%aN-Mey1D^O|t>Wa?SnsrC!!#Y4sDQ%-@G
zvfHQCt7V8UHCA8h;oj>MFgW7kZG`=WBH-<mS03YSY<t6!-E!NQgfY#f-T284l+NSK
zingKm_4IjIaML*=5g0&G6a9{R7G74lQJ-;`Lr&{7?JD>%Y8@$zt&tu)J~PyCUyPs8
zZOqgCCYVZAl2%LeHo_=_bSD0Bf1urZc{m`1;0Z0aZ(n4Q<6BmsF&w=Hkuqo22B694
z1NiL>JEAU+1Nx;ehLBn(nfIgUtyh8OP$>JaBaJ0}+8;w*uXp;%wnh*5&i@%ms(3!x
z@7{0k3tzCa+F<MPR-5kOSMgu=@ZlL85+SRw(EC4QsJGa!?CThQ9@__$OKLLCpBW*;
z!i8ay5cw?SMN~NRgCRg=cjV0IUzFxLCl=jJNl8hn2rm38Nfnu|e<hOwCt<SxT~v`w
zgod{oM?9RPQoRrE4+@e7H67JY291h@jD*;M#Heu#38-iqY?>r|$W&uWC7H+)plDge
zhqSMr?Ss4aVT0hV19Ch(0s_C`zTSyJaB5fxq+G&(757u_$8DoJ5+=pZM+~~Aih+NN
zC!YTglvw{s^>rkOG6Ma}5F(T!moE4e+ync4&0)Zz0a7du>D#*W`nRGJsG5O{4^~ui
zazcbSw6$g_o_Y}TfY8)&3#NZ|2Lf;zG-;TrGm?|dvJ{aBA${ac&TwMSlvl6DiqNc}
zfLt0IL!FcbTt4vbkYj$2%Mo$5RD=LmA=-aY?Z|tA)0NFCu3Ad_A>*7V`;(WZQOZPO
z?8esJq7wP8{wkq93*@-&z}&(jJ}F5-+e?Z;D<b(jq<|hMR+c@r@C=6~c!(yB(DlRd
zmu5PuPjs90!s~&jAIkj<f~-8B=YTQ&rc2uwc|L^lui8b3lgEJxp|vkvW@nx-rK;t&
zU36N$j?C`Tlcp!Fu>^t@kQgCKv6-a4d|$XMSI0(o6qk*INWSo@sIevfvSZDtMd32R
z>9gP;9hIq<>BitV8o9VOux5)QS^V}KZM9qzLVc$|_Y`Yu7AV*s+n={4^|Dh@+|o)0
z@RorrE>%|fu_n7sWYyR<*ke<2)Xk5DU^3h)jlpl&7m&KFccfq_GtxVl{C9;kWwM&@
zra&;<?|ASR3k!kNRsG5Giu&FC#Eb+*ufEi5jSr%OwkoDIlCZUg{6eeV!}S*Sl6#1O
zxc?oC0E8LtTagV1Ic+e2ELfe#&0_q%1odh{71a^*337@asg}-ldlr_aT;ASz_&NUp
z^>q(xLR-H*9*h~ZN5-(T_p{^-GJ<<=w90=>?C@M_Y^)I64qw=<H-*&rJbs#e(DN84
z_|gjBI7e=APF}<5wJ7u2%n*6D!c%YaOdy~&yWicGI$|)$X6nraY_2q2nq^;oxzw`j
z?43&CsmJ%X9lRV5i>kYCjnh03X?L0S4bBb+8jgTGPkmCAh$UVykN!f`iqd5vQ7nbX
zW;EV-Mw~HgiJom&?)6J{R`z5P-v)|}9sVQcX~$FM<ZtpucSJo`1f`O;e#p@J8~S{Q
zhg<soBUP#UOF=sC(OfwUYh|k&KiAwdN9(bw^u|&ujeQu~nm4PX$X^_x+z5i-ix@zs
z<AN8f^-k<JVSc%|Ez-;TtYL3~;|))Y{k`tGfQQff;5Kjo={Q|>64Wv%^zsPdjPFf_
zJd?Kr{30wUHB;Rr=b5FBc$K4Kvz32$4R=x$bJX;=)sF9DFzz!c`U`HaluSX1WgWW@
z3_D!lN#JhXGThOo!pXWp9dp*$DP>#fIg`h@;qR?>ur+x#lz!F{-oOtW1O^^OY5OfR
zWdf6fKDb4Wl#lT>In`=7TNU!YHjs|mg6jl&`5r9eJjtL)K5{^0=q0*=wbvznmk#JV
z41NZJ1*g5#b;ylGcBk%CO;`$?tEY))j``Kai`8-q5SL|XgovT><O>+4`+9uYi==f}
zSTK!HE3*Z{r3h99D!Uic=HFn1G`ePMK<tGc1|f>SZ*BLkECA^Oq%_Z5OJ`x)mtx_;
zorWFOEc+>Gj?<OlS=gy`Bn<9P(+*hE{>a5s-`ujl1;;@f&b8en47GN<bHC#9ma`}8
zE}w<?AUkX;Wp78yohwqa7v;)o{a0>0or{S>@{^JM$L<Yt7bv-3eU%sYwVN&Ed#wMF
zVI5w31~CCtF8kI2?uZcYxcOhB5K{?=loOyOE+~5tWk6-%u@0FP_K;aYB3m*AuO<Do
zvb7!3WBf?G^{qdz<CPy@#)D{hI3#wl>3uh=`!~b?aa`W|sLRcKm-7^jq03_0Ur<xa
zxfaqqZ#wqUHYlZ5rger~S}K(-qa~{(C*!M!2!%{l4nXdD?~+1y%|j}Y*|0c$vI5kw
zC{1F>VKWboZC<?`bGomdi(^-q6`JSTV|~qq$65s-ze5E`P3j?1R8LdG&`?v`zSWd=
z^<dsVpobXHa6)#T$?b19ya@3rZi5Z2>Gctr-I2NPO3s15MBToBdkyq`cv#+r_`bX*
z72DhCg1Er<_^#4$N3ac5UUl9D=uwr2#_!_lm||}*JZ8KV9aB9X6ycjqZ2M9wR+4Vv
zi>g!Ov(?1;Uj}mQ?K1}nnq)zXJRR{tNVqG{RgI4U2H6J`ZKEL9?3=8|M!SJ;-Xz}F
z&w@nlfoh)H1*+LHKSG<XL3=*(Tg{{GcSjy)FXj4*{9KOH@Mo1Z^CuM!J6Uo()}z-R
zV04c%*3}xPR->&;iMJ&;+3L{oXO0uG@$~2F#_|e}j{6$JT)#btl(}^6q=M$v4v=0>
z7&Yp&;EwiAnv92#{A5<7zB%&CT=j2J3IpBU@DA9=SkSO0>t>Y8>7{#BE-6{1b1xj7
zB(C(m#UkY0TFdf;o^(mK0&7Ul0O+k=^&V`4&T}+YW^||U0N2z{n-wZQdKfI?c3Bc{
z6DV9UWt8TAe`(q7c^50~;;8;ZGvJ|$VL8agJN50YEY<=n=T~Ka(y7ysINi~G@-i5o
zN{(DEG@HLaXl`TM{&|7}VBAyZy%H-gBO`O(O89Va$6(MR2ZtL#|D^s^>Fr?D{Ua0E
zQD3#NTPdQ4S14;zQ(rYd1Xm+cvNuxt*_CxtMG-Cl@mTVRRd>cq1N#gE@O|mG-KPVE
zL@<8JX=mvx9Qo)T2AyLjXF7*x8=mHuPrroNb~d}vF#!Omcv(p?b(4sJd{-dT1QDDj
zZdu7qc6K4v!(WBv73Jc<xb<w~duTwzQ1p=b>L1Y-Y4~>6Fxs<_!jWSl4b3^a1cKQc
zFa2S&`zs~~&#MaTgeW<j7-^h<Rgk;?`PFfhP?-CxcGEtvXxgl%I_F6xY+}eOjqG<N
z&(7$#`N+uC>y$vMng!Z035e!9QG$WVjh-`AMUYJGRMu^|V-x_mIR7=SUx|uFJ-2f6
z<(E*L`k{+;_Q{-x3VKOsN<bLz6BNK>UtixaO|b|O889Z!*^EmFxZL{80sy%7!vTzA
zTLFNvPxyfE{M*m~Hb{~Q*bhem{3daR0;E&^f6*u{=L-$Q_cRTN4*1>phVhxnVF@df
Rz6${P$x10oR*M@4{SW5V<I4a5

literal 0
HcmV?d00001

diff --git a/linux/main.cpp b/linux/main.cpp
index a9c3b88..9e8d7b9 100644
--- a/linux/main.cpp
+++ b/linux/main.cpp
@@ -42,6 +42,7 @@ class AirPodsTrayApp : public QObject {
     Q_PROPERTY(bool hideOnStart READ hideOnStart CONSTANT)
     Q_PROPERTY(DeviceInfo *deviceInfo READ deviceInfo CONSTANT)
     Q_PROPERTY(QString phoneMacStatus READ phoneMacStatus NOTIFY phoneMacStatusChanged)
+    Q_PROPERTY(bool hearingAidEnabled READ hearingAidEnabled WRITE setHearingAidEnabled NOTIFY hearingAidEnabledChanged)
 
 public:
     AirPodsTrayApp(bool debugMode, bool hideOnStart, QQmlApplicationEngine *parent = nullptr)
@@ -131,6 +132,7 @@ public:
     bool hideOnStart() const { return m_hideOnStart; }
     DeviceInfo *deviceInfo() const { return m_deviceInfo; }
     QString phoneMacStatus() const { return m_phoneMacStatus; }
+    bool hearingAidEnabled() const { return m_deviceInfo->hearingAidEnabled(); }
 
 private:
     bool debugMode;
@@ -367,6 +369,16 @@ public slots:
         emit phoneMacStatusChanged();
     }
 
+    void setHearingAidEnabled(bool enabled)
+    {
+        LOG_INFO("Setting hearing aid to: " << (enabled ? "enabled" : "disabled"));
+        QByteArray packet = enabled ? AirPodsPackets::HearingAid::ENABLED
+                                    : AirPodsPackets::HearingAid::DISABLED;
+
+        writePacketToSocket(packet, "Hearing aid packet written: ");
+        m_deviceInfo->setHearingAidEnabled(enabled);
+    }
+
     bool writePacketToSocket(const QByteArray &packet, const QString &logMessage)
     {
         if (socket && socket->isOpen())
@@ -682,6 +694,14 @@ private slots:
                 LOG_INFO("Conversational awareness state received: " << m_deviceInfo->conversationalAwareness());
             }
         }
+        // Hearing Aid state
+        else if (data.startsWith(AirPodsPackets::HearingAid::HEADER)) {
+            if (auto result = AirPodsPackets::HearingAid::parseState(data))
+            {
+                m_deviceInfo->setHearingAidEnabled(result.value());
+                LOG_INFO("Hearing aid state received: " << m_deviceInfo->hearingAidEnabled());
+            }
+        }
         // Noise Control Mode
         else if (data.size() == 11 && data.startsWith(AirPodsPackets::NoiseControl::HEADER))
         {
@@ -944,6 +964,7 @@ signals:
     void retryAttemptsChanged(int attempts);
     void oneBudANCModeChanged(bool enabled);
     void phoneMacStatusChanged();
+    void hearingAidEnabledChanged(bool enabled);
 
 private:
     QBluetoothSocket *socket = nullptr;