Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/dtor/input
[sfrench/cifs-2.6.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 - "samsung,odroidxu3-audio" - for Odroid XU3 board,
6                 "samsung,odroidxu4-audio" - for Odroid XU4 board
7  - model - the user-visible name of this sound complex
8  - clocks - should contain entries matching clock names in the clock-names
9     property
10  - clock-names - should contain following entries:
11     - "epll" - indicating the EPLL output clock
12     - "i2s_rclk" - indicating the RCLK (root) clock of the I2S0 controller
13  - samsung,audio-widgets - this property specifies off-codec audio elements
14    like headphones or speakers, for details see widgets.txt
15  - samsung,audio-routing - a list of the connections between audio
16    components;  each entry is a pair of strings, the first being the
17    connection's sink, the second being the connection's source;
18    valid names for sources and sinks are the MAX98090's pins (as
19    documented in its binding), and the jacks on the board
20
21    For Odroid X2:
22      "Headphone Jack", "Mic Jack", "DMIC"
23
24    For Odroid U3, XU3:
25      "Headphone Jack", "Speakers"
26
27    For Odroid XU4:
28      no entries
29
30 Required sub-nodes:
31
32  - 'cpu' subnode with a 'sound-dai' property containing the phandle of the I2S
33     controller
34  - 'codec' subnode with a 'sound-dai' property containing list of phandles
35     to the CODEC nodes, first entry must be corresponding to the MAX98090
36     CODEC and the second entry must be the phandle of the HDMI IP block node
37
38 Example:
39
40 sound {
41         compatible = "samsung,odroidxu3-audio";
42         model = "Odroid-XU3";
43         samsung,audio-routing =
44                 "Headphone Jack", "HPL",
45                 "Headphone Jack", "HPR",
46                 "IN1", "Mic Jack",
47                 "Mic Jack", "MICBIAS";
48
49         clocks = <&clock CLK_FOUT_EPLL>, <&i2s0 CLK_I2S_RCLK_SRC>;
50         clock-names = "epll", "sclk_i2s";
51
52         cpu {
53                 sound-dai = <&i2s0 0>;
54         };
55         codec {
56                 sound-dai = <&hdmi>, <&max98090>;
57         };
58 };