Documentation/devicetree/bindings/sound/nvidia,tegra210-ahub.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/sound/nvidia,tegra210-ahub.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Tegra210 AHUB
   8
   9 description: |
  10   The Audio Hub (AHUB) comprises a collection of hardware accelerators
  11   for audio pre-processing, post-processing and a programmable full
  12   crossbar for routing audio data across these accelerators. It has
  13   external interfaces such as I2S, DMIC, DSPK. It interfaces with ADMA
  14   engine through ADMAIF.
  15
  16 maintainers:
  17   - Jon Hunter <jonathanh@nvidia.com>
  18   - Sameer Pujar <spujar@nvidia.com>
  19
  20 properties:
  21   $nodename:
  22     pattern: "^ahub@[0-9a-f]*$"
  23
  24   compatible:
  25     oneOf:
  26       - enum:
  27           - nvidia,tegra210-ahub
  28           - nvidia,tegra186-ahub
  29           - nvidia,tegra234-ahub
  30       - items:
  31           - const: nvidia,tegra194-ahub
  32           - const: nvidia,tegra186-ahub
  33
  34   reg:
  35     maxItems: 1
  36
  37   clocks:
  38     maxItems: 1
  39
  40   clock-names:
  41     const: ahub
  42
  43   assigned-clocks:
  44     maxItems: 1
  45
  46   assigned-clock-parents:
  47     maxItems: 1
  48
  49   assigned-clock-rates:
  50     maxItems: 1
  51
  52   "#address-cells":
  53     enum: [ 1, 2 ]
  54
  55   "#size-cells":
  56     enum: [ 1, 2 ]
  57
  58   ranges: true
  59
  60   ports:
  61     $ref: /schemas/graph.yaml#/properties/ports
  62     description: |
  63       Contains list of ACIF (Audio CIF) port nodes for AHUB (Audio Hub).
  64       These are connected to ACIF interfaces of AHUB clients. Thus the
  65       number of port nodes depend on the number of clients that AHUB may
  66       have depending on the SoC revision.
  67
  68     patternProperties:
  69       '^port@[0-9]':
  70         $ref: audio-graph-port.yaml#
  71         unevaluatedProperties: false
  72
  73 patternProperties:
  74   '^i2s@[0-9a-f]+$':
  75     type: object
  76
  77   '^dmic@[0-9a-f]+$':
  78     type: object
  79     $ref: nvidia,tegra210-dmic.yaml#
  80
  81   '^admaif@[0-9a-f]+$':
  82     type: object
  83     $ref: nvidia,tegra210-admaif.yaml#
  84
  85   '^dspk@[0-9a-f]+$':
  86     type: object
  87     $ref: nvidia,tegra186-dspk.yaml#
  88
  89   '^mvc@[0-9a-f]+$':
  90     type: object
  91     $ref: nvidia,tegra210-mvc.yaml#
  92
  93   '^sfc@[0-9a-f]+$':
  94     type: object
  95     $ref: nvidia,tegra210-sfc.yaml#
  96
  97   '^amx@[0-9a-f]+$':
  98     type: object
  99     $ref: nvidia,tegra210-amx.yaml#
 100
 101   '^adx@[0-9a-f]+$':
 102     type: object
 103     $ref: nvidia,tegra210-adx.yaml#
 104
 105   '^amixer@[0-9a-f]+$':
 106     type: object
 107     $ref: nvidia,tegra210-mixer.yaml#
 108
 109   '^asrc@[0-9a-f]+$':
 110     type: object
 111     $ref: nvidia,tegra186-asrc.yaml#
 112
 113   '^processing-engine@[0-9a-f]+$':
 114     type: object
 115     $ref: nvidia,tegra210-ope.yaml#
 116
 117 required:
 118   - compatible
 119   - reg
 120   - clocks
 121   - clock-names
 122   - assigned-clocks
 123   - assigned-clock-parents
 124   - "#address-cells"
 125   - "#size-cells"
 126   - ranges
 127
 128 additionalProperties: false
 129
 130 examples:
 131   - |
 132     #include<dt-bindings/clock/tegra210-car.h>
 133
 134     ahub@702d0800 {
 135         compatible = "nvidia,tegra210-ahub";
 136         reg = <0x702d0800 0x800>;
 137         clocks = <&tegra_car TEGRA210_CLK_D_AUDIO>;
 138         clock-names = "ahub";
 139         assigned-clocks = <&tegra_car TEGRA210_CLK_D_AUDIO>;
 140         assigned-clock-parents = <&tegra_car TEGRA210_CLK_PLL_A_OUT0>;
 141         #address-cells = <1>;
 142         #size-cells = <1>;
 143         ranges = <0x702d0000 0x702d0000 0x0000e400>;
 144
 145         // All AHUB child nodes below
 146         admaif@702d0000 {
 147             compatible = "nvidia,tegra210-admaif";
 148             reg = <0x702d0000 0x800>;
 149             dmas = <&adma 1>,  <&adma 1>,
 150                <&adma 2>,  <&adma 2>,
 151                <&adma 3>,  <&adma 3>,
 152                <&adma 4>,  <&adma 4>,
 153                <&adma 5>,  <&adma 5>,
 154                <&adma 6>,  <&adma 6>,
 155                <&adma 7>,  <&adma 7>,
 156                <&adma 8>,  <&adma 8>,
 157                <&adma 9>,  <&adma 9>,
 158                <&adma 10>, <&adma 10>;
 159             dma-names = "rx1",  "tx1",
 160                     "rx2",  "tx2",
 161                     "rx3",  "tx3",
 162                     "rx4",  "tx4",
 163                     "rx5",  "tx5",
 164                     "rx6",  "tx6",
 165                     "rx7",  "tx7",
 166                     "rx8",  "tx8",
 167                     "rx9",  "tx9",
 168                     "rx10", "tx10";
 169         };
 170
 171         i2s@702d1000 {
 172             compatible = "nvidia,tegra210-i2s";
 173             reg = <0x702d1000 0x100>;
 174             clocks = <&tegra_car TEGRA210_CLK_I2S0>;
 175             clock-names = "i2s";
 176             assigned-clocks = <&tegra_car TEGRA210_CLK_I2S0>;
 177             assigned-clock-parents = <&tegra_car TEGRA210_CLK_PLL_A_OUT0>;
 178             assigned-clock-rates = <1536000>;
 179             sound-name-prefix = "I2S1";
 180         };
 181
 182         dmic@702d4000 {
 183             compatible = "nvidia,tegra210-dmic";
 184             reg = <0x702d4000 0x100>;
 185             clocks = <&tegra_car TEGRA210_CLK_DMIC1>;
 186             clock-names = "dmic";
 187             assigned-clocks = <&tegra_car TEGRA210_CLK_DMIC1>;
 188             assigned-clock-parents = <&tegra_car TEGRA210_CLK_PLL_A_OUT0>;
 189             assigned-clock-rates = <3072000>;
 190             sound-name-prefix = "DMIC1";
 191         };
 192
 193         // More child nodes to follow
 194     };
 195
 196 ...