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