Home | History | Annotate | Download | only in include
      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 */
    897