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