diff options
| author | Andre Przywara <andre.przywara@arm.com> | 2023-03-21 13:53:19 +0000 |
|---|---|---|
| committer | Manish Pandey <manish.pandey2@arm.com> | 2023-03-27 19:36:00 +0100 |
| commit | d23acc9e4f94d95280ee7985e3f96482eb7fe04d (patch) | |
| tree | fcdaca586dc8781d27b0fc76a5739c66eaea5ed9 /docs/getting_started | |
| parent | 82f5b5098b7674f5b8c6b1e3cd24902b6a508f5a (diff) | |
| download | arm-trusted-firmware-d23acc9e4f94d95280ee7985e3f96482eb7fe04d.tar.gz | |
refactor(amu): unify ENABLE_AMU and ENABLE_FEAT_AMUv1
So far we have the ENABLE_AMU build option to include AMU register
handling code for enabling and context switch. There is also an
ENABLE_FEAT_AMUv1 option, solely to protect the HAFGRTR_EL2 system
register handling. The latter needs some alignment with the new feature
scheme, but it conceptually overlaps with the ENABLE_AMU option.
Since there is no real need for two separate options, unify both into a
new ENABLE_FEAT_AMU name in a first step. This is mostly just renaming at
this point, a subsequent patch will make use of the new feature handling
scheme.
Change-Id: I97d8a55bdee2ed1e1509fa9f2b09fd0bdd82736e
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
Diffstat (limited to 'docs/getting_started')
| -rw-r--r-- | docs/getting_started/build-options.rst | 18 |
1 files changed, 6 insertions, 12 deletions
diff --git a/docs/getting_started/build-options.rst b/docs/getting_started/build-options.rst index 0540b6d2f..08c1ff68e 100644 --- a/docs/getting_started/build-options.rst +++ b/docs/getting_started/build-options.rst @@ -230,11 +230,6 @@ Common build options payload. Please refer to the "Booting an EL3 payload" section for more details. -- ``ENABLE_AMU``: Boolean option to enable Activity Monitor Unit extensions. - This is an optional architectural feature available on v8.4 onwards. Some - v8.2 implementations also implement an AMU and this option can be used to - enable this feature on those systems as well. Default is 0. - - ``ENABLE_AMU_AUXILIARY_COUNTERS``: Enables support for AMU auxiliary counters (also known as group 1 counters). These are implementation-defined counters, and as such require additional platform configuration. Default is 0. @@ -261,13 +256,12 @@ Common build options builds, but this behaviour can be overridden in each platform's Makefile or in the build command line. -- ``ENABLE_FEAT_AMUv1``: Numeric value to enable access to the HAFGRTR_EL2 - (Hypervisor Activity Monitors Fine-Grained Read Trap Register) during EL2 - to EL3 context save/restore operations. This flag can take the values 0 to 2, - to align with the ``FEATURE_DETECTION`` mechanism. It is an optional feature - available on v8.4 and onwards and must be set to either 1 or 2 alongside - ``ENABLE_FEAT_FGT``, to access the HAFGRTR_EL2 register. - Default value is ``0``. +- ``ENABLE_FEAT_AMU``: Numeric value to enable Activity Monitor Unit + extensions. This flag can take the values 0 to 2, to align with the + ``FEATURE_DETECTION`` mechanism. This is an optional architectural feature + available on v8.4 onwards. Some v8.2 implementations also implement an AMU + and this option can be used to enable this feature on those systems as well. + This flag can take the values 0 to 2, the default is 0. - ``ENABLE_FEAT_AMUv1p1``: Numeric value to enable the ``FEAT_AMUv1p1`` extension. ``FEAT_AMUv1p1`` is an optional feature available on Arm v8.6 |