dt-bindings: mtd: Create a file for raw NAND chip properties
authorMiquel Raynal <miquel.raynal@bootlin.com>
Mon, 19 Jun 2023 09:29:01 +0000 (11:29 +0200)
committerMiquel Raynal <miquel.raynal@bootlin.com>
Thu, 22 Jun 2023 21:04:20 +0000 (23:04 +0200)
commit46721a1c9f829fe934eb1ec03e19b9e2896b995a
tree47999e6197d96107e9968292d6e2c7009da46091
parentda787688a5a08ece05a2f752d38b281fab8df846
dt-bindings: mtd: Create a file for raw NAND chip properties

In an effort to constrain as much as we can the existing binding, we
want to add "unevaluatedProperties: false" in all the NAND chip
descriptions part of NAND controller bindings. But in order to do that
properly, we also need to reference a file which contains all the
"allowed" properties. Right now this file is nand-chip.yaml but in
practice raw NAND controllers may use additional properties in their
NAND chip children node. These properties are listed under
nand-controller.yaml, which makes the "unevaluatedProperties" checks
fail while the description are valid. We need to move these NAND chip
related properties into another file, because we do not want to pollute
nand-chip.yaml which is also referenced by eg. SPI-NAND devices.

Let's create a raw-nand-chip.yaml file to reference all the properties a
raw NAND chip description can contain. The chain of inheritance becomes:
  nand-controller.yaml <- raw-nand-chip.yaml
  raw-nand-chip.yaml   <- nand-chip.yaml
  spi-nand.yaml        <- nand-chip.yaml

Signed-off-by: Miquel Raynal <miquel.raynal@bootlin.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/linux-mtd/20230619092916.3028470-3-miquel.raynal@bootlin.com
Documentation/devicetree/bindings/mtd/nand-controller.yaml
Documentation/devicetree/bindings/mtd/raw-nand-chip.yaml [new file with mode: 0644]