1 /****************************************************************************** 2 * 3 * Copyright 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 <hardware/bt_sdp.h> 28 29 #include "bt_target.h" 30 #include "bt_types.h" 31 #include "bta_api.h" 32 #include "btm_api.h" 33 34 using bluetooth::Uuid; 35 36 /* status values */ 37 #define BTA_SDP_SUCCESS 0 /* Successful operation. */ 38 #define BTA_SDP_FAILURE 1 /* Generic failure. */ 39 #define BTA_SDP_BUSY 2 /* Temporarily can not handle this request. */ 40 41 typedef uint8_t tBTA_SDP_STATUS; 42 43 /* SDP I/F callback events */ 44 /* events received by tBTA_SDP_DM_CBACK */ 45 #define BTA_SDP_ENABLE_EVT 0 /* SDP service i/f enabled*/ 46 #define BTA_SDP_SEARCH_EVT 1 /* SDP Service started */ 47 #define BTA_SDP_SEARCH_COMP_EVT 2 /* SDP search complete */ 48 #define BTA_SDP_CREATE_RECORD_USER_EVT 3 /* SDP search complete */ 49 #define BTA_SDP_REMOVE_RECORD_USER_EVT 4 /* SDP search complete */ 50 #define BTA_SDP_MAX_EVT 5 /* max number of SDP events */ 51 52 #define BTA_SDP_MAX_RECORDS 15 53 54 typedef uint16_t tBTA_SDP_EVT; 55 56 /* data associated with BTA_SDP_DISCOVERY_COMP_EVT */ 57 typedef struct { 58 tBTA_SDP_STATUS status; 59 RawAddress remote_addr; 60 bluetooth::Uuid uuid; 61 int record_count; 62 bluetooth_sdp_record records[BTA_SDP_MAX_RECORDS]; 63 } tBTA_SDP_SEARCH_COMP; 64 65 typedef union { 66 tBTA_SDP_STATUS status; /* BTA_SDP_SEARCH_EVT */ 67 tBTA_SDP_SEARCH_COMP sdp_search_comp; /* BTA_SDP_SEARCH_COMP_EVT */ 68 } tBTA_SDP; 69 70 /* SDP DM Interface callback */ 71 typedef void(tBTA_SDP_DM_CBACK)(tBTA_SDP_EVT event, tBTA_SDP* p_data, 72 void* user_data); 73 74 /* MCE configuration structure */ 75 typedef struct { 76 uint16_t sdp_db_size; /* The size of p_sdp_db */ 77 tSDP_DISCOVERY_DB* p_sdp_db; /* The data buffer to keep SDP database */ 78 } tBTA_SDP_CFG; 79 80 /******************************************************************************* 81 * 82 * Function BTA_SdpEnable 83 * 84 * Description Enable the SDP I/F service. When the enable 85 * operation is complete the callback function will be 86 * called with a BTA_SDP_ENABLE_EVT. This function must 87 * be called before other functions in the MCE API are 88 * called. 89 * 90 * Returns BTA_SDP_SUCCESS if successful. 91 * BTA_SDP_FAIL if internal failure. 92 * 93 ******************************************************************************/ 94 extern tBTA_SDP_STATUS BTA_SdpEnable(tBTA_SDP_DM_CBACK* p_cback); 95 96 /******************************************************************************* 97 * 98 * Function BTA_SdpSearch 99 * 100 * Description Start a search for sdp records for a specific BD_ADDR with a 101 * specific profile uuid. 102 * When the search operation is completed, the callback 103 * function will be called with a BTA_SDP_SEARCH_EVT. 104 * Returns BTA_SDP_SUCCESS if successful. 105 * BTA_SDP_FAIL if internal failure. 106 * 107 ******************************************************************************/ 108 extern tBTA_SDP_STATUS BTA_SdpSearch(const RawAddress& bd_addr, 109 const bluetooth::Uuid& uuid); 110 111 /******************************************************************************* 112 * 113 * Function BTA_SdpCreateRecordByUser 114 * 115 * Description This function is used to request a callback to create a SDP 116 * record. The registered callback will be called with event 117 * BTA_SDP_CREATE_RECORD_USER_EVT. 118 * 119 * Returns BTA_SDP_SUCCESS, if the request is being processed. 120 * BTA_SDP_FAILURE, otherwise. 121 * 122 ******************************************************************************/ 123 extern tBTA_SDP_STATUS BTA_SdpCreateRecordByUser(void* user_data); 124 125 /******************************************************************************* 126 * 127 * Function BTA_SdpRemoveRecordByUser 128 * 129 * Description This function is used to request a callback to remove a SDP 130 * record. The registered callback will be called with event 131 * BTA_SDP_REMOVE_RECORD_USER_EVT. 132 * 133 * Returns BTA_SDP_SUCCESS, if the request is being processed. 134 * BTA_SDP_FAILURE, otherwise. 135 * 136 ******************************************************************************/ 137 extern tBTA_SDP_STATUS BTA_SdpRemoveRecordByUser(void* user_data); 138 139 #endif /* BTA_SDP_API_H */ 140