oms_wp_phy_pk_transmission_info_set()

摘要

为给定数据包设置无线传输属性。

注意: 该内核过程可用于单载波和多载波模式。

语法

oms_wp_phy_pk_transmission_info_set (pkptr, attr_id_0, attr_value_0, attr_id_1, attr_value_1, . end_of_arguments_id);

参数 类型 说明
pkptr Packet* 需要关联无线信息的数据包
attr_id_n int 必须使用表 13 给出的预定义属性 ID 常量。
本函数说明末尾的表格给出了属性 ID 常量的完整列表及其说明。
attr_value_n 变量类型 所指定值的数据类型必须与对应属性 ID 的要求匹配
end_of_arguments_id int 始终使用 OMSC_WP_ARG_END

返回类型

Compcode

若属性设置成功,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。

详细说明

高级无线包的客户端模块(例如 MAC 模块)在需要为数据包通过 PHY 层的传输指定特定无线属性时,可以使用该内核过程。如有需要,客户端模块应在把数据包发送给 PHY 模块之前调用该函数。

在单载波模式下该函数不是必需的:不调用该函数时,PHY 模块将使用其当前设置(例如通过属性配置或默认值获得的设置)来确定数据包的无线属性。而在多载波模式下使用高级无线包时,该函数是必需的。处于多载波模式时,以下常量所标识的属性的设置是必需的。属性 ID 常量的完整列表及其说明见表 13。

  • OMSC_WP_PK_SIZE_BITS_INT64
  • OMSC_WP_PK_SIZE_PHY_BLOCKS_INT
  • OMSC_WP_PK_START_TIME_DBL
  • OMSC_WP_PK_TX_DELAY_DBL
  • OMSC_WP_PK_START_FREQ_HZ_DBL
  • OMSC_WP_PK_END_FREQ_HZ_DBL
  • OMSC_WP_PK_MCS_INDEX_INT
  • OMSC_WP_PK_BURST_TYPE_INT

该函数在数据包中设置的属性数量是可变的。每个属性需要由一对参数设置:每对的第一个元素表示要设置的属性,第二个是赋给该属性的值。系统提供了表示每个属性的预定义常量。

所需属性列表写完后,必须传入特殊常量 OMSC_WP_ARG_END,表示属性列表结束。

示例

摘自 lte_support.ex.c。

void
lte_support_phy_burst_ici_info_pk_install_from_dci (Packet* pkptr, LteT_Pddch_Dci* dci_ptr, int measurement_key)
	{
/** Install the radio information in the packet from the DCI.				**/
FIN (lte_support_phy_burst_ici_info_pk_install_from_dci (pkptr, dci_ptr, measurement_key));
	oms_wp_phy_pk_transmission_info_set (pkptr, 
				OMSC_WP_PK_SIZE_BITS_INT64, 	(OpT_Int64) dci_ptr->alloc_size_bits,
				OMSC_WP_PK_SIZE_PHY_BLOCKS_INT, 	dci_ptr->alloc_size_blocks,
				OMSC_WP_PK_START_TIME_DBL, 	dci_ptr->burst_start_time,
				OMSC_WP_PK_TX_DELAY_DBL, 		dci_ptr->burst_delay,
				OMSC_WP_PK_START_FREQ_HZ_DBL, 	dci_ptr->burst_start_freq_hz,
				OMSC_WP_PK_END_FREQ_HZ_DBL, 	dci_ptr->burst_end_freq_hz,
				OMSC_WP_PK_MCS_INDEX_INT, 	dci_ptr->mcs_index,
				OMSC_WP_PK_BURST_TYPE_INT, 	LteT_Burst_Type_Data,
				OMSC_WP_PK_MEASURE_ID_INT, 	measurement_key,
				OMSC_WP_ARG_END);
	FOUT;
	}

表 13:attr_id_n 参数的取值

名称 类型 说明
OMSC_WP_ARG_END n/a 表示属性列表结束
OMSC_WP_PK_START_TIME_DBL double 传输开始时间
OMSC_WP_PK_TX_DELAY_DBL double 传输时延
OMSC_WP_PK_SIZE_BITS_INT64 OpT_Int64 以比特为单位的数据包大小
OMSC_WP_PK_SIZE_SYMBOLS_INT int 以符号为单位的数据包大小
OMSC_WP_PK_SIZE_PHY_BLOCKS_INT int 以帧/子帧分配单元为单位的数据包大小(例如 LTE 物理资源块)
OMSC_WP_PK_START_FREQ_HZ_DBL double 指示本次传输频段的起始频率
OMSC_WP_PK_END_FREQ_HZ_DBL double 指示本次传输频段的结束频率
OMSC_WP_PK_BW_HZ_DBL double 传输带宽
使用此常量,或组合使用 OMSC_WP_PK_END_FREQ_HZ_DBL 与 OMSC_WP_PK_START_FREQ_HZ_DBL,来指定传输的频段。
OMSC_WP_PK_MCS_INDEX_INT int (仅多载波模式)
分配给本次传输的调制编码方案索引。目前仅支持 LTE 专用的 MCS 索引。
OMSC_WP_PK_BLER_CURVE_PTR void* (仅单载波模式)
当前数据包应使用的调制表句柄(Modulation_Handle)。向该函数传入句柄时,务必将 Modulation_Handle 变量强制转换为 void*。
调制表给出用于计算数据包差错的 SNR 到误码率的映射关系。
OMSC_WP_PK_TX_PWR_PER_SUBCHANNEL_DBL double • 多载波模式下,每个子载波或资源块的传输功率
• 单载波模式下,整个传输带宽的实际传输功率
OMSC_WP_PK_TX_ANT_COUNT_INT int 当前数据包传输所使用的 MIMO 发射天线数量,与发射机的 MIMO 天线设置无关
OMSC_WP_PK_RX_ANT_COUNT_INT int 当前数据包接收将使用的 MIMO 接收天线数量,与每个潜在接收机的实际接收天线无关
OMSC_WP_PK_BURST_TYPE_INT int 当前数据包所表示的无线突发类型。
可用于区分各类数据包与控制包,使高级无线包的各管道阶段对它们作不同处理。
• WrlsT_Burst_Type_None – 未指定的包类型
• WrlsT_Burst_Type_Data – 参与测量采集的数据包
• WrlsT_Burst_Type_Data_No_Phy_Stats – 不用于测量采集的数据包。
• WrlsT_Burst_Type_Ctrl_0 – 控制包类型 0
• WrlsT_Burst_Type_Ctrl_1 – 控制包类型 1
• WrlsT_Burst_Type_Ctrl_2 – 控制包类型 2
• WrlsT_Burst_Type_Ctrl_3 – 控制包类型 3
OMSC_WP_PK_SC_CHANNEL_INDEX_INT int (仅单载波模式)
发射模块内将处理当前数据包传输的发射信道
OMSC_WP_PK_ECC_ACCEPT_STATUS_INT int 用于在接收侧强制接收该数据包,即使接收差错条件表明 PHY 层需要丢弃该包。
当该属性设为“1”时,无论差错条件如何,该数据包都会被接收。接收侧的客户端模块可以对任何到达的数据包调用 oms_wp_phy_rcvd_pk_accept_status_get(),以判断该包是否被 PHY 层拒绝(但被强制接收)。客户端模块随后可以决定如何处理该包。这对实现 HARQ 等重传机制特别有用。
OMSC_WP_PK_MCAST_AREA_INT int 当使用 MBSFN(Multimedia Broadcast Single Frequency Network,单频网多媒体广播)等某种无线组播技术时,用于为当前数据包指定某个组播区域 ID
OMSC_WP_PK_MEASURE_ID_INT int 高层使用的唯一键,用于唯一标识一个测量实体
在无线接收管道阶段中,类型为 WrlsT_Measurement_Record_Proc_Ptr 的回调将使用该键,为以测量键标识的测量实体记录测量值。
OMSC_WP_PK_MIMO_TECHNIQUE_INT OmsT_WP_MIMO_Tx_Technique 数据包传输将使用的 MIMO 传输技术。MIMO 传输技术可以是发射分集或空间复用。
更多信息见 OmsT_WP_MIMO_Tx_Technique。
OMSC_WP_PK_CODEWORD_INDEX_INT OmsT_WP_Codeword_Index 使用多码字空间复用时,所传数据包的码字索引。最多支持两个码字。
更多信息见 OmsT_WP_Codeword_Index。
OMSC_WP_PK_RECEIVER_RXCH_OBJID Objid 该数据包必须发送到的接收信道对象 ID。若该属性设为某个有效的接收信道,则该数据包只会发送到该接收信道。
注意: 要使用该数据包属性,必须使用 oms_wp_phy_module_attr_set() 设置 PHY 模块的 OMSC_WP_ATTR_PHY_TXCH_START_IND_FOR_SINGLE_RXCH 属性,以指定一个特殊的发射信道池。

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