From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-alma10-1.taild15c8.ts.net [100.103.45.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D33762931DF; Mon, 28 Sep 2026 12:45:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=100.103.45.18 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790599511; cv=none; b=VmyTToljI5potNu1skXoRR6Gp+JRGQzvG90hLwdtpNKAhqEWGAofBShJTx0gOYSsZGDbrOsIXtIh1bz25lE0f7lfNWxO/dZKRKc/cJ9fqFiyRwAKJVBJRTBU1kLJhYZqmq5EvWdCDAMdwys7ba623cKal5e4LcTS8t3gxt4N9Po= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790599511; c=relaxed/simple; bh=G7y474POKpTi688pkhVMmEb6+e4iP1EoZlz1Mco3gPE=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=lqPVRXQWWQg7TgySf3D5yGp/Ba8sVM65RL79mtOSy19Ix4Z5HHujbkO1hv7WtEKbKepKrm5qacr0pL/4dJL6rrhPK6xMWLlQgangVoi5RFlMfVopGFoDTvZoaNHK2LAKNkr+wxKHOQTyK2y8S2ixLq/bcQ8H4nY5B8ic5udUF9w= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=HFkY/XTf; arc=none smtp.client-ip=100.103.45.18 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="HFkY/XTf" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 84E731F000FF; Mon, 28 Sep 2026 12:45:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1790599509; bh=C3sJZ+XGR3q3cAZQbPWld8WHZgZ0nkcap7Eqc78EZkU=; h=From:To:Cc:Subject:Date; b=HFkY/XTfMCifhXjwEuMml2laM88hQq2yG6mC2TBW0X2ZA4bvgmAIY6QTBurCtix7y v7ttZrniLUv4AdjhBzDdxL6zTeRjO/OpxEHbCfYN6qpwBRPtm1CctmKYf1lgVqcO9W X6KSvvljjJdX6L5JalVZyQC5b1Mj0EJFuewM+BMdsU6BwvXCVdrFMF0xLi8zxIIPcd t/8rh/H3LF4DuPpc0ls6F0m+XWqM7RRZx0X1hb49cnBjjPsXiSnK1kegIHtopwgI36 oylS8mQ0usHDm8AH9RkEH47rLeIdon0pX5bVaULS1NvhiS2Kkk8KmPkGAw3hfnxR1/ EpFlOm2SzD+ew== From: "Rob Herring (Arm)" To: Vinod Koul , Frank Li , Krzysztof Kozlowski , Conor Dooley , Wei Xu Cc: dmaengine@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v2] dt-bindings: dma: Convert hisilicon,k3-dma-1.0 to DT schema Date: Mon, 28 Sep 2026 07:44:46 -0500 Message-ID: <20260928124448.3754740-1-robh@kernel.org> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Convert the hisilicon,k3-dma-1.0 binding to DT schema format. Add dma-channel-mask, dma-no-cci, dma-type and interrupt-names properties which were not documented. The "hisilicon,hisi-pcm-asp-dma-1.0" doesn't have clocks, so make it optional. Assisted-by: LLM Signed-off-by: Rob Herring (Arm) --- v2: - Fix example node name to 'dma-controller' --- .../bindings/dma/hisilicon,k3-dma-1.0.yaml | 87 +++++++++++++++++++ .../devicetree/bindings/dma/k3dma.txt | 47 ---------- 2 files changed, 87 insertions(+), 47 deletions(-) create mode 100644 Documentation/devicetree/bindings/dma/hisilicon,k3-dma-1.0.yaml delete mode 100644 Documentation/devicetree/bindings/dma/k3dma.txt diff --git a/Documentation/devicetree/bindings/dma/hisilicon,k3-dma-1.0.yaml b/Documentation/devicetree/bindings/dma/hisilicon,k3-dma-1.0.yaml new file mode 100644 index 000000000000..e60f2a572272 --- /dev/null +++ b/Documentation/devicetree/bindings/dma/hisilicon,k3-dma-1.0.yaml @@ -0,0 +1,87 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/dma/hisilicon,k3-dma-1.0.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Hisilicon K3 DMA controller + +maintainers: + - Wei Xu + +properties: + compatible: + items: + - enum: + - hisilicon,k3-dma-1.0 + - hisilicon,hisi-pcm-asp-dma-1.0 + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + + interrupts: + maxItems: 1 + + '#dma-cells': + const: 1 + + dma-channels: + description: Number of physical DMA channels supported. + maximum: 32 + + dma-requests: + description: Number of virtual DMA request lines supported. + maximum: 32 + + dma-channel-mask: + description: Bitmask of usable DMA channels. + + dma-no-cci: + type: boolean + description: DMA is not coherent with the CCI. + + dma-type: + $ref: /schemas/types.yaml#/definitions/string + description: SoC-specific DMA type name. + enum: + - hi3660_dma + - hi6220_dma + + interrupt-names: + maxItems: 1 + +required: + - compatible + - reg + - interrupts + - '#dma-cells' + - dma-channels + - dma-requests + +allOf: + - $ref: dma-controller.yaml# + - if: + properties: + compatible: + contains: + const: hisilicon,k3-dma-1.0 + then: + required: + - clocks + +additionalProperties: false + +examples: + - | + dma-controller@fcd02000 { + compatible = "hisilicon,k3-dma-1.0"; + reg = <0xfcd02000 0x1000>; + #dma-cells = <1>; + dma-channels = <16>; + dma-requests = <27>; + interrupts = <0 12 4>; + clocks = <&pclk>; + }; diff --git a/Documentation/devicetree/bindings/dma/k3dma.txt b/Documentation/devicetree/bindings/dma/k3dma.txt deleted file mode 100644 index 10a2f15b08a3..000000000000 --- a/Documentation/devicetree/bindings/dma/k3dma.txt +++ /dev/null @@ -1,47 +0,0 @@ -* Hisilicon K3 DMA controller - -See dma.txt first - -Required properties: -- compatible: Must be one of -- "hisilicon,k3-dma-1.0" -- "hisilicon,hisi-pcm-asp-dma-1.0" -- reg: Should contain DMA registers location and length. -- interrupts: Should contain one interrupt shared by all channel -- #dma-cells: see dma.txt, should be 1, para number -- dma-channels: physical channels supported -- dma-requests: virtual channels supported, each virtual channel - have specific request line -- clocks: clock required - -Example: - -Controller: - dma0: dma@fcd02000 { - compatible = "hisilicon,k3-dma-1.0"; - reg = <0xfcd02000 0x1000>; - #dma-cells = <1>; - dma-channels = <16>; - dma-requests = <27>; - interrupts = <0 12 4>; - clocks = <&pclk>; - }; - -Client: -Use specific request line passing from dmax -For example, i2c0 read channel request line is 18, while write channel use 19 - - i2c0: i2c@fcb08000 { - compatible = "snps,designware-i2c"; - dmas = <&dma0 18 /* read channel */ - &dma0 19>; /* write channel */ - dma-names = "rx", "tx"; - }; - - i2c1: i2c@fcb09000 { - compatible = "snps,designware-i2c"; - dmas = <&dma0 20 /* read channel */ - &dma0 21>; /* write channel */ - dma-names = "rx", "tx"; - }; - -- 2.53.0