Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

ASoC: dt-bindings: document the adau1373 Codec

Describe the adau1373 Low Power Codec with Speaker and
Headphone Amplifier.

While at it, properly add a MAINTAINERS entry for ADI sound bindings.

Signed-off-by: Nuno Sa <nuno.sa@analog.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/20241028-adau1373-shutdown-v2-2-647f56bbd182@analog.com
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Nuno Sa and committed by
Mark Brown
6b26a56f bebf0f45

+112
+111
Documentation/devicetree/bindings/sound/adi,adau1373.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/adi,adau1373.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Analog Devices ADAU1373 CODEC 8 + 9 + maintainers: 10 + - Nuno Sá <nuno.sa@analog.com> 11 + 12 + description: | 13 + Analog Devices ADAU1373 Low power codec with speaker and headphone amplifiers. 14 + https://www.analog.com/media/en/technical-documentation/data-sheets/ADAU1373.pdf 15 + 16 + allOf: 17 + - $ref: dai-common.yaml# 18 + 19 + properties: 20 + compatible: 21 + enum: 22 + - adi,adau1373 23 + 24 + reg: 25 + maxItems: 1 26 + 27 + "#sound-dai-cells": 28 + const: 0 29 + 30 + powerdown-gpios: 31 + description: GPIO used for hardware power-down. 32 + maxItems: 1 33 + 34 + adi,micbias1-microvolt: 35 + description: 36 + This property sets the microphone bias voltage for the first microphone. 37 + enum: [1800000, 2200000, 2600000, 2900000] 38 + default: 2900000 39 + 40 + adi,micbias2-microvolt: 41 + description: 42 + This property sets the microphone bias voltage for the second microphone. 43 + enum: [1800000, 2200000, 2600000, 2900000] 44 + default: 2900000 45 + 46 + adi,input1-differential: 47 + description: This property sets the first analog input as differential. 48 + type: boolean 49 + 50 + adi,input2-differential: 51 + description: This property sets the second analog input as differential. 52 + type: boolean 53 + 54 + adi,input3-differential: 55 + description: This property sets the third analog input as differential. 56 + type: boolean 57 + 58 + adi,input4-differential: 59 + description: This property sets the fourth analog input as differential. 60 + type: boolean 61 + 62 + adi,lineout-differential: 63 + description: This property sets the line output as differential. 64 + type: boolean 65 + 66 + adi,lineout-gnd-sense: 67 + description: This property enables the line output ground sense control. 68 + type: boolean 69 + 70 + adi,drc-settings: 71 + description: 72 + This setting is used to control the dynamic range of the signal. The 73 + device provides a maximum of three full band DRCs with 13 entries each. 74 + $ref: /schemas/types.yaml#/definitions/uint8-array 75 + oneOf: 76 + - minItems: 13 77 + maxItems: 13 78 + - minItems: 26 79 + maxItems: 26 80 + - minItems: 39 81 + maxItems: 39 82 + 83 + required: 84 + - "#sound-dai-cells" 85 + - compatible 86 + - reg 87 + 88 + unevaluatedProperties: false 89 + 90 + examples: 91 + - | 92 + #include <dt-bindings/gpio/gpio.h> 93 + 94 + i2c { 95 + #address-cells = <1>; 96 + #size-cells = <0>; 97 + audio-codec@1a { 98 + compatible = "adi,adau1373"; 99 + reg = <0x1a>; 100 + #sound-dai-cells = <0>; 101 + powerdown-gpios = <&gpio 100 GPIO_ACTIVE_LOW>; 102 + adi,input2-differential; 103 + adi,input1-differential; 104 + adi,lineout-differential; 105 + adi,micbias2-microvolt = <1800000>; 106 + adi,drc-settings = /bits/ 8 < 107 + 0xff 0xff 0x1 0x2 0xa 0xa 0xd 0x1 0xff 0xff 0x5 0xd 0xff 108 + >; 109 + }; 110 + }; 111 + ...
+1
MAINTAINERS
··· 1521 1521 S: Supported 1522 1522 W: http://wiki.analog.com/ 1523 1523 W: https://ez.analog.com/linux-software-drivers 1524 + F: Documentation/devicetree/bindings/sound/adi,* 1524 1525 F: sound/soc/codecs/ad1* 1525 1526 F: sound/soc/codecs/ad7* 1526 1527 F: sound/soc/codecs/adau*