Documentation/devicetree/bindings/hwmon/maxim,max20730.yaml

   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
   8 title: Maxim max20730
   9
  10 maintainers:
  11   - Jean Delvare <jdelvare@suse.com>
  12   - Guenter Roeck <linux@roeck-us.net>
  13
  14 description: |
  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
  26 properties:
  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
  48 required:
  49   - compatible
  50   - reg
  51
  52 additionalProperties: false
  53
  54 examples:
  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     };