1 # SPDX-License-Identifier: GPL-2.0-only OR BSD 1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/regulator/m 4 $id: http://devicetree.org/schemas/regulator/maxim,max8952.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Maxim MAX8952 voltage regulator 7 title: Maxim MAX8952 voltage regulator
8 8
9 maintainers: 9 maintainers:
10 - Krzysztof Kozlowski <krzk@kernel.org> 10 - Krzysztof Kozlowski <krzk@kernel.org>
11 11
12 allOf: 12 allOf:
13 - $ref: regulator.yaml# 13 - $ref: regulator.yaml#
14 14
15 properties: 15 properties:
16 compatible: 16 compatible:
17 const: maxim,max8952 17 const: maxim,max8952
18 18
19 max8952,default-mode: 19 max8952,default-mode:
20 $ref: /schemas/types.yaml#/definitions/uin 20 $ref: /schemas/types.yaml#/definitions/uint32
21 enum: [0, 1, 2, 3] 21 enum: [0, 1, 2, 3]
22 description: | 22 description: |
23 index of default DVS voltage 23 index of default DVS voltage
24 24
25 max8952,dvs-mode-microvolt: 25 max8952,dvs-mode-microvolt:
26 minItems: 4 26 minItems: 4
27 maxItems: 4 27 maxItems: 4
28 items: 28 items:
29 minimum: 770000 29 minimum: 770000
30 maximum: 1400000 30 maximum: 1400000
31 description: | 31 description: |
32 Array of 4 integer values defining DVS v 32 Array of 4 integer values defining DVS voltages in microvolts. All values
33 must be from range <770000, 1400000>. 33 must be from range <770000, 1400000>.
34 34
35 max8952,en-gpio: 35 max8952,en-gpio:
36 maxItems: 1 36 maxItems: 1
37 description: | 37 description: |
38 GPIO used to control enable status of re 38 GPIO used to control enable status of regulator
39 39
40 max8952,ramp-speed: 40 max8952,ramp-speed:
41 $ref: /schemas/types.yaml#/definitions/uin 41 $ref: /schemas/types.yaml#/definitions/uint32
42 enum: [0, 1, 2, 3, 4, 5, 6, 7] 42 enum: [0, 1, 2, 3, 4, 5, 6, 7]
43 default: 0 43 default: 0
44 description: | 44 description: |
45 Voltage ramp speed, values map to: 45 Voltage ramp speed, values map to:
46 - 0: 32mV/us 46 - 0: 32mV/us
47 - 1: 16mV/us 47 - 1: 16mV/us
48 - 2: 8mV/us 48 - 2: 8mV/us
49 - 3: 4mV/us 49 - 3: 4mV/us
50 - 4: 2mV/us 50 - 4: 2mV/us
51 - 5: 1mV/us 51 - 5: 1mV/us
52 - 6: 0.5mV/us 52 - 6: 0.5mV/us
53 - 7: 0.25mV/us 53 - 7: 0.25mV/us
54 Defaults to 32mV/us if not specified. 54 Defaults to 32mV/us if not specified.
55 55
56 max8952,sync-freq: 56 max8952,sync-freq:
57 $ref: /schemas/types.yaml#/definitions/uin 57 $ref: /schemas/types.yaml#/definitions/uint32
58 enum: [0, 1, 2] 58 enum: [0, 1, 2]
59 default: 0 59 default: 0
60 description: | 60 description: |
61 Sync frequency, values map to: 61 Sync frequency, values map to:
62 - 0: 26 MHz 62 - 0: 26 MHz
63 - 1: 13 MHz 63 - 1: 13 MHz
64 - 2: 19.2 MHz 64 - 2: 19.2 MHz
65 Defaults to 26 MHz if not specified. 65 Defaults to 26 MHz if not specified.
66 66
67 max8952,vid-gpios: 67 max8952,vid-gpios:
68 minItems: 2 68 minItems: 2
69 maxItems: 2 69 maxItems: 2
70 description: | 70 description: |
71 Array of two GPIO pins used for DVS volt 71 Array of two GPIO pins used for DVS voltage selection
72 72
73 reg: 73 reg:
74 maxItems: 1 74 maxItems: 1
75 75
76 required: 76 required:
77 - compatible 77 - compatible
78 - max8952,dvs-mode-microvolt 78 - max8952,dvs-mode-microvolt
79 - reg 79 - reg
80 80
81 unevaluatedProperties: false 81 unevaluatedProperties: false
82 82
83 examples: 83 examples:
84 - | 84 - |
85 #include <dt-bindings/gpio/gpio.h> 85 #include <dt-bindings/gpio/gpio.h>
86 86
87 i2c { 87 i2c {
88 #address-cells = <1>; 88 #address-cells = <1>;
89 #size-cells = <0>; 89 #size-cells = <0>;
90 90
91 pmic@60 { 91 pmic@60 {
92 compatible = "maxim,max8952"; 92 compatible = "maxim,max8952";
93 reg = <0x60>; 93 reg = <0x60>;
94 94
95 max8952,vid-gpios = <&gpx0 3 GPIO_ 95 max8952,vid-gpios = <&gpx0 3 GPIO_ACTIVE_HIGH>,
96 <&gpx0 4 GPIO_ 96 <&gpx0 4 GPIO_ACTIVE_HIGH>;
97 max8952,default-mode = <0>; 97 max8952,default-mode = <0>;
98 max8952,dvs-mode-microvolt = <1250 98 max8952,dvs-mode-microvolt = <1250000>, <1200000>,
99 <1050 99 <1050000>, <950000>;
100 max8952,sync-freq = <0>; 100 max8952,sync-freq = <0>;
101 max8952,ramp-speed = <0>; 101 max8952,ramp-speed = <0>;
102 102
103 regulator-name = "VARM_1.2V_C210"; 103 regulator-name = "VARM_1.2V_C210";
104 regulator-min-microvolt = <770000> 104 regulator-min-microvolt = <770000>;
105 regulator-max-microvolt = <1400000 105 regulator-max-microvolt = <1400000>;
106 regulator-always-on; 106 regulator-always-on;
107 regulator-boot-on; 107 regulator-boot-on;
108 }; 108 };
109 }; 109 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.