bluetooth-numbers 0.1.0

# Bluetooth numbers for Python

[](https://github.com/koenvervloesem/bluetooth-numbers/actions) [](https://pypi-hypernode.com/project/bluetooth-numbers) [](https://www.python.org) [](https://github.com/koenvervloesem/bluetooth-numbers/blob/main/LICENSE)

This project offers a Python package with a subset of [Bluetooth Assigned Numbers](https://www.bluetooth.com/specifications/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 Nordic Semiconductor’s [Bluetooth Numbers Database](https://github.com/NordicSemiconductor/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.

## Installation

The package can be installed from PyPI:

`shell pip3 install bluetooth-numbers `

## Usage

Get the description of a company ID:

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

Get the description of a service UUID:

`python >>> 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:

`python >>> 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:

`python >>> 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](LICENSE.txr) file for more information.