GNU Linux-libre 4.19.264-gnu1
[releases.git] / Documentation / devicetree / bindings / regulator / max8952.txt
1 Maxim MAX8952 voltage regulator
2
3 Required properties:
4 - compatible: must be equal to "maxim,max8952"
5 - reg: I2C slave address, usually 0x60
6 - max8952,dvs-mode-microvolt: array of 4 integer values defining DVS voltages
7   in microvolts. All values must be from range <770000, 1400000>
8 - any required generic properties defined in regulator.txt
9
10 Optional properties:
11 - max8952,vid-gpios: array of two GPIO pins used for DVS voltage selection
12 - max8952,en-gpio: GPIO used to control enable status of regulator
13 - max8952,default-mode: index of default DVS voltage, from <0, 3> range
14 - max8952,sync-freq: sync frequency, must be one of following values:
15     - 0: 26 MHz
16     - 1: 13 MHz
17     - 2: 19.2 MHz
18   Defaults to 26 MHz if not specified.
19 - max8952,ramp-speed: voltage ramp speed, must be one of following values:
20     - 0: 32mV/us
21     - 1: 16mV/us
22     - 2: 8mV/us
23     - 3: 4mV/us
24     - 4: 2mV/us
25     - 5: 1mV/us
26     - 6: 0.5mV/us
27     - 7: 0.25mV/us
28   Defaults to 32mV/us if not specified.
29 - any available generic properties defined in regulator.txt
30
31 Example:
32
33         vdd_arm_reg: pmic@60 {
34                 compatible = "maxim,max8952";
35                 reg = <0x60>;
36
37                 /* max8952-specific properties */
38                 max8952,vid-gpios = <&gpx0 3 0>, <&gpx0 4 0>;
39                 max8952,en-gpio = <&gpx0 1 0>;
40                 max8952,default-mode = <0>;
41                 max8952,dvs-mode-microvolt = <1250000>, <1200000>,
42                                                 <1050000>, <950000>;
43                 max8952,sync-freq = <0>;
44                 max8952,ramp-speed = <0>;
45
46                 /* generic regulator properties */
47                 regulator-name = "vdd_arm";
48                 regulator-min-microvolt = <770000>;
49                 regulator-max-microvolt = <1400000>;
50                 regulator-always-on;
51                 regulator-boot-on;
52         };