Received-SPF: pass (google.com: domain of linux-kernel+bounces-142109-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
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,
	Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Subject: [PATCH v8 1/3] dt-bindings: dmaengine: Add dma multiplexer for CV18XX/SG200X series SoC
Date: Fri, 12 Apr 2024 15:07:31 +0800
Message-ID:
 <IA1PR20MB495375109D0375B8ADA6519FBB042@IA1PR20MB4953.namprd20.prod.outlook.com>
In-Reply-To: <IA1PR20MB495359880A3A8C4947702BB5BB042@IA1PR20MB4953.namprd20.prod.outlook.com>
References: <IA1PR20MB495359880A3A8C4947702BB5BB042@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_|SA1PR20MB7440:EE_
X-MS-Office365-Filtering-Correlation-Id: a16eb3d7-d2b6-4023-b937-08dc5abf3018
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info:
	ad9qk06okJGfioff4IeIYFt6cB6Z9p8IPVvX91BemJr8ya8bkhfKP2Q/EeuxJ1Ca7JtO1JRBNgge2WIab9hjg4NLWtYwapHa7bsmjFGbtT41znvaJ0SrAILYdUomjWvXYXhG6jtlzpMOa6FDGfNKfcpdCI3wdTwg030IgoK1MUs6Z4v5brkgyFLf/2n8j/PZXOPDN0Ivr5bZDt+QpY+vQp/JTjVIFXOt3STkBAPtejh3xyLvhopTwvVnr16sLmIb9LAKoVxer4HkHXqD8cCnbmy4UL13+Sgw7t5T0OwP20XPSENyOuLZRgNJ2AmHpJCkaDz8dxzb6OK+1zXU5CB+Z3vjiY9eoUWxxrOzAB8EIR3uQrcqdC2D2o5VPzJ4zGNY6FvqG45GDTNNk+NQujQ0CFDY4wzndz5qaNzBWndSnO7hKVUpqcYnfrJsE6YkWql1JSsAKF4hVbZpzMqFMxCCv8SvpIP+8HdYSGNXQ3C5ADcofU7zmZ173xndznnluEwzsWXQTrLNmrkRrjhHMgJr4YUVCKEKgjwtPDXLkNTPfqenwLkATdGz7Fcfk3UgWq3faGanqJvp+ausdVvoJ85jdepaROm/FVxqWys2P4D2/7IFbhunPG+WY/O8c1LX8cnR9+O/3bDv92HD5s0Hsd0QFIP/qvzNTK7JExDZO482j//Pc/mkzy9P3IDuESRvi66W
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?E2OMlPMLoIwwLiKPho75CuSisDZ+xJJD5cB+GjoXIKnA4BBxXu7jH+tGGFdr?=
 =?us-ascii?Q?RU+ECzDPdKdEI0xhgRuOMKhhxnPj2I4zlWrQW97QQABXhBW70KjZa7RSMeTX?=
 =?us-ascii?Q?R5sWygPSWM1exuezW/hQiDcx8M4QB7jT6N+8MueLcKZhqtQ7ZjOY3R0VPC/k?=
 =?us-ascii?Q?s6JJ7ThdoZbcbGz9mTMJDfsjv6IrRXdG3uR1VgB1T13DqU2RMRaGZxMo+EmW?=
 =?us-ascii?Q?MtBVG/1f30+FgB0/9npCfulEYwTJ9YHqRN3O4xABBs9x/ZdyZ0oU7OjhM0ts?=
 =?us-ascii?Q?Q6OQUAjtP2AcS2hWnHZ1x9C4V6SVKLlA5SMlsG68y1qIwp1TQRp3rMCUZ8Jd?=
 =?us-ascii?Q?LwLOVUwvxKFodgarIXWQIARMrmPe0C2UWlvJVAbwM41xqUjjzW+EqwujSxDF?=
 =?us-ascii?Q?gci8rN6tSSagfksLgB6GYdDaj0k4r8/HQSEmuLWZcQf3C2k4NzhNLfsiY6XA?=
 =?us-ascii?Q?ABxVl1dlDC2c5TH9SHWKOoM8gg/GZOY1jN8lPjKtX2Uk6uLgtcIzXr+/+hlv?=
 =?us-ascii?Q?MO7QzNFeN+Globd9bSKyFVq0NZKgBeSnK1EJTDrCl51TTm9TUALs3UWdyppN?=
 =?us-ascii?Q?maRxfRGCLbHFwoMTBBdxzCtv9+VgDSnyvnBPZwEgeEUXvVrtOha4K9CuT5YS?=
 =?us-ascii?Q?vLW6zNE6yC8G8gqe1wyIQiScB7hhFbc5lLUfJJd+gzcDUdxhHHQ+sPg85i2j?=
 =?us-ascii?Q?MagBiV1lCcR/3B6E29Yzxc8HMoap6mXKpdVbAZvIoqdot2rwOqdkBvXApzC9?=
 =?us-ascii?Q?JuwpOKRE2faLZMQJJc8gJnbzz8ldbImFdGJ4UtjCj+dyCcob+GbvATBCzIxr?=
 =?us-ascii?Q?SqGquIp+DtR0qojZ4Gz21hZZL8t/hNeUhkcXUB81UyPuPNtlX9tpXlDubQSo?=
 =?us-ascii?Q?IUWFYSZ5Pc02ZxIjY3slwjIRGGGCHPFiWF/fIwD5FcU/lXQH1AZ5NMxf8whv?=
 =?us-ascii?Q?W7hQRH13Ompq/ANn29VLsWmRjvMq+VcGHPmmjrzIgwHS7VYHvnRT4ZYpybj1?=
 =?us-ascii?Q?tecac8Om4VCXYHkWvlKaSHV6BjpLwHrVjuEuCSR7Nr66gMixZ/PTsLw0YA7Z?=
 =?us-ascii?Q?dM9LbcgBOSZ4FE2dWumqiVdUIbmzhVYE0YAaJ3R0rG111CeleOwQRQadIqsP?=
 =?us-ascii?Q?tdVrvuuU/WbTAPkZ6vU+AWH9zF55G/239lVx2sT7o4HNKqjhQhJYh5r/ofaJ?=
 =?us-ascii?Q?UBcd46b4zNpWhMkq+SNeUx+Fe88B1tsUdVopvAIvOZJq2+PL216IBcyehD6K?=
 =?us-ascii?Q?r4V6kUKMMubxAmbJKyu5?=
X-OriginatorOrg: outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: a16eb3d7-d2b6-4023-b937-08dc5abf3018
X-MS-Exchange-CrossTenant-AuthSource: IA1PR20MB4953.namprd20.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Apr 2024 07:07:17.3796
 (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: SA1PR20MB7440

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>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 .../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