Introduce the ARM TF reset design document
authorSandrine Bailleux <sandrine.bailleux@arm.com>
Tue, 15 Dec 2015 14:27:17 +0000 (14:27 +0000)
committerSandrine Bailleux <sandrine.bailleux@arm.com>
Tue, 15 Dec 2015 15:14:43 +0000 (15:14 +0000)
commitc2f0260c12e3d3c917a7242ef235832b6dbfd66d
tree6604b5bb9b4e92e8de893224f77a16776f61b8b1
parent8e4f829179bf265e067c5e6151f044fdbdd298af
Introduce the ARM TF reset design document

This patch introduces a new document presenting the ARM Trusted
Firmware Reset Design. It shows the reset code flow, lists the
different build options that affect it, in which case to use them
and what their exact effect is.

The section about using BL31 entrypoint as the reset address has
been moved from the general firmware design document to this one.
It's also been improved to explain why the FVP port supports the
RESET_TO_BL31 configuration, even though the reset vector address
can't be programmed dynamically.

This document includes some images, which have been generated using
Dia version 0.97.2. This tool can be obtained from:
https://wiki.gnome.org/Apps/Dia/Download
This patch provides:
 - the image files describing the different reset flow diagrams;
 - the source '.dia' file;
 - a script automating the generation of the images from the '.dia'
   file.
Note that the 2 latter files are not actually needed for the document
and are provided for convenience only, in case the reset images need
to be modified.

Change-Id: Ib6302e8209d418a5b31c4e85e55fd9e83caf2ca2
docs/diagrams/default_reset_code.png [new file with mode: 0644]
docs/diagrams/generate_reset_images.sh [new file with mode: 0755]
docs/diagrams/reset_code_flow.dia [new file with mode: 0644]
docs/diagrams/reset_code_no_boot_type_check.png [new file with mode: 0644]
docs/diagrams/reset_code_no_checks.png [new file with mode: 0644]
docs/diagrams/reset_code_no_cpu_check.png [new file with mode: 0644]
docs/firmware-design.md
docs/reset-design.md [new file with mode: 0644]