]> Gentwo Git Trees - linux/.git/commitdiff
dt-bindings: mailbox: Convert apm,xgene-slimpro-mbox to DT schema
authorRob Herring (Arm) <robh@kernel.org>
Mon, 13 Oct 2025 21:31:10 +0000 (16:31 -0500)
committerRob Herring (Arm) <robh@kernel.org>
Tue, 14 Oct 2025 22:12:15 +0000 (17:12 -0500)
Convert APM X-Gene slimpro-mbox binding to DT schema format. It's a
straight-forward conversion.

Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Documentation/devicetree/bindings/mailbox/apm,xgene-slimpro-mbox.yaml [new file with mode: 0644]
Documentation/devicetree/bindings/mailbox/xgene-slimpro-mailbox.txt [deleted file]

diff --git a/Documentation/devicetree/bindings/mailbox/apm,xgene-slimpro-mbox.yaml b/Documentation/devicetree/bindings/mailbox/apm,xgene-slimpro-mbox.yaml
new file mode 100644 (file)
index 0000000..815f08d
--- /dev/null
@@ -0,0 +1,62 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/apm,xgene-slimpro-mbox.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: APM X-Gene SLIMpro mailbox
+
+maintainers:
+  - Khuong Dinh <khuong@os.amperecomputing.com>
+
+description:
+  The APM X-Gene SLIMpro mailbox is used to communicate messages between
+  the ARM64 processors and the Cortex M3 (dubbed SLIMpro). It uses a simple
+  interrupt based door bell mechanism and can exchange simple messages using the
+  internal registers.
+
+properties:
+  compatible:
+    const: apm,xgene-slimpro-mbox
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    items:
+      - description: mailbox channel 0 doorbell
+      - description: mailbox channel 1 doorbell
+      - description: mailbox channel 2 doorbell
+      - description: mailbox channel 3 doorbell
+      - description: mailbox channel 4 doorbell
+      - description: mailbox channel 5 doorbell
+      - description: mailbox channel 6 doorbell
+      - description: mailbox channel 7 doorbell
+
+  '#mbox-cells':
+    description: Number of mailbox channel.
+    const: 1
+
+required:
+  - compatible
+  - reg
+  - interrupts
+  - '#mbox-cells'
+
+additionalProperties: false
+
+examples:
+  - |
+    mailbox@10540000 {
+        compatible = "apm,xgene-slimpro-mbox";
+        reg = <0x10540000 0xa000>;
+        #mbox-cells = <1>;
+        interrupts = <0x0 0x0 0x4>,
+                     <0x0 0x1 0x4>,
+                     <0x0 0x2 0x4>,
+                     <0x0 0x3 0x4>,
+                     <0x0 0x4 0x4>,
+                     <0x0 0x5 0x4>,
+                     <0x0 0x6 0x4>,
+                     <0x0 0x7 0x4>;
+    };
diff --git a/Documentation/devicetree/bindings/mailbox/xgene-slimpro-mailbox.txt b/Documentation/devicetree/bindings/mailbox/xgene-slimpro-mailbox.txt
deleted file mode 100644 (file)
index e46451b..0000000
+++ /dev/null
@@ -1,35 +0,0 @@
-The APM X-Gene SLIMpro mailbox is used to communicate messages between
-the ARM64 processors and the Cortex M3 (dubbed SLIMpro). It uses a simple
-interrupt based door bell mechanism and can exchange simple messages using the
-internal registers.
-
-There are total of 8 interrupts in this mailbox. Each used for an individual
-door bell (or mailbox channel).
-
-Required properties:
-- compatible:  Should be as "apm,xgene-slimpro-mbox".
-
-- reg:         Contains the mailbox register address range.
-
-- interrupts:  8 interrupts must be from 0 to 7, interrupt 0 define the
-               the interrupt for mailbox channel 0 and interrupt 1 for
-               mailbox channel 1 and so likewise for the reminder.
-
-- #mbox-cells: only one to specify the mailbox channel number.
-
-Example:
-
-Mailbox Node:
-               mailbox: mailbox@10540000 {
-                       compatible = "apm,xgene-slimpro-mbox";
-                       reg = <0x0 0x10540000 0x0 0xa000>;
-                       #mbox-cells = <1>;
-                       interrupts =    <0x0 0x0 0x4>,
-                                       <0x0 0x1 0x4>,
-                                       <0x0 0x2 0x4>,
-                                       <0x0 0x3 0x4>,
-                                       <0x0 0x4 0x4>,
-                                       <0x0 0x5 0x4>,
-                                       <0x0 0x6 0x4>,
-                                       <0x0 0x7 0x4>,
-               };