开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 嵌入式/单片机编程 > uCOS > 查看源码
UCOS_II.H
资源名称：uCOS-II.rar　[点击查看]
上传用户：jinguanrq
上传日期：2022-06-04
资源大小：724k
文件大小：22k
源码类别：

uCOS

开发平台：

C/C++

UCOS_II.H：源码内容
  1. /*
  2. *********************************************************************************************************
  3. *                                                uC/OS-II
  4. *                                          The Real-Time Kernel
  5. *
  6. *                        (c) Copyright 1992-1998, Jean J. Labrosse, Plantation, FL
  7. *                                           All Rights Reserved
  8. *
  9. *                                                  V2.00
  10. *
  11. * File : uCOS_II.H
  12. * By   : Jean J. Labrosse
  13. *********************************************************************************************************
  14. */
  16. /*
  17. *********************************************************************************************************
  18. *                                             MISCELLANEOUS
  19. *********************************************************************************************************
  20. */
  22. #define  OS_VERSION              200   /* Version of uC/OS-II (Vx.yy multiplied by 100)                */
  24. #ifdef   OS_GLOBALS
  25. #define  OS_EXT
  26. #else
  27. #define  OS_EXT  extern
  28. #endif
  30. #define  OS_PRIO_SELF           0xFF   /* Indicate SELF priority                                       */
  32. #if      OS_TASK_STAT_EN
  33. #define  OS_N_SYS_TASKS            2                    /* Number of system tasks                      */
  34. #else
  35. #define  OS_N_SYS_TASKS            1
  36. #endif
  38. #define  OS_STAT_PRIO       (OS_LOWEST_PRIO - 1)        /* Statistic task priority                     */
  39. #define  OS_IDLE_PRIO       (OS_LOWEST_PRIO)            /* IDLE      task priority                     */
  41. #define  OS_EVENT_TBL_SIZE ((OS_LOWEST_PRIO) / 8 + 1)   /* Size of event table                         */
  42. #define  OS_RDY_TBL_SIZE   ((OS_LOWEST_PRIO) / 8 + 1)   /* Size of ready table                         */
  44. #define  OS_TASK_IDLE_ID       65535   /* I.D. numbers for Idle and Stat tasks                         */
  45. #define  OS_TASK_STAT_ID       65534
  47.                                        /* TASK STATUS (Bit definition for OSTCBStat)                   */
  48. #define  OS_STAT_RDY            0x00   /* Ready to run                                                 */
  49. #define  OS_STAT_SEM            0x01   /* Pending on semaphore                                         */
  50. #define  OS_STAT_MBOX           0x02   /* Pending on mailbox                                           */
  51. #define  OS_STAT_Q              0x04   /* Pending on queue                                             */
  52. #define  OS_STAT_SUSPEND        0x08   /* Task is suspended                                            */
  54. #define  OS_EVENT_TYPE_MBOX        1
  55. #define  OS_EVENT_TYPE_Q           2
  56. #define  OS_EVENT_TYPE_SEM         3
  58.                                        /* TASK OPTIONS (see OSTaskCreateExt())                         */
  59. #define  OS_TASK_OPT_STK_CHK  0x0001   /* Enable stack checking for the task                           */
  60. #define  OS_TASK_OPT_STK_CLR  0x0002   /* Clear the stack when the task is create                      */
  61. #define  OS_TASK_OPT_SAVE_FP  0x0004   /* Save the contents of any floating-point registers            */
  64. #ifndef  FALSE
  65. #define  FALSE                     0
  66. #endif
  68. #ifndef  TRUE
  69. #define  TRUE                      1
  70. #endif
  72. /*
  73. *********************************************************************************************************
  74. *                                              ERROR CODES
  75. *********************************************************************************************************
  76. */
  78. #define OS_NO_ERR                 0
  79. #define OS_ERR_EVENT_TYPE         1
  80. #define OS_ERR_PEND_ISR           2
  82. #define OS_TIMEOUT               10
  83. #define OS_TASK_NOT_EXIST        11
  85. #define OS_MBOX_FULL             20
  87. #define OS_Q_FULL                30
  89. #define OS_PRIO_EXIST            40
  90. #define OS_PRIO_ERR              41
  91. #define OS_PRIO_INVALID          42
  93. #define OS_SEM_OVF               50
  95. #define OS_TASK_DEL_ERR          60
  96. #define OS_TASK_DEL_IDLE         61
  97. #define OS_TASK_DEL_REQ          62
  98. #define OS_TASK_DEL_ISR          63
  100. #define OS_NO_MORE_TCB           70
  102. #define OS_TIME_NOT_DLY          80
  103. #define OS_TIME_INVALID_MINUTES  81
  104. #define OS_TIME_INVALID_SECONDS  82
  105. #define OS_TIME_INVALID_MILLI    83
  106. #define OS_TIME_ZERO_DLY         84
  108. #define OS_TASK_SUSPEND_PRIO     90
  109. #define OS_TASK_SUSPEND_IDLE     91
  111. #define OS_TASK_RESUME_PRIO     100
  112. #define OS_TASK_NOT_SUSPENDED   101
  114. #define OS_MEM_INVALID_PART     110
  115. #define OS_MEM_INVALID_BLKS     111
  116. #define OS_MEM_INVALID_SIZE     112
  117. #define OS_MEM_NO_FREE_BLKS     113
  118. #define OS_MEM_FULL             114
  120. #define OS_TASK_OPT_ERR         130
  122. /*$PAGE*/
  123. /*
  124. *********************************************************************************************************
  125. *                                          EVENT CONTROL BLOCK
  126. *********************************************************************************************************
  127. */
  129. #if (OS_MAX_EVENTS >= 2)
  130. typedef struct {
  131.     void   *OSEventPtr;                    /* Pointer to message or queue structure                    */
  132.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE]; /* List of tasks waiting for event to occur                 */
  133.     INT16U  OSEventCnt;                    /* Count of used when event is a semaphore                  */
  134.     INT8U   OSEventType;                   /* OS_EVENT_TYPE_MBOX, OS_EVENT_TYPE_Q or OS_EVENT_TYPE_SEM */
  135.     INT8U   OSEventGrp;                    /* Group corresponding to tasks waiting for event to occur  */
  136. } OS_EVENT;
  137. #endif
  139. /*$PAGE*/
  140. /*
  141. *********************************************************************************************************
  142. *                                          MESSAGE MAILBOX DATA
  143. *********************************************************************************************************
  144. */
  146. #if OS_MBOX_EN
  147. typedef struct {
  148.     void   *OSMsg;                         /* Pointer to message in mailbox                            */
  149.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE]; /* List of tasks waiting for event to occur                 */
  150.     INT8U   OSEventGrp;                    /* Group corresponding to tasks waiting for event to occur  */
  151. } OS_MBOX_DATA;
  152. #endif
  154. /*
  155. *********************************************************************************************************
  156. *                                     MEMORY PARTITION DATA STRUCTURES
  157. *********************************************************************************************************
  158. */
  160. #if OS_MEM_EN && (OS_MAX_MEM_PART >= 2)
  161. typedef struct {                       /* MEMORY CONTROL BLOCK                                         */
  162.     void   *OSMemAddr;                 /* Pointer to beginning of memory partition                     */
  163.     void   *OSMemFreeList;             /* Pointer to list of free memory blocks                        */
  164.     INT32U  OSMemBlkSize;              /* Size (in bytes) of each block of memory                      */
  165.     INT32U  OSMemNBlks;                /* Total number of blocks in this partition                     */
  166.     INT32U  OSMemNFree;                /* Number of memory blocks remaining in this partition          */
  167. } OS_MEM;
  170. typedef struct {
  171.     void   *OSAddr;                    /* Pointer to the beginning address of the memory partition     */
  172.     void   *OSFreeList;                /* Pointer to the beginning of the free list of memory blocks   */
  173.     INT32U  OSBlkSize;                 /* Size (in bytes) of each memory block                         */
  174.     INT32U  OSNBlks;                   /* Total number of blocks in the partition                      */
  175.     INT32U  OSNFree;                   /* Number of memory blocks free                                 */
  176.     INT32U  OSNUsed;                   /* Number of memory blocks used                                 */
  177. } OS_MEM_DATA;
  178. #endif
  180. /*$PAGE*/
  181. /*
  182. *********************************************************************************************************
  183. *                                          MESSAGE QUEUE DATA
  184. *********************************************************************************************************
  185. */
  187. #if OS_Q_EN
  188. typedef struct {
  189.     void   *OSMsg;                          /* Pointer to next message to be extracted from queue      */
  190.     INT16U  OSNMsgs;                        /* Number of messages in message queue                     */
  191.     INT16U  OSQSize;                        /* Size of message queue                                   */
  192.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  193.     INT8U   OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  194. } OS_Q_DATA;
  195. #endif
  197. /*
  198. *********************************************************************************************************
  199. *                                           SEMAPHORE DATA
  200. *********************************************************************************************************
  201. */
  203. #if OS_SEM_EN
  204. typedef struct {
  205.     INT16U  OSCnt;                          /* Semaphore count                                         */
  206.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  207.     INT8U   OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  208. } OS_SEM_DATA;
  209. #endif
  211. /*
  212. *********************************************************************************************************
  213. *                                            TASK STACK DATA
  214. *********************************************************************************************************
  215. */
  217. #if OS_TASK_CREATE_EXT_EN
  218. typedef struct {
  219.     INT32U  OSFree;                    /* Number of free bytes on the stack                            */
  220.     INT32U  OSUsed;                    /* Number of bytes used on the stack                            */
  221. } OS_STK_DATA;
  222. #endif
  224. /*$PAGE*/
  225. /*
  226. *********************************************************************************************************
  227. *                                          TASK CONTROL BLOCK
  228. *********************************************************************************************************
  229. */
  231. typedef struct os_tcb {
  232.     OS_STK        *OSTCBStkPtr;        /* Pointer to current top of stack                              */
  234. #if OS_TASK_CREATE_EXT_EN    
  235.     void          *OSTCBExtPtr;        /* Pointer to user definable data for TCB extension             */
  236.     OS_STK        *OSTCBStkBottom;     /* Pointer to bottom of stack                                   */
  237.     INT32U         OSTCBStkSize;       /* Size of task stack (in bytes)                                */
  238.     INT16U         OSTCBOpt;           /* Task options as passed by OSTaskCreateExt()                  */
  239.     INT16U         OSTCBId;            /* Task ID (0..65535)                                           */
  240. #endif
  242.     struct os_tcb *OSTCBNext;          /* Pointer to next     TCB in the TCB list                      */
  243.     struct os_tcb *OSTCBPrev;          /* Pointer to previous TCB in the TCB list                      */
  245. #if (OS_Q_EN && (OS_MAX_QS >= 2)) || OS_MBOX_EN || OS_SEM_EN
  246.     OS_EVENT      *OSTCBEventPtr;      /* Pointer to event control block                               */
  247. #endif
  249. #if (OS_Q_EN && (OS_MAX_QS >= 2)) || OS_MBOX_EN
  250.     void          *OSTCBMsg;           /* Message received from OSMboxPost() or OSQPost()              */
  251. #endif    
  253.     INT16U         OSTCBDly;           /* Nbr ticks to delay task or, timeout waiting for event        */
  254.     INT8U          OSTCBStat;          /* Task status                                                  */
  255.     INT8U          OSTCBPrio;          /* Task priority (0 == highest, 63 == lowest)                   */
  257.     INT8U          OSTCBX;             /* Bit position in group  corresponding to task priority (0..7) */
  258.     INT8U          OSTCBY;             /* Index into ready table corresponding to task priority        */
  259.     INT8U          OSTCBBitX;          /* Bit mask to access bit position in ready table               */
  260.     INT8U          OSTCBBitY;          /* Bit mask to access bit position in ready group               */
  261.     
  262. #if OS_TASK_DEL_EN    
  263.     BOOLEAN        OSTCBDelReq;        /* Indicates whether a task needs to delete itself              */
  264. #endif
  265. } OS_TCB;
  267. /*$PAGE*/
  268. /*
  269. *********************************************************************************************************
  270. *                                            GLOBAL VARIABLES
  271. *********************************************************************************************************
  272. */
  273.                                        
  274. OS_EXT  INT32U       OSCtxSwCtr;               /* Counter of number of context switches                */
  276. #if     (OS_MAX_EVENTS >= 2)
  277. OS_EXT  OS_EVENT    *OSEventFreeList;          /* Pointer to list of free EVENT control blocks         */
  278. OS_EXT  OS_EVENT     OSEventTbl[OS_MAX_EVENTS];/* Table of EVENT control blocks                        */
  279. #endif
  281. OS_EXT  INT32U       OSIdleCtr;                /* Idle counter                                         */
  283. #if     OS_TASK_STAT_EN
  284. OS_EXT  INT8S        OSCPUUsage;               /* Percentage of CPU used                               */
  285. OS_EXT  INT32U       OSIdleCtrMax;             /* Maximum value that idle counter can take in 1 sec.   */
  286. OS_EXT  INT32U       OSIdleCtrRun;             /* Value reached by idle counter at run time in 1 sec.  */
  287. OS_EXT  BOOLEAN      OSStatRdy;                /* Flag indicating that the statistic task is ready     */
  288. #endif
  290. OS_EXT  INT8U        OSIntNesting;             /* Interrupt nesting level                              */
  292. OS_EXT  INT8U        OSLockNesting;            /* Multitasking lock nesting level                      */
  294. OS_EXT  INT8U        OSPrioCur;                /* Priority of current task                             */
  295. OS_EXT  INT8U        OSPrioHighRdy;            /* Priority of highest priority task                    */
  297. OS_EXT  INT8U        OSRdyGrp;                        /* Ready list group                              */
  298. OS_EXT  INT8U        OSRdyTbl[OS_RDY_TBL_SIZE];       /* Table of tasks which are ready to run         */
  300. OS_EXT  BOOLEAN      OSRunning;                       /* Flag indicating that kernel is running        */
  302. #if     OS_TASK_CREATE_EN  || OS_TASK_CREATE_EXT_EN || OS_TASK_DEL_EN
  303. OS_EXT  INT8U        OSTaskCtr;                       /* Number of tasks created                       */
  304. #endif
  306. OS_EXT  OS_TCB      *OSTCBCur;                        /* Pointer to currently running TCB              */
  307. OS_EXT  OS_TCB      *OSTCBFreeList;                   /* Pointer to list of free TCBs                  */
  308. OS_EXT  OS_TCB      *OSTCBHighRdy;                    /* Pointer to highest priority TCB ready to run  */
  309. OS_EXT  OS_TCB      *OSTCBList;                       /* Pointer to doubly linked list of TCBs         */
  310. OS_EXT  OS_TCB      *OSTCBPrioTbl[OS_LOWEST_PRIO + 1];/* Table of pointers to created TCBs             */
  312. OS_EXT  INT32U       OSTime;                   /* Current value of system time (in ticks)              */
  315. extern  INT8U const  OSMapTbl[];               /* Priority->Bit Mask lookup table                      */
  316. extern  INT8U const  OSUnMapTbl[];             /* Priority->Index    lookup table                      */
  318. /*$PAGE*/
  319. /*
  320. *********************************************************************************************************
  321. *                                          FUNCTION PROTOTYPES
  322. *                                     (Target Independant Functions)
  323. *********************************************************************************************************
  324. */
  326. /*
  327. *********************************************************************************************************
  328. *                                        MESSAGE MAILBOX MANAGEMENT
  329. *********************************************************************************************************
  330. */
  331. #if         OS_MBOX_EN
  332. void       *OSMboxAccept(OS_EVENT *pevent);
  333. OS_EVENT   *OSMboxCreate(void *msg);
  334. void       *OSMboxPend(OS_EVENT *pevent, INT16U timeout, INT8U *err);
  335. INT8U       OSMboxPost(OS_EVENT *pevent, void *msg);
  336. INT8U       OSMboxQuery(OS_EVENT *pevent, OS_MBOX_DATA *pdata);
  337. #endif
  338. /*
  339. *********************************************************************************************************
  340. *                                           MEMORY MANAGEMENT
  341. *********************************************************************************************************
  342. */
  343. #if         OS_MEM_EN && (OS_MAX_MEM_PART >= 2)
  344. OS_MEM     *OSMemCreate(void *addr, INT32U nblks, INT32U blksize, INT8U *err);
  345. void       *OSMemGet(OS_MEM *pmem, INT8U *err);
  346. INT8U       OSMemPut(OS_MEM *pmem, void *pblk);
  347. INT8U       OSMemQuery(OS_MEM *pmem, OS_MEM_DATA *pdata);
  348. #endif
  349. /*
  350. *********************************************************************************************************
  351. *                                         MESSAGE QUEUE MANAGEMENT
  352. *********************************************************************************************************
  353. */
  354. #if         OS_Q_EN && (OS_MAX_QS >= 2)
  355. void       *OSQAccept(OS_EVENT *pevent);
  356. OS_EVENT   *OSQCreate(void **start, INT16U size);
  357. INT8U       OSQFlush(OS_EVENT *pevent);
  358. void       *OSQPend(OS_EVENT *pevent, INT16U timeout, INT8U *err);
  359. INT8U       OSQPost(OS_EVENT *pevent, void *msg);
  360. INT8U       OSQPostFront(OS_EVENT *pevent, void *msg);
  361. INT8U       OSQQuery(OS_EVENT *pevent, OS_Q_DATA *pdata);
  362. #endif
  363. /*$PAGE*/
  364. /*
  365. *********************************************************************************************************
  366. *                                          SEMAPHORE MANAGEMENT
  367. *********************************************************************************************************
  368. */
  369. #if         OS_SEM_EN
  370. INT16U      OSSemAccept(OS_EVENT *pevent);
  371. OS_EVENT   *OSSemCreate(INT16U value);
  372. void        OSSemPend(OS_EVENT *pevent, INT16U timeout, INT8U *err);
  373. INT8U       OSSemPost(OS_EVENT *pevent);
  374. INT8U       OSSemQuery(OS_EVENT *pevent, OS_SEM_DATA *pdata);
  375. #endif
  376. /*
  377. *********************************************************************************************************
  378. *                                            TASK MANAGEMENT
  379. *********************************************************************************************************
  380. */
  381. #if         OS_TASK_CHANGE_PRIO_EN
  382. INT8U       OSTaskChangePrio(INT8U oldprio, INT8U newprio);
  383. #endif
  385. INT8U       OSTaskCreate(void (*task)(void *pd), void *pdata, OS_STK *ptos, INT8U prio);
  387. #if         OS_TASK_CREATE_EXT_EN
  388. INT8U       OSTaskCreateExt(void  (*task)(void *pd), 
  389.                             void   *pdata, 
  390.                             OS_STK *ptos, 
  391.                             INT8U   prio,
  392.                             INT16U  id,
  393.                             OS_STK *pbos,
  394.                             INT32U  stk_size,
  395.                             void   *pext,
  396.                             INT16U  opt);
  397. #endif                            
  399. #if         OS_TASK_DEL_EN
  400. INT8U       OSTaskDel(INT8U prio);
  401. INT8U       OSTaskDelReq(INT8U prio);
  402. #endif
  404. #if         OS_TASK_SUSPEND_EN
  405. INT8U       OSTaskResume(INT8U prio);
  406. INT8U       OSTaskSuspend(INT8U prio);
  407. #endif
  409. #if         OS_TASK_CREATE_EXT_EN
  410. INT8U       OSTaskStkChk(INT8U prio, OS_STK_DATA *pdata);
  411. #endif
  413. INT8U       OSTaskQuery(INT8U prio, OS_TCB *pdata);
  415. /*
  416. *********************************************************************************************************
  417. *                                            TIME MANAGEMENT
  418. *********************************************************************************************************
  419. */
  420. void        OSTimeDly(INT16U ticks);
  421. INT8U       OSTimeDlyHMSM(INT8U hours, INT8U minutes, INT8U seconds, INT16U milli);
  422. INT8U       OSTimeDlyResume(INT8U prio);
  423. INT32U      OSTimeGet(void);
  424. void        OSTimeSet(INT32U ticks);
  425. void        OSTimeTick(void);
  427. /*
  428. *********************************************************************************************************
  429. *                                             MISCELLANEOUS
  430. *********************************************************************************************************
  431. */
  433. void        OSInit(void);
  435. void        OSIntEnter(void);
  436. void        OSIntExit(void);
  438. void        OSSchedLock(void);
  439. void        OSSchedUnlock(void);
  441. void        OSStart(void);
  443. void        OSStatInit(void);
  445. INT16U      OSVersion(void);
  447. /*$PAGE*/
  448. /*
  449. *********************************************************************************************************
  450. *                                      INTERNAL FUNCTION PROTOTYPES
  451. *                            (Your application MUST NOT call these functions)
  452. *********************************************************************************************************
  453. */
  455. #if         OS_MBOX_EN || OS_Q_EN || OS_SEM_EN
  456. void        OSEventTaskRdy(OS_EVENT *pevent, void *msg, INT8U msk);
  457. void        OSEventTaskWait(OS_EVENT *pevent);
  458. void        OSEventTO(OS_EVENT *pevent);
  459. void        OSEventWaitListInit(OS_EVENT *pevent);
  460. #endif
  462. #if         OS_MEM_EN && (OS_MAX_MEM_PART >= 2)
  463. void        OSMemInit(void);
  464. #endif
  466. #if         OS_Q_EN
  467. void        OSQInit(void);
  468. #endif
  470. void        OSSched(void);
  472. void        OSTaskIdle(void *data);
  474. #if         OS_TASK_STAT_EN
  475. void        OSTaskStat(void *data);
  476. #endif
  478. INT8U       OSTCBInit(INT8U prio, OS_STK *ptos, OS_STK *pbos, INT16U id, INT16U stk_size, void *pext, INT16U opt);
  480. /*$PAGE*/
  481. /*
  482. *********************************************************************************************************
  483. *                                          FUNCTION PROTOTYPES
  484. *                                      (Target Specific Functions)
  485. *********************************************************************************************************
  486. */
  488. void        OSCtxSw(void);
  490. void        OSIntCtxSw(void);
  492. void        OSStartHighRdy(void);
  494. void        OSTaskCreateHook(OS_TCB *ptcb);
  495. void        OSTaskDelHook(OS_TCB *ptcb);
  496. void        OSTaskStatHook(void);
  497. void       *OSTaskStkInit(void (*task)(void *pd), void *pdata, void *ptos, INT16U opt);
  498. void        OSTaskSwHook(void);
  500. void        OSTickISR(void);
  502. void        OSTimeTickHook(void);