/py-decode-beacon

Python beacon (iBeacon and AltBeacon) decoder for BlueZ HCI event messages

Primary LanguagePythonMIT LicenseMIT

Python beacon advertisement decoder

Copyright (c) 2015 Patrick Van Oosterwijck

Released under the MIT license.

Library

The file decode_beacon.py provides an easily extensible decoder for beacon advertisement packets as received from BlueZ HCI events. Currently it supports Apple iBeacon and the free AltBeacon specifications.

I used various sources to try to understand the BlueZ HCI packet and iBeacon formats, this is documented in the IBEACON.md file.

Examples

The file decode_test.py contains a couple of simple hardcoded test HCI packets to test the decoder.

The file bluez_scan.py contains a simple BlueZ HCI advertisement packet scanner based on this code.