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 i/f enabled*/ 44 #define BTA_SDP_SEARCH_EVT 1 /* SDP Service started */ 45 #define BTA_SDP_SEARCH_COMP_EVT 2 /* SDP search complete */ 46 #define BTA_SDP_CREATE_RECORD_USER_EVT 3 /* SDP search complete */ 47 #define BTA_SDP_REMOVE_RECORD_USER_EVT 4 /* SDP search complete */ 48 #define BTA_SDP_MAX_EVT 5 /* max number of SDP events */ 49 50 #define BTA_SDP_MAX_RECORDS 15 51 52 typedef UINT16 tBTA_SDP_EVT; 53 54 /* data associated with BTA_SDP_DISCOVERY_COMP_EVT */ 55 typedef struct { 56 tBTA_SDP_STATUS status; 57 BD_ADDR remote_addr; 58 tBT_UUID uuid; 59 int record_count; 60 bluetooth_sdp_record records[BTA_SDP_MAX_RECORDS]; 61 } tBTA_SDP_SEARCH_COMP; 62 63 typedef union { 64 tBTA_SDP_STATUS status; /* BTA_SDP_SEARCH_EVT */ 65 tBTA_SDP_SEARCH_COMP sdp_search_comp; /* BTA_SDP_SEARCH_COMP_EVT */ 66 } tBTA_SDP; 67 68 /* SDP DM Interface callback */ 69 typedef void (tBTA_SDP_DM_CBACK)(tBTA_SDP_EVT event, tBTA_SDP *p_data, void *user_data); 70 71 /* MCE configuration structure */ 72 typedef struct { 73 UINT16 sdp_db_size; /* The size of p_sdp_db */ 74 #if (SDP_INCLUDED == TRUE) 75 tSDP_DISCOVERY_DB *p_sdp_db; /* The data buffer to keep SDP database */ 76 #endif ///SDP_INCLUDED == TRUE 77 } tBTA_SDP_CFG; 78 79 #ifdef __cplusplus 80 extern "C" 81 { 82 #endif 83 /******************************************************************************* 84 ** 85 ** Function BTA_SdpEnable 86 ** 87 ** Description Enable the SDP I/F service. When the enable 88 ** operation is complete the callback function will be 89 ** called with a BTA_SDP_ENABLE_EVT. This function must 90 ** be called before other functions in the MCE API are 91 ** called. 92 ** 93 ** Returns BTA_SDP_SUCCESS if successful. 94 ** BTA_SDP_FAIL if internal failure. 95 ** 96 *******************************************************************************/ 97 extern tBTA_SDP_STATUS BTA_SdpEnable(tBTA_SDP_DM_CBACK *p_cback); 98 99 /******************************************************************************* 100 ** 101 ** Function BTA_SdpDisable 102 ** 103 ** Description Disable the SDP search I/F service. 104 ** Free buffer for SDP configuration structure. 105 ** 106 ** Returns BTA_SDP_SUCCESS if successful. 107 ** BTA_SDP_FAIL if internal failure. 108 ** 109 *******************************************************************************/ 110 extern tBTA_SDP_STATUS BTA_SdpDisable(void); 111 112 /******************************************************************************* 113 ** 114 ** Function BTA_SdpSearch 115 ** 116 ** Description Start a search for sdp records for a specific BD_ADDR with a 117 ** specific profile uuid. 118 ** When the search operation is completed, the callback function 119 ** will be called with a BTA_SDP_SEARCH_EVT. 120 ** Returns BTA_SDP_SUCCESS if successful. 121 ** BTA_SDP_FAIL if internal failure. 122 ** 123 *******************************************************************************/ 124 extern tBTA_SDP_STATUS BTA_SdpSearch(BD_ADDR bd_addr, tSDP_UUID *uuid); 125 126 /******************************************************************************* 127 ** 128 ** Function BTA_SdpCreateRecordByUser 129 ** 130 ** Description This function is used to request a callback to create a SDP 131 ** record. The registered callback will be called with event 132 ** BTA_SDP_CREATE_RECORD_USER_EVT. 133 ** 134 ** Returns BTA_SDP_SUCCESS, if the request is being processed. 135 ** BTA_SDP_FAILURE, otherwise. 136 ** 137 *******************************************************************************/ 138 extern tBTA_SDP_STATUS BTA_SdpCreateRecordByUser(void *user_data); 139 140 /******************************************************************************* 141 ** 142 ** Function BTA_SdpRemoveRecordByUser 143 ** 144 ** Description This function is used to request a callback to remove a SDP 145 ** record. The registered callback will be called with event 146 ** BTA_SDP_REMOVE_RECORD_USER_EVT. 147 ** 148 ** Returns BTA_SDP_SUCCESS, if the request is being processed. 149 ** BTA_SDP_FAILURE, otherwise. 150 ** 151 *******************************************************************************/ 152 extern tBTA_SDP_STATUS BTA_SdpRemoveRecordByUser(void *user_data); 153 154 #ifdef __cplusplus 155 } 156 #endif 157 158 #endif ///SDP_INCLUDED == TRUE 159 160 #endif /* BTA_SDP_API_H */ 161
