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. |
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.
+ Incoming phone call when the device is playing music + Recording sections of a phone call + 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 :-
+ Query the supported use case verbs, devices and modifiers for the machine. + Set and Get use case verbs, devices and modifiers for the machine. + Get the ALSA PCM playback and capture device PCMs for use case verb, use case device and modifier. + Get the TQ parameter for each use case verb, use case device and modifier. + Get the ALSA master playback and capture volume/switch kcontrols for each use case.
#define SND_USE_CASE_DEV_BLUETOOTH "Bluetooth" |
Bluetooth Device
#define SND_USE_CASE_DEV_EARPIECE "Earpiece" |
Earpiece Device
#define SND_USE_CASE_DEV_HANDSET "Handset" |
Handset Device
#define SND_USE_CASE_DEV_HDMI "HDMI" |
HDMI Device
#define SND_USE_CASE_DEV_HEADPHONES "Headphones" |
Headphones Device
#define SND_USE_CASE_DEV_HEADSET "Headset" |
Headset Device
#define SND_USE_CASE_DEV_LINE "Line" |
Line Device
#define SND_USE_CASE_DEV_NONE "None" |
None Device
#define SND_USE_CASE_DEV_SPDIF "SPDIF" |
SPDIF Device
#define SND_USE_CASE_DEV_SPEAKER "Speaker" |
Speaker Device
#define SND_USE_CASE_MOD_CAPTURE_MUSIC "Capture Music" |
Capture Music Modifier
#define SND_USE_CASE_MOD_CAPTURE_VOICE "Capture Voice" |
Capture Voice Modifier
#define SND_USE_CASE_MOD_ECHO_REF "Echo Reference" |
Echo Reference Modifier
#define SND_USE_CASE_MOD_PLAY_MUSIC "Play Music" |
Play Music Modifier
#define SND_USE_CASE_MOD_PLAY_TONE "Play Tone" |
Play Tone Modifier
#define SND_USE_CASE_MOD_PLAY_VOICE "Play Voice" |
Play Voice Modifier
#define SND_USE_CASE_TQ_MUSIC "Music" |
TQ - Tone Quality
The interface allows clients to determine the audio TQ required for each use case verb and modifier. It's intended as an optional hint to the audio driver in order to lower power consumption. Music Tone Quality
#define SND_USE_CASE_TQ_TONES "Tones" |
Tones Tone Quality
#define SND_USE_CASE_TQ_VOICE "Voice" |
Voice Tone Quality
#define SND_USE_CASE_VERB_ANALOG_RADIO "FM Analog Radio" |
FM Analog Radio Verb
#define SND_USE_CASE_VERB_DIGITAL_RADIO "FM Digital Radio" |
FM Digital Radio Verb
#define SND_USE_CASE_VERB_HIFI "HiFi" |
HiFi Verb
#define SND_USE_CASE_VERB_HIFI_LOW_POWER "HiFi Low Power" |
HiFi Low Power Verb
#define SND_USE_CASE_VERB_INACTIVE "Inactive" |
Inactive Verb
#define SND_USE_CASE_VERB_IP_VOICECALL "Voice Call IP" |
Voice Call IP Verb
#define SND_USE_CASE_VERB_VOICE "Voice" |
Voice Verb
#define SND_USE_CASE_VERB_VOICE_LOW_POWER "Voice Low Power" |
Voice Low Power Verb
#define SND_USE_CASE_VERB_VOICECALL "Voice Call" |
Voice Call Verb
typedef struct snd_use_case_mgr snd_use_case_mgr_t |
use case container
int snd_use_case_free_list | ( | const char * | list[], | |
int | items | |||
) |
Free a string list.
list | The string list to free | |
items | Count of strings |
int snd_use_case_get | ( | snd_use_case_mgr_t * | uc_mgr, | |
const char * | identifier, | |||
const char ** | value | |||
) |
Get current - string.
uc_mgr | Use case manager | |
identifier | ||
value | Value pointer |
Known identifiers:
Recommended names for values:
If **JackHWMute** is set, it indicates that when the jack is plugged in, the hardware automatically mutes some other device(s). The JackHWMute value is a space-separated list of device names (this isn't compatible with device names with spaces in them, so don't use such device names!). Note that JackHWMute should be used only when the hardware enforces the automatic muting. If the hardware doesn't enforce any muting, it may still be tempting to set JackHWMute to trick upper software layers to e.g. automatically mute speakers when headphones are plugged in, but that's application policy configuration that doesn't belong to UCM configuration files.
uc_mgr | Use case manager | |
identifier | ||
value | Value pointer |
int snd_use_case_get_list | ( | snd_use_case_mgr_t * | uc_mgr, | |
const char * | identifier, | |||
const char ** | list[] | |||
) |
Obtain a list of entries.
uc_mgr | Use case manager (may be NULL - card list) | |
identifier | (may be NULL - card list) | |
list | Returned allocated list |
_supporteddevs/{modifier}|{device}[/{verb}] - list of supported devices _conflictingdevs/{modifier}|{device}[/{verb}] - list of conflicting devices Note that at most one of the supported/conflicting devs lists has any entries, and when neither is present, all devices are supported.
uc_mgr | Use case manager (may be NULL - card list) | |
identifier | (may be NULL - card list) | |
list | Returned allocated list |
int snd_use_case_geti | ( | snd_use_case_mgr_t * | uc_mgr, | |
const char * | identifier, | |||
long * | value | |||
) |
Get current - integer.
uc_mgr | Use case manager | |
identifier | ||
value | result |
uc_mgr | Use case manager | |
identifier |
char* snd_use_case_identifier | ( | const char * | fmt, | |
... | ||||
) |
Create an identifier.
fmt | Format (sprintf like) | |
... | Optional arguments for sprintf like format |
int snd_use_case_mgr_close | ( | snd_use_case_mgr_t * | uc_mgr | ) |
Close use case manager.
uc_mgr | Use case manager |
uc_mgr | Use case manager |
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.
uc_mgr | Returned use case manager pointer | |
card_name | Sound card name. |
uc_mgr | Returned use case manager pointer | |
card_name | name of card to open |
int snd_use_case_mgr_reload | ( | snd_use_case_mgr_t * | uc_mgr | ) |
Reload and re-parse use case configuration files for sound card.
uc_mgr | Use case manager |
uc_mgr | 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.
uc_mgr | Use case manager |
uc_mgr | Use case manager |
int snd_use_case_set | ( | snd_use_case_mgr_t * | uc_mgr, | |
const char * | identifier, | |||
const char * | value | |||
) |
Set new.
uc_mgr | Use case manager | |
identifier | ||
value | Value |
uc_mgr | Use case manager | |
identifier | ||
value | Value |