code.delx.au - pulseaudio/blob - src/modules/bluetooth/bluez4-util.h

   1 #ifndef foobluez4utilhfoo
   2 #define foobluez4utilhfoo
   3
   4 /***
   5   This file is part of PulseAudio.
   6
   7   Copyright 2008-2013 João Paulo Rechi Vita
   8
   9   PulseAudio is free software; you can redistribute it and/or modify
  10   it under the terms of the GNU Lesser General Public License as
  11   published by the Free Software Foundation; either version 2.1 of the
  12   License, or (at your option) any later version.
  13
  14   PulseAudio is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   General Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public
  20   License along with PulseAudio; if not, write to the Free Software
  21   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  22   USA.
  23 ***/
  24
  25 #include <dbus/dbus.h>
  26
  27 #include <pulsecore/llist.h>
  28 #include <pulsecore/macro.h>
  29
  30 #define PA_BLUEZ4_ERROR_NOT_SUPPORTED "org.bluez.Error.NotSupported"
  31
  32 /* UUID copied from bluez/audio/device.h */
  33 #define GENERIC_AUDIO_UUID      "00001203-0000-1000-8000-00805f9b34fb"
  34
  35 #define HSP_HS_UUID             "00001108-0000-1000-8000-00805f9b34fb"
  36 #define HSP_AG_UUID             "00001112-0000-1000-8000-00805f9b34fb"
  37
  38 #define HFP_HS_UUID             "0000111e-0000-1000-8000-00805f9b34fb"
  39 #define HFP_AG_UUID             "0000111f-0000-1000-8000-00805f9b34fb"
  40
  41 #define ADVANCED_AUDIO_UUID     "0000110d-0000-1000-8000-00805f9b34fb"
  42
  43 #define A2DP_SOURCE_UUID        "0000110a-0000-1000-8000-00805f9b34fb"
  44 #define A2DP_SINK_UUID          "0000110b-0000-1000-8000-00805f9b34fb"
  45
  46 #define HSP_MAX_GAIN 15
  47
  48 typedef struct pa_bluez4_uuid pa_bluez4_uuid;
  49 typedef struct pa_bluez4_device pa_bluez4_device;
  50 typedef struct pa_bluez4_discovery pa_bluez4_discovery;
  51 typedef struct pa_bluez4_transport pa_bluez4_transport;
  52
  53 struct userdata;
  54
  55 struct pa_bluez4_uuid {
  56     char *uuid;
  57     PA_LLIST_FIELDS(pa_bluez4_uuid);
  58 };
  59
  60 typedef enum pa_bluez4_profile {
  61     PA_BLUEZ4_PROFILE_A2DP,
  62     PA_BLUEZ4_PROFILE_A2DP_SOURCE,
  63     PA_BLUEZ4_PROFILE_HSP,
  64     PA_BLUEZ4_PROFILE_HFGW,
  65     PA_BLUEZ4_PROFILE_OFF
  66 } pa_bluez4_profile_t;
  67
  68 #define PA_BLUEZ4_PROFILE_COUNT PA_BLUEZ4_PROFILE_OFF
  69
  70 struct pa_bluez4_hook_uuid_data {
  71     pa_bluez4_device *device;
  72     const char *uuid;
  73 };
  74
  75 /* Hook data: pa_bluez4_discovery pointer. */
  76 typedef enum pa_bluez4_hook {
  77     PA_BLUEZ4_HOOK_DEVICE_CONNECTION_CHANGED, /* Call data: pa_bluez4_device */
  78     PA_BLUEZ4_HOOK_DEVICE_UUID_ADDED, /* Call data: pa_bluez4_hook_uuid_data */
  79     PA_BLUEZ4_HOOK_TRANSPORT_STATE_CHANGED, /* Call data: pa_bluez4_transport */
  80     PA_BLUEZ4_HOOK_TRANSPORT_NREC_CHANGED, /* Call data: pa_bluez4_transport */
  81     PA_BLUEZ4_HOOK_TRANSPORT_MICROPHONE_GAIN_CHANGED, /* Call data: pa_bluez4_transport */
  82     PA_BLUEZ4_HOOK_TRANSPORT_SPEAKER_GAIN_CHANGED, /* Call data: pa_bluez4_transport */
  83     PA_BLUEZ4_HOOK_MAX
  84 } pa_bluez4_hook_t;
  85
  86 typedef enum pa_bluez4_transport_state {
  87     PA_BLUEZ4_TRANSPORT_STATE_DISCONNECTED,
  88     PA_BLUEZ4_TRANSPORT_STATE_IDLE, /* Connected but not playing */
  89     PA_BLUEZ4_TRANSPORT_STATE_PLAYING
  90 } pa_bluez4_transport_state_t;
  91
  92 struct pa_bluez4_transport {
  93     pa_bluez4_device *device;
  94     char *owner;
  95     char *path;
  96     pa_bluez4_profile_t profile;
  97     uint8_t codec;
  98     uint8_t *config;
  99     int config_size;
 100
 101     pa_bluez4_transport_state_t state;
 102     bool nrec;
 103     uint16_t microphone_gain; /* Used for HSP/HFP */
 104     uint16_t speaker_gain; /* Used for HSP/HFP */
 105 };
 106
 107 /* This enum is shared among Audio, Headset, AudioSink, and AudioSource, although not all values are acceptable in all profiles */
 108 typedef enum pa_bluez4_audio_state {
 109     PA_BLUEZ4_AUDIO_STATE_INVALID = -1,
 110     PA_BLUEZ4_AUDIO_STATE_DISCONNECTED,
 111     PA_BLUEZ4_AUDIO_STATE_CONNECTING,
 112     PA_BLUEZ4_AUDIO_STATE_CONNECTED,
 113     PA_BLUEZ4_AUDIO_STATE_PLAYING
 114 } pa_bluez4_audio_state_t;
 115
 116 struct pa_bluez4_device {
 117     pa_bluez4_discovery *discovery;
 118     bool dead;
 119
 120     int device_info_valid;      /* 0: no results yet; 1: good results; -1: bad results ... */
 121
 122     /* Device information */
 123     char *name;
 124     char *path;
 125     pa_bluez4_transport *transports[PA_BLUEZ4_PROFILE_COUNT];
 126     int paired;
 127     char *alias;
 128     PA_LLIST_HEAD(pa_bluez4_uuid, uuids);
 129     char *address;
 130     int class;
 131     int trusted;
 132
 133     /* Audio state */
 134     pa_bluez4_audio_state_t audio_state;
 135
 136     /* AudioSink, AudioSource, Headset and HandsfreeGateway states */
 137     pa_bluez4_audio_state_t profile_state[PA_BLUEZ4_PROFILE_COUNT];
 138 };
 139
 140 pa_bluez4_discovery* pa_bluez4_discovery_get(pa_core *core);
 141 pa_bluez4_discovery* pa_bluez4_discovery_ref(pa_bluez4_discovery *y);
 142 void pa_bluez4_discovery_unref(pa_bluez4_discovery *d);
 143
 144 pa_bluez4_device* pa_bluez4_discovery_get_by_path(pa_bluez4_discovery *d, const char* path);
 145 pa_bluez4_device* pa_bluez4_discovery_get_by_address(pa_bluez4_discovery *d, const char* address);
 146
 147 bool pa_bluez4_device_any_audio_connected(const pa_bluez4_device *d);
 148
 149 int pa_bluez4_transport_acquire(pa_bluez4_transport *t, bool optional, size_t *imtu, size_t *omtu);
 150 void pa_bluez4_transport_release(pa_bluez4_transport *t);
 151
 152 void pa_bluez4_transport_set_microphone_gain(pa_bluez4_transport *t, uint16_t value);
 153 void pa_bluez4_transport_set_speaker_gain(pa_bluez4_transport *t, uint16_t value);
 154
 155 pa_hook* pa_bluez4_discovery_hook(pa_bluez4_discovery *y, pa_bluez4_hook_t hook);
 156
 157 typedef enum pa_bluez4_form_factor {
 158     PA_BLUEZ4_FORM_FACTOR_UNKNOWN,
 159     PA_BLUEZ4_FORM_FACTOR_HEADSET,
 160     PA_BLUEZ4_FORM_FACTOR_HANDSFREE,
 161     PA_BLUEZ4_FORM_FACTOR_MICROPHONE,
 162     PA_BLUEZ4_FORM_FACTOR_SPEAKER,
 163     PA_BLUEZ4_FORM_FACTOR_HEADPHONE,
 164     PA_BLUEZ4_FORM_FACTOR_PORTABLE,
 165     PA_BLUEZ4_FORM_FACTOR_CAR,
 166     PA_BLUEZ4_FORM_FACTOR_HIFI,
 167     PA_BLUEZ4_FORM_FACTOR_PHONE,
 168 } pa_bluez4_form_factor_t;
 169
 170 pa_bluez4_form_factor_t pa_bluez4_get_form_factor(uint32_t class);
 171 const char *pa_bluez4_form_factor_to_string(pa_bluez4_form_factor_t ff);
 172
 173 char *pa_bluez4_cleanup_name(const char *name);
 174
 175 bool pa_bluez4_uuid_has(pa_bluez4_uuid *uuids, const char *uuid);
 176 const char *pa_bluez4_profile_to_string(pa_bluez4_profile_t profile);
 177
 178 #endif