| Tom Rini | 53633a8 | 2024-02-29 12:33:36 -0500 | [diff] [blame^] | 1 | # SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause |
| 2 | %YAML 1.2 |
| 3 | --- |
| 4 | $id: http://devicetree.org/schemas/mailbox/qcom-ipcc.yaml# |
| 5 | $schema: http://devicetree.org/meta-schemas/core.yaml# |
| 6 | |
| 7 | title: Qualcomm Technologies, Inc. Inter-Processor Communication Controller |
| 8 | |
| 9 | maintainers: |
| 10 | - Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org> |
| 11 | |
| 12 | description: |
| 13 | The Inter-Processor Communication Controller (IPCC) is a centralized hardware |
| 14 | to route interrupts across various subsystems. It involves a three-level |
| 15 | addressing scheme called protocol, client and signal. For example, consider an |
| 16 | entity on the Application Processor Subsystem (APSS) that wants to listen to |
| 17 | Modem's interrupts via Shared Memory Point to Point (SMP2P) interface. In such |
| 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 falls under the Multiprocessor (MPROC) |
| 20 | protocol (protocol-id is 0). Refer include/dt-bindings/mailbox/qcom-ipcc.h |
| 21 | for the list of such IDs. |
| 22 | |
| 23 | properties: |
| 24 | compatible: |
| 25 | items: |
| 26 | - enum: |
| 27 | - qcom,qdu1000-ipcc |
| 28 | - qcom,sa8775p-ipcc |
| 29 | - qcom,sc7280-ipcc |
| 30 | - qcom,sc8280xp-ipcc |
| 31 | - qcom,sm6350-ipcc |
| 32 | - qcom,sm6375-ipcc |
| 33 | - qcom,sm8250-ipcc |
| 34 | - qcom,sm8350-ipcc |
| 35 | - qcom,sm8450-ipcc |
| 36 | - qcom,sm8550-ipcc |
| 37 | - qcom,sm8650-ipcc |
| 38 | - const: qcom,ipcc |
| 39 | |
| 40 | reg: |
| 41 | maxItems: 1 |
| 42 | |
| 43 | interrupts: |
| 44 | maxItems: 1 |
| 45 | |
| 46 | interrupt-controller: true |
| 47 | |
| 48 | "#interrupt-cells": |
| 49 | const: 3 |
| 50 | description: |
| 51 | The first cell is the client-id, the second cell is the signal-id and the |
| 52 | third cell is the interrupt type. |
| 53 | |
| 54 | "#mbox-cells": |
| 55 | const: 2 |
| 56 | description: |
| 57 | The first cell is the client-id, and the second cell is the signal-id. |
| 58 | |
| 59 | required: |
| 60 | - compatible |
| 61 | - reg |
| 62 | - interrupts |
| 63 | - interrupt-controller |
| 64 | - "#interrupt-cells" |
| 65 | - "#mbox-cells" |
| 66 | |
| 67 | additionalProperties: false |
| 68 | |
| 69 | examples: |
| 70 | - | |
| 71 | #include <dt-bindings/interrupt-controller/arm-gic.h> |
| 72 | #include <dt-bindings/mailbox/qcom-ipcc.h> |
| 73 | |
| 74 | mailbox@408000 { |
| 75 | compatible = "qcom,sm8250-ipcc", "qcom,ipcc"; |
| 76 | reg = <0x408000 0x1000>; |
| 77 | interrupts = <GIC_SPI 229 IRQ_TYPE_LEVEL_HIGH>; |
| 78 | interrupt-controller; |
| 79 | #interrupt-cells = <3>; |
| 80 | #mbox-cells = <2>; |
| 81 | }; |