Merge tag 'for-5.12-rc1-tag' of git://git.kernel.org/pub/scm/linux/kernel/git/kdave...
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / firmware / qcom,scm.txt
1 QCOM Secure Channel Manager (SCM)
2
3 Qualcomm processors include an interface to communicate to the secure firmware.
4 This interface allows for clients to request different types of actions.  These
5 can include CPU power up/down, HDCP requests, loading of firmware, and other
6 assorted actions.
7
8 Required properties:
9 - compatible: must contain one of the following:
10  * "qcom,scm-apq8064"
11  * "qcom,scm-apq8084"
12  * "qcom,scm-ipq4019"
13  * "qcom,scm-ipq806x"
14  * "qcom,scm-ipq8074"
15  * "qcom,scm-msm8660"
16  * "qcom,scm-msm8916"
17  * "qcom,scm-msm8960"
18  * "qcom,scm-msm8974"
19  * "qcom,scm-msm8994"
20  * "qcom,scm-msm8996"
21  * "qcom,scm-msm8998"
22  * "qcom,scm-sc7180"
23  * "qcom,scm-sdm845"
24  * "qcom,scm-sm8150"
25  * "qcom,scm-sm8250"
26  * "qcom,scm-sm8350"
27  and:
28  * "qcom,scm"
29 - clocks: Specifies clocks needed by the SCM interface, if any:
30  * core clock required for "qcom,scm-apq8064", "qcom,scm-msm8660" and
31    "qcom,scm-msm8960"
32  * core, iface and bus clocks required for "qcom,scm-apq8084",
33    "qcom,scm-msm8916" and "qcom,scm-msm8974"
34 - clock-names: Must contain "core" for the core clock, "iface" for the interface
35   clock and "bus" for the bus clock per the requirements of the compatible.
36 - qcom,dload-mode: phandle to the TCSR hardware block and offset of the
37                    download mode control register (optional)
38
39 Example for MSM8916:
40
41         firmware {
42                 scm {
43                         compatible = "qcom,msm8916", "qcom,scm";
44                         clocks = <&gcc GCC_CRYPTO_CLK> ,
45                                  <&gcc GCC_CRYPTO_AXI_CLK>,
46                                  <&gcc GCC_CRYPTO_AHB_CLK>;
47                         clock-names = "core", "bus", "iface";
48                 };
49         };