# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/sound/nvidia,tegra210-admaif.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Tegra210 ADMAIF

description: |
  ADMAIF is the interface between ADMA and AHUB. Each ADMA channel
  that sends/receives data to/from AHUB must interface through an
  ADMAIF channel. ADMA channel sending data to AHUB pairs with ADMAIF
  Tx channel and ADMA channel receiving data from AHUB pairs with
  ADMAIF Rx channel.

maintainers:
  - Jon Hunter <jonathanh@nvidia.com>
  - Sameer Pujar <spujar@nvidia.com>

properties:
  $nodename:
    pattern: "^admaif@[0-9a-f]*$"

  compatible:
    oneOf:
      - enum:
          - nvidia,tegra210-admaif
          - nvidia,tegra186-admaif
          - nvidia,tegra264-admaif
      - items:
          - enum:
              - nvidia,tegra234-admaif
              - nvidia,tegra194-admaif
          - const: nvidia,tegra186-admaif

  reg:
    maxItems: 1

  dmas: true

  dma-names: true

  interconnects:
    items:
      - description: APE read memory client
      - description: APE write memory client

  interconnect-names:
    items:
      - const: dma-mem # read
      - const: write

  iommus:
    maxItems: 1

  ports:
    $ref: /schemas/graph.yaml#/properties/ports
    description: |
      Contains list of ACIF (Audio CIF) port nodes for ADMAIF channels.
      The number of port nodes depends on the number of ADMAIF channels
      that SoC may have. These are interfaced with respective ACIF ports
      in AHUB (Audio Hub). Each port is capable of data transfers in
      both directions.

    patternProperties:
      '^port@[0-9]':
        $ref: audio-graph-port.yaml#
        unevaluatedProperties: false

allOf:
  - if:
      properties:
        compatible:
          contains:
            const: nvidia,tegra210-admaif
    then:
      properties:
        dmas:
          description:
            DMA channel specifiers, equally divided for Tx and Rx.
          minItems: 1
          maxItems: 20
        dma-names:
          items:
            pattern: "^[rt]x(10|[1-9])$"
          description:
            Should be "rx1", "rx2" ... "rx10" for DMA Rx channel
            Should be "tx1", "tx2" ... "tx10" for DMA Tx channel
          minItems: 1
          maxItems: 20
        interconnects: false
        interconnect-names: false
        iommus: false

  - if:
      properties:
        compatible:
          contains:
            const: nvidia,tegra186-admaif
    then:
      properties:
        dmas:
          description:
            DMA channel specifiers, equally divided for Tx and Rx.
          minItems: 1
          maxItems: 40
        dma-names:
          items:
            pattern: "^[rt]x(1[0-9]|[1-9]|20)$"
          description:
            Should be "rx1", "rx2" ... "rx20" for DMA Rx channel
            Should be "tx1", "tx2" ... "tx20" for DMA Tx channel
          minItems: 1
          maxItems: 40

  - if:
      properties:
        compatible:
          contains:
            const: nvidia,tegra264-admaif
    then:
      properties:
        dmas:
          description:
            DMA channel specifiers, equally divided for Tx and Rx.
          minItems: 1
          maxItems: 64
        dma-names:
          items:
            pattern: "^[rt]x(3[0-2]|[1-2][0-9]|[1-9])$"
          description:
            Should be "rx1", "rx2" ... "rx32" for DMA Rx channel
            Should be "tx1", "tx2" ... "tx32" for DMA Tx channel
          minItems: 1
          maxItems: 64

required:
  - compatible
  - reg
  - dmas
  - dma-names

additionalProperties: false

examples:
  - |
    admaif@702d0000 {
        compatible = "nvidia,tegra210-admaif";
        reg = <0x702d0000 0x800>;
        dmas = <&adma 1>,  <&adma 1>,
               <&adma 2>,  <&adma 2>,
               <&adma 3>,  <&adma 3>,
               <&adma 4>,  <&adma 4>,
               <&adma 5>,  <&adma 5>,
               <&adma 6>,  <&adma 6>,
               <&adma 7>,  <&adma 7>,
               <&adma 8>,  <&adma 8>,
               <&adma 9>,  <&adma 9>,
               <&adma 10>, <&adma 10>;
        dma-names = "rx1",  "tx1",
                    "rx2",  "tx2",
                    "rx3",  "tx3",
                    "rx4",  "tx4",
                    "rx5",  "tx5",
                    "rx6",  "tx6",
                    "rx7",  "tx7",
                    "rx8",  "tx8",
                    "rx9",  "tx9",
                    "rx10", "tx10";
    };

...