From patchwork Thu Jun 23 16:52:16 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Shych X-Patchwork-Id: 584318 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id E38A5CCA47C for ; Thu, 23 Jun 2022 16:52:49 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232197AbiFWQwr (ORCPT ); Thu, 23 Jun 2022 12:52:47 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57192 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231981AbiFWQwg (ORCPT ); Thu, 23 Jun 2022 12:52:36 -0400 Received: from NAM02-SN1-obe.outbound.protection.outlook.com (mail-sn1anam02on2071.outbound.protection.outlook.com [40.107.96.71]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AFDD52BE3; Thu, 23 Jun 2022 09:52:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=bUjncUAMflZeq+o5jOy6krCaKsk+0am9hTAGBGTEVZEAbj7YONIjCDMhk5Dp/UWjZFDn3VoE3G2TJyBAG18jL2OhccM4NGfxzoo51VGVhk7V3nREWzkH1ba/g8a6wDxqyIJUhsmqPgNuEgeLRBxdVmFjpUrJpR6u0ZlzNFvqVuF2w0paVOJdq7KjzPYmkN6pUOUbP6Fc0wNXPjA2cQcUbAGkCvud8ZNAKX9TqvOsb8GvAIAU83Jx2qPFXi0polm6BBcC9/Q6KJVqPKS524qegyK685gYqxTNGYSOC/ilUMJYKvcolPMPsoCiy27O2mAntbw53crMQwKxz7ZIjWfWNA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NWFp8Y8E137ojxGaPPH6m0beGhyonHW+pi5ZQxTnn/Y=; b=NEwz2EUi674Ku4ZtaoQHTWi6ikMaU1hnZCKEQZAWt7SvSDiJAK6tgkviEZvaQhhZsK5TsA4iLD3qPY1Bl0FHlDdhvslrqhpE1GfIVGqx0wLIEXhdicESZsGMFqtQ/jvb3EfsYzFgG2T/4/KVZk9eP8L28ZUSyq3KBRRWSzxyf3+bA1JSHAOyR9wvQ6f5OqVVJp4CnbBJ/4beL0PBPkUROHzoTPXSx3iPJrkV06cli1vBivjJmLqJDWS+8/XR/vOZuoBFojvIZ44hjpHPOshG/Ejir/ssFQ0iFZjBi/2TaujRtu0WrHF9Yn0fLFbgJ1jWB2qfnV/fqiAo3P2knEplTg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.236) smtp.rcpttodomain=vger.kernel.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NWFp8Y8E137ojxGaPPH6m0beGhyonHW+pi5ZQxTnn/Y=; b=GAzd5E+ZUDjyCqNOV9dCJ9MAtVmXJmrpD3FJOm07THY3ih3CRSTUthtQZsxJHvu+pKNRUkN+wriB3dS2V/Z9GQYkAyOFy3SJaXMOmRs2EJhOo5ztGMHK+CzfTufmZCq6MyVg1X+Z42w+k9QO3KQc5UdPEomLq/poDhS4EFxBeaLs4xx0rtB9PbxxXR8jsZSe78TalrPvmyTMUtD33zZgZHZT6Fd8KbkEfq7xmvf+qUxc1mJInzN1GEC76AL/AuwnQHmwuxqigcyJu4mMga57+Z2aAQ4HwUFcedL8lj3MHXwA8XP0l0tUPQJ5/CDbsr5SH3Bk2KqzADwjSu+tCPNVnQ== Received: from MWHPR19CA0052.namprd19.prod.outlook.com (2603:10b6:300:94::14) by MW2PR12MB4668.namprd12.prod.outlook.com (2603:10b6:302:e::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5353.15; Thu, 23 Jun 2022 16:52:29 +0000 Received: from CO1NAM11FT021.eop-nam11.prod.protection.outlook.com (2603:10b6:300:94:cafe::c4) by MWHPR19CA0052.outlook.office365.com (2603:10b6:300:94::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5373.15 via Frontend Transport; Thu, 23 Jun 2022 16:52:29 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.236) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.236 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.236; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (12.22.5.236) by CO1NAM11FT021.mail.protection.outlook.com (10.13.175.51) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5373.15 via Frontend Transport; Thu, 23 Jun 2022 16:52:28 +0000 Received: from drhqmail201.nvidia.com (10.126.190.180) by DRHQMAIL109.nvidia.com (10.27.9.19) with Microsoft SMTP Server (TLS) id 15.0.1497.32; Thu, 23 Jun 2022 16:52:28 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by drhqmail201.nvidia.com (10.126.190.180) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.26; Thu, 23 Jun 2022 09:52:27 -0700 Received: from r-build-bsp-02.mtr.labs.mlnx (10.127.8.9) by mail.nvidia.com (10.126.190.181) with Microsoft SMTP Server id 15.2.986.26 via Frontend Transport; Thu, 23 Jun 2022 09:52:26 -0700 From: To: , CC: , , , Michael Shych Subject: [PATCH hwmon-next v4 2/3] dt-bindings: hwmon: add Microchip EMC2305 fan controller. Date: Thu, 23 Jun 2022 19:52:16 +0300 Message-ID: <20220623165217.59252-3-michaelsh@nvidia.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20220623165217.59252-1-michaelsh@nvidia.com> References: <20220623165217.59252-1-michaelsh@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 2204efc1-bc24-4c71-235e-08da5538c207 X-MS-TrafficTypeDiagnostic: MW2PR12MB4668:EE_ X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: kAD1E5jIm3wb6ticpxVQLB79nG+n6zjorz29RpnrNImUQ97Y4e76vDpMTROTMmZS3ZszujgxSKgAyv8Q+RJGQ1bs7MiUL94OnugUE2c8q5rHm8SKTWG66Zz/1i1IdnZnJaKDLEedV2uART53HIaZ6tZIEvS/3jhxL3+oLUsu2n+U1A+zVAJjzP9l+xz3vQMorI3brJnfl9Ye5KbL3SKFU153/XmZTskCOR7RdeYS04Xdmfx/tYVH6ikJSnl64dDS/rp/5JFGv6wQq0XkhRdSKrVmVR5jB5c3pgxxzSRXqGlpHO/Vz40W0xCXaVUTHZFjf2iBZoJCLlQc8kgR4phVUmxHOk5SFMPzPIL90Bepz3yrcUDgZORbQTqNUH04nd/Ow6R99htBLO8I6Uinnfhxxvh19UBz8uHAGpyQ+wf1EBUuYR0HSZwD8T4t3dDOyCLvTBwFP9fbKQbpa2Oodu92HDvLGg+sEHkmUxMQnQ/Cz5cW1CQBaLedWGyL8BUW2/mCyNztQ1Au13ID3POX5fXFLasItYLM3OFbGBd/p0zGq/8SvcIpK3TCjJFP7WbGpXBdrmh5NFj2oqhkgpkLJbaIjVErRVAJ/nsxWY060AAqBAPTGqbfEBDup5M07gZmlDC9uEYzYyGq3QIUDf5wAJd/EkdaCeC0fFFC5xjQbTkKENYIG7agPweBDn5T46eHCgdMjAUrsjDzyRhxzvVJrjRlW6+610TPaKiEo0J0P9j/DzFNGxWP8cSXkxTCqLZjVsEmRrkNcSCao4agB6SZOYMftxkU760w46kqL8gR+jmG0tI2OplTSFL5h0mXQ5tPqa8M182klp4fgKsoliKCz3+2bNoySjARW4ePxpNML6/m7Cf9mlWp5Y6huyBzEcq0y3JulsXZZFCmCoXo6wq7jnuPdCI2LW4IjVfJIJ2cvSup487kq0l9V+vQBwwkj1+BCkOUGL9wktYX4ot+6dJ5Nu9FjA== X-Forefront-Antispam-Report: CIP:12.22.5.236; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE; SFS:(13230016)(4636009)(346002)(376002)(136003)(39860400002)(396003)(36840700001)(46966006)(40470700004)(86362001)(26005)(966005)(2906002)(478600001)(2876002)(6666004)(83380400001)(40460700003)(41300700001)(36860700001)(2616005)(47076005)(81166007)(426003)(82310400005)(336012)(186003)(8676002)(316002)(110136005)(356005)(8936002)(36756003)(4326008)(1076003)(40480700001)(82740400003)(107886003)(5660300002)(54906003)(70586007)(70206006)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Jun 2022 16:52:28.7030 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 2204efc1-bc24-4c71-235e-08da5538c207 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.236]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT021.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW2PR12MB4668 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Michael Shych Add basic description of emc2305 driver device tree binding. Signed-off-by: Michael Shych Reviewed-by: Vadim Pasternak --- v2->v3 Changes pointed out by Rob Herring and Guenter Roeck: - Describe separate channels of fan-controller; - Remove pwm_max property; - Fix compatible property. Changes added by Michael Shych: - Fix dt binding check warnings. v1->v2 - Fix dt binding check errors; - Add descriptions; - Add missing fields; - Change the patch subject name; - Separate pwm-min, pwm-max per PWM channel. --- .../bindings/hwmon/microchip,emc2305.yaml | 106 +++++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml diff --git a/Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml b/Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml new file mode 100644 index 000000000000..d054ba46ae23 --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml @@ -0,0 +1,106 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- + +$id: http://devicetree.org/schemas/hwmon/microchip,emc2305.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Microchip EMC2305 RPM-based PWM Fan Speed Controller + +maintainers: + - Michael Shych + +description: | + Microchip EMC2301/2/3/5 are RPM-based PWM Fan Controller. + The Fan Controller supports up to 5 independently controlled PWM fan drives. + Fan rotation speeds are reported in RPM. + + Datasheet: https://www.microchip.com/en-us/product/EMC2305 + +additionalProperties: false + +properties: + compatible: + enum: + - microchip,emc2305 + - microchip,emc2303 + - microchip,emc2302 + - microchip,emc2301 + + reg: + maxItems: 1 + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + + microchip,cooling-levels: + description: + Quantity of cooling level state. + $ref: /schemas/types.yaml#/definitions/uint8 + minimum: 0 + maximum: 255 + + microchip,pwm-separate: + description: + This flag indicates that separate PWM setting will be used + for different channels. + $ref: /schemas/types.yaml#/definitions/flag + +patternProperties: + "^channel@[0-4]$": + type: object + + additionalProperties: false + + properties: + reg: + items: + - enum: + - 0 + - 1 + - 2 + - 3 + - 4 + + pwm-min: + description: + Min pwm of emc2305 channel + $ref: /schemas/types.yaml#/definitions/uint8 + minimum: 0 + maximum: 255 + + required: + - reg + +required: + - compatible + + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + fan-controller@4d { + compatible = "microchip,emc2305"; + reg = <0x4d>; + #address-cells = <1>; + #size-cells = <0>; + microchip,pwm-separate; + microchip,cooling-levels = /bits/ 8 <10>; + + channel@0 { + reg = <0>; + pwm-min = /bits/ 8 <0>; + }; + channel@1 { + reg = <1>; + pwm-min = /bits/ 8 <0>; + }; + }; + }; + From patchwork Thu Jun 23 16:52:17 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Shych X-Patchwork-Id: 584317 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 36210C43334 for ; Thu, 23 Jun 2022 16:53:27 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232785AbiFWQxV (ORCPT ); Thu, 23 Jun 2022 12:53:21 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57186 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232049AbiFWQwh (ORCPT ); Thu, 23 Jun 2022 12:52:37 -0400 Received: from NAM04-MW2-obe.outbound.protection.outlook.com (mail-mw2nam04on2066.outbound.protection.outlook.com [40.107.101.66]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id F01AE5FDD; Thu, 23 Jun 2022 09:52:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GWXnp8Dwwybp2GrEPI4bF98fJOdpiIAeyz1/3+el1lytomTsA++DhMxe1RMU37417+FgbkW5T8STAmzDbiMvXK9nmFb45IUmHRO52QkkAeE+mbyZ4YJgqa3yyVnkAyffPbm4lLbXyHyYp5FtKZTI9qq3Jz3/qF2VzX0oWi+aHRAYDeAHQB2IsbLtfMzU3IciZxAx/gQIC5MnMgK1XTDCu6UmbaOUaj/sfdOhKSr/b/ExI0szg9qErSkc7EM/oDNwTXtMrwdPYIPICUsPXlOuzkWq9HHR5Tqxx/oqon+2nDuHThn8eKxqIgZhrIgD8qAxqz0p5FEOQm3iuhQa4p4a4Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=ZkXvzgpj9E7kz/YhpR0nhPtHcC4y60tSoMNu3L4uW00=; b=hMpDPEWvZPM1ip7UuLnh7rJLjPBLm5wmtw0hBOaQp01zamLIv6gLKDmg7aazcRNUfFKk8H0El9V4xfj0nqteMFfinWOdU/KDtQuqK0fhO864NUUDowKWjr7OBKUTWzoewcHew+rgjKdmZi/GElRrpd3BZ8zR5aVg3kiz8Qmq4JPRCKOeJXaASYa4mHsY90xYguo2mM8W/gqAH3syJ1MMyU8puRTWyEFzAM8yALxNbRrA9eOje29qA9bnhuqEr/kzvI2dVoYFFCZNnLnxWU79DYsSjreG67W3XsiZ7WW8BU7ItCdoXiG6OaRnknt/d10rR5PiFCNY53M/gAqdlaFjjQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.236) smtp.rcpttodomain=vger.kernel.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=ZkXvzgpj9E7kz/YhpR0nhPtHcC4y60tSoMNu3L4uW00=; b=J5ZL5Omf/DuqrWR57d3WMIIOraG9xeci0fEoCT3j+a2JRyeTX4UapPDRigA9VUEBJQQJjx4lGadXu0FyApsaDR/B+HMXQNGMZFh4eP0uJaKAUN96hCm9t9uNPVDwRqb/cxn9g2hLdQiGCtmcrJooezQKEJHwH60BV3gm7XOf286f1gpgC+P1J7M7nbiSomYSno9G99hBSNIAcXVeazkAM6uKHlaXt97GjbMIsSzWsQYNK/dx5U8StSVFzBXMQIInV/x3/RZvIUtM/WeIits6IVZJKFx3bciqg8LP9HgkrlcN/TMUM/V4sGLrX9fTQY1+9t5qWJcrrCTnfpzt3mkgxw== Received: from MWHPR12CA0048.namprd12.prod.outlook.com (2603:10b6:301:2::34) by MN2PR12MB3741.namprd12.prod.outlook.com (2603:10b6:208:162::30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5373.16; Thu, 23 Jun 2022 16:52:31 +0000 Received: from CO1NAM11FT013.eop-nam11.prod.protection.outlook.com (2603:10b6:301:2:cafe::b2) by MWHPR12CA0048.outlook.office365.com (2603:10b6:301:2::34) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5373.15 via Frontend Transport; Thu, 23 Jun 2022 16:52:31 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.236) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.236 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.236; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (12.22.5.236) by CO1NAM11FT013.mail.protection.outlook.com (10.13.174.227) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5373.15 via Frontend Transport; Thu, 23 Jun 2022 16:52:30 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by DRHQMAIL109.nvidia.com (10.27.9.19) with Microsoft SMTP Server (TLS) id 15.0.1497.32; Thu, 23 Jun 2022 16:52:30 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by drhqmail202.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.26; Thu, 23 Jun 2022 09:52:29 -0700 Received: from r-build-bsp-02.mtr.labs.mlnx (10.127.8.9) by mail.nvidia.com (10.126.190.181) with Microsoft SMTP Server id 15.2.986.26 via Frontend Transport; Thu, 23 Jun 2022 09:52:28 -0700 From: To: , CC: , , , Michael Shych Subject: [PATCH hwmon-next v4 3/3] docs: hwmon: add emc2305.rst to docs Date: Thu, 23 Jun 2022 19:52:17 +0300 Message-ID: <20220623165217.59252-4-michaelsh@nvidia.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20220623165217.59252-1-michaelsh@nvidia.com> References: <20220623165217.59252-1-michaelsh@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: e462d1a1-ee16-49d8-96a6-08da5538c355 X-MS-TrafficTypeDiagnostic: MN2PR12MB3741:EE_ X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 90+9hsVLHzQ0D00AFRiFKQn1EGslgJPt7JFdGM81Ud9tEelysY06Do+9cqvxEoYXuB20kWJEkSU+oNC0D/5soA0G3HGldlsK3l6B7bfcn/+OMTfcb8UJ/Ow4QRbOfH41hLn9WZO7HTM6cxbnN558srNKGaCDg75+xBCYcpi63shix0eiqvCfLGOnfDZ1E+toob+pu8bTsLkMdZIHym9EukpmsfykIcsKRfCRAFtvvTWora32NlXD3ywlqZVrPSxOT84KjBuT0LG2OMaBBY9fhzc9SXaQ2j4uIQz6f47RjGuNSruPMHwDpshudM5QJx0IxuhUQg5kfIRnf5ybkdXh9WhF8Pdrrm3QpJiewCy28KepTdpnsAYLJGWGD/k5lhUMUSk9rHlOOd3XRd9zT2h0/2ErSOiKFuqaD7IhYG1Z6h/OWeu9oeefPRZhYW9j/K4uzuH8xGqd6rIsQnNbXiQVcxBFZbB5YzsaSybMoh3chjXSuCd/XNPOFE0GeVkQlfyIcsCmDCfYZCq8sOgODePJoi9r7dD6zwXmOUdUUtsLIn6gUlKc4TS1jOPrMy1jypgD5So2YVxs5YwVdDdaF10beOIXTHTdNJx0iVcbKnVZXkm32Y9ew2NiUFpWf2tL+dHW1yCtMN2fuZuvT1N39WMhdqUqfoplORKj+S+10rB3cN/y9TvKpnPDBuiGJi7mq+SNxhF+y2zAIDMbsBIhw3SN1IIkEzMRMCk9HldBFDZhSwO9BPx5RgmHO6YGWwE2EeJNGLYqgD8hVpmilF6Dv7D6moMBjWRG9MjQEiFwpf+6BiJUr3t7t0tyhEOq7TpGbZSVWO0sKRqc4n5eue/h4fqvjQIyc/7fwCp9UfcyZTpq6wIDwccZcd17KN4NG+A3HZbJapEBxnd0UWz5Kf2/t3xC5l5aIBODmIOyfdkRTLmN/YE= X-Forefront-Antispam-Report: CIP:12.22.5.236; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE; SFS:(13230016)(4636009)(396003)(376002)(346002)(136003)(39860400002)(40470700004)(46966006)(36840700001)(186003)(6666004)(8936002)(36860700001)(356005)(478600001)(70206006)(54906003)(8676002)(4326008)(41300700001)(966005)(36756003)(2876002)(82310400005)(81166007)(110136005)(70586007)(82740400003)(26005)(40480700001)(5660300002)(426003)(47076005)(40460700003)(336012)(2616005)(86362001)(107886003)(2906002)(316002)(1076003)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Jun 2022 16:52:30.8792 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e462d1a1-ee16-49d8-96a6-08da5538c355 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.236]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT013.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR12MB3741 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Michael Shych Add description of emc2305 driver. Signed-off-by: Michael Shych Reviewed-by: Vadim Pasternak --- v1->v2 - Add document to index.rst --- Documentation/hwmon/emc2305.rst | 40 ++++++++++++++++++++++++++++++++++++++++ Documentation/hwmon/index.rst | 1 + 2 files changed, 41 insertions(+) create mode 100644 Documentation/hwmon/emc2305.rst diff --git a/Documentation/hwmon/emc2305.rst b/Documentation/hwmon/emc2305.rst new file mode 100644 index 000000000000..258da49d18f9 --- /dev/null +++ b/Documentation/hwmon/emc2305.rst @@ -0,0 +1,40 @@ +.. SPDX-License-Identifier: GPL-2.0 + +Kernel driver emc2305 +===================== + +Supported chips: + Microchip EMC2305, EMC2303, EMC2302, EMC2301 + + Addresses scanned: I2C 0x27, 0x2c, 0x2d, 0x2e, 0x2f, 0x4c, 0x4d + Prefixes: 'emc2305' + + Datasheet: Publicly available at the Microchip website : + https://www.microchip.com/en-us/product/EMC2305 + +Description: +----------- +This driver implements support for Microchip EMC2301/2/3/5 RPM-based PWM Fan Controller. +The EMC2305 Fan Controller supports up to 5 independently controlled PWM fan drives. +Fan rotation speeds are reported in RPM. +The driver supports the RPM-based PWM control to keep a fan at the desired speed. +The driver provides the possibility to have one common PWM interface for all FANs +or up to the maximum available or configured independent PWMs. + +The driver provides the following sysfs interfaces in hwmon subsystem: + +================= == =================================================== +fan[1-5]_fault RO files for tachometers TACH1-TACH5 fault indication +fan[1-5]_input RO files for tachometers TACH1-TACH5 input (in RPM) +pwm[1-5] RW file for fan[1-5] target duty cycle (0..255) +================= == =================================================== + +sysfs interfaces in thermal subsystem: + +================= == ======================================================================== +cur_state RW file for the current cooling state of the cooling device (0..max_state) +max_state RO file for the maximum cooling state of the cooling device +================= == ======================================================================== + +Configuration is possible via device tree: +Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst index f7113b0f8b2a..83b082d222af 100644 --- a/Documentation/hwmon/index.rst +++ b/Documentation/hwmon/index.rst @@ -63,6 +63,7 @@ Hardware Monitoring Kernel Drivers ds620 emc1403 emc2103 + emc2305 emc6w201 f71805f f71882fg