ePacket Bluetooth GATT central interface

ePacket Bluetooth GATT central interface More...

Data Structures
struct	epacket_bt_gatt_connect_params
	Parameters for epacket_bt_gatt_connect. More...

Macros
#define	epacket_bt_central_frame   epacket_v0_versioned_frame_format
	Bluetooth GATT central interface frame format, epacket_v0_versioned_frame_format.

Functions
int	epacket_bt_gatt_connect (struct bt_conn **conn, struct epacket_bt_gatt_connect_params *params, struct epacket_read_response *security, bool *already)
	Connect to a peer Infuse-IoT device via Bluetooth GATT.
void	epacket_bt_gatt_notify_init (struct bt_conn *conn)
	Setup epacket_bt_gatt_notify_recv_func.
uint8_t	epacket_bt_gatt_notify_recv_func (struct bt_conn *conn, struct bt_gatt_subscribe_params *params, const void *data, uint16_t length)
	Infuse-IoT Bluetooth GATT characteristic notification handle function.
void	epacket_bt_gatt_rate_limit_request (uint8_t delay_ms)
	Send a epacket_rate_limit_req to all connected peer devices.
int	epacket_bt_gatt_rate_throughput_request (struct bt_conn *conn, uint16_t throughput_kbps)
	Send a epacket_rate_throughput_req to a specific peer device.

Detailed Description

ePacket Bluetooth GATT central interface

Macro Definition Documentation

epacket_bt_central_frame

#define epacket_bt_central_frame   epacket_v0_versioned_frame_format

#include </__w/infuse-sdk/infuse-sdk/infuse-sdk/include/infuse/epacket/interface/epacket_bt_central.h>

Bluetooth GATT central interface frame format, epacket_v0_versioned_frame_format.

Function Documentation

epacket_bt_gatt_connect()

int epacket_bt_gatt_connect	(	struct bt_conn **	conn,
		struct epacket_bt_gatt_connect_params *	params,
		struct epacket_read_response *	security,
		bool *	already )

#include </__w/infuse-sdk/infuse-sdk/infuse-sdk/include/infuse/epacket/interface/epacket_bt_central.h>

Connect to a peer Infuse-IoT device via Bluetooth GATT.

Note

If called multiple times on the same connection, the subscribe requests, inactivity and absolute timeout are updated on each call.

Parameters

conn	Output connection object on success
params	ePacket connection parameters
security	Output security parameters of the peer device on success
already	True if the connection already existed

Return values

0	on success, *conn is valid
-ENOTCONN	if existing_only is set and no connection exists
-EINVAL	if an existing connection was not created by this interface
-EIO	if setup of an existing connection by another caller failed
-ETIMEDOUT	if setup of an existing connection did not complete within the connection timeout
>0	on HCI error, *conn is invalid
<0	on Zephyr error, *conn is invalid

epacket_bt_gatt_notify_init()

void epacket_bt_gatt_notify_init

(

struct bt_conn *

conn

)

#include </__w/infuse-sdk/infuse-sdk/infuse-sdk/include/infuse/epacket/interface/epacket_bt_central.h>

Setup epacket_bt_gatt_notify_recv_func.

Parameters

conn	Connection object. Must not be NULL.

epacket_bt_gatt_notify_recv_func()

uint8_t epacket_bt_gatt_notify_recv_func	(	struct bt_conn *	conn,
		struct bt_gatt_subscribe_params *	params,
		const void *	data,
		uint16_t	length )

#include </__w/infuse-sdk/infuse-sdk/infuse-sdk/include/infuse/epacket/interface/epacket_bt_central.h>

Infuse-IoT Bluetooth GATT characteristic notification handle function.

Public API function so that connections setup through a function other than epacket_bt_gatt_connect can hook the connection up as an ePacket data source dynamically.

Note

Users must ensure that epacket_bt_gatt_notify_init is called before any data is received on the connection.

Parameters

conn	Connection object. May be NULL, indicating that the peer is being unpaired
params	Subscription parameters.
data	Attribute value data. If NULL then subscription was removed.
length	Attribute value length.

Returns

BT_GATT_ITER_CONTINUE to continue receiving value notifications. BT_GATT_ITER_STOP to unsubscribe from value notifications.

epacket_bt_gatt_rate_limit_request()

void epacket_bt_gatt_rate_limit_request

(

uint8_t

delay_ms

)

#include </__w/infuse-sdk/infuse-sdk/infuse-sdk/include/infuse/epacket/interface/epacket_bt_central.h>

Send a epacket_rate_limit_req to all connected peer devices.

Parameters

delay_ms

Delay duration to request

epacket_bt_gatt_rate_throughput_request()

int epacket_bt_gatt_rate_throughput_request	(	struct bt_conn *	conn,
		uint16_t	throughput_kbps )

#include </__w/infuse-sdk/infuse-sdk/infuse-sdk/include/infuse/epacket/interface/epacket_bt_central.h>

Send a epacket_rate_throughput_req to a specific peer device.

Parameters

conn	Connection object
throughput_kbps	Requested throughput limit in kilobits/sec

Return values

0	on success
-errno	on error