mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2026-05-13 14:09:38 -04:00
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>
This commit is contained in:
Frank Li
127
Documentation/devicetree/bindings/sound/ti,tlv320dac3100.yaml
Normal file
127
Documentation/devicetree/bindings/sound/ti,tlv320dac3100.yaml
Normal file
@@ -0,0 +1,127 @@
|
|||||||
|
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||||||
|
%YAML 1.2
|
||||||
|
---
|
||||||
|
$id: http://devicetree.org/schemas/sound/ti,tlv320dac3100.yaml#
|
||||||
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||||
|
|
||||||
|
title: Texas Instruments - tlv320aic31xx Codec module
|
||||||
|
|
||||||
|
maintainers:
|
||||||
|
- Shenghao Ding <shenghao-ding@ti.com>
|
||||||
|
|
||||||
|
description: |
|
||||||
|
CODEC output pins:
|
||||||
|
* HPL
|
||||||
|
* HPR
|
||||||
|
* SPL, devices with stereo speaker amp
|
||||||
|
* SPR, devices with stereo speaker amp
|
||||||
|
* SPK, devices with mono speaker amp
|
||||||
|
* MICBIAS
|
||||||
|
|
||||||
|
CODEC input pins:
|
||||||
|
* MIC1LP, devices with ADC
|
||||||
|
* MIC1RP, devices with ADC
|
||||||
|
* MIC1LM, devices with ADC
|
||||||
|
* AIN1, devices without ADC
|
||||||
|
* AIN2, devices without ADC
|
||||||
|
|
||||||
|
The pins can be used in referring sound node's audio-routing property.
|
||||||
|
|
||||||
|
properties:
|
||||||
|
compatible:
|
||||||
|
enum:
|
||||||
|
- ti,tlv320aic310x # - Generic TLV320AIC31xx with mono speaker amp
|
||||||
|
- ti,tlv320aic311x # - Generic TLV320AIC31xx with stereo speaker amp
|
||||||
|
- ti,tlv320aic3100 # - TLV320AIC3100 (mono speaker amp, no MiniDSP)
|
||||||
|
- ti,tlv320aic3110 # - TLV320AIC3110 (stereo speaker amp, no MiniDSP)
|
||||||
|
- ti,tlv320aic3120 # - TLV320AIC3120 (mono speaker amp, MiniDSP)
|
||||||
|
- ti,tlv320aic3111 # - TLV320AIC3111 (stereo speaker amp, MiniDSP)
|
||||||
|
- ti,tlv320dac3100 # - TLV320DAC3100 (no ADC, mono speaker amp, no MiniDSP)
|
||||||
|
- ti,tlv320dac3101 # - TLV320DAC3101 (no ADC, stereo speaker amp, no MiniDSP)
|
||||||
|
|
||||||
|
reg:
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
'#sound-dai-cells':
|
||||||
|
const: 0
|
||||||
|
|
||||||
|
HPVDD-supply: true
|
||||||
|
|
||||||
|
SPRVDD-supply: true
|
||||||
|
|
||||||
|
SPLVDD-supply: true
|
||||||
|
|
||||||
|
AVDD-supply: true
|
||||||
|
|
||||||
|
IOVDD-supply: true
|
||||||
|
|
||||||
|
DVDD-supply: true
|
||||||
|
|
||||||
|
reset-gpios:
|
||||||
|
description: GPIO specification for the active low RESET input.
|
||||||
|
|
||||||
|
ai31xx-micbias-vg:
|
||||||
|
$ref: /schemas/types.yaml#/definitions/uint32
|
||||||
|
default: 1
|
||||||
|
enum: [1, 2, 3]
|
||||||
|
description: |
|
||||||
|
MicBias Voltage setting
|
||||||
|
1 or MICBIAS_2_0V - MICBIAS output is powered to 2.0V
|
||||||
|
2 or MICBIAS_2_5V - MICBIAS output is powered to 2.5V
|
||||||
|
3 or MICBIAS_AVDD - MICBIAS output is connected to AVDD
|
||||||
|
|
||||||
|
ai31xx-ocmv:
|
||||||
|
$ref: /schemas/types.yaml#/definitions/uint32
|
||||||
|
enum: [0, 1, 2, 3]
|
||||||
|
description: |
|
||||||
|
output common-mode voltage setting
|
||||||
|
0 - 1.35V,
|
||||||
|
1 - 1.5V,
|
||||||
|
2 - 1.65V,
|
||||||
|
3 - 1.8V
|
||||||
|
|
||||||
|
gpio-reset:
|
||||||
|
description: gpio pin number used for codec reset
|
||||||
|
deprecated: true
|
||||||
|
|
||||||
|
|
||||||
|
required:
|
||||||
|
- compatible
|
||||||
|
- reg
|
||||||
|
- HPVDD-supply
|
||||||
|
- SPRVDD-supply
|
||||||
|
- SPLVDD-supply
|
||||||
|
- AVDD-supply
|
||||||
|
- IOVDD-supply
|
||||||
|
- DVDD-supply
|
||||||
|
|
||||||
|
allOf:
|
||||||
|
- $ref: dai-common.yaml#
|
||||||
|
|
||||||
|
unevaluatedProperties: false
|
||||||
|
|
||||||
|
examples:
|
||||||
|
- |
|
||||||
|
#include <dt-bindings/gpio/gpio.h>
|
||||||
|
#include <dt-bindings/sound/tlv320aic31xx.h>
|
||||||
|
|
||||||
|
i2c {
|
||||||
|
#address-cells = <1>;
|
||||||
|
#size-cells = <0>;
|
||||||
|
|
||||||
|
sound@18 {
|
||||||
|
compatible = "ti,tlv320aic311x";
|
||||||
|
reg = <0x18>;
|
||||||
|
|
||||||
|
ai31xx-micbias-vg = <MICBIAS_2_0V>;
|
||||||
|
reset-gpios = <&gpio1 17 GPIO_ACTIVE_LOW>;
|
||||||
|
|
||||||
|
HPVDD-supply = <®ulator>;
|
||||||
|
SPRVDD-supply = <®ulator>;
|
||||||
|
SPLVDD-supply = <®ulator>;
|
||||||
|
AVDD-supply = <®ulator>;
|
||||||
|
IOVDD-supply = <®ulator>;
|
||||||
|
DVDD-supply = <®ulator>;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
@@ -1,77 +0,0 @@
|
|||||||
Texas Instruments - tlv320aic31xx Codec module
|
|
||||||
|
|
||||||
The tlv320aic31xx serial control bus communicates through I2C protocols
|
|
||||||
|
|
||||||
Required properties:
|
|
||||||
|
|
||||||
- compatible - "string" - One of:
|
|
||||||
"ti,tlv320aic310x" - Generic TLV320AIC31xx with mono speaker amp
|
|
||||||
"ti,tlv320aic311x" - Generic TLV320AIC31xx with stereo speaker amp
|
|
||||||
"ti,tlv320aic3100" - TLV320AIC3100 (mono speaker amp, no MiniDSP)
|
|
||||||
"ti,tlv320aic3110" - TLV320AIC3110 (stereo speaker amp, no MiniDSP)
|
|
||||||
"ti,tlv320aic3120" - TLV320AIC3120 (mono speaker amp, MiniDSP)
|
|
||||||
"ti,tlv320aic3111" - TLV320AIC3111 (stereo speaker amp, MiniDSP)
|
|
||||||
"ti,tlv320dac3100" - TLV320DAC3100 (no ADC, mono speaker amp, no MiniDSP)
|
|
||||||
"ti,tlv320dac3101" - TLV320DAC3101 (no ADC, stereo speaker amp, no MiniDSP)
|
|
||||||
|
|
||||||
- reg - <int> - I2C slave address
|
|
||||||
- HPVDD-supply, SPRVDD-supply, SPLVDD-supply, AVDD-supply, IOVDD-supply,
|
|
||||||
DVDD-supply : power supplies for the device as covered in
|
|
||||||
Documentation/devicetree/bindings/regulator/regulator.txt
|
|
||||||
|
|
||||||
|
|
||||||
Optional properties:
|
|
||||||
|
|
||||||
- reset-gpios - GPIO specification for the active low RESET input.
|
|
||||||
- ai31xx-micbias-vg - MicBias Voltage setting
|
|
||||||
1 or MICBIAS_2_0V - MICBIAS output is powered to 2.0V
|
|
||||||
2 or MICBIAS_2_5V - MICBIAS output is powered to 2.5V
|
|
||||||
3 or MICBIAS_AVDD - MICBIAS output is connected to AVDD
|
|
||||||
If this node is not mentioned or if the value is unknown, then
|
|
||||||
micbias is set to 2.0V.
|
|
||||||
- ai31xx-ocmv - output common-mode voltage setting
|
|
||||||
0 - 1.35V,
|
|
||||||
1 - 1.5V,
|
|
||||||
2 - 1.65V,
|
|
||||||
3 - 1.8V
|
|
||||||
|
|
||||||
Deprecated properties:
|
|
||||||
|
|
||||||
- gpio-reset - gpio pin number used for codec reset
|
|
||||||
|
|
||||||
CODEC output pins:
|
|
||||||
* HPL
|
|
||||||
* HPR
|
|
||||||
* SPL, devices with stereo speaker amp
|
|
||||||
* SPR, devices with stereo speaker amp
|
|
||||||
* SPK, devices with mono speaker amp
|
|
||||||
* MICBIAS
|
|
||||||
|
|
||||||
CODEC input pins:
|
|
||||||
* MIC1LP, devices with ADC
|
|
||||||
* MIC1RP, devices with ADC
|
|
||||||
* MIC1LM, devices with ADC
|
|
||||||
* AIN1, devices without ADC
|
|
||||||
* AIN2, devices without ADC
|
|
||||||
|
|
||||||
The pins can be used in referring sound node's audio-routing property.
|
|
||||||
|
|
||||||
Example:
|
|
||||||
#include <dt-bindings/gpio/gpio.h>
|
|
||||||
#include <dt-bindings/sound/tlv320aic31xx.h>
|
|
||||||
|
|
||||||
tlv320aic31xx: tlv320aic31xx@18 {
|
|
||||||
compatible = "ti,tlv320aic311x";
|
|
||||||
reg = <0x18>;
|
|
||||||
|
|
||||||
ai31xx-micbias-vg = <MICBIAS_OFF>;
|
|
||||||
|
|
||||||
reset-gpios = <&gpio1 17 GPIO_ACTIVE_LOW>;
|
|
||||||
|
|
||||||
HPVDD-supply = <®ulator>;
|
|
||||||
SPRVDD-supply = <®ulator>;
|
|
||||||
SPLVDD-supply = <®ulator>;
|
|
||||||
AVDD-supply = <®ulator>;
|
|
||||||
IOVDD-supply = <®ulator>;
|
|
||||||
DVDD-supply = <®ulator>;
|
|
||||||
};
|
|
||||||
Reference in New Issue
Block a user