xref: /freebsd/sys/contrib/device-tree/Bindings/sound/samsung,odroid.yaml (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
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        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
68required:
69  - compatible
70  - model
71  - cpu
72  - codec
73
74additionalProperties: false
75
76examples:
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    };
95