blob: 0f1d8c6562aa1f97bae21b807dcaaee9e430ff6f [file] [log] [blame]
/******************************************************************************
*
* Copyright (C) 2010-2012 Broadcom Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
******************************************************************************/
/******************************************************************************
*
* This is the implementation of the API for GATT module of BTA.
*
******************************************************************************/
#include "bt_target.h"
#if (BTA_GATT_INCLUDED == TRUE)
#include <string.h>
#include <base/callback.h>
#include "bt_common.h"
#include "bta_gatt_api.h"
#include "bta_gattc_int.h"
#include "bta_sys.h"
/*****************************************************************************
* Constants
****************************************************************************/
static const tBTA_SYS_REG bta_gattc_reg = {bta_gattc_hdl_event,
BTA_GATTC_Disable};
/*******************************************************************************
*
* Function BTA_GATTC_Disable
*
* Description This function is called to disable GATTC module
*
* Parameters None.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_Disable(void) {
if (bta_sys_is_register(BTA_ID_GATTC) == false) {
APPL_TRACE_WARNING("GATTC Module not enabled/already disabled");
return;
}
BT_HDR* p_buf = (BT_HDR*)osi_malloc(sizeof(BT_HDR));
p_buf->event = BTA_GATTC_API_DISABLE_EVT;
bta_sys_sendmsg(p_buf);
bta_sys_deregister(BTA_ID_GATTC);
}
/*******************************************************************************
*
* Function BTA_GATTC_AppRegister
*
* Description This function is called to register application callbacks
* with BTA GATTC module.
*
* Parameters p_app_uuid - applicaiton UUID
* p_client_cb - pointer to the application callback function.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_AppRegister(tBT_UUID* p_app_uuid,
tBTA_GATTC_CBACK* p_client_cb) {
tBTA_GATTC_API_REG* p_buf =
(tBTA_GATTC_API_REG*)osi_malloc(sizeof(tBTA_GATTC_API_REG));
if (bta_sys_is_register(BTA_ID_GATTC) == false)
bta_sys_register(BTA_ID_GATTC, &bta_gattc_reg);
p_buf->hdr.event = BTA_GATTC_API_REG_EVT;
if (p_app_uuid != NULL)
memcpy(&p_buf->app_uuid, p_app_uuid, sizeof(tBT_UUID));
p_buf->p_cback = p_client_cb;
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_AppDeregister
*
* Description This function is called to deregister an application
* from BTA GATTC module.
*
* Parameters client_if - client interface identifier.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_AppDeregister(tBTA_GATTC_IF client_if) {
tBTA_GATTC_API_DEREG* p_buf =
(tBTA_GATTC_API_DEREG*)osi_malloc(sizeof(tBTA_GATTC_API_DEREG));
p_buf->hdr.event = BTA_GATTC_API_DEREG_EVT;
p_buf->client_if = client_if;
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_Open
*
* Description Open a direct connection or add a background auto connection
* bd address
*
* Parameters client_if: server interface.
* remote_bda: remote device BD address.
* is_direct: direct connection or background auto connection
* transport: Transport to be used for GATT connection
* (BREDR/LE)
*
* Returns void
*
******************************************************************************/
void BTA_GATTC_Open(tBTA_GATTC_IF client_if, BD_ADDR remote_bda, bool is_direct,
tBTA_GATT_TRANSPORT transport) {
tBTA_GATTC_API_OPEN* p_buf =
(tBTA_GATTC_API_OPEN*)osi_malloc(sizeof(tBTA_GATTC_API_OPEN));
p_buf->hdr.event = BTA_GATTC_API_OPEN_EVT;
p_buf->client_if = client_if;
p_buf->is_direct = is_direct;
p_buf->transport = transport;
memcpy(p_buf->remote_bda, remote_bda, BD_ADDR_LEN);
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_CancelOpen
*
* Description Cancel a direct open connection or remove a background auto
* connection
* bd address
*
* Parameters client_if: server interface.
* remote_bda: remote device BD address.
* is_direct: direct connection or background auto connection
*
* Returns void
*
******************************************************************************/
void BTA_GATTC_CancelOpen(tBTA_GATTC_IF client_if, BD_ADDR remote_bda,
bool is_direct) {
tBTA_GATTC_API_CANCEL_OPEN* p_buf = (tBTA_GATTC_API_CANCEL_OPEN*)osi_malloc(
sizeof(tBTA_GATTC_API_CANCEL_OPEN));
p_buf->hdr.event = BTA_GATTC_API_CANCEL_OPEN_EVT;
p_buf->client_if = client_if;
p_buf->is_direct = is_direct;
memcpy(p_buf->remote_bda, remote_bda, BD_ADDR_LEN);
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_Close
*
* Description Close a connection to a GATT server.
*
* Parameters conn_id: connectino ID to be closed.
*
* Returns void
*
******************************************************************************/
void BTA_GATTC_Close(uint16_t conn_id) {
BT_HDR* p_buf = (BT_HDR*)osi_malloc(sizeof(BT_HDR));
p_buf->event = BTA_GATTC_API_CLOSE_EVT;
p_buf->layer_specific = conn_id;
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_ConfigureMTU
*
* Description Configure the MTU size in the GATT channel. This can be done
* only once per connection.
*
* Parameters conn_id: connection ID.
* mtu: desired MTU size to use.
*
* Returns void
*
******************************************************************************/
void BTA_GATTC_ConfigureMTU(uint16_t conn_id, uint16_t mtu) {
tBTA_GATTC_API_CFG_MTU* p_buf =
(tBTA_GATTC_API_CFG_MTU*)osi_malloc(sizeof(tBTA_GATTC_API_CFG_MTU));
p_buf->hdr.event = BTA_GATTC_API_CFG_MTU_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->mtu = mtu;
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_ServiceSearchRequest
*
* Description This function is called to request a GATT service discovery
* on a GATT server. This function report service search
* result by a callback event, and followed by a service search
* complete event.
*
* Parameters conn_id: connection ID.
* p_srvc_uuid: a UUID of the service application is interested
* in.
* If Null, discover for all services.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_ServiceSearchRequest(uint16_t conn_id, tBT_UUID* p_srvc_uuid) {
const size_t len = sizeof(tBTA_GATTC_API_SEARCH) + sizeof(tBT_UUID);
tBTA_GATTC_API_SEARCH* p_buf = (tBTA_GATTC_API_SEARCH*)osi_calloc(len);
p_buf->hdr.event = BTA_GATTC_API_SEARCH_EVT;
p_buf->hdr.layer_specific = conn_id;
if (p_srvc_uuid) {
p_buf->p_srvc_uuid = (tBT_UUID*)(p_buf + 1);
memcpy(p_buf->p_srvc_uuid, p_srvc_uuid, sizeof(tBT_UUID));
} else {
p_buf->p_srvc_uuid = NULL;
}
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_GetServices
*
* Description This function is called to find the services on the given
* server.
*
* Parameters conn_id: connection ID which identify the server.
*
* Returns returns list_t of tBTA_GATTC_SERVICE or NULL.
*
******************************************************************************/
const list_t* BTA_GATTC_GetServices(uint16_t conn_id) {
return bta_gattc_get_services(conn_id);
}
/*******************************************************************************
*
* Function BTA_GATTC_GetCharacteristic
*
* Description This function is called to find the characteristic on the
* given server.
*
* Parameters conn_id - connection ID which identify the server.
* handle - characteristic handle
*
* Returns returns pointer to tBTA_GATTC_CHARACTERISTIC or NULL.
*
******************************************************************************/
const tBTA_GATTC_CHARACTERISTIC* BTA_GATTC_GetCharacteristic(uint16_t conn_id,
uint16_t handle) {
return bta_gattc_get_characteristic(conn_id, handle);
}
/*******************************************************************************
*
* Function BTA_GATTC_GetDescriptor
*
* Description This function is called to find the characteristic on the
* given server.
*
* Parameters conn_id - connection ID which identify the server.
* handle - descriptor handle
*
* Returns returns pointer to tBTA_GATTC_DESCRIPTOR or NULL.
*
******************************************************************************/
const tBTA_GATTC_DESCRIPTOR* BTA_GATTC_GetDescriptor(uint16_t conn_id,
uint16_t handle) {
return bta_gattc_get_descriptor(conn_id, handle);
}
/*******************************************************************************
*
* Function BTA_GATTC_GetGattDb
*
* Description This function is called to get the GATT database.
*
* Parameters conn_id: connection ID which identify the server.
* db: output parameter which will contain the GATT database
* copy. Caller is responsible for freeing it.
* count: number of elements in database.
*
******************************************************************************/
void BTA_GATTC_GetGattDb(uint16_t conn_id, uint16_t start_handle,
uint16_t end_handle, btgatt_db_element_t** db,
int* count) {
bta_gattc_get_gatt_db(conn_id, start_handle, end_handle, db, count);
}
/*******************************************************************************
*
* Function BTA_GATTC_ReadCharacteristic
*
* Description This function is called to read a characteristics value
*
* Parameters conn_id - connection ID.
* handle - characteritic handle to read.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_ReadCharacteristic(uint16_t conn_id, uint16_t handle,
tBTA_GATT_AUTH_REQ auth_req,
GATT_READ_OP_CB callback, void* cb_data) {
tBTA_GATTC_API_READ* p_buf =
(tBTA_GATTC_API_READ*)osi_calloc(sizeof(tBTA_GATTC_API_READ));
p_buf->hdr.event = BTA_GATTC_API_READ_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->auth_req = auth_req;
p_buf->handle = handle;
p_buf->read_cb = callback;
p_buf->read_cb_data = cb_data;
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_ReadCharDescr
*
* Description This function is called to read a descriptor value.
*
* Parameters conn_id - connection ID.
* handle - descriptor handle to read.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_ReadCharDescr(uint16_t conn_id, uint16_t handle,
tBTA_GATT_AUTH_REQ auth_req,
GATT_READ_OP_CB callback, void* cb_data) {
tBTA_GATTC_API_READ* p_buf =
(tBTA_GATTC_API_READ*)osi_calloc(sizeof(tBTA_GATTC_API_READ));
p_buf->hdr.event = BTA_GATTC_API_READ_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->auth_req = auth_req;
p_buf->handle = handle;
p_buf->read_cb = callback;
p_buf->read_cb_data = cb_data;
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_ReadMultiple
*
* Description This function is called to read multiple characteristic or
* characteristic descriptors.
*
* Parameters conn_id - connectino ID.
* p_read_multi - pointer to the read multiple parameter.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_ReadMultiple(uint16_t conn_id, tBTA_GATTC_MULTI* p_read_multi,
tBTA_GATT_AUTH_REQ auth_req) {
tBTA_GATTC_API_READ_MULTI* p_buf =
(tBTA_GATTC_API_READ_MULTI*)osi_calloc(sizeof(tBTA_GATTC_API_READ_MULTI));
p_buf->hdr.event = BTA_GATTC_API_READ_MULTI_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->auth_req = auth_req;
p_buf->num_attr = p_read_multi->num_attr;
if (p_buf->num_attr > 0)
memcpy(p_buf->handles, p_read_multi->handles,
sizeof(uint16_t) * p_read_multi->num_attr);
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_WriteCharValue
*
* Description This function is called to write characteristic value.
*
* Parameters conn_id - connection ID.
* handle - characteristic handle to write.
* write_type - type of write.
* value - the value to be written.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_WriteCharValue(uint16_t conn_id, uint16_t handle,
tBTA_GATTC_WRITE_TYPE write_type,
std::vector<uint8_t> value,
tBTA_GATT_AUTH_REQ auth_req,
GATT_WRITE_OP_CB callback, void* cb_data) {
tBTA_GATTC_API_WRITE* p_buf = (tBTA_GATTC_API_WRITE*)osi_calloc(
sizeof(tBTA_GATTC_API_WRITE) + value.size());
p_buf->hdr.event = BTA_GATTC_API_WRITE_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->auth_req = auth_req;
p_buf->handle = handle;
p_buf->write_type = write_type;
p_buf->len = value.size();
p_buf->write_cb = callback;
p_buf->write_cb_data = cb_data;
if (value.size() > 0) {
p_buf->p_value = (uint8_t*)(p_buf + 1);
memcpy(p_buf->p_value, value.data(), value.size());
}
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_WriteCharDescr
*
* Description This function is called to write descriptor value.
*
* Parameters conn_id - connection ID
* handle - descriptor hadle to write.
* value - the value to be written.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_WriteCharDescr(uint16_t conn_id, uint16_t handle,
std::vector<uint8_t> value,
tBTA_GATT_AUTH_REQ auth_req,
GATT_WRITE_OP_CB callback, void* cb_data) {
tBTA_GATTC_API_WRITE* p_buf = (tBTA_GATTC_API_WRITE*)osi_calloc(
sizeof(tBTA_GATTC_API_WRITE) + value.size());
p_buf->hdr.event = BTA_GATTC_API_WRITE_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->auth_req = auth_req;
p_buf->handle = handle;
p_buf->write_type = BTA_GATTC_TYPE_WRITE;
p_buf->write_cb = callback;
p_buf->write_cb_data = cb_data;
if (value.size() != 0) {
p_buf->p_value = (uint8_t*)(p_buf + 1);
p_buf->len = value.size();
memcpy(p_buf->p_value, value.data(), value.size());
}
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_PrepareWrite
*
* Description This function is called to prepare write a characteristic
* value.
*
* Parameters conn_id - connection ID.
* p_char_id - GATT characteritic ID of the service.
* offset - offset of the write value.
* value - the value to be written.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_PrepareWrite(uint16_t conn_id, uint16_t handle, uint16_t offset,
std::vector<uint8_t> value,
tBTA_GATT_AUTH_REQ auth_req,
GATT_WRITE_OP_CB callback, void* cb_data) {
tBTA_GATTC_API_WRITE* p_buf = (tBTA_GATTC_API_WRITE*)osi_calloc(
sizeof(tBTA_GATTC_API_WRITE) + value.size());
p_buf->hdr.event = BTA_GATTC_API_WRITE_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->auth_req = auth_req;
p_buf->handle = handle;
p_buf->write_cb = callback;
p_buf->write_cb_data = cb_data;
p_buf->write_type = BTA_GATTC_WRITE_PREPARE;
p_buf->offset = offset;
p_buf->len = value.size();
if (value.size() > 0) {
p_buf->p_value = (uint8_t*)(p_buf + 1);
memcpy(p_buf->p_value, value.data(), value.size());
}
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_ExecuteWrite
*
* Description This function is called to execute write a prepare write
* sequence.
*
* Parameters conn_id - connection ID.
* is_execute - execute or cancel.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_ExecuteWrite(uint16_t conn_id, bool is_execute) {
tBTA_GATTC_API_EXEC* p_buf =
(tBTA_GATTC_API_EXEC*)osi_calloc(sizeof(tBTA_GATTC_API_EXEC));
p_buf->hdr.event = BTA_GATTC_API_EXEC_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->is_execute = is_execute;
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_SendIndConfirm
*
* Description This function is called to send handle value confirmation.
*
* Parameters conn_id - connection ID.
* p_char_id - characteristic ID to confirm.
*
* Returns None
*
******************************************************************************/
void BTA_GATTC_SendIndConfirm(uint16_t conn_id, uint16_t handle) {
tBTA_GATTC_API_CONFIRM* p_buf =
(tBTA_GATTC_API_CONFIRM*)osi_calloc(sizeof(tBTA_GATTC_API_CONFIRM));
APPL_TRACE_API("%s conn_id=%d handle=0x%04x", __func__, conn_id, handle);
p_buf->hdr.event = BTA_GATTC_API_CONFIRM_EVT;
p_buf->hdr.layer_specific = conn_id;
p_buf->handle = handle;
bta_sys_sendmsg(p_buf);
}
/*******************************************************************************
*
* Function BTA_GATTC_RegisterForNotifications
*
* Description This function is called to register for notification of a
* service.
*
* Parameters client_if - client interface.
* bda - target GATT server.
* handle - GATT characteristic handle.
*
* Returns OK if registration succeed, otherwise failed.
*
******************************************************************************/
tBTA_GATT_STATUS BTA_GATTC_RegisterForNotifications(tBTA_GATTC_IF client_if,
const BD_ADDR bda,
uint16_t handle) {
tBTA_GATTC_RCB* p_clreg;
tBTA_GATT_STATUS status = BTA_GATT_ILLEGAL_PARAMETER;
uint8_t i;
if (!handle) {
APPL_TRACE_ERROR("deregistration failed, handle is 0");
return status;
}
if ((p_clreg = bta_gattc_cl_get_regcb(client_if)) != NULL) {
for (i = 0; i < BTA_GATTC_NOTIF_REG_MAX; i++) {
if (p_clreg->notif_reg[i].in_use &&
!memcmp(p_clreg->notif_reg[i].remote_bda, bda, BD_ADDR_LEN) &&
p_clreg->notif_reg[i].handle == handle) {
APPL_TRACE_WARNING("notification already registered");
status = BTA_GATT_OK;
break;
}
}
if (status != BTA_GATT_OK) {
for (i = 0; i < BTA_GATTC_NOTIF_REG_MAX; i++) {
if (!p_clreg->notif_reg[i].in_use) {
memset((void*)&p_clreg->notif_reg[i], 0,
sizeof(tBTA_GATTC_NOTIF_REG));
p_clreg->notif_reg[i].in_use = true;
memcpy(p_clreg->notif_reg[i].remote_bda, bda, BD_ADDR_LEN);
p_clreg->notif_reg[i].handle = handle;
status = BTA_GATT_OK;
break;
}
}
if (i == BTA_GATTC_NOTIF_REG_MAX) {
status = BTA_GATT_NO_RESOURCES;
APPL_TRACE_ERROR("Max Notification Reached, registration failed.");
}
}
} else {
APPL_TRACE_ERROR("Client_if: %d Not Registered", client_if);
}
return status;
}
/*******************************************************************************
*
* Function BTA_GATTC_DeregisterForNotifications
*
* Description This function is called to de-register for notification of a
* service.
*
* Parameters client_if - client interface.
* remote_bda - target GATT server.
* handle - GATT characteristic handle.
*
* Returns OK if deregistration succeed, otherwise failed.
*
******************************************************************************/
tBTA_GATT_STATUS BTA_GATTC_DeregisterForNotifications(tBTA_GATTC_IF client_if,
const BD_ADDR bda,
uint16_t handle) {
if (!handle) {
APPL_TRACE_ERROR("%s: deregistration failed, handle is 0", __func__);
return BTA_GATT_ILLEGAL_PARAMETER;
}
tBTA_GATTC_RCB* p_clreg = bta_gattc_cl_get_regcb(client_if);
if (p_clreg == NULL) {
APPL_TRACE_ERROR(
"%s client_if: %d not registered bd_addr:%02x:%02x:%02x:%02x:%02x:%02x",
__func__, client_if, bda[0], bda[1], bda[2], bda[3], bda[4], bda[5]);
return BTA_GATT_ILLEGAL_PARAMETER;
}
for (int i = 0; i < BTA_GATTC_NOTIF_REG_MAX; i++) {
if (p_clreg->notif_reg[i].in_use &&
!memcmp(p_clreg->notif_reg[i].remote_bda, bda, BD_ADDR_LEN) &&
p_clreg->notif_reg[i].handle == handle) {
APPL_TRACE_DEBUG("%s deregistered bd_addr:%02x:%02x:%02x:%02x:%02x:%02x",
__func__, bda[0], bda[1], bda[2], bda[3], bda[4],
bda[5]);
memset(&p_clreg->notif_reg[i], 0, sizeof(tBTA_GATTC_NOTIF_REG));
return BTA_GATT_OK;
}
}
APPL_TRACE_ERROR(
"%s registration not found bd_addr:%02x:%02x:%02x:%02x:%02x:%02x",
__func__, bda[0], bda[1], bda[2], bda[3], bda[4], bda[5]);
return BTA_GATT_ERROR;
}
/*******************************************************************************
*
* Function BTA_GATTC_Refresh
*
* Description Refresh the server cache of the remote device
*
* Parameters remote_bda: remote device BD address.
*
* Returns void
*
******************************************************************************/
void BTA_GATTC_Refresh(const BD_ADDR remote_bda) {
tBTA_GATTC_API_OPEN* p_buf =
(tBTA_GATTC_API_OPEN*)osi_malloc(sizeof(tBTA_GATTC_API_OPEN));
p_buf->hdr.event = BTA_GATTC_API_REFRESH_EVT;
memcpy(p_buf->remote_bda, remote_bda, BD_ADDR_LEN);
bta_sys_sendmsg(p_buf);
}
#endif /* BTA_GATT_INCLUDED */