Changing Wireless Node Behavior Using API Functions

As described in the third use case described in Advanced Wireless Package Use Cases, you can use the APIs that are shipped with the advanced wireless package to do the following:

  • Send and receive MAC packets through the PHY module
  • Configure PHY module parameters for advanced wireless communication techniques
  • Register measurements and corresponding alerts

Note: See API Workflow Examples for suggested ways to use the built-in APIs.

Built-in APIs make the integration and use of the advanced wireless package easier.

  • The measurement/notification utility helps you monitor the state of the wireless transmissions (for example, received power) from your custom modules or layers and receive alerts that can interact with your implementation.

    A common requirement for existing wireless protocols is the need to monitor the radio signals to trigger actions (for example, routing, navigation, handover, and adaptive power) within different layers of a wireless device. You can use the advanced wireless package to simplify the implementation of a radio model with these capabilities already built in. Specifically, a measurement module is provided to monitor the PHY state and to subscribe to notifications that the module will communicate when the measured value reaches a given threshold.

  • Notification alerts can be received even if the client module or layer is not connected directly to the PHY module (for example, through packet streams). This is useful for alerting any layer (for example, IP or application layer) about the PHY activity so decisions based on such conditions can be made at that layer.

The advanced wireless package is utilized by the LTE suite for the modeling of LTE physical layer. Some LTE models are referenced in the examples provided for API in the sections that follow and in the API description in the General Models Reference guide. See "Advanced Wireless Package" on page 104 for detailed descriptions of each function of API.