1 /****************************************************************************** 2 * 3 * Copyright (C) 2015 The Android Open Source Project 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 BTA SDP I/F 22 * 23 ******************************************************************************/ 24 #ifndef BTA_SDP_API_H 25 #define BTA_SDP_API_H 26 27 #include "bt_sdp.h" 28 #include "common/bt_target.h" 29 #include "stack/bt_types.h" 30 #include "bta/bta_api.h" 31 #include "stack/btm_api.h" 32 33 #if (SDP_INCLUDED == TRUE) 34 /* status values */ 35 #define BTA_SDP_SUCCESS 0 /* Successful operation. */ 36 #define BTA_SDP_FAILURE 1 /* Generic failure. */ 37 #define BTA_SDP_BUSY 2 /* Temporarily can not handle this request. */ 38 39 typedef UINT8 tBTA_SDP_STATUS; 40 41 /* SDP I/F callback events */ 42 /* events received by tBTA_SDP_DM_CBACK */ 43 #define BTA_SDP_ENABLE_EVT 0 /* SDP service enabled */ 44 #define BTA_SDP_DISENABLE_EVT 1 /* SDP service disenabled */ 45 #define BTA_SDP_SEARCH_EVT 2 /* SDP search started */ 46 #define BTA_SDP_SEARCH_COMP_EVT 3 /* SDP search complete */ 47 #define BTA_SDP_CREATE_RECORD_USER_EVT 4 /* SDP create record complete */ 48 #define BTA_SDP_REMOVE_RECORD_USER_EVT 5 /* SDP remove record complete */ 49 #define BTA_SDP_MAX_EVT 6 /* max number of SDP events */ 50 51 #define BTA_SDP_MAX_RECORDS 15 52 53 typedef UINT16 tBTA_SDP_EVT; 54 55 /* data associated with BTA_SDP_DISCOVERY_COMP_EVT */ 56 typedef struct { 57 tBTA_SDP_STATUS status; 58 BD_ADDR remote_addr; 59 tBT_UUID uuid; 60 int record_count; 61 bluetooth_sdp_record records[BTA_SDP_MAX_RECORDS]; 62 } tBTA_SDP_SEARCH_COMP; 63 64 /* data associated with BTA_SDP_CREATE_RECORD_USER_EVT */ 65 typedef struct { 66 tBTA_SDP_STATUS status; 67 int handle; 68 } tBTA_SDP_CREATE_RECORD_USER; 69 70 typedef union { 71 tBTA_SDP_STATUS status; /* BTA_SDP_SEARCH_EVT */ 72 tBTA_SDP_SEARCH_COMP sdp_search_comp; /* BTA_SDP_SEARCH_COMP_EVT */ 73 tBTA_SDP_CREATE_RECORD_USER sdp_create_record; /* BTA_SDP_CREATE_RECORD_USER_EVT */ 74 } tBTA_SDP; 75 76 /* SDP DM Interface callback */ 77 typedef void (tBTA_SDP_DM_CBACK)(tBTA_SDP_EVT event, tBTA_SDP *p_data, void *user_data); 78 79 /* MCE configuration structure */ 80 typedef struct { 81 UINT16 sdp_db_size; /* The size of p_sdp_db */ 82 #if (SDP_INCLUDED == TRUE) 83 tSDP_DISCOVERY_DB *p_sdp_db; /* The data buffer to keep SDP database */ 84 #endif ///SDP_INCLUDED == TRUE 85 } tBTA_SDP_CFG; 86 87 #ifdef __cplusplus 88 extern "C" 89 { 90 #endif 91 /******************************************************************************* 92 ** 93 ** Function BTA_SdpEnable 94 ** 95 ** Description Enable the SDP I/F service. When the enable 96 ** operation is complete the callback function will be 97 ** called with a BTA_SDP_ENABLE_EVT. This function must 98 ** be called before other functions in the MCE API are 99 ** called. 100 ** 101 ** Returns BTA_SDP_SUCCESS if successful. 102 ** BTA_SDP_FAIL if internal failure. 103 ** 104 *******************************************************************************/ 105 extern tBTA_SDP_STATUS BTA_SdpEnable(tBTA_SDP_DM_CBACK *p_cback); 106 107 /******************************************************************************* 108 ** 109 ** Function BTA_SdpDisable 110 ** 111 ** Description Disable the SDP search I/F service. 112 ** Free buffer for SDP configuration structure. 113 ** 114 ** Returns BTA_SDP_SUCCESS if successful. 115 ** BTA_SDP_FAIL if internal failure. 116 ** 117 *******************************************************************************/ 118 extern tBTA_SDP_STATUS BTA_SdpDisable(void); 119 120 /******************************************************************************* 121 ** 122 ** Function BTA_SdpSearch 123 ** 124 ** Description Start a search for sdp records for a specific BD_ADDR with a 125 ** specific profile uuid. 126 ** When the search operation is completed, the callback function 127 ** will be called with a BTA_SDP_SEARCH_EVT. 128 ** Returns BTA_SDP_SUCCESS if successful. 129 ** BTA_SDP_FAIL if internal failure. 130 ** 131 *******************************************************************************/ 132 extern tBTA_SDP_STATUS BTA_SdpSearch(BD_ADDR bd_addr, tSDP_UUID *uuid); 133 134 /******************************************************************************* 135 ** 136 ** Function BTA_SdpCreateRecordByUser 137 ** 138 ** Description This function is used to request a callback to create a SDP 139 ** record. The registered callback will be called with event 140 ** BTA_SDP_CREATE_RECORD_USER_EVT. 141 ** 142 ** Returns BTA_SDP_SUCCESS, if the request is being processed. 143 ** BTA_SDP_FAILURE, otherwise. 144 ** 145 *******************************************************************************/ 146 extern tBTA_SDP_STATUS BTA_SdpCreateRecordByUser(void *user_data); 147 148 /******************************************************************************* 149 ** 150 ** Function BTA_SdpRemoveRecordByUser 151 ** 152 ** Description This function is used to request a callback to remove a SDP 153 ** record. The registered callback will be called with event 154 ** BTA_SDP_REMOVE_RECORD_USER_EVT. 155 ** 156 ** Returns BTA_SDP_SUCCESS, if the request is being processed. 157 ** BTA_SDP_FAILURE, otherwise. 158 ** 159 *******************************************************************************/ 160 extern tBTA_SDP_STATUS BTA_SdpRemoveRecordByUser(void *user_data); 161 162 #ifdef __cplusplus 163 } 164 #endif 165 166 #endif ///SDP_INCLUDED == TRUE 167 168 #endif /* BTA_SDP_API_H */ 169
