1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/regulator/dlg,da9121.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: Dialog Semiconductor DA9121 voltage regulator 8 9maintainers: 10 - Adam Ward <Adam.Ward.opensource@diasemi.com> 11 12description: | 13 Dialog Semiconductor DA9121 Single-channel 10A double-phase buck converter 14 Dialog Semiconductor DA9122 Double-channel 5A single-phase buck converter 15 Dialog Semiconductor DA9220 Double-channel 3A single-phase buck converter 16 Dialog Semiconductor DA9217 Single-channel 6A double-phase buck converter 17 Dialog Semiconductor DA9130 Single-channel 10A double-phase buck converter 18 Dialog Semiconductor DA9131 Double-channel 5A single-phase buck converter 19 Dialog Semiconductor DA9132 Double-channel 3A single-phase buck converter 20 Dialog Semiconductor DA9141 Single-channel 40A quad-phase buck converter 21 Dialog Semiconductor DA9142 Single-channel 20A double-phase buck converter 22 23 Device parameter ranges 24 25 The current limits can be set to at/near double the rated current per channel 26 to allow for transient peaks. 27 Current limit changes when the output is enabled are not supported, as a 28 precaution against undefined behaviour. 29 30 |----------------------------------------------| 31 | | range & reset default value | 32 | Device |------------------------------| 33 | | microvolt | microamp | 34 |----------------------------------------------| 35 | DA9121/DA9130 | Min: 300000 | Min: 7000000 | 36 | | Max: 1900000 | Max: 20000000 | 37 |----------------------------------------------| 38 | DA9121/DA9131 | Min: 300000 | Min: 3500000 | 39 | | Max: 1900000 | Max: 10000000 | 40 |----------------------------------------------| 41 | DA9121/DA9131 | Min: 300000 | Min: 3500000 | 42 | | Max: 1900000 | Max: 6000000 | 43 |----------------------------------------------| 44 | DA9217 | Min: 300000 | Min: 7000000 | 45 | | Max: 1900000 | Max: 12000000 | 46 |----------------------------------------------| 47 | DA9141 | Min: 300000 | Min: 26000000 | 48 | | Max: 1300000 | Max: 78000000 | 49 |----------------------------------------------| 50 | DA9142 | Min: 300000 | Min: 13000000 | 51 | | Max: 1300000 | Max: 39000000 | 52 |----------------------------------------------| 53 54properties: 55 $nodename: 56 pattern: "pmic@[0-9a-f]{1,2}" 57 compatible: 58 enum: 59 - dlg,da9121 60 - dlg,da9122 61 - dlg,da9220 62 - dlg,da9217 63 - dlg,da9130 64 - dlg,da9131 65 - dlg,da9132 66 - dlg,da9141 67 - dlg,da9142 68 69 reg: 70 maxItems: 1 71 description: Specifies the I2C slave address. 72 73 interrupts: 74 maxItems: 1 75 description: IRQ line information. 76 77 dlg,irq-polling-delay-passive-ms: 78 minimum: 1000 79 maximum: 10000 80 description: | 81 Specify the polling period, measured in milliseconds, between interrupt status 82 update checks. Range 1000-10000 ms. 83 84 regulators: 85 type: object 86 additionalProperties: false 87 description: | 88 List of regulators provided by the device 89 90 patternProperties: 91 "^buck([1-2])$": 92 type: object 93 $ref: regulator.yaml# 94 description: | 95 Properties for a single BUCK regulator 96 97 properties: 98 regulator-name: 99 pattern: "^BUCK([1-2])$" 100 description: | 101 BUCK2 present in DA9122, DA9220, DA9131, DA9132 only 102 103 regulator-initial-mode: 104 enum: [ 0, 1, 2, 3 ] 105 description: Defined in include/dt-bindings/regulator/dlg,da9121-regulator.h 106 107 enable-gpios: 108 maxItems: 1 109 description: Specify a valid GPIO for platform control of the regulator 110 111 dlg,ripple-cancel: 112 $ref: "/schemas/types.yaml#/definitions/uint32" 113 enum: [ 0, 1, 2, 3 ] 114 description: | 115 Defined in include/dt-bindings/regulator/dlg,da9121-regulator.h 116 Only present on multi-channel devices (DA9122, DA9220, DA9131, DA9132) 117 118 unevaluatedProperties: false 119 120required: 121 - compatible 122 - reg 123 - regulators 124 125additionalProperties: false 126 127examples: 128 - | 129 #include <dt-bindings/gpio/gpio.h> 130 #include <dt-bindings/interrupt-controller/irq.h> 131 #include <dt-bindings/regulator/dlg,da9121-regulator.h> 132 i2c { 133 #address-cells = <1>; 134 #size-cells = <0>; 135 pmic@68 { 136 compatible = "dlg,da9121"; 137 reg = <0x68>; 138 139 interrupt-parent = <&gpio6>; 140 interrupts = <11 IRQ_TYPE_LEVEL_LOW>; 141 142 dlg,irq-polling-delay-passive-ms = <2000>; 143 144 regulators { 145 DA9121_BUCK1: buck1 { 146 regulator-name = "BUCK1"; 147 regulator-min-microvolt = <300000>; 148 regulator-max-microvolt = <1900000>; 149 regulator-min-microamp = <7000000>; 150 regulator-max-microamp = <20000000>; 151 regulator-boot-on; 152 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>; 153 enable-gpios = <&gpio 1 GPIO_ACTIVE_HIGH>; 154 }; 155 }; 156 }; 157 }; 158 159 - | 160 #include <dt-bindings/gpio/gpio.h> 161 #include <dt-bindings/interrupt-controller/irq.h> 162 #include <dt-bindings/regulator/dlg,da9121-regulator.h> 163 i2c { 164 #address-cells = <1>; 165 #size-cells = <0>; 166 pmic@68 { 167 compatible = "dlg,da9122"; 168 reg = <0x68>; 169 170 interrupt-parent = <&gpio6>; 171 interrupts = <11 IRQ_TYPE_LEVEL_LOW>; 172 173 dlg,irq-polling-delay-passive-ms = <2000>; 174 175 regulators { 176 DA9122_BUCK1: buck1 { 177 regulator-name = "BUCK1"; 178 regulator-min-microvolt = <300000>; 179 regulator-max-microvolt = <1900000>; 180 regulator-min-microamp = <3500000>; 181 regulator-max-microamp = <10000000>; 182 regulator-boot-on; 183 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>; 184 enable-gpios = <&gpio6 1 GPIO_ACTIVE_HIGH>; 185 dlg,ripple-cancel = <DA9121_BUCK_RIPPLE_CANCEL_NONE>; 186 }; 187 DA9122_BUCK2: buck2 { 188 regulator-name = "BUCK2"; 189 regulator-min-microvolt = <300000>; 190 regulator-max-microvolt = <1900000>; 191 regulator-min-microamp = <3500000>; 192 regulator-max-microamp = <10000000>; 193 regulator-boot-on; 194 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>; 195 enable-gpios = <&gpio6 2 GPIO_ACTIVE_HIGH>; 196 dlg,ripple-cancel = <DA9121_BUCK_RIPPLE_CANCEL_NONE>; 197 }; 198 }; 199 }; 200 }; 201... 202