Modem Signal Strength

A Modem Signal Strength event trigger executes when the signal strength of the node's cellular modem meets a defined condition.

For this trigger event type to execute, a SIM card must have been properly inserted into the node or the modem must have been activated and registered with the cellular network provider.

Defining a modem signal strength event trigger

To define a modem signal strength event trigger, follow these steps:

  1. From the Workbench left pane, expand the node where you want to define the modem signal strength event trigger.
  2. Select the Project icon to display the Projects window, right-click a specific project tab to display its pop-up menu, and then select New.
    You also can select the New button at the bottom of the Projects window when a specific project tab has already been selected.
  3. The new Trigger window appears.
    Name the trigger. The trigger name can be up to 64 characters and include letters, numbers, and the underscore character. Spaces are allowed.
  4. From the Event tab, select the Trigger Event Type down-arrow, expand the Cellular Modem category, and then select Modem Signal Strength.

    The Event tab becomes active with parameters that accommodate the modem signal strength event.
Parameter Description
Condition The condition of the modem signal strength that causes the trigger to execute. The condition can be specified as follows:
  • Value changed - The signal strength changed from its previous value.
  • Greater than - The signal strength is greater than the value specified in Signal Strength.
  • Greater than or equal to - The signal strength is greater than or equal to the value specified in Signal Strength.
  • Equal to - The signal strength is equal to the value specified in Signal Strength.
  • Less than - The signal strength is less than the value specified in Signal Strength.
  • Less than or equal to - The signal strength is less than or equal to the value specified in Signal Strength.
Signal Strength A signal strength value. The valid range is 0 through 5.
Depending on the condition selected, the range may even be further restricted. For example, when using the Greater than condition, the maximum valid signal strength value is 4.

Modem signal strength event type trigger event variables

The input event variables available to a modem signal strength message event trigger are:

Event variable Data type Description
Previous Signal Strength INT4 The previous value of the signal strength prior to the condition being met.
Signal Strength INT4 The current value of the signal strength.
Timestamp TIMESTAMP The date and time when the change in signal strength was detected.
Related Topics

Get Modem Radio Signal Status