Documentation/ABI/testing/sysfs-driver-hid GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Generic HID device sysfs ABI

USB·Bluetooth·hidraw HID device에서 raw binary report descriptor와 ASCII hexadecimal country code를 읽는 read-only interfaces를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-driver-hid
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Raw report descriptor and country code

sysfs-driver-hid:1-20

동일한 두 attributes가 USB, Bluetooth와 hidraw topology에 노출되며 report_descriptor는 binary, country는 ASCII hexadecimal integer를 반환합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/report_descriptor
2 What: /sys/class/bluetooth/hci<addr>/<hid-bus>:<vendor-id>:<product-id>.<num>/report_descriptor
3 What: /sys/class/hidraw/hidraw<num>/device/report_descriptor
4 Date: Jan 2011
5 KernelVersion: 2.0.39
6 Contact: Alan Ott <[email protected]>
7 Description: When read, this file returns the device's raw binary HID
8 report descriptor.
9 This file cannot be written.
10 Users: HIDAPI library (http://www.signal11.us/oss/hidapi)
11
12 What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/country
13 What: /sys/class/bluetooth/hci<addr>/<hid-bus>:<vendor-id>:<product-id>.<num>/country
14 What: /sys/class/hidraw/hidraw<num>/device/country
15 Date: February 2015
16 KernelVersion: 3.19
17 Contact: Olivier Gay <[email protected]>
18 Description: When read, this file returns the hex integer value in ASCII
19 of the device's HID country code (e.g. 21 for US).
20 This file cannot be written.
21

3. 한국어 전문 번역

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

Raw HID report descriptor

1-11
항목한국어 전문 번역
What/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/report_descriptor; /sys/class/bluetooth/hci<addr>/<hid-bus>:<vendor-id>:<product-id>.<num>/report_descriptor; /sys/class/hidraw/hidraw<num>/device/report_descriptor
Date2011년 1월
KernelVersion2.0.39
ContactAlan Ott <[email protected]>
DescriptionRead하면 device의 raw binary HID report descriptor를 반환합니다. 이 file에는 write할 수 없습니다.
UsersHIDAPI library (http://www.signal11.us/oss/hidapi)
Generic HID sysfs locations
TopologyAttribute location
USB.../<hid-bus>:<vendor-id>:<product-id>.<num>/
Bluetooth/sys/class/bluetooth/hci<addr>/.../
hidraw/sys/class/hidraw/hidraw<num>/device/

동일한 attributes가 연결 방식과 device-class별 path에 나타납니다.

HID country code

12-20
항목한국어 전문 번역
What/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/country; /sys/class/bluetooth/hci<addr>/<hid-bus>:<vendor-id>:<product-id>.<num>/country; /sys/class/hidraw/hidraw<num>/device/country
Date2015년 2월
KernelVersion3.19
ContactOlivier Gay <[email protected]>
DescriptionRead하면 device HID country code의 hexadecimal integer value를 ASCII로 반환합니다. 예를 들어 US는 21입니다. 이 file에는 write할 수 없습니다.