1 /******************************************************************************
2  *
3  *  Copyright 2014 The Android Open Source Project
4  *  Copyright 2006-2012 Broadcom Corporation
5  *
6  *  Licensed under the Apache License, Version 2.0 (the "License");
7  *  you may not use this file except in compliance with the License.
8  *  You may obtain a copy of the License at:
9  *
10  *  http://www.apache.org/licenses/LICENSE-2.0
11  *
12  *  Unless required by applicable law or agreed to in writing, software
13  *  distributed under the License is distributed on an "AS IS" BASIS,
14  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15  *  See the License for the specific language governing permissions and
16  *  limitations under the License.
17  *
18  ******************************************************************************/
19 
20 /******************************************************************************
21  *
22  *  This is the public interface file the BTA MCE I/F
23  *
24  ******************************************************************************/
25 #ifndef BTA_MCE_API_H
26 #define BTA_MCE_API_H
27 
28 #include "bt_target.h"
29 #include "bt_types.h"
30 #include "bta_api.h"
31 #include "btm_api.h"
32 
33 /*****************************************************************************
34  *  Constants and data types
35  ****************************************************************************/
36 /* status values */
37 #define BTA_MCE_SUCCESS 0 /* Successful operation. */
38 #define BTA_MCE_FAILURE 1 /* Generic failure. */
39 #define BTA_MCE_BUSY 2    /* Temporarily can not handle this request. */
40 
41 typedef uint8_t tBTA_MCE_STATUS;
42 
43 /* MCE I/F callback events */
44 /* events received by tBTA_MCE_DM_CBACK */
45 #define BTA_MCE_ENABLE_EVT 0             /* MCE enabled */
46 #define BTA_MCE_MAS_DISCOVERY_COMP_EVT 1 /* SDP MAS discovery complete */
47 #define BTA_MCE_MAX_EVT 2                /* max number of MCE events */
48 
49 #define BTA_MCE_MAX_MAS_INSTANCES 12
50 
51 typedef uint16_t tBTA_MCE_EVT;
52 
53 typedef struct {
54   uint8_t scn;
55   char* p_srv_name;
56   uint16_t srv_name_len;
57   uint8_t instance_id;
58   uint8_t msg_type;
59 } tBTA_MCE_MAS_INFO;
60 
61 /* data associated with BTA_MCE_MAS_DISCOVERY_COMP_EVT */
62 typedef struct {
63   tBTA_MCE_STATUS status;
64   RawAddress remote_addr;
65   int num_mas;
66   tBTA_MCE_MAS_INFO mas[BTA_MCE_MAX_MAS_INSTANCES];
67 } tBTA_MCE_MAS_DISCOVERY_COMP;
68 
69 /* union of data associated with MCE callback */
70 typedef union {
71   tBTA_MCE_STATUS status; /* BTA_MCE_ENABLE_EVT */
72   tBTA_MCE_MAS_DISCOVERY_COMP
73       mas_disc_comp; /* BTA_MCE_MAS_DISCOVERY_COMP_EVT */
74 } tBTA_MCE;
75 
76 /* MCE DM Interface callback */
77 typedef void(tBTA_MCE_DM_CBACK)(tBTA_MCE_EVT event, tBTA_MCE* p_data,
78                                 void* user_data);
79 
80 /* MCE configuration structure */
81 typedef struct {
82   uint16_t sdp_db_size;        /* The size of p_sdp_db */
83   tSDP_DISCOVERY_DB* p_sdp_db; /* The data buffer to keep SDP database */
84 } tBTA_MCE_CFG;
85 
86 /*****************************************************************************
87  *  External Function Declarations
88  ****************************************************************************/
89 
90 /*******************************************************************************
91  *
92  * Function         BTA_MceEnable
93  *
94  * Description      Enable the MCE I/F service. When the enable
95  *                  operation is complete the callback function will be
96  *                  called with a BTA_MCE_ENABLE_EVT. This function must
97  *                  be called before other functions in the MCE API are
98  *                  called.
99  *
100  * Returns          BTA_MCE_SUCCESS if successful.
101  *                  BTA_MCE_FAIL if internal failure.
102  *
103  ******************************************************************************/
104 extern tBTA_MCE_STATUS BTA_MceEnable(tBTA_MCE_DM_CBACK* p_cback);
105 
106 /*******************************************************************************
107  *
108  * Function         BTA_MceGetRemoteMasInstances
109  *
110  * Description      This function performs service discovery for the MAS service
111  *                  by the given peer device. When the operation is completed
112  *                  the tBTA_MCE_DM_CBACK callback function will be  called with
113  *                  a BTA_MCE_MAS_DISCOVERY_COMP_EVT.
114  *
115  * Returns          BTA_MCE_SUCCESS, if the request is being processed.
116  *                  BTA_MCE_FAILURE, otherwise.
117  *
118  ******************************************************************************/
119 extern tBTA_MCE_STATUS BTA_MceGetRemoteMasInstances(const RawAddress& bd_addr);
120 
121 #endif /* BTA_MCE_API_H */
122