1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/mailbox/allwinner,sun6i-a31-msgbox.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Allwinner sunxi Message Box
8
9 maintainers:
10 - Samuel Holland <samuel@sholland.org>
11
12 description: |
13 The hardware message box on sun6i, sun8i, sun9i, and sun50i SoCs is a
14 two-user mailbox controller containing 8 unidirectional FIFOs. An interrupt
15 is raised for received messages, but software must poll to know when a
16 transmitted message has been acknowledged by the remote user. Each FIFO can
17 hold four 32-bit messages; when a FIFO is full, clients must wait before
18 attempting more transmissions.
19
20 Refer to ./mailbox.txt for generic information about mailbox device-tree
21 bindings.
22
23 properties:
24 compatible:
25 oneOf:
26 - items:
27 - enum:
28 - allwinner,sun8i-a83t-msgbox
29 - allwinner,sun8i-h3-msgbox
30 - allwinner,sun9i-a80-msgbox
31 - allwinner,sun50i-a64-msgbox
32 - allwinner,sun50i-h6-msgbox
33 - const: allwinner,sun6i-a31-msgbox
34 - const: allwinner,sun6i-a31-msgbox
35
36 reg:
37 maxItems: 1
38
39 clocks:
40 maxItems: 1
41 description: bus clock
42
43 resets:
44 maxItems: 1
45 description: bus reset
46
47 interrupts:
48 maxItems: 1
49
50 '#mbox-cells':
51 const: 1
52 description: first cell is the channel number (0-7)
53
54 required:
55 - compatible
56 - reg
57 - clocks
58 - resets
59 - interrupts
60 - '#mbox-cells'
61
62 additionalProperties: false
63
64 examples:
65 - |
66 #include <dt-bindings/clock/sun8i-h3-ccu.h>
67 #include <dt-bindings/interrupt-controller/arm-gic.h>
68 #include <dt-bindings/reset/sun8i-h3-ccu.h>
69
70 msgbox: mailbox@1c17000 {
71 compatible = "allwinner,sun8i-h3-msgbox",
72 "allwinner,sun6i-a31-msgbox";
73 reg = <0x01c17000 0x1000>;
74 clocks = <&ccu CLK_BUS_MSGBOX>;
75 resets = <&ccu RST_BUS_MSGBOX>;
76 interrupts = <GIC_SPI 49 IRQ_TYPE_LEVEL_HIGH>;
77 #mbox-cells = <1>;
78 };
79
80 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.