Re: [PATCH v1 29/43] dt-bindings: rtc: Add ST M48T86

From: Krzysztof Kozlowski
Date: Thu Jun 01 2023 - 04:18:38 EST


On 01/06/2023 07:45, Nikita Shubin wrote:
> Add YAML bindings for ST M48T86 / Dallas DS12887 RTC.
>
> Signed-off-by: Nikita Shubin <nikita.shubin@xxxxxxxxxxx>
> ---
>
> Notes:
> v0 -> v1:
>
> - s/dallas/st/
> - description for regs
> - s/additionalProperties/unevaluatedProperties/
> - add ref rtc.yaml
> - changed compatible to st,m48t86
> - dropped label in example
> - replaced Alessandro Alessandro to Alexandre Belloni
>
> .../bindings/rtc/st,m48t86-rtc.yaml | 38 +++++++++++++++++++
> 1 file changed, 38 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/rtc/st,m48t86-rtc.yaml
>
> diff --git a/Documentation/devicetree/bindings/rtc/st,m48t86-rtc.yaml b/Documentation/devicetree/bindings/rtc/st,m48t86-rtc.yaml
> new file mode 100644
> index 000000000000..eb8e6451d7c8
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/rtc/st,m48t86-rtc.yaml

Filename based on compatible, so drop "rtc".

> @@ -0,0 +1,38 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/rtc/st,m48t86-rtc.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: ST M48T86 / Dallas DS12887 RTC wirh SRAM

typo: with

> +
> +maintainers:
> + - Alexandre Belloni <alexandre.belloni@xxxxxxxxxxx>
> +
> +properties:
> + compatible:
> + enum:
> + - st,m48t86
> +
> + reg:
> + items:
> + - description: index register
> + - description: data register
> +
> +allOf:
> + - $ref: rtc.yaml
> +
> +unevaluatedProperties: false
> +
> +required:
> + - compatible
> + - reg

required goes after properties:

Keep the same order in all your patches.

> +
> +examples:
> + - |
> + rtc@10800000 {
> + compatible = "st,m48t86";
> + reg = <0x10800000 0x1>, <0x11700000 0x1>;

One byte long? Not a word?

> + };
> +
> +...

Best regards,
Krzysztof