第六章函数参考.doc

第六章?函数参考 以下部分描述RTX51 Tiny的系统函数。函数依字母顺序排列，分为以下部分： 概要（Summary） 简述程序作用，列出包含的文件，包括它的声明和原型，语法举例，和参数描述。 描述（Description）程序的详细描述，如何使用。 返回值?????????? 程序返回值说明。 参阅（see also） ?相关程序。 例子???????????? 如何正确使用该函数的程序例子中断。 附注： ???????? 以os_开头的函数可以由任务调用，但不能由中断服务程序调用。 ???????? 以isr_开头的函数可以由中断服务程序调用，但不能由任务调用。 1、irs_send_signal 概要： #includertx51tny.h ???? char isr_send_signal(unsigned char task_id); /*信号发往的任务*/ 描述： isr_send_signal函数给任务task_id发送一个信号。如果指定的任务正在等待一个信号，则该函数使该任务就绪，但不启动它，信号存储在任务的信号标志中。 附注： ???????? 该函数是RTX51 Tiny实时操作系统的一部分，仅包含于PK51中。 ???????? 该函数仅被中断函数调用。 返回值?成功调用后返回0，如果指定任务不存在，则返回-1。 参阅?? ?os_clear_signal,os_send_signal,os_wait 例子 #includertx51tny.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指定的任务置为就绪态。 附注? ???????? 该函数是RTX51 Tiny的一部分，包含在PK51中。 ???????? 该函数仅用于中断函数。 返回值??? 无 例子????? ?#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 概要?? ?#includertx51tny.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 ?????? ?#includestdio.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 task2n”); ??????????? } ??????????????? … ??????????? } 5、os_delete_task 概要???? #includertx51tn