src.bluetooth_sig.types.address

Bluetooth address utilities.

This module provides utilities for working with Bluetooth device addresses (BD_ADDR), commonly represented as 48-bit MAC addresses.

Functions

Name	Description
bytes_to_mac_address(→ str)	Convert 6 bytes to a MAC address string.
mac_address_to_bytes(→ bytes)	Convert a MAC address string to 6 bytes.

Module Contents

src.bluetooth_sig.types.address.bytes_to_mac_address(data: bytes | bytearray) → str

Convert 6 bytes to a MAC address string.

Parameters:

data – 6-byte representation of MAC address

Returns:

BB:CC:DD:EE:FF”)

Return type:

MAC address string with colon separators (e.g., “AA

Raises:

ValueError – If data is not exactly 6 bytes

Example

>>> bytes_to_mac_address(bytes.fromhex("aabbccddeeff"))
'AA:BB:CC:DD:EE:FF'

src.bluetooth_sig.types.address.mac_address_to_bytes(mac_address: str) → bytes

Convert a MAC address string to 6 bytes.

Parameters:

mac_address – MAC address string (e.g., “AA:BB:CC:DD:EE:FF”)

Returns:

6-byte representation of the MAC address

Raises:

ValueError – If MAC address format is invalid

Example

>>> mac_address_to_bytes("AA:BB:CC:DD:EE:FF").hex()
'aabbccddeeff'