1 # SPDX-License-Identifier: (GPL-2.0-only OR BS
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/remoteproc/
5 $schema: http://devicetree.org/meta-schemas/co
6
7 title: TI K3 R5F processor subsystems
8
9 maintainers:
10 - Suman Anna <s-anna@ti.com>
11
12 description: |
13 The TI K3 family of SoCs usually have one or
14 processor subsystems/clusters (R5FSS). The d
15 either in a LockStep mode providing safety/f
16 Split mode providing two individual compute
17 capacity on most SoCs. These are used togeth
18 on the SoC to achieve various system level g
19
20 AM64x SoCs do not support LockStep mode, but
21 called "Single-CPU" mode, where only Core0 i
22 Core1's TCMs as well.
23
24 AM62 SoC family support a single R5F core on
25 firmware and can also be used as a remote pr
26
27 Each Dual-Core R5F sub-system is represented
28 representing the cluster, with a pair of chi
29 the individual R5F cores. Each node has a nu
30 properties that enable the OS running on the
31 the device management of the remote processo
32 remote processor.
33
34 properties:
35 $nodename:
36 pattern: "^r5fss(@.*)?"
37
38 compatible:
39 enum:
40 - ti,am62-r5fss
41 - ti,am64-r5fss
42 - ti,am654-r5fss
43 - ti,j7200-r5fss
44 - ti,j721e-r5fss
45 - ti,j721s2-r5fss
46
47 power-domains:
48 description: |
49 Should contain a phandle to a PM domain
50 specifier containing the R5FSS device id
51 maxItems: 1
52
53 "#address-cells":
54 const: 1
55
56 "#size-cells":
57 const: 1
58
59 ranges:
60 description: |
61 Standard ranges definition providing add
62 local R5F TCM address spaces to bus addr
63
64 # Optional properties:
65 # --------------------
66
67 ti,cluster-mode:
68 $ref: /schemas/types.yaml#/definitions/uin
69 description: |
70 Configuration Mode for the Dual R5F core
71 For most SoCs (AM65x, J721E, J7200, J721
72 It should be either a value of 1 (LockSt
73 most SoCs (AM65x, J721E, J7200, J721s2),
74 omitted.
75 For AM64x SoCs,
76 It should be either a value of 0 (Split
77 default is Split mode if omitted.
78 For AM62x SoCs,
79 It should be set as 3 (Single-Core mode)
80 omitted.
81
82
83 # R5F Processor Child Nodes:
84 # ==========================
85
86 patternProperties:
87 "^r5f@[a-f0-9]+$":
88 type: object
89 description: |
90 The R5F Sub-System device node should de
91 node representing a TI instantiation of
92 are some specific integration difference
93 a Region Address Translator (RAT) for tr
94 addresses into a 32-bit address space fo
95 the R5F Sub-System device node should on
96 as it has only one core available.
97
98 Each R5F core has an associated 64 KB of
99 internal memories split between two bank
100 interleaved into two banks TCMB0 and TCM
101 ATCM and BTCM) provide read/write perfor
102 caches. Each of the TCMs can be enabled
103 either of them can be configured to appe
104
105 The cores do not use an MMU, but has a R
106 (RAT) module that is accessible only fro
107 translations between 32-bit CPU addresse
108 addresses. Cache and memory access setti
109 Memory Protection Unit (MPU), programmab
110
111 $ref: /schemas/arm/keystone/ti,k3-sci-comm
112
113 properties:
114 compatible:
115 enum:
116 - ti,am62-r5f
117 - ti,am64-r5f
118 - ti,am654-r5f
119 - ti,j7200-r5f
120 - ti,j721e-r5f
121 - ti,j721s2-r5f
122
123 reg:
124 items:
125 - description: Address and Size of t
126 - description: Address and Size of t
127
128 reg-names:
129 items:
130 - const: atcm
131 - const: btcm
132
133 resets:
134 description: |
135 Should contain the phandle to the re
136 local resets for this device, and a
137 maxItems: 1
138
139 firmware-name:
140 description: |
141 Should contain the name of the defau
142 file located on the firmware search
143
144 # The following properties are mandatory for R
145 # modes, and are mandatory for R5F Core1 _only
146 # R5F Core1 in LockStep mode:
147
148 mboxes:
149 description: |
150 OMAP Mailbox specifier denoting the
151 communication with the remote proces
152 with the sub-mailbox node used in th
153 maxItems: 1
154
155 memory-region:
156 description: |
157 phandle to the reserved memory nodes
158 remoteproc device. There should be a
159 defined. The reserved memory nodes s
160 should be defined with a "no-map" pr
161 Documentation/devicetree/bindings/re
162 minItems: 2
163 maxItems: 8
164 items:
165 - description: region used for dynam
166 vring buffers
167 - description: region reserved for f
168 additionalItems: true
169
170
171 # Optional properties:
172 # --------------------
173 # The following properties are optional proper
174
175 ti,atcm-enable:
176 $ref: /schemas/types.yaml#/definitions
177 enum: [0, 1]
178 description: |
179 R5F core configuration mode dictatin
180 R5F address of ATCM is dictated by t
181 either a value of 1 (enabled) or 0 (
182 if omitted. Recommended to enable it
183
184 ti,btcm-enable:
185 $ref: /schemas/types.yaml#/definitions
186 enum: [0, 1]
187 description: |
188 R5F core configuration mode dictatin
189 R5F address of BTCM is dictated by t
190 either a value of 1 (enabled) or 0 (
191 omitted.
192
193 ti,loczrama:
194 $ref: /schemas/types.yaml#/definitions
195 enum: [0, 1]
196 description: |
197 R5F core configuration mode dictatin
198 address 0 (from core's view). Should
199 at 0x0) or 0 (BTCM at 0x0), default
200
201 sram:
202 $ref: /schemas/types.yaml#/definitions
203 minItems: 1
204 maxItems: 4
205 items:
206 maxItems: 1
207 description: |
208 phandles to one or more reserved on-
209 should be defined as child nodes of
210 should be defined as per the generic
211 Documentation/devicetree/bindings/sr
212
213 required:
214 - compatible
215 - reg
216 - reg-names
217 - ti,sci
218 - ti,sci-dev-id
219 - ti,sci-proc-ids
220 - resets
221 - firmware-name
222
223 unevaluatedProperties: false
224
225 allOf:
226 - if:
227 properties:
228 compatible:
229 enum:
230 - ti,am64-r5fss
231 then:
232 properties:
233 ti,cluster-mode:
234 enum: [0, 2]
235
236 - if:
237 properties:
238 compatible:
239 enum:
240 - ti,am654-r5fss
241 - ti,j7200-r5fss
242 - ti,j721e-r5fss
243 - ti,j721s2-r5fss
244 then:
245 properties:
246 ti,cluster-mode:
247 enum: [0, 1]
248
249 - if:
250 properties:
251 compatible:
252 enum:
253 - ti,am62-r5fss
254 then:
255 properties:
256 ti,cluster-mode:
257 enum: [3]
258
259 required:
260 - compatible
261 - power-domains
262 - "#address-cells"
263 - "#size-cells"
264 - ranges
265
266 additionalProperties: false
267
268 examples:
269 - |
270 soc {
271 #address-cells = <2>;
272 #size-cells = <2>;
273
274 mailbox0: mailbox-0 {
275 #mbox-cells = <1>;
276 };
277
278 mailbox1: mailbox-1 {
279 #mbox-cells = <1>;
280 };
281
282 bus@100000 {
283 compatible = "simple-bus";
284 #address-cells = <2>;
285 #size-cells = <2>;
286 ranges = <0x00 0x00100000 0x00 0x0
287 <0x00 0x41000000 0x00 0x4
288 <0x00 0x41400000 0x00 0x4
289 <0x00 0x41c00000 0x00 0x4
290
291 bus@28380000 {
292 compatible = "simple-bus";
293 #address-cells = <2>;
294 #size-cells = <2>;
295 ranges = <0x00 0x28380000 0x00
296 <0x00 0x41000000 0x00
297 <0x00 0x41400000 0x00
298 <0x00 0x41c00000 0x00
299
300 /* AM65x MCU R5FSS node */
301 mcu_r5fss0: r5fss@41000000 {
302 compatible = "ti,am654-r5f
303 power-domains = <&k3_pds 1
304 ti,cluster-mode = <1>;
305 #address-cells = <1>;
306 #size-cells = <1>;
307 ranges = <0x41000000 0x00
308 <0x41400000 0x00
309
310 mcu_r5f0: r5f@41000000 {
311 compatible = "ti,am654
312 reg = <0x41000000 0x00
313 <0x41010000 0x00
314 reg-names = "atcm", "b
315 ti,sci = <&dmsc>;
316 ti,sci-dev-id = <159>;
317 ti,sci-proc-ids = <0x0
318 resets = <&k3_reset 15
319 firmware-name = "am65x
320 ti,atcm-enable = <1>;
321 ti,btcm-enable = <1>;
322 ti,loczrama = <1>;
323 mboxes = <&mailbox0 &m
324 memory-region = <&mcu_
325 <&mcu_
326 sram = <&mcu_r5fss0_co
327 };
328
329 mcu_r5f1: r5f@41400000 {
330 compatible = "ti,am654
331 reg = <0x41400000 0x00
332 <0x41410000 0x00
333 reg-names = "atcm", "b
334 ti,sci = <&dmsc>;
335 ti,sci-dev-id = <245>;
336 ti,sci-proc-ids = <0x0
337 resets = <&k3_reset 24
338 firmware-name = "am65x
339 ti,atcm-enable = <1>;
340 ti,btcm-enable = <1>;
341 ti,loczrama = <1>;
342 mboxes = <&mailbox1 &m
343 };
344 };
345 };
346 };
347 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.