xref: /openbmc/linux/Documentation/devicetree/bindings/hwmon/adi,adm1177.yaml (revision c900529f3d9161bfde5cca0754f83b4d3c3e0220)
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:
30*47aab533SBjorn 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
497f464532SRob HerringadditionalProperties: false
507f464532SRob Herring
5178667161SBeniamin Biaexamples:
5278667161SBeniamin Bia  - |
5378667161SBeniamin Bia    #include <dt-bindings/gpio/gpio.h>
5478667161SBeniamin Bia    #include <dt-bindings/interrupt-controller/irq.h>
5508be4233SKrzysztof Kozlowski    i2c {
5678667161SBeniamin Bia        #address-cells = <1>;
5778667161SBeniamin Bia        #size-cells = <0>;
5878667161SBeniamin Bia
5978667161SBeniamin Bia        pwmon@5a {
6078667161SBeniamin Bia            compatible = "adi,adm1177";
6178667161SBeniamin Bia            reg = <0x5a>;
6278667161SBeniamin Bia            shunt-resistor-micro-ohms = <50000>; /* 50 mOhm */
6378667161SBeniamin Bia            adi,shutdown-threshold-microamp = <1059000>; /* 1.059 A */
6478667161SBeniamin Bia            adi,vrange-high-enable;
6578667161SBeniamin Bia        };
6678667161SBeniamin Bia    };
6778667161SBeniamin Bia...
68