From mboxrd@z Thu Jan 1 00:00:00 1970 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 bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id D1C88FA1FFE for ; Wed, 22 Apr 2026 21:30:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:MIME-Version:Content-Type: Content-Transfer-Encoding:References:In-Reply-To:Message-ID:Date:Subject:Cc: To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=OyocYzYKTx/6S6qPDZZaBcYBo1tj1fmASl25eWMWw0s=; b=M170xtNWySE4kunR4IEGO66l/a Epkt6Nl3Gq8yXGMCc/Hn+j9wyF97M+5piQqwgqiqNirwXNvG6d+G6otegWMQqbS7U9XL4tOrwHFrG G9qdRGYoIJLEzX2nL1hTgCwPs+T5hdRFkkJDxWd/VihZupWpZD7BRAoraObKPQg5cCZF68s8dpQxh e2S79g7dVhtPVrqj/jDD4HzjqVplGVLky0mNwvGtwXFUU5ZE+CkMHYca5z10r/vqA7nbfLv1q3Zeb pzcbmkrvDwpjpsQGQh/0nG1QCjDZLbycyAmx8JwBVC61GtF5jQ56bGIYG9KAR4exzQi0T6fiM3cug jIE+FTqQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98.2 #2 (Red Hat Linux)) id 1wFf9U-0000000AlsJ-3tak; Wed, 22 Apr 2026 21:30:32 +0000 Received: from mail-francecentralazlp170130007.outbound.protection.outlook.com ([2a01:111:f403:c20a::7] helo=PA4PR04CU001.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.98.2 #2 (Red Hat Linux)) id 1wFf9R-0000000Alr1-36v5 for linux-arm-kernel@lists.infradead.org; Wed, 22 Apr 2026 21:30:31 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=ff7pzs3sNJbImUmbASzktJ1dwIXOsJL6mtAPPj5/GzcXznvXMZBrA5grTNUlm0+eY3+twIYx010FgfPTZCXmqnaAlyIfnstTfSv5vbs5p1JQPD5I4xe7/t83/q9eYW42mOEFA8KOocW1kZcUyCt6uNg3btqRZE9wk0qpDwVo4/9Fq537OxSu4Y7IOJLN98xDwwFmwdLGJss/Ob3gONAIyLO14+LtD99k5W2XqURzv1zqG8icQIHPQnPUmrI5eVnEnibfBqg540ErqoyA/A3gBjsfj445/LsXPRUXTdJT3PUr6D2N40BlP+/GlQ7DFgGcsSRi1BIh4GZp+LhPdzsseQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=OyocYzYKTx/6S6qPDZZaBcYBo1tj1fmASl25eWMWw0s=; b=xmFZxwWZEfrW7tjvyc7ENlKy8W53eJog5ZTmVZk8LZzN3rZUBRdqE2+QPhVeequyDn8n9EDp0DOQCE1bWGYY1v5rU5G0geDoCD/nUjFgf2ykNI8WQdYJNKCdC/ev1WM6OZcry/o6BUiPH6ai2vIDIMbAxRFRCNmI5Pc95djAQ5Ju5fPMTiIdE258YmRWYHnXN+Jv5/D6+anikf7m6Gh2ldLsD/eMsWPAnnhoofnsAasEjlhyziwsSa7QaWGaDg2LozyfjrCwq07n830kYhq/PCMCT/u1Ua609Fx3pKiKatZJcAQ2Re3w9un6nmI5JNcNVxPWKkfYfPERcH80xpUTVg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=OyocYzYKTx/6S6qPDZZaBcYBo1tj1fmASl25eWMWw0s=; b=k+VzkdU9FEyKfAnDA80l/0R0fg8Gu0Ww0ESa6WpbFGCclBIuiKXf1cuOR0fIxm1bG4EnTivfR6/MGQL/hWCN5wMQg8ipSW2fbX3YpFiFmc72PsGTUfVu53xpnVVXX8ccoX4Epp8opMECZH9zrSABdWjICzFMauiV9OSIpakYJNJztjzIb3xy3TS6/9cqO/mKMpLs68wn2DAvG6dk02a8TrufQVD3mYg2N4Njnrpg9sk+7URsUCzrqkxfxziHTtZZBTOYLQXTMq3Vph2zM84dYDieqCSWW7oUpZ96HOgR3eH92z07o2Aa6JIRxP0Hb1fmmT+OTZ6uGXzByUTef0/9GA== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AS8PR04MB9176.eurprd04.prod.outlook.com (2603:10a6:20b:44b::7) by DU2PR04MB8870.eurprd04.prod.outlook.com (2603:10a6:10:2e1::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9846.21; Wed, 22 Apr 2026 21:30:24 +0000 Received: from AS8PR04MB9176.eurprd04.prod.outlook.com ([fe80::ba87:1cd1:53d9:fcd7]) by AS8PR04MB9176.eurprd04.prod.outlook.com ([fe80::ba87:1cd1:53d9:fcd7%6]) with mapi id 15.20.9846.019; Wed, 22 Apr 2026 21:30:24 +0000 From: Shenwei Wang To: Linus Walleij , Bartosz Golaszewski , Jonathan Corbet , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Bjorn Andersson , Mathieu Poirier , Frank Li , Sascha Hauer Cc: Shuah Khan , linux-gpio@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Pengutronix Kernel Team , Fabio Estevam , Shenwei Wang , Peng Fan , devicetree@vger.kernel.org, linux-remoteproc@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org, linux-imx@nxp.com Subject: [PATCH v13 2/4] dt-bindings: remoteproc: imx_rproc: Add "rpmsg" subnode support Date: Wed, 22 Apr 2026 16:28:47 -0500 Message-ID: <20260422212849.1240591-3-shenwei.wang@nxp.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260422212849.1240591-1-shenwei.wang@nxp.com> References: <20260422212849.1240591-1-shenwei.wang@nxp.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: SN6PR2101CA0014.namprd21.prod.outlook.com (2603:10b6:805:106::24) To AS8PR04MB9176.eurprd04.prod.outlook.com (2603:10a6:20b:44b::7) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AS8PR04MB9176:EE_|DU2PR04MB8870:EE_ X-MS-Office365-Filtering-Correlation-Id: 32b31881-ca55-4cb7-8e34-08dea0b65d25 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|376014|52116014|7416014|1800799024|19092799006|18002099003|921020|38350700014|56012099003|22082099003; X-Microsoft-Antispam-Message-Info: BmS9cyKdNJcKocvdnxWaJSedT6rgCKXcG7bT2kjJEI+WWMZxkTzj0Bb6DpneZYrf67QRaIoz8r2cDvpJ+glvQTWx5UwFj3Wb2sN059ud6eS9S+CjRHirSiYj1VVdBo9Pj0iJVdpI33U3o2nVIvKSA+t+O1o9EV8A/mjLxlPbFVQaXbmf/KMu/z+VpdxhunqXgwyPErEmaKrs+XjGXCCazh/Pi21dQ8/P+3xVat9W82WW8rQ+X+eKe0PyEcz/gdcJbave1djFnjU7PPJSMLIKM9UkDGDgxwf/APuH85zoZLGvvcuoBWHAG604t4rxy8BWhnmqM10kbzy9WAMFgakymUyAfdWceqhkAApohX1UU3hQz/fK3UNWG4CJGXK+HGiAwMMoFRByGYjCCzzQLFCleZbaUcpu+ZGFbXNQmgTLHZm8MEAWrjI4XVQQX1dXA0gkbf2Pe1NyEI6P+ExM3M1RRezYcoPaFbly/CsPyqfncy0Kzgs16oi5KPsHJOtGPTo9ugtRYoA8lma1wg/mn1UdFYvr8asBD3J13XBm4f2+XhzSXkt0ljc2TeOomGVv7qtxFIw9PFufNI7z9s9CJ4uj2mlCoBROrA1oNsmp0vBfXsF5FlO59MzpU7yN62vlLDEnwwdCIpTlnylg0EfbkLeexuFpG4480jR4oyvT5J1LKtnrBsLC7Epasl2J/EJgx5Omapb45vK4i7fLLLlK3TYmZv+ci0RRtfaBhVe489NhLo7k+oP+mndRwmS23G9mzziMemvTp5PcwnqTc86GzWh8lA== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AS8PR04MB9176.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(366016)(376014)(52116014)(7416014)(1800799024)(19092799006)(18002099003)(921020)(38350700014)(56012099003)(22082099003);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?AgIYmTdx/i/4JfDk4yKsgrxZieEKliBtm0SIj3h9dkf/KBtzx3pxbd3VbH5H?= =?us-ascii?Q?Ivgedf/H4vehx+3eBSYMdKJda1zdsKcCUnKvCDFuqZMp8lKhE4SKF29dU1HR?= =?us-ascii?Q?TsgrwE62CHYvZyQApEqjn0HMVTMrOOr4epq2Uhl+Gb84IQsHb/kgz5oxOJfO?= =?us-ascii?Q?6Wob5M9o9HnJZLJO0XGXSADYrbTOAIjovqZ8iZRHyz51ijdZPhnYmeU695pj?= =?us-ascii?Q?mCT5KC8WgPmmmgXIENpWd5aAEUrUyER69lbGegILJ/ebRub7MWfyfmXKwEAn?= =?us-ascii?Q?M7wO0m5j+Bmsi/CKNRiBmoCoBzx6rb9nNZL4BaQtJvZxA2beRgsbKgd664x9?= =?us-ascii?Q?KIxhNUHQjRZX/XNy5z9Hbx1G7tutS3KFLfc4Jgd6ntGj650iFnZ54oVVN8ay?= =?us-ascii?Q?WOa/J7UOFnufI0CcVGeKGHEOovEYB9/YJnkt1hdscY/gdPCjaqNRJpw0ZlAL?= =?us-ascii?Q?GDuJog3aGJkV1YjHviksEAigAPP7Zun5PP1lGtFAv7AKllk1ZpA0d2pWdhgm?= =?us-ascii?Q?UeQ/Pku+tteRZkpHDh+6xTe1Ccapr+GjmNN2uG1YnDI52IE+zWaVrAkW9RZB?= =?us-ascii?Q?Ym8DBU9vN6FwwzSlUy3Ao9uh5QOWWACVe2G9Rnp1NFO+M2ippkoEH4Pr66vA?= =?us-ascii?Q?HvlTj4A4WvvpZGUXp7va6Nd5UrmH1Q3RsSvpCL9+p/Zlp+WsJ3eLup1g5vVa?= =?us-ascii?Q?l3IOyBzGXTJhfEJEOO8nQTt10F3t+YaPpDdbDHvAbZhwXV/kNv3WVeDkbZMs?= =?us-ascii?Q?bX4/QXxVPWlxoohfzDNDVddL2cxzZi+vx1VnKE4t366PyOeQgkgwNZaRCS2Z?= =?us-ascii?Q?s+597joh0dDDBYlgu233g4ZR0F2U8DDHisGyHdWR2LFq7YF26gW5HXLRIhh9?= =?us-ascii?Q?RCF5vCsyG6Q/EyfFn1LWJXq4+OOUUmgncNDqw2cwjhdagVgc7qkBOyhb7buh?= =?us-ascii?Q?DoY7kVsImgQthVTd2Z7W5gJUE24pz1T9LKzdWIeQ3+gjcbwjsOQHs1BSYrTP?= =?us-ascii?Q?ku+e2pz13Csi5ibB3Xer/UwPuWRcViATIOyQ7KM0/P/lSubBCHGzngO9n+VA?= =?us-ascii?Q?2MBJtllXEcVuGOsMcehcX2s/wiC2FpCN8ok0MjSwo6EiIS5+GxzIX8MEvyaw?= =?us-ascii?Q?Qx7xCEO3U+4faw8u+OIQjkqdDdnpJFEggNWcaJpfRkhVVOyhyir/rHx0IeFv?= =?us-ascii?Q?ToftZVml05uPnP6RnIEujHtB5ZP3ZtNbX7A35JACkwvm6Pb/52RrerT7qgbH?= =?us-ascii?Q?ybh/HA+X//lbrqP6TbDJpsFQLcZdKM09Y0C+7GCpVzTGYmw2456jaExz/tT+?= =?us-ascii?Q?aIEb1EhaiFqNylZVUTqMl+Jiqd8d+Oyw6JNzmPQKVZpFblnDCO0f0MlITnam?= =?us-ascii?Q?KPYNn+GZ2k9sh7H/OnGaplbSpmDTNYPcL/LGdNSbDTdvtQwf3reHC79Ym3Q4?= =?us-ascii?Q?uKwGQVnJ0HIIpVpsYuTw29PLF3qQJpYDCPGk5Tcnqt0BHvmb2D0mGmpGF3u+?= =?us-ascii?Q?AtxPU0kK7I4EQMlQWp77+J6b41X4HuPPDf0ycYLVskgEqJ4yhll/mIN9ikK5?= =?us-ascii?Q?Vr6+E7T4FHozFBzO3VUs7cOm2VnDpi3rpPOuzWldVT9B2IKkklhRcxRzTYbG?= =?us-ascii?Q?Rkmjqic1CMv1NdsIGA63YhO/3sOBZi0vxKJsIJscaF+mqyMHWazPfHxt5of8?= =?us-ascii?Q?3rxm5JI4f6iRYPtbzFm6pYJqUn8/leqkwxv03XVB9G49xyHJnlJuypN3/Zr2?= =?us-ascii?Q?PoDSnrbjfw=3D=3D?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 32b31881-ca55-4cb7-8e34-08dea0b65d25 X-MS-Exchange-CrossTenant-AuthSource: AS8PR04MB9176.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Apr 2026 21:30:24.2730 (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: BY+mhXP9J2AiLqvAhxG9Va2fH7jpiAigr/2cy0cRqkjRX6Zd6cuYWUspjrXYlN1UeTcNF6baArndUHwVB2vYSA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU2PR04MB8870 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20260422_143030_318848_B6F0F0D6 X-CRM114-Status: GOOD ( 18.40 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Remote processors may announce multiple GPIO controllers over an RPMSG channel. These GPIO controllers may require corresponding device tree nodes, especially when acting as providers, to supply phandles for their consumers. Define an RPMSG node to work as a container for a group of RPMSG channels under the imx_rproc node. Each subnode within "rpmsg" represents an individual RPMSG channel. The name of each subnode corresponds to the channel name as defined by the remote processor. All remote devices associated with a given channel are defined as child nodes under the corresponding channel node. Signed-off-by: Shenwei Wang --- .../devicetree/bindings/gpio/gpio-rpmsg.yaml | 55 +++++++++++++++++++ .../bindings/remoteproc/fsl,imx-rproc.yaml | 53 ++++++++++++++++++ 2 files changed, 108 insertions(+) create mode 100644 Documentation/devicetree/bindings/gpio/gpio-rpmsg.yaml diff --git a/Documentation/devicetree/bindings/gpio/gpio-rpmsg.yaml b/Documentation/devicetree/bindings/gpio/gpio-rpmsg.yaml new file mode 100644 index 000000000000..6c78b6850321 --- /dev/null +++ b/Documentation/devicetree/bindings/gpio/gpio-rpmsg.yaml @@ -0,0 +1,55 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/gpio/gpio-rpmsg.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Generic RPMSG GPIO Controller + +maintainers: + - Shenwei Wang + +description: + On an AMP platform, some GPIO controllers are exposed by the remote processor + through the RPMSG bus. The RPMSG GPIO transport protocol defines the packet + structure and communication flow between Linux and the remote firmware. Those + controllers are managed via this transport protocol. For more details of the + protocol, check the document below. + Documentation/driver-api/gpio/gpio-rpmsg.rst + +properties: + compatible: + oneOf: + - items: + - enum: + - fsl,rpmsg-gpio + - const: rpmsg-gpio + - const: rpmsg-gpio + + reg: + description: + The reg property represents the index of the GPIO controllers. Since + the driver manages controllers on a remote system, this index tells + the remote system which controller to operate. + maxItems: 1 + + "#gpio-cells": + const: 2 + + gpio-controller: true + + interrupt-controller: true + + "#interrupt-cells": + const: 2 + +required: + - compatible + - reg + - "#gpio-cells" + - "#interrupt-cells" + +allOf: + - $ref: /schemas/gpio/gpio.yaml# + +unevaluatedProperties: false diff --git a/Documentation/devicetree/bindings/remoteproc/fsl,imx-rproc.yaml b/Documentation/devicetree/bindings/remoteproc/fsl,imx-rproc.yaml index ce8ec0119469..aea33205a881 100644 --- a/Documentation/devicetree/bindings/remoteproc/fsl,imx-rproc.yaml +++ b/Documentation/devicetree/bindings/remoteproc/fsl,imx-rproc.yaml @@ -85,6 +85,34 @@ properties: This property is to specify the resource id of the remote processor in SoC which supports SCFW + rpmsg: + type: object + additionalProperties: false + description: + Represents the RPMSG bus between Linux and the remote system. Contains + a group of RPMSG channel devices running on the bus. + + properties: + rpmsg-io: + type: object + additionalProperties: false + properties: + '#address-cells': + const: 1 + + '#size-cells': + const: 0 + + patternProperties: + "gpio@[0-9a-f]+$": + type: object + $ref: /schemas/gpio/gpio-rpmsg.yaml# + unevaluatedProperties: false + + required: + - '#address-cells' + - '#size-cells' + required: - compatible @@ -147,5 +175,30 @@ examples: &mu 3 1>; memory-region = <&vdev0buffer>, <&vdev0vring0>, <&vdev0vring1>, <&rsc_table>; syscon = <&src>; + + rpmsg { + rpmsg-io { + #address-cells = <1>; + #size-cells = <0>; + + gpio@0 { + compatible = "rpmsg-gpio"; + reg = <0>; + gpio-controller; + #gpio-cells = <2>; + #interrupt-cells = <2>; + interrupt-controller; + }; + + gpio@1 { + compatible = "rpmsg-gpio"; + reg = <1>; + gpio-controller; + #gpio-cells = <2>; + #interrupt-cells = <2>; + interrupt-controller; + }; + }; + }; }; ... -- 2.43.0