axipmon
Xilinx Vitis Drivers API Documentation
xaxipmon_polled_example.c File Reference

Overview

This file contains a design example showing how to use the driver APIs of the AXI Performance Monitor driver in poll mode.

Note

Global Clock Counter and Metric Counters are enabled. The Application for which Metrics need to be computed should be run and then the Metrics collected.

MODIFICATION HISTORY:
Ver   Who    Date     Changes


1.00a bss 02/29/12 First release 2.00a bss 06/23/12 Updated to support v2_00a version of IP. 3.00a bss 09/03/12 Deleted XAxiPmon_SetAgent API to support v2_01a version of IP. 3.01a bss 10/25/12 Deleted XAxiPmon_EnableCountersData API to support new version of IP. 6.5 ms 01/23/17 Modified xil_printf statement in main function to ensure that "Successfully ran" and "Failed" strings are available in all examples. This is a fix for CR-965028.

Functions

int AxiPmonPolledExample (u16 AxiPmonDeviceId, u32 *Metrics, u32 *ClkCntHigh, u32 *ClkCntLow)
 This function runs a test on the AXI Performance Monitor device using the driver APIs. More...
 
int main (void)
 Main function that invokes the example in this file. More...
 

Function Documentation

int AxiPmonPolledExample ( u16  AxiPmonDeviceId,
u32 *  Metrics,
u32 *  ClkCntHigh,
u32 *  ClkCntLow 
)

This function runs a test on the AXI Performance Monitor device using the driver APIs.

This function does the following tasks:

  • Initiate the AXI Performance Monitor device driver instance
  • Run self-test on the device
  • Sets Metric Selector to select Slave Agent Number 1 and first set of Metrics
  • Enables Global Clock Counter and Metric Counters
  • Calls Application for which Metrics need to be computed
  • Disables Global Clock Counter and Metric Counters
  • Read Global Clock Counter and Metric Counter 0
Parameters
AxiPmonDeviceIdis the XPAR_<AXIPMON_instance>_DEVICE_ID value from xparameters.h.
Metricsis an user referece variable in which computed metrics will be filled
ClkCntHighis an user referece variable in which Higher 64 bits of Global Clock Counter are filled
ClkCntLowis an user referece variable in which Lower 64 bits of Global Clock Counter are filled
Returns
  • XST_SUCCESS if the example has completed successfully.
  • XST_FAILURE if the example has failed.
Note
None

References XAxiPmon_Config::BaseAddress, XAPM_INCREMENTER_0, XAPM_METRIC_COUNTER_0, XAPM_METRIC_SET_0, XAxiPmon_CfgInitialize(), XAxiPmon_DisableGlobalClkCounter, XAxiPmon_DisableMetricsCounter(), XAxiPmon_EnableGlobalClkCounter, XAxiPmon_EnableMetricsCounter(), XAxiPmon_GetGlobalClkCounter(), XAxiPmon_GetMetricCounter(), XAxiPmon_LookupConfig(), XAxiPmon_SelfTest(), XAxiPmon_SetIncrementerRange(), and XAxiPmon_SetMetrics().

Referenced by main().

int main ( void  )

Main function that invokes the example in this file.

Parameters
None.
Returns
  • XST_SUCCESS if the example has completed successfully.
  • XST_FAILURE if the example has failed.
Note
None.

References AxiPmonPolledExample().