Skip to content
Stops crashes of bluetooth due to Bluedroid running out of unique bluetooth address space
Java Shell Groovy
Branch: master
Clone or download
Latest commit d435966 Apr 5, 2014
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea initial commit Apr 2, 2014
app initial commit Apr 2, 2014
gradle/wrapper initial commit Apr 2, 2014
.gitignore initial commit Apr 2, 2014
BluetoothCrashResolver.iml initial commit Apr 2, 2014 Update Apr 5, 2014
build.gradle initial commit Apr 2, 2014 initial commit Apr 2, 2014
gradlew initial commit Apr 2, 2014
gradlew.bat initial commit Apr 2, 2014
settings.gradle initial commit Apr 2, 2014

Bluetooth Crash Resolver

This project contains an example Android app that makes use of a core class that provides relief for Android Bug 67272. This bug in the Bluedroid stack causes crashes in Android's BluetoothService when scanning for BLE devices encounters a large number of unique devices. It is rare for most users but can be problematic for those with apps scanning for Bluetooth LE devices in the background (e.g. iBeacon-enabled apps), especially when these users are around Bluetooth LE devices that randomize their mac address.

The core class that provides the functionality is com.radiusnetworks.bluetooth.BluetoothCrashResolver. Suggested improvements are strongly desired and feedback is encouraged.

The core class can both recover from crashes and prevent crashes from happening in the first place. In order to be able to prevent crashes, the module must be integrated in an app that does the BLE scans, and must make a call to the class with each scan record received so it can keep track of how many unique devices are likely in Bluedroid's memory.

The reference app that uses the core class in this project CANNOT prevent crashes because the app does not do its own bluetooth scanning. It can, however, reactively clear out the list of bluetooth addresses after a crash, making the next crash happen as far in the future as possible.

This app is also available in the Google Play Store.

##Integrating with your app

If you have an app that does Bluetooth LE scans, then here are the steps you need to take to add this to your app to prevent crashes:

  1. Copy into your codebase

  2. In whatever class does Bluetooth LE scanning, construct this object, call start(), and keep using the same object instance for as long as you keep doing scanning:

    bluetoothCrashResolver = new BlutoothCrashResolver(this.getApplicationContext()); bluetoothCrashResolver.start();

  3. Whenever you get a scan callback, make a call like this, passing a reference to your your LeScanCallback object:

    bluetoothCrashResolver.notifyScannedDevice(device, myLeScanCallback);

  4. When you stop scanning, call the stop method:


By performing the steps above, the module will keep track of how many unique devices are seen, and when they approach the limit of 1990, it will stop doing LeScans, and command a flush of the list. It will also save the list of recently seen devices to non-volatile storage, so if you stop scanning and start up again later (even after closing and reopening your app), it will resume counting from where it left off.

Apache 2.0 (Open Source)

##More details on the crash bug

Android Bug Report #67272

Android iBeacon Library Issue #16

A Solution for Android Bluetooth Crashes

You can’t perform that action at this time.