summaryrefslogtreecommitdiff
path: root/android/hardware/bt_hl.h
blob: d26c054a7b460ab5457320469a4c42e78d34cc54 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
/* SPDX-License-Identifier: Apache-2.0 */
/*
 * Copyright (C) 2012 The Android Open Source Project
 *
 */

#ifndef ANDROID_INCLUDE_BT_HL_H
#define ANDROID_INCLUDE_BT_HL_H

__BEGIN_DECLS

/* HL connection states */

typedef enum
{
    BTHL_MDEP_ROLE_SOURCE,
    BTHL_MDEP_ROLE_SINK
} bthl_mdep_role_t;

typedef enum {
    BTHL_APP_REG_STATE_REG_SUCCESS,
    BTHL_APP_REG_STATE_REG_FAILED,
    BTHL_APP_REG_STATE_DEREG_SUCCESS,
    BTHL_APP_REG_STATE_DEREG_FAILED
} bthl_app_reg_state_t;

typedef enum
{
    BTHL_CHANNEL_TYPE_RELIABLE,
    BTHL_CHANNEL_TYPE_STREAMING,
    BTHL_CHANNEL_TYPE_ANY
} bthl_channel_type_t;


/* HL connection states */
typedef enum {
    BTHL_CONN_STATE_CONNECTING,
    BTHL_CONN_STATE_CONNECTED,
    BTHL_CONN_STATE_DISCONNECTING,
    BTHL_CONN_STATE_DISCONNECTED,
    BTHL_CONN_STATE_DESTROYED
} bthl_channel_state_t;

typedef struct
{
    bthl_mdep_role_t        mdep_role;
    int                     data_type;
    bthl_channel_type_t     channel_type;
    const char                   *mdep_description; /* MDEP description to be used in the SDP (optional); null terminated */
} bthl_mdep_cfg_t;

typedef struct
{
    const char      *application_name;
    const char      *provider_name;   /* provider name to be used in the SDP (optional); null terminated */
    const char      *srv_name;        /* service name to be used in the SDP (optional); null terminated*/
    const char      *srv_desp;        /* service description to be used in the SDP (optional); null terminated */
    int             number_of_mdeps;
    bthl_mdep_cfg_t *mdep_cfg;  /* Dynamic array */
} bthl_reg_param_t;

/** Callback for application registration status.
 *  state will have one of the values from  bthl_app_reg_state_t
 */
typedef void (* bthl_app_reg_state_callback)(int app_id, bthl_app_reg_state_t state);

/** Callback for channel connection state change.
 *  state will have one of the values from
 *  bthl_connection_state_t and fd (file descriptor)
 */
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);

/** BT-HL callback structure. */
typedef struct {
    /** set to sizeof(bthl_callbacks_t) */
    size_t      size;
    bthl_app_reg_state_callback     app_reg_state_cb;
    bthl_channel_state_callback     channel_state_cb;
} bthl_callbacks_t;


/** Represents the standard BT-HL interface. */
typedef struct {

    /** set to sizeof(bthl_interface_t)  */
    size_t          size;

    /**
     * Register the Bthl callbacks
     */
    bt_status_t (*init)( bthl_callbacks_t* callbacks );

    /** Register HL application */
    bt_status_t (*register_application) ( bthl_reg_param_t *p_reg_param, int *app_id);

    /** Unregister HL application */
    bt_status_t (*unregister_application) (int app_id);

    /** connect channel */
    bt_status_t (*connect_channel)(int app_id, bt_bdaddr_t *bd_addr, int mdep_cfg_index, int *channel_id);

    /** destroy channel */
    bt_status_t (*destroy_channel)(int channel_id);

    /** Close the  Bthl callback **/
    void (*cleanup)(void);

} bthl_interface_t;
__END_DECLS

#endif /* ANDROID_INCLUDE_BT_HL_H */