path: root/docs
diff options
authorRyan Harkin <ryan.harkin@linaro.org>2014-01-13 12:37:03 +0000
committerDan Handley <dan.handley@arm.com>2014-01-20 18:45:04 +0000
commit25cff83ee4300f26d5b7661ad6359525aaa36b94 (patch)
tree99eb00fe80b041dbaaf54ed8403aab6744154c59 /docs
parent5443f2be407f23a19c31564121683ddc24b982e8 (diff)
Build system: Fixes #2: Add multi-platform support
Move all explicit platform or architecture specific references into a new platform.mk file that is defined for each platform. Change-Id: I9d6320d1ba957e0cc8d9b316b3578132331fa428 Signed-off-by: Ryan Harkin <ryan.harkin@linaro.org>
Diffstat (limited to 'docs')
2 files changed, 9 insertions, 4 deletions
diff --git a/docs/change-log.md b/docs/change-log.md
index 7d6d8f6..50e1111 100644
--- a/docs/change-log.md
+++ b/docs/change-log.md
@@ -98,6 +98,11 @@ Detailed changes since last release
system. The GICv3 re-distributors are probed to work out which
re-distributor should be used with which CPU.
+* Add multi-platform support to the build system. The user may now specify
+ which platform to build using PLAT=<platform> as part of the make command
+ line. Default behaviour is to make all platforms. New platforms are
+ automatically detected by the make file when they are added to the plat
+ directory.
ARM Trusted Firmware - version 0.2
diff --git a/docs/user-guide.md b/docs/user-guide.md
index bc4597f..0358e07 100644
--- a/docs/user-guide.md
+++ b/docs/user-guide.md
@@ -82,7 +82,7 @@ To build the software for the FVPs, follow these steps:
3. Set the compiler path and build:
- CROSS_COMPILE=<path-to-aarch64-gcc>/bin/aarch64-none-elf- make
+ CROSS_COMPILE=<path-to-aarch64-gcc>/bin/aarch64-none-elf- make PLAT=fvp
By default this produces a release version of the build. To produce a debug
version instead, refer to the "Debugging options" section below.
@@ -104,7 +104,7 @@ To build the software for the FVPs, follow these steps:
5. (Optional) Build products for a specific build variant can be removed using:
- make DEBUG=<D> clean
+ make DEBUG=<D> PLAT=fvp clean
... where `<D>` is `0` or `1`, as specified when building.
@@ -117,7 +117,7 @@ To build the software for the FVPs, follow these steps:
To compile a debug version and make the build more verbose use
- CROSS_COMPILE=<path-to-aarch64-gcc>/bin/aarch64-none-elf- make DEBUG=1 V=1
+ CROSS_COMPILE=<path-to-aarch64-gcc>/bin/aarch64-none-elf- make PLAT=fvp DEBUG=1 V=1
AArch64 GCC uses DWARF version 4 debugging symbols by default. Some tools (for
example DS-5) might not support this and may need an older version of DWARF
@@ -135,7 +135,7 @@ Extra debug options can be passed to the build system by setting `CFLAGS`:
CFLAGS='-O0 -gdwarf-2' \
CROSS_COMPILE=<path-to-aarch64-gcc>/bin/aarch64-none-elf- \
- make DEBUG=1 V=1
+ make PLAT=fvp DEBUG=1 V=1
NOTE: The Foundation FVP does not provide a debugger interface.