dlg,da9121.yaml (6616B)
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 description: | 87 List of regulators provided by the device 88 89 patternProperties: 90 "^buck([1-2])$": 91 type: object 92 $ref: regulator.yaml# 93 description: | 94 Properties for a single BUCK regulator 95 96 properties: 97 regulator-name: 98 pattern: "^BUCK([1-2])$" 99 description: | 100 BUCK2 present in DA9122, DA9220, DA9131, DA9132 only 101 102 regulator-initial-mode: 103 enum: [ 0, 1, 2, 3 ] 104 description: Defined in include/dt-bindings/regulator/dlg,da9121-regulator.h 105 106 enable-gpios: 107 maxItems: 1 108 description: Specify a valid GPIO for platform control of the regulator 109 110 dlg,ripple-cancel: 111 $ref: "/schemas/types.yaml#/definitions/uint32" 112 enum: [ 0, 1, 2, 3 ] 113 description: | 114 Defined in include/dt-bindings/regulator/dlg,da9121-regulator.h 115 Only present on multi-channel devices (DA9122, DA9220, DA9131, DA9132) 116 117 unevaluatedProperties: false 118 119required: 120 - compatible 121 - reg 122 - regulators 123 124additionalProperties: false 125 126examples: 127 - | 128 #include <dt-bindings/gpio/gpio.h> 129 #include <dt-bindings/interrupt-controller/irq.h> 130 #include <dt-bindings/regulator/dlg,da9121-regulator.h> 131 i2c { 132 #address-cells = <1>; 133 #size-cells = <0>; 134 pmic@68 { 135 compatible = "dlg,da9121"; 136 reg = <0x68>; 137 138 interrupt-parent = <&gpio6>; 139 interrupts = <11 IRQ_TYPE_LEVEL_LOW>; 140 141 dlg,irq-polling-delay-passive-ms = <2000>; 142 143 regulators { 144 DA9121_BUCK1: buck1 { 145 regulator-name = "BUCK1"; 146 regulator-min-microvolt = <300000>; 147 regulator-max-microvolt = <1900000>; 148 regulator-min-microamp = <7000000>; 149 regulator-max-microamp = <20000000>; 150 regulator-boot-on; 151 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>; 152 enable-gpios = <&gpio 1 GPIO_ACTIVE_HIGH>; 153 }; 154 }; 155 }; 156 }; 157 158 - | 159 #include <dt-bindings/gpio/gpio.h> 160 #include <dt-bindings/interrupt-controller/irq.h> 161 #include <dt-bindings/regulator/dlg,da9121-regulator.h> 162 i2c { 163 #address-cells = <1>; 164 #size-cells = <0>; 165 pmic@68 { 166 compatible = "dlg,da9122"; 167 reg = <0x68>; 168 169 interrupt-parent = <&gpio6>; 170 interrupts = <11 IRQ_TYPE_LEVEL_LOW>; 171 172 dlg,irq-polling-delay-passive-ms = <2000>; 173 174 regulators { 175 DA9122_BUCK1: buck1 { 176 regulator-name = "BUCK1"; 177 regulator-min-microvolt = <300000>; 178 regulator-max-microvolt = <1900000>; 179 regulator-min-microamp = <3500000>; 180 regulator-max-microamp = <10000000>; 181 regulator-boot-on; 182 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>; 183 enable-gpios = <&gpio6 1 GPIO_ACTIVE_HIGH>; 184 dlg,ripple-cancel = <DA9121_BUCK_RIPPLE_CANCEL_NONE>; 185 }; 186 DA9122_BUCK2: buck2 { 187 regulator-name = "BUCK2"; 188 regulator-min-microvolt = <300000>; 189 regulator-max-microvolt = <1900000>; 190 regulator-min-microamp = <3500000>; 191 regulator-max-microamp = <10000000>; 192 regulator-boot-on; 193 regulator-initial-mode = <DA9121_BUCK_MODE_AUTO>; 194 enable-gpios = <&gpio6 2 GPIO_ACTIVE_HIGH>; 195 dlg,ripple-cancel = <DA9121_BUCK_RIPPLE_CANCEL_NONE>; 196 }; 197 }; 198 }; 199 }; 200...