devicetree.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Matteo Martelli <matteomartelli3@gmail.com>
To: Jonathan Cameron <jic23@kernel.org>,
	 Lars-Peter Clausen <lars@metafoo.de>,
	Rob Herring <robh@kernel.org>,
	 Krzysztof Kozlowski <krzk+dt@kernel.org>,
	 Conor Dooley <conor+dt@kernel.org>
Cc: linux-iio@vger.kernel.org, devicetree@vger.kernel.org,
	 linux-kernel@vger.kernel.org,
	Matteo Martelli <matteomartelli3@gmail.com>
Subject: [PATCH 1/2] dt-bindings: iio: adc: add binding for pac1921
Date: Wed, 03 Jul 2024 15:34:35 +0200	[thread overview]
Message-ID: <20240703-iio-pac1921-v1-1-54c47d9180b6@gmail.com> (raw)
In-Reply-To: <20240703-iio-pac1921-v1-0-54c47d9180b6@gmail.com>

Add binging for Microchip PAC1921 Power/Current monitor

Signed-off-by: Matteo Martelli <matteomartelli3@gmail.com>
---
 .../bindings/iio/adc/microchip,pac1921.yaml        | 79 ++++++++++++++++++++++
 1 file changed, 79 insertions(+)

diff --git a/Documentation/devicetree/bindings/iio/adc/microchip,pac1921.yaml b/Documentation/devicetree/bindings/iio/adc/microchip,pac1921.yaml
new file mode 100644
index 000000000000..ec08228dcc16
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/adc/microchip,pac1921.yaml
@@ -0,0 +1,79 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/iio/adc/microchip,pac1921.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Microchip PAC1921 High-Side Power/Current Monitor with Anaog Output
+
+maintainers:
+  - Matteo Martelli <matteomartelli3@gmail.com>
+
+description: |
+  The PAC1921 is a power/current monitoring device with an analog output
+  and I2C/SMBus interface.
+
+  Datasheet can be found here:
+  https://ww1.microchip.com/downloads/en/DeviceDoc/PAC1921-Data-Sheet-DS20005293E.pdf
+
+properties:
+  compatible:
+    const: microchip,pac1921
+
+  reg:
+    maxItems: 1
+
+  "#io-channel-cells":
+    const: 1
+
+  shunt-resistor-micro-ohms:
+    description:
+      Value in micro Ohms of the shunt resistor connected between
+      the SENSE+ and SENSE- inputs, across which the current is measured.
+      Value is needed to compute the scaling of the measured current.
+
+  label:
+    description: Unique name to identify which device this is.
+
+  microchip,dv-gain:
+    description:
+      Digital multiplier to control the effective bus voltage gain. The gain
+      value of 1 is the setting for the full-scale range and it can be increased
+      when the system is designed for a lower VBUS range.
+    $ref: /schemas/types.yaml#/definitions/uint32
+    enum: [1, 2, 4, 8, 16, 32]
+    default: 1
+
+  microchip,di-gain:
+    description:
+      Digital multiplier to control the effective current gain. The gain
+      value of 1 is the setting for the full-scale range and it can be
+      increased when the system is designed for a lower VSENSE range.
+    $ref: /schemas/types.yaml#/definitions/uint32
+    enum: [1, 2, 4, 8, 16, 32, 64, 128]
+    default: 1
+
+required:
+  - compatible
+  - reg
+  - shunt-resistor-micro-ohms
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        adc@4c {
+            compatible = "microchip,pac1921";
+            #io-channel-cells = <1>;
+            label = "vbat";
+            reg = <0x4c>;
+            shunt-resistor-micro-ohms = <10000>;
+            microchip,dv-gain = <4>;
+            microchip,di-gain = <32>;
+        };
+    };
+...

-- 
2.45.1


  reply	other threads:[~2024-07-03 13:35 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-07-03 13:34 [PATCH 0/2] iio: adc: add support for pac1921 Matteo Martelli
2024-07-03 13:34 ` Matteo Martelli [this message]
2024-07-03 15:10   ` [PATCH 1/2] dt-bindings: iio: adc: add binding " Conor Dooley
2024-07-04 10:06     ` Matteo Martelli
2024-07-04 10:37       ` Conor Dooley
2024-07-04 17:50         ` Matteo Martelli
2024-07-03 13:34 ` [PATCH 2/2] iio: adc: add support " Matteo Martelli
     [not found]   ` <SN6PR11MB3167C48F19120E35862316FA99DE2@SN6PR11MB3167.namprd11.prod.outlook.com>
2024-07-05  8:39     ` Marius.Cristea
2024-07-08 13:45       ` Matteo Martelli
2024-07-13 10:09         ` Jonathan Cameron
2024-07-03 14:55 ` [PATCH 0/2] " Conor Dooley

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240703-iio-pac1921-v1-1-54c47d9180b6@gmail.com \
    --to=matteomartelli3@gmail.com \
    --cc=conor+dt@kernel.org \
    --cc=devicetree@vger.kernel.org \
    --cc=jic23@kernel.org \
    --cc=krzk+dt@kernel.org \
    --cc=lars@metafoo.de \
    --cc=linux-iio@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=robh@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).