Home

Awesome

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.