Merge branch 'next' of git://git.kernel.org/pub/scm/linux/kernel/git/jmorris/linux...
[linux-2.6-block.git] / Documentation / devicetree / bindings / sound / fsl-asoc-card.txt
CommitLineData
708b4351
NC
1Freescale Generic ASoC Sound Card with ASRC support
2
3The Freescale Generic ASoC Sound Card can be used, ideally, for all Freescale
4SoCs connecting with external CODECs.
5
6The idea of this generic sound card is a bit like ASoC Simple Card. However,
7for Freescale SoCs (especially those released in recent years), most of them
8have ASRC (Documentation/devicetree/bindings/sound/fsl,asrc.txt) inside. And
9this is a specific feature that might be painstakingly controlled and merged
10into the Simple Card.
11
12So having this generic sound card allows all Freescale SoC users to benefit
13from the simplification of a new card support and the capability of the wide
14sample rates support through ASRC.
15
50760cad
MS
16Note: The card is initially designed for those sound cards who use AC'97, I2S
17 and PCM DAI formats. However, it'll be also possible to support those non
18 AC'97/I2S/PCM type sound cards, such as S/PDIF audio and HDMI audio, as
19 long as the driver has been properly upgraded.
708b4351
NC
20
21
22The compatible list for this generic sound card currently:
50760cad
MS
23 "fsl,imx-audio-ac97"
24
708b4351
NC
25 "fsl,imx-audio-cs42888"
26
27 "fsl,imx-audio-wm8962"
28 (compatible with Documentation/devicetree/bindings/sound/imx-audio-wm8962.txt)
29
30 "fsl,imx-audio-sgtl5000"
31 (compatible with Documentation/devicetree/bindings/sound/imx-audio-sgtl5000.txt)
32
2935bf43
XL
33 "fsl,imx-audio-wm8960"
34
708b4351
NC
35Required properties:
36
37 - compatible : Contains one of entries in the compatible list.
38
39 - model : The user-visible name of this sound complex
40
41 - audio-cpu : The phandle of an CPU DAI controller
42
43 - audio-codec : The phandle of an audio codec
44
45 - audio-routing : A list of the connections between audio components.
46 Each entry is a pair of strings, the first being the
47 connection's sink, the second being the connection's
48 source. There're a few pre-designed board connectors:
49 * Line Out Jack
50 * Line In Jack
51 * Headphone Jack
52 * Mic Jack
53 * Ext Spk
54 * AMIC (stands for Analog Microphone Jack)
55 * DMIC (stands for Digital Microphone Jack)
56
57 Note: The "Mic Jack" and "AMIC" are redundant while
58 coexsiting in order to support the old bindings
59 of wm8962 and sgtl5000.
60
61Optional properties:
62
63 - audio-asrc : The phandle of ASRC. It can be absent if there's no
64 need to add ASRC support via DPCM.
65
66Example:
67sound-cs42888 {
68 compatible = "fsl,imx-audio-cs42888";
69 model = "cs42888-audio";
70 audio-cpu = <&esai>;
71 audio-asrc = <&asrc>;
72 audio-codec = <&cs42888>;
73 audio-routing =
74 "Line Out Jack", "AOUT1L",
75 "Line Out Jack", "AOUT1R",
76 "Line Out Jack", "AOUT2L",
77 "Line Out Jack", "AOUT2R",
78 "Line Out Jack", "AOUT3L",
79 "Line Out Jack", "AOUT3R",
80 "Line Out Jack", "AOUT4L",
81 "Line Out Jack", "AOUT4R",
82 "AIN1L", "Line In Jack",
83 "AIN1R", "Line In Jack",
84 "AIN2L", "Line In Jack",
85 "AIN2R", "Line In Jack";
86};