xref: /freebsd/sys/contrib/device-tree/Bindings/sound/samsung,odroid.yaml (revision ec0ea6efa1ad229d75c394c1a9b9cac33af2b1d3) 
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
7title: Samsung Exynos Odroid XU3/XU4 audio complex with MAX98090 codec
8
9maintainers:
10  - Krzysztof Kozlowski <krzk@kernel.org>
11  - Sylwester Nawrocki <s.nawrocki@samsung.com>
12
13properties:
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        $ref: /schemas/types.yaml#/definitions/phandle-array
41        description: phandles to the I2S controllers
42
43  codec:
44    type: object
45    properties:
46      sound-dai:
47        $ref: /schemas/types.yaml#/definitions/phandle-array
48        description: |
49          List of phandles to the CODEC nodes,
50          first entry must be corresponding to the MAX98090 CODEC and
51          the second entry must be the phandle of the HDMI IP block node.
52
53  samsung,audio-routing:
54    $ref: /schemas/types.yaml#/definitions/non-unique-string-array
55    description: |
56      List of the connections between audio
57      components;  each entry is a pair of strings, the first being the
58      connection's sink, the second being the connection's source;
59      valid names for sources and sinks are the MAX98090's pins (as
60      documented in its binding), and the jacks on the board.
61      For Odroid X2: "Headphone Jack", "Mic Jack", "DMIC"
62      For Odroid U3, XU3: "Headphone Jack", "Speakers"
63      For Odroid XU4: no entries
64
65  samsung,audio-widgets:
66    $ref: /schemas/types.yaml#/definitions/non-unique-string-array
67    description: |
68      This property specifies off-codec audio elements
69      like headphones or speakers, for details see widgets.txt
70
71required:
72  - compatible
73  - model
74  - cpu
75  - codec
76
77additionalProperties: false
78
79examples:
80  - |
81    sound {
82        compatible = "hardkernel,odroid-xu3-audio";
83        model = "Odroid-XU3";
84        samsung,audio-routing =
85                "Headphone Jack", "HPL",
86                "Headphone Jack", "HPR",
87                "IN1", "Mic Jack",
88                "Mic Jack", "MICBIAS";
89
90        cpu {
91            sound-dai = <&i2s0 0>;
92        };
93
94        codec {
95            sound-dai = <&hdmi>, <&max98090>;
96        };
97    };
98
99