src.bluetooth_sig.registry.core.appearance_values

Registry for Bluetooth appearance values.

This module provides a registry for looking up human-readable device types and categories from appearance codes found in advertising data and GATT characteristics.

Classes

Name	Description
AppearanceValuesRegistry	Registry for Bluetooth appearance values with lazy loading.

Functions

Name	Description
get_appearance_values_registry(→ AppearanceValuesRegistry)	Return the process-wide appearance_values_registry singleton instance.

Module Contents

class src.bluetooth_sig.registry.core.appearance_values.AppearanceValuesRegistry

Bases: bluetooth_sig.registry.base.BaseGenericRegistry[bluetooth_sig.types.registry.appearance_info.AppearanceInfo]

Registry for Bluetooth appearance values with lazy loading.

This registry loads appearance values from the Bluetooth SIG assigned_numbers YAML file and provides lookup methods to decode appearance codes into human-readable device type information.

The registry uses lazy loading - the YAML file is only parsed on the first lookup call. This improves startup time and reduces memory usage when the registry is not needed.

Thread Safety:

This registry is thread-safe. Multiple threads can safely call get_appearance_info() concurrently.

Example::

>>> registry = AppearanceValuesRegistry()
>>> info = registry.get_appearance_info(833)
>>> if info:
...     print(info.full_name)  # "Heart Rate Sensor: Heart Rate Belt"
...     print(info.category)  # "Heart Rate Sensor"
...     print(info.subcategory)  # "Heart Rate Belt"

find_by_category_subcategory(category: str, subcategory: str | None = None) → bluetooth_sig.types.registry.appearance_info.AppearanceInfo | None

Find appearance info by category and subcategory names.

This method searches the registry for an appearance that matches the given category and subcategory names.

Parameters:

• category – Device category name (e.g., “Heart Rate Sensor”)

• subcategory – Optional subcategory name (e.g., “Heart Rate Belt”)

Returns:

AppearanceInfo if found, None otherwise

Example::

>>> registry = AppearanceValuesRegistry()
>>> info = registry.find_by_category_subcategory("Heart Rate Sensor", "Heart Rate Belt")
>>> if info:
...     print(info.category_value)  # Category value for lookup

get_appearance_info(appearance_code: int) → bluetooth_sig.types.registry.appearance_info.AppearanceInfo | None

Get appearance info by appearance code.

This method lazily loads the YAML file on first call.

Parameters:

appearance_code – 16-bit appearance value from BLE (0-65535)

Returns:

AppearanceInfo with decoded information, or None if code not found

Raises:

ValueError – If appearance_code is outside valid range (0-65535)

Example::

>>> registry = AppearanceValuesRegistry()
>>> info = registry.get_appearance_info(833)
>>> if info:
...     print(info.full_name)  # "Heart Rate Sensor: Heart Rate Belt"

src.bluetooth_sig.registry.core.appearance_values.get_appearance_values_registry() → AppearanceValuesRegistry

Return the process-wide appearance_values_registry singleton instance.