op_prg_odb_bkpt()
摘要
定义带标签的断点;当仿真在 ODB 控制下运行且该带标签断点已启用时,断点将会触发。
语法
op_prg_odb_bkpt (label)
| 参数 | 类型 | 说明 |
|---|---|---|
label |
const char* |
标识断点的标签字符串。该字符串会与已启用的带标签断点的标签进行比较。此类断点通过 ODB 命令 lstop 或 mlstop 启用。标签可包含任意 ASCII 字符,包括空白字符。 |
返回类型
void
无返回值。
示例
/* perform different actions depending on the type of interrupt */
switch (op_intrpt_type ())
{
case OPC_INTRPT_REMOTE:
gate_status = op_intrpt_code ();
op_prg_odb_bkpt ("gate.remote");
break;
case OPC_INTRPT_STRM:
if (gate_status == GATE_OPEN)
op_pk_send (op_pk_get (0), 0);
else{
op_prg_odb_bkpt ("gate.closed");
op_pk_destroy (op_pk_get (0));
}
break;
case OPC_INTRPT_STAT:
remote_status = (int) op_stat_local_read (REMOTE_STAT);
break;
}
详情
断点是仿真执行过程中的暂停点,使用户能够评估仿真状态,并确定在下一个断点出现之前事件处理的范围。ODB 仿真调试器支持仿真断点(有关 ODB 的使用方法,参见“Simulation Debugger (ODB)“ 第 39 页)。在 ODB 中可以定义和/或启用多种类型的断点,包括面向时间的断点、面向事件的断点和带标签断点。带标签断点在进程模型内部使用本内核过程定义,并可通过 ODB 中的 lstop 和 mlstop 命令启用。
本内核过程可检测通过 lstop 或 mlstop 激活的带标签跟踪,前提是传递给本内核过程的标签字符串与传递给 ODB 命令的标签字符串完全一致。仅限于特定模块的带标签跟踪,只有当本内核过程由在该模块中执行的进程调用时才会被检测到。
本内核过程在优化仿真内核下不起任何作用。
用途
为进程提供了一种在特定条件下触发断点的定义机制。例如,本内核过程可以嵌入 if 语句、switch 语句或特殊的进程转移或状态中;每当相关代码被执行、本内核过程被调用时,就产生一次断点“机会”。如果断点已通过 ODB 命令 lstop 或 mlstop 启用,这些断点“机会”就会真正实现。能够有选择地启用由内核过程定义的断点,使得在相关模型部分的初始调试阶段完成后,仍可将这些断点保留在进程模型中。为断点加标签允许多组进程定义的断点在同一仿真中共存,在未被专门启用之前保持休眠状态。
错误
- 程序中止:段违例。(由于无效的标签指针或格式错误的标签字符串)
参考
- 使用内核过程 op_prg_odb_print_major() 和 op_prg_odb_print_minor() 在条件性带标签断点(即只在特殊情况下触发的断点)之前打印调试消息
- 使用 ODB 命令
lstop全局启用由本内核过程定义的带标签断点 - 使用 ODB 命令
mlstop按模块启用由本内核过程定义的带标签断点