Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
From:   Quan Nguyen <quan@os.amperecomputing.com>
To:     Joel Stanley <joel@jms.id.au>, Andrew Jeffery <andrew@aj.id.au>,
        Jean Delvare <jdelvare@suse.com>,
        Guenter Roeck <linux@roeck-us.net>,
        Rob Herring <robh+dt@kernel.org>,
        Lee Jones <lee.jones@linaro.org>,
        Jonathan Corbet <corbet@lwn.net>, 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 <patches@amperecomputing.com>,
        Phong Vo <phong@os.amperecomputing.com>,
        "Thang Q . Nguyen" <thang@os.amperecomputing.com>
Subject: [PATCH v5 1/4] dt-bindings: mfd: Add bindings for Ampere Altra SMPro MFD driver
Date:   Tue, 13 Jul 2021 13:00:28 +0700
Message-Id: <20210713060031.31568-2-quan@os.amperecomputing.com>
In-Reply-To: <20210713060031.31568-1-quan@os.amperecomputing.com>
References: <20210713060031.31568-1-quan@os.amperecomputing.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
Received: from hcm-sw-17.amperecomputing.com (118.69.219.201) by HK2PR03CA0052.apcprd03.prod.outlook.com (2603:1096:202:17::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4331.10 via Frontend Transport; Tue, 13 Jul 2021 06:00:57 +0000
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id: afdaf19b-ad83-4871-b738-08d945c3970f
X-MS-TrafficTypeDiagnostic: MWHPR01MB2592:
X-MS-Exchange-Transport-Forked: True
X-Microsoft-Antispam-PRVS: <MWHPR01MB259257F66CF482644F8F9566F2149@MWHPR01MB2592.prod.exchangelabs.com>
X-MS-Oob-TLC-OOBClassifiers: OLM:883;
X-MS-Exchange-SenderADCheck: 1
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: Y/rIHuBp/5dXAaGOOCKCbzvLgawc86Urw9Qq3PBiTtNr6fLaniPMamj2benqyz72fp4D6q4dBj1dxJ9iZX3y9XF0MFNyryDxoRaP3oFLXVVzK/M41gYB9J5JYz7vXjqUMaC9Kz/KYjwgnxOupxAlqpIOStxffKwchzBqbIvvH73qnktUm+lgvDY8GucVMWwJqmB9ODFYRH6A/QikfTQcQ8qsfnG2Ulg1YsOc5PIFaXu58EURfzo14euHQ+o1MjWyJjnBsp37BdcrTUBR/frO6a/Zm7rMGXnj907htTCfl99EoNBFbt+RUh/kTntJJxgTmx78G4alz47RK8mjzCM2ILnL0fRdUV5eFiHdPB3+djSoTEQaMSdgYizAthby66GcE/mb72uA591oxSF83ABrb48NK53Yo1TAVgHRxgWLfxkDbT9RXhVZ5FAXLjBtdlyydSPy0anvSH5RZxwmBgY0Q7+GQVIsmbDzXi1Jb1HR9wvxP3OsCbLFQmuP6er3kxrba8LIh8PB3oyjfdQZAJ6OKCFyU/FHW3V/nU9Sauegzlm8BfEhYjGFzzGWgSnu8190UON9IYKigiT1hWFRKv+Pfh4alVsSipQMH5ntdtzwllMdkEmagTNO8VyE7TrFOpBJx1YXy013I6cTkMoc/KZZj9oGoCU2s6dYgN9I0f87sMTZYguf9yDdZQKTBmJMkPbfU84Gm+pZScXdeOwGmysc8vHpZKJWEtMVPFo2Mr98WeemMkwzRP0vErD4+pcEDwosi5Hlke7/PtfNSEKEcpCAtlqn0il03Jnda5bbyhJe1/0hjX/ULSDdlMLFr9mTuiI7
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)(346002)(39850400004)(376002)(136003)(396003)(366004)(966005)(2616005)(86362001)(110136005)(956004)(316002)(5660300002)(107886003)(66946007)(54906003)(66556008)(66476007)(4326008)(478600001)(38100700002)(38350700002)(6666004)(921005)(6512007)(52116002)(6506007)(83380400001)(26005)(2906002)(8676002)(7416002)(8936002)(186003)(1076003)(6486002);DIR:OUT;SFP:1102;
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?4clz9Dy0YsJefnY5Rd/qQ5cxj4f10hcjPLR7p9QuJWQ0pfvArztQZBu7r0dM?=
 =?us-ascii?Q?ExIwkB3UTdhEn5Os/B8FfVEc5yZuC65NQfIpfM/xCcdhOjGzcajzBvlpltxx?=
 =?us-ascii?Q?9ICy10+gy8MRaHhBzcW7/ip7fQz5BxqxN8IAP0cxhXRpcL1y4NpDBtoorJvr?=
 =?us-ascii?Q?i7ToxCxGH+aDhn7WZCmz1sRw6OLsG32CLeUPV3kH7uCqdc4Dcu3q+vxubAyJ?=
 =?us-ascii?Q?zgs6abT59P4oiWv0qkPDGFsEQITl0fTy3hl0HUdElDMYNsiWtN6p2azAoPY6?=
 =?us-ascii?Q?ID/iE2F1dXidERaYLQ1ouoIFKHA1cF7zKJ4t3HIiv6IelxqyGxN6Tdt5yxJj?=
 =?us-ascii?Q?qyYxKePYluwSV0sTmXGnNuS0sgSrimZVaYHsKCCccqUb5Fug4qSBKCnZb38G?=
 =?us-ascii?Q?df3neADoYiz74WNJh+pjUo6D3cmmeFAstg28670CQ/VsJGtFGGJpE3RHeb7I?=
 =?us-ascii?Q?XBZt8N14lcw7E6gO7gzdHHumXRsTl/uGhjLdBLKO2IjiHlt9ubfNLivt2aNi?=
 =?us-ascii?Q?998usgVYJeoiYvrpwsyK07ohUscx0X6QdocJ6KuzMFL4Vbu1Zue8w/wO+byd?=
 =?us-ascii?Q?0juAO7YZ6dbLZvtQVDVek1sbkL6HQ/aSX24bd6vbLZdscYaTpDW5nTJ/rNX+?=
 =?us-ascii?Q?oUF609HvYHwsGZ884S+yMgzLfhNihb6ivFn43rSeAiElMZeboKmd0Ws+gAUf?=
 =?us-ascii?Q?BBl47Cstl4L9PzIQ6PoAgbap3jFFLjXMe1HsWdGMj6PbRoISSlcmpo5TktY+?=
 =?us-ascii?Q?Zlaev+1SiwkUbT48+DPQMLcBUqcSzqJ2EvM+0uhBQVYIIxOB0Kp5e+R4SGtH?=
 =?us-ascii?Q?dODwxheewPCYIeqwxTCV6v9Wnka8+LBlFumA7hk3sXxhHRn9hGncpTJxvTSe?=
 =?us-ascii?Q?UjAwShqUSIZXlcp7poxAWBQVp9Cw7kGSIbamYrjCXE7A+CQ9oWmMyAYVZR4z?=
 =?us-ascii?Q?KcN+SFisLb/UNQqXcBE5b6GGnbO/CfTABPaX0TSDfVJ0dCsvLgOB87dXKpsS?=
 =?us-ascii?Q?pCccx32H0z5YwSrX9d7j5dT9DHRSXap9Zk8aMN6/QfnyJrZW+vB4xhzd+6uH?=
 =?us-ascii?Q?fDraLTY38K2TMs5G6MELDRfUSefSztUNgtUVG+VdxrgxA1ykz/B+ReXstwOm?=
 =?us-ascii?Q?Rpr7TZ6B+Z0/q3foxRFahmkxo+QV5InpNhtPhHlQ4N8TnT5pPTMhN2min5D5?=
 =?us-ascii?Q?x/wsehE1isC1qtUAX9Qg92IU8vTEpFBBwu0zowsMjcDRK6SkKW2oAt13c//1?=
 =?us-ascii?Q?oe39Mj/b5LwOfHiPn7WDVbvzo8cOgTjhojDbYEIIHHkxvcztZpAIBRjx5GeR?=
 =?us-ascii?Q?0VeRbsoJHh14YLwJDMtk9Fk1?=
X-OriginatorOrg: os.amperecomputing.com
X-MS-Exchange-CrossTenant-Network-Message-Id: afdaf19b-ad83-4871-b738-08d945c3970f
X-MS-Exchange-CrossTenant-AuthSource: MW2PR0102MB3482.prod.exchangelabs.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jul 2021 06:01:00.9581
 (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: gPreIjFyH8cbNFHkltl2wlddjg263r8l76FmKpO6O6JTPQ3b7tQHj1uqeIl7Xa5ccU9xoDvllPE83HPxVLxUZdh0hem/EgTONwtLyE5GGUM=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR01MB2592
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Adds device tree bindings for SMPro MFD driver found on the Mt.Jade
hardware reference platform with Ampere's Altra Processor family.

The SMpro co-processor on Ampere Altra processor family is to monitor
and report various data included hwmon-related info, RAS errors, and
other miscellaneous information.

Signed-off-by: Quan Nguyen <quan@os.amperecomputing.com>
---
Changes in v5:
  + Dropped ../bindings/hwmon/ampere,ac01-hwmon.yaml file [Quan]
  + Removed patternProperties section and child DT nodes in example
  section [Quan]
  + Revised commit message [Quan]

Changes in v4:
  + Revised the commit message to clarify how the specific info will
    be handled commented by Rob.

Changes in v3:
  + Supported list of compatible string [Rob]
  + Introduced reg property in DT to specify reg offset [Rob]
  + Updated description and other minor changes in yaml file [Rob]

Changes in v2:
  + Changed "ampere,ac01-smpro" to "ampere,smpro" [Quan]

 .../devicetree/bindings/mfd/ampere,smpro.yaml | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/mfd/ampere,smpro.yaml

diff --git a/Documentation/devicetree/bindings/mfd/ampere,smpro.yaml b/Documentation/devicetree/bindings/mfd/ampere,smpro.yaml
new file mode 100644
index 000000000000..8b48747e5de3
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/ampere,smpro.yaml
@@ -0,0 +1,52 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mfd/ampere,smpro.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Ampere Altra SMPro firmware driver
+
+maintainers:
+  - Quan Nguyen <quan@os.amperecomputing.com>
+
+description: |
+  Ampere Altra SMPro firmware may contain different blocks like hardware
+  monitoring, error monitoring and other miscellaneous features.
+
+properties:
+  compatible:
+    enum:
+      - ampere,smpro
+
+  reg:
+    description:
+      I2C device address.
+    maxItems: 1
+
+  "#address-cells":
+    const: 1
+
+  "#size-cells":
+    const: 0
+
+required:
+  - "#address-cells"
+  - "#size-cells"
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        smpro@4f {
+            compatible = "ampere,smpro";
+            reg = <0x4f>;
+            #address-cells = <1>;
+            #size-cells = <0>;
+        };
+    };
-- 
2.28.0