184 lines
6.6 KiB
Python
184 lines
6.6 KiB
Python
# -*- coding: utf-8 -*-
|
|
import uuid
|
|
from typing import Optional, Union
|
|
|
|
|
|
class BleakError(Exception):
|
|
"""Base Exception for bleak."""
|
|
|
|
pass
|
|
|
|
|
|
class BleakCharacteristicNotFoundError(BleakError):
|
|
"""
|
|
Exception which is raised if a device does not support a characteristic.
|
|
|
|
.. versionadded: 0.22
|
|
"""
|
|
|
|
char_specifier: Union[int, str, uuid.UUID]
|
|
|
|
def __init__(self, char_specifier: Union[int, str, uuid.UUID]) -> None:
|
|
"""
|
|
Args:
|
|
characteristic (str): handle or UUID of the characteristic which was not found
|
|
"""
|
|
super().__init__(f"Characteristic {char_specifier} was not found!")
|
|
self.char_specifier = char_specifier
|
|
|
|
|
|
class BleakDeviceNotFoundError(BleakError):
|
|
"""
|
|
Exception which is raised if a device can not be found by ``connect``, ``pair`` and ``unpair``.
|
|
This is the case if the OS Bluetooth stack has never seen this device or it was removed and forgotten.
|
|
|
|
.. versionadded: 0.19
|
|
"""
|
|
|
|
identifier: str
|
|
|
|
def __init__(self, identifier: str, *args: object) -> None:
|
|
"""
|
|
Args:
|
|
identifier (str): device identifier (Bluetooth address or UUID) of the device which was not found
|
|
"""
|
|
super().__init__(*args)
|
|
self.identifier = identifier
|
|
|
|
|
|
class BleakDBusError(BleakError):
|
|
"""Specialized exception type for D-Bus errors."""
|
|
|
|
def __init__(self, dbus_error: str, error_body: list):
|
|
"""
|
|
Args:
|
|
dbus_error (str): The D-Bus error, e.g. ``org.freedesktop.DBus.Error.UnknownObject``.
|
|
error_body (list): Body of the D-Bus error, sometimes containing error description or details.
|
|
"""
|
|
super().__init__(dbus_error, *error_body)
|
|
|
|
@property
|
|
def dbus_error(self) -> str:
|
|
"""Gets the D-Bus error name, e.g. ``org.freedesktop.DBus.Error.UnknownObject``."""
|
|
return self.args[0]
|
|
|
|
@property
|
|
def dbus_error_details(self) -> Optional[str]:
|
|
"""Gets the optional D-Bus error details, e.g. 'Invalid UUID'."""
|
|
if len(self.args) > 1:
|
|
details = self.args[1]
|
|
# Some error descriptions can be further parsed to be even more helpful
|
|
if "ATT error: 0x" in details:
|
|
more_detail = PROTOCOL_ERROR_CODES.get(
|
|
int(details.rsplit("x")[1], 16), "Unknown code"
|
|
)
|
|
details += f" ({more_detail})"
|
|
return details
|
|
return None
|
|
|
|
def __str__(self) -> str:
|
|
name = f"[{self.dbus_error}]"
|
|
details = self.dbus_error_details
|
|
return (name + " " + details) if details else name
|
|
|
|
|
|
CONTROLLER_ERROR_CODES = {
|
|
0x00: "Success",
|
|
0x01: "Unknown HCI Command",
|
|
0x02: "Unknown Connection Identifier",
|
|
0x03: "Hardware Failure",
|
|
0x04: "Page Timeout",
|
|
0x05: "Authentication Failure",
|
|
0x06: "PIN or Key Missing",
|
|
0x07: "Memory Capacity Exceeded",
|
|
0x08: "Connection Timeout",
|
|
0x09: "Connection Limit Exceeded",
|
|
0x0A: "Synchronous Connection Limit To A Device Exceeded",
|
|
0x0B: "Connection Already Exists",
|
|
0x0C: "Command Disallowed",
|
|
0x0D: "Connection Rejected due to Limited Resources",
|
|
0x0E: "Connection Rejected Due To Security Reasons",
|
|
0x0F: "Connection Rejected due to Unacceptable BD_ADDR",
|
|
0x10: "Connection Accept Timeout Exceeded",
|
|
0x11: "Unsupported Feature or Parameter Value",
|
|
0x12: "Invalid HCI Command Parameters",
|
|
0x13: "Remote User Terminated Connection",
|
|
0x14: "Remote Device Terminated Connection due to Low Resources",
|
|
0x15: "Remote Device Terminated Connection due to Power Off",
|
|
0x16: "Connection Terminated By Local Host",
|
|
0x17: "Repeated Attempts",
|
|
0x18: "Pairing Not Allowed",
|
|
0x19: "Unknown LMP PDU",
|
|
0x1A: "Unsupported Remote Feature / Unsupported LMP Feature",
|
|
0x1B: "SCO Offset Rejected",
|
|
0x1C: "SCO Interval Rejected",
|
|
0x1D: "SCO Air Mode Rejected",
|
|
0x1E: "Invalid LMP Parameters / Invalid LL Parameters",
|
|
0x1F: "Unspecified Error",
|
|
0x20: "Unsupported LMP Parameter Value / Unsupported LL Parameter Value",
|
|
0x21: "Role Change Not Allowed",
|
|
0x22: "LMP Response Timeout / LL Response Timeout",
|
|
0x23: "LMP Error Transaction Collision / LL Procedure Collision",
|
|
0x24: "LMP PDU Not Allowed",
|
|
0x25: "Encryption Mode Not Acceptable",
|
|
0x26: "Link Key cannot be Changed",
|
|
0x27: "Requested QoS Not Supported",
|
|
0x28: "Instant Passed",
|
|
0x29: "Pairing With Unit Key Not Supported",
|
|
0x2A: "Different Transaction Collision",
|
|
0x2B: "Reserved for future use",
|
|
0x2C: "QoS Unacceptable Parameter",
|
|
0x2D: "QoS Rejected",
|
|
0x2E: "Channel Classification Not Supported",
|
|
0x2F: "Insufficient Security",
|
|
0x30: "Parameter Out Of Mandatory Range",
|
|
0x31: "Reserved for future use",
|
|
0x32: "Role Switch Pending",
|
|
0x33: "Reserved for future use",
|
|
0x34: "Reserved Slot Violation",
|
|
0x35: "Role Switch Failed",
|
|
0x36: "Extended Inquiry Response Too Large",
|
|
0x37: "Secure Simple Pairing Not Supported By Host",
|
|
0x38: "Host Busy - Pairing",
|
|
0x39: "Connection Rejected due to No Suitable Channel Found",
|
|
0x3A: "Controller Busy",
|
|
0x3B: "Unacceptable Connection Parameters",
|
|
0x3C: "Advertising Timeout",
|
|
0x3D: "Connection Terminated due to MIC Failure",
|
|
0x3E: "Connection Failed to be Established / Synchronization Timeout",
|
|
0x3F: "MAC Connection Failed",
|
|
0x40: "Coarse Clock Adjustment Rejected but Will Try to Adjust Using Clock",
|
|
0x41: "Type0 Submap Not Defined",
|
|
0x42: "Unknown Advertising Identifier",
|
|
0x43: "Limit Reached",
|
|
0x44: "Operation Cancelled by Host",
|
|
0x45: "Packet Too Long",
|
|
}
|
|
|
|
# as defined in Bluetooth Core Specification v5.2, volume 3, part F, section 3.4.1.1, table 3.4.
|
|
PROTOCOL_ERROR_CODES = {
|
|
0x01: "Invalid Handle",
|
|
0x02: "Read Not Permitted",
|
|
0x03: "Write Not Permitted",
|
|
0x04: "Invalid PDU",
|
|
0x05: "Insufficient Authentication",
|
|
0x06: "Request Not Supported",
|
|
0x07: "Invalid Offset",
|
|
0x08: "Insufficient Authorization",
|
|
0x09: "Prepare Queue Full",
|
|
0x0A: "Attribute Not Found",
|
|
0x0B: "Attribute Not Long",
|
|
0x0C: "Insufficient Encryption Key Size",
|
|
0x0D: "Invalid Attribute Value Length",
|
|
0x0E: "Unlikely Error",
|
|
0x0F: "Insufficient Authentication",
|
|
0x10: "Unsupported Group Type",
|
|
0x11: "Insufficient Resource",
|
|
0x12: "Database Out Of Sync",
|
|
0x13: "Value Not Allowed",
|
|
# REVISIT: do we need Application Errors 0x80-0x9F?
|
|
0xFC: "Write Request Rejected",
|
|
0xFD: "Client Characteristic Configuration Descriptor Improperly Configured",
|
|
0xFE: "Procedure Already in Progress",
|
|
0xFF: "Out of Range",
|
|
}
|