요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Request allocation과 audio entity names
configfs-usb-gadget-uac1:30-41양 방향에 공통으로 preallocate할 request 수와 interface, input/output terminal, channel, mute/volume functional unit 이름을 설정합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /config/usb-gadget/gadget/functions/uac1.name
2
Date: June 2017
3
KernelVersion: 4.14
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_mute_present capture mute control enable
12
c_volume_present capture volume control enable
13
c_volume_min capture volume control min value
14
(in 1/256 dB)
15
c_volume_max capture volume control max value
16
(in 1/256 dB)
17
c_volume_res capture volume control resolution
18
(in 1/256 dB)
19
p_chmask playback channel mask
20
p_srate list of playback sampling rates (comma-separated)
21
p_ssize playback sample size (bytes)
22
p_mute_present playback mute control enable
23
p_volume_present playback volume control enable
24
p_volume_min playback volume control min value
25
(in 1/256 dB)
26
p_volume_max playback volume control max value
27
(in 1/256 dB)
28
p_volume_res playback volume control resolution
29
(in 1/256 dB)
30
req_number the number of pre-allocated requests
31
for both capture and playback
32
function_name name of the interface
33
p_it_name playback input terminal name
34
p_it_ch_name playback channels name
35
p_ot_name playback output terminal name
36
p_fu_vol_name playback mute/volume functional unit name
37
c_it_name capture input terminal name
38
c_it_ch_name capture channels name
39
c_ot_name capture output terminal name
40
c_fu_vol_name capture mute/volume functional unit name
41
===================== =======================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
USB Audio Class 1 function instance
1-5| 항목 | 내용 |
|---|---|
| What | /config/usb-gadget/gadget/functions/uac1.name |
| Date | 2017년 6월 |
| KernelVersion | 4.14 |
Capture stream format와 feature-unit control
7-18| Attribute | 설명 |
|---|---|
| c_chmask | Capture channel mask |
| c_srate | Comma로 구분한 capture sampling rate 목록 |
| c_ssize | Capture sample size, byte 단위 |
| c_mute_present | Capture mute control 활성화 |
| c_volume_present | Capture volume control 활성화 |
| c_volume_min | Capture volume control minimum, 1/256 dB 단위 |
| c_volume_max | Capture volume control maximum, 1/256 dB 단위 |
| c_volume_res | Capture volume control resolution, 1/256 dB 단위 |
Playback stream format와 feature-unit control
19-29| Attribute | 설명 |
|---|---|
| p_chmask | Playback channel mask |
| p_srate | Comma로 구분한 playback sampling rate 목록 |
| p_ssize | Playback sample size, byte 단위 |
| p_mute_present | Playback mute control 활성화 |
| p_volume_present | Playback volume control 활성화 |
| p_volume_min | Playback volume control minimum, 1/256 dB 단위 |
| p_volume_max | Playback volume control maximum, 1/256 dB 단위 |
| p_volume_res | Playback volume control resolution, 1/256 dB 단위 |
Request 수와 UAC1 entity 이름
30-40| Attribute | 설명 |
|---|---|
| req_number | Capture와 playback 양쪽을 위해 preallocate할 request 수 |
| function_name | Interface 이름 |
| p_it_name | Playback input terminal 이름 |
| p_it_ch_name | Playback channel 이름 |
| p_ot_name | Playback output terminal 이름 |
| p_fu_vol_name | Playback mute/volume functional unit 이름 |
| c_it_name | Capture input terminal 이름 |
| c_it_ch_name | Capture channel 이름 |
| c_ot_name | Capture output terminal 이름 |
| c_fu_vol_name | Capture mute/volume functional unit 이름 |
Playback input terminal: p_it_name→Playback channels: p_it_ch_name→Mute/volume FU: p_fu_vol_name→Playback output terminal: p_ot_name
Capture input terminal: c_it_name→Capture channels: c_it_ch_name→Mute/volume FU: c_fu_vol_name→Capture output terminal: c_ot_name
uac1.name→req_number→Capture와 playback 공통 preallocated request
Channel mask + sample rate list + sample size→Stream format→Mute/volume min·max·resolution
두 stream은 각자의 format과 terminal·feature unit 이름을 가지며 request pool은 양 방향에 공통으로 preallocate된다.
Capture와 playback format·volume controls
configfs-usb-gadget-uac1:1-29Capture와 playback 각각의 channel mask, comma-separated sample rate, byte sample size 및 mute·volume control range를 구성합니다.