From 39df36b59f01fd8f738a1c18454df54b979a7ae2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nuno=20S=C3=A1?= Date: Fri, 11 Sep 2026 14:53:39 +0100 Subject: [PATCH] dt-bindings: hwmon/pmbus: Document MAX20826 and similar devices MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The MAX20826 IC and similar provide a high-density, flexible and scalable dual-loop solution for high current cores for AI applications. These are dual loop solutions multiphase voltage regulators. Between Rails A and B, MAX20855B and MAX20908 supports up to 8 phases total configurable from 8+0 to 4+4 phases, MAX20912 supports up to 12 phases from 12+0 to 6+6, and MAX20826 and MAX20916 supports up to 16 phases from 16+0 to 8+8. The output voltage of each rail is controlled either through PMBus or through the high-speed processor voltage-control interface (Intel SVID, AMD SVI3, Nvidia PWMVID or AVSBus, depending on the device). Which one is in use is part of the configuration the device powers up with and is read back from it, hence adi,rail-a-high-speed and adi,rail-b-high-speed only tell whether the high-speed interface or PMBus controls the output voltage of the respective rail. Co-developed-by: Alexis Czezar Torreno Signed-off-by: Alexis Czezar Torreno Signed-off-by: Nuno Sá Acked-by: Conor Dooley Link: https://patch.msgid.link/20260911-hwmon-max20826-support-v2-3-5e30cbd97d84@analog.com Signed-off-by: Guenter Roeck --- .../bindings/hwmon/pmbus/adi,max20826.yaml | 102 ++++++++++++++++++ MAINTAINERS | 7 ++ 2 files changed, 109 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/pmbus/adi,max20826.yaml diff --git a/Documentation/devicetree/bindings/hwmon/pmbus/adi,max20826.yaml b/Documentation/devicetree/bindings/hwmon/pmbus/adi,max20826.yaml new file mode 100644 index 000000000000..e3bb51d6d1d6 --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/pmbus/adi,max20826.yaml @@ -0,0 +1,102 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/hwmon/pmbus/adi,max20826.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Analog Devices MAX20826 PMBus Voltage Regulator + +maintainers: + - Nuno Sá + +description: + Analog Devices MAX20826 and similar devices are Dual-Output Multiphase + High-Current Controller. + +properties: + compatible: + enum: + - adi,max20826 + - adi,max20855b + - adi,max20908 + - adi,max20912 + - adi,max20916 + + reg: + maxItems: 1 + + vdd3p3-supply: + description: + 3.3V bias supply. It is the input of the internal 1.8V linear regulator + which supplies the controller. + + avren-gpios: + description: GPIO pin to enable/disable the output voltage on Rail A. + maxItems: 1 + + bvren-gpios: + description: GPIO pin to enable/disable the output voltage on Rail B. + maxItems: 1 + + adi,rail-a-high-speed: + type: boolean + description: + The output voltage of Rail A is controlled by the high-speed processor + voltage-control interface the device powered up in (PWMVID, SVID, SVI3 or + AVSBus). If not given, PMBus controls the output voltage of Rail A. + + adi,rail-b-high-speed: + type: boolean + description: + Same as adi,rail-a-high-speed but for Rail B. + + regulators: + type: object + description: + List of regulators provided by this controller. vout0 is Rail A and + vout1 is Rail B. + + patternProperties: + "^vout[0-1]$": + $ref: /schemas/regulator/regulator.yaml# + type: object + unevaluatedProperties: false + + additionalProperties: false + +required: + - compatible + - reg + - vdd3p3-supply + +additionalProperties: false + +examples: + - | + #include + i2c { + #address-cells = <1>; + #size-cells = <0>; + + regulator@64 { + compatible = "adi,max20826"; + reg = <0x64>; + + vdd3p3-supply = <&vdd3p3>; + + avren-gpios = <&gpio 0 GPIO_ACTIVE_HIGH>; + bvren-gpios = <&gpio 1 GPIO_ACTIVE_HIGH>; + + adi,rail-a-high-speed; + + regulators { + vout0 { + regulator-name = "vcore_a"; + }; + + vout1 { + regulator-name = "vcore_b"; + }; + }; + }; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 5304761819d9..c8874088d4e3 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -16005,6 +16005,13 @@ F: Documentation/devicetree/bindings/hwmon/pmbus/adi,max17616.yaml F: Documentation/hwmon/max17616.rst F: drivers/hwmon/pmbus/max17616.c +MAX20826 HARDWARE MONITOR CONTROLLER DRIVER +M: Nuno Sá +L: linux-hwmon@vger.kernel.org +S: Supported +W: https://ez.analog.com/linux-software-drivers +F: Documentation/devicetree/bindings/hwmon/pmbus/adi,max20826.yaml + MAX20830 HARDWARE MONITOR DRIVER M: Alexis Czezar Torreno L: linux-hwmon@vger.kernel.org