Freescale MX25 Touchscreen Conversion Queue | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

fsl-mx25-tcq.txt:1-34

펜 임계값, 안정화 시간과 4선 패널 구성을 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Freescale mx25 TS conversion queue module

3 mx25 touchscreen conversion queue module which controls the ADC unit of the

4 mx25 for attached touchscreens.

6 Required properties:

7 - compatible: Should be "fsl,imx25-tcq".

8 - reg: Memory range of the device.

9 - interrupts: Should be the interrupt number associated with this module within

10 the tscadc unit (<0>).

11 - fsl,wires: Should be '<4>' or '<5>'

13 Optional properties:

14 - fsl,pen-debounce-ns: Pen debounce time in nanoseconds.

15 - fsl,pen-threshold: Pen-down threshold for the touchscreen. This is a value

16 between 1 and 4096. It is the ratio between the internal reference voltage

17 and the measured voltage after the plate was precharged. Resistance between

18 plates and therefore the voltage decreases with pressure so that a smaller

19 value is equivalent to a higher pressure.

20 - fsl,settling-time-ns: Settling time in nanoseconds. The settling time is before

21 the actual touch detection to wait for an even charge distribution in the

22 plate.

24 This device includes two conversion queues which can be added as subnodes.

25 The first queue is for the touchscreen, the second for general purpose ADC.

27 Example:

28 tsc: tcq@50030400 {

29 compatible = "fsl,imx25-tcq";

30 reg = <0x50030400 0x60>;

31 interrupt-parent = <&tscadc>;

32 interrupts = <0>;

33 fsl,wires = <4>;

34 };

3. 한국어 전문 번역

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

Freescale MX25 변환 큐 속성

1-26

MX25 터치스크린 변환 큐 모듈은 연결된 터치스크린을 위해 MX25의 ADC 유닛을 제어합니다. `compatible`은 `fsl,imx25-tcq`, `reg`는 장치 메모리 범위, `interrupts`는 TSCADC 유닛 내부에서 이 모듈에 연결된 인터럽트 번호 `<0>`입니다. `fsl,wires`는 `<4>` 또는 `<5>`여야 합니다.

선택 속성 `fsl,pen-debounce-ns`는 ns 단위 펜 디바운스 시간입니다. `fsl,pen-threshold`는 1~4096 범위의 pen-down 임계값으로, 내부 기준 전압과 플레이트를 미리 충전한 뒤 측정한 전압의 비율입니다. 압력이 커지면 플레이트 사이 저항과 전압이 감소하므로 더 작은 값이 더 높은 압력에 해당합니다.

`fsl,settling-time-ns`는 실제 터치 감지 전에 플레이트 전하가 고르게 분포되도록 기다리는 ns 단위 안정화 시간입니다. 장치에는 하위 노드로 추가할 수 있는 두 변환 큐가 있으며 첫 번째는 터치스크린용, 두 번째는 범용 ADC용입니다.

MX25 이중 변환 큐

4선 또는 5선 패널펜 임계값과 안정화

MX25 TSCADCADC 변환

Queue 0터치스크린

Queue 1범용 ADC

공유 ADC가 터치스크린 큐와 범용 ADC 큐를 분리해 처리합니다.

4선 MX25 TCQ 예제

27-34

예제는 `0x50030400`의 0x60-byte 영역에 `fsl,imx25-tcq`를 두고 TSCADC parent의 인터럽트 0을 연결하며 4선 패널을 선택합니다.

tsc: tcq@50030400 {
        compatible = "fsl,imx25-tcq";
        reg = <0x50030400 0x60>;
        interrupt-parent = <&tscadc>;
        interrupts = <0>;
        fsl,wires = <4>;
};