Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1248399

[PATCH v4 1/5] mailbox: dt: Supply bindings for ST's Mailbox IP

Show all headers | View raw

Signed-off-by: Lee Jones <lee.jones@linaro.org>
---
 .../devicetree/bindings/mailbox/sti-mailbox.txt    | 51 ++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/mailbox/sti-mailbox.txt

diff --git a/Documentation/devicetree/bindings/mailbox/sti-mailbox.txt b/Documentation/devicetree/bindings/mailbox/sti-mailbox.txt
new file mode 100644
index 0000000..b61eec9
--- /dev/null
+++ b/Documentation/devicetree/bindings/mailbox/sti-mailbox.txt
@@ -0,0 +1,51 @@
+ST Microelectronics Mailbox Driver
+
+Each ST Mailbox IP currently consists of 4 instances of 32 channels.  Messages
+are passed between Application and Remote processors using shared memory.
+
+Controller
+----------
+
+Required properties:
+- compatible		: Should be "st,stih407-mailbox"
+- reg			: Offset and length of the device's register set
+- mbox-name		: Name of the mailbox
+- #mbox-cells:		: Must be 2
+			  <&phandle instance channel direction>
+			    phandle   : Label name of controller
+			    instance  : Instance number
+			    channel   : Channel number
+
+Optional properties
+- interrupts		: Contains the IRQ line for a Rx mailbox
+
+Example:
+
+mailbox0: mailbox@0  {
+	compatible	= "st,stih407-mailbox";
+	reg		= <0x08f00000 0x1000>;
+	interrupts	= <GIC_SPI 1 IRQ_TYPE_NONE>;
+	#mbox-cells	= <2>;
+	mbox-name	= "a9";
+};
+
+Client
+------
+
+Required properties:
+- compatible		: Many (See the client docs)
+- reg			: Shared (between Application and Remote) memory address
+- mboxes		: Standard property to specify a Mailbox (See ./mailbox.txt)
+			  Cells must match 'mbox-cells' (See Controller docs above)
+
+Optional properties
+- mbox-names		: Name given to channels seen in the 'mboxes' property.
+
+Example:
+
+mailbox_test {
+	compatible	= "mailbox_test";
+	reg		= <0x[shared_memory_address], [shared_memory_size]>;
+	mboxes		= <&mailbox2 0 1>, <&mailbox0 2 1>;
+	mbox-names	= "tx",	"rx";
+};
-- 
1.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[RESEND v4.1 0/5] Mailbox: Provide support STi based platforms Lee Jones <lee.jones@linaro.org> - 2015-10-16 09:30 +0200
  [PATCH v4 1/5] mailbox: dt: Supply bindings for ST's Mailbox IP Lee Jones <lee.jones@linaro.org> - 2015-10-16 09:30 +0200
  [PATCH v4 5/5] ARM: STi: DT: STiH407: Enable Mailbox testing facility Lee Jones <lee.jones@linaro.org> - 2015-10-16 09:30 +0200
  [PATCH v4 3/5] ARM: STi: stih407-family: Add nodes for Mailbox Lee Jones <lee.jones@linaro.org> - 2015-10-16 09:30 +0200
  [PATCH v4 4/5] mailbox: Add generic mechanism for testing Mailbox Controllers Lee Jones <lee.jones@linaro.org> - 2015-10-16 09:30 +0200
    [PATCH] mailbox: Fix a couple of trivial static checker issues Lee Jones <lee.jones@linaro.org> - 2015-10-16 13:40 +0200
      [PATCH v2] mailbox: Fix a couple of trivial static checker issues Lee Jones <lee.jones@linaro.org> - 2015-10-16 14:40 +0200
  Re: [RESEND v4.1 0/5] Mailbox: Provide support STi based platforms Jassi Brar <jaswinder.singh@linaro.org> - 2015-10-17 07:20 +0200

csiph-web