Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

regulator: dt-bindings: lltc,ltc3676: convert to YAML

Convert Linear Technology LTC3676 8-output I2C voltage regulator IC
DT bindings to DT schema. Add missing interrupts: property as this
IC does have interrupt line and it is used in existing DTs.

Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Marek Vasut <marex@denx.de>
Link: https://patch.msgid.link/20241016225235.114635-1-marex@denx.de
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Marek Vasut and committed by
Mark Brown
b9ca2648 59a06dce

+167 -94
+167
Documentation/devicetree/bindings/regulator/lltc,ltc3676.yaml
··· 1 + # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/regulator/lltc,ltc3676.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Linear Technology LTC3676 8-output regulators 8 + 9 + maintainers: 10 + - Tim Harvey <tharvey@gateworks.com> 11 + 12 + description: | 13 + LTC3676 contains eight regulators, 4 switching SW1..SW4 and four LDO1..4 . 14 + 15 + properties: 16 + compatible: 17 + const: lltc,ltc3676 18 + 19 + reg: 20 + maxItems: 1 21 + 22 + interrupts: 23 + maxItems: 1 24 + 25 + regulators: 26 + type: object 27 + additionalProperties: false 28 + description: | 29 + List of regulators provided by this controller, must be named 30 + after their hardware counterparts (SW|LDO)[1-4]. 31 + 32 + patternProperties: 33 + "^(sw[1-4]|ldo[24])$": 34 + type: object 35 + unevaluatedProperties: false 36 + $ref: regulator.yaml# 37 + description: 38 + Properties for single SW or LDO regulator. Regulators SW1..SW4 can 39 + regulate the feedback reference from 412.5mV to 800mV in 12.5 mV 40 + steps. The output voltage thus ranges between 0.4125 * (1 + R1/R2) V 41 + and 0.8 * (1 + R1/R2) V. 42 + Regulators LDO1, LDO2, LDO4 have a fixed 0.725 V reference and thus 43 + output 0.725 * (1 + R1/R2) V. 44 + The LDO1 standby regulator can not be disabled and thus should have 45 + the regulator-always-on property set. 46 + 47 + properties: 48 + lltc,fb-voltage-divider: 49 + description: 50 + An array of two integers containing the resistor values 51 + R1 and R2 of the feedback voltage divider in ohms. 52 + $ref: /schemas/types.yaml#/definitions/uint32-array 53 + minItems: 2 54 + maxItems: 2 55 + 56 + required: 57 + - lltc,fb-voltage-divider 58 + 59 + properties: 60 + ldo1: 61 + type: object 62 + unevaluatedProperties: false 63 + $ref: regulator.yaml# 64 + description: 65 + The LDO1 standby regulator can not be disabled and thus should 66 + have the regulator-always-on property set. See patternProperties 67 + description above for the rest of the details. 68 + 69 + properties: 70 + lltc,fb-voltage-divider: 71 + description: 72 + An array of two integers containing the resistor values 73 + R1 and R2 of the feedback voltage divider in ohms. 74 + $ref: /schemas/types.yaml#/definitions/uint32-array 75 + minItems: 2 76 + maxItems: 2 77 + 78 + required: 79 + - lltc,fb-voltage-divider 80 + - regulator-always-on 81 + 82 + ldo3: 83 + type: object 84 + unevaluatedProperties: false 85 + $ref: regulator.yaml# 86 + description: 87 + The LDO3 regulator is fixed to 1.8 V. See patternProperties 88 + description above for the rest of the details. 89 + 90 + required: 91 + - compatible 92 + - reg 93 + - regulators 94 + 95 + additionalProperties: false 96 + 97 + examples: 98 + - | 99 + i2c { 100 + #address-cells = <1>; 101 + #size-cells = <0>; 102 + 103 + pmic@3c { 104 + compatible = "lltc,ltc3676"; 105 + reg = <0x3c>; 106 + 107 + regulators { 108 + sw1_reg: sw1 { 109 + regulator-min-microvolt = <674400>; 110 + regulator-max-microvolt = <1308000>; 111 + lltc,fb-voltage-divider = <127000 200000>; 112 + regulator-ramp-delay = <7000>; 113 + regulator-boot-on; 114 + regulator-always-on; 115 + }; 116 + 117 + sw2_reg: sw2 { 118 + regulator-min-microvolt = <1033310>; 119 + regulator-max-microvolt = <200400>; 120 + lltc,fb-voltage-divider = <301000 200000>; 121 + regulator-ramp-delay = <7000>; 122 + regulator-boot-on; 123 + regulator-always-on; 124 + }; 125 + 126 + sw3_reg: sw3 { 127 + regulator-min-microvolt = <674400>; 128 + regulator-max-microvolt = <130800>; 129 + lltc,fb-voltage-divider = <127000 200000>; 130 + regulator-ramp-delay = <7000>; 131 + regulator-boot-on; 132 + regulator-always-on; 133 + }; 134 + 135 + sw4_reg: sw4 { 136 + regulator-min-microvolt = <868310>; 137 + regulator-max-microvolt = <168400>; 138 + lltc,fb-voltage-divider = <221000 200000>; 139 + regulator-ramp-delay = <7000>; 140 + regulator-boot-on; 141 + regulator-always-on; 142 + }; 143 + 144 + ldo2_reg: ldo2 { 145 + regulator-min-microvolt = <2490375>; 146 + regulator-max-microvolt = <2490375>; 147 + lltc,fb-voltage-divider = <487000 200000>; 148 + regulator-boot-on; 149 + regulator-always-on; 150 + }; 151 + 152 + ldo3_reg: ldo3 { 153 + regulator-min-microvolt = <1800000>; 154 + regulator-max-microvolt = <1800000>; 155 + regulator-boot-on; 156 + }; 157 + 158 + ldo4_reg: ldo4 { 159 + regulator-min-microvolt = <3023250>; 160 + regulator-max-microvolt = <3023250>; 161 + lltc,fb-voltage-divider = <634000 200000>; 162 + regulator-boot-on; 163 + regulator-always-on; 164 + }; 165 + }; 166 + }; 167 + };
-94
Documentation/devicetree/bindings/regulator/ltc3676.txt
··· 1 - Linear Technology LTC3676 8-output regulators 2 - 3 - Required properties: 4 - - compatible: "lltc,ltc3676" 5 - - reg: I2C slave address 6 - 7 - Required child node: 8 - - regulators: Contains eight regulator child nodes sw1, sw2, sw3, sw4, 9 - ldo1, ldo2, ldo3, and ldo4, specifying the initialization data as 10 - documented in Documentation/devicetree/bindings/regulator/regulator.txt. 11 - 12 - Each regulator is defined using the standard binding for regulators. The 13 - nodes for sw1, sw2, sw3, sw4, ldo1, ldo2 and ldo4 additionally need to specify 14 - the resistor values of their external feedback voltage dividers: 15 - 16 - Required properties (not on ldo3): 17 - - lltc,fb-voltage-divider: An array of two integers containing the resistor 18 - values R1 and R2 of the feedback voltage divider in ohms. 19 - 20 - Regulators sw1, sw2, sw3, sw4 can regulate the feedback reference from: 21 - 412.5mV to 800mV in 12.5 mV steps. The output voltage thus ranges between 22 - 0.4125 * (1 + R1/R2) V and 0.8 * (1 + R1/R2) V. 23 - 24 - Regulators ldo1, ldo2, and ldo4 have a fixed 0.725 V reference and thus output 25 - 0.725 * (1 + R1/R2) V. The ldo3 regulator is fixed to 1.8 V. The ldo1 standby 26 - regulator can not be disabled and thus should have the regulator-always-on 27 - property set. 28 - 29 - Example: 30 - 31 - ltc3676: pmic@3c { 32 - compatible = "lltc,ltc3676"; 33 - reg = <0x3c>; 34 - 35 - regulators { 36 - sw1_reg: sw1 { 37 - regulator-min-microvolt = <674400>; 38 - regulator-max-microvolt = <1308000>; 39 - lltc,fb-voltage-divider = <127000 200000>; 40 - regulator-ramp-delay = <7000>; 41 - regulator-boot-on; 42 - regulator-always-on; 43 - }; 44 - 45 - sw2_reg: sw2 { 46 - regulator-min-microvolt = <1033310>; 47 - regulator-max-microvolt = <200400>; 48 - lltc,fb-voltage-divider = <301000 200000>; 49 - regulator-ramp-delay = <7000>; 50 - regulator-boot-on; 51 - regulator-always-on; 52 - }; 53 - 54 - sw3_reg: sw3 { 55 - regulator-min-microvolt = <674400>; 56 - regulator-max-microvolt = <130800>; 57 - lltc,fb-voltage-divider = <127000 200000>; 58 - regulator-ramp-delay = <7000>; 59 - regulator-boot-on; 60 - regulator-always-on; 61 - }; 62 - 63 - sw4_reg: sw4 { 64 - regulator-min-microvolt = <868310>; 65 - regulator-max-microvolt = <168400>; 66 - lltc,fb-voltage-divider = <221000 200000>; 67 - regulator-ramp-delay = <7000>; 68 - regulator-boot-on; 69 - regulator-always-on; 70 - }; 71 - 72 - ldo2_reg: ldo2 { 73 - regulator-min-microvolt = <2490375>; 74 - regulator-max-microvolt = <2490375>; 75 - lltc,fb-voltage-divider = <487000 200000>; 76 - regulator-boot-on; 77 - regulator-always-on; 78 - }; 79 - 80 - ldo3_reg: ldo3 { 81 - regulator-min-microvolt = <1800000>; 82 - regulator-max-microvolt = <1800000>; 83 - regulator-boot-on; 84 - }; 85 - 86 - ldo4_reg: ldo4 { 87 - regulator-min-microvolt = <3023250>; 88 - regulator-max-microvolt = <3023250>; 89 - lltc,fb-voltage-divider = <634000 200000>; 90 - regulator-boot-on; 91 - regulator-always-on; 92 - }; 93 - }; 94 - };