Imagination Technologies Pistachio Pin Controllers

Pistachio 복합 pin controller

Pistachio의 pin controller는 GPIO controller, GPIO interrupt controller, pinmux와 pinconf device를 결합한 장치입니다.

Pistachio의 system 또는 east pin controller에는 pin 99개가 있고, 그중 MFIO 90개를 GPIO로 구성할 수 있습니다. GPIO 90개는 각각 최대 16개 GPIO를 갖는 bank 6개로 나뉘며, 각 bank는 pad controller 노드의 하위 노드로 표현합니다.

공통 pin controller, GPIO, interrupt binding은 각각 `pinctrl-bindings.txt`, `../gpio/gpio.txt`, `../interrupt-controller/interrupts.txt`를 참조합니다.

Controller와 GPIO bank 필수 속성

Pin controller 노드의 필수 `compatible` 값은 `img,pistachio-system-pinctrl`이며 `reg`에는 pinctrl register 주소 범위를 지정합니다.

GPIO bank 하위 노드의 `interrupts`는 bank의 interrupt line을 지정합니다. `gpio-controller`와 `interrupt-controller`는 각각 GPIO controller와 interrupt controller임을 표시합니다.

`#gpio-cells`는 2여야 합니다. 첫 cell은 GPIO pin 번호이고 둘째 cell은 polarity이며 가능한 값은 `dt-bindings/gpio/gpio.h`를 따릅니다. `#interrupt-cells`도 2여야 하며 첫 cell은 GPIO pin 번호, 둘째 cell은 interrupt flag이고 유효한 값은 `dt-bindings/interrupt-controller/irq.h`를 따릅니다.

GPIO bank 하위 노드 N개는 반드시 `gpio0`, `gpio1`, ... `gpioN-1` 형식으로 이름을 붙여야 합니다.

Pin configuration 속성

Pin configuration 하위 노드의 필수 `pins`는 설정을 적용할 pin 목록입니다.

선택 `function`은 지정한 pin의 mux function이며 MFIO가 아닌 pin에는 적용되지 않습니다. 유효한 pin별 function은 다음 표에 있습니다.

`bias-high-impedance`, `bias-pull-up`, `bias-pull-down`, `bias-bus-hold`는 각각 high-impedance, weak pull-up, weak pull-down, bus-keeper mode를 켭니다.

`drive-strength`는 mA 단위이며 2, 4, 8, 12를 지원합니다. `input-schmitt-enable`과 `input-schmitt-disable`은 Schmitt trigger를 켜거나 끕니다. `slew-rate`는 0이면 slow, 1이면 fast입니다.

Pistachio pin과 function 전체 표

MFIO0부터 MFIO89까지의 mux function과 JTAG·reset 관련 고정 pin을 원문 순서로 정리한 전체 표입니다. Function이 비어 있는 행은 문서에 별도 mux function이 열거되지 않은 pin입니다.

Pistachio GPIO와 UART0 예제

예제는 첫째와 여섯째 GPIO bank를 GPIO 및 interrupt controller로 정의하고 UART0의 Rx·Tx·RTS·CTS를 `mfio55`부터 `mfio58`에 mux합니다.

UART consumer는 두 configuration phandle을 기본 상태로 참조합니다. Fixed regulator는 `gpio5`의 GPIO 6을 active-high VBUS 제어선으로 사용합니다.

pinctrl@18101c00 {
        compatible = "img,pistachio-system-pinctrl";
        reg = <0x18101C00 0x400>;

        gpio0: gpio0 {
                interrupts = <GIC_SHARED 71 IRQ_TYPE_LEVEL_HIGH>;

                gpio-controller;
                #gpio-cells = <2>;

                interrupt-controller;
                #interrupt-cells = <2>;
        };

        ...

        gpio5: gpio5 {
                interrupts = <GIC_SHARED 76 IRQ_TYPE_LEVEL_HIGH>;

                gpio-controller;
                #gpio-cells = <2>;

                interrupt-controller;
                #interrupt-cells = <2>;
        };

        ...

        uart0_xfer: uart0-xfer {
                uart0-rxd {
                        pins = "mfio55";
                        function = "uart0";
                };
                uart0-txd {
                        pins = "mfio56";
                        function = "uart0";
                };
        };

        uart0_rts_cts: uart0-rts-cts {
                uart0-rts {
                          pins = "mfio57";
                          function = "uart0";
                };
                uart0-cts {
                          pins = "mfio58";
                          function = "uart0";
                };
        };
};

uart@... {
        ...
        pinctrl-names = "default";
        pinctrl-0 = <&uart0_xfer>, <&uart0_rts_cts>;
        ...
};

usb_vbus: fixed-regulator {
        ...
        gpio = <&gpio5 6 GPIO_ACTIVE_HIGH>;
        ...
};