xref: /openbmc/linux/Documentation/devicetree/bindings/iio/afe/current-sense-amplifier.yaml (revision cdd38c5f1ce4398ec58fec95904b75824daab7b5)
1*fbac26b9SJonathan Cameron# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2*fbac26b9SJonathan Cameron%YAML 1.2
3*fbac26b9SJonathan Cameron---
4*fbac26b9SJonathan Cameron$id: http://devicetree.org/schemas/iio/afe/current-sense-amplifier.yaml#
5*fbac26b9SJonathan Cameron$schema: http://devicetree.org/meta-schemas/core.yaml#
6*fbac26b9SJonathan Cameron
7*fbac26b9SJonathan Camerontitle: Current Sense Amplifier
8*fbac26b9SJonathan Cameron
9*fbac26b9SJonathan Cameronmaintainers:
10*fbac26b9SJonathan Cameron  - Peter Rosin <peda@axentia.se>
11*fbac26b9SJonathan Cameron
12*fbac26b9SJonathan Camerondescription: |
13*fbac26b9SJonathan Cameron  When an io-channel measures the output voltage from a current sense
14*fbac26b9SJonathan Cameron  amplifier, the interesting measurement is almost always the current
15*fbac26b9SJonathan Cameron  through the sense resistor, not the voltage output. This binding
16*fbac26b9SJonathan Cameron  describes such a current sense circuit.
17*fbac26b9SJonathan Cameron
18*fbac26b9SJonathan Cameronproperties:
19*fbac26b9SJonathan Cameron  compatible:
20*fbac26b9SJonathan Cameron    const: current-sense-amplifier
21*fbac26b9SJonathan Cameron
22*fbac26b9SJonathan Cameron  io-channels:
23*fbac26b9SJonathan Cameron    maxItems: 1
24*fbac26b9SJonathan Cameron    description: |
25*fbac26b9SJonathan Cameron      Channel node of a voltage io-channel.
26*fbac26b9SJonathan Cameron
27*fbac26b9SJonathan Cameron  sense-resistor-micro-ohms:
28*fbac26b9SJonathan Cameron    description: The sense resistance.
29*fbac26b9SJonathan Cameron
30*fbac26b9SJonathan Cameron  sense-gain-mult:
31*fbac26b9SJonathan Cameron    $ref: /schemas/types.yaml#/definitions/uint32
32*fbac26b9SJonathan Cameron    description: Amplifier gain multiplier. The default is <1>.
33*fbac26b9SJonathan Cameron
34*fbac26b9SJonathan Cameron  sense-gain-div:
35*fbac26b9SJonathan Cameron    $ref: /schemas/types.yaml#/definitions/uint32
36*fbac26b9SJonathan Cameron    description: Amplifier gain divider. The default is <1>.
37*fbac26b9SJonathan Cameron
38*fbac26b9SJonathan Cameronrequired:
39*fbac26b9SJonathan Cameron  - compatible
40*fbac26b9SJonathan Cameron  - io-channels
41*fbac26b9SJonathan Cameron  - sense-resistor-micro-ohms
42*fbac26b9SJonathan Cameron
43*fbac26b9SJonathan CameronadditionalProperties: false
44*fbac26b9SJonathan Cameron
45*fbac26b9SJonathan Cameronexamples:
46*fbac26b9SJonathan Cameron  - |
47*fbac26b9SJonathan Cameron    sysi {
48*fbac26b9SJonathan Cameron        compatible = "current-sense-amplifier";
49*fbac26b9SJonathan Cameron        io-channels = <&tiadc 0>;
50*fbac26b9SJonathan Cameron
51*fbac26b9SJonathan Cameron        sense-resistor-micro-ohms = <20000>;
52*fbac26b9SJonathan Cameron        sense-gain-mult = <50>;
53*fbac26b9SJonathan Cameron    };
54*fbac26b9SJonathan Cameron...
55