Re: [PATCH 2/7] dt-bindings: clock: qcom: Add bindings documentation for the Glymur TCSR

From: Krzysztof Kozlowski
Date: Mon Jul 21 2025 - 05:22:11 EST


On Wed, Jul 16, 2025 at 08:50:12PM +0530, Pankaj Patil wrote:
> From: Taniya Das <taniya.das@xxxxxxxxxxxxxxxx>
>
> The Glymur TCSR block provides CLKREF clocks for EDP, PCIe, and USB. Add
> this to the TCSR clock controller binding together with identifiers for
> the clocks
>
> Signed-off-by: Taniya Das <taniya.das@xxxxxxxxxxxxxxxx>
> Signed-off-by: Pankaj Patil <pankaj.patil@xxxxxxxxxxxxxxxx>

A nit, subject: drop second/last, redundant "bindings". The
"dt-bindings" prefix is already stating that these are bindings.
See also:
https://elixir.bootlin.com/linux/v6.7-rc8/source/Documentation/devicetree/bindings/submitting-patches.rst#L18

And same for documentation...

> ---
> .../bindings/clock/qcom,sm8550-tcsr.yaml | 3 +++
> .../dt-bindings/clock/qcom,glymur-tcsrcc.h | 24 +++++++++++++++++++
> 2 files changed, 27 insertions(+)
> create mode 100644 include/dt-bindings/clock/qcom,glymur-tcsrcc.h
>
> diff --git a/Documentation/devicetree/bindings/clock/qcom,sm8550-tcsr.yaml b/Documentation/devicetree/bindings/clock/qcom,sm8550-tcsr.yaml
> index f3afbb25e868..9fbf88836782 100644
> --- a/Documentation/devicetree/bindings/clock/qcom,sm8550-tcsr.yaml
> +++ b/Documentation/devicetree/bindings/clock/qcom,sm8550-tcsr.yaml
> @@ -8,12 +8,14 @@ title: Qualcomm TCSR Clock Controller on SM8550
>
> maintainers:
> - Bjorn Andersson <andersson@xxxxxxxxxx>
> + - Taniya Das <taniya.das@xxxxxxxxxxxxxxxx>
>
> description: |
> Qualcomm TCSR clock control module provides the clocks, resets and
> power domains on SM8550
>
> See also:
> + - include/dt-bindings/clock/qcom,glymur-tcsr.h
> - include/dt-bindings/clock/qcom,sm8550-tcsr.h
> - include/dt-bindings/clock/qcom,sm8650-tcsr.h
> - include/dt-bindings/clock/qcom,sm8750-tcsr.h
> @@ -22,6 +24,7 @@ properties:
> compatible:
> items:
> - enum:
> + - qcom,glymur-tcsr
> - qcom,sar2130p-tcsr
> - qcom,sm8550-tcsr
> - qcom,sm8650-tcsr
> diff --git a/include/dt-bindings/clock/qcom,glymur-tcsrcc.h b/include/dt-bindings/clock/qcom,glymur-tcsrcc.h
> new file mode 100644
> index 000000000000..72614226b113
> --- /dev/null
> +++ b/include/dt-bindings/clock/qcom,glymur-tcsrcc.h

Filename matching compatible.

Best regards,
Krzysztof