op_intrpt_enable()
摘要
重新允许指定类别的中断递送给调用进程,持续无限期。
语法
op_intrpt_enable (type, code)
| 参数 | 类型 | 说明 |
|---|---|---|
type |
int |
待启用中断的类型。 [这是一个指定中断类型的整数代码,因而部分定义了待启用的中断类别(参见表 59 “Interrupt Type Symbolic Constants“ 第 15 页);该代码的可能取值也列于详情一节。] |
code |
int |
待启用中断的数字代码 [这是一个特定的整数数字代码,部分定义了待启用的中断类别。该值会与先前通过内核过程 op_intrpt_disable() 定义的禁用屏蔽所关联的代码进行比较。] |
返回类型
void
无返回值。
示例
节选自:示例模型(models/std/eth_net);进程模型(eth_mac);函数块。
eth_mac_phys_layer_ignore ()
{
/* enable reception of physical layer events */
op_intrpt_disable (OPC_INTRPT_STAT, DEFERENCE_INSTAT, 0);
op_intrpt_disable (OPC_INTRPT_STAT, COLLISION_DETECT_INSTAT, 0);
op_intrpt_disable (OPC_INTRPT_STAT, TRANSMITTING_INSTAT, 0);
}
eth_mac_phys_layer_listen ()
{
/* enable reception of physical layer events */
op_intrpt_enable (OPC_INTRPT_STAT, DEFERENCE_INSTAT);
op_intrpt_enable (OPC_INTRPT_STAT, COLLISION_DETECT_INSTAT);
op_intrpt_enable (OPC_INTRPT_STAT, TRANSMITTING_INSTAT);
}
详情
待启用的中断类别由中断类型(例如流中断、自中断等)和与中断相关联的数字代码共同指定。type 参数的取值可以取自以下符号常量之一:
- OPC_INTRPT_ACCESS——访问中断
- OPC_INTRPT_BEGSIM——开始仿真中断
- OPC_INTRPT_ENDSIM——结束仿真中断
- OPC_INTRPT_ESYS_INTERFACE——外部系统中断
- OPC_INTRPT_ESYS_INTERFACE_EXT——外部系统中断(来自联合仿真器)
- OPC_INTRPT_FAIL——节点/链路故障中断
- OPC_INTRPT_MCAST——组播中断
- OPC_INTRPT_PROCEDURE——过程中断
- OPC_INTRPT_PROCESS——进程中断
- OPC_INTRPT_RECOVER——节点/链路恢复中断
- OPC_INTRPT_REGULAR——常规中断
- OPC_INTRPT_REMOTE——远程中断)
- OPC_INTRPT_REMOTE_END_RCV——数据包到达接收端的结束
- OPC_INTRPT_REMOTE_START_RCV——数据包到达接收端的开始
- OPC_INTRPT_REMOTE_START_XMT——发送端开始发送数据包时 “split_start_radio_transmission“ 偏好为 TRUE
- OPC_INTRPT_SELF——自中断
- OPC_INTRPT_SELF_END_XMT——发送端结束发送数据包
- OPC_INTRPT_STAT——统计中断
- OPC_INTRPT_STRM——流中断
code 参数与以下中断类型相关:
- 自
- 远程
- 过程
- 流(code 表示受影响的输入流索引)
- 统计线(code 表示受影响的输入统计量索引)
- 访问(code 表示受影响的输出流索引)
- 组播
- 进程
默认情况下,所有类别的中断均处于启用状态;它们只能通过调用相关的内核过程 op_intrpt_disable() 来禁用。
用途
提供了一种重新启用先前通过内核过程 op_intrpt_disable() 禁用的某一类中断的机制。中断类别可以被连续地禁用和启用任意多次。通常,中断是在调用进程忙于执行某项任务的仿真时间段结束时被重新启用的;被启用的中断在时间段开始时曾被禁用,以避免任务被抢占。注意,禁用某一类中断并不会使该类中断从事件列表中移除;它只是屏蔽其对调用进程的递送。因此,如果被禁用的中断在其计划递送时间之前被重新启用,它们实际上将被递送给该模块。
错误
- 程序中止:内核过程需要进程上下文。
- 可恢复错误:中断类型(
<type>)无法识别。
参考
- 使用内核过程 op_intrpt_disable() 执行相反操作并禁用一类中断
- 使用内核过程 op_intrpt_enable_all() 启用所有类别的中断
- 使用内核过程 op_ev_cancel() 取消单个自中断
- 使用内核过程 op_intrpt_clear_self() 取消所有挂起的自中断