2020-11-11 16:19:23

by Alexandru Tachici

[permalink] [raw]
Subject: [PATCH v2 0/3] hwmon: ltc2992: Add support

From: Alexandru Tachici <[email protected]>

LTC2992 is a rail-to-rail system monitor that
measures current, voltage, and power of two supplies.

Two ADCs simultaneously measure each supply’s current.
A third ADC monitors the input voltages and four
auxiliary external voltages (GPIOs).

1. Use hwmon to create sysfs entries for current, voltage
and power of two 0V to 100V supplies. Create sysfs entries
for voltage sensed on the 4 GPIO pins.

2. Expose to userspace the 4 open-drain GPIOs provided by ltc2992.

3. DT bindings for ltc2992.

Alexandru Tachici (3):
hwmon: ltc2992: Add support
hwmon: ltc2992: Add support for GPIOs.
dt-binding: hwmon: Add documentation for ltc2992

Changelog v1 -> v2:
- ltc2992_read_reg function returns the reg value directly
- historical min max values are reported now through lowest and highest sysfs
- added alarm sysfs for both min and max values
- added reset history option: writing to in_reset_history will reset all
lowest/highest values
- fixed missing static
- fixed dt bindings errors

.../bindings/hwmon/adi,ltc2992.yaml | 80 ++
Documentation/hwmon/index.rst | 1 +
Documentation/hwmon/ltc2992.rst | 56 +
drivers/hwmon/Kconfig | 12 +
drivers/hwmon/Makefile | 1 +
drivers/hwmon/ltc2992.c | 976 ++++++++++++++++++
6 files changed, 1126 insertions(+)
create mode 100644 Documentation/devicetree/bindings/hwmon/adi,ltc2992.yaml
create mode 100644 Documentation/hwmon/ltc2992.rst
create mode 100644 drivers/hwmon/ltc2992.c

--
2.20.1


2020-11-11 16:20:25

by Alexandru Tachici

[permalink] [raw]
Subject: [PATCH v2 3/3] dt-binding: hwmon: Add documentation for ltc2992

From: Alexandru Tachici <[email protected]>

Add documentation for ltc2992.

Signed-off-by: Alexandru Tachici <[email protected]>
---
.../bindings/hwmon/adi,ltc2992.yaml | 80 +++++++++++++++++++
1 file changed, 80 insertions(+)
create mode 100644 Documentation/devicetree/bindings/hwmon/adi,ltc2992.yaml

diff --git a/Documentation/devicetree/bindings/hwmon/adi,ltc2992.yaml b/Documentation/devicetree/bindings/hwmon/adi,ltc2992.yaml
new file mode 100644
index 000000000000..64a8fcb7bc46
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwmon/adi,ltc2992.yaml
@@ -0,0 +1,80 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/hwmon/adi,ltc2992.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Linear Technology 2992 Power Monitor
+
+maintainers:
+ - Alexandru Tachici <[email protected]>
+
+description: |
+ Linear Technology 2992 Dual Wide Range Power Monitor
+ https://www.analog.com/media/en/technical-documentation/data-sheets/ltc2992.pdf
+
+properties:
+ compatible:
+ enum:
+ - adi,ltc2992
+
+ reg:
+ maxItems: 1
+
+ '#address-cells':
+ const: 1
+
+ '#size-cells':
+ const: 0
+
+ avcc-supply: true
+
+patternProperties:
+ "^channel@([0-1])$":
+ type: object
+ description: |
+ Represents the two supplies to be monitored.
+
+ properties:
+ reg:
+ description: |
+ The channel number. LTC2992 can monitor two supplies.
+ items:
+ minimum: 0
+ maximum: 1
+
+ shunt-resistor-micro-ohms:
+ description:
+ The value of curent sense resistor in microohms.
+
+required:
+ - compatible
+ - reg
+
+additionalProperties: false
+
+examples:
+ - |
+ i2c1 {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ ltc2992@6F {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ compatible = "adi,ltc2992";
+ reg = <0x6F>;
+
+ channel@0 {
+ reg = <0x0>;
+ shunt-resistor-micro-ohms = <10000>;
+ };
+
+ channel@1 {
+ reg = <0x1>;
+ shunt-resistor-micro-ohms = <10000>;
+ };
+ };
+ };
+...
--
2.20.1

2020-11-17 02:01:00

by Rob Herring

[permalink] [raw]
Subject: Re: [PATCH v2 3/3] dt-binding: hwmon: Add documentation for ltc2992

On Wed, 11 Nov 2020 18:20:57 +0200, [email protected] wrote:
> From: Alexandru Tachici <[email protected]>
>
> Add documentation for ltc2992.
>
> Signed-off-by: Alexandru Tachici <[email protected]>
> ---
> .../bindings/hwmon/adi,ltc2992.yaml | 80 +++++++++++++++++++
> 1 file changed, 80 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/hwmon/adi,ltc2992.yaml
>

Reviewed-by: Rob Herring <[email protected]>