[PATCH linux dev-6.1 v2 2/2] dt-bindings: hwmon: add MAX31790 and INA233 binding documents

Delphine CC Chiu Delphine_CC_Chiu at wiwynn.com
Mon Sep 11 11:44:36 AEST 2023


Add MAX31790 and INA233 binding documents for Yosemite V4 config.
The drivers' code change will be soonly contributed.

Signed-off-by: Delphine CC Chiu <Delphine_CC_Chiu at wiwynn.com>
Changelog:
 v2 - Add binding documents for ina233 and max31790
---
 .../devicetree/bindings/hwmon/ina233.txt      | 27 +++++++++++++++++++
 .../devicetree/bindings/hwmon/max31790.txt    | 25 +++++++++++++++++
 MAINTAINERS                                   | 12 +++++++++
 3 files changed, 64 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/hwmon/ina233.txt
 create mode 100644 Documentation/devicetree/bindings/hwmon/max31790.txt

diff --git a/Documentation/devicetree/bindings/hwmon/ina233.txt b/Documentation/devicetree/bindings/hwmon/ina233.txt
new file mode 100644
index 000000000000..a1067788ec0c
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwmon/ina233.txt
@@ -0,0 +1,27 @@
+Bindings for the Maxim MAX31790 Intelligent Fan Controller
+==========================================================
+
+Reference:
+
+https://pdf1.alldatasheet.com/datasheet-pdf/view/930928/TI1/INA233.html
+
+The INA233 device is a current, voltage and power monitor with an I2C-, SMBus-,and PMBus-compatible interface
+that is compliant with digital bus voltages from 1.8 V to 5.0 V.
+The device monitors and reports values for current, voltage and power.
+The integrated power accumulator can be used for energy or average power calculations.
+Programmable calibration value, conversion times and averaging when combined with an internal multiplier
+enable direct readouts of current in amperes and power in watts.
+
+Required properties:
+- compatible     	: ti,ina233
+- reg            	: I2C address
+- resistor-calibration  : MFR_CALIBRATION which will be set into register 0xd4
+- current-lsb    	: Current_LSB for calibration
+Example:
+
+        ina233 at 45 {
+                compatible = "ti,ina233";
+                reg = <0x45>;
+                resistor-calibration = /bits/ 16 <0x0a00>;
+                current-lsb= /bits/ 16 <0x0001>;
+        };
diff --git a/Documentation/devicetree/bindings/hwmon/max31790.txt b/Documentation/devicetree/bindings/hwmon/max31790.txt
new file mode 100644
index 000000000000..e00060ddfe15
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwmon/max31790.txt
@@ -0,0 +1,25 @@
+Bindings for the Maxim MAX31790 Intelligent Fan Controller
+==========================================================
+
+Reference:
+
+https://datasheets.maximintegrated.com/en/ds/MAX31790.pdf
+
+The MAX31790 controls the speeds of up to six fans
+using six independent PWM outputs. The desired fan
+speeds (or PWM duty cycles) are written through the I2C
+interface. The outputs drive “4-wire” fans directly, or can
+be used to modulate the fan’s power terminals using an
+external pass transistor
+
+Required properties:
+- compatible     : maxim,max31790
+- reg            : I2C address
+- pwm-as-tach    : config PWM outputs as tachometer inputs
+Example:
+
+        fans at 52 {
+                compatible = "maxim,max31790";
+		reg = <0x20>;
+                pwm-as-tach = /bits/ 8 <4 5>;
+        };
diff --git a/MAINTAINERS b/MAINTAINERS
index ccf8d060cd22..6baad9c10669 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1362,6 +1362,12 @@ F:	Documentation/devicetree/bindings/hwmon/adi,max31760.yaml
 F:	Documentation/hwmon/max31760.rst
 F:	drivers/hwmon/max31760.c
 
+ANALOG DEVICES INC MAX31790 DRIVER
+M:	Delphine CC Chiu  <Delphine_CC_Chiu at wiwynn.com>
+S:	Odd Fixes
+F:	Documentation/devicetree/bindings/hwmon/max31790.txt
+F:	drivers/hwmon/max31790.c
+
 ANALOGBITS PLL LIBRARIES
 M:	Paul Walmsley <paul.walmsley at sifive.com>
 S:	Supported
@@ -10034,6 +10040,12 @@ F:	Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml
 F:	Documentation/hwmon/ina209.rst
 F:	drivers/hwmon/ina209.c
 
+INA233 HARDWARE MONITOR DRIVER
+M:	Delphine CC Chiu  <Delphine_CC_Chiu at wiwynn.com>
+S:	Odd Fixes
+F:	Documentation/devicetree/bindings/hwmon/ina233.txt
+F:	drivers/hwmon/ina222.c
+
 INA2XX HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux at roeck-us.net>
 L:	linux-hwmon at vger.kernel.org
-- 
2.25.1



More information about the openbmc mailing list