RTX51 Tiny User Manual

目录

总览 (2)

实时程序 (5)

操作原理 (7)

配置RTX51 Tiny (11)

使用RTX51 Tiny (14)

实例 (17)

函数参考 (18)

总览

RTX51 Tiny是一个实时系统，它允许你创建可同时执行多个功能或任务的应用程序。在嵌入式应用中这往往是必须的。虽然可以创建无RTOS实时程序（通过执行一个或多个任务循环），但诸如调度，维护和时序问题，像RTX51 Tiny这样的RTOS可以解决。

一个实时的操作系统可以灵活的调度系统资源，像CPU、内存和任务之间的通信。RTX51 Tiny是一个功能强大且简单易用的RTOS，适用于所有8051衍生产品。

在Keil C51编译器中RTX51 Tiny是用标准C（ANSI C）编写的。C语言允许你轻松的定义任务功能而不必进行复杂的栈和变量设置。RTX51程序需要包含一个特殊的头文件且链接RTX51库到程序中。

1.新特性

RTX51 Tiny第二版包含了许多新特性使实时软件开发更容易，如下

代码分段

RTX51 Tiny现在支持代码分段（需配置文件L51_BANK.A51文件）。

明确任务切换

新功能（OS_SWITCH_TASK）可以是一个任务处于就绪状态并立即切换至另一个任务。

任务就绪标志

新的RTX51 Tiny库允许给任务设置就绪状态标志，使任务处于就绪状态，在一个时

间间隔、超时或接受到信号后恢复运行。

CPU空闲模式

RTX51 Tiny允许CPU处于空闲模式

定时器中断的用户代码支持

开发者可以添加自己的代码到RTX51 Tiny定时器中断中，也可以为自己的例程设置

和RTX51 Tiny相同的例程（需配置CONF_TNY.A51）。

支持间隔时间设置

OS_REST+INTERVAL允许开发者在混合的时间间隔和信号中调用OS_WAIT来调整超

时时间。

此外，RTX51 Tiny已被重新组合以具备灵活性、加速性以及对代码和数据空间要求更小。RTX51 Tiny第二版在显著减小代码量并具有可扩展性。

1）轮询任务切换被禁用

2）很少RTX51 Tiny系统功能被使用

3）栈检查被禁用

禁用轮询任务切换被禁用也降低了数据空间要求。

2.已解决问题

以下是RTX51 Tiny 1.06已知问题的列表，这些问题将在2.0版中得以纠正：

1）在RTX51 Tiny 1.06中，当一个中断发生在OS_WAIT中时ISR_SEND_SIGNAL会破坏”

就绪”状态，这将使任务挂起等待中断的信号，这个问题将在2.0版中得以纠正。

2）在RTX51 Tiny 1.06中，当一个信号发生时，在调用OS_WAIT时K_IVL和K_SIG不能被合并，因为间隔定时器的值不能调整。2.0版中提供OS_REST_INTERVAL例程允许开发者正确的调整间隔定时器。

3）在RTX51 Tiny 1.06中，TIMESHARING等同于轮询不能被设置为1，若是的，如果中断发生前轮询时间设置，那么轮询将被破坏和延时256个时间周期（时钟滴答次数）

而不是1，这些问题将在2.0版中得以解决。

4）在RTX51 Tiny 1.06中，当用户中断执行时间长于系统时钟周期时间，系统时钟计时器将被递归调用，这将覆盖SAVEPSW和SAVEACC值，通常会造成系统崩溃。这个问题将在2.0版中得以解决。如果你的应用程序包含了一个中断且执行时间长于系统时钟周期时间，LONG_USR_INTR配置选项值将被设置为1。如果应用程序大部分时间用于执行高优先级中断例程时，开发者需要这样设置。

3.

4.软件工具

RTX51 Tiny需要使用以下应用软件：

C51 编译器

A51 宏汇编器

BL51 链接器或LX51链接器

RTX51TINY.LIB和RTX51BT.LIB库文件必须存放在库文件（\KEIL\C51\LIB）文件夹中。

RTX51TINY.H头文件必须存放在头文件（\KEIL\C51\INC）文件夹中。

5.目标需求

5.1中断

RTX51 Tiny与中断函数一同并行工作，中断服务例程通过发送信号或设置任务”就绪”

状态标志与RTX51 Tiny任务通讯。

在RTX51 Tiny应用程序中中断例程必须被执行且可用，它们遵循一样的标准，无RTX51 Tiny应用程序没有中断服务例程管理。

RTX51 Tiny使用定时器0，定时器0中断和寄存器组1。如果开发者的程序使用定时器0,那么RTX51 Tiny将无法正常工作。开发者可以添加自己的定时器0 ISR代码到RTX51 Tiny 定时器0 ISR代码尾部（参考硬件定时器获取更多信息）。

RTX51 Tiny假设始终启用全局中断（EA = 1），RTX51 TinY需要更改中断系统状态，以确保内部没有破坏内部结构。RTX51 Tiny通过更改EA状态来启用和禁用中断，这里不保存和恢复EA，只是简单的设置和清除。如果开发者禁用中断调用RTX51 Tiny例程将无法回应。程序关键部分可能需要短时间的禁用中断，然而，你不可能在禁用中断时调用RTX51 Tiny例程，所有如果你的程序打算禁止中断，那么它因该只是暂时的。

5.2重入函数

C51编译器提供可重入函数可重入函数存储参数和本地变量在可重入栈中，使它们在递归和多重调用中被保护。RTX51 Tiny不包含任何可重入栈管理。所以如果你使用可重入函数在你的应用程序中，你必须保证这些函数不会调用RTX51 Tiny系统函数且可重入函数不会被轮询任务切换中断。

C函数当只使用寄存器参数和自动变量是真正意义上的可重入且不受任何限制的被RTX51 Tiny调用。

非可重入C函数不能被其他一些如任务或中断处理程序调用，非可重入函数存储参数和变量在静态内存段，这些可以被的同时或递归的多个任务调用所覆盖。

你可以为多个处理非重入函数，但你必须保证它们不会被同时调用。通常这意味着轮询任务调度被禁用且你的飞可重入函数不能调用RTX51 Tiny系统函数。

如果你想在你的任务或中断中处理可重入或不可重入函数时，应禁止任务轮询切换。

5.3C库例程

C51的可重入库例程可以不受任何限制的被调用。对于C51不可重入的库例程与不可重入C函数具有相同限制。

5.4多重数据指针

Keil C51编译器允许在8051系列衍伸产品中使用多重数据指针，然而，RTX51 Tiny 不提供多重数据指针管理，因此你要小心的使用。

你应该禁用轮询任务切换，如果你使用多数据指针。

5.5算数单元

Keil C51编译器允许你在8051系列衍伸产品的算数单元，然而，RTX51 Tiny不提供算数单元管理，因此你必须小心的使用。

你应该禁用任务轮询切换，如果你使用算数单元。

5.6寄存器组

RTX51 Tiny的所有任务都使用寄存器组0，处于这个原因，所有任务必须在编译时设置默认为REGISTERBANK(0)。

中断函数可能使用剩余的寄存器组，然而，RTX51 Tiny需要6字节的永久寄存器组块。可以在配置文件中设置RTX51 Tiny使用的寄存器组。

实时程序

实时程序必须快速的响应实时事件，几个事件可以方便的创建了一个没有实时系统（RTOS）的程序。随着越来越多的事件加入，程序愈发的复杂，这时一个实时系统变得越来越重要了。

1.单任务程序

嵌入式和标准C开始执行与main 函数，在嵌入式应用程序main中通常是一个死循环且连续执行的单任务。

void main(void)

{

While(1){ // repeat forever

do_samething(); //execute the do_samething task

}

}

这个例子中，do_samething函数可以被认为是一个单任务，就像只有一个任务在执行，这里不需要多任务处理能力和多任务操作系统。

2.多任务程序

更复杂的C程序的函数或任务可以在循环中实现伪多处理能力。

void main(void)

{

int counter = 0;

while (1){

check_serial_io();

process_serial_cmds();

check_kbd_io();

process_kbd_cmds();

adjust_atrlr_parms();

counter++;

}

}

3.在上面例子中，每个函数执行一个操作或任务。函数在一个接一个有顺序的执行。

4.当添加更多任务时调度开始成为一个问题。例如，如果process_kvd_cmds函数要长时间

执行，那么主函数就需要更长的周期来执行check_serial_io()函数，这样串口数据可能丢失，当然，可以在主函数循环中更频繁的调用check_serial_io()函数来解决，但最终程序将无法正常工作。

5.RTX51 Tiny程序

当你使用RTX51 Tiny时，可以在应用程序中创建一个特殊任务函数给每个任务，例如：void check_serial_io_task(void) _task_ 1

{

//this task check serial I/O

}

void process_serial_cmds_task(void) _task_ 2

{

//this task processes serial commands

}

void check_kbd_io_task(void) _task_ 3

{

// this task check keyboard commands

}

void procees_kbd_cmds_task(void) _task_ 4

{

//this task processes keyboard commands

}

void startup_task(void) _task_ 0

{

os_create_task(1); //create serial_io task

os_create_task(2); //create serial_cmds task

os_create_task(3); //create kbd_io task

os_create_task(4); //create kbd_cmds task

os_deleete_task(0); //delete the startup task

}

现在这个例子中，每个函数定义一个RTX51 Tiny任务，RTX51 Tiny没有main函数，由执行task 0lai 代替。在一个典型的应用程序中，task 0简单的创建所有其他任务。

操作原理

RTX51 Tiny使用和管理你目标系统上的资源。RTX51 Tiny需要在一个项目的基础上进行诸多配置。

1.定时器中断

RTX51 Tiny使用标准8051定时器0（模式1）来创建一个定时中断。这个中断是RTX51 Tiny 的时间计数器，RTX51 Tiny库例程的超时和间隔时间值都是由这个时间计数器来测量的。

默认情况下，RTX51时间计数器每10000个机器周期产生一个中断，因此，一个运行在12MHZ的标准8051 MCU，周期为0.01秒（12MHZ/12/10000）[注：12MHZ 每个机器周期1ns]，其值可以通过配置CONF_TNY.A51来改变。

注释：

你可以添加你自己的代码到RTX51定时计数器中断中，参考CONF_TNY.A51文件。

参考中断系统总览部分。

2.任务

RTX51 Tiny是一个最简单的任务调度者，创建一个RTX51 Tiny程序，你必须有一个以上的任务函数。接下来的信息将帮助你入门了解RTX51.

任务的定义在C语言中使用了新的关键字且被Keil C51编译器支持。

RTX51 Tiny维持每个任务在一个准确的状态（RUNNING, READY, WAITING, DELETED, TIME_OUT）

同一时间只有一个任务处于RUNNING状态，其他任务可能在READY,WAITING, or TIME_OUT

空闲任务（Idle_task）将一直处于READY状态并随时准备运行（当无任务可运行时）。

4.事件

事件在实时操作系统中常用于对程序中任务的控制。一个任务可以等待一个事件或设置事件标志给其他任务。

OS_WAIT允许一个任务等待一个活更多的事件。

TIMEOUT是一个常见事件，每个任务都可以等待，一个超时就是一个简单的时钟周期。当一个任务等待一个事件时，其他任务可以运行。一旦等待的定时器时钟周期

结束，任务可能继续运行。

INTERVAL 是一个超时数，一个间隔就像超时，除了时钟周期不同。间隔可以使用产生一个运行于一定时间内的任务，不管其任务调用时间有多长。一旦间隔时间结

束，任务将立即被运行而不是其他任务。

SIGNAL 是一个简单的任务间通讯。以个人可以等待另一个任务发送的信号。

（OS_SEND_SIGNAL 和ISR_SEND_SIGNAL）

每个任务都有一个READY标志，可以通过其他任务设置（OS_SET_READY 和ISR_SET_READY），任务在等待一个超时，间隔或信号可以通过设置其READY标志来

启动。

使用：

OS_WAIT还可以等待以下组合事件

K_SIG | K_TMO OS_WAIT 延时直到一个信号到达或超时

K_SIG | k_IVL OS_WAIT延时直到一个信号到达或间隔时间到达，这种情况下，你需要用OS_RESET_INTERVAL来消除延时问题。

K_IVL和K_TMO组合无法使用。

5.任务调度

任务调度分配处理任务，RTX51 Tiny调度决定任务运行规则。

发生如下情况当前任务将被中断:

1)任务调用OS_SWITCH_TASK且有其他任务处于READY状态准备运行。

2)任务调用OS_WAIT函数且等待时间还未到达。

3)任务执行时间已长于轮询时间片。

发生如下情况其他任务将开始运行：

1）没有其他任务在运行

2）任务处于READY状态或TIME_OUT状态

6.轮询任务切换

RTX51 Tiny可能被配置为轮询多任务（或多任务切换），轮询允许几个任务准并行执行，任务不是真的同时执行（把CPU可使用时间分为时间片，每个任务一个时间片），时间很短，所以几个任务看起来在同时执行。

任务执行时间片是持续时间，然而，RTX51 Tiny切换下一个任务处于READY状态准备运行，时间片持续时间可以通过配置RTX51 tiny来定义。

以下实例演示了一个简单的轮询多任务RTX51 Tiny程序。2个任务在程序里计数循环，RTX51 Tiny开始执行TASK0，在这里是函数JOB0，这个函数创建其他任务调用JOB1，然后JOB0执行一个个时间片，RTX51 Tiny切换到JOB1，然后JOB1执行一个时间片，RTX51 Tiny切换回JOB0，这一过程反复进行。

#include

int counter0;

int counter1;

void job0(void) _task_ 0{

os_create(1);

while(1){

counter0++;

}

}

Void job1(void) _task_ 1{

While(1){

Counter1++;

}

}

在任务等待时间片结束时，可以使用OS_WAIT和OS_SWITCH_TASK函数切换到其他任务，OS_WAIT函数暂停当前任务（设置为WAITING状态）知道特殊事件到达（这时任务改变为READY状态），这期间，其他任务可以运行。

7.同步任务切换

如果你禁用多任务轮询，你必须设计和执行你的任务时注意同步性。具体而言，你必须在你的任务某个地方调用OS_WAIT或OS_SWITCH_TASK函数，这里由RTX51 Tiny的功能函数切换到其他任务。

这2个函数不同点在于OS_WAIT等待一个事件而OS_SWITCH_TASK则马上切换到其他READY状态任务执行。

8.空闲任务

当无任务可运行时，RTX51 Tiny执行一个空闲任务，空闲任务时一个简单的无限循环，如下：

SJMP $

一些8051兼容设备提供一种空闲模式来降低功耗，通过暂停程序知道一个中断产生。

在这模式中，所有外设包括中断系统将继续执行。

RTX51 Tiny允许在空闲任务中开启空闲模式，当中断产生，微处理器恢复执行，这代码执行需要被开启且需要配置CONF_TNY.A51配置文件。

9.栈管理

RTX51 Tiny只在8051的内部存储器中维持一个栈给每个任务使用。当一个任务运行时，它拥有最大栈空间，当一个任务切换产生时，以前任务的栈缩小且转存而当前的栈扩大和转存。

？STACK符号表示栈的开始地址。在这个例子中，下方的堆栈中包括符号变量，寄存器和可位寻址内存，剩余内存为任务栈，栈顶可以在配置文件中改变。

配置RTX51 Tiny

RTX51 Tiny可以为每个应用程序定制。

1.配置

RTX51 Tiny必须被配置为你的嵌入式应用程序。所有配置均可在CONF_TNY.A51文件中找到，此文件位于\KEIL\C51\RTXTINY2\，配置选项允许如下：

指定定时器中断寄存器组

指定定时器间隔

指定用户代码在定时器中断中执行

指定轮询超时

启用/禁用轮询任务切换

指定你的应用程序包含长时间中断

指定是否实用代码分块功能

定义栈顶位置

指定最小栈空间需求

指定代码在栈错误所执行的事件

定义空闲任务操作

RTX51 Tiny库包括默认的CONF_TNY.A51配置,然而,确保你的应用程序使用配置,你必须赋值CONF_TNY.A51到你的工程文件夹并添加到工程中.

注:

如果你不包含CONF_TNY.A51配置文件在你的工程文件中,库将自动包含默认配置文件,库中存储的配置文件后续变化可能对你的应用程序操作产生不利影响.

1.1硬件定时器

以下等同于指定RTX51 Tiny的硬件定时器配置

INT_REGBANK 指定RTX51 Tiny定时器中断使用的寄存器组,默认设置为1(寄存器组1)

INT_CLOCK 指定定时器产生中断的周期,这个值从1000-65535,越小的值产生越快的中断,这个值用于计数器重载,默认值为10000.

HW_TIMER_CODE是一个宏,用来指定RTX51 Tiny定时器中断后执行的代码.默认值由中断返回,例如:

HW_TIMER_CODE MACRO ;Empty macro by default

RETI

ENDM

1.2轮询

轮询任务切换默认是开启的。以下等同于允许你配置轮询任务切换或者禁用

TIMESHARING指定每个任务运行时间，0为禁用轮询任务切换，默认设置为5时钟周期。

1.3长时间中断

一般情况下，中断服务例程（ISRs）要求很快执行完毕，有时候，中断服务程序可能需要很长一段时间。如果一个高优先级的中断执行的时间超过定时器间隔时间，RTX51 Tiny的时钟中断就可能被这个更高优先级的中断中断，并且被以后的RTX51时钟中断重入。

如果需要运行很长时间的高优先级中断，就应该考虑减少中断服务程序的工作量，改变RTX51时钟间隔或参考使用以下配置：

LONG_USR_INTR指定是否使用执行时间超过定时器间隔的中断，当这个值为1时，RTX51 Tiny就会把保护RTX51 Tiny时钟间隔中断重入代码包含进去，默认

值为0的快速中断。

1.4代码分块

以下配置选项允许你指定是否在你的应用程序中使用代码分块。

CODE_BANKING指定是否在你的应用程序中使用代码分块，这个选项必须被设置，1表示使用，0表示不使用，默认值为1（不适用代码分块功能）

注：

L51_BANK.A51版本2.2以上需要为你的程序使用代码分块功能

1.5栈

几个选项可用于栈配置，以下等同于定义内部可用内存大小和最小栈空间大小，一

个宏允许你指定在CPU没有足够的栈空间是执行的代码。

RAMTOP指定片上栈顶地址，你将不能改变这一点，除非你有栈顶符号变量，默认值为0xFF。

FREE_STACK指定最小可用栈大小，当切换到一个任务时，如果检测到可用空间少于指定值，STACK_ERROR宏将被执行，0为禁用栈检测，默认值为20字节。

STACK_ERROR是一个宏，指定如果栈错误时执行的指令。默认行为为禁用中断并且进入无限循环，如下：

STACK_ERROR MACRO

CLR EA

SJMP $

ENDM

1.6空闲任务

当没有任务可运行时，RTX51 Tiny执行一个空闲任务，这个空闲任务是一个简单的

循环且什么也不做，它只等待一个定时器间隔中断到达然后切换到其他可运行任务。

以下等同于允许你配置空闲模式：

CPU_IDLE是一个宏，指定在空闲任务中执行的代码，默认值为设置PCON寄存器的空闲标志位。

CPU_IDLE MACRO

ORL PCON,#1

ENDM

CPU_IDLE_CODE指定在空闲任务中是否执行CPU_IDLE宏，默认值为0，因此CPU_IDLE将不被包含在空闲任务中。

2.库文件

RTX51 Tiny包括2库文件：

RTX51TNY.LIB给无分块RTX51 Tiny程序使用

RTX51BT.LIB给代码分块RTX51 Tiny程序使用

RTXTINY.PRJ工程（在\KEIL\C51\RTXTINY2\SOURCECODE文件夹下）建立2个库

文件

注：

你不用包含任何库文件在你的应用程序中，当你KEIL开发环境或命令行链接器时这是自动完成的。

当你简历RTX51 Tiny库时，默认的配置文件（CONF_TNY.A51）是包含在库里面的。如果你没有包含配置文件在你的工程中，默认第一次将被包含。

后续如果配置文件产生变化将对你的应用程序操作产生不利影响。

3.优化

优化RTX51 Tiny程序方法如下：

如果可能，禁用轮询任务切换。轮询需要13个字节栈空间来存储任务上下文和所有的寄存器，如果任务切换是通过调用RTX51 Tiny库例程触发的（像OS_WAIT,OS_WSITCH_TASK），那么这些空间是不需要的。

使用OS_WAIT例程代替依靠轮询超时切换任务。这能提高系统反应时间和任务响应时间。

不要设置定时器间中断率过快。把定时器的时间设的比较短增加了每秒的时钟间隔次数可能会减少每个任务的可用时间，因为没个定时器中断使用100-200个周期执行，设置超时值足够高，以减少中断处理程序带来的影响。

最小化RTX51 Tiny内存需求，任务顺序从0开始。

使用RTX51 Tiny

使用RTX51 Tiny，你能够顺利的创建程序并编译链接它们，这通常有如下3个步骤：

1.写程序

当你写RTX51 Tiny程序时，你必须使用关键字_TASK_定义你的任务并使用内核例程。

RTX51TNY.H里面有例程原型。

1.1头文件

RTX51 Tiny要求使用一个头文件:RTX51TNY.H，所有库例程和内容都在这个头文件里面定义，你可以包含它到你的工程中：

#include

1.2编程说明

在你简历RTX51 Tiny程序时以下规矩必须遵守：

确定包含头文件RTX51TNY.H

不要建立main函数，RXTX51 Tiny有自己的main函数

程序至少包含一个以上任务

RTX Tiny程序必须开启中断（EA = 1）,小心你禁用中断的地方。

程序至少调用一个库例程，否则，链接器将不会包含RTX51 Tiny库。

TASK0是你程序中第一个执行的任务，你必须使用OS_CREATE_TASK在TASK0中调用其他任务。

你的函数必须永远不会结束或返回。你的程序必须在死循环中，使用OS_DELETE_TASK函数可以停止一个执行中的任务。

你必须制定RTX51 Tiny的开发环境或链接器命令行。

1.3定义任务

实时系统或多任务应用程序可以稳定地让一个活多个任务执行指定操作。RTX51 Tiny 支持最大16个任务。

任务时一个简单的C函数，它有void类型的返回值，void类型的参数表和使用了_task_函数属性，如下：

Void func(void) _task_ id

Func 任务函数名

_task_ id 任务号码0-15

以下定义了任务函数JOB0任务号为0：

Void job0(void) _task_ 0{

While(1){

Do_anything();

}

}

注：

1）多有任务都应该是死循环，永远不会返回

2）任务不返回值应使用VOID返回类型

3）没有参数应使用VOID类型

4）每个任务必须被分配一个唯一不变的id（0-15）

5）最小化RTX51 Tiny内存需求，任务顺序从0开始

2.编译和链接

完成RTX51 Tiny应用程序有如下2条基本途径：

2.1命令行工具

RTX51 Tiny完全集成了C51编程语言。在这里创建RTX51 Tiny程序非常容易。你只需要使用C函数而不必使用汇编语言。

在命令行编译程序：

C51 REXPROG.C DEBUG OBJECTEXTEND

在命令行链接程序：

指定在链接器命令行指示RXT51TINY

包含RTX_CONF.OBJ文件在工程文件中

BL51 RTXPROG.OBJ, RTX_CONF.OBJ RTX51TINY

2.2uVision 开发环境

在keil开发环境中创建程序：

打开操作选项”target dialog”->”target”

3.调试

Keil开发环境允许你运行和测试RTX51 Tiny应用程序，就行运行非RTX51 Tiny一样，没有特殊命令或选项。

内核探测对话框显示程序内核的各方面，在你程序中，外设菜单选项任务列表命令显示此对话框。

TID 任务ID

TASK NAME 任务函数名

STATE 当前状态

WAIT FOR EVENT 等待事件

SIG 任务信号标志

TIMER 任务超时剩余时间，仅作用于等待超时或时间间隔的任务

STACK 任务栈开始地址

实例

所有实例均在\KEIL\C51\RTXTINY2\EXAMPLES\文件夹中。

1.RTX_EX1 实例

2.RTX_EX2实例

3.交通实例

函数参考

1.ISR_SEND_SIGNAL

原型：

#include

Char isr_send_signal(unsigned char task_id);

描述：ISR_SEND_SIGNAL发送一个信号给任务TASK_ID，如果指定任务等待一个信号，那个任务将被准备执行，但不启动。否则，把信号存入指定任务信号标志位中。

这个函数是RTX51 实时操作系统PK51专业开发套件的一部分。

这个函数只能从中断函数中调用。

返回值：返回0表示成功-1表示不存在指定任务

参见：OS_CLEAR_SIGNAL OS_SEND_SIGNAL OS_WAIT

示例：

#include

Void tst_isr_send_signal(void) interrupt 2{

Isr_send_signal(8);

}

2.ISR_SET_READY

原型：

#include

Char isr_set_ready(unsigned char task_id)

描述：设置指定TASK_ID为READY状态

这个函数是RTX51 实时操作系统PK51专业开发套件的一部分。

这个函数只能从中断函数中调用。

返回值：无

示例：

#include

Void tst_isr_set_ready(void) interrupt 2{

Isr_set_ready(1);

}

3.OS_CLEAR_SIGNAL

原型：

#include

Char os_clear_signal(unsigned char task_id)

描述：清除TASK_ID信号标志位

返回值：返回值0表示清除成功-1表示指定任务不存在

示例：

#include

Void tst_os_clear_signal(void) _task_ 8

{

Os_clear_signal(5);

}

4.OS_CREAT_TASK

原型：

#include

Char os_create_task(unsigned char task_id);

描述：创建任务TASK_ID,此任务将在处于READY状态在下一个可用时间运行。

返回值：返回值0表示创建成功-1表示此任务正在运行或此任务不存在。

参见：OS_DELETE_TASK

示例：

#include

#include

Void new_task(void) _task_ 2

{

Do_something();

}

Void tst_os_create_task(void) _task_ 0

{

If(os_create_task(2)){

Printf(“couldn’t start task 2”);

}

}

5.OS_DELETE_TASK

原型：

#include

Char os_delete_task(unsigned char task_id);

描述：停止指定任务TASK_ID并从任务列表中移除

返回值：返回值0表示停止和删除成功-1 表示指定任务不存在或未开始执行

一个任务如果删除自身将立即切换任务。

示例：

#include

#include

Void tst_os_delete_task(void) _task_ 0

{

If(os_delete_task(2))

Printf(“can’t stop task 2”);

}

6.OS_RESET_INTERVAL

原型：

#include

Void os_reset_interval(unsigned char ticks);

描述：函数纠正定时器问你和重置定时器时间间隔，TICKS参数为设置定时器时间间隔当函数OS_WAIT同时等待K_IVL和K_SIG，且一个信号由OS_WAIT结束，这时定时器间隔不会被调整且随后调用OS_WAIT可能不会被正确延时。

函数纠正这个可能的问题并且随后调用如预期的OS_WAIT

实例：

#include

void task_func (void) _task_ 4 {

switch (os_wait (K_SIG | K_IVL, 100, 0)) {

case TMO_EVENT: /* Timeout occurred */

/* os_reset_interval not required */ break;

case SIG_EVENT: /* Signal received */

/* os_reset_interval required */

os_reset_interval (100); /* do something with the signal */

break; }

}

7.OS_RUNNING_TASK_ID

原型：

#include

Char os_running_task_id(void);

描述：函数确定当前执行的任务id

返回值：返回当前正在执行的任务id，范围0-15

实例：

#include

void tst_os_running_task (void) _task_ 3

{

unsigned char tid;

tid = os_running_task_id (); /* tid = 3 */

}

8.OS_SEND_SIGNAL

原型：

#include

Char os_send_signal(char task_id);

描述：ISR_SEND_SIGNAL发送一个信号给任务TASK_ID，如果指定任务等待一个信号，那个任务将被准备执行，但不启动。否则，把信号存入指定任务信号标志位中。

返回值：返回0表示成功-1表示不存在指定任务

示例：

#include

Void tst_os_send_signal(void) _task_ 2{

os_send_signal(3);

}

9.OS_SET_READY

原型：

#include

Char os_set_ready(unsigned char task_id);

描述：函数设置任务处于READY状态

返回值：无

示例：

#include

void ready_func (void) _task_ 2{

os_set_ready (1); /* Set ready flag for task 1 */