2021-03-22 18:21:59

by Michael Walle

Subject: [RFC PATCH 2/4] dt-bindings: mtd: add YAML schema for the generic MTD bindings

Convert MTD's common.txt to mtd.yaml.

Signed-off-by: Michael Walle <[email protected]>
---
Btw, I've asked Miquel if I can add it as the maintainer.

.../devicetree/bindings/mtd/common.txt | 16 +-------
.../devicetree/bindings/mtd/mtd.yaml | 39 +++++++++++++++++++
2 files changed, 40 insertions(+), 15 deletions(-)
create mode 100644 Documentation/devicetree/bindings/mtd/mtd.yaml

diff --git a/Documentation/devicetree/bindings/mtd/common.txt b/Documentation/devicetree/bindings/mtd/common.txt
index fc068b923d7a..ae16f9ea8606 100644
--- a/Documentation/devicetree/bindings/mtd/common.txt
+++ b/Documentation/devicetree/bindings/mtd/common.txt
@@ -1,15 +1 @@
-* Common properties of all MTD devices
-
-Optional properties:
-- label: user-defined MTD device name. Can be used to assign user
- friendly names to MTD devices (instead of the flash model or flash
- controller based name) in order to ease flash device identification
- and/or describe what they are used for.
-
-Example:
-
- flash@0 {
- label = "System-firmware";
-
- /* flash type specific properties */
- };
+This file has been moved to mtd.yaml.
diff --git a/Documentation/devicetree/bindings/mtd/mtd.yaml b/Documentation/devicetree/bindings/mtd/mtd.yaml
new file mode 100644
index 000000000000..321259aab0f6
--- /dev/null
+++ b/Documentation/devicetree/bindings/mtd/mtd.yaml
@@ -0,0 +1,39 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mtd/mtd.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: MTD (Memory Technology Device) Device Tree Bindings
+
+maintainers:
+ - Miquel Raynal <[email protected]>
+ - Richard Weinberger <[email protected]>
+
+properties:
+ $nodename:
+ pattern: "^flash(@.*)?$"
+
+ label:
+ description:
+ User-defined MTD device name. Can be used to assign user friendly
+ names to MTD devices (instead of the flash model or flash controller
+ based name) in order to ease flash device identification and/or
+ describe what they are used for.
+
+additionalProperties: true
+
+examples:
+ - |
+ spi {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ flash@0 {
+ reg = <0>;
+ compatible = "some,flash";
+ label = "System-firmware";
+ };
+ };
+
+...
--
2.20.1

2021-03-27 17:13:54

by Rob Herring (Arm)

Subject: Re: [RFC PATCH 2/4] dt-bindings: mtd: add YAML schema for the generic MTD bindings

On Mon, 22 Mar 2021 19:19:47 +0100, Michael Walle wrote:
> Convert MTD's common.txt to mtd.yaml.
>
> Signed-off-by: Michael Walle <[email protected]>
> ---
> Btw, I've asked Miquel if I can add it as the maintainer.
>
> .../devicetree/bindings/mtd/common.txt | 16 +-------
> .../devicetree/bindings/mtd/mtd.yaml | 39 +++++++++++++++++++
> 2 files changed, 40 insertions(+), 15 deletions(-)
> create mode 100644 Documentation/devicetree/bindings/mtd/mtd.yaml
>

Reviewed-by: Rob Herring <[email protected]>