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