4.1. Configuring the examples

This section describes how to configure the AMBA-PV examples. The examples are installed with AMBA-PV and located in $MAXCORE_HOME/AMBA-PV.

The examples use SystemC and TLM headers and libraries and require the SYSTEMC_HOME environment variable environment variable to be set. This is done when AMBA-PV is installed. To use a different copy of SystemC or TLM, modify the variable before building the examples.

Table 4.1. Environment variable[1]

Environment variableDescription
SYSTEMC_HOMEPoints to the SystemC 2.3.0 installation directory

[1] You do not need to set the TLM_HOME environment variable when using SystemC. The examples work if it is unset or set to the same value as SYSTEMC_HOME.

SystemC and TLM headers and libraries are installed in $MAXCORE_HOME/Accellera, which contains releases of the SystemC and TLM packages and patch files. The patch files document the required changes to the SystemC and TLM packages available from Accellera. The SystemC and TLM packages are link compatible with the Accellera download version.

The AMBA-PV examples rely on a certain directory structure for libraries and header files. This is different from the packages that can be obtained from Accellera because AMBA-PV supports a different range of compilers than the Accellera packages. To use the original Accellera packages in conjunction with the AMBA-PV examples, apply a set of patch files to the Accellera package that adjusts the directory names. To re-build the packages, follow the instructions from the README.txt file available in the $MAXCORE_HOME/Accellera/source directory.

On Linux hosts, the make command in each example directory generates an executable that consists of the example name followed by .x (for example, dma.x, or bridge.x).

On Microsoft Windows hosts, Microsoft Visual Studio project files are provided for the 2008 and 2010 versions (for example, dma_VC2008.vcproj, or bridge_VC2010.vcxproj).

Copyright © 2009-2013 ARM. All rights reserved.ARM DUI 0455H