Documentation/devicetree/bindings/mailbox/qcom-ipcc.yaml

   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     };