Connection API

API Reference

---

• BLE (Bluetooth Low Energy)
• BR/EDR (Bluetooth Basic Rate / Enhanced Data Rate)
• EATT

group gatt_common_api

GATT Profile Connection Functions.

Functions

wiced_bt_gatt_status_t wiced_bt_gatt_register(wiced_bt_gatt_cback_t *p_gatt_cback)

Register an application callback for GATT.

Parameters

p_gatt_cback – [in] : The GATT notification callback

Returns

wiced_bt_gatt_status_t

wiced_bool_t wiced_bt_gatt_cancel_connect(wiced_bt_device_address_t bd_addr, wiced_bool_t is_direct)

Cancel initiating GATT connection.

Parameters

• bd_addr – [in] : Remote device address

• is_direct – [in] : Is direct connection or not

Returns

TRUE : If connection started FALSE : If connection start failure

wiced_bt_gatt_status_t wiced_bt_gatt_disconnect(uint16_t conn_id)

Close the specified GATT connection.

Result is notified using GATT_CONNECTION_STATUS_EVT of wiced_bt_gatt_cback_t.

Parameters

conn_id – [in] : GATT connection ID

Returns

wiced_bt_gatt_status_t

wiced_bt_gatt_status_t wiced_bt_gatt_get_device_address(uint16_t conn_id, wiced_bt_device_address_t *p_bdaddr, wiced_bt_transport_t *p_transport, wiced_bt_ble_address_type_t *p_addr_type)

API to get the bluetooth device address of the connected gatt conn_id.

note

: The API cannot be used to get the Bluetooth device address in case the device is disconnected

Parameters

• conn_id – [in] : Connection handle of the gatt bearer

• p_bdaddr – [out] : wiced_bt_device_address_t

• p_transport – [out] wiced_bt_transport_t of the bearer

• p_addr_type – [out] wiced_bt_ble_address_type_t of the bearer. Valid only if device referred by the conn_id is of type BT_TRANSPORT_LE

Returns

wiced_bt_gatt_status_t