1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2# Copyright 2019 BayLibre, SAS
3%YAML 1.2
4---
5$id: "http://devicetree.org/schemas/mailbox/amlogic,meson-gxbb-mhu.yaml#"
6$schema: "http://devicetree.org/meta-schemas/core.yaml#"
7
8title: Amlogic Meson Message-Handling-Unit Controller
9
10maintainers:
11  - Neil Armstrong <narmstrong@baylibre.com>
12
13description: |
14  The Amlogic's Meson SoCs Message-Handling-Unit (MHU) is a mailbox controller
15  that has 3 independent channels/links to communicate with remote processor(s).
16  MHU links are hardwired on a platform. A link raises interrupt for any
17  received data. However, there is no specified way of knowing if the sent
18  data has been read by the remote. This driver assumes the sender polls
19  STAT register and the remote clears it after having read the data.
20
21properties:
22  compatible:
23    enum:
24      - amlogic,meson-gxbb-mhu
25
26  reg:
27    maxItems: 1
28
29  interrupts:
30    minItems: 3
31    description:
32      Contains the interrupt information corresponding to each of the 3 links
33      of MHU.
34
35  "#mbox-cells":
36    const: 1
37
38required:
39  - compatible
40  - reg
41  - interrupts
42  - "#mbox-cells"
43
44additionalProperties: false
45
46examples:
47  - |
48    mailbox@c883c404 {
49          compatible = "amlogic,meson-gxbb-mhu";
50          reg = <0xc883c404 0x4c>;
51          interrupts = <208>, <209>, <210>;
52          #mbox-cells = <1>;
53    };
54