Devicetree
 help / color / mirror / Atom feed
From: Krzysztof Kozlowski <krzk@kernel.org>
To: Shengjiu Wang <shengjiu.wang@gmail.com>
Cc: shengjiu.wang@oss.nxp.com, lgirdwood@gmail.com,
	broonie@kernel.org, robh@kernel.org, krzk+dt@kernel.org,
	conor+dt@kernel.org, Frank.Li@nxp.com, s.hauer@pengutronix.de,
	kernel@pengutronix.de, festevam@gmail.com, shawnguo@kernel.org,
	linux-sound@vger.kernel.org, devicetree@vger.kernel.org,
	imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org,
	linux-kernel@vger.kernel.org, Xiubo.Lee@gmail.com,
	nicoleotsuka@gmail.com, perex@perex.cz, tiwai@suse.com,
	linuxppc-dev@lists.ozlabs.org,
	Shengjiu Wang <shengjiu.wang@nxp.com>
Subject: Re: [PATCH v3 1/5] ASoC: dt-bindings: fsl,imx-asrc: update port binding to support multiple paths
Date: Tue, 11 Aug 2026 07:44:48 +0200	[thread overview]
Message-ID: <dc40dcae-3017-4e61-8c6d-7e6127e4ee77@kernel.org> (raw)
In-Reply-To: <CAA+D8AM9s7EX-G246Hf2=DOx5q2qXWg_MjUCaoJ8RggOjp+5cQ@mail.gmail.com>

On 11/08/2026 04:28, Shengjiu Wang wrote:
> On Mon, Aug 10, 2026 at 3:14 PM Krzysztof Kozlowski <krzk@kernel.org> wrote:
>>
>> On Tue, Aug 04, 2026 at 06:02:14PM +0800, shengjiu.wang@oss.nxp.com wrote:
>>> From: Shengjiu Wang <shengjiu.wang@nxp.com>
>>>
>>> The i.MX ASRC hardware supports up to three conversion pairs (A, B, C).
>>
>> Which SoC? Did you read this binding you are changing?
> 
> The i.MX35 ASRC (the original) already supports three conversion pairs
> (A, B, C).
> All subsequent SoCs that reuse this IP -- including i.MX53, i.MX8QM, i.MX8QXP,
> i.MX952, share the same three-pair hardware. This binding covers all of them.
> 
>>
>>> The existing binding exposed only a single generic audio-graph port,
>>> which cannot represent independent conversion paths when multiple pairs
>>> are in use simultaneously.
>>>
>>> Add a ports container that enumerates up to three sub-ports, each
>>> representing an independent conversion path:
>>>   port@0 -- conversion path 0
>>>   port@1 -- conversion path 1
>>>   port@2 -- conversion path 2
>>>
>>> Each sub-port references audio-graph-port.yaml as before. Hardware pairs
>>> are allocated dynamically at stream open time; each active stream
>>> direction (playback or capture) on a port consumes one hardware pair.
>>>
>>> For backwards compatibility, keep the old single port property but mark
>>
>> Why? Did the old hardware change that it has more ports/paths?
> 
> The hardware has always supported three pairs; the original binding simply
> did not expose them all. This patch corrects the binding to match what the
> hardware has always been capable of.
> 
>>
>>> it deprecated. A schema constraint (not: required: [port, ports]) ensures
>>> that both forms cannot be used at the same time. The binding example is
>>> updated to show the preferred ports form.
>>>
>>> No existing upstream DTS file for fsl,imx-asrc uses the previously
>>> documented single 'port' node, so this change does not break any
>>> in-tree device tree.
>>
>> Does it break other users of this binding?
> 
> No. The existing single 'port' property is kept and marked deprecated
> so that any out-of-tree device tree still works without modification.
> The new 'ports' form is additive only.
> 
>>
>> Why mentioning upstream in the first place? Either this change breaks
>> ABI or not, explain that.
> 
> The deprecated 'port' property is retained, so this change is fully backwards
> compatible and does not break ABI.

So why? Drop redundant parts.

Best regards,
Krzysztof

  reply	other threads:[~2026-08-11  5:44 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-08-04 10:02 [PATCH v3 0/5] ASoC: fsl_asrc/fsl_easrc: expose per-pair/context DAIs and fix DMA race shengjiu.wang
2026-08-04 10:02 ` [PATCH v3 1/5] ASoC: dt-bindings: fsl,imx-asrc: update port binding to support multiple paths shengjiu.wang
2026-08-04 14:39   ` Frank Li
2026-08-05  6:57     ` Shengjiu Wang
2026-08-05 17:06       ` Frank Li
2026-08-06  5:27         ` Shengjiu Wang
2026-08-06 16:40           ` Frank Li
2026-08-10  7:12     ` Krzysztof Kozlowski
2026-08-10 19:07       ` Frank Li
2026-08-11  5:44         ` Krzysztof Kozlowski
2026-08-10  7:14   ` Krzysztof Kozlowski
2026-08-11  2:28     ` Shengjiu Wang
2026-08-11  5:44       ` Krzysztof Kozlowski [this message]
2026-08-11  7:33         ` Shengjiu Wang
2026-08-11  7:36           ` Krzysztof Kozlowski
2026-08-11  8:17             ` Shengjiu Wang
2026-08-04 10:02 ` [PATCH v3 2/5] ASoC: dt-bindings: fsl,easrc: add ports binding for multiple conversion paths shengjiu.wang
2026-08-04 14:40   ` Frank Li
2026-08-04 10:02 ` [PATCH v3 3/5] ASoC: fsl_asrc/fsl_easrc: move DMA params into pair/context struct shengjiu.wang
2026-08-04 10:15   ` sashiko-bot
2026-08-04 10:02 ` [PATCH v3 4/5] ASoC: fsl_asrc: expose individual DAIs per conversion path shengjiu.wang
2026-08-04 10:20   ` sashiko-bot
2026-08-04 10:02 ` [PATCH v3 5/5] ASoC: fsl_easrc: " shengjiu.wang
2026-08-04 10:12   ` sashiko-bot

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=dc40dcae-3017-4e61-8c6d-7e6127e4ee77@kernel.org \
    --to=krzk@kernel.org \
    --cc=Frank.Li@nxp.com \
    --cc=Xiubo.Lee@gmail.com \
    --cc=broonie@kernel.org \
    --cc=conor+dt@kernel.org \
    --cc=devicetree@vger.kernel.org \
    --cc=festevam@gmail.com \
    --cc=imx@lists.linux.dev \
    --cc=kernel@pengutronix.de \
    --cc=krzk+dt@kernel.org \
    --cc=lgirdwood@gmail.com \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-sound@vger.kernel.org \
    --cc=linuxppc-dev@lists.ozlabs.org \
    --cc=nicoleotsuka@gmail.com \
    --cc=perex@perex.cz \
    --cc=robh@kernel.org \
    --cc=s.hauer@pengutronix.de \
    --cc=shawnguo@kernel.org \
    --cc=shengjiu.wang@gmail.com \
    --cc=shengjiu.wang@nxp.com \
    --cc=shengjiu.wang@oss.nxp.com \
    --cc=tiwai@suse.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox