xref: /freebsd/sys/contrib/device-tree/Bindings/hwmon/maxim,max20730.yaml (revision 0d66206fff44f864ea8a4b220c3a53b4caa959a0)
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4
5$id: http://devicetree.org/schemas/hwmon/maxim,max20730.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Maxim max20730
9
10maintainers:
11  - Jean Delvare <jdelvare@suse.com>
12  - Guenter Roeck <linux@roeck-us.net>
13
14description: |
15  The MAX20730 is a fully integrated, highly efficient switching regulator
16  with PMBus for applications operating from 4.5V to 16V and requiring
17  up to 25A (max) load. This single-chip regulator provides extremely
18  compact, high efficiency power-delivery solutions with high-precision
19  output voltages and excellent transient response.
20
21  Datasheets:
22    https://datasheets.maximintegrated.com/en/ds/MAX20730.pdf
23    https://datasheets.maximintegrated.com/en/ds/MAX20734.pdf
24    https://datasheets.maximintegrated.com/en/ds/MAX20743.pdf
25
26properties:
27  compatible:
28    enum:
29      - maxim,max20730
30      - maxim,max20734
31      - maxim,max20743
32
33  reg:
34    maxItems: 1
35
36  vout-voltage-divider:
37    description: |
38      If voltage divider present at vout, the voltage at voltage sensor pin
39      will be scaled. The properties will convert the raw reading to a more
40      meaningful number if voltage divider present. It has two numbers,
41      the first number is the output resistor, the second number is the total
42      resistance. Therefore, the adjusted vout is equal to
43      Vout = Vout * output_resistance / total resistance.
44    $ref: /schemas/types.yaml#/definitions/uint32-array
45    minItems: 2
46    maxItems: 2
47
48required:
49  - compatible
50  - reg
51
52additionalProperties: false
53
54examples:
55  - |
56    i2c {
57      #address-cells = <1>;
58      #size-cells = <0>;
59
60      max20730@10 {
61        compatible = "maxim,max20730";
62        reg = <0x10>;
63        vout-voltage-divider = <1000 2000>; // vout would be scaled to 0.5
64      };
65    };
66