A.12.2 CADIProfiling::CADIProfileSetup()

This method informs the target of the memory regions that are to be profiled.

Call this function once before any number of calls to:

  • CADIProfileControl(CADI_PROF_CNTL_Start).
  • CADIProfileControl(CADI_PROF_CNTL_Stop).
virtual CADIReturn_t CADIProfiling::CADIProfileSetup(CADIProfileType_t type, 
               uint32_t regionCount, CADIProfileRegion_t *region) = 0;
type

is the type of profiling, execution addresses or data access, to which these regions apply. It is one of these values:

  • CADI_PROF_TYPE_Execution.
  • CADI_PROF_TYPE_Memory is used with CADIProfileGetMemory().
  • CADI_PROF_TYPE_Trace is used with CADIProfileGetTrace().
regionCount

is the number of regions.

region
contains the description of the memory areas being added. The caller allocates the required memory for this array.

The return value must be CADI_STATUS_IllegalArgument if any of these are true:

  • Any region spans unpopulated memory.
  • Any region spans illegal memory.
  • Any region overlaps another region.
  • The address space of a region is not consistent with the profiling type.
Non-ConfidentialPDF file icon PDF versionARM 100963_0200_00_en
Copyright © 2014–2017 ARM Limited or its affiliates. All rights reserved.