rk3399_ARM-atf/docs/architecture_features.rst

8 code and determine whether TF-A support them. However, for features that are transparent to EL3, it
10 in TF-A.
13 architectural features within TF-A.
22    * ``OK``: TF-A has explicit support;
29 ---------------
31 +-------------------------+--------+
35 +-------------------------+--------+
37 +-------------------------+--------+
39 +-------------------------+--------+
41 +-------------------------+--------+
43 +-------------------------+--------+
45 +-------------------------+--------+
47 +-------------------------+--------+
49 +-------------------------+--------+
51 +-------------------------+--------+
53 +-------------------------+--------+
55 +-------------------------+--------+
57 +-------------------------+--------+
59 +-------------------------+--------+
61 +-------------------------+--------+
63 +-------------------------+--------+
65 +-------------------------+--------+
67 +-------------------------+--------+
69 +-------------------------+--------+
71 +-------------------------+--------+
73 +-------------------------+--------+
75 +-------------------------+--------+
77 +-------------------------+--------+
79 +-------------------------+--------+
81 +-------------------------+--------+
83 +-------------------------+--------+
85 +-------------------------+--------+
88 ---------------
90 +-----------------------+--------+
94 +-----------------------+--------+
96 +-----------------------+--------+
98 +-----------------------+--------+
100 +-----------------------+--------+
102 +-----------------------+--------+
104 +-----------------------+--------+
106 +-----------------------+--------+
108 +-----------------------+--------+
110 +-----------------------+--------+
112 +-----------------------+--------+
114 +-----------------------+--------+
116 +-----------------------+--------+
118 +-----------------------+--------+
120 +-----------------------+--------+
122 +-----------------------+--------+
124 +-----------------------+--------+
126 +-----------------------+--------+
128 +-----------------------+--------+
130 +-----------------------+--------+
132 +-----------------------+--------+
134 +-----------------------+--------+
136 +-----------------------+--------+
138 +-----------------------+--------+
140 +-----------------------+--------+
142 +-----------------------+--------+
144 +-----------------------+--------+
146 +-----------------------+--------+
148 +-----------------------+--------+
150 +-----------------------+--------+
152 +-----------------------+--------+
154 +-----------------------+--------+
156 +-----------------------+--------+
158 +-----------------------+--------+
160 +-----------------------+--------+
162 +-----------------------+--------+
164 +-----------------------+--------+
167 ---------------
169 +-------------------+--------+
173 +-------------------+--------+
175 +-------------------+--------+
177 +-------------------+--------+
179 +-------------------+--------+
181 +-------------------+--------+
183 +-------------------+--------+
185 +-------------------+--------+
187 +-------------------+--------+
189 +-------------------+--------+
191 +-------------------+--------+
193 +-------------------+--------+
195 +-------------------+--------+
197 +-------------------+--------+
199 +-------------------+--------+
201 +-------------------+--------+
203 +-------------------+--------+
205 +-------------------+--------+
207 +-------------------+--------+
209 +-------------------+--------+
211 +-------------------+--------+
213 +-------------------+--------+
215 +-------------------+--------+
217 +-------------------+--------+
219 +-------------------+--------+
221 +-------------------+--------+
223 +-------------------+--------+
225 +-------------------+--------+
227 +-------------------+--------+
229 +-------------------+--------+
231 +-------------------+--------+
233 +-------------------+--------+
235 +-------------------+--------+
237 +-------------------+--------+
239 +-------------------+--------+
242 ---------------
244 +--------------------------+--------+
248 +--------------------------+--------+
250 +--------------------------+--------+
252 +--------------------------+--------+
254 +--------------------------+--------+
256 +--------------------------+--------+
258 +--------------------------+--------+
260 +--------------------------+--------+
262 +--------------------------+--------+
264 +--------------------------+--------+
266 +--------------------------+--------+
268 +--------------------------+--------+
270 +--------------------------+--------+
272 +--------------------------+--------+
274 +--------------------------+--------+
276 +--------------------------+--------+
278 +--------------------------+--------+
280 +--------------------------+--------+
282 +--------------------------+--------+
284 +--------------------------+--------+
286 +--------------------------+--------+
288 +--------------------------+--------+
290 +--------------------------+--------+
292 +--------------------------+--------+
294 +--------------------------+--------+
296 +--------------------------+--------+
298 +--------------------------+--------+
300 +--------------------------+--------+
302 +--------------------------+--------+
304 +--------------------------+--------+
306 +--------------------------+--------+
308 +--------------------------+--------+
310 +--------------------------+--------+
312 +--------------------------+--------+
314 +--------------------------+--------+
316 +--------------------------+--------+
318 +--------------------------+--------+
320 +--------------------------+--------+
322 +--------------------------+--------+
324 +--------------------------+--------+
326 +--------------------------+--------+
328 +--------------------------+--------+
330 +--------------------------+--------+
332 +--------------------------+--------+
334 +--------------------------+--------+
336 +--------------------------+--------+
338 +--------------------------+--------+
340 +--------------------------+--------+
342 +--------------------------+--------+
344 +--------------------------+--------+
346 +--------------------------+--------+
348 +--------------------------+--------+
350 +--------------------------+--------+
352 +--------------------------+--------+
354 +--------------------------+--------+
356 +--------------------------+--------+
358 +--------------------------+--------+
360 +--------------------------+--------+
362 +--------------------------+--------+
364 +--------------------------+--------+
366 +--------------------------+--------+
368 +--------------------------+--------+
372 ---------------
374 +------------------+--------+
378 +------------------+--------+
380 +------------------+--------+
382 +------------------+--------+
384 +------------------+--------+
386 +------------------+--------+
388 +------------------+--------+
390 +------------------+--------+
392 +------------------+--------+
394 +------------------+--------+
396 +------------------+--------+
398 +------------------+--------+
400 +------------------+--------+
402 +------------------+--------+
404 +------------------+--------+
406 +------------------+--------+
410 ---------------
412 +---------------------+--------+
416 +---------------------+--------+
418 +---------------------+--------+
420 +---------------------+--------+
422 +---------------------+--------+
424 +---------------------+--------+
426 +---------------------+--------+
428 +---------------------+--------+
430 +---------------------+--------+
432 +---------------------+--------+
434 +---------------------+--------+
436 +---------------------+--------+
438 +---------------------+--------+
440 +---------------------+--------+
442 +---------------------+--------+
444 +---------------------+--------+
446 +---------------------+--------+
448 +---------------------+--------+
450 +---------------------+--------+
453 -----------------------------
457 higher exception levels, other features might be used by TF-A code itself.
459 Most of the feature flags defined in the TF-A build system are allowed to take
484 --------------------------------
499 - Add a feature flag to the build system.
501   - The flag's name should be in the form ``ENABLE_FEAT_ABC``.
503   - Add it to the ``assert_numerics`` and ``add_defines`` lists in the
506   - Add a default of ``0`` for it in ``make_helpers/arch_features.mk``. If the
510   - Add any constraints in ``make_helpers/constraints.mk``. This will usually be
514 - Add the feature accessor functions in ``include/arch/aarch64/arch_features.h``.
520   - The ``_supported`` variant is the one that should usually be used. If common
524   - In rare occasions, the feature must be checked in assembly. A
528 - Register the feature in ``common/feat_detect.c``.
530 - Add support for the feature. This will be very feature specific and exact code
535   - If support requires more extensive code sequences, consider adding them to a
540  - If the feature introduces ``SCR_EL3``, ``MDCR_EL3``, or ``CPTR_EL3`` controls
544  - If the feature introduces any control bits in ``SCR_EL3``, ``MDCR_EL3``,
551  - If the feature comes with registers, those should be context switched if
554  - Consider whether the feature introduces any potential side channels and how
557 - Add documentation in ``docs/getting_started/build-options.rst``. This should
563 - Enable the feature for the FVP platform in ``plat/arm/board/fvp/platform.mk``,
566 - If the feature is optional, enable it in CI in the "allconfig" fragments.
567   Those are currently ``run_config/fvp-aemv8a.all.bmcov``,
568   ``run_config/fvp-spm.all.bmcov``, ``run_config/fvp-spm.all``, and
569   ``run_config/fvp-aemv8a.all``. Mandatory features are expected to be covered
572 - Optionally, although recommended, is to add a test in TFTF. This should only