forked from ~ljy/RK356X_SDK_RELEASE

hc
2024-05-13 9d77db3c730780c8ef5ccd4b66403ff5675cfe4e
kernel/Documentation/devicetree/bindings/remoteproc/qcom,q6v5.txt
....@@ -12,6 +12,8 @@
1212 "qcom,msm8916-mss-pil",
1313 "qcom,msm8974-mss-pil"
1414 "qcom,msm8996-mss-pil"
15
+ "qcom,msm8998-mss-pil"
16
+ "qcom,sc7180-mss-pil"
1517 "qcom,sdm845-mss-pil"
1618
1719 - reg:
....@@ -28,24 +30,59 @@
2830 - interrupts-extended:
2931 Usage: required
3032 Value type: <prop-encoded-array>
31
- Definition: must list the watchdog, fatal IRQs ready, handover and
32
- stop-ack IRQs
33
+ Definition: reference to the interrupts that match interrupt-names
3334
3435 - interrupt-names:
3536 Usage: required
3637 Value type: <stringlist>
37
- Definition: must be "wdog", "fatal", "ready", "handover", "stop-ack"
38
+ Definition: The interrupts needed depends on the the compatible
39
+ string:
40
+ qcom,q6v5-pil:
41
+ qcom,ipq8074-wcss-pil:
42
+ qcom,msm8916-mss-pil:
43
+ qcom,msm8974-mss-pil:
44
+ must be "wdog", "fatal", "ready", "handover", "stop-ack"
45
+ qcom,msm8996-mss-pil:
46
+ qcom,msm8998-mss-pil:
47
+ qcom,sc7180-mss-pil:
48
+ qcom,sdm845-mss-pil:
49
+ must be "wdog", "fatal", "ready", "handover", "stop-ack",
50
+ "shutdown-ack"
51
+
52
+- firmware-name:
53
+ Usage: optional
54
+ Value type: <stringlist>
55
+ Definition: must list the relative firmware image paths for mba and
56
+ modem. They are used for booting and authenticating the
57
+ Hexagon core.
3858
3959 - clocks:
4060 Usage: required
4161 Value type: <phandle>
42
- Definition: reference to the iface, bus and mem clocks to be held on
43
- behalf of the booting of the Hexagon core
62
+ Definition: reference to the clocks that match clock-names
4463
4564 - clock-names:
4665 Usage: required
4766 Value type: <stringlist>
48
- Definition: must be "iface", "bus", "mem"
67
+ Definition: The clocks needed depend on the compatible string:
68
+ qcom,ipq8074-wcss-pil:
69
+ no clock names required
70
+ qcom,q6v5-pil:
71
+ qcom,msm8916-mss-pil:
72
+ qcom,msm8974-mss-pil:
73
+ must be "iface", "bus", "mem", "xo"
74
+ qcom,msm8996-mss-pil:
75
+ must be "iface", "bus", "mem", "xo", "gpll0_mss",
76
+ "snoc_axi", "mnoc_axi", "pnoc", "qdss"
77
+ qcom,msm8998-mss-pil:
78
+ must be "iface", "bus", "mem", "xo", "gpll0_mss",
79
+ "snoc_axi", "mnoc_axi", "qdss"
80
+ qcom,sc7180-mss-pil:
81
+ must be "iface", "bus", "xo", "snoc_axi", "mnoc_axi",
82
+ "nav"
83
+ qcom,sdm845-mss-pil:
84
+ must be "iface", "bus", "mem", "xo", "gpll0_mss",
85
+ "snoc_axi", "mnoc_axi", "prng"
4986
5087 - resets:
5188 Usage: required
....@@ -53,14 +90,39 @@
5390 Definition: reference to the reset-controller for the modem sub-system
5491 reference to the list of 3 reset-controllers for the
5592 wcss sub-system
93
+ reference to the list of 2 reset-controllers for the modem
94
+ sub-system on SC7180, SDM845 SoCs
5695
5796 - reset-names:
5897 Usage: required
5998 Value type: <stringlist>
6099 Definition: must be "mss_restart" for the modem sub-system
61
- Definition: must be "wcss_aon_reset", "wcss_reset", "wcss_q6_reset"
62
- for the wcss syb-system
100
+ must be "wcss_aon_reset", "wcss_reset", "wcss_q6_reset"
101
+ for the wcss sub-system
102
+ must be "mss_restart", "pdc_reset" for the modem
103
+ sub-system on SC7180, SDM845 SoCs
63104
105
+For devices where the mba and mpss sub-nodes are not specified, mba/mpss region
106
+should be referenced as follows:
107
+- memory-region:
108
+ Usage: required
109
+ Value type: <phandle>
110
+ Definition: reference to the reserved-memory for the mba region followed
111
+ by the mpss region
112
+
113
+For the compatible strings below the following supplies are required:
114
+ "qcom,q6v5-pil"
115
+ "qcom,msm8916-mss-pil",
116
+- cx-supply:
117
+- mx-supply:
118
+- pll-supply:
119
+ Usage: required
120
+ Value type: <phandle>
121
+ Definition: reference to the regulators to be held on behalf of the
122
+ booting of the Hexagon core
123
+
124
+For the compatible string below the following supplies are required:
125
+ "qcom,msm8974-mss-pil"
64126 - cx-supply:
65127 - mss-supply:
66128 - mx-supply:
....@@ -69,6 +131,35 @@
69131 Value type: <phandle>
70132 Definition: reference to the regulators to be held on behalf of the
71133 booting of the Hexagon core
134
+
135
+For the compatible string below the following supplies are required:
136
+ "qcom,msm8996-mss-pil"
137
+- pll-supply:
138
+ Usage: required
139
+ Value type: <phandle>
140
+ Definition: reference to the regulators to be held on behalf of the
141
+ booting of the Hexagon core
142
+
143
+- power-domains:
144
+ Usage: required
145
+ Value type: <phandle>
146
+ Definition: reference to power-domains that match power-domain-names
147
+
148
+- power-domain-names:
149
+ Usage: required
150
+ Value type: <stringlist>
151
+ Definition: The power-domains needed depend on the compatible string:
152
+ qcom,q6v5-pil:
153
+ qcom,ipq8074-wcss-pil:
154
+ qcom,msm8916-mss-pil:
155
+ qcom,msm8974-mss-pil:
156
+ no power-domain names required
157
+ qcom,msm8996-mss-pil:
158
+ qcom,msm8998-mss-pil:
159
+ must be "cx", "mx"
160
+ qcom,sc7180-mss-pil:
161
+ qcom,sdm845-mss-pil:
162
+ must be "cx", "mx", "mss", "load_state"
72163
73164 - qcom,smem-states:
74165 Usage: required
....@@ -88,6 +179,18 @@
88179 by the three offsets within syscon for q6, modem and nc
89180 halt registers.
90181
182
+For the compatible strings below the following phandle references are required:
183
+ "qcom,sc7180-mss-pil"
184
+- qcom,spare-regs:
185
+ Usage: required
186
+ Value type: <prop-encoded-array>
187
+ Definition: a phandle reference to a syscon representing TCSR followed
188
+ by the offset within syscon for conn_box_spare0 register
189
+ used by the modem sub-system running on SC7180 SoC.
190
+
191
+The Hexagon node must contain iommus property as described in ../iommu/iommu.txt
192
+on platforms which do not have TrustZone.
193
+
91194 = SUBNODES:
92195 The Hexagon node must contain two subnodes, named "mba" and "mpss" representing
93196 the memory regions used by the Hexagon firmware. Each sub-node must contain: