Setting Up the Trigger Event

RTX Time View begins monitoring data and storing it in a buffer as soon as the RTX Time View Wizard is completed; however, logging of the events to a file is not started until the trigger condition is detected. The Trigger Setup dialog box lets you select the type of event that will trigger the logging of data.

To set up the trigger event:

From the File Setup screen, click Next to display the Trigger Setup dialog.

From the Trigger Setup dialog, select the event and the occurrence of the event you want to act as your data collection trigger (see Trigger Event Options below for a detailed list). If Immediate is selected as the trigger, Occurrence is not a valid option. For events that contain a drop-down list, select the desired event item. When the specified trigger event is detected, RTX Time View starts capturing data to the log file. For example, if ReleaseSemaphore under Deterministic Calls has been selected as the trigger event and Occurrence has been set to 3, RTX Time View will begin collecting data on the third occurrence of the RtReleaseSemaphore call.

NOTE: Users can create their own events that can be logged and used as triggers. User events are created by adding trace event calls in your application code using the RTX function call RtTraceEvent.

Click Next to advance to the Data Capture Setup dialog.

Trigger Event Options

The table below lists the events you can specify as a trigger for RTX Time View. To get additional information about an event, see RTX Time View Events.

Trigger	Description
Any user event id	Defines the trigger as any event defined with the RtTraceEvent call.
Deterministic calls	Choose from the following. To get detailed information about a particular event type, click its link. Cancel Timer Enter Critical Section Get Process Affinity Mask Get Thread Times Leave Critical Section Pulse Event Raise Exception Release Mutex Release Semaphore Reset Event Resume Thread RtSleep Set Event Set Process Affinity Mask Set Thread Affinity Mask Set Thread Ideal Processor Set Thread Priority Set Timer Set Timer Relative Sleep Suspend Thread Wait For Multiple Objects Wait for Single Object
Immediate	Logging begins as soon as you click Start in the RTX Time View Wizard.
Internal activity	Choose from: Object Close Object Creation Object Destroy Object Open Object WFO Timeout Object WFO Wakeup Thread Context Switch
Interrupts	Choose from: Device Interrupts Exception Interrupts Timer Interrupts
Non-deterministic calls	Choose from: Allocate Contiguous Memory Allocate Locked Memory Attach Interrupt Attach Shutdown Handler Close Handle Create Event Create File Create Mutex Create Semaphore Create Shared Memory Create Thread Create Timer Delete Critical Section Delete File Device IO Control Exit Process Exit Thread Free Contiguous Memory Free Locked Memory Get Bus Data Heap Allocate Heap Create Heap Destroy Heap Free Heap Re-Allocate Initialize Critical Section Map Memory Open Event Open Mutex Open Semaphore Open Shared Memory Read File Remove Directory Set Bus Data Set File Pointer Terminate Thread Translate Bus Data Unmap Memory Write File