Documentation/devicetree/bindings/mailbox/amlogic,meson-gxbb-mhu.yaml

   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
   8 title: Amlogic Meson Message-Handling-Unit Controller
   9
  10 maintainers:
  11   - Neil Armstrong <narmstrong@baylibre.com>
  12
  13 description: |
  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
  21 properties:
  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
  38 required:
  39   - compatible
  40   - reg
  41   - interrupts
  42   - "#mbox-cells"
  43
  44 additionalProperties: false
  45
  46 examples:
  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