Received-SPF: pass (google.com: domain of linux-kernel+bounces-124024-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99;
From: Inochi Amaoto <inochiama@outlook.com>
To: Vinod Koul <vkoul@kernel.org>,
	Rob Herring <robh@kernel.org>,
	Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Chen Wang <unicorn_wang@outlook.com>,
	Inochi Amaoto <inochiama@outlook.com>,
	Paul Walmsley <paul.walmsley@sifive.com>,
	Palmer Dabbelt <palmer@dabbelt.com>,
	Albert Ou <aou@eecs.berkeley.edu>
Cc: Jisheng Zhang <jszhang@kernel.org>,
	Liu Gui <kenneth.liu@sophgo.com>,
	Jingbao Qiu <qiujingbao.dlmu@gmail.com>,
	dlan@gentoo.org,
	dmaengine@vger.kernel.org,
	devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	linux-riscv@lists.infradead.org
Subject: [PATCH v6 1/3] dt-bindings: dmaengine: Add dma multiplexer for CV18XX/SG200X series SoC
Date: Fri, 29 Mar 2024 10:04:37 +0800
Message-ID:
 <IA1PR20MB4953DDD8E89675650E0E2529BB3A2@IA1PR20MB4953.namprd20.prod.outlook.com>
In-Reply-To: <IA1PR20MB4953F0FAED4373660C7873A2BB3A2@IA1PR20MB4953.namprd20.prod.outlook.com>
References: <IA1PR20MB4953F0FAED4373660C7873A2BB3A2@IA1PR20MB4953.namprd20.prod.outlook.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: IA1PR20MB4953:EE_|SA1PR20MB5151:EE_
X-MS-Office365-Filtering-Correlation-Id: 997d6efb-69bd-428e-12bb-08dc4f949427
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info:
	siY0LAwyBgQ3cxY9zKy8W9Xo1EJjXC1nL+G+xG2lgEzzKpwaNNZ6m18eZrlhcVmy3F+i0qaKQWGS1vFonVdA9gCRFsW/uyvCX03GuGDgsQ7h9E9riGQyiiBKT16sgpcdpmSLXmQMrNjszp8SG3ljITfrRUxi4x6Jenb9REtTw4y7V80/6oZYj9AF1t7K4/3yrqUdHm/dG/ep2xFF9HYW0OwdtczSBqtP6Ak5LrRISVY9g/oWxQkBh2V/4nfqWYp4HZlKCx4R4aQYD1xmJ2o3+wno02OuYyXbXcC+wV64iEvpOJC0otVQxaK1YrO5Z9GKCs60nW5+28r65whV2iMY6xg/86StQwxQ1TOSm5C8pufO27Suu4QPjsM0uPTeWNT/V7L6WTyRRoB4XO8FUXJ10yUMwE9OZ3YhQdosNsPG8Ta9x7Dg2K1QcfJDnukYuUPjCWmyLT+LixYzD/BCQwGEKIUegs77lf/ubbnLFEPpyFvEnMc+EiZmsoS4qUploNWkdWAwGXwhMGP/8lkLdMQvOy+vlw1X5GfZM4+VGlsyxjcHbZ6OCg/ic5BHWifJCq50fFbPANa0pJCYy23WDpCjOpenVKK8WWAWkFHKQfVrC2hfu3mF3CN+EwtnCQLtFET4pBTKgOyj3y+Ca0qYyDC8M1SuVsPA0N0C6CSqQ/tkD2qCHg2YE5aLZ5XXLR3P8xzkwVT8bs3unu3FAWZ2IEbZzA==
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?P8jApDyui+t01exk0B9p60tkeFFvRF1n0FwlLAWXQqiUADn+YkhY/CCTLp2I?=
 =?us-ascii?Q?ZyghMJIrARKdp9AhzHry0/Im5ZhY+C2Z6vh/mrzABwK0FP153zBYFb0+N5vb?=
 =?us-ascii?Q?6NRlga4s1kQR7ow/KTWGDJ7TeqrsDcF2lQlAyJGdEeMs8fEwOOUB5/NBJJ67?=
 =?us-ascii?Q?cw4S3x0LheFbMWaobvNApxfFWTqUDkrdYeP/6XA1gIPsFnoxB0ujSxsJWK0r?=
 =?us-ascii?Q?NWp38UZctGnc9FoLf1ja9gjFf/5/UwUKilkwAnu2j7c2Mf8eFB9ta0bRCfhR?=
 =?us-ascii?Q?7U9fnt2prPCGCRCZ/5OXJqzUvjp71Y0Oape0OyJ60mbnCX4CyJIuhZEpfTcz?=
 =?us-ascii?Q?CkRS8VT1V9aejUuQZtSRXuC0HIpd7wvXbgg+NZmEloWgYiWVy6g+aYWsGUnn?=
 =?us-ascii?Q?8g4sjLoM7CrdAaTQBJ37VIaQagkstUGGQ+cJXoPb/ZucamUJCfXHeRg2eZyi?=
 =?us-ascii?Q?0FFmYqmzndXeT5K+sVJnlXm8lnNliv1l06nKzF7LRuIaEbVtJBq94AsRUcBB?=
 =?us-ascii?Q?ZJLmwumRQPEbWuKDtt80+cck6BsTYNC4gNHOBAvsA5xCcyHwAxON/7Rwkeq0?=
 =?us-ascii?Q?18o8nMKOe4jUmfJORzhfe7dSa6Nz6dVUpHf3B9z2Hejv7U3i8QaNT3RmGuG4?=
 =?us-ascii?Q?lZcxfXTjMRSExAtxaMGO3bgZJNCCJSzWm30mvvJsaA7h78PJ+0HuJM2E5rup?=
 =?us-ascii?Q?q9WN+u7EJvQD0PSfunD+NfgCy6cBWHKir3aj4XUvT+sSFpPWRMHbjrl3BoHU?=
 =?us-ascii?Q?x8oVuiMcbfqP1giAUYw7HcWt/JgrdH7kd86r2tOChpdsVoqkXSBHP7gGpLIx?=
 =?us-ascii?Q?O2YJUZv17UxOU2WOj1Mgs19K87Gk3iNv6DZHlnpPdVbEzvPJOHWiY+oATHWv?=
 =?us-ascii?Q?3Caa3GpiLJiIC3gJq8ICs0H/ozZqnHXStayWAJsBRZ7IXPOhLFXNsH/GtRfh?=
 =?us-ascii?Q?QtBQMZWFs6j/LrKUGh5+IkrqNS7kWDz1Pn54TOAf/VKClyDjswVNisqrxZCG?=
 =?us-ascii?Q?PazGm6N0C6zBSomkuTVkH+cwBkCKX/VsYrc8XpVdLU7la/CtKZBnw3OCqu/7?=
 =?us-ascii?Q?0/2UbvzRTlAYpvaex/rFdZpTPIiloXXvhASmpJGJuXzv+tqsz9D/6JilwMKl?=
 =?us-ascii?Q?QZf3uzUn6XJDcBFx4zc3tobgo+gHAuslrQNmPL7a76TDXABQj/UrtDbqUsSy?=
 =?us-ascii?Q?JHfYPDcdFU6ya0wv2Ba9bH8xA25RdoiSKSPZEUQObddxyTrzFZrh/OGmjzhN?=
 =?us-ascii?Q?tPad1Wb7INck7EM9uDuZ?=
X-OriginatorOrg: outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 997d6efb-69bd-428e-12bb-08dc4f949427
X-MS-Exchange-CrossTenant-AuthSource: IA1PR20MB4953.namprd20.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Mar 2024 02:04:34.0594
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg:
	00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA1PR20MB5151

The DMA IP of Sophgo CV18XX/SG200X is based on a DW AXI CORE, with
an additional channel remap register located in the top system control
area. The DMA channel is exclusive to each core.

In addition, the DMA multiplexer is a subdevice of system controller,
so this binding only contains necessary properties for the multiplexer
itself.

Add the dmamux binding for CV18XX/SG200X series SoC.

Signed-off-by: Inochi Amaoto <inochiama@outlook.com>
---
 .../bindings/dma/sophgo,cv1800-dmamux.yaml    | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/dma/sophgo,cv1800-dmamux.yaml

diff --git a/Documentation/devicetree/bindings/dma/sophgo,cv1800-dmamux.yaml b/Documentation/devicetree/bindings/dma/sophgo,cv1800-dmamux.yaml
new file mode 100644
index 000000000000..480cb117db9b
--- /dev/null
+++ b/Documentation/devicetree/bindings/dma/sophgo,cv1800-dmamux.yaml
@@ -0,0 +1,51 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/dma/sophgo,cv1800-dmamux.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Sophgo CV1800/SG200 Series DMA multiplexer
+
+maintainers:
+  - Inochi Amaoto <inochiama@outlook.com>
+
+description: |
+  The DMA multiplexer of CV1800 is a subdevice of the system
+  controller. It support mapping 8 channels, but each channel
+  can be mapped only once.
+
+allOf:
+  - $ref: dma-router.yaml#
+
+properties:
+  compatible:
+    const: sophgo,cv1800-dmamux
+
+  reg:
+    items:
+      - description: DMA channal remapping register
+      - description: DMA channel interrupt mapping register
+
+  '#dma-cells':
+    const: 2
+    description:
+      The first cells is device id. The second one is the cpu id.
+
+  dma-masters:
+    maxItems: 1
+
+required:
+  - reg
+  - '#dma-cells'
+  - dma-masters
+
+additionalProperties: false
+
+examples:
+  - |
+    dma-router@154 {
+      compatible = "sophgo,cv1800-dmamux";
+      reg = <0x154 0x8>, <0x298 0x4>;
+      #dma-cells = <2>;
+      dma-masters = <&dmac>;
+    };
--
2.44.0