oms_wp_phy_module_handle_get()
Abstract
Gets a handle to the PHY module.
Syntax
oms_wp_phy_module_handle_get (phy_module_name)
| Argument | Type | Description |
|---|---|---|
phy_module_name |
const char* |
Name of the PHY module within the node model The default name is “phy” when using the modules as provided. |
Return Type
OmsT_WP_Phy_Handle*
Details
This function is intended to be used when oms_wp_phy_module_initialize_single_carrier() and oms_wp_phy_module_initialize_multi_carrier() are not used. In this case, the PHY module client can use the handle to send packets to the PHY module or to install measurements and subscribe to notifications.
Example
Excerpt from coverage_area_tracker process model, init4 enter execs.
* Obtain a handle to the advanced wireless PHY module. */
phy_handle = oms_wp_phy_module_handle_get ("phy");
/* 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);