tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
mailbox: dt: Supply bindings for ST's Mailbox IP
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Jassi Brar <jaswinder.singh@linaro.org>
authored by
Lee Jones
and committed by
Jassi Brar
b5f67376
d311a28a
+51
+51
Documentation/devicetree/bindings/mailbox/sti-mailbox.txt
+51
Documentation/devicetree/bindings/mailbox/sti-mailbox.txt
···
1
+
ST Microelectronics Mailbox Driver
2
+
3
+
Each ST Mailbox IP currently consists of 4 instances of 32 channels. Messages
4
+
are passed between Application and Remote processors using shared memory.
5
+
6
+
Controller
7
+
----------
8
+
9
+
Required properties:
10
+
- compatible : Should be "st,stih407-mailbox"
11
+
- reg : Offset and length of the device's register set
12
+
- mbox-name : Name of the mailbox
13
+
- #mbox-cells: : Must be 2
14
+
<&phandle instance channel direction>
15
+
phandle : Label name of controller
16
+
instance : Instance number
17
+
channel : Channel number
18
+
19
+
Optional properties
20
+
- interrupts : Contains the IRQ line for a Rx mailbox
21
+
22
+
Example:
23
+
24
+
mailbox0: mailbox@0 {
25
+
compatible = "st,stih407-mailbox";
26
+
reg = <0x08f00000 0x1000>;
27
+
interrupts = <GIC_SPI 1 IRQ_TYPE_NONE>;
28
+
#mbox-cells = <2>;
29
+
mbox-name = "a9";
30
+
};
31
+
32
+
Client
33
+
------
34
+
35
+
Required properties:
36
+
- compatible : Many (See the client docs)
37
+
- reg : Shared (between Application and Remote) memory address
38
+
- mboxes : Standard property to specify a Mailbox (See ./mailbox.txt)
39
+
Cells must match 'mbox-cells' (See Controller docs above)
40
+
41
+
Optional properties
42
+
- mbox-names : Name given to channels seen in the 'mboxes' property.
43
+
44
+
Example:
45
+
46
+
mailbox_test {
47
+
compatible = "mailbox_test";
48
+
reg = <0x[shared_memory_address], [shared_memory_size]>;
49
+
mboxes = <&mailbox2 0 1>, <&mailbox0 2 1>;
50
+
mbox-names = "tx", "rx";
51
+
};