Actions Semi S900 Pin Controller

Actions S900 pin controller

이 바인딩은 Actions Semi S900 SoC의 pin controller를 설명합니다. `compatible`은 `actions,s900-pinctrl`, `reg`는 controller register의 기본 주소와 크기, `clocks`는 controller clock phandle입니다.

`gpio-controller`와 `gpio-ranges`는 GPIO controller 역할과 pin-controller pin 매핑을 지정합니다. `#gpio-cells`는 2이며 첫 cell은 GPIO 번호, 두 번째 cell은 선택 매개변수입니다.

`interrupt-controller`는 interrupt controller 역할을 표시합니다. `#interrupt-cells`는 2이며 interrupt 번호와 `bindings/interrupt-controller/interrupts.txt`의 trigger flag를 전달합니다.

GPIO bank마다 interrupt 출력 하나가 있으며 `interrupts`는 bank 0부터 순서대로 나열합니다. 항목 수는 SoC의 GPIO bank 수에 따라 달라집니다.

공통 client 바인딩은 `pinctrl-bindings.txt`를 따릅니다. Pin configuration node는 여러 하위 노드의 container이며 각 노드는 pin이나 group에 적용할 mux function, pull-up, drive strength 등의 구성을 나타냅니다.

S900 pin configuration node 규칙

하위 노드 이름은 의미가 없고 내용만으로 처리합니다. 각 하위 노드는 명시한 매개변수에만 영향을 주므로 mux 설정은 생략된 pinconf 값을 암시하지 않고 pull-up 설정도 mux function을 암시하지 않습니다.

Pinmux function은 pin group에서만 선택할 수 있고 pinconf 매개변수는 group과 개별 pin 모두에 적용할 수 있습니다. 유효한 generic 속성은 `pinctrl-bindings.txt`가 정의합니다.

S900 pin 이름

필수 `pins`는 pull control과 Schmitt trigger 설정에 사용할 pin 이름 문자열 배열입니다. 사용 가능한 pin 식별자 전체는 다음과 같습니다.

eth_txd0, eth_txd1, eth_txen, eth_rxer, eth_crs_dv,
eth_rxd1, eth_rxd0, eth_ref_clk, eth_mdc, eth_mdio,
sirq0, sirq1, sirq2, i2s_d0, i2s_bclk0, i2s_lrclk0,
i2s_mclk0, i2s_d1, i2s_bclk1, i2s_lrclk1, i2s_mclk1,
pcm1_in, pcm1_clk, pcm1_sync, pcm1_out, eram_a5,
eram_a6, eram_a7, eram_a8, eram_a9, eram_a10, eram_a11,
lvds_oep, lvds_oen, lvds_odp, lvds_odn, lvds_ocp,
lvds_ocn, lvds_obp, lvds_obn, lvds_oap, lvds_oan,
lvds_eep, lvds_een, lvds_edp, lvds_edn, lvds_ecp,
lvds_ecn, lvds_ebp, lvds_ebn, lvds_eap, lvds_ean,
sd0_d0, sd0_d1, sd0_d2, sd0_d3, sd1_d0, sd1_d1,
sd1_d2, sd1_d3, sd0_cmd, sd0_clk, sd1_cmd, sd1_clk,
spi0_sclk, spi0_ss, spi0_miso, spi0_mosi, uart0_rx,
uart0_tx, uart2_rx, uart2_tx, uart2_rtsb, uart2_ctsb,
uart3_rx, uart3_tx, uart3_rtsb, uart3_ctsb, uart4_rx,
uart4_tx, i2c0_sclk, i2c0_sdata, i2c1_sclk, i2c1_sdata,
i2c2_sclk, i2c2_sdata, csi0_dn0, csi0_dp0, csi0_dn1,
csi0_dp1, csi0_cn, csi0_cp, csi0_dn2, csi0_dp2, csi0_dn3,
csi0_dp3, dsi_dp3, dsi_dn3, dsi_dp1, dsi_dn1, dsi_cp,
dsi_cn, dsi_dp0, dsi_dn0, dsi_dp2, dsi_dn2, sensor0_pclk,
csi1_dn0,csi1_dp0,csi1_dn1, csi1_dp1, csi1_cn, csi1_cp,
sensor0_ckout, nand0_d0, nand0_d1, nand0_d2, nand0_d3,
nand0_d4, nand0_d5, nand0_d6, nand0_d7, nand0_dqs,
nand0_dqsn, nand0_ale, nand0_cle, nand0_ceb0, nand0_ceb1,
nand0_ceb2, nand0_ceb3, nand1_d0, nand1_d1, nand1_d2,
nand1_d3, nand1_d4, nand1_d5, nand1_d6, nand1_d7, nand1_dqs,
nand1_dqsn, nand1_ale, nand1_cle, nand1_ceb0, nand1_ceb1,
nand1_ceb2, nand1_ceb3, sgpio0, sgpio1, sgpio2, sgpio3

S900 pin group

필수 `groups`는 pin group 이름 문자열 배열입니다. 다음 group들은 pinmux function 선택에 사용됩니다.

lvds_oxx_uart4_mfp, rmii_mdc_mfp, rmii_mdio_mfp, sirq0_mfp,
sirq1_mfp, rmii_txd0_mfp, rmii_txd1_mfp, rmii_txen_mfp,
rmii_rxer_mfp, rmii_crs_dv_mfp, rmii_rxd1_mfp, rmii_rxd0_mfp,
rmii_ref_clk_mfp, i2s_d0_mfp, i2s_d1_mfp, i2s_lr_m_clk0_mfp,
i2s_bclk0_mfp, i2s_bclk1_mclk1_mfp, pcm1_in_out_mfp,
pcm1_clk_mfp, pcm1_sync_mfp, eram_a5_mfp, eram_a6_mfp,
eram_a7_mfp, eram_a8_mfp, eram_a9_mfp, eram_a10_mfp,
eram_a11_mfp, lvds_oep_odn_mfp, lvds_ocp_obn_mfp,
lvds_oap_oan_mfp, lvds_e_mfp, spi0_sclk_mosi_mfp, spi0_ss_mfp,
spi0_miso_mfp, uart2_rtsb_mfp, uart2_ctsb_mfp, uart3_rtsb_mfp,
uart3_ctsb_mfp, sd0_d0_mfp, sd0_d1_mfp, sd0_d2_d3_mfp,
sd1_d0_d3_mfp, sd0_cmd_mfp, sd0_clk_mfp, sd1_cmd_clk_mfp,
uart0_rx_mfp, nand0_d0_ceb3_mfp, uart0_tx_mfp, i2c0_mfp,
csi0_cn_cp_mfp, csi0_dn0_dp3_mfp, csi1_dn0_cp_mfp,
dsi_dp3_dn1_mfp, dsi_cp_dn0_mfp, dsi_dp2_dn2_mfp,
nand1_d0_ceb1_mfp, nand1_ceb3_mfp, nand1_ceb0_mfp,
csi1_dn0_dp0_mfp, uart4_rx_tx_mfp

다음 group들은 drive-strength 매개변수 선택에 사용됩니다.

sgpio3_drv, sgpio2_drv, sgpio1_drv, sgpio0_drv,
rmii_tx_d0_d1_drv, rmii_txen_rxer_drv, rmii_crs_dv_drv,
rmii_rx_d1_d0_drv, rmii_ref_clk_drv, rmii_mdc_mdio_drv,
sirq_0_1_drv, sirq2_drv, i2s_d0_d1_drv, i2s_lr_m_clk0_drv,
i2s_blk1_mclk1_drv, pcm1_in_out_drv, lvds_oap_oan_drv,
lvds_oep_odn_drv, lvds_ocp_obn_drv, lvds_e_drv, sd0_d3_d0_drv,
sd1_d3_d0_drv, sd0_sd1_cmd_clk_drv, spi0_sclk_mosi_drv,
spi0_ss_miso_drv, uart0_rx_tx_drv, uart4_rx_tx_drv, uart2_drv,
uart3_drv, i2c0_drv, i2c1_drv, i2c2_drv, sensor0_drv

다음 group들은 slew-rate 매개변수 선택에 사용됩니다.

sgpio3_sr, sgpio2_sr, sgpio1_sr, sgpio0_sr, rmii_tx_d0_d1_sr,
rmii_txen_rxer_sr, rmii_crs_dv_sr, rmii_rx_d1_d0_sr,
rmii_ref_clk_sr, rmii_mdc_mdio_sr, sirq_0_1_sr, sirq2_sr,
i2s_do_d1_sr, i2s_lr_m_clk0_sr, i2s_bclk0_mclk1_sr,
pcm1_in_out_sr, sd1_d3_d0_sr, sd0_sd1_clk_cmd_sr,
spi0_sclk_mosi_sr, spi0_ss_miso_sr, uart0_rx_tx_sr,
uart4_rx_tx_sr, uart2_sr, uart3_sr, i2c0_sr, i2c1_sr, i2c2_sr,
sensor0_sr

S900 pinmux function

필수 `function`은 pinmux function 이름 문자열 배열이며 각 function은 대응하는 pin group에서만 선택할 수 있습니다. 사용 가능한 전체 function은 다음과 같습니다.

eram, eth_rmii, eth_smii, spi0, spi1, spi2, spi3, sens0,
uart0, uart1, uart2, uart3, uart4, uart5, uart6, i2s0, i2s1,
pcm0, pcm1, jtag, pwm0, pwm1, pwm2, pwm3, pwm4, pwm5, sd0,
sd1, sd2, sd3, i2c0, i2c1, i2c2, i2c3, i2c4, i2c5, lvds,
usb30, usb20, gpu, mipi_csi0, mipi_csi1, mipi_dsi, nand0,
nand1, spdif, sirq0, sirq1, sirq2

S900 선택 pinconf 속성

`bias-bus-hold`는 지정한 pin의 이전 상태 값을 유지하고 `bias-high-impedance`는 high-impedance로 구성합니다. `bias-pull-down`과 `bias-pull-up`은 각각 pull-down과 pull-up을 설정합니다.

`input-schmitt-enable`과 `input-schmitt-disable`은 지정한 pin의 Schmitt trigger를 켜거나 끕니다. 이 boolean형 속성들은 모두 인자가 없습니다.

`slew-rate`는 0이면 slow, 1이면 fast로 설정합니다. `drive-strength`는 mA 단위이며 허용 값은 2, 4, 8, 12입니다.

S900 예제

예제 controller는 146개 GPIO pin과 bank별 interrupt 6개를 정의합니다. `uart2-default` 상태는 `lvds_oep_odn_mfp` group을 UART2 function에 연결하고 대응 drive group의 강도를 12mA로 설정합니다.

pinctrl: pinctrl@e01b0000 {
        compatible = "actions,s900-pinctrl";
        reg = <0x0 0xe01b0000 0x0 0x1000>;
        clocks = <&cmu CLK_GPIO>;
        gpio-controller;
        gpio-ranges = <&pinctrl 0 0 146>;
        #gpio-cells = <2>;
        interrupt-controller;
        #interrupt-cells = <2>;
        interrupts = <GIC_SPI 36 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 37 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 38 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 39 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 40 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 16 IRQ_TYPE_LEVEL_HIGH>;

        uart2-default: uart2-default {
                pinmux {
                        groups = "lvds_oep_odn_mfp";
                        function = "uart2";
                };
                pinconf {
                        groups = "lvds_oep_odn_drv";
                        drive-strength = <12>;
                };
        };
};