libmdr 0.1.0__py3-none-win_amd64.whl

libmdr/_generated_constants.py

@@ -0,0 +1,342 @@
+"""Generated from SonyHeadphonesClient
+
+Do not edit this file directly; run ``python tooling/generate_bindings.py``.
+"""
+
+from __future__ import annotations
+
+PROPERTY_CURRENT = 0
+PROPERTY_DESIRED = 1
+PROTOCOL_V1 = 1
+PROTOCOL_V2 = 2
+FALSE = 0
+TRUE = 1
+AVAILABILITY_UNKNOWN = 0
+AVAILABILITY_UNAVAILABLE = 1
+AVAILABILITY_AVAILABLE = 2
+TIMEOUT_DEFAULT = 0
+TIMEOUT_ACK = 1
+TIMEOUT_ACK_RETRIES = 2
+HEADPHONES_INIT_NONE = 0
+HEADPHONES_INIT_IDENTITY = 1
+HEADPHONES_INIT_SUPPORT_FUNCTIONS = 2
+HEADPHONES_INIT_GENERAL_SETTINGS = 4
+HEADPHONES_INIT_EQUALIZER = 8
+HEADPHONES_INIT_DSEE = 16
+HEADPHONES_INIT_PLAYBACK = 32
+HEADPHONES_INIT_NOISE_CONTROL = 64
+HEADPHONES_INIT_ASSIGNABLE_CONTROLS = 128
+HEADPHONES_INIT_PERIPHERALS = 256
+HEADPHONES_INIT_SPEAK_TO_CHAT = 512
+HEADPHONES_INIT_LISTENING_MODE = 1024
+HEADPHONES_INIT_POWER = 2048
+HEADPHONES_INIT_WEARING_STATUS = 4096
+HEADPHONES_INIT_VOICE_GUIDANCE = 8192
+HEADPHONES_INIT_CONNECTION = 16384
+HEADPHONES_INIT_BATTERY = 32768
+HEADPHONES_INIT_FIRMWARE_UPDATE = 65536
+HEADPHONES_INIT_ALERT = 131072
+HEADPHONES_INIT_LOG = 262144
+HEADPHONES_INIT_VOICE_ASSISTANT = 524288
+HEADPHONES_INIT_DISCOVERY = 3
+HEADPHONES_INIT_DEFAULT = 1048575
+HEADPHONES_SYNC_NONE = 0
+HEADPHONES_SYNC_BATTERY = 1
+HEADPHONES_SYNC_SAFE_LISTENING = 2
+HEADPHONES_SYNC_PLAYBACK = 4
+HEADPHONES_SYNC_WEARING_STATUS = 8
+HEADPHONES_SYNC_DEFAULT = 15
+FEATURE_IDENTITY = 1
+FEATURE_BATTERY_SINGLE = 2
+FEATURE_BATTERY_LEFT_RIGHT = 3
+FEATURE_BATTERY_CASE = 4
+FEATURE_PLAYBACK_METADATA = 5
+FEATURE_PLAYBACK_CONTROL = 6
+FEATURE_PLAYBACK_VOLUME = 7
+FEATURE_NOISE_CANCELLING = 8
+FEATURE_AMBIENT_SOUND = 9
+FEATURE_ADAPTIVE_AMBIENT_SOUND = 10
+FEATURE_SPEAK_TO_CHAT = 11
+FEATURE_LISTENING_MODE = 12
+FEATURE_EQUALIZER = 13
+FEATURE_DSEE = 14
+FEATURE_PAIRED_DEVICE_MANAGEMENT = 15
+FEATURE_PAIRING_MODE = 16
+FEATURE_GENERAL_SETTINGS = 17
+FEATURE_ASSIGNABLE_CONTROLS = 18
+FEATURE_NOISE_CONTROL_BUTTON = 19
+FEATURE_AUTO_POWER_OFF = 20
+FEATURE_WEARING_DETECTION = 21
+FEATURE_AUTO_PAUSE = 22
+FEATURE_HEAD_GESTURE = 23
+FEATURE_VOICE_GUIDANCE = 24
+FEATURE_VOICE_GUIDANCE_VOLUME = 25
+FEATURE_SHUTDOWN = 26
+FEATURE_CONNECTION_MODE = 27
+FEATURE_SAFE_LISTENING = 28
+FEATURE_SOURCE_SWITCH_CONTROL = 29
+FEATURE_LISTENING_BACKGROUND_MUSIC = 30
+FEATURE_LISTENING_CINEMA = 31
+FEATURE_LISTENING_VOICE_BOOST = 32
+FEATURE_LISTENING_SOUND_LEAKAGE_REDUCTION = 33
+FEATURE_WEARING_STATUS = 34
+FEATURE_VOICE_ASSISTANT = 35
+FEATURE_MAX_VALUE = 35
+EVENT_NONE = 0
+EVENT_IDENTITY_CHANGED = 1
+EVENT_BATTERY_CHANGED = 2
+EVENT_PLAYBACK_CHANGED = 3
+EVENT_NOISE_CONTROL_CHANGED = 4
+EVENT_SPEAK_TO_CHAT_CHANGED = 5
+EVENT_LISTENING_MODE_CHANGED = 6
+EVENT_EQUALIZER_CHANGED = 7
+EVENT_PAIRED_DEVICES_CHANGED = 8
+EVENT_PAIRING_CHANGED = 9
+EVENT_GENERAL_SETTINGS_CHANGED = 10
+EVENT_ASSIGNABLE_CONTROLS_CHANGED = 11
+EVENT_POWER_CHANGED = 12
+EVENT_VOICE_GUIDANCE_CHANGED = 13
+EVENT_CONNECTION_MODE_CHANGED = 14
+EVENT_SAFE_LISTENING_CHANGED = 15
+EVENT_INITIALIZE_COMPLETE = 16
+EVENT_SYNC_COMPLETE = 17
+EVENT_APPLY_COMPLETE = 18
+EVENT_ALERT = 19
+EVENT_INTERACTION = 20
+EVENT_DEVICE_MESSAGE = 21
+EVENT_NEED_SYNC = 22
+EVENT_UNHANDLED = 23
+EVENT_WEARING_STATUS_CHANGED = 24
+EVENT_VOICE_ASSISTANT_CHANGED = 25
+PACKET_DIRECTION_RX = 0
+PACKET_DIRECTION_TX = 1
+TEXT_MODEL_NAME = 1
+TEXT_UNIQUE_ID = 2
+TEXT_FIRMWARE_VERSION = 3
+TEXT_MODEL_SERIES = 4
+TEXT_MODEL_COLOR = 5
+TEXT_TRACK_TITLE = 6
+TEXT_TRACK_ALBUM = 7
+TEXT_TRACK_ARTIST = 8
+TEXT_PAIRED_DEVICE_ID = 9
+TEXT_PAIRED_DEVICE_NAME = 10
+TEXT_GENERAL_SETTING_SUBJECT = 11
+TEXT_GENERAL_SETTING_SUMMARY = 12
+TEXT_LAST_ERROR = 13
+TEXT_LAST_ALERT = 14
+TEXT_LAST_INTERACTION = 15
+TEXT_LAST_DEVICE_MESSAGE = 16
+TEXT_EQUALIZER_PRESET_NAME = 17
+AUDIO_CODEC_UNKNOWN = 0
+AUDIO_CODEC_SBC = 1
+AUDIO_CODEC_AAC = 2
+AUDIO_CODEC_LDAC = 3
+AUDIO_CODEC_APTX = 4
+AUDIO_CODEC_APTX_HD = 5
+AUDIO_CODEC_LC3 = 6
+AUDIO_CODEC_OTHER = 255
+BATTERY_MAIN = 0
+BATTERY_LEFT = 1
+BATTERY_RIGHT = 2
+BATTERY_CASE = 3
+CHARGING_UNKNOWN = 0
+CHARGING_NO = 1
+CHARGING_YES = 2
+CHARGING_COMPLETE = 3
+PLAYBACK_UNKNOWN = 0
+PLAYBACK_STOPPED = 1
+PLAYBACK_PLAYING = 2
+PLAYBACK_PAUSED = 3
+PLAYBACK_PLAY = 1
+PLAYBACK_PAUSE = 2
+PLAYBACK_NEXT = 3
+PLAYBACK_PREVIOUS = 4
+SOURCE_SWITCH_CONTROL_SUCCESS = 0
+SOURCE_SWITCH_CONTROL_FAILED = 1
+SOURCE_SWITCH_CONTROL_FAILED_ON_CALL = 2
+SOURCE_SWITCH_CONTROL_FAILED_NOT_CONNECTED = 3
+SOURCE_SWITCH_CONTROL_FAILED_VOICE_ASSISTANT = 4
+NOISE_MODE_OFF = 0
+NOISE_MODE_CANCELLING = 1
+NOISE_MODE_V1_ON = 1
+NOISE_MODE_AMBIENT = 2
+NOISE_AMBIENT_LEVEL_V1_NOISE_CANCELLING = 255
+ADAPTIVE_SENSITIVITY_UNKNOWN = 0
+ADAPTIVE_SENSITIVITY_LOW = 1
+ADAPTIVE_SENSITIVITY_STANDARD = 2
+ADAPTIVE_SENSITIVITY_HIGH = 3
+NOISE_BUTTON_NONE = 0
+NOISE_BUTTON_NOISE_AMBIENT_OFF = 1
+NOISE_BUTTON_NOISE_AMBIENT = 2
+NOISE_BUTTON_NOISE_OFF = 3
+NOISE_BUTTON_AMBIENT_OFF = 4
+SPEECH_SENSITIVITY_UNKNOWN = 0
+SPEECH_SENSITIVITY_AUTO = 1
+SPEECH_SENSITIVITY_LOW = 2
+SPEECH_SENSITIVITY_HIGH = 3
+SPEAK_TIMEOUT_UNKNOWN = 0
+SPEAK_TIMEOUT_SHORT = 1
+SPEAK_TIMEOUT_MEDIUM = 2
+SPEAK_TIMEOUT_LONG = 3
+SPEAK_TIMEOUT_MANUAL = 4
+LISTENING_STANDARD = 0
+LISTENING_BACKGROUND_MUSIC = 1
+LISTENING_CINEMA = 2
+LISTENING_VOICE_BOOST = 3
+LISTENING_SOUND_LEAKAGE_REDUCTION = 4
+LISTENING_BLOCKER_NONE = 0
+LISTENING_BLOCKER_CALL = 1
+LISTENING_BLOCKER_LE_AUDIO = 2
+LISTENING_BLOCKER_VOICE_ASSISTANT = 4
+LISTENING_BLOCKER_LISTENING_MODE = 8
+LISTENING_BLOCKER_OTHER = 16
+VOICE_ASSISTANT_NONE = 0
+VOICE_ASSISTANT_VOICE_RECOGNITION = 1
+VOICE_ASSISTANT_GOOGLE_ASSISTANT = 2
+VOICE_ASSISTANT_AMAZON_ALEXA = 3
+VOICE_ASSISTANT_TENCENT_XIAOWEI = 4
+VOICE_ASSISTANT_SONY_VOICE_CONTROL = 5
+VOICE_ASSISTANT_OTHER_DEVICE = 6
+VOICE_ASSISTANT_UNKNOWN = 255
+VOICE_ASSISTANT_KEY_UNKNOWN = 0
+VOICE_ASSISTANT_KEY_FIXED_BUTTON = 1
+VOICE_ASSISTANT_KEY_TOUCH_PANEL = 2
+VOICE_ASSISTANT_KEY_ASSIGNABLE_BUTTON = 3
+VOICE_ASSISTANT_KEY_ASSIGNABLE_SENSOR = 4
+ROOM_UNKNOWN = 0
+ROOM_SMALL = 1
+ROOM_MEDIUM = 2
+ROOM_LARGE = 3
+EQ_OFF = 0
+EQ_ROCK = 1
+EQ_POP = 2
+EQ_JAZZ = 3
+EQ_DANCE = 4
+EQ_EDM = 5
+EQ_R_AND_B_HIP_HOP = 6
+EQ_ACOUSTIC = 7
+EQ_BRIGHT = 8
+EQ_EXCITED = 9
+EQ_MELLOW = 10
+EQ_RELAXED = 11
+EQ_VOCAL = 12
+EQ_TREBLE = 13
+EQ_BASS = 14
+EQ_SPEECH = 15
+EQ_HEAVY = 16
+EQ_CLEAR = 17
+EQ_HARD = 18
+EQ_SOFT = 19
+EQ_GAMING = 20
+EQ_FPS_1 = 21
+EQ_FPS_2 = 22
+EQ_FPS_3 = 23
+EQ_CUSTOM = 24
+EQ_USER_1 = 25
+EQ_USER_2 = 26
+EQ_USER_3 = 27
+EQ_USER_4 = 28
+EQ_USER_5 = 29
+EQ_UNKNOWN = 255
+DSEE_UNKNOWN = 0
+DSEE_STANDARD = 1
+DSEE_HX = 2
+DSEE_HX_AI = 3
+DSEE_ULTIMATE = 4
+PAIRED_DEVICE_CONNECT = 1
+PAIRED_DEVICE_DISCONNECT = 2
+PAIRED_DEVICE_SELECT_PLAYBACK = 3
+PAIRED_DEVICE_UNPAIR = 4
+ALERT_ACTION_NEGATIVE = 0
+ALERT_ACTION_POSITIVE = 1
+GENERAL_SETTING_UNKNOWN = 0
+GENERAL_SETTING_BOOLEAN = 1
+ASSIGNABLE_NONE = 0
+ASSIGNABLE_PLAYBACK = 1
+ASSIGNABLE_NOISE_CONTROL = 2
+ASSIGNABLE_NOISE_CONTROL_QUICK_ACCESS = 3
+ASSIGNABLE_TRACK_CONTROL = 4
+ASSIGNABLE_VOICE_RECOGNITION = 5
+ASSIGNABLE_GOOGLE_ASSISTANT = 6
+ASSIGNABLE_AMAZON_ALEXA = 7
+ASSIGNABLE_TENCENT_XIAOWEI = 8
+ASSIGNABLE_MICROSOFT_CORTANA = 9
+ASSIGNABLE_QUICK_ACCESS = 10
+ASSIGNABLE_VOLUME = 11
+ASSIGNABLE_PLAYBACK_VOICE_ASSISTANT_LIMITATION = 12
+ASSIGNABLE_TENCENT_XIAOWEI_Q_MSC = 13
+ASSIGNABLE_TEAMS = 14
+ASSIGNABLE_GOOGLE_ASSISTANT_BT_CLASSIC_CAUTION = 15
+ASSIGNABLE_AMAZON_ALEXA_BT_CLASSIC_CAUTION = 16
+ASSIGNABLE_TENCENT_XIAOWEI_BT_CLASSIC_CAUTION = 17
+ASSIGNABLE_QUICK_ACCESS_BT_CLASSIC_CAUTION = 18
+ASSIGNABLE_NOISE_CONTROL_QUICK_ACCESS_BT_CLASSIC_CAUTION = 19
+ASSIGNABLE_TENCENT_XIAOWEI_Q_MSC_BT_CLASSIC_CAUTION = 20
+ASSIGNABLE_NOISE_CONTROL_MIC = 21
+ASSIGNABLE_LISTENING_MODE_QUICK_ACCESS = 22
+ASSIGNABLE_NOISE_CONTROL_LISTENING_MODE = 23
+ASSIGNABLE_CHAT_MIX = 24
+ASSIGNABLE_CUSTOM1 = 25
+ASSIGNABLE_CUSTOM2 = 26
+ASSIGNABLE_UNKNOWN = 27
+WEARING_POWER_UNAVAILABLE = 0
+WEARING_POWER_DISABLED = 1
+WEARING_POWER_WHEN_REMOVED = 2
+WEARING_STATUS_UNKNOWN = 0
+WEARING_STATUS_WORN = 1
+WEARING_STATUS_LEFT_REMOVED = 2
+WEARING_STATUS_RIGHT_REMOVED = 3
+WEARING_STATUS_REMOVED = 4
+AUDIO_PRIORITY_UNKNOWN = 0
+AUDIO_PRIORITY_QUALITY = 1
+AUDIO_PRIORITY_STABILITY = 2
+ASSIGNABLE_ACTION_KEY_UNKNOWN = 0
+ASSIGNABLE_ACTION_KEY_LEFT = 1
+ASSIGNABLE_ACTION_KEY_RIGHT = 2
+ASSIGNABLE_ACTION_KEY_CUSTOM = 3
+ASSIGNABLE_ACTION_KEY_C = 4
+ASSIGNABLE_ACTION_KEY_NC_AMB = 5
+ASSIGNABLE_ACTION_KEY_NC_AMBIENT = 6
+ASSIGNABLE_ACTION_KEY_TYPE_UNKNOWN = 0
+ASSIGNABLE_ACTION_KEY_TYPE_TOUCH_SENSOR = 1
+ASSIGNABLE_ACTION_KEY_TYPE_BUTTON = 2
+ASSIGNABLE_ACTION_KEY_TYPE_FACE_TAP = 3
+
+# Display names: client/Client.cpp kFeatures -> client/I18N/Default.cpp.
+FEATURE_NAMES = {
+    FEATURE_IDENTITY: 'Identity',
+    FEATURE_BATTERY_SINGLE: 'Single battery',
+    FEATURE_BATTERY_LEFT_RIGHT: 'Left/right battery',
+    FEATURE_BATTERY_CASE: 'Charging case battery',
+    FEATURE_PLAYBACK_METADATA: 'Playback metadata',
+    FEATURE_PLAYBACK_CONTROL: 'Playback Control',
+    FEATURE_PLAYBACK_VOLUME: 'Playback volume',
+    FEATURE_NOISE_CANCELLING: 'Noise Cancelling',
+    FEATURE_AMBIENT_SOUND: 'Ambient Sound',
+    FEATURE_ADAPTIVE_AMBIENT_SOUND: 'Adaptive ambient sound',
+    FEATURE_SPEAK_TO_CHAT: 'Speak To Chat',
+    FEATURE_LISTENING_MODE: 'Listening Mode',
+    FEATURE_EQUALIZER: 'Equalizer',
+    FEATURE_DSEE: 'DSEE',
+    FEATURE_PAIRED_DEVICE_MANAGEMENT: 'Paired device management',
+    FEATURE_PAIRING_MODE: 'Pairing mode',
+    FEATURE_GENERAL_SETTINGS: 'General Setting',
+    FEATURE_ASSIGNABLE_CONTROLS: 'Assignable Controls',
+    FEATURE_NOISE_CONTROL_BUTTON: 'Noise control button',
+    FEATURE_AUTO_POWER_OFF: 'Auto Power Off',
+    FEATURE_WEARING_DETECTION: 'Wearing detection',
+    FEATURE_AUTO_PAUSE: 'Auto pause',
+    FEATURE_HEAD_GESTURE: 'Head Gesture',
+    FEATURE_VOICE_GUIDANCE: 'Voice Guidance',
+    FEATURE_VOICE_GUIDANCE_VOLUME: 'Voice guidance volume',
+    FEATURE_SHUTDOWN: 'Shutdown',
+    FEATURE_CONNECTION_MODE: 'Connection mode',
+    FEATURE_SAFE_LISTENING: 'Safe listening',
+    FEATURE_SOURCE_SWITCH_CONTROL: 'Source switch control',
+    FEATURE_LISTENING_BACKGROUND_MUSIC: 'Listening: background music',
+    FEATURE_LISTENING_CINEMA: 'Listening: cinema',
+    FEATURE_LISTENING_VOICE_BOOST: 'Listening: voice boost',
+    FEATURE_LISTENING_SOUND_LEAKAGE_REDUCTION: 'Listening: sound leakage reduction',
+    FEATURE_WEARING_STATUS: 'Wearing status',
+    FEATURE_VOICE_ASSISTANT: 'Voice Assistant',
+}

libmdr/_generated_result.py

@@ -0,0 +1,25 @@
+"""Generated from SonyHeadphonesClient
+
+Do not edit this file directly; run ``python tooling/generate_bindings.py``.
+"""
+
+from __future__ import annotations
+
+ABI_VERSION = 9
+INIT_BT_BLE = 1
+OK = 0
+INPROGRESS = 1
+ERROR_GENERAL = 2
+ERROR_NOT_FOUND = 3
+ERROR_TIMEOUT = 4
+ERROR_NET = 5
+ERROR_NO_CONNECTION = 6
+ERROR_BAD_ADDRESS = 7
+ERROR_NOT_SUPPORTED = 8
+ERROR_BUFFER_TOO_SMALL = 9
+ERROR_MALFORMED_PAYLOAD = 10
+ERROR_INVALID_ARGUMENT = 11
+ERROR_ABI_MISMATCH = 12
+SERVICE_UUID_V2 = '956C7B26-D49A-4BA8-B03F-B17D393CB6E2'
+SERVICE_UUID_V1 = '96CC203E-5068-46AD-B32D-E316F5E069BA'
+SERVICE_UUID_BLE = '5B833E20-6BC7-4802-8E9A-723CECA4BD8F'

libmdr/connection.py

@@ -0,0 +1,73 @@
+"""High-level wrapper around MDRConnection helpers."""
+
+from __future__ import annotations
+
+from ctypes import POINTER, byref, c_int, cast, c_void_p
+from dataclasses import dataclass
+
+from . import _api, _dll, result
+
+
+@dataclass(frozen=True)
+class DeviceInfo:
+    name: str
+    address: str
+
+
+class Connection:
+    """Thin wrapper over an `MDRConnection*` owned elsewhere (usually libmdr_bt)."""
+
+    def __init__(self, ptr: object) -> None:
+        if not ptr:
+            raise ValueError("MDRConnection pointer is null")
+        self._ptr = cast(ptr, POINTER(_api.MDRConnection))
+
+    @property
+    def pointer(self):
+        return self._ptr
+
+    def as_void_p(self) -> c_void_p:
+        return cast(self._ptr, c_void_p)
+
+    def connect(self, mac_address: str, service_uuid: str) -> int:
+        return result.check(
+            _dll.lib().mdrConnectionConnect(
+                self._ptr,
+                mac_address.encode("utf-8"),
+                service_uuid.encode("utf-8"),
+            ),
+            allow_inprogress=True,
+        )
+
+    def disconnect(self) -> None:
+        _dll.lib().mdrConnectionDisconnect(self._ptr)
+
+    def poll(self, timeout_ms: int = 0) -> int:
+        return int(_dll.lib().mdrConnectionPoll(self._ptr, int(timeout_ms)))
+
+    def last_error(self) -> str:
+        text = _dll.lib().mdrConnectionGetLastError(self._ptr)
+        if not text:
+            return ""
+        return text.decode("utf-8", errors="replace")
+
+    def devices(self) -> list[DeviceInfo]:
+        lib = _dll.lib()
+        devices = POINTER(_api.MDRDeviceInfo)()
+        count = c_int(0)
+        result.check(lib.mdrConnectionGetDevicesList(self._ptr, byref(devices), byref(count)))
+        try:
+            out: list[DeviceInfo] = []
+            for index in range(count.value):
+                item = devices[index]
+                out.append(
+                    DeviceInfo(
+                        name=item.szDeviceName.decode("utf-8", errors="replace").rstrip("\x00"),
+                        address=item.szDeviceMacAddress.decode("utf-8", errors="replace").rstrip(
+                            "\x00"
+                        ),
+                    )
+                )
+            return out
+        finally:
+            result.check(lib.mdrConnectionFreeDevicesList(self._ptr, byref(devices)))