管道阶段定义
管道阶段以 C 或 C++ 语言过程实现,具有预定义的参数与返回值接口。几乎所有管道阶段都接受一个数据包地址(Packet* 数据类型)作为其唯一参数。如前所述,传入数据包的 TDA 字段被用作把信息传回仿真内核以及后续管道阶段的载体。
每个管道阶段都有一个由用户提供的名称,通常选取能够代表其特征的名称。例如,负责计算点对点链路传输时延的管道阶段可以命名为“tx_delay”。所选的名称必须同时用于命名该管道阶段过程和包含它的源代码文件。管道阶段的目标代码文件只有带有 .ps.o 后缀时才能被 Modeler 识别;因此管道阶段源代码文件通常带有 .ps.c 后缀(C 文件)和 .ps.cpp 后缀(C++ 文件)。因此,信噪比管道阶段可以由一个在名为 tx_delay.ps.c 的文件中定义为 tx_delay() 的 C 过程来实现,该文件编译后生成目标代码文件 tx_delay.ps.o。用户也可以把自定义管道阶段创建为 C 或 C++ 文件,然后用 op_mko 工具编译为 .ps.o 文件。有关 op_mko 工具的更多信息,参见第 3 章“Program Descriptions”第 143 页。
仿真内核包含一个用于支持向传输数据属性赋值以及从中取值的程序包。该程序包称为 Transmission Data 程序包(Td),其中包含的过程概述如下。有关它们的能力与用法的详细说明,参见第 26 章“Transmission Data Package”第 1 页。
表 103:Transmission Data 程序包内核过程
| 内核过程 | 提供的能力 |
|---|---|
op_td_get_dbl() |
获取存储在数据包指定 TDA 中的双精度浮点值 |
op_td_get_int() |
获取存储在数据包指定 TDA 中的整数值 |
op_td_get_ptr() |
从指定的传输数据属性获取指针值 |
op_td_increment_dbl() |
向 TDA 的双精度值加上指定的量 |
op_td_increment_int() |
向 TDA 的整数值加上指定的量 |
op_td_is_set() |
判定数据包的指定 TDA 当前是否包含已指派的值 |
op_td_set_dbl() |
把双精度浮点值指派给数据包的指定 TDA,替换先前的值(如有) |
op_td_set_int() |
把整数值指派给数据包的指定 TDA,替换先前的值(如有) |
op_td_set_ptr() |
把指针值指派给指定的传输数据属性 |
顶层管道过程还可以利用大多数内核过程(KP)、其他文件中用户定义或第三方的过程,以及 C 语言的通用能力来实现它们所需的功能。通常,管道阶段所做的数学计算依赖于 C/C++ 数学库的可用性,因此在其源代码文件中包含定义文件 math.h。下面是一个简单管道阶段过程的 C 源代码示例:
图 224:C 管道阶段过程示例
/* transmission_delay.ps.c */
#include <opnet.h>
#include <math.h>
void
transmission_delay (Packet * pk)
{
/* Obtain the transmission data rate (supplied by the Kernel */
/* in the packet’s TDAs). */
tx_data_rate = op_td_get_dbl (pk, OPC_TDA_RA_TX_DRATE);
/* Obtain the packet’s length (in bits). */
pk_length = op_pk_total_size_get (pk);
/* Compute the transmission delay. */
tx_delay = pk_length / tx_data_rate;
/* Place result in packet to return to Kernel. */
op_td_set_dbl (pk, OPC_TDA_RA_TX_DELAY, tx_delay);
}
对于 C++ 管道阶段文件,顶层管道过程必须使用 C 链接约定进行链接,以便仿真内核能够正确访问它。这通过在过程的原型外包裹一个 ‘extern “C”’ 链接表达式来表示,例如:
图 225:C++ 管道阶段过程示例
/* transmission_delay.ps.cpp */
#include <opnet.h>
#include <math.h>
extern “C”{
void closure_template (Packet *);
}
void
closure_template (Packet * pk)
{
/* pipeline stage code */
}
默认管道阶段模型
Modeler 为每种类型的链路提供默认的管道过程。在新建收发器或链路对象时,这些管道阶段作为默认指派出现。这些阶段的名称列于下文,并附上相应的发送机或接收机模块属性。每个默认阶段的行为与实现的完整说明见第 4 章“Pipeline Stages/Point-to-Point Links”第 21 页和第 3 章“Pipeline Stages/Bus Link”第 6 页。这些默认阶段也可以作为希望创建应用专用管道阶段的开发者的良好起点。
表 104:点对点收发器管道默认阶段
| 管道阶段 | 属性名称 | 默认阶段名称 |
|---|---|---|
| 传输时延 | txdel model | dpt_txdel |
| 传播时延 | propdel model | dpt_propdel |
| 误码分配 | error model | dpt_error |
| 差错纠正 | ecc model | dpt_ecc |
表 105:总线收发器管道默认阶段
| 管道阶段 | 属性名称 | 默认阶段名称 |
|---|---|---|
| 传输时延 | txdel model | dbu_txdel |
| 链路闭合 | closure model | dbu_closure |
| 传播时延 | propdel model | dbu_propdel |
| 冲突 | coll model | dbu_coll |
| 误码分配 | error model | dbu_error |
| 差错纠正 | ecc model | dbu_ecc |
“NONE” 管道阶段
要仿真包含大量节点或大量数据包传输的网络模型,Modeler 必须进行大量的管道阶段计算。这可能导致仿真运行很长时间。如果某些管道阶段对你的仿真目标并不重要,你可以跳过这些阶段。要跳过某个管道阶段,只需把链路对象相应的管道阶段属性设为“NONE”。在仿真期间,仿真内核会跳过每个被设为“NONE”的阶段,并把相应的 TDA 设为某个默认值,以代替计算结果。下表列出了所使用的默认值。
表 106:点对点收发器管道默认值
| 管道阶段 | TDA | 默认值 |
|---|---|---|
| 传输时延 | OPC_TDA_PT_TX_DELAY |
0 秒 |
| 传播时延 | OPC_TDA_PT_PROP_DELAY |
0 秒 |
| 误码分配 | OPC_TDA_PT_NUM_ERRORS |
0 |
| 差错纠正 | OPC_TDA_PT_PK_ACCEPT |
OPC_TRUE |
表 107:总线收发器管道默认值
| 管道阶段 | TDA | 默认值 |
|---|---|---|
| 传输时延 | OPC_TDA_BU_TX_DELAY |
0 秒 |
| 链路闭合 | OPC_TDA_BU_CLOSURE |
OPC_TRUE |
| 传播时延 | OPC_TDA_BU_PROP_DELAY |
0 秒 |
| 冲突 | OPC_TDA_BU_NUM_COLLS |
0 |
| 误码分配 | OPC_TDA_BU_NUM_ERRORS |
0 |
| 差错纠正 | OPC_TDA_BU_PK_ACCEPT |
OPC_TRUE |
你可以通过设置相应仿真偏好(simulation preference)的值来改变 NONE 管道阶段所指派的默认值,如下表所列。
表 108:点对点 TDA 默认值的仿真偏好
| 管道阶段 | TDA | 仿真偏好 |
|---|---|---|
| 传输时延 | OPC_TDA_PT_TX_DELAY |
psnone_tda.pt.txdel.tx_delay |
| 传播时延 | OPC_TDA_PT_PROP_DELAY |
psnone_tda.pt.propdel.prop_delay |
| 误码分配 | OPC_TDA_PT_NUM_ERRORS |
psnone_tda.pt.error.num_errors |
| 差错纠正 | OPC_TDA_PT_PK_ACCEPT |
psnone_tda.pt.ecc.pk_accept |
表 109:总线 TDA 默认值的仿真偏好
| 管道阶段 | TDA | 仿真偏好 |
|---|---|---|
| 传输时延 | OPC_TDA_BU_TX_DELAY |
psnone_tda.bu.txdel.tx_delay |
| 链路闭合 | OPC_TDA_BU_CLOSURE |
psnone_tda.bu.closure.closure |
| 传播时延 | OPC_TDA_BU_PROP_DELAY |
psnone_tda.bu.propdel.prop_delay |
| 冲突 | OPC_TDA_BU_NUM_COLLS |
psnone_tda.bu.coll.num_colls |
| 误码分配 | OPC_TDA_BU_NUM_ERRORS |
psnone_tda.bu.error.num_errors |
| 差错纠正 | OPC_TDA_BU_PK_ACCEPT |
psnone_tda.bu.ecc.pk_accept |