Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/joshdholtz/sweettooth-android-ble


https://github.com/joshdholtz/sweettooth-android-ble

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

# SweetTooth
A simplistic, sugarcoated, Android BLE Wrapper

## Let's Get Down To Business

1. Initialize SweetToothManager with Application (to get context)
2. Add SweetToothListener to SweetToothManager
- This listener will get notified of discovered devices
3. Start scanning
- You know, it starts scanning for devices

````java

// Init instance and add listener
SweetToothManager.getInstance().initInstance(getApplication());
SweetToothManager.getInstance().addListener(new SweetToothListener() {

@Override
public void onDiscoveredDevice(BluetoothDevice arg0, int arg1, byte[] arg2) {
Log.d("SweetTooth", "We got device - " + arg0.getName());
}

@Override
public void onScanningIntervalStateChange(boolean arg0) {

}

@Override
public void onScanningStateChange(boolean arg0) {

}

});

// Starts scanning - this should probably start on a button press
SweetToothManager.getInstance().start();

````

## Scans on interval - a little bit of hacks
Not sure if needed yet

````java

public class MainActivity extends Activity implements SweetToothListener {

// Starts scanning on an interval - turns on scan for 5 seconds, turns off scanning for 0.5 seconds
// This is used (in this case) since Android as no way to turn on multiple discoveries of an advertising device
SweetToothManager.getInstance().startOnInterval(5000, 500);

}

````

## WTF is with the scanRecord?
The scan record contains advertisement data but the simple byte array does not provide easy access to the information.

BLEAdvertisementData class parses the scanRecord and provides helpers for getting all of the data out.
If the helpers aren't enough, the BLEAdvertisementData class extends HashMap so you can grab any data you want out of it.

````java

@Override
public void discoveredDevice(BluetoothDevice device, int rssi, byte[] scanRecord) {
BLEAdvertisementData blueTipzData = BLEAdvertisementData.parseAdvertisementData(scanRecord);

Log.d("SweetTooth", "Flags - " + blueTipzData.getFlags() );

Log.d("SweetTooth", "16 bit UUIDS - " + Arrays.toString( blueTipzData.get16BitServiceUUIDs() ) );
Log.d("SweetTooth", "More 16 bit UUIDS - " + Arrays.toString( blueTipzData.getMore16BitServiceUUIDs() ) );

Log.d("SweetTooth", "32 bit UUIDS - " + Arrays.toString( blueTipzData.get32BitServiceUUIDs() ) );
Log.d("SweetTooth", "More 32 bit UUIDS - " + Arrays.toString( blueTipzData.getMore32BitServiceUUIDs() ) );

Log.d("SweetTooth", "128 bit UUIDS - " + Arrays.toString( blueTipzData.get128BitServiceUUIDs() ) );
Log.d("SweetTooth", "More 128 bit UUIDS - " + Arrays.toString( blueTipzData.getMore128BitServiceUUIDs() ) );

Log.d("SweetTooth", "Local name complete - " + blueTipzData.getLocalNameComplete() );
Log.d("SweetTooth", "Local name shortened - " + blueTipzData.getLocalNameShortened() );
}

````