1 /* 2 * Copyright (C) 2012 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef ANDROID_INCLUDE_BT_HL_H 18 #define ANDROID_INCLUDE_BT_HL_H 19 20 __BEGIN_DECLS 21 22 /* HL connection states */ 23 24 typedef enum 25 { 26 BTHL_MDEP_ROLE_SOURCE, 27 BTHL_MDEP_ROLE_SINK 28 } bthl_mdep_role_t; 29 30 typedef enum { 31 BTHL_APP_REG_STATE_REG_SUCCESS, 32 BTHL_APP_REG_STATE_REG_FAILED, 33 BTHL_APP_REG_STATE_DEREG_SUCCESS, 34 BTHL_APP_REG_STATE_DEREG_FAILED 35 } bthl_app_reg_state_t; 36 37 typedef enum 38 { 39 BTHL_CHANNEL_TYPE_RELIABLE, 40 BTHL_CHANNEL_TYPE_STREAMING, 41 BTHL_CHANNEL_TYPE_ANY 42 } bthl_channel_type_t; 43 44 45 /* HL connection states */ 46 typedef enum { 47 BTHL_CONN_STATE_CONNECTING, 48 BTHL_CONN_STATE_CONNECTED, 49 BTHL_CONN_STATE_DISCONNECTING, 50 BTHL_CONN_STATE_DISCONNECTED, 51 BTHL_CONN_STATE_DESTROYED 52 } bthl_channel_state_t; 53 54 typedef struct 55 { 56 bthl_mdep_role_t mdep_role; 57 int data_type; 58 bthl_channel_type_t channel_type; 59 const char *mdep_description; /* MDEP description to be used in the SDP (optional); null terminated */ 60 } bthl_mdep_cfg_t; 61 62 typedef struct 63 { 64 const char *application_name; 65 const char *provider_name; /* provider name to be used in the SDP (optional); null terminated */ 66 const char *srv_name; /* service name to be used in the SDP (optional); null terminated*/ 67 const char *srv_desp; /* service description to be used in the SDP (optional); null terminated */ 68 int number_of_mdeps; 69 bthl_mdep_cfg_t *mdep_cfg; /* Dynamic array */ 70 } bthl_reg_param_t; 71 72 /** Callback for application registration status. 73 * state will have one of the values from bthl_app_reg_state_t 74 */ 75 typedef void (* bthl_app_reg_state_callback)(int app_id, bthl_app_reg_state_t state); 76 77 /** Callback for channel connection state change. 78 * state will have one of the values from 79 * bthl_connection_state_t and fd (file descriptor) 80 */ 81 typedef void (* bthl_channel_state_callback)(int app_id, bt_bdaddr_t *bd_addr, int mdep_cfg_index, int channel_id, bthl_channel_state_t state, int fd); 82 83 /** BT-HL callback structure. */ 84 typedef struct { 85 /** set to sizeof(bthl_callbacks_t) */ 86 size_t size; 87 bthl_app_reg_state_callback app_reg_state_cb; 88 bthl_channel_state_callback channel_state_cb; 89 } bthl_callbacks_t; 90 91 92 /** Represents the standard BT-HL interface. */ 93 typedef struct { 94 95 /** set to sizeof(bthl_interface_t) */ 96 size_t size; 97 98 /** 99 * Register the Bthl callbacks 100 */ 101 bt_status_t (*init)( bthl_callbacks_t* callbacks ); 102 103 /** Register HL application */ 104 bt_status_t (*register_application) ( bthl_reg_param_t *p_reg_param, int *app_id); 105 106 /** Unregister HL application */ 107 bt_status_t (*unregister_application) (int app_id); 108 109 /** connect channel */ 110 bt_status_t (*connect_channel)(int app_id, bt_bdaddr_t *bd_addr, int mdep_cfg_index, int *channel_id); 111 112 /** destroy channel */ 113 bt_status_t (*destroy_channel)(int channel_id); 114 115 /** Close the Bthl callback **/ 116 void (*cleanup)(void); 117 118 } bthl_interface_t; 119 __END_DECLS 120 121 #endif /* ANDROID_INCLUDE_BT_HL_H */ 122 123 124