Re: [PATCH V3 2/2] ASoC: dt-bindings: max98363: add soundwire amplifier

From: Krzysztof Kozlowski
Date: Fri Mar 24 2023 - 07:36:56 EST


On 23/03/2023 18:52, “Ryan wrote:
> From: Ryan Lee <ryans.lee@xxxxxxxxxx>
>
> This patch adds dt-bindings information for Analog Devices MAX98363
> SoundWire Amplifier.

No improvements here. So reminding:

Do not use "This commit/patch", but imperative mood. See:
https://elixir.bootlin.com/linux/v5.17.1/source/Documentation/process/submitting-patches.rst#L95

>
> Signed-off-by: Ryan Lee <ryans.lee@xxxxxxxxxx>
> ---
> Changes from v1:
> Fixed a syntax error for the 'dt_binding_check' build.
> Removed unnecessary properties.
> Added description about SoundWire device ID of MAX98363
> Changes from v2:
> Removed the legacy from i2c/i2s driver and added SoundWire device ID info.
> Added missing information about DAI.
>
> .../bindings/sound/adi,max98363.yaml | 62 +++++++++++++++++++
> 1 file changed, 62 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/sound/adi,max98363.yaml
>
> diff --git a/Documentation/devicetree/bindings/sound/adi,max98363.yaml b/Documentation/devicetree/bindings/sound/adi,max98363.yaml
> new file mode 100644
> index 000000000000..92352a23e1cb
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/sound/adi,max98363.yaml
> @@ -0,0 +1,62 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/sound/adi,max98363.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Analog Devices MAX98363 SoundWire Amplifier
> +
> +maintainers:
> + - Ryan Lee <ryans.lee@xxxxxxxxxx>
> +
> +description:
> + The MAX98363 is a SoundWire input Class D mono amplifier that
> + supports MIPI SoundWire v1.2-compatible digital interface for
> + audio and control data.
> + SoundWire peripheral device ID of MAX98363 is 0x3X019F836300

lowercase hex

> + where X is the peripheral device unique ID decoded from pin.
> + It supports up to 10 peripheral devices(0x0 to 0x9).
> +
> +allOf:
> + - $ref: dai-common.yaml#
> +
> +properties:
> + compatible:
> + const: sdw3019F836300

lowercase hex (also in example)

> +
> + reg:
> + maxItems: 1
> +
> + '#sound-dai-cells':
> + const: 0
> +
> + sound-name-prefix: true

Drop this.

> +
> +required:
> + - compatible
> + - reg
> + - "#sound-dai-cells"
> +
> +additionalProperties: false

Instead:
unevaluatedProperties: false

Best regards,
Krzysztof