activity-monitors.rst 1.2 KB

12345678910111213141516171819202122232425262728293031323334
  1. Activity Monitors
  2. =================
  3. FEAT_AMUv1 of the Armv8-A architecture introduces the Activity Monitors
  4. extension. This extension describes the architecture for the Activity Monitor
  5. Unit (|AMU|), an optional non-invasive component for monitoring core events
  6. through a set of 64-bit counters.
  7. When the ``ENABLE_FEAT_AMU=1`` build option is provided, Trusted Firmware-A
  8. sets up the |AMU| prior to its exit from EL3, and will save and restore
  9. architected |AMU| counters as necessary upon suspend and resume.
  10. .. _Activity Monitor Auxiliary Counters:
  11. Auxiliary counters
  12. ------------------
  13. FEAT_AMUv1 describes a set of implementation-defined auxiliary counters (also
  14. known as group 1 counters), controlled by the ``ENABLE_AMU_AUXILIARY_COUNTERS``
  15. build option.
  16. As a security precaution, Trusted Firmware-A does not enable these by default.
  17. Instead, platforms may configure their auxiliary counters through one of two
  18. possible mechanisms:
  19. - |FCONF|, controlled by the ``ENABLE_AMU_FCONF`` build option.
  20. - A platform implementation of the ``plat_amu_topology`` function (the default).
  21. See :ref:`Activity Monitor Unit (AMU) Bindings` for documentation on the |FCONF|
  22. device tree bindings.
  23. --------------
  24. *Copyright (c) 2021, Arm Limited. All rights reserved.*