1 # SPDX-License-Identifier: GPL-2.0 OR BSD-2-Cl 1 # SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/mailbox/qco 4 $id: http://devicetree.org/schemas/mailbox/qcom-ipcc.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Qualcomm Technologies, Inc. Inter-Proce 7 title: Qualcomm Technologies, Inc. Inter-Processor Communication Controller
8 8
9 maintainers: 9 maintainers:
10 - Manivannan Sadhasivam <manivannan.sadhasiva 10 - Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
11 11
12 description: 12 description:
13 The Inter-Processor Communication Controller 13 The Inter-Processor Communication Controller (IPCC) is a centralized hardware
14 to route interrupts across various subsystem 14 to route interrupts across various subsystems. It involves a three-level
15 addressing scheme called protocol, client an 15 addressing scheme called protocol, client and signal. For example, consider an
16 entity on the Application Processor Subsyste 16 entity on the Application Processor Subsystem (APSS) that wants to listen to
17 Modem's interrupts via Shared Memory Point t 17 Modem's interrupts via Shared Memory Point to Point (SMP2P) interface. In such
18 a case, the client would be Modem (client-id 18 a case, the client would be Modem (client-id is 2) and the signal would be
19 SMP2P (signal-id is 2). The SMP2P itself fal 19 SMP2P (signal-id is 2). The SMP2P itself falls under the Multiprocessor (MPROC)
20 protocol (protocol-id is 0). Refer include/d 20 protocol (protocol-id is 0). Refer include/dt-bindings/mailbox/qcom-ipcc.h
21 for the list of such IDs. 21 for the list of such IDs.
22 22
23 properties: 23 properties:
24 compatible: 24 compatible:
25 items: 25 items:
26 - enum: 26 - enum:
27 - qcom,qcs8300-ipcc <<
28 - qcom,qdu1000-ipcc <<
29 - qcom,sa8255p-ipcc <<
30 - qcom,sa8775p-ipcc <<
31 - qcom,sc7280-ipcc <<
32 - qcom,sc8280xp-ipcc <<
33 - qcom,sdx75-ipcc <<
34 - qcom,sm6350-ipcc 27 - qcom,sm6350-ipcc
35 - qcom,sm6375-ipcc <<
36 - qcom,sm8250-ipcc 28 - qcom,sm8250-ipcc
37 - qcom,sm8350-ipcc 29 - qcom,sm8350-ipcc
38 - qcom,sm8450-ipcc !! 30 - qcom,sc7280-ipcc
39 - qcom,sm8550-ipcc <<
40 - qcom,sm8650-ipcc <<
41 - qcom,x1e80100-ipcc <<
42 - const: qcom,ipcc 31 - const: qcom,ipcc
43 32
44 reg: 33 reg:
45 maxItems: 1 34 maxItems: 1
46 35
47 interrupts: 36 interrupts:
48 maxItems: 1 37 maxItems: 1
49 38
50 interrupt-controller: true 39 interrupt-controller: true
51 40
52 "#interrupt-cells": 41 "#interrupt-cells":
53 const: 3 42 const: 3
54 description: 43 description:
55 The first cell is the client-id, the sec 44 The first cell is the client-id, the second cell is the signal-id and the
56 third cell is the interrupt type. 45 third cell is the interrupt type.
57 46
58 "#mbox-cells": 47 "#mbox-cells":
59 const: 2 48 const: 2
60 description: 49 description:
61 The first cell is the client-id, and the 50 The first cell is the client-id, and the second cell is the signal-id.
62 51
63 required: 52 required:
64 - compatible 53 - compatible
65 - reg 54 - reg
66 - interrupts 55 - interrupts
67 - interrupt-controller 56 - interrupt-controller
68 - "#interrupt-cells" 57 - "#interrupt-cells"
69 - "#mbox-cells" 58 - "#mbox-cells"
70 59
71 additionalProperties: false 60 additionalProperties: false
72 61
73 examples: 62 examples:
74 - | 63 - |
75 #include <dt-bindings/interrupt-controller !! 64 #include <dt-bindings/interrupt-controller/arm-gic.h>
76 #include <dt-bindings/mailbox/qcom-ipcc.h> !! 65 #include <dt-bindings/mailbox/qcom-ipcc.h>
>> 66
>> 67 mailbox@408000 {
>> 68 compatible = "qcom,sm8250-ipcc", "qcom,ipcc";
>> 69 reg = <0x408000 0x1000>;
>> 70 interrupts = <GIC_SPI 229 IRQ_TYPE_LEVEL_HIGH>;
>> 71 interrupt-controller;
>> 72 #interrupt-cells = <3>;
>> 73 #mbox-cells = <2>;
>> 74 };
>> 75
>> 76 smp2p-modem {
>> 77 compatible = "qcom,smp2p";
>> 78 interrupts-extended = <&ipcc_mproc IPCC_CLIENT_MPSS
>> 79 IPCC_MPROC_SIGNAL_SMP2P IRQ_TYPE_EDGE_RISING>;
>> 80 mboxes = <&ipcc_mproc IPCC_CLIENT_MPSS IPCC_MPROC_SIGNAL_SMP2P>;
77 81
78 mailbox@408000 { !! 82 /* Other SMP2P fields */
79 compatible = "qcom,sm8250-ipcc", "qcom !! 83 };
80 reg = <0x408000 0x1000>; <<
81 interrupts = <GIC_SPI 229 IRQ_TYPE_LEV <<
82 interrupt-controller; <<
83 #interrupt-cells = <3>; <<
84 #mbox-cells = <2>; <<
85 }; <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.