diff options
author | Soby Mathew <soby.mathew@arm.com> | 2014-04-07 15:28:55 +0100 |
---|---|---|
committer | Soby Mathew <soby.mathew@arm.com> | 2014-05-16 14:51:00 +0100 |
commit | a43d431b80541ea436b71f967c5749babf978c7a (patch) | |
tree | 15bbb0525b219f28bd9907bc77b9fd8391723caa /docs/porting-guide.md | |
parent | c5c9b69c132c823aabc1e29c2ff6f30323c85483 (diff) | |
download | arm-trusted-firmware-a43d431b80541ea436b71f967c5749babf978c7a.tar.gz |
Rework BL3-1 unhandled exception handling and reporting
This patch implements the register reporting when unhandled exceptions are
taken in BL3-1. Unhandled exceptions will result in a dump of registers
to the console, before halting execution by that CPU. The Crash Stack,
previously called the Exception Stack, is used for this activity.
This stack is used to preserve the CPU context and runtime stack
contents for debugging and analysis.
This also introduces the per_cpu_ptr_cache, referenced by tpidr_el3,
to provide easy access to some of BL3-1 per-cpu data structures.
Initially, this is used to provide a pointer to the Crash stack.
panic() now prints the the error file and line number in Debug mode
and prints the PC value in release mode.
The Exception Stack is renamed to Crash Stack with this patch.
The original intention of exception stack is no longer valid
since we intend to support several valid exceptions like IRQ
and FIQ in the trusted firmware context. This stack is now
utilized for dumping and reporting the system state when a
crash happens and hence the rename.
Fixes ARM-software/tf-issues#79 Improve reporting of unhandled exception
Change-Id: I260791dc05536b78547412d147193cdccae7811a
Diffstat (limited to 'docs/porting-guide.md')
-rw-r--r-- | docs/porting-guide.md | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/porting-guide.md b/docs/porting-guide.md index e967b0e..721ba1b 100644 --- a/docs/porting-guide.md +++ b/docs/porting-guide.md @@ -194,6 +194,18 @@ constants defined. In the ARM FVP port, this file is found in Defines the base address in non-secure DRAM where BL2 loads the BL3-3 binary image. Must be aligned on a page-size boundary. +### File : platform_macros.S [mandatory] + +Each platform must export a file of this name with the following +macro defined. In the ARM FVP port, this file is found in +[plat/fvp/include/platform_macros.S]. + +* **Macro : plat_print_gic_regs** + + This macro allows the crash reporting routine to print GIC registers + in case of an unhandled IRQ or FIQ in BL3-1. This aids in debugging and + this macro can be defined to be empty in case GIC register reporting is + not desired. ### Other mandatory modifications @@ -1147,6 +1159,7 @@ _Copyright (c) 2013-2014, ARM Limited and Contributors. All rights reserved._ [plat/common/aarch64/platform_mp_stack.S]: ../plat/common/aarch64/platform_mp_stack.S [plat/common/aarch64/platform_up_stack.S]: ../plat/common/aarch64/platform_up_stack.S [plat/fvp/platform.h]: ../plat/fvp/platform.h +[plat/fvp/include/platform_macros.S]: ../plat/fvp/include/platform_macros.S [plat/fvp/aarch64/plat_common.c]: ../plat/fvp/aarch64/plat_common.c [plat/fvp/plat_pm.c]: ../plat/fvp/plat_pm.c [include/runtime_svc.h]: ../include/runtime_svc.h |