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: Dataclass-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 Guide

• 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! 🎉
• Coverage Report: Test Coverage (Generated from CI)

License

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