Documentation/devicetree/bindings/sound/samsung,midas-audio.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/sound/samsung,midas-audio.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung Midas audio complex with WM1811 codec
   8
   9 maintainers:
  10   - Sylwester Nawrocki <s.nawrocki@samsung.com>
  11
  12 allOf:
  13   - $ref: sound-card-common.yaml#
  14
  15 properties:
  16   compatible:
  17     const: samsung,midas-audio
  18
  19   cpu:
  20     type: object
  21     additionalProperties: false
  22     properties:
  23       sound-dai:
  24         maxItems: 1
  25         description: phandle to the I2S controller
  26     required:
  27       - sound-dai
  28
  29   codec:
  30     type: object
  31     additionalProperties: false
  32     properties:
  33       sound-dai:
  34         maxItems: 1
  35         description: phandle to the WM1811 CODEC
  36     required:
  37       - sound-dai
  38
  39   samsung,audio-routing:
  40     deprecated: true
  41     $ref: /schemas/types.yaml#/definitions/non-unique-string-array
  42     description: |
  43       List of the connections between audio components; each entry is
  44       a pair of strings, the first being the connection's sink, the second
  45       being the connection's source; valid names for sources and sinks are
  46       the WM1811's pins (as documented in its binding), and the jacks
  47       on the board: HP, SPK, Main Mic, Sub Mic, Headset Mic.
  48       Deprecated, use audio-routing.
  49
  50   mic-bias-supply:
  51     description: Supply for the micbias on the Main microphone
  52
  53   submic-bias-supply:
  54     description: Supply for the micbias on the Sub microphone
  55
  56   fm-sel-gpios:
  57     maxItems: 1
  58     description: GPIO pin for FM selection
  59
  60   lineout-sel-gpios:
  61     maxItems: 1
  62     description: GPIO pin for line out selection
  63
  64 required:
  65   - compatible
  66   - cpu
  67   - codec
  68   - audio-routing
  69   - mic-bias-supply
  70   - submic-bias-supply
  71
  72 unevaluatedProperties: false
  73
  74 examples:
  75   - |
  76     #include <dt-bindings/gpio/gpio.h>
  77
  78     sound {
  79         compatible = "samsung,midas-audio";
  80         model = "Midas";
  81
  82         fm-sel-gpios = <&gpaa0 3 GPIO_ACTIVE_HIGH>;
  83
  84         mic-bias-supply = <&mic_bias_reg>;
  85         submic-bias-supply = <&submic_bias_reg>;
  86
  87         audio-routing =
  88                 "HP", "HPOUT1L",
  89                 "HP", "HPOUT1R",
  90
  91                 "SPK", "SPKOUTLN",
  92                 "SPK", "SPKOUTLP",
  93                 "SPK", "SPKOUTRN",
  94                 "SPK", "SPKOUTRP",
  95
  96                 "RCV", "HPOUT2N",
  97                 "RCV", "HPOUT2P",
  98
  99                 "IN1LP", "Main Mic",
 100                 "IN1LN", "Main Mic",
 101                 "IN1RP", "Sub Mic",
 102                 "IN1LP", "Sub Mic";
 103
 104         cpu {
 105             sound-dai = <&i2s0>;
 106         };
 107
 108         codec {
 109             sound-dai = <&wm1811>;
 110         };
 111
 112     };