在任意模块监测 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 层测量

  1. 从客户端模块获取 PHY 模块的句柄。

    1.1 在客户端模块中调用 oms_wp_phy_module_handle_get(),提供 PHY 模块的实际名称。

    *结果:* 创建指向 PHY 模块的本地句柄。
    

    注意: 调用此函数不会在客户端模块与 PHY 模块之间引起任何中断/事件交互。

  2. 使用 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. 订阅测量值高于或低于指定阈值时的通知告警。

    3.1 使用函数 oms_wp_phy_measure_notification_subscribe()。务必使用安装测量时(步骤 2)所用的相同测量标识码和测量类型。

    3.2 指定应触发通知的阈值和阈值方向。可选地,使用子客户端 ID 为此特定通知分配一个代码。当同一测量订阅了多个通知时,这尤其有用,因为它可以区分到达的告警。子客户端字符串用于调试目的,如果不需要,可以为空字符串。

  4. 监视告警。

    结果: 测量将通过远程中断向客户端模块通知任何告警。

    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 结束