Received-SPF: pass (google.com: domain of linux-kernel+bounces-144782-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161;
From: "Peng Fan (OSS)" <peng.fan@oss.nxp.com>
Date: Mon, 15 Apr 2024 16:50:50 +0800
Subject: [PATCH v10 2/4] dt-bindings: firmware: arm,scmi: support pinctrl
 protocol
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <20240415-pinctrl-scmi-v10-2-59c6e7a586ee@nxp.com>
References: <20240415-pinctrl-scmi-v10-0-59c6e7a586ee@nxp.com>
In-Reply-To: <20240415-pinctrl-scmi-v10-0-59c6e7a586ee@nxp.com>
To: Sudeep Holla <sudeep.holla@arm.com>, 
 Cristian Marussi <cristian.marussi@arm.com>, Rob Herring <robh@kernel.org>, 
 Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, 
 Conor Dooley <conor+dt@kernel.org>, 
 Linus Walleij <linus.walleij@linaro.org>, 
 Dan Carpenter <dan.carpenter@linaro.org>
Cc: Dhruva Gole <d-gole@ti.com>, 
 Andy Shevchenko <andy.shevchenko@gmail.com>, 
 linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, 
 devicetree@vger.kernel.org, linux-gpio@vger.kernel.org, 
 Peng Fan <peng.fan@nxp.com>
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: DU0PR04MB9417:EE_|AM9PR04MB7506:EE_
X-MS-Office365-Filtering-Correlation-Id: 9f0336a2-e374-49be-9eb8-08dc5d280d53
X-MS-Exchange-SharedMailbox-RoutingAgent-Processed: True
X-MS-Exchange-SenderADCheck: 1
X-MS-Exchange-AntiSpam-Relay: 0
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info:
	a1PcyRBVsm9bf7cwF9XlE7NDeGEnLdzPhqn1Nm3L1fznQxACz6NZBHI2BN4l+/5ZxZbZ+LrNcx9uVeVOh2z+F3GgZ2xKwrgwF/NNspGboqtC9dKSaap1Mm6b2M+/XR/F1Ac6oi+4Yz2TZydrZI77qbf8gHJwDTFdB11cecQ790Z5IF33ebHsYJzZYZ4vYpS3852TKE9mmGvqZb8iwBRp9JFUU3NlKfXOr4PLwCwQlW+pxghiqzMoHJ+sPzr81q8rhkUV67s/kbh5hjA59JomS7kXeJBYPgIgf57OnXuH9rfbwzQVEJVeG2tM7WkvRQM3xzIkOw6AhlRUkQY3Ncu5fs6C0Lr6nMn91/XzoL22036UcLyHwZwMzQmQxnhG5+kc9eYub/DZZSe8oPJooQMSeQMd3wep3wWqh82s9TAlDgCFnokL70bXadg+fRlWCcPFrQFO1SMvDhCmxxC1F1ukb+kh7RTXrbp1xQv3aqBn+Cfl9I9O537eG2rp3csymn0E89RvZUm5yjuBrNoi1wkzNusZ4bYegyLEswa+tJ+3umI6d38+KBKpEjJqCQFos0s4pcrW9ZvmcEVAZNvsa2GyYQC0Xb4j1fRZWY03isXNBUl+hYFYkIJ2f3sJGaXYywEWoCQTEdwyt6+AqRYdWmnAzUHeDnF87nNKoN7wHYxC9tlEihAGHaiaJy0VlGsAMIPrA6Ly6RpTqFPJk9ORfUAUEaDkAu9TQqGt8IeudlAbBNw=
X-Forefront-Antispam-Report:
	CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DU0PR04MB9417.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(1800799015)(7416005)(52116005)(376005)(366007)(38350700005);DIR:OUT;SFP:1101;
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?cURxM0JPd05BQmJhZEY5STlPaWMrQXJqZW5Hbmc3eEs1NUt6R2lNVnNNZzZG?=
 =?utf-8?B?U09Sakx2Q0taYUFKazdWQmRaQTRPd1ViWjM1dlZ5QjBudERBU2tpRDhkamM0?=
 =?utf-8?B?eVBMWitIUXFnSGVhWTVNazNDemN4OCtmNXBYTnBYYkp4bEhUaS9SSW9zOU82?=
 =?utf-8?B?RFdmRUEyekpvcVVrb3AxU3BabE83ZDM5cGVLSjFkOUVrRHVYQ1RRbEV0VE45?=
 =?utf-8?B?NlQwbXI1QzJVdi8yNDBDa3JPTnFFS1lRdjcrdXZESWtrU09LQzgzRkpHUEJw?=
 =?utf-8?B?YlR3NjRXMWN3WHlLNTUwbE1DNUhKTmNZMWFiZkdIWnZCK3MvNC9USTc3WWVT?=
 =?utf-8?B?eTZGRmN3cHJYRFo5SU1oczVmOXRhQVo3N3BlQ05oQ1NsZUg4RG1DUDhZTk5X?=
 =?utf-8?B?MGRlMmpia3Fad05YUkdrRk5wQW5QNWhzajNINUREdGg5c1BmWDRISDNaQ2Fx?=
 =?utf-8?B?bU0vTmJQZFhDSGsyNmJNbStLM0RLdEVYbStvOG1BY3FGTTVzd2VwNzNVNWJN?=
 =?utf-8?B?SVpMM3prekRvOEh6eEFBSkRaL2NjalQra24rU2JXL0tuMTRONUM2ZnZIbFI1?=
 =?utf-8?B?akRDMy9FT1YxN2hBbzI5UnprajNEV1M1QUo4VjNMT0d5NUo1QytVZ0gwM3R1?=
 =?utf-8?B?TTF2MzJkUnpTNDR6ekdqTDVFWG5oU2NDc202ank1UGlXazllalExMDJZRkFz?=
 =?utf-8?B?YjBFSWFxczBvYTRNdDNFd3FjVnE3U1NhYjZOZjdZN1NNRnB1RWJrUnNHMS9E?=
 =?utf-8?B?bVY2b2JEdEZaUWVhak9QVlZOckk2V2VhT2d6T2J0MFNIVGkyQ05jUFNkSFVZ?=
 =?utf-8?B?TUxUenB3dm85Z3dJR01NajlzY253K0s2NlVFUGMxZmpBU2g5MmFxTnNhQUlJ?=
 =?utf-8?B?SUtmY2hjUmxzTFRuVWhIUmpMbXBNdlNVV2MxN1dVT1JlZjBnazZ3WURkUG9y?=
 =?utf-8?B?WmFqaDVhL1VxVjd2c0JsM2NGalFRQ3htUm1MWnFraFJuc21GTENhdjd6c0l3?=
 =?utf-8?B?QTJGNk9sSjhhWU0wTWNBZ1pDYnNOY0hqU3pBYWthQ2JVOW90VVdQaFpMK0JS?=
 =?utf-8?B?emZaRjV6d3NreExtV2xiMmlwYmJUZXVleGJtY0hsa2VsQzJUaFBneTlLUHox?=
 =?utf-8?B?SlRzRnJxMVFlUE9UelliN3hCaG02YWpTNHJ5TWNTbS95Z09BVTUxZkt0SnJi?=
 =?utf-8?B?TDhpRFNyaytFWGVSQ3gxZVpza0ZSb1lXQzN0eVlhK0J5TE9udmpSZ0lyT2Jx?=
 =?utf-8?B?U0NPMGQxOThPeUdYYy9aZk04bWJPbFdkSHpGU1E2cUFjMTcrUzdBdTdNaks2?=
 =?utf-8?B?RmIxZDJTanEvcE92TzJENDI0WjczcTYyT25YTUtGdWVWck4zbjQzSGpnOGYy?=
 =?utf-8?B?M0czNnk0N3JvYW1XVE54VHROejVoOHpqWThlMlRaOFhyOTl6dHZPMEdhQXph?=
 =?utf-8?B?TzdZVEI2MFRYaUJnMWtEQkdyRVJ2T1VnU3FTbSttVFNoaEVZeFYvclhmVG9D?=
 =?utf-8?B?cDVZOFQwRUhWV3B5eS9hV3ZiYUxwaHY3NVk4ZnFSS3lRVzhadmp1NjZBalVK?=
 =?utf-8?B?TGdVZEVLUERrc0ZMMXA0d2FLOUtaQTBRVVZqZDFqdUFrOHo2ZWwvOGYxWlpl?=
 =?utf-8?B?NCsxai9vVk1jMU5qS2lCNHJtdGdybFdNcW95aXNFOHlNdm9wZTIwQWs4T1Rh?=
 =?utf-8?B?S1RORVc0TjBucXhIWkk0OXFRbk13Z0pwcjJUaFVKM2RieEI3dDFOektBZlk1?=
 =?utf-8?B?bEVselJGZGFNVm5QUStGbGhrZ0RQd3lGL25rM0lsRFFrQmFqTVZQb05ybzhS?=
 =?utf-8?B?cHhiY2ZSaWc2WDNvekUyWGhhQ0hiNFhncnRCay9XV2l0Z2d2aGNmb0Y4TzRG?=
 =?utf-8?B?SkJGY1M2WjJlZzNmeTZvbjF0TDVLTXdRakVvaHRQbm9RTGhscFQrOTk0OEoz?=
 =?utf-8?B?eWZTSFRqWldLTFRwYVJQMytZOHFjYkdWTFJkWkRDWVg1Qlk1cGpiVW13eGkr?=
 =?utf-8?B?cC91cUhnU2VWZ2RaWkhBTkZDUFZJQ0ZiNmJ5ak9jbFg1d1Qva0wwRXg0VzdJ?=
 =?utf-8?B?NDQ0djcxbFh6eE1wQnVyVlJkYTRXUHN1amlFOUdqRWJlelVpSFQ3eHN1TjJY?=
 =?utf-8?Q?kaBLIUX/aogkfWwXTG1AjabpV?=
X-OriginatorOrg: oss.nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 9f0336a2-e374-49be-9eb8-08dc5d280d53
X-MS-Exchange-CrossTenant-AuthSource: DU0PR04MB9417.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Apr 2024 08:42:58.4645
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: jVqB7+J8AkENFPqSV6fnutvtFm8BRzb5aPK1vWxKF8kzOh7IuqoEIm9FXLkFJw6QQdJeukt83iytvGSQgvY/cQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM9PR04MB7506

From: Peng Fan <peng.fan@nxp.com>

Add SCMI v3.2 pinctrl protocol bindings and example.

Reviewed-by: Rob Herring <robh@kernel.org>
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Reviewed-by: Dhruva Gole <d-gole@ti.com>
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
 .../devicetree/bindings/firmware/arm,scmi.yaml     | 50 ++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
index 93fb7d05f849..7de2c29606e5 100644
--- a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
+++ b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
@@ -247,6 +247,37 @@ properties:
       reg:
         const: 0x18
 
+  protocol@19:
+    type: object
+    allOf:
+      - $ref: '#/$defs/protocol-node'
+      - $ref: /schemas/pinctrl/pinctrl.yaml
+
+    unevaluatedProperties: false
+
+    properties:
+      reg:
+        const: 0x19
+
+    patternProperties:
+      '-pins$':
+        type: object
+        allOf:
+          - $ref: /schemas/pinctrl/pincfg-node.yaml#
+          - $ref: /schemas/pinctrl/pinmux-node.yaml#
+        unevaluatedProperties: false
+
+        description:
+          A pin multiplexing sub-node describes how to configure a
+          set of pins in some desired function.
+          A single sub-node may define several pin configurations.
+          This sub-node is using the default pinctrl bindings to configure
+          pin multiplexing and using SCMI protocol to apply a specified
+          configuration.
+
+    required:
+      - reg
+
 additionalProperties: false
 
 $defs:
@@ -401,6 +432,25 @@ examples:
             scmi_powercap: protocol@18 {
                 reg = <0x18>;
             };
+
+            scmi_pinctrl: protocol@19 {
+                reg = <0x19>;
+
+                i2c2-pins {
+                    groups = "g_i2c2_a", "g_i2c2_b";
+                    function = "f_i2c2";
+                };
+
+                mdio-pins {
+                    groups = "g_avb_mdio";
+                    drive-strength = <24>;
+                };
+
+                keys_pins: keys-pins {
+                    pins = "gpio_5_17", "gpio_5_20", "gpio_5_22", "gpio_2_1";
+                    bias-pull-up;
+                };
+            };
         };
     };
 

-- 
2.37.1