Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: dma: Convert apm,xgene-storm-dma to DT schema

Convert APM X-Gene Storm DMA binding to DT schema format. It's a
straight-forward conversion.

Link: https://patch.msgid.link/20251013213037.684981-1-robh@kernel.org
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>

+59 -47
+59
Documentation/devicetree/bindings/dma/apm,xgene-storm-dma.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/dma/apm,xgene-storm-dma.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: APM X-Gene Storm SoC DMA 8 + 9 + maintainers: 10 + - Khuong Dinh <khuong@os.amperecomputing.com> 11 + 12 + properties: 13 + compatible: 14 + const: apm,xgene-storm-dma 15 + 16 + reg: 17 + items: 18 + - description: DMA control and status registers 19 + - description: Descriptor ring control and status registers 20 + - description: Descriptor ring command registers 21 + - description: SoC efuse registers 22 + 23 + interrupts: 24 + items: 25 + - description: DMA error reporting interrupt 26 + - description: DMA channel 0 completion interrupt 27 + - description: DMA channel 1 completion interrupt 28 + - description: DMA channel 2 completion interrupt 29 + - description: DMA channel 3 completion interrupt 30 + 31 + clocks: 32 + maxItems: 1 33 + 34 + dma-coherent: true 35 + 36 + required: 37 + - compatible 38 + - reg 39 + - interrupts 40 + - clocks 41 + 42 + additionalProperties: false 43 + 44 + examples: 45 + - | 46 + dma@1f270000 { 47 + compatible = "apm,xgene-storm-dma"; 48 + reg = <0x1f270000 0x10000>, 49 + <0x1f200000 0x10000>, 50 + <0x1b000000 0x400000>, 51 + <0x1054a000 0x100>; 52 + interrupts = <0x0 0x82 0x4>, 53 + <0x0 0xb8 0x4>, 54 + <0x0 0xb9 0x4>, 55 + <0x0 0xba 0x4>, 56 + <0x0 0xbb 0x4>; 57 + dma-coherent; 58 + clocks = <&dmaclk 0>; 59 + };
-47
Documentation/devicetree/bindings/dma/apm-xgene-dma.txt
··· 1 - Applied Micro X-Gene SoC DMA nodes 2 - 3 - DMA nodes are defined to describe on-chip DMA interfaces in 4 - APM X-Gene SoC. 5 - 6 - Required properties for DMA interfaces: 7 - - compatible: Should be "apm,xgene-dma". 8 - - device_type: set to "dma". 9 - - reg: Address and length of the register set for the device. 10 - It contains the information of registers in the following order: 11 - 1st - DMA control and status register address space. 12 - 2nd - Descriptor ring control and status register address space. 13 - 3rd - Descriptor ring command register address space. 14 - 4th - Soc efuse register address space. 15 - - interrupts: DMA has 5 interrupts sources. 1st interrupt is 16 - DMA error reporting interrupt. 2nd, 3rd, 4th and 5th interrupts 17 - are completion interrupts for each DMA channels. 18 - - clocks: Reference to the clock entry. 19 - 20 - Optional properties: 21 - - dma-coherent : Present if dma operations are coherent 22 - 23 - Example: 24 - dmaclk: dmaclk@1f27c000 { 25 - compatible = "apm,xgene-device-clock"; 26 - #clock-cells = <1>; 27 - clocks = <&socplldiv2 0>; 28 - reg = <0x0 0x1f27c000 0x0 0x1000>; 29 - reg-names = "csr-reg"; 30 - clock-output-names = "dmaclk"; 31 - }; 32 - 33 - dma: dma@1f270000 { 34 - compatible = "apm,xgene-storm-dma"; 35 - device_type = "dma"; 36 - reg = <0x0 0x1f270000 0x0 0x10000>, 37 - <0x0 0x1f200000 0x0 0x10000>, 38 - <0x0 0x1b000000 0x0 0x400000>, 39 - <0x0 0x1054a000 0x0 0x100>; 40 - interrupts = <0x0 0x82 0x4>, 41 - <0x0 0xb8 0x4>, 42 - <0x0 0xb9 0x4>, 43 - <0x0 0xba 0x4>, 44 - <0x0 0xbb 0x4>; 45 - dma-coherent; 46 - clocks = <&dmaclk 0>; 47 - };