#include <stdbool.h>
#include <stdint.h>

Data Structures
struct	bt_gatt_iter

Typedefs
typedef void(*	bt_gatt_destroy_func_t )(void *user_data)

typedef void(*	bt_gatt_result_callback_t )(bool success, uint8_t att_ecode, void *user_data)

typedef void(*	bt_gatt_request_callback_t )(bool success, uint8_t att_ecode, struct bt_gatt_result result, void user_data)

Functions
unsigned int	bt_gatt_result_service_count (struct bt_gatt_result *result)

unsigned int	bt_gatt_result_characteristic_count (struct bt_gatt_result *result)

unsigned int	bt_gatt_result_descriptor_count (struct bt_gatt_result *result)

unsigned int	bt_gatt_result_included_count (struct bt_gatt_result *result)

bool	bt_gatt_iter_init (struct bt_gatt_iter iter, struct bt_gatt_result result)

bool	bt_gatt_iter_next_service (struct bt_gatt_iter iter, uint16_t start_handle, uint16_t *end_handle, uint8_t uuid[16])

bool	bt_gatt_iter_next_characteristic (struct bt_gatt_iter iter, uint16_t start_handle, uint16_t end_handle, uint16_t value_handle, uint8_t *properties, uint8_t uuid[16])

bool	bt_gatt_iter_next_descriptor (struct bt_gatt_iter iter, uint16_t handle, uint8_t uuid[16])

bool	bt_gatt_iter_next_included_service (struct bt_gatt_iter iter, uint16_t handle, uint16_t start_handle, uint16_t end_handle, uint8_t uuid[16])

bool	bt_gatt_iter_next_read_by_type (struct bt_gatt_iter iter, uint16_t handle, uint16_t length, const uint8_t *value)

struct bt_gatt_request *	bt_gatt_request_ref (struct bt_gatt_request *req)

void	bt_gatt_request_unref (struct bt_gatt_request *req)

void	bt_gatt_request_cancel (struct bt_gatt_request *req)

unsigned int	bt_gatt_exchange_mtu (struct bt_att att, uint16_t client_rx_mtu, bt_gatt_result_callback_t callback, void user_data, bt_gatt_destroy_func_t destroy)

struct bt_gatt_request *	bt_gatt_discover_all_primary_services (struct bt_att att, bt_uuid_t uuid, bt_gatt_request_callback_t callback, void *user_data, bt_gatt_destroy_func_t destroy)

struct bt_gatt_request *	bt_gatt_discover_primary_services (struct bt_att att, bt_uuid_t uuid, uint16_t start, uint16_t end, bt_gatt_request_callback_t callback, void *user_data, bt_gatt_destroy_func_t destroy)

struct bt_gatt_request *	bt_gatt_discover_secondary_services (struct bt_att att, bt_uuid_t uuid, uint16_t start, uint16_t end, bt_gatt_request_callback_t callback, void *user_data, bt_gatt_destroy_func_t destroy)

struct bt_gatt_request *	bt_gatt_discover_included_services (struct bt_att att, uint16_t start, uint16_t end, bt_gatt_request_callback_t callback, void user_data, bt_gatt_destroy_func_t destroy)

struct bt_gatt_request *	bt_gatt_discover_characteristics (struct bt_att att, uint16_t start, uint16_t end, bt_gatt_request_callback_t callback, void user_data, bt_gatt_destroy_func_t destroy)

struct bt_gatt_request *	bt_gatt_discover_descriptors (struct bt_att att, uint16_t start, uint16_t end, bt_gatt_request_callback_t callback, void user_data, bt_gatt_destroy_func_t destroy)

bool	bt_gatt_read_by_type (struct bt_att att, uint16_t start, uint16_t end, const bt_uuid_t uuid, bt_gatt_request_callback_t callback, void *user_data, bt_gatt_destroy_func_t destroy)

Typedef Documentation

typedef void(* bt_gatt_destroy_func_t)(void *user_data)

Definition at line 60 of file gatt-helpers.h.

typedef void(* bt_gatt_request_callback_t)(bool success, uint8_t att_ecode, struct bt_gatt_result *result, void *user_data)

Definition at line 64 of file gatt-helpers.h.

typedef void(* bt_gatt_result_callback_t)(bool success, uint8_t att_ecode, void *user_data)

Definition at line 62 of file gatt-helpers.h.

Function Documentation

struct bt_gatt_request* bt_gatt_discover_all_primary_services	(	struct bt_att *	att,
		bt_uuid_t *	uuid,
		bt_gatt_request_callback_t	callback,
		void *	user_data,
		bt_gatt_destroy_func_t	destroy
	)

Definition at line 925 of file gatt-helpers.c.

References bt_gatt_discover_primary_services().

Referenced by exchange_mtu_cb().

struct bt_gatt_request* bt_gatt_discover_characteristics	(	struct bt_att *	att,
		uint16_t	start,
		uint16_t	end,
		bt_gatt_request_callback_t	callback,
		void *	user_data,
		bt_gatt_destroy_func_t	destroy
	)

Definition at line 1311 of file gatt-helpers.c.

References async_req_unref(), bt_gatt_request::att, BT_ATT_OP_READ_BY_TYPE_REQ, bt_att_send(), bt_gatt_request_ref(), bt_gatt_request::callback, bt_gatt_request::destroy, discover_chrcs_cb(), bt_gatt_request::end_handle, GATT_CHARAC_UUID, bt_gatt_request::id, new0, put_le16(), bt_gatt_request::start_handle, and bt_gatt_request::user_data.

Referenced by discover_chrcs_cb(), discover_descs_cb(), and discover_incl_cb().

struct bt_gatt_request* bt_gatt_discover_descriptors	(	struct bt_att *	att,
		uint16_t	start,
		uint16_t	end,
		bt_gatt_request_callback_t	callback,
		void *	user_data,
		bt_gatt_destroy_func_t	destroy
	)

Definition at line 1544 of file gatt-helpers.c.

References async_req_unref(), bt_gatt_request::att, BT_ATT_OP_FIND_INFO_REQ, bt_att_send(), bt_gatt_request_ref(), bt_gatt_request::callback, bt_gatt_request::destroy, discover_descs_cb(), bt_gatt_request::end_handle, bt_gatt_request::id, new0, put_le16(), bt_gatt_request::start_handle, and bt_gatt_request::user_data.

Referenced by discover_descs().

struct bt_gatt_request* bt_gatt_discover_included_services	(	struct bt_att *	att,
		uint16_t	start,
		uint16_t	end,
		bt_gatt_request_callback_t	callback,
		void *	user_data,
		bt_gatt_destroy_func_t	destroy
	)

Definition at line 1194 of file gatt-helpers.c.

References async_req_unref(), bt_gatt_request::att, BT_ATT_OP_READ_BY_TYPE_REQ, bt_att_send(), bt_gatt_request_ref(), bt_gatt_request::callback, bt_gatt_request::destroy, discover_included_cb(), bt_gatt_request::end_handle, GATT_INCLUDE_UUID, bt_gatt_request::id, new0, put_le16(), bt_gatt_request::start_handle, and bt_gatt_request::user_data.

Referenced by discover_incl_cb(), and discover_secondary_cb().

struct bt_gatt_request* bt_gatt_discover_primary_services	(	struct bt_att *	att,
		bt_uuid_t *	uuid,
		uint16_t	start,
		uint16_t	end,
		bt_gatt_request_callback_t	callback,
		void *	user_data,
		bt_gatt_destroy_func_t	destroy
	)

Definition at line 936 of file gatt-helpers.c.

References discover_services().

Referenced by bt_gatt_discover_all_primary_services(), and process_service_changed().

struct bt_gatt_request* bt_gatt_discover_secondary_services	(	struct bt_att *	att,
		bt_uuid_t *	uuid,
		uint16_t	start,
		uint16_t	end,
		bt_gatt_request_callback_t	callback,
		void *	user_data,
		bt_gatt_destroy_func_t	destroy
	)

Definition at line 947 of file gatt-helpers.c.

References discover_services().

Referenced by discover_primary_cb().

unsigned int bt_gatt_exchange_mtu	(	struct bt_att *	att,
		uint16_t	client_rx_mtu,
		bt_gatt_result_callback_t	callback,
		void *	user_data,
		bt_gatt_destroy_func_t	destroy
	)

Exchange MTU trigger

bt_gatt_exchange_mtu is called by a GATT Client with the thereafter Parameters building the mtu_op data structure (gatt_client_init in btgattclient.c case)
bt_att_send is called with BT_ATT_OP_MTU_REQ op code and passing the mtu_op data structure
after receiving the response message mtu_cb is called with the opcode and the mtu_op data structure
mtu_cb call the user callback function (exchange_mtu_cb in the btgattclient.c case)

Parameters

att	pointer to bt_att data structure
client_rx_mtu	mtu client size
callback	user callback to call from mtu_cb (set in mtu_op internal data structure)
user_data	pointer for user, set in the mtu_op internal data structure
destroy	housekeeping data management function set in the mtu_op internal data structure

Returns: sequence number or 0 if error

Definition at line 582 of file gatt-helpers.c.

References mtu_op::att, BT_ATT_OP_MTU_REQ, bt_att_send(), mtu_op::callback, mtu_op::client_rx_mtu, mtu_op::destroy, destroy_mtu_op(), mtu_cb(), new0, put_le16(), and mtu_op::user_data.

Referenced by gatt_client_init().

bool bt_gatt_iter_init	(	struct bt_gatt_iter *	iter,
		struct bt_gatt_result *	result
	)

Definition at line 188 of file gatt-helpers.c.

References bt_gatt_iter::pos, and bt_gatt_iter::result.

Referenced by discover_chrcs_cb(), discover_descs_cb(), discover_incl_cb(), discover_primary_cb(), and discover_secondary_cb().

bool bt_gatt_iter_next_characteristic	(	struct bt_gatt_iter *	iter,
		uint16_t *	start_handle,
		uint16_t *	end_handle,
		uint16_t *	value_handle,
		uint8_t *	properties,
		uint8_t	uuid[16]
	)

Definition at line 378 of file gatt-helpers.c.

References BT_ATT_OP_READ_BY_TYPE_RSP, convert_uuid_le(), bt_gatt_result::data_len, bt_gatt_request::end_handle, get_le16(), bt_gatt_result::next, bt_gatt_result::op, bt_gatt_result::opcode, bt_gatt_result::pdu, bt_gatt_result::pdu_len, bt_gatt_iter::pos, bt_gatt_iter::result, bt_uuid_t::type, and bt_gatt_request::uuid.

Referenced by discover_chrcs_cb().

bool bt_gatt_iter_next_descriptor	(	struct bt_gatt_iter *	iter,
		uint16_t *	handle,
		uint8_t	uuid[16]
	)

Definition at line 430 of file gatt-helpers.c.

References BT_ATT_OP_FIND_INFO_RSP, convert_uuid_le(), bt_gatt_result::data_len, get_le16(), bt_gatt_result::next, bt_gatt_result::opcode, bt_gatt_result::pdu, bt_gatt_result::pdu_len, bt_gatt_iter::pos, and bt_gatt_iter::result.

Referenced by discover_descs_cb().

bool bt_gatt_iter_next_included_service	(	struct bt_gatt_iter *	iter,
		uint16_t *	handle,
		uint16_t *	start_handle,
		uint16_t *	end_handle,
		uint8_t	uuid[16]
	)

Definition at line 257 of file gatt-helpers.c.

References BT_ATT_OP_READ_BY_TYPE_RSP, convert_uuid_le(), bt_gatt_result::data_len, get_le16(), bt_gatt_result::next, bt_gatt_result::op, bt_gatt_result::opcode, bt_gatt_result::pdu, bt_gatt_result::pdu_len, bt_gatt_iter::pos, bt_gatt_iter::result, bt_uuid_t::type, and bt_gatt_request::uuid.

Referenced by discover_incl_cb().

bool bt_gatt_iter_next_read_by_type	(	struct bt_gatt_iter *	iter,
		uint16_t *	handle,
		uint16_t *	length,
		const uint8_t **	value
	)

Definition at line 455 of file gatt-helpers.c.

References BT_ATT_OP_READ_BY_TYPE_RSP, bt_gatt_result::data_len, get_le16(), bt_gatt_result::next, bt_gatt_result::op, bt_gatt_result::opcode, bt_gatt_result::pdu, bt_gatt_result::pdu_len, bt_gatt_iter::pos, bt_gatt_iter::result, bt_uuid_t::type, and bt_gatt_request::uuid.

bool bt_gatt_iter_next_service	(	struct bt_gatt_iter *	iter,
		uint16_t *	start_handle,
		uint16_t *	end_handle,
		uint8_t	uuid[16]
	)

Definition at line 337 of file gatt-helpers.c.

References BT_ATT_OP_FIND_BY_TYPE_VAL_RSP, BT_ATT_OP_READ_BY_GRP_TYPE_RSP, bt_uuid_to_uuid128(), convert_uuid_le(), uint128_t::data, bt_gatt_result::data_len, get_le16(), bt_gatt_result::next, bt_gatt_result::op, bt_gatt_result::opcode, bt_gatt_result::pdu, bt_gatt_result::pdu_len, bt_gatt_iter::pos, bt_gatt_iter::result, bt_uuid_t::u128, bt_gatt_request::uuid, and bt_uuid_t::value.

Referenced by discover_primary_cb(), and discover_secondary_cb().

bool bt_gatt_read_by_type	(	struct bt_att *	att,
		uint16_t	start,
		uint16_t	end,
		const bt_uuid_t *	uuid,
		bt_gatt_request_callback_t	callback,
		void *	user_data,
		bt_gatt_destroy_func_t	destroy
	)