bta/include/bta_hl_api.h

   1 /******************************************************************************
   2  *
   3  *  Copyright (C) 2009-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 /******************************************************************************
  20  *
  21  *  This is the public interface file for the HeaLth device profile (HL)
  22  *  subsystem of BTA, Broadcom's Bluetooth application layer for mobile
  23  *  phones.
  24  *
  25  ******************************************************************************/
  26 #ifndef BTA_HL_API_H
  27 #define BTA_HL_API_H
  28
  29 #include "bta_api.h"
  30 #include "btm_api.h"
  31 #include "mca_api.h"
  32
  33 /*****************************************************************************
  34 **  Constants and data types
  35 *****************************************************************************/
  36 /* Extra Debug Code */
  37 #ifndef BTA_HL_DEBUG
  38 #define BTA_HL_DEBUG           TRUE
  39 #endif
  40
  41 #ifndef BTA_HL_NUM_APPS
  42 #define BTA_HL_NUM_APPS                 12
  43 #endif
  44
  45 #ifndef BTA_HL_NUM_MDEPS
  46 #define BTA_HL_NUM_MDEPS                13
  47 #endif
  48
  49 #ifndef BTA_HL_NUM_MCLS
  50 #define BTA_HL_NUM_MCLS                 7
  51 #endif
  52
  53 #ifndef BTA_HL_NUM_MDLS_PER_MDEP
  54 #define BTA_HL_NUM_MDLS_PER_MDEP        4
  55 #endif
  56
  57 #ifndef BTA_HL_NUM_MDLS_PER_MCL
  58 #define BTA_HL_NUM_MDLS_PER_MCL         10
  59 #endif
  60
  61 #ifndef BTA_HL_NUM_DATA_TYPES
  62 #define BTA_HL_NUM_DATA_TYPES            5   /* maximum number of data types can be supported
  63                                                 per MDEP ID */
  64 #endif
  65
  66 #define BTA_HL_MCAP_RSP_TOUT            2    /* 2 seconds */
  67
  68 #ifndef BTA_HL_CCH_NUM_FILTER_ELEMS
  69 #define BTA_HL_CCH_NUM_FILTER_ELEMS     3
  70 #endif
  71
  72 #ifndef BTA_HL_NUM_SDP_CBACKS
  73 #define BTA_HL_NUM_SDP_CBACKS           7
  74 #endif
  75
  76 #ifndef BTA_HL_NUM_SDP_RECS
  77 #define BTA_HL_NUM_SDP_RECS             5
  78 #endif
  79
  80 #ifndef BTA_HL_NUM_SDP_MDEPS
  81 #define BTA_HL_NUM_SDP_MDEPS            12
  82 #endif
  83
  84 #ifndef BTA_HL_NUM_SVC_ELEMS
  85 #define BTA_HL_NUM_SVC_ELEMS            2
  86 #endif
  87
  88 #ifndef BTA_HL_NUM_PROTO_ELEMS
  89 #define BTA_HL_NUM_PROTO_ELEMS          2
  90 #endif
  91
  92 #define BTA_HL_VERSION                  0x0101
  93 #define BTA_HL_NUM_ADD_PROTO_LISTS      1
  94 #define BTA_HL_NUM_ADD_PROTO_ELEMS      2
  95 #define BTA_HL_MDEP_SEQ_SIZE            20
  96 #define BTA_HL_VAL_ARRY_SIZE            320
  97
  98 #ifndef BTA_HL_NUM_MDL_CFGS
  99 #define BTA_HL_NUM_MDL_CFGS             16    /* numer of MDL cfg saved in the persistent memory*/
 100 #endif
 101
 102 #define BTA_HL_NUM_TIMERS               7
 103
 104 #define BTA_HL_CCH_RSP_TOUT             2000
 105 #define BTA_HL_MAX_TIME                 255
 106 #define BTA_HL_MIN_TIME                 1
 107 #define BTA_HL_INVALID_APP_HANDLE       0xFF
 108 #define BTA_HL_INVALID_MCL_HANDLE       0xFF
 109 #define BTA_HL_INVALID_MDL_HANDLE       0xFFFF
 110
 111 #define BTA_HL_STATUS_OK                    0
 112 #define BTA_HL_STATUS_FAIL                  1   /* Used to pass all other errors */
 113 #define BTA_HL_STATUS_ABORTED               2
 114 #define BTA_HL_STATUS_NO_RESOURCE           3
 115 #define BTA_HL_STATUS_LAST_ITEM             4
 116 #define BTA_HL_STATUS_DUPLICATE_APP_ID      5
 117 #define BTA_HL_STATUS_INVALID_APP_HANDLE    6
 118 #define BTA_HL_STATUS_INVALID_MCL_HANDLE    7
 119 #define BTA_HL_STATUS_MCAP_REG_FAIL         8
 120 #define BTA_HL_STATUS_MDEP_CO_FAIL          9
 121 #define BTA_HL_STATUS_ECHO_CO_FAIL          10
 122 #define BTA_HL_STATUS_MDL_CFG_CO_FAIL       11
 123 #define BTA_HL_STATUS_SDP_NO_RESOURCE       12
 124 #define BTA_HL_STATUS_SDP_FAIL              13
 125 #define BTA_HL_STATUS_NO_CCH                14
 126 #define BTA_HL_STATUS_NO_MCL                15
 127
 128 #define BTA_HL_STATUS_NO_FIRST_RELIABLE     17
 129 #define BTA_HL_STATUS_INVALID_DCH_CFG       18
 130 #define BTA_HL_STATUS_INVALID_MDL_HANDLE    19
 131 #define BTA_HL_STATUS_INVALID_BD_ADDR       20
 132 #define BTA_HL_STATUS_INVALID_RECONNECT_CFG 21
 133 #define BTA_HL_STATUS_ECHO_TEST_BUSY        22
 134 #define BTA_HL_STATUS_INVALID_LOCAL_MDEP_ID 23
 135 #define BTA_HL_STATUS_INVALID_MDL_ID        24
 136 #define BTA_HL_STATUS_NO_MDL_ID_FOUND       25
 137 #define BTA_HL_STATUS_DCH_BUSY              26  /* DCH is congested*/
 138 #define BTA_HL_STATUS_INVALID_CTRL_PSM      27
 139 #define BTA_HL_STATUS_DUPLICATE_CCH_OPEN    28
 140
 141 typedef UINT8 tBTA_HL_STATUS;
 142 typedef tMCA_HANDLE tBTA_HL_APP_HANDLE;
 143 typedef tMCA_CL     tBTA_HL_MCL_HANDLE;
 144 typedef tMCA_DL     tBTA_HL_MDL_HANDLE;
 145 enum
 146 {
 147     BTA_HL_DEVICE_TYPE_SINK,
 148     BTA_HL_DEVICE_TYPE_SOURCE,
 149     BTA_HL_DEVICE_TYPE_DUAL
 150 };
 151
 152 typedef UINT8 tBTA_HL_DEVICE_TYPE;
 153
 154
 155
 156 #define BTA_HL_SDP_IEEE_11073_20601             0x01
 157
 158 #define BTA_HL_MCAP_SUP_RECONNECT_MASK_INIT          2 /* 0x02 */
 159 #define BTA_HL_MCAP_SUP_RECONNECT_MASK_ACCEPT        4 /* 0x04 */
 160 #define BTA_HL_MCAP_SUP_CSP_MASK_SYNC_SLAVE          0 /* 0x08 */
 161 #define BTA_HL_MCAP_SUP_CSP_MASK_SYNC_MASTER         0 /* 0x10 */
 162
 163 #define BTA_HL_MCAP_SUP_PROC_MASK  (BTA_HL_MCAP_SUP_RECONNECT_MASK_INIT | \
 164                                     BTA_HL_MCAP_SUP_RECONNECT_MASK_ACCEPT | \
 165                                     BTA_HL_MCAP_SUP_CSP_MASK_SYNC_SLAVE | \
 166                                     BTA_HL_MCAP_SUP_CSP_MASK_SYNC_MASTER)
 167 #define BTA_HL_MDEP_ROLE_SOURCE         0x00
 168 #define BTA_HL_MDEP_ROLE_SINK           0x01
 169
 170 typedef UINT8 tBTA_HL_MDEP_ROLE;
 171
 172 #define BTA_HL_MDEP_ROLE_MASK_SOURCE    0x01     /* bit mask */
 173 #define BTA_HL_MDEP_ROLE_MASK_SINK      0x02
 174 typedef UINT8 tBTA_HL_MDEP_ROLE_MASK;
 175
 176
 177 #define BTA_HL_ECHO_TEST_MDEP_ID        0
 178 #define BTA_HL_ECHO_TEST_MDEP_CFG_IDX   0
 179
 180 #define BTA_HL_INVALID_MDEP_ID     0xFF
 181 typedef tMCA_DEP tBTA_HL_MDEP_ID; /* 0 is for echo test,
 182                                    0x01-0x7F availave for use,
 183                                    0x80-0xFF reserved*/
 184
 185
 186 #define BTA_HL_DELETE_ALL_MDL_IDS   0xFFFF
 187 #define BTA_HL_MAX_MDL_VAL          0xFEFF
 188 typedef UINT16 tBTA_HL_MDL_ID;  /* 0x0000 reserved,
 189                                    0x0001-0xFEFF dynamic range,
 190                                    0xFF00-0xFFFE reserved,
 191                                    0xFFFF indicates all MDLs*/
 192
 193 #define BTA_HL_MDEP_DESP_LEN       35
 194
 195 #define BTA_HL_DCH_MODE_RELIABLE    0
 196 #define BTA_HL_DCH_MODE_STREAMING   1
 197
 198 typedef UINT8 tBTA_HL_DCH_MODE;
 199
 200 #define BTA_HL_DCH_CFG_NO_PREF      0
 201 #define BTA_HL_DCH_CFG_RELIABLE     1
 202 #define BTA_HL_DCH_CFG_STREAMING    2
 203 #define BTA_HL_DCH_CFG_UNKNOWN      0xFF
 204
 205 typedef UINT8 tBTA_HL_DCH_CFG;
 206
 207 /* The Default DCH CFG for the echo test when the device is a Source */
 208 #define BTA_HL_DEFAULT_ECHO_TEST_SRC_DCH_CFG BTA_HL_DCH_CFG_RELIABLE
 209
 210 #define BTA_HL_DCH_CREATE_RSP_SUCCESS 0
 211 #define BTA_HL_DCH_CREATE_RSP_CFG_REJ 1
 212
 213 typedef UINT8 tBTA_HL_DCH_CREATE_RSP;
 214
 215 #define BTA_HL_MCAP_SUP_PROC_RECONNECT_INIT 0x02
 216 #define BTA_HL_MCAP_SUP_PROC_RECONNECT_APT  0x04
 217 #define BTA_HL_MCAP_SUP_PROC_CSP_SLAVE      0x08
 218 #define BTA_HL_MCAP_SUP_PROC_CSP_MASTER     0x10
 219
 220 typedef UINT8 tBTA_HL_SUP_PROC_MASK;
 221
 222 typedef struct
 223 {
 224     UINT16                  max_rx_apdu_size;  /* local rcv MTU */
 225     UINT16                  max_tx_apdu_size;  /* maximum TX APDU size*/
 226 } tBTA_HL_ECHO_CFG;
 227
 228
 229 typedef struct
 230 {
 231     UINT16                  data_type;
 232     UINT16                  max_rx_apdu_size;  /* local rcv MTU */
 233     UINT16                  max_tx_apdu_size;  /* maximum TX APDU size*/
 234     char                    desp[BTA_HL_MDEP_DESP_LEN+1];
 235 } tBTA_HL_MDEP_DATA_TYPE_CFG;
 236
 237
 238 typedef struct
 239 {
 240     tBTA_HL_MDEP_ROLE           mdep_role;
 241     UINT8                       num_of_mdep_data_types;
 242     tBTA_HL_MDEP_DATA_TYPE_CFG  data_cfg[BTA_HL_NUM_DATA_TYPES];
 243 } tBTA_HL_MDEP_CFG;
 244
 245 typedef struct
 246 {
 247     tBTA_HL_MDEP_ID         mdep_id;  /* MDEP ID 0x01-0x7F */
 248     tBTA_HL_MDEP_CFG        mdep_cfg;
 249     UINT8                   ori_app_id;
 250 } tBTA_HL_MDEP;
 251
 252 typedef struct
 253 {
 254     tBTA_HL_MDEP            mdep[BTA_HL_NUM_MDEPS];
 255     tBTA_HL_ECHO_CFG        echo_cfg;
 256     tBTA_HL_MDEP_ROLE_MASK  app_role_mask;
 257     BOOLEAN                 advertize_source_sdp;
 258     UINT8                   num_of_mdeps;
 259 } tBTA_HL_SUP_FEATURE;
 260
 261 typedef struct
 262 {
 263     BOOLEAN                 delete_req_pending;
 264     tBTA_HL_MDL_ID          mdl_id;
 265     tBTA_HL_MCL_HANDLE      mcl_handle;
 266 } tBTA_HL_DELETE_MDL;
 267
 268 typedef struct
 269 {
 270     UINT8                   time;
 271     UINT16                  mtu;
 272     tBTA_HL_MDL_ID          mdl_id;
 273     tBTA_HL_MDEP_ID         local_mdep_id;
 274     tBTA_HL_MDEP_ROLE       local_mdep_role;
 275     BOOLEAN                 active;     /* true if this item is in use */
 276     tBTA_HL_DCH_MODE        dch_mode;
 277     UINT8                   fcs;
 278     BD_ADDR                 peer_bd_addr;
 279 } tBTA_HL_MDL_CFG;
 280
 281
 282 /* Maximum number of supported feature list items (list_elem in tSDP_SUP_FEATURE_ELEM) */
 283 #define BTA_HL_NUM_SUP_FEATURE_ELEMS     13
 284 #define BTA_HL_SUP_FEATURE_SDP_BUF_SIZE  512
 285 /* This structure is used to add supported feature lists and find supported feature elements */
 286 typedef struct
 287 {
 288     UINT8       mdep_id;
 289     UINT16      data_type;
 290     tBTA_HL_MDEP_ROLE       mdep_role;
 291     char        *p_mdep_desp;
 292 } tBTA_HL_SUP_FEATURE_ELEM;
 293
 294 typedef struct
 295 {
 296     UINT16                      num_elems;
 297     tBTA_HL_SUP_FEATURE_ELEM   list_elem[BTA_HL_NUM_SUP_FEATURE_ELEMS];
 298 } tBTA_HL_SUP_FEATURE_LIST_ELEM;
 299
 300
 301 typedef struct
 302 {
 303     tBTA_HL_DEVICE_TYPE     dev_type;           /* sink, source or dual roles */
 304     tBTA_SEC                sec_mask;           /* security mask for accepting conenction*/
 305     const char              *p_srv_name;        /* service name to be used in the SDP; null terminated*/
 306     const char              *p_srv_desp;        /* service description to be used in the SDP; null terminated */
 307     const char              *p_provider_name;   /* provide name to be used in the SDP; null terminated */
 308 } tBTA_HL_REG_PARAM;
 309
 310 typedef struct
 311 {
 312     UINT16                  ctrl_psm;
 313     BD_ADDR                 bd_addr;           /* Address of peer device */
 314     tBTA_SEC                sec_mask;          /* security mask for initiating connection*/
 315 } tBTA_HL_CCH_OPEN_PARAM;
 316
 317
 318 typedef struct
 319 {
 320     UINT16                  ctrl_psm;
 321     tBTA_HL_MDEP_ID         local_mdep_id;     /* local MDEP ID */
 322     tBTA_HL_MDEP_ID         peer_mdep_id;      /* peer mdep id */
 323     tBTA_HL_DCH_CFG         local_cfg;
 324     tBTA_SEC                sec_mask;          /* security mask for initiating connection*/
 325 } tBTA_HL_DCH_OPEN_PARAM;
 326
 327
 328 typedef struct
 329 {
 330     UINT16                  ctrl_psm;
 331     tBTA_HL_MDL_ID          mdl_id;
 332 } tBTA_HL_DCH_RECONNECT_PARAM;
 333
 334
 335 typedef struct
 336 {
 337     UINT16                  ctrl_psm;
 338     UINT16                  pkt_size;
 339     tBTA_HL_DCH_CFG         local_cfg;
 340 } tBTA_HL_DCH_ECHO_TEST_PARAM;
 341
 342 typedef struct
 343 {
 344     UINT16                  buf_size;
 345     UINT8                   p_buf;        /* buffer pointer */
 346 } tBTA_HL_DCH_BUF_INFO;
 347
 348 typedef struct
 349 {
 350     tBTA_HL_MDEP_ID         local_mdep_id;  /* local MDEP ID */
 351     tBTA_HL_MDL_ID          mdl_id;
 352     tBTA_HL_DCH_CREATE_RSP  rsp_code;
 353     tBTA_HL_DCH_CFG         cfg_rsp;
 354 } tBTA_HL_DCH_CREATE_RSP_PARAM;
 355
 356 typedef struct
 357 {
 358     UINT16              data_type;
 359     UINT8               mdep_id;
 360     tBTA_HL_MDEP_ROLE   mdep_role;
 361     char                mdep_desp[BTA_HL_MDEP_DESP_LEN+1];
 362 }tBTA_HL_SDP_MDEP_CFG;
 363
 364 typedef struct
 365 {
 366     UINT16                  ctrl_psm;
 367     UINT16                  data_psm;
 368     UINT8                   mcap_sup_proc;
 369     UINT8                   num_mdeps; /* number of mdep elements from SDP*/
 370     char                    srv_name[BTA_SERVICE_NAME_LEN+1];
 371     char                    srv_desp[BTA_SERVICE_DESP_LEN+1];
 372     char                    provider_name[BTA_PROVIDER_NAME_LEN+1];
 373     tBTA_HL_SDP_MDEP_CFG    mdep_cfg[BTA_HL_NUM_SDP_MDEPS];
 374 } tBTA_HL_SDP_REC;
 375
 376 typedef struct
 377 {
 378     UINT8                num_recs;
 379     tBTA_HL_SDP_REC      sdp_rec[BTA_HL_NUM_SDP_RECS];
 380 } tBTA_HL_SDP;
 381
 382 /* HL control callback function events */
 383 enum
 384 {
 385     BTA_HL_CTRL_ENABLE_CFM_EVT            = 0,
 386     BTA_HL_CTRL_DISABLE_CFM_EVT
 387 };
 388 typedef UINT8 tBTA_HL_CTRL_EVT;
 389 /* Structure associated with BTA_HL_ENABLE_EVT
 390    BTA_HL_DISABLE_EVT */
 391
 392 typedef struct
 393 {
 394     tBTA_HL_STATUS  status;
 395 } tBTA_HL_CTRL_ENABLE_DISABLE;
 396
 397 typedef union
 398 {
 399     tBTA_HL_CTRL_ENABLE_DISABLE  enable_cfm;
 400     tBTA_HL_CTRL_ENABLE_DISABLE  disable_cfm;
 401 } tBTA_HL_CTRL;
 402
 403 /* HL instance callback function events */
 404 enum
 405 {
 406     BTA_HL_REGISTER_CFM_EVT           =0,
 407     BTA_HL_DEREGISTER_CFM_EVT,
 408     BTA_HL_CCH_OPEN_IND_EVT,
 409     BTA_HL_CCH_OPEN_CFM_EVT,
 410     BTA_HL_CCH_CLOSE_IND_EVT,
 411     BTA_HL_CCH_CLOSE_CFM_EVT,
 412     BTA_HL_DCH_CREATE_IND_EVT,
 413     BTA_HL_DCH_OPEN_IND_EVT,
 414     BTA_HL_DCH_OPEN_CFM_EVT,
 415     BTA_HL_DCH_CLOSE_IND_EVT,
 416     BTA_HL_DCH_CLOSE_CFM_EVT,
 417     BTA_HL_DCH_RECONNECT_IND_EVT,
 418     BTA_HL_DCH_RECONNECT_CFM_EVT,
 419
 420     BTA_HL_DCH_ABORT_IND_EVT,
 421     BTA_HL_DCH_ABORT_CFM_EVT,
 422     BTA_HL_DELETE_MDL_IND_EVT,
 423     BTA_HL_DELETE_MDL_CFM_EVT,
 424     BTA_HL_DCH_SEND_DATA_CFM_EVT,
 425     BTA_HL_DCH_RCV_DATA_IND_EVT,
 426     BTA_HL_CONG_CHG_IND_EVT,
 427     BTA_HL_DCH_ECHO_TEST_CFM_EVT,
 428     BTA_HL_SDP_QUERY_CFM_EVT,
 429     BTA_HL_SDP_INFO_IND_EVT
 430 };
 431 typedef UINT8 tBTA_HL_EVT;
 432
 433
 434 typedef struct
 435 {
 436     tBTA_HL_STATUS          status;        /* start status */
 437     UINT8                   app_id;
 438     tBTA_HL_APP_HANDLE      app_handle;
 439 } tBTA_HL_REGISTER_CFM;
 440
 441
 442 typedef struct
 443 {
 444     tBTA_HL_STATUS          status;        /* start status */
 445     UINT8                   app_id;
 446     tBTA_HL_APP_HANDLE      app_handle;
 447 } tBTA_HL_DEREGISTER_CFM;
 448
 449
 450 typedef struct
 451 {
 452     BOOLEAN                 intentional;
 453     tBTA_HL_MCL_HANDLE      mcl_handle;
 454     tBTA_HL_APP_HANDLE      app_handle;
 455 } tBTA_HL_CCH_CLOSE_IND;
 456
 457
 458 typedef struct
 459 {
 460     tBTA_HL_MCL_HANDLE      mcl_handle;
 461     tBTA_HL_APP_HANDLE      app_handle;
 462 } tBTA_HL_MCL_IND;
 463
 464 typedef struct
 465 {
 466     tBTA_HL_STATUS          status;             /* connection status */
 467     tBTA_HL_MCL_HANDLE      mcl_handle;
 468     tBTA_HL_APP_HANDLE      app_handle;
 469 } tBTA_HL_MCL_CFM;
 470
 471 typedef struct
 472 {
 473     tBTA_HL_MCL_HANDLE      mcl_handle;
 474     tBTA_HL_APP_HANDLE      app_handle;
 475     BD_ADDR                 bd_addr; /* address of peer device */
 476 } tBTA_HL_CCH_OPEN_IND;
 477
 478 typedef struct
 479 {
 480     tBTA_HL_STATUS          status;             /* connection status */
 481     UINT8                   app_id;
 482     tBTA_HL_MCL_HANDLE      mcl_handle;
 483     tBTA_HL_APP_HANDLE      app_handle;
 484     BD_ADDR                 bd_addr;            /* address of peer device */
 485 } tBTA_HL_CCH_OPEN_CFM;
 486
 487 typedef struct
 488 {
 489     tBTA_HL_MCL_HANDLE      mcl_handle;
 490     tBTA_HL_APP_HANDLE      app_handle;
 491     tBTA_HL_MDEP_ID         local_mdep_id;
 492     tBTA_HL_MDL_ID          mdl_id;             /* MCAP data link ID for this
 493                                                    data channel conenction    */
 494     tBTA_HL_DCH_CFG         cfg;                /* dch cfg requested by the peer device */
 495     BD_ADDR                 bd_addr; /* address of peer device */
 496
 497 } tBTA_HL_DCH_CREATE_IND;
 498
 499 typedef struct
 500 {
 501     tBTA_HL_MDL_HANDLE      mdl_handle;
 502     tBTA_HL_MCL_HANDLE      mcl_handle;
 503     tBTA_HL_APP_HANDLE      app_handle;
 504     tBTA_HL_MDEP_ID         local_mdep_id;
 505     tBTA_HL_MDL_ID          mdl_id;             /* MCAP data link ID for this
 506                                                    data channel conenction    */
 507     tBTA_HL_DCH_MODE        dch_mode;           /* data channel mode - reliable or streaming*/
 508
 509     BOOLEAN                 first_reliable;  /* whether this is the first reliable data channel */
 510     UINT16                  mtu;
 511 } tBTA_HL_DCH_OPEN_IND;
 512
 513 typedef struct
 514 {
 515     tBTA_HL_STATUS          status;             /* connection status */
 516     tBTA_HL_MDL_HANDLE      mdl_handle;
 517     tBTA_HL_MCL_HANDLE      mcl_handle;
 518     tBTA_HL_APP_HANDLE      app_handle;
 519     tBTA_HL_MDEP_ID         local_mdep_id;
 520     tBTA_HL_MDL_ID          mdl_id;             /* MCAP data link ID for this
 521                                                    data channel conenction    */
 522     tBTA_HL_DCH_MODE        dch_mode;           /* data channel mode - reliable or streaming*/
 523     BOOLEAN                 first_reliable;     /* whether this is the first reliable data channel */
 524     UINT16                  mtu;
 525 } tBTA_HL_DCH_OPEN_CFM;
 526
 527
 528 typedef struct
 529 {
 530     BOOLEAN                 intentional;
 531     tBTA_HL_MDL_HANDLE      mdl_handle;
 532     tBTA_HL_MCL_HANDLE      mcl_handle;
 533     tBTA_HL_APP_HANDLE      app_handle;
 534 } tBTA_HL_DCH_CLOSE_IND;
 535
 536
 537 typedef struct
 538 {
 539     tBTA_HL_MDL_HANDLE      mdl_handle;
 540     tBTA_HL_MCL_HANDLE      mcl_handle;
 541     tBTA_HL_APP_HANDLE      app_handle;
 542 } tBTA_HL_MDL_IND;
 543
 544 typedef struct
 545 {
 546     tBTA_HL_STATUS          status;
 547     tBTA_HL_MDL_HANDLE      mdl_handle;
 548     tBTA_HL_MCL_HANDLE      mcl_handle;
 549     tBTA_HL_APP_HANDLE      app_handle;
 550 } tBTA_HL_MDL_CFM;
 551
 552 typedef struct
 553 {
 554     tBTA_HL_MCL_HANDLE      mcl_handle;
 555     tBTA_HL_APP_HANDLE      app_handle;
 556     tBTA_HL_MDL_ID          mdl_id;
 557 } tBTA_HL_DELETE_MDL_IND;
 558
 559 typedef struct
 560 {
 561     tBTA_HL_STATUS          status;
 562     tBTA_HL_MCL_HANDLE      mcl_handle;
 563     tBTA_HL_APP_HANDLE      app_handle;
 564     tBTA_HL_MDL_ID          mdl_id;
 565 } tBTA_HL_DELETE_MDL_CFM;
 566
 567 typedef struct
 568 {
 569     tBTA_HL_MDL_HANDLE      mdl_handle;
 570     tBTA_HL_MCL_HANDLE      mcl_handle;
 571     tBTA_HL_APP_HANDLE      app_handle;
 572     BOOLEAN                 cong;
 573 } tBTA_HL_DCH_CONG_IND;
 574
 575 typedef struct
 576 {
 577     tBTA_HL_APP_HANDLE      app_handle;
 578     UINT16                  ctrl_psm;
 579     UINT16                  data_psm;
 580     UINT8                   data_x_spec;
 581     UINT8                   mcap_sup_procs;
 582 } tBTA_HL_SDP_INFO_IND;
 583
 584 typedef struct
 585 {
 586     tBTA_HL_STATUS          status;
 587     UINT8                   app_id;
 588     tBTA_HL_APP_HANDLE      app_handle;
 589     BD_ADDR                 bd_addr;
 590     tBTA_HL_SDP             *p_sdp;
 591 } tBTA_HL_SDP_QUERY_CFM;
 592
 593 typedef union
 594 {
 595     tBTA_HL_REGISTER_CFM        reg_cfm;
 596     tBTA_HL_DEREGISTER_CFM      dereg_cfm;
 597     tBTA_HL_CCH_OPEN_IND        cch_open_ind;
 598     tBTA_HL_CCH_OPEN_CFM        cch_open_cfm;
 599     tBTA_HL_CCH_CLOSE_IND       cch_close_ind;
 600     tBTA_HL_MCL_CFM             cch_close_cfm;
 601     tBTA_HL_DCH_CREATE_IND      dch_create_ind;
 602     tBTA_HL_DCH_OPEN_IND        dch_open_ind;
 603     tBTA_HL_DCH_OPEN_CFM        dch_open_cfm;
 604     tBTA_HL_DCH_CLOSE_IND       dch_close_ind;
 605     tBTA_HL_MDL_CFM             dch_close_cfm;
 606     tBTA_HL_DCH_OPEN_IND        dch_reconnect_ind;
 607     tBTA_HL_DCH_OPEN_CFM        dch_reconnect_cfm;
 608     tBTA_HL_MCL_IND             dch_abort_ind;
 609     tBTA_HL_MCL_CFM             dch_abort_cfm;
 610     tBTA_HL_DELETE_MDL_IND      delete_mdl_ind;
 611     tBTA_HL_DELETE_MDL_CFM      delete_mdl_cfm;
 612     tBTA_HL_MDL_CFM             dch_send_data_cfm;
 613     tBTA_HL_MDL_IND             dch_rcv_data_ind;
 614     tBTA_HL_DCH_CONG_IND        dch_cong_ind;
 615     tBTA_HL_MCL_CFM             echo_test_cfm;
 616     tBTA_HL_SDP_QUERY_CFM       sdp_query_cfm;
 617     tBTA_HL_SDP_INFO_IND        sdp_info_ind;
 618
 619 } tBTA_HL;
 620
 621 /* HL callback functions */
 622 typedef void tBTA_HL_CTRL_CBACK(tBTA_HL_CTRL_EVT event, tBTA_HL_CTRL *p_data);
 623 typedef void tBTA_HL_CBACK(tBTA_HL_EVT event, tBTA_HL *p_data);
 624
 625
 626 /*****************************************************************************
 627 **  External Function Declarations
 628 *****************************************************************************/
 629 #ifdef __cplusplus
 630 extern "C"
 631 {
 632 #endif
 633
 634 /**************************
 635 **  API Functions
 636 ***************************/
 637
 638 /*******************************************************************************
 639 **
 640 ** Function         BTA_HlEnable
 641 **
 642 ** Description      Enable the HL subsystems.  This function must be
 643 **                  called before any other functions in the HL API are called.
 644 **                  When the enable operation is completed the callback function
 645 **                  will be called with an BTA_HL_CTRL_ENABLE_CFM_EVT event.
 646 **
 647 ** Parameters       p_cback - HL event call back function
 648 **
 649 ** Returns          void
 650 **
 651 *******************************************************************************/
 652 extern void BTA_HlEnable(tBTA_HL_CTRL_CBACK *p_ctrl_cback);
 653 /*******************************************************************************
 654 **
 655 ** Function         BTA_HlDisable
 656 **
 657 ** Description     Disable the HL subsystem.
 658 **
 659 ** Returns          void
 660 **
 661 *******************************************************************************/
 662 extern void BTA_HlDisable(void);
 663
 664 /*******************************************************************************
 665 **
 666 ** Function         BTA_HlUpdate
 667 **
 668 ** Description      Register an HDP application
 669 **
 670 ** Parameters       app_id        - Application ID
 671 **                  p_reg_param   - non-platform related parameters for the
 672 **                                  HDP application
 673 **                  p_cback       - HL event callback fucntion
 674 **
 675 ** Returns          void
 676 **
 677 *******************************************************************************/
 678 extern void BTA_HlUpdate(UINT8  app_id,
 679                          tBTA_HL_REG_PARAM *p_reg_param, BOOLEAN is_register,
 680                          tBTA_HL_CBACK *p_cback);
 681
 682 /*******************************************************************************
 683 **
 684 ** Function         BTA_HlRegister
 685 **
 686 ** Description      Register a HDP application
 687 **
 688 **
 689 ** Parameters       app_id        - hdp application ID
 690 **                  p_reg_param   - non-platform related parameters for the
 691 **                                  HDP application
 692 **                  p_cback       - HL event callback fucntion
 693 **
 694 ** Returns          void
 695 **
 696 *******************************************************************************/
 697 extern void BTA_HlRegister(UINT8  app_id,
 698                            tBTA_HL_REG_PARAM *p_reg_param,
 699                            tBTA_HL_CBACK *p_cback);
 700
 701 /*******************************************************************************
 702 **
 703 ** Function         BTA_HlDeregister
 704 **
 705 ** Description      Deregister an HDP application
 706 **
 707 ** Parameters       app_handle - Application handle
 708 **
 709 ** Returns         void
 710 **
 711 *******************************************************************************/
 712 extern void BTA_HlDeregister(UINT8 app_id,tBTA_HL_APP_HANDLE app_handle);
 713
 714 /*******************************************************************************
 715 **
 716 ** Function         BTA_HlCchOpen
 717 **
 718 ** Description      Open a Control channel connection with the specified BD address
 719 **                  and the control PSM value is used to select which
 720 **                  HDP insatnce should be used in case the peer device support
 721 **                  multiple HDP instances.
 722 **
 723 **
 724 ** Parameters       app_handle - Application Handle
 725 **                  p_open_param - parameters for opening a control channel
 726 **
 727 ** Returns          void
 728 **
 729 **                  Note: If the control PSM value is zero then the first HDP
 730 **                        instance is used for the control channel setup
 731 *******************************************************************************/
 732 extern void BTA_HlCchOpen(UINT8 app_id, tBTA_HL_APP_HANDLE app_handle,
 733                           tBTA_HL_CCH_OPEN_PARAM *p_open_param);
 734
 735 /*******************************************************************************
 736 **
 737 ** Function         BTA_HlCchClose
 738 **
 739 ** Description      Close a Control channel connection with the specified MCL
 740 **                  handle
 741 **
 742 ** Parameters       mcl_handle - MCL handle
 743 **
 744 ** Returns          void
 745 **
 746 *******************************************************************************/
 747 extern  void BTA_HlCchClose(tBTA_HL_MCL_HANDLE mcl_handle);
 748
 749 /*******************************************************************************
 750 **
 751 ** Function         BTA_HlDchOpen
 752 **
 753 ** Description      Open a data channel connection with the specified DCH parameters
 754 **
 755 ** Parameters       mcl_handle - MCL handle
 756 **                  p_open_param - parameters for opening a data channel
 757 **
 758 ** Returns          void
 759 **
 760 *******************************************************************************/
 761 extern  void BTA_HlDchOpen(tBTA_HL_MCL_HANDLE mcl_handle,
 762                            tBTA_HL_DCH_OPEN_PARAM *p_open_param);
 763 /*******************************************************************************
 764 **
 765 ** Function         BTA_HlDchReconnect
 766 **
 767 ** Description      Reconnect a data channel with the specified MDL_ID
 768 **
 769 ** Parameters       mcl_handle      - MCL handle
 770 *8                  p_recon_param   - parameters for reconnecting a data channel
 771 **
 772 ** Returns          void
 773 **
 774 *******************************************************************************/
 775 extern void BTA_HlDchReconnect(tBTA_HL_MCL_HANDLE mcl_handle,
 776                                tBTA_HL_DCH_RECONNECT_PARAM *p_recon_param);
 777 /*******************************************************************************
 778 **
 779 ** Function         BTA_HlDchClose
 780 **
 781 ** Description      Close a data channel with the specified MDL handle
 782 **
 783 ** Parameters       mdl_handle  - MDL handle
 784 **
 785 ** Returns          void
 786 **
 787 *******************************************************************************/
 788 extern void BTA_HlDchClose(tBTA_HL_MDL_HANDLE mdl_handle);
 789
 790 /*******************************************************************************
 791 **
 792 ** Function         BTA_HlDchAbort
 793 **
 794 ** Description      Abort the current data channel setup with the specified MCL
 795 **                  handle
 796 **
 797 ** Parameters       mcl_handle  - MCL handle
 798 **
 799 **
 800 ** Returns          void
 801 **
 802 *******************************************************************************/
 803 extern void BTA_HlDchAbort(tBTA_HL_MCL_HANDLE mcl_handle);
 804
 805 /*******************************************************************************
 806 **
 807 ** Function         BTA_HlSendData
 808 **
 809 ** Description      Send an APDU to the peer device
 810 **
 811 ** Parameters       mdl_handle  - MDL handle
 812 **                  pkt_size    - size of the data packet to be sent
 813 **
 814 ** Returns          void
 815 **
 816 *******************************************************************************/
 817 extern void BTA_HlSendData(tBTA_HL_MDL_HANDLE mdl_handle,
 818                            UINT16           pkt_size);
 819
 820 /*******************************************************************************
 821 **
 822 ** Function         BTA_HlDeleteMdl
 823 **
 824 ** Description      Delete the specified MDL_ID within the specified MCL handle
 825 **
 826 ** Parameters       mcl_handle  - MCL handle
 827 **                  mdl_id      - MDL ID
 828 **
 829 ** Returns          void
 830 **
 831 **                  note: If mdl_id = 0xFFFF then this means to delete all MDLs
 832 **                        and this value can only be used with DeleteMdl request only
 833 **                        not other requests
 834 **
 835 *******************************************************************************/
 836 extern void BTA_HlDeleteMdl(tBTA_HL_MCL_HANDLE mcl_handle,
 837                             tBTA_HL_MDL_ID mdl_id );
 838
 839 /*******************************************************************************
 840 **
 841 ** Function         BTA_HlDchEchoTest
 842 **
 843 ** Description      Initiate an echo test with the specified MCL handle
 844 **
 845 ** Parameters       mcl_handle           - MCL handle
 846 *8                  p_echo_test_param   -  parameters for echo testing
 847 **
 848 ** Returns          void
 849 **
 850 *******************************************************************************/
 851 extern void BTA_HlDchEchoTest( tBTA_HL_MCL_HANDLE  mcl_handle,
 852                                tBTA_HL_DCH_ECHO_TEST_PARAM *p_echo_test_param);
 853
 854 /*******************************************************************************
 855 **
 856 ** Function         BTA_HlSdpQuery
 857 **
 858 ** Description      SDP query request for the specified BD address
 859 **
 860 ** Parameters       app_id
 861                         app_handle      - application handle
 862 **                  bd_addr         - BD address
 863 **
 864 ** Returns          void
 865 **
 866 *******************************************************************************/
 867 extern  void BTA_HlSdpQuery(UINT8  app_id,tBTA_HL_APP_HANDLE app_handle,
 868                             BD_ADDR bd_addr);
 869
 870 /*******************************************************************************
 871 **
 872 ** Function         BTA_HlDchCreateMdlRsp
 873 **
 874 ** Description      Set the Response and configuration values for the Create MDL
 875 **                  request
 876 **
 877 ** Parameters       mcl_handle  - MCL handle
 878 **                  p_rsp_param - parameters specified whether the request should
 879 **                                be accepted or not and if it should be accepted
 880 **                                then it also specified the configuration response
 881 **                                value
 882 **
 883 ** Returns          void
 884 **
 885 *******************************************************************************/
 886 extern void BTA_HlDchCreateRsp(tBTA_HL_MCL_HANDLE mcl_handle,
 887                                tBTA_HL_DCH_CREATE_RSP_PARAM *p_rsp_param);
 888
 889
 890
 891 #ifdef __cplusplus
 892
 893 }
 894 #endif
 895
 896 #endif /* BTA_HL_API_H */