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
24typedef enum
25{
26    BTHL_MDEP_ROLE_SOURCE,
27    BTHL_MDEP_ROLE_SINK
28} bthl_mdep_role_t;
29
30typedef 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
37typedef 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 */
46typedef 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
54typedef 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
62typedef 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 */
75typedef 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 */
81typedef 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. */
84typedef 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. */
93typedef 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