Documentation/devicetree/bindings/sound/samsung,odroid.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/sound/samsung,odroid.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung Exynos Odroid XU3/XU4 audio complex with MAX98090 codec
   8
   9 maintainers:
  10   - Krzysztof Kozlowski <krzk@kernel.org>
  11   - Sylwester Nawrocki <s.nawrocki@samsung.com>
  12
  13 properties:
  14   compatible:
  15     oneOf:
  16       - const: hardkernel,odroid-xu3-audio
  17
  18       - const: hardkernel,odroid-xu4-audio
  19         deprecated: true
  20
  21       - const: samsung,odroid-xu3-audio
  22         deprecated: true
  23
  24       - const: samsung,odroid-xu4-audio
  25         deprecated: true
  26
  27   model:
  28     $ref: /schemas/types.yaml#/definitions/string
  29     description: The user-visible name of this sound complex.
  30
  31   assigned-clock-parents: true
  32   assigned-clock-rates: true
  33   assigned-clocks: true
  34   clocks: true
  35
  36   cpu:
  37     type: object
  38     properties:
  39       sound-dai:
  40         $ref: /schemas/types.yaml#/definitions/phandle-array
  41         description: phandles to the I2S controllers
  42
  43   codec:
  44     type: object
  45     properties:
  46       sound-dai:
  47         $ref: /schemas/types.yaml#/definitions/phandle-array
  48         description: |
  49           List of phandles to the CODEC nodes,
  50           first entry must be corresponding to the MAX98090 CODEC and
  51           the second entry must be the phandle of the HDMI IP block node.
  52
  53   samsung,audio-routing:
  54     $ref: /schemas/types.yaml#/definitions/non-unique-string-array
  55     description: |
  56       List of the connections between audio
  57       components;  each entry is a pair of strings, the first being the
  58       connection's sink, the second being the connection's source;
  59       valid names for sources and sinks are the MAX98090's pins (as
  60       documented in its binding), and the jacks on the board.
  61       For Odroid X2: "Headphone Jack", "Mic Jack", "DMIC"
  62       For Odroid U3, XU3: "Headphone Jack", "Speakers"
  63       For Odroid XU4: no entries
  64
  65   samsung,audio-widgets:
  66     $ref: /schemas/types.yaml#/definitions/non-unique-string-array
  67     description: |
  68       This property specifies off-codec audio elements
  69       like headphones or speakers, for details see widgets.txt
  70
  71 required:
  72   - compatible
  73   - model
  74   - cpu
  75   - codec
  76
  77 additionalProperties: false
  78
  79 examples:
  80   - |
  81     sound {
  82         compatible = "hardkernel,odroid-xu3-audio";
  83         model = "Odroid-XU3";
  84         samsung,audio-routing =
  85                 "Headphone Jack", "HPL",
  86                 "Headphone Jack", "HPR",
  87                 "IN1", "Mic Jack",
  88                 "Mic Jack", "MICBIAS";
  89
  90         cpu {
  91             sound-dai = <&i2s0 0>;
  92         };
  93
  94         codec {
  95             sound-dai = <&hdmi>, <&max98090>;
  96         };
  97     };
  98