SiS I2C Multiple Touch Controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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>;
};