GNU Linux-libre 6.1.90-gnu
[releases.git] / Documentation / devicetree / bindings / sound / nvidia,tegra210-mvc.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-mvc.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Tegra210 MVC
8
9 description: |
10   The Master Volume Control (MVC) provides gain or attenuation to a digital
11   signal path. It can be used in input or output signal path for per-stream
12   volume control or it can be used as master volume control. The MVC block
13   has one input and one output. The input digital stream can be mono or
14   multi-channel (up to 7.1 channels) stream. An independent mute control is
15   also included in the MVC block.
16
17 maintainers:
18   - Jon Hunter <jonathanh@nvidia.com>
19   - Mohan Kumar <mkumard@nvidia.com>
20   - Sameer Pujar <spujar@nvidia.com>
21
22 allOf:
23   - $ref: name-prefix.yaml#
24
25 properties:
26   $nodename:
27     pattern: "^mvc@[0-9a-f]*$"
28
29   compatible:
30     oneOf:
31       - const: nvidia,tegra210-mvc
32       - items:
33           - enum:
34               - nvidia,tegra234-mvc
35               - nvidia,tegra194-mvc
36               - nvidia,tegra186-mvc
37           - const: nvidia,tegra210-mvc
38
39   reg:
40     maxItems: 1
41
42   sound-name-prefix:
43     pattern: "^MVC[1-9]$"
44
45   ports:
46     $ref: /schemas/graph.yaml#/properties/ports
47     properties:
48       port@0:
49         $ref: audio-graph-port.yaml#
50         unevaluatedProperties: false
51         description: |
52           MVC ACIF (Audio Client Interface) input port. This is connected
53           to corresponding ACIF output port on AHUB (Audio Hub).
54
55       port@1:
56         $ref: audio-graph-port.yaml#
57         unevaluatedProperties: false
58         description: |
59           MVC ACIF output port. This is connected to corresponding ACIF
60           input port on AHUB.
61
62 required:
63   - compatible
64   - reg
65
66 additionalProperties: false
67
68 examples:
69   - |
70
71     mvc@702da000 {
72         compatible = "nvidia,tegra210-mvc";
73         reg = <0x702da000 0x200>;
74         sound-name-prefix = "MVC1";
75     };
76
77 ...