mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-15 17:14:21 +00:00
d23acc9e4f
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>
34 lines
1.2 KiB
ReStructuredText
34 lines
1.2 KiB
ReStructuredText
Activity Monitors
|
|
=================
|
|
|
|
FEAT_AMUv1 of the Armv8-A architecture introduces the Activity Monitors
|
|
extension. This extension describes the architecture for the Activity Monitor
|
|
Unit (|AMU|), an optional non-invasive component for monitoring core events
|
|
through a set of 64-bit counters.
|
|
|
|
When the ``ENABLE_FEAT_AMU=1`` build option is provided, Trusted Firmware-A
|
|
sets up the |AMU| prior to its exit from EL3, and will save and restore
|
|
architected |AMU| counters as necessary upon suspend and resume.
|
|
|
|
.. _Activity Monitor Auxiliary Counters:
|
|
|
|
Auxiliary counters
|
|
------------------
|
|
|
|
FEAT_AMUv1 describes a set of implementation-defined auxiliary counters (also
|
|
known as group 1 counters), controlled by the ``ENABLE_AMU_AUXILIARY_COUNTERS``
|
|
build option.
|
|
|
|
As a security precaution, Trusted Firmware-A does not enable these by default.
|
|
Instead, platforms may configure their auxiliary counters through one of two
|
|
possible mechanisms:
|
|
|
|
- |FCONF|, controlled by the ``ENABLE_AMU_FCONF`` build option.
|
|
- A platform implementation of the ``plat_amu_topology`` function (the default).
|
|
|
|
See :ref:`Activity Monitor Unit (AMU) Bindings` for documentation on the |FCONF|
|
|
device tree bindings.
|
|
|
|
--------------
|
|
|
|
*Copyright (c) 2021, Arm Limited. All rights reserved.*
|