1 /******************************************************************************
2  *
3  *  Copyright (C) 2014 The Android Open Source Project
4  *  Copyright (C) 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 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 tBTA_MCE_EVT;
52 
53 typedef struct
54 {
55     UINT8   scn;
56     char    *p_srv_name;
57     UINT16  srv_name_len;
58     UINT8   instance_id;
59     UINT8   msg_type;
60 } tBTA_MCE_MAS_INFO;
61 
62 /* data associated with BTA_MCE_MAS_DISCOVERY_COMP_EVT */
63 typedef struct
64 {
65     tBTA_MCE_STATUS    status;
66     BD_ADDR            remote_addr;
67     int                num_mas;
68     tBTA_MCE_MAS_INFO  mas[BTA_MCE_MAX_MAS_INSTANCES];
69 } tBTA_MCE_MAS_DISCOVERY_COMP;
70 
71 /* union of data associated with MCE callback */
72 typedef union
73 {
74     tBTA_MCE_STATUS              status;         /* BTA_MCE_ENABLE_EVT */
75     tBTA_MCE_MAS_DISCOVERY_COMP  mas_disc_comp;  /* BTA_MCE_MAS_DISCOVERY_COMP_EVT */
76 } tBTA_MCE;
77 
78 /* MCE DM Interface callback */
79 typedef void (tBTA_MCE_DM_CBACK)(tBTA_MCE_EVT event, tBTA_MCE *p_data, void * user_data);
80 
81 /* MCE configuration structure */
82 typedef struct
83 {
84     UINT16  sdp_db_size;            /* The size of p_sdp_db */
85     tSDP_DISCOVERY_DB   *p_sdp_db;  /* The data buffer to keep SDP database */
86 } tBTA_MCE_CFG;
87 
88 /*****************************************************************************
89 **  External Function Declarations
90 *****************************************************************************/
91 #ifdef __cplusplus
92 extern "C"
93 {
94 #endif
95 
96 /*******************************************************************************
97 **
98 ** Function         BTA_MceEnable
99 **
100 ** Description      Enable the MCE I/F service. When the enable
101 **                  operation is complete the callback function will be
102 **                  called with a BTA_MCE_ENABLE_EVT. This function must
103 **                  be called before other functions in the MCE API are
104 **                  called.
105 **
106 ** Returns          BTA_MCE_SUCCESS if successful.
107 **                  BTA_MCE_FAIL if internal failure.
108 **
109 *******************************************************************************/
110 extern tBTA_MCE_STATUS BTA_MceEnable(tBTA_MCE_DM_CBACK *p_cback);
111 
112 /*******************************************************************************
113 **
114 ** Function         BTA_MceGetRemoteMasInstances
115 **
116 ** Description      This function performs service discovery for the MAS service
117 **                  by the given peer device. When the operation is completed
118 **                  the tBTA_MCE_DM_CBACK callback function will be  called with
119 **                  a BTA_MCE_MAS_DISCOVERY_COMP_EVT.
120 **
121 ** Returns          BTA_MCE_SUCCESS, if the request is being processed.
122 **                  BTA_MCE_FAILURE, otherwise.
123 **
124 *******************************************************************************/
125 extern tBTA_MCE_STATUS BTA_MceGetRemoteMasInstances(BD_ADDR bd_addr);
126 
127 #ifdef __cplusplus
128 }
129 #endif
130 
131 #endif /* BTA_MCE_API_H */
132