요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Z-axis click detection and feature toggles
sysfs-devices-platform-trackpoint:45-101thresh·upthresh·ztime·jenks는 press/release·select·double-click 판정을 조정하며 ext_dev와 press_to_select는 0/1로 기능을 끄고 켭니다.
Hands-off drift calibration
sysfs-devices-platform-trackpoint:102-115drift_time은 force가 없는 hands-off condition을 확인한 뒤 position을 새 zero로 삼기까지의 calibration period를 제어합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/devices/platform/i8042/.../sensitivity
2
Date: Aug, 2005
3
KernelVersion: 2.6.14
4
Contact: [email protected]
5
Description:
6
(RW) Trackpoint sensitivity.
8
What: /sys/devices/platform/i8042/.../intertia
9
Date: Aug, 2005
10
KernelVersion: 2.6.14
11
Contact: [email protected]
12
Description:
13
(RW) Negative inertia factor. High values cause the cursor to
14
snap backward when the trackpoint is released.
16
What: /sys/devices/platform/i8042/.../reach
17
Date: Aug, 2005
18
KernelVersion: 2.6.14
19
Contact: [email protected]
20
Description:
21
(RW) Backup range for z-axis press.
23
What: /sys/devices/platform/i8042/.../draghys
24
Date: Aug, 2005
25
KernelVersion: 2.6.14
26
Contact: [email protected]
27
Description:
28
(RW) The drag hysteresis controls how hard it is to drag with
29
z-axis pressed.
31
What: /sys/devices/platform/i8042/.../mindrag
32
Date: Aug, 2005
33
KernelVersion: 2.6.14
34
Contact: [email protected]
35
Description:
36
(RW) Minimum amount of force needed to trigger dragging.
38
What: /sys/devices/platform/i8042/.../speed
39
Date: Aug, 2005
40
KernelVersion: 2.6.14
41
Contact: [email protected]
42
Description:
43
(RW) Speed of the trackpoint cursor.
45
What: /sys/devices/platform/i8042/.../thresh
46
Date: Aug, 2005
47
KernelVersion: 2.6.14
48
Contact: [email protected]
49
Description:
50
(RW) Minimum value for z-axis force required to trigger a press
51
or release, relative to the running average.
53
What: /sys/devices/platform/i8042/.../upthresh
54
Date: Aug, 2005
55
KernelVersion: 2.6.14
56
Contact: [email protected]
57
Description:
58
(RW) The offset from the running average required to generate a
59
select (click) on z-axis on release.
61
What: /sys/devices/platform/i8042/.../ztime
62
Date: Aug, 2005
63
KernelVersion: 2.6.14
64
Contact: [email protected]
65
Description:
66
(RW) This attribute determines how sharp a press has to be in
67
order to be recognized.
69
What: /sys/devices/platform/i8042/.../jenks
70
Date: Aug, 2005
71
KernelVersion: 2.6.14
72
Contact: [email protected]
73
Description:
74
(RW) Minimum curvature in degrees required to generate a double
75
click without a release.
77
What: /sys/devices/platform/i8042/.../skipback
78
Date: Aug, 2005
79
KernelVersion: 2.6.14
80
Contact: [email protected]
81
Description:
82
(RW) When the skipback bit is set, backup cursor movement during
83
releases from drags will be suppressed. The default value for
84
this bit is 0.
86
What: /sys/devices/platform/i8042/.../ext_dev
87
Date: Aug, 2005
88
KernelVersion: 2.6.14
89
Contact: [email protected]
90
Description:
91
(RW) Disable (0) or enable (1) external pointing device.
93
What: /sys/devices/platform/i8042/.../press_to_select
94
Date: Aug, 2005
95
KernelVersion: 2.6.14
96
Contact: [email protected]
97
Description:
98
(RW) Writing a value of 1 to this file will enable the Press to
99
Select functions like tapping the control stick to simulate a
100
left click, and writing 0 will disable it.
102
What: /sys/devices/platform/i8042/.../drift_time
103
Date: Dec, 2014
104
KernelVersion: 3.19
105
Contact: [email protected]
106
Description:
107
(RW) This parameter controls the period of time to test for a
108
‘hands off’ condition (i.e. when no force is applied) before a
109
drift (noise) calibration occurs.
111
IBM Trackpoints have a feature to compensate for drift by
112
recalibrating themselves periodically. By default, if for 0.5
113
seconds there is no change in position, it's used as the new
114
zero. This duration is too low. Often, the calibration happens
115
when the trackpoint is in fact being used.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
TrackPoint sensitivity
1-7| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../sensitivity |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) TrackPoint sensitivity입니다. |
GroupAttributes
Cursor responsesensitivity, intertia, speed
Dragreach, draghys, mindrag, skipback
Z-axis clickthresh, upthresh, ztime, jenks
Feature switchesext_dev, press_to_select
Calibrationdrift_time
14개 RW attribute가 조정하는 interaction 영역입니다.
TrackPoint negative inertia
8-15| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../intertia |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Negative inertia factor입니다. 값이 높으면 TrackPoint를 놓을 때 cursor가 뒤로 튑니다. Sysfs path의 원문 표기는 intertia입니다. |
Z-axis press backup range
16-22| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../reach |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Z-axis press의 backup range입니다. |
reach defines backup range→mindrag minimum force→draghys drag hysteresis→skipback optionally suppresses release backup movement
Press force, hysteresis와 release behavior에 관여하는 attribute입니다.
TrackPoint drag hysteresis
23-30| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../draghys |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Drag hysteresis는 z-axis를 누른 상태에서 drag하기가 얼마나 어려운지 제어합니다. |
Minimum drag force
31-37| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../mindrag |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Dragging을 trigger하는 데 필요한 minimum force입니다. |
TrackPoint cursor speed
38-44| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../speed |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) TrackPoint cursor의 speed입니다. |
Z-axis press and release threshold
45-52| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../thresh |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Running average를 기준으로 press 또는 release를 trigger하는 데 필요한 z-axis force의 minimum value입니다. |
thresh detects press/release force→ztime evaluates press sharpness→upthresh generates select on release→jenks can generate double click without release
Running average와 press shape를 기준으로 press·release·click을 판정합니다.
Z-axis release select threshold
53-60| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../upthresh |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Z-axis release 시 select(click)를 생성하는 데 필요한 running average로부터의 offset입니다. |
Recognized press sharpness
61-68| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../ztime |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Press가 인식되려면 얼마나 sharp해야 하는지 결정합니다. |
Double-click curvature
69-76| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../jenks |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Release 없이 double click을 생성하는 데 필요한 degree 단위 minimum curvature입니다. |
Drag-release cursor backup suppression
77-85| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../skipback |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) Skipback bit를 set하면 drag release 중 발생하는 backup cursor movement를 억제합니다. 이 bit의 default 값은 0입니다. |
Attribute01
skipbackDefault; backup movement 허용Backup movement 억제
ext_devExternal device disableExternal device enable
press_to_selectDisableEnable tap-to-left-click
명시적으로 0/1 semantics가 정의된 switch입니다.
External pointing-device switch
86-92| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../ext_dev |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) External pointing device를 0으로 disable하거나 1로 enable합니다. |
Press-to-Select switch
93-101| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../press_to_select |
| Date | 2005년 8월 |
| KernelVersion | 2.6.14 |
| Contact | [email protected] |
| Description | (RW) 이 file에 1을 write하면 control stick을 tap해 left click을 simulate하는 Press-to-Select function을 enable하고, 0을 write하면 disable합니다. |
Hands-off drift-calibration period
102-115| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/i8042/.../drift_time |
| Date | 2014년 12월 |
| KernelVersion | 3.19 |
| Contact | [email protected] |
| Description | (RW) Drift(noise) calibration이 일어나기 전에 'hands off' condition, 즉 force가 가해지지 않는 상태를 검사할 time period를 제어합니다. IBM TrackPoint는 주기적으로 자체 recalibration하여 drift를 보상합니다. Default에서는 0.5 seconds 동안 position 변화가 없으면 그 position을 새 zero로 사용합니다. 이 duration은 너무 짧아서 실제로 TrackPoint를 사용 중일 때 calibration이 일어나는 경우가 많습니다. |
No position change→drift_time 동안 hands-off condition 검사→Current position을 new zero로 채택→Periodic drift compensation
Default 0.5-second inactivity period가 너무 짧아 active use 중 오인될 수 있습니다.
Cursor response and drag detection
sysfs-devices-platform-trackpoint:1-44, 77-85Sensitivity·speed·negative inertia는 cursor response를 조정하고 reach·draghys·mindrag·skipback은 z-axis drag 시작과 release 시 backup movement를 제어합니다.