mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-09-03 17:51:23 +00:00

Firmware contants do not fit the purpose of bindings because they are not
independent IDs for abstractions. They are more or less just contants which
better to wire via header with DT which is using it.
That's why add deprecated message to dt binding header and also update
existing dt bindings not to use macros from the header and replace them by
it's value. Actually value is not relevant because it is only example.
The similar changes have been done by commit 9d92925768
("dt-bindings:
pinctrl: samsung: deprecate header with register constants").
Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Acked-by: Vinod Koul <vkoul@kernel.org>
Acked-by: Conor Dooley <conor.dooley@microchip.com>
Signed-off-by: Michal Simek <michal.simek@amd.com>
Link: https://lore.kernel.org/r/2a6f0229522327939e6893565e540b75f854a37b.1738600745.git.michal.simek@amd.com
90 lines
1.8 KiB
YAML
90 lines
1.8 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/dma/xilinx/xlnx,zynqmp-dma-1.0.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Xilinx ZynqMP DMA Engine
|
|
|
|
description: |
|
|
The Xilinx ZynqMP DMA engine supports memory to memory transfers,
|
|
memory to device and device to memory transfers. It also has flow
|
|
control and rate control support for slave/peripheral dma access.
|
|
|
|
maintainers:
|
|
- Michael Tretter <m.tretter@pengutronix.de>
|
|
- Harini Katakam <harini.katakam@amd.com>
|
|
- Radhey Shyam Pandey <radhey.shyam.pandey@amd.com>
|
|
|
|
allOf:
|
|
- $ref: ../dma-controller.yaml#
|
|
|
|
properties:
|
|
"#dma-cells":
|
|
const: 1
|
|
|
|
compatible:
|
|
enum:
|
|
- amd,versal2-dma-1.0
|
|
- xlnx,zynqmp-dma-1.0
|
|
|
|
reg:
|
|
description: memory map for gdma/adma module access
|
|
maxItems: 1
|
|
|
|
interrupts:
|
|
description: DMA channel interrupt
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
description: input clocks
|
|
minItems: 2
|
|
maxItems: 2
|
|
|
|
clock-names:
|
|
items:
|
|
- const: clk_main
|
|
- const: clk_apb
|
|
|
|
xlnx,bus-width:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum:
|
|
- 64
|
|
- 128
|
|
description: AXI bus width in bits
|
|
|
|
iommus:
|
|
maxItems: 1
|
|
|
|
power-domains:
|
|
maxItems: 1
|
|
|
|
dma-coherent:
|
|
description: present if dma operations are coherent
|
|
|
|
required:
|
|
- "#dma-cells"
|
|
- compatible
|
|
- reg
|
|
- interrupts
|
|
- clocks
|
|
- clock-names
|
|
- xlnx,bus-width
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
|
|
fpd_dma_chan1: dma-controller@fd500000 {
|
|
compatible = "xlnx,zynqmp-dma-1.0";
|
|
reg = <0xfd500000 0x1000>;
|
|
interrupt-parent = <&gic>;
|
|
interrupts = <0 117 0x4>;
|
|
#dma-cells = <1>;
|
|
clock-names = "clk_main", "clk_apb";
|
|
clocks = <&zynqmp_clk 19>, <&zynqmp_clk 31>;
|
|
xlnx,bus-width = <128>;
|
|
dma-coherent;
|
|
};
|