device-tree-bindings/pinctrl/pinctrl-bindings.txt

4 such as pull-up/down, tri-state, drive-strength etc are designated as pin
15 need to reconfigure pins at run-time, for example to tri-state pins when the
17 states. The number and names of those states is defined by the client device's
21 for client device device tree nodes to map those state names to the pin
38 assigned a name. When names are used, another property exists to map from
39 those names to the integer IDs.
43 IDs that must be provided, or whether to define the set of state names that
47 pinctrl-0:	List of phandles, each pointing at a pin configuration
65 pinctrl-1:	List of phandles, each pointing at a pin configuration
68 pinctrl-n:	List of phandles, each pointing at a pin configuration
70 pinctrl-names:	The list of names to assign states. List entry 0 defines the
78 		pinctrl-names = "active", "idle";
79 		pinctrl-0 = <&state_0_node_a>;
80 		pinctrl-1 = <&state_1_node_a &state_1_node_b>;
85 		pinctrl-0 = <&state_0_node_a>;
86 		pinctrl-1 = <&state_1_node_a &state_1_node_b>;
94 		pinctrl-names = "active", "idle";
95 		pinctrl-0 = <>;
96 		pinctrl-1 = <>;
130 == Generic pin multiplexing node content ==
134 function		- the mux function to select
135 groups			- the list of groups to select with this function
137 pins			- the list of pins to select with this function (either
159 == Generic pin configuration node content ==
162 and generic. Pin control bindings should use the properties defined below
165 should state which of these generic properties, if any, are used, and the
168 Supported generic properties are:
170 pins			- the list of pins that properties in the node
173 group			- the group to apply the properties to, if the driver
177 bias-disable		- disable any pin bias
178 bias-high-impedance	- high impedance mode ("third-state", "floating")
179 bias-bus-hold		- latch weakly
180 bias-pull-up		- pull up the pin
181 bias-pull-down		- pull down the pin
182 bias-pull-pin-default	- use pin-default pull state
183 drive-push-pull		- drive actively high and low
184 drive-open-drain	- drive with open drain
185 drive-open-source	- drive with open source
186 drive-strength		- sink or source at most X mA
187 input-enable		- enable input on pin (no effect on output)
188 input-disable		- disable input on pin (no effect on output)
189 input-schmitt-enable	- enable schmitt-trigger mode
190 input-schmitt-disable	- disable schmitt-trigger mode
191 input-debounce		- debounce mode with debound time X
192 power-source		- select between different power supplies
193 low-power-enable	- enable low power mode
194 low-power-disable	- disable low power mode
195 output-low		- set the pin to output mode with low level
196 output-high		- set the pin to output mode with high level
197 slew-rate		- set the slew rate
204 		bias-pull-up;
210 		output-high;
215 		group = "foo-group";
216 		bias-pull-up;
220 Some of the generic properties take arguments. For those that do, the
223 - pins takes a list of pin names or IDs as a required argument. The specific
225   - Whether the entries are integers or strings, and their meaning.
227 - bias-pull-up, -down and -pin-default take as optional argument on hardware
228   supporting it the pull strength in Ohm. bias-disable will disable the pull.
230 - drive-strength takes as argument the target strength in mA.
232 - input-debounce takes the debounce time in usec as argument
235 More in-depth documentation on these parameters can be found in
236 <include/linux/pinctrl/pinconf-generic.h>