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

源码开发语言/平台
当前位置：首页 > 源码/资料 > MacOS编程 > 查看源码
ucos_ii.h
资源名称：micrium-ucos-ii-v288.zip　[点击查看]
上传用户：ht5068443
上传日期：2016-07-26
资源大小：802k
文件大小：81k
源码类别：

MacOS编程

开发平台：

C/C++

ucos_ii.h：源码内容
  1. /*
  2. *********************************************************************************************************
  3. *                                                uC/OS-II
  4. *                                          The Real-Time Kernel
  5. *
  6. *                              (c) Copyright 1992-2009, Micrium, Weston, FL
  7. *                                           All Rights Reserved
  8. *
  9. * File    : uCOS_II.H
  10. * By      : Jean J. Labrosse
  11. * Version : V2.88
  12. *
  13. * LICENSING TERMS:
  14. * ---------------
  15. *   uC/OS-II is provided in source form for FREE evaluation, for educational use or for peaceful research.
  16. * If you plan on using  uC/OS-II  in a commercial product you need to contact Micri祄 to properly license
  17. * its use in your product. We provide ALL the source code for your convenience and to help you experience
  18. * uC/OS-II.   The fact that the  source is provided does  NOT  mean that you can use it without  paying a
  19. * licensing fee.
  20. *********************************************************************************************************
  21. */
  23. #ifndef   OS_uCOS_II_H
  24. #define   OS_uCOS_II_H
  26. #ifdef __cplusplus
  27. extern "C" {
  28. #endif
  30. /*
  31. *********************************************************************************************************
  32. *                                          uC/OS-II VERSION NUMBER
  33. *********************************************************************************************************
  34. */
  36. #define  OS_VERSION                 288u                /* Version of uC/OS-II (Vx.yy mult. by 100)    */
  38. /*
  39. *********************************************************************************************************
  40. *                                           INCLUDE HEADER FILES
  41. *********************************************************************************************************
  42. */
  44. #include <app_cfg.h>
  45. #include <os_cfg.h>
  46. #include <os_cpu.h>
  48. /*
  49. *********************************************************************************************************
  50. *                                             MISCELLANEOUS
  51. *********************************************************************************************************
  52. */
  54. #ifdef   OS_GLOBALS
  55. #define  OS_EXT
  56. #else
  57. #define  OS_EXT  extern
  58. #endif
  60. #ifndef  OS_FALSE
  61. #define  OS_FALSE                     0u
  62. #endif
  64. #ifndef  OS_TRUE
  65. #define  OS_TRUE                      1u
  66. #endif
  68. #define  OS_ASCII_NUL          (INT8U)0
  70. #define  OS_PRIO_SELF              0xFFu                /* Indicate SELF priority                      */
  72. #if OS_TASK_STAT_EN > 0
  73. #define  OS_N_SYS_TASKS               2u                /* Number of system tasks                      */
  74. #else
  75. #define  OS_N_SYS_TASKS               1u
  76. #endif
  78. #define  OS_TASK_STAT_PRIO  (OS_LOWEST_PRIO - 1)        /* Statistic task priority                     */
  79. #define  OS_TASK_IDLE_PRIO  (OS_LOWEST_PRIO)            /* IDLE      task priority                     */
  81. #if OS_LOWEST_PRIO <= 63
  82. #define  OS_EVENT_TBL_SIZE ((OS_LOWEST_PRIO) / 8 + 1)   /* Size of event table                         */
  83. #define  OS_RDY_TBL_SIZE   ((OS_LOWEST_PRIO) / 8 + 1)   /* Size of ready table                         */
  84. #else
  85. #define  OS_EVENT_TBL_SIZE ((OS_LOWEST_PRIO) / 16 + 1)  /* Size of event table                         */
  86. #define  OS_RDY_TBL_SIZE   ((OS_LOWEST_PRIO) / 16 + 1)  /* Size of ready table                         */
  87. #endif
  89. #define  OS_TASK_IDLE_ID          65535u                /* ID numbers for Idle, Stat and Timer tasks   */
  90. #define  OS_TASK_STAT_ID          65534u
  91. #define  OS_TASK_TMR_ID           65533u
  93. #define  OS_EVENT_EN           (((OS_Q_EN > 0) && (OS_MAX_QS > 0)) || (OS_MBOX_EN > 0) || (OS_SEM_EN > 0) || (OS_MUTEX_EN > 0))
  95. #define  OS_TCB_RESERVED        ((OS_TCB *)1)
  97. /*$PAGE*/
  98. /*
  99. *********************************************************************************************************
  100. *                              TASK STATUS (Bit definition for OSTCBStat)
  101. *********************************************************************************************************
  102. */
  103. #define  OS_STAT_RDY               0x00u    /* Ready to run                                            */
  104. #define  OS_STAT_SEM               0x01u    /* Pending on semaphore                                    */
  105. #define  OS_STAT_MBOX              0x02u    /* Pending on mailbox                                      */
  106. #define  OS_STAT_Q                 0x04u    /* Pending on queue                                        */
  107. #define  OS_STAT_SUSPEND           0x08u    /* Task is suspended                                       */
  108. #define  OS_STAT_MUTEX             0x10u    /* Pending on mutual exclusion semaphore                   */
  109. #define  OS_STAT_FLAG              0x20u    /* Pending on event flag group                             */
  110. #define  OS_STAT_MULTI             0x80u    /* Pending on multiple events                              */
  112. #define  OS_STAT_PEND_ANY         (OS_STAT_SEM | OS_STAT_MBOX | OS_STAT_Q | OS_STAT_MUTEX | OS_STAT_FLAG)
  114. /*
  115. *********************************************************************************************************
  116. *                           TASK PEND STATUS (Status codes for OSTCBStatPend)
  117. *********************************************************************************************************
  118. */
  119. #define  OS_STAT_PEND_OK              0u    /* Pending status OK, not pending, or pending complete     */
  120. #define  OS_STAT_PEND_TO              1u    /* Pending timed out                                       */
  121. #define  OS_STAT_PEND_ABORT           2u    /* Pending aborted                                         */
  123. /*
  124. *********************************************************************************************************
  125. *                                        OS_EVENT types
  126. *********************************************************************************************************
  127. */
  128. #define  OS_EVENT_TYPE_UNUSED         0u
  129. #define  OS_EVENT_TYPE_MBOX           1u
  130. #define  OS_EVENT_TYPE_Q              2u
  131. #define  OS_EVENT_TYPE_SEM            3u
  132. #define  OS_EVENT_TYPE_MUTEX          4u
  133. #define  OS_EVENT_TYPE_FLAG           5u
  135. #define  OS_TMR_TYPE                100u    /* Used to identify Timers ...                             */
  136.                                             /* ... (Must be different value than OS_EVENT_TYPE_xxx)    */
  138. /*
  139. *********************************************************************************************************
  140. *                                         EVENT FLAGS
  141. *********************************************************************************************************
  142. */
  143. #define  OS_FLAG_WAIT_CLR_ALL         0u    /* Wait for ALL    the bits specified to be CLR (i.e. 0)   */
  144. #define  OS_FLAG_WAIT_CLR_AND         0u
  146. #define  OS_FLAG_WAIT_CLR_ANY         1u    /* Wait for ANY of the bits specified to be CLR (i.e. 0)   */
  147. #define  OS_FLAG_WAIT_CLR_OR          1u
  149. #define  OS_FLAG_WAIT_SET_ALL         2u    /* Wait for ALL    the bits specified to be SET (i.e. 1)   */
  150. #define  OS_FLAG_WAIT_SET_AND         2u
  152. #define  OS_FLAG_WAIT_SET_ANY         3u    /* Wait for ANY of the bits specified to be SET (i.e. 1)   */
  153. #define  OS_FLAG_WAIT_SET_OR          3u
  156. #define  OS_FLAG_CONSUME           0x80u    /* Consume the flags if condition(s) satisfied             */
  159. #define  OS_FLAG_CLR                  0u
  160. #define  OS_FLAG_SET                  1u
  162. /*
  163. *********************************************************************************************************
  164. *                                   Values for OSTickStepState
  165. *
  166. * Note(s): This feature is used by uC/OS-View.
  167. *********************************************************************************************************
  168. */
  170. #if OS_TICK_STEP_EN > 0
  171. #define  OS_TICK_STEP_DIS             0u    /* Stepping is disabled, tick runs as mormal               */
  172. #define  OS_TICK_STEP_WAIT            1u    /* Waiting for uC/OS-View to set OSTickStepState to _ONCE  */
  173. #define  OS_TICK_STEP_ONCE            2u    /* Process tick once and wait for next cmd from uC/OS-View */
  174. #endif
  176. /*
  177. *********************************************************************************************************
  178. *       Possible values for 'opt' argument of OSSemDel(), OSMboxDel(), OSQDel() and OSMutexDel()
  179. *********************************************************************************************************
  180. */
  181. #define  OS_DEL_NO_PEND               0u
  182. #define  OS_DEL_ALWAYS                1u
  184. /*
  185. *********************************************************************************************************
  186. *                                        OS???Pend() OPTIONS
  187. *
  188. * These #defines are used to establish the options for OS???PendAbort().
  189. *********************************************************************************************************
  190. */
  191. #define  OS_PEND_OPT_NONE             0u    /* NO option selected                                      */
  192. #define  OS_PEND_OPT_BROADCAST        1u    /* Broadcast action to ALL tasks waiting                   */
  194. /*
  195. *********************************************************************************************************
  196. *                                     OS???PostOpt() OPTIONS
  197. *
  198. * These #defines are used to establish the options for OSMboxPostOpt() and OSQPostOpt().
  199. *********************************************************************************************************
  200. */
  201. #define  OS_POST_OPT_NONE          0x00u    /* NO option selected                                      */
  202. #define  OS_POST_OPT_BROADCAST     0x01u    /* Broadcast message to ALL tasks waiting                  */
  203. #define  OS_POST_OPT_FRONT         0x02u    /* Post to highest priority task waiting                   */
  204. #define  OS_POST_OPT_NO_SCHED      0x04u    /* Do not call the scheduler if this option is selected    */
  206. /*
  207. *********************************************************************************************************
  208. *                                 TASK OPTIONS (see OSTaskCreateExt())
  209. *********************************************************************************************************
  210. */
  211. #define  OS_TASK_OPT_NONE        0x0000u    /* NO option selected                                      */
  212. #define  OS_TASK_OPT_STK_CHK     0x0001u    /* Enable stack checking for the task                      */
  213. #define  OS_TASK_OPT_STK_CLR     0x0002u    /* Clear the stack when the task is create                 */
  214. #define  OS_TASK_OPT_SAVE_FP     0x0004u    /* Save the contents of any floating-point registers       */
  216. /*
  217. *********************************************************************************************************
  218. *                            TIMER OPTIONS (see OSTmrStart() and OSTmrStop())
  219. *********************************************************************************************************
  220. */
  221. #define  OS_TMR_OPT_NONE              0u    /* No option selected                                      */
  223. #define  OS_TMR_OPT_ONE_SHOT          1u    /* Timer will not automatically restart when it expires    */
  224. #define  OS_TMR_OPT_PERIODIC          2u    /* Timer will     automatically restart when it expires    */
  226. #define  OS_TMR_OPT_CALLBACK          3u    /* OSTmrStop() option to call 'callback' w/ timer arg.     */
  227. #define  OS_TMR_OPT_CALLBACK_ARG      4u    /* OSTmrStop() option to call 'callback' w/ new   arg.     */
  229. /*
  230. *********************************************************************************************************
  231. *                                            TIMER STATES
  232. *********************************************************************************************************
  233. */
  234. #define  OS_TMR_STATE_UNUSED          0u
  235. #define  OS_TMR_STATE_STOPPED         1u
  236. #define  OS_TMR_STATE_COMPLETED       2u
  237. #define  OS_TMR_STATE_RUNNING         3u
  239. /*
  240. *********************************************************************************************************
  241. *                                             ERROR CODES
  242. *********************************************************************************************************
  243. */
  244. #define OS_ERR_NONE                   0u
  246. #define OS_ERR_EVENT_TYPE             1u
  247. #define OS_ERR_PEND_ISR               2u
  248. #define OS_ERR_POST_NULL_PTR          3u
  249. #define OS_ERR_PEVENT_NULL            4u
  250. #define OS_ERR_POST_ISR               5u
  251. #define OS_ERR_QUERY_ISR              6u
  252. #define OS_ERR_INVALID_OPT            7u
  253. #define OS_ERR_ID_INVALID             8u
  254. #define OS_ERR_PDATA_NULL             9u
  256. #define OS_ERR_TIMEOUT               10u
  257. #define OS_ERR_EVENT_NAME_TOO_LONG   11u
  258. #define OS_ERR_PNAME_NULL            12u
  259. #define OS_ERR_PEND_LOCKED           13u
  260. #define OS_ERR_PEND_ABORT            14u
  261. #define OS_ERR_DEL_ISR               15u
  262. #define OS_ERR_CREATE_ISR            16u
  263. #define OS_ERR_NAME_GET_ISR          17u
  264. #define OS_ERR_NAME_SET_ISR          18u
  266. #define OS_ERR_MBOX_FULL             20u
  268. #define OS_ERR_Q_FULL                30u
  269. #define OS_ERR_Q_EMPTY               31u
  271. #define OS_ERR_PRIO_EXIST            40u
  272. #define OS_ERR_PRIO                  41u
  273. #define OS_ERR_PRIO_INVALID          42u
  275. #define OS_ERR_SEM_OVF               50u
  277. #define OS_ERR_TASK_CREATE_ISR       60u
  278. #define OS_ERR_TASK_DEL              61u
  279. #define OS_ERR_TASK_DEL_IDLE         62u
  280. #define OS_ERR_TASK_DEL_REQ          63u
  281. #define OS_ERR_TASK_DEL_ISR          64u
  282. #define OS_ERR_TASK_NAME_TOO_LONG    65u
  283. #define OS_ERR_TASK_NO_MORE_TCB      66u
  284. #define OS_ERR_TASK_NOT_EXIST        67u
  285. #define OS_ERR_TASK_NOT_SUSPENDED    68u
  286. #define OS_ERR_TASK_OPT              69u
  287. #define OS_ERR_TASK_RESUME_PRIO      70u
  288. #define OS_ERR_TASK_SUSPEND_IDLE     71u
  289. #define OS_ERR_TASK_SUSPEND_PRIO     72u
  290. #define OS_ERR_TASK_WAITING          73u
  292. #define OS_ERR_TIME_NOT_DLY          80u
  293. #define OS_ERR_TIME_INVALID_MINUTES  81u
  294. #define OS_ERR_TIME_INVALID_SECONDS  82u
  295. #define OS_ERR_TIME_INVALID_MS       83u
  296. #define OS_ERR_TIME_ZERO_DLY         84u
  297. #define OS_ERR_TIME_DLY_ISR          85u
  299. #define OS_ERR_MEM_INVALID_PART      90u
  300. #define OS_ERR_MEM_INVALID_BLKS      91u
  301. #define OS_ERR_MEM_INVALID_SIZE      92u
  302. #define OS_ERR_MEM_NO_FREE_BLKS      93u
  303. #define OS_ERR_MEM_FULL              94u
  304. #define OS_ERR_MEM_INVALID_PBLK      95u
  305. #define OS_ERR_MEM_INVALID_PMEM      96u
  306. #define OS_ERR_MEM_INVALID_PDATA     97u
  307. #define OS_ERR_MEM_INVALID_ADDR      98u
  308. #define OS_ERR_MEM_NAME_TOO_LONG     99u
  310. #define OS_ERR_NOT_MUTEX_OWNER      100u
  312. #define OS_ERR_FLAG_INVALID_PGRP    110u
  313. #define OS_ERR_FLAG_WAIT_TYPE       111u
  314. #define OS_ERR_FLAG_NOT_RDY         112u
  315. #define OS_ERR_FLAG_INVALID_OPT     113u
  316. #define OS_ERR_FLAG_GRP_DEPLETED    114u
  317. #define OS_ERR_FLAG_NAME_TOO_LONG   115u
  319. #define OS_ERR_PIP_LOWER            120u
  321. #define OS_ERR_TMR_INVALID_DLY      130u
  322. #define OS_ERR_TMR_INVALID_PERIOD   131u
  323. #define OS_ERR_TMR_INVALID_OPT      132u
  324. #define OS_ERR_TMR_INVALID_NAME     133u
  325. #define OS_ERR_TMR_NON_AVAIL        134u
  326. #define OS_ERR_TMR_INACTIVE         135u
  327. #define OS_ERR_TMR_INVALID_DEST     136u
  328. #define OS_ERR_TMR_INVALID_TYPE     137u
  329. #define OS_ERR_TMR_INVALID          138u
  330. #define OS_ERR_TMR_ISR              139u
  331. #define OS_ERR_TMR_NAME_TOO_LONG    140u
  332. #define OS_ERR_TMR_INVALID_STATE    141u
  333. #define OS_ERR_TMR_STOPPED          142u
  334. #define OS_ERR_TMR_NO_CALLBACK      143u
  336. /*
  337. *********************************************************************************************************
  338. *                                    OLD ERROR CODE NAMES (< V2.84)
  339. *********************************************************************************************************
  340. */
  341. #define OS_NO_ERR                    OS_ERR_NONE
  342. #define OS_TIMEOUT                   OS_ERR_TIMEOUT
  343. #define OS_TASK_NOT_EXIST            OS_ERR_TASK_NOT_EXIST
  344. #define OS_MBOX_FULL                 OS_ERR_MBOX_FULL
  345. #define OS_Q_FULL                    OS_ERR_Q_FULL
  346. #define OS_Q_EMPTY                   OS_ERR_Q_EMPTY
  347. #define OS_PRIO_EXIST                OS_ERR_PRIO_EXIST
  348. #define OS_PRIO_ERR                  OS_ERR_PRIO
  349. #define OS_PRIO_INVALID              OS_ERR_PRIO_INVALID
  350. #define OS_SEM_OVF                   OS_ERR_SEM_OVF
  351. #define OS_TASK_DEL_ERR              OS_ERR_TASK_DEL
  352. #define OS_TASK_DEL_IDLE             OS_ERR_TASK_DEL_IDLE
  353. #define OS_TASK_DEL_REQ              OS_ERR_TASK_DEL_REQ
  354. #define OS_TASK_DEL_ISR              OS_ERR_TASK_DEL_ISR
  355. #define OS_NO_MORE_TCB               OS_ERR_TASK_NO_MORE_TCB
  356. #define OS_TIME_NOT_DLY              OS_ERR_TIME_NOT_DLY
  357. #define OS_TIME_INVALID_MINUTES      OS_ERR_TIME_INVALID_MINUTES
  358. #define OS_TIME_INVALID_SECONDS      OS_ERR_TIME_INVALID_SECONDS
  359. #define OS_TIME_INVALID_MS           OS_ERR_TIME_INVALID_MS
  360. #define OS_TIME_ZERO_DLY             OS_ERR_TIME_ZERO_DLY
  361. #define OS_TASK_SUSPEND_PRIO         OS_ERR_TASK_SUSPEND_PRIO
  362. #define OS_TASK_SUSPEND_IDLE         OS_ERR_TASK_SUSPEND_IDLE
  363. #define OS_TASK_RESUME_PRIO          OS_ERR_TASK_RESUME_PRIO
  364. #define OS_TASK_NOT_SUSPENDED        OS_ERR_TASK_NOT_SUSPENDED
  365. #define OS_MEM_INVALID_PART          OS_ERR_MEM_INVALID_PART
  366. #define OS_MEM_INVALID_BLKS          OS_ERR_MEM_INVALID_BLKS
  367. #define OS_MEM_INVALID_SIZE          OS_ERR_MEM_INVALID_SIZE
  368. #define OS_MEM_NO_FREE_BLKS          OS_ERR_MEM_NO_FREE_BLKS
  369. #define OS_MEM_FULL                  OS_ERR_MEM_FULL
  370. #define OS_MEM_INVALID_PBLK          OS_ERR_MEM_INVALID_PBLK
  371. #define OS_MEM_INVALID_PMEM          OS_ERR_MEM_INVALID_PMEM
  372. #define OS_MEM_INVALID_PDATA         OS_ERR_MEM_INVALID_PDATA
  373. #define OS_MEM_INVALID_ADDR          OS_ERR_MEM_INVALID_ADDR
  374. #define OS_MEM_NAME_TOO_LONG         OS_ERR_MEM_NAME_TOO_LONG
  375. #define OS_TASK_OPT_ERR              OS_ERR_TASK_OPT
  376. #define OS_FLAG_INVALID_PGRP         OS_ERR_FLAG_INVALID_PGRP
  377. #define OS_FLAG_ERR_WAIT_TYPE        OS_ERR_FLAG_WAIT_TYPE
  378. #define OS_FLAG_ERR_NOT_RDY          OS_ERR_FLAG_NOT_RDY
  379. #define OS_FLAG_INVALID_OPT          OS_ERR_FLAG_INVALID_OPT
  380. #define OS_FLAG_GRP_DEPLETED         OS_ERR_FLAG_GRP_DEPLETED
  382. /*$PAGE*/
  383. /*
  384. *********************************************************************************************************
  385. *                                          EVENT CONTROL BLOCK
  386. *********************************************************************************************************
  387. */
  389. #if (OS_EVENT_EN) && (OS_MAX_EVENTS > 0)
  390. typedef struct os_event {
  391.     INT8U    OSEventType;                    /* Type of event control block (see OS_EVENT_TYPE_xxxx)    */
  392.     void    *OSEventPtr;                     /* Pointer to message or queue structure                   */
  393.     INT16U   OSEventCnt;                     /* Semaphore Count (not used if other EVENT type)          */
  394. #if OS_LOWEST_PRIO <= 63
  395.     INT8U    OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  396.     INT8U    OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  397. #else
  398.     INT16U   OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  399.     INT16U   OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  400. #endif
  402. #if OS_EVENT_NAME_EN > 0
  403.     INT8U   *OSEventName;
  404. #endif
  405. } OS_EVENT;
  406. #endif
  409. /*
  410. *********************************************************************************************************
  411. *                                       EVENT FLAGS CONTROL BLOCK
  412. *********************************************************************************************************
  413. */
  415. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  417. #if OS_FLAGS_NBITS == 8                     /* Determine the size of OS_FLAGS (8, 16 or 32 bits)       */
  418. typedef  INT8U    OS_FLAGS;
  419. #endif
  421. #if OS_FLAGS_NBITS == 16
  422. typedef  INT16U   OS_FLAGS;
  423. #endif
  425. #if OS_FLAGS_NBITS == 32
  426. typedef  INT32U   OS_FLAGS;
  427. #endif
  430. typedef struct os_flag_grp {                /* Event Flag Group                                        */
  431.     INT8U         OSFlagType;               /* Should be set to OS_EVENT_TYPE_FLAG                     */
  432.     void         *OSFlagWaitList;           /* Pointer to first NODE of task waiting on event flag     */
  433.     OS_FLAGS      OSFlagFlags;              /* 8, 16 or 32 bit flags                                   */
  434. #if OS_FLAG_NAME_EN > 0
  435.     INT8U        *OSFlagName;
  436. #endif
  437. } OS_FLAG_GRP;
  441. typedef struct os_flag_node {               /* Event Flag Wait List Node                               */
  442.     void         *OSFlagNodeNext;           /* Pointer to next     NODE in wait list                   */
  443.     void         *OSFlagNodePrev;           /* Pointer to previous NODE in wait list                   */
  444.     void         *OSFlagNodeTCB;            /* Pointer to TCB of waiting task                          */
  445.     void         *OSFlagNodeFlagGrp;        /* Pointer to Event Flag Group                             */
  446.     OS_FLAGS      OSFlagNodeFlags;          /* Event flag to wait on                                   */
  447.     INT8U         OSFlagNodeWaitType;       /* Type of wait:                                           */
  448.                                             /*      OS_FLAG_WAIT_AND                                   */
  449.                                             /*      OS_FLAG_WAIT_ALL                                   */
  450.                                             /*      OS_FLAG_WAIT_OR                                    */
  451.                                             /*      OS_FLAG_WAIT_ANY                                   */
  452. } OS_FLAG_NODE;
  453. #endif
  455. /*$PAGE*/
  456. /*
  457. *********************************************************************************************************
  458. *                                          MESSAGE MAILBOX DATA
  459. *********************************************************************************************************
  460. */
  462. #if OS_MBOX_EN > 0
  463. typedef struct os_mbox_data {
  464.     void   *OSMsg;                         /* Pointer to message in mailbox                            */
  465. #if OS_LOWEST_PRIO <= 63
  466.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE]; /* List of tasks waiting for event to occur                 */
  467.     INT8U   OSEventGrp;                    /* Group corresponding to tasks waiting for event to occur  */
  468. #else
  469.     INT16U  OSEventTbl[OS_EVENT_TBL_SIZE]; /* List of tasks waiting for event to occur                 */
  470.     INT16U  OSEventGrp;                    /* Group corresponding to tasks waiting for event to occur  */
  471. #endif
  472. } OS_MBOX_DATA;
  473. #endif
  475. /*
  476. *********************************************************************************************************
  477. *                                     MEMORY PARTITION DATA STRUCTURES
  478. *********************************************************************************************************
  479. */
  481. #if (OS_MEM_EN > 0) && (OS_MAX_MEM_PART > 0)
  482. typedef struct os_mem {                   /* MEMORY CONTROL BLOCK                                      */
  483.     void   *OSMemAddr;                    /* Pointer to beginning of memory partition                  */
  484.     void   *OSMemFreeList;                /* Pointer to list of free memory blocks                     */
  485.     INT32U  OSMemBlkSize;                 /* Size (in bytes) of each block of memory                   */
  486.     INT32U  OSMemNBlks;                   /* Total number of blocks in this partition                  */
  487.     INT32U  OSMemNFree;                   /* Number of memory blocks remaining in this partition       */
  488. #if OS_MEM_NAME_EN > 0
  489.     INT8U  *OSMemName;                    /* Memory partition name                                     */
  490. #endif
  491. } OS_MEM;
  494. typedef struct os_mem_data {
  495.     void   *OSAddr;                    /* Pointer to the beginning address of the memory partition     */
  496.     void   *OSFreeList;                /* Pointer to the beginning of the free list of memory blocks   */
  497.     INT32U  OSBlkSize;                 /* Size (in bytes) of each memory block                         */
  498.     INT32U  OSNBlks;                   /* Total number of blocks in the partition                      */
  499.     INT32U  OSNFree;                   /* Number of memory blocks free                                 */
  500.     INT32U  OSNUsed;                   /* Number of memory blocks used                                 */
  501. } OS_MEM_DATA;
  502. #endif
  504. /*$PAGE*/
  505. /*
  506. *********************************************************************************************************
  507. *                                    MUTUAL EXCLUSION SEMAPHORE DATA
  508. *********************************************************************************************************
  509. */
  511. #if OS_MUTEX_EN > 0
  512. typedef struct os_mutex_data {
  513. #if OS_LOWEST_PRIO <= 63
  514.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  515.     INT8U   OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  516. #else
  517.     INT16U  OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  518.     INT16U  OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  519. #endif
  520.     BOOLEAN OSValue;                        /* Mutex value (OS_FALSE = used, OS_TRUE = available)      */
  521.     INT8U   OSOwnerPrio;                    /* Mutex owner's task priority or 0xFF if no owner         */
  522.     INT8U   OSMutexPIP;                     /* Priority Inheritance Priority or 0xFF if no owner       */
  523. } OS_MUTEX_DATA;
  524. #endif
  526. /*
  527. *********************************************************************************************************
  528. *                                          MESSAGE QUEUE DATA
  529. *********************************************************************************************************
  530. */
  532. #if OS_Q_EN > 0
  533. typedef struct os_q {                   /* QUEUE CONTROL BLOCK                                         */
  534.     struct os_q   *OSQPtr;              /* Link to next queue control block in list of free blocks     */
  535.     void         **OSQStart;            /* Pointer to start of queue data                              */
  536.     void         **OSQEnd;              /* Pointer to end   of queue data                              */
  537.     void         **OSQIn;               /* Pointer to where next message will be inserted  in   the Q  */
  538.     void         **OSQOut;              /* Pointer to where next message will be extracted from the Q  */
  539.     INT16U         OSQSize;             /* Size of queue (maximum number of entries)                   */
  540.     INT16U         OSQEntries;          /* Current number of entries in the queue                      */
  541. } OS_Q;
  544. typedef struct os_q_data {
  545.     void          *OSMsg;               /* Pointer to next message to be extracted from queue          */
  546.     INT16U         OSNMsgs;             /* Number of messages in message queue                         */
  547.     INT16U         OSQSize;             /* Size of message queue                                       */
  548. #if OS_LOWEST_PRIO <= 63
  549.     INT8U          OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur         */
  550.     INT8U          OSEventGrp;          /* Group corresponding to tasks waiting for event to occur     */
  551. #else
  552.     INT16U         OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur         */
  553.     INT16U         OSEventGrp;          /* Group corresponding to tasks waiting for event to occur     */
  554. #endif
  555. } OS_Q_DATA;
  556. #endif
  558. /*
  559. *********************************************************************************************************
  560. *                                           SEMAPHORE DATA
  561. *********************************************************************************************************
  562. */
  564. #if OS_SEM_EN > 0
  565. typedef struct os_sem_data {
  566.     INT16U  OSCnt;                          /* Semaphore count                                         */
  567. #if OS_LOWEST_PRIO <= 63
  568.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  569.     INT8U   OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  570. #else
  571.     INT16U  OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  572.     INT16U  OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  573. #endif
  574. } OS_SEM_DATA;
  575. #endif
  577. /*
  578. *********************************************************************************************************
  579. *                                            TASK STACK DATA
  580. *********************************************************************************************************
  581. */
  583. #if OS_TASK_CREATE_EXT_EN > 0
  584. typedef struct os_stk_data {
  585.     INT32U  OSFree;                    /* Number of free bytes on the stack                            */
  586.     INT32U  OSUsed;                    /* Number of bytes used on the stack                            */
  587. } OS_STK_DATA;
  588. #endif
  590. /*$PAGE*/
  591. /*
  592. *********************************************************************************************************
  593. *                                          TASK CONTROL BLOCK
  594. *********************************************************************************************************
  595. */
  597. typedef struct os_tcb {
  598.     OS_STK          *OSTCBStkPtr;           /* Pointer to current top of stack                         */
  600. #if OS_TASK_CREATE_EXT_EN > 0
  601.     void            *OSTCBExtPtr;           /* Pointer to user definable data for TCB extension        */
  602.     OS_STK          *OSTCBStkBottom;        /* Pointer to bottom of stack                              */
  603.     INT32U           OSTCBStkSize;          /* Size of task stack (in number of stack elements)        */
  604.     INT16U           OSTCBOpt;              /* Task options as passed by OSTaskCreateExt()             */
  605.     INT16U           OSTCBId;               /* Task ID (0..65535)                                      */
  606. #endif
  608.     struct os_tcb   *OSTCBNext;             /* Pointer to next     TCB in the TCB list                 */
  609.     struct os_tcb   *OSTCBPrev;             /* Pointer to previous TCB in the TCB list                 */
  611. #if (OS_EVENT_EN) || (OS_FLAG_EN > 0)
  612.     OS_EVENT        *OSTCBEventPtr;         /* Pointer to          event control block                 */
  613. #endif
  615. #if (OS_EVENT_EN) && (OS_EVENT_MULTI_EN > 0)
  616.     OS_EVENT       **OSTCBEventMultiPtr;    /* Pointer to multiple event control blocks                */
  617. #endif
  619. #if ((OS_Q_EN > 0) && (OS_MAX_QS > 0)) || (OS_MBOX_EN > 0)
  620.     void            *OSTCBMsg;              /* Message received from OSMboxPost() or OSQPost()         */
  621. #endif
  623. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  624. #if OS_TASK_DEL_EN > 0
  625.     OS_FLAG_NODE    *OSTCBFlagNode;         /* Pointer to event flag node                              */
  626. #endif
  627.     OS_FLAGS         OSTCBFlagsRdy;         /* Event flags that made task ready to run                 */
  628. #endif
  630.     INT32U           OSTCBDly;              /* Nbr ticks to delay task or, timeout waiting for event   */
  631.     INT8U            OSTCBStat;             /* Task      status                                        */
  632.     INT8U            OSTCBStatPend;         /* Task PEND status                                        */
  633.     INT8U            OSTCBPrio;             /* Task priority (0 == highest)                            */
  635.     INT8U            OSTCBX;                /* Bit position in group  corresponding to task priority   */
  636.     INT8U            OSTCBY;                /* Index into ready table corresponding to task priority   */
  637. #if OS_LOWEST_PRIO <= 63
  638.     INT8U            OSTCBBitX;             /* Bit mask to access bit position in ready table          */
  639.     INT8U            OSTCBBitY;             /* Bit mask to access bit position in ready group          */
  640. #else
  641.     INT16U           OSTCBBitX;             /* Bit mask to access bit position in ready table          */
  642.     INT16U           OSTCBBitY;             /* Bit mask to access bit position in ready group          */
  643. #endif
  645. #if OS_TASK_DEL_EN > 0
  646.     INT8U            OSTCBDelReq;           /* Indicates whether a task needs to delete itself         */
  647. #endif
  649. #if OS_TASK_PROFILE_EN > 0
  650.     INT32U           OSTCBCtxSwCtr;         /* Number of time the task was switched in                 */
  651.     INT32U           OSTCBCyclesTot;        /* Total number of clock cycles the task has been running  */
  652.     INT32U           OSTCBCyclesStart;      /* Snapshot of cycle counter at start of task resumption   */
  653.     OS_STK          *OSTCBStkBase;          /* Pointer to the beginning of the task stack              */
  654.     INT32U           OSTCBStkUsed;          /* Number of bytes used from the stack                     */
  655. #endif
  657. #if OS_TASK_NAME_EN > 0
  658.     INT8U           *OSTCBTaskName;
  659. #endif
  661. #if OS_TASK_REG_TBL_SIZE > 0
  662.     INT32U           OSTCBRegTbl[OS_TASK_REG_TBL_SIZE];
  663. #endif
  664. } OS_TCB;
  666. /*$PAGE*/
  667. /*
  668. ************************************************************************************************************************
  669. *                                                   TIMER DATA TYPES
  670. ************************************************************************************************************************
  671. */
  673. #if OS_TMR_EN > 0
  674. typedef  void (*OS_TMR_CALLBACK)(void *ptmr, void *parg);
  678. typedef  struct  os_tmr {
  679.     INT8U            OSTmrType;                       /* Should be set to OS_TMR_TYPE                                  */
  680.     OS_TMR_CALLBACK  OSTmrCallback;                   /* Function to call when timer expires                           */
  681.     void            *OSTmrCallbackArg;                /* Argument to pass to function when timer expires               */
  682.     void            *OSTmrNext;                       /* Double link list pointers                                     */
  683.     void            *OSTmrPrev;
  684.     INT32U           OSTmrMatch;                      /* Timer expires when OSTmrTime == OSTmrMatch                    */
  685.     INT32U           OSTmrDly;                        /* Delay time before periodic update starts                      */
  686.     INT32U           OSTmrPeriod;                     /* Period to repeat timer                                        */
  687. #if OS_TMR_CFG_NAME_EN > 0
  688.     INT8U           *OSTmrName;                       /* Name to give the timer                                        */
  689. #endif
  690.     INT8U            OSTmrOpt;                        /* Options (see OS_TMR_OPT_xxx)                                  */
  691.     INT8U            OSTmrState;                      /* Indicates the state of the timer:                             */
  692.                                                       /*     OS_TMR_STATE_UNUSED                                       */
  693.                                                       /*     OS_TMR_STATE_RUNNING                                      */
  694.                                                       /*     OS_TMR_STATE_STOPPED                                      */
  695. } OS_TMR;
  699. typedef  struct  os_tmr_wheel {
  700.     OS_TMR          *OSTmrFirst;                      /* Pointer to first timer in linked list                         */
  701.     INT16U           OSTmrEntries;
  702. } OS_TMR_WHEEL;
  703. #endif
  705. /*$PAGE*/
  706. /*
  707. *********************************************************************************************************
  708. *                                            GLOBAL VARIABLES
  709. *********************************************************************************************************
  710. */
  712. OS_EXT  INT32U            OSCtxSwCtr;               /* Counter of number of context switches           */
  714. #if (OS_EVENT_EN) && (OS_MAX_EVENTS > 0)
  715. OS_EXT  OS_EVENT         *OSEventFreeList;          /* Pointer to list of free EVENT control blocks    */
  716. OS_EXT  OS_EVENT          OSEventTbl[OS_MAX_EVENTS];/* Table of EVENT control blocks                   */
  717. #endif
  719. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  720. OS_EXT  OS_FLAG_GRP       OSFlagTbl[OS_MAX_FLAGS];  /* Table containing event flag groups              */
  721. OS_EXT  OS_FLAG_GRP      *OSFlagFreeList;           /* Pointer to free list of event flag groups       */
  722. #endif
  724. #if OS_TASK_STAT_EN > 0
  725. OS_EXT  INT8U             OSCPUUsage;               /* Percentage of CPU used                          */
  726. OS_EXT  INT32U            OSIdleCtrMax;             /* Max. value that idle ctr can take in 1 sec.     */
  727. OS_EXT  INT32U            OSIdleCtrRun;             /* Val. reached by idle ctr at run time in 1 sec.  */
  728. OS_EXT  BOOLEAN           OSStatRdy;                /* Flag indicating that the statistic task is rdy  */
  729. OS_EXT  OS_STK            OSTaskStatStk[OS_TASK_STAT_STK_SIZE];      /* Statistics task stack          */
  730. #endif
  732. OS_EXT  INT8U             OSIntNesting;             /* Interrupt nesting level                         */
  734. OS_EXT  INT8U             OSLockNesting;            /* Multitasking lock nesting level                 */
  736. OS_EXT  INT8U             OSPrioCur;                /* Priority of current task                        */
  737. OS_EXT  INT8U             OSPrioHighRdy;            /* Priority of highest priority task               */
  739. #if OS_LOWEST_PRIO <= 63
  740. OS_EXT  INT8U             OSRdyGrp;                        /* Ready list group                         */
  741. OS_EXT  INT8U             OSRdyTbl[OS_RDY_TBL_SIZE];       /* Table of tasks which are ready to run    */
  742. #else
  743. OS_EXT  INT16U            OSRdyGrp;                        /* Ready list group                         */
  744. OS_EXT  INT16U            OSRdyTbl[OS_RDY_TBL_SIZE];       /* Table of tasks which are ready to run    */
  745. #endif
  747. OS_EXT  BOOLEAN           OSRunning;                       /* Flag indicating that kernel is running   */
  749. OS_EXT  INT8U             OSTaskCtr;                       /* Number of tasks created                  */
  751. OS_EXT  volatile  INT32U  OSIdleCtr;                                 /* Idle counter                   */
  753. OS_EXT  OS_STK            OSTaskIdleStk[OS_TASK_IDLE_STK_SIZE];      /* Idle task stack                */
  756. OS_EXT  OS_TCB           *OSTCBCur;                        /* Pointer to currently running TCB         */
  757. OS_EXT  OS_TCB           *OSTCBFreeList;                   /* Pointer to list of free TCBs             */
  758. OS_EXT  OS_TCB           *OSTCBHighRdy;                    /* Pointer to highest priority TCB R-to-R   */
  759. OS_EXT  OS_TCB           *OSTCBList;                       /* Pointer to doubly linked list of TCBs    */
  760. OS_EXT  OS_TCB           *OSTCBPrioTbl[OS_LOWEST_PRIO + 1];/* Table of pointers to created TCBs        */
  761. OS_EXT  OS_TCB            OSTCBTbl[OS_MAX_TASKS + OS_N_SYS_TASKS];   /* Table of TCBs                  */
  763. #if OS_TICK_STEP_EN > 0
  764. OS_EXT  INT8U             OSTickStepState;          /* Indicates the state of the tick step feature    */
  765. #endif
  767. #if (OS_MEM_EN > 0) && (OS_MAX_MEM_PART > 0)
  768. OS_EXT  OS_MEM           *OSMemFreeList;            /* Pointer to free list of memory partitions       */
  769. OS_EXT  OS_MEM            OSMemTbl[OS_MAX_MEM_PART];/* Storage for memory partition manager            */
  770. #endif
  772. #if (OS_Q_EN > 0) && (OS_MAX_QS > 0)
  773. OS_EXT  OS_Q             *OSQFreeList;              /* Pointer to list of free QUEUE control blocks    */
  774. OS_EXT  OS_Q              OSQTbl[OS_MAX_QS];        /* Table of QUEUE control blocks                   */
  775. #endif
  777. #if OS_TIME_GET_SET_EN > 0
  778. OS_EXT  volatile  INT32U  OSTime;                   /* Current value of system time (in ticks)         */
  779. #endif
  781. #if OS_TMR_EN > 0
  782. OS_EXT  INT16U            OSTmrFree;                /* Number of free entries in the timer pool        */
  783. OS_EXT  INT16U            OSTmrUsed;                /* Number of timers used                           */
  784. OS_EXT  INT32U            OSTmrTime;                /* Current timer time                              */
  786. OS_EXT  OS_EVENT         *OSTmrSem;                 /* Sem. used to gain exclusive access to timers    */
  787. OS_EXT  OS_EVENT         *OSTmrSemSignal;           /* Sem. used to signal the update of timers        */
  789. OS_EXT  OS_TMR            OSTmrTbl[OS_TMR_CFG_MAX]; /* Table containing pool of timers                 */
  790. OS_EXT  OS_TMR           *OSTmrFreeList;            /* Pointer to free list of timers                  */
  791. OS_EXT  OS_STK            OSTmrTaskStk[OS_TASK_TMR_STK_SIZE];
  793. OS_EXT  OS_TMR_WHEEL      OSTmrWheelTbl[OS_TMR_CFG_WHEEL_SIZE];
  794. #endif
  796. extern  INT8U   const     OSUnMapTbl[256];          /* Priority->Index    lookup table                 */
  798. /*$PAGE*/
  799. /*
  800. *********************************************************************************************************
  801. *                                          FUNCTION PROTOTYPES
  802. *                                     (Target Independent Functions)
  803. *********************************************************************************************************
  804. */
  806. /*
  807. *********************************************************************************************************
  808. *                                            MISCELLANEOUS
  809. *********************************************************************************************************
  810. */
  812. #if (OS_EVENT_EN)
  814. #if (OS_EVENT_NAME_EN > 0)
  815. INT8U         OSEventNameGet          (OS_EVENT        *pevent,
  816.                                        INT8U           *pname,
  817.                                        INT8U           *perr);
  819. void          OSEventNameSet          (OS_EVENT        *pevent,
  820.                                        INT8U           *pname,
  821.                                        INT8U           *perr);
  822. #endif
  824. #if (OS_EVENT_MULTI_EN > 0)
  825. INT16U        OSEventPendMulti        (OS_EVENT       **pevents_pend,
  826.                                        OS_EVENT       **pevents_rdy,
  827.                                        void           **pmsgs_rdy,
  828.                                        INT32U           timeout,
  829.                                        INT8U           *perr);
  830. #endif
  832. #endif
  834. /*
  835. *********************************************************************************************************
  836. *                                         EVENT FLAGS MANAGEMENT
  837. *********************************************************************************************************
  838. */
  840. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  842. #if OS_FLAG_ACCEPT_EN > 0
  843. OS_FLAGS      OSFlagAccept            (OS_FLAG_GRP     *pgrp,
  844.                                        OS_FLAGS         flags,
  845.                                        INT8U            wait_type,
  846.                                        INT8U           *perr);
  847. #endif
  849. OS_FLAG_GRP  *OSFlagCreate            (OS_FLAGS         flags,
  850.                                        INT8U           *perr);
  852. #if OS_FLAG_DEL_EN > 0
  853. OS_FLAG_GRP  *OSFlagDel               (OS_FLAG_GRP     *pgrp,
  854.                                        INT8U            opt,
  855.                                        INT8U           *perr);
  856. #endif
  858. #if (OS_FLAG_EN > 0) && (OS_FLAG_NAME_EN > 0)
  859. INT8U         OSFlagNameGet           (OS_FLAG_GRP     *pgrp,
  860.                                        INT8U           *pname,
  861.                                        INT8U           *perr);
  863. void          OSFlagNameSet           (OS_FLAG_GRP     *pgrp,
  864.                                        INT8U           *pname,
  865.                                        INT8U           *perr);
  866. #endif
  868. OS_FLAGS      OSFlagPend              (OS_FLAG_GRP     *pgrp,
  869.                                        OS_FLAGS         flags,
  870.                                        INT8U            wait_type,
  871.                                        INT32U           timeout,
  872.                                        INT8U           *perr);
  874. OS_FLAGS      OSFlagPendGetFlagsRdy   (void);
  875. OS_FLAGS      OSFlagPost              (OS_FLAG_GRP     *pgrp,
  876.                                        OS_FLAGS         flags,
  877.                                        INT8U            opt,
  878.                                        INT8U           *perr);
  880. #if OS_FLAG_QUERY_EN > 0
  881. OS_FLAGS      OSFlagQuery             (OS_FLAG_GRP     *pgrp,
  882.                                        INT8U           *perr);
  883. #endif
  884. #endif
  886. /*
  887. *********************************************************************************************************
  888. *                                        MESSAGE MAILBOX MANAGEMENT
  889. *********************************************************************************************************
  890. */
  892. #if OS_MBOX_EN > 0
  894. #if OS_MBOX_ACCEPT_EN > 0
  895. void         *OSMboxAccept            (OS_EVENT        *pevent);
  896. #endif
  898. OS_EVENT     *OSMboxCreate            (void            *pmsg);
  900. #if OS_MBOX_DEL_EN > 0
  901. OS_EVENT     *OSMboxDel               (OS_EVENT        *pevent,
  902.                                        INT8U            opt,
  903.                                        INT8U           *perr);
  904. #endif
  906. void         *OSMboxPend              (OS_EVENT        *pevent,
  907.                                        INT32U           timeout,
  908.                                        INT8U           *perr);
  910. #if OS_MBOX_PEND_ABORT_EN > 0
  911. INT8U         OSMboxPendAbort         (OS_EVENT        *pevent,
  912.                                        INT8U            opt,
  913.                                        INT8U           *perr);
  914. #endif
  916. #if OS_MBOX_POST_EN > 0
  917. INT8U         OSMboxPost              (OS_EVENT        *pevent,
  918.                                        void            *pmsg);
  919. #endif
  921. #if OS_MBOX_POST_OPT_EN > 0
  922. INT8U         OSMboxPostOpt           (OS_EVENT        *pevent,
  923.                                        void            *pmsg,
  924.                                        INT8U            opt);
  925. #endif
  927. #if OS_MBOX_QUERY_EN > 0
  928. INT8U         OSMboxQuery             (OS_EVENT        *pevent,
  929.                                        OS_MBOX_DATA    *p_mbox_data);
  930. #endif
  931. #endif
  933. /*
  934. *********************************************************************************************************
  935. *                                           MEMORY MANAGEMENT
  936. *********************************************************************************************************
  937. */
  939. #if (OS_MEM_EN > 0) && (OS_MAX_MEM_PART > 0)
  941. OS_MEM       *OSMemCreate             (void            *addr,
  942.                                        INT32U           nblks,
  943.                                        INT32U           blksize,
  944.                                        INT8U           *perr);
  946. void         *OSMemGet                (OS_MEM          *pmem,
  947.                                        INT8U           *perr);
  948. #if OS_MEM_NAME_EN > 0
  949. INT8U         OSMemNameGet            (OS_MEM          *pmem,
  950.                                        INT8U           *pname,
  951.                                        INT8U           *perr);
  953. void          OSMemNameSet            (OS_MEM          *pmem,
  954.                                        INT8U           *pname,
  955.                                        INT8U           *perr);
  956. #endif
  957. INT8U         OSMemPut                (OS_MEM          *pmem,
  958.                                        void            *pblk);
  960. #if OS_MEM_QUERY_EN > 0
  961. INT8U         OSMemQuery              (OS_MEM          *pmem,
  962.                                        OS_MEM_DATA     *p_mem_data);
  963. #endif
  965. #endif
  967. /*
  968. *********************************************************************************************************
  969. *                                MUTUAL EXCLUSION SEMAPHORE MANAGEMENT
  970. *********************************************************************************************************
  971. */
  973. #if OS_MUTEX_EN > 0
  975. #if OS_MUTEX_ACCEPT_EN > 0
  976. BOOLEAN       OSMutexAccept           (OS_EVENT        *pevent,
  977.                                        INT8U           *perr);
  978. #endif
  980. OS_EVENT     *OSMutexCreate           (INT8U            prio,
  981.                                        INT8U           *perr);
  983. #if OS_MUTEX_DEL_EN > 0
  984. OS_EVENT     *OSMutexDel              (OS_EVENT        *pevent,
  985.                                        INT8U            opt,
  986.                                        INT8U           *perr);
  987. #endif
  989. void          OSMutexPend             (OS_EVENT        *pevent,
  990.                                        INT32U           timeout,
  991.                                        INT8U           *perr);
  993. INT8U         OSMutexPost             (OS_EVENT        *pevent);
  995. #if OS_MUTEX_QUERY_EN > 0
  996. INT8U         OSMutexQuery            (OS_EVENT        *pevent,
  997.                                        OS_MUTEX_DATA   *p_mutex_data);
  998. #endif
  1000. #endif
  1002. /*$PAGE*/
  1003. /*
  1004. *********************************************************************************************************
  1005. *                                         MESSAGE QUEUE MANAGEMENT
  1006. *********************************************************************************************************
  1007. */
  1009. #if (OS_Q_EN > 0) && (OS_MAX_QS > 0)
  1011. #if OS_Q_ACCEPT_EN > 0
  1012. void         *OSQAccept               (OS_EVENT        *pevent,
  1013.                                        INT8U           *perr);
  1014. #endif
  1016. OS_EVENT     *OSQCreate               (void           **start,
  1017.                                        INT16U           size);
  1019. #if OS_Q_DEL_EN > 0
  1020. OS_EVENT     *OSQDel                  (OS_EVENT        *pevent,
  1021.                                        INT8U            opt,
  1022.                                        INT8U           *perr);
  1023. #endif
  1025. #if OS_Q_FLUSH_EN > 0
  1026. INT8U         OSQFlush                (OS_EVENT        *pevent);
  1027. #endif
  1029. void         *OSQPend                 (OS_EVENT        *pevent,
  1030.                                        INT32U           timeout,
  1031.                                        INT8U           *perr);
  1033. #if OS_Q_PEND_ABORT_EN > 0
  1034. INT8U         OSQPendAbort            (OS_EVENT        *pevent,
  1035.                                        INT8U            opt,
  1036.                                        INT8U           *perr);
  1037. #endif
  1039. #if OS_Q_POST_EN > 0
  1040. INT8U         OSQPost                 (OS_EVENT        *pevent,
  1041.                                        void            *pmsg);
  1042. #endif
  1044. #if OS_Q_POST_FRONT_EN > 0
  1045. INT8U         OSQPostFront            (OS_EVENT        *pevent,
  1046.                                        void            *pmsg);
  1047. #endif
  1049. #if OS_Q_POST_OPT_EN > 0
  1050. INT8U         OSQPostOpt              (OS_EVENT        *pevent,
  1051.                                        void            *pmsg,
  1052.                                        INT8U            opt);
  1053. #endif
  1055. #if OS_Q_QUERY_EN > 0
  1056. INT8U         OSQQuery                (OS_EVENT        *pevent,
  1057.                                        OS_Q_DATA       *p_q_data);
  1058. #endif
  1060. #endif
  1062. /*$PAGE*/
  1063. /*
  1064. *********************************************************************************************************
  1065. *                                          SEMAPHORE MANAGEMENT
  1066. *********************************************************************************************************
  1067. */
  1068. #if OS_SEM_EN > 0
  1070. #if OS_SEM_ACCEPT_EN > 0
  1071. INT16U        OSSemAccept             (OS_EVENT        *pevent);
  1072. #endif
  1074. OS_EVENT     *OSSemCreate             (INT16U           cnt);
  1076. #if OS_SEM_DEL_EN > 0
  1077. OS_EVENT     *OSSemDel                (OS_EVENT        *pevent,
  1078.                                        INT8U            opt,
  1079.                                        INT8U           *perr);
  1080. #endif
  1082. void          OSSemPend               (OS_EVENT        *pevent,
  1083.                                        INT32U           timeout,
  1084.                                        INT8U           *perr);
  1086. #if OS_SEM_PEND_ABORT_EN > 0
  1087. INT8U         OSSemPendAbort          (OS_EVENT        *pevent,
  1088.                                        INT8U            opt,
  1089.                                        INT8U           *perr);
  1090. #endif
  1092. INT8U         OSSemPost               (OS_EVENT        *pevent);
  1094. #if OS_SEM_QUERY_EN > 0
  1095. INT8U         OSSemQuery              (OS_EVENT        *pevent,
  1096.                                        OS_SEM_DATA     *p_sem_data);
  1097. #endif
  1099. #if OS_SEM_SET_EN > 0
  1100. void          OSSemSet                (OS_EVENT        *pevent,
  1101.                                        INT16U           cnt,
  1102.                                        INT8U           *perr);
  1103. #endif
  1105. #endif
  1107. /*$PAGE*/
  1108. /*
  1109. *********************************************************************************************************
  1110. *                                            TASK MANAGEMENT
  1111. *********************************************************************************************************
  1112. */
  1113. #if OS_TASK_CHANGE_PRIO_EN > 0
  1114. INT8U         OSTaskChangePrio        (INT8U            oldprio,
  1115.                                        INT8U            newprio);
  1116. #endif
  1118. #if OS_TASK_CREATE_EN > 0
  1119. INT8U         OSTaskCreate            (void           (*task)(void *p_arg),
  1120.                                        void            *p_arg,
  1121.                                        OS_STK          *ptos,
  1122.                                        INT8U            prio);
  1123. #endif
  1125. #if OS_TASK_CREATE_EXT_EN > 0
  1126. INT8U         OSTaskCreateExt         (void           (*task)(void *p_arg),
  1127.                                        void            *p_arg,
  1128.                                        OS_STK          *ptos,
  1129.                                        INT8U            prio,
  1130.                                        INT16U           id,
  1131.                                        OS_STK          *pbos,
  1132.                                        INT32U           stk_size,
  1133.                                        void            *pext,
  1134.                                        INT16U           opt);
  1135. #endif
  1137. #if OS_TASK_DEL_EN > 0
  1138. INT8U         OSTaskDel               (INT8U            prio);
  1139. INT8U         OSTaskDelReq            (INT8U            prio);
  1140. #endif
  1142. #if OS_TASK_NAME_EN > 0
  1143. INT8U         OSTaskNameGet           (INT8U            prio,
  1144.                                        INT8U           *pname,
  1145.                                        INT8U           *perr);
  1147. void          OSTaskNameSet           (INT8U            prio,
  1148.                                        INT8U           *pname,
  1149.                                        INT8U           *perr);
  1150. #endif
  1152. #if OS_TASK_SUSPEND_EN > 0
  1153. INT8U         OSTaskResume            (INT8U            prio);
  1154. INT8U         OSTaskSuspend           (INT8U            prio);
  1155. #endif
  1157. #if (OS_TASK_STAT_STK_CHK_EN > 0) && (OS_TASK_CREATE_EXT_EN > 0)
  1158. INT8U         OSTaskStkChk            (INT8U            prio,
  1159.                                        OS_STK_DATA     *p_stk_data);
  1160. #endif
  1162. #if OS_TASK_QUERY_EN > 0
  1163. INT8U         OSTaskQuery             (INT8U            prio,
  1164.                                        OS_TCB          *p_task_data);
  1165. #endif
  1169. #if OS_TASK_REG_TBL_SIZE > 0
  1170. INT32U        OSTaskRegGet            (INT8U            prio,
  1171.                                        INT8U            id,
  1172.                                        INT8U           *perr);
  1174. void          OSTaskRegSet            (INT8U            prio,
  1175.                                        INT8U            id,
  1176.                                        INT32U           value,
  1177.                                        INT8U           *perr);
  1178. #endif
  1180. /*$PAGE*/
  1181. /*
  1182. *********************************************************************************************************
  1183. *                                            TIME MANAGEMENT
  1184. *********************************************************************************************************
  1185. */
  1187. void          OSTimeDly               (INT32U           ticks);
  1189. #if OS_TIME_DLY_HMSM_EN > 0
  1190. INT8U         OSTimeDlyHMSM           (INT8U            hours,
  1191.                                        INT8U            minutes,
  1192.                                        INT8U            seconds,
  1193.                                        INT16U           milli);
  1194. #endif
  1196. #if OS_TIME_DLY_RESUME_EN > 0
  1197. INT8U         OSTimeDlyResume         (INT8U            prio);
  1198. #endif
  1200. #if OS_TIME_GET_SET_EN > 0
  1201. INT32U        OSTimeGet               (void);
  1202. void          OSTimeSet               (INT32U           ticks);
  1203. #endif
  1205. void          OSTimeTick              (void);
  1207. /*
  1208. *********************************************************************************************************
  1209. *                                            TIMER MANAGEMENT
  1210. *********************************************************************************************************
  1211. */
  1213. #if OS_TMR_EN > 0
  1214. OS_TMR      *OSTmrCreate              (INT32U           dly,
  1215.                                        INT32U           period,
  1216.                                        INT8U            opt,
  1217.                                        OS_TMR_CALLBACK  callback,
  1218.                                        void            *callback_arg,
  1219.                                        INT8U           *pname,
  1220.                                        INT8U           *perr);
  1222. BOOLEAN      OSTmrDel                 (OS_TMR          *ptmr,
  1223.                                        INT8U           *perr);
  1225. #if OS_TMR_CFG_NAME_EN > 0
  1226. INT8U        OSTmrNameGet             (OS_TMR          *ptmr,
  1227.                                        INT8U           *pdest,
  1228.                                        INT8U           *perr);
  1229. #endif
  1230. INT32U       OSTmrRemainGet           (OS_TMR          *ptmr,
  1231.                                        INT8U           *perr);
  1233. INT8U        OSTmrStateGet            (OS_TMR          *ptmr,
  1234.                                        INT8U           *perr);
  1236. BOOLEAN      OSTmrStart               (OS_TMR          *ptmr,
  1237.                                        INT8U           *perr);
  1239. BOOLEAN      OSTmrStop                (OS_TMR          *ptmr,
  1240.                                        INT8U            opt,
  1241.                                        void            *callback_arg,
  1242.                                        INT8U           *perr);
  1244. INT8U        OSTmrSignal              (void);
  1245. #endif
  1247. /*
  1248. *********************************************************************************************************
  1249. *                                             MISCELLANEOUS
  1250. *********************************************************************************************************
  1251. */
  1253. void          OSInit                  (void);
  1255. void          OSIntEnter              (void);
  1256. void          OSIntExit               (void);
  1258. #if OS_SCHED_LOCK_EN > 0
  1259. void          OSSchedLock             (void);
  1260. void          OSSchedUnlock           (void);
  1261. #endif
  1263. void          OSStart                 (void);
  1265. void          OSStatInit              (void);
  1267. INT16U        OSVersion               (void);
  1269. /*$PAGE*/
  1270. /*
  1271. *********************************************************************************************************
  1272. *                                      INTERNAL FUNCTION PROTOTYPES
  1273. *                            (Your application MUST NOT call these functions)
  1274. *********************************************************************************************************
  1275. */
  1277. #if OS_TASK_DEL_EN > 0
  1278. void          OS_Dummy                (void);
  1279. #endif
  1281. #if (OS_EVENT_EN)
  1282. INT8U         OS_EventTaskRdy         (OS_EVENT        *pevent,
  1283.                                        void            *pmsg,
  1284.                                        INT8U            msk,
  1285.                                        INT8U            pend_stat);
  1287. void          OS_EventTaskWait        (OS_EVENT        *pevent);
  1289. void          OS_EventTaskRemove      (OS_TCB          *ptcb,
  1290.                                        OS_EVENT        *pevent);
  1292. #if (OS_EVENT_MULTI_EN > 0)
  1293. void          OS_EventTaskWaitMulti   (OS_EVENT       **pevents_wait);
  1295. void          OS_EventTaskRemoveMulti (OS_TCB          *ptcb,
  1296.                                        OS_EVENT       **pevents_multi);
  1297. #endif
  1299. void          OS_EventWaitListInit    (OS_EVENT        *pevent);
  1300. #endif
  1302. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  1303. void          OS_FlagInit             (void);
  1304. void          OS_FlagUnlink           (OS_FLAG_NODE    *pnode);
  1305. #endif
  1307. void          OS_MemClr               (INT8U           *pdest,
  1308.                                        INT16U           size);
  1310. void          OS_MemCopy              (INT8U           *pdest,
  1311.                                        INT8U           *psrc,
  1312.                                        INT16U           size);
  1314. #if (OS_MEM_EN > 0) && (OS_MAX_MEM_PART > 0)
  1315. void          OS_MemInit              (void);
  1316. #endif
  1318. #if OS_Q_EN > 0
  1319. void          OS_QInit                (void);
  1320. #endif
  1322. void          OS_Sched                (void);
  1324. #if (OS_EVENT_NAME_EN > 0) || (OS_FLAG_NAME_EN > 0) || (OS_MEM_NAME_EN > 0) || (OS_TASK_NAME_EN > 0)
  1325. INT8U         OS_StrLen               (INT8U           *psrc);
  1326. #endif
  1328. void          OS_TaskIdle             (void            *p_arg);
  1330. #if OS_TASK_STAT_EN > 0
  1331. void          OS_TaskStat             (void            *p_arg);
  1332. #endif
  1334. #if (OS_TASK_STAT_STK_CHK_EN > 0) && (OS_TASK_CREATE_EXT_EN > 0)
  1335. void          OS_TaskStkClr           (OS_STK          *pbos,
  1336.                                        INT32U           size,
  1337.                                        INT16U           opt);
  1338. #endif
  1340. #if (OS_TASK_STAT_STK_CHK_EN > 0) && (OS_TASK_CREATE_EXT_EN > 0)
  1341. void          OS_TaskStatStkChk       (void);
  1342. #endif
  1344. INT8U         OS_TCBInit              (INT8U            prio,
  1345.                                        OS_STK          *ptos,
  1346.                                        OS_STK          *pbos,
  1347.                                        INT16U           id,
  1348.                                        INT32U           stk_size,
  1349.                                        void            *pext,
  1350.                                        INT16U           opt);
  1352. #if OS_TMR_EN > 0
  1353. void          OSTmr_Init              (void);
  1354. #endif
  1356. /*$PAGE*/
  1357. /*
  1358. *********************************************************************************************************
  1359. *                                          FUNCTION PROTOTYPES
  1360. *                                      (Target Specific Functions)
  1361. *********************************************************************************************************
  1362. */
  1364. #if OS_DEBUG_EN > 0
  1365. void          OSDebugInit             (void);
  1366. #endif
  1368. void          OSInitHookBegin         (void);
  1369. void          OSInitHookEnd           (void);
  1371. void          OSTaskCreateHook        (OS_TCB          *ptcb);
  1372. void          OSTaskDelHook           (OS_TCB          *ptcb);
  1374. void          OSTaskIdleHook          (void);
  1376. void          OSTaskStatHook          (void);
  1377. OS_STK       *OSTaskStkInit           (void           (*task)(void *p_arg),
  1378.                                        void            *p_arg,
  1379.                                        OS_STK          *ptos,
  1380.                                        INT16U           opt);
  1382. #if OS_TASK_SW_HOOK_EN > 0
  1383. void          OSTaskSwHook            (void);
  1384. #endif
  1386. void          OSTCBInitHook           (OS_TCB          *ptcb);
  1388. #if OS_TIME_TICK_HOOK_EN > 0
  1389. void          OSTimeTickHook          (void);
  1390. #endif
  1392. /*$PAGE*/
  1393. /*
  1394. *********************************************************************************************************
  1395. *                                          FUNCTION PROTOTYPES
  1396. *                                   (Application Specific Functions)
  1397. *********************************************************************************************************
  1398. */
  1400. #if OS_APP_HOOKS_EN > 0
  1401. void          App_TaskCreateHook      (OS_TCB          *ptcb);
  1402. void          App_TaskDelHook         (OS_TCB          *ptcb);
  1403. void          App_TaskIdleHook        (void);
  1405. void          App_TaskStatHook        (void);
  1407. #if OS_TASK_SW_HOOK_EN > 0
  1408. void          App_TaskSwHook          (void);
  1409. #endif
  1411. void          App_TCBInitHook         (OS_TCB          *ptcb);
  1413. #if OS_TIME_TICK_HOOK_EN > 0
  1414. void          App_TimeTickHook        (void);
  1415. #endif
  1416. #endif
  1418. /*
  1419. *********************************************************************************************************
  1420. *                                          FUNCTION PROTOTYPES
  1421. *
  1422. * IMPORTANT: These prototypes MUST be placed in OS_CPU.H
  1423. *********************************************************************************************************
  1424. */
  1426. #if 0
  1427. void          OSStartHighRdy          (void);
  1428. void          OSIntCtxSw              (void);
  1429. void          OSCtxSw                 (void);
  1430. #endif
  1432. /*$PAGE*/
  1433. /*
  1434. *********************************************************************************************************
  1435. *                                   LOOK FOR MISSING #define CONSTANTS
  1436. *
  1437. * This section is used to generate ERROR messages at compile time if certain #define constants are
  1438. * MISSING in OS_CFG.H.  This allows you to quickly determine the source of the error.
  1439. *
  1440. * You SHOULD NOT change this section UNLESS you would like to add more comments as to the source of the
  1441. * compile time error.
  1442. *********************************************************************************************************
  1443. */
  1445. /*
  1446. *********************************************************************************************************
  1447. *                                            EVENT FLAGS
  1448. *********************************************************************************************************
  1449. */
  1451. #ifndef OS_FLAG_EN
  1452. #error  "OS_CFG.H, Missing OS_FLAG_EN: Enable (1) or Disable (0) code generation for Event Flags"
  1453. #else
  1454.     #ifndef OS_MAX_FLAGS
  1455.     #error  "OS_CFG.H, Missing OS_MAX_FLAGS: Max. number of Event Flag Groups in your application"
  1456.     #else
  1457.         #if     OS_MAX_FLAGS > 65500u
  1458.         #error  "OS_CFG.H, OS_MAX_FLAGS must be <= 65500"
  1459.         #endif
  1460.     #endif
  1462.     #ifndef OS_FLAGS_NBITS
  1463.     #error  "OS_CFG.H, Missing OS_FLAGS_NBITS: Determine #bits used for event flags, MUST be either 8, 16 or 32"
  1464.     #endif
  1466.     #ifndef OS_FLAG_WAIT_CLR_EN
  1467.     #error  "OS_CFG.H, Missing OS_FLAG_WAIT_CLR_EN: Include code for Wait on Clear EVENT FLAGS"
  1468.     #endif
  1470.     #ifndef OS_FLAG_ACCEPT_EN
  1471.     #error  "OS_CFG.H, Missing OS_FLAG_ACCEPT_EN: Include code for OSFlagAccept()"
  1472.     #endif
  1474.     #ifndef OS_FLAG_DEL_EN
  1475.     #error  "OS_CFG.H, Missing OS_FLAG_DEL_EN: Include code for OSFlagDel()"
  1476.     #endif
  1478.     #ifndef OS_FLAG_NAME_EN
  1479.     #error  "OS_CFG.H, Missing OS_FLAG_NAME_EN: Enable flag group names"
  1480.     #endif
  1482.     #ifndef OS_FLAG_QUERY_EN
  1483.     #error  "OS_CFG.H, Missing OS_FLAG_QUERY_EN: Include code for OSFlagQuery()"
  1484.     #endif
  1485. #endif
  1487. /*
  1488. *********************************************************************************************************
  1489. *                                           MESSAGE MAILBOXES
  1490. *********************************************************************************************************
  1491. */
  1493. #ifndef OS_MBOX_EN
  1494. #error  "OS_CFG.H, Missing OS_MBOX_EN: Enable (1) or Disable (0) code generation for MAILBOXES"
  1495. #else
  1496.     #ifndef OS_MBOX_ACCEPT_EN
  1497.     #error  "OS_CFG.H, Missing OS_MBOX_ACCEPT_EN: Include code for OSMboxAccept()"
  1498.     #endif
  1500.     #ifndef OS_MBOX_DEL_EN
  1501.     #error  "OS_CFG.H, Missing OS_MBOX_DEL_EN: Include code for OSMboxDel()"
  1502.     #endif
  1504.     #ifndef OS_MBOX_PEND_ABORT_EN
  1505.     #error  "OS_CFG.H, Missing OS_MBOX_PEND_ABORT_EN: Include code for OSMboxPendAbort()"
  1506.     #endif
  1508.     #ifndef OS_MBOX_POST_EN
  1509.     #error  "OS_CFG.H, Missing OS_MBOX_POST_EN: Include code for OSMboxPost()"
  1510.     #endif
  1512.     #ifndef OS_MBOX_POST_OPT_EN
  1513.     #error  "OS_CFG.H, Missing OS_MBOX_POST_OPT_EN: Include code for OSMboxPostOpt()"
  1514.     #endif
  1516.     #ifndef OS_MBOX_QUERY_EN
  1517.     #error  "OS_CFG.H, Missing OS_MBOX_QUERY_EN: Include code for OSMboxQuery()"
  1518.     #endif
  1519. #endif
  1521. /*
  1522. *********************************************************************************************************
  1523. *                                           MEMORY MANAGEMENT
  1524. *********************************************************************************************************
  1525. */
  1527. #ifndef OS_MEM_EN
  1528. #error  "OS_CFG.H, Missing OS_MEM_EN: Enable (1) or Disable (0) code generation for MEMORY MANAGER"
  1529. #else
  1530.     #ifndef OS_MAX_MEM_PART
  1531.     #error  "OS_CFG.H, Missing OS_MAX_MEM_PART: Max. number of memory partitions"
  1532.     #else
  1533.         #if     OS_MAX_MEM_PART > 65500u
  1534.         #error  "OS_CFG.H, OS_MAX_MEM_PART must be <= 65500"
  1535.         #endif
  1536.     #endif
  1538.     #ifndef OS_MEM_NAME_EN
  1539.     #error  "OS_CFG.H, Missing OS_MEM_NAME_EN: Enable memory partition names"
  1540.     #endif
  1542.     #ifndef OS_MEM_QUERY_EN
  1543.     #error  "OS_CFG.H, Missing OS_MEM_QUERY_EN: Include code for OSMemQuery()"
  1544.     #endif
  1545. #endif
  1547. /*
  1548. *********************************************************************************************************
  1549. *                                       MUTUAL EXCLUSION SEMAPHORES
  1550. *********************************************************************************************************
  1551. */
  1553. #ifndef OS_MUTEX_EN
  1554. #error  "OS_CFG.H, Missing OS_MUTEX_EN: Enable (1) or Disable (0) code generation for MUTEX"
  1555. #else
  1556.     #ifndef OS_MUTEX_ACCEPT_EN
  1557.     #error  "OS_CFG.H, Missing OS_MUTEX_ACCEPT_EN: Include code for OSMutexAccept()"
  1558.     #endif
  1560.     #ifndef OS_MUTEX_DEL_EN
  1561.     #error  "OS_CFG.H, Missing OS_MUTEX_DEL_EN: Include code for OSMutexDel()"
  1562.     #endif
  1564.     #ifndef OS_MUTEX_QUERY_EN
  1565.     #error  "OS_CFG.H, Missing OS_MUTEX_QUERY_EN: Include code for OSMutexQuery()"
  1566.     #endif
  1567. #endif
  1569. /*
  1570. *********************************************************************************************************
  1571. *                                              MESSAGE QUEUES
  1572. *********************************************************************************************************
  1573. */
  1575. #ifndef OS_Q_EN
  1576. #error  "OS_CFG.H, Missing OS_Q_EN: Enable (1) or Disable (0) code generation for QUEUES"
  1577. #else
  1578.     #ifndef OS_MAX_QS
  1579.     #error  "OS_CFG.H, Missing OS_MAX_QS: Max. number of queue control blocks"
  1580.     #else
  1581.         #if     OS_MAX_QS > 65500u
  1582.         #error  "OS_CFG.H, OS_MAX_QS must be <= 65500"
  1583.         #endif
  1584.     #endif
  1586.     #ifndef OS_Q_ACCEPT_EN
  1587.     #error  "OS_CFG.H, Missing OS_Q_ACCEPT_EN: Include code for OSQAccept()"
  1588.     #endif
  1590.     #ifndef OS_Q_DEL_EN
  1591.     #error  "OS_CFG.H, Missing OS_Q_DEL_EN: Include code for OSQDel()"
  1592.     #endif
  1594.     #ifndef OS_Q_FLUSH_EN
  1595.     #error  "OS_CFG.H, Missing OS_Q_FLUSH_EN: Include code for OSQFlush()"
  1596.     #endif
  1598.     #ifndef OS_Q_PEND_ABORT_EN
  1599.     #error  "OS_CFG.H, Missing OS_Q_PEND_ABORT_EN: Include code for OSQPendAbort()"
  1600.     #endif
  1602.     #ifndef OS_Q_POST_EN
  1603.     #error  "OS_CFG.H, Missing OS_Q_POST_EN: Include code for OSQPost()"
  1604.     #endif
  1606.     #ifndef OS_Q_POST_FRONT_EN
  1607.     #error  "OS_CFG.H, Missing OS_Q_POST_FRONT_EN: Include code for OSQPostFront()"
  1608.     #endif
  1610.     #ifndef OS_Q_POST_OPT_EN
  1611.     #error  "OS_CFG.H, Missing OS_Q_POST_OPT_EN: Include code for OSQPostOpt()"
  1612.     #endif
  1614.     #ifndef OS_Q_QUERY_EN
  1615.     #error  "OS_CFG.H, Missing OS_Q_QUERY_EN: Include code for OSQQuery()"
  1616.     #endif
  1617. #endif
  1619. /*
  1620. *********************************************************************************************************
  1621. *                                              SEMAPHORES
  1622. *********************************************************************************************************
  1623. */
  1625. #ifndef OS_SEM_EN
  1626. #error  "OS_CFG.H, Missing OS_SEM_EN: Enable (1) or Disable (0) code generation for SEMAPHORES"
  1627. #else
  1628.     #ifndef OS_SEM_ACCEPT_EN
  1629.     #error  "OS_CFG.H, Missing OS_SEM_ACCEPT_EN: Include code for OSSemAccept()"
  1630.     #endif
  1632.     #ifndef OS_SEM_DEL_EN
  1633.     #error  "OS_CFG.H, Missing OS_SEM_DEL_EN: Include code for OSSemDel()"
  1634.     #endif
  1636.     #ifndef OS_SEM_PEND_ABORT_EN
  1637.     #error  "OS_CFG.H, Missing OS_SEM_PEND_ABORT_EN: Include code for OSSemPendAbort()"
  1638.     #endif
  1640.     #ifndef OS_SEM_QUERY_EN
  1641.     #error  "OS_CFG.H, Missing OS_SEM_QUERY_EN: Include code for OSSemQuery()"
  1642.     #endif
  1644.     #ifndef OS_SEM_SET_EN
  1645.     #error  "OS_CFG.H, Missing OS_SEM_SET_EN: Include code for OSSemSet()"
  1646.     #endif
  1647. #endif
  1649. /*
  1650. *********************************************************************************************************
  1651. *                                             TASK MANAGEMENT
  1652. *********************************************************************************************************
  1653. */
  1655. #ifndef OS_MAX_TASKS
  1656. #error  "OS_CFG.H, Missing OS_MAX_TASKS: Max. number of tasks in your application"
  1657. #else
  1658.     #if     OS_MAX_TASKS < 2
  1659.     #error  "OS_CFG.H,         OS_MAX_TASKS must be >= 2"
  1660.     #endif
  1662.     #if     OS_MAX_TASKS >  ((OS_LOWEST_PRIO - OS_N_SYS_TASKS) + 1)
  1663.     #error  "OS_CFG.H,         OS_MAX_TASKS must be <= OS_LOWEST_PRIO - OS_N_SYS_TASKS + 1"
  1664.     #endif
  1666. #endif
  1668. #if     OS_LOWEST_PRIO >  254
  1669. #error  "OS_CFG.H,         OS_LOWEST_PRIO must be <= 254 in V2.8x and higher"
  1670. #endif
  1672. #ifndef OS_TASK_IDLE_STK_SIZE
  1673. #error  "OS_CFG.H, Missing OS_TASK_IDLE_STK_SIZE: Idle task stack size"
  1674. #endif
  1676. #ifndef OS_TASK_STAT_EN
  1677. #error  "OS_CFG.H, Missing OS_TASK_STAT_EN: Enable (1) or Disable(0) the statistics task"
  1678. #endif
  1680. #ifndef OS_TASK_STAT_STK_SIZE
  1681. #error  "OS_CFG.H, Missing OS_TASK_STAT_STK_SIZE: Statistics task stack size"
  1682. #endif
  1684. #ifndef OS_TASK_STAT_STK_CHK_EN
  1685. #error  "OS_CFG.H, Missing OS_TASK_STAT_STK_CHK_EN: Check task stacks from statistics task"
  1686. #endif
  1688. #ifndef OS_TASK_CHANGE_PRIO_EN
  1689. #error  "OS_CFG.H, Missing OS_TASK_CHANGE_PRIO_EN: Include code for OSTaskChangePrio()"
  1690. #endif
  1692. #ifndef OS_TASK_CREATE_EN
  1693. #error  "OS_CFG.H, Missing OS_TASK_CREATE_EN: Include code for OSTaskCreate()"
  1694. #endif
  1696. #ifndef OS_TASK_CREATE_EXT_EN
  1697. #error  "OS_CFG.H, Missing OS_TASK_CREATE_EXT_EN: Include code for OSTaskCreateExt()"
  1698. #endif
  1700. #ifndef OS_TASK_DEL_EN
  1701. #error  "OS_CFG.H, Missing OS_TASK_DEL_EN: Include code for OSTaskDel()"
  1702. #endif
  1704. #ifndef OS_TASK_NAME_EN
  1705. #error  "OS_CFG.H, Missing OS_TASK_NAME_EN: Enable task names"
  1706. #endif
  1708. #ifndef OS_TASK_SUSPEND_EN
  1709. #error  "OS_CFG.H, Missing OS_TASK_SUSPEND_EN: Include code for OSTaskSuspend() and OSTaskResume()"
  1710. #endif
  1712. #ifndef OS_TASK_QUERY_EN
  1713. #error  "OS_CFG.H, Missing OS_TASK_QUERY_EN: Include code for OSTaskQuery()"
  1714. #endif
  1716. #ifndef OS_TASK_REG_TBL_SIZE
  1717. #error  "OS_CFG.H, Missing OS_TASK_REG_TBL_SIZE: Include code for task specific registers"
  1718. #else
  1719.     #if     OS_TASK_REG_TBL_SIZE > 255
  1720.     #error  "OS_CFG.H,         OS_TASK_REG_TBL_SIZE must be <= 255"
  1721.     #endif
  1722. #endif
  1724. /*
  1725. *********************************************************************************************************
  1726. *                                             TIME MANAGEMENT
  1727. *********************************************************************************************************
  1728. */
  1730. #ifndef OS_TICKS_PER_SEC
  1731. #error  "OS_CFG.H, Missing OS_TICKS_PER_SEC: Sets the number of ticks in one second"
  1732. #endif
  1734. #ifndef OS_TIME_DLY_HMSM_EN
  1735. #error  "OS_CFG.H, Missing OS_TIME_DLY_HMSM_EN: Include code for OSTimeDlyHMSM()"
  1736. #endif
  1738. #ifndef OS_TIME_DLY_RESUME_EN
  1739. #error  "OS_CFG.H, Missing OS_TIME_DLY_RESUME_EN: Include code for OSTimeDlyResume()"
  1740. #endif
  1742. #ifndef OS_TIME_GET_SET_EN
  1743. #error  "OS_CFG.H, Missing OS_TIME_GET_SET_EN: Include code for OSTimeGet() and OSTimeSet()"
  1744. #endif
  1746. /*
  1747. *********************************************************************************************************
  1748. *                                             TIMER MANAGEMENT
  1749. *********************************************************************************************************
  1750. */
  1752. #ifndef OS_TMR_EN
  1753. #error  "OS_CFG.H, Missing OS_TMR_EN: When (1) enables code generation for Timer Management"
  1754. #elif   OS_TMR_EN > 0
  1755.     #if     OS_SEM_EN == 0
  1756.     #error  "OS_CFG.H, Semaphore management is required (set OS_SEM_EN to 1) when enabling Timer Management."
  1757.     #error  "          Timer management require TWO semaphores."
  1758.     #endif
  1760.     #ifndef OS_TMR_CFG_MAX
  1761.     #error  "OS_CFG.H, Missing OS_TMR_CFG_MAX: Determines the total number of timers in an application (2 .. 65500)"
  1762.     #else
  1763.         #if OS_TMR_CFG_MAX < 2
  1764.         #error  "OS_CFG.H, OS_TMR_CFG_MAX should be between 2 and 65500"
  1765.         #endif
  1767.         #if OS_TMR_CFG_MAX > 65500
  1768.         #error  "OS_CFG.H, OS_TMR_CFG_MAX should be between 2 and 65500"
  1769.         #endif
  1770.     #endif
  1772.     #ifndef OS_TMR_CFG_WHEEL_SIZE
  1773.     #error  "OS_CFG.H, Missing OS_TMR_CFG_WHEEL_SIZE: Sets the size of the timer wheel (1 .. 1023)"
  1774.     #else
  1775.         #if OS_TMR_CFG_WHEEL_SIZE < 2
  1776.         #error  "OS_CFG.H, OS_TMR_CFG_WHEEL_SIZE should be between 2 and 1024"
  1777.         #endif
  1779.         #if OS_TMR_CFG_WHEEL_SIZE > 1024
  1780.         #error  "OS_CFG.H, OS_TMR_CFG_WHEEL_SIZE should be between 2 and 1024"
  1781.         #endif
  1782.     #endif
  1784.     #ifndef OS_TMR_CFG_NAME_EN
  1785.     #error  "OS_CFG.H, Missing OS_TMR_CFG_NAME_EN: Enable Timer names"
  1786.     #endif
  1788.     #ifndef OS_TMR_CFG_TICKS_PER_SEC
  1789.     #error  "OS_CFG.H, Missing OS_TMR_CFG_TICKS_PER_SEC: Determines the rate at which tiem timer management task will run (Hz)"
  1790.     #endif
  1792.     #ifndef OS_TASK_TMR_STK_SIZE
  1793.     #error  "OS_CFG.H, Missing OS_TASK_TMR_STK_SIZE: Determines the size of the Timer Task's stack"
  1794.     #endif
  1795. #endif
  1798. /*
  1799. *********************************************************************************************************
  1800. *                                            MISCELLANEOUS
  1801. *********************************************************************************************************
  1802. */
  1804. #ifndef OS_ARG_CHK_EN
  1805. #error  "OS_CFG.H, Missing OS_ARG_CHK_EN: Enable (1) or Disable (0) argument checking"
  1806. #endif
  1809. #ifndef OS_CPU_HOOKS_EN
  1810. #error  "OS_CFG.H, Missing OS_CPU_HOOKS_EN: uC/OS-II hooks are found in the processor port files when 1"
  1811. #endif
  1814. #ifndef OS_APP_HOOKS_EN
  1815. #error  "OS_CFG.H, Missing OS_APP_HOOKS_EN: Application-defined hooks are called from the uC/OS-II hooks"
  1816. #endif
  1819. #ifndef OS_DEBUG_EN
  1820. #error  "OS_CFG.H, Missing OS_DEBUG_EN: Allows you to include variables for debugging or not"
  1821. #endif
  1824. #ifndef OS_LOWEST_PRIO
  1825. #error  "OS_CFG.H, Missing OS_LOWEST_PRIO: Defines the lowest priority that can be assigned"
  1826. #endif
  1829. #ifndef OS_MAX_EVENTS
  1830. #error  "OS_CFG.H, Missing OS_MAX_EVENTS: Max. number of event control blocks in your application"
  1831. #else
  1832.     #if     OS_MAX_EVENTS > 65500u
  1833.     #error  "OS_CFG.H, OS_MAX_EVENTS must be <= 65500"
  1834.     #endif
  1835. #endif
  1838. #ifndef OS_SCHED_LOCK_EN
  1839. #error  "OS_CFG.H, Missing OS_SCHED_LOCK_EN: Include code for OSSchedLock() and OSSchedUnlock()"
  1840. #endif
  1843. #ifndef OS_EVENT_MULTI_EN
  1844. #error  "OS_CFG.H, Missing OS_EVENT_MULTI_EN: Include code for OSEventPendMulti()"
  1845. #endif
  1848. #ifndef OS_TASK_PROFILE_EN
  1849. #error  "OS_CFG.H, Missing OS_TASK_PROFILE_EN: Include data structure for run-time task profiling"
  1850. #endif
  1853. #ifndef OS_TASK_SW_HOOK_EN
  1854. #error  "OS_CFG.H, Missing OS_TASK_SW_HOOK_EN: Allows you to include the code for OSTaskSwHook() or not"
  1855. #endif
  1858. #ifndef OS_TICK_STEP_EN
  1859. #error  "OS_CFG.H, Missing OS_TICK_STEP_EN: Allows to 'step' one tick at a time with uC/OS-View"
  1860. #endif
  1863. #ifndef OS_TIME_TICK_HOOK_EN
  1864. #error  "OS_CFG.H, Missing OS_TIME_TICK_HOOK_EN: Allows you to include the code for OSTimeTickHook() or not"
  1865. #endif
  1867. /*
  1868. *********************************************************************************************************
  1869. *                                         SAFETY CRITICAL USE
  1870. *********************************************************************************************************
  1871. */
  1873. #ifdef SAFETY_CRITICAL_RELEASE
  1875. #if    OS_ARG_CHK_EN < 1
  1876. #error "OS_CFG.H, OS_ARG_CHK_EN must be enabled for safety-critical release code"
  1877. #endif
  1879. #if    OS_APP_HOOKS_EN > 0
  1880. #error "OS_CFG.H, OS_APP_HOOKS_EN must be disabled for safety-critical release code"
  1881. #endif
  1883. #if    OS_DEBUG_EN > 0
  1884. #error "OS_CFG.H, OS_DEBUG_EN must be disabled for safety-critical release code"
  1885. #endif
  1887. #ifdef CANTATA
  1888. #error "OS_CFG.H, CANTATA must be disabled for safety-critical release code"
  1889. #endif
  1891. #ifdef OS_SCHED_LOCK_EN
  1892. #error "OS_CFG.H, OS_SCHED_LOCK_EN must be disabled for safety-critical release code"
  1893. #endif
  1895. #ifdef VSC_VALIDATION_MODE
  1896. #error "OS_CFG.H, VSC_VALIDATION_MODE must be disabled for safety-critical release code"
  1897. #endif
  1899. #if    OS_TASK_STAT_EN > 0
  1900. #error "OS_CFG.H, OS_TASK_STAT_EN must be disabled for safety-critical release code"
  1901. #endif
  1903. #if    OS_TICK_STEP_EN > 0
  1904. #error "OS_CFG.H, OS_TICK_STEP_EN must be disabled for safety-critical release code"
  1905. #endif
  1907. #if    OS_FLAG_EN > 0
  1908.     #if    OS_FLAG_DEL_EN > 0
  1909.     #error "OS_CFG.H, OS_FLAG_DEL_EN must be disabled for safety-critical release code"
  1910.     #endif
  1911. #endif
  1913. #if    OS_MBOX_EN > 0
  1914.     #if    OS_MBOX_DEL_EN > 0
  1915.     #error "OS_CFG.H, OS_MBOX_DEL_EN must be disabled for safety-critical release code"
  1916.     #endif
  1917. #endif
  1919. #if    OS_MUTEX_EN > 0
  1920.     #if    OS_MUTEX_DEL_EN > 0
  1921.     #error "OS_CFG.H, OS_MUTEX_DEL_EN must be disabled for safety-critical release code"
  1922.     #endif
  1923. #endif
  1925. #if    OS_Q_EN > 0
  1926.     #if    OS_Q_DEL_EN > 0
  1927.     #error "OS_CFG.H, OS_Q_DEL_EN must be disabled for safety-critical release code"
  1928.     #endif
  1929. #endif
  1931. #if    OS_SEM_EN > 0
  1932.     #if    OS_SEM_DEL_EN > 0
  1933.     #error "OS_CFG.H, OS_SEM_DEL_EN must be disabled for safety-critical release code"
  1934.     #endif
  1935. #endif
  1937. #if    OS_TASK_EN > 0
  1938.     #if    OS_TASK_DEL_EN > 0
  1939.     #error "OS_CFG.H, OS_TASK_DEL_EN must be disabled for safety-critical release code"
  1940.     #endif
  1941. #endif
  1943. #if    OS_CRITICAL_METHOD != 3
  1944. #error "OS_CPU.H, OS_CRITICAL_METHOD must be type 3 for safety-critical release code"
  1945. #endif
  1947. #endif  /* ------------------------ SAFETY_CRITICAL_RELEASE ------------------------ */
  1949. #ifdef __cplusplus
  1950. }
  1951. #endif
  1953. #endif