요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Playback format, controls, request pool
configfs-usb-gadget-uac2:23-36Playback channel·sample format과 HS/SS interval, mute·volume control 범위를 설정하며 req_number로 capture와 playback 양쪽이 공유할 pre-allocated request 수를 정합니다.
Interface, clocks, terminals, function units
configfs-usb-gadget-uac2:37-51Function interface와 topology control, input·output clock, playback·capture terminal 및 mute/volume function unit의 이름과 terminal type code를 설정합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /config/usb-gadget/gadget/functions/uac2.name
2
Date: Sep 2014
3
KernelVersion: 3.18
4
Description:
5
The attributes:
7
===================== =======================================
8
c_chmask capture channel mask
9
c_srate list of capture sampling rates (comma-separated)
10
c_ssize capture sample size (bytes)
11
c_hs_bint capture bInterval for HS/SS (1-4: fixed, 0: auto)
12
c_sync capture synchronization type
13
(async/adaptive)
14
c_mute_present capture mute control enable
15
c_volume_present capture volume control enable
16
c_volume_min capture volume control min value
17
(in 1/256 dB)
18
c_volume_max capture volume control max value
19
(in 1/256 dB)
20
c_volume_res capture volume control resolution
21
(in 1/256 dB)
22
fb_max maximum extra bandwidth in async mode
23
p_chmask playback channel mask
24
p_srate list of playback sampling rates (comma-separated)
25
p_ssize playback sample size (bytes)
26
p_hs_bint playback bInterval for HS/SS (1-4: fixed, 0: auto)
27
p_mute_present playback mute control enable
28
p_volume_present playback volume control enable
29
p_volume_min playback volume control min value
30
(in 1/256 dB)
31
p_volume_max playback volume control max value
32
(in 1/256 dB)
33
p_volume_res playback volume control resolution
34
(in 1/256 dB)
35
req_number the number of pre-allocated requests
36
for both capture and playback
37
function_name name of the interface
38
if_ctrl_name topology control name
39
clksrc_in_name input clock name
40
clksrc_out_name output clock name
41
p_it_name playback input terminal name
42
p_it_ch_name playback input first channel name
43
p_ot_name playback output terminal name
44
p_fu_vol_name playback mute/volume function unit name
45
c_it_name capture input terminal name
46
c_it_ch_name capture input first channel name
47
c_ot_name capture output terminal name
48
c_fu_vol_name capture mute/volume functional unit name
49
c_terminal_type code of the capture terminal type
50
p_terminal_type code of the playback terminal type
51
===================== =======================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
UAC2 function ABI 식별 정보
1-5| 항목 | 내용 |
|---|---|
| What | /config/usb-gadget/gadget/functions/uac2.name |
| Date | 2014년 9월 |
| KernelVersion | 3.18 |
| Description | 다음 attributes를 제공합니다. |
Capture attributes
7-22| Attribute | 설명 |
|---|---|
| c_chmask | Capture channel mask |
| c_srate | 쉼표로 구분한 capture sampling rate 목록 |
| c_ssize | Capture sample size, 단위는 byte |
| c_hs_bint | HS/SS capture bInterval. 1-4는 고정값이고 0은 자동 설정 |
| c_sync | Capture synchronization type: async 또는 adaptive |
| c_mute_present | Capture mute control 활성화 |
| c_volume_present | Capture volume control 활성화 |
| c_volume_min | Capture volume control 최솟값, 단위는 1/256 dB |
| c_volume_max | Capture volume control 최댓값, 단위는 1/256 dB |
| c_volume_res | Capture volume control 해상도, 단위는 1/256 dB |
| fb_max | Asynchronous mode에서 허용할 최대 extra bandwidth |
Playback attributes와 request pool
23-36| Attribute | 설명 |
|---|---|
| p_chmask | Playback channel mask |
| p_srate | 쉼표로 구분한 playback sampling rate 목록 |
| p_ssize | Playback sample size, 단위는 byte |
| p_hs_bint | HS/SS playback bInterval. 1-4는 고정값이고 0은 자동 설정 |
| p_mute_present | Playback mute control 활성화 |
| p_volume_present | Playback volume control 활성화 |
| p_volume_min | Playback volume control 최솟값, 단위는 1/256 dB |
| p_volume_max | Playback volume control 최댓값, 단위는 1/256 dB |
| p_volume_res | Playback volume control 해상도, 단위는 1/256 dB |
| req_number | Capture와 playback 양쪽에 미리 할당할 request 수 |
Interface와 audio topology attributes
37-51| Attribute | 설명 |
|---|---|
| function_name | Interface 이름 |
| if_ctrl_name | Topology control 이름 |
| clksrc_in_name | Input clock 이름 |
| clksrc_out_name | Output clock 이름 |
| p_it_name | Playback input terminal 이름 |
| p_it_ch_name | Playback input의 첫 번째 channel 이름 |
| p_ot_name | Playback output terminal 이름 |
| p_fu_vol_name | Playback mute/volume function unit 이름 |
| c_it_name | Capture input terminal 이름 |
| c_it_ch_name | Capture input의 첫 번째 channel 이름 |
| c_ot_name | Capture output terminal 이름 |
| c_fu_vol_name | Capture mute/volume functional unit 이름 |
| c_terminal_type | Capture terminal type code |
| p_terminal_type | Playback terminal type code |
USB host playback stream→p_it_name / p_it_ch_name→p_fu_vol_name→p_ot_name→Playback terminal type
Capture audio source→c_it_name / c_it_ch_name→c_fu_vol_name→c_ot_name→USB host capture stream
clksrc_in_name→if_ctrl_name→function_name→clksrc_out_name
Capture requests→req_number→Playback requests
p_ 접두사는 playback topology, c_ 접두사는 capture topology를 구성한다. 각 경로는 input terminal, mute/volume function unit, output terminal 이름을 가지며 input·output clock 이름과 함께 interface에 노출된다.
Capture format, synchronization, controls
configfs-usb-gadget-uac2:1-22Capture channel mask와 sampling rate, sample size, HS/SS interval, synchronization type, mute·volume control 범위와 asynchronous mode의 extra bandwidth를 설정합니다.