在任意模块监测 PHY 层测量
本节说明如何使用 API 函数在任意模块监测 PHY 层测量,即使这些模块并未通过数据包流与 PHY 模块相连。
注意: 可在
coverage_area_tracker进程模型中看到 API 用法的示例,涉及 init4 state exit executives、function block、header block、next_angle exit executives、high_signal exit executives 和 low_signal exit executives 各部分。
过程 4:在任意模块监测 PHY 层测量
-
从客户端模块获取 PHY 模块的句柄。
1.1 在客户端模块中调用
oms_wp_phy_module_handle_get(),提供 PHY 模块的实际名称。*结果:* 创建指向 PHY 模块的本地句柄。注意: 调用此函数不会在客户端模块与 PHY 模块之间引起任何中断/事件交互。
-
使用
oms_wp_phy_measure_register_single()安装测量。注意以下几点:-
此函数需要在第四个仿真事件阶段或之后调用。
来自
coverage_area_tracker进程模型 init4 state exit executives 的示例:/* Register a received power measure. Note that the object ID of the cell */ /* transmitter is associated to this measurement so only the packets sent */ /* from that node contribute to this measurement. */ oms_wp_phy_measure_register_single(phy_handle, (int) Transmitter_Node_Objid, OmsC_WP_RCV_Power, OMSC_WP_MEASURE_WNDW_SIZE_NONE, coverage_tracker_phy_rcvd_power_measurement_collect_only_one_node); -
此函数必须指明 PHY 句柄、测量标识码、测量类型(例如接收功率、SNR)以及测量窗口大小(以秒计)。
-
此函数还必须指明决定哪些数据包计入测量的函数回调(见该进程的 function block 中的示例)。此函数回调可以使用
oms_wp_phy_measure_entity_get_from_rx_state()获取将被更新的实际测量实体,以及使用oms_wp_phy_support_measurement_write()将新的测量值写入其中。
-
-
订阅测量值高于或低于指定阈值时的通知告警。
3.1 使用函数
oms_wp_phy_measure_notification_subscribe()。务必使用安装测量时(步骤 2)所用的相同测量标识码和测量类型。3.2 指定应触发通知的阈值和阈值方向。可选地,使用子客户端 ID 为此特定通知分配一个代码。当同一测量订阅了多个通知时,这尤其有用,因为它可以区分到达的告警。子客户端字符串用于调试目的,如果不需要,可以为空字符串。
-
监视告警。
结果: 测量将通过远程中断向客户端模块通知任何告警。
4.1 使用函数
oms_wp_phy_notification_handle_get()评估任何中断的到达,并判断该中断是否对应测量发出的通知告警。此函数将捕获通知信息,并返回一个告警句柄(OmsT_WP_Phy_Alert_Handle)。可以使用 `oms_wp_phy_alert_handle_valid()` 评估该告警句柄,以判断中断是否对应通知告警,此时此函数将返回 valid。否则返回 false,这种情况发生在当前事件不符合测量通知事件的特征时(例如,当前事件不是远程中断)。 当进程模型除测量通知外还预期其他中断时,使用 `oms_wp_phy_alert_handle_valid()` 评估告警句柄尤其重要。 > **注意:** 在本例中,作为示例列出的客户端模块(`coverage_area_tracker.pr.m`)没有检查告警的有效性,因为它没有预期其他中断。4.2 读取告警的信息。
按照上一步所述检查告警的有效性后,你可以读取与告警关联的不同属性。例如,`oms_wp_phy_alert_threshold_dir_get()` 返回当前告警中指定的阈值方向,`oms_wp_phy_alert_measure_avg_get()` 返回触发告警的平均测量值,`oms_wp_phy_alert_subclient_id_get()` 返回为当前告警指定的子客户端 ID,`oms_wp_phy_alert_measure_type_get()` 返回关联的测量类型,等等。
过程 4 结束