[PATCH 1/7] dt-bindings: mailbox: Don't require #mbox-cells to be 1
From: Douglas Anderson
Date: Tue Jul 14 2026 - 18:24:46 EST
Existing mailboxes have #mbox-cells and this makes sense if a mailbox
only exposes one channel. Update the bindings to match.
Signed-off-by: Douglas Anderson <dianders@xxxxxxxxxxxx>
---
I assume this is worth doing (?). As noted [1], mailbox bindings are
already in the core schema, so what's here just provides extra context
and descriptions.
[1] https://lore.kernel.org/all/20260322-mailbox-v1-1-c6251f18187c@xxxxxxxxx/
Documentation/devicetree/bindings/mailbox/mailbox.txt | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/devicetree/bindings/mailbox/mailbox.txt b/Documentation/devicetree/bindings/mailbox/mailbox.txt
index af8ecee2ac68..f50727e9686f 100644
--- a/Documentation/devicetree/bindings/mailbox/mailbox.txt
+++ b/Documentation/devicetree/bindings/mailbox/mailbox.txt
@@ -6,8 +6,7 @@ assign appropriate mailbox channel to client drivers.
* Mailbox Controller
Required property:
-- #mbox-cells: Must be at least 1. Number of cells in a mailbox
- specifier.
+- #mbox-cells: Number of cells in a mailbox specifier.
Example:
mailbox: mailbox {
@@ -19,7 +18,8 @@ Example:
* Mailbox Client
Required property:
-- mboxes: List of phandle and mailbox channel specifiers.
+- mboxes: List of phandle and mailbox channel specifiers. If #mbox-cells is 0
+ then a mailbox only provides one channel and only a phandle is needed.
Optional property:
- mbox-names: List of identifier strings for each mailbox channel.
--
2.55.0.141.g00534a21ce-goog