com.idevicesinc.sweetblue

Interface BondFilter

All Known Implementing Classes:

BleDeviceConfig.DefaultBondFilter

public interface BondFilter

As of now there are two main default uses for this class...

The first is that in at least some cases it's not possible to determine beforehand whether a given characteristic requires bonding, so implementing this interface on BleDeviceConfig.bondFilter lets the app give a hint to the library so it can bond before attempting to read or write an encrypted characteristic. Providing these hints lets the library handle things in a more deterministic and optimized fashion, but is not required.

The second is that some android devices have issues when it comes to bonding. So far the worst culprits are certain Sony and Motorola phones, so if it looks like Build.MANUFACTURER is either one of those, BleDeviceConfig.DefaultBondFilter is set to unbond upon discoveries and disconnects. Please look at the source of BleDeviceConfig.DefaultBondFilter for the most up-to-date spec. The problem seems to be associated with mismanagement of pairing keys by the OS and this brute force solution seems to be the only way to smooth things out.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	BondFilter.CharacteristicEvent Struct passed to onEvent(CharacteristicEvent).
static class	BondFilter.CharacteristicEventType An enumeration of the type of characteristic operation for a BondFilter.CharacteristicEvent.
static class	BondFilter.ConnectionBugEvent
static class	BondFilter.Please Return value for the various interface methods of BondFilter.
static class	BondFilter.StateChangeEvent Just a dummy subclass of DeviceStateListener.StateEvent so that this gets auto-imported for implementations of BondFilter.

Method Summary

Modifier and Type	Method and Description
BondFilter.Please	onEvent(BondFilter.CharacteristicEvent e) Called immediately before reading, writing, or enabling notification on a characteristic.
BondFilter.ConnectionBugEvent.Please	onEvent(BondFilter.ConnectionBugEvent e) Called after bonding to a device, and the state reports as being disconnected, but the connection is still actually alive.
BondFilter.Please	onEvent(BondFilter.StateChangeEvent e) Called after a device undergoes a change in its BleDeviceState.

Method Detail

onEvent

BondFilter.Please onEvent(BondFilter.StateChangeEvent e)

Called after a device undergoes a change in its BleDeviceState.

onEvent

BondFilter.Please onEvent(BondFilter.CharacteristicEvent e)

Called immediately before reading, writing, or enabling notification on a characteristic.

onEvent

BondFilter.ConnectionBugEvent.Please onEvent(BondFilter.ConnectionBugEvent e)

Called after bonding to a device, and the state reports as being disconnected, but the connection is still actually alive. The BondFilter.ConnectionBugEvent.Please returned here will tell the library to attempt to fix it or not.