요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Real model identity and pedal axes
sysfs-driver-hid-logitech-lg4ff:59-75real_id는 alternate mode와 무관한 실제 wheel model을 읽고 combine_pedals는 accelerator와 brake를 Y axis 하나로 합칩니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/hid/drivers/logitech/<dev>/range
2
Date: July 2011
3
KernelVersion: 3.2
4
Contact: Michal Malý <madcatxster@devoid-pointer.net>
5
Description: Display minimum, maximum and current range of the steering
6
wheel. Writing a value within min and max boundaries sets the
7
range of the wheel.
9
What: /sys/bus/hid/drivers/logitech/<dev>/alternate_modes
10
Date: Feb 2015
11
KernelVersion: 4.1
12
Contact: Michal Malý <madcatxster@devoid-pointer.net>
13
Description: Displays a set of alternate modes supported by a wheel. Each
14
mode is listed as follows:
16
Tag: Mode Name
18
Currently active mode is marked with an asterisk. List also
19
contains an abstract item "native" which always denotes the
20
native mode of the wheel. Echoing the mode tag switches the
21
wheel into the corresponding mode. Depending on the exact model
22
of the wheel not all listed modes might always be selectable.
23
If a wheel cannot be switched into the desired mode, -EINVAL
24
is returned accompanied with an explanatory message in the
25
kernel log.
26
This entry is not created for devices that have only one mode.
28
Currently supported mode switches:
30
Driving Force Pro::
32
DF-EX --> DFP
34
G25::
36
DF-EX --> DFP --> G25
38
G27::
40
DF-EX <*> DFP <-> G25 <-> G27
41
DF-EX <*--------> G25 <-> G27
42
DF-EX <*----------------> G27
44
G29::
46
DF-EX <*> DFP <-> G25 <-> G27 <-> G29
47
DF-EX <*--------> G25 <-> G27 <-> G29
48
DF-EX <*----------------> G27 <-> G29
49
DF-EX <*------------------------> G29
51
DFGT::
53
DF-EX <*> DFP <-> DFGT
54
DF-EX <*--------> DFGT
56
* hid_logitech module must be loaded with lg4ff_no_autoswitch=1
57
parameter set in order for the switch to DF-EX mode to work.
59
What: /sys/bus/hid/drivers/logitech/<dev>/real_id
60
Date: Feb 2015
61
KernelVersion: 4.1
62
Contact: Michal Malý <madcatxster@devoid-pointer.net>
63
Description: Displays the real model of the wheel regardless of any
64
alternate mode the wheel might be switched to.
65
It is a read-only value.
66
This entry is not created for devices that have only one mode.
68
What: /sys/bus/hid/drivers/logitech/<dev>/combine_pedals
69
Date: Sep 2016
70
KernelVersion: 4.9
71
Contact: Simon Wood <simon@mungewell.org>
72
Description: Controls whether a combined value of accelerator and brake is
73
reported on the Y axis of the controller. Useful for older games
74
which can do not work with separate accelerator/brake axis.
75
Off ('0') by default, enabled by setting '1'.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Steering-wheel range
1-8| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/drivers/logitech/<dev>/range |
| Date | 2011년 7월 |
| KernelVersion | 3.2 |
| Contact | Michal Malý <madcatxster@devoid-pointer.net> |
| Description | Steering wheel의 minimum, maximum과 current range를 표시합니다. Min/max boundaries 안의 값을 write하면 wheel range를 설정합니다. |
Alternate wheel modes
9-58| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/drivers/logitech/<dev>/alternate_modes |
| Date | 2015년 2월 |
| KernelVersion | 4.1 |
| Contact | Michal Malý <madcatxster@devoid-pointer.net> |
| Description | Wheel이 지원하는 alternate modes를 "Tag: Mode Name" 형식으로 표시하고 currently active mode에는 asterisk를 붙입니다. Abstract item "native"는 항상 wheel의 native mode를 뜻합니다. Mode tag를 echo하면 해당 mode로 전환하지만 model에 따라 나열된 mode가 항상 선택 가능한 것은 아닙니다. 전환할 수 없으면 -EINVAL과 kernel log의 설명 message를 반환합니다. Mode가 하나뿐인 device에는 이 entry를 만들지 않습니다. DF-EX mode 전환에는 hid_logitech module의 lg4ff_no_autoswitch=1 parameter가 필요합니다. |
WheelSupported switch path
Driving Force ProDF-EX --> DFP
G25DF-EX --> DFP --> G25
G27DF-EX <*> DFP <-> G25 <-> G27
G27DF-EX <*--------> G25 <-> G27
G27DF-EX <*----------------> G27
G29DF-EX <*> DFP <-> G25 <-> G27 <-> G29
G29DF-EX <*--------> G25 <-> G27 <-> G29
G29DF-EX <*----------------> G27 <-> G29
G29DF-EX <*------------------------> G29
DFGTDF-EX <*> DFP <-> DFGT
DFGTDF-EX <*--------> DFGT
원문의 각 ASCII transition line을 model별로 그대로 구조화했습니다.
Real wheel model identifier
59-67| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/drivers/logitech/<dev>/real_id |
| Date | 2015년 2월 |
| KernelVersion | 4.1 |
| Contact | Michal Malý <madcatxster@devoid-pointer.net> |
| Description | Wheel이 전환된 alternate mode와 관계없이 실제 model을 표시하는 read-only value입니다. Mode가 하나뿐인 device에는 이 entry를 만들지 않습니다. |
Combined accelerator and brake axis
68-75| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/drivers/logitech/<dev>/combine_pedals |
| Date | 2016년 9월 |
| KernelVersion | 4.9 |
| Contact | Simon Wood <simon@mungewell.org> |
| Description | Accelerator와 brake의 combined value를 controller Y axis에 report할지 제어합니다. Separate accelerator/brake axes로 동작하지 않는 older games에 유용합니다. Default는 off("0")이며 "1"을 설정하면 enable됩니다. |
ValueReported axes
0, defaultSeparate accelerator and brake axes
1Combined value on controller Y axis
Accelerator와 brake axis presentation을 binary value로 전환합니다.
Steering range and alternate modes
sysfs-driver-hid-logitech-lg4ff:1-58range는 min/max/current wheel range를 다루고 alternate_modes는 active mode 표시, native mode와 model별 mode-switch graph를 제공합니다.