1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/dma/dma-common.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: DMA Engine Generic Binding
8
9maintainers:
10  - Vinod Koul <vkoul@kernel.org>
11
12description:
13  Generic binding to provide a way for a driver using DMA Engine to
14  retrieve the DMA request or channel information that goes from a
15  hardware device to a DMA controller.
16
17select: false
18
19properties:
20  "#dma-cells":
21    minimum: 1
22    # Should be enough
23    maximum: 255
24    description:
25      Used to provide DMA controller specific information.
26
27  dma-channel-mask:
28    description:
29      Bitmask of available DMA channels in ascending order that are
30      not reserved by firmware and are available to the
31      kernel. i.e. first channel corresponds to LSB.
32      The first item in the array is for channels 0-31, the second is for
33      channels 32-63, etc.
34    $ref: /schemas/types.yaml#/definitions/uint32-array
35    items:
36      minItems: 1
37      # Should be enough
38      maxItems: 255
39
40  dma-channels:
41    $ref: /schemas/types.yaml#/definitions/uint32
42    description:
43      Number of DMA channels supported by the controller.
44
45  dma-requests:
46    $ref: /schemas/types.yaml#/definitions/uint32
47    description:
48      Number of DMA request signals supported by the controller.
49
50required:
51  - "#dma-cells"
52
53additionalProperties: true
54