alsaucm - referenční příručka, možnosti, příklady příkazů

NÁZEV

alsaucm - ALSA Use Case Manager

SYNOPSE

alsaucm <options> [command]

POPIS

alsaucm (ALSA Use Case Manager) je program pro použití rozhraní ALSA Use Case z příkazového řádku.

Na složitých zvukových kartách není nastavení zvukových tras triviální a nastavení směšovače se mohou vzájemně střetávat, což znemožňuje zvukové kartě vůbec fungovat.

ALSA Use Case Manager je mechanismus pro řízení složitého zvukového hardwaru, který vytváří vztah mezi hardwarovými konfiguracemi a smysluplnými případy použití, se kterými se může koncový uživatel ztotožnit.

Správce případů použití lze také použít k přepínání mezi případy použití v případě potřeby konzistentním způsobem.

Na nižší úrovni pracuje správce případu užití tak, že nakonfiguruje zvukové karty ALSA kcontrols tak, aby se změnilo hardwarové digitální a analogové směrování zvuku tak, aby odpovídalo případu použití požadovaného zařízení.

Konfigurace správce případů použití kcontrol jsou uloženy ve snadno upravitelných textových souborech. Případ použití zvuku lze definovat pomocí parametru verb a device.

Sloveso popisuje akci případu užití, tj. telefonní hovor, poslech hudby, nahrávání konverzace atd. Zařízení popisuje hardware pro fyzické zachycení a přehrávání zvuku, tj. sluchátka, telefonní sluchátko, sluchátka s bluetooth atd.

MOŽNOSTI

Dostupné možnosti:

-h, --help

tuto pomoc

-c, --card NAME

otevřít kartu NAME

-i, --interactive

interaktivní režim

-b, --batch FILE

dávkový režim (pro vstup stdin použijte '-')

-n, --no-open

neotevírejte první nalezenou kartu

Dostupné příkazy:

open NAME

otevřít kartu NAME.

platné názvy jsou názvy zvukových karet uvedené v /usr/share/alsa/ucm.

reset

resetovat zvukovou kartu do výchozího stavu.

reload

znovu načíst konfiguraci.

listcards

seznam dostupných karet.

list IDENTIFIER

příkaz list pro položky vracející dvě položky (hodnota+komentář).

hodnota argumentu IDENTIFIER může být:

  • _verbs – získat seznam sloves (ve dvojici sloveso+komentář)

  • _devices[/{verb}] – získat seznam podporovaných zařízení (v páru zařízení + komentář)

  • _modifiers[/{verb}] – získat seznam podporovaných modifikátorů (v páru modifikátor+komentář)

Tvary bez koncovky /{verb} jsou platné pouze po zadání konkrétního slovesa.

list1 IDENTIFIER

příkaz list pro seznamy vracející jednu položku na položku.

hodnota argumentu IDENTIFIER se může lišit v závislosti na kontextu, může to být:

  • TQ[/{verb}] – získání seznamu identifikátorů kvality tónu

  • _enadevs – získat seznam povolených zařízení

  • _enamods – získat seznam povolených modifikátorů

  • _supporteddevs/{modifier}|{device}[/{verb}] – seznam podporovaných zařízení

  • _conflictingdevs/{modifier}|{device}[/{verb}] – seznam kolidujících zařízení

get IDENTIFIER

získat hodnotu řetězce.

hodnota argumentu IDENTIFIER může být:

  • _verb – vrátí aktuální sloveso

  • [=]{NAME}[/[{modifier}|{/device}][/{verb}]] (Platná JMÉNA naleznete v rozhraní případu použití ALSA )

geti IDENTIFIER

získat celočíselnou hodnotu.

hodnota argumentu IDENTIFIER může být:

  • _devstatus/{device}

  • _modstatus/{device}

set IDENTIFIER VALUE

nastavit hodnotu řetězce

Hodnota argumentu IDENTIFIER může být:

  • _verb – nastavte sloveso na VALUE

  • _enadev – povolí zařízení určené pomocí VALUE

  • _disdev – deaktivuje zařízení určené parametrem VALUE

  • _swdev/{old_device} - switche device:

    • disable old_device and then enable the device specified by VALUE

    • pokud nebylo povoleno žádné zařízení, stačí se vrátit

  • _enamod – povolí modifikátor určený parametrem VALUE

  • _dismod – deaktivuje modifikátor určený parametrem VALUE

  • _swmod/{old_modifier} - switch modifier:

    • disable old_modifier and then enable the modifier specified by VALUE

    • pokud nebyl povolen žádný modifikátor, stačí vrátit

Všimněte si, že identifikátory odkazující na zařízení a modifikátory jsou platné pouze po nastavení slovesa.

h, help

Pomoc

q, quit

přestat

SOUBORY

Hlavní soubory případu použití pro každou podporovanou zvukovou kartu jsou v /usr/share/alsa/ucm.

Například hlavní soubor případu použití pro kartu Pandaboard je v /usr/share/alsa/ucm/PandaBoard/PandaBoard.conf, tento soubor uvádí všechna podporovaná použití případy, např.

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

Každý případ použití definuje _verb, které je popsáno v souboru specifikovaném v direktivě File, jako výše.

Sloveso HiFi výše je popsáno v /usr/share/alsa/ucm/PandaBoard/hifi.

Další podrobnosti o syntaxi souborů UCM naleznete ve zdrojovém kódu alsa-lib: http://git.alsa-project.org/?p=alsa-lib.git;a=blob;f=src/ ucm/parser.c

PŘÍKLADY POUŽITÍ

Některé příkazy, jako například list _devices, mohou fungovat pouze po nastavení _verb ve stejném provedení, například tato sekvence nefunguje :

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

Tento příkaz však dělá:

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

Příklad nastavení zařízení Speaker pro sloveso HiFi karty bytcr-rt5640:

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

VIZ TAKÉ

  • Rozhraní případu použití: http://www.alsa-project.org/alsa-doc/alsa-lib/group__ucm.html

HMYZ

Žádné známé.

AUTOR

Antonio Ospite

AUTORSKÁ PRÁVA

GPLv2+