bindings/mailbox/arm%2Cmhu.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/mailbox/arm,mhu.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: ARM MHU Mailbox Controller
10   - Jassi Brar <jaswinder.singh@linaro.org>
13   The ARM's Message-Handling-Unit (MHU) is a mailbox controller that has 3
14   independent channels/links to communicate with remote processor(s).  MHU links
21   The MHU hardware also allows operations in doorbell mode. The MHU drives the
22   interrupt signal using a 32-bit register, with all 32-bits logically ORed
28   interrupt. Each of the 32-bits can be used as "doorbell" to alert the remote
37           - arm,mhu
38           - arm,mhu-doorbell
40     - compatible
45       - description: Data transfer mode
47           - const: arm,mhu
48           - const: arm,primecell
50       - description: Doorbell mode
52           - const: arm,mhu-doorbell
53           - const: arm,primecell
61       - description: low-priority non-secure
62       - description: high-priority non-secure
63       - description: Secure
69   clock-names:
71       - const: apb_pclk
73   '#mbox-cells':
76       Set to 2 in doorbell mode and represents index of the channel and doorbell
81   - compatible
82   - reg
83   - interrupts
84   - '#mbox-cells'
90   - |
92         #address-cells = <2>;
93         #size-cells = <2>;
96             #mbox-cells = <1>;
97             compatible = "arm,mhu", "arm,primecell";
99             interrupts = <0 36 4>, /* LP-NonSecure */
100                          <0 35 4>, /* HP-NonSecure */
103             clock-names = "apb_pclk";
107             compatible = "fujitsu,mb86s70-scb-1.0";
109             mboxes = <&mhuA 1>; /* HP-NonSecure */
113   # Doorbell mode.
114   - |
116         #address-cells = <2>;
117         #size-cells = <2>;
120             #mbox-cells = <2>;
121             compatible = "arm,mhu-doorbell", "arm,primecell";
123             interrupts = <0 36 4>, /* LP-NonSecure */
124                          <0 35 4>, /* HP-NonSecure */
127             clock-names = "apb_pclk";
133             mboxes = <&mhuB 1 4>; /* HP-NonSecure, 5th doorbell */