bta/gatt/bta_gatts_api.c - platform/external/bluetooth/bluedroid - Git at Google

 /******************************************************************************
  *
  *  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 server of BTA.
  *
  ******************************************************************************/

 #include "bt_target.h"

 #if defined(BTA_GATT_INCLUDED) && (BTA_GATT_INCLUDED == TRUE)

 #include <string.h>
 #include "gki.h"
 #include "bta_sys.h"
 #include "bta_gatt_api.h"
 #include "bta_gatts_int.h"

 /*****************************************************************************
 **  Externs
 *****************************************************************************/
 #if BTA_DYNAMIC_MEMORY == FALSE
 extern tBTA_GATTS_CB  bta_gatts_cb;
 #endif

 /*****************************************************************************
 **  Constants
 *****************************************************************************/

 static const tBTA_SYS_REG bta_gatts_reg =
 {
     bta_gatts_hdl_event,
     NULL        /* need a disable functino to be called when BT is disabled */
 };

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_Init
 **
 ** Description     This function is called to initalize GATTS module
 **
 ** Parameters       None
 **
 ** Returns          None
 **
 *******************************************************************************/
 void BTA_GATTS_Init()
 {
     memset(&bta_gatts_cb, 0, sizeof(tBTA_GATTS_CB));
 }

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_AppRegister
 **
 ** Description      This function is called to register application callbacks
 **                    with BTA GATTS module.
 **
 ** Parameters       p_app_uuid - applicaiton UUID
 **                  p_cback - pointer to the application callback function.
 **
 ** Returns          None
 **
 *******************************************************************************/
 void BTA_GATTS_AppRegister(tBT_UUID *p_app_uuid, tBTA_GATTS_CBACK *p_cback)
 {
     tBTA_GATTS_API_REG  *p_buf;

     /* register with BTA system manager */
     GKI_sched_lock();
     if (!bta_gatts_cb.enabled)
     {
         bta_sys_register(BTA_ID_GATTS, &bta_gatts_reg);
     }
     GKI_sched_unlock();

     if ((p_buf = (tBTA_GATTS_API_REG *) GKI_getbuf(sizeof(tBTA_GATTS_API_REG))) != NULL)
     {
         p_buf->hdr.event    = BTA_GATTS_API_REG_EVT;

         if (p_app_uuid != NULL)
             memcpy(&p_buf->app_uuid, p_app_uuid, sizeof(tBT_UUID));
         p_buf->p_cback      = p_cback;

         bta_sys_sendmsg(p_buf);
     }
     return;
 }


 /*******************************************************************************
 **
 ** Function         BTA_GATTS_AppDeregister
 **
 ** Description      De-register with GATT Server.
 **
 ** Parameters       app_id: applicatino ID.
 **
 ** Returns          void
 **
 *******************************************************************************/
 void BTA_GATTS_AppDeregister(tBTA_GATTS_IF server_if)
 {
     tBTA_GATTS_API_DEREG  *p_buf;

     if ((p_buf = (tBTA_GATTS_API_DEREG *) GKI_getbuf(sizeof(tBTA_GATTS_API_DEREG))) != NULL)
     {
         p_buf->hdr.event    = BTA_GATTS_API_DEREG_EVT;
         p_buf->server_if    = server_if;

         bta_sys_sendmsg(p_buf);
     }
     return;
 }

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_CreateService
 **
 ** Description      Create a service. When service creation is done, a callback
 **                  event BTA_GATTS_CREATE_SRVC_EVT is called to report status
 **                  and service ID to the profile. The service ID obtained in
 **                  the callback function needs to be used when adding included
 **                  service and characteristics/descriptors into the service.
 **
 ** Parameters       app_id: Profile ID this service is belonged to.
 **                  p_service_uuid: service UUID.
 **                  inst: instance ID number of this service.
 **                  num_handle: numble of handle requessted for this service.
 **                  is_primary: is this service a primary one or not.
 **
 ** Returns          void
 **
 *******************************************************************************/
 void BTA_GATTS_CreateService(tBTA_GATTS_IF server_if, tBT_UUID *p_service_uuid, UINT8 inst,
                              UINT16 num_handle, BOOLEAN is_primary)
 {
     tBTA_GATTS_API_CREATE_SRVC  *p_buf;

     if ((p_buf = (tBTA_GATTS_API_CREATE_SRVC *) GKI_getbuf(sizeof(tBTA_GATTS_API_CREATE_SRVC))) != NULL)
     {
         p_buf->hdr.event = BTA_GATTS_API_CREATE_SRVC_EVT;

         p_buf->server_if = server_if;
         p_buf->inst = inst;
         memcpy(&p_buf->service_uuid, p_service_uuid, sizeof(tBT_UUID));
         p_buf->num_handle = num_handle;
         p_buf->is_pri = is_primary;

         bta_sys_sendmsg(p_buf);
     }
     return;
 }
 /*******************************************************************************
 **
 ** Function         BTA_GATTS_AddIncludeService
 **
 ** Description      This function is called to add an included service. After included
 **                  service is included, a callback event BTA_GATTS_ADD_INCL_SRVC_EVT
 **                  is reported the included service ID.
 **
 ** Parameters       service_id: service ID to which this included service is to
 **                              be added.
 **                  included_service_id: the service ID to be included.
 **
 ** Returns          void
 **
 *******************************************************************************/
 void BTA_GATTS_AddIncludeService(UINT16 service_id, UINT16 included_service_id)
 {
     tBTA_GATTS_API_ADD_INCL_SRVC  *p_buf;

     if ((p_buf =
          (tBTA_GATTS_API_ADD_INCL_SRVC *) GKI_getbuf(sizeof(tBTA_GATTS_API_ADD_INCL_SRVC)))
         != NULL)
     {
         p_buf->hdr.event = BTA_GATTS_API_ADD_INCL_SRVC_EVT;

         p_buf->hdr.layer_specific = service_id;
         p_buf->included_service_id = included_service_id;

         bta_sys_sendmsg(p_buf);
     }
     return;

 }
 /*******************************************************************************
 **
 ** Function         BTA_GATTS_AddCharacteristic
 **
 ** Description      This function is called to add a characteristic into a service.
 **
 ** Parameters       service_id: service ID to which this included service is to
 **                              be added.
 **                  p_char_uuid : Characteristic UUID.
 **                  perm      : Characteristic value declaration attribute permission.
 **                  property  : Characteristic Properties
 **
 ** Returns          None
 **
 *******************************************************************************/
 void BTA_GATTS_AddCharacteristic (UINT16 service_id,  tBT_UUID  *p_char_uuid,
                                   tBTA_GATT_PERM perm, tBTA_GATT_CHAR_PROP property)
 {
     tBTA_GATTS_API_ADD_CHAR  *p_buf;

     if ((p_buf = (tBTA_GATTS_API_ADD_CHAR *) GKI_getbuf(sizeof(tBTA_GATTS_API_ADD_CHAR))) != NULL)
     {
         memset(p_buf, 0, sizeof(tBTA_GATTS_API_ADD_CHAR));

         p_buf->hdr.event = BTA_GATTS_API_ADD_CHAR_EVT;
         p_buf->hdr.layer_specific = service_id;
         p_buf->perm = perm;
         p_buf->property = property;

         if (p_char_uuid)
         {
             memcpy(&p_buf->char_uuid, p_char_uuid, sizeof(tBT_UUID));
         }
         bta_sys_sendmsg(p_buf);
     }
     return;
 }

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_AddCharDescriptor
 **
 ** Description      This function is called to add characteristic descriptor. When
 **                  it's done, a callback event BTA_GATTS_ADD_DESCR_EVT is called
 **                  to report the status and an ID number for this descriptor.
 **
 ** Parameters       service_id: service ID to which this charatceristic descriptor is to
 **                              be added.
 **                  perm: descriptor access permission.
 **                  p_descr_uuid: descriptor UUID.
 **
 ** Returns          returns status.
 **
 *******************************************************************************/
 void BTA_GATTS_AddCharDescriptor (UINT16 service_id,
                                   tBTA_GATT_PERM perm,
                                   tBT_UUID  * p_descr_uuid)
 {
     tBTA_GATTS_API_ADD_DESCR  *p_buf;
     UINT16  len = sizeof(tBTA_GATTS_API_ADD_DESCR);


     if ((p_buf = (tBTA_GATTS_API_ADD_DESCR *) GKI_getbuf(len)) != NULL)
     {
         memset(p_buf, 0, len);

         p_buf->hdr.event = BTA_GATTS_API_ADD_DESCR_EVT;
         p_buf->hdr.layer_specific = service_id;
         p_buf->perm = perm;

         if (p_descr_uuid)
         {
             memcpy(&p_buf->descr_uuid, p_descr_uuid, sizeof(tBT_UUID));
         }
         bta_sys_sendmsg(p_buf);
     }
     return;

 }

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_DeleteService
 **
 ** Description      This function is called to delete a service. When this is done,
 **                  a callback event BTA_GATTS_DELETE_EVT is report with the status.
 **
 ** Parameters       service_id: service_id to be deleted.
 **
 ** Returns          returns none.
 **
 *******************************************************************************/
 void  BTA_GATTS_DeleteService(UINT16 service_id)
 {
     BT_HDR  *p_buf;

     if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL)
     {
         p_buf->event = BTA_GATTS_API_DEL_SRVC_EVT;

         p_buf->layer_specific = service_id;

         bta_sys_sendmsg(p_buf);
     }
     return;

 }

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_StartService
 **
 ** Description      This function is called to start a service.
 **
 ** Parameters       service_id: the service ID to be started.
 **                  sup_transport: supported trasnport.
 **
 ** Returns          None.
 **
 *******************************************************************************/
 void  BTA_GATTS_StartService(UINT16 service_id, tBTA_GATT_TRANSPORT sup_transport)
 {
     tBTA_GATTS_API_START  *p_buf;

     if ((p_buf = (tBTA_GATTS_API_START *) GKI_getbuf(sizeof(tBTA_GATTS_API_START))) != NULL)
     {
         p_buf->hdr.event = BTA_GATTS_API_START_SRVC_EVT;

         p_buf->hdr.layer_specific = service_id;
         p_buf->transport = sup_transport;

         bta_sys_sendmsg(p_buf);
     }
     return;
 }

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_StopService
 **
 ** Description      This function is called to stop a service.
 **
 ** Parameters       service_id - service to be topped.
 **
 ** Returns          None
 **
 *******************************************************************************/
 void BTA_GATTS_StopService(UINT16 service_id)
 {
     BT_HDR  *p_buf;

     if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL)
     {
         p_buf->event = BTA_GATTS_API_STOP_SRVC_EVT;

         p_buf->layer_specific = service_id;

         bta_sys_sendmsg(p_buf);
     }
     return;
 }

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_HandleValueIndication
 **
 ** Description      This function is called to read a characteristics descriptor.
 **
 ** Parameters       bda - remote device bd address to indicate.
 **					attr_id - attribute ID to indicate.
 **                  data_len - indicate data length.
 **                  p_data: data to indicate.
 **                  need_confirm - if this indication expects a confirmation or not.
 **
 ** Returns          None
 **
 *******************************************************************************/
 void BTA_GATTS_HandleValueIndication (UINT16 conn_id, UINT16 attr_id, UINT16 data_len,
                                       UINT8 *p_data, BOOLEAN need_confirm)
 {
     tBTA_GATTS_API_INDICATION  *p_buf;
     UINT16  len = sizeof(tBTA_GATTS_API_INDICATION);

     if ((p_buf = (tBTA_GATTS_API_INDICATION *) GKI_getbuf(len)) != NULL)
     {
         memset(p_buf, 0, len);

         p_buf->hdr.event = BTA_GATTS_API_INDICATION_EVT;
         p_buf->hdr.layer_specific = conn_id;
         p_buf->attr_id = attr_id;
         p_buf->need_confirm = need_confirm;

         if (data_len > 0 && p_data != NULL)
         {
             p_buf->len = data_len;
             memcpy(p_buf->value, p_data, data_len);

         }
         bta_sys_sendmsg(p_buf);
     }
     return;

 }
 /*******************************************************************************
 **
 ** Function         BTA_GATTS_SendRsp
 **
 ** Description      This function is called to send a response to a request.
 **
 ** Parameters       conn_id - connection identifier.
 **                  trans_id - transaction ID.
 **                  status - response status
 **                  p_msg - response data.
 **
 ** Returns          None
 **
 *******************************************************************************/
 void BTA_GATTS_SendRsp (UINT16 conn_id, UINT32 trans_id,
                         tBTA_GATT_STATUS status, tBTA_GATTS_RSP *p_msg)
 {
     tBTA_GATTS_API_RSP  *p_buf;
     UINT16  len = sizeof(tBTA_GATTS_API_RSP) + sizeof(tBTA_GATTS_RSP);

     if ((p_buf = (tBTA_GATTS_API_RSP *) GKI_getbuf(len)) != NULL)
     {
         memset(p_buf, 0, len);

         p_buf->hdr.event    = BTA_GATTS_API_RSP_EVT;
         p_buf->hdr.layer_specific = conn_id;
         p_buf->trans_id = trans_id;
         p_buf->status = status;

         if (p_msg != NULL)
         {
             p_buf->p_rsp = (tBTA_GATTS_RSP *)(p_buf + 1);
             memcpy(p_buf->p_rsp, p_msg, sizeof(tBTA_GATTS_RSP));
         }

         bta_sys_sendmsg(p_buf);
     }
     return;

 }


 /*******************************************************************************
 **
 ** Function         BTA_GATTS_Open
 **
 ** Description      Open a direct open connection or add a background auto connection
 **                  bd address
 **
 ** Parameters       server_if: server interface.
 **                  remote_bda: remote device BD address.
 **                  is_direct: direct connection or background auto connection
 **
 ** Returns          void
 **
 *******************************************************************************/
 void BTA_GATTS_Open(tBTA_GATTS_IF server_if, BD_ADDR remote_bda, BOOLEAN is_direct)
 {
     tBTA_GATTS_API_OPEN  *p_buf;

     if ((p_buf = (tBTA_GATTS_API_OPEN *) GKI_getbuf(sizeof(tBTA_GATTS_API_OPEN))) != NULL)
     {
         p_buf->hdr.event = BTA_GATTS_API_OPEN_EVT;
         p_buf->server_if = server_if;
         p_buf->is_direct = is_direct;
         memcpy(p_buf->remote_bda, remote_bda, BD_ADDR_LEN);

         bta_sys_sendmsg(p_buf);
     }
     return;
 }


 /*******************************************************************************
 **
 ** Function         BTA_GATTS_CancelOpen
 **
 ** Description      Cancel a direct open connection or remove a background auto connection
 **                  bd address
 **
 ** Parameters       server_if: server interface.
 **                  remote_bda: remote device BD address.
 **                  is_direct: direct connection or background auto connection
 **
 ** Returns          void
 **
 *******************************************************************************/
 void BTA_GATTS_CancelOpen(tBTA_GATTS_IF server_if, BD_ADDR remote_bda, BOOLEAN is_direct)
 {
     tBTA_GATTS_API_CANCEL_OPEN  *p_buf;

     if ((p_buf = (tBTA_GATTS_API_CANCEL_OPEN *) GKI_getbuf(sizeof(tBTA_GATTS_API_CANCEL_OPEN))) != NULL)
     {
         p_buf->hdr.event = BTA_GATTS_API_CANCEL_OPEN_EVT;
         p_buf->server_if = server_if;
         p_buf->is_direct = is_direct;
         memcpy(p_buf->remote_bda, remote_bda, BD_ADDR_LEN);
         bta_sys_sendmsg(p_buf);
     }
     return;
 }

 /*******************************************************************************
 **
 ** Function         BTA_GATTS_Close
 **
 ** Description      Close a connection  a remote device.
 **
 ** Parameters       conn_id: connectino ID to be closed.
 **
 ** Returns          void
 **
 *******************************************************************************/
 void BTA_GATTS_Close(UINT16 conn_id)
 {
     BT_HDR  *p_buf;

     if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL)
     {
         p_buf->event = BTA_GATTS_API_CLOSE_EVT;
         p_buf->layer_specific = conn_id;
         bta_sys_sendmsg(p_buf);
     }
     return;

 }

 #endif /* BTA_GATT_INCLUDED */
	/******************************************************************************
	*
	* 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 server of BTA.
	*
	******************************************************************************/

	#include "bt_target.h"

	#if defined(BTA_GATT_INCLUDED) && (BTA_GATT_INCLUDED == TRUE)

	#include <string.h>
	#include "gki.h"
	#include "bta_sys.h"
	#include "bta_gatt_api.h"
	#include "bta_gatts_int.h"

	/*****************************************************************************
	** Externs
	*****************************************************************************/
	#if BTA_DYNAMIC_MEMORY == FALSE
	extern tBTA_GATTS_CB bta_gatts_cb;
	#endif

	/*****************************************************************************
	** Constants
	*****************************************************************************/

	static const tBTA_SYS_REG bta_gatts_reg =
	{
	bta_gatts_hdl_event,
	NULL /* need a disable functino to be called when BT is disabled */
	};

	/*******************************************************************************
	**
	** Function BTA_GATTS_Init
	**
	** Description This function is called to initalize GATTS module
	**
	** Parameters None
	**
	** Returns None
	**
	*******************************************************************************/
	void BTA_GATTS_Init()
	{
	memset(&bta_gatts_cb, 0, sizeof(tBTA_GATTS_CB));
	}

	/*******************************************************************************
	**
	** Function BTA_GATTS_AppRegister
	**
	** Description This function is called to register application callbacks
	** with BTA GATTS module.
	**
	** Parameters p_app_uuid - applicaiton UUID
	** p_cback - pointer to the application callback function.
	**
	** Returns None
	**
	*******************************************************************************/
	void BTA_GATTS_AppRegister(tBT_UUID p_app_uuid, tBTA_GATTS_CBACK p_cback)
	{
	tBTA_GATTS_API_REG *p_buf;

	/* register with BTA system manager */
	GKI_sched_lock();
	if (!bta_gatts_cb.enabled)
	{
	bta_sys_register(BTA_ID_GATTS, &bta_gatts_reg);
	}
	GKI_sched_unlock();

	if ((p_buf = (tBTA_GATTS_API_REG *) GKI_getbuf(sizeof(tBTA_GATTS_API_REG))) != NULL)
	{
	p_buf->hdr.event = BTA_GATTS_API_REG_EVT;

	if (p_app_uuid != NULL)
	memcpy(&p_buf->app_uuid, p_app_uuid, sizeof(tBT_UUID));
	p_buf->p_cback = p_cback;

	bta_sys_sendmsg(p_buf);
	}
	return;
	}



	/*******************************************************************************
	**
	** Function BTA_GATTS_AppDeregister
	**
	** Description De-register with GATT Server.
	**
	** Parameters app_id: applicatino ID.
	**
	** Returns void
	**
	*******************************************************************************/
	void BTA_GATTS_AppDeregister(tBTA_GATTS_IF server_if)
	{
	tBTA_GATTS_API_DEREG *p_buf;

	if ((p_buf = (tBTA_GATTS_API_DEREG *) GKI_getbuf(sizeof(tBTA_GATTS_API_DEREG))) != NULL)
	{
	p_buf->hdr.event = BTA_GATTS_API_DEREG_EVT;
	p_buf->server_if = server_if;

	bta_sys_sendmsg(p_buf);
	}
	return;
	}

	/*******************************************************************************
	**
	** Function BTA_GATTS_CreateService
	**
	** Description Create a service. When service creation is done, a callback
	** event BTA_GATTS_CREATE_SRVC_EVT is called to report status
	** and service ID to the profile. The service ID obtained in
	** the callback function needs to be used when adding included
	** service and characteristics/descriptors into the service.
	**
	** Parameters app_id: Profile ID this service is belonged to.
	** p_service_uuid: service UUID.
	** inst: instance ID number of this service.
	** num_handle: numble of handle requessted for this service.
	** is_primary: is this service a primary one or not.
	**
	** Returns void
	**
	*******************************************************************************/
	void BTA_GATTS_CreateService(tBTA_GATTS_IF server_if, tBT_UUID *p_service_uuid, UINT8 inst,
	UINT16 num_handle, BOOLEAN is_primary)
	{
	tBTA_GATTS_API_CREATE_SRVC *p_buf;

	if ((p_buf = (tBTA_GATTS_API_CREATE_SRVC *) GKI_getbuf(sizeof(tBTA_GATTS_API_CREATE_SRVC))) != NULL)
	{
	p_buf->hdr.event = BTA_GATTS_API_CREATE_SRVC_EVT;

	p_buf->server_if = server_if;
	p_buf->inst = inst;
	memcpy(&p_buf->service_uuid, p_service_uuid, sizeof(tBT_UUID));
	p_buf->num_handle = num_handle;
	p_buf->is_pri = is_primary;

	bta_sys_sendmsg(p_buf);
	}
	return;
	}
	/*******************************************************************************
	**
	** Function BTA_GATTS_AddIncludeService
	**
	** Description This function is called to add an included service. After included
	** service is included, a callback event BTA_GATTS_ADD_INCL_SRVC_EVT
	** is reported the included service ID.
	**
	** Parameters service_id: service ID to which this included service is to
	** be added.
	** included_service_id: the service ID to be included.
	**
	** Returns void
	**
	*******************************************************************************/
	void BTA_GATTS_AddIncludeService(UINT16 service_id, UINT16 included_service_id)
	{
	tBTA_GATTS_API_ADD_INCL_SRVC *p_buf;

	if ((p_buf =
	(tBTA_GATTS_API_ADD_INCL_SRVC *) GKI_getbuf(sizeof(tBTA_GATTS_API_ADD_INCL_SRVC)))
	!= NULL)
	{
	p_buf->hdr.event = BTA_GATTS_API_ADD_INCL_SRVC_EVT;

	p_buf->hdr.layer_specific = service_id;
	p_buf->included_service_id = included_service_id;

	bta_sys_sendmsg(p_buf);
	}
	return;

	}
	/*******************************************************************************
	**
	** Function BTA_GATTS_AddCharacteristic
	**
	** Description This function is called to add a characteristic into a service.
	**
	** Parameters service_id: service ID to which this included service is to
	** be added.
	** p_char_uuid : Characteristic UUID.
	** perm : Characteristic value declaration attribute permission.
	** property : Characteristic Properties
	**
	** Returns None
	**
	*******************************************************************************/
	void BTA_GATTS_AddCharacteristic (UINT16 service_id, tBT_UUID *p_char_uuid,
	tBTA_GATT_PERM perm, tBTA_GATT_CHAR_PROP property)
	{
	tBTA_GATTS_API_ADD_CHAR *p_buf;

	if ((p_buf = (tBTA_GATTS_API_ADD_CHAR *) GKI_getbuf(sizeof(tBTA_GATTS_API_ADD_CHAR))) != NULL)
	{
	memset(p_buf, 0, sizeof(tBTA_GATTS_API_ADD_CHAR));

	p_buf->hdr.event = BTA_GATTS_API_ADD_CHAR_EVT;
	p_buf->hdr.layer_specific = service_id;
	p_buf->perm = perm;
	p_buf->property = property;

	if (p_char_uuid)
	{
	memcpy(&p_buf->char_uuid, p_char_uuid, sizeof(tBT_UUID));
	}
	bta_sys_sendmsg(p_buf);
	}
	return;
	}

	/*******************************************************************************
	**
	** Function BTA_GATTS_AddCharDescriptor
	**
	** Description This function is called to add characteristic descriptor. When
	** it's done, a callback event BTA_GATTS_ADD_DESCR_EVT is called
	** to report the status and an ID number for this descriptor.
	**
	** Parameters service_id: service ID to which this charatceristic descriptor is to
	** be added.
	** perm: descriptor access permission.
	** p_descr_uuid: descriptor UUID.
	**
	** Returns returns status.
	**
	*******************************************************************************/
	void BTA_GATTS_AddCharDescriptor (UINT16 service_id,
	tBTA_GATT_PERM perm,
	tBT_UUID * p_descr_uuid)
	{
	tBTA_GATTS_API_ADD_DESCR *p_buf;
	UINT16 len = sizeof(tBTA_GATTS_API_ADD_DESCR);


	if ((p_buf = (tBTA_GATTS_API_ADD_DESCR *) GKI_getbuf(len)) != NULL)
	{
	memset(p_buf, 0, len);

	p_buf->hdr.event = BTA_GATTS_API_ADD_DESCR_EVT;
	p_buf->hdr.layer_specific = service_id;
	p_buf->perm = perm;

	if (p_descr_uuid)
	{
	memcpy(&p_buf->descr_uuid, p_descr_uuid, sizeof(tBT_UUID));
	}
	bta_sys_sendmsg(p_buf);
	}
	return;

	}

	/*******************************************************************************
	**
	** Function BTA_GATTS_DeleteService
	**
	** Description This function is called to delete a service. When this is done,
	** a callback event BTA_GATTS_DELETE_EVT is report with the status.
	**
	** Parameters service_id: service_id to be deleted.
	**
	** Returns returns none.
	**
	*******************************************************************************/
	void BTA_GATTS_DeleteService(UINT16 service_id)
	{
	BT_HDR *p_buf;

	if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL)
	{
	p_buf->event = BTA_GATTS_API_DEL_SRVC_EVT;

	p_buf->layer_specific = service_id;

	bta_sys_sendmsg(p_buf);
	}
	return;

	}

	/*******************************************************************************
	**
	** Function BTA_GATTS_StartService
	**
	** Description This function is called to start a service.
	**
	** Parameters service_id: the service ID to be started.
	** sup_transport: supported trasnport.
	**
	** Returns None.
	**
	*******************************************************************************/
	void BTA_GATTS_StartService(UINT16 service_id, tBTA_GATT_TRANSPORT sup_transport)
	{
	tBTA_GATTS_API_START *p_buf;

	if ((p_buf = (tBTA_GATTS_API_START *) GKI_getbuf(sizeof(tBTA_GATTS_API_START))) != NULL)
	{
	p_buf->hdr.event = BTA_GATTS_API_START_SRVC_EVT;

	p_buf->hdr.layer_specific = service_id;
	p_buf->transport = sup_transport;

	bta_sys_sendmsg(p_buf);
	}
	return;
	}

	/*******************************************************************************
	**
	** Function BTA_GATTS_StopService
	**
	** Description This function is called to stop a service.
	**
	** Parameters service_id - service to be topped.
	**
	** Returns None
	**
	*******************************************************************************/
	void BTA_GATTS_StopService(UINT16 service_id)
	{
	BT_HDR *p_buf;

	if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL)
	{
	p_buf->event = BTA_GATTS_API_STOP_SRVC_EVT;

	p_buf->layer_specific = service_id;

	bta_sys_sendmsg(p_buf);
	}
	return;
	}

	/*******************************************************************************
	**
	** Function BTA_GATTS_HandleValueIndication
	**
	** Description This function is called to read a characteristics descriptor.
	**
	** Parameters bda - remote device bd address to indicate.
	** attr_id - attribute ID to indicate.
	** data_len - indicate data length.
	** p_data: data to indicate.
	** need_confirm - if this indication expects a confirmation or not.
	**
	** Returns None
	**
	*******************************************************************************/
	void BTA_GATTS_HandleValueIndication (UINT16 conn_id, UINT16 attr_id, UINT16 data_len,
	UINT8 *p_data, BOOLEAN need_confirm)
	{
	tBTA_GATTS_API_INDICATION *p_buf;
	UINT16 len = sizeof(tBTA_GATTS_API_INDICATION);

	if ((p_buf = (tBTA_GATTS_API_INDICATION *) GKI_getbuf(len)) != NULL)
	{
	memset(p_buf, 0, len);

	p_buf->hdr.event = BTA_GATTS_API_INDICATION_EVT;
	p_buf->hdr.layer_specific = conn_id;
	p_buf->attr_id = attr_id;
	p_buf->need_confirm = need_confirm;

	if (data_len > 0 && p_data != NULL)
	{
	p_buf->len = data_len;
	memcpy(p_buf->value, p_data, data_len);

	}
	bta_sys_sendmsg(p_buf);
	}
	return;

	}
	/*******************************************************************************
	**
	** Function BTA_GATTS_SendRsp
	**
	** Description This function is called to send a response to a request.
	**
	** Parameters conn_id - connection identifier.
	** trans_id - transaction ID.
	** status - response status
	** p_msg - response data.
	**
	** Returns None
	**
	*******************************************************************************/
	void BTA_GATTS_SendRsp (UINT16 conn_id, UINT32 trans_id,
	tBTA_GATT_STATUS status, tBTA_GATTS_RSP *p_msg)
	{
	tBTA_GATTS_API_RSP *p_buf;
	UINT16 len = sizeof(tBTA_GATTS_API_RSP) + sizeof(tBTA_GATTS_RSP);

	if ((p_buf = (tBTA_GATTS_API_RSP *) GKI_getbuf(len)) != NULL)
	{
	memset(p_buf, 0, len);

	p_buf->hdr.event = BTA_GATTS_API_RSP_EVT;
	p_buf->hdr.layer_specific = conn_id;
	p_buf->trans_id = trans_id;
	p_buf->status = status;

	if (p_msg != NULL)
	{
	p_buf->p_rsp = (tBTA_GATTS_RSP *)(p_buf + 1);
	memcpy(p_buf->p_rsp, p_msg, sizeof(tBTA_GATTS_RSP));
	}

	bta_sys_sendmsg(p_buf);
	}
	return;

	}



	/*******************************************************************************
	**
	** Function BTA_GATTS_Open
	**
	** Description Open a direct open connection or add a background auto connection
	** bd address
	**
	** Parameters server_if: server interface.
	** remote_bda: remote device BD address.
	** is_direct: direct connection or background auto connection
	**
	** Returns void
	**
	*******************************************************************************/
	void BTA_GATTS_Open(tBTA_GATTS_IF server_if, BD_ADDR remote_bda, BOOLEAN is_direct)
	{
	tBTA_GATTS_API_OPEN *p_buf;

	if ((p_buf = (tBTA_GATTS_API_OPEN *) GKI_getbuf(sizeof(tBTA_GATTS_API_OPEN))) != NULL)
	{
	p_buf->hdr.event = BTA_GATTS_API_OPEN_EVT;
	p_buf->server_if = server_if;
	p_buf->is_direct = is_direct;
	memcpy(p_buf->remote_bda, remote_bda, BD_ADDR_LEN);

	bta_sys_sendmsg(p_buf);
	}
	return;
	}


	/*******************************************************************************
	**
	** Function BTA_GATTS_CancelOpen
	**
	** Description Cancel a direct open connection or remove a background auto connection
	** bd address
	**
	** Parameters server_if: server interface.
	** remote_bda: remote device BD address.
	** is_direct: direct connection or background auto connection
	**
	** Returns void
	**
	*******************************************************************************/
	void BTA_GATTS_CancelOpen(tBTA_GATTS_IF server_if, BD_ADDR remote_bda, BOOLEAN is_direct)
	{
	tBTA_GATTS_API_CANCEL_OPEN *p_buf;

	if ((p_buf = (tBTA_GATTS_API_CANCEL_OPEN *) GKI_getbuf(sizeof(tBTA_GATTS_API_CANCEL_OPEN))) != NULL)
	{
	p_buf->hdr.event = BTA_GATTS_API_CANCEL_OPEN_EVT;
	p_buf->server_if = server_if;
	p_buf->is_direct = is_direct;
	memcpy(p_buf->remote_bda, remote_bda, BD_ADDR_LEN);
	bta_sys_sendmsg(p_buf);
	}
	return;
	}

	/*******************************************************************************
	**
	** Function BTA_GATTS_Close
	**
	** Description Close a connection a remote device.
	**
	** Parameters conn_id: connectino ID to be closed.
	**
	** Returns void
	**
	*******************************************************************************/
	void BTA_GATTS_Close(UINT16 conn_id)
	{
	BT_HDR *p_buf;

	if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL)
	{
	p_buf->event = BTA_GATTS_API_CLOSE_EVT;
	p_buf->layer_specific = conn_id;
	bta_sys_sendmsg(p_buf);
	}
	return;

	}

	#endif /* BTA_GATT_INCLUDED */