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 属性,以指定一个特殊的发射信道池。 |