alsaucm - manuel de référence, options, exemples de commandes

NOM

alsaucm - Gestionnaire de cas d'utilisation ALSA

SYNOPSIS

alsaucm <options> [command]

DESCRIPTION

alsaucm (ALSA Use Case Manager) est un programme permettant d'utiliser l'interface Cas d'utilisation ALSA à partir de la ligne de commande.

Sur les cartes son complexes, la configuration des routes audio n'est pas triviale et les paramètres du mélangeur peuvent entrer en conflit, empêchant la carte son de fonctionner.

Le gestionnaire de cas d'utilisation ALSA est un mécanisme de contrôle du matériel audio complexe établissant une relation entre les configurations matérielles et les cas d'utilisation significatifs auxquels l'utilisateur final peut s'identifier.

Le gestionnaire de cas d'utilisation peut également être utilisé pour basculer entre les cas d'utilisation si nécessaire, de manière cohérente.

À un niveau inférieur, le gestionnaire de cas d'utilisation fonctionne en configurant la carte son ALSA kcontrols pour modifier le routage audio numérique et analogique matériel afin de correspondre au cas d'utilisation de l'appareil demandé.

Les configurations kcontrol du gestionnaire de cas d'utilisation sont stockées dans des fichiers texte faciles à modifier. Un cas d'utilisation audio peut être défini par un paramètre verb et device.

Le verbe décrit l'action du cas d'utilisation, c'est-à-dire un appel téléphonique, écouter de la musique, enregistrer une conversation, etc. L'appareil décrit le matériel physique de capture et de lecture audio, c'est-à-dire un casque, un combiné téléphonique, un casque Bluetooth, etc.

OPTIONS

Options disponibles:

-h, --help

cette aide

-c, --card NAME

ouvrir la carte NAME

-i, --interactive

mode interactif

-b, --batch FILE

mode batch (utilisez '-' pour l'entrée stdin)

-n, --no-open

ne pas ouvrir la première carte trouvée

Commandes disponibles :

open NAME

ouvrir la carte NAME.

les noms valides sont les noms de cartes son répertoriés dans /usr/share/alsa/ucm.

reset

réinitialiser la carte son à l'état par défaut.

reload

recharger la configuration.

listcards

lister les cartes disponibles.

list IDENTIFIER

commande list, pour les éléments renvoyant deux entrées (valeur + commentaire).

la valeur de l'argument IDENTIFIER peut être :

  • _verbs - récupère la liste des verbes (par paire verbe + commentaire)

  • _devices[/{verb}] - obtenir la liste des appareils pris en charge (par paire appareil + commentaire)

  • _modifiers[/{verb}] - obtenir la liste des modificateurs pris en charge (par paire modificateur + commentaire)

Les formes sans le /{verb} de fin ne sont valides qu'après qu'un verbe spécifique a été défini.

list1 IDENTIFIER

commande list, pour les listes renvoyant un élément par entrée.

la valeur de l'argument IDENTIFIER peut varier selon le contexte, il peut s'agir de :

  • TQ[/{verb}] - obtenir la liste des identifiants de qualité de tonalité

  • _enadevs - obtenir la liste des appareils activés

  • _enamods - obtenir la liste des modificateurs activés

  • _supporteddevs/{modifier}|{device}[/{verb}] - liste des appareils pris en charge

  • _conflictingdevs/{modifier}|{device}[/{verb}] - liste des appareils en conflit

get IDENTIFIER

obtenir la valeur de la chaîne.

la valeur de l'argument IDENTIFIER peut être :

  • _verb - renvoie le verbe actuel

  • [=]{NAME}[/[{modifier}|{/device}][/{verb}]] (pour des NAMEs valides, consultez l'interface de cas d'utilisation ALSA )

geti IDENTIFIER

obtenir une valeur entière.

la valeur de l'argument IDENTIFIER peut être :

  • _devstatus/{appareil}

  • _modstatus/{appareil}

set IDENTIFIER VALUE

définir la valeur de la chaîne

La valeur de l'argument IDENTIFIER peut être :

  • _verb : définissez le verbe sur VALUE

  • _enadev - active l'appareil spécifié par VALUE

  • _disdev - désactive l'appareil spécifié par VALUE

  • _swdev/{old_device} - switche device:

    • disable old_device and then enable the device specified by VALUE

    • si aucun appareil n'a été activé, il suffit de revenir

  • _enamod - active le modificateur spécifié par VALUE

  • _dismod - désactive le modificateur spécifié par VALUE

  • _swmod/{old_modifier} - switch modifier:

    • disable old_modifier and then enable the modifier specified by VALUE

    • si aucun modificateur n'a été activé, il suffit de revenir

Notez que les identifiants faisant référence aux périphériques et aux modificateurs ne sont valides qu'après avoir défini un verbe.

h, help

aider

q, quit

arrêter

DES DOSSIERS

Les fichiers de cas d'utilisation principaux pour chaque carte son prise en charge se trouvent dans /usr/share/alsa/ucm.

Par exemple, le fichier de cas d'utilisation maître pour la carte Pandaboard est dans /usr/share/alsa/ucm/PandaBoard/PandaBoard.conf, ce fichier répertorie toutes les utilisations prises en charge cas, par ex.

SectionUseCase."HiFi" {
                File "hifi"
                Comment "Play HiFi quality Music."
}
...

Chaque cas d'utilisation définit un _verb, qui est décrit dans le fichier spécifié dans la directive File, comme ci-dessus.

Le verbe HiFi ci-dessus est décrit dans /usr/share/alsa/ucm/PandaBoard/hifi.

Pour plus de détails sur la syntaxe des fichiers UCM, consultez le code source d'alsa-lib : http://git.alsa-project.org/?p=alsa-lib.git;a=blob;f=src/ ucm/parser.c

EXEMPLES D'UTILISATION

Certaines commandes, comme par exemple list _devices, ne peuvent fonctionner qu'après avoir défini un _verb dans la même exécution, par exemple cette séquence ne fonctionne pas :

# alsaucm -c bytcr-rt5640 set _verb HiFi
# alsaucm -c bytcr-rt5640 list _devices

Cependant cette commande fait :

# alsaucm -n -b - <<EOM
open bytcr-rt5640
set _verb HiFi
list _devices
EOM

Un exemple de réglage du périphérique Speaker pour le verbe HiFi de la carte bytcr-rt5640 :

# alsaucm -n -b - <<EOM
open bytcr-rt5640
reset
set _verb HiFi
set _enadev Speaker
EOM

VOIR ÉGALEMENT

  • Interface de cas d'utilisation : http://www.alsa-project.org/alsa-doc/alsa-lib/group__ucm.html

INSECTES

Aucun connu.

AUTEUR

Antonio Ospite ao2@ao2.it

DROITS D'AUTEUR

GPLv2+