1 Altera Mailbox Driver 1 Altera Mailbox Driver
2 ===================== 2 =====================
3 3
4 Required properties: 4 Required properties:
5 - compatible : "altr,mailbox-1.0". 5 - compatible : "altr,mailbox-1.0".
6 - reg : physical base address of the m 6 - reg : physical base address of the mailbox and length of
7 memory mapped region. 7 memory mapped region.
8 - #mbox-cells: Common mailbox binding propert 8 - #mbox-cells: Common mailbox binding property to identify the number
9 of cells required for the mail 9 of cells required for the mailbox specifier. Should be 1.
10 10
11 Optional properties: 11 Optional properties:
>> 12 - interrupt-parent : interrupt source phandle.
12 - interrupts : interrupt number. The 13 - interrupts : interrupt number. The interrupt specifier format
13 depends on the interru 14 depends on the interrupt controller parent.
14 15
15 Example: 16 Example:
16 mbox_tx: mailbox@100 { 17 mbox_tx: mailbox@100 {
17 compatible = "altr,mailbox-1.0 18 compatible = "altr,mailbox-1.0";
18 reg = <0x100 0x8>; 19 reg = <0x100 0x8>;
19 interrupt-parent = < &gic_0 >; 20 interrupt-parent = < &gic_0 >;
20 interrupts = <5>; 21 interrupts = <5>;
21 #mbox-cells = <1>; 22 #mbox-cells = <1>;
22 }; 23 };
23 24
24 mbox_rx: mailbox@200 { 25 mbox_rx: mailbox@200 {
25 compatible = "altr,mailbox-1.0 26 compatible = "altr,mailbox-1.0";
26 reg = <0x200 0x8>; 27 reg = <0x200 0x8>;
27 interrupt-parent = < &gic_0 >; 28 interrupt-parent = < &gic_0 >;
28 interrupts = <6>; 29 interrupts = <6>;
29 #mbox-cells = <1>; 30 #mbox-cells = <1>;
30 }; 31 };
31 32
32 Mailbox client 33 Mailbox client
33 =============== 34 ===============
34 "mboxes" and the optional "mbox-names" (please 35 "mboxes" and the optional "mbox-names" (please see
35 Documentation/devicetree/bindings/mailbox/mail 36 Documentation/devicetree/bindings/mailbox/mailbox.txt for details). Each value
36 of the mboxes property should contain a phandl 37 of the mboxes property should contain a phandle to the mailbox controller
37 device node and second argument is the channel 38 device node and second argument is the channel index. It must be 0 (hardware
38 support only one channel).The equivalent "mbox 39 support only one channel).The equivalent "mbox-names" property value can be
39 used to give a name to the communication chann 40 used to give a name to the communication channel to be used by the client user.
40 41
41 Example: 42 Example:
42 mclient0: mclient0@400 { 43 mclient0: mclient0@400 {
43 compatible = "client-1.0"; 44 compatible = "client-1.0";
44 reg = <0x400 0x10>; 45 reg = <0x400 0x10>;
45 mbox-names = "mbox-tx", "mbox- 46 mbox-names = "mbox-tx", "mbox-rx";
46 mboxes = <&mbox_tx 0>, 47 mboxes = <&mbox_tx 0>,
47 <&mbox_rx 0>; 48 <&mbox_rx 0>;
48 }; 49 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.