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);