214 lines · yaml
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)2%YAML 1.23---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 regulator8 9maintainers:10 - Adam Ward <Adam.Ward.opensource@diasemi.com>11 12description: |13 Dialog Semiconductor DA9121 Single-channel 10A double-phase buck converter14 Dialog Semiconductor DA9122 Double-channel 5A single-phase buck converter15 Dialog Semiconductor DA9220 Double-channel 3A single-phase buck converter16 Dialog Semiconductor DA9217 Single-channel 6A double-phase buck converter17 Dialog Semiconductor DA9130 Single-channel 10A double-phase buck converter18 Dialog Semiconductor DA9131 Double-channel 5A single-phase buck converter19 Dialog Semiconductor DA9132 Double-channel 3A single-phase buck converter20 Dialog Semiconductor DA9141 Single-channel 40A quad-phase buck converter21 Dialog Semiconductor DA9142 Single-channel 20A double-phase buck converter22 23 Device parameter ranges24 25 The current limits can be set to at/near double the rated current per channel26 to allow for transient peaks.27 Current limit changes when the output is enabled are not supported, as a28 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,da912160 - dlg,da912261 - dlg,da922062 - dlg,da921763 - dlg,da913064 - dlg,da913165 - dlg,da913266 - dlg,da914167 - dlg,da914268 69 reg:70 maxItems: 171 description: Specifies the I2C slave address.72 73 interrupts:74 maxItems: 175 description: IRQ line information.76 77 dlg,irq-polling-delay-passive-ms:78 minimum: 100079 maximum: 1000080 description: |81 Specify the polling period, measured in milliseconds, between interrupt status82 update checks. Range 1000-10000 ms.83 84 regulators:85 type: object86 additionalProperties: false87 description: |88 List of regulators provided by the device89 90 patternProperties:91 "^buck([1-2])$":92 type: object93 $ref: regulator.yaml#94 description: |95 Properties for a single BUCK regulator96 97 properties:98 regulator-initial-mode:99 enum: [ 0, 1, 2, 3 ]100 description: Defined in include/dt-bindings/regulator/dlg,da9121-regulator.h101 102 enable-gpios:103 maxItems: 1104 description: Specify a valid GPIO for platform control of the regulator105 106 dlg,ripple-cancel:107 $ref: /schemas/types.yaml#/definitions/uint32108 enum: [ 0, 1, 2, 3 ]109 description: |110 Defined in include/dt-bindings/regulator/dlg,da9121-regulator.h111 Only present on multi-channel devices (DA9122, DA9220, DA9131, DA9132)112 113 unevaluatedProperties: false114 115required:116 - compatible117 - reg118 - regulators119 120allOf:121 - if:122 properties:123 compatible:124 not:125 contains:126 enum:127 - dlg,da9122128 - dlg,da9131129 - dlg,da9132130 - dlg,da9220131 then:132 properties:133 regulators:134 properties:135 buck2: false136 137additionalProperties: false138 139examples:140 - |141 #include <dt-bindings/gpio/gpio.h>142 #include <dt-bindings/interrupt-controller/irq.h>143 #include <dt-bindings/regulator/dlg,da9121-regulator.h>144 i2c {145 #address-cells = <1>;146 #size-cells = <0>;147 pmic@68 {148 compatible = "dlg,da9121";149 reg = <0x68>;150 151 interrupt-parent = <&gpio6>;152 interrupts = <11 IRQ_TYPE_LEVEL_LOW>;153 154 dlg,irq-polling-delay-passive-ms = <2000>;155 156 regulators {157 DA9121_BUCK1: buck1 {158 regulator-name = "BUCK1";159 regulator-min-microvolt = <300000>;160 regulator-max-microvolt = <1900000>;161 regulator-min-microamp = <7000000>;162 regulator-max-microamp = <20000000>;163 regulator-boot-on;164 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>;165 enable-gpios = <&gpio 1 GPIO_ACTIVE_HIGH>;166 };167 };168 };169 };170 171 - |172 #include <dt-bindings/gpio/gpio.h>173 #include <dt-bindings/interrupt-controller/irq.h>174 #include <dt-bindings/regulator/dlg,da9121-regulator.h>175 i2c {176 #address-cells = <1>;177 #size-cells = <0>;178 pmic@68 {179 compatible = "dlg,da9122";180 reg = <0x68>;181 182 interrupt-parent = <&gpio6>;183 interrupts = <11 IRQ_TYPE_LEVEL_LOW>;184 185 dlg,irq-polling-delay-passive-ms = <2000>;186 187 regulators {188 DA9122_BUCK1: buck1 {189 regulator-name = "BUCK1";190 regulator-min-microvolt = <300000>;191 regulator-max-microvolt = <1900000>;192 regulator-min-microamp = <3500000>;193 regulator-max-microamp = <10000000>;194 regulator-boot-on;195 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>;196 enable-gpios = <&gpio6 1 GPIO_ACTIVE_HIGH>;197 dlg,ripple-cancel = <DA9121_BUCK_RIPPLE_CANCEL_NONE>;198 };199 DA9122_BUCK2: buck2 {200 regulator-name = "BUCK2";201 regulator-min-microvolt = <300000>;202 regulator-max-microvolt = <1900000>;203 regulator-min-microamp = <3500000>;204 regulator-max-microamp = <10000000>;205 regulator-boot-on;206 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>;207 enable-gpios = <&gpio6 2 GPIO_ACTIVE_HIGH>;208 dlg,ripple-cancel = <DA9121_BUCK_RIPPLE_CANCEL_NONE>;209 };210 };211 };212 };213...214