Documentation/ABI/testing/configfs-usb-gadget-hid GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

USB gadget HID function configfs ABI

USB HID function instance의 protocol, subclass, report length와 binary report descriptor를 구성하고 /dev/hidg<N> runtime data와 구분하는 configfs ABI를 설명합니다.

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

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

HID descriptor configuration

configfs-usb-gadget-hid:1-13

HID protocol과 subclass, report size 및 descriptor blob을 function instance에 설정하며 actual report data path는 /dev/hidg<N>입니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 What: /config/usb-gadget/gadget/functions/hid.name
2 Date: Nov 2014
3 KernelVersion: 3.19
4 Description:
5 The attributes:
6
7 ============= ============================================
8 protocol HID protocol to use
9 report_desc blob corresponding to HID report descriptors
10 except the data passed through /dev/hidg<N>
11 report_length HID report length
12 subclass HID device subclass to use
13 ============= ============================================
14

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

USB HID function instance attributes

1-13
항목내용
What/config/usb-gadget/gadget/functions/hid.name
Date2014년 11월
KernelVersion3.19
Attribute설명
protocol사용할 HID protocol
report_descHID report descriptor에 해당하는 blob이다. `/dev/hidg<N>`을 통해 전달되는 data는 여기에 포함되지 않는다.
report_lengthHID report length
subclass사용할 HID device subclass
HID descriptor와 runtime report data의 경계
functions/hid.nameprotocol / subclassHID interface identity
functions/hid.namereport_desc / report_lengthHID report format
Runtime HID report data/dev/hidg<N>USB HID transfer

Configfs attribute는 HID interface의 형식과 descriptor를 정하고, 실제 HID report payload는 hidg character device를 통과한다.