Package Overview
Note: You must have a license for the Wireless functionality to use the Radio package.
The Radio package is a collection of Kernel Procedures that allows you to dynamically change a radio transmitter channel’s receiver group and perform other wireless-related operations. You can use these KPs to change receiver groups at any time during a simulation. For example, you can remove a receiver channel when its node moves beyond the transmitter channel’s broadcast range. Using dynamic receiver groups also eliminates the need to retain obsolete receivers strictly to allow a transmitter to cancel messages. See “Default Receiver Group Model (dra_rxgroup)“ on page 290 for more information on radio receiver groups.
When a transmitter channel attempts to modify its receiver group during a packet transfer, the Simulation Kernel maintains the original group to ensure correct message cancellation. Any subsequent operations will use the modified group. (The OPNET debugger displays both the original and the modified groups when you examine a transmitter channel during a packet transfer.)
You can add receivers to a receiver group using op_radio_txch_rxch_add() and remove them using op_radio_txch_rxch_remove(). You can assign a complete receiver group to a transmitter channel using op_radio_txch_rxgroup_set() and retrieve a listing of a transmitter channel’s current receiver group using op_radio_txch_rxgroup_get(). Calling the procedure op_radio_txch_rxgroup_compute() calculates or updates a transmitter channel’s receiver group; this allows you to invoke the radio group pipeline stage for a transmitter channel at any time during a simulation.
Use the KP op_radio_antenna_point_info_get() to obtain the current polar and azimuth pointing angles (in the geocentric coordinate system) of an antenna. The pointing angles (in the antenna’s coordinate system) and gain to a particular geocentric location can be obtained with op_radio_antenna_angles_to_location_get() and op_radio_antenna_gain_to_location_get(), respectively.
Use op_radio_wireless_domain_aux_proc_call() to invoke the Auxiliary callback of a wireless domain.