Bluetooth utilities

Stack independent helpers for Bluetooth devices, UUIDs and pairing data (lib/btutil). More...

Modules
	Bluetooth UUIDs
	Expand 16-bit and 32-bit Bluetooth UUIDs to 128 bits.
	Pairing information helpers
	Compare and inspect struct pbl_bt_sm_pairing_info.

Functions
struct pbl_bt_device	bt_device_init_with_address (struct pbl_bt_addr address, bool is_random)
	Create an LE device from its address.
struct pbl_bt_addr	bt_device_get_address (struct pbl_bt_device device)
	Get the address of a device.
bool	bt_device_address_equal (const struct pbl_bt_addr *addr1, const struct pbl_bt_addr *addr2)
	Compare two addresses.
bool	bt_device_address_is_invalid (const struct pbl_bt_addr *addr)
	Check whether an address is invalid.
bool	bt_device_internal_equal (const struct pbl_bt_device_internal *device1_int, const struct pbl_bt_device_internal *device2_int)
	Compare two devices: address, address type and transport.
bool	bt_device_equal (const struct pbl_bt_device *device1, const struct pbl_bt_device *device2)
	Compare two devices, see bt_device_internal_equal().
bool	bt_device_is_invalid (const struct pbl_bt_device *device)
	Check whether a device is invalid, such as one returned by an API that found no device.

Detailed Description

Stack independent helpers for Bluetooth devices, UUIDs and pairing data (lib/btutil).

struct pbl_bt_device dev = bt_device_init_with_address(addr, false);
 
if (!bt_device_is_invalid(&dev)) {
  struct pbl_bt_addr a = bt_device_get_address(dev);
  PBL_LOG_DBG("Device " PBL_BT_ADDR_FMT, PBL_BT_ADDR_XPLODE(a));
}
 
Uuid hrs = bt_uuid_expand_16bit(0x180D); // 0000180D-0000-1000-8000-00805F9B34FB

Function Documentation

bt_device_address_equal()

bool bt_device_address_equal	(	const struct pbl_bt_addr *	addr1,
		const struct pbl_bt_addr *	addr2
	)

Compare two addresses.

Parameters

addr1	First address, may be NULL.
addr2	Second address, may be NULL.

Returns

true if both are non-NULL and equal.

bt_device_address_is_invalid()

bool bt_device_address_is_invalid

(

const struct pbl_bt_addr *

addr

)

Check whether an address is invalid.

Parameters

addr	The address, may be NULL.

Returns

true if addr is NULL or all zeros.

bt_device_equal()

bool bt_device_equal	(	const struct pbl_bt_device *	device1,
		const struct pbl_bt_device *	device2
	)

Compare two devices, see bt_device_internal_equal().

Parameters

device1	First device, may be NULL.
device2	Second device, may be NULL.

Returns

true if both are non-NULL and refer to the same device.

bt_device_get_address()

struct pbl_bt_addr bt_device_get_address

(

struct pbl_bt_device

device

)

Get the address of a device.

Parameters

device

The device.

Returns

The address.

bt_device_init_with_address()

struct pbl_bt_device bt_device_init_with_address	(	struct pbl_bt_addr	address,
		bool	is_random
	)

Create an LE device from its address.

Parameters

address	The address.
is_random	true for a random address, false for the public address (BD_ADDR).

Returns

The device.

bt_device_internal_equal()

bool bt_device_internal_equal	(	const struct pbl_bt_device_internal *	device1_int,
		const struct pbl_bt_device_internal *	device2_int
	)

Compare two devices: address, address type and transport.

Parameters

device1_int	First device, may be NULL.
device2_int	Second device, may be NULL.

Returns

true if both are non-NULL and refer to the same device.

bt_device_is_invalid()

bool bt_device_is_invalid

(

const struct pbl_bt_device *

device

)

Check whether a device is invalid, such as one returned by an API that found no device.

Parameters

device

The device.

Returns

true if device equals PBL_BT_DEVICE_INVALID.