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
39typedef 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
52typedef uint16_t tBTA_SDP_EVT;
53
54/* data associated with BTA_SDP_DISCOVERY_COMP_EVT */
55typedef 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
63typedef 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 */
69typedef void(tBTA_SDP_DM_CBACK)(tBTA_SDP_EVT event, tBTA_SDP* p_data,
70                                void* user_data);
71
72/* MCE configuration structure */
73typedef 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 ******************************************************************************/
92extern 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 ******************************************************************************/
106extern 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 ******************************************************************************/
120extern 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 ******************************************************************************/
134extern tBTA_SDP_STATUS BTA_SdpRemoveRecordByUser(void* user_data);
135
136#endif /* BTA_SDP_API_H */
137