xref: /linux/Documentation/devicetree/bindings/sound/mediatek,mt8188-mt6359.yaml (revision cdd30ebb1b9f36159d66f088b61aee264e649d7a) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/mediatek,mt8188-mt6359.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MediaTek MT8188 ASoC sound card
8
9maintainers:
10  - Trevor Wu <trevor.wu@mediatek.com>
11
12allOf:
13  - $ref: sound-card-common.yaml#
14
15properties:
16  compatible:
17    enum:
18      - mediatek,mt8188-es8326
19      - mediatek,mt8188-mt6359-evb
20      - mediatek,mt8188-nau8825
21      - mediatek,mt8188-rt5682s
22
23  audio-routing:
24    description:
25      Valid names could be the input or output widgets of audio components,
26      power supplies, MicBias of codec and the software switch.
27
28  mediatek,platform:
29    $ref: /schemas/types.yaml#/definitions/phandle
30    description: The phandle of MT8188 ASoC platform.
31
32  mediatek,adsp:
33    $ref: /schemas/types.yaml#/definitions/phandle
34    description:
35      The phandle of the MT8188 ADSP platform, which is the optional Audio DSP
36      hardware that provides additional audio functionalities if present.
37      The AFE will link to ADSP when the phandle is provided.
38
39patternProperties:
40  "^dai-link-[0-9]+$":
41    type: object
42    description:
43      Container for dai-link level properties and CODEC sub-nodes.
44
45    properties:
46      link-name:
47        description:
48          This property corresponds to the name of the BE dai-link to which
49          we are going to update parameters in this node.
50        items:
51          enum:
52            - DPTX_BE
53            - ETDM1_IN_BE
54            - ETDM2_IN_BE
55            - ETDM1_OUT_BE
56            - ETDM2_OUT_BE
57            - ETDM3_OUT_BE
58            - PCM1_BE
59
60      codec:
61        description: Holds subnode which indicates codec dai.
62        type: object
63        additionalProperties: false
64        properties:
65          sound-dai:
66            minItems: 1
67            maxItems: 2
68        required:
69          - sound-dai
70
71      dai-format:
72        description: audio format.
73        items:
74          enum:
75            - i2s
76            - right_j
77            - left_j
78            - dsp_a
79            - dsp_b
80
81      mediatek,clk-provider:
82        $ref: /schemas/types.yaml#/definitions/string
83        description: Indicates dai-link clock master.
84        items:
85          enum:
86            - cpu
87            - codec
88
89    additionalProperties: false
90
91    required:
92      - link-name
93
94unevaluatedProperties: false
95
96required:
97  - compatible
98  - mediatek,platform
99
100examples:
101  - |
102    sound {
103        compatible = "mediatek,mt8188-mt6359-evb";
104        model = "MT6359-EVB";
105        mediatek,platform = <&afe>;
106        pinctrl-names = "default";
107        pinctrl-0 = <&aud_pins_default>;
108        audio-routing =
109            "Headphone", "Headphone L",
110            "Headphone", "Headphone R",
111            "AIN1", "Headset Mic";
112        dai-link-0 {
113            link-name = "ETDM3_OUT_BE";
114            dai-format = "i2s";
115            mediatek,clk-provider = "cpu";
116            codec {
117                sound-dai = <&hdmi0>;
118            };
119        };
120    };
121
122...
123