📄 os_task.lst
字号:
}
#endif
581 /*$PAGE*/
582 /*
583 *********************************************************************************************************
584 * STACK CHECKING
585 *
586 * Description: This function is called to check the amount of free memory left on the specified task's
587 * stack.
588 *
589 * Arguments : prio is the task priority
590 *
591 * pdata is a pointer to a data structure of type OS_STK_DATA.
592 *
593 * Returns : OS_NO_ERR upon success
594 * OS_PRIO_INVALID if the priority you specify is higher that the maximum allowed
595 * (i.e. > OS_LOWEST_PRIO) or, you have not specified OS_PRIO_SELF.
596 * OS_TASK_NOT_EXIST if the desired task has not been created
597 * OS_TASK_OPT_ERR if you did NOT specified OS_TASK_OPT_STK_CHK when the task was created
598 *********************************************************************************************************
599 */
600 #if OS_TASK_CREATE_EXT_EN > 0
INT8U OSTaskStkChk (INT8U prio, OS_STK_DATA *pdata)
{
#if OS_CRITICAL_METHOD == 3 /* Allocate storage for CPU status register */
OS_CPU_SR cpu_sr;
#endif
OS_TCB *ptcb;
OS_STK *pchk;
INT32U free;
INT32U size;
#if OS_ARG_CHK_EN > 0
C51 COMPILER V9.01 OS_TASK 10/31/2012 17:19:07 PAGE 11
if (prio > OS_LOWEST_PRIO && prio != OS_PRIO_SELF) { /* Make sure task priority is valid */
return (OS_PRIO_INVALID);
}
#endif
pdata->OSFree = 0; /* Assume failure, set to 0 size */
pdata->OSUsed = 0;
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++ == (OS_STK)0) { /* Compute the number of zero entries on the stk */
free++;
}
#else
while (*pchk-- == (OS_STK)0) {
free++;
}
#endif
pdata->OSFree = free * sizeof(OS_STK); /* Compute number of free bytes on the stack */
pdata->OSUsed = (size - free) * sizeof(OS_STK); /* Compute number of bytes used on the stack */
return (OS_NO_ERR);
}
#endif
650 /*$PAGE*/
651 /*
652 *********************************************************************************************************
653 * SUSPEND A TASK
654 *
655 * Description: This function is called to suspend a task. The task can be the calling task if the
656 * priority passed to OSTaskSuspend() is the priority of the calling task or OS_PRIO_SELF.
657 *
658 * Arguments : prio is the priority of the task to suspend. If you specify OS_PRIO_SELF, the
659 * calling task will suspend itself and rescheduling will occur.
660 *
661 * Returns : OS_NO_ERR if the requested task is suspended
662 * OS_TASK_SUSPEND_IDLE if you attempted to suspend the idle task which is not allowed.
663 * OS_PRIO_INVALID if the priority you specify is higher that the maximum allowed
664 * (i.e. >= OS_LOWEST_PRIO) or, you have not specified OS_PRIO_SELF.
665 * OS_TASK_SUSPEND_PRIO if the task to suspend does not exist
666 *
667 * Note : You should use this function with great care. If you suspend a task that is waiting for
668 * an event (i.e. a message, a semaphore, a queue ...) you will prevent this task from
669 * running when the event arrives.
670 *********************************************************************************************************
671 */
672
673 #if OS_TASK_SUSPEND_EN > 0
INT8U OSTaskSuspend (INT8U prio)
C51 COMPILER V9.01 OS_TASK 10/31/2012 17:19:07 PAGE 12
{
#if OS_CRITICAL_METHOD == 3 /* Allocate storage for CPU status register */
OS_CPU_SR cpu_sr;
#endif
BOOLEAN self;
OS_TCB *ptcb;
#if OS_ARG_CHK_EN > 0
if (prio == OS_IDLE_PRIO) { /* Not allowed to suspend idle task */
return (OS_TASK_SUSPEND_IDLE);
}
if (prio >= OS_LOWEST_PRIO && prio != OS_PRIO_SELF) { /* Task priority valid ? */
return (OS_PRIO_INVALID);
}
#endif
OS_ENTER_CRITICAL();
if (prio == OS_PRIO_SELF) { /* See if suspend SELF */
prio = OSTCBCur->OSTCBPrio;
self = TRUE;
} else if (prio == OSTCBCur->OSTCBPrio) { /* See if suspending self */
self = TRUE;
} else {
self = FALSE; /* No suspending another task */
}
ptcb = OSTCBPrioTbl[prio];
if (ptcb == (OS_TCB *)0) { /* Task to suspend must exist */
OS_EXIT_CRITICAL();
return (OS_TASK_SUSPEND_PRIO);
}
if ((OSRdyTbl[ptcb->OSTCBY] &= ~ptcb->OSTCBBitX) == 0x00) { /* Make task not ready */
OSRdyGrp &= ~ptcb->OSTCBBitY;
}
ptcb->OSTCBStat |= OS_STAT_SUSPEND; /* Status of task is 'SUSPENDED' */
OS_EXIT_CRITICAL();
if (self == TRUE) { /* Context switch only if SELF */
OS_Sched();
}
return (OS_NO_ERR);
}
#endif
716 /*$PAGE*/
717 /*
718 *********************************************************************************************************
719 * QUERY A TASK
720 *
721 * Description: This function is called to obtain a copy of the desired task's TCB.
722 *
723 * Arguments : prio is the priority of the task to obtain information from.
724 *
725 * Returns : OS_NO_ERR if the requested task is suspended
726 * OS_PRIO_INVALID if the priority you specify is higher that the maximum allowed
727 * (i.e. > OS_LOWEST_PRIO) or, you have not specified OS_PRIO_SELF.
728 * OS_PRIO_ERR if the desired task has not been created
729 *********************************************************************************************************
730 */
731
732 #if OS_TASK_QUERY_EN > 0
INT8U OSTaskQuery (INT8U prio, OS_TCB *pdata)
{
#if OS_CRITICAL_METHOD == 3 /* Allocate storage for CPU status register */
OS_CPU_SR cpu_sr;
C51 COMPILER V9.01 OS_TASK 10/31/2012 17:19:07 PAGE 13
#endif
OS_TCB *ptcb;
#if OS_ARG_CHK_EN > 0
if (prio > OS_LOWEST_PRIO && prio != OS_PRIO_SELF) { /* Task priority valid ? */
return (OS_PRIO_INVALID);
}
#endif
OS_ENTER_CRITICAL();
if (prio == OS_PRIO_SELF) { /* See if suspend SELF */
prio = OSTCBCur->OSTCBPrio;
}
ptcb = OSTCBPrioTbl[prio];
if (ptcb == (OS_TCB *)0) { /* Task to query must exist */
OS_EXIT_CRITICAL();
return (OS_PRIO_ERR);
}
memcpy(pdata, ptcb, sizeof(OS_TCB)); /* Copy TCB into user storage area */
OS_EXIT_CRITICAL();
return (OS_NO_ERR);
}
#endif
MODULE INFORMATION: STATIC OVERLAYABLE
CODE SIZE = 859 ----
CONSTANT SIZE = ---- ----
XDATA SIZE = ---- 18
PDATA SIZE = ---- ----
DATA SIZE = ---- ----
IDATA SIZE = ---- ----
BIT SIZE = ---- ----
END OF MODULE INFORMATION.
C51 COMPILATION COMPLETE. 0 WARNING(S), 0 ERROR(S)
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -