From: Ben Levinsky <ben.levinsky@amd.com>
To: Mathieu Poirier <mathieu.poirier@linaro.org>,
Bjorn Andersson <andersson@kernel.org>,
Jassi Brar <jassisinghbrar@gmail.com>,
Rob Herring <robh@kernel.org>,
Krzysztof Kozlowski <krzk+dt@kernel.org>,
Conor Dooley <conor+dt@kernel.org>
Cc: <michal.simek@amd.com>, <tanmay.shah@amd.com>,
<ben.levinsky@amd.com>, <linux-remoteproc@vger.kernel.org>,
<devicetree@vger.kernel.org>,
<linux-arm-kernel@lists.infradead.org>,
<linux-kernel@vger.kernel.org>
Subject: [PATCH v3 1/4] dt-bindings: mailbox: Add AMD PL Mailbox IP
Date: Thu, 19 Nov 2026 14:04:02 -0800 [thread overview]
Message-ID: <20261119220405.2838553-2-ben.levinsky@amd.com> (raw)
In-Reply-To: <20261119220405.2838553-1-ben.levinsky@amd.com>
Add a binding for the AMD PL Mailbox, a soft IP used to exchange 32-bit
words between two processors through a pair of FIFOs.
The IP lives in programmable logic and isn't tied to a SoC, so the
compatible names the IP and its version. The FIFO depth is set when the
design is synthesized and can't be read from the hardware, hence
property amd,pl-mailbox-depth.
Assisted-by: Claude:claude-opus-5.5
Signed-off-by: Ben Levinsky <ben.levinsky@amd.com>
---
.../bindings/mailbox/amd,pl-mailbox-2.1.yaml | 71 +++++++++++++++++++
MAINTAINERS | 6 ++
2 files changed, 77 insertions(+)
create mode 100644 Documentation/devicetree/bindings/mailbox/amd,pl-mailbox-2.1.yaml
diff --git a/Documentation/devicetree/bindings/mailbox/amd,pl-mailbox-2.1.yaml b/Documentation/devicetree/bindings/mailbox/amd,pl-mailbox-2.1.yaml
new file mode 100644
index 000000000000..50ac14a4cbac
--- /dev/null
+++ b/Documentation/devicetree/bindings/mailbox/amd,pl-mailbox-2.1.yaml
@@ -0,0 +1,71 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mailbox/amd,pl-mailbox-2.1.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: AMD Programmable Logic Mailbox IP
+
+maintainers:
+ - Ben Levinsky <ben.levinsky@amd.com>
+
+description: |
+ The AMD Programmable Logic Mailbox IP passes messages between two
+ processors through a pair of FIFOs. Each side of the IP has its own
+ registers, interrupt and clock, and is described by its own node.
+ Channel 0 is used to transmit and channel 1 to receive.
+
+ The Mailbox is a soft IP core instantiated in programmable logic, not a
+ SoC block, so the compatible names the IP core and its version (2.1).
+ The "pl" part distinguishes it from the IPI hardware that can also be
+ used as a mailbox.
+
+properties:
+ compatible:
+ const: amd,pl-mailbox-2.1
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ clocks:
+ maxItems: 1
+
+ amd,pl-mailbox-depth:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ minimum: 16
+ maximum: 8192
+ default: 16
+ description:
+ Depth of the send and receive FIFOs in 32-bit words. The depth is the
+ C_MAILBOX_DEPTH parameter chosen for each IP instance when the design
+ is synthesized, so instances in one design can differ, and it cannot
+ be read from the registers. Must match the synthesized depth.
+
+ '#mbox-cells':
+ const: 1
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - clocks
+ - '#mbox-cells'
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/arm-gic.h>
+
+ mailbox@b2060000 {
+ compatible = "amd,pl-mailbox-2.1";
+ reg = <0xb2060000 0x10000>;
+ interrupts = <GIC_SPI 106 IRQ_TYPE_LEVEL_HIGH>;
+ clocks = <&pl_clk>;
+ amd,pl-mailbox-depth = <16>;
+ #mbox-cells = <1>;
+ };
+...
diff --git a/MAINTAINERS b/MAINTAINERS
index ca1c59e1fc59..dc6a835f7bbc 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1315,6 +1315,12 @@ S: Supported
T: git https://gitlab.freedesktop.org/agd5f/linux.git
F: drivers/gpu/drm/amd/pm/
+AMD PROGRAMMABLE LOGIC MAILBOX DRIVER
+M: Ben Levinsky <ben.levinsky@amd.com>
+L: linux-kernel@vger.kernel.org
+S: Maintained
+F: Documentation/devicetree/bindings/mailbox/amd,pl-mailbox-2.1.yaml
+
AMD PSTATE DRIVER
M: Huang Rui <ray.huang@amd.com>
M: Mario Limonciello <mario.limonciello@amd.com>
--
2.34.1
next prev parent reply other threads:[~2026-11-19 22:04 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-19 22:04 [PATCH v3 0/4] Add AMD PL Mailbox and RPMsg support for the AMD BRAM remoteproc Ben Levinsky
2026-11-19 22:04 ` Ben Levinsky [this message]
2026-11-19 22:04 ` [PATCH v3 2/4] mailbox: Add AMD PL Mailbox soft IP controller Ben Levinsky
2026-11-19 22:18 ` sashiko-bot
2026-11-19 22:04 ` [PATCH v3 3/4] dt-bindings: remoteproc: Add RPMsg resources to AMD BRAM rproc Ben Levinsky
2026-11-19 22:04 ` [PATCH v3 4/4] remoteproc: amd_mbv_bram: Add RPMsg support Ben Levinsky
2026-11-19 22:19 ` sashiko-bot
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261119220405.2838553-2-ben.levinsky@amd.com \
--to=ben.levinsky@amd.com \
--cc=andersson@kernel.org \
--cc=conor+dt@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=jassisinghbrar@gmail.com \
--cc=krzk+dt@kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-remoteproc@vger.kernel.org \
--cc=mathieu.poirier@linaro.org \
--cc=michal.simek@amd.com \
--cc=robh@kernel.org \
--cc=tanmay.shah@amd.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.