Nuvoton NPCM7XX Pinctrl

NPCM7XX pin controller

Nuvoton BMC NPCM7XX pin controller는 multiplexing block을 통해 여러 function을 route합니다. 각 pin은 GPIO function과 서로 다른 hardware block에 직접 연결되는 복수의 function을 지원합니다.

필수 속성은 값이 1인 `#address-cells`와 `#size-cells`, Poleg NPCM7XX용 `compatible = "nuvoton,npcm750-pinctrl"`, parent pin controller와 child GPIO bank 사이의 mapping range를 정의하는 `ranges`입니다.

GPIO bank subnode

NPCM7XX에는 8개 GPIO bank가 있고 각 bank는 GPIO 32개를 지원합니다. 각 subnode에는 register base와 size를 지정하는 `reg`, `gpio-controller`, 값이 2인 `#gpio-cells`, falling-edge flag를 포함한 bank `interrupts`, bank가 관리하는 pin 범위인 `gpio-ranges`가 필요합니다.

두 GPIO cell 가운데 첫 cell은 GPIO pin 번호이고 두 번째 cell은 선택적 parameter에 사용됩니다.

gpio0: gpio@f0010000 {
        gpio-controller;
        #gpio-cells = <2>;
        reg = <0x0 0x80>;
        interrupts = <GIC_SPI 116 IRQ_TYPE_LEVEL_HIGH>;
        gpio-ranges = <&pinctrl 0 0 32>;
};

Pin mux subnode와 전체 pin 목록

`pin`은 pin 이름 문자열 또는 여러 pin 이름의 문자열 배열이며, 이 pin들이 pin configuration 선택에 사용됩니다. 아래 표는 원문에 열거된 pin 이름 전체를 순서대로 보존합니다.

선택적 pin configuration 속성

선택 속성은 `bias-disable`, `bias-pull-down`, `bias-pull-up`, `input-enable`, `input-disable`, `output-high`, `output-low`, `drive-push-pull`, `drive-open-drain`, `input-debounce`, `slew-rate`, `drive-strength`입니다.

`slew-rate`는 0이면 slow, 1이면 fast입니다. `drive-strength`는 2, 4, 8, 12, 16, 24 mA 중 하나를 받습니다.

Pinmux subnode 예제

GPIO0/IOX1DI를 high output으로, GPIO2/IOX1CK도 high output으로 구성하는 두 pinmux subnode 예제입니다. 두 번째 node의 `output_high` 표기는 원문 그대로 보존합니다.

gpio0_iox1d1_pin: gpio0-iox1d1-pin {
        pins = "GPIO0/IOX1DI";
        output-high;
};
gpio0_iox1ck_pin: gpio0-iox1ck-pin {
        pins = "GPIO2/IOX1CK";
        output_high;
};

Pin group subnode와 전체 group/function 목록

Pin group subnode에는 mux할 group 이름인 `groups`와 그 group에 mux할 function 이름인 `function`이 필요합니다. 아래 표는 원문에 제시된 사용 가능 group과 function 이름 전체입니다.

Group subnode 예제

`r1err`, `r1md`, `r1` group을 각각 같은 이름의 function으로 mux하는 예제입니다.

r1err_pins: r1err-pins {
        groups = "r1err";
        function = "r1err";
};
r1md_pins: r1md-pins {
        groups = "r1md";
        function = "r1md";
};
r1_pins: r1-pins {
        groups = "r1";
        function = "r1";
};

NPCM750 pinctrl 전체 예제

NPCM750 controller의 address mapping, GPIO bank 0과 7, 개별 pin 구성, IOX group, CLKREQ group을 한 node에 구성한 전체 예제입니다. 중간의 `....`는 원문이 생략을 표시한 그대로입니다.

pinctrl: pinctrl@f0800000 {
        #address-cells = <1>;
        #size-cells = <1>;
        compatible = "nuvoton,npcm750-pinctrl";
        ranges = <0 0xf0010000 0x8000>;

        gpio0: gpio@f0010000 {
                gpio-controller;
                #gpio-cells = <2>;
                reg = <0x0 0x80>;
                interrupts = <GIC_SPI 116 IRQ_TYPE_LEVEL_HIGH>;
                gpio-ranges = <&pinctrl 0 0 32>;
        };

        ....

        gpio7: gpio@f0017000 {
                gpio-controller;
                #gpio-cells = <2>;
                reg = <0x7000 0x80>;
                interrupts = <GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH>;
                gpio-ranges = <&pinctrl 0 224 32>;
        };

        gpio0_iox1d1_pin: gpio0-iox1d1-pin {
                pins = "GPIO0/IOX1DI";
                output-high;
        };

        iox1_pins: iox1-pins {
                groups = "iox1";
                function = "iox1";
        };
        iox2_pins: iox2-pins {
                groups = "iox2";
                function = "iox2";
        };

        ....

        clkreq_pins: clkreq-pins {
                groups = "clkreq";
                function = "clkreq";
        };
};