Sim Api User Guide(6)

2.9.20 ConfigureMemFill

Prototype

HEXAPI_Status ConfigureMemFill(HEX_1u_t value)

Parameters

Description
Specify a value for all uninitialized memory . The emulator will fill all memory with the specified value before the simulation starts .
hexagon-sim Medium -memfill value Options are similar to this function .

2.9.21 ConfigureMemFillRandom

Prototype

HEXAPI_Status ConfigureMemFillRandom(HEX_4u_t seed)

Parameters

Return

Description
Specify a value as the seed of a random number . The simulator uses rand() Host function to initialize all " uninitialized " The value of memory . The behavior of this function depends on the host implementation of the random number generator .
hexagon-sim Medium -memfill_rand The seed option is similar to this function .

2.9.22 ConfigureStatisticsFile

Prototype

 HEXAPI_Status ConfigureStatisticsFile(const char *pStatsFile,
 HEXAPI_OpenMode mode = HEX_MODE_WRITE)

Parameters

Return

Description
Specifies the text file to write execution statistics .
Be careful Only when EmitStatistics() When the function is called , Statistics will be written to the specified file .
EmitStatistics() When the function is called , Statistics will be written to the specified file .

2.9.23 ConfigurePmuStatisticsFile

Prototype

HEXAPI_Status ConfigurePmuStatisticsFile(const char *pmuStatsFile, HEXAPI_OpenMode mode = HEX_MODE_WRITE)

Parameters

Return

Description
Specify the text file , take Hexagon PMU The execution statistics of are written into it .
Be careful Only when calling EmitStatistics() Function time , Statistics will be written to the specified file .

2.9.24 ConfigurePCRangeFilter

Prototype

HEXAPI_Status ConfigurePCRangeFilter(HEX_VA_t PCStart,
                  HEX_VA_t PCEnd)

Parameters

Parameters

Return

Description
Enable the start and stop of statistics collection and tracking based on instruction execution . This applies to all forms of statistical data collection ：Gprof、Qprof、 Regional analysis and normal execution statistics . This also applies to trace generation .
When PCStart When the instruction of the address is submitted , The statistical collection began . It means PCStart The statistics of the packet are not in the tracking data . When PCEnd When the instruction of the address is submitted , Statistics collection terminated . It means PCEnd Packet statistics are in the tracking data . Even if PCStart The command at is executed again , Statistical collection will not be restarted .
This routine only enables the collection of statistical data . Use EmitStatistics() or EmitPerfStatistics() To print Statistics .
This function is associated with ConfigureTimeRangeFilter() Working together . When TimeStart or PCStart When the conditions are met , Start collecting statistics , When TimeEnd or PCEnd When the conditions are met , Just end the collection .

2.9.25 ConfigureTimeRangeFilter

Prototype

 HEXAPI_Status ConfigureTimeRangeFilter(HEX_8u_t TimeStart,
                  HEXAPI_Interval StartUnits, HEX_8u_t TimeEnd,
                  HEXAPI_Interval EndUnits)

Parameters

Return

Description
Enable the start and stop of statistics collection and tracking based on elapsed simulation time . This applies to all forms of statistical data collection ：Gprof、Qprof、region profiling And normal execution statistics . This also applies to trace generation .
When TimeStart After time , Start collecting statistics . When TimeEnd After time , The collection of statistics is over . Statistics collection will never be restarted .
This routine only enables the collection of statistical data . Use EmitStatistics() or EmitPerfStatistics() To print Statistics .
This function is associated with ConfigurePCRangeFilter() Working together . When TimeStart or PCStart When the conditions are met , Start collecting statistics , When TimeEnd or PCEnd When the conditions are met , Just end the collection .

2.9.26 ConfigureNULLPointerBehavior

Prototype

HEXAPI_Status ConfigureNULLPointerBehavior(
                  HEXAPI_Nullptr behavior)

Parameters

Return

Description
Indicates how the simulator should handle NULL Pointer dereference .

2.9.27 ConfigureHeapInfo

Prototype

HEXAPI_Status ConfigureHeapInfo(HEX_PA_t heapBase,
                  HEX_4u_t heapSize)

Parameters

Return

Description
Indicates the location of the simulator heap . These values are assigned to the running program as part of the startup program of the independent program . This call is for RTOS The application is undefined .

2.9.28 ConfigureStackInfo

Prototype

HEXAPI_Status ConfigureStackInfo(HEX_PA_t stackBase,
                  HEX_4u_t stackSize)

Parameters

Return

Description
Indicates the location of the simulator stack . These values are given to the running program as part of the stand-alone startup program . If no stack cardinality and size are specified , The location of the stack will be obtained from the executable . This call is for RTOS Application is undefined .

2.9.29 EndOfConfiguration

Prototype

HEXAPI_Status EndOfConfiguration()

Return

Description
This function should be the last of the simulator configuration functions . Calling this function causes the simulator to evaluate configuration options and load cosims、OS Cognitive module 、 Symbol files, etc . If a binary image is provided , It will be loaded into Hexagon Simulator memory .
Be careful Any configuration call after this function will return an error （HEX_STAT_CANNOT_CONFIG）.