src/modules/alsa/alsa-util.h

   1 #ifndef fooalsautilhfoo
   2 #define fooalsautilhfoo
   3
   4 /***
   5   This file is part of PulseAudio.
   6
   7   Copyright 2004-2006 Lennart Poettering
   8   Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
   9
  10   PulseAudio is free software; you can redistribute it and/or modify
  11   it under the terms of the GNU Lesser General Public License as published
  12   by the Free Software Foundation; either version 2 of the License,
  13   or (at your option) any later version.
  14
  15   PulseAudio is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with PulseAudio; if not, write to the Free Software
  22   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  23   USA.
  24 ***/
  25
  26 #include <asoundlib.h>
  27
  28 #include <pulse/sample.h>
  29 #include <pulse/volume.h>
  30 #include <pulse/mainloop-api.h>
  31 #include <pulse/channelmap.h>
  32 #include <pulse/proplist.h>
  33
  34 #include <pulsecore/rtpoll.h>
  35 #include <pulsecore/core.h>
  36
  37 typedef struct pa_alsa_fdlist pa_alsa_fdlist;
  38
  39 struct pa_alsa_fdlist *pa_alsa_fdlist_new(void);
  40 void pa_alsa_fdlist_free(struct pa_alsa_fdlist *fdl);
  41 int pa_alsa_fdlist_set_mixer(struct pa_alsa_fdlist *fdl, snd_mixer_t *mixer_handle, pa_mainloop_api* m);
  42
  43 int pa_alsa_set_hw_params(
  44         snd_pcm_t *pcm_handle,
  45         pa_sample_spec *ss,
  46         uint32_t *periods,
  47         snd_pcm_uframes_t *period_size,
  48         snd_pcm_uframes_t tsched_size,
  49         pa_bool_t *use_mmap,
  50         pa_bool_t *use_tsched,
  51         pa_bool_t require_exact_channel_number);
  52
  53 int pa_alsa_set_sw_params(snd_pcm_t *pcm, snd_pcm_uframes_t avail_min);
  54
  55 int pa_alsa_prepare_mixer(snd_mixer_t *mixer, const char *dev);
  56 snd_mixer_elem_t *pa_alsa_find_elem(snd_mixer_t *mixer, const char *name, const char *fallback, pa_bool_t playback);
  57 int pa_alsa_find_mixer_and_elem(snd_pcm_t *pcm, snd_mixer_t **_m, snd_mixer_elem_t **_e);
  58
  59 typedef struct pa_alsa_profile_info {
  60     pa_channel_map map;
  61     const char *alsa_name;
  62     const char *description;
  63     const char *name;
  64     unsigned priority;
  65 } pa_alsa_profile_info;
  66
  67 /* Picks a working profile based on the specified ss/map */
  68 snd_pcm_t *pa_alsa_open_by_device_id_auto(
  69         const char *dev_id,
  70         char **dev,
  71         pa_sample_spec *ss,
  72         pa_channel_map* map,
  73         int mode,
  74         uint32_t *nfrags,
  75         snd_pcm_uframes_t *period_size,
  76         snd_pcm_uframes_t tsched_size,
  77         pa_bool_t *use_mmap,
  78         pa_bool_t *use_tsched,
  79         const pa_alsa_profile_info **profile);
  80
  81 /* Uses the specified profile */
  82 snd_pcm_t *pa_alsa_open_by_device_id_profile(
  83         const char *dev_id,
  84         char **dev,
  85         pa_sample_spec *ss,
  86         pa_channel_map* map,
  87         int mode,
  88         uint32_t *nfrags,
  89         snd_pcm_uframes_t *period_size,
  90         snd_pcm_uframes_t tsched_size,
  91         pa_bool_t *use_mmap,
  92         pa_bool_t *use_tsched,
  93         const pa_alsa_profile_info *profile);
  94
  95 /* Opens the explicit ALSA device */
  96 snd_pcm_t *pa_alsa_open_by_device_string(
  97         const char *device,
  98         char **dev,
  99         pa_sample_spec *ss,
 100         pa_channel_map* map,
 101         int mode,
 102         uint32_t *nfrags,
 103         snd_pcm_uframes_t *period_size,
 104         snd_pcm_uframes_t tsched_size,
 105         pa_bool_t *use_mmap,
 106         pa_bool_t *use_tsched,
 107         pa_bool_t require_exact_channel_number);
 108
 109 int pa_alsa_probe_profiles(
 110         const char *dev_id,
 111         const pa_sample_spec *ss,
 112         void (*cb)(const pa_alsa_profile_info *sink, const pa_alsa_profile_info *source, void *userdata),
 113         void *userdata);
 114
 115 int pa_alsa_calc_mixer_map(snd_mixer_elem_t *elem, const pa_channel_map *channel_map, snd_mixer_selem_channel_id_t mixer_map[], pa_bool_t playback);
 116
 117 void pa_alsa_dump(snd_pcm_t *pcm);
 118 void pa_alsa_dump_status(snd_pcm_t *pcm);
 119
 120 void pa_alsa_redirect_errors_inc(void);
 121 void pa_alsa_redirect_errors_dec(void);
 122
 123 void pa_alsa_init_proplist_pcm_info(pa_core *c, pa_proplist *p, snd_pcm_info_t *pcm_info);
 124 void pa_alsa_init_proplist_card(pa_core *c, pa_proplist *p, int card);
 125 void pa_alsa_init_proplist_pcm(pa_core *c, pa_proplist *p, snd_pcm_t *pcm);
 126
 127 int pa_alsa_recover_from_poll(snd_pcm_t *pcm, int revents);
 128
 129 pa_rtpoll_item* pa_alsa_build_pollfd(snd_pcm_t *pcm, pa_rtpoll *rtpoll);
 130
 131 snd_pcm_sframes_t pa_alsa_safe_avail_update(snd_pcm_t *pcm, size_t hwbuf_size, const pa_sample_spec *ss);
 132 int pa_alsa_safe_mmap_begin(snd_pcm_t *pcm, const snd_pcm_channel_area_t **areas, snd_pcm_uframes_t *offset, snd_pcm_uframes_t *frames, size_t hwbuf_size, const pa_sample_spec *ss);
 133
 134 char *pa_alsa_get_driver_name(int card);
 135
 136 #endif