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 <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 /* 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_t 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_t 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,
70                                 void* user_data);
71 
72 /* MCE configuration structure */
73 typedef struct {
74   uint16_t sdp_db_size;        /* The size of p_sdp_db */
75   tSDP_DISCOVERY_DB* p_sdp_db; /* The data buffer to keep SDP database */
76 } tBTA_SDP_CFG;
77 
78 /*******************************************************************************
79  *
80  * Function         BTA_SdpEnable
81  *
82  * Description      Enable the SDP I/F service. When the enable
83  *                  operation is complete the callback function will be
84  *                  called with a BTA_SDP_ENABLE_EVT. This function must
85  *                  be called before other functions in the MCE API are
86  *                  called.
87  *
88  * Returns          BTA_SDP_SUCCESS if successful.
89  *                  BTA_SDP_FAIL if internal failure.
90  *
91  ******************************************************************************/
92 extern tBTA_SDP_STATUS BTA_SdpEnable(tBTA_SDP_DM_CBACK* p_cback);
93 
94 /*******************************************************************************
95  *
96  * Function         BTA_SdpSearch
97  *
98  * Description      Start a search for sdp records for a specific BD_ADDR with a
99  *                  specific profile uuid.
100  *                  When the search operation is completed, the callback
101  *                  function will be called with a BTA_SDP_SEARCH_EVT.
102  * Returns          BTA_SDP_SUCCESS if successful.
103  *                  BTA_SDP_FAIL if internal failure.
104  *
105  ******************************************************************************/
106 extern tBTA_SDP_STATUS BTA_SdpSearch(BD_ADDR bd_addr, tSDP_UUID* uuid);
107 
108 /*******************************************************************************
109  *
110  * Function         BTA_SdpCreateRecordByUser
111  *
112  * Description      This function is used to request a callback to create a SDP
113  *                  record. The registered callback will be called with event
114  *                  BTA_SDP_CREATE_RECORD_USER_EVT.
115  *
116  * Returns          BTA_SDP_SUCCESS, if the request is being processed.
117  *                  BTA_SDP_FAILURE, otherwise.
118  *
119  ******************************************************************************/
120 extern tBTA_SDP_STATUS BTA_SdpCreateRecordByUser(void* user_data);
121 
122 /*******************************************************************************
123  *
124  * Function         BTA_SdpRemoveRecordByUser
125  *
126  * Description      This function is used to request a callback to remove a SDP
127  *                  record. The registered callback will be called with event
128  *                  BTA_SDP_REMOVE_RECORD_USER_EVT.
129  *
130  * Returns          BTA_SDP_SUCCESS, if the request is being processed.
131  *                  BTA_SDP_FAILURE, otherwise.
132  *
133  ******************************************************************************/
134 extern tBTA_SDP_STATUS BTA_SdpRemoveRecordByUser(void* user_data);
135 
136 #endif /* BTA_SDP_API_H */
137