xref: /linux/Documentation/devicetree/bindings/hwmon/adi,adm1177.yaml (revision 79790b6818e96c58fe2bffee1b418c16e64e7b80)
178667161SBeniamin Bia# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
278667161SBeniamin Bia%YAML 1.2
378667161SBeniamin Bia---
478667161SBeniamin Bia$id: http://devicetree.org/schemas/hwmon/adi,adm1177.yaml#
578667161SBeniamin Bia$schema: http://devicetree.org/meta-schemas/core.yaml#
678667161SBeniamin Bia
778667161SBeniamin Biatitle: Analog Devices ADM1177 Hot Swap Controller and Digital Power Monitor
878667161SBeniamin Bia
978667161SBeniamin Biamaintainers:
1078667161SBeniamin Bia  - Michael Hennerich <michael.hennerich@analog.com>
1178667161SBeniamin Bia
1278667161SBeniamin Biadescription: |
1378667161SBeniamin Bia  Analog Devices ADM1177 Hot Swap Controller and Digital Power Monitor
1478667161SBeniamin Bia  https://www.analog.com/media/en/technical-documentation/data-sheets/ADM1177.pdf
1578667161SBeniamin Bia
1678667161SBeniamin Biaproperties:
1778667161SBeniamin Bia  compatible:
1878667161SBeniamin Bia    enum:
1978667161SBeniamin Bia      - adi,adm1177
2078667161SBeniamin Bia
2178667161SBeniamin Bia  reg:
2278667161SBeniamin Bia    maxItems: 1
2378667161SBeniamin Bia
2478667161SBeniamin Bia  avcc-supply:
2578667161SBeniamin Bia    description:
2678667161SBeniamin Bia      Phandle to the Avcc power supply
2778667161SBeniamin Bia
2878667161SBeniamin Bia  shunt-resistor-micro-ohms:
2978667161SBeniamin Bia    description:
3047aab533SBjorn Helgaas      The value of current sense resistor in microohms. If not provided,
3178667161SBeniamin Bia      the current reading and overcurrent alert is disabled.
3278667161SBeniamin Bia
3378667161SBeniamin Bia  adi,shutdown-threshold-microamp:
3478667161SBeniamin Bia    description:
3578667161SBeniamin Bia      Specifies the current level at which an over current alert occurs.
3678667161SBeniamin Bia      If not provided, the overcurrent alert is configured to max ADC range
3778667161SBeniamin Bia      based on shunt-resistor-micro-ohms.
3878667161SBeniamin Bia
3978667161SBeniamin Bia  adi,vrange-high-enable:
4078667161SBeniamin Bia    description:
4178667161SBeniamin Bia      Specifies which internal voltage divider to be used. A 1 selects
4278667161SBeniamin Bia      a 7:2 voltage divider while a 0 selects a 14:1 voltage divider.
4378667161SBeniamin Bia    type: boolean
4478667161SBeniamin Bia
4578667161SBeniamin Biarequired:
4678667161SBeniamin Bia  - compatible
4778667161SBeniamin Bia  - reg
4878667161SBeniamin Bia
49*a095d8c0SKrzysztof KozlowskiallOf:
50*a095d8c0SKrzysztof Kozlowski  - $ref: hwmon-common.yaml#
51*a095d8c0SKrzysztof Kozlowski
52*a095d8c0SKrzysztof KozlowskiunevaluatedProperties: false
537f464532SRob Herring
5478667161SBeniamin Biaexamples:
5578667161SBeniamin Bia  - |
5678667161SBeniamin Bia    #include <dt-bindings/gpio/gpio.h>
5778667161SBeniamin Bia    #include <dt-bindings/interrupt-controller/irq.h>
5808be4233SKrzysztof Kozlowski    i2c {
5978667161SBeniamin Bia        #address-cells = <1>;
6078667161SBeniamin Bia        #size-cells = <0>;
6178667161SBeniamin Bia
6278667161SBeniamin Bia        pwmon@5a {
6378667161SBeniamin Bia            compatible = "adi,adm1177";
6478667161SBeniamin Bia            reg = <0x5a>;
6578667161SBeniamin Bia            shunt-resistor-micro-ohms = <50000>; /* 50 mOhm */
6678667161SBeniamin Bia            adi,shutdown-threshold-microamp = <1059000>; /* 1.059 A */
6778667161SBeniamin Bia            adi,vrange-high-enable;
6878667161SBeniamin Bia        };
6978667161SBeniamin Bia    };
7078667161SBeniamin Bia...
71