Re: [PATCH v2 1/2] dt-bindings: sound: simple-card: add sysclk-cpu-first flag

[Krzysztof Kozlowski <krzk@kernel.org>]

On 10/02/2026 17:45, Stefano Radaelli wrote:
> From: Stefano Radaelli <stefano.r@variscite.com>
> 
> The simple-audio-card driver can program sysclk for CPU and codec DAIs
> during hw_params. Some setups require calling the CPU DAI sysclk first
> so that the codec sees the final MCLK rate.
> 
> Document a new boolean DT flag, sysclk-cpu-first, which allows selecting
> CPU-first sysclk ordering where needed. The property is supported both
> as a top-level simple-audio-card property (prefixed) and on dai-link
> subnodes (non-prefixed).

Please use scripts/get_maintainers.pl to get a list of necessary people
and lists to CC. It might happen, that command when run on an older
kernel, gives you outdated entries. Therefore please be sure you base
your patches on recent Linux kernel.

Tools like b4 or scripts/get_maintainer.pl provide you proper list of
people, so fix your workflow. Tools might also fail if you work on some
ancient tree (don't, instead use mainline) or work on fork of kernel
(don't, instead use mainline). Just use b4 and everything should be
fine, although remember about `b4 prep --auto-to-cc` if you added new
patches to the patchset.

You missed at least devicetree list (maybe more), so this won't be
tested by automated tooling. Performing review on untested code might be
a waste of time.

Please kindly resend and include all necessary To/Cc entries.

> 
> Signed-off-by: Stefano Radaelli <stefano.r@variscite.com>
> ---
>  .../devicetree/bindings/sound/simple-card.yaml        | 11 +++++++++++
>  1 file changed, 11 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/sound/simple-card.yaml b/Documentation/devicetree/bindings/sound/simple-card.yaml
> index 533d0a1da56e..ddad440636be 100644
> --- a/Documentation/devicetree/bindings/sound/simple-card.yaml
> +++ b/Documentation/devicetree/bindings/sound/simple-card.yaml
> @@ -35,6 +35,13 @@ definitions:
>      description: see tdm-slot.txt.
>      $ref: /schemas/types.yaml#/definitions/uint32
>  
> +  sysclk-cpu-first:
> +    description:
> +      When mclk-fs is used, configure CPU DAI sysclk before codec DAI sysclk
> +      so the codec sees the final MCLK rate.
> +      This property only affects the mclk-fs code path.

You described the desired Linux feature or behavior, not the actual
hardware. The bindings are about the latter, so instead you need to
rephrase the property and its description to match actual hardware
capabilities/features/configuration etc.


Best regards,
Krzysztof