Event Statistics Window

The Event Statistics Window displays execution time and current consumption (when using ULINKplus) between corresponding start and stop event annotations in the application code. It provides statistics for average values across a number of executions and captures minimum and maximum time/current events.

For details about the annotations refer to Using Event Statistics in the Event Recorder component documentation.

The Event Recorder Filter has a category to control recording of start/stop event groups.

Code Example:

#include "EventRecorder.h"                      // include for the Event Recorder API access
 :
 EventRecorderInitialize(EventRecordAll, 1U);   // initialize and start Event Recorder
 : 
 EventStartC(0);                                // start measurement event group C, slot 0  
  for (j = 0; j < 1000; j++){ 
    CalcSinTable ();                            // calculate table with sinus values 
    EventStartB(0);                             // start group B, slot 0  
    MaxSqrtSum = rand () / 65536;               // limit for sqrt calculation
    num = FindSqrtSum ((float))MaxSqrtSum);     // return number of sqrt operations
    EventStopBv(0, MaxSqrtSum, num);            // stop group B, slot 0, log MaxSqrtSum,num  
 }
 EventStopC(0);                                 // stop measurement event group C, slot 0  
 :

• EventStartG (slot) or EventStartGv (slot, v1, v2) functions define the start point of an execution slot.
• EventStopG (slot) or EventStopGv (slot, v1, v2) functions define the stop point of an execution slot.

Each execution slot is identified by the function name group letter G = {A, B, C, D} and a slot number (0 to 15). A call to EventStopG or EventStopGv with slot=15 stops measurement for all slots in a group and may be used at global exits of an execution block.

Display Event and Thread Statistics

Open from the menu View - Analysis Windows - Event Statistics. The figure below explains the displayed information:

For the minimum and maximum time or current consumption it also shows for start and stop events the: 

• Source file name and line number of event calls via EventStartG (slot) or EventStopG (slot)
• Integer values v1 and v2 of event calls via EventStartGv (slot, v1, v2) or EventStopGv (slot, v1, v2).

Aggregated statistical data

The aggregated statistical data for an execution slot is displayed in the corresponding row.

The following information is shown:

Captured minimum and maximum events

For each execution slot, the events with maximum and minimum execution times and current consumption (when using ULINKplus with power measurement) are captured.

The following information is shown:

⁽¹⁾ Q, I and U values are only shown when using ULINKplus with power measurement.

Thread execution statistics

Statistical data for the execution of threads is also shown. As for events, minimum, maximum, and average execution times are shown for each state of each thread separately.

Reset Statistic Information or Create Log Files

The debug command EventRecorder creates a log file or resets the statistic information.

Start/Stop events in Event Recorder window

As all other events, the start/stop events are listed in the Event Recorder Window as shown below.