WrlsT_Effective_Snr_Compute_Proc_Ptr
Abstract
Computes the effective SNR of the received packet from the given average SNR by taking the multipath fading into account. When called, all the function arguments are populated and passed by the calling pipeline stage model of the receiver module.
Syntax
WrlsT_Effective_Snr_Compute_Proc_Ptr (mpath_channel_model_ptr, scaling_factors_arr, current_state, cw_index, avg_snr_db);
| Argument | Type | Description |
|---|---|---|
| mpath_channel_model_ptr | OmsT_WP_Multipath_Channel_Model * |
Multipath channel model information. This is passed by the pipeline stage of the radio receiver module as an argument to this function. (Refer to oms_wp_api.h for definition.) |
| scaling_factors_arr | int* |
An array of scaling factors defined for the MCS index of the received packet. The size of the array depends upon the number of scaling factors defined in the attribute “Multipath Channel Definitions > Manual Configuration > MCS Scaling Factors > Scaling Factors” or attribute “Multipath Channel Definitions > Import File Names > MCS Scaling Factors > Scaling Factors” for the MCS index of the packet received by the receiver module. |
| current_state | int |
Current state of the multipath channel. |
| cw_index | OmsT_WP_Codeword_Index |
Codeword index of the received packet. See OmsT_WP_Codeword_Index for more information. |
| avg_snr_db | Double |
SNR of the received packet without the effect of multipath channel. |
Return Type
double
Effective SNR of the received packet due to multipath channel
Details
WrlsT_Effective_Snr_Compute_Proc_Ptr is set by default to wrls_phy_mpath_effective_snr_mapping_function_apply(), defined in wrls_phy_support.ex.c. However, this can be overridden by configuring OMSC_WP_ATTR_PHY_EFFECTIVE_SNR_COMPUTE_PROC property of the PHY module handle using oms_wp_phy_module_attr_set().
This callback will be invoked by the SNR pipeline stage of a radio receiver module of the Advanced Wireless Package.
For more information about multipath channels, see “Multipath Parameters” on page 6 in the Advanced Wireless Model User Guide.
Example
wrls_phy_mpath_effective_snr_mapping_function_apply() defined in wrls_phy_support.ex.c.