GNU Linux-libre 4.19.245-gnu1
[releases.git] / Documentation / devicetree / bindings / sound / samsung,odroid.txt
1 Samsung Exynos Odroid XU3/XU4 audio complex with MAX98090 codec
2
3 Required properties:
4
5  - compatible - "hardkernel,odroid-xu3-audio" - for Odroid XU3 board,
6                 "hardkernel,odroid-xu4-audio" - for Odroid XU4 board (deprecated),
7                 "samsung,odroid-xu3-audio" - for Odroid XU3 board (deprecated),
8                 "samsung,odroid-xu4-audio" - for Odroid XU4 board (deprecated)
9  - model - the user-visible name of this sound complex
10  - clocks - should contain entries matching clock names in the clock-names
11     property
12  - samsung,audio-widgets - this property specifies off-codec audio elements
13    like headphones or speakers, for details see widgets.txt
14  - samsung,audio-routing - a list of the connections between audio
15    components;  each entry is a pair of strings, the first being the
16    connection's sink, the second being the connection's source;
17    valid names for sources and sinks are the MAX98090's pins (as
18    documented in its binding), and the jacks on the board
19
20    For Odroid X2:
21      "Headphone Jack", "Mic Jack", "DMIC"
22
23    For Odroid U3, XU3:
24      "Headphone Jack", "Speakers"
25
26    For Odroid XU4:
27      no entries
28
29 Required sub-nodes:
30
31  - 'cpu' subnode with a 'sound-dai' property containing the phandle of the I2S
32     controller
33  - 'codec' subnode with a 'sound-dai' property containing list of phandles
34     to the CODEC nodes, first entry must be corresponding to the MAX98090
35     CODEC and the second entry must be the phandle of the HDMI IP block node
36
37 Example:
38
39 sound {
40         compatible = "hardkernel,odroid-xu3-audio";
41         model = "Odroid-XU3";
42         samsung,audio-routing =
43                 "Headphone Jack", "HPL",
44                 "Headphone Jack", "HPR",
45                 "IN1", "Mic Jack",
46                 "Mic Jack", "MICBIAS";
47
48         cpu {
49                 sound-dai = <&i2s0 0>;
50         };
51         codec {
52                 sound-dai = <&hdmi>, <&max98090>;
53         };
54 };