Bindings/dma/nvidia,tegra210-adma.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/nvidia,tegra210-adma.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: NVIDIA Tegra Audio DMA (ADMA) controller
   8
   9 description: |
  10   The Tegra Audio DMA controller is used for transferring data
  11   between system memory and the Audio Processing Engine (APE).
  12
  13 maintainers:
  14   - Jon Hunter <jonathanh@nvidia.com>
  15
  16 allOf:
  17   - $ref: dma-controller.yaml#
  18
  19 properties:
  20   compatible:
  21     oneOf:
  22       - enum:
  23           - nvidia,tegra210-adma
  24           - nvidia,tegra186-adma
  25       - items:
  26           - enum:
  27               - nvidia,tegra234-adma
  28               - nvidia,tegra194-adma
  29           - const: nvidia,tegra186-adma
  30
  31   reg:
  32     maxItems: 1
  33
  34   interrupts:
  35     description: |
  36       Should contain all of the per-channel DMA interrupts in
  37       ascending order with respect to the DMA channel index.
  38     minItems: 1
  39     maxItems: 32
  40
  41   clocks:
  42     description: Must contain one entry for the ADMA module clock
  43     maxItems: 1
  44
  45   clock-names:
  46     const: d_audio
  47
  48   "#dma-cells":
  49     description: |
  50       The first cell denotes the receive/transmit request number and
  51       should be between 1 and the maximum number of requests supported.
  52       This value corresponds to the RX/TX_REQUEST_SELECT fields in the
  53       ADMA_CHn_CTRL register.
  54     const: 1
  55
  56   dma-channel-mask:
  57     maxItems: 1
  58
  59 required:
  60   - compatible
  61   - reg
  62   - interrupts
  63   - clocks
  64   - clock-names
  65
  66 additionalProperties: false
  67
  68 examples:
  69   - |
  70     #include <dt-bindings/interrupt-controller/arm-gic.h>
  71     #include<dt-bindings/clock/tegra210-car.h>
  72
  73     dma-controller@702e2000 {
  74         compatible = "nvidia,tegra210-adma";
  75         reg = <0x702e2000 0x2000>;
  76         interrupt-parent = <&tegra_agic>;
  77         interrupts = <GIC_SPI 24 IRQ_TYPE_LEVEL_HIGH>,
  78                      <GIC_SPI 25 IRQ_TYPE_LEVEL_HIGH>,
  79                      <GIC_SPI 26 IRQ_TYPE_LEVEL_HIGH>,
  80                      <GIC_SPI 27 IRQ_TYPE_LEVEL_HIGH>,
  81                      <GIC_SPI 28 IRQ_TYPE_LEVEL_HIGH>,
  82                      <GIC_SPI 29 IRQ_TYPE_LEVEL_HIGH>,
  83                      <GIC_SPI 30 IRQ_TYPE_LEVEL_HIGH>,
  84                      <GIC_SPI 31 IRQ_TYPE_LEVEL_HIGH>,
  85                      <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>,
  86                      <GIC_SPI 33 IRQ_TYPE_LEVEL_HIGH>,
  87                      <GIC_SPI 34 IRQ_TYPE_LEVEL_HIGH>,
  88                      <GIC_SPI 35 IRQ_TYPE_LEVEL_HIGH>,
  89                      <GIC_SPI 36 IRQ_TYPE_LEVEL_HIGH>,
  90                      <GIC_SPI 37 IRQ_TYPE_LEVEL_HIGH>,
  91                      <GIC_SPI 38 IRQ_TYPE_LEVEL_HIGH>,
  92                      <GIC_SPI 39 IRQ_TYPE_LEVEL_HIGH>,
  93                      <GIC_SPI 40 IRQ_TYPE_LEVEL_HIGH>,
  94                      <GIC_SPI 41 IRQ_TYPE_LEVEL_HIGH>,
  95                      <GIC_SPI 42 IRQ_TYPE_LEVEL_HIGH>,
  96                      <GIC_SPI 43 IRQ_TYPE_LEVEL_HIGH>,
  97                      <GIC_SPI 44 IRQ_TYPE_LEVEL_HIGH>,
  98                      <GIC_SPI 45 IRQ_TYPE_LEVEL_HIGH>;
  99         clocks = <&tegra_car TEGRA210_CLK_D_AUDIO>;
 100         clock-names = "d_audio";
 101         #dma-cells = <1>;
 102     };
 103
 104 ...