xref: /freebsd/sys/contrib/device-tree/Bindings/sound/samsung,odroid.yaml (revision fac71e4e09885bb2afa3d984a0c239a52e1a7418) 
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    additionalProperties: false
39    properties:
40      sound-dai:
41        description: phandles to the I2S controllers
42
43  codec:
44    type: object
45    additionalProperties: false
46    properties:
47      sound-dai:
48        minItems: 1
49        items:
50          - description: phandle of the HDMI IP block node
51          - description: phandle of the MAX98090 CODEC
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