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     UINT16         num_records;
    145     tSDP_RECORD    record[SDP_MAX_RECORDS];
    146 } tSDP_DB;
    147 
    148 enum
    149 {
    150     SDP_IS_SEARCH,
    151     SDP_IS_ATTR_SEARCH,
    152 };
    153 
    154 #if SDP_SERVER_ENABLED == TRUE
    155 /* Continuation information for the SDP server response */
    156 typedef struct
    157 {
    158     UINT16            next_attr_index; /* attr index for next continuation response */
    159     UINT16            next_attr_start_id;  /* attr id to start with for the attr index in next cont. response */
    160     tSDP_RECORD       *prev_sdp_rec; /* last sdp record that was completely sent in the response */
    161     BOOLEAN           last_attr_seq_desc_sent; /* whether attr seq length has been sent previously */
    162     UINT16            attr_offset; /* offset within the attr to keep trak of partial attributes in the responses */
    163 } tSDP_CONT_INFO;
    164 #endif  /* SDP_SERVER_ENABLED == TRUE */
    165 
    166 /* Define the SDP Connection Control Block */
    167 typedef struct
    168 {
    169 #define SDP_STATE_IDLE              0
    170 #define SDP_STATE_CONN_SETUP        1
    171 #define SDP_STATE_CFG_SETUP         2
    172 #define SDP_STATE_CONNECTED         3
    173     UINT8             con_state;
    174 
    175 #define SDP_FLAGS_IS_ORIG           0x01
    176 #define SDP_FLAGS_HIS_CFG_DONE      0x02
    177 #define SDP_FLAGS_MY_CFG_DONE       0x04
    178     UINT8             con_flags;
    179 
    180     BD_ADDR           device_address;
    181     TIMER_LIST_ENT    timer_entry;
    182     UINT16            rem_mtu_size;
    183     UINT16            connection_id;
    184     UINT16            list_len;                 /* length of the response in the GKI buffer */
    185     UINT8             *rsp_list;                /* pointer to GKI buffer holding response */
    186 
    187 #if SDP_CLIENT_ENABLED == TRUE
    188     tSDP_DISCOVERY_DB *p_db;                    /* Database to save info into   */
    189     tSDP_DISC_CMPL_CB *p_cb;                    /* Callback for discovery done  */
    190     tSDP_DISC_CMPL_CB2 *p_cb2;                   /* Callback for discovery done piggy back with the user data */
    191     void               *user_data;              /* piggy back user data */
    192     UINT32            handles[SDP_MAX_DISC_SERVER_RECS]; /* Discovered server record handles */
    193     UINT16            num_handles;              /* Number of server handles     */
    194     UINT16            cur_handle;               /* Current handle being processed */
    195     UINT16            transaction_id;
    196     UINT16            disconnect_reason;        /* Disconnect reason            */
    197 #if (defined(SDP_BROWSE_PLUS) && SDP_BROWSE_PLUS == TRUE)
    198     UINT16            cur_uuid_idx;
    199 #endif
    200 
    201 #define SDP_DISC_WAIT_CONN          0
    202 #define SDP_DISC_WAIT_HANDLES       1
    203 #define SDP_DISC_WAIT_ATTR          2
    204 #define SDP_DISC_WAIT_SEARCH_ATTR   3
    205 #define SDP_DISC_WAIT_CANCEL        5
    206 
    207     UINT8             disc_state;
    208     UINT8             is_attr_search;
    209 #endif  /* SDP_CLIENT_ENABLED == TRUE */
    210 
    211 #if SDP_SERVER_ENABLED == TRUE
    212     UINT16            cont_offset;              /* Continuation state data in the server response */
    213     tSDP_CONT_INFO    cont_info;                /* structure to hold continuation information for the server response */
    214 #endif  /* SDP_SERVER_ENABLED == TRUE */
    215 
    216 } tCONN_CB;
    217 
    218 
    219 /*  The main SDP control block */
    220 typedef struct
    221 {
    222     tL2CAP_CFG_INFO   l2cap_my_cfg;             /* My L2CAP config     */
    223     tCONN_CB          ccb[SDP_MAX_CONNECTIONS];
    224 #if SDP_SERVER_ENABLED == TRUE
    225     tSDP_DB           server_db;
    226 #endif
    227     tL2CAP_APPL_INFO  reg_info;                 /* L2CAP Registration info */
    228     UINT16            max_attr_list_size;       /* Max attribute list size to use   */
    229     UINT16            max_recs_per_search;      /* Max records we want per seaarch  */
    230     UINT8             trace_level;
    231 } tSDP_CB;
    232 
    233 #ifdef __cplusplus
    234 extern "C" {
    235 #endif
    236 /* Global SDP data */
    237 #if SDP_DYNAMIC_MEMORY == FALSE
    238 extern tSDP_CB  sdp_cb;
    239 #else
    240 extern tSDP_CB *sdp_cb_ptr;
    241 #define sdp_cb (*sdp_cb_ptr)
    242 #endif
    243 
    244 #ifdef __cplusplus
    245 }
    246 #endif
    247 
    248 /* Functions provided by sdp_main.c */
    249 extern void     sdp_init (void);
    250 extern void     sdp_disconnect (tCONN_CB*p_ccb, UINT16 reason);
    251 
    252 #if (defined(SDP_DEBUG) && SDP_DEBUG == TRUE)
    253 extern UINT16 sdp_set_max_attr_list_size (UINT16 max_size);
    254 #endif
    255 
    256 /* Functions provided by sdp_conn.c
    257 */
    258 extern void sdp_conn_rcv_l2e_conn_ind (BT_HDR *p_msg);
    259 extern void sdp_conn_rcv_l2e_conn_cfm (BT_HDR *p_msg);
    260 extern void sdp_conn_rcv_l2e_disc (BT_HDR *p_msg);
    261 extern void sdp_conn_rcv_l2e_config_ind (BT_HDR *p_msg);
    262 extern void sdp_conn_rcv_l2e_config_cfm (BT_HDR *p_msg);
    263 extern void sdp_conn_rcv_l2e_conn_failed (BT_HDR *p_msg);
    264 extern void sdp_conn_rcv_l2e_connected (BT_HDR *p_msg);
    265 extern void sdp_conn_rcv_l2e_conn_failed (BT_HDR *p_msg);
    266 extern void sdp_conn_rcv_l2e_data (BT_HDR *p_msg);
    267 extern void sdp_conn_timeout (tCONN_CB *p_ccb);
    268 
    269 extern tCONN_CB *sdp_conn_originate (UINT8 *p_bd_addr);
    270 
    271 /* Functions provided by sdp_utils.c
    272 */
    273 extern tCONN_CB *sdpu_find_ccb_by_cid (UINT16 cid);
    274 extern tCONN_CB *sdpu_find_ccb_by_db (tSDP_DISCOVERY_DB *p_db);
    275 extern tCONN_CB *sdpu_allocate_ccb (void);
    276 extern void      sdpu_release_ccb (tCONN_CB *p_ccb);
    277 
    278 extern UINT8    *sdpu_build_attrib_seq (UINT8 *p_out, UINT16 *p_attr, UINT16 num_attrs);
    279 extern UINT8    *sdpu_build_attrib_entry (UINT8 *p_out, tSDP_ATTRIBUTE *p_attr);
    280 extern void      sdpu_build_n_send_error (tCONN_CB *p_ccb, UINT16 trans_num, UINT16 error_code, char *p_error_text);
    281 
    282 extern UINT8    *sdpu_extract_attr_seq (UINT8 *p, UINT16 param_len, tSDP_ATTR_SEQ *p_seq);
    283 extern UINT8    *sdpu_extract_uid_seq (UINT8 *p, UINT16 param_len, tSDP_UUID_SEQ *p_seq);
    284 
    285 extern UINT8    *sdpu_get_len_from_type (UINT8 *p, UINT8 type, UINT32 *p_len);
    286 extern BOOLEAN  sdpu_is_base_uuid (UINT8 *p_uuid);
    287 extern BOOLEAN  sdpu_compare_uuid_arrays (UINT8 *p_uuid1, UINT32 len1, UINT8 *p_uuid2, UINT16 len2);
    288 extern BOOLEAN  sdpu_compare_bt_uuids (tBT_UUID *p_uuid1, tBT_UUID *p_uuid2);
    289 extern BOOLEAN  sdpu_compare_uuid_with_attr (tBT_UUID *p_btuuid, tSDP_DISC_ATTR *p_attr);
    290 
    291 extern void     sdpu_sort_attr_list( UINT16 num_attr, tSDP_DISCOVERY_DB *p_db );
    292 extern UINT16 sdpu_get_list_len( tSDP_UUID_SEQ   *uid_seq, tSDP_ATTR_SEQ   *attr_seq );
    293 extern UINT16 sdpu_get_attrib_seq_len(tSDP_RECORD *p_rec, tSDP_ATTR_SEQ *attr_seq);
    294 extern UINT16 sdpu_get_attrib_entry_len(tSDP_ATTRIBUTE *p_attr);
    295 extern UINT8 *sdpu_build_partial_attrib_entry (UINT8 *p_out, tSDP_ATTRIBUTE *p_attr, UINT16 len, UINT16 *offset);
    296 extern void sdpu_uuid16_to_uuid128(UINT16 uuid16, UINT8* p_uuid128);
    297 
    298 /* Functions provided by sdp_db.c
    299 */
    300 extern tSDP_RECORD    *sdp_db_service_search (tSDP_RECORD *p_rec, tSDP_UUID_SEQ *p_seq);
    301 extern tSDP_RECORD    *sdp_db_find_record (UINT32 handle);
    302 extern tSDP_ATTRIBUTE *sdp_db_find_attr_in_rec (tSDP_RECORD *p_rec, UINT16 start_attr, UINT16 end_attr);
    303 
    304 
    305 /* Functions provided by sdp_server.c
    306 */
    307 #if SDP_SERVER_ENABLED == TRUE
    308 extern void     sdp_server_handle_client_req (tCONN_CB *p_ccb, BT_HDR *p_msg);
    309 #else
    310 #define sdp_server_handle_client_req(p_ccb, p_msg)
    311 #endif
    312 
    313 /* Functions provided by sdp_discovery.c
    314 */
    315 #if SDP_CLIENT_ENABLED == TRUE
    316 extern void sdp_disc_connected (tCONN_CB *p_ccb);
    317 extern void sdp_disc_server_rsp (tCONN_CB *p_ccb, BT_HDR *p_msg);
    318 #else
    319 #define sdp_disc_connected(p_ccb)
    320 #define sdp_disc_server_rsp(p_ccb, p_msg)
    321 #endif
    322 
    323 
    324 
    325 #endif
    326