xref: /rk3399_ARM-atf/docs/components/activity-monitors.rst (revision d23acc9e4f94d95280ee7985e3f96482eb7fe04d)
19cf75647SChris KayActivity Monitors
29cf75647SChris Kay=================
39cf75647SChris Kay
49cf75647SChris KayFEAT_AMUv1 of the Armv8-A architecture introduces the Activity Monitors
59cf75647SChris Kayextension. This extension describes the architecture for the Activity Monitor
69cf75647SChris KayUnit (|AMU|), an optional non-invasive component for monitoring core events
79cf75647SChris Kaythrough a set of 64-bit counters.
89cf75647SChris Kay
9*d23acc9eSAndre PrzywaraWhen the ``ENABLE_FEAT_AMU=1`` build option is provided, Trusted Firmware-A
10*d23acc9eSAndre Przywarasets up the |AMU| prior to its exit from EL3, and will save and restore
11*d23acc9eSAndre Przywaraarchitected |AMU| counters as necessary upon suspend and resume.
129cf75647SChris Kay
1368120783SChris Kay.. _Activity Monitor Auxiliary Counters:
1468120783SChris Kay
15742ca230SChris KayAuxiliary counters
16742ca230SChris Kay------------------
17742ca230SChris Kay
18742ca230SChris KayFEAT_AMUv1 describes a set of implementation-defined auxiliary counters (also
19742ca230SChris Kayknown as group 1 counters), controlled by the ``ENABLE_AMU_AUXILIARY_COUNTERS``
20742ca230SChris Kaybuild option.
21742ca230SChris Kay
22742ca230SChris KayAs a security precaution, Trusted Firmware-A does not enable these by default.
23742ca230SChris KayInstead, platforms may configure their auxiliary counters through one of two
24742ca230SChris Kaypossible mechanisms:
25742ca230SChris Kay
26742ca230SChris Kay- |FCONF|, controlled by the ``ENABLE_AMU_FCONF`` build option.
27742ca230SChris Kay- A platform implementation of the ``plat_amu_topology`` function (the default).
28742ca230SChris Kay
29742ca230SChris KaySee :ref:`Activity Monitor Unit (AMU) Bindings` for documentation on the |FCONF|
30742ca230SChris Kaydevice tree bindings.
31742ca230SChris Kay
329cf75647SChris Kay--------------
339cf75647SChris Kay
349cf75647SChris Kay*Copyright (c) 2021, Arm Limited. All rights reserved.*
35