alsaucm - справочное руководство, опции, примеры команд

ИМЯ

alsaucm - Диспетчер вариантов использования ALSA

СИНТАКСИС

alsaucm <options> [command]

ОПИСАНИЕ

alsaucm (Менеджер вариантов использования ALSA) — это программа для использования интерфейса ALSA Use Case из командной строки.

На сложных звуковых картах настройка аудиомаршрутов не является тривиальной задачей, а настройки микшера могут конфликтовать друг с другом, препятствуя работе звуковой карты вообще.

Диспетчер вариантов использования ALSA — это механизм управления сложным звуковым оборудованием, устанавливающий взаимосвязь между конфигурациями оборудования и значимыми вариантами использования, с которыми может иметь дело конечный пользователь.

Диспетчер вариантов использования также можно использовать для согласованного переключения между вариантами использования, когда это необходимо.

На более низком уровне менеджер вариантов использования работает, настраивая элементы управления ALSA звуковой карты для изменения аппаратной цифровой и аналоговой маршрутизации звука в соответствии с запрошенным вариантом использования устройства.

Конфигурации менеджера вариантов использования kcontrol хранятся в легко изменяемых текстовых файлах. Вариант использования аудио можно определить с помощью параметра verb и device.

Глагол описывает действие варианта использования, т. е. телефонный звонок, прослушивание музыки, запись разговора и т. д. Устройство описывает физическое оборудование для захвата и воспроизведения звука, т. е. наушники, телефонную трубку, Bluetooth-гарнитуру и т. д.

ПАРАМЕТРЫ

Доступные Варианты:

-h, --help
эта помощь
-c, --card NAME
открыть карту ИМЯ
-i, --interactive
интерактивный режим
-b, --batch FILE
пакетный режим (используйте '-' для стандартного ввода)
-n, --no-open
не открывать первую найденную карту

Доступные команды:

open NAME
открыть карту ИМЯ.

действительными именами являются имена звуковых карт, указанные в /usr/share/alsa/ucm.
reset
сбросить звуковую карту в состояние по умолчанию.
reload
перезагрузить конфигурацию.
listcards
список доступных карт.
list IDENTIFIER
list, для элементов, возвращающих две записи (значение+комментарий).

значение аргумента IDENTIFIER может быть:
_verbs — получить список глаголов (в паре глагол+комментарий)
_devices[/{verb}] — получить список поддерживаемых устройств (в паре устройство+комментарий)
_modifiers[/{verb}] — получить список поддерживаемых модификаторов (в паре модификатор+комментарий)
Формы без завершающего /{verb} допустимы только после установки определенного глагола.
list1 IDENTIFIER
list, для списков, возвращающих один элемент на запись.

значение аргумента IDENTIFIER может варьироваться в зависимости от контекста, это может быть:
TQ[/{verb}] — получить список идентификаторов качества тона
_enadevs — получить список включенных устройств
_enamods — получить список включенных модификаторов
_supporteddevs/{modifier}|{device}[/{verb}] — список поддерживаемых устройств
_conflictingdevs/{modifier}|{device}[/{verb}] — список конфликтующих устройств
get IDENTIFIER
получить строковое значение.

значение аргумента IDENTIFIER может быть:
_verb — вернуть текущую команду
[=]{NAME}[/[{modifier}|{/device}][/{verb}]] (Действительные ИМЕНА см. в Интерфейсе вариантов использования ALSA )
geti IDENTIFIER
получить целочисленное значение.

значение аргумента IDENTIFIER может быть:
_devstatus/{устройство
_modstatus/{устройство
set IDENTIFIER VALUE
установить строковое значение

Значение аргумента IDENTIFIER может быть следующим:
_verb — задайте для глагола значение VALUE.
_enadev — включить устройство, указанное в VALUE.
_disdev — отключить устройство, указанное в VALUE.
_swdev/{old_device} - switche device:

disable old_device and then enable the device specified by VALUE
если ни одно устройство не было включено, просто вернитесь
_enamod — включить модификатор, указанный в VALUE.
_dismod — отключить модификатор, указанный в VALUE.
_swmod/{old_modifier} - switch modifier:

disable old_modifier and then enable the modifier specified by VALUE
если модификатор не был включен, просто вернитесь
Обратите внимание, что идентификаторы, относящиеся к устройствам и модификаторам, действительны только после установки глагола.
h, help
помощь
q, quit
покидать

ФАЙЛЫ

Файлы основных сценариев использования для каждой поддерживаемой звуковой карты находятся в папке /usr/share/alsa/ucm.

Например, основной файл прецедентов для карты Pandaboard находится в /usr/share/alsa/ucm/PandaBoard/PandaBoard.conf, в этом файле перечислены все поддерживаемые варианты использования. случаи, напр.

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

Каждый вариант использования определяет _verb, который описан в файле, указанном в директиве File, как указано выше.

Приведенный выше глагол HiFi описан в /usr/share/alsa/ucm/PandaBoard/hifi.

Дополнительные сведения о синтаксисе файлов UCM см. в исходном коде alsa-lib: http://git.alsa-project.org/?p=alsa-lib.git;a=blob;f=src/ ucm/parser.c

ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ

Некоторые команды, такие как, например, list _devices, могут работать только после установки _verb в таком же исполнении, например, эта последовательность не работает :

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

Однако эта команда делает:

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

Пример настройки устройства Speaker для глагола HiFi платы bytcr-rt5640:

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

СМОТРИТЕ ТАКЖЕ

Интерфейс варианта использования: http://www.alsa-project.org/alsa-doc/alsa-lib/group__ucm.html

ОШИБКИ

Никто не известен.

АВТОР

Антонио Оспите ao2@ao2.it

АВТОРСКИЕ ПРАВА

GPLv2+