epacket_bt_central APIs

epacket_bt_central API 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

Functions
int	epacket_bt_gatt_connect (struct bt_conn **conn, struct epacket_bt_gatt_connect_params *params, struct epacket_read_response *security)
	Connect to a peer Infuse-IoT device via Bluetooth GATT.
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_bt_central API

Macro Definition Documentation

epacket_bt_central_frame

#define epacket_bt_central_frame   epacket_v0_versioned_frame_format

#include <infuse/epacket/interface/epacket_bt_central.h>

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 )

#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

Return values

0	on success, *conn is valid
>0	on HCI error, *conn is invalid
<0	on Zephyr error, *conn is invalid

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 <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.

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 <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 <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