요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
===========================
2
Standard ALSA Control Names
3
===========================
5
This document describes standard names of mixer controls.
7
Standard Syntax
8
---------------
9
Syntax: [LOCATION] SOURCE [CHANNEL] [DIRECTION] FUNCTION
12
DIRECTION
13
~~~~~~~~~
14
================ ===============
15
<nothing> both directions
16
Playback one direction
17
Capture one direction
18
Bypass Playback one direction
19
Bypass Capture one direction
20
================ ===============
22
FUNCTION
23
~~~~~~~~
24
======== =================================
25
Switch on/off switch
26
Volume amplifier
27
Route route control, hardware specific
28
======== =================================
30
CHANNEL
31
~~~~~~~
32
============ ==================================================
33
<nothing> channel independent, or applies to all channels
34
Front front left/right channels
35
Surround rear left/right in 4.0/5.1 surround
36
CLFE C/LFE channels
37
Center center channel
38
LFE LFE channel
39
Side side left/right for 7.1 surround
40
============ ==================================================
42
LOCATION (Physical location of source)
43
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
44
============ =====================
45
Front front position
46
Rear rear position
47
Dock on docking station
48
Internal internal
49
============ =====================
51
SOURCE
52
~~~~~~
53
=================== =================================================
54
Master
55
Master Mono
56
Hardware Master
57
Speaker internal speaker
58
Bass Speaker internal LFE speaker
59
Headphone
60
Line Out
61
Beep beep generator
62
Phone
63
Phone Input
64
Phone Output
65
Synth
66
FM
67
Mic
68
Headset Mic mic part of combined headset jack - 4-pin
69
headphone + mic
70
Headphone Mic mic part of either/or - 3-pin headphone or mic
71
Line input only, use "Line Out" for output
72
CD
73
Video
74
Zoom Video
75
Aux
76
PCM
77
PCM Pan
78
Loopback
79
Analog Loopback D/A -> A/D loopback
80
Digital Loopback playback -> capture loopback -
81
without analog path
82
Mono
83
Mono Output
84
Multi
85
ADC
86
Wave
87
Music
88
I2S
89
IEC958
90
HDMI
91
SPDIF output only
92
SPDIF In
93
Digital In
94
HDMI/DP either HDMI or DisplayPort
95
=================== =================================================
97
Exceptions (deprecated)
98
-----------------------
100
===================================== =======================
101
[Analogue|Digital] Capture Source
102
[Analogue|Digital] Capture Switch aka input gain switch
103
[Analogue|Digital] Capture Volume aka input gain volume
104
[Analogue|Digital] Playback Switch aka output gain switch
105
[Analogue|Digital] Playback Volume aka output gain volume
106
Tone Control - Switch
107
Tone Control - Bass
108
Tone Control - Treble
109
3D Control - Switch
110
3D Control - Center
111
3D Control - Depth
112
3D Control - Wide
113
3D Control - Space
114
3D Control - Level
115
Mic Boost [(?dB)]
116
===================================== =======================
118
PCM interface
119
-------------
121
=================== ========================================
122
Sample Clock Source { "Word", "Internal", "AutoSync" }
123
Clock Sync Status { "Lock", "Sync", "No Lock" }
124
External Rate external capture rate
125
Capture Rate capture rate taken from external source
126
=================== ========================================
128
IEC958 (S/PDIF) interface
129
-------------------------
131
============================================ ======================================
132
IEC958 [...] [Playback|Capture] Switch turn on/off the IEC958 interface
133
IEC958 [...] [Playback|Capture] Volume digital volume control
134
IEC958 [...] [Playback|Capture] Default default or global value - read/write
135
IEC958 [...] [Playback|Capture] Mask consumer and professional mask
136
IEC958 [...] [Playback|Capture] Con Mask consumer mask
137
IEC958 [...] [Playback|Capture] Pro Mask professional mask
138
IEC958 [...] [Playback|Capture] PCM Stream the settings assigned to a PCM stream
139
IEC958 Q-subcode [Playback|Capture] Default Q-subcode bits
141
IEC958 Preamble [Playback|Capture] Default burst preamble words (4*16bits)
142
============================================ ======================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
표준 구문과 방향·기능·채널·위치
1-50이 문서는 mixer control의 표준 이름을 정의한다. 기본 구문은 `[LOCATION] SOURCE [CHANNEL] [DIRECTION] FUNCTION`이다. 대괄호 요소는 필요한 경우에만 넣는다.
이름의미
<생략>양방향
Playback한 방향
Capture한 방향
Bypass Playback한 방향
Bypass Capture한 방향
생략하면 양방향이며 나머지는 한 방향을 뜻한다.
이름의미
Switchon/off switch
Volumeamplifier
Routehardware 전용 route control
Control이 수행하는 기능이다.
이름적용 대상
<생략>channel 독립 또는 모든 channel
Frontfront left/right
Surround4.0/5.1의 rear left/right
CLFEcenter/LFE
Centercenter
LFELFE
Side7.1의 side left/right
이름에 표시하는 channel 범위다.
이름위치
Front전면
Rear후면
Dockdocking station
Internal내부
Source의 물리적 위치를 나타낸다.
===========================
Standard ALSA Control Names
===========================
This document describes standard names of mixer controls.
Standard Syntax
---------------
Syntax: [LOCATION] SOURCE [CHANNEL] [DIRECTION] FUNCTION
DIRECTION
~~~~~~~~~
================ ===============
<nothing> both directions
Playback one direction
Capture one direction
Bypass Playback one direction
Bypass Capture one direction
================ ===============
FUNCTION
~~~~~~~~
======== =================================
Switch on/off switch
Volume amplifier
Route route control, hardware specific
======== =================================
CHANNEL
~~~~~~~
============ ==================================================
<nothing> channel independent, or applies to all channels
Front front left/right channels
Surround rear left/right in 4.0/5.1 surround
CLFE C/LFE channels
Center center channel
LFE LFE channel
Side side left/right for 7.1 surround
============ ==================================================
LOCATION (Physical location of source)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
============ =====================
Front front position
Rear rear position
Dock on docking station
Internal internal
============ =====================
표준 SOURCE 이름
51-96`SOURCE`는 control이 다루는 신호 또는 물리 endpoint를 식별한다. 이름 자체가 표준 ABI의 일부이므로 다음 표의 대소문자와 단어를 그대로 사용한다.
이름설명
Master / Master Mono / Hardware Mastermaster 계열
Speakerinternal speaker
Bass Speakerinternal LFE speaker
Headphone / Line Out출력 endpoint
Beepbeep generator
Phone / Phone Input / Phone Output전화 경로
Synth / FM / Mic신시사이저·FM·마이크
Headset Mic4-pin headphone+mic 결합 jack의 mic
Headphone Mic3-pin headphone 또는 mic 겸용 jack의 mic
Lineinput 전용, output은 Line Out
CD / Video / Zoom Video / Aux입력 source
PCM / PCM Pan / LoopbackPCM과 loopback
Analog LoopbackD/A에서 A/D로 loopback
Digital Loopbackanalog path 없는 playback-to-capture loopback
Mono / Mono Output / Multi / ADC일반 channel·converter source
Wave / Music / I2S / IEC958 / HDMIdigital audio source
SPDIFoutput 전용
SPDIF In / Digital Indigital input
HDMI/DPHDMI 또는 DisplayPort
설명이 없는 항목도 이름 자체가 표준값이다.
SOURCE
~~~~~~
=================== =================================================
Master
Master Mono
Hardware Master
Speaker internal speaker
Bass Speaker internal LFE speaker
Headphone
Line Out
Beep beep generator
Phone
Phone Input
Phone Output
Synth
FM
Mic
Headset Mic mic part of combined headset jack - 4-pin
headphone + mic
Headphone Mic mic part of either/or - 3-pin headphone or mic
Line input only, use "Line Out" for output
CD
Video
Zoom Video
Aux
PCM
PCM Pan
Loopback
Analog Loopback D/A -> A/D loopback
Digital Loopback playback -> capture loopback -
without analog path
Mono
Mono Output
Multi
ADC
Wave
Music
I2S
IEC958
HDMI
SPDIF output only
SPDIF In
Digital In
HDMI/DP either HDMI or DisplayPort
=================== =================================================
폐기된 예외 이름과 PCM interface
97-127다음 이름은 과거 호환을 위한 예외이며 deprecated 상태다. 새 control은 표준 구문을 사용해야 한다.
이름설명
[Analogue|Digital] Capture Sourcecapture source
[Analogue|Digital] Capture Switchinput gain switch
[Analogue|Digital] Capture Volumeinput gain volume
[Analogue|Digital] Playback Switchoutput gain switch
[Analogue|Digital] Playback Volumeoutput gain volume
Tone Control - Switch / Bass / Trebletone control
3D Control - Switch / Center / Depth / Wide / Space / Level3D control
Mic Boost [(?dB)]microphone boost
별칭 설명까지 원문대로 보존한다.
PCM interface에는 sample clock와 외부 rate 상태를 나타내는 다음 표준 control 이름이 있다.
이름값 / 의미
Sample Clock Source{ Word, Internal, AutoSync }
Clock Sync Status{ Lock, Sync, No Lock }
External Rate외부 capture rate
Capture Rate외부 source에서 취한 capture rate
Clock source와 capture rate 이름이다.
Exceptions (deprecated)
-----------------------
===================================== =======================
[Analogue|Digital] Capture Source
[Analogue|Digital] Capture Switch aka input gain switch
[Analogue|Digital] Capture Volume aka input gain volume
[Analogue|Digital] Playback Switch aka output gain switch
[Analogue|Digital] Playback Volume aka output gain volume
Tone Control - Switch
Tone Control - Bass
Tone Control - Treble
3D Control - Switch
3D Control - Center
3D Control - Depth
3D Control - Wide
3D Control - Space
3D Control - Level
Mic Boost [(?dB)]
===================================== =======================
PCM interface
-------------
=================== ========================================
Sample Clock Source { "Word", "Internal", "AutoSync" }
Clock Sync Status { "Lock", "Sync", "No Lock" }
External Rate external capture rate
Capture Rate capture rate taken from external source
=================== ========================================
IEC958(S/PDIF) interface 이름
128-142IEC958 control도 `[Playback|Capture]` 방향과 선택적 중간 qualifier를 포함하는 정해진 이름을 사용한다.
이름의미
IEC958 [...] [Playback|Capture] SwitchIEC958 interface on/off
IEC958 [...] [Playback|Capture] Volumedigital volume
IEC958 [...] [Playback|Capture] Default기본 또는 global read/write 값
IEC958 [...] [Playback|Capture] Maskconsumer와 professional mask
IEC958 [...] [Playback|Capture] Con Maskconsumer mask
IEC958 [...] [Playback|Capture] Pro Maskprofessional mask
IEC958 [...] [Playback|Capture] PCM StreamPCM stream에 할당된 설정
IEC958 Q-subcode [Playback|Capture] DefaultQ-subcode bit
IEC958 Preamble [Playback|Capture] Defaultburst preamble word 4x16bit
S/PDIF interface의 switch, 값, mask와 stream 설정이다.
IEC958 (S/PDIF) interface
-------------------------
============================================ ======================================
IEC958 [...] [Playback|Capture] Switch turn on/off the IEC958 interface
IEC958 [...] [Playback|Capture] Volume digital volume control
IEC958 [...] [Playback|Capture] Default default or global value - read/write
IEC958 [...] [Playback|Capture] Mask consumer and professional mask
IEC958 [...] [Playback|Capture] Con Mask consumer mask
IEC958 [...] [Playback|Capture] Pro Mask professional mask
IEC958 [...] [Playback|Capture] PCM Stream the settings assigned to a PCM stream
IEC958 Q-subcode [Playback|Capture] Default Q-subcode bits
IEC958 Preamble [Playback|Capture] Default burst preamble words (4*16bits)
============================================ ======================================
요약·해설
control-names.rst:1-142ALSA mixer control의 [LOCATION] SOURCE [CHANNEL] [DIRECTION] FUNCTION 표준 구문과 SOURCE·PCM·IEC958 이름 및 폐기된 예외를 정리합니다.