Actions Semi S700 Pin Controller

Actions S700 pin controller

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

`gpio-controller`는 노드를 GPIO controller로 표시하고 `gpio-ranges`는 GPIO controller와 pin-controller pin 사이의 매핑을 지정합니다. `#gpio-cells`는 2이며 첫 cell은 GPIO pin 번호, 두 번째 cell은 선택 매개변수입니다.

`interrupt-controller`는 노드를 interrupt controller로 표시합니다. `#interrupt-cells`는 2이며 첫 cell은 interrupt 번호, 두 번째는 `bindings/interrupt-controller/interrupts.txt`에 정의된 trigger flag입니다.

`interrupts`에는 controller의 interrupt 출력을 적습니다. GPIO bank마다 interrupt 하나가 있으므로 항목 수는 SoC의 bank 수에 따라 달라지고 bank 0부터 bank 순서대로 나열해야 합니다.

Client 장치가 사용하는 공통 pinctrl 바인딩과 `pin configuration node`의 의미는 이 디렉터리의 `pinctrl-bindings.txt`를 참조하십시오. Configuration node는 임의 개수의 하위 노드를 담으며 각 하위 노드는 pin, group 또는 그 목록에 적용할 mux function과 pull-up·drive strength 같은 설정을 나타냅니다.

S700 pin configuration node 규칙

각 하위 노드의 이름은 중요하지 않으며 모든 하위 노드는 이름이 아니라 내용만으로 열거하고 처리해야 합니다.

하위 노드는 명시한 매개변수에만 영향을 줍니다. Mux function만 적고 pin configuration을 적지 않았다면 다른 pin configuration에 대한 의미가 없고, pull-up만 기술한 pin 노드도 mux function에 대한 의미를 갖지 않습니다.

Pinmux function은 pin group에서만 사용할 수 있지만 pinconf 매개변수는 pin group과 개별 pin 모두에 사용할 수 있습니다. 하위 노드에는 `pinctrl-bindings.txt`가 정의한 다음 generic 속성을 지정할 수 있습니다.

S700 pin 이름

필수 `pins`는 pin 이름 문자열 배열입니다. 이 pin들은 pull control과 Schmitt trigger 매개변수를 선택하는 데 사용합니다. 사용 가능한 pin 식별자 전체는 다음과 같습니다.

eth_txd0, eth_txd1, eth_txd2, eth_txd3, eth_txen, eth_rxer,
eth_crs_dv, eth_rxd1, eth_rxd0, eth_rxd2, eth_rxd3, 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, ks_in0, ks_in1, ks_in2,
ks_in3, ks_out0, ks_out1, ks_out2, 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, lcd0_d18,
lcd0_d2, dsi_dp3, dsi_dn3, dsi_dp1, dsi_dn1, dsi_cp, dsi_cn,
dsi_dp0, dsi_dn0, dsi_dp2, dsi_dn2, 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_ss, spi0_miso, uart0_rx, uart0_tx,
uart2_rx, uart2_tx, uart2_rtsb, uart2_ctsb, uart3_rx, uart3_tx,
uart3_rtsb, uart3_ctsb, i2c0_sclk, i2c0_sdata, i2c1_sclk,
i2c1_sdata, i2c2_sdata, csi_dn0, csi_dp0, csi_dn1, csi_dp1,
csi_cn, csi_cp, csi_dn2, csi_dp2, csi_dn3, csi_dp3,
sensor0_pclk, sensor0_ckout, dnand_d0, dnand_d1, dnand_d2,
dnand_d3, dnand_d4, dnand_d5, dnand_d6, dnand_d7, dnand_wrb,
dnand_rdb, dnand_rdbn, dnand_dqs, dnand_dqsn, dnand_rb0,
dnand_ale, dnand_cle, dnand_ceb0, dnand_ceb1, dnand_ceb2,
dnand_ceb3, porb, clko_25m, bsel, pkg0, pkg1, pkg2, pkg3

S700 pin group

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

rgmii_txd23_mfp, rgmii_rxd2_mfp, rgmii_rxd3_mfp, lcd0_d18_mfp,
rgmii_txd01_mfp, rgmii_txd0_mfp, rgmii_txd1_mfp, rgmii_txen_mfp,
rgmii_rxen_mfp, rgmii_rxd1_mfp, rgmii_rxd0_mfp, rgmii_ref_clk_mfp,
i2s_d0_mfp, i2s_pcm1_mfp, i2s0_pcm0_mfp, i2s1_pcm0_mfp,
i2s_d1_mfp, ks_in2_mfp, ks_in1_mfp, ks_in0_mfp, ks_in3_mfp,
ks_out0_mfp, ks_out1_mfp, ks_out2_mfp, lvds_o_pn_mfp, dsi_dn0_mfp,
dsi_dp2_mfp, lcd0_d2_mfp, dsi_dp3_mfp, dsi_dn3_mfp, dsi_dp0_mfp,
lvds_ee_pn_mfp, uart2_rx_tx_mfp, spi0_i2c_pcm_mfp, dsi_dnp1_cp_d2_mfp,
dsi_dnp1_cp_d17_mfp, lvds_e_pn_mfp, dsi_dn2_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_mfp,
uart0_rx_mfp, clko_25m_mfp, csi_cn_cp_mfp, sens0_ckout_mfp, uart0_tx_mfp,
i2c0_mfp, csi_dn_dp_mfp, sen0_pclk_mfp, pcm1_in_mfp, pcm1_clk_mfp,
pcm1_sync_mfp, pcm1_out_mfp, dnand_data_wr_mfp, dnand_acle_ce0_mfp,
nand_ceb2_mfp, nand_ceb3_mfp

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

sirq_drv, rgmii_txd23_drv, rgmii_rxd23_drv, rgmii_txd01_txen_drv,
rgmii_rxer_drv, rgmii_crs_drv, rgmii_rxd10_drv, rgmii_ref_clk_drv,
smi_mdc_mdio_drv, i2s_d0_drv, i2s_bclk0_drv, i2s3_drv, i2s13_drv,
pcm1_drv, ks_in_drv, ks_out_drv, lvds_all_drv, lcd_d18_d2_drv,
dsi_all_drv, sd0_d0_d3_drv, sd0_cmd_drv, sd0_clk_drv, spi0_all_drv,
uart0_rx_drv, uart0_tx_drv, uart2_all_drv, i2c0_all_drv, i2c12_all_drv,
sens0_pclk_drv, sens0_ckout_drv, uart3_all_drv

S700 pinmux function

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

nor, eth_rgmii, eth_sgmii, spi0, spi1, spi2, spi3, seNs0, sens1,
uart0, uart1, uart2, uart3, uart4, uart5, uart6, i2s0, i2s1,
pcm1, pcm0, ks, jtag, pwm0, pwm1, pwm2, pwm3, pwm4, pwm5, p0,
sd0, sd1, sd2, i2c0, i2c1, i2c2, i2c3, dsi, lvds, usb30,
clko_25m, mipi_csi, nand, spdif, sirq0, sirq1, sirq2, bt, lcd0

S700 선택 pinconf 속성

`bias-pull-down`과 `bias-pull-up`은 인자 없이 지정한 pin을 각각 pull-down과 pull-up으로 구성합니다. `input-schmitt-enable`과 `input-schmitt-disable`도 인자 없이 지정한 pin의 Schmitt trigger를 켜거나 끕니다.

`drive-strength`는 지정한 pin의 drive strength를 mA 단위 정수로 선택하며 유효한 값은 2, 4, 8, 12입니다.

S700 예제

예제 controller는 136개 GPIO pin과 bank별 interrupt 5개를 정의합니다. `uart3-default` 상태는 RTS/CTS pinmux group을 UART3 function에 연결하고 `uart3_all_drv` group의 drive strength를 2mA로 설정합니다.

pinctrl: pinctrl@e01b0000 {
        compatible = "actions,s700-pinctrl";
        reg = <0x0 0xe01b0000 0x0 0x1000>;
        clocks = <&cmu CLK_GPIO>;
        gpio-controller;
        gpio-ranges = <&pinctrl 0 0 136>;
        #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>;

        uart3-default: uart3-default {
                pinmux {
                        groups = "uart3_rtsb_mfp", "uart3_ctsb_mfp";
                        function = "uart3";
                };
                pinconf {
                        groups = "uart3_all_drv";
                        drive-strength = <2>;
                };
        };
};