Home | History | Annotate | Download | only in sdp
      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 /******************************************************************************
     20  *
     21  *  This file contains internally used SDP definitions
     22  *
     23  ******************************************************************************/
     24 
     25 #ifndef  SDP_INT_H
     26 #define  SDP_INT_H
     27 
     28 #include "bt_target.h"
     29 #include "sdp_api.h"
     30 #include "l2c_api.h"
     31 
     32 
     33 /* Continuation length - we use a 2-byte offset */
     34 #define SDP_CONTINUATION_LEN        2
     35 #define SDP_MAX_CONTINUATION_LEN    16          /* As per the spec */
     36 
     37 /* Timeout definitions. */
     38 #define SDP_INACT_TIMEOUT       30              /* Inactivity timeout         */
     39 
     40 
     41 /* Define the Out-Flow default values. */
     42 #define  SDP_OFLOW_QOS_FLAG                 0
     43 #define  SDP_OFLOW_SERV_TYPE                0
     44 #define  SDP_OFLOW_TOKEN_RATE               0
     45 #define  SDP_OFLOW_TOKEN_BUCKET_SIZE        0
     46 #define  SDP_OFLOW_PEAK_BANDWIDTH           0
     47 #define  SDP_OFLOW_LATENCY                  0
     48 #define  SDP_OFLOW_DELAY_VARIATION          0
     49 
     50 /* Define the In-Flow default values. */
     51 #define  SDP_IFLOW_QOS_FLAG                 0
     52 #define  SDP_IFLOW_SERV_TYPE                0
     53 #define  SDP_IFLOW_TOKEN_RATE               0
     54 #define  SDP_IFLOW_TOKEN_BUCKET_SIZE        0
     55 #define  SDP_IFLOW_PEAK_BANDWIDTH           0
     56 #define  SDP_IFLOW_LATENCY                  0
     57 #define  SDP_IFLOW_DELAY_VARIATION          0
     58 
     59 #define  SDP_LINK_TO                        0
     60 
     61 /* Define the type of device notification. */
     62 /* (Inquiry Scan and Page Scan)            */
     63 #define  SDP_DEVICE_NOTI_LEN                sizeof (BT_HDR) +           \
     64                                             HCIC_PREAMBLE_SIZE +        \
     65                                             HCIC_PARAM_SIZE_WRITE_PARAM1
     66 
     67 #define  SDP_DEVICE_NOTI_FLAG               0x03
     68 
     69 /* Define the Protocol Data Unit (PDU) types.
     70 */
     71 #define  SDP_PDU_ERROR_RESPONSE                 0x01
     72 #define  SDP_PDU_SERVICE_SEARCH_REQ             0x02
     73 #define  SDP_PDU_SERVICE_SEARCH_RSP             0x03
     74 #define  SDP_PDU_SERVICE_ATTR_REQ               0x04
     75 #define  SDP_PDU_SERVICE_ATTR_RSP               0x05
     76 #define  SDP_PDU_SERVICE_SEARCH_ATTR_REQ        0x06
     77 #define  SDP_PDU_SERVICE_SEARCH_ATTR_RSP        0x07
     78 
     79 /* Max UUIDs and attributes we support per sequence */
     80 #define     MAX_UUIDS_PER_SEQ       16
     81 #define     MAX_ATTR_PER_SEQ        16
     82 
     83 /* Max length we support for any attribute */
     84 // btla-specific ++
     85 #ifdef SDP_MAX_ATTR_LEN
     86 #define MAX_ATTR_LEN SDP_MAX_ATTR_LEN
     87 #else
     88 #define     MAX_ATTR_LEN            256
     89 #endif
     90 // btla-specific --
     91 
     92 /* Internal UUID sequence representation */
     93 typedef struct
     94 {
     95     UINT16     len;
     96     UINT8      value[MAX_UUID_SIZE];
     97 } tUID_ENT;
     98 
     99 typedef struct
    100 {
    101     UINT16      num_uids;
    102     tUID_ENT    uuid_entry[MAX_UUIDS_PER_SEQ];
    103 } tSDP_UUID_SEQ;
    104 
    105 
    106 /* Internal attribute sequence definitions */
    107 typedef struct
    108 {
    109     UINT16      start;
    110     UINT16      end;
    111 } tATT_ENT;
    112 
    113 typedef struct
    114 {
    115     UINT16      num_attr;
    116     tATT_ENT    attr_entry[MAX_ATTR_PER_SEQ];
    117 } tSDP_ATTR_SEQ;
    118 
    119 
    120 /* Define the attribute element of the SDP database record */
    121 typedef struct
    122 {
    123     UINT32  len;           /* Number of bytes in the entry */
    124     UINT8   *value_ptr;    /* Points to attr_pad */
    125     UINT16  id;
    126     UINT8   type;
    127 } tSDP_ATTRIBUTE;
    128 
    129 /* An SDP record consists of a handle, and 1 or more attributes */
    130 typedef struct
    131 {
    132     UINT32              record_handle;
    133     UINT32              free_pad_ptr;
    134     UINT16              num_attributes;
    135     tSDP_ATTRIBUTE      attribute[SDP_MAX_REC_ATTR];
    136     UINT8               attr_pad[SDP_MAX_PAD_LEN];
    137 } tSDP_RECORD;
    138 
    139 
    140 /* Define the SDP database */
    141 typedef struct
    142 {
    143     UINT32         di_primary_handle;       /* Device ID Primary record or NULL if nonexistent */
    144     BOOLEAN        brcm_di_registered;
    145     UINT16         num_records;
    146     tSDP_RECORD    record[SDP_MAX_RECORDS];
    147 } tSDP_DB;
    148 
    149 enum
    150 {
    151     SDP_IS_SEARCH,
    152     SDP_IS_ATTR_SEARCH,
    153     SDP_IS_PASS_THRU    /* only when SDP_FOR_JV_INCLUDED == TRUE */
    154 };
    155 
    156 #if SDP_SERVER_ENABLED == TRUE
    157 /* Continuation information for the SDP server response */
    158 typedef struct
    159 {
    160     UINT16            next_attr_index; /* attr index for next continuation response */
    161     UINT16            next_attr_start_id;  /* attr id to start with for the attr index in next cont. response */
    162     tSDP_RECORD       *prev_sdp_rec; /* last sdp record that was completely sent in the response */
    163     BOOLEAN           last_attr_seq_desc_sent; /* whether attr seq length has been sent previously */
    164     UINT16            attr_offset; /* offset within the attr to keep trak of partial attributes in the responses */
    165 } tSDP_CONT_INFO;
    166 #endif  /* SDP_SERVER_ENABLED == TRUE */
    167 
    168 /* Define the SDP Connection Control Block */
    169 typedef struct
    170 {
    171 #define SDP_STATE_IDLE              0
    172 #define SDP_STATE_CONN_SETUP        1
    173 #define SDP_STATE_CFG_SETUP         2
    174 #define SDP_STATE_CONNECTED         3
    175     UINT8             con_state;
    176 
    177 #define SDP_FLAGS_IS_ORIG           0x01
    178 #define SDP_FLAGS_HIS_CFG_DONE      0x02
    179 #define SDP_FLAGS_MY_CFG_DONE       0x04
    180     UINT8             con_flags;
    181 
    182     BD_ADDR           device_address;
    183     TIMER_LIST_ENT    timer_entry;
    184     UINT16            rem_mtu_size;
    185     UINT16            connection_id;
    186     UINT16            list_len;                 /* length of the response in the GKI buffer */
    187     UINT8             *rsp_list;                /* pointer to GKI buffer holding response */
    188 
    189 #if SDP_CLIENT_ENABLED == TRUE
    190     tSDP_DISCOVERY_DB *p_db;                    /* Database to save info into   */
    191     tSDP_DISC_CMPL_CB *p_cb;                    /* Callback for discovery done  */
    192     tSDP_DISC_CMPL_CB2 *p_cb2;                   /* Callback for discovery done piggy back with the user data */
    193     void               *user_data;              /* piggy back user data */
    194     UINT32            handles[SDP_MAX_DISC_SERVER_RECS]; /* Discovered server record handles */
    195     UINT16            num_handles;              /* Number of server handles     */
    196     UINT16            cur_handle;               /* Current handle being processed */
    197     UINT16            transaction_id;
    198     UINT16            disconnect_reason;        /* Disconnect reason            */
    199 #if (defined(SDP_BROWSE_PLUS) && SDP_BROWSE_PLUS == TRUE)
    200     UINT16            cur_uuid_idx;
    201 #endif
    202 
    203 #define SDP_DISC_WAIT_CONN          0
    204 #define SDP_DISC_WAIT_HANDLES       1
    205 #define SDP_DISC_WAIT_ATTR          2
    206 #define SDP_DISC_WAIT_SEARCH_ATTR   3
    207 #define SDP_DISC_WAIT_PASS_THRU     4    /* only when SDP_FOR_JV_INCLUDED == TRUE */
    208 #define SDP_DISC_WAIT_CANCEL        5
    209 
    210     UINT8             disc_state;
    211     UINT8             is_attr_search;
    212 #endif  /* SDP_CLIENT_ENABLED == TRUE */
    213 
    214 #if SDP_SERVER_ENABLED == TRUE
    215     UINT16            cont_offset;              /* Continuation state data in the server response */
    216     tSDP_CONT_INFO    cont_info;                /* structure to hold continuation information for the server response */
    217 #endif  /* SDP_SERVER_ENABLED == TRUE */
    218 
    219 } tCONN_CB;
    220 
    221 
    222 /*  The main SDP control block */
    223 typedef struct
    224 {
    225     tL2CAP_CFG_INFO   l2cap_my_cfg;             /* My L2CAP config     */
    226     tCONN_CB          ccb[SDP_MAX_CONNECTIONS];
    227 #if SDP_SERVER_ENABLED == TRUE
    228     tSDP_DB           server_db;
    229 #endif
    230     tL2CAP_APPL_INFO  reg_info;                 /* L2CAP Registration info */
    231     UINT16            max_attr_list_size;       /* Max attribute list size to use   */
    232     UINT16            max_recs_per_search;      /* Max records we want per seaarch  */
    233     UINT8             trace_level;
    234 } tSDP_CB;
    235 
    236 #ifdef __cplusplus
    237 extern "C" {
    238 #endif
    239 /* Global SDP data */
    240 #if SDP_DYNAMIC_MEMORY == FALSE
    241 SDP_API extern tSDP_CB  sdp_cb;
    242 #else
    243 SDP_API extern tSDP_CB *sdp_cb_ptr;
    244 #define sdp_cb (*sdp_cb_ptr)
    245 #endif
    246 
    247 #ifdef __cplusplus
    248 }
    249 #endif
    250 
    251 /* Functions provided by sdp_main.c */
    252 SDP_API extern void     sdp_init (void);
    253 extern void     sdp_disconnect (tCONN_CB*p_ccb, UINT16 reason);
    254 
    255 #if (defined(SDP_DEBUG) && SDP_DEBUG == TRUE)
    256 SDP_API extern UINT16 sdp_set_max_attr_list_size (UINT16 max_size);
    257 #endif
    258 
    259 /* Functions provided by sdp_conn.c
    260 */
    261 extern void sdp_conn_rcv_l2e_conn_ind (BT_HDR *p_msg);
    262 extern void sdp_conn_rcv_l2e_conn_cfm (BT_HDR *p_msg);
    263 extern void sdp_conn_rcv_l2e_disc (BT_HDR *p_msg);
    264 extern void sdp_conn_rcv_l2e_config_ind (BT_HDR *p_msg);
    265 extern void sdp_conn_rcv_l2e_config_cfm (BT_HDR *p_msg);
    266 extern void sdp_conn_rcv_l2e_conn_failed (BT_HDR *p_msg);
    267 extern void sdp_conn_rcv_l2e_connected (BT_HDR *p_msg);
    268 extern void sdp_conn_rcv_l2e_conn_failed (BT_HDR *p_msg);
    269 extern void sdp_conn_rcv_l2e_data (BT_HDR *p_msg);
    270 extern void sdp_conn_timeout (tCONN_CB *p_ccb);
    271 
    272 extern tCONN_CB *sdp_conn_originate (UINT8 *p_bd_addr);
    273 
    274 /* Functions provided by sdp_utils.c
    275 */
    276 extern tCONN_CB *sdpu_find_ccb_by_cid (UINT16 cid);
    277 extern tCONN_CB *sdpu_find_ccb_by_db (tSDP_DISCOVERY_DB *p_db);
    278 extern tCONN_CB *sdpu_allocate_ccb (void);
    279 extern void      sdpu_release_ccb (tCONN_CB *p_ccb);
    280 
    281 extern UINT8    *sdpu_build_attrib_seq (UINT8 *p_out, UINT16 *p_attr, UINT16 num_attrs);
    282 extern UINT8    *sdpu_build_attrib_entry (UINT8 *p_out, tSDP_ATTRIBUTE *p_attr);
    283 extern void      sdpu_build_n_send_error (tCONN_CB *p_ccb, UINT16 trans_num, UINT16 error_code, char *p_error_text);
    284 
    285 extern UINT8    *sdpu_extract_attr_seq (UINT8 *p, UINT16 param_len, tSDP_ATTR_SEQ *p_seq);
    286 extern UINT8    *sdpu_extract_uid_seq (UINT8 *p, UINT16 param_len, tSDP_UUID_SEQ *p_seq);
    287 
    288 SDP_API extern UINT8    *sdpu_get_len_from_type (UINT8 *p, UINT8 type, UINT32 *p_len);
    289 extern BOOLEAN  sdpu_is_base_uuid (UINT8 *p_uuid);
    290 extern BOOLEAN  sdpu_compare_uuid_arrays (UINT8 *p_uuid1, UINT32 len1, UINT8 *p_uuid2, UINT16 len2);
    291 SDP_API extern BOOLEAN  sdpu_compare_bt_uuids (tBT_UUID *p_uuid1, tBT_UUID *p_uuid2);
    292 extern BOOLEAN  sdpu_compare_uuid_with_attr (tBT_UUID *p_btuuid, tSDP_DISC_ATTR *p_attr);
    293 
    294 extern void     sdpu_sort_attr_list( UINT16 num_attr, tSDP_DISCOVERY_DB *p_db );
    295 extern UINT16 sdpu_get_list_len( tSDP_UUID_SEQ   *uid_seq, tSDP_ATTR_SEQ   *attr_seq );
    296 extern UINT16 sdpu_get_attrib_seq_len(tSDP_RECORD *p_rec, tSDP_ATTR_SEQ *attr_seq);
    297 extern UINT16 sdpu_get_attrib_entry_len(tSDP_ATTRIBUTE *p_attr);
    298 extern UINT8 *sdpu_build_partial_attrib_entry (UINT8 *p_out, tSDP_ATTRIBUTE *p_attr, UINT16 len, UINT16 *offset);
    299 extern void sdpu_uuid16_to_uuid128(UINT16 uuid16, UINT8* p_uuid128);
    300 
    301 /* Functions provided by sdp_db.c
    302 */
    303 extern tSDP_RECORD    *sdp_db_service_search (tSDP_RECORD *p_rec, tSDP_UUID_SEQ *p_seq);
    304 extern tSDP_RECORD    *sdp_db_find_record (UINT32 handle);
    305 extern tSDP_ATTRIBUTE *sdp_db_find_attr_in_rec (tSDP_RECORD *p_rec, UINT16 start_attr, UINT16 end_attr);
    306 
    307 
    308 /* Functions provided by sdp_server.c
    309 */
    310 #if SDP_SERVER_ENABLED == TRUE
    311 extern void     sdp_server_handle_client_req (tCONN_CB *p_ccb, BT_HDR *p_msg);
    312 #else
    313 #define sdp_server_handle_client_req(p_ccb, p_msg)
    314 #endif
    315 
    316 /* Functions provided by sdp_discovery.c
    317 */
    318 #if SDP_CLIENT_ENABLED == TRUE
    319 extern void sdp_disc_connected (tCONN_CB *p_ccb);
    320 extern void sdp_disc_server_rsp (tCONN_CB *p_ccb, BT_HDR *p_msg);
    321 #else
    322 #define sdp_disc_connected(p_ccb)
    323 #define sdp_disc_server_rsp(p_ccb, p_msg)
    324 #endif
    325 
    326 
    327 
    328 #endif
    329 
    330