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