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