Received-SPF: pass (google.com: domain of linux-kernel+bounces-103294-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1;
From: "Peng Fan (OSS)" <peng.fan@oss.nxp.com>
Date: Thu, 14 Mar 2024 21:35:19 +0800
Subject: [PATCH v5 2/4] dt-bindings: firmware: arm,scmi: support pinctrl
 protocol
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <20240314-pinctrl-scmi-v5-2-b19576e557f2@nxp.com>
References: <20240314-pinctrl-scmi-v5-0-b19576e557f2@nxp.com>
In-Reply-To: <20240314-pinctrl-scmi-v5-0-b19576e557f2@nxp.com>
To: Sudeep Holla <sudeep.holla@arm.com>, 
 Cristian Marussi <cristian.marussi@arm.com>, 
 Rob Herring <robh+dt@kernel.org>, 
 Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, 
 Conor Dooley <conor+dt@kernel.org>, 
 Oleksii Moisieiev <oleksii_moisieiev@epam.com>, 
 Linus Walleij <linus.walleij@linaro.org>, Shawn Guo <shawnguo@kernel.org>, 
 Sascha Hauer <s.hauer@pengutronix.de>, 
 Pengutronix Kernel Team <kernel@pengutronix.de>, 
 Fabio Estevam <festevam@gmail.com>, NXP Linux Team <linux-imx@nxp.com>
Cc: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, 
 devicetree@vger.kernel.org, linux-gpio@vger.kernel.org, 
 AKASHI Takahiro <takahiro.akashi@linaro.org>, Peng Fan <peng.fan@nxp.com>, 
 Rob Herring <robh@kernel.org>
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: DU0PR04MB9417:EE_|PAWPR04MB9861:EE_
X-MS-Office365-Filtering-Correlation-Id: 45fcbd0a-12b1-4975-93f4-08dc442a797d
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:
	U97MrxKMY5B+dHDlv/+GIeKn2ViEhvJQO3elMrFtD7ay7HKUClOQVaVhpBNFMOpeTj6VbB1ZVCutIS9h5OP4lDXR6yGJbqtxtqcB4wVBdiyn3GMAAJoDuI8o2NQMutWcB2d2Dk8mEE9qlWDYyr0y56sPHfRGkq/44yEkFRm8CHv+JmaW9PpKDewbgRcUEq4PQkJgV03atICWSm5zoSyQq/3n09jMuDmHYoJYnEkN9Vro/LjnWIZHjRcq66TIvuIzvBdnCTzE3G3XALo2WDyIbXYfAtIEZjGaVh5qYHoHUn0zpA0nYgPwP+QOXzTuikj2yGicFnf8JuP8x8UMQc6ZcGftPmM5jFHpkMvKvwBXJkNpLnwgXqBr4OG3f8Bed/JR6xlThisGgg5IhejqSEDZFBrbqRcY1vjDbU0HnIZff7dimWpykutq5E9HT0j4qlZzy+IfwK6d6nH4ictrq6ImTKWUXJHwNYr9gaiIMb2S+hnnmFNwxOnOiL1OeSV5TTjbej+bM5S4qRpzlPCZelENDZp3RLJANYlebx/7sXvoHmSpSvoP9CWXuAfRiIkHefc9g/Xfg3JNoCqv2LAx01KmWXIoTQ47amk6+xxVxKU3thxPP0hYsPtrkUuI3yOAEltn7uPNtYjl+I4C2FTGGoDSB0XWSqbfrb8fFfP/8wre8aPF3pqDrge2rcMvpp6DqZBJpujYanS2V+XOd/fkPrP+I6gREKo1bMfOkLxxEPTnzDg=
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)(376005)(52116005)(7416005)(1800799015)(38350700005)(921011);DIR:OUT;SFP:1101;
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?WDV2VHRiaXNoNFpqRXlrRnE4YzNyTDRQdmc3QmR5TUlGUi9iVERVQU9nYmtw?=
 =?utf-8?B?VExZL1V0aHpIY2tyemhldkc0TTR3Uno2ak9maTJjVVpKTmJ5aE9qNDIyejlz?=
 =?utf-8?B?emVlYm9YSTRycWJKTnR5VjA2R2lyTWEyWXFZaXBsaEZ3Rm12Y0plRjE3WXhr?=
 =?utf-8?B?aUpSeVNsMzc5WUdINjZKekd3dWtYRzdER1FuTk1SZ001TUtYWDlwRXFEOUdU?=
 =?utf-8?B?azlkbmg3T0tpUk5WZ3lnVTlFUU54UXVkNk5KN3E5T2NqUHVXaGR1Sk1PaXdy?=
 =?utf-8?B?bVdBQVdsNGNSb1JOZFFvMXg2SUMzTkJ5VnBSZzZWYW5EckpJenppWjR2b29T?=
 =?utf-8?B?NFdsNTJRUWpnb0p0K3BQYWpTNDBiOWtSUnE1aGp6ZXh5UWMrb2YzdktBaC9X?=
 =?utf-8?B?SXNOZjZuR1dVeVVvTHlyenJVZjk2N1kzUzMxUE1ZT0I5OWd2b2ppUXJCTVVq?=
 =?utf-8?B?MGs4V1J3RUFzWGpldFp3OWZvWFZMVUxQUE9KZEdDTXY2RTh6M2x5Q0x2eGJR?=
 =?utf-8?B?TzdsdkVCd2l0V1ZIQzUza3NDa1pIVmU4L0N6ZXBNK24venpXRmFjMlBPNWR5?=
 =?utf-8?B?cTFWZnJwamx3S0l1WjZyU2JZcEphS3o3R1cxVkRhcEhjL3lqUXlmMTJvSGZ1?=
 =?utf-8?B?OHJ3REdhYmpqclBuZTQyZUtKR0VkRVUvcjVaSUZwcWdjbjgrTUFjRE9HUzZq?=
 =?utf-8?B?OEJubkJsdkQ4VU9HQmN2RnZaZ29DVXQ3L2VRN1c2MlFnS3F6MlZUWDlLdnJm?=
 =?utf-8?B?Y1ZaY3ZlckZsQnpUVFM0S1lzSjFyMGwraGIzaHpkQmNER1g3N0pOUWJtM0NK?=
 =?utf-8?B?ZjgxR1FBakJGUU5BTlFTdGtHWW1vTlk0aG02QUpWS3Z5WUxCMW1xZDhFWmVt?=
 =?utf-8?B?SkRyVjlDVkZEVjdzd3JtblhxMDNKREgvVDJSd2lHTzFrSU51cWZzQXkybTJN?=
 =?utf-8?B?UnNSeDdJZC9zTTM5Q0YyRDU4dXdXbzB0b0RhaC92OGw1SkxPVkJaanB1QjNY?=
 =?utf-8?B?V1I0TElQQ1M4ZmdJM1JxZFNBMklTTk04akw1VFBtR1ZKVUo2NUtMdmZjMjZ4?=
 =?utf-8?B?eWcxb242dzFOUWJQOTlJUFFtVXZnUFdHNHFqNHZXVUpKZ1JCZlIvb250QTdi?=
 =?utf-8?B?LzllZHR4aE1UK2ZYdHMyMEg2SlJBNTZGOEM5T1BJUUp2cnFkdUtuZi9kclBr?=
 =?utf-8?B?SFVrOUo1bEFTQmdiQzhTdUlmOUNCbDhmdG1iVnp5eWFBa2MrVXZ6ZXF0Z1Vx?=
 =?utf-8?B?UUZudG0yRituaENnY1BqWlBTNW9lRDNqY0hkTkJRUFhIRmNteVd4cng3M0g4?=
 =?utf-8?B?WnpNV1lCSElmajRQOWludVluUHY3ajN6STdiZEFqR25TWWJOd3RDYjhDbW1N?=
 =?utf-8?B?UjJuNThOVmNyZkJNT2dISkZ1bDJMVXpXTWtxUGRYdGFRMW1sZkRVSHVYZCsz?=
 =?utf-8?B?VVp3ZzVJa2srZEZYZGovVFZEQkRFRmZQWlNjQ1E3ZEZoZHJENmFNRkxZZXU3?=
 =?utf-8?B?SkE5ZGVmcHM2RUZmbkk2NHJrVnZGSm80YXZLdXlYS2hvdDBVV2ltMWlKWDFK?=
 =?utf-8?B?UmJRZ1cxcHdkNWcwdHkzazcxRUl3bElDMW1mL0ZpejJlY3V0QXFzdzJiQnZk?=
 =?utf-8?B?a3o2cmg2aHdRdGpzMk0rT09NMVl6R0k3ZHhycmpRdkdvc2RFNE5mZTdHZkFh?=
 =?utf-8?B?aUtQcXRRa3hHZzZndzRQdFJvVnhBeTlQSWhQQ1FSclJReGlOczBLNU9WZ0tq?=
 =?utf-8?B?NzBxZlZnZ0xUZnVDMjA3dmFidXFDak9ya1BBOG1BbHBVblFQZ3lqU0V0a08r?=
 =?utf-8?B?b2xvM2hseUhva00zNkNtbkwrSjl0VjNIWTZicnVleXhVRHBXWmREV2Nubkpi?=
 =?utf-8?B?TXAzTDR0ZFpFRkpTTUROSFZNRGliTkMrV1IxSk0xazFhL3lrSElWUEFCTWdN?=
 =?utf-8?B?aFRmZWZFaklyVkNVaTRsaXRkaTFrSGdtRjF2bWRqVkQ1QnQwWCtTZVNrOHl4?=
 =?utf-8?B?ZXVONkhHVHdsLzIxZlN5ZFk1YlF2ZmVEdWQrZUsyWlBVODZYUFNEcGk2VjA2?=
 =?utf-8?B?a3V1T01hUXdCdmkrSnc1aGVaVCsvOXRzTXI3bUM3ZGVIdGdsckYzdlNGRXVl?=
 =?utf-8?Q?XchIfu9+LNMMwvmOxsg+2bOiE?=
X-OriginatorOrg: oss.nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 45fcbd0a-12b1-4975-93f4-08dc442a797d
X-MS-Exchange-CrossTenant-AuthSource: DU0PR04MB9417.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Mar 2024 13:27:19.8345
 (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: wyNqA3iCfLowopmS4Mf/+GMrj9sNHR6lgaVUY/+8f615iKLSt3W46U/oKvIimN56ODQKyUdzkZdDycQYT+6zvg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PAWPR04MB9861

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>
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 4591523b51a0..bba4a37de6b4 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 describe how to configure a
+          set of pins is some desired function.
+          A single sub-node may define several pin configurations.
+          This sub-node is using default pinctrl bindings to configure
+          pin multiplexing and using SCMI protocol to apply specified
+          configuration using SCMI protocol.
+
+    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