RTX51 Tiny 2.02 中文手册 part6[转贴]
原贴地址:http://blog.ednchina.com/roumao/147030/message.aspx第六章
函数参考
以下部分描述RTX51 Tiny的系统函数。函数依字母顺序排列，分为以下部分：
概要（Summary） 简述程序作用，列出包含的文件，包括它的声明和原型，语法举例，和参数描述。
描述（Description）程序的详细描述，如何使用。
返回值
程序返回值说明。
参阅（see also）
相关程序。
例子
如何正确使用该函数的程序例子中断。
附注：
l
以os_开头的函数可以由任务调用，但不能由中断服务程序调用。
l
以isr_开头的函数可以由中断服务程序调用，但不能由任务调用。
1、irs_send_signal
概要： #include<rtx51tny.h>
char isr_send_signal(unsigned char task_id); /*信号发往的任务*/
描述： isr_send_signal函数给任务task_id发送一个信号。如果指定的任务正在等待一个信号，则该函数使该任务就绪，但不启动它，信号存储在任务的信号标志中。
附注：
l
该函数是RTX51 Tiny实时操作系统的一部分，仅包含于PK51中。
l
该函数仅被中断函数调用。
返回值
成功调用后返回0，如果指定任务不存在，则返回-1。
参阅
os_clear_signal,os_send_signal,os_wait
例子
#include<rtx51tny.h>
void tst_isr_send_signal(void) interrupt 2
{
isr_send_signal(8); /*给任务8发信号*/
}
2、irs_set_ready
概要
#include< rtx51tny.h>
char isr_set_ready{ unsigned char task_id};/*使就绪的任务*/
描述
将由task_id指定的任务置为就绪态。
附注
l
该函数是RTX51 Tiny的一部分，包含在PK51中。
l
该函数仅用于中断函数。
返回值
无
例子
#include< rtx51tny.h>
void tst_isr_set_ready(void)interrupt 2
{ isr_set_ready(1);/*置位任务1的就绪标志*/
}
3、os_clear_signal
概要
#include< rtx51tny.h>
char os_clesr_signal(unsigned cahr task_id);/*清除信号的任务*/
描述
清除由task_id指定的任务信号标志。
附注： 该函数是RTX51 Tiny的一部分，包含在PK51中。
返回值
信号成功清除后返回0，指定的任务不存在时返回-1。
参阅
isr_send_signal,os_send_signal,os_wait
例子
#include< rtx51tny.h>
void tst_os_clsar_siganl(void)_task_8
{
…
os_clear_signal(5);
/*清除任务5的信号标志*/
…
}
4、os_create_task
概要
#include<rtx51tny.h>
char os_create_task(unsigned char task_id);/*要启动的任务ID*/
描述
启动任务task_id，该任务被标记为就绪，并在下一个时间点开始执行。
附注：
该函数是包含在PK51中的RTX51 Tiny的组成部分。
返回值
任务成功启动后返回0，如果任务不能启动或任务已在运行，或没有以task_id定义的任务，返回-1。
参阅
os_delete_task
例子
#include< rtx51tny.h>
#include<stdio.h>
/*用于printf*/
void new_task(void)_task_2
{…}
void tst_os_create_task(void)_task_0
{
…
if(os_create_task(2))
{
printf(“couldn’t start task2\n”);
}
…
}
5、os_delete_task
概要
#include<rtx51tny.h>
char os_delete_task(unsigned char task_id);/*要删除的任务*/
描述
函数将以task_id指定的任务停止，并从任务列表中将其删除。
附注
该函数是包含在PK51中的RTX51 Tiny的组成部分。
返回值
任务成功停止并删除后返回0。指定任务不存在或未启动时返回-1。
附注
如果任务删除自己，将立即发生任务切换。
参阅
os_create_task
例子
#include<rtx51tny.h>
#include<stdio.h>
void tst_os_delete_task(void)_task_0
{
…
if(os_delete_task(2))
{
printf(“couldn’t stop task2\n”);
}
…
}
6、os_reset_interval
概要
#include<rtx51tny.h>
void os_reset_interval(unsigned char ticks); /*滴答数*/
描述
用于纠正由于os_wait函数同时等待K_IVL和K_SIG事件而产生的时间问题，在这种情况下，如果一个信号事件（K_SIG）引起os_wait退出，时间间隔定时器并不调整，这样，会导致后续的os_wait调用（等待一个时间间隔）延迟的不是预期的时间周期。允许你将时间间隔定时器复位，这样，后续对os_wait的调用就会按预期的操作进行。
附注： 该函数是包含在PK51中的RTX51 Tiny的组成部分。
返回值
无
例子
#include<rtx51tny.h>
void task_func(void)_task_4
{
…
switch(os_wait2(KSIG|K_IVL,100))
{
case
TMO_EVENT:
/*发生了超时，不需要Os_reset_interval*/
break;
case
SIG_EVCENT:
/*收到信号，需要Os_reset_interval*/
os_reset_interval(100);
/*依信号执行的其它操作*/
break;
}
…
}
7、os_running_task_id
概要
#include<rtx51tny.h>
char os_running_task_id(void);
描述
函数确认当前正在执行的任务的任务ID。
附注： 该函数是包含在PK51中的RTX51 Tiny的组成部分。
返回值 返回当前正在执行的任务的任务号，该值为0~15之间的一个数。
例子
#include<rtx51tny.h>
void tst_os_running_task(void)_task_3
{
unsigned char tid;
tid=os_running_task_id( ); /*tid=3*/
}
8、os_send_signal
概要
#include<rtx51tny.h>
char os_send_signal(char task_id);/*信号发往的任务*/
描述
函数向任务task_id发送一个信号。如果指定的任务已经在等待一个信号，则该函数使任务准备执行但不启动它。信号存储在任务的信号标志中。
附注
该函数是包含在PK51中的RTX51 Tiny的组成部分。
返回值 成功调用后返回0，指定任务不存在时返回-1。
参阅
isr_send_signal,os_clear_signal,os_wait
#include<rtx51tny.h>
void signal_func(void)_task_2
{
…
os_send_signal(8);
/*向8号任务发信号*/
…
}
void tst_os_send_signal(void)_task_8
{
…
os_send_signal(2);
/*向2号任务发信号*/
…
}
9、
os_set_ready
概要
#include<rtx51tny.h>
char os_set_ready(unsigned char task_id);/*使就绪的任务*/
描述
将以task_id指定的任务置为就绪状态。
附注： 该函数是包含在PK51中的RTX51 Tiny的组成部分。
返回值 无
例子
#include<rtx51tny.h>
void ready_func(void)_task_2
{
…
os_set_ready(1);
/*置位任务1的就绪标志*/
…
}
10、
os_switch_task
概要
#include<rtx51tny.h>
char os_switch_task(void);
描述
该函数允许一个任务停止执行，并运行另一个任务。如果调用os_switch_task的任务是唯一的就绪任务，它将立即恢复运行。
附注：
该函数是包含在PK51中的RTX51 Tiny的组成部分。
返回值
无
例子
#include<rtx51tny.h>
#include<stdio>
void long_job(void)_task_1
{
float f1,f2;
f1=0.0;
while(1)
{
f2=log(f1);
f1+=0.0001;
os_switch_task();
/*运行其它任务*/
}
}
11、os_wait
概要
#include<rtx51tny.h>
char os_wait(
unsigned char event_sel,
/*要等待的事件*/
unsigned char ticks,
/*要等待的滴答数*/
unsigned int
dammy);
/*无用参数*/
描述
该函数挂起当前任务，并等待一个或几个事件，如时间间隔，超时，或从其它任务和中断发来的信号。参数event_set指定要等待的事件，可以是下表中常数的一些组合。
事
件
描
述
K_IVL
等待滴答值为单位的时间间隔
K_SIG
等待一个信号
K_TMO
等待一个以滴答值为单位的超时
事件可以用竖线符（“|”）进行逻辑或。例如，K_TMO1K_SIG指定任务等待一个超时或者一个信号。
ticks参数指定要等待的时间间隔事件(K_IVL)或超时事件(K_TMO)的定时器滴答数。参数是为了提供与兼容性而设置的，在中并不使用。
附注
l
该函数是包含在PK中的RTX51 Tiny的组成部分。
l
请参阅事件一节获得关于K_IVL,K_SIG,K_TMO的更多信息。
返回值 当有一个指定的事件发生时，任务进入就绪态。任务恢复执行时，下表列出的由返回的常数指出使任务重新启动的事件。可能的返回值有：
返 回 值
描
述
RDY_EVENT
表示任务的就绪标志是被或函数置位的。
SIG_EVENT
收到一个信号
TMO_EVENT
超时完成，或时间间隔到
NOT_OK
参数的值无效
参阅
isr_send_signal,isr_set_ready,os_clear_signal,os_reset_interval,
os_send_signal,os_set_ready,os_wait1,os_wait2
例子
#include<rtx51tny.h>
#include<stdio.h>
void tst_os_wait(void)_task_9
{
while(1)
{
char event;
event=os_wait(K_SIG|K_TMO,50.0);
switch(event)
{
default:
/*从不发生，该情况*/
break;
case
TMO_EVENT;/*超时*/
break;
/*50次滴答超时*/
case
SIG_EVENT; /*收到信号*/
break;
}
}
}
12、os_wait1
概要
#include<rtx51tny.h>
char os_wait1(unsigned
char
event_sel);/*要等待的事件*/
描述
该函数挂起当前的任务等待一个事件发生。os_wait1是os_wait的一个子集，它不支持os_wait提供的全部事件。参数event_sel指定要等待的事件，该函数只能是K_SIG。
附注：
l
该函数是包含于PK51中的RTX51Tiny的组成部分。
l
参见事件一节获得K_IVL，K_SIG和K_TMO的更多信息。
返回值
当指定的事件发生，任务进入就绪态。任务恢复运行时，os_wait1
返回的值表明启动任务的事件，返回值见下面的常数列表：
返 回 值
RDY_EVENT
任务的就绪标志位是被os_set_ready或isr_set_ready置位的
SIG_EVENT
收到一个信号
NOT_OK
Event_sel参数的值无效
例子
见os_wait
13、os_wait2
概要
#include<rtx51tny.h>
char os_wait2(unsigned char event_sel,
/*要等待的事件*/
unsigned char ticks);
/*要等待的滴答数*/
描述
函数挂起当前任务等待一个或几个事件发生，如时间间隔，超时或一个从其它任务或中断来的信号。参数event_sel指定的事件可以是下列常数的组合：
Event
描 述
K_IVL
等待以滴答数为单位的时间间隔
K_SIG
等待一个信号
K_TMO
等待以滴答数为单位的超时
事件可以用“|”进行逻辑或。如K_TMO|K_SIG表示任务等待一个超时或一个信号。
参数ticks 指定等待时间间隔(K_IVL)或超时(K_TMO)事件时的滴答数。
附注：
l
该函数是包含于PK51中的RTX51Tiny的组成部分。
l
参见事件一节获得更多关于K_IVL, K_TMO,和K_SIG的信息。
返回值
当一个或几个事件产生时,任务进入就绪态.任务恢复执行时, os_wait2的返回值见下面的常数列表：
返
回
值
描
述
RDY_EVENT
任务的就绪标志是被os_set_ready或isr_set_ready函数置位的
SIG_EVENT
收到一个信号
TMO_EVENT
返回时完成,或时间间隔到达
NOT_OK
参数event_sel的值无效
例子
见os_wait。
页:
[1]