Bluetooth SIG Standards Library¶

A pure Python library for Bluetooth SIG standards interpretation

Welcome¶

The Bluetooth SIG Standards Library provides comprehensive GATT characteristic and service parsing with automatic UUID resolution. Built on the official Bluetooth SIG specifications, it offers a robust, standards-compliant architecture for Bluetooth device communication with type-safe data parsing and clean API design.

Key Features¶

✅ Standards-Based: Official Bluetooth SIG YAML registry with automatic UUID resolution
✅ Type-Safe: Convert raw Bluetooth data to meaningful sensor values with comprehensive typing
✅ Modern Python: msgspec-based design with Python 3.9+ compatibility
✅ Comprehensive: Support for 70+ GATT characteristics across multiple service categories
✅ Production Ready: Extensive validation, perfect code quality scores, and comprehensive testing
✅ Framework Agnostic: Works with any BLE connection library (bleak, simplepyble, etc.)

Quick Example¶

from bluetooth_sig import BluetoothSIGTranslator

translator = BluetoothSIGTranslator()
service_info = translator.get_sig_info_by_uuid("180F")  # Battery
char_info = translator.get_sig_info_by_uuid("2A19")  # Battery Level

Getting Started¶

⚡ Quick Start

Get up and running in minutes

Quick Start

📦 Installation

Install via pip or from source

Installation

📖 Usage Guide

Learn how to use the library

Usage

📚 API Reference

Detailed API documentation

API Reference

Why Choose This Library?¶

Unlike other Bluetooth libraries that focus on device connectivity, this library specializes in standards interpretation. It bridges the gap between raw BLE data and meaningful application-level information.

Learn more about what this library solves →

Support¶

Issues: GitHub Issues
Source Code: GitHub Repository
Documentation: You’re here! 🎉
Test Coverage: Available in CI artifacts

License¶

This project is licensed under the MIT License - see the LICENSE file for details.