Sim Api User Guide(4)

2.9.7 ConfigureBusPenalty

Prototype

HEXAPI_Status ConfigureBusPenalty(HEX_8u_t BusPenaltyInterval,
                 HEXAPI_Interval units)

Parameters

Return

Description
Configure the default latency for bus access for the entire memory range . This delay can be achieved by connecting a bus for the appropriate address range cosim And be covered . The delay is determined by the clock frequency of the kernel , simulation “ real time ”, Just like the kernel runs at a specified frequency . And the actual time （ Wall clock time ） Not directly related .
The granularity of the time increment is determined by the current core frequency setting . The smallest particle size corresponds to the time required for a single processor cycle . All time values are scaled according to the current processor clock frequency , If the core frequency changes , Then zoom again .
hexagon-sim Medium -buspenalty cycles Options are similar to this function , It's just that the function accepts a time value instead of the number of cycles .

2.9.8 ConfigureCosim

Prototype

HEXAPI_Status ConfigureCosim(const char *pCosimConfigFile,
                     HEXAPI_OpenMode mode = HEX_MODE_READ)

Parameters

Return

Description
The external cosim Insert the simulator .cosim（s） You can register to get memory read / Write 、 Bus access 、PC Execute callbacks for events and time-based Events . You can specify multiple cosim, And list... In different lines of the configuration file .
cosim Examples of configuration file contents .

/local/Hexagon_tools_install/qc/lib/iss/timer.so 32000 0xAB000000 2 /local/Hexagon_tools_install/qc/lib/iss/timer.so 19200000 0xAB004000 3 /local/MM_cosim/ebi_bus.so 0x100000

hexagon-sim Medium –cosim_file The file name option is similar to this function .

2.9.9 ConfigureOSAwareness

Prototype

HEXAPI_Status ConfigureOSAwareness(const char *pOsamConfigFile,
                     HEXAPI_OpenMode mode = HEX_MODE_READ)

Parameters

Return

Description
Insert... Into an operating system module . The following operating system callbacks can be registered .

1. The debugger gets the status of the software thread 、 Mutually exclusive information, etc .
2. 2.PC Execution event .
3. Virtual to physical conversion , Used for service Angel call （ Semi trusteeship ）.
   hexagon-sim Medium -rtos The file name option is similar to this function .

2.9.10 ConfigureQProf

Prototype

HEXAPI_Status ConfigureQProf (const char *pQProfConfigFile, HEXAPI_OpenMode mode = HEX_MODE_READ,
const char *qprofPath = NULL, HEX_4u_t port = 0)

Parameters

Return

Description
Configure the data dump of the graphics analyzer . See Hexagon Simulator User guide . The profiling file is created in the specified directory . If the offer is NULL Catalog , Then create a file in the current working directory .
The configuration file uses mode as the opening mode . Generated qprof The file is opened for writing , Replace existing qprof The content of the document （ If any ）, No warning .
hexagon-sim Medium –qprof File name and –qprof:pipe port Options are similar to this function .

2.9.11 ConfigureRProf

Prototype

HEXAPI_Status ConfigureRProf (const char *pRProfConfigFile,
                      HEXAPI_OpenMode mode = HEX_MODE_READ)

Parameters

Return

Description
Configure the parameters of the area analyzer . See Hexagon Simulator User guide . Regional profiling data is attached to the statistical file . See also 2.9.22 section .
hexagon-sim Medium –region_prof The file name option is similar to this function .

2.9.12 ConfigureGProf

Prototype

HEXAPI_Status ConfigureGProf(const char *gprofPath = NULL)

Parameters

Return

Description
by GNU Analyzer configuration data dump . See 《Hexagon Simulator User guide 》. The profiling file will be created in the specified directory . If the offer is NULL Catalog , The file will be created in the current working directory . The simulator overwrites the existing file without warning .
hexagon-sim Medium –profile Options are similar to this function .
Be careful If you do not make this configuration call ,gprof Profiling will be disabled . Whether or not gprofPath Parameters , Make this call to enable gprof analyse . Once this call is made , There is no way to disable... In this session gprof Dissected .