Re: [PATCH v10 1/1] dt-bindings: mtd: marvell-nand: Convert to YAML DT scheme

From: Rob Herring
Date: Tue Jun 20 2023 - 13:25:23 EST



On Mon, 19 Jun 2023 16:07:42 +1200, Chris Packham wrote:
> From: Vadym Kochan <vadym.kochan@xxxxxxxxxxx>
>
> Switch the DT binding to a YAML schema to enable the DT validation.
>
> There was also an incorrect reference to dma-names being "rxtx" where
> the driver and existing device trees actually use dma-names = "data" so
> this is corrected in the conversion.
>
> Signed-off-by: Vadym Kochan <vadym.kochan@xxxxxxxxxxx>
> Signed-off-by: Chris Packham <chris.packham@xxxxxxxxxxxxxxxxxxx>
> ---
>
> Notes:
> Changes in v10:
> - Formatting for description
> - Restrict clocks to 1 item for non-8K devices
> - Don't allow "marvell,armada-8k-nand-controller" without
> "marvell,armada370-nand-controller" (undoes a change from v8)
>
> Changes in v9:
> - depend on series from Miquel
> https://lore.kernel.org/linux-mtd/20230606175246.190465-1-miquel.raynal@xxxxxxxxxxx/
> - enforce minimum/maximum for nand-rb
> - move required: block for controller
> - move unevaluatedProperties: for nand chip
> - remove label, partitions and nand-on-flash-bbt which are covered by
> generic schema
>
> Changes in v8:
> - Mark deprecated compatible values as such
> - Allow "marvell,armada-8k-nand-controller" without
> "marvell,armada370-nand-controller"
> - Make dma-names usage reflect reality
> - Update commit message
>
> Changes in v7:
> - Restore "label" and "partitions" properties (should be picked up via
> nand-controller.yaml but aren't)
> - Add/restore nand-on-flash-bbt and nand-ecc-mode which aren't covered
> by nand-controller.yaml.
> - Use "unevalautedProperties: false"
> - Corrections for clock-names, dma-names, nand-rb and nand-ecc-strength
> - Add pxa3xx-nand-controller example
>
> Changes in v6:
> - remove properties covered by nand-controller.yaml
> - add example using armada-8k compatible
>
> earlier changes:
>
> v5:
> 1) Get back "label" and "partitions" properties but without
> ref to the "partition.yaml" which was wrongly used.
>
> 2) Add "additionalProperties: false" for nand@ because all possible
> properties are described.
>
> v4:
> 1) Remove "label" and "partitions" properties
>
> 2) Use 2 clocks for A7K/8K platform which is a requirement
>
> v3:
> 1) Remove txt version from the MAINTAINERS list
>
> 2) Use enum for some of compatible strings
>
> 3) Drop:
> #address-cells
> #size-cells:
>
> as they are inherited from the nand-controller.yaml
>
> 4) Add restriction to use 2 clocks for A8K SoC
>
> 5) Dropped description for clock-names and extend it with
> minItems: 1
>
> 6) Drop description for "dmas"
>
> 7) Use "unevalautedProperties: false"
>
> 8) Drop quites from yaml refs.
>
> 9) Use 4-space indentation for the example section
>
> v2:
> 1) Fixed warning by yamllint with incorrect indentation for compatible list
>
> .../bindings/mtd/marvell,nand-controller.yaml | 226 ++++++++++++++++++
> .../devicetree/bindings/mtd/marvell-nand.txt | 126 ----------
> MAINTAINERS | 1 -
> 3 files changed, 226 insertions(+), 127 deletions(-)
> create mode 100644 Documentation/devicetree/bindings/mtd/marvell,nand-controller.yaml
> delete mode 100644 Documentation/devicetree/bindings/mtd/marvell-nand.txt
>

Reviewed-by: Rob Herring <robh@xxxxxxxxxx>