Defines |
#define | SND_USE_CASE_VERB_INACTIVE "Inactive" |
#define | SND_USE_CASE_VERB_HIFI "HiFi" |
#define | SND_USE_CASE_VERB_HIFI_LOW_POWER "HiFi Low Power" |
#define | SND_USE_CASE_VERB_VOICE "Voice" |
#define | SND_USE_CASE_VERB_VOICE_LOW_POWER "Voice Low Power" |
#define | SND_USE_CASE_VERB_VOICECALL "Voice Call" |
#define | SND_USE_CASE_VERB_IP_VOICECALL "Voice Call IP" |
#define | SND_USE_CASE_VERB_ANALOG_RADIO "FM Analog Radio" |
#define | SND_USE_CASE_VERB_DIGITAL_RADIO "FM Digital Radio" |
#define | SND_USE_CASE_DEV_NONE "None" |
#define | SND_USE_CASE_DEV_SPEAKER "Speaker" |
#define | SND_USE_CASE_DEV_LINE "Line" |
#define | SND_USE_CASE_DEV_HEADPHONES "Headphones" |
#define | SND_USE_CASE_DEV_HEADSET "Headset" |
#define | SND_USE_CASE_DEV_HANDSET "Handset" |
#define | SND_USE_CASE_DEV_BLUETOOTH "Bluetooth" |
#define | SND_USE_CASE_DEV_EARPIECE "Earpiece" |
#define | SND_USE_CASE_DEV_SPDIF "SPDIF" |
#define | SND_USE_CASE_DEV_HDMI "HDMI" |
#define | SND_USE_CASE_MOD_CAPTURE_VOICE "Capture Voice" |
#define | SND_USE_CASE_MOD_CAPTURE_MUSIC "Capture Music" |
#define | SND_USE_CASE_MOD_PLAY_MUSIC "Play Music" |
#define | SND_USE_CASE_MOD_PLAY_VOICE "Play Voice" |
#define | SND_USE_CASE_MOD_PLAY_TONE "Play Tone" |
#define | SND_USE_CASE_MOD_ECHO_REF "Echo Reference" |
#define | SND_USE_CASE_TQ_MUSIC "Music" |
#define | SND_USE_CASE_TQ_VOICE "Voice" |
#define | SND_USE_CASE_TQ_TONES "Tones" |
Typedefs |
typedef struct snd_use_case_mgr | snd_use_case_mgr_t |
Functions |
char * | snd_use_case_identifier (const char *fmt,...) |
| Create an identifier.
|
int | snd_use_case_free_list (const char *list[], int items) |
| Free a string list.
|
int | snd_use_case_get_list (snd_use_case_mgr_t *uc_mgr, const char *identifier, const char **list[]) |
| Obtain a list of entries.
|
int | snd_use_case_get (snd_use_case_mgr_t *uc_mgr, const char *identifier, const char **value) |
| Get current - string.
|
int | snd_use_case_geti (snd_use_case_mgr_t *uc_mgr, const char *identifier, long *value) |
| Get current - integer.
|
int | snd_use_case_set (snd_use_case_mgr_t *uc_mgr, const char *identifier, const char *value) |
| Set new.
|
int | snd_use_case_mgr_open (snd_use_case_mgr_t **uc_mgr, const char *card_name) |
| Open and initialise use case core for sound card.
|
int | snd_use_case_mgr_reload (snd_use_case_mgr_t *uc_mgr) |
| Reload and re-parse use case configuration files for sound card.
|
int | snd_use_case_mgr_close (snd_use_case_mgr_t *uc_mgr) |
| Close use case manager.
|
int | snd_use_case_mgr_reset (snd_use_case_mgr_t *uc_mgr) |
| Reset use case manager verb, device, modifier to deafult settings.
|
The ALSA Use Case manager interface. See Usecase page for more details.
#define SND_USE_CASE_VERB_INACTIVE "Inactive" |
ALSA Use Case Interface
The use case manager works by configuring the sound card ALSA kcontrols to change the hardware digital and analog audio routing to match the requested device use case. The use case manager kcontrol configurations are stored in easy to modify text files.
An audio use case can be defined by a verb and device parameter. The verb describes the use case action i.e. a phone call, listening to music, recording a conversation etc. The device describes the physical audio capture and playback hardware i.e. headphones, phone handset, bluetooth headset, etc.
It's intended clients will mostly only need to set the use case verb and device for each system use case change (as the verb and device parameters cover most audio use cases).
However there are times when a use case has to be modified at runtime. e.g.
o Incoming phone call when the device is playing music o Recording sections of a phone call o Playing tones during a call.
In order to allow asynchronous runtime use case adaptations, we have a third optional modifier parameter that can be used to further configure the use case during live audio runtime.
This interface allows clients to :-
o Query the supported use case verbs, devices and modifiers for the machine. o Set and Get use case verbs, devices and modifiers for the machine. o Get the ALSA PCM playback and capture device PCMs for use case verb, use case device and modifier. o Get the TQ parameter for each use case verb, use case device and modifier. o Get the ALSA master playback and capture volume/switch kcontrols for each use case.