arm-trusted-firmware/docs/components/activity-monitors.rst
Boyan Karatotev a02495ea5b chore(docs): explain what the plat_amu_aux_enables array does
Change-Id: I90f1bcaa8bec133d3be81785aea11948208ca0a5
Signed-off-by: Boyan Karatotev <boyan.karatotev@arm.com>
2025-03-19 16:54:50 +01:00

30 lines
1.1 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 must configure their auxiliary counters through the
``plat_amu_aux_enables`` platform hook. This is a per-core array indexed with
``plat_my_core_pos()``. A core's value will be written verbatim into
``AMCNTENSET1_EL0``.
--------------
*Copyright (c) 2021-2025, Arm Limited. All rights reserved.*