Documentation/devicetree/bindings/sound/nvidia,tegra-audio-max9808x.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/nvidia,tegra-audio-max9808x.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: NVIDIA Tegra audio complex with MAX9808x CODEC
   8
   9 maintainers:
  10   - Jon Hunter <jonathanh@nvidia.com>
  11   - Thierry Reding <thierry.reding@gmail.com>
  12
  13 allOf:
  14   - $ref: nvidia,tegra-audio-common.yaml#
  15
  16 properties:
  17   compatible:
  18     oneOf:
  19       - items:
  20           - pattern: '^[a-z0-9]+,tegra-audio-max98088(-[a-z0-9]+)+$'
  21           - const: nvidia,tegra-audio-max98088
  22       - items:
  23           - pattern: '^[a-z0-9]+,tegra-audio-max98089(-[a-z0-9]+)+$'
  24           - const: nvidia,tegra-audio-max98089
  25
  26   nvidia,audio-routing:
  27     $ref: /schemas/types.yaml#/definitions/non-unique-string-array
  28     description: |
  29       A list of the connections between audio components.
  30       Each entry is a pair of strings, the first being the connection's sink,
  31       the second being the connection's source. Valid names for sources and
  32       sinks are the pins (documented in the binding document),
  33       and the jacks on the board.
  34     minItems: 2
  35     items:
  36       enum:
  37         # Board Connectors
  38         - Int Spk
  39         - Headphone Jack
  40         - Earpiece
  41         - Headset Mic
  42         - Internal Mic 1
  43         - Internal Mic 2
  44
  45         # CODEC Pins
  46         - HPL
  47         - HPR
  48         - SPKL
  49         - SPKR
  50         - RECL
  51         - RECR
  52         - INA1
  53         - INA2
  54         - INB1
  55         - INB2
  56         - MIC1
  57         - MIC2
  58         - MICBIAS
  59
  60 unevaluatedProperties: false
  61
  62 examples:
  63   - |
  64     #include <dt-bindings/clock/tegra30-car.h>
  65     #include <dt-bindings/soc/tegra-pmc.h>
  66     sound {
  67         compatible = "lg,tegra-audio-max98089-p895",
  68                      "nvidia,tegra-audio-max98089";
  69         nvidia,model = "LG Optimus Vu MAX98089";
  70
  71         nvidia,audio-routing =
  72             "Headphone Jack", "HPL",
  73             "Headphone Jack", "HPR",
  74             "Int Spk", "SPKL",
  75             "Int Spk", "SPKR",
  76             "Earpiece", "RECL",
  77             "Earpiece", "RECR",
  78             "INA1", "Headset Mic",
  79             "MIC1", "MICBIAS",
  80             "MICBIAS", "Internal Mic 1",
  81             "MIC2", "Internal Mic 2";
  82
  83         nvidia,i2s-controller = <&tegra_i2s0>;
  84         nvidia,audio-codec = <&codec>;
  85
  86         clocks = <&tegra_car TEGRA30_CLK_PLL_A>,
  87                  <&tegra_car TEGRA30_CLK_PLL_A_OUT0>,
  88                  <&tegra_pmc TEGRA_PMC_CLK_OUT_1>;
  89         clock-names = "pll_a", "pll_a_out0", "mclk";
  90     };