Configuring Triggered Logging in Stimulus Profiles

Use triggered logging in stimulus profiles if you want to see channel data under certain conditions, such as those that you might expect to cause the unit under test (UUT) to fail.

When you use the Stimulus Profile Editor to log real-time test data, you can configure start and stop triggers for logging. The editor logs channel data while the start trigger condition is TRUE and the stop trigger condition is FALSE.

You can also configure pre-triggered and post-triggered data logging. This saves the channel data immediately before a start trigger and after a stop trigger. For example, if the start trigger represents a fault in the system, and the stop trigger represents a return to expected values, it can be useful to see the behavior of the system that lead to the fault and how well the system recovers.

  1. Create a stimulus profile that logs real-time test data.
  2. Select the Start Logging step for a logging configuration.
  3. In the Property Browser, set the Trigger Channel to a channel you want to watch for logging conditions.
    Note This can be any channel in the system definition associated with the stimulus profile.
  4. Set the Trigger Condition and the corresponding High Limit and Low Limit values.
    Note You can set the Trigger Condition to in_limits or out_of_limits to configure logging to start and stop when the value of Trigger Channel either enters or leaves the value range specified by the limits. For example, if you set Trigger Condition to in_limits, the stimulus profile registers a start trigger when the value of Trigger Channel is greater than or equal to the Low Limit and less than or equal to the High Limit. It registers a stop trigger, and stops logging, when the value of Trigger Channel leaves this window.
  5. Depending on your desired result, configure the step to handle a situation where multiple start triggers occur.
    Desired Result Configuration
    One file containing all logged data. Disable Replace Existing File.
    One file containing only data from the last occurrence of a start trigger. Enable Replace Existing File.
    Separate files for each set of logged data.
    1. Enable Timestamp Filename.
      Note You must enable timestamps on segmented filenames to avoid filename conflicts.
    2. Set Segment Options to OnStartTrigger
  6. If you want to specify an amount of channel data to log immediately before a start trigger occurs, set a value for Pre-Trigger Duration.
    Note When you execute the profile, the VeriStand Gateway maintains a buffer that always contains this amount of data.
  7. If you want to specify an amount of channel data to log after a stop trigger occurs, set a value for Post-Trigger Duration.
  8. Click Save.