oms_wp_phy_module_attr_set()

摘要

在 PHY 模块句柄中设置各属性的值。

语法

oms_wp_phy_module_attr_set (phy_handle, attr_id_0, attr_value_0, attr_id_1, attr_value_1, attr_id_n, attr_value_n, end_of_arguments_id);

参数 类型 说明
phy_handle OmsT_WP_Phy_Handle* PHY 模块句柄
attr_id_<num> int 必须使用表 11 中给出的预定义属性 ID 常量。
属性 ID 常量及其说明的完整列表,见本函数说明末尾的表格。
attr_value_<num> 变量类型 指定值的数据类型必须与对应属性 ID 的要求匹配。
end_of_arguments_id int 始终使用 OMSC_WP_ARG_END

返回类型

Compcode

如果属性被正确设置,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。

详细说明

该函数与 oms_wp_phy_module_changes_commit() 或 oms_wp_phy_module_activate() 配合使用,以更改高级无线包中 PHY 模块的属性。该函数负责在 PHY 模块句柄中设置各属性的值。可以通过调用 oms_wp_phy_module_changes_commit() 或 oms_wp_phy_module_activate(),把这些属性从句柄提交到实际的 PHY 模块。

该函数接收的参数数量是可变的。

  • 第一个参数是 PHY 模块句柄,它必须始终存在。
  • 接下来的参数是要在句柄中设置的属性。 每个属性由一对连续的参数设定:每对参数中的第一个是表示待设置属性的常量,其后跟着为该属性设置的值。

在所有属性参数指定完毕后,最后一个参数必须是用于终止传入该函数的参数列表的特殊常量 OMSC_WP_ARG_END。

调用该函数时,必须指定 PHY 模块句柄、至少一个属性(连同其对应的一对参数),并在最后给出 OMSC_WP_ARG_END。

表 11:attr_id_<num> 参数的取值

符号常量 对应值类型 说明
OMSC_WP_ARG_END 无 参数列表结束
OMSC_WP_ATTR_PHY_TYPE OmsT_WP_Phy_Type PHY 技术类型:单载波或多载波(OFDMA)
可取的值见 OmsT_WP_Phy_Type。
OMSC_WP_ATTR_PHY_MODEL OmsT_WP_Phy_Model_Type PHY 模型类型
目前可用的模型类型为 SCFDMA 或 OFDMA(用于多载波),或 unregistered model(用于单载波)。
可取的值见 OmsT_WP_Phy_Model_Type。
OMSC_WP_ATTR_PHY_MIMO_TX_ANT_COUNT int MIMO 发射天线数量
OMSC_WP_ATTR_PHY_MIMO_RX_ANT_COUNT int MIMO 接收天线数量
OMSC_WP_ATTR_PHY_ECC_ACCEPT_PKTS_IN_ERROR Boolean 表示 PHY 模块发送的所有数据包都会被所有接收方接受,而不论数据包中累积的错误如何。这使得更高层(例如 MAC)可以访问处于错误状态的数据包。
OMSC_WP_ATTR_PHY_EFFECTIVE_SNR_COMPUTE_PROC WrlsT_Effective_Snr_Compute_Proc_Ptr 用于在多径衰落存在的情况下,根据给定的测量平均 SNR 计算有效 SNR 的函数回调。
更多信息参见 WrlsT_Effective_Snr_Compute_Proc_Ptr。
OMSC_WP_ATTR_PHY_TXCH_START_IND_FOR_SINGLE_RXCH int 该属性指示一个特殊发射信道池的起始发射信道编号,客户端进程可用该池把数据包发送到单个接收信道,而不是所有可能的接收信道。当使用空间复用 MIMO 技术时,这类信道通常被用来高效地发送第二个码字,因为第二个码字不会在其他接收信道上引起额外的干扰。
OMSC_WP_ATTR_PHY_MAC_TO_PHY_PARAMS_CONVERT_PROC WrlsT_MAC_To_PHY_Convert_Proc_Ptr 把更高层(例如 MAC)的无线配置需求转换到高级无线包的 PHY 模块的函数回调。
更多信息参见 WrlsT_MAC_To_PHY_Convert_Proc_Ptr。
OMSC_WP_ATTR_PHY_MCARRIER_SUBBAND_MEASURE_PROC WrlsT_Inoise_Mcarrier_Subband_Measures_Proc_Ptr 用于指定多载波 PHY 层所支持的各种子带测量收集方法的函数回调。
更多信息参见 WrlsT_Inoise_Mcarrier_Subband_Measures_Proc_Ptr。
OMSC_WP_ATTR_PHY_MEASURE_INFO void* 供子带测量回调使用的数据
OMSC_WP_ATTR_PHY_CLIENT_INFO void* 供 MAC 到 PHY 转换回调使用的数据
OMSC_WP_ATTR_PHY_CELL_ID int 在多载波模式下,该属性指示节点当前“监听”的小区(例如 LTE 中的 eNodeB)的小区 ID。\
OMSC_WP_ATTR_PHY_SERVING_CELL_ID int 在多载波模式下,该属性指示当前为该节点提供服务的小区(例如 LTE 中的 eNodeB)的小区 ID
OMSC_WP_ATTR_PHY_CENTER_FREQ double 指示发射机的中心频率
不可与 OMSC_WP_ATTR_PHY_BASE_FREQ 同时设置
OMSC_WP_ATTR_PHY_BASE_FREQ double 指示发射机的基频
不可与 OMSC_WP_ATTR_PHY_CENTER_FREQ 同时设置
OMSC_WP_ATTR_PHY_BW double 指示发射机的带宽

示例

lte_enb_as 进程模型 init exit executives 的节选。

/* Set the properties of the PHY layer.							*/
oms_wp_phy_module_attr_set (phy_module_hdl,
	OMSC_WP_ATTR_PHY_TYPE, 	OmsC_WP_OFDMA,
	OMSC_WP_ATTR_PHY_MODEL, 	OmsC_WP_Lte_Ofdma,
	OMSC_WP_ATTR_PHY_CELL_ID,	enb_id,
	OMSC_WP_ATTR_PHY_MAC_TO_PHY_PARAMS_CONVERT_PROC,	(void*)
	lte_support_mac_config_to_phy_convert,
	OMSC_WP_ATTR_PHY_CLIENT_INFO, (void*) &chnl_descriptor,
	OMSC_WP_ATTR_PHY_MCARRIER_SUBBAND_MEASURE_PROC, 	(void*) OPC_NIL,
	OMSC_WP_ATTR_ARG_END);
/* Initialize and commit the PHY layer properties.							*/
oms_wp_phy_module_activate (phy_module_hdl);

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