Documentation/devicetree/bindings/remoteproc/qcom,sm8150-pas.yaml

   1 # SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/remoteproc/qcom,sm8150-pas.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Qualcomm SM8150/SM8250 Peripheral Authentication Service
   8
   9 maintainers:
  10   - Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
  11
  12 description:
  13   Qualcomm SM8150/SM8250 SoC Peripheral Authentication Service loads and boots
  14   firmware on the Qualcomm DSP Hexagon cores.
  15
  16 properties:
  17   compatible:
  18     enum:
  19       - qcom,sm8150-adsp-pas
  20       - qcom,sm8150-cdsp-pas
  21       - qcom,sm8150-mpss-pas
  22       - qcom,sm8150-slpi-pas
  23       - qcom,sm8250-adsp-pas
  24       - qcom,sm8250-cdsp-pas
  25       - qcom,sm8250-slpi-pas
  26
  27   reg:
  28     maxItems: 1
  29
  30   clocks:
  31     items:
  32       - description: XO clock
  33
  34   clock-names:
  35     items:
  36       - const: xo
  37
  38   qcom,qmp:
  39     $ref: /schemas/types.yaml#/definitions/phandle
  40     description: Reference to the AOSS side-channel message RAM.
  41
  42   memory-region:
  43     minItems: 1
  44     description: Reference to the reserved-memory for the Hexagon core
  45
  46   smd-edge: false
  47
  48   firmware-name:
  49     $ref: /schemas/types.yaml#/definitions/string
  50     description: Firmware name for the Hexagon core
  51
  52 required:
  53   - compatible
  54   - reg
  55
  56 allOf:
  57   - $ref: /schemas/remoteproc/qcom,pas-common.yaml#
  58   - if:
  59       properties:
  60         compatible:
  61           enum:
  62             - qcom,sm8150-adsp-pas
  63             - qcom,sm8150-cdsp-pas
  64             - qcom,sm8150-slpi-pas
  65             - qcom,sm8250-adsp-pas
  66             - qcom,sm8250-cdsp-pas
  67             - qcom,sm8250-slpi-pas
  68     then:
  69       properties:
  70         interrupts:
  71           maxItems: 5
  72         interrupt-names:
  73           maxItems: 5
  74     else:
  75       properties:
  76         interrupts:
  77           minItems: 6
  78         interrupt-names:
  79           minItems: 6
  80
  81   - if:
  82       properties:
  83         compatible:
  84           enum:
  85             - qcom,sm8150-adsp-pas
  86             - qcom,sm8150-cdsp-pas
  87             - qcom,sm8250-cdsp-pas
  88     then:
  89       properties:
  90         power-domains:
  91           items:
  92             - description: CX power domain
  93         power-domain-names:
  94           items:
  95             - const: cx
  96
  97   - if:
  98       properties:
  99         compatible:
 100           enum:
 101             - qcom,sm8150-mpss-pas
 102     then:
 103       properties:
 104         power-domains:
 105           items:
 106             - description: CX power domain
 107             - description: MSS power domain
 108         power-domain-names:
 109           items:
 110             - const: cx
 111             - const: mss
 112
 113   - if:
 114       properties:
 115         compatible:
 116           enum:
 117             - qcom,sm8150-slpi-pas
 118             - qcom,sm8250-adsp-pas
 119             - qcom,sm8250-slpi-pas
 120     then:
 121       properties:
 122         power-domains:
 123           items:
 124             - description: LCX power domain
 125             - description: LMX power domain
 126         power-domain-names:
 127           items:
 128             - const: lcx
 129             - const: lmx
 130
 131 unevaluatedProperties: false
 132
 133 examples:
 134   - |
 135     #include <dt-bindings/clock/qcom,rpmh.h>
 136     #include <dt-bindings/interrupt-controller/arm-gic.h>
 137     #include <dt-bindings/interrupt-controller/irq.h>
 138     #include <dt-bindings/power/qcom-rpmpd.h>
 139
 140     remoteproc@17300000 {
 141         compatible = "qcom,sm8150-adsp-pas";
 142         reg = <0x17300000 0x4040>;
 143
 144         clocks = <&rpmhcc RPMH_CXO_CLK>;
 145         clock-names = "xo";
 146
 147         firmware-name = "qcom/sm8150/adsp.mbn";
 148
 149         interrupts-extended = <&intc GIC_SPI 162 IRQ_TYPE_EDGE_RISING>,
 150                               <&adsp_smp2p_in 0 IRQ_TYPE_EDGE_RISING>,
 151                               <&adsp_smp2p_in 1 IRQ_TYPE_EDGE_RISING>,
 152                               <&adsp_smp2p_in 2 IRQ_TYPE_EDGE_RISING>,
 153                               <&adsp_smp2p_in 3 IRQ_TYPE_EDGE_RISING>;
 154         interrupt-names = "wdog", "fatal", "ready",
 155                           "handover", "stop-ack";
 156
 157         memory-region = <&adsp_mem>;
 158
 159         power-domains = <&rpmhpd SM8150_CX>;
 160
 161         qcom,qmp = <&aoss_qmp>;
 162         qcom,smem-states = <&adsp_smp2p_out 0>;
 163         qcom,smem-state-names = "stop";
 164
 165         glink-edge {
 166             interrupts = <GIC_SPI 156 IRQ_TYPE_EDGE_RISING>;
 167             label = "lpass";
 168             qcom,remote-pid = <2>;
 169             mboxes = <&apss_shared 8>;
 170
 171             /* ... */
 172
 173         };
 174     };