Documentation/devicetree/bindings/sound/renesas,rsrc-card.txt

   1 Renesas Sampling Rate Convert Sound Card:
   2
   3 Renesas Sampling Rate Convert Sound Card specifies audio DAI connections of SoC <-> codec.
   4
   5 Required properties:
   6
   7 - compatible                            : "renesas,rsrc-card,<board>"
   8                                           Examples with soctypes are:
   9                                             - "renesas,rsrc-card"
  10                                             - "renesas,rsrc-card,lager"
  11                                             - "renesas,rsrc-card,koelsch"
  12 Optional properties:
  13
  14 - card_name                             : User specified audio sound card name, one string
  15                                           property.
  16 - cpu                                   : CPU   sub-node
  17 - codec                                 : CODEC sub-node
  18
  19 Optional subnode properties:
  20
  21 - format                                : CPU/CODEC common audio format.
  22                                           "i2s", "right_j", "left_j" , "dsp_a"
  23                                           "dsp_b", "ac97", "pdm", "msb", "lsb"
  24 - frame-master                          : Indicates dai-link frame master.
  25                                           phandle to a cpu or codec subnode.
  26 - bitclock-master                       : Indicates dai-link bit clock master.
  27                                           phandle to a cpu or codec subnode.
  28 - bitclock-inversion                    : bool property. Add this if the
  29                                           dai-link uses bit clock inversion.
  30 - frame-inversion                       : bool property. Add this if the
  31                                           dai-link uses frame clock inversion.
  32 - convert-rate                          : platform specified sampling rate convert
  33 - audio-prefix                          : see audio-routing
  34 - audio-routing                         : A list of the connections between audio components.
  35                                           Each entry is a pair of strings, the first being the connection's sink,
  36                                           the second being the connection's source. Valid names for sources.
  37                                           use audio-prefix if some components is using same sink/sources naming.
  38                                           it can be used if compatible was "renesas,rsrc-card";
  39
  40 Required CPU/CODEC subnodes properties:
  41
  42 - sound-dai                             : phandle and port of CPU/CODEC
  43
  44 Optional CPU/CODEC subnodes properties:
  45
  46 - clocks / system-clock-frequency       : specify subnode's clock if needed.
  47                                           it can be specified via "clocks" if system has
  48                                           clock node (= common clock), or "system-clock-frequency"
  49                                           (if system doens't support common clock)
  50                                           If a clock is specified, it is
  51                                           enabled with clk_prepare_enable()
  52                                           in dai startup() and disabled with
  53                                           clk_disable_unprepare() in dai
  54                                           shutdown().
  55
  56 Example
  57
  58 sound {
  59         compatible = "renesas,rsrc-card,lager";
  60
  61         card-name = "rsnd-ak4643";
  62         format = "left_j";
  63         bitclock-master = <&sndcodec>;
  64         frame-master = <&sndcodec>;
  65
  66         sndcpu: cpu {
  67                 sound-dai = <&rcar_sound>;
  68         };
  69
  70         sndcodec: codec {
  71                 sound-dai = <&ak4643>;
  72                 system-clock-frequency = <11289600>;
  73         };
  74 };