System Response Time Measurement (SRTM) Sample
Description
The System Response Time Measurement (SRTM) utility measures timer delivery latencies using the eRTOS synchronized clock and timers. It then prints the results.
Source Files
File | Description |
---|---|
srtm.c |
Gathers thread-level timer latencies and prints out a summary and an optional histogram of results. The timer can also generate a sound on the speaker. This is a useful tool for measuring application-level response time latencies while the system is stressed by other activity, such as disk, network, and GUI IO, and/or heavy processing. Different hardware platforms can also be compared. |
Building the Sample
- Open a project file in the corresponding Visual Studio version you use for development.
- Build the project.
Running the Sample
To run the SRTM sample:
- Boot the system in its Windows Boot Configuration.
- Navigate to
<InstallDrive>\MaxRT\eRTOS\
. - Right-click AutoStart.bat and select Edit.
- Find or write the Run command(s) for SRTM.
Note: For more information on Run commands, see Run.
- If using pre-written Run commands, remove the comment characters (: :) to enable the command(s).
- Re-boot the system from a GRUB bootable USB drive or hard drive.
- Select the desired GRUB boot configuration. See GRUB Boot Configurations for more information.
- Upon system boot, the sample(s) will run automatically after the eRTOS Kernel startup.
- Sample output will be displayed on the screen when the program ends.
- Re-boot the system in its Windows Boot Configuration.
- Navigate to
<InstallDrive>\MaxRT\eRTOS\
. - Open the RtLogFile.txt log file to view sample output.
Usage
Run | srtm [/?] [/h] [/s] [/1] [/f] seconds_to_sample
Options
/h = Display histogram (in addition to summary)
/s = Turn on sound (square wave driven by timer)
/1 = Use a 10 MS timer period (default is 1 MS)
/f = Use fastest available timer (1MS or better)
/n num = Multiple SRTM instances aware (num = the total number of instances)
/? = help on usage
If no parameters given, the default is srtm /h /s /f 15
APIs Referenced