2.3. Building

This page assumes the Prerequisites have been followed to install all project dependencies.

2.3.1. Hafnium

By default, the Hafnium SPMC is built with clang for a few target platforms along with tests. From Hafnium top level directory, simply type:

make

The resulting FVP image is located in out/reference/secure_aem_v8a_fvp_vhe_clang/hafnium.bin.

The presence of assertions in the final build can be set using the ENABLE_ASSERTIONS make variable, by default this is set to true, meaning asserts are included in the build.

make ENABLE_ASSERTIONS=<true|false>

Each project in the project directory specifies a root configurations of the build. Adding a project is the preferred way to extend support to new platforms. The target project that is built is selected by the PROJECT make variable, the default project is ‘reference’.

make PROJECT=<project_name>

If you wish to change the value of the make variables you may need to first use:

make clobber

So the args.gn file will be regenerated with the new values.

2.3.2. Hafnium Documentation

If you have already sourced a virtual environment, Poetry will respect this and install dependencies there.

poetry run make doc