• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1  /******************************************************************************
2   *
3   *  Copyright (C) 1999-2012 Broadcom Corporation
4   *
5   *  Licensed under the Apache License, Version 2.0 (the "License");
6   *  you may not use this file except in compliance with the License.
7   *  You may obtain a copy of the License at:
8   *
9   *  http://www.apache.org/licenses/LICENSE-2.0
10   *
11   *  Unless required by applicable law or agreed to in writing, software
12   *  distributed under the License is distributed on an "AS IS" BASIS,
13   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   *  See the License for the specific language governing permissions and
15   *  limitations under the License.
16   *
17   ******************************************************************************/
18  
19  #ifndef  GATT_INT_H
20  #define  GATT_INT_H
21  
22  #include "bt_target.h"
23  
24  
25  #include "bt_trace.h"
26  #include "gatt_api.h"
27  #include "btm_ble_api.h"
28  #include "btu.h"
29  
30  #include <string.h>
31  
32  
33  #define GATT_CREATE_CONN_ID(tcb_idx, gatt_if)  ((UINT16) ((((UINT8)(tcb_idx) ) << 8) | ((UINT8) (gatt_if))))
34  #define GATT_GET_TCB_IDX(conn_id)  ((UINT8) (((UINT16) (conn_id)) >> 8))
35  #define GATT_GET_GATT_IF(conn_id)  ((tGATT_IF)((UINT8) (conn_id)))
36  
37  #define GATT_GET_SR_REG_PTR(index) (&gatt_cb.sr_reg[(UINT8) (index)]);
38  #define GATT_TRANS_ID_MAX                   0x0fffffff      /* 4 MSB is reserved */
39  
40  /* security action for GATT write and read request */
41  #define GATT_SEC_NONE              0
42  #define GATT_SEC_OK                1
43  #define GATT_SEC_SIGN_DATA         2   /* compute the signature for the write cmd */
44  #define GATT_SEC_ENCRYPT           3    /* encrypt the link with current key */
45  #define GATT_SEC_ENCRYPT_NO_MITM   4    /* unauthenticated encryption or better */
46  #define GATT_SEC_ENCRYPT_MITM      5    /* authenticated encryption */
47  #define GATT_SEC_ENC_PENDING       6   /* wait for link encryption pending */
48  typedef UINT8 tGATT_SEC_ACTION;
49  
50  
51  #define GATT_ATTR_OP_SPT_MTU               (0x00000001 << 0)
52  #define GATT_ATTR_OP_SPT_FIND_INFO         (0x00000001 << 1)
53  #define GATT_ATTR_OP_SPT_FIND_BY_TYPE      (0x00000001 << 2)
54  #define GATT_ATTR_OP_SPT_READ_BY_TYPE      (0x00000001 << 3)
55  #define GATT_ATTR_OP_SPT_READ              (0x00000001 << 4)
56  #define GATT_ATTR_OP_SPT_MULT_READ         (0x00000001 << 5)
57  #define GATT_ATTR_OP_SPT_READ_BLOB         (0x00000001 << 6)
58  #define GATT_ATTR_OP_SPT_READ_BY_GRP_TYPE  (0x00000001 << 7)
59  #define GATT_ATTR_OP_SPT_WRITE             (0x00000001 << 8)
60  #define GATT_ATTR_OP_SPT_WRITE_CMD         (0x00000001 << 9)
61  #define GATT_ATTR_OP_SPT_PREP_WRITE        (0x00000001 << 10)
62  #define GATT_ATTR_OP_SPT_EXE_WRITE         (0x00000001 << 11)
63  #define GATT_ATTR_OP_SPT_HDL_VALUE_CONF    (0x00000001 << 12)
64  #define GATT_ATTR_OP_SP_SIGN_WRITE        (0x00000001 << 13)
65  
66  #define GATT_INDEX_INVALID  0xff
67  
68  #define GATT_PENDING_REQ_NONE    0
69  
70  
71  #define GATT_WRITE_CMD_MASK  0xc0  /*0x1100-0000*/
72  #define GATT_AUTH_SIGN_MASK  0x80  /*0x1000-0000*/
73  #define GATT_AUTH_SIGN_LEN   12
74  
75  #define GATT_HDR_SIZE           3 /* 1B opcode + 2B handle */
76  
77  /* wait for ATT cmd response timeout value */
78  #define GATT_WAIT_FOR_RSP_TOUT       30
79  #define GATT_WAIT_FOR_DISC_RSP_TOUT  5
80  #define GATT_REQ_RETRY_LIMIT         2
81  
82  /* characteristic descriptor type */
83  #define GATT_DESCR_EXT_DSCPTOR   1    /* Characteristic Extended Properties */
84  #define GATT_DESCR_USER_DSCPTOR  2    /* Characteristic User Description    */
85  #define GATT_DESCR_CLT_CONFIG    3    /* Client Characteristic Configuration */
86  #define GATT_DESCR_SVR_CONFIG    4    /* Server Characteristic Configuration */
87  #define GATT_DESCR_PRES_FORMAT   5    /* Characteristic Presentation Format */
88  #define GATT_DESCR_AGGR_FORMAT   6    /* Characteristic Aggregate Format */
89  #define GATT_DESCR_VALID_RANGE   7    /* Characteristic Valid Range */
90  #define GATT_DESCR_UNKNOWN       0xff
91  
92  #define GATT_SEC_FLAG_LKEY_UNAUTHED     BTM_SEC_FLAG_LKEY_KNOWN
93  #define GATT_SEC_FLAG_LKEY_AUTHED       BTM_SEC_FLAG_LKEY_AUTHED
94  #define GATT_SEC_FLAG_ENCRYPTED         BTM_SEC_FLAG_ENCRYPTED
95  typedef UINT8 tGATT_SEC_FLAG;
96  
97  /* Find Information Response Type
98  */
99  #define GATT_INFO_TYPE_PAIR_16      0x01
100  #define GATT_INFO_TYPE_PAIR_128     0x02
101  
102  /*  GATT client FIND_TYPE_VALUE_Request data */
103  typedef struct
104  {
105      tBT_UUID        uuid;           /* type of attribute to be found */
106      UINT16          s_handle;       /* starting handle */
107      UINT16          e_handle;       /* ending handle */
108      UINT16          value_len;      /* length of the attribute value */
109      UINT8           value[GATT_MAX_MTU_SIZE];       /* pointer to the attribute value to be found */
110  } tGATT_FIND_TYPE_VALUE;
111  
112  /* client request message to ATT protocol
113  */
114  typedef union
115  {
116      tGATT_READ_BY_TYPE      browse;     /* read by type request */
117      tGATT_FIND_TYPE_VALUE   find_type_value;/* find by type value */
118      tGATT_READ_MULTI        read_multi;   /* read multiple request */
119      tGATT_READ_PARTIAL      read_blob;    /* read blob */
120      tGATT_VALUE             attr_value;   /* write request */
121                                            /* prepare write */
122      /* write blob */
123      UINT16                  handle;        /* read,  handle value confirmation */
124      UINT16                  mtu;
125      tGATT_EXEC_FLAG         exec_write;    /* execute write */
126  }tGATT_CL_MSG;
127  
128  /* error response strucutre */
129  typedef struct
130  {
131      UINT16  handle;
132      UINT8   cmd_code;
133      UINT8   reason;
134  }tGATT_ERROR;
135  
136  /* server response message to ATT protocol
137  */
138  typedef union
139  {
140      /* data type            member          event   */
141      tGATT_VALUE             attr_value;     /* READ, HANDLE_VALUE_IND, PREPARE_WRITE */
142                                              /* READ_BLOB, READ_BY_TYPE */
143      tGATT_ERROR             error;          /* ERROR_RSP */
144      UINT16                  handle;         /* WRITE, WRITE_BLOB */
145      UINT16                  mtu;            /* exchange MTU request */
146  } tGATT_SR_MSG;
147  
148  /* Characteristic declaration attribute value
149  */
150  typedef struct
151  {
152      tGATT_CHAR_PROP             property;
153      UINT16                      char_val_handle;
154  } tGATT_CHAR_DECL;
155  
156  /* attribute value maintained in the server database
157  */
158  typedef union
159  {
160      tBT_UUID                uuid;               /* service declaration */
161      tGATT_CHAR_DECL         char_decl;          /* characteristic declaration */
162      tGATT_INCL_SRVC         incl_handle;        /* included service */
163  
164  } tGATT_ATTR_VALUE;
165  
166  /* Attribute UUID type
167  */
168  #define GATT_ATTR_UUID_TYPE_16      0
169  #define GATT_ATTR_UUID_TYPE_128     1
170  #define GATT_ATTR_UUID_TYPE_32      2
171  typedef UINT8   tGATT_ATTR_UUID_TYPE;
172  
173  /* 16 bits UUID Attribute in server database
174  */
175  typedef struct
176  {
177      void                                *p_next;  /* pointer to the next attribute,
178                                                      either tGATT_ATTR16 or tGATT_ATTR128 */
179      tGATT_ATTR_VALUE                    *p_value;
180      tGATT_ATTR_UUID_TYPE                uuid_type;
181      tGATT_PERM                          permission;
182      UINT16                              handle;
183      UINT16                              uuid;
184  } tGATT_ATTR16;
185  
186  /* 32 bits UUID Attribute in server database
187  */
188  typedef struct
189  {
190      void                                *p_next;  /* pointer to the next attribute,
191                                                      either tGATT_ATTR16, tGATT_ATTR32 or tGATT_ATTR128 */
192      tGATT_ATTR_VALUE                    *p_value;
193      tGATT_ATTR_UUID_TYPE                uuid_type;
194      tGATT_PERM                          permission;
195      UINT16                              handle;
196      UINT32                              uuid;
197  } tGATT_ATTR32;
198  
199  
200  /* 128 bits UUID Attribute in server database
201  */
202  typedef struct
203  {
204      void                                *p_next;  /* pointer to the next attribute,
205                                                      either tGATT_ATTR16 or tGATT_ATTR128 */
206      tGATT_ATTR_VALUE                    *p_value;
207      tGATT_ATTR_UUID_TYPE                uuid_type;
208      tGATT_PERM                          permission;
209      UINT16                              handle;
210      UINT8                               uuid[LEN_UUID_128];
211  } tGATT_ATTR128;
212  
213  /* Service Database definition
214  */
215  typedef struct
216  {
217      void            *p_attr_list;               /* pointer to the first attribute,
218                                                    either tGATT_ATTR16 or tGATT_ATTR128 */
219      UINT8           *p_free_mem;                /* Pointer to free memory       */
220      BUFFER_Q        svc_buffer;                 /* buffer queue used for service database */
221      UINT32          mem_free;                   /* Memory still available       */
222      UINT16          end_handle;                 /* Last handle number           */
223      UINT16          next_handle;                /* Next usable handle value     */
224  } tGATT_SVC_DB;
225  
226  /* Data Structure used for GATT server                                        */
227  /* A GATT registration record consists of a handle, and 1 or more attributes  */
228  /* A service registration information record consists of beginning and ending */
229  /* attribute handle, service UUID and a set of GATT server callback.          */
230  typedef struct
231  {
232      tGATT_SVC_DB    *p_db;      /* pointer to the service database */
233      tBT_UUID        app_uuid;           /* applicatino UUID */
234      UINT32          sdp_handle; /* primamry service SDP handle */
235      UINT16          service_instance;   /* service instance number */
236      UINT16          type;       /* service type UUID, primary or secondary */
237      UINT16          s_hdl;      /* service starting handle */
238      UINT16          e_hdl;      /* service ending handle */
239      tGATT_IF        gatt_if;    /* this service is belong to which application */
240      BOOLEAN         in_use;
241  } tGATT_SR_REG;
242  
243  #define GATT_LISTEN_TO_ALL  0xff
244  #define GATT_LISTEN_TO_NONE 0
245  
246  /* Data Structure used for GATT server */
247  /* An GATT registration record consists of a handle, and 1 or more attributes */
248  /* A service registration information record consists of beginning and ending */
249  /* attribute handle, service UUID and a set of GATT server callback.          */
250  
251  typedef struct
252  {
253      tBT_UUID     app_uuid128;
254      tGATT_CBACK  app_cb;
255      tGATT_IF     gatt_if; /* one based */
256      BOOLEAN      in_use;
257      UINT8        listening; /* if adv for all has been enabled */
258  } tGATT_REG;
259  
260  
261  
262  
263  /* command queue for each connection */
264  typedef struct
265  {
266      BT_HDR      *p_cmd;
267      UINT16      clcb_idx;
268      UINT8       op_code;
269      BOOLEAN     to_send;
270  }tGATT_CMD_Q;
271  
272  
273  #if GATT_MAX_SR_PROFILES <= 8
274  typedef UINT8 tGATT_APP_MASK;
275  #elif GATT_MAX_SR_PROFILES <= 16
276  typedef UINT16 tGATT_APP_MASK;
277  #elif GATT_MAX_SR_PROFILES <= 32
278  typedef UINT32 tGATT_APP_MASK;
279  #endif
280  
281  /* command details for each connection */
282  typedef struct
283  {
284      BT_HDR          *p_rsp_msg;
285      UINT32           trans_id;
286      tGATT_READ_MULTI multi_req;
287      BUFFER_Q         multi_rsp_q;
288      UINT16           handle;
289      UINT8            op_code;
290      UINT8            status;
291      UINT8            cback_cnt[GATT_MAX_APPS];
292  } tGATT_SR_CMD;
293  
294  #define     GATT_CH_CLOSE               0
295  #define     GATT_CH_CLOSING             1
296  #define     GATT_CH_CONN                2
297  #define     GATT_CH_CFG                 3
298  #define     GATT_CH_OPEN                4
299  #define     GATT_CH_W4_SEC_COMP         5
300  #define     GATT_CH_W4_DATA_SIGN_COMP   6
301  
302  typedef UINT8 tGATT_CH_STATE;
303  
304  #define GATT_GATT_START_HANDLE  1
305  #define GATT_GAP_START_HANDLE   20
306  #define GATT_APP_START_HANDLE   40
307  
308  typedef struct hdl_cfg
309  {
310      UINT16               gatt_start_hdl;
311      UINT16               gap_start_hdl;
312      UINT16               app_start_hdl;
313  }tGATT_HDL_CFG;
314  
315  typedef struct hdl_list_elem
316  {
317      struct              hdl_list_elem *p_next;
318      struct              hdl_list_elem *p_prev;
319      tGATTS_HNDL_RANGE   asgn_range; /* assigned handle range */
320      tGATT_SVC_DB        svc_db;
321      BOOLEAN             in_use;
322  }tGATT_HDL_LIST_ELEM;
323  
324  typedef struct
325  {
326      tGATT_HDL_LIST_ELEM  *p_first;
327      tGATT_HDL_LIST_ELEM  *p_last;
328      UINT16               count;
329  }tGATT_HDL_LIST_INFO;
330  
331  
332  typedef struct srv_list_elem
333  {
334      struct              srv_list_elem *p_next;
335      struct              srv_list_elem *p_prev;
336      UINT16              s_hdl;
337      UINT8               i_sreg;
338      BOOLEAN             in_use;
339      BOOLEAN             is_primary;
340  }tGATT_SRV_LIST_ELEM;
341  
342  
343  typedef struct
344  {
345      tGATT_SRV_LIST_ELEM  *p_last_primary;
346      tGATT_SRV_LIST_ELEM  *p_first;
347      tGATT_SRV_LIST_ELEM  *p_last;
348      UINT16               count;
349  }tGATT_SRV_LIST_INFO;
350  
351  typedef struct
352  {
353      BUFFER_Q        pending_enc_clcb;   /* pending encryption channel q */
354      tGATT_SEC_ACTION sec_act;
355      BD_ADDR         peer_bda;
356      tBT_TRANSPORT   transport;
357      UINT32          trans_id;
358  
359      UINT16          att_lcid;           /* L2CAP channel ID for ATT */
360      UINT16          payload_size;
361  
362      tGATT_CH_STATE  ch_state;
363      UINT8           ch_flags;
364  
365      tGATT_IF         app_hold_link[GATT_MAX_APPS];
366  
367      /* server needs */
368      /* server response data */
369      tGATT_SR_CMD    sr_cmd;
370      UINT16          indicate_handle;
371      BUFFER_Q        pending_ind_q;
372  
373      TIMER_LIST_ENT  conf_timer_ent;     /* peer confirm to indication timer */
374  
375      UINT8            prep_cnt[GATT_MAX_APPS];
376      UINT8            ind_count;
377  
378      tGATT_CMD_Q       cl_cmd_q[GATT_CL_MAX_LCB];
379      TIMER_LIST_ENT    ind_ack_timer_ent;    /* local app confirm to indication timer */
380      UINT8             pending_cl_req;
381      UINT8             next_slot_inq;    /* index of next available slot in queue */
382  
383      BOOLEAN         in_use;
384      UINT8           tcb_idx;
385  } tGATT_TCB;
386  
387  
388  /* logic channel */
389  typedef struct
390  {
391      UINT16                  next_disc_start_hdl;   /* starting handle for the next inc srvv discovery */
392      tGATT_DISC_RES          result;
393      BOOLEAN                 wait_for_read_rsp;
394  } tGATT_READ_INC_UUID128;
395  typedef struct
396  {
397      tGATT_TCB               *p_tcb;         /* associated TCB of this CLCB */
398      tGATT_REG               *p_reg;        /* owner of this CLCB */
399      UINT8                   sccb_idx;
400      UINT8                   *p_attr_buf;    /* attribute buffer for read multiple, prepare write */
401      tBT_UUID                uuid;
402      UINT16                  conn_id;        /* connection handle */
403      UINT16                  clcb_idx;
404      UINT16                  s_handle;       /* starting handle of the active request */
405      UINT16                  e_handle;       /* ending handle of the active request */
406      UINT16                  counter;        /* used as offset, attribute length, num of prepare write */
407      UINT16                  start_offset;
408      tGATT_AUTH_REQ          auth_req;       /* authentication requirement */
409      UINT8                   operation;      /* one logic channel can have one operation active */
410      UINT8                   op_subtype;     /* operation subtype */
411      UINT8                   status;         /* operation status */
412      BOOLEAN                 first_read_blob_after_read;
413      tGATT_READ_INC_UUID128  read_uuid128;
414      BOOLEAN                 in_use;
415      TIMER_LIST_ENT          rsp_timer_ent;  /* peer response timer */
416      UINT8                   retry_count;
417  
418  } tGATT_CLCB;
419  
420  typedef struct
421  {
422      tGATT_CLCB  *p_clcb;
423  }tGATT_PENDING_ENC_CLCB;
424  
425  
426  #define GATT_SIGN_WRITE             1
427  #define GATT_VERIFY_SIGN_DATA       2
428  
429  typedef struct
430  {
431      BT_HDR      hdr;
432      tGATT_CLCB  *p_clcb;
433  }tGATT_SIGN_WRITE_OP;
434  
435  typedef struct
436  {
437      BT_HDR      hdr;
438      tGATT_TCB   *p_tcb;
439      BT_HDR      *p_data;
440  
441  }tGATT_VERIFY_SIGN_OP;
442  
443  
444  typedef struct
445  {
446      UINT16                  clcb_idx;
447      BOOLEAN                 in_use;
448  } tGATT_SCCB;
449  
450  typedef struct
451  {
452      UINT16      handle;
453      UINT16      uuid;
454      UINT32      service_change;
455  }tGATT_SVC_CHG;
456  
457  typedef struct
458  {
459      tGATT_IF        gatt_if[GATT_MAX_APPS];
460      tGATT_IF        listen_gif[GATT_MAX_APPS];
461      BD_ADDR         remote_bda;
462      BOOLEAN         in_use;
463  }tGATT_BG_CONN_DEV;
464  
465  #define GATT_SVC_CHANGED_CONNECTING        1   /* wait for connection */
466  #define GATT_SVC_CHANGED_SERVICE           2   /* GATT service discovery */
467  #define GATT_SVC_CHANGED_CHARACTERISTIC    3   /* service change char discovery */
468  #define GATT_SVC_CHANGED_DESCRIPTOR        4   /* service change CCC discoery */
469  #define GATT_SVC_CHANGED_CONFIGURE_CCCD    5   /* config CCC */
470  
471  typedef struct
472  {
473      UINT16  conn_id;
474      BOOLEAN in_use;
475      BOOLEAN connected;
476      BD_ADDR bda;
477      tBT_TRANSPORT   transport;
478  
479      /* GATT service change CCC related variables */
480      UINT8       ccc_stage;
481      UINT8       ccc_result;
482      UINT16      s_handle;
483      UINT16      e_handle;
484  }tGATT_PROFILE_CLCB;
485  
486  typedef struct
487  {
488      tGATT_TCB           tcb[GATT_MAX_PHY_CHANNEL];
489      BUFFER_Q            sign_op_queue;
490  
491      tGATT_SR_REG        sr_reg[GATT_MAX_SR_PROFILES];
492      UINT16              next_handle;    /* next available handle */
493      tGATT_SVC_CHG       gattp_attr;     /* GATT profile attribute service change */
494      tGATT_IF            gatt_if;
495      tGATT_HDL_LIST_INFO hdl_list_info;
496      tGATT_HDL_LIST_ELEM hdl_list[GATT_MAX_SR_PROFILES];
497      tGATT_SRV_LIST_INFO srv_list_info;
498      tGATT_SRV_LIST_ELEM srv_list[GATT_MAX_SR_PROFILES];
499  
500      BUFFER_Q            srv_chg_clt_q;   /* service change clients queue */
501      BUFFER_Q            pending_new_srv_start_q; /* pending new service start queue */
502      tGATT_REG           cl_rcb[GATT_MAX_APPS];
503      tGATT_CLCB          clcb[GATT_CL_MAX_LCB];  /* connection link control block*/
504      tGATT_SCCB          sccb[GATT_MAX_SCCB];    /* sign complete callback function GATT_MAX_SCCB <= GATT_CL_MAX_LCB */
505      UINT8               trace_level;
506      UINT16              def_mtu_size;
507  
508  #if GATT_CONFORMANCE_TESTING == TRUE
509      BOOLEAN             enable_err_rsp;
510      UINT8               req_op_code;
511      UINT8               err_status;
512      UINT16              handle;
513  #endif
514  
515      tGATT_PROFILE_CLCB  profile_clcb[GATT_MAX_APPS];
516      UINT16              handle_of_h_r;          /* Handle of the handles reused characteristic value */
517  
518      tGATT_APPL_INFO       cb_info;
519  
520  
521  
522      tGATT_HDL_CFG           hdl_cfg;
523      tGATT_BG_CONN_DEV       bgconn_dev[GATT_MAX_BG_CONN_DEV];
524  
525  } tGATT_CB;
526  
527  
528  #define GATT_SIZE_OF_SRV_CHG_HNDL_RANGE 4
529  
530  #ifdef __cplusplus
531  extern "C" {
532  #endif
533  
534  /* Global GATT data */
535  #if GATT_DYNAMIC_MEMORY == FALSE
536  GATT_API extern tGATT_CB  gatt_cb;
537  #else
538  GATT_API extern tGATT_CB *gatt_cb_ptr;
539  #define gatt_cb (*gatt_cb_ptr)
540  #endif
541  
542  #if GATT_CONFORMANCE_TESTING == TRUE
543  GATT_API extern void gatt_set_err_rsp(BOOLEAN enable, UINT8 req_op_code, UINT8 err_status);
544  #endif
545  
546  #ifdef __cplusplus
547  }
548  #endif
549  
550  /* internal functions */
551  extern void gatt_init (void);
552  
553  /* from gatt_main.c */
554  extern BOOLEAN gatt_disconnect (tGATT_TCB *p_tcb);
555  extern BOOLEAN gatt_act_connect (tGATT_REG *p_reg, BD_ADDR bd_addr, tBT_TRANSPORT transport);
556  extern BOOLEAN gatt_connect (BD_ADDR rem_bda,  tGATT_TCB *p_tcb, tBT_TRANSPORT transport);
557  extern void gatt_data_process (tGATT_TCB *p_tcb, BT_HDR *p_buf);
558  extern void gatt_update_app_use_link_flag ( tGATT_IF gatt_if, tGATT_TCB *p_tcb, BOOLEAN is_add, BOOLEAN check_acl_link);
559  
560  extern void gatt_profile_db_init(void);
561  extern void gatt_set_ch_state(tGATT_TCB *p_tcb, tGATT_CH_STATE ch_state);
562  extern tGATT_CH_STATE gatt_get_ch_state(tGATT_TCB *p_tcb);
563  extern void gatt_init_srv_chg(void);
564  extern void gatt_proc_srv_chg (void);
565  extern void gatt_send_srv_chg_ind (BD_ADDR peer_bda);
566  extern void gatt_chk_srv_chg(tGATTS_SRV_CHG *p_srv_chg_clt);
567  extern void gatt_add_a_bonded_dev_for_srv_chg (BD_ADDR bda);
568  
569  /* from gatt_attr.c */
570  extern UINT16 gatt_profile_find_conn_id_by_bd_addr(BD_ADDR bda);
571  
572  
573  /* Functions provided by att_protocol.c */
574  extern tGATT_STATUS attp_send_cl_msg (tGATT_TCB *p_tcb, UINT16 clcb_idx, UINT8 op_code, tGATT_CL_MSG *p_msg);
575  extern BT_HDR *attp_build_sr_msg(tGATT_TCB *p_tcb, UINT8 op_code, tGATT_SR_MSG *p_msg);
576  extern tGATT_STATUS attp_send_sr_msg (tGATT_TCB *p_tcb, BT_HDR *p_msg);
577  extern tGATT_STATUS attp_send_msg_to_l2cap(tGATT_TCB *p_tcb, BT_HDR *p_toL2CAP);
578  
579  /* utility functions */
580  extern UINT8 * gatt_dbg_op_name(UINT8 op_code);
581  extern UINT32 gatt_add_sdp_record (tBT_UUID *p_uuid, UINT16 start_hdl, UINT16 end_hdl);
582  extern BOOLEAN gatt_parse_uuid_from_cmd(tBT_UUID *p_uuid, UINT16 len, UINT8 **p_data);
583  extern UINT8 gatt_build_uuid_to_stream(UINT8 **p_dst, tBT_UUID uuid);
584  extern BOOLEAN gatt_uuid_compare(tBT_UUID src, tBT_UUID tar);
585  extern void gatt_convert_uuid32_to_uuid128(UINT8 uuid_128[LEN_UUID_128], UINT32 uuid_32);
586  extern void gatt_sr_get_sec_info(BD_ADDR rem_bda, tBT_TRANSPORT transport, UINT8 *p_sec_flag, UINT8 *p_key_size);
587  extern void gatt_start_rsp_timer(UINT16 clcb_idx);
588  extern void gatt_start_conf_timer(tGATT_TCB    *p_tcb);
589  extern void gatt_rsp_timeout(TIMER_LIST_ENT *p_tle);
590  extern void gatt_ind_ack_timeout(TIMER_LIST_ENT *p_tle);
591  extern void gatt_start_ind_ack_timer(tGATT_TCB *p_tcb);
592  extern tGATT_STATUS gatt_send_error_rsp(tGATT_TCB *p_tcb, UINT8 err_code, UINT8 op_code, UINT16 handle, BOOLEAN deq);
593  extern void gatt_dbg_display_uuid(tBT_UUID bt_uuid);
594  extern tGATT_PENDING_ENC_CLCB* gatt_add_pending_enc_channel_clcb(tGATT_TCB *p_tcb, tGATT_CLCB *p_clcb );
595  
596  extern tGATTS_PENDING_NEW_SRV_START *gatt_sr_is_new_srv_chg(tBT_UUID *p_app_uuid128, tBT_UUID *p_svc_uuid, UINT16 svc_inst);
597  
598  extern BOOLEAN gatt_is_srv_chg_ind_pending (tGATT_TCB *p_tcb);
599  extern tGATTS_SRV_CHG *gatt_is_bda_in_the_srv_chg_clt_list (BD_ADDR bda);
600  
601  extern BOOLEAN gatt_find_the_connected_bda(UINT8 start_idx, BD_ADDR bda, UINT8 *p_found_idx, tBT_TRANSPORT *p_transport);
602  extern void gatt_set_srv_chg(void);
603  extern void gatt_delete_dev_from_srv_chg_clt_list(BD_ADDR bd_addr);
604  extern tGATT_VALUE *gatt_add_pending_ind(tGATT_TCB  *p_tcb, tGATT_VALUE *p_ind);
605  extern tGATTS_PENDING_NEW_SRV_START *gatt_add_pending_new_srv_start( tGATTS_HNDL_RANGE *p_new_srv_start);
606  extern void gatt_free_srvc_db_buffer_app_id(tBT_UUID *p_app_id);
607  extern BOOLEAN gatt_update_listen_mode(void);
608  extern BOOLEAN gatt_cl_send_next_cmd_inq(tGATT_TCB *p_tcb);
609  
610  /* reserved handle list */
611  extern tGATT_HDL_LIST_ELEM *gatt_find_hdl_buffer_by_app_id (tBT_UUID *p_app_uuid128, tBT_UUID *p_svc_uuid, UINT16 svc_inst);
612  extern tGATT_HDL_LIST_ELEM *gatt_find_hdl_buffer_by_handle(UINT16 handle);
613  extern tGATT_HDL_LIST_ELEM *gatt_alloc_hdl_buffer(void);
614  extern void gatt_free_hdl_buffer(tGATT_HDL_LIST_ELEM *p);
615  extern BOOLEAN gatt_is_last_attribute(tGATT_SRV_LIST_INFO *p_list, tGATT_SRV_LIST_ELEM *p_start, tBT_UUID value);
616  extern void gatt_update_last_pri_srv_info(tGATT_SRV_LIST_INFO *p_list);
617  extern BOOLEAN gatt_add_a_srv_to_list(tGATT_SRV_LIST_INFO *p_list, tGATT_SRV_LIST_ELEM *p_new);
618  extern BOOLEAN gatt_remove_a_srv_from_list(tGATT_SRV_LIST_INFO *p_list, tGATT_SRV_LIST_ELEM *p_remove);
619  extern BOOLEAN gatt_add_an_item_to_list(tGATT_HDL_LIST_INFO *p_list, tGATT_HDL_LIST_ELEM *p_new);
620  extern BOOLEAN gatt_remove_an_item_from_list(tGATT_HDL_LIST_INFO *p_list, tGATT_HDL_LIST_ELEM *p_remove);
621  extern tGATTS_SRV_CHG *gatt_add_srv_chg_clt(tGATTS_SRV_CHG *p_srv_chg);
622  
623  /* for background connection */
624  extern BOOLEAN gatt_update_auto_connect_dev (tGATT_IF gatt_if, BOOLEAN add, BD_ADDR bd_addr, BOOLEAN is_initiator);
625  extern BOOLEAN gatt_is_bg_dev_for_app(tGATT_BG_CONN_DEV *p_dev, tGATT_IF gatt_if);
626  extern BOOLEAN gatt_remove_bg_dev_for_app(tGATT_IF gatt_if, BD_ADDR bd_addr);
627  extern UINT8 gatt_get_num_apps_for_bg_dev(BD_ADDR bd_addr);
628  extern BOOLEAN gatt_find_app_for_bg_dev(BD_ADDR bd_addr, tGATT_IF *p_gatt_if);
629  extern tGATT_BG_CONN_DEV * gatt_find_bg_dev(BD_ADDR remote_bda);
630  extern void gatt_deregister_bgdev_list(tGATT_IF gatt_if);
631  extern void gatt_reset_bgdev_list(void);
632  
633  /* server function */
634  extern UINT8 gatt_sr_find_i_rcb_by_handle(UINT16 handle);
635  extern UINT8 gatt_sr_find_i_rcb_by_app_id(tBT_UUID *p_app_uuid128, tBT_UUID *p_svc_uuid, UINT16 svc_inst);
636  extern UINT8 gatt_sr_alloc_rcb(tGATT_HDL_LIST_ELEM *p_list);
637  extern tGATT_STATUS gatt_sr_process_app_rsp (tGATT_TCB *p_tcb, tGATT_IF gatt_if, UINT32 trans_id, UINT8 op_code, tGATT_STATUS status, tGATTS_RSP *p_msg);
638  extern void gatt_server_handle_client_req (tGATT_TCB *p_tcb, UINT8 op_code,
639                                             UINT16 len, UINT8 *p_data);
640  extern void gatt_sr_send_req_callback(UINT16 conn_id,  UINT32 trans_id,
641                                        UINT8 op_code, tGATTS_DATA *p_req_data);
642  extern UINT32 gatt_sr_enqueue_cmd (tGATT_TCB *p_tcb, UINT8 op_code, UINT16 handle);
643  extern BOOLEAN gatt_cancel_open(tGATT_IF gatt_if, BD_ADDR bda);
644  
645  /*   */
646  
647  extern tGATT_REG *gatt_get_regcb (tGATT_IF gatt_if);
648  extern BOOLEAN gatt_is_clcb_allocated (UINT16 conn_id);
649  extern tGATT_CLCB *gatt_clcb_alloc (UINT16 conn_id);
650  extern void gatt_clcb_dealloc (tGATT_CLCB *p_clcb);
651  
652  extern void gatt_sr_copy_prep_cnt_to_cback_cnt(tGATT_TCB *p_tcb );
653  extern BOOLEAN gatt_sr_is_cback_cnt_zero(tGATT_TCB *p_tcb );
654  extern BOOLEAN gatt_sr_is_prep_cnt_zero(tGATT_TCB *p_tcb );
655  extern void gatt_sr_reset_cback_cnt(tGATT_TCB *p_tcb );
656  extern void gatt_sr_reset_prep_cnt(tGATT_TCB *p_tcb );
657  extern void gatt_sr_update_cback_cnt(tGATT_TCB *p_tcb, tGATT_IF gatt_if, BOOLEAN is_inc, BOOLEAN is_reset_first);
658  extern void gatt_sr_update_prep_cnt(tGATT_TCB *p_tcb, tGATT_IF gatt_if, BOOLEAN is_inc, BOOLEAN is_reset_first);
659  
660  extern BOOLEAN gatt_find_app_hold_link(tGATT_TCB *p_tcb, UINT8 start_idx, UINT8 *p_found_idx, tGATT_IF *p_gatt_if);
661  extern UINT8 gatt_num_apps_hold_link(tGATT_TCB *p_tcb);
662  extern UINT8 gatt_num_clcb_by_bd_addr(BD_ADDR bda);
663  extern tGATT_TCB * gatt_find_tcb_by_cid(UINT16 lcid);
664  extern tGATT_TCB * gatt_allocate_tcb_by_bdaddr(BD_ADDR bda, tBT_TRANSPORT transport);
665  extern tGATT_TCB * gatt_get_tcb_by_idx(UINT8 tcb_idx);
666  extern tGATT_TCB * gatt_find_tcb_by_addr(BD_ADDR bda, tBT_TRANSPORT transport);
667  extern BOOLEAN gatt_send_ble_burst_data (BD_ADDR remote_bda,  BT_HDR *p_buf);
668  
669  /* GATT client functions */
670  extern void gatt_dequeue_sr_cmd (tGATT_TCB *p_tcb);
671  extern UINT8 gatt_send_write_msg(tGATT_TCB *p_tcb, UINT16 clcb_idx, UINT8 op_code, UINT16 handle,
672                                   UINT16 len, UINT16 offset, UINT8 *p_data);
673  extern void gatt_cleanup_upon_disc(BD_ADDR bda, UINT16 reason, tBT_TRANSPORT transport);
674  extern void gatt_end_operation(tGATT_CLCB *p_clcb, tGATT_STATUS status, void *p_data);
675  
676  extern void gatt_act_discovery(tGATT_CLCB *p_clcb);
677  extern void gatt_act_read(tGATT_CLCB *p_clcb, UINT16 offset);
678  extern void gatt_act_write(tGATT_CLCB *p_clcb, UINT8 sec_act);
679  extern UINT8 gatt_act_send_browse(tGATT_TCB *p_tcb, UINT16 index, UINT8 op, UINT16 s_handle, UINT16 e_handle,
680                                    tBT_UUID uuid);
681  extern tGATT_CLCB *gatt_cmd_dequeue(tGATT_TCB *p_tcb, UINT8 *p_opcode);
682  extern BOOLEAN gatt_cmd_enq(tGATT_TCB *p_tcb, UINT16 clcb_idx, BOOLEAN to_send, UINT8 op_code, BT_HDR *p_buf);
683  extern void gatt_client_handle_server_rsp (tGATT_TCB *p_tcb, UINT8 op_code,
684                                             UINT16 len, UINT8 *p_data);
685  extern void gatt_send_queue_write_cancel (tGATT_TCB *p_tcb, tGATT_CLCB *p_clcb, tGATT_EXEC_FLAG flag);
686  
687  /* gatt_auth.c */
688  extern BOOLEAN gatt_security_check_start(tGATT_CLCB *p_clcb);
689  extern void gatt_verify_signature(tGATT_TCB *p_tcb, BT_HDR *p_buf);
690  extern tGATT_SEC_ACTION gatt_determine_sec_act(tGATT_CLCB *p_clcb );
691  extern tGATT_STATUS gatt_get_link_encrypt_status(tGATT_TCB *p_tcb);
692  extern tGATT_SEC_ACTION gatt_get_sec_act(tGATT_TCB *p_tcb);
693  extern void gatt_set_sec_act(tGATT_TCB *p_tcb, tGATT_SEC_ACTION sec_act);
694  
695  /* gatt_db.c */
696  extern BOOLEAN gatts_init_service_db (tGATT_SVC_DB *p_db, tBT_UUID *p_service, BOOLEAN is_pri, UINT16 s_hdl, UINT16 num_handle);
697  extern UINT16 gatts_add_included_service (tGATT_SVC_DB *p_db, UINT16 s_handle, UINT16 e_handle, tBT_UUID service);
698  extern UINT16 gatts_add_characteristic (tGATT_SVC_DB *p_db, tGATT_PERM perm, tGATT_CHAR_PROP property, tBT_UUID *p_char_uuid);
699  extern UINT16 gatts_add_char_descr (tGATT_SVC_DB *p_db, tGATT_PERM perm, tBT_UUID *p_dscp_uuid);
700  extern tGATT_STATUS gatts_db_read_attr_value_by_type (tGATT_TCB *p_tcb, tGATT_SVC_DB *p_db, UINT8 op_code, BT_HDR *p_rsp, UINT16 s_handle,
701                                                        UINT16 e_handle, tBT_UUID type, UINT16 *p_len, tGATT_SEC_FLAG sec_flag, UINT8 key_size,UINT32 trans_id, UINT16 *p_cur_handle);
702  extern tGATT_STATUS gatts_read_attr_value_by_handle(tGATT_TCB *p_tcb,tGATT_SVC_DB *p_db, UINT8 op_code, UINT16 handle, UINT16 offset,
703                                                      UINT8 *p_value, UINT16 *p_len, UINT16 mtu,tGATT_SEC_FLAG sec_flag,UINT8 key_size,UINT32 trans_id);
704  extern tGATT_STATUS gatts_write_attr_perm_check (tGATT_SVC_DB *p_db, UINT8 op_code,UINT16 handle, UINT16 offset, UINT8 *p_data,
705                                                   UINT16 len, tGATT_SEC_FLAG sec_flag, UINT8 key_size);
706  extern tGATT_STATUS gatts_read_attr_perm_check(tGATT_SVC_DB *p_db, BOOLEAN is_long, UINT16 handle, tGATT_SEC_FLAG sec_flag,UINT8 key_size);
707  extern void gatts_update_srv_list_elem(UINT8 i_sreg, UINT16 handle, BOOLEAN is_primary);
708  extern tBT_UUID * gatts_get_service_uuid (tGATT_SVC_DB *p_db);
709  
710  extern void gatt_reset_bgdev_list(void);
711  #endif
712  
713  
714