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

dt-bindings: dma: mv-xor-v2: Convert to dtschema

Convert txt bindings of Marvell XOR v2 engines to dtschema to allow
for validation.

Also add missing property `dma-coherent` as `drivers/dma/mv_xor_v2.c`
calls various dma-coherent memory functions.

Signed-off-by: Shresth Prasad <shresthprasad7@gmail.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20240723095518.9364-2-shresthprasad7@gmail.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>

authored by

Shresth Prasad and committed by
Vinod Koul
31c70e0b 7492b2f8

+61 -28
+61
Documentation/devicetree/bindings/dma/marvell,xor-v2.yaml
··· 1 + # SPDX-License-Identifier: GPL-2.0 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/dma/marvell,xor-v2.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Marvell XOR v2 engines 8 + 9 + maintainers: 10 + - Andrew Lunn <andrew@lunn.ch> 11 + 12 + properties: 13 + compatible: 14 + oneOf: 15 + - const: marvell,xor-v2 16 + - items: 17 + - enum: 18 + - marvell,armada-7k-xor 19 + - const: marvell,xor-v2 20 + 21 + reg: 22 + items: 23 + - description: DMA registers 24 + - description: global registers 25 + 26 + clocks: 27 + minItems: 1 28 + maxItems: 2 29 + 30 + clock-names: 31 + minItems: 1 32 + items: 33 + - const: core 34 + - const: reg 35 + 36 + msi-parent: 37 + description: 38 + Phandle to the MSI-capable interrupt controller used for 39 + interrupts. 40 + maxItems: 1 41 + 42 + dma-coherent: true 43 + 44 + required: 45 + - compatible 46 + - reg 47 + - msi-parent 48 + - dma-coherent 49 + 50 + additionalProperties: false 51 + 52 + examples: 53 + - | 54 + xor0@6a0000 { 55 + compatible = "marvell,armada-7k-xor", "marvell,xor-v2"; 56 + reg = <0x6a0000 0x1000>, <0x6b0000 0x1000>; 57 + clocks = <&ap_clk 0>, <&ap_clk 1>; 58 + clock-names = "core", "reg"; 59 + msi-parent = <&gic_v2m0>; 60 + dma-coherent; 61 + };
-28
Documentation/devicetree/bindings/dma/mv-xor-v2.txt
··· 1 - * Marvell XOR v2 engines 2 - 3 - Required properties: 4 - - compatible: one of the following values: 5 - "marvell,armada-7k-xor" 6 - "marvell,xor-v2" 7 - - reg: Should contain registers location and length (two sets) 8 - the first set is the DMA registers 9 - the second set is the global registers 10 - - msi-parent: Phandle to the MSI-capable interrupt controller used for 11 - interrupts. 12 - 13 - Optional properties: 14 - - clocks: Optional reference to the clocks used by the XOR engine. 15 - - clock-names: mandatory if there is a second clock, in this case the 16 - name must be "core" for the first clock and "reg" for the second 17 - one 18 - 19 - 20 - Example: 21 - 22 - xor0@400000 { 23 - compatible = "marvell,xor-v2"; 24 - reg = <0x400000 0x1000>, 25 - <0x410000 0x1000>; 26 - msi-parent = <&gic_v2m0>; 27 - dma-coherent; 28 - };