docs/components/context-management-library.rst

1 Context Management Library
4 This document provides an overview of the Context Management library implementation
23 TF-A Context
56 The Context Management library in TF-A is designed to cover all the requirements
60 firmware, which are collectively referred to as CPU Context Management.
64 Originally, the Context Management library in TF-A was designed to cater for a
78 Context Management library running at EL3 should only initialize and monitor the
150 `lib/el3_runtime/(aarch32/aarch64)`_ - Context library code directory.
172 #. ``context_mgmt.h`` :  contains the public interface to Context Management Library.
187 Bootloader Images utilizing Context Management Library
191 |   Bootloader                              | Context Management Library  |
249 CPU Context and Memory allocation
252 CPU Context
280 Context Memory Allocation
287 |Context memory allocation|
289 NS-Context Memory
299 Secure-Context Memory
308 Realm-Context Memory
321 |CPU Context Memory Configuration|
323 Context Setup/Initialization
332 Context Setup during Cold boot
348 |Context Init ColdBoot|
354 Context Setup during Warmboot
361 |Context Init WarmBoot|
398 Context Initialization for Individual Worlds
501 Per-world Context
535 Root-Context (EL3-Execution-Context)
538 EL3/Root Context is the execution environment while the CPU is running at EL3.
562 EL3 Context ensures, CPU executes under fixed EL3 system register settings
565 Root Context needs to be setup as early as possible before we try and access/modify
574 |Root Context Sequence|
586 .. |Context Memory Allocation| image:: ../resources/diagrams/context_memory_allocation.png
587 .. |CPU Context Memory Configuration| image:: ../resources/diagrams/cpu_data_config_context_memory.…
589 .. |Context Init ColdBoot| image:: ../resources/diagrams/context_init_coldboot.png
590 .. |Context Init WarmBoot| image:: ../resources/diagrams/context_init_warmboot.png
591 .. |Root Context Sequence| image:: ../resources/diagrams/root_context_sequence.png