GNU Linux-libre 6.1.90-gnu
[releases.git] / Documentation / devicetree / bindings / sound / samsung,odroid.yaml
1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/sound/samsung,odroid.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Samsung Exynos Odroid XU3/XU4 audio complex with MAX98090 codec
8
9 maintainers:
10   - Krzysztof Kozlowski <krzk@kernel.org>
11   - Sylwester Nawrocki <s.nawrocki@samsung.com>
12
13 properties:
14   compatible:
15     oneOf:
16       - const: hardkernel,odroid-xu3-audio
17
18       - const: hardkernel,odroid-xu4-audio
19         deprecated: true
20
21       - const: samsung,odroid-xu3-audio
22         deprecated: true
23
24       - const: samsung,odroid-xu4-audio
25         deprecated: true
26
27   model:
28     $ref: /schemas/types.yaml#/definitions/string
29     description: The user-visible name of this sound complex.
30
31   assigned-clock-parents: true
32   assigned-clock-rates: true
33   assigned-clocks: true
34   clocks: true
35
36   cpu:
37     type: object
38     properties:
39       sound-dai:
40         description: phandles to the I2S controllers
41
42   codec:
43     type: object
44     properties:
45       sound-dai:
46         items:
47           - description: phandle of the MAX98090 CODEC
48           - description: phandle of the HDMI IP block node
49
50   samsung,audio-routing:
51     $ref: /schemas/types.yaml#/definitions/non-unique-string-array
52     description: |
53       List of the connections between audio
54       components;  each entry is a pair of strings, the first being the
55       connection's sink, the second being the connection's source;
56       valid names for sources and sinks are the MAX98090's pins (as
57       documented in its binding), and the jacks on the board.
58       For Odroid X2: "Headphone Jack", "Mic Jack", "DMIC"
59       For Odroid U3, XU3: "Headphone Jack", "Speakers"
60       For Odroid XU4: no entries
61
62   samsung,audio-widgets:
63     $ref: /schemas/types.yaml#/definitions/non-unique-string-array
64     description: |
65       This property specifies off-codec audio elements
66       like headphones or speakers, for details see widgets.txt
67
68 required:
69   - compatible
70   - model
71   - cpu
72   - codec
73
74 additionalProperties: false
75
76 examples:
77   - |
78     sound {
79         compatible = "hardkernel,odroid-xu3-audio";
80         model = "Odroid-XU3";
81         samsung,audio-routing =
82                 "Headphone Jack", "HPL",
83                 "Headphone Jack", "HPR",
84                 "IN1", "Mic Jack",
85                 "Mic Jack", "MICBIAS";
86
87         cpu {
88             sound-dai = <&i2s0 0>;
89         };
90
91         codec {
92             sound-dai = <&hdmi>, <&max98090>;
93         };
94     };