?? os_task.lst
字號(hào):
C51 COMPILER V6.12 OS_TASK 04/12/2004 19:13:38 PAGE 10
549 4 OS_EXIT_CRITICAL();
550 4 }
551 3 return (OS_NO_ERR);
552 3 } else {
553 3 OS_EXIT_CRITICAL();
554 3 return (OS_TASK_NOT_SUSPENDED);
555 3 }
556 2 }
557 1 }
558 #endif
559 /*$PAGE*/
560 /*
561 *********************************************************************************************************
562 * STACK CHECKING
563 *
564 * Description: This function is called to check the amount of free memory left on the specified task's
565 * stack.
566 *
567 * Arguments : prio is the task priority
568 *
569 * pdata is a pointer to a data structure of type OS_STK_DATA.
570 *
571 * Returns : OS_NO_ERR upon success
572 * OS_PRIO_INVALID if the priority you specify is higher that the maximum allowed
573 * (i.e. > OS_LOWEST_PRIO) or, you have not specified OS_PRIO_SELF.
574 * OS_TASK_NOT_EXIST if the desired task has not been created
575 * OS_TASK_OPT_ERR if you did NOT specified OS_TASK_OPT_STK_CHK when the task was created
576 *********************************************************************************************************
577 */
578 #if OS_TASK_CREATE_EXT_EN
INT8U OSTaskStkChk (INT8U prio, OS_STK_DATA *ppdata) reentrant
{
OS_TCB *ptcb;
OS_STK *pchk;
INT32U free;
INT32U size;
ppdata->OSFree = 0; /* Assume failure, set to 0 size */
ppdata->OSUsed = 0;
if (prio > OS_LOWEST_PRIO && prio != OS_PRIO_SELF) { /* Make sure task priority is valid */
return (OS_PRIO_INVALID);
}
OS_ENTER_CRITICAL();
if (prio == OS_PRIO_SELF) { /* See if check for SELF */
prio = OSTCBCur->OSTCBPrio;
}
ptcb = OSTCBPrioTbl[prio];
if (ptcb == (OS_TCB *)0) { /* Make sure task exist */
OS_EXIT_CRITICAL();
return (OS_TASK_NOT_EXIST);
}
if ((ptcb->OSTCBOpt & OS_TASK_OPT_STK_CHK) == 0) { /* Make sure stack checking option is set */
OS_EXIT_CRITICAL();
return (OS_TASK_OPT_ERR);
}
free = 0;
size = ptcb->OSTCBStkSize;
pchk = ptcb->OSTCBStkBottom;
OS_EXIT_CRITICAL();
#if OS_STK_GROWTH == 1
while (*pchk++ == 0) { /* Compute the number of zero entries on the stk */
C51 COMPILER V6.12 OS_TASK 04/12/2004 19:13:38 PAGE 11
free++;
}
#else
while (*pchk-- == 0) {
free++;
}
#endif
ppdata->OSFree = free * sizeof(OS_STK); /* Compute number of free bytes on the stack */
ppdata->OSUsed = (size - free) * sizeof(OS_STK); /* Compute number of bytes used on the stack */
return (OS_NO_ERR);
}
#endif
623 /*$PAGE*/
624 /*
625 *********************************************************************************************************
626 * SUSPEND A TASK
627 *
628 * Description: This function is called to suspend a task. The task can be the calling task if the
629 * priority passed to OSTaskSuspend() is the priority of the calling task or OS_PRIO_SELF.
630 *
631 * Arguments : prio is the priority of the task to suspend. If you specify OS_PRIO_SELF, the
632 * calling task will suspend itself and rescheduling will occur.
633 *
634 * Returns : OS_NO_ERR if the requested task is suspended
635 * OS_TASK_SUSPEND_IDLE if you attempted to suspend the idle task which is not allowed.
636 * OS_PRIO_INVALID if the priority you specify is higher that the maximum allowed
637 * (i.e. >= OS_LOWEST_PRIO) or, you have not specified OS_PRIO_SELF.
638 * OS_TASK_SUSPEND_PRIO if the task to suspend does not exist
639 *
640 * Note : You should use this function with great care. If you suspend a task that is waiting for
641 * an event (i.e. a message, a semaphore, a queue ...) you will prevent this task from
642 * running when the event arrives.
643 *********************************************************************************************************
644 */
645
646 #if OS_TASK_SUSPEND_EN
647 INT8U OSTaskSuspend (INT8U prio) reentrant
648 {
649 1 BOOLEAN self;
650 1 OS_TCB *ptcb;
651 1
652 1
653 1 if (prio == OS_IDLE_PRIO) { /* Not allowed to suspend idle task */
654 2 return (OS_TASK_SUSPEND_IDLE);
655 2 }
656 1 if (prio >= OS_LOWEST_PRIO && prio != OS_PRIO_SELF) { /* Task priority valid ? */
657 2 return (OS_PRIO_INVALID);
658 2 }
659 1 OS_ENTER_CRITICAL();
660 1 if (prio == OS_PRIO_SELF) { /* See if suspend SELF */
661 2 prio = OSTCBCur->OSTCBPrio;
662 2 self = TRUE;
663 2 } else if (prio == OSTCBCur->OSTCBPrio) { /* See if suspending self */
664 2 self = TRUE;
665 2 } else {
666 2 self = FALSE; /* No suspending another task */
667 2 }
668 1 if ((ptcb = OSTCBPrioTbl[prio]) == (OS_TCB *)0) { /* Task to suspend must exist */
669 2 OS_EXIT_CRITICAL();
670 2 return (OS_TASK_SUSPEND_PRIO);
671 2 } else {
672 2 if ((OSRdyTbl[ptcb->OSTCBY] &= ~ptcb->OSTCBBitX) == 0) { /* Make task not ready */
C51 COMPILER V6.12 OS_TASK 04/12/2004 19:13:38 PAGE 12
673 3 OSRdyGrp &= ~ptcb->OSTCBBitY;
674 3 }
675 2 ptcb->OSTCBStat |= OS_STAT_SUSPEND; /* Status of task is 'SUSPENDED' */
676 2 OS_EXIT_CRITICAL();
677 2 if (self == TRUE) { /* Context switch only if SELF */
678 3 OSSched();
679 3 }
680 2 return (OS_NO_ERR);
681 2 }
682 1 }
683 #endif
684 /*$PAGE*/
685 /*
686 *********************************************************************************************************
687 * QUERY A TASK
688 *
689 * Description: This function is called to obtain a copy of the desired task's TCB.
690 *
691 * Arguments : prio is the priority of the task to obtain information from.
692 *
693 * Returns : OS_NO_ERR if the requested task is suspended
694 * OS_PRIO_INVALID if the priority you specify is higher that the maximum allowed
695 * (i.e. > OS_LOWEST_PRIO) or, you have not specified OS_PRIO_SELF.
696 * OS_PRIO_ERR if the desired task has not been created
697 *********************************************************************************************************
698 */
699
700 INT8U OSTaskQuery (INT8U prio, OS_TCB *ppdata) reentrant
701 {
702 1 OS_TCB *ptcb;
703 1
704 1
705 1 if (prio > OS_LOWEST_PRIO && prio != OS_PRIO_SELF) { /* Task priority valid ? */
706 2 return (OS_PRIO_INVALID);
707 2 }
708 1 OS_ENTER_CRITICAL();
709 1 if (prio == OS_PRIO_SELF) { /* See if suspend SELF */
710 2 prio = OSTCBCur->OSTCBPrio;
711 2 }
712 1 if ((ptcb = OSTCBPrioTbl[prio]) == (OS_TCB *)0) { /* Task to query must exist */
713 2 OS_EXIT_CRITICAL();
714 2 return (OS_PRIO_ERR);
715 2 }
716 1 *ppdata = *ptcb; /* Copy TCB into user storage area */
717 1 OS_EXIT_CRITICAL();
718 1 return (OS_NO_ERR);
719 1 }
MODULE INFORMATION: STATIC OVERLAYABLE
CODE SIZE = 2046 ----
CONSTANT SIZE = ---- ----
XDATA SIZE = ---- ----
PDATA SIZE = ---- ----
DATA SIZE = ---- ----
IDATA SIZE = ---- ----
BIT SIZE = ---- ----
END OF MODULE INFORMATION.
C51 COMPILATION COMPLETE. 2 WARNING(S), 0 ERROR(S)
?? 快捷鍵說(shuō)明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號(hào)
Ctrl + =
減小字號(hào)
Ctrl + -