← Documents Documentation/ABI/testing/configfs-usb-gadget-midi2 GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

USB gadget MIDI 2.0 function configfs ABI

USB MIDI 2.0 function의 UMP stream 처리와 interface identity, endpoint protocol·device identity, function block direction·group mapping·MIDI compatibility를 설명합니다.

Source pathDocumentation/ABI/testing/configfs-usb-gadget-midi2
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

MIDI 2.0 function attributes

configfs-usb-gadget-midi2:1-11

UMP Stream message 처리, static block mode와 MIDI interface 이름을 function instance에 설정합니다.

UMP Endpoint configuration

configfs-usb-gadget-midi2:13-31

0-3 endpoint마다 protocol capability와 default, 이름 및 manufacturer·family·model·software revision identity를 구성합니다.

UMP Function Block configuration

configfs-usb-gadget-midi2:33-54

0-31 function block마다 direction, UMP group range, MIDI 1.0 mapping, UI hint, MIDI-CI, SysEx8와 active 상태를 설정합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /config/usb-gadget/gadget/functions/midi2.name
2 Date: Jul 2023
3 KernelVersion: 6.6
4 Description:
5 The attributes:
6
7 ============ ===============================================
8 process_ump Flag to process UMP Stream messages (0 or 1)
9 static_block Flag for static blocks (0 or 1)
10 iface_name MIDI interface name string
11 ============ ===============================================
12
13 What: /config/usb-gadget/gadget/functions/midi2.name/ep.number
14 Date: Jul 2023
15 KernelVersion: 6.6
16 Description:
17 This group contains a UMP Endpoint configuration.
18 A new Endpoint starts from 0, and can be up to 3.
19
20 The attributes:
21
22 ============= ===============================================
23 protocol_caps MIDI protocol capabilities (1, 2 or 3 for both)
24 protocol Default MIDI protocol (1 or 2)
25 ep_name UMP Endpoint name string
26 product_id Product ID string
27 manufacturer Manufacture ID (24 bit)
28 family Device family ID (16 bit)
29 model Device model ID (16 bit)
30 sw_revision Software Revision (32 bit)
31 ============= ===============================================
32
33 What: /config/usb-gadget/gadget/functions/midi2.name/ep.number/block.number
34 Date: Jul 2023
35 KernelVersion: 6.6
36 Description:
37 This group contains a UMP Function Block configuration.
38 A new block starts from 0, and can be up to 31.
39
40 The attributes:
41
42 ================= ==============================================
43 name Function Block name string
44 direction 1: input, 2: output, 3: bidirectional
45 first_group The first UMP Group number (0-15)
46 num_groups The number of groups in this FB (1-16)
47 midi1_first_group The first UMP Group number for MIDI 1.0 (0-15)
48 midi1_num_groups The number of groups for MIDI 1.0 (0-16)
49 ui_hint 0: unknown, 1: receiver, 2: sender, 3: both
50 midi_ci_version Supported MIDI-CI version number (8 bit)
51 is_midi1 Legacy MIDI 1.0 device (0, 1 or 2)
52 sysex8_streams Max number of SysEx8 streams (8 bit)
53 active Active FB flag (0 or 1)
54 ================= ==============================================
55

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

USB MIDI 2.0 function instance

1-11
항목내용
What/config/usb-gadget/gadget/functions/midi2.name
Date2023년 7월
KernelVersion6.6
Attribute설명
process_umpUMP Stream message를 처리할지 정하는 flag, 0 또는 1
static_blockStatic block을 위한 flag, 0 또는 1
iface_nameMIDI interface 이름 문자열

UMP Endpoint 0-3 configuration

13-31
항목내용
What/config/usb-gadget/gadget/functions/midi2.name/ep.number
Date2023년 7월
KernelVersion6.6
DescriptionUMP Endpoint configuration을 담는다. 새 Endpoint 번호는 0에서 시작하며 최대 3까지 가능하다.
Attribute설명
protocol_capsMIDI protocol capability. 1, 2 또는 둘 다를 뜻하는 3
protocolDefault MIDI protocol, 1 또는 2
ep_nameUMP Endpoint 이름 문자열
product_idProduct ID 문자열
manufacturerManufacturer ID, 24 bit
familyDevice family ID, 16 bit
modelDevice model ID, 16 bit
sw_revisionSoftware Revision, 32 bit

UMP Function Block 0-31 configuration

33-54
항목내용
What/config/usb-gadget/gadget/functions/midi2.name/ep.number/block.number
Date2023년 7월
KernelVersion6.6
DescriptionUMP Function Block configuration을 담는다. 새 block 번호는 0에서 시작하며 최대 31까지 가능하다.
Attribute설명
nameFunction Block 이름 문자열
direction1은 input, 2는 output, 3은 bidirectional
first_group첫 UMP Group 번호, 0-15
num_groups이 Function Block의 group 수, 1-16
midi1_first_groupMIDI 1.0을 위한 첫 UMP Group 번호, 0-15
midi1_num_groupsMIDI 1.0을 위한 group 수, 0-16
ui_hint0은 unknown, 1은 receiver, 2는 sender, 3은 both
midi_ci_version지원하는 MIDI-CI version number, 8 bit
is_midi1Legacy MIDI 1.0 device 값, 0, 1 또는 2
sysex8_streamsSysEx8 stream의 maximum number, 8 bit
activeActive Function Block flag, 0 또는 1
MIDI 2.0 function의 UMP endpoint와 function block 계층
functions/midi2.nameprocess_ump / static_block / iface_nameMIDI 2.0 function
MIDI 2.0 functionep.0-ep.3protocol_caps / protocolEndpoint identity
ep.numberblock.0-block.31directionfirst_group + num_groupsUMP group mapping
Function BlockMIDI 1.0 group mappingMIDI-CI / SysEx8 capabilityactive flag

Function instance 아래 최대 네 endpoint를 두고, 각 endpoint 아래 최대 32개 function block이 UMP group과 protocol capability를 기술한다.