[PATCH v4 2/2] dt-bindings: hwmon: Add sample averaging properties for ADM1275

From: Potin Lai
Date: Tue Mar 01 2022 - 05:39:47 EST


Add documentation of new properties for sample averaging in PMON_CONFIG
register.

New properties:
- adi,volt-curr-sample-average
- adi,power-sample-average
- adi,power-sample-average-enable

Signed-off-by: Potin Lai <potin.lai@xxxxxxxxxxxx>
---
.../bindings/hwmon/adi,adm1275.yaml | 44 +++++++++++++++++++
1 file changed, 44 insertions(+)

diff --git a/Documentation/devicetree/bindings/hwmon/adi,adm1275.yaml b/Documentation/devicetree/bindings/hwmon/adi,adm1275.yaml
index 223393d7cafd..1b612dc06992 100644
--- a/Documentation/devicetree/bindings/hwmon/adi,adm1275.yaml
+++ b/Documentation/devicetree/bindings/hwmon/adi,adm1275.yaml
@@ -37,6 +37,47 @@ properties:
description:
Shunt resistor value in micro-Ohm.

+ adi,volt-curr-sample-average:
+ description: |
+ Number of samples to be used to report voltage and current values.
+ If the configured value is not a power of 2, sample averaging number
+ will be configured with smaller and closest power of 2.
+
+ $ref: /schemas/types.yaml#/definitions/uint32
+ enum: [1, 2, 4, 8, 16, 32, 64, 128]
+ default: 1
+
+ adi,power-sample-average:
+ description: |
+ Number of samples to be used to report power values.
+ If the configured value is not a power of 2, sample averaging number
+ will be configured with smaller and closest power of 2.
+
+ $ref: /schemas/types.yaml#/definitions/uint32
+ enum: [1, 2, 4, 8, 16, 32, 64, 128]
+ default: 1
+
+ adi,power-sample-average-enable:
+ description: Enable sample averaging for power reading.
+ type: boolean
+
+dependencies:
+ adi,power-sample-average-enable: ['adi,power-sample-average']
+ adi,power-sample-average: ['adi,power-sample-average-enable']
+
+allOf:
+ - if:
+ properties:
+ compatible:
+ contains:
+ enum:
+ - adi,adm1075
+ - adi,adm1275
+ - adi,adm1276
+ then:
+ properties:
+ adi,power-sample-average-enable: false
+
required:
- compatible
- reg
@@ -53,5 +94,8 @@ examples:
compatible = "adi,adm1272";
reg = <0x10>;
shunt-resistor-micro-ohms = <500>;
+ adi,volt-curr-sample-average = <128>;
+ adi,power-sample-average = <128>;
+ adi,power-sample-average-enable;
};
};
--
2.17.1