cn.bingerz.flipble.scanner

Class ScanRecord

java.lang.Object

cn.bingerz.flipble.scanner.ScanRecord

public final class ScanRecord
extends java.lang.Object

Represents a scan record from Bluetooth LE scan.

Field Summary

Fields

Modifier and Type	Field and Description
static android.os.ParcelUuid	BASE_UUID
static int	UUID_BYTES_128_BIT
static int	UUID_BYTES_16_BIT
static int	UUID_BYTES_32_BIT

Method Summary

Modifier and Type	Method and Description
int	getAdvertiseFlags() Returns the advertising flags indicating the discoverable mode and capability of the device.
byte[]	getBytes() Returns raw bytes of scan record.
java.lang.String	getDeviceName() Returns the local name of the BLE device.
android.util.SparseArray<byte[]>	getManufacturerSpecificData() Returns a sparse array of manufacturer identifier and its corresponding manufacturer specific data.
byte[]	getManufacturerSpecificData(int manufacturerId) Returns the manufacturer specific data associated with the manufacturer id.
java.util.Map<android.os.ParcelUuid,byte[]>	getServiceData() Returns a map of service UUID and its corresponding service data.
byte[]	getServiceData(android.os.ParcelUuid serviceDataUuid) Returns the service data byte array associated with the serviceUuid.
java.util.List<android.os.ParcelUuid>	getServiceUuids() Returns a list of service UUIDs within the advertisement that are used to identify the bluetooth GATT services.
int	getTxPowerLevel() Returns the transmission power level of the packet in dBm.
static ScanRecord	parseFromBytes(byte[] scanRecord) Parse scan record bytes to ScanRecord.
static android.os.ParcelUuid	parseUuidFrom(byte[] uuidBytes) Parse UUID from bytes.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

UUID_BYTES_16_BIT

public static final int UUID_BYTES_16_BIT

See Also:

Constant Field Values

UUID_BYTES_32_BIT

public static final int UUID_BYTES_32_BIT

See Also:

Constant Field Values

UUID_BYTES_128_BIT

public static final int UUID_BYTES_128_BIT

See Also:

Constant Field Values

BASE_UUID

public static final android.os.ParcelUuid BASE_UUID

Method Detail

getAdvertiseFlags

public int getAdvertiseFlags()

Returns the advertising flags indicating the discoverable mode and capability of the device. Returns -1 if the flag field is not set.

getServiceUuids

public java.util.List<android.os.ParcelUuid> getServiceUuids()

Returns a list of service UUIDs within the advertisement that are used to identify the bluetooth GATT services.

getManufacturerSpecificData

public android.util.SparseArray<byte[]> getManufacturerSpecificData()

Returns a sparse array of manufacturer identifier and its corresponding manufacturer specific data.

getManufacturerSpecificData

public byte[] getManufacturerSpecificData(int manufacturerId)

Returns the manufacturer specific data associated with the manufacturer id. Returns null if the manufacturerId is not found.

getServiceData

public java.util.Map<android.os.ParcelUuid,byte[]> getServiceData()

Returns a map of service UUID and its corresponding service data.

getServiceData

public byte[] getServiceData(android.os.ParcelUuid serviceDataUuid)

Returns the service data byte array associated with the serviceUuid. Returns null if the serviceDataUuid is not found.

getTxPowerLevel

public int getTxPowerLevel()

Returns the transmission power level of the packet in dBm. Returns Integer.MIN_VALUE if the field is not set. This value can be used to calculate the path loss of a received packet using the following equation:

pathloss = txPowerLevel - rssi

getDeviceName

public java.lang.String getDeviceName()

Returns the local name of the BLE device. The is a UTF-8 encoded string.

getBytes

public byte[] getBytes()

Returns raw bytes of scan record.

parseFromBytes

public static ScanRecord parseFromBytes(byte[] scanRecord)

Parse scan record bytes to ScanRecord.

The format is defined in Bluetooth 4.1 specification, Volume 3, Part C, Section 11 and 18.

All numerical multi-byte entities and values shall use little-endian byte order.

Parameters:

scanRecord - The scan record of Bluetooth LE advertisement and/or scan response.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

parseUuidFrom

public static android.os.ParcelUuid parseUuidFrom(byte[] uuidBytes)

Parse UUID from bytes. The uuidBytes can represent a 16-bit, 32-bit or 128-bit UUID, but the returned UUID is always in 128-bit format. Note UUID is little endian in Bluetooth.

Parameters:

uuidBytes - Byte representation of uuid.

Returns:

ParcelUuid parsed from bytes.

Throws:

java.lang.IllegalArgumentException - If the uuidBytes cannot be parsed.