ST-Ericsson Nomadik Pinctrl

Nomadik controller 필수 속성

ST-Ericsson Nomadik pinmux controller의 필수 `compatible`은 `stericsson,db8500-pinctrl`, `stericsson,db8540-pinctrl`, `stericsson,stn8815-pinctrl` 중 하나입니다.

`nomadik-gpio-chips`는 대응하는 GPIO chip들의 phandle 배열이며, 이 GPIO chip들이 pin controller가 사용하는 register range를 가집니다. `prcm`은 pin controller backend를 관리하는 PRCMU의 phandle입니다.

Client device의 공통 pinctrl binding과 "pin configuration node"의 의미는 이 directory의 `pinctrl-bindings.txt`를 참조합니다.

Container와 pin multiplexing subnode

ST-Ericsson pin configuration node는 임의 개수의 subnode를 담는 container입니다. 각 subnode는 pin 하나, group 하나 또는 pin/group 목록에 원하는 구성을 표현하며 mux function과 input·output·pull-up·pull-down 같은 pin configuration parameter를 포함할 수 있습니다.

Subnode 이름은 중요하지 않습니다. 모든 subnode를 열거한 뒤 이름이 아니라 content만으로 처리해야 합니다. Subnode는 표준 pin control binding의 generic pin multiplexing node layout을 사용합니다.

Pin multiplexing subnode에는 mux할 function 이름 string인 `function`과 pin group 이름 string 배열인 `groups`가 필수입니다. 각 group은 function과 결합되어 multiplexing setup을 만듭니다.

Pin configuration과 active 값

Pin configuration subnode에는 영향을 받는 pin을 나타내는 string 배열 `pins`와 pin configuration node handle인 `ste,config`가 필요합니다. 예를 들어 `ste,config = <&slpm_in_wkup_pdis>`처럼 사용합니다.

`ste,input`, `ste,output`, `ste,sleep`의 값과 의미는 다음과 같습니다.

Sleep input·output·GPIO·wakeup·pull

Sleep 상태의 input, output, GPIO mode, wake-up detection, pull resistor는 아래 값으로 구성합니다. `ste,sleep-input = <3>`은 no pull, pull-up, pull-down 중 마지막 input 구성을 유지합니다.

Controller와 UART0 state 예제

DB8500 controller 예제는 GPIO0부터 GPIO3까지의 chip과 PRCMU를 연결합니다. `slpm_in_wkup_pdis`, `slpm_out_hi_wkup_pdis`, `slpm_out_wkup_pdis` 세 reusable sleep configuration을 정의합니다.

UART0의 default mux는 `u0` function을 `u0_a_1`에 적용합니다. Default configuration에서 GPIO0·2는 pull-up input, GPIO1·3은 high output입니다. Sleep configuration에서는 GPIO0·2가 마지막 input 설정을 유지하고 GPIO1은 high output, GPIO3은 값 미지정 output을 사용하며 wake-up detection은 비활성화됩니다.

pinctrl@80157000 {
        compatible = "stericsson,db8500-pinctrl";
        nomadik-gpio-chips = <&gpio0>, <&gpio1>, <&gpio2>, <&gpio3>;
        prcm = <&prcmu>;

        pinctrl-names = "default";

        slpm_in_wkup_pdis: slpm_in_wkup_pdis {
                ste,sleep = <1>;
                ste,sleep-input = <3>;
                ste,sleep-wakeup = <1>;
                ste,sleep-pull-disable = <0>;
        };

        slpm_out_hi_wkup_pdis: slpm_out_hi_wkup_pdis {
                ste,sleep = <1>;
                ste,sleep-output = <1>;
                ste,sleep-wakeup = <1>;
                ste,sleep-pull-disable = <0>;
        };

        slpm_out_wkup_pdis: slpm_out_wkup_pdis {
                ste,sleep = <1>;
                ste,sleep-output = <2>;
                ste,sleep-wakeup = <1>;
                ste,sleep-pull-disable = <0>;
        };

        uart0 {
                uart0_default_mux: uart0_mux {
                        u0_default_mux {
                                function = "u0";
                                pins = "u0_a_1";
                        };
                };
                uart0_default_mode: uart0_default {
                        uart0_default_cfg1 {
                                pins = "GPIO0", "GPIO2";
                                ste,input = <1>;
                        };

                        uart0_default_cfg2 {
                                pins = "GPIO1", "GPIO3";
                                ste,output = <1>;
                        };
                };
                uart0_sleep_mode: uart0_sleep {
                        uart0_sleep_cfg1 {
                                pins = "GPIO0", "GPIO2";
                                ste,config = <&slpm_in_wkup_pdis>;
                        };
                        uart0_sleep_cfg2 {
                                pins = "GPIO1";
                                ste,config = <&slpm_out_hi_wkup_pdis>;
                        };
                        uart0_sleep_cfg3 {
                                pins = "GPIO3";
                                ste,config = <&slpm_out_wkup_pdis>;
                        };
                };
        };
};

PL011 UART consumer 예제

PL011 UART node는 `default`와 `sleep` 두 pinctrl state를 선언합니다. Default state는 UART0 mux와 active mode를 함께 참조하고, sleep state는 `uart0_sleep_mode`를 참조합니다.

uart@80120000 {
        compatible = "arm,pl011", "arm,primecell";
        reg = <0x80120000 0x1000>;
        interrupts = <0 11 0x4>;

        pinctrl-names = "default","sleep";
        pinctrl-0 = <&uart0_default_mux>, <&uart0_default_mode>;
        pinctrl-1 = <&uart0_sleep_mode>;
};