Received-SPF: pass (google.com: domain of linux-kernel+bounces-143978-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
From: Chanh Nguyen <chanh@os.amperecomputing.com>
To: Jean Delvare <jdelvare@suse.com>,
	Guenter Roeck <linux@roeck-us.net>,
	Rob Herring <robh+dt@kernel.org>,
	Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Justin Ledford <justinledford@google.com>,
	devicetree@vger.kernel.org,
	linux-hwmon@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	OpenBMC Maillist <openbmc@lists.ozlabs.org>,
	Open Source Submission <patches@amperecomputing.com>
Cc: Phong Vo <phong@os.amperecomputing.com>,
	Thang Nguyen <thang@os.amperecomputing.com>,
	Quan Nguyen <quan@os.amperecomputing.com>,
	Chanh Nguyen <chanh@os.amperecomputing.com>
Subject: [PATCH v2 3/3] dt-bindings: hwmon: max31790: Add maxim,pwmout-pin-as-tach-input property
Date: Sun, 14 Apr 2024 11:22:46 +0700
Message-Id: <20240414042246.8681-4-chanh@os.amperecomputing.com>
In-Reply-To: <20240414042246.8681-1-chanh@os.amperecomputing.com>
References: <20240414042246.8681-1-chanh@os.amperecomputing.com>
Content-Type: text/plain
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?1c74AE2iZ4DTFXSyX+oguEPp/qUfPBmxfWqyYtN+Tp/O4zvz2ThE/Eex9TfK?=
 =?us-ascii?Q?bjhU1R2TTxH98VKnygjsexZGtEcuudfBGHS0ZG/xDaC5nqda/GKZxPwChLyj?=
 =?us-ascii?Q?2WFApWL3aPq+LHOfxcubiTlbeRtW1iic3qbCWlYP28keZH6PUrqcM8UWU1aA?=
 =?us-ascii?Q?HuKAyLCvOgVBu6U/vbZzk3n/cBmKMjLBwG81hxHAg75tBsM/Ckqz8yMEJ6J5?=
 =?us-ascii?Q?+lG952hUPFnIYRPAK2AMjQ7IRznNTRyfzt6nt5e3EILsqqTimOldZ/UJdqBR?=
 =?us-ascii?Q?gngGm2MqZxB4cWwbCsR3FoevFk5K1r8jAMKpMSWTNte0krihMgAqHv7CVDn0?=
 =?us-ascii?Q?omPFBOHj0pfxWSzXZ+lqPu2GKqTWWFnW3E/i0vhLxlK496+rkMUVpV8XrlH5?=
 =?us-ascii?Q?FnDBtohwVIp7njPpdJlLhfjSbVGzEFvxiqt8R0auHjHorIEIUvquxSSE3/NB?=
 =?us-ascii?Q?x7siE3dS+jqdBSfmTAQjeZ1MJWoXELLET6r1eBmrBJFpY/HIgmCPFmmjJDRq?=
 =?us-ascii?Q?TggzaFiQWrq2Y/OXSBI42Jg+oB5X2UOY8xKXyz4qM9sP1MIEvk59sIwidaQB?=
 =?us-ascii?Q?duvm5P7EIRQh4J/T5yzLCuNP2dhKXEN6U7tadFkjHQpsB3xS0VBev5/QkWF2?=
 =?us-ascii?Q?hJoOqPtE17VT942yy2475AXon/vyczSopkweHro4FjCQ+tHBS9pEmhdLWLVF?=
 =?us-ascii?Q?cF29qIPE1O30hHDXOqgS3VseSjEhTbanMH6fhJKk21HKg4TnXrQ13Yfe1Yo8?=
 =?us-ascii?Q?85E9/7/uExSZajDMt70AjvpLHTok+HL44+7GF95vNKculGyp2got6qY87v/9?=
 =?us-ascii?Q?XIW6kPH0x6p9aIYlfr399NJLZWg+Z5HuoQZ72xRg+KB8HWryXRKliaGoJ1TO?=
 =?us-ascii?Q?FeqGs+OB4JYVPOS0sUG/Ey6bvK5nXhimKVcHT4h//dwPKJcp4qPSvTDCMcuZ?=
 =?us-ascii?Q?ENEquA/XvVuVSRPQ2WwqqWwYRKTqB538CrbuPc6UX5AUGqWA80jaYoHwIDdG?=
 =?us-ascii?Q?NXoGATgbN+luw2xNjNs3faeRAtWseORSvCJLsyC66tgHPPr64BB4s6yVUiO4?=
 =?us-ascii?Q?iFDyxp/dSM0ldswiVCknP+tn5BEOgWpajyFE0dVTICoKc7dWKSA92g+SCHy5?=
 =?us-ascii?Q?IgAECmFxcAT3MOG7CXjzpuLv1+NiIds7F0FfGzDzZvQDg7u1ZqMjJPKSiyja?=
 =?us-ascii?Q?Kz9UB4C8fNu5Ambg0AdcjqcVve8hPhFnrnOZP6ek8iuPKABKWr8QJIa9vnzC?=
 =?us-ascii?Q?EdKziCMeuqglE0GL+ByNcZtBzTsABFMSEJ3lmdumrU6fhZQJjCW7zIokPqk+?=
 =?us-ascii?Q?7N5Tve/lVxcqZRRJ1jGkMPimlm5LbpqGOR837jCLVF3rHHszlFsaV4Pz8MY5?=
 =?us-ascii?Q?1ptVYfbMgJEuAILqbNhP0ivGg2p5/PjiL50jNOgHg13SC0MlfQQ75OzfuVeA?=
 =?us-ascii?Q?w11d0aSueemcPG3mYBLmCLotOtH6ZX1RihQfQ08hUdlQcz1PD21ogDuZH78h?=
 =?us-ascii?Q?bE+gQxe4tPfKx+3csNrnWGFh91Iz65wlh662D1PT3jLfca25qSrf+eYyqPPd?=
 =?us-ascii?Q?YmUxaxIjnpGd9IbaM586VXAQBEqlz8f/3rZXHYDjo4aHHeiM0xSPbxhXW4zE?=
 =?us-ascii?Q?oMWzWcChGNB7ww8zqWLv0TY=3D?=
X-OriginatorOrg: os.amperecomputing.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 63ffb86e-5ae2-41f2-bb49-08dc5c3aa75e
X-MS-Exchange-CrossTenant-AuthSource: DM6PR01MB5947.prod.exchangelabs.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Apr 2024 04:23:36.9445
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 3bc2b170-fd94-476d-b0ce-4229bdc904a7
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: kZKlJutpeUddnd9bPywT3KumJ5yMce60rOl96RUfOQVLrYkL4ievYMT5f/7bU/B1dFDvxKJF2qN8AeG1VZd1LY4o9vSPY6zoUuxjceRVoruL5CGpbv4HyjaRc1PCuFo6
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR01MB6715

The max31790 supports six pins, which are dedicated PWM outputs. Any of the
six PWM outputs can also be configured to serve as tachometer inputs,
allowing for up to 12 tachometer fans to be monitored.

Add a new vendor-specific property, 'maxim,pwmout-pin-as-tach-input',
to allow PWMOUT to become a TACH input.

An array of six integers responds to six PWM channels for configuring
the PWM to TACH mode. When set to 0, the associated PWMOUT produces
a PWM waveform for control of fan speed. When set to 1, PWMOUT becomes
a TACH input.

Signed-off-by: Chanh Nguyen <chanh@os.amperecomputing.com>
---
Changes in v2:
 - Update the vendor property name to "maxim,pwmout-pin-as-tach-input"   [Rob]
 - Update commit message                                                 [Krzysztof]
---
 .../devicetree/bindings/hwmon/maxim,max31790.yaml     | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Documentation/devicetree/bindings/hwmon/maxim,max31790.yaml b/Documentation/devicetree/bindings/hwmon/maxim,max31790.yaml
index a561e5a3e9e4..2d4f50bc7c41 100644
--- a/Documentation/devicetree/bindings/hwmon/maxim,max31790.yaml
+++ b/Documentation/devicetree/bindings/hwmon/maxim,max31790.yaml
@@ -30,6 +30,16 @@ properties:
   resets:
     maxItems: 1
 
+  maxim,pwmout-pin-as-tach-input:
+    description: |
+      An array of six integers responds to six PWM channels for
+      configuring the pwm to tach mode.
+      When set to 0, the associated PWMOUT produces a PWM waveform for
+      control of fan speed. When set to 1, PWMOUT becomes a TACH input
+    $ref: /schemas/types.yaml#/definitions/uint8-array
+    maxItems: 6
+    minItems: 6
+
 required:
   - compatible
   - reg
@@ -48,5 +58,6 @@ examples:
       fan-controller@20 {
         compatible = "maxim,max31790";
         reg = <0x20>;
+        maxim,pwmout-pin-as-tach-input = /bits/ 8 <0 0 0 0 1 1>;
       };
     };
-- 
2.17.1