Python package with a wide set of numbers related to Bluetooth
This project offers a Python package with a wide set of numbers related to Bluetooth, 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 by rolling their own database and keeping it updated.
The following sources are used:
- Nordic Semiconductor's Bluetooth Numbers Database for Company IDs, Service UUIDs, Characteristic UUIDs and Descriptor UUIDs
- Bluetooth Assigned Numbers for SDO Service UUIDs and Member Service UUIDs
- The IEEE database of OUIs for prefixes of Bluetooth addresses
You can install bluetooth-numbers as a package from PyPI with pip:
pip install bluetooth-numbersGet the description of a company ID:
>>> from bluetooth_numbers import company
>>> company[0x0499]
'Ruuvi Innovations Ltd.'Get the description of a service UUID:
>>> from bluetooth_numbers 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 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 import descriptor
>>> descriptor[0x2901]
'Characteristic User Descriptor'Get the description of an OUI:
>>> from bluetooth_numbers import oui
>>> oui["58:2D:34"]
'Qingping Electronics (Suzhou) Co., Ltd'See the module reference for complete documentation.
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.
