bindings/pinctrl/fsl%2Cmxs-pinctrl.txt

5 function is GPIO.  The configuration on the pins includes drive strength,
6 voltage and pull-up.
9 - compatible: "fsl,imx23-pinctrl" or "fsl,imx28-pinctrl"
10 - reg: Should contain the register physical address and length for the
13 Please refer to pinctrl-bindings.txt in this directory for details of the
18 a group of pins, and only affects those parameters that are explicitly listed.
20 information about pull-up. For this reason, even seemingly boolean values are
26 One is to set up a group of pins for a function, both mux selection and pin
27 configurations, and it's called group node in the binding document.   The other
29 different configuration than what is defined in group node.  The binding
32 On mxs, there is no hardware pin group. The pin group in this binding only
33 means a group of pins put together for particular peripheral to work in
34 particular function, like SSP0 functioning as mmc0-8bit.  That said, the
35 group node should include all the pins needed for one function rather than
36 having these pins defined in several group nodes.  It also means each of
37 "pinctrl-*" phandle in client device node should only have one group node
39 there to adjust configurations for some pins in the group.
41 Required subnode-properties:
42 - fsl,pinmux-ids: An integer array.  Each integer in the array specify a pin
43   with given mux function, with bank, pin and mux packed as below.
49   This integer with mux selection packed is used as an entity by both group
51   effects only on group node, and will get ignored by driver with config node,
56 - reg: Should be the index of the group nodes for same function.  This property
57   is required only for group nodes, and should not be present in any config
60 Optional subnode-properties:
61 - fsl,drive-strength: Integer.
66 - fsl,voltage: Integer.
67     0: MXS_VOLTAGE_LOW  - 1.8 V
68     1: MXS_VOLTAGE_HIGH - 3.3 V
69 - fsl,pull-up: Integer.
70     0: MXS_PULL_DISABLE - Disable the internal pull-up
71     1: MXS_PULL_ENABLE  - Enable the internal pull-up
73 Note that when enabling the pull-up, the internal pad keeper gets disabled.
74 Also, some pins doesn't have a pull up, in that case, setting the fsl,pull-up
80 	#address-cells = <1>;
81 	#size-cells = <0>;
82 	compatible = "fsl,imx28-pinctrl";
85 	mmc0_8bit_pins_a: mmc0-8bit@0 {
87 		fsl,pinmux-ids = <
100 		fsl,drive-strength = <MXS_DRIVE_4mA>;
102 		fsl,pull-up = <MXS_PULL_ENABLE>;
105 	mmc_cd_cfg: mmc-cd-cfg {
106 		fsl,pinmux-ids = <MX28_PAD_SSP0_DETECT__SSP0_CARD_DETECT>;
107 		fsl,pull-up = <MXS_PULL_DISABLE>;
110 	mmc_sck_cfg: mmc-sck-cfg {
111 		fsl,pinmux-ids = <MX28_PAD_SSP0_SCK__SSP0_SCK>;
112 		fsl,drive-strength = <MXS_DRIVE_12mA>;
113 		fsl,pull-up = <MXS_PULL_DISABLE>;
117 In this example, group node mmc0-8bit defines a group of pins for mxs SSP0
118 to function as a 8-bit mmc device, with 8mA, 3.3V and pull-up configurations
119 applied on all these pins.  And config nodes mmc-cd-cfg and mmc-sck-cfg are
120 adjusting the configuration for pins card-detection and clock from what group
121 node mmc0-8bit defines.  Only the configuration properties to be adjusted need
124 Valid values for i.MX28/i.MX23 pinmux-id are defined in
125 arch/arm/boot/dts/imx28-pinfunc.h and arch/arm/boot/dts/imx23-pinfunc.h.
127 arch/arm/boot/dts/mxs-pinfunc.h.