这个目录中存放的是与范例HPLIST相关的文件（请看附录D，HPLISTC和TO）。HPLIST.C存放在\\SOFTWARE\\HPLISTC\\SOURCE目录下。DOS下的可执行文件（HPLIST.EXE）存放在\\SOFTWARE\\TO\\EXE中。

? \\SOFTWARE\\TO

这个目录中存放的是和范例TO相关的文件（请看附录D，HPLISTC和TO）。源文件TO.C存放在

\\SOFTWARE\\TO\\SOURCE中，DOS下的可执行文件（TO.EXE）存放在\\SOFTWARE\\TO\\EXE中。注意TO需要一个TO.TBL文件，它必须放在根目录下。用户可以在\\SOFTWARE\\TO\\EXE目录下找到TO.TBL文件。如果要运行TO.EXE，必须将TO.TBL复制到根目录下。

? \\SOFTWARE\%uCOS-II

与μC/OS-II 相关的文件都放在这个目录下。

? \\SOFTWARE\%uCOS-II\\EX1_x86L

这个目录里包括例1的源代码(参见 1.07, 例1)，可以在DOS（或Windows 95下的DOS窗口）下运行。

? \\SOFTWARE\%uCOS-II\\EX2_x86L

这个目录里包括例2的源代码(参见 1.08, 例2)，可以在DOS（或Windows 95下的DOS窗口）下运行。

? \\SOFTWARE\%uCOS-II\\EX3_x86L

这个目录里包括例3的源代码(参见 1.09, 例3)，可以在DOS（或Windows 95下的DOS窗口）下运行。

? \\SOFTWARE\%uCOS-II\\Ix86L

这个目录下包括依赖于处理器类型的代码。此时是为在80x86处理器上运行uC/OS-II而必须的一些代码，实模式，在大模式下编译。

? \\SOFTWARE\%uCOS-II\\SOURCE

这个目录里包括与处理器类型无关的源代码。这些代码完全可移植到其它架构的处理器上。 1.01 INCLUDES.H

用户将注意到本书中所有的 *.C 文件都包括了以下定义：

#include \

INCLUDE.H可以使用户不必在工程项目中每个*.C文件中都考虑需要什么样的头文件。换句话说，INCLUDE.H是主头文件。这样做唯一的缺点是INCLUDES.H中许多头文件在一些*.C文件的编译中是不需要的。这意味着逐个编译这些文件要花费额外的时间。这虽有些不便，但代码的可移植性却增加了。本书中所有的例子使用一个共同的头文件INCLUDES.H，3个副本分别存放在

\\SOFTWARE\%uCOS-II\\EX1_x86L，\\SOFTWARE\%uCOS-II\\EX2_x86L，以及\\SOFTWARE\%uCOS-II\\EX3_x86L 中。当然可以重新编辑INCLUDES.H以添加用户自己的头文件。 1.02不依赖于编译的数据类型

因为不同的微处理器有不同的字长，μC/OS-II的移植文件包括很多类型定义以确保可移植性（参见\\SOFTWARE\%uCOS-II\\Ix86L\\OS_CPU.H，它是针对80x86的实模式，在大模式下编译）。μCOS-II不使用C语言中的short,int,long等数据类型的定义，因为它们与处理器类型有关，隐含着不可移植性。笔者代之以移植性强的整数数据类型，这样，既直观又可移植，如表L1.1所示。为了方便起见，还定义了浮点数数据类型，虽然μC/OS-II中没有使用浮点数。

程序清单 L1.1 可移植型数据类型。 Typedef unsigned char BOOLEAN; Typedef unsigned char INT8U; Typedef signed char INT8S;

Typedef unsigned int INT16U; Typedef signed int INT16S; Typedef unsigned long INT32U; Typedef signed long INT32S; Typedef float FP32; Typedef double FP64;

#define BYTE INT8S #define UBYTE INT8U #define WORD INT16S #define UWORD INT16U #define LONG INT32S #define ULONG INT32U

以INT16U数据类型为例，它代表16位无符号整数数据类型。μC/OS-II和用户的应用代码可以定义这种类型的数据，范围从0到65,535。如果将μCO/S-II移植到32位处理器中，那就意味着INT16U不再不是一个无符号整型数据，而是一个无符号短整型数据。然而将无论μC/OS-II用到哪里，都会当作INT16U处理。 表1.1是以Borland C/C++编译器为例，为80x86提供的定义语句。为了和μC/OS兼容，还定义了BYTE,WORD,LONG以及相应的无符号变量。这使得用户可以不作任何修改就能将μC/OS的代码移植到μC/OS-II中。之所以这样做是因为笔者觉得这种新的数据类型定义有更多的灵活性，也更加易读易懂。对一些人来说，WORD意味着32位数，而此处却意味着16位数。这些新的数据类型应该能够消除此类含混不请

1.03全局变量

以下是如何定义全局变量。众所周知，全局变量应该是得到内存分配且可以被其他模块通过C语言中extern关键字调用的变量。因此，必须在 .C 和 .H 文件中定义。这种重复的定义很容易导致错误。以下讨论的方法只需用在头文件中定义一次。虽然有点不易懂,但用户一旦掌握，使用起来却很灵活。表1.2中的定义出现在定义所有全局变量的.H头文件中。

程序清单 L 1.2 定义全局宏。 #ifdef xxx_GLOBALS #define xxx_EXT #else

#define xxx_EXT extern #endif .H 文件中每个全局变量都加上了xxx_EXT的前缀。xxx代表模块的名字。该模块的.C文件中有以下定义：

#define xxx_GLOBALS #include \

当编译器处理.C文件时，它强制xxx_EXT（在相应.H文件中可以找到）为空，（因为xxx_GLOBALS已经定义）。所以编译器给每个全局变量分配内存空间，而当编译器处理其他.C文件时，xxx_GLOBAL没有定义，xxx_EXT被定义为extern，这样用户就可以调用外部全局变量。为了说明这个概念，可以参见uC/OS_II.H,其中包括以下定义：

#ifdef OS_GLOBALS

#define OS_EXT #else

#define OS_EXT extern #endif

OS_EXT INT32U OSIdleCtr; OS_EXT INT32U OSIdleCtrRun; OS_EXT INT32U OSIdleCtrMax;

同时，uCOS_II.H有中以下定义：

#define OS_GLOBALS #include ―includes.h‖

当编译器处理uCOS_II.C时，它使得头文件变成如下所示，因为OS_EXT被设置为空。

INT32U OSIdleCtr; INT32U OSIdleCtrRun; INT32U OSIdleCtrMax;

这样编译器就会将这些全局变量分配在内存中。当编译器处理其他.C文件时，头文件变成了如下的样子，因为OS_GLOBAL没有定义，所以OS_EXT被定义为extern。

extern INT32U OSIdleCtr; extern INT32U OSIdleCtrRun; extern INT32U OSIdleCtrMax;

在这种情况下，不产生内存分配，而任何 .C文件都可以使用这些变量。这样的就只需在 .H 文件中定义一次就可以了。

1.04 OS_ENTER_CRITICAL() 和 OS_EXIT_CRITICAL()

用户会看到，调用OS_ENTER_CRITICAL()和OS_EXIT_CRITICAL()两个宏，贯穿本书的所有源代码。OS_ENTER_CRITICAL() 关中断；而OS_EXIT_CRITICAL()开中断。关中断和开中断是为了保护临界段代码。这些代码很显然与处理器有关。关于宏的定义可以在OS_CPU.H中找到。9.03.02节详细讨论定义这些宏的两种方法。

程序清单 L 1.3 进入正确部分的宏。 #define OS_CRITICAL_METHOD 2

#if OS_CRITICAL_METHOD == 1

#define OS_ENTER_CRITICAL() asm CLI #define OS_EXIT_CRITICAL() asm STI #endif

#if OS_CRITICAL_METHOD == 2

#define OS_ENTER_CRITICAL() asm {PUSHF; CLI} #define OS_EXIT_CRITICAL() asm POPF #endif

用户的应用代码可以使用这两个宏来开中断和关中断。很明显，关中断会影响中断延迟，所以要特别小心。用户还可以用信号量来保护林阶段代码。 1.05基于PC的服务

PC.C 文件和 PC.H 文件（在\\SOFTWARE\\BLOCKS\\PC\\SOURCE目录下）是笔者在范例中使用到的一些基于PC的服务程序。与 μC/OS-II 以前的版本（即 μC/OS）不同，笔者希望集中这些函数以避免在各个例子中都重复定义，也更容易适应不同的编译器。PC.C包括字符显示，时间度量和其他各种服务。所有的函数都以PC_为前缀。 1.05.01字符显示

为了性能更好，显示函数直接向显示内存区中写数据。在VGA显示器中，显示内存从绝对地址

0x000B8000开始（或用段、偏移量表示则为B800:0000）。在单色显示器中，用户可以把#define constant DISP_BASE从0xB800改为0xB000。

PC.C中的显示函数用x和y坐标来直接向显示内存中写ASCII字符。PC的显示可以达到25行80列一共2,000个字符。每个字符需要两个字节来显示。第一个字节是用户想要显示的字符，第二个字节用来确定前景色和背景色。前景色用低四位来表示，背景色用第4位到6位来表示。最高位表示这个字符是否闪烁，（1）表示闪烁，（0）表示不闪烁。 用PC.H中 #defien constants定义前景和背景色，PC.C包括以下四个函数：

PC_DispClrScr() Clear the screen

PC_DispClrLine() Clear a single row (or line)

PC_DispChar() Display a single ASCII character anywhere on the screen PC_DispStr() Display an ASCII string anywhere on the screen

1.05.02花费时间的测量

时间测量函数主要用于测试一个函数的运行花了多少时间。测量时间是用PC的82C54定时器2。 被测的程序代码是放在函数PC_ElapsedStart()和PC_ElapsedStop()之间来测量的。在用这两个函数之前，应该调用PC_ElapsedInit()来初始化，它主要是计算运行这两个函数本身所附加的的时间。这样，PC_ElapsedStop()函数中返回的数值就是准确的测量结果了。注意，这两个函数都不具备可重入性，所以，必须小心，不要有多个任务同时调用这两个函数。表1.4说明了如何测量PC_DisplayChar()的执行时间。注意，时间是以uS为单位的。

程序清单 L 1.4 测量代码执行时间。 INT16U time;

PC_ElapsedInit(); . .

PC_ElapsedStart();

PC_DispChar(40, 24, ?A‘, DISP_FGND_WHITE); time = PC_ElapsedStop();

1.05.03其他函数

μC/OS-II的应用程序和其他DOS应用程序是一样的，换句话说，用户可以像在DOS下编译其他单线程的程序一样编译和链接用户程序。所生成的.EXE程序可以在DOS下装载和运行，当然应用程序应该从main（）函数开始。因为μC/OS-II 是多任务，而且为每个任务开辟一个堆栈，所以单线程的DOS环境应该保存，在退出μC/OS-II 程序时返回到DOS。调用PC_DOSSaveReturn()可以保存当前DOS环境，而调用PC_DOSReturn()可以返回到DOS。 PC.C中使用ANSI C的setjmp(),longjmp()函数来分别保存和恢复DOS环境。Borland C/C++编译库提供这些函数，多数其它的编译程序也应有这类函数。 应该注意到无论是应用程序的错误还是只调用exit(0)而没有调用PC_DOSReturn()函数都会使DOS环境被破坏，从而导致DOS或WINDOWS95下的DOS窗口崩溃。