Bluetooth Data Tools
Tools for converting bluetooth data and packets
Installation
Install this via pip (or your favourite package manager):
pip install bluetooth-data-tools
Usage
Parsing BLE GAP Advertisement Data
Parse raw BLE advertisement bytes into structured data:
from bluetooth_data_tools import parse_advertisement_data_bytes
# Parse raw GAP advertisement bytes
parsed = parse_advertisement_data_bytes(raw_bytes)
local_name = parsed[0] # str | None
service_uuids = parsed[1] # list[str]
service_data = parsed[2] # dict[str, bytes]
manufacturer_data = parsed[3] # dict[int, bytes]
tx_power = parsed[4] # int | None
Or use the object-oriented interface:
from bluetooth_data_tools import BLEGAPAdvertisement, parse_advertisement_data
adv = parse_advertisement_data([raw_bytes1, raw_bytes2])
print(adv.local_name)
print(adv.service_uuids)
print(adv.service_data)
print(adv.manufacturer_data)
print(adv.tx_power)
Bluetooth Address Utilities
from bluetooth_data_tools import (
int_to_bluetooth_address,
mac_to_int,
short_address,
human_readable_name,
)
# Convert integer to MAC address
int_to_bluetooth_address(0x123456789ABC)
# "12:34:56:78:9A:BC"
# Convert MAC address to integer
mac_to_int("FF:FF:FF:FF:FF:FF")
# 281474976710655
# Get short address (last 2 octets)
short_address("AA:BB:CC:DD:EE:FF")
# "EEFF"
# Format a human-readable device name
human_readable_name("My Sensor", "", "AA:BB:CC:DD:EE:FF")
# "My Sensor (EEFF)"
Distance Estimation
Estimate distance from TX power and RSSI:
from bluetooth_data_tools import calculate_distance_meters
distance = calculate_distance_meters(power=-59, rssi=-60)
# ~1.135 meters
Monotonic Time
A fast monotonic clock optimized for Bluetooth event timing. On Linux, uses CLOCK_MONOTONIC_COARSE via Cython for lower overhead:
from bluetooth_data_tools import monotonic_time_coarse
now = monotonic_time_coarse()
Private Address Resolution (RPA)
Resolve Bluetooth Low Energy random private addresses using an Identity Resolving Key:
from bluetooth_data_tools import get_cipher_for_irk, resolve_private_address
cipher = get_cipher_for_irk(irk_bytes) # 16-byte Identity Resolving Key
is_match = resolve_private_address(cipher, "40:01:02:0A:C4:A6")
Contributors ✨
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
Credits
This package was created with Cookiecutter and the browniebroke/cookiecutter-pypackage project template.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bluetooth_data_tools-1.29.19.tar.gz.
File metadata
- Download URL: bluetooth_data_tools-1.29.19.tar.gz
- Upload date:
- Size: 20.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df54c690cbdc12c00786fce0919554edaed76673d2d9b1ccfa76cd9559e5d408
|
|
| MD5 |
7bb0d5cefea3b0e346aefdf02356611d
|
|
| BLAKE2b-256 |
df8637f7cedecefc0e24716b8987b9e77baffb3562e8bb1d126179ca74bdd562
|
Provenance
The following attestation bundles were made for bluetooth_data_tools-1.29.19.tar.gz:
Publisher:
ci.yml on Bluetooth-Devices/bluetooth-data-tools
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
bluetooth_data_tools-1.29.19.tar.gz -
Subject digest:
df54c690cbdc12c00786fce0919554edaed76673d2d9b1ccfa76cd9559e5d408 - Sigstore transparency entry: 2255749636
- Sigstore integration time:
-
Permalink:
Bluetooth-Devices/bluetooth-data-tools@54c1879a4324bacda713b2f738d2c7c1fea4a2b2 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Bluetooth-Devices
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@54c1879a4324bacda713b2f738d2c7c1fea4a2b2 -
Trigger Event:
push
-
Statement type:
File details
Details for the file bluetooth_data_tools-1.29.19-cp314-cp314-manylinux_2_41_x86_64.whl.
File metadata
- Download URL: bluetooth_data_tools-1.29.19-cp314-cp314-manylinux_2_41_x86_64.whl
- Upload date:
- Size: 156.1 kB
- Tags: CPython 3.14, manylinux: glibc 2.41+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fbc8dd0998e9234c35b964caa747e5078c2aa2de4a9c14fffce0ab82a6bbe255
|
|
| MD5 |
3bb859c4934356a639dc51ffc22aa26d
|
|
| BLAKE2b-256 |
831baf7caa7305cb342feb54e93ded7778e16f8544d2d920c523af82b4a5f93a
|
Provenance
The following attestation bundles were made for bluetooth_data_tools-1.29.19-cp314-cp314-manylinux_2_41_x86_64.whl:
Publisher:
ci.yml on Bluetooth-Devices/bluetooth-data-tools
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
bluetooth_data_tools-1.29.19-cp314-cp314-manylinux_2_41_x86_64.whl -
Subject digest:
fbc8dd0998e9234c35b964caa747e5078c2aa2de4a9c14fffce0ab82a6bbe255 - Sigstore transparency entry: 2255749649
- Sigstore integration time:
-
Permalink:
Bluetooth-Devices/bluetooth-data-tools@54c1879a4324bacda713b2f738d2c7c1fea4a2b2 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Bluetooth-Devices
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@54c1879a4324bacda713b2f738d2c7c1fea4a2b2 -
Trigger Event:
push
-
Statement type:
