GNU Linux-libre 4.14.266-gnu1
[releases.git] / Documentation / devicetree / bindings / pinctrl / berlin,pinctrl.txt
1 * Pin-controller driver for the Marvell Berlin SoCs
2
3 Pin control registers are part of both chip controller and system
4 controller register sets. Pin controller nodes should be a sub-node of
5 either the chip controller or system controller node. The pins
6 controlled are organized in groups, so no actual pin information is
7 needed.
8
9 A pin-controller node should contain subnodes representing the pin group
10 configurations, one per function. Each subnode has the group name and
11 the muxing function used.
12
13 Be aware the Marvell Berlin datasheets use the keyword 'mode' for what
14 is called a 'function' in the pin-controller subsystem.
15
16 Required properties:
17 - compatible: should be one of:
18         "marvell,berlin2-soc-pinctrl",
19         "marvell,berlin2-system-pinctrl",
20         "marvell,berlin2cd-soc-pinctrl",
21         "marvell,berlin2cd-system-pinctrl",
22         "marvell,berlin2q-soc-pinctrl",
23         "marvell,berlin2q-system-pinctrl",
24         "marvell,berlin4ct-avio-pinctrl",
25         "marvell,berlin4ct-soc-pinctrl",
26         "marvell,berlin4ct-system-pinctrl"
27
28 Required subnode-properties:
29 - groups: a list of strings describing the group names.
30 - function: a string describing the function used to mux the groups.
31
32 Example:
33
34 sys_pinctrl: pin-controller {
35         compatible = "marvell,berlin2q-system-pinctrl";
36
37         uart0_pmux: uart0-pmux {
38                 groups = "GSM12";
39                 function = "uart0";
40         };
41 };
42
43 &uart0 {
44         pinctrl-0 = <&uart0_pmux>;
45         pinctrl-names = "default";
46 };