TmmT_Path_Loss_Calc_Method
注意: 需要地形建模模块(Terrain Modeling Module)功能。
摘要
回调:按需调用,为传播模型执行路径损耗计算。
语法
<path_loss_calc_method_name> (model_ptr, tda_state_ptr, tx_position_ptr, rx_position_ptr, center_frequency, bandwidth, verbose, status_ptr, message_buffer_v)
| 参数 | 类型 | 说明 |
|---|---|---|
model_ptr |
TmmT_Propagation_Model * |
与此方法关联的传播模型。 |
tda_state_ptr |
void * |
从流水线阶段(pipeline stage)传入的参数(见详情)。 |
tx_position_ptr |
TmmT_Position * |
发射机的位置(纬度、经度和海拔米数)。 |
rx_position_ptr |
TmmT_Position * |
接收机的位置(纬度、经度和海拔米数)。 |
center_frequency |
double |
路径损耗计算的中心频率,单位为赫兹(Hz)。 |
bandwidth |
double |
路径损耗计算的信号带宽,单位为赫兹(Hz)。 |
verbose |
int |
错误消息使用的 verbose 模式,OPC_TRUE(详细输出)或 OPC_FALSE。 |
status_ptr |
TmmT_Loss_Status * |
路径损耗计算的状态,为 TmmC_Loss_Valid、TmmC_Loss_Error 或 TmmC_Loss_No_Closure 之一。 |
message_buffer_v |
char |
用于填写文本消息的区域(见详情)。 |
返回类型
double
计算得到的路径损耗,以信号增益表示,单位为分贝(dB)。该值为 0.0(近场)或负值。
头文件
tmm.h
详情
该回调为 model_ptr 指定的传播模型执行路径损耗计算。在初始化传播模型时,应将此回调指定为该模型的 path_loss_calc_method。
tda_state_ptr 参数供你的流水线阶段在需要时向路径损耗计算函数传递参数(与仿真 Packet 提供 TDA 的方式类似)。当 Project Editor 调用传播模型时,该参数为 OPC_NIL。
message_buffer_v 参数为路径损耗计算提供报告计算损耗值过程中任何问题或错误文本消息的位置。该变量是一个二维数组,由五个 512 字符缓冲区组成。
用途
用于为传播模型执行路径损耗计算的回调。