Sim Api User Guide(4)

2.9.7 ConfigureBusPenalty

Prototype

HEXAPI_Status ConfigureBusPenalty(HEX_8u_t BusPenaltyInterval,
                 HEXAPI_Interval units)

Parameters

Return

Description
配置整个内存范围的总线访问的默认延迟。这个延迟可以通过为适当的地址范围连接一个总线cosim而被覆盖。延迟是由内核的时钟频率决定的，模拟 “实时”，就像内核在指定的频率下运行一样。与实际时间（即壁钟时间）没有直接关系。
时间增量的颗粒度由当前的核心频率设置来决定。最细的颗粒度对应于单个处理器周期所需的时间。所有的时间值都根据当前的处理器时钟频率进行缩放，如果核心频率发生变化，则重新进行缩放。
hexagon-sim中的-buspenalty cycles选项与该函数类似，只是该函数接受一个时间值而不是周期数。

2.9.8 ConfigureCosim

Prototype

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

Parameters

Return

Description
将外部cosim插入模拟器。cosim（s）可以注册以获得内存读/写、总线访问、PC执行事件和基于时间的事件的回调。可以指定多个cosim，并在配置文件的不同行中列出。
cosim配置文件内容的例子。

/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中的–cosim_file文件名选项类似于这个函数。

2.9.9 ConfigureOSAwareness

Prototype

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

Parameters

Return

Description
在模拟器中插入一个操作系统意识模块。操作系统感知模块可以为以下内容注册回调。

1. 调试器获取软件线程状态、互斥信息等。
2. 2.PC执行事件。
3. 虚拟到物理的转换，用于服务天使调用（半托管）。
   hexagon-sim中的-rtos文件名选项类似于这个功能。

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
配置图形分析器的数据转储。详见 Hexagon Simulator 用户指南。剖析文件在指定的目录中创建。如果提供的是NULL目录，则在当前工作目录中创建文件。
配置文件使用模式作为打开方式。生成的qprof文件被打开进行写入，替换现有的qprof文件的内容（如果有的话），没有警告。
hexagon-sim中的–qprof文件名和–qprof:pipe port选项与这个函数类似。

2.9.11 ConfigureRProf

Prototype

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

Parameters

Return

Description
配置区域分析器的参数。详见 Hexagon Simulator 用户指南。区域剖析数据被附加到统计文件中。参见第2.9.22节。
hexagon-sim中的–region_prof文件名选项与此功能类似。

2.9.12 ConfigureGProf

Prototype

HEXAPI_Status ConfigureGProf(const char *gprofPath = NULL)

Parameters

Return

Description
为GNU分析器配置数据转储。详见《Hexagon Simulator用户指南》。剖析文件将在指定的目录中创建。如果提供的是NULL目录，文件将在当前工作目录中创建。模拟器会覆盖现有的文件而不发出警告。
hexagon-sim中的–profile选项与此功能类似。
注意 如果不进行这个配置调用，gprof剖析将被禁用。无论是否有gprofPath参数，进行这个调用都可以启用gprof剖析。一旦进行了这个调用，就没有办法在这个会话中禁用gprof剖析了。