xref: /linux/Documentation/devicetree/bindings/hwmon/adi,adm1177.yaml (revision ae22a94997b8a03dcb3c922857c203246711f9d4) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/hwmon/adi,adm1177.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Analog Devices ADM1177 Hot Swap Controller and Digital Power Monitor
8
9maintainers:
10  - Michael Hennerich <michael.hennerich@analog.com>
11
12description: |
13  Analog Devices ADM1177 Hot Swap Controller and Digital Power Monitor
14  https://www.analog.com/media/en/technical-documentation/data-sheets/ADM1177.pdf
15
16properties:
17  compatible:
18    enum:
19      - adi,adm1177
20
21  reg:
22    maxItems: 1
23
24  avcc-supply:
25    description:
26      Phandle to the Avcc power supply
27
28  shunt-resistor-micro-ohms:
29    description:
30      The value of current sense resistor in microohms. If not provided,
31      the current reading and overcurrent alert is disabled.
32
33  adi,shutdown-threshold-microamp:
34    description:
35      Specifies the current level at which an over current alert occurs.
36      If not provided, the overcurrent alert is configured to max ADC range
37      based on shunt-resistor-micro-ohms.
38
39  adi,vrange-high-enable:
40    description:
41      Specifies which internal voltage divider to be used. A 1 selects
42      a 7:2 voltage divider while a 0 selects a 14:1 voltage divider.
43    type: boolean
44
45required:
46  - compatible
47  - reg
48
49allOf:
50  - $ref: hwmon-common.yaml#
51
52unevaluatedProperties: false
53
54examples:
55  - |
56    #include <dt-bindings/gpio/gpio.h>
57    #include <dt-bindings/interrupt-controller/irq.h>
58    i2c {
59        #address-cells = <1>;
60        #size-cells = <0>;
61
62        pwmon@5a {
63            compatible = "adi,adm1177";
64            reg = <0x5a>;
65            shunt-resistor-micro-ohms = <50000>; /* 50 mOhm */
66            adi,shutdown-threshold-microamp = <1059000>; /* 1.059 A */
67            adi,vrange-high-enable;
68        };
69    };
70...
71