dts/upstream/Bindings/sound/samsung,snow.yaml

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/sound/samsung,snow.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Google Snow audio complex with MAX9809x codec

maintainers:
  - Krzysztof Kozlowski <krzk@kernel.org>
  - Sylwester Nawrocki <s.nawrocki@samsung.com>

properties:
  compatible:
    enum:
      - google,snow-audio-max98090
      - google,snow-audio-max98091
      - google,snow-audio-max98095

  codec:
    type: object
    additionalProperties: false
    properties:
      sound-dai:
        description: List of phandles to the CODEC and HDMI IP nodes.
        items:
          - description: Phandle to the MAX98090, MAX98091 or MAX98095 CODEC.
          - description: Phandle to the HDMI IP block node.
    required:
      - sound-dai

  cpu:
    type: object
    additionalProperties: false
    properties:
      sound-dai:
        description: Phandle to the Samsung I2S controller.
        maxItems: 1
    required:
      - sound-dai

  samsung,audio-codec:
    description: Phandle to the audio codec.
    $ref: /schemas/types.yaml#/definitions/phandle
    deprecated: true

  samsung,i2s-controller:
    description: Phandle to the Samsung I2S controller.
    $ref: /schemas/types.yaml#/definitions/phandle
    deprecated: true

  samsung,model:
    description: The user-visible name of this sound complex.
    $ref: /schemas/types.yaml#/definitions/string

required:
  - compatible
  - codec
  - cpu

additionalProperties: false

examples:
  - |
    sound {
        compatible = "google,snow-audio-max98095";
        samsung,model = "Snow-I2S-MAX98095";

        cpu {
            sound-dai = <&i2s0 0>;
        };

        codec {
            sound-dai = <&max98095 0>, <&hdmi>;
        };
    };