Connection and Filter Accept List

group btm_ble_conn_filter_accept_list_functions

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

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 BLE background connection procedure type.

Parameters
  • conn_type[in] BTM_BLE_CONN_NONE, BTM_BLE_CONN_AUTO, or BTM_BLE_CONN_SELECTIVE

  • p_select_cback[in] callback for BTM_BLE_CONN_SELECTIVE

Returns

TRUE if background connection set

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
  • add_remove[in] : TRUE to add; FALSE to remove.

  • remote_bda[in] : device address to add/remove.

  • ble_addr_type[in] : Address type.

Returns

TRUE if successful

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
  • remote_bda[in] : remote device address.

  • p_conn_parameters[in] : 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.

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
  • add[in] TRUE to add; FALSE to remove

  • addr_type[in] Type of the addr

  • remote_bda[in] remote device address.

Returns

wiced_bool_t ( WICED_TRUE if successful else WICED_FALSE )

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
  • add[in] TRUE to add; FALSE to remove

  • remote_bda[in] remote device address.

  • addr_type[in] : remote device address type .

Returns

WICED_TRUE if successful else WICED_FALSE

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

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