alsaucm - リファレンスマニュアル、オプション、コマンド例

名前

alsaucm - ALSA ユースケースマネージャー

概要

alsaucm <options> [command]

説明

alsaucm (ALSA ユースケースマネージャー) は、コマンドラインから ALSA のユースケース インターフェイスを使用するためのプログラムです。

複雑なサウンドカードでは、オーディオルートの設定は簡単ではなく、ミキサー設定が相互に競合し、オーディオカードがまったく機能しなくなる可能性があります。

ALSA ユースケースマネージャーは、複雑なオーディオハードウェアを制御して、ハードウェア構成とエンドユーザーが関係できる有意義なユースケースとの関係を確立するためのメカニズムです。

ユースケースマネージャーを使用して、必要に応じて一貫した方法でユースケースを切り替えることもできます。

下位レベルでは、ユースケースマネージャーは、要求されたデバイスのユースケースに一致するようにハードウェアのデジタルおよびアナログオーディオルーティングを変更するようにサウンドカード ALSA kcontrols を構成することによって機能します。

ユースケースマネージャーの kcontrol 構成は、簡単に変更できるテキストファイルに保存されます。オーディオのユースケースは動詞とデバイスパラメータによって定義できます。

動詞は、ユースケースのアクション (電話をかける、音楽を聴く、会話を録音するなど) を表します。デバイスは、物理的なオーディオのキャプチャおよび再生ハードウェア (ヘッドフォン、受話器、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 コマンド。2 つのエントリ (値 + コメント) を返す項目の場合。

IDENTIFIER 引数の値は次のとおりです。
_verbs - 動詞リストを取得します (動詞とコメントのペア)
_devices[/{verb}] - サポートされているデバイスのリストを取得します（デバイス + コメントのペア）
_modifiers[/{verb}] - サポートされている修飾子のリストを取得します（修飾子とコメントのペア）
末尾に /{verb} がない形式は、特定の動詞が設定された後にのみ有効です。
list1 IDENTIFIER
list コマンド。エントリごとに 1 つの項目を返すリストの場合。

IDENTIFIER 引数の値はコンテキストによって異なり、次のようになります。
TQ[/{verb}] - 音質識別子のリストを取得します
_enadevs - 有効なデバイスのリストを取得します
_enamods - 有効なモディファイアのリストを取得します
_supporteddevs/{modifier}|{device}[/{verb}] - サポートされているデバイスのリスト
_conflictingdevs/{modifier}|{device}[/{verb}] - 競合するデバイスのリスト
get IDENTIFIER
文字列値を取得します。

IDENTIFIER 引数の値は次のとおりです。
_verb - 現在の動詞を返します
[=]{NAME}[/[{modifier}|{/device}][/{verb}]] (有効な NAME については、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

bytcr-rt5640 カードのHiFi動詞のスピーカーデバイスを設定する例:

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

バグ

何も知られていない。

著者

アントニオ・オスピテ ao2@ao2.it

著作権

GPLv2+

alsaucm - リファレンスマニュアル、オプション、コマンド例

名前

概要

説明

オプション

ファイル

使用例

関連項目

バグ

著者

著作権