1 One-register-per-pin type device tree based pinctrl driver
4 - compatible : "pinctrl-single" or "pinconf-single".
5 "pinctrl-single" means that pinconf isn't supported.
6 "pinconf-single" means that generic pinconf is supported.
8 - reg : offset and length of the register set for the mux registers
10 - pinctrl-single,register-width : pinmux register access width in bits
12 - pinctrl-single,function-mask : mask of allowed pinmux function bits
13 in the pinmux register
16 - pinctrl-single,function-off : function off mode for disabled state if
17 available and same for all registers; if not specified, disabling of
18 pin functions is ignored
20 - pinctrl-single,bit-per-mux : boolean to indicate that one register controls
21 more than one pin, for which "pinctrl-single,function-mask" property specifies
24 - pinctrl-single,drive-strength : array of value that are used to configure
25 drive strength in the pinmux register. They're value of drive strength
26 current and drive strength mask.
28 /* drive strength current, mask */
29 pinctrl-single,power-source = <0x30 0xf0>;
31 - pinctrl-single,bias-pullup : array of value that are used to configure the
32 input bias pullup in the pinmux register.
34 /* input, enabled pullup bits, disabled pullup bits, mask */
35 pinctrl-single,bias-pullup = <0 1 0 1>;
37 - pinctrl-single,bias-pulldown : array of value that are used to configure the
38 input bias pulldown in the pinmux register.
40 /* input, enabled pulldown bits, disabled pulldown bits, mask */
41 pinctrl-single,bias-pulldown = <2 2 0 2>;
43 * Two bits to control input bias pullup and pulldown: User should use
44 pinctrl-single,bias-pullup & pinctrl-single,bias-pulldown. One bit means
45 pullup, and the other one bit means pulldown.
46 * Three bits to control input bias enable, pullup and pulldown. User should
47 use pinctrl-single,bias-pullup & pinctrl-single,bias-pulldown. Input bias
48 enable bit should be included in pullup or pulldown bits.
49 * Although driver could set PIN_CONFIG_BIAS_DISABLE, there's no property as
50 pinctrl-single,bias-disable. Because pinctrl single driver could implement
51 it by calling pulldown, pullup disabled.
53 - pinctrl-single,input-schmitt : array of value that are used to configure
54 input schmitt in the pinmux register. In some silicons, there're two input
55 schmitt value (rising-edge & falling-edge) in the pinmux register.
57 /* input schmitt value, mask */
58 pinctrl-single,input-schmitt = <0x30 0x70>;
60 - pinctrl-single,input-schmitt-enable : array of value that are used to
61 configure input schmitt enable or disable in the pinmux register.
63 /* input, enable bits, disable bits, mask */
64 pinctrl-single,input-schmitt-enable = <0x30 0x40 0 0x70>;
66 - pinctrl-single,gpio-range : list of value that are used to configure a GPIO
67 range. They're value of subnode phandle, pin base in pinctrl device, pin
68 number in this range, GPIO function value of this GPIO range.
69 The number of parameters is depend on #pinctrl-single,gpio-range-cells
72 /* pin base, nr pins & gpio function */
73 pinctrl-single,gpio-range = <&range 0 3 0 &range 3 9 1>;
75 This driver assumes that there is only one register for each pin (unless the
76 pinctrl-single,bit-per-mux is set), and uses the common pinctrl bindings as
77 specified in the pinctrl-bindings.txt document in this directory.
79 The pin configuration nodes for pinctrl-single are specified as pinctrl
80 register offset and value pairs using pinctrl-single,pins. Only the bits
81 specified in pinctrl-single,function-mask are updated. For example, setting
82 a pin for a device could be done with:
84 pinctrl-single,pins = <0xdc 0x118>;
86 Where 0xdc is the offset from the pinctrl register base address for the
87 device pinctrl register, and 0x118 contains the desired value of the
88 pinctrl register. See the device example and static board pins example
89 below for more information.
91 In case when one register changes more than one pin's mux the
92 pinctrl-single,bits need to be used which takes three parameters:
94 pinctrl-single,bits = <0xdc 0x18, 0xff>;
96 Where 0xdc is the offset from the pinctrl register base address for the
97 device pinctrl register, 0x18 is the desired value, and 0xff is the sub mask to
98 be used when applying this change to the register.
101 Optional sub-node: In case some pins could be configured as GPIO in the pinmux
102 register, those pins could be defined as a GPIO range. This sub-node is required
103 by pinctrl-single,gpio-range property.
105 Required properties in sub-node:
106 - #pinctrl-single,gpio-range-cells : the number of parameters after phandle in
107 pinctrl-single,gpio-range property.
110 #pinctrl-single,gpio-range-cells = <3>;
116 /* SoC common file */
118 /* first controller instance for pins in core domain */
119 pmx_core: pinmux@4a100040 {
120 compatible = "pinctrl-single";
121 reg = <0x4a100040 0x0196>;
122 #address-cells = <1>;
124 pinctrl-single,register-width = <16>;
125 pinctrl-single,function-mask = <0xffff>;
128 /* second controller instance for pins in wkup domain */
129 pmx_wkup: pinmux@4a31e040 {
130 compatible = "pinctrl-single";
131 reg = <0x4a31e040 0x0038>;
132 #address-cells = <1>;
134 pinctrl-single,register-width = <16>;
135 pinctrl-single,function-mask = <0xffff>;
138 control_devconf0: pinmux@48002274 {
139 compatible = "pinctrl-single";
140 reg = <0x48002274 4>; /* Single register */
141 #address-cells = <1>;
143 pinctrl-single,bit-per-mux;
144 pinctrl-single,register-width = <32>;
145 pinctrl-single,function-mask = <0x5F>;
148 /* third controller instance for pins in gpio domain */
149 pmx_gpio: pinmux@d401e000 {
150 compatible = "pinconf-single";
151 reg = <0xd401e000 0x0330>;
152 #address-cells = <1>;
156 pinctrl-single,register-width = <32>;
157 pinctrl-single,function-mask = <7>;
159 /* sparse GPIO range could be supported */
160 pinctrl-single,gpio-range = <&range 0 3 0 &range 3 9 1
161 &range 12 1 0 &range 13 29 1
162 &range 43 1 0 &range 44 49 1
163 &range 94 1 1 &range 96 2 1>;
166 #pinctrl-single,gpio-range-cells = <3>;
171 /* board specific .dts file */
176 * map all board specific static pins enabled by the pinctrl driver
177 * itself during the boot (or just set them up in the bootloader)
179 pinctrl-names = "default";
180 pinctrl-0 = <&board_pins>;
182 board_pins: pinmux_board_pins {
183 pinctrl-single,pins = <
191 uart0_pins: pinmux_uart0_pins {
192 pinctrl-single,pins = <
193 0x208 0 /* UART0_RXD (IOCFG138) */
194 0x20c 0 /* UART0_TXD (IOCFG139) */
196 pinctrl-single,bias-pulldown = <0 2 2>;
197 pinctrl-single,bias-pullup = <0 1 1>;
201 uart2_pins: pinmux_uart2_pins {
202 pinctrl-single,pins = <
212 mcbsp1_pins: pinmux_mcbsp1_pins {
213 pinctrl-single,bits = <
214 0x00 0x18 0x18 /* FSR/CLKR signal from FSX/CLKX pin */
218 mcbsp2_clks_pins: pinmux_mcbsp2_clks_pins {
219 pinctrl-single,bits = <
220 0x00 0x40 0x40 /* McBSP2 CLKS from McBSP_CLKS pin */
227 pinctrl-names = "default";
228 pinctrl-0 = <&uart0_pins>;
232 pinctrl-names = "default";
233 pinctrl-0 = <&uart2_pins>;