Documentation/devicetree/bindings/sound/qcom,apq8096.txt

   1 * Qualcomm Technologies APQ8096 ASoC sound card driver
   2
   3 This binding describes the APQ8096 sound card, which uses qdsp for audio.
   4
   5 - compatible:
   6         Usage: required
   7         Value type: <stringlist>
   8         Definition: must be "qcom,apq8096-sndcard"
   9
  10 - audio-routing:
  11         Usage: Optional
  12         Value type: <stringlist>
  13         Definition:  A list of the connections between audio components.
  14                   Each entry is a pair of strings, the first being the
  15                   connection's sink, the second being the connection's
  16                   source. Valid names could be power supplies, MicBias
  17                   of codec and the jacks on the board:
  18                   Valid names include:
  19
  20                 Board Connectors:
  21                         "Headphone Left"
  22                         "Headphone Right"
  23                         "Earphone"
  24                         "Line Out1"
  25                         "Line Out2"
  26                         "Line Out3"
  27                         "Line Out4"
  28                         "Analog Mic1"
  29                         "Analog Mic2"
  30                         "Analog Mic3"
  31                         "Analog Mic4"
  32                         "Analog Mic5"
  33                         "Analog Mic6"
  34                         "Digital Mic2"
  35                         "Digital Mic3"
  36
  37                 Audio pins and MicBias on WCD9335 Codec:
  38                         "MIC_BIAS1"
  39                         "MIC_BIAS2"
  40                         "MIC_BIAS3"
  41                         "MIC_BIAS4"
  42                         "AMIC1"
  43                         "AMIC2"
  44                         "AMIC3"
  45                         "AMIC4"
  46                         "AMIC5"
  47                         "AMIC6"
  48                         "AMIC6"
  49                         "DMIC1"
  50                         "DMIC2"
  51                         "DMIC3"
  52
  53 - model:
  54         Usage: required
  55         Value type: <stringlist>
  56         Definition: The user-visible name of this sound card.
  57
  58 - aux-devs
  59         Usage: optional
  60         Value type: <array of phandles>
  61         Definition: A list of phandles for auxiliary devices (e.g. analog
  62                     amplifiers) that do not appear directly within the DAI
  63                     links. Should be connected to another audio component
  64                     using "audio-routing".
  65
  66 = dailinks
  67 Each subnode of sndcard represents either a dailink, and subnodes of each
  68 dailinks would be cpu/codec/platform dais.
  69
  70 - link-name:
  71         Usage: required
  72         Value type: <string>
  73         Definition: User friendly name for dai link
  74
  75 = CPU, PLATFORM, CODEC dais subnodes
  76 - cpu:
  77         Usage: required
  78         Value type: <subnode>
  79         Definition: cpu dai sub-node
  80
  81 - codec:
  82         Usage: Optional
  83         Value type: <subnode>
  84         Definition: codec dai sub-node
  85
  86 - platform:
  87         Usage: Optional
  88         Value type: <subnode>
  89         Definition: platform dai sub-node
  90
  91 - sound-dai:
  92         Usage: required
  93         Value type: <phandle with arguments>
  94         Definition: dai phandle/s and port of CPU/CODEC/PLATFORM node.
  95
  96 Obsolete:
  97         qcom,model: String for soundcard name (Use model instead)
  98         qcom,audio-routing: A list of the connections between audio components.
  99                             (Use audio-routing instead)
 100
 101 Example:
 102
 103 audio {
 104         compatible = "qcom,apq8096-sndcard";
 105         model = "DB820c";
 106
 107         mm1-dai-link {
 108                 link-name = "MultiMedia1";
 109                 cpu {
 110                         sound-dai = <&q6asmdai MSM_FRONTEND_DAI_MULTIMEDIA1>;
 111                 };
 112         };
 113
 114         hdmi-dai-link {
 115                 link-name = "HDMI Playback";
 116                 cpu {
 117                         sound-dai = <&q6afe HDMI_RX>;
 118                 };
 119
 120                 platform {
 121                         sound-dai = <&q6adm>;
 122                 };
 123
 124                 codec {
 125                         sound-dai = <&hdmi 0>;
 126                 };
 127         };
 128 };