From patchwork Thu Apr 22 09:08:41 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Quan Nguyen X-Patchwork-Id: 425946 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-18.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_CR_TRAILER, INCLUDES_PATCH, MAILING_LIST_MULTI, MSGID_FROM_MTA_HEADER, SPF_HELO_NONE, SPF_PASS, USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id C28BBC43462 for ; Thu, 22 Apr 2021 09:09:21 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 93B136145A for ; Thu, 22 Apr 2021 09:09:21 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235601AbhDVJJv (ORCPT ); Thu, 22 Apr 2021 05:09:51 -0400 Received: from mail-bn8nam11on2128.outbound.protection.outlook.com ([40.107.236.128]:5558 "EHLO NAM11-BN8-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S235491AbhDVJJu (ORCPT ); Thu, 22 Apr 2021 05:09:50 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lDhSMjpKMl9de0zCVO5/m1a0MeKlkdwAV8W3PkTGhALGJBkELUeAt8h4WoW45WrYGEoJACI+94QG4lz7hGI3JpeKHc/y/Q2JRoULng+7IPWgoAZqLuiMZdrYowOYSKsVr6JS+2/xODGkqINNLTmtPvqHMtcHmYmySxs6SUCNOxXuUTecYKRNmrcwB8MQvG/MbAUhuffQs2tBLNVugV71/g2OboLtbuBnRixgd15wOAYuh+4mzIeFL5uO9JD4nh6i7vNkzXhm/6QJjIsYEdeYoeXA03dIrMOTtRl1rkMLlTdsaMRKOEIkU3VuIreRdRGawmtkajeX7U0njsJH7evM4w== 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-SenderADCheck; bh=ORDiNLCx24eLLZ2e/hdi11I+0SG2S7JQgFXHc+FNmS4=; b=Myvh2H6Yfnij08rcP6H36UbsNW+Bho2JRNWZIkDJTHw9u1q2Q9fvTc8jqKxN65VRbGakL1z81eNI2GLoXD/R9xdwhsgbDN/bVZkTkX7dQdGVle/AUqjGig1/ljTgshWLrZSnHL6zaZuc61h2C0RowmDM5T1VDtP8Kscz9+02tD9HYwXMwoEZNcPEVa7OZKOUpj/1iWf2QJAb3iP5GvtFSXRsyHrouc7dzQSww/cYTkFlXDxbjdCqW4YfZKYhPYcA9OjU3rD1k1riSkp3fGgFJsqyFFelxTojOMqYTd21HWMTtO4i1+TqVtMOdSg6BExRm8DoXnpS5Ba/4CzUwHaLZw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=os.amperecomputing.com; dmarc=pass action=none header.from=os.amperecomputing.com; dkim=pass header.d=os.amperecomputing.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=os.amperecomputing.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=ORDiNLCx24eLLZ2e/hdi11I+0SG2S7JQgFXHc+FNmS4=; b=q12zZJKK6KKoNkjW+aRq6yxHD8+wg7hDFO7zVEXKIxZXmaVxNo0Aa95SecPia6DDzO5B73rbF3F4+oTXAp1/C7R9UlzdZOlFtLjC3ywmHFTa90k/NqeHmvvbvn5xt/WbTtY/wzZcGiMD6Z9fpgb6663YI7q5CE5qxTF+XplgqCE= Authentication-Results: jms.id.au; dkim=none (message not signed) header.d=none;jms.id.au; dmarc=none action=none header.from=os.amperecomputing.com; Received: from MW2PR0102MB3482.prod.exchangelabs.com (2603:10b6:302:c::32) by MW4PR01MB6356.prod.exchangelabs.com (2603:10b6:303:66::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4042.16; Thu, 22 Apr 2021 09:09:14 +0000 Received: from MW2PR0102MB3482.prod.exchangelabs.com ([fe80::d840:7aa7:58d4:b503]) by MW2PR0102MB3482.prod.exchangelabs.com ([fe80::d840:7aa7:58d4:b503%5]) with mapi id 15.20.4042.024; Thu, 22 Apr 2021 09:09:14 +0000 From: Quan Nguyen To: Joel Stanley , Andrew Jeffery , Jean Delvare , Guenter Roeck , Rob Herring , Lee Jones , Jonathan Corbet , linux-hwmon@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-aspeed@lists.ozlabs.org, openbmc@lists.ozlabs.org Cc: Open Source Submission , Phong Vo , "Thang Q . Nguyen" Subject: [PATCH v4 2/4] mfd: simple-mfd-i2c: Adds Ampere's Altra SMpro support Date: Thu, 22 Apr 2021 16:08:41 +0700 Message-Id: <20210422090843.4614-3-quan@os.amperecomputing.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20210422090843.4614-1-quan@os.amperecomputing.com> References: <20210422090843.4614-1-quan@os.amperecomputing.com> X-Originating-IP: [118.69.219.201] X-ClientProxiedBy: HKAPR04CA0011.apcprd04.prod.outlook.com (2603:1096:203:d0::21) To MW2PR0102MB3482.prod.exchangelabs.com (2603:10b6:302:c::32) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from hcm-sw-17.amperecomputing.com (118.69.219.201) by HKAPR04CA0011.apcprd04.prod.outlook.com (2603:1096:203:d0::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4065.22 via Frontend Transport; Thu, 22 Apr 2021 09:09:10 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 3655f894-4e1f-4cd0-f0b0-08d9056e4c96 X-MS-TrafficTypeDiagnostic: MW4PR01MB6356: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 10tuTmfynHEYsMt/rOoriw2qM6rl2jhjyAd1zVDKQ7wmE+za8vCMQzOIi5eyOXpS52YzdsM8SISDFk3auuFp9l+piitGrEog+8SrjPXu1j8r+B8AnH+HiRaQ5FxeZYfuggPKJbkqy4lrPJveoZ/IT30A1ypOf/HjmpKASLFZ/FjPnWpsDWqpY308wid4LsmBC8RMagKO5VPz8RMusDODjSDBlJIhDZpTz9pH6Jut9IJVy0s1EcSxsJVVeLn5mY1kXri0nzZwBI4sORqHTZkbpHUdFvhftO+YFVp5o4g1CZeBtpysMwLbMrfzvZvvQLp6+AeLKnCBUtdsJlrQnsRmNR09F82gjne9/vmm8+LqmRoI+uveaS4QqSNQvH2IODP2kNLmRtjIsxzsng8eJmBPdISFv8OL8KT/z7FQzyKoYhUrgDfk00DYh6GwjFA4H61ki/JjN2PyMTM5xpxmPIG+vatO4a4y5l7E6wmzaIFsnsK9a4LxD+F5CIDp7l8UEh6Ty3jlszQi6eoCP81Ghrni8FVhAPqemu3vopLM5BzswtAPXjMpshjUlbVessJoonuEt2RgML5NP61/QHjbw03TE4drJ0qr6mSR4L1NZ4gPD84Apn9R34/Huxkb2rGfXd9r0kWUtd6JfMINt55FOYIr+BbkVHeXzIHK+pGRLnvfCVY= X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MW2PR0102MB3482.prod.exchangelabs.com; PTR:; CAT:NONE; SFS:(4636009)(396003)(136003)(39850400004)(376002)(366004)(346002)(110136005)(38100700002)(26005)(107886003)(5660300002)(86362001)(956004)(2906002)(6512007)(1076003)(6666004)(316002)(8676002)(186003)(83380400001)(66476007)(4326008)(16526019)(66556008)(52116002)(38350700002)(921005)(7416002)(2616005)(8936002)(478600001)(6486002)(66946007)(54906003)(6506007); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData: +5ueedYNwe5PVd0w8YlvmGIC6zyLtK0nr+ebE/G1zJb0kifHB7C1szmSKiwm610NlLAkBVekKj/sbGOCBdzsl8+a065w2yTA1bGSHLQfMFKP08imCnAPjHHYhhE7oMAAc3vOAWCdMKUHf0vf2mQpUz5JCxsz3CczdSu7NxECaPp1idA0yXzlUGfN664j+y5Nn6kECBCp+0O/kHkvqgVWOl/KCgnaXcnzFqWWXJMwKYyjkYT0hPIC3NCSLfix7Lf+3/srgpaSjYcrsPnTyAaHLF8b/Kz/QciXaQAUftnR+hd7pxyEqEvR4uIzx86lJs5WN3/lalO5PI2f34M/n3NsYY7+iMU+vuD5VaHFKDzEWb1Lmr30AjHi0pf5tQLc29Z054tdKtGpx2UHGpNv4/+bCpdK8Ajel6UHKL1oKGk1gNMNhotarCKpLHhFCiWHXeP1ykl1yUp0ZzdofWl9BkV2nC+HN7yCjgAcxX5pJvMFig+2sEqPu6S5gDovtSLKbRaK/GgE6+C5sSfQRbnWGYyhaULQSXi+bdgZg7hpqNXBRoU2dirMsFYJeinj8RZKIsU7mOftip+4kvEdBTnApOrcEOy8Fd1XzGK0Yqn8RxmktElSvD2nLv6K+UpoM52tut916AXkeuUyl9kV02A/deo3KWE9zjQRmuNPCv4cZ8V9QIiRzFz2ov+L3dPM3lehgXv0itXyRIVk7MJgbDqO1zJ/QUs507LDSWtKfEcIyukvZj8gHzDaV6m/PK8bvDk7l6m9OB6+ZziFif/KOU8xZNp2UBVaBro/NN3EOQ/ZkuB9NfNTbHRRxUsS3YIfu8w3pwojuS4nfJt0kLEiMMXL0pz8e60cvp2Dz5F00gJM83UkFe6VvGqIWTshA+0YDy6sYFqpYPbMjY1rjr/LubhzIaFDVZ95aamFJGBrywT8iyJL40zELAdkYvx7ILy/M3Erke9JhyNxyoN6OaVdgR1amhZYFsaWf6SKW7ShM5aTjm3uRKbzhKDaobNMkqDiUTYzCNy+iv4a1KtcXYRZWSIl8RC8Sn5gtejQoEhO74ClKPYZsPiLQt9LlzN9p7iyRdZINy0XQo8NdEiVi8+2/l0H3Dh9B/2rTTK+UMBW/LnZZOWhzPPhcVWrLmlPjPJvVMqscWn82ivsE7PfJIkS9LTkYpiDZbNvsja2Au1oOBbayIE6WRcBHcINJMPvpXV/xZQ5D5fdHjUOrFkLDGkbpq+d/Z62Vr4dNKE/eonCj1DCcqopE/dQ7aQjqMgk94boFeW6x4Jxv8oqT9eHrKveXFkz1B35WFL8UO6bksCR+XG4uzTcJbNYpmb5UuMA2h4E1DUgpMYB X-OriginatorOrg: os.amperecomputing.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3655f894-4e1f-4cd0-f0b0-08d9056e4c96 X-MS-Exchange-CrossTenant-AuthSource: MW2PR0102MB3482.prod.exchangelabs.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Apr 2021 09:09:14.2655 (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: ZTqErKle1wBD2DaAOMzDizLwdIpe9REkEvCplSquvh3GKx4POtMeVwNZ+jgKf87MGMRb3vPIldI7H1J62zWYpA0a/mmYLdRBB8y44Xoibvk= X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR01MB6356 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Adds simple register map MFD driver for SMpro co-processor found on the Mt.Jade hardware reference platform with Ampere's Altra processor family. Signed-off-by: Quan Nguyen Acked-for-MFD-by: Lee Jones --- Changes in v4: + Add "depends on I2C" to fix build issue found by kernel test robot [Guenter] Changes in v3: + None Changes in v2: + Used 'struct of_device_id's .data attribute [Lee Jones] drivers/mfd/Kconfig | 11 +++++++++++ drivers/mfd/simple-mfd-i2c.c | 6 ++++++ 2 files changed, 17 insertions(+) diff --git a/drivers/mfd/Kconfig b/drivers/mfd/Kconfig index d07e8cf93286..10713b0e260e 100644 --- a/drivers/mfd/Kconfig +++ b/drivers/mfd/Kconfig @@ -77,6 +77,17 @@ config MFD_AS3711 help Support for the AS3711 PMIC from AMS +config MFD_SMPRO + tristate "Ampere Computing MFD SMpro core driver" + depends on I2C + select MFD_SIMPLE_MFD_I2C + help + Say yes here to enable SMpro driver support for Ampere's Altra + processor family. + + Ampere's Altra SMpro exposes an I2C regmap interface that can + be accessed by child devices. + config MFD_AS3722 tristate "ams AS3722 Power Management IC" select MFD_CORE diff --git a/drivers/mfd/simple-mfd-i2c.c b/drivers/mfd/simple-mfd-i2c.c index 87f684cff9a1..9a44655f5592 100644 --- a/drivers/mfd/simple-mfd-i2c.c +++ b/drivers/mfd/simple-mfd-i2c.c @@ -21,6 +21,11 @@ static const struct regmap_config simple_regmap_config = { .val_bits = 8, }; +static const struct regmap_config simple_word_regmap_config = { + .reg_bits = 8, + .val_bits = 16, +}; + static int simple_mfd_i2c_probe(struct i2c_client *i2c) { const struct regmap_config *config; @@ -39,6 +44,7 @@ static int simple_mfd_i2c_probe(struct i2c_client *i2c) static const struct of_device_id simple_mfd_i2c_of_match[] = { { .compatible = "kontron,sl28cpld" }, + { .compatible = "ampere,smpro", .data = &simple_word_regmap_config }, {} }; MODULE_DEVICE_TABLE(of, simple_mfd_i2c_of_match); From patchwork Thu Apr 22 09:08:43 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Quan Nguyen X-Patchwork-Id: 425945 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-18.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_CR_TRAILER, INCLUDES_PATCH, MAILING_LIST_MULTI, MSGID_FROM_MTA_HEADER, SPF_HELO_NONE, SPF_PASS, USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 33FA2C43462 for ; Thu, 22 Apr 2021 09:09:34 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id F128B61459 for ; Thu, 22 Apr 2021 09:09:33 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235491AbhDVJKG (ORCPT ); Thu, 22 Apr 2021 05:10:06 -0400 Received: from mail-co1nam11on2112.outbound.protection.outlook.com ([40.107.220.112]:32864 "EHLO NAM11-CO1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S235659AbhDVJJ6 (ORCPT ); Thu, 22 Apr 2021 05:09:58 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Z6vklRxQoDLUJfuQ7GIp05eBngkBEfFctg2EXadYzw/6zWunkWAnO/pdzWuUDU/Pxh24OZsMGdtYqBf7PuhV4QtcQL3KGgQzlCXAD2u56r1HYUDpxfNiFj9auIdLiw9NGBQtlNcn6UBrtMfYvKey9i18oQPd71loTGFIKhD7BNYEWxm8DItiOmH2uE+rRUYf8WEL7en4bxJHdNN2AualSSOYFJxTfvDZxr1+Eyz7I/q14RXwh3G9UplMC3Ekmt8Gn84lU8KDtLC53QG+8JAmI7k6fNLsVe4wTVFfRk0GFtY84Bvkf53HbwMVjAD836l8Nv3SfddP8/G91Es7ADe2Cg== 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-SenderADCheck; bh=jmRWFMCUEMT+cz4GcPH/zDJcrRXlqg8GmLXCr741EyQ=; b=WzzQxFWhAik/V6NtmWycw5QX1cCKvnmTSfTv89sQj3Koo4i+9lnXoesUrAhWcO4D4EgDKIQoXdNAZa29QNrktoaO/lEtXxKXCT71cNzKnQe7ObtyIZJ4Lg3UR2aklcw23Uf3xd/ZrcnN4wIJ6BcljftdYJTnTg5j8+Bmm/pGMqb9EkZzmpBQROk2coV9XH2NWkoZF39pSyF0vSIk6I29BmP4VFGzKSxcJ5xU0uLuRo8hCERSn5ZZuMbEOt2aCm5bbv9ehG8gw40SuahF7SCwiguSI6WGoQVqE6lwVM539MExa+lWcU2yfbpLrm0dQgiowM3lAKcNHysrXbXuTAmXnA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=os.amperecomputing.com; dmarc=pass action=none header.from=os.amperecomputing.com; dkim=pass header.d=os.amperecomputing.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=os.amperecomputing.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=jmRWFMCUEMT+cz4GcPH/zDJcrRXlqg8GmLXCr741EyQ=; b=rB4bDemzBcEz0pmBplkhP4a81ooc80VYvCaeqLyU/aqKxaSWvLum0cJ8upJ6hN7ZPSOI811BGtLD7OhKyRRdtZImj210gboRHJnb70Zjl0IRtMgcUbNeceLsLKyr3dukicuyTWIF7CeWtWE6tTqSR2Q/t/YS0ho5LVgdHIC6t14= Authentication-Results: jms.id.au; dkim=none (message not signed) header.d=none;jms.id.au; dmarc=none action=none header.from=os.amperecomputing.com; Received: from MW2PR0102MB3482.prod.exchangelabs.com (2603:10b6:302:c::32) by MW4PR01MB6356.prod.exchangelabs.com (2603:10b6:303:66::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4042.16; Thu, 22 Apr 2021 09:09:22 +0000 Received: from MW2PR0102MB3482.prod.exchangelabs.com ([fe80::d840:7aa7:58d4:b503]) by MW2PR0102MB3482.prod.exchangelabs.com ([fe80::d840:7aa7:58d4:b503%5]) with mapi id 15.20.4042.024; Thu, 22 Apr 2021 09:09:22 +0000 From: Quan Nguyen To: Joel Stanley , Andrew Jeffery , Jean Delvare , Guenter Roeck , Rob Herring , Lee Jones , Jonathan Corbet , linux-hwmon@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-aspeed@lists.ozlabs.org, openbmc@lists.ozlabs.org Cc: Open Source Submission , Phong Vo , "Thang Q . Nguyen" Subject: [PATCH v4 4/4] docs: hwmon: (smpro-hwmon) Add documentation Date: Thu, 22 Apr 2021 16:08:43 +0700 Message-Id: <20210422090843.4614-5-quan@os.amperecomputing.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20210422090843.4614-1-quan@os.amperecomputing.com> References: <20210422090843.4614-1-quan@os.amperecomputing.com> X-Originating-IP: [118.69.219.201] X-ClientProxiedBy: HKAPR04CA0011.apcprd04.prod.outlook.com (2603:1096:203:d0::21) To MW2PR0102MB3482.prod.exchangelabs.com (2603:10b6:302:c::32) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from hcm-sw-17.amperecomputing.com (118.69.219.201) by HKAPR04CA0011.apcprd04.prod.outlook.com (2603:1096:203:d0::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4065.22 via Frontend Transport; Thu, 22 Apr 2021 09:09:18 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: d6257fa2-3e15-406a-15fa-08d9056e515b X-MS-TrafficTypeDiagnostic: MW4PR01MB6356: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:7691; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: OGutW08rP8lwUNv3Zgs9Q//bWIgfqkJjuUuWBRY21RSoqOCdI+tJvTNgZ30PF4eF9mOvf1fkQqa/g16LHC1RXD1UzT9lpphylTge+gldaPvIq3mfXCBKW0rBeK1F3fkx9SySr2pnWTRInJyvvQIlMAGu9XtU7SMbJQFARP2rACar/6ZEMUKVBBHVOtwoVwkhkhh9DdaYOyJoZzSVQad0jP9NovCuvK107K91Z1AZ4ar6GyJrdl1apTnEpSFhf4XMz37IdNmgMIXX6I1/kjzeLJM7XDdszBRD1ZDuVV6ThIQiyQIPaVTRScKFvQSoWpsZoVzqbILp8CjU3EVKsLgwE0uspNWt7EUsxIBfWJV4WWbG/vD/ydBRkN8/WdcPplAZs1BhyElvAfPSmAIMb2WW9phZshgwc1+qusa4uk8xo6yF3rD7DysjvToVYGmcjOq92tJIQGtjbKDEFfEcRL4YMUf9PowG0a31Srl0jeonnJSMLJt/9MJDQ0AldcunJTNhYcLmMHToJP6eWKtPggvP+M3uPU6xsVXBwwzJdsFWygPHLHLA9mz8O6WRDW1CHQJzDTv5yJtMA/9jfdmjVYgaZuDrlRIsQdJwvMeGPJd5fdfswJ1AL81on+XcZ6Pwx5UJAUKprTTTudo5HD5GiDo1K4owcudCK959cr5yu34utMg= X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MW2PR0102MB3482.prod.exchangelabs.com; PTR:; CAT:NONE; SFS:(4636009)(396003)(136003)(39850400004)(376002)(366004)(346002)(110136005)(38100700002)(26005)(107886003)(5660300002)(86362001)(956004)(2906002)(6512007)(1076003)(6666004)(316002)(8676002)(186003)(83380400001)(66476007)(4326008)(16526019)(66556008)(52116002)(38350700002)(921005)(7416002)(2616005)(8936002)(478600001)(6486002)(66946007)(54906003)(6506007); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData: M0xsnyCf5rcBQ7TkwE2TB5XkBMs3L/nO7EZ3tZkHxX1VVGSt1pjmIXa9TKyJqaQDwerfb/xbBQXzMHG73qtuLxAf4TkypuZWlTI0q8Z5J7Xt7AhyuHQPUBSkexFzvyuerg78wqBKLa/UwP2s51JKCT3sgFXMmkNT0DMGe4Av1uJg337PTP8yO3UysX3YVOw6y+q+uKACGbTt+SkU4mqD17+aBUAz/ASRRohMwzKMcddwwmqbOzP4GimAuqV4B2YNHws6I/8wPNL0ERheb1imP0NL5lPeqjXfK9ZIFk5lk8Sil6DDtFAOxXTgAerwrvOP/lH6AjeD8ea1uu4YbockThxJiGMHMP/TPZTK6ePBOOMf7kgpj4hYQn+M9v9uao5qv9k4w6JhZH2G6/LGqV1OhsTqcYmUHsRXsaz+o8CQnZvZZP6aeUshbAaoe7vch4q6FQ9NUtp+PCnV7ehrPPVzFVfWpSguF6ZYmuxQlmM2VcGn4AL9uWrIr80pAye+gSFH4UcOzgpMN8bJnLJIVK9RLBacZq4MnJX3cobEEwnG52HsQic+ovJ5hGvX2oEvXyf/cy30+vpCf7Jz6zNojemj42KDyDVkPYoSGZLcDBWvKccF5pe7u5emiiy7gW9foDjHXUM5b7J2POjKWROX7puLXwVnYiVcgEDBM6cDi77ArnvoP4VQehJUPTH7gqNetVvRsO/wV4QKYOHF7zw8/a2ryN4YTfWg3iorZUg7/mHZI5Q7gl3G92EZQnkuLVK8ZydjdYP8ciY1kYI2A32H6Coqy2tSbNdV77860BnQc8riCLoh6+QGG/dWHpYHFP33+HiWiuH+wyVryMqC2hSFOLp/8QUDwEOrFp6o7eDtLSt+xBNsplvaMGqLdJzPmnirYTJgP3yOVdw8KgSEN9LmOGmW9uw52YWUfPX/yfumf8CBCXUdild9AnrbN+1GlhK2yX80rHwK7USHSFnBJ0T66mw+4JlZepKK4XXMQ6OPQU8TBUE4NMkTnve74W08fzeqs1eSysCpeJLJvOwj1C69ZeuvZGwHFYNYm5+UnZr1fb0DypkxvgmXXD4k38nVE0zh72h1m4ASTvqlkqzGgzqbraz3eaveE87/W1QH8mah74Hs7BvKMyAwi2yuusUF2o8PyqrOHmGOtXHSQ3fEWqmxFSh2ZU66QTycfgpd4VS413T6s7+TsQNTxzNi0xnW+dcukkv8MpqCPnG++abo3MhiMAvklBJB9A83krhIWIoHyVG7D+CM/g8+qLNf4EvfFuk+Oko5HoxFIAPFXKtJBQtdYrORK9TahtoJBAsOUXr0sW5dp6evghcTQoERP66CZYisuPAL X-OriginatorOrg: os.amperecomputing.com X-MS-Exchange-CrossTenant-Network-Message-Id: d6257fa2-3e15-406a-15fa-08d9056e515b X-MS-Exchange-CrossTenant-AuthSource: MW2PR0102MB3482.prod.exchangelabs.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Apr 2021 09:09:22.2868 (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: JzqU6EJjqfwyS2nZ5DwcgNul7Y4XCachP0kmZ2VFJa7zhLi0msAXznWgdOcCIhVzNsQWWcchwVpzehfIGHooMZxual2UoKdI5ByEaY99Ins= X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR01MB6356 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Add documentation for the Ampere(R)'s Altra(R) SMpro hwmon driver. Signed-off-by: Thu Nguyen Signed-off-by: Quan Nguyen Reviewed-by: Guenter Roeck --- Changes in v4: + None Changes in v3: + None Changes in v2: + Removed "virtual" sensors [Guenter] + Fixed typo "mili" to "milli", "nanoWatt" to "microWatt" [Guenter] + Reported SOC_TDP as "Socket TDP" using max attributes [Guenter] + Clarified "highest" meaning in documentation [Guenter] + Reported MEM HOT Threshold for all DIMMs as temp*_crit [Guenter] + Removed Socket TDP sensor [Quan] + Included sensor type and channel in labels [Quan] Documentation/hwmon/index.rst | 1 + Documentation/hwmon/smpro-hwmon.rst | 101 ++++++++++++++++++++++++++++ 2 files changed, 102 insertions(+) create mode 100644 Documentation/hwmon/smpro-hwmon.rst diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst index 48bfa7887dd4..3e3631b253b6 100644 --- a/Documentation/hwmon/index.rst +++ b/Documentation/hwmon/index.rst @@ -166,6 +166,7 @@ Hardware Monitoring Kernel Drivers sis5595 sl28cpld smm665 + smpro-hwmon smsc47b397 smsc47m192 smsc47m1 diff --git a/Documentation/hwmon/smpro-hwmon.rst b/Documentation/hwmon/smpro-hwmon.rst new file mode 100644 index 000000000000..f978b1370e16 --- /dev/null +++ b/Documentation/hwmon/smpro-hwmon.rst @@ -0,0 +1,101 @@ +.. SPDX-License-Identifier: GPL-2.0-or-later + +Kernel driver Ampere(R)'s Altra(R) SMpro hwmon +============================================== + +Supported chips: + + * Ampere(R) Altra(R) + + Prefix: 'smpro' + + Reference: Altra SoC BMC Interface Specification + +Author: Thu Nguyen + +Description +----------- +This driver supports hardware monitoring for Ampere(R) Altra(R) SoC's based on the +SMpro co-processor (SMpro). +The following sensor types are supported by the driver: + + * temperature + * voltage + * current + * power + +The SMpro interface provides the registers to query the various sensors and +their values which are then exported to userspace by this driver. + +Usage Notes +----------- + +SMpro hwmon driver creates at least two sysfs files for each sensor. + +* File ``_label`` reports the sensor label. +* File ``_input`` returns the sensor value. + +The sysfs files are allocated in the SMpro root fs folder. +There is one root folder for each SMpro instance. + +When the SoC is turned off, the driver will fail to read registers +and return -ENXIO. + +Sysfs entries +------------- + +The following sysfs files are supported: + +* Ampere(R) Altra(R): + +============ ============= ====== =============================================== +Name Unit Perm Description +temp1_input milli Celsius RO SoC temperature +temp2_input milli Celsius RO Max temperature reported among SoC VRDs +temp2_crit milli Celsius RO SoC VRD HOT Threshold temperature +temp3_input milli Celsius RO Max temperature reported among DIMM VRDs +temp4_input milli Celsius RO Max temperature reported among Core VRDs +temp5_input milli Celsius RO Temperature of DIMM0 on CH0 +temp5_crit milli Celsius RO MEM HOT Threshold for all DIMMs +temp6_input milli Celsius RO Temperature of DIMM0 on CH1 +temp6_crit milli Celsius RO MEM HOT Threshold for all DIMMs +temp7_input milli Celsius RO Temperature of DIMM0 on CH2 +temp7_crit milli Celsius RO MEM HOT Threshold for all DIMMs +temp8_input milli Celsius RO Temperature of DIMM0 on CH3 +temp8_crit milli Celsius RO MEM HOT Threshold for all DIMMs +temp9_input milli Celsius RO Temperature of DIMM0 on CH4 +temp9_crit milli Celsius RO MEM HOT Threshold for all DIMMs +temp10_input milli Celsius RO Temperature of DIMM0 on CH5 +temp10_crit milli Celsius RO MEM HOT Threshold for all DIMMs +temp11_input milli Celsius RO Temperature of DIMM0 on CH6 +temp11_crit milli Celsius RO MEM HOT Threshold for all DIMMs +temp12_input milli Celsius RO Temperature of DIMM0 on CH7 +temp12_crit milli Celsius RO MEM HOT Threshold for all DIMMs +temp13_input milli Celsius RO Max temperature reported among RCA VRDs +in0_input milli Volts RO Core voltage +in1_input milli Volts RO SoC voltage +in2_input milli Volts RO DIMM VRD1 voltage +in3_input milli Volts RO DIMM VRD2 voltage +in4_input milli Volts RO RCA VRD voltage +cur1_input milli Amperes RO Core VRD current +cur2_input milli Amperes RO SoC VRD current +cur3_input milli Amperes RO DIMM VRD1 current +cur4_input milli Amperes RO DIMM VRD2 current +cur5_input milli Amperes RO RCA VRD current +power1_input micro Watts RO Core VRD power +power2_input micro Watts RO SoC VRD power +power3_input micro Watts RO DIMM VRD1 power +power4_input micro Watts RO DIMM VRD2 power +power5_input micro Watts RO RCA VRD power +============ ============= ====== =============================================== + +Example:: + + # cat in0_input + 830 + # cat temp1_input + 37000 + # cat curr1_input + 9000 + # cat power5_input + 19500000