1 Pincontrol driver for MAX77620 Power managemen 1 Pincontrol driver for MAX77620 Power management IC from Maxim Semiconductor.
2 2
3 Device has 8 GPIO pins which can be configured 3 Device has 8 GPIO pins which can be configured as GPIO as well as the
4 special IO functions. 4 special IO functions.
5 5
6 Please refer file <devicetree/bindings/pinctrl 6 Please refer file <devicetree/bindings/pinctrl/pinctrl-bindings.txt>
7 for details of the common pinctrl bindings use 7 for details of the common pinctrl bindings used by client devices,
8 including the meaning of the phrase "pin confi 8 including the meaning of the phrase "pin configuration node".
9 9
10 Optional Pinmux properties: 10 Optional Pinmux properties:
11 -------------------------- 11 --------------------------
12 Following properties are required if default s 12 Following properties are required if default setting of pins are required
13 at boot. 13 at boot.
14 - pinctrl-names: A pinctrl state named per <pi 14 - pinctrl-names: A pinctrl state named per <pinctrl-bindings.txt>.
15 - pinctrl[0...n]: Properties to contain the ph 15 - pinctrl[0...n]: Properties to contain the phandle for pinctrl states per
16 <pinctrl-bindings.txt>. 16 <pinctrl-bindings.txt>.
17 17
18 The pin configurations are defined as child of 18 The pin configurations are defined as child of the pinctrl states node. Each
19 sub-node have following properties: 19 sub-node have following properties:
20 20
21 Required properties: 21 Required properties:
22 ------------------ 22 ------------------
23 - pins: List of pins. Valid values of pins pro 23 - pins: List of pins. Valid values of pins properties are:
24 gpio0, gpio1, gpio2, gpi 24 gpio0, gpio1, gpio2, gpio3, gpio4, gpio5, gpio6, gpio7.
25 25
26 Optional properties: 26 Optional properties:
27 ------------------- 27 -------------------
28 Following are optional properties defined as p 28 Following are optional properties defined as pinmux DT binding document
29 <pinctrl-bindings.txt>. Absence of properties 29 <pinctrl-bindings.txt>. Absence of properties will leave the configuration
30 on default. 30 on default.
31 function, 31 function,
32 drive-push-pull, 32 drive-push-pull,
33 drive-open-drain, 33 drive-open-drain,
34 bias-pull-up, 34 bias-pull-up,
35 bias-pull-down. 35 bias-pull-down.
36 36
37 Valid values for function properties are: 37 Valid values for function properties are:
38 gpio, lpm-control-in, fps-out, 32k-out 38 gpio, lpm-control-in, fps-out, 32k-out, sd0-dvs-in, sd1-dvs-in,
39 reference-out 39 reference-out
40 40
41 There are also customised properties for the G 41 There are also customised properties for the GPIO1, GPIO2 and GPIO3. These
42 customised properties are required to configur 42 customised properties are required to configure FPS configuration parameters
43 of these GPIOs. Please refer <devicetree/bindi 43 of these GPIOs. Please refer <devicetree/bindings/mfd/max77620.txt> for more
44 detail of Flexible Power Sequence (FPS). 44 detail of Flexible Power Sequence (FPS).
45 45
46 - maxim,active-fps-source: FPS so 46 - maxim,active-fps-source: FPS source for the GPIOs to get
47 enable 47 enabled/disabled when system is in
48 active 48 active state. Valid values are:
49 - MAX7 49 - MAX77620_FPS_SRC_0,
50 50 FPS source is FPS0.
51 - MAX7 51 - MAX77620_FPS_SRC_1,
52 52 FPS source is FPS1
53 - MAX7 53 - MAX77620_FPS_SRC_2 and
54 54 FPS source is FPS2
55 - MAX7 55 - MAX77620_FPS_SRC_NONE.
56 56 GPIO is not controlled
57 57 by FPS events and it gets
58 58 enabled/disabled by register
59 59 access.
60 Absenc 60 Absence of this property will leave
61 the FP 61 the FPS configuration register for that
62 GPIO t 62 GPIO to default configuration.
63 63
64 - maxim,active-fps-power-up-slot: Sequen 64 - maxim,active-fps-power-up-slot: Sequencing event slot number on which
65 the GP 65 the GPIO get enabled when
66 master 66 master FPS input event set to HIGH.
67 Valid 67 Valid values are 0 to 7.
68 This i 68 This is applicable if FPS source is
69 select 69 selected as FPS0, FPS1 or FPS2.
70 70
71 - maxim,active-fps-power-down-slot: Sequen 71 - maxim,active-fps-power-down-slot: Sequencing event slot number on which
72 the GP 72 the GPIO get disabled when master
73 FPS in 73 FPS input event set to LOW.
74 Valid 74 Valid values are 0 to 7.
75 This i 75 This is applicable if FPS source is
76 select 76 selected as FPS0, FPS1 or FPS2.
77 77
78 - maxim,suspend-fps-source: This i 78 - maxim,suspend-fps-source: This is same as property
79 "maxim 79 "maxim,active-fps-source" but value
80 get co 80 get configured when system enters in
81 to sus 81 to suspend state.
82 82
83 - maxim,suspend-fps-power-up-slot: This i 83 - maxim,suspend-fps-power-up-slot: This is same as property
84 "maxim 84 "maxim,active-fps-power-up-slot" but
85 this v 85 this value get configured into FPS
86 config 86 configuration register when system
87 enters 87 enters into suspend.
88 This i 88 This is applicable if suspend state
89 FPS so 89 FPS source is selected as FPS0, FPS1 or
90 90
91 - maxim,suspend-fps-power-down-slot: This i 91 - maxim,suspend-fps-power-down-slot: This is same as property
92 "maxim 92 "maxim,active-fps-power-down-slot" but
93 this v 93 this value get configured into FPS
94 config 94 configuration register when system
95 enters 95 enters into suspend.
96 This i 96 This is applicable if suspend state
97 FPS so 97 FPS source is selected as FPS0, FPS1 or
98 FPS2. 98 FPS2.
99 99
100 Example: 100 Example:
101 -------- 101 --------
102 #include <dt-bindings/mfd/max77620.h> 102 #include <dt-bindings/mfd/max77620.h>
103 ... 103 ...
104 max77620@3c { 104 max77620@3c {
105 105
106 pinctrl-names = "default"; 106 pinctrl-names = "default";
107 pinctrl-0 = <&spmic_default>; 107 pinctrl-0 = <&spmic_default>;
108 108
109 spmic_default: pinmux@0 { 109 spmic_default: pinmux@0 {
110 pin_gpio0 { 110 pin_gpio0 {
111 pins = "gpio0"; 111 pins = "gpio0";
112 function = "gpio"; 112 function = "gpio";
113 }; 113 };
114 114
115 pin_gpio1 { 115 pin_gpio1 {
116 pins = "gpio1"; 116 pins = "gpio1";
117 function = "fps-out"; 117 function = "fps-out";
118 maxim,active-fps-sourc 118 maxim,active-fps-source = <MAX77620_FPS_SRC_0>;
119 }; 119 };
120 120
121 pin_gpio2 { 121 pin_gpio2 {
122 pins = "gpio2"; 122 pins = "gpio2";
123 function = "fps-out"; 123 function = "fps-out";
124 maxim,active-fps-sourc 124 maxim,active-fps-source = <MAX77620_FPS_SRC_1>;
125 }; 125 };
126 }; 126 };
127 }; 127 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.