| Message ID | 20230608054230.344014-1-ryan.lee.analog@gmail.com |
|---|---|
| State | Superseded |
| Headers | show |
| Series | [1/2] ASoC: dt-bindings: max98388: add amplifier driver | expand |
> -----Original Message----- > From: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> > Sent: Thursday, June 8, 2023 12:18 AM > To: “Ryan <ryan.lee.analog@gmail.com>; lgirdwood@gmail.com; > broonie@kernel.org; robh+dt@kernel.org; > krzysztof.kozlowski+dt@linaro.org; perex@perex.cz; tiwai@suse.com; > rf@opensource.cirrus.com; Lee, RyanS <RyanS.Lee@analog.com>; > wangweidong.a@awinic.com; shumingf@realtek.com; > herve.codina@bootlin.com; ckeepax@opensource.cirrus.com; > doug@schmorgal.com; ajye_huang@compal.corp-partner.google.com; > kiseok.jo@irondevice.com; alsa-devel@alsa-project.org; > devicetree@vger.kernel.org; linux-kernel@vger.kernel.org > Cc: venkataprasad.potturu@amd.com > Subject: Re: [PATCH 1/2] ASoC: dt-bindings: max98388: add amplifier driver > > [External] > > On 08/06/2023 07:42, “Ryan wrote: > > From: Ryan Lee <ryans.lee@analog.com> > > > > Add dt-bindings information for Analog Devices MAX98388 I2S Amplifier > > > > Signed-off-by: Ryan Lee <ryans.lee@analog.com> > > Thank you for your patch. There is something to discuss/improve. Thanks for the comments. I shall fix the issues and submit the patch again. > > > + > > +allOf: > > + - $ref: dai-common.yaml# > > + > > +properties: > > + compatible: > > + enum: > > + - adi,max98388 > > Blank line > > > + reg: > > + maxItems: 1 > > + description: I2C address of the device. > > Drop description, it's obvious. > > > + > > + '#sound-dai-cells': > > + const: 0 > > + > > + adi,vmon-slot-no: > > + description: slot number of the voltage feedback monitor > > + $ref: "/schemas/types.yaml#/definitions/uint32" > > Drop quotes. > > > + minimum: 0 > > + maximum: 15 > > + default: 0 > > + > > + adi,imon-slot-no: > > + description: slot number of the current feedback monitor > > + $ref: "/schemas/types.yaml#/definitions/uint32" > > Drop quotes. > > > + minimum: 0 > > + maximum: 15 > > + default: 1 > > + > > + adi,interleave-mode: > > + description: > > + For cases where a single combined channel for the I/V feedback data > > + is not sufficient, the device can also be configured to share > > + a single data output channel on alternating frames. > > + In this configuration, the current and voltage data will be frame > > + interleaved on a single output channel. > > + type: boolean > > + > > + reset-gpios: > > + maxItems: 1 > > + > > +required: > > + - compatible > > + - reg > > + - "#sound-dai-cells" > > Keep consistent quotes - either ' or " > > > + > > +unevaluatedProperties: false > > > Best regards, > Krzysztof
diff --git a/Documentation/devicetree/bindings/sound/adi,max98388.yaml b/Documentation/devicetree/bindings/sound/adi,max98388.yaml new file mode 100644 index 000000000000..fc0ac8d8c3ae --- /dev/null +++ b/Documentation/devicetree/bindings/sound/adi,max98388.yaml @@ -0,0 +1,79 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/adi,max98388.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Analog Devices MAX98388 Speaker Amplifier + +maintainers: + - Ryan Lee <ryans.lee@analog.com> + +description: + The MAX98388 is a mono Class-D speaker amplifier with I/V feedback. + The device provides a PCM interface for audio data and a standard + I2C interface for control data communication. + +allOf: + - $ref: dai-common.yaml# + +properties: + compatible: + enum: + - adi,max98388 + reg: + maxItems: 1 + description: I2C address of the device. + + '#sound-dai-cells': + const: 0 + + adi,vmon-slot-no: + description: slot number of the voltage feedback monitor + $ref: "/schemas/types.yaml#/definitions/uint32" + minimum: 0 + maximum: 15 + default: 0 + + adi,imon-slot-no: + description: slot number of the current feedback monitor + $ref: "/schemas/types.yaml#/definitions/uint32" + minimum: 0 + maximum: 15 + default: 1 + + adi,interleave-mode: + description: + For cases where a single combined channel for the I/V feedback data + is not sufficient, the device can also be configured to share + a single data output channel on alternating frames. + In this configuration, the current and voltage data will be frame + interleaved on a single output channel. + type: boolean + + reset-gpios: + maxItems: 1 + +required: + - compatible + - reg + - "#sound-dai-cells" + +unevaluatedProperties: false + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + i2c { + #address-cells = <1>; + #size-cells = <0>; + max98388: amplifier@39 { + compatible = "adi,max98388"; + reg = <0x39>; + #sound-dai-cells = <0>; + adi,vmon-slot-no = <0>; + adi,imon-slot-no = <1>; + adi,interleave-mode; + reset-gpios = <&gpio 4 GPIO_ACTIVE_LOW>; + }; + };