xref: /linux/Documentation/devicetree/bindings/hwmon/pmbus/adi,vt7505.yaml (revision 67f8bc848ee31831336bd478e57d2f993551902e) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/hwmon/pmbus/adi,vt7505.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Analog Devices MAX16545/MAX16550 and Volterra VT7505 PMBus controllers
8
9maintainers:
10  - Sanman Pradhan <psanman@juniper.net>
11
12description: |
13  The Analog Devices MAX16545 and MAX16550, and the Volterra VT7505, are PMBus
14  controllers that provide input/output voltage, input/output current,
15  input power and temperature monitoring over the PMBus interface.
16
17  The MAX16545 uses the same programming model as the VT7505.
18
19  Datasheets:
20  https://www.analog.com/media/en/technical-documentation/data-sheets/max16545b-max16545c.pdf
21  https://www.analog.com/media/en/technical-documentation/data-sheets/max16550.pdf
22
23properties:
24  compatible:
25    oneOf:
26      - enum:
27          - adi,max16550
28          - adi,vt7505
29      - items:
30          - const: adi,max16545
31          - const: adi,vt7505
32
33  reg:
34    maxItems: 1
35
36  adi,rload-ohms:
37    description:
38      Resistance in ohms of the external telemetry load resistor connected
39      between the ILOAD current-output pin and ground. This is not a
40      current-path shunt resistor; it sets the scaling of the reported input
41      current, output current and input power.
42    minimum: 1
43    maximum: 283383959
44    default: 4750
45
46  adi,ocp-severe-filter-us:
47    description:
48      Deglitch time, in microseconds, applied to the severe
49      overcurrent-protection comparator, programmed into the
50      MFR_CONFIG[15:14] field. The MAX16550 and VT7505 expose this field.
51      On the MAX16545 the severe overcurrent delay is fixed and these bits
52      are reserved. If omitted, the existing hardware setting is retained.
53    enum: [0, 1, 2, 10]
54
55required:
56  - compatible
57  - reg
58
59allOf:
60  # The severe OCP deglitch filter is fixed on the MAX16545, so the property
61  # is only valid for the MAX16550 and VT7505.
62  - if:
63      properties:
64        compatible:
65          contains:
66            const: adi,max16545
67    then:
68      properties:
69        adi,ocp-severe-filter-us: false
70
71additionalProperties: false
72
73examples:
74  - |
75    i2c {
76        #address-cells = <1>;
77        #size-cells = <0>;
78
79        regulator@40 {
80            compatible = "adi,vt7505";
81            reg = <0x40>;
82            adi,rload-ohms = <4750>;
83            adi,ocp-severe-filter-us = <10>;
84        };
85    };
86