op_stat_local_read()
摘要
从外围处理器或队列的输入统计量读取当前值。
语法
op_stat_local_read (instat_index)
| 参数 | 类型 | 说明 |
|---|---|---|
instat_index |
int |
目标输入统计量的数字索引 [输入统计量索引限定在 0 到 99 的范围内。] |
返回类型
double
指定输入统计量的当前值。若发生可恢复错误,返回常量 OPC_DBL_INVALID。
示例
摘自:示例模型(models/std/eth_net);进程模型(eth_mac);头文件块。
/*** mnemonic macros for transitions and executives ***/
#define DEFERENCE_ON (op_stat_local_read (DEFERENCE_INSTAT) == 1.0)
#define DEFERENCE_OFF (op_stat_local_read (DEFERENCE_INSTAT) == 0.0)
#define DEFERENCE_LOW (op_intrpt_type () == OPC_INTRPT_STAT && \
op_intrpt_stat () == DEFERENCE_INSTAT && \
DEFERENCE_OFF)
#define COLL_DET_HIGH (op_intrpt_type () == OPC_INTRPT_STAT && \
op_intrpt_stat () == TRANSMITTING_INSTAT && \
op_stat_local_read (TRANSMITTING_INSTAT) == 0.0)
详情
该内核过程可以随时读取输入统计量;它返回写入相连统计量连线的最后一个值。如果指定输入统计量没有连接统计量连线,或输入统计量索引超出范围,则发生错误并返回常量 OPC_DBL_INVALID。
用途
提供一种获取输入统计量值的机制;输入统计量的值即另一个模块输出统计量的值,通过相连的统计量连线传递。该内核过程可用于两种模式:
- 外围模块因统计量连线中断而被中断,该中断表示连线上发生了相关变化,进程读取输入统计量以确定更新后的值。
- 外围模块自行决定需要对某条统计量连线的值进行采样,以便在计算中使用该值。
错误
- 程序中止(Program Abort):该内核过程需要进程上下文。
- 可恢复错误(Recoverable Error):局部统计量索引(
<stat_index>)超出范围。 - 可恢复错误(Recoverable Error):模块没有相连的统计量输入。
- 可恢复错误(Recoverable Error):输入统计量索引(
<stat_index>)未被占用。
参考
- 使用内核过程 op_stat_write() 向输出统计量写入值,并以当前仿真时间标记
- 使用内核过程 op_stat_write_t() 向输出统计量写入值,并以指定仿真时间标记
- 使用内核过程 op_stat_scalar_write() 向标量统计量写入值