Arm Event Counters Functions - 2023.1 English

Standalone Library Documentation: BSP and Libraries Document Collection (UG643)

Document ID
UG643
Release Date
2023-05-16
Version
2023.1 English

This section contain APIs for configuring and controlling the Performance Monitor Events for Arm based processors supported by standalone BSP. For more information about the event counters, see xpm_counter.h file.

It contains APIs to setup an event, return the event counter value, disable event(s), enable events, and reset event counters. It also provides a helper function: Xpm_SleepPerfCounter that is used to implement sleep routines in non-OS environment. It also contains two APIs which are being deprecated. Users are advised not to use them. On usage of these APIs, refer to xpm_conter_example.c file which is available in the standalone/examples folder.

Table 1. Quick Function Reference
Type Name Arguments
void Xpm_SetEvents
  • s32 PmcrCfg
void Xpm_GetEventCounters
  • u32 * PmCtrValue
u32 Xpm_DisableEvent
  • u32 EventCntrId
u32 Xpm_SetUpAnEvent
  • u32 EventID
u32 Xpm_GetEventCounter
  • u32 EventCntrId
  • u32 * CntVal
void Xpm_DisableEventCounters
  • void
void Xpm_EnableEventCounters
  • void
void Xpm_ResetEventCounters
  • void
void Xpm_SleepPerfCounter
  • u32 delay
  • u64 frequency