From nobody Sun Jul 26 02:46:34 2026 Received: from mail-pj1-f47.google.com (mail-pj1-f47.google.com [209.85.216.47]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 913693890E4 for ; Wed, 8 Jul 2026 16:32:42 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.47 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1783528364; cv=none; b=thWOm63LLEYAykO6ho2ZdIie9wigpPgu/fNTAbO4Nq0mzcrkXJBggZJs830z+HpuLBEMI78p+63WH03kpGUwV5vGAMsBjPrSYT1sYZ7v4/awIFf1sZZilnCoNc2lavfcsXJkAuQkIqVYCafDCG7VK8vgK78ge9A2FnDlRxxiq7s= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1783528364; c=relaxed/simple; bh=VtZM2qD7Un0eQm+y6xnch5aCljKPdhMYWFqn+0laie0=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:To:Cc; b=Ybd5qeEyvhd/7Ndlg7f86FciXRPxa4whnkPe3h1iGUf09A7oEsbSryDezuu8VQStqXA3mHLONRGqgW/1d2uLa0VKusk3v2pgecs8ChTQxEGIkHrT/26jfOTne1vWvWm4O2eN4mqGhqsagZldRwYGiOT33LhJz6WtwzA+6U0xVoU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=fpCgxJWK; arc=none smtp.client-ip=209.85.216.47 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="fpCgxJWK" Received: by mail-pj1-f47.google.com with SMTP id 98e67ed59e1d1-38115bbb83dso111008a91.3 for ; Wed, 08 Jul 2026 09:32:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1783528362; x=1784133162; darn=vger.kernel.org; h=cc:to:message-id:content-transfer-encoding:content-type :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to:content-type; bh=fWuQ0mPWMJpAyjf5/+TbvMYXq9kqNgTMYENPSWW7pBg=; b=fpCgxJWKr2ROqzfv670bIti+IRxSqUIqBctdhnR7nL/BrFdmOcZhZwuNK4TwrDzlc1 ZU2kQjIXsMla+3hOtmL8FflDI/8lA3t76Pue7WHyoZyY5QYPvEscoDC98f24GioP3IWs PKf7wJh4gPVbcxJG76j6wadCXjAu85O0eiEzZ5VmeeaDzNUPVQwp2rJzGmoMix9r4ECD FBIGrjjcmzKUfXCuP3WQQybme5XUHTU0KNV0eBIICMVvmCIWeh9nTqyPkiAvvF72FyxN kO8BW4qIU0IxFlbYPMafWcfNQTdvgsV+8mCr5NNp8/G+jYad8eV8w70pRzVtWup96Cv6 CU6g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1783528362; x=1784133162; h=cc:to:message-id:content-transfer-encoding:content-type :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to:content-type; bh=fWuQ0mPWMJpAyjf5/+TbvMYXq9kqNgTMYENPSWW7pBg=; b=Bv+y6gqSYQ6nOJZHw+TX3EoMy2WivbIAo2Ab270dfcNY5UjWII4LlD96N2uwi4bFfR 4RisG2IwRIlNAOQJ1e6dfq3oPFxzSyDdixS4M2GFFRA6GBJ+/cqpo0Gvoy1MQ2EOY20e 5c8AAJudjV43n9jFJxvti+nbF3hvvY+nq5z+TByu8+LcrN111IdZkQctknEJm1U5SsyU MVAR4JvlmjrexNYBNYGE50A1Mmp3kmlmIWgN8P4NSR+MkKAlOubmFQEgN3tqznYyZPCI fiL7HsREUj6PQ9Lo8ec67ul4cd82+4sqvxKssAIFX0OX5AK60W/yfDYfmsNAFD28lhVr odbA== X-Forwarded-Encrypted: i=1; AHgh+Ro/RdqhYcBDu+LUtgGH611CsOtB3pmQqA6tzINqoHQrSygIS250umHGo0ad2qEZtn/qSVwSQc/rQ+HDAmQ=@vger.kernel.org X-Gm-Message-State: AOJu0YyFtryQR4dgAPWAMq9JMLDeRzuBU6Im8/cxr8ml7WsyYsB3CI4d WNA0/HFHeIZyZ9keitFQfQTBxhXJpbRpSv2Qyj8Wb0tEpBcXDoeFWuMJ X-Gm-Gg: AfdE7ck/2O5nLVXR7y5rC6Xe03xc6gxGzDkbMw7vWz4hXQPo1YDSGLYkBP5A995dTwC kpYM7brGwVqB1O6OOrnz9SWXryYEkj2JviCvzXlTvh575L8jJX1kRvKKVM8R2NCxp/aTT+4VUnh 7+YfQq5Ft+hhf76ov9yMcITQbCA9v9BQnSpXDUWMfRq3WJAZjCGKWX2i6ePxEqYwo+gy2Zsnl0b 4Dk/OlzrwZt0pbxX4dbyDufQOuDh8hnbIhjx8nDZt89Bj00YefLgcmyKU2AH7F2U2FfgB8l93fM uPlKailBVbvTDTEslY04OSTxAvDDLf3kGAj81NcqURU7d7iK7RHdEBLiBCV/+9f5JkX6m86lZvi Mx6QuJiqGcMX6/v/BlqmLM/AcA+2COmtI9T7q4kfJ5ctLL6acjVcZKlUHtVylAq10MeZeLhixsA SQE+oJd/sRoZCTXykx0R8eIg== X-Received: by 2002:a17:90b:3502:b0:380:7688:fc06 with SMTP id 98e67ed59e1d1-38a21af6569mr199889a91.8.1783528361810; Wed, 08 Jul 2026 09:32:41 -0700 (PDT) Received: from [192.168.1.2] ([2401:4900:881c:f765:f05c:d31e:8ae0:b06d]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-31174a8f521sm21334679eec.22.2026.07.08.09.32.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 08 Jul 2026 09:32:41 -0700 (PDT) From: Bhargav Joshi Date: Wed, 08 Jul 2026 22:02:18 +0530 Subject: [PATCH v2] dt-bindings: dma: ti,dma-crossbar: Convert to DT schema Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260708-ti-dma-crossbar-v2-1-2ac0d6efde36@gmail.com> X-B4-Tracking: v=1; b=H4sIAAAAAAAC/3WNyw6CMBBFf4XM2jFtxVJc+R+GRe0DJhFKWtJoS P/dyt7lOck9d4fkIrkEt2aH6DIlCksFcWrATHoZHZKtDIIJyTqmcCO0s0YTQ0pPHVE71XJurrZ XAupqjc7T+yg+hsoTpS3Ez3GQ+c/+b2WOHL0UXS9boTy/3MdZ0+tswgxDKeULecmDJ64AAAA= X-Change-ID: 20260708-ti-dma-crossbar-ae8411c5d982 To: Vinod Koul , Frank Li , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Vignesh Raghavendra , Peter Ujfalusi Cc: dmaengine@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, goledhruva@gmail.com, m-chawdhry@ti.com, daniel.baluta@gmail.com, simona.toaca@nxp.com, j.bhargav.u@gmail.com X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1783528356; l=7311; i=j.bhargav.u@gmail.com; h=from:subject:message-id; bh=VtZM2qD7Un0eQm+y6xnch5aCljKPdhMYWFqn+0laie0=; b=8UUVG/V7m8IFQrOl0+Czl3uNXOfTfrrryplL13fs8AJOXUF7Ax34fabmQJKV+LqcpqDSIYrRY f6BvLJU/Ni/C6zeDtxaLninKrrlVYV50kicVUaNZbqfIq/mcpAX2jt2 X-Developer-Key: i=j.bhargav.u@gmail.com; a=ed25519; pk=IqNDwUZKECEA+n8wXctFLBbYL9NhFstZNbOznm/nX1k= Convert Texas Instruments DMA Crossbar from text to DT schema. Modify MAINTAINERS file to correctly point to new yaml file. Signed-off-by: Bhargav Joshi --- Changes in v2: - Removed the unmatched `ti,omap4430-sdma` compatible string from the example block and trim down example - Restored dropped documentation regarding client dma-cells configuration into the top-level description block. - Updated the MAINTAINERS file to replace the old .txt reference with the new .yaml file path. - Added constraints on its inner tuple dimensions of ti,reserved-dma-request-ranges - Link to v1: https://lore.kernel.org/r/20260708-ti-dma-crossbar-v1-1-f6279= 6428f13@gmail.com --- .../bindings/dma/ti,dra7-dma-crossbar.yaml | 89 ++++++++++++++++++= ++++ .../devicetree/bindings/dma/ti-dma-crossbar.txt | 68 ----------------- MAINTAINERS | 2 +- 3 files changed, 90 insertions(+), 69 deletions(-) diff --git a/Documentation/devicetree/bindings/dma/ti,dra7-dma-crossbar.yam= l b/Documentation/devicetree/bindings/dma/ti,dra7-dma-crossbar.yaml new file mode 100644 index 000000000000..3de4f53797d5 --- /dev/null +++ b/Documentation/devicetree/bindings/dma/ti,dra7-dma-crossbar.yaml @@ -0,0 +1,89 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/dma/ti,dra7-dma-crossbar.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments DMA Crossbar (DMA request router) + +maintainers: + - Vignesh Raghavendra + - Bhargav Joshi + +description: + When requesting channel via ti,dra7-dma-crossbar, the DMA client must re= quest + the DMA event number as crossbar ID (input to the DMA crossbar). For + ti,am335x-edma-crossbar the meaning of parameters of dmas for clients dm= as =3D + <&edma_xbar 12 0 1>; where <12> is the DMA request number, <0> is the TC= the + event should be assigned and <1> is the mux selection for in the crossba= r. + When mux 0 is used the DMA channel can be requested directly from edma n= ode. + +properties: + compatible: + enum: + - ti,dra7-dma-crossbar + - ti,am335x-edma-crossbar + + reg: + maxItems: 1 + + "#dma-cells": + minimum: 1 + maximum: 3 + + dma-requests: + minimum: 1 + maximum: 256 + + dma-masters: + maxItems: 1 + + ti,dma-safe-map: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Safe routing value for unused request lines + + ti,reserved-dma-request-ranges: + $ref: /schemas/types.yaml#/definitions/uint32-matrix + description: + DMA request ranges which should not be used when mapping xbar input = to + DMA request, they are either allocated to be used by for example the= DSP + or they are used as memcpy channels in eDMA. + items: + items: + - description: starting DMA request line number + - description: number of consecutive lines to reserve + +required: + - compatible + - reg + - "#dma-cells" + - dma-requests + - dma-masters + +allOf: + - $ref: dma-router.yaml# + + - if: + properties: + compatible: + contains: + const: ti,am335x-edma-crossbar + then: + properties: + "#dma-cells": + const: 3 + +unevaluatedProperties: false + +examples: + - | + dma-router@4a002b78 { + compatible =3D "ti,dra7-dma-crossbar"; + reg =3D <0x4a002b78 0xfc>; + #dma-cells =3D <1>; + dma-requests =3D <205>; + ti,dma-safe-map =3D <0>; + /* Protect the sDMA request ranges: 10-14 and 100-126 */ + ti,reserved-dma-request-ranges =3D <10 5>, <100 27>; + dma-masters =3D <&sdma>; + }; diff --git a/Documentation/devicetree/bindings/dma/ti-dma-crossbar.txt b/Do= cumentation/devicetree/bindings/dma/ti-dma-crossbar.txt deleted file mode 100644 index 1f9831540c97..000000000000 --- a/Documentation/devicetree/bindings/dma/ti-dma-crossbar.txt +++ /dev/null @@ -1,68 +0,0 @@ -Texas Instruments DMA Crossbar (DMA request router) - -Required properties: -- compatible: "ti,dra7-dma-crossbar" for DRA7xx DMA crossbar - "ti,am335x-edma-crossbar" for AM335x and AM437x -- reg: Memory map for accessing module -- #dma-cells: Should be set to match with the DMA controller's dma-cells - for ti,dra7-dma-crossbar and <3> for ti,am335x-edma-crossbar. -- dma-requests: Number of DMA requests the crossbar can receive -- dma-masters: phandle pointing to the DMA controller - -The DMA controller node need to have the following poroperties: -- dma-requests: Number of DMA requests the controller can handle - -Optional properties: -- ti,dma-safe-map: Safe routing value for unused request lines -- ti,reserved-dma-request-ranges: DMA request ranges which should not be u= sed - when mapping xbar input to DMA request, they are either - allocated to be used by for example the DSP or they are used as - memcpy channels in eDMA. - -Notes: -When requesting channel via ti,dra7-dma-crossbar, the DMA client must requ= est -the DMA event number as crossbar ID (input to the DMA crossbar). - -For ti,am335x-edma-crossbar: the meaning of parameters of dmas for clients: -dmas =3D <&edma_xbar 12 0 1>; where <12> is the DMA request number, <0> is= the TC -the event should be assigned and <1> is the mux selection for in the cross= bar. -When mux 0 is used the DMA channel can be requested directly from edma nod= e. - -Example: - -/* DMA controller */ -sdma: dma-controller@4a056000 { - compatible =3D "ti,omap4430-sdma"; - reg =3D <0x4a056000 0x1000>; - interrupts =3D , - , - , - ; - #dma-cells =3D <1>; - dma-channels =3D <32>; - dma-requests =3D <127>; -}; - -/* DMA crossbar */ -sdma_xbar: dma-router@4a002b78 { - compatible =3D "ti,dra7-dma-crossbar"; - reg =3D <0x4a002b78 0xfc>; - #dma-cells =3D <1>; - dma-requests =3D <205>; - ti,dma-safe-map =3D <0>; - /* Protect the sDMA request ranges: 10-14 and 100-126 */ - ti,reserved-dma-request-ranges =3D <10 5>, <100 27>; - dma-masters =3D <&sdma>; -}; - -/* DMA client */ -uart1: serial@4806a000 { - compatible =3D "ti,omap4-uart"; - reg =3D <0x4806a000 0x100>; - interrupts-extended =3D <&gic GIC_SPI 67 IRQ_TYPE_LEVEL_HIGH>; - ti,hwmods =3D "uart1"; - clock-frequency =3D <48000000>; - /* Requesting crossbar input 49 and 50 */ - dmas =3D <&sdma_xbar 49>, <&sdma_xbar 50>; - dma-names =3D "tx", "rx"; -}; diff --git a/MAINTAINERS b/MAINTAINERS index f37a81950e25..a4b39e0dc178 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -26710,7 +26710,7 @@ TEXAS INSTRUMENTS DMA DRIVERS M: Vignesh Raghavendra L: dmaengine@vger.kernel.org S: Maintained -F: Documentation/devicetree/bindings/dma/ti-dma-crossbar.txt +F: Documentation/devicetree/bindings/dma/ti,dra7-dma-crossbar.yaml F: Documentation/devicetree/bindings/dma/ti-edma.txt F: Documentation/devicetree/bindings/dma/ti/ F: drivers/dma/ti/ --- base-commit: 0e35b9b6ec0ffcc5e23cbdec09f5c622ad532b53 change-id: 20260708-ti-dma-crossbar-ae8411c5d982 Best regards, --=20 Bhargav