节点对象属性说明

begsim intrpt

该属性指定是否在仿真开始时(即仿真时间 0.0 秒)为该对象的根进程生成仿真开始中断。某些进程需要这种中断先完成初始化,然后才开始主流的事件处理。初始化工作通常包括:为状态变量分配并设置初始值、创建必要的子进程,以及在网络层和节点层对周围环境进行发现。

进程模型可以通过检查内核过程 op_intrpt_type() 的返回值来判断当前投递的是否为这种中断。返回值为 OPC_INTRPT_BEGSIM 表示仿真开始中断。

Editing Simulation
Data Type toggle toggle
Access read/write/promote read
Default Value disabled
Units
Constraints

bit capacity

该属性指定传输队列或子队列所能容纳的最大比特数。队列或子队列的大小(以比特计)是当前队列中所有数据包长度的总和。若向队列中插入数据包会使总比特数超过该属性指定的上限,插入操作将返回失败状态,表明队列已满。

Editing Simulation
Data Type double double
Access read/write/promote read/write
Default Value infinity
Units bits
Constraints bit capacity >= 0

channel

该属性指定接收机所支持的入向信道或发射机所支持的出向信道。它由任意数量的相应类型的信道对象组成:

Editing Simulation
Data Type compound compound
Access read/write/promote read
Default Value
Units
Constraints

color

该属性是对象在节点编辑器工作区中绘制时显示的颜色。可以从可用颜色的菜单或调色板中选择该属性的值。该属性的取值对仿真行为没有任何影响。

Editing Simulation
Data Type typed file not applicable
Access read/write not applicable
Default Value #FF8000 (logical association)
blue (packet stream)
red (statistic wire)
Units
Constraints

data rate

该属性指定信道可以接收信息的速率。通常,对应的发射机和接收机信道上该属性具有相同的取值。此外,链路对象(“Simplex Point-to-Point Link Object”、“Duplex Point-to-Point Link Object” 或 “Bus Link Object”)也有一个 data rate 属性,其取值必须与信道 [0] 的 data rate 相匹配,才能保证正确运行。特殊值 “unspecified” 可以赋给发射机或接收机上的 data rate 属性,使其自动获取链路及对应信道的数据速率。

有关为使链路保持一致而使数据速率相互匹配的更多信息,参见第 7 章“Network Domain”第 292 页。

Editing Simulation
Data Type double double
Access read/write/promote read/write
Default Value “unspecified”
Units bits/second
Constraints data rate > 0.0

delay

该属性是从数据包通过数据包流被发送的时刻,到数据包到达目的模块的时刻之间的仿真时间间隔。如果使用了内核过程 op_pk_send_delayed() 发送数据包,该时延还会叠加在其带来的时延之上。例如,在仿真时间 10.0 通过 op_pk_send() 发送一个数据包,且该数据包所经过的数据包流的 “delay” 为 5.0,则流中断在时刻 15.0 到达目的模块。如果改为通过 op_pk_send_delayed() 发送同一数据包,且其 “delay” 参数等于 2.0,则流中断在时刻 17.0 发生。

Editing Simulation
Data Type double double
Access read/write/promote read/write
Default Value 0.0
Units seconds
Constraints delay >= 0.0

dest stat

该属性指定统计量连线所连接到的输入统计量的名称。该取值总是具有 “instat (n)” 的形式,其中 n 为输入统计量索引。在使用 op_stat_local_read() 等内核过程时,该输入统计量索引用于标识该统计量。该输入统计量的取值随源模块处相应输出统计量的变化而变化。

Editing Simulation
Data Type enumerated integer
Access read/write read
Default Value lowest available instat
Units
Constraints

dest stream

该属性是数据包流对象所连接的目的模块输入流的索引。例如,若该属性取值 2,则目的模块中的进程必须向内核过程 op_pk_get() 传入 2 作为参数(即流索引),才能接收通过该流接收到的数据包。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value lowest available stream
Units
Constraints

ecc threshold

该属性是数据包中被允许的最高比特错误比例,只有不超过该比例的数据包才会被接收机接受并转发到输出流。例如,“ecc threshold” 值为 0.20 的接收机将接受错误比特不超过其总比特数 20% 的数据包。该属性为接收机模块的纠错能力提供了一种粗略的模型。该属性的取值通常由总线链路收发管道中的纠错阶段(ecc model)使用。

Editing Simulation
Data Type double double
Access read/write/promote read/write
Default Value 0.0
Units errors/bit
Constraints 0.0 <= ecc threshold <= 1.0

endsim intrpt

该属性指定是否在仿真结束时为该对象的根进程生成仿真结束中断。某些进程需要这种中断在仿真结束时执行特殊功能。这些功能通常涉及报告仿真过程中收集的信息,一般是标量统计量,或采用专用格式的报告。

进程模型可以通过检查内核过程 op_intrpt_type() 的返回值来判断当前投递的是否为这种中断。返回值为 OPC_INTRPT_ENDSIM 表示仿真结束中断。

Editing Simulation
Data Type toggle toggle
Access read/write/promote read
Default Value disabled
Units
Constraints

esd model

该属性是在联合仿真期间用于与另一个仿真器对接的外部系统定义(ESD)的名称。可以在外部系统编辑器中开发外部系统定义,以定制仿真之间的数据传输。有关外部系统建模的更多信息,参见第 8 章“External System Domain”第 325 页。

所引用的模型必须是以 .esd.m 后缀结尾的文件。

Editing Simulation
Data Type typed file string
Access read/write read
Default Value None
Units
Constraints

failure intrpts

该属性指定当网络模型中的节点或链路发生故障时,是否为该对象的根进程生成故障中断。(故障由节点或链路的 “condition” 属性从 “enabled” 变为 “disabled” 来标志。)该属性的可能取值如下:

  • disabled – 不为该模块调度任何故障中断。
  • local only – 仅当包含该处理器对象的节点发生故障时,才为该模块调度故障中断。
  • network wide – 当网络中任何节点或链路发生故障时,为该模块调度故障中断。

与该属性三个可能取值对应的符号常量为 OPC_INTRPT_DISABLED、OPC_INTRPT_LOCAL_ONLY 和 OPC_INTRPT_NETWORK_WIDE。

Editing Simulation
Data Type enumerated integer
Access read/write/promote read/write
Default Value disabled
Units
Constraints

falling edge trigger

启用时,该属性指定:若目的模块输入统计量的取值被更新,且新值小于先前值,则在目的模块生成统计量中断。与所有统计量连线触发器一样,该属性的取值是在统计量更新到达目的模块时进行检查的,而不是在源模块处统计量被更新时。

目的模块中的进程可以通过检查内核过程 op_intrpt_type() 的返回值来判断其被调用的原因是否为这种中断。返回值为 OPC_INTRPT_STAT 表示统计量中断。

Editing Simulation
Data Type toggle toggle
Access read/write/promote read/write
Default Value enabled
Units
Constraints

high threshold trigger

启用时,该属性指定:若目的模块输入统计量的取值被更新,且新值大于或等于指定的阈值,则在目的模块生成统计量中断。与所有统计量连线触发器一样,该属性的取值是在统计量更新到达目的模块时进行检查的,而不是在源模块处统计量被更新时。

目的模块中的进程可以通过检查内核过程 op_intrpt_type() 的返回值来判断其被调用的原因是否为这种中断。返回值为 OPC_INTRPT_STAT 表示统计量中断。

Editing Simulation
Data Type toggle-double toggle-double
Access read/write/promote read/write
Default Value disabled
Units
Constraints

icon name

该属性指定在节点模型图中用于表示该对象的图标名称。可以使用图标编辑器创建自定义图标。该属性的取值对仿真行为没有影响。

Editing Simulation
Data Type icon not applicable
Access read/write not applicable
Default Value bu_rx (bus receivers)
bu_tx (bus transmitters)
processor (processors)
pt_rx (point-to-point receivers)
pt_tx (point-to-point transmitters)
queue (queues)
Units
Constraints

intrpt interval

该属性指定为处理器或队列的根进程调度定期中断的频率。如果该属性被禁用,则不会发生定期中断。如果该属性被启用(即具有有效的 double 值),则属性的取值为定期中断之间的仿真时间秒数。

如果在仿真过程中修改了该属性,该对象下一个已调度的定期中断将被取消,并在当前仿真时间之后一个周期的时刻调度一个新的定期中断。

进程模型可以通过检查内核过程 op_intrpt_type() 的返回值来判断当前投递的是否为这种中断。返回值为 OPC_INTRPT_REGULAR 表示定期中断。

Editing Simulation
Data Type toggle-double toggle-double
Access read/write/promote read/write
Default Value disabled
Units seconds
Constraints intrpt interval > 0.0

intrpt method

该属性指定数据包通过数据包流,或统计量通过统计量连线向目的模块转发的方式。

数据包流:若该属性取值为 “scheduled”,通过该流发送数据包将为目的模块中相应的进程调度一个流中断。源进程继续执行。随后(若数据包流的 “delay” 属性设为 0.0,则在相同的仿真时刻),流中断被投递给目的进程。若该属性取值为 “forced”,则在调用 op_pk_send() 时立即处理流中断。源进程的执行被暂时挂起,并在目的进程阻塞之后恢复。当流的源是处理器或队列模块时,该属性不适用。

统计量连线:若该属性取值为 “scheduled”,通过连线发送统计量将为目的模块中相应的进程调度一个统计量中断。源进程继续执行。随后(若统计量连线的 “delay” 属性设为 0.0,则在相同的仿真时刻),统计量中断被投递给目的进程。若该属性取值为 “forced”,则在统计量取值发生变化时立即处理统计量中断。源进程的执行被暂时挂起,并在目的进程阻塞之后恢复。

在仿真过程中,可以使用 op_ima_obj_attr_set() 并利用以下常量来修改该属性:OPC_INTRPT_METHOD_FORCED、OPC_INTRPT_METHOD_SCHED,以及(用于数据包流的)OPC_INTRPT_METHOD_QUIET。

Editing Simulation
Data Type enumerated integer
Access read/write/promote read/write
Default Value scheduled
Units
Constraints scheduled, quiet, forced (packet streams)
scheduled, forced (statistic wires)

low threshold trigger

启用时,该属性指定:若目的模块输入统计量的取值被更新,且新值小于或等于指定的阈值,则在目的模块生成统计量中断。与所有统计量连线触发器一样,该属性的取值是在统计量更新到达目的模块时进行检查的,而不是在源模块处统计量被更新时。目的模块中的进程可以通过检查内核过程 op_intrpt_type() 的返回值来判断其被调用的原因是否为这种中断。返回值为 OPC_INTRPT_STAT 表示统计量中断。

Editing Simulation
Data Type toggle-double toggle-double
Access read/write/promote read/write
Default Value disabled
Units
Constraints

name

该属性是用户为对象指定的标识。赋给该属性的取值显示在节点图中对象图标的下方。它也可以用于在仿真过程中或节点模型报告中引用该对象。仿真内核本身并不使用该属性。有关更多信息,参见第 6 页的 op_id_from_name()。

Editing Simulation
Data Type string string
Access read/write read
Default Value br_n; n >= 0 (bus receivers)
bt_n; n >= 0 (bus transmitters)
assoc (logical associations)
strm (packet streams)
p_n; n >= 0 (processors)
pr_n; n >= 0 (point-to-point receivers)
pt_n; n >= 0 (point-to-point transmitters)
q_n; n >= 0 (queues)
stat_n; n >= 0 (statistic wires)
Units
Constraints unique in node model; no dots

packet formats

对于接收机信道,该属性指定信道可以接收并转发到其节点内其他模块的数据包类型。其他类型的数据包在被完全接收之后将被接收机拒绝。该属性的作用是防止接收到不合适的、无法由与接收机相连的模块正确处理的数据包。

对于发射机信道,该属性指定信道可以从其节点内的其他模块接受并成功发送的数据包类型。其他类型的数据包会被发射机信道入队,但在到达队列头部时被丢弃。该属性的作用是防止发送那些无法由接收节点正确处理的数据包。

为使信道能够工作,该属性所指定的列表必须与总线链路的 packet formats 属性所指定的列表至少有一个共同的数据包格式。

注意: 该属性以 “逗号分隔” 字符串的形式存储,将每个受支持的数据包格式对应的子串拼接起来。特殊子串 “unformatted” 允许信道支持无格式数据包。

网络模型在链路一致性判定中使用该属性,以验证节点与链路的兼容性。有关链路一致性的更多信息,参见第 7 章“Network Domain”第 292 页。

Editing Simulation
Data Type string string
Access read/write read
Default Value “all formatted, unformatted”
Units
Constraints

pk capacity

该属性指定传输队列或子队列所能容纳的最大数据包数。队列或子队列的大小(以数据包计)是当前队列中所有数据包的总数。若向队列中插入数据包会使数据包总数超过该属性指定的上限,插入操作将返回失败状态,表明队列已满。

Editing Simulation
Data Type double double
Access read/write/promote read/write
Default Value 1000.0 (transmitter channel)
infinity (subqueue)
Units packets
Constraints packet capacity >= 0

priority

该属性用于确定在同一仿真时刻调度的事件的执行顺序。在高优先级模块处调度的事件先于在较低优先级模块处调度的事件被处理。

事件优先级按层次结构评定:子网优先级比节点优先级更重要,节点优先级比模块优先级更重要。对于同一仿真时刻的一组事件,高优先级子网中的所有事件都在低优先级子网中的任何事件之前处理。模块优先级仅用于对子网优先级和节点优先级完全相同的模块处发生的事件进行排序。

并行仿真内核不使用该属性。

Editing Simulation
Data Type integer integer
Access read/write/promote read
Default Value 0
Units
Constraints -32767 <= priority <= 32767

process model

该属性是用于该模块根进程的进程模型的名称。可以在进程编辑器中开发进程模型,以表示任意软件或硬件功能。有关进程建模的更多信息,参见第 5 章“Process Domain”第 165 页。

处理器的默认进程模型(sink)只是简单地丢弃接收到的数据包。

队列的默认进程模型(pc_fifo)按照接收顺序将数据包添加到队列尾部入队;在需要时,按照先进先出的顺序从队列头部移除数据包出队。

Editing Simulation
Data Type typed file string
Access read/write read/write
Default Value sink (processors)
pc_fifo (queues)
Units
Constraints

recovery intrpts

该属性指定当网络模型中的节点或链路恢复时,是否为该对象的根进程调度恢复中断。(恢复由节点或链路的 “condition” 属性从 “disabled” 变为 “enabled” 来标志。)该属性的可能取值如下:

  • disabled – 不在该模块生成任何恢复中断。
  • local only – 仅当包含该处理器对象的节点恢复时,才在该模块生成恢复中断。
  • network wide – 当网络中任何节点或链路恢复时,在该模块生成恢复中断。

与该属性三个可能取值对应的符号常量为 OPC_INTRPT_DISABLED、OPC_INTRPT_LOCAL_ONLY 和 OPC_INTRPT_NETWORK_WIDE。

Editing Simulation
Data Type enumerated integer
Access read/write/promote read/write
Default Value disabled
Units
Constraints

repeated value trigger

启用时,该属性指定:若目的模块输入统计量的取值被更新,且新值等于旧值,则在目的模块生成统计量中断。与所有统计量连线触发器一样,该属性的取值是在统计量更新到达目的模块时进行检查的,而不是在源模块处统计量被更新时。

目的模块中的进程可以通过检查内核过程 op_intrpt_type() 的返回值来判断其被调用的原因是否为这种中断。返回值为 OPC_INTRPT_STAT 表示统计量中断。

Editing Simulation
Data Type toggle toggle
Access read/write/promote read/write
Default Value disabled
Units
Constraints

rising edge trigger

启用时,该属性指定:若目的模块输入统计量的取值被更新,且新值大于先前值,则在目的模块生成统计量中断。与所有统计量连线触发器一样,该属性的取值是在统计量更新到达目的模块时进行检查的,而不是在源模块处统计量被更新时。

目的模块中的进程可以通过检查内核过程 op_intrpt_type() 的返回值来判断其被调用的原因是否为这种中断。返回值为 OPC_INTRPT_STAT 表示统计量中断。

Editing Simulation
Data Type toggle toggle
Access read/write/promote read/write
Default Value enabled
Units
Constraints

src stat

该属性是作为统计量连线源的输出统计量的名称。预定义统计量和用户自定义统计量均受支持。对于由进程报告的用户自定义统计量,其取值通过内核过程 op_stat_write() 更新。

有关统计量可能的来源及其与统计量连线工作的关系,参见 Node Reference 中对各具体对象的描述。

注意: 不要将 bit error rate 统计量用作该属性的取值。

Editing Simulation
Data Type enumerated string
Access read/write read
Default Value based on module type
Units
Constraints based on module type

src stream

该属性是数据包流所连接的源模块输出流的索引。例如,若该属性取值 2,则源模块中的进程必须向内核过程 op_pk_send() 传入 2 作为第二个参数(即流索引参数),才能通过该流发送数据包。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value lowest available stream
Units
Constraints

submodule

该属性是其输出统计量作为统计量连线源的子模块的名称。该子模块必须位于统计量连线的源模块之内。可能的子模块包括子队列,以及与各类发射机和接收机相关联的各种信道对象。默认值(None)表示该统计量连线所连接的输出统计量属于源模块本身,而非其内部包含的某个子模块。并非所有类型的源模块都支持子模块。

Editing Simulation
Data Type enumerated integer
Access read/write read
Default Value “None”
Units
Constraints

subqueue

该属性指定队列所支持的子队列。该属性的取值是一个复合属性对象(CA 对象),其子对象即 Subqueue Object。有关复合属性的更多信息,参见第 4 章“Modeling Framework”第 80 页。

Editing Simulation
Data Type compound compound
Access read/write/promote read
Default Value
Units
Constraints

super priority

该属性用于确定在同一仿真时刻调度的事件的执行顺序。对于同一仿真时刻的一组事件,启用了该属性的模块处的所有事件,都在未启用该属性的模块处的任何事件之前处理,无论其层次化定义的优先级如何。如果多个模块都启用了该属性,则这些模块处事件的顺序按照通常的层次化优先级方案确定。

并行仿真内核不使用该属性。

Editing Simulation
Data Type toggle toggle
Access read/write/promote read/write
Default Value disabled
Units
Constraints

zero crossing trigger

启用时,该属性指定:若目的模块输入统计量的取值被更新,且新值为下列情况之一,则在目的模块生成统计量中断:

  • 为正,且旧值为负
  • 为负,且旧值为正
  • 等于零

与所有统计量连线触发器一样,该属性的取值是在统计量更新到达目的模块时进行检查的,而不是在源模块处统计量被更新时。

目的模块中的进程可以通过检查内核过程 op_intrpt_type() 的返回值来判断其被调用的原因是否为这种中断。返回值为 OPC_INTRPT_STAT 表示统计量中断。

Editing Simulation
Data Type toggle toggle
Access read/write/promote read/write
Default Value disabled
Units
Constraints

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com