dt-bindings: mailbox: convert bcm2835-mbox bindings to YAML
authorStefan Wahren <stefan.wahren@i2se.com>
Sat, 17 Jun 2023 13:36:19 +0000 (15:36 +0200)
committerJassi Brar <jaswinder.singh@linaro.org>
Fri, 30 Jun 2023 22:35:45 +0000 (17:35 -0500)
Convert the DT binding document for bcm2835-mbox from .txt to YAML.

Signed-off-by: Stefan Wahren <stefan.wahren@i2se.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Jassi Brar <jaswinder.singh@linaro.org>
Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.txt [deleted file]
Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.yaml [new file with mode: 0644]

diff --git a/Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.txt b/Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.txt
deleted file mode 100644 (file)
index b48d7d3..0000000
+++ /dev/null
@@ -1,26 +0,0 @@
-Broadcom BCM2835 VideoCore mailbox IPC
-
-Required properties:
-
-- compatible:  Should be "brcm,bcm2835-mbox"
-- reg:         Specifies base physical address and size of the registers
-- interrupts:  The interrupt number
-                 See bindings/interrupt-controller/brcm,bcm2835-armctrl-ic.txt
-- #mbox-cells: Specifies the number of cells needed to encode a mailbox
-                 channel. The value shall be 0, since there is only one
-                 mailbox channel implemented by the device.
-
-Example:
-
-mailbox: mailbox@7e00b880 {
-       compatible = "brcm,bcm2835-mbox";
-       reg = <0x7e00b880 0x40>;
-       interrupts = <0 1>;
-       #mbox-cells = <0>;
-};
-
-firmware: firmware {
-       compatible = "raspberrypi,firmware";
-       mboxes = <&mailbox>;
-       #power-domain-cells = <1>;
-};
diff --git a/Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.yaml b/Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.yaml
new file mode 100644 (file)
index 0000000..9588817
--- /dev/null
@@ -0,0 +1,40 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mailbox/brcm,bcm2835-mbox.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Broadcom BCM2835 VideoCore mailbox IPC
+
+maintainers:
+  - Stefan Wahren <stefan.wahren@i2se.com>
+
+properties:
+  compatible:
+    const: brcm,bcm2835-mbox
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+  "#mbox-cells":
+    const: 0
+
+required:
+  - compatible
+  - reg
+  - interrupts
+  - "#mbox-cells"
+
+additionalProperties: false
+
+examples:
+  - |
+    mailbox@7e00b880 {
+      compatible = "brcm,bcm2835-mbox";
+      reg = <0x7e00b880 0x40>;
+      interrupts = <0 1>;
+      #mbox-cells = <0>;
+    };