linux/Documentation/devicetree/bindings/sound/realtek,rt5640.yaml
Neil Armstrong eba5a0bac2
ASoC: dt-bindings: realtek,rt5640: Convert to dtschema
Convert the RT5640/RT5639 audio CODEC bindings to DT schema.

Signed-off-by: Neil Armstrong <neil.armstrong@linaro.org>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20240911-topic-amlogic-arm32-upstream-bindings-fixes-covert-realtek-rt5640-v1-1-6b3745e34540@linaro.org
Signed-off-by: Mark Brown <broonie@kernel.org>
2024-09-30 01:11:02 +02:00

147 lines
3.4 KiB
YAML

# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/sound/realtek,rt5640.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: RT5640/RT5639 audio CODEC
maintainers:
- Neil Armstrong <neil.armstrong@linaro.org>
description: |
This device supports I2C only.
Pins on the device (for linking into audio routes) for RT5639/RT5640:
* DMIC1
* DMIC2
* MICBIAS1
* IN1P
* IN1N
* IN2P
* IN2N
* IN3P
* IN3N
* HPOL
* HPOR
* LOUTL
* LOUTR
* SPOLP
* SPOLN
* SPORP
* SPORN
Additional pins on the device for RT5640:
* MONOP
* MONON
allOf:
- $ref: dai-common.yaml#
properties:
compatible:
enum:
- realtek,rt5640
- realtek,rt5639
reg:
maxItems: 1
interrupts:
maxItems: 1
description: The CODEC's interrupt output.
realtek,in1-differential:
description:
Indicate MIC1 input is differential, rather than single-ended.
type: boolean
realtek,in2-differential:
description:
Indicate MIC2 input is differential, rather than single-ended.
type: boolean
realtek,in3-differential:
description:
Indicate MIC3 input is differential, rather than single-ended.
type: boolean
realtek,lout-differential:
description:
Indicate LOUT output is differential, rather than single-ended.
type: boolean
realtek,dmic1-data-pin:
description: Specify which pin to be used as DMIC1 data pin.
$ref: /schemas/types.yaml#/definitions/uint32
enum:
- 0 # dmic1 is not used
- 1 # using IN2P pin as dmic1 data pin
- 2 # using GPIO3 pin as dmic1 data pin
realtek,dmic2-data-pin:
description: Specify which pin to be used as DMIC2 data pin.
$ref: /schemas/types.yaml#/definitions/uint32
enum:
- 0 # dmic2 is not used
- 1 # using IN2N pin as dmic2 data pin
- 2 # using GPIO4 pin as dmic2 data pin
realtek,jack-detect-source:
description: The Jack Detect source.
$ref: /schemas/types.yaml#/definitions/uint32
enum:
- 0 # Jack Detect function is not used
- 1 # Use GPIO1 for jack-detect
- 2 # Use JD1_IN4P for jack-detect
- 3 # Use JD2_IN4N for jack-detect
- 4 # Use GPIO2 for jack-detect
- 5 # Use GPIO3 for jack-detect
- 6 # Use GPIO4 for jack-detect
realtek,jack-detect-not-inverted:
description:
Normal jack-detect switches give an inverted signal, set this bool
in the rare case you've a jack-detect switch which is not inverted.
type: boolean
realtek,over-current-threshold-microamp:
description: micbias over-current detection threshold in µA
enum:
- 600
- 1500
- 2000
realtek,over-current-scale-factor:
description: micbias over-current detection scale-factor
$ref: /schemas/types.yaml#/definitions/uint32
enum:
- 0 # Scale current by 0.5
- 1 # Scale current by 0.75
- 2 # Scale current by 1.0
- 3 # Scale current by 1.5
required:
- compatible
- reg
- interrupts
unevaluatedProperties: false
examples:
- |
#include <dt-bindings/gpio/gpio.h>
#include <dt-bindings/interrupt-controller/irq.h>
i2c {
#address-cells = <1>;
#size-cells = <0>;
codec@1a {
compatible = "realtek,rt5640";
reg = <0x1a>;
interrupt-parent = <&gpio>;
interrupts = <7 IRQ_TYPE_EDGE_FALLING>;
};
};