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

Groups > linux.kernel > #1674906

[PATCH 1/9] Documentation: dt-bindings: add support for mailbox client shared memory

Show all headers | View raw

Many users of the mailbox controllers depend on the shared memory between the
two end points to exchange the main data while using simple doorbell mechanism
to alert the end points of the presence of a message.

This patch defines device tree bindings to represent such shared memory in a
generic way.

Cc: Rob Herring <robh+dt@kernel.org>
Signed-off-by: Sudeep Holla <sudeep.holla@arm.com>
---
 .../devicetree/bindings/mailbox/mailbox.txt        | 28 ++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/Documentation/devicetree/bindings/mailbox/mailbox.txt b/Documentation/devicetree/bindings/mailbox/mailbox.txt
index be05b9746c69..af8ecee2ac68 100644
--- a/Documentation/devicetree/bindings/mailbox/mailbox.txt
+++ b/Documentation/devicetree/bindings/mailbox/mailbox.txt
@@ -23,6 +23,11 @@ assign appropriate mailbox channel to client drivers.
 
 Optional property:
 - mbox-names: List of identifier strings for each mailbox channel.
+- shmem : List of phandle pointing to the shared memory(SHM) area between the
+	  users of these mailboxes for IPC, one for each mailbox. This shared
+	  memory can be part of any memory reserved for the purpose of this
+	  communication between the mailbox client and the remote.
+
 
 Example:
 	pwr_cntrl: power {
@@ -30,3 +35,26 @@ assign appropriate mailbox channel to client drivers.
 		mbox-names = "pwr-ctrl", "rpc";
 		mboxes = <&mailbox 0 &mailbox 1>;
 	};
+
+Example with shared memory(shmem):
+
+	sram: sram@50000000 {
+		compatible = "mmio-sram";
+		reg = <0x50000000 0x10000>;
+
+		#address-cells = <1>;
+		#size-cells = <1>;
+		ranges = <0 0x50000000 0x10000>;
+
+		cl_shmem: shmem@0 {
+			compatible = "client-shmem";
+			reg = <0x0 0x200>;
+		};
+	};
+
+	client@2e000000 {
+		...
+		mboxes = <&mailbox 0>;
+		shmem = <&cl_shmem>;
+		..
+	};
-- 
2.7.4

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

Thread

[PATCH 0/9] firmware: ARM System Control and Management Interface(SCMI) support Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200
  [PATCH 4/9] firmware: arm_scmi: add common infrastructure and support for base protocol Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200
  [PATCH 9/9] firmware: arm_scmi: probe and initialise all the supported protocols Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200
  [PATCH 8/9] firmware: arm_scmi: add initial support for sensor protocol Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200
  [PATCH 7/9] firmware: arm_scmi: add initial support for power protocol Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200
  [PATCH 6/9] firmware: arm_scmi: add initial support for clock protocol Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200
  [PATCH 2/9] Documentation: add DT binding for ARM System Control and Management Interface(SCMI) protocol Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200
    Re: [PATCH 2/9] Documentation: add DT binding for ARM System Control  and Management Interface(SCMI) protocol Rob Herring <robh@kernel.org> - 2017-06-29 01:10 +0200
      Re: [PATCH 2/9] Documentation: add DT binding for ARM System Control  and Management Interface(SCMI) protocol Sudeep Holla <sudeep.holla@arm.com> - 2017-06-30 12:40 +0200
  [PATCH 1/9] Documentation: dt-bindings: add support for mailbox client shared memory Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200
    Re: [PATCH 1/9] Documentation: dt-bindings: add support for mailbox  client shared memory Rob Herring <robh@kernel.org> - 2017-06-29 01:00 +0200
      Re: [PATCH 1/9] Documentation: dt-bindings: add support for mailbox  client shared memory Sudeep Holla <sudeep.holla@arm.com> - 2017-06-30 12:30 +0200
  [PATCH 3/9] firmware: arm_scmi: add basic driver infrastructure for SCMI Sudeep Holla <sudeep.holla@arm.com> - 2017-06-26 18:00 +0200

csiph-web