Connection and Filter Accept List

This section provides functions for LE connection related and Filter Accept List operations. More...

Functions
wiced_bool_t	wiced_bt_ble_set_background_connection_type (wiced_bt_ble_conn_type_t conn_type, wiced_bt_ble_selective_conn_cback_t *p_select_cback)
	Set LE background connection procedure type. More...
wiced_bool_t	wiced_bt_ble_update_background_connection_device (wiced_bool_t add_remove, wiced_bt_device_address_t remote_bda, wiced_bt_ble_address_type_t ble_addr_type)
	This function is called to add or remove a device into/from background connection procedure. More...
wiced_result_t	wiced_bt_ble_get_connection_parameters (wiced_bt_device_address_t remote_bda, wiced_bt_ble_conn_params_t *p_conn_parameters)
	To read LE connection parameters based on connection address received in gatt connection up indication. More...
wiced_bool_t	wiced_bt_ble_update_advertising_filter_accept_list (wiced_bool_t add, wiced_bt_ble_address_type_t addr_type, wiced_bt_device_address_t remote_bda)
	Add or remove device from advertising filter Accept List. More...
wiced_bool_t	wiced_bt_ble_update_scanner_filter_list (wiced_bool_t add, wiced_bt_device_address_t remote_bda, wiced_bt_ble_address_type_t addr_type)
	Add or remove device from scanner filter Accept List. More...
wiced_bool_t	wiced_bt_ble_clear_filter_accept_list (void)
	Request clearing filter Accept List in controller side. More...
uint8_t	wiced_bt_ble_get_filter_accept_list_size (void)
	Returns size of Filter Accept List size in controller side. More...

Detailed Description

This section provides functions for LE connection related and Filter Accept List operations.

Function Documentation

wiced_bool_t wiced_bt_ble_clear_filter_accept_list

(

void

)

Request clearing filter Accept List in controller side.

Returns

TRUE if request of clear is sent to controller side

wiced_result_t wiced_bt_ble_get_connection_parameters	(	wiced_bt_device_address_t	remote_bda,
		wiced_bt_ble_conn_params_t *	p_conn_parameters
	)

To read LE connection parameters based on connection address received in gatt connection up indication.

Parameters

[in]	remote_bda	: remote device address.
[in]	p_conn_parameters	: Connection Parameters

Returns

wiced_result_t
WICED_BT_ILLEGAL_VALUE : if p_conn_parameters is NULL.
WICED_BT_UNKNOWN_ADDR : if device address is bad.
WICED_BT_SUCCESS otherwise.

uint8_t wiced_bt_ble_get_filter_accept_list_size

(

void

)

Returns size of Filter Accept List size in controller side.

Returns

size of Filter Accept List in current controller

wiced_bool_t wiced_bt_ble_set_background_connection_type	(	wiced_bt_ble_conn_type_t	conn_type,
		wiced_bt_ble_selective_conn_cback_t *	p_select_cback
	)

Set LE background connection procedure type.

Parameters

[in]	conn_type	BTM_BLE_CONN_NONE, BTM_BLE_CONN_AUTO, or BTM_BLE_CONN_SELECTIVE
[in]	p_select_cback	callback for BTM_BLE_CONN_SELECTIVE

Returns

TRUE if background connection set

wiced_bool_t wiced_bt_ble_update_advertising_filter_accept_list	(	wiced_bool_t	add,
		wiced_bt_ble_address_type_t	addr_type,
		wiced_bt_device_address_t	remote_bda
	)

Add or remove device from advertising filter Accept List.

Parameters

[in]	add	TRUE to add; FALSE to remove
[in]	addr_type	Type of the addr
[in]	remote_bda	remote device address.

Returns

wiced_bool_t ( WICED_TRUE if successful else WICED_FALSE )

wiced_bool_t wiced_bt_ble_update_background_connection_device	(	wiced_bool_t	add_remove,
		wiced_bt_device_address_t	remote_bda,
		wiced_bt_ble_address_type_t	ble_addr_type
	)

This function is called to add or remove a device into/from background connection procedure.

The background connection procedure is decided by the background connection type, it can be auto connection, or selective connection.

Parameters

[in]	add_remove	: TRUE to add; FALSE to remove.
[in]	remote_bda	: device address to add/remove.
[in]	ble_addr_type	: Address type.

Returns

TRUE if successful

wiced_bool_t wiced_bt_ble_update_scanner_filter_list	(	wiced_bool_t	add,
		wiced_bt_device_address_t	remote_bda,
		wiced_bt_ble_address_type_t	addr_type
	)

Add or remove device from scanner filter Accept List.

Parameters

[in]	add	TRUE to add; FALSE to remove
[in]	remote_bda	remote device address.
[in]	addr_type	: remote device address type .

Returns

WICED_TRUE if successful else WICED_FALSE