xref: /freebsd/sys/contrib/device-tree/Bindings/sound/samsung,midas-audio.yaml (revision 43a5ec4eb41567cc92586503212743d89686d78f) 
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
7title: Samsung Midas audio complex with WM1811 codec
8
9maintainers:
10  - Sylwester Nawrocki <s.nawrocki@samsung.com>
11
12properties:
13  compatible:
14    const: samsung,midas-audio
15
16  model:
17    $ref: /schemas/types.yaml#/definitions/string
18    description: The user-visible name of this sound complex.
19
20  cpu:
21    type: object
22    properties:
23      sound-dai:
24        $ref: /schemas/types.yaml#/definitions/phandle-array
25        maxItems: 1
26        description: phandle to the I2S controller
27    required:
28      - sound-dai
29
30  codec:
31    type: object
32    properties:
33      sound-dai:
34        $ref: /schemas/types.yaml#/definitions/phandle-array
35        maxItems: 1
36        description: phandle to the WM1811 CODEC
37    required:
38      - sound-dai
39
40  samsung,audio-routing:
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
49  mic-bias-supply:
50    description: Supply for the micbias on the Main microphone
51
52  submic-bias-supply:
53    description: Supply for the micbias on the Sub microphone
54
55  fm-sel-gpios:
56    maxItems: 1
57    description: GPIO pin for FM selection
58
59  lineout-sel-gpios:
60    maxItems: 1
61    description: GPIO pin for line out selection
62
63required:
64  - compatible
65  - model
66  - cpu
67  - codec
68  - samsung,audio-routing
69  - mic-bias-supply
70  - submic-bias-supply
71
72additionalProperties: false
73
74examples:
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        samsung,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    };
113