Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
ASoC: dt-bindings: convert tlv320aic31xx.txt to yaml
Convert binding doc tlv320aic31xx.txt to yaml format.
Additional change:
- add i2c node in example.
- replace MICBIAS_OFF with MICBIAS_2_0v in example because MICBIAS_OFF have
been defined in header file.
- add ref to dai-common.yaml.
- add #sound-dai-cells.
Fix below warning:
arch/arm64/boot/dts/freescale/imx8mq-zii-ultra-rmb3.dtb: /soc@0/bus@30800000/i2c@30a30000/codec@18:
failed to match any schema with compatible: ['ti,tlv320dac3100']
Signed-off-by: Frank Li <Frank.Li@nxp.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20240814174422.4026100-1-Frank.Li@nxp.com
Signed-off-by: Mark Brown <broonie@kernel.org>
authored by
Frank Li
and committed by
Mark Brown
e486feb7
d08ea419
+127
-77
+127
Documentation/devicetree/bindings/sound/ti,tlv320dac3100.yaml
+127
Documentation/devicetree/bindings/sound/ti,tlv320dac3100.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/ti,tlv320dac3100.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Texas Instruments - tlv320aic31xx Codec module
8
+
9
+
maintainers:
10
+
- Shenghao Ding <shenghao-ding@ti.com>
11
+
12
+
description: |
13
+
CODEC output pins:
14
+
* HPL
15
+
* HPR
16
+
* SPL, devices with stereo speaker amp
17
+
* SPR, devices with stereo speaker amp
18
+
* SPK, devices with mono speaker amp
19
+
* MICBIAS
20
+
21
+
CODEC input pins:
22
+
* MIC1LP, devices with ADC
23
+
* MIC1RP, devices with ADC
24
+
* MIC1LM, devices with ADC
25
+
* AIN1, devices without ADC
26
+
* AIN2, devices without ADC
27
+
28
+
The pins can be used in referring sound node's audio-routing property.
29
+
30
+
properties:
31
+
compatible:
32
+
enum:
33
+
- ti,tlv320aic310x # - Generic TLV320AIC31xx with mono speaker amp
34
+
- ti,tlv320aic311x # - Generic TLV320AIC31xx with stereo speaker amp
35
+
- ti,tlv320aic3100 # - TLV320AIC3100 (mono speaker amp, no MiniDSP)
36
+
- ti,tlv320aic3110 # - TLV320AIC3110 (stereo speaker amp, no MiniDSP)
37
+
- ti,tlv320aic3120 # - TLV320AIC3120 (mono speaker amp, MiniDSP)
38
+
- ti,tlv320aic3111 # - TLV320AIC3111 (stereo speaker amp, MiniDSP)
39
+
- ti,tlv320dac3100 # - TLV320DAC3100 (no ADC, mono speaker amp, no MiniDSP)
40
+
- ti,tlv320dac3101 # - TLV320DAC3101 (no ADC, stereo speaker amp, no MiniDSP)
41
+
42
+
reg:
43
+
maxItems: 1
44
+
45
+
'#sound-dai-cells':
46
+
const: 0
47
+
48
+
HPVDD-supply: true
49
+
50
+
SPRVDD-supply: true
51
+
52
+
SPLVDD-supply: true
53
+
54
+
AVDD-supply: true
55
+
56
+
IOVDD-supply: true
57
+
58
+
DVDD-supply: true
59
+
60
+
reset-gpios:
61
+
description: GPIO specification for the active low RESET input.
62
+
63
+
ai31xx-micbias-vg:
64
+
$ref: /schemas/types.yaml#/definitions/uint32
65
+
default: 1
66
+
enum: [1, 2, 3]
67
+
description: |
68
+
MicBias Voltage setting
69
+
1 or MICBIAS_2_0V - MICBIAS output is powered to 2.0V
70
+
2 or MICBIAS_2_5V - MICBIAS output is powered to 2.5V
71
+
3 or MICBIAS_AVDD - MICBIAS output is connected to AVDD
72
+
73
+
ai31xx-ocmv:
74
+
$ref: /schemas/types.yaml#/definitions/uint32
75
+
enum: [0, 1, 2, 3]
76
+
description: |
77
+
output common-mode voltage setting
78
+
0 - 1.35V,
79
+
1 - 1.5V,
80
+
2 - 1.65V,
81
+
3 - 1.8V
82
+
83
+
gpio-reset:
84
+
description: gpio pin number used for codec reset
85
+
deprecated: true
86
+
87
+
88
+
required:
89
+
- compatible
90
+
- reg
91
+
- HPVDD-supply
92
+
- SPRVDD-supply
93
+
- SPLVDD-supply
94
+
- AVDD-supply
95
+
- IOVDD-supply
96
+
- DVDD-supply
97
+
98
+
allOf:
99
+
- $ref: dai-common.yaml#
100
+
101
+
unevaluatedProperties: false
102
+
103
+
examples:
104
+
- |
105
+
#include <dt-bindings/gpio/gpio.h>
106
+
#include <dt-bindings/sound/tlv320aic31xx.h>
107
+
108
+
i2c {
109
+
#address-cells = <1>;
110
+
#size-cells = <0>;
111
+
112
+
sound@18 {
113
+
compatible = "ti,tlv320aic311x";
114
+
reg = <0x18>;
115
+
116
+
ai31xx-micbias-vg = <MICBIAS_2_0V>;
117
+
reset-gpios = <&gpio1 17 GPIO_ACTIVE_LOW>;
118
+
119
+
HPVDD-supply = <®ulator>;
120
+
SPRVDD-supply = <®ulator>;
121
+
SPLVDD-supply = <®ulator>;
122
+
AVDD-supply = <®ulator>;
123
+
IOVDD-supply = <®ulator>;
124
+
DVDD-supply = <®ulator>;
125
+
};
126
+
};
127
+
-77
Documentation/devicetree/bindings/sound/tlv320aic31xx.txt
-77
Documentation/devicetree/bindings/sound/tlv320aic31xx.txt
···
1
-
Texas Instruments - tlv320aic31xx Codec module
2
-
3
-
The tlv320aic31xx serial control bus communicates through I2C protocols
4
-
5
-
Required properties:
6
-
7
-
- compatible - "string" - One of:
8
-
"ti,tlv320aic310x" - Generic TLV320AIC31xx with mono speaker amp
9
-
"ti,tlv320aic311x" - Generic TLV320AIC31xx with stereo speaker amp
10
-
"ti,tlv320aic3100" - TLV320AIC3100 (mono speaker amp, no MiniDSP)
11
-
"ti,tlv320aic3110" - TLV320AIC3110 (stereo speaker amp, no MiniDSP)
12
-
"ti,tlv320aic3120" - TLV320AIC3120 (mono speaker amp, MiniDSP)
13
-
"ti,tlv320aic3111" - TLV320AIC3111 (stereo speaker amp, MiniDSP)
14
-
"ti,tlv320dac3100" - TLV320DAC3100 (no ADC, mono speaker amp, no MiniDSP)
15
-
"ti,tlv320dac3101" - TLV320DAC3101 (no ADC, stereo speaker amp, no MiniDSP)
16
-
17
-
- reg - <int> - I2C slave address
18
-
- HPVDD-supply, SPRVDD-supply, SPLVDD-supply, AVDD-supply, IOVDD-supply,
19
-
DVDD-supply : power supplies for the device as covered in
20
-
Documentation/devicetree/bindings/regulator/regulator.txt
21
-
22
-
23
-
Optional properties:
24
-
25
-
- reset-gpios - GPIO specification for the active low RESET input.
26
-
- ai31xx-micbias-vg - MicBias Voltage setting
27
-
1 or MICBIAS_2_0V - MICBIAS output is powered to 2.0V
28
-
2 or MICBIAS_2_5V - MICBIAS output is powered to 2.5V
29
-
3 or MICBIAS_AVDD - MICBIAS output is connected to AVDD
30
-
If this node is not mentioned or if the value is unknown, then
31
-
micbias is set to 2.0V.
32
-
- ai31xx-ocmv - output common-mode voltage setting
33
-
0 - 1.35V,
34
-
1 - 1.5V,
35
-
2 - 1.65V,
36
-
3 - 1.8V
37
-
38
-
Deprecated properties:
39
-
40
-
- gpio-reset - gpio pin number used for codec reset
41
-
42
-
CODEC output pins:
43
-
* HPL
44
-
* HPR
45
-
* SPL, devices with stereo speaker amp
46
-
* SPR, devices with stereo speaker amp
47
-
* SPK, devices with mono speaker amp
48
-
* MICBIAS
49
-
50
-
CODEC input pins:
51
-
* MIC1LP, devices with ADC
52
-
* MIC1RP, devices with ADC
53
-
* MIC1LM, devices with ADC
54
-
* AIN1, devices without ADC
55
-
* AIN2, devices without ADC
56
-
57
-
The pins can be used in referring sound node's audio-routing property.
58
-
59
-
Example:
60
-
#include <dt-bindings/gpio/gpio.h>
61
-
#include <dt-bindings/sound/tlv320aic31xx.h>
62
-
63
-
tlv320aic31xx: tlv320aic31xx@18 {
64
-
compatible = "ti,tlv320aic311x";
65
-
reg = <0x18>;
66
-
67
-
ai31xx-micbias-vg = <MICBIAS_OFF>;
68
-
69
-
reset-gpios = <&gpio1 17 GPIO_ACTIVE_LOW>;
70
-
71
-
HPVDD-supply = <®ulator>;
72
-
SPRVDD-supply = <®ulator>;
73
-
SPLVDD-supply = <®ulator>;
74
-
AVDD-supply = <®ulator>;
75
-
IOVDD-supply = <®ulator>;
76
-
DVDD-supply = <®ulator>;
77
-
};