op_td_set_dbl()

摘要

为指定的传输数据属性赋值一个双精度浮点值。

语法

op_td_set_dbl (pkptr, tda_index, value)
参数 类型 说明
pkptr Packet* 指向所关注数据包的指针
[该内核过程必须在收发器管道阶段的上下文内调用。在此上下文中,所关注的数据包是作为参数传入该阶段过程的数据包。]
tda_index int 所关注的传输数据属性的数字索引。该 TDA 必须是双精度浮点类型。
[该值是一个整数代码,指定要访问的传输数据属性。该参数的预定义值列于“Transmission Data Attribute“ 第 28 页。用户定义的传输信息可以赋值给大于预定义属性所占最大索引的任意属性索引。最大的预定义属性索引为 OPC_TDA_PT_MAX_INDEX(点对点管道)、OPC_TDA_BU_MAX_INDEX(总线管道)和 OPC_TDA_RA_MAX_INDEX(无线管道)。]
value double 要赋值给指定传输数据属性的值

返回类型

void

无返回值。

示例

摘自:示例模型(models/std/base);管道模型(dra_ber)。

	/* Determine current value of Signal-to-Noise-Ratio (SNR). */
	snr = op_td_get_dbl (pkptr, OPC_TDA_RA_SNR);

	/* Determine address of modulation table. */
	modulation_table = op_td_get_ptr (pkptr, OPC_TDA_RA_RX_MOD);

	/* Determine processing gain on channel. */
	proc_gain = op_td_get_dbl (pkptr, OPC_TDA_RA_PROC_GAIN);

	/* Calculate effective SNR incorporating processing gain. */
	eff_snr = snr + proc_gain;

	/* Derive expected BER from effective SNR. */
	ber = op_tbl_mod_ber (modulation_table, eff_snr);

	/* Place the BER in the packet's transmission data. */
	op_td_set_dbl (pkptr, OPC_TDA_RA_BER, ber);

详情

传输数据属性用于在仿真内核与各级收发器管道阶段之间传递链路建模数据。Td 包的内核过程提供了用于操作传输数据属性的基本操作(设置和获取)。管道阶段模型的基本格式是一个 C 文件,其中包含一个与文件同名的单一函数(例如,基础管道阶段模型 dra_power 存储在文件 dra_power.ps.c 中,并实现为 C 函数 dra_power())。在大多数阶段中,该函数的唯一参数是指向该阶段所操作数据包的指针。C 函数中的语句通常执行以下一系列活动:

  1. 从数据包的传输数据中提取属性(通过内核过程 op_td_get_dbl()、op_td_get_int()、op_td_get_int64() 和 op_td_get_ptr())。
  2. 执行表征链路模型相应阶段的计算(通常是数值处理与符号处理的组合)。
  3. 将新计算出的属性赋值给数据包的传输数据(通过内核过程 op_td_set_dbl()、op_td_set_int()、op_td_set_int64() 和 op_td_set_ptr())。

用途

提供了一种为传输数据的属性赋值的机制,该传输数据与通过链路模型收发器管道各阶段的每个数据包相关联。该内核过程用于在指定数据包的传输数据块中赋值单个双精度浮点属性值。

错误

  • 可恢复错误:<type> 类型的 TDA(<name>)无法使用 'op_td_set_dbl' 设置。
  • 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
  • 程序中止:内核过程不能从进程上下文调用。
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已销毁的数据包(<pk_id>)。
  • 程序中止:只读 TDA(<tda_name>)无法在(<pk_id>)中赋值。
  • 程序中止:Tda 索引(<tda_index>)超出数据包(<pk_id>)的范围。
  • 程序中止:Tda(<tda_name>)在数据包(<pk_id>)中未赋值。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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