N-Trig touchscreen filtering sysfs ABI | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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: [email protected]

5 Description:

6 (RW) Number of contact frames ignored before acknowledging the

7 start of activity (activating touch).

10 What: /sys/bus/hid/drivers/ntrig/<dev>/decativate_slack

11 Date: May, 2010

12 KernelVersion: 2.6.35

13 Contact: [email protected]

14 Description:

15 (RW) Number of empty (no contact) frames ignored before

16 acknowledging the end of activity (deactivating touch).

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.

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: [email protected]

29 Description:

30 Threholds to override activation slack.

32 ================= =====================================

33 activation_width (RW) Width threshold to immediately

34 start processing touch events.

36 activation_height (RW) Height threshold to immediately

37 start processing touch events.

38 ================= =====================================

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: [email protected]

45 Description:

46 Minimum size contact accepted.

48 ========== ===========================================

49 min_width (RW) Minimum touch contact width to decide

50 activation and activity.

52 min_height (RW) Minimum touch contact height to decide

53 activation and activity.

54 ========== ===========================================

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: [email protected]

62 Description:

63 (RO) These are internal ranges not used for normal events but

64 useful for tuning.

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: [email protected]

72 Description:

73 (RO) The range for positions reported during activity.

3. 한국어 전문 번역

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

Touch activation frame slack

1-9

항목	한국어 전문 번역
What	/sys/bus/hid/drivers/ntrig/<dev>/activate_slack
Date	2010년 5월
KernelVersion	2.6.35
Contact	[email protected]
Description	Touch 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
Date	2010년 5월
KernelVersion	2.6.35
Contact	[email protected]
Description	Touch 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
Date	2010년 5월
KernelVersion	2.6.35
Contact	[email protected]
Description	Activation 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
Date	2010년 5월
KernelVersion	2.6.35
Contact	[email protected]
Description	Accepted 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
Date	2010년 5월
KernelVersion	2.6.35
Contact	[email protected]
Description	Normal 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
Date	2010년 5월
KernelVersion	2.6.35
Contact	[email protected]
Description	Activity 중 report되는 positions의 read-only logical range입니다.