About the Azure RTOS ThreadX Guide

This guide provides comprehensive information about Azure RTOS ThreadX, the Microsoft high-performance real-time kernel.

It is intended for the embedded real-time software developer. The developer should be familiar with standard real-time operating system functions and the C programming language.

Organization

Chapter 1 - Provides a basic overview of Azure RTOS ThreadX and its relationship to real-time embedded development

Chapter 2 - Gives the basic steps to install and use Azure RTOS ThreadX in your application right out of the box

Chapter 3 - Describes in detail the functional operation of Azure RTOS ThreadX, the high performance real-time kernel

Chapter 4 - Details the application's interface to Azure RTOS ThreadX

Chapter 5 - Describes writing I/O drivers for Azure RTOS ThreadX applications

Chapter 6 - Describes the demonstration application that is supplied with every Azure RTOS ThreadX processor support package

Appendix A - Azure RTOS ThreadX API

Appendix B - Azure RTOS ThreadX constants

Appendix C - Azure RTOS ThreadX data types

Appendix D - ASCII chart

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.

Important

Information symbols draw attention to important or additional information that could affect performance or function.

Warning

Warning symbols draw attention to situations in which developers should take care to avoid because they could cause fatal errors.

Azure RTOS ThreadX Data Types

In addition to the custom Azure RTOS ThreadX control structure data types, there are a series of special data types that are used in Azure RTOS ThreadX service call interfaces. These special data types map directly to data types of the underlying C compiler. This is done to insure portability between different C compilers. The exact implementation can be found in the tx_port.h file included with the source.

The following is a list of Azure RTOS ThreadX service call data types and their associated meanings:

Data type Description
UINT Basic unsigned integer. This type must support 8-bit unsigned data; however, it is mapped to the most convenient unsigned data type.
ULONG Unsigned long type. This type must support 32-bit unsigned data.
VOID Almost always equivalent to the compiler's void type.
CHAR Most often a standard 8-bit character type.

Additional data types are used within the Azure RTOS ThreadX source. They are also located in the tx_port.h file.

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.