Commit 3163508b authored by Drew Fustini's avatar Drew Fustini Committed by Linus Walleij
Browse files

pinctrl: Document pinctrl-single,pins when #pinctrl-cells = 2



Document the values in pinctrl-single,pins when #pinctrl-cells = <2>

Fixes: 27c90e5e ("ARM: dts: am33xx-l4: change #pinctrl-cells from 1 to 2")
Reported-by: default avatarTrent Piepho <tpiepho@gmail.com>
Signed-off-by: default avatarDrew Fustini <drew@beagleboard.org>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Acked-by: default avatarTony Lindgren <tony@atomide.com>
Link: https://lore.kernel.org/linux-omap/3139716.CMS8C0sQ7x@zen.local/
Link: https://lore.kernel.org/r/20200919200836.3218536-1-drew@beagleboard.org


Signed-off-by: default avatarLinus Walleij <linus.walleij@linaro.org>
parent 48548c78
Loading
Loading
Loading
Loading
+14 −7
Original line number Diff line number Diff line
@@ -94,16 +94,23 @@ pinctrl-single,bit-per-mux is set), and uses the common pinctrl bindings as
specified in the pinctrl-bindings.txt document in this directory.

The pin configuration nodes for pinctrl-single are specified as pinctrl
register offset and value pairs using pinctrl-single,pins. Only the bits
specified in pinctrl-single,function-mask are updated. For example, setting
a pin for a device could be done with:
register offset and values using pinctrl-single,pins. Only the bits specified
in pinctrl-single,function-mask are updated.

When #pinctrl-cells = 1, then setting a pin for a device could be done with:

	pinctrl-single,pins = <0xdc 0x118>;

Where 0xdc is the offset from the pinctrl register base address for the
device pinctrl register, and 0x118 contains the desired value of the
pinctrl register. See the device example and static board pins example
below for more information.
Where 0xdc is the offset from the pinctrl register base address for the device
pinctrl register, and 0x118 contains the desired value of the pinctrl register.

When #pinctrl-cells = 2, then setting a pin for a device could be done with:

	pinctrl-single,pins = <0xdc 0x30 0x07>;

Where 0x30 is the pin configuration value and 0x07 is the pin mux mode value.
These two values are OR'd together to produce the value stored at offset 0xdc.
See the device example and static board pins example below for more information.

In case when one register changes more than one pin's mux the
pinctrl-single,bits need to be used which takes three parameters: