← Documents Documentation/devicetree/bindings/input/microchip,qt1050.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Microchip AT42QT1050 Touch Sensor

5-channel QTouchADC key와 per-key sensing parameter 바인딩입니다.

Source pathDocumentation/devicetree/bindings/input/microchip,qt1050.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

microchip,qt1050.txt:1-78

불연속 key 구성과 precharge, averaging, threshold를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 Microchip AT42QT1050 Five-channel Touch Sensor IC
2
3 The AT42QT1050 (QT1050) is a QTouchADC sensor device. The device can sense from
4 one to five keys, dependent on mode. The QT1050 includes all signal processing
5 functions necessary to provide stable sensing under a wide variety of changing
6 conditions, and the outputs are fully debounced.
7
8 The touchkey device node should be placed inside an I2C bus node.
9
10 Required properties:
11 - compatible: Must be "microchip,qt1050"
12 - reg: The I2C address of the device
13 - interrupts: The sink for the touchpad's IRQ output,
14 see ../interrupt-controller/interrupts.txt
15
16 Optional properties:
17 - wakeup-source: touch keys can be used as a wakeup source
18
19 Each button (key) is represented as a sub-node:
20
21 Each not specified key or key with linux,code set to KEY_RESERVED gets disabled
22 in HW.
23
24 Subnode properties:
25 - linux,code: Keycode to emit.
26 - reg: The key number. Valid values: 0, 1, 2, 3, 4.
27
28 Optional subnode-properties:
29
30 If a optional property is missing or has a invalid value the default value is
31 taken.
32
33 - microchip,pre-charge-time-ns:
34 Each touchpad need some time to precharge. The value depends on the mechanical
35 layout.
36 Valid value range: 0 - 637500; values must be a multiple of 2500;
37 default is 0.
38 - microchip,average-samples:
39 Number of data samples which are averaged for each read.
40 Valid values: 1, 4, 16, 64, 256, 1024, 4096, 16384; default is 1.
41 - microchip,average-scaling:
42 The scaling factor which is used to scale the average-samples.
43 Valid values: 1, 2, 4, 8, 16, 32, 64, 128; default is 1.
44 - microchip,threshold:
45 Number of counts to register a touch detection.
46 Valid value range: 0 - 255; default is 20.
47
48 Example:
49 QT1050 with 3 non continuous keys, key2 and key4 are disabled.
50
51 touchkeys@41 {
52 compatible = "microchip,qt1050";
53 reg = <0x41>;
54 interrupt-parent = <&gpio0>;
55 interrupts = <17 IRQ_TYPE_EDGE_FALLING>;
56
57 up@0 {
58 reg = <0>;
59 linux,code = <KEY_UP>;
60 microchip,average-samples = <64>;
61 microchip,average-scaling = <16>;
62 microchip,pre-charge-time-ns = <10000>;
63 };
64
65 right@1 {
66 reg = <1>;
67 linux,code = <KEY_RIGHT>;
68 microchip,average-samples = <64>;
69 microchip,average-scaling = <8>;
70 };
71
72 down@3 {
73 reg = <3>;
74 linux,code = <KEY_DOWN>;
75 microchip,average-samples = <256>;
76 microchip,average-scaling = <16>;
77 };
78 };
79

3. 한국어 전문 번역

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

AT42QT1050 key와 I2C 속성

1-27

Microchip AT42QT1050(QT1050)은 QTouchADC sensor device이며 mode에 따라 key 1~5개를 감지합니다. 다양한 변화 조건에서도 안정적으로 sensing하는 데 필요한 signal processing을 모두 포함하고 output은 완전히 debounce됩니다. Touchkey node는 I2C bus node 안에 둡니다.

필수 `compatible`은 `microchip,qt1050`, `reg`는 device I2C address, `interrupts`는 touchpad IRQ output의 sink이며 `../interrupt-controller/interrupts.txt`를 참조합니다. 선택 `wakeup-source`는 touch key를 wakeup source로 사용할 수 있게 합니다.

각 button은 subnode 하나로 나타냅니다. 명시하지 않은 key 또는 `linux,code = KEY_RESERVED`인 key는 hardware에서 비활성화됩니다. Subnode의 `linux,code`는 내보낼 keycode, `reg`는 0, 1, 2, 3, 4 중 하나인 key number입니다.

QT1050 per-key tuning

28-47

선택 subnode property가 없거나 값이 invalid하면 기본값을 사용합니다. `microchip,pre-charge-time-ns`는 mechanical layout에 따른 touchpad precharge time으로 0~637500 범위의 2500 배수이며 기본 0입니다.

`microchip,average-samples`는 read마다 평균할 sample 수로 1, 4, 16, 64, 256, 1024, 4096, 16384 중 하나이며 기본 1입니다. `microchip,average-scaling`은 average-samples에 적용할 scaling factor로 1, 2, 4, 8, 16, 32, 64, 128 중 하나이며 기본 1입니다. `microchip,threshold`는 touch detection을 등록할 count 수로 0~255이고 기본 20입니다.

QT1050 key tuning ranges
PropertyAllowedDefault
pre-charge-time-ns0..637500, step 25000
average-samples1..16384 power-of-4 sequence1
average-scaling1..128 power-of-21
threshold0..25520

각 optional subnode property의 허용값과 기본값입니다.

불연속 key 3개 예제

48-78

예제 QT1050은 I2C address `0x41`과 GPIO0 falling-edge interrupt 17을 사용합니다. 불연속 key 0, 1, 3만 `KEY_UP`, `KEY_RIGHT`, `KEY_DOWN`으로 정의하여 key 2와 4를 비활성화합니다. Up key는 average 64, scaling 16, precharge 10000 ns, right key는 average 64와 scaling 8, down key는 average 256과 scaling 16을 사용합니다.

touchkeys@41 {
        compatible = "microchip,qt1050";
        reg = <0x41>;
        interrupt-parent = <&gpio0>;
        interrupts = <17 IRQ_TYPE_EDGE_FALLING>;

        up@0 {
                reg = <0>;
                linux,code = <KEY_UP>;
                microchip,average-samples = <64>;
                microchip,average-scaling = <16>;
                microchip,pre-charge-time-ns = <10000>;
        };

        right@1 {
                reg = <1>;
                linux,code = <KEY_RIGHT>;
                microchip,average-samples = <64>;
                microchip,average-scaling = <8>;
        };

        down@3 {
                reg = <3>;
                linux,code = <KEY_DOWN>;
                microchip,average-samples = <256>;
                microchip,average-scaling = <16>;
        };
};