Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
ASoC: dt-bindings: fsl,imx-audio-es8328: Convert to dtschema
Convert the Freescale i.MX audio complex with ES8328 codec bindings to
DT schema format.
Cc: Daniel Baluta <daniel.baluta@nxp.com>
Signed-off-by: Animesh Agarwal <animeshagarwal28@gmail.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20240722063657.23018-1-animeshagarwal28@gmail.com
Signed-off-by: Mark Brown <broonie@kernel.org>
authored by
Animesh Agarwal
and committed by
Mark Brown
00645b42
00425bf8
+111
-60
+111
Documentation/devicetree/bindings/sound/fsl,imx-audio-es8328.yaml
+111
Documentation/devicetree/bindings/sound/fsl,imx-audio-es8328.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/fsl,imx-audio-es8328.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Freescale i.MX audio complex with ES8328 codec
8
+
9
+
maintainers:
10
+
- Shawn Guo <shawnguo@kernel.org>
11
+
- Sascha Hauer <s.hauer@pengutronix.de>
12
+
13
+
allOf:
14
+
- $ref: sound-card-common.yaml#
15
+
16
+
properties:
17
+
compatible:
18
+
const: fsl,imx-audio-es8328
19
+
20
+
model:
21
+
$ref: /schemas/types.yaml#/definitions/string
22
+
description: The user-visible name of this sound complex
23
+
24
+
ssi-controller:
25
+
$ref: /schemas/types.yaml#/definitions/phandle
26
+
description: The phandle of the i.MX SSI controller
27
+
28
+
jack-gpio:
29
+
description: Optional GPIO for headphone jack
30
+
maxItems: 1
31
+
32
+
audio-amp-supply:
33
+
description: Power regulator for speaker amps
34
+
35
+
audio-codec:
36
+
$ref: /schemas/types.yaml#/definitions/phandle
37
+
description: The phandle to the ES8328 audio codec
38
+
39
+
audio-routing:
40
+
$ref: /schemas/types.yaml#/definitions/non-unique-string-array
41
+
description: |
42
+
A list of the connections between audio components. Each entry
43
+
is a pair of strings, the first being the connection's sink, the second
44
+
being the connection's source. Valid names could be power supplies,
45
+
ES8328 pins, and the jacks on the board:
46
+
47
+
Power supplies:
48
+
* audio-amp
49
+
50
+
ES8328 pins:
51
+
* LOUT1
52
+
* LOUT2
53
+
* ROUT1
54
+
* ROUT2
55
+
* LINPUT1
56
+
* LINPUT2
57
+
* RINPUT1
58
+
* RINPUT2
59
+
* Mic PGA
60
+
61
+
Board connectors:
62
+
* Headphone
63
+
* Speaker
64
+
* Mic Jack
65
+
66
+
mux-int-port:
67
+
$ref: /schemas/types.yaml#/definitions/uint32
68
+
description: The internal port of the i.MX audio muxer (AUDMUX)
69
+
enum: [1, 2, 7]
70
+
default: 1
71
+
72
+
mux-ext-port:
73
+
$ref: /schemas/types.yaml#/definitions/uint32
74
+
description: The external port of the i.MX audio muxer (AUDMIX)
75
+
enum: [3, 4, 5, 6]
76
+
default: 3
77
+
78
+
required:
79
+
- compatible
80
+
- model
81
+
- ssi-controller
82
+
- jack-gpio
83
+
- audio-amp-supply
84
+
- audio-codec
85
+
- audio-routing
86
+
- mux-int-port
87
+
- mux-ext-port
88
+
89
+
unevaluatedProperties: false
90
+
91
+
examples:
92
+
- |
93
+
sound {
94
+
compatible = "fsl,imx-audio-es8328";
95
+
model = "imx-audio-es8328";
96
+
ssi-controller = <&ssi1>;
97
+
audio-codec = <&codec>;
98
+
jack-gpio = <&gpio5 15 0>;
99
+
audio-amp-supply = <®_audio_amp>;
100
+
audio-routing =
101
+
"Speaker", "LOUT2",
102
+
"Speaker", "ROUT2",
103
+
"Speaker", "audio-amp",
104
+
"Headphone", "ROUT1",
105
+
"Headphone", "LOUT1",
106
+
"LINPUT1", "Mic Jack",
107
+
"RINPUT1", "Mic Jack",
108
+
"Mic Jack", "Mic Bias";
109
+
mux-int-port = <1>;
110
+
mux-ext-port = <3>;
111
+
};
-60
Documentation/devicetree/bindings/sound/imx-audio-es8328.txt
-60
Documentation/devicetree/bindings/sound/imx-audio-es8328.txt
···
1
-
Freescale i.MX audio complex with ES8328 codec
2
-
3
-
Required properties:
4
-
- compatible : "fsl,imx-audio-es8328"
5
-
- model : The user-visible name of this sound complex
6
-
- ssi-controller : The phandle of the i.MX SSI controller
7
-
- jack-gpio : Optional GPIO for headphone jack
8
-
- audio-amp-supply : Power regulator for speaker amps
9
-
- audio-codec : The phandle of the ES8328 audio codec
10
-
- audio-routing : A list of the connections between audio components.
11
-
Each entry is a pair of strings, the first being the
12
-
connection's sink, the second being the connection's
13
-
source. Valid names could be power supplies, ES8328
14
-
pins, and the jacks on the board:
15
-
16
-
Power supplies:
17
-
* audio-amp
18
-
19
-
ES8328 pins:
20
-
* LOUT1
21
-
* LOUT2
22
-
* ROUT1
23
-
* ROUT2
24
-
* LINPUT1
25
-
* LINPUT2
26
-
* RINPUT1
27
-
* RINPUT2
28
-
* Mic PGA
29
-
30
-
Board connectors:
31
-
* Headphone
32
-
* Speaker
33
-
* Mic Jack
34
-
- mux-int-port : The internal port of the i.MX audio muxer (AUDMUX)
35
-
- mux-ext-port : The external port of the i.MX audio muxer (AUDMIX)
36
-
37
-
Note: The AUDMUX port numbering should start at 1, which is consistent with
38
-
hardware manual.
39
-
40
-
Example:
41
-
42
-
sound {
43
-
compatible = "fsl,imx-audio-es8328";
44
-
model = "imx-audio-es8328";
45
-
ssi-controller = <&ssi1>;
46
-
audio-codec = <&codec>;
47
-
jack-gpio = <&gpio5 15 0>;
48
-
audio-amp-supply = <®_audio_amp>;
49
-
audio-routing =
50
-
"Speaker", "LOUT2",
51
-
"Speaker", "ROUT2",
52
-
"Speaker", "audio-amp",
53
-
"Headphone", "ROUT1",
54
-
"Headphone", "LOUT1",
55
-
"LINPUT1", "Mic Jack",
56
-
"RINPUT1", "Mic Jack",
57
-
"Mic Jack", "Mic Bias";
58
-
mux-int-port = <1>;
59
-
mux-ext-port = <3>;
60
-
};