Documentation/devicetree/bindings/sound/fsl-asoc-card.txt

   1 Freescale Generic ASoC Sound Card with ASRC support
   2
   3 The Freescale Generic ASoC Sound Card can be used, ideally, for all Freescale
   4 SoCs connecting with external CODECs.
   5
   6 The idea of this generic sound card is a bit like ASoC Simple Card. However,
   7 for Freescale SoCs (especially those released in recent years), most of them
   8 have ASRC (Documentation/devicetree/bindings/sound/fsl,asrc.txt) inside. And
   9 this is a specific feature that might be painstakingly controlled and merged
  10 into the Simple Card.
  11
  12 So having this generic sound card allows all Freescale SoC users to benefit
  13 from the simplification of a new card support and the capability of the wide
  14 sample rates support through ASRC.
  15
  16 Note: 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.
  20
  21
  22 The compatible list for this generic sound card currently:
  23  "fsl,imx-audio-ac97"
  24
  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
  33  "fsl,imx-audio-wm8960"
  34
  35 Required 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
  61 Optional 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
  66 Example:
  67 sound-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 };