Toshiba TC3589x Multi-Purpose Expander

Toshiba TC3589x 다목적 expander

Toshiba TC3589x 계열은 I2C 기반 MFD이며 GPIO, keypad, rotator(vibrator), LED나 vibrator용 PWM을 내장할 수 있습니다. 포함되는 모델은 TC35890, TC35892, TC35893, TC35894, TC35895, TC35896입니다.

상위 MFD 필수 속성

`compatible`은 모델에 따라 `toshiba,tc35890`, `toshiba,tc35892`, `toshiba,tc35893`, `toshiba,tc35894`, `toshiba,tc35895`, `toshiba,tc35896` 중 하나입니다. `reg`는 I2C address, `interrupts`는 컨트롤러가 연결된 상위 interrupt입니다.

`interrupt-controller`는 이 노드를 interrupt controller로 표시합니다. `#interrupt-cells`는 `<1>`이며 첫 cell은 TC3589x interrupt controller 내부 IRQ offset입니다.

GPIO 자식과 interrupt flags

TC35890과 TC35892의 GPIO module은 24개, 나머지 모델은 20개의 GPIO line을 갖습니다. GPIO 자식의 `compatible`은 `toshiba,tc3589x-gpio`, `interrupts`는 상위 TC3589x MFD에 연결된 interrupt입니다.

GPIO 자식의 `interrupt-controller`와 `#interrupt-cells = <2>`는 첫 cell을 GPIO IRQ offset, 둘째 cell을 `<dt-bindings/interrupt-controller/irq.h>`에 따른 interrupt flags로 정의합니다. 유효한 flags는 `IRQ_TYPE_LEVEL_LOW`, `IRQ_TYPE_LEVEL_HIGH`, `IRQ_TYPE_EDGE_RISING`, `IRQ_TYPE_EDGE_FALLING`, `IRQ_TYPE_EDGE_BOTH`입니다.

`gpio-controller`는 자식을 GPIO controller로 표시합니다. `#gpio-cells = <2>`에서 첫 cell은 GPIO offset, 둘째 cell은 flags입니다.

Keypad 자식 속성

모든 variant의 keypad는 같으며 최대 96개 key를 지원합니다. Linux 전용 속성은 기존 input driver의 모델을 따릅니다. `compatible`은 `toshiba,tc3589x-keypad`, `debounce-delay-ms`는 millisecond 단위 debounce interval입니다.

`keypad,num-rows`와 `keypad,num-columns`는 matrix 행·열 수이며 `bindings/input/matrix-keymap.txt`를 따릅니다. `linux,keymap` 정의도 같은 문서에 있습니다. `linux,no-autorepeat`는 autorepeat 기능을 끄고, `wakeup-source`는 모든 keypad event를 wakeup event로 사용합니다. legacy 속성 `linux,wakeup`도 지원합니다.

TC35893 GPIO·keypad 예제

예제의 TC35893은 I2C 주소 `0x44`, GPIO6 pin 26 rising-edge interrupt, 한 cell 상위 IRQ domain을 사용합니다. GPIO 자식은 local interrupt 0과 두 cell IRQ·GPIO specifier를 제공합니다.

Keypad 자식은 local interrupt 6, 4ms debounce, 8열·8행 matrix, autorepeat 비활성화, 18개 keymap 값과 `wakeup-source`를 지정합니다.

tc35893@44 {
        compatible = "toshiba,tc35893";
        reg = <0x44>;
        interrupt-parent = <&gpio6>;
        interrupts = <26 IRQ_TYPE_EDGE_RISING>;

        interrupt-controller;
        #interrupt-cells = <1>;

        tc3589x_gpio {
                compatible = "toshiba,tc3589x-gpio";
                interrupts = <0>;

                interrupt-controller;
                #interrupt-cells = <2>;
                gpio-controller;
                #gpio-cells = <2>;
        };
        tc3589x_keypad {
                compatible = "toshiba,tc3589x-keypad";
                interrupts = <6>;
                debounce-delay-ms = <4>;
                keypad,num-columns = <8>;
                keypad,num-rows = <8>;
                linux,no-autorepeat;
                linux,keymap = <0x0301006b
                                0x04010066
                                0x06040072
                                0x040200d7
                                0x0303006a
                                0x0205000e
                                0x0607008b
                                0x0500001c
                                0x0403000b
                                0x03040034
                                0x05020067
                                0x0305006c
                                0x040500e7
                                0x0005009e
                                0x06020073
                                0x01030039
                                0x07060069
                                0x050500d9>;
                wakeup-source;
        };
};