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

Linux 6.18.37 · ABI / testing

N-Trig touchscreen filtering sysfs ABI

N-Trig touchscreen의 activation/deactivation frame slack, immediate-activation thresholds, minimum contact size와 physical/logical sensor ranges를 설명합니다.

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

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

1. 요약·해설

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

Touch activation and deactivation slack

sysfs-driver-hid-ntrig:1-23

Contact frame과 empty frame을 몇 개 무시한 뒤 touch 시작·종료를 인정할지 조정해 false activation 또는 transient disconnect를 완화합니다.

Contact thresholds and sensor ranges

sysfs-driver-hid-ntrig:24-73

Width/height thresholds가 slack을 override하거나 minimum accepted contact를 결정하고 read-only physical/logical ranges는 tuning과 reported positions를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/hid/drivers/ntrig/<dev>/activate_slack
2 Date: May, 2010
3 KernelVersion: 2.6.35
4 Contact: linux-input@vger.kernel.org
5 Description:
6 (RW) Number of contact frames ignored before acknowledging the
7 start of activity (activating touch).
8
9
10 What: /sys/bus/hid/drivers/ntrig/<dev>/decativate_slack
11 Date: May, 2010
12 KernelVersion: 2.6.35
13 Contact: linux-input@vger.kernel.org
14 Description:
15 (RW) Number of empty (no contact) frames ignored before
16 acknowledging the end of activity (deactivating touch).
17
18 When the last finger is removed from the device, it sends a
19 number of empty frames. By holding off on deactivation for a few
20 frames false erroneous disconnects can be tolerated, where the
21 sensor may mistakenly not detect a finger that is still present.
22
23
24 What: /sys/bus/hid/drivers/ntrig/<dev>/activation_width
25 What: /sys/bus/hid/drivers/ntrig/<dev>/activation_height
26 Date: May, 2010
27 KernelVersion: 2.6.35
28 Contact: linux-input@vger.kernel.org
29 Description:
30 Threholds to override activation slack.
31
32 ================= =====================================
33 activation_width (RW) Width threshold to immediately
34 start processing touch events.
35
36 activation_height (RW) Height threshold to immediately
37 start processing touch events.
38 ================= =====================================
39
40 What: /sys/bus/hid/drivers/ntrig/<dev>/min_width
41 What: /sys/bus/hid/drivers/ntrig/<dev>/min_height
42 Date: May, 2010
43 KernelVersion: 2.6.35
44 Contact: linux-input@vger.kernel.org
45 Description:
46 Minimum size contact accepted.
47
48 ========== ===========================================
49 min_width (RW) Minimum touch contact width to decide
50 activation and activity.
51
52 min_height (RW) Minimum touch contact height to decide
53 activation and activity.
54 ========== ===========================================
55
56
57 What: /sys/bus/hid/drivers/ntrig/<dev>/sensor_physical_width
58 What: /sys/bus/hid/drivers/ntrig/<dev>/sensor_physical_height
59 Date: May, 2010
60 KernelVersion: 2.6.35
61 Contact: linux-input@vger.kernel.org
62 Description:
63 (RO) These are internal ranges not used for normal events but
64 useful for tuning.
65
66
67 What: /sys/bus/hid/drivers/ntrig/<dev>/sensor_logical_width
68 What: /sys/bus/hid/drivers/ntrig/<dev>/sensor_logical_height
69 Date: May, 2010
70 KernelVersion: 2.6.35
71 Contact: linux-input@vger.kernel.org
72 Description:
73 (RO) The range for positions reported during activity.
74

3. 한국어 전문 번역

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

Touch activation frame slack

1-9
항목한국어 전문 번역
What/sys/bus/hid/drivers/ntrig/<dev>/activate_slack
Date2010년 5월
KernelVersion2.6.35
Contactlinux-input@vger.kernel.org
DescriptionTouch activity 시작을 인정하기 전에 무시할 contact frames의 수를 read/write합니다.
N-Trig touch-activity filtering
Contact frames beginIgnore activate_slack framesAcknowledge active touchLast finger removed and empty frames beginIgnore decativate_slack framesAcknowledge end of activity

Start와 end acknowledgement 앞에 각각 contact/empty frame slack을 둡니다.

Touch deactivation frame slack

10-23
항목한국어 전문 번역
What/sys/bus/hid/drivers/ntrig/<dev>/decativate_slack
Date2010년 5월
KernelVersion2.6.35
Contactlinux-input@vger.kernel.org
DescriptionTouch activity 종료를 인정하기 전에 무시할 empty(no-contact) frames의 수를 read/write합니다. 마지막 finger가 제거되면 device가 여러 empty frames를 보냅니다. Deactivation을 몇 frame 지연하면 sensor가 아직 존재하는 finger를 일시적으로 감지하지 못해 생기는 false erroneous disconnect를 허용할 수 있습니다.

Immediate-activation width and height

24-39
항목한국어 전문 번역
What/sys/bus/hid/drivers/ntrig/<dev>/activation_width; /sys/bus/hid/drivers/ntrig/<dev>/activation_height
Date2010년 5월
KernelVersion2.6.35
Contactlinux-input@vger.kernel.org
DescriptionActivation slack을 override하는 read/write thresholds입니다. activation_width는 touch event 처리를 즉시 시작할 width threshold이고 activation_height는 즉시 시작할 height threshold입니다.
Immediate-activation thresholds
AttributeAccessThreshold effect
activation_widthRead / writeImmediately start processing by width
activation_heightRead / writeImmediately start processing by height

원문의 width/height ASCII 표를 구조화했습니다.

Minimum accepted contact size

40-56
항목한국어 전문 번역
What/sys/bus/hid/drivers/ntrig/<dev>/min_width; /sys/bus/hid/drivers/ntrig/<dev>/min_height
Date2010년 5월
KernelVersion2.6.35
Contactlinux-input@vger.kernel.org
DescriptionAccepted contact의 minimum size를 정하는 read/write attributes입니다. min_width는 activation과 activity를 결정할 minimum touch-contact width이고 min_height는 minimum touch-contact height입니다.
Minimum contact dimensions
AttributeAccessDecision dimension
min_widthRead / writeMinimum width for activation and activity
min_heightRead / writeMinimum height for activation and activity

원문의 minimum width/height ASCII 표를 구조화했습니다.

Physical sensor ranges

57-66
항목한국어 전문 번역
What/sys/bus/hid/drivers/ntrig/<dev>/sensor_physical_width; /sys/bus/hid/drivers/ntrig/<dev>/sensor_physical_height
Date2010년 5월
KernelVersion2.6.35
Contactlinux-input@vger.kernel.org
DescriptionNormal events에는 사용하지 않지만 tuning에 유용한 read-only internal physical ranges입니다.
N-Trig sensor ranges
Range pairAccessUse
sensor_physical_width / heightRead-onlyInternal tuning ranges
sensor_logical_width / heightRead-onlyPositions reported during activity

Physical tuning ranges와 activity position ranges를 구분합니다.

Logical activity-position ranges

67-73
항목한국어 전문 번역
What/sys/bus/hid/drivers/ntrig/<dev>/sensor_logical_width; /sys/bus/hid/drivers/ntrig/<dev>/sensor_logical_height
Date2010년 5월
KernelVersion2.6.35
Contactlinux-input@vger.kernel.org
DescriptionActivity 중 report되는 positions의 read-only logical range입니다.