About this guide

This guide contains comprehensive information about Azure RTOS TraceX, the Microsoft Windows-based system analysis tool for Microsoft Azure RTOS.

It is intended for the embedded real-time software developer using Azure RTOS ThreadX Real-Time Operating System (RTOS) and add-on components. The developer should be familiar with standard Azure RTOS ThreadX Azure RTOS FileX, and Azure RTOS NetX concepts.

Organization

  • Chapter 1 - contains an basic overview of Azure RTOS TraceX and describes its relationship to real-time development.
  • Chapter 2 - gives the basic steps to install and use Azure RTOS TraceX to analyze your application right out of the box.
  • Chapter 3 - describes the main features of Azure RTOS TraceX.
  • Chapter 4 - details performance analysis features of Azure RTOS TraceX.
  • Chapter 5 - describes how to set up Azure RTOS ThreadX, Azure RTOS FileX, and Azure RTOS NetX in order to generate a trace buffer that is viewable by Azure RTOS TraceX.
  • Chapter 6 - describes Azure RTOS TraceX events in detail.
  • Chapter 7 - describes Azure RTOS FileX events in detail.
  • Chapter 8 - describes Azure RTOS NetX events in detail.
  • Chapter 9 - describes Azure RTOS USBX events in detail.
  • Chapter 10 - describes creating custom user events in detail.
  • Chapter 11 - describes the internal trace buffer in detail.
  • Appendix A - Azure RTOS ThreadX port-specific file with its time-stamp source for gathering trace events.
  • Appendix B - Azure RTOS ThreadX tx_trace.h file that shows implementation details regarding the event trace buffer.
  • Appendix C - Summarizes command line utilities for converting various file formats into proper Azure RTOS TraceX binary files.
  • Appendix D - Examples of dumping trace files from various development tools.

Guide Conventions

Italics - Typeface denotes book titles, emphasizes important words, and indicates variables.

Boldface - Typeface denotes file names, key words, and further emphasizes important words and variables.

Note

Indicates information of note.

Customer Support Center

Please submit a support ticket through the Azure Portal for questions or help using the steps here. Please supply us with the following information in an email message so we can more efficiently resolve your support request:

  1. A detailed description of the problem, including frequency of occurrence and whether it can be reliably reproduced.
  2. A detailed description of any changes to the application and/or Azure RTOS ThreadX that preceded the problem.
  3. The contents of the _tx_version_id string found in the tx_port.h file of your distribution. This string will provide us valuable information regarding your run-time environment.
  4. The contents in RAM of the _tx_build_options ULONG variable. This variable will give us information on how your Azure RTOS ThreadX library was built.