xref: /freebsd/sys/contrib/device-tree/Bindings/firmware/qcom,scm.txt (revision dd41de95a84d979615a2ef11df6850622bf6184e)
1QCOM Secure Channel Manager (SCM)
2
3Qualcomm processors include an interface to communicate to the secure firmware.
4This interface allows for clients to request different types of actions.  These
5can include CPU power up/down, HDCP requests, loading of firmware, and other
6assorted actions.
7
8Required 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 and:
26 * "qcom,scm"
27- clocks: Specifies clocks needed by the SCM interface, if any:
28 * core clock required for "qcom,scm-apq8064", "qcom,scm-msm8660" and
29   "qcom,scm-msm8960"
30 * core, iface and bus clocks required for "qcom,scm-apq8084",
31   "qcom,scm-msm8916" and "qcom,scm-msm8974"
32- clock-names: Must contain "core" for the core clock, "iface" for the interface
33  clock and "bus" for the bus clock per the requirements of the compatible.
34- qcom,dload-mode: phandle to the TCSR hardware block and offset of the
35		   download mode control register (optional)
36
37Example for MSM8916:
38
39	firmware {
40		scm {
41			compatible = "qcom,msm8916", "qcom,scm";
42			clocks = <&gcc GCC_CRYPTO_CLK> ,
43				 <&gcc GCC_CRYPTO_AXI_CLK>,
44				 <&gcc GCC_CRYPTO_AHB_CLK>;
45			clock-names = "core", "bus", "iface";
46		};
47	};
48