SiS I2C Multiple Touch Controller | Linux 6.18.37

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

sis_i2c.txt:1-31

attention·reset 신호와 주소 0x5c 예제를 설명합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기

1 * SiS I2C Multiple Touch Controller

3 Required properties:

4 - compatible: must be "sis,9200-ts"

5 - reg: i2c slave address

6 - interrupts: touch controller interrupt (see interrupt

7 binding [0])

9 Optional properties:

10 - pinctrl-names: should be "default" (see pinctrl binding [1]).

11 - pinctrl-0: a phandle pointing to the pin settings for the

12 device (see pinctrl binding [1]).

13 - attn-gpios: the gpio pin used as attention line

14 - reset-gpios: the gpio pin used to reset the controller

15 - wakeup-source: touchscreen can be used as a wakeup source

17 [0]: Documentation/devicetree/bindings/interrupt-controller/interrupts.txt

18 [1]: Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt

20 Example:

22 sis9255@5c {

23 compatible = "sis,9200-ts";

24 reg = <0x5c>;

25 pinctrl-names = "default";

26 pinctrl-0 = <&pinctrl_sis>;

27 interrupt-parent = <&gpio3>;

28 interrupts = <19 IRQ_TYPE_EDGE_FALLING>;

29 irq-gpios = <&gpio3 19 GPIO_ACTIVE_LOW>;

30 reset-gpios = <&gpio2 30 GPIO_ACTIVE_LOW>;

31 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

SiS I2C 멀티터치 속성

1-19

SiS I2C 멀티터치 컨트롤러의 필수 `compatible`은 `sis,9200-ts`, `reg`는 I2C slave 주소, `interrupts`는 터치 컨트롤러 인터럽트입니다. 인터럽트 형식은 `Documentation/devicetree/bindings/interrupt-controller/interrupts.txt`를 따릅니다.

선택 `pinctrl-names`는 `default`여야 하고 `pinctrl-0`은 장치 핀 설정을 가리키는 phandle이며 `Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt`를 따릅니다. `attn-gpios`는 attention line GPIO, `reset-gpios`는 컨트롤러 리셋 GPIO입니다. `wakeup-source`가 있으면 터치스크린을 시스템 깨우기 소스로 사용할 수 있습니다.

SiS 멀티터치 신호

default pinctrl장치 핀 설정

ATTN / IRQ GPIO터치 알림

SiS at 0x5c멀티터치 데이터

wakeup-source시스템 깨우기

기본 pinctrl과 attention·reset GPIO가 I2C 컨트롤러의 동작을 구성합니다.

SiS 9255 주소 0x5c 예제

20-31

예제는 주소 `0x5c`에 `sis,9200-ts` 호환 컨트롤러를 두고 기본 pinctrl을 연결합니다. GPIO3 핀 19의 falling-edge 인터럽트와 active-low 신호, GPIO2 핀 30의 active-low 리셋을 사용합니다. 예제의 GPIO 속성 이름은 원문 그대로 `irq-gpios`입니다.

sis9255@5c  {
        compatible = "sis,9200-ts";
        reg = <0x5c>;
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_sis>;
        interrupt-parent = <&gpio3>;
        interrupts = <19 IRQ_TYPE_EDGE_FALLING>;
        irq-gpios = <&gpio3 19 GPIO_ACTIVE_LOW>;
        reset-gpios = <&gpio2 30 GPIO_ACTIVE_LOW>;
};