Bluetooth numbers for Python

This project offers a Python package with a subset of Bluetooth Assigned Numbers, so Python projects can easily use these numbers. The goal of this project is to provide a shared resource so various Python projects that deal with Bluetooth don't have to replicate this effort.

The source of the numbers in this package is mostly Nordic Semiconductor's Bluetooth Numbers Database, an up-to-date listing of all the various Bluetooth Specification-related elements that are defined by the Bluetooth industry (Company IDs, Service UUIDs, Characteristic UUIDs and Descriptor UUIDs), that you can use instead of rolling your own. It's supplemented with some data taken from the Bluetooth Assigned Numbers document that are not tracked by the Bluetooth Numbers Database.

Installation

The package can be installed from PyPI:

pip3 install bluetooth-numbers

Usage

Get the description of a company ID:

>>> from bluetooth_numbers.companies import company
>>> company[0x0499]
'Ruuvi Innovations Ltd.'

Get the description of a service UUID:

>>> from bluetooth_numbers.services import service
>>> from uuid import UUID
>>> service[0x180F]
'Battery Service'
>>> service[UUID("6E400001-B5A3-F393-E0A9-E50E24DCCA9E")]
'Nordic UART Service'

Get the description of a characteristic UUID:

>>> from bluetooth_numbers.characteristics import characteristic
>>> from uuid import UUID
>>> characteristic[0x2A37]
'Heart Rate Measurement'
>>> characteristic[UUID("6E400002-B5A3-F393-E0A9-E50E24DCCA9E")]
'UART RX Characteristic'

Get the description of a descriptor UUID:

>>> from bluetooth_numbers.descriptors import descriptor
>>> descriptor[0x2901]
'Characteristic User Descriptor'

License

This project is provided by Koen Vervloesem as open source software with the MIT license. See the LICENSE file for more information.

See also the license for the Bluetooth Numbers Database used in this package.