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

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

uCOS

开发平台：

Others

ucos_ii.h：源码内容
  1. /*
  2. *********************************************************************************************************
  3. *                                                uC/OS-II
  4. *                                          The Real-Time Kernel
  5. *
  6. *                              (c) Copyright 1992-2007, Micrium, Weston, FL
  7. *                                           All Rights Reserved
  8. *
  9. * File    : uCOS_II.H
  10. * By      : Jean J. Labrosse
  11. * Version : V2.86
  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                 286u                /* 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_PDATA_NULL             9u
  255. #define OS_ERR_TIMEOUT               10u
  256. #define OS_ERR_EVENT_NAME_TOO_LONG   11u
  257. #define OS_ERR_PNAME_NULL            12u
  258. #define OS_ERR_PEND_LOCKED           13u
  259. #define OS_ERR_PEND_ABORT            14u
  260. #define OS_ERR_DEL_ISR               15u
  261. #define OS_ERR_CREATE_ISR            16u
  262. #define OS_ERR_NAME_GET_ISR          17u
  263. #define OS_ERR_NAME_SET_ISR          18u
  265. #define OS_ERR_MBOX_FULL             20u
  267. #define OS_ERR_Q_FULL                30u
  268. #define OS_ERR_Q_EMPTY               31u
  270. #define OS_ERR_PRIO_EXIST            40u
  271. #define OS_ERR_PRIO                  41u
  272. #define OS_ERR_PRIO_INVALID          42u
  274. #define OS_ERR_SEM_OVF               50u
  276. #define OS_ERR_TASK_CREATE_ISR       60u
  277. #define OS_ERR_TASK_DEL              61u
  278. #define OS_ERR_TASK_DEL_IDLE         62u
  279. #define OS_ERR_TASK_DEL_REQ          63u
  280. #define OS_ERR_TASK_DEL_ISR          64u
  281. #define OS_ERR_TASK_NAME_TOO_LONG    65u
  282. #define OS_ERR_TASK_NO_MORE_TCB      66u
  283. #define OS_ERR_TASK_NOT_EXIST        67u
  284. #define OS_ERR_TASK_NOT_SUSPENDED    68u
  285. #define OS_ERR_TASK_OPT              69u
  286. #define OS_ERR_TASK_RESUME_PRIO      70u
  287. #define OS_ERR_TASK_SUSPEND_IDLE     71u
  288. #define OS_ERR_TASK_SUSPEND_PRIO     72u
  289. #define OS_ERR_TASK_WAITING          73u
  291. #define OS_ERR_TIME_NOT_DLY          80u
  292. #define OS_ERR_TIME_INVALID_MINUTES  81u
  293. #define OS_ERR_TIME_INVALID_SECONDS  82u
  294. #define OS_ERR_TIME_INVALID_MS       83u
  295. #define OS_ERR_TIME_ZERO_DLY         84u
  296. #define OS_ERR_TIME_DLY_ISR          85u
  298. #define OS_ERR_MEM_INVALID_PART      90u
  299. #define OS_ERR_MEM_INVALID_BLKS      91u
  300. #define OS_ERR_MEM_INVALID_SIZE      92u
  301. #define OS_ERR_MEM_NO_FREE_BLKS      93u
  302. #define OS_ERR_MEM_FULL              94u
  303. #define OS_ERR_MEM_INVALID_PBLK      95u
  304. #define OS_ERR_MEM_INVALID_PMEM      96u
  305. #define OS_ERR_MEM_INVALID_PDATA     97u
  306. #define OS_ERR_MEM_INVALID_ADDR      98u
  307. #define OS_ERR_MEM_NAME_TOO_LONG     99u
  309. #define OS_ERR_NOT_MUTEX_OWNER      100u
  311. #define OS_ERR_FLAG_INVALID_PGRP    110u
  312. #define OS_ERR_FLAG_WAIT_TYPE       111u
  313. #define OS_ERR_FLAG_NOT_RDY         112u
  314. #define OS_ERR_FLAG_INVALID_OPT     113u
  315. #define OS_ERR_FLAG_GRP_DEPLETED    114u
  316. #define OS_ERR_FLAG_NAME_TOO_LONG   115u
  318. #define OS_ERR_PIP_LOWER            120u
  320. #define OS_ERR_TMR_INVALID_DLY      130u
  321. #define OS_ERR_TMR_INVALID_PERIOD   131u
  322. #define OS_ERR_TMR_INVALID_OPT      132u
  323. #define OS_ERR_TMR_INVALID_NAME     133u
  324. #define OS_ERR_TMR_NON_AVAIL        134u
  325. #define OS_ERR_TMR_INACTIVE         135u
  326. #define OS_ERR_TMR_INVALID_DEST     136u
  327. #define OS_ERR_TMR_INVALID_TYPE     137u
  328. #define OS_ERR_TMR_INVALID          138u
  329. #define OS_ERR_TMR_ISR              139u
  330. #define OS_ERR_TMR_NAME_TOO_LONG    140u
  331. #define OS_ERR_TMR_INVALID_STATE    141u
  332. #define OS_ERR_TMR_STOPPED          142u
  333. #define OS_ERR_TMR_NO_CALLBACK      143u
  335. /*
  336. *********************************************************************************************************
  337. *                                    OLD ERROR CODE NAMES (< V2.84)
  338. *********************************************************************************************************
  339. */
  340. #define OS_NO_ERR                    OS_ERR_NONE
  341. #define OS_TIMEOUT                   OS_ERR_TIMEOUT
  342. #define OS_TASK_NOT_EXIST            OS_ERR_TASK_NOT_EXIST
  343. #define OS_MBOX_FULL                 OS_ERR_MBOX_FULL
  344. #define OS_Q_FULL                    OS_ERR_Q_FULL
  345. #define OS_Q_EMPTY                   OS_ERR_Q_EMPTY
  346. #define OS_PRIO_EXIST                OS_ERR_PRIO_EXIST
  347. #define OS_PRIO_ERR                  OS_ERR_PRIO
  348. #define OS_PRIO_INVALID              OS_ERR_PRIO_INVALID
  349. #define OS_SEM_OVF                   OS_ERR_SEM_OVF
  350. #define OS_TASK_DEL_ERR              OS_ERR_TASK_DEL
  351. #define OS_TASK_DEL_IDLE             OS_ERR_TASK_DEL_IDLE
  352. #define OS_TASK_DEL_REQ              OS_ERR_TASK_DEL_REQ
  353. #define OS_TASK_DEL_ISR              OS_ERR_TASK_DEL_ISR
  354. #define OS_NO_MORE_TCB               OS_ERR_TASK_NO_MORE_TCB
  355. #define OS_TIME_NOT_DLY              OS_ERR_TIME_NOT_DLY
  356. #define OS_TIME_INVALID_MINUTES      OS_ERR_TIME_INVALID_MINUTES
  357. #define OS_TIME_INVALID_SECONDS      OS_ERR_TIME_INVALID_SECONDS
  358. #define OS_TIME_INVALID_MS           OS_ERR_TIME_INVALID_MS
  359. #define OS_TIME_ZERO_DLY             OS_ERR_TIME_ZERO_DLY
  360. #define OS_TASK_SUSPEND_PRIO         OS_ERR_TASK_SUSPEND_PRIO
  361. #define OS_TASK_SUSPEND_IDLE         OS_ERR_TASK_SUSPEND_IDLE
  362. #define OS_TASK_RESUME_PRIO          OS_ERR_TASK_RESUME_PRIO
  363. #define OS_TASK_NOT_SUSPENDED        OS_ERR_TASK_NOT_SUSPENDED
  364. #define OS_MEM_INVALID_PART          OS_ERR_MEM_INVALID_PART
  365. #define OS_MEM_INVALID_BLKS          OS_ERR_MEM_INVALID_BLKS
  366. #define OS_MEM_INVALID_SIZE          OS_ERR_MEM_INVALID_SIZE
  367. #define OS_MEM_NO_FREE_BLKS          OS_ERR_MEM_NO_FREE_BLKS
  368. #define OS_MEM_FULL                  OS_ERR_MEM_FULL
  369. #define OS_MEM_INVALID_PBLK          OS_ERR_MEM_INVALID_PBLK
  370. #define OS_MEM_INVALID_PMEM          OS_ERR_MEM_INVALID_PMEM
  371. #define OS_MEM_INVALID_PDATA         OS_ERR_MEM_INVALID_PDATA
  372. #define OS_MEM_INVALID_ADDR          OS_ERR_MEM_INVALID_ADDR
  373. #define OS_MEM_NAME_TOO_LONG         OS_ERR_MEM_NAME_TOO_LONG
  374. #define OS_TASK_OPT_ERR              OS_ERR_TASK_OPT
  375. #define OS_FLAG_INVALID_PGRP         OS_ERR_FLAG_INVALID_PGRP
  376. #define OS_FLAG_ERR_WAIT_TYPE        OS_ERR_FLAG_WAIT_TYPE
  377. #define OS_FLAG_ERR_NOT_RDY          OS_ERR_FLAG_NOT_RDY
  378. #define OS_FLAG_INVALID_OPT          OS_ERR_FLAG_INVALID_OPT
  379. #define OS_FLAG_GRP_DEPLETED         OS_ERR_FLAG_GRP_DEPLETED
  381. /*$PAGE*/
  382. /*
  383. *********************************************************************************************************
  384. *                                          EVENT CONTROL BLOCK
  385. *********************************************************************************************************
  386. */
  388. #if (OS_EVENT_EN) && (OS_MAX_EVENTS > 0)
  389. typedef struct os_event {
  390.     INT8U    OSEventType;                    /* Type of event control block (see OS_EVENT_TYPE_xxxx)    */
  391.     void    *OSEventPtr;                     /* Pointer to message or queue structure                   */
  392.     INT16U   OSEventCnt;                     /* Semaphore Count (not used if other EVENT type)          */
  393. #if OS_LOWEST_PRIO <= 63
  394.     INT8U    OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  395.     INT8U    OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  396. #else
  397.     INT16U   OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  398.     INT16U   OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  399. #endif
  401. #if OS_EVENT_NAME_SIZE > 1
  402.     INT8U    OSEventName[OS_EVENT_NAME_SIZE];
  403. #endif
  404. } OS_EVENT;
  405. #endif
  408. /*
  409. *********************************************************************************************************
  410. *                                       EVENT FLAGS CONTROL BLOCK
  411. *********************************************************************************************************
  412. */
  414. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  416. #if OS_FLAGS_NBITS == 8                     /* Determine the size of OS_FLAGS (8, 16 or 32 bits)       */
  417. typedef  INT8U    OS_FLAGS;
  418. #endif
  420. #if OS_FLAGS_NBITS == 16
  421. typedef  INT16U   OS_FLAGS;
  422. #endif
  424. #if OS_FLAGS_NBITS == 32
  425. typedef  INT32U   OS_FLAGS;
  426. #endif
  429. typedef struct os_flag_grp {                /* Event Flag Group                                        */
  430.     INT8U         OSFlagType;               /* Should be set to OS_EVENT_TYPE_FLAG                     */
  431.     void         *OSFlagWaitList;           /* Pointer to first NODE of task waiting on event flag     */
  432.     OS_FLAGS      OSFlagFlags;              /* 8, 16 or 32 bit flags                                   */
  433. #if OS_FLAG_NAME_SIZE > 1
  434.     INT8U         OSFlagName[OS_FLAG_NAME_SIZE];
  435. #endif
  436. } OS_FLAG_GRP;
  440. typedef struct os_flag_node {               /* Event Flag Wait List Node                               */
  441.     void         *OSFlagNodeNext;           /* Pointer to next     NODE in wait list                   */
  442.     void         *OSFlagNodePrev;           /* Pointer to previous NODE in wait list                   */
  443.     void         *OSFlagNodeTCB;            /* Pointer to TCB of waiting task                          */
  444.     void         *OSFlagNodeFlagGrp;        /* Pointer to Event Flag Group                             */
  445.     OS_FLAGS      OSFlagNodeFlags;          /* Event flag to wait on                                   */
  446.     INT8U         OSFlagNodeWaitType;       /* Type of wait:                                           */
  447.                                             /*      OS_FLAG_WAIT_AND                                   */
  448.                                             /*      OS_FLAG_WAIT_ALL                                   */
  449.                                             /*      OS_FLAG_WAIT_OR                                    */
  450.                                             /*      OS_FLAG_WAIT_ANY                                   */
  451. } OS_FLAG_NODE;
  452. #endif
  454. /*$PAGE*/
  455. /*
  456. *********************************************************************************************************
  457. *                                          MESSAGE MAILBOX DATA
  458. *********************************************************************************************************
  459. */
  461. #if OS_MBOX_EN > 0
  462. typedef struct os_mbox_data {
  463.     void   *OSMsg;                         /* Pointer to message in mailbox                            */
  464. #if OS_LOWEST_PRIO <= 63
  465.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE]; /* List of tasks waiting for event to occur                 */
  466.     INT8U   OSEventGrp;                    /* Group corresponding to tasks waiting for event to occur  */
  467. #else
  468.     INT16U  OSEventTbl[OS_EVENT_TBL_SIZE]; /* List of tasks waiting for event to occur                 */
  469.     INT16U  OSEventGrp;                    /* Group corresponding to tasks waiting for event to occur  */
  470. #endif
  471. } OS_MBOX_DATA;
  472. #endif
  474. /*
  475. *********************************************************************************************************
  476. *                                     MEMORY PARTITION DATA STRUCTURES
  477. *********************************************************************************************************
  478. */
  480. #if (OS_MEM_EN > 0) && (OS_MAX_MEM_PART > 0)
  481. typedef struct os_mem {                   /* MEMORY CONTROL BLOCK                                      */
  482.     void   *OSMemAddr;                    /* Pointer to beginning of memory partition                  */
  483.     void   *OSMemFreeList;                /* Pointer to list of free memory blocks                     */
  484.     INT32U  OSMemBlkSize;                 /* Size (in bytes) of each block of memory                   */
  485.     INT32U  OSMemNBlks;                   /* Total number of blocks in this partition                  */
  486.     INT32U  OSMemNFree;                   /* Number of memory blocks remaining in this partition       */
  487. #if OS_MEM_NAME_SIZE > 1
  488.     INT8U   OSMemName[OS_MEM_NAME_SIZE];  /* Memory partition name                                     */
  489. #endif
  490. } OS_MEM;
  493. typedef struct os_mem_data {
  494.     void   *OSAddr;                    /* Pointer to the beginning address of the memory partition     */
  495.     void   *OSFreeList;                /* Pointer to the beginning of the free list of memory blocks   */
  496.     INT32U  OSBlkSize;                 /* Size (in bytes) of each memory block                         */
  497.     INT32U  OSNBlks;                   /* Total number of blocks in the partition                      */
  498.     INT32U  OSNFree;                   /* Number of memory blocks free                                 */
  499.     INT32U  OSNUsed;                   /* Number of memory blocks used                                 */
  500. } OS_MEM_DATA;
  501. #endif
  503. /*$PAGE*/
  504. /*
  505. *********************************************************************************************************
  506. *                                    MUTUAL EXCLUSION SEMAPHORE DATA
  507. *********************************************************************************************************
  508. */
  510. #if OS_MUTEX_EN > 0
  511. typedef struct os_mutex_data {
  512. #if OS_LOWEST_PRIO <= 63
  513.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  514.     INT8U   OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  515. #else
  516.     INT16U  OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  517.     INT16U  OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  518. #endif
  519.     BOOLEAN OSValue;                        /* Mutex value (OS_FALSE = used, OS_TRUE = available)      */
  520.     INT8U   OSOwnerPrio;                    /* Mutex owner's task priority or 0xFF if no owner         */
  521.     INT8U   OSMutexPIP;                     /* Priority Inheritance Priority or 0xFF if no owner       */
  522. } OS_MUTEX_DATA;
  523. #endif
  525. /*
  526. *********************************************************************************************************
  527. *                                          MESSAGE QUEUE DATA
  528. *********************************************************************************************************
  529. */
  531. #if OS_Q_EN > 0
  532. typedef struct os_q {                   /* QUEUE CONTROL BLOCK                                         */
  533.     struct os_q   *OSQPtr;              /* Link to next queue control block in list of free blocks     */
  534.     void         **OSQStart;            /* Pointer to start of queue data                              */
  535.     void         **OSQEnd;              /* Pointer to end   of queue data                              */
  536.     void         **OSQIn;               /* Pointer to where next message will be inserted  in   the Q  */
  537.     void         **OSQOut;              /* Pointer to where next message will be extracted from the Q  */
  538.     INT16U         OSQSize;             /* Size of queue (maximum number of entries)                   */
  539.     INT16U         OSQEntries;          /* Current number of entries in the queue                      */
  540. } OS_Q;
  543. typedef struct os_q_data {
  544.     void          *OSMsg;               /* Pointer to next message to be extracted from queue          */
  545.     INT16U         OSNMsgs;             /* Number of messages in message queue                         */
  546.     INT16U         OSQSize;             /* Size of message queue                                       */
  547. #if OS_LOWEST_PRIO <= 63
  548.     INT8U          OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur         */
  549.     INT8U          OSEventGrp;          /* Group corresponding to tasks waiting for event to occur     */
  550. #else
  551.     INT16U         OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur         */
  552.     INT16U         OSEventGrp;          /* Group corresponding to tasks waiting for event to occur     */
  553. #endif
  554. } OS_Q_DATA;
  555. #endif
  557. /*
  558. *********************************************************************************************************
  559. *                                           SEMAPHORE DATA
  560. *********************************************************************************************************
  561. */
  563. #if OS_SEM_EN > 0
  564. typedef struct os_sem_data {
  565.     INT16U  OSCnt;                          /* Semaphore count                                         */
  566. #if OS_LOWEST_PRIO <= 63
  567.     INT8U   OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  568.     INT8U   OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  569. #else
  570.     INT16U  OSEventTbl[OS_EVENT_TBL_SIZE];  /* List of tasks waiting for event to occur                */
  571.     INT16U  OSEventGrp;                     /* Group corresponding to tasks waiting for event to occur */
  572. #endif
  573. } OS_SEM_DATA;
  574. #endif
  576. /*
  577. *********************************************************************************************************
  578. *                                            TASK STACK DATA
  579. *********************************************************************************************************
  580. */
  582. #if OS_TASK_CREATE_EXT_EN > 0
  583. typedef struct os_stk_data {
  584.     INT32U  OSFree;                    /* Number of free bytes on the stack                            */
  585.     INT32U  OSUsed;                    /* Number of bytes used on the stack                            */
  586. } OS_STK_DATA;
  587. #endif
  589. /*$PAGE*/
  590. /*
  591. *********************************************************************************************************
  592. *                                          TASK CONTROL BLOCK
  593. *********************************************************************************************************
  594. */
  596. typedef struct os_tcb {
  597.     OS_STK          *OSTCBStkPtr;           /* Pointer to current top of stack                         */
  599. #if OS_TASK_CREATE_EXT_EN > 0
  600.     void            *OSTCBExtPtr;           /* Pointer to user definable data for TCB extension        */
  601.     OS_STK          *OSTCBStkBottom;        /* Pointer to bottom of stack                              */
  602.     INT32U           OSTCBStkSize;          /* Size of task stack (in number of stack elements)        */
  603.     INT16U           OSTCBOpt;              /* Task options as passed by OSTaskCreateExt()             */
  604.     INT16U           OSTCBId;               /* Task ID (0..65535)                                      */
  605. #endif
  607.     struct os_tcb   *OSTCBNext;             /* Pointer to next     TCB in the TCB list                 */
  608.     struct os_tcb   *OSTCBPrev;             /* Pointer to previous TCB in the TCB list                 */
  610. #if (OS_EVENT_EN) || (OS_FLAG_EN > 0)
  611.     OS_EVENT        *OSTCBEventPtr;         /* Pointer to          event control block                 */
  612. #endif
  614. #if (OS_EVENT_EN) && (OS_EVENT_MULTI_EN > 0)
  615.     OS_EVENT       **OSTCBEventMultiPtr;    /* Pointer to multiple event control blocks                */
  616. #endif
  618. #if ((OS_Q_EN > 0) && (OS_MAX_QS > 0)) || (OS_MBOX_EN > 0)
  619.     void            *OSTCBMsg;              /* Message received from OSMboxPost() or OSQPost()         */
  620. #endif
  622. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  623. #if OS_TASK_DEL_EN > 0
  624.     OS_FLAG_NODE    *OSTCBFlagNode;         /* Pointer to event flag node                              */
  625. #endif
  626.     OS_FLAGS         OSTCBFlagsRdy;         /* Event flags that made task ready to run                 */
  627. #endif
  629.     INT16U           OSTCBDly;              /* Nbr ticks to delay task or, timeout waiting for event   */
  630.     INT8U            OSTCBStat;             /* Task      status                                        */
  631.     INT8U            OSTCBStatPend;         /* Task PEND status                                        */
  632.     INT8U            OSTCBPrio;             /* Task priority (0 == highest)                            */
  634.     INT8U            OSTCBX;                /* Bit position in group  corresponding to task priority   */
  635.     INT8U            OSTCBY;                /* Index into ready table corresponding to task priority   */
  636. #if OS_LOWEST_PRIO <= 63
  637.     INT8U            OSTCBBitX;             /* Bit mask to access bit position in ready table          */
  638.     INT8U            OSTCBBitY;             /* Bit mask to access bit position in ready group          */
  639. #else
  640.     INT16U           OSTCBBitX;             /* Bit mask to access bit position in ready table          */
  641.     INT16U           OSTCBBitY;             /* Bit mask to access bit position in ready group          */
  642. #endif
  644. #if OS_TASK_DEL_EN > 0
  645.     INT8U            OSTCBDelReq;           /* Indicates whether a task needs to delete itself         */
  646. #endif
  648. #if OS_TASK_PROFILE_EN > 0
  649.     INT32U           OSTCBCtxSwCtr;         /* Number of time the task was switched in                 */
  650.     INT32U           OSTCBCyclesTot;        /* Total number of clock cycles the task has been running  */
  651.     INT32U           OSTCBCyclesStart;      /* Snapshot of cycle counter at start of task resumption   */
  652.     OS_STK          *OSTCBStkBase;          /* Pointer to the beginning of the task stack              */
  653.     INT32U           OSTCBStkUsed;          /* Number of bytes used from the stack                     */
  654. #endif
  656. #if OS_TASK_NAME_SIZE > 1
  657.     INT8U            OSTCBTaskName[OS_TASK_NAME_SIZE];
  658. #endif
  659. } OS_TCB;
  661. /*$PAGE*/
  662. /*
  663. ************************************************************************************************************************
  664. *                                                   TIMER DATA TYPES
  665. ************************************************************************************************************************
  666. */
  668. #if OS_TMR_EN > 0
  669. typedef  void (*OS_TMR_CALLBACK)(void *ptmr, void *parg);
  673. typedef  struct  os_tmr {
  674.     INT8U            OSTmrType;                       /* Should be set to OS_TMR_TYPE                                  */
  675.     OS_TMR_CALLBACK  OSTmrCallback;                   /* Function to call when timer expires                           */
  676.     void            *OSTmrCallbackArg;                /* Argument to pass to function when timer expires               */
  677.     void            *OSTmrNext;                       /* Double link list pointers                                     */
  678.     void            *OSTmrPrev;
  679.     INT32U           OSTmrMatch;                      /* Timer expires when OSTmrTime == OSTmrMatch                    */
  680.     INT32U           OSTmrDly;                        /* Delay time before periodic update starts                      */
  681.     INT32U           OSTmrPeriod;                     /* Period to repeat timer                                        */
  682. #if OS_TMR_CFG_NAME_SIZE > 0
  683.     INT8U            OSTmrName[OS_TMR_CFG_NAME_SIZE]; /* Name to give the timer                                        */
  684. #endif
  685.     INT8U            OSTmrOpt;                        /* Options (see OS_TMR_OPT_xxx)                                  */
  686.     INT8U            OSTmrState;                      /* Indicates the state of the timer:                             */
  687.                                                       /*     OS_TMR_STATE_UNUSED                                       */
  688.                                                       /*     OS_TMR_STATE_RUNNING                                      */
  689.                                                       /*     OS_TMR_STATE_STOPPED                                      */
  690. } OS_TMR;
  694. typedef  struct  os_tmr_wheel {
  695.     OS_TMR          *OSTmrFirst;                      /* Pointer to first timer in linked list                         */
  696.     INT16U           OSTmrEntries;
  697. } OS_TMR_WHEEL;
  698. #endif
  700. /*$PAGE*/
  701. /*
  702. *********************************************************************************************************
  703. *                                            GLOBAL VARIABLES
  704. *********************************************************************************************************
  705. */
  707. OS_EXT  INT32U            OSCtxSwCtr;               /* Counter of number of context switches           */
  709. #if (OS_EVENT_EN) && (OS_MAX_EVENTS > 0)
  710. OS_EXT  OS_EVENT         *OSEventFreeList;          /* Pointer to list of free EVENT control blocks    */
  711. OS_EXT  OS_EVENT          OSEventTbl[OS_MAX_EVENTS];/* Table of EVENT control blocks                   */
  712. #endif
  714. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  715. OS_EXT  OS_FLAG_GRP       OSFlagTbl[OS_MAX_FLAGS];  /* Table containing event flag groups              */
  716. OS_EXT  OS_FLAG_GRP      *OSFlagFreeList;           /* Pointer to free list of event flag groups       */
  717. #endif
  719. #if OS_TASK_STAT_EN > 0
  720. OS_EXT  INT8U             OSCPUUsage;               /* Percentage of CPU used                          */
  721. OS_EXT  INT32U            OSIdleCtrMax;             /* Max. value that idle ctr can take in 1 sec.     */
  722. OS_EXT  INT32U            OSIdleCtrRun;             /* Val. reached by idle ctr at run time in 1 sec.  */
  723. OS_EXT  BOOLEAN           OSStatRdy;                /* Flag indicating that the statistic task is rdy  */
  724. OS_EXT  OS_STK            OSTaskStatStk[OS_TASK_STAT_STK_SIZE];      /* Statistics task stack          */
  725. #endif
  727. OS_EXT  INT8U             OSIntNesting;             /* Interrupt nesting level                         */
  729. OS_EXT  INT8U             OSLockNesting;            /* Multitasking lock nesting level                 */
  731. OS_EXT  INT8U             OSPrioCur;                /* Priority of current task                        */
  732. OS_EXT  INT8U             OSPrioHighRdy;            /* Priority of highest priority task               */
  734. #if OS_LOWEST_PRIO <= 63
  735. OS_EXT  INT8U             OSRdyGrp;                        /* Ready list group                         */
  736. OS_EXT  INT8U             OSRdyTbl[OS_RDY_TBL_SIZE];       /* Table of tasks which are ready to run    */
  737. #else
  738. OS_EXT  INT16U            OSRdyGrp;                        /* Ready list group                         */
  739. OS_EXT  INT16U            OSRdyTbl[OS_RDY_TBL_SIZE];       /* Table of tasks which are ready to run    */
  740. #endif
  742. OS_EXT  BOOLEAN           OSRunning;                       /* Flag indicating that kernel is running   */
  744. OS_EXT  INT8U             OSTaskCtr;                       /* Number of tasks created                  */
  746. OS_EXT  volatile  INT32U  OSIdleCtr;                                 /* Idle counter                   */
  748. OS_EXT  OS_STK            OSTaskIdleStk[OS_TASK_IDLE_STK_SIZE];      /* Idle task stack                */
  751. OS_EXT  OS_TCB           *OSTCBCur;                        /* Pointer to currently running TCB         */
  752. OS_EXT  OS_TCB           *OSTCBFreeList;                   /* Pointer to list of free TCBs             */
  753. OS_EXT  OS_TCB           *OSTCBHighRdy;                    /* Pointer to highest priority TCB R-to-R   */
  754. OS_EXT  OS_TCB           *OSTCBList;                       /* Pointer to doubly linked list of TCBs    */
  755. OS_EXT  OS_TCB           *OSTCBPrioTbl[OS_LOWEST_PRIO + 1];/* Table of pointers to created TCBs        */
  756. OS_EXT  OS_TCB            OSTCBTbl[OS_MAX_TASKS + OS_N_SYS_TASKS];   /* Table of TCBs                  */
  758. #if OS_TICK_STEP_EN > 0
  759. OS_EXT  INT8U             OSTickStepState;          /* Indicates the state of the tick step feature    */
  760. #endif
  762. #if (OS_MEM_EN > 0) && (OS_MAX_MEM_PART > 0)
  763. OS_EXT  OS_MEM           *OSMemFreeList;            /* Pointer to free list of memory partitions       */
  764. OS_EXT  OS_MEM            OSMemTbl[OS_MAX_MEM_PART];/* Storage for memory partition manager            */
  765. #endif
  767. #if (OS_Q_EN > 0) && (OS_MAX_QS > 0)
  768. OS_EXT  OS_Q             *OSQFreeList;              /* Pointer to list of free QUEUE control blocks    */
  769. OS_EXT  OS_Q              OSQTbl[OS_MAX_QS];        /* Table of QUEUE control blocks                   */
  770. #endif
  772. #if OS_TIME_GET_SET_EN > 0
  773. OS_EXT  volatile  INT32U  OSTime;                   /* Current value of system time (in ticks)         */
  774. #endif
  776. #if OS_TMR_EN > 0
  777. OS_EXT  INT16U            OSTmrFree;                /* Number of free entries in the timer pool        */
  778. OS_EXT  INT16U            OSTmrUsed;                /* Number of timers used                           */
  779. OS_EXT  INT32U            OSTmrTime;                /* Current timer time                              */
  781. OS_EXT  OS_EVENT         *OSTmrSem;                 /* Sem. used to gain exclusive access to timers    */
  782. OS_EXT  OS_EVENT         *OSTmrSemSignal;           /* Sem. used to signal the update of timers        */
  784. OS_EXT  OS_TMR            OSTmrTbl[OS_TMR_CFG_MAX]; /* Table containing pool of timers                 */
  785. OS_EXT  OS_TMR           *OSTmrFreeList;            /* Pointer to free list of timers                  */
  786. OS_EXT  OS_STK            OSTmrTaskStk[OS_TASK_TMR_STK_SIZE];
  788. OS_EXT  OS_TMR_WHEEL      OSTmrWheelTbl[OS_TMR_CFG_WHEEL_SIZE];
  789. #endif
  791. extern  INT8U   const     OSUnMapTbl[256];          /* Priority->Index    lookup table                 */
  793. /*$PAGE*/
  794. /*
  795. *********************************************************************************************************
  796. *                                          FUNCTION PROTOTYPES
  797. *                                     (Target Independent Functions)
  798. *********************************************************************************************************
  799. */
  801. /*
  802. *********************************************************************************************************
  803. *                                            MISCELLANEOUS
  804. *********************************************************************************************************
  805. */
  807. #if (OS_EVENT_EN)
  809. #if (OS_EVENT_NAME_SIZE > 1)
  810. INT8U         OSEventNameGet          (OS_EVENT        *pevent,
  811.                                        INT8U           *pname,
  812.                                        INT8U           *perr);
  814. void          OSEventNameSet          (OS_EVENT        *pevent,
  815.                                        INT8U           *pname,
  816.                                        INT8U           *perr);
  817. #endif
  819. #if (OS_EVENT_MULTI_EN > 0)
  820. INT16U        OSEventPendMulti        (OS_EVENT       **pevents_pend,
  821.                                        OS_EVENT       **pevents_rdy,
  822.                                        void           **pmsgs_rdy,
  823.                                        INT16U           timeout,
  824.                                        INT8U           *perr);
  825. #endif
  827. #endif
  829. /*
  830. *********************************************************************************************************
  831. *                                         EVENT FLAGS MANAGEMENT
  832. *********************************************************************************************************
  833. */
  835. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  837. #if OS_FLAG_ACCEPT_EN > 0
  838. OS_FLAGS      OSFlagAccept            (OS_FLAG_GRP     *pgrp,
  839.                                        OS_FLAGS         flags,
  840.                                        INT8U            wait_type,
  841.                                        INT8U           *perr);
  842. #endif
  844. OS_FLAG_GRP  *OSFlagCreate            (OS_FLAGS         flags,
  845.                                       INT8U            *perr);
  847. #if OS_FLAG_DEL_EN > 0
  848. OS_FLAG_GRP  *OSFlagDel               (OS_FLAG_GRP     *pgrp,
  849.                                        INT8U            opt,
  850.                                        INT8U           *perr);
  851. #endif
  853. #if (OS_FLAG_EN > 0) && (OS_FLAG_NAME_SIZE > 1)
  854. INT8U         OSFlagNameGet           (OS_FLAG_GRP     *pgrp,
  855.                                        INT8U           *pname,
  856.                                        INT8U           *perr);
  858. void          OSFlagNameSet           (OS_FLAG_GRP     *pgrp,
  859.                                        INT8U           *pname,
  860.                                        INT8U           *perr);
  861. #endif
  863. OS_FLAGS      OSFlagPend              (OS_FLAG_GRP     *pgrp,
  864.                                        OS_FLAGS         flags,
  865.                                        INT8U            wait_type,
  866.                                        INT16U           timeout,
  867.                                        INT8U           *perr);
  869. OS_FLAGS      OSFlagPendGetFlagsRdy   (void);
  870. OS_FLAGS      OSFlagPost              (OS_FLAG_GRP     *pgrp,
  871.                                        OS_FLAGS         flags,
  872.                                        INT8U            opt,
  873.                                        INT8U           *perr);
  875. #if OS_FLAG_QUERY_EN > 0
  876. OS_FLAGS      OSFlagQuery             (OS_FLAG_GRP     *pgrp,
  877.                                        INT8U           *perr);
  878. #endif
  879. #endif
  881. /*
  882. *********************************************************************************************************
  883. *                                        MESSAGE MAILBOX MANAGEMENT
  884. *********************************************************************************************************
  885. */
  887. #if OS_MBOX_EN > 0
  889. #if OS_MBOX_ACCEPT_EN > 0
  890. void         *OSMboxAccept            (OS_EVENT        *pevent);
  891. #endif
  893. OS_EVENT     *OSMboxCreate            (void            *pmsg);
  895. #if OS_MBOX_DEL_EN > 0
  896. OS_EVENT     *OSMboxDel               (OS_EVENT        *pevent,
  897.                                        INT8U            opt,
  898.                                        INT8U           *perr);
  899. #endif
  901. void         *OSMboxPend              (OS_EVENT        *pevent,
  902.                                        INT16U           timeout,
  903.                                        INT8U           *perr);
  905. #if OS_MBOX_PEND_ABORT_EN > 0
  906. INT8U         OSMboxPendAbort         (OS_EVENT        *pevent,
  907.                                        INT8U            opt,
  908.                                        INT8U           *perr);
  909. #endif
  911. #if OS_MBOX_POST_EN > 0
  912. INT8U         OSMboxPost              (OS_EVENT        *pevent,
  913.                                        void            *pmsg);
  914. #endif
  916. #if OS_MBOX_POST_OPT_EN > 0
  917. INT8U         OSMboxPostOpt           (OS_EVENT        *pevent,
  918.                                        void            *pmsg,
  919.                                        INT8U            opt);
  920. #endif
  922. #if OS_MBOX_QUERY_EN > 0
  923. INT8U         OSMboxQuery             (OS_EVENT        *pevent,
  924.                                        OS_MBOX_DATA    *p_mbox_data);
  925. #endif
  926. #endif
  928. /*
  929. *********************************************************************************************************
  930. *                                           MEMORY MANAGEMENT
  931. *********************************************************************************************************
  932. */
  934. #if (OS_MEM_EN > 0) && (OS_MAX_MEM_PART > 0)
  936. OS_MEM       *OSMemCreate             (void            *addr,
  937.                                        INT32U           nblks,
  938.                                        INT32U           blksize,
  939.                                        INT8U           *perr);
  941. void         *OSMemGet                (OS_MEM          *pmem,
  942.                                        INT8U           *perr);
  943. #if OS_MEM_NAME_SIZE > 1
  944. INT8U         OSMemNameGet            (OS_MEM          *pmem,
  945.                                        INT8U           *pname,
  946.                                        INT8U           *perr);
  948. void          OSMemNameSet            (OS_MEM          *pmem,
  949.                                        INT8U           *pname,
  950.                                        INT8U           *perr);
  951. #endif
  952. INT8U         OSMemPut                (OS_MEM          *pmem,
  953.                                        void            *pblk);
  955. #if OS_MEM_QUERY_EN > 0
  956. INT8U         OSMemQuery              (OS_MEM          *pmem,
  957.                                        OS_MEM_DATA     *p_mem_data);
  958. #endif
  960. #endif
  962. /*
  963. *********************************************************************************************************
  964. *                                MUTUAL EXCLUSION SEMAPHORE MANAGEMENT
  965. *********************************************************************************************************
  966. */
  968. #if OS_MUTEX_EN > 0
  970. #if OS_MUTEX_ACCEPT_EN > 0
  971. BOOLEAN       OSMutexAccept           (OS_EVENT        *pevent,
  972.                                        INT8U           *perr);
  973. #endif
  975. OS_EVENT     *OSMutexCreate           (INT8U            prio,
  976.                                        INT8U           *perr);
  978. #if OS_MUTEX_DEL_EN > 0
  979. OS_EVENT     *OSMutexDel              (OS_EVENT        *pevent,
  980.                                        INT8U            opt,
  981.                                        INT8U           *perr);
  982. #endif
  984. void          OSMutexPend             (OS_EVENT        *pevent,
  985.                                        INT16U           timeout,
  986.                                        INT8U           *perr);
  988. INT8U         OSMutexPost             (OS_EVENT        *pevent);
  990. #if OS_MUTEX_QUERY_EN > 0
  991. INT8U         OSMutexQuery            (OS_EVENT        *pevent,
  992.                                        OS_MUTEX_DATA   *p_mutex_data);
  993. #endif
  995. #endif
  997. /*$PAGE*/
  998. /*
  999. *********************************************************************************************************
  1000. *                                         MESSAGE QUEUE MANAGEMENT
  1001. *********************************************************************************************************
  1002. */
  1004. #if (OS_Q_EN > 0) && (OS_MAX_QS > 0)
  1006. #if OS_Q_ACCEPT_EN > 0
  1007. void         *OSQAccept               (OS_EVENT        *pevent,
  1008.                                        INT8U           *perr);
  1009. #endif
  1011. OS_EVENT     *OSQCreate               (void           **start,
  1012.                                        INT16U           size);
  1014. #if OS_Q_DEL_EN > 0
  1015. OS_EVENT     *OSQDel                  (OS_EVENT        *pevent,
  1016.                                        INT8U            opt,
  1017.                                        INT8U           *perr);
  1018. #endif
  1020. #if OS_Q_FLUSH_EN > 0
  1021. INT8U         OSQFlush                (OS_EVENT        *pevent);
  1022. #endif
  1024. void         *OSQPend                 (OS_EVENT        *pevent,
  1025.                                        INT16U           timeout,
  1026.                                        INT8U           *perr);
  1028. #if OS_Q_PEND_ABORT_EN > 0
  1029. INT8U         OSQPendAbort            (OS_EVENT        *pevent,
  1030.                                        INT8U            opt,
  1031.                                        INT8U           *perr);
  1032. #endif
  1034. #if OS_Q_POST_EN > 0
  1035. INT8U         OSQPost                 (OS_EVENT        *pevent,
  1036.                                        void            *pmsg);
  1037. #endif
  1039. #if OS_Q_POST_FRONT_EN > 0
  1040. INT8U         OSQPostFront            (OS_EVENT        *pevent,
  1041.                                        void            *pmsg);
  1042. #endif
  1044. #if OS_Q_POST_OPT_EN > 0
  1045. INT8U         OSQPostOpt              (OS_EVENT        *pevent,
  1046.                                        void            *pmsg,
  1047.                                        INT8U            opt);
  1048. #endif
  1050. #if OS_Q_QUERY_EN > 0
  1051. INT8U         OSQQuery                (OS_EVENT        *pevent,
  1052.                                        OS_Q_DATA       *p_q_data);
  1053. #endif
  1055. #endif
  1057. /*$PAGE*/
  1058. /*
  1059. *********************************************************************************************************
  1060. *                                          SEMAPHORE MANAGEMENT
  1061. *********************************************************************************************************
  1062. */
  1063. #if OS_SEM_EN > 0
  1065. #if OS_SEM_ACCEPT_EN > 0
  1066. INT16U        OSSemAccept             (OS_EVENT        *pevent);
  1067. #endif
  1069. OS_EVENT     *OSSemCreate             (INT16U           cnt);
  1071. #if OS_SEM_DEL_EN > 0
  1072. OS_EVENT     *OSSemDel                (OS_EVENT        *pevent,
  1073.                                        INT8U            opt,
  1074.                                        INT8U           *perr);
  1075. #endif
  1077. void          OSSemPend               (OS_EVENT        *pevent,
  1078.                                        INT16U           timeout,
  1079.                                        INT8U           *perr);
  1081. #if OS_SEM_PEND_ABORT_EN > 0
  1082. INT8U         OSSemPendAbort          (OS_EVENT        *pevent,
  1083.                                        INT8U            opt,
  1084.                                        INT8U           *perr);
  1085. #endif
  1087. INT8U         OSSemPost               (OS_EVENT        *pevent);
  1089. #if OS_SEM_QUERY_EN > 0
  1090. INT8U         OSSemQuery              (OS_EVENT        *pevent,
  1091.                                        OS_SEM_DATA     *p_sem_data);
  1092. #endif
  1094. #if OS_SEM_SET_EN > 0
  1095. void          OSSemSet                (OS_EVENT        *pevent,
  1096.                                        INT16U           cnt,
  1097.                                        INT8U           *perr);
  1098. #endif
  1100. #endif
  1102. /*$PAGE*/
  1103. /*
  1104. *********************************************************************************************************
  1105. *                                            TASK MANAGEMENT
  1106. *********************************************************************************************************
  1107. */
  1108. #if OS_TASK_CHANGE_PRIO_EN > 0
  1109. INT8U         OSTaskChangePrio        (INT8U            oldprio,
  1110.                                        INT8U            newprio);
  1111. #endif
  1113. #if OS_TASK_CREATE_EN > 0
  1114. INT8U         OSTaskCreate            (void           (*task)(void *p_arg),
  1115.                                        void            *p_arg,
  1116.                                        OS_STK          *ptos,
  1117.                                        INT8U            prio);
  1118. #endif
  1120. #if OS_TASK_CREATE_EXT_EN > 0
  1121. INT8U         OSTaskCreateExt         (void           (*task)(void *p_arg),
  1122.                                        void            *p_arg,
  1123.                                        OS_STK          *ptos,
  1124.                                        INT8U            prio,
  1125.                                        INT16U           id,
  1126.                                        OS_STK          *pbos,
  1127.                                        INT32U           stk_size,
  1128.                                        void            *pext,
  1129.                                        INT16U           opt);
  1130. #endif
  1132. #if OS_TASK_DEL_EN > 0
  1133. INT8U         OSTaskDel               (INT8U            prio);
  1134. INT8U         OSTaskDelReq            (INT8U            prio);
  1135. #endif
  1137. #if OS_TASK_NAME_SIZE > 1
  1138. INT8U         OSTaskNameGet           (INT8U            prio,
  1139.                                        INT8U           *pname,
  1140.                                        INT8U           *perr);
  1142. void          OSTaskNameSet           (INT8U            prio,
  1143.                                        INT8U           *pname,
  1144.                                        INT8U           *perr);
  1145. #endif
  1147. #if OS_TASK_SUSPEND_EN > 0
  1148. INT8U         OSTaskResume            (INT8U            prio);
  1149. INT8U         OSTaskSuspend           (INT8U            prio);
  1150. #endif
  1152. #if (OS_TASK_STAT_STK_CHK_EN > 0) && (OS_TASK_CREATE_EXT_EN > 0)
  1153. INT8U         OSTaskStkChk            (INT8U            prio,
  1154.                                        OS_STK_DATA     *p_stk_data);
  1155. #endif
  1157. #if OS_TASK_QUERY_EN > 0
  1158. INT8U         OSTaskQuery             (INT8U            prio,
  1159.                                        OS_TCB          *p_task_data);
  1160. #endif
  1162. /*$PAGE*/
  1163. /*
  1164. *********************************************************************************************************
  1165. *                                            TIME MANAGEMENT
  1166. *********************************************************************************************************
  1167. */
  1169. void          OSTimeDly               (INT16U           ticks);
  1171. #if OS_TIME_DLY_HMSM_EN > 0
  1172. INT8U         OSTimeDlyHMSM           (INT8U            hours,
  1173.                                        INT8U            minutes,
  1174.                                        INT8U            seconds,
  1175.                                        INT16U           milli);
  1176. #endif
  1178. #if OS_TIME_DLY_RESUME_EN > 0
  1179. INT8U         OSTimeDlyResume         (INT8U            prio);
  1180. #endif
  1182. #if OS_TIME_GET_SET_EN > 0
  1183. INT32U        OSTimeGet               (void);
  1184. void          OSTimeSet               (INT32U           ticks);
  1185. #endif
  1187. void          OSTimeTick              (void);
  1189. /*
  1190. *********************************************************************************************************
  1191. *                                            TIMER MANAGEMENT
  1192. *********************************************************************************************************
  1193. */
  1195. #if OS_TMR_EN > 0
  1196. OS_TMR      *OSTmrCreate              (INT32U           dly,
  1197.                                        INT32U           period,
  1198.                                        INT8U            opt,
  1199.                                        OS_TMR_CALLBACK  callback,
  1200.                                        void            *callback_arg,
  1201.                                        INT8U           *pname,
  1202.                                        INT8U           *perr);
  1204. BOOLEAN      OSTmrDel                 (OS_TMR          *ptmr,
  1205.                                        INT8U           *perr);
  1207. #if OS_TMR_CFG_NAME_SIZE > 0
  1208. INT8U        OSTmrNameGet             (OS_TMR          *ptmr,
  1209.                                        INT8U           *pdest,
  1210.                                        INT8U           *perr);
  1211. #endif
  1212. INT32U       OSTmrRemainGet           (OS_TMR          *ptmr,
  1213.                                        INT8U           *perr);
  1215. INT8U        OSTmrStateGet            (OS_TMR          *ptmr,
  1216.                                        INT8U           *perr);
  1218. BOOLEAN      OSTmrStart               (OS_TMR          *ptmr,
  1219.                                        INT8U           *perr);
  1221. BOOLEAN      OSTmrStop                (OS_TMR          *ptmr,
  1222.                                        INT8U            opt,
  1223.                                        void            *callback_arg,
  1224.                                        INT8U           *perr);
  1226. INT8U        OSTmrSignal              (void);
  1227. #endif
  1229. /*
  1230. *********************************************************************************************************
  1231. *                                             MISCELLANEOUS
  1232. *********************************************************************************************************
  1233. */
  1235. void          OSInit                  (void);
  1237. void          OSIntEnter              (void);
  1238. void          OSIntExit               (void);
  1240. #if OS_SCHED_LOCK_EN > 0
  1241. void          OSSchedLock             (void);
  1242. void          OSSchedUnlock           (void);
  1243. #endif
  1245. void          OSStart                 (void);
  1247. void          OSStatInit              (void);
  1249. INT16U        OSVersion               (void);
  1251. /*$PAGE*/
  1252. /*
  1253. *********************************************************************************************************
  1254. *                                      INTERNAL FUNCTION PROTOTYPES
  1255. *                            (Your application MUST NOT call these functions)
  1256. *********************************************************************************************************
  1257. */
  1259. #if OS_TASK_DEL_EN > 0
  1260. void          OS_Dummy                (void);
  1261. #endif
  1263. #if (OS_EVENT_EN)
  1264. INT8U         OS_EventTaskRdy         (OS_EVENT        *pevent,
  1265.                                        void            *pmsg,
  1266.                                        INT8U            msk,
  1267.                                        INT8U            pend_stat);
  1269. void          OS_EventTaskWait        (OS_EVENT        *pevent);
  1271. void          OS_EventTaskRemove      (OS_TCB          *ptcb,
  1272.                                        OS_EVENT        *pevent);
  1274. #if (OS_EVENT_MULTI_EN > 0)
  1275. void          OS_EventTaskWaitMulti   (OS_EVENT       **pevents_wait);
  1277. void          OS_EventTaskRemoveMulti (OS_TCB          *ptcb,
  1278.                                        OS_EVENT       **pevents_multi);
  1279. #endif
  1281. void          OS_EventWaitListInit    (OS_EVENT        *pevent);
  1282. #endif
  1284. #if (OS_FLAG_EN > 0) && (OS_MAX_FLAGS > 0)
  1285. void          OS_FlagInit             (void);
  1286. void          OS_FlagUnlink           (OS_FLAG_NODE    *pnode);
  1287. #endif
  1289. void          OS_MemClr               (INT8U           *pdest,
  1290.                                        INT16U           size);
  1292. void          OS_MemCopy              (INT8U           *pdest,
  1293.                                        INT8U           *psrc,
  1294.                                        INT16U           size);
  1296. #if (OS_MEM_EN > 0) && (OS_MAX_MEM_PART > 0)
  1297. void          OS_MemInit              (void);
  1298. #endif
  1300. #if OS_Q_EN > 0
  1301. void          OS_QInit                (void);
  1302. #endif
  1304. void          OS_Sched                (void);
  1306. #if (OS_EVENT_NAME_SIZE > 1) || (OS_FLAG_NAME_SIZE > 1) || (OS_MEM_NAME_SIZE > 1) || (OS_TASK_NAME_SIZE > 1)
  1307. INT8U         OS_StrCopy              (INT8U           *pdest,
  1308.                                        INT8U           *psrc);
  1310. INT8U         OS_StrLen               (INT8U           *psrc);
  1311. #endif
  1313. void          OS_TaskIdle             (void            *p_arg);
  1315. #if OS_TASK_STAT_EN > 0
  1316. void          OS_TaskStat             (void            *p_arg);
  1317. #endif
  1319. #if (OS_TASK_STAT_STK_CHK_EN > 0) && (OS_TASK_CREATE_EXT_EN > 0)
  1320. void          OS_TaskStkClr           (OS_STK          *pbos,
  1321.                                        INT32U           size,
  1322.                                        INT16U           opt);
  1323. #endif
  1325. #if (OS_TASK_STAT_STK_CHK_EN > 0) && (OS_TASK_CREATE_EXT_EN > 0)
  1326. void          OS_TaskStatStkChk       (void);
  1327. #endif
  1329. INT8U         OS_TCBInit              (INT8U            prio,
  1330.                                        OS_STK          *ptos,
  1331.                                        OS_STK          *pbos,
  1332.                                        INT16U           id,
  1333.                                        INT32U           stk_size,
  1334.                                        void            *pext,
  1335.                                        INT16U           opt);
  1337. #if OS_TMR_EN > 0
  1338. void          OSTmr_Init              (void);
  1339. #endif
  1341. /*$PAGE*/
  1342. /*
  1343. *********************************************************************************************************
  1344. *                                          FUNCTION PROTOTYPES
  1345. *                                      (Target Specific Functions)
  1346. *********************************************************************************************************
  1347. */
  1349. #if OS_DEBUG_EN > 0
  1350. void          OSDebugInit             (void);
  1351. #endif
  1353. void          OSInitHookBegin         (void);
  1354. void          OSInitHookEnd           (void);
  1356. void          OSTaskCreateHook        (OS_TCB          *ptcb);
  1357. void          OSTaskDelHook           (OS_TCB          *ptcb);
  1359. void          OSTaskIdleHook          (void);
  1361. void          OSTaskStatHook          (void);
  1362. OS_STK       *OSTaskStkInit           (void           (*task)(void *p_arg),
  1363.                                        void            *p_arg,
  1364.                                        OS_STK          *ptos,
  1365.                                        INT16U           opt);
  1367. #if OS_TASK_SW_HOOK_EN > 0
  1368. void          OSTaskSwHook            (void);
  1369. #endif
  1371. void          OSTCBInitHook           (OS_TCB          *ptcb);
  1373. #if OS_TIME_TICK_HOOK_EN > 0
  1374. void          OSTimeTickHook          (void);
  1375. #endif
  1377. /*$PAGE*/
  1378. /*
  1379. *********************************************************************************************************
  1380. *                                          FUNCTION PROTOTYPES
  1381. *                                   (Application Specific Functions)
  1382. *********************************************************************************************************
  1383. */
  1385. #if OS_APP_HOOKS_EN > 0
  1386. void          App_TaskCreateHook      (OS_TCB          *ptcb);
  1387. void          App_TaskDelHook         (OS_TCB          *ptcb);
  1388. void          App_TaskIdleHook        (void);
  1390. void          App_TaskStatHook        (void);
  1392. #if OS_TASK_SW_HOOK_EN > 0
  1393. void          App_TaskSwHook          (void);
  1394. #endif
  1396. void          App_TCBInitHook         (OS_TCB          *ptcb);
  1398. #if OS_TIME_TICK_HOOK_EN > 0
  1399. void          App_TimeTickHook        (void);
  1400. #endif
  1401. #endif
  1403. /*
  1404. *********************************************************************************************************
  1405. *                                          FUNCTION PROTOTYPES
  1406. *
  1407. * IMPORTANT: These prototypes MUST be placed in OS_CPU.H
  1408. *********************************************************************************************************
  1409. */
  1411. #if 0
  1412. void          OSStartHighRdy          (void);
  1413. void          OSIntCtxSw              (void);
  1414. void          OSCtxSw                 (void);
  1415. #endif
  1417. /*$PAGE*/
  1418. /*
  1419. *********************************************************************************************************
  1420. *                                   LOOK FOR MISSING #define CONSTANTS
  1421. *
  1422. * This section is used to generate ERROR messages at compile time if certain #define constants are
  1423. * MISSING in OS_CFG.H.  This allows you to quickly determine the source of the error.
  1424. *
  1425. * You SHOULD NOT change this section UNLESS you would like to add more comments as to the source of the
  1426. * compile time error.
  1427. *********************************************************************************************************
  1428. */
  1430. /*
  1431. *********************************************************************************************************
  1432. *                                            EVENT FLAGS
  1433. *********************************************************************************************************
  1434. */
  1436. #ifndef OS_FLAG_EN
  1437. #error  "OS_CFG.H, Missing OS_FLAG_EN: Enable (1) or Disable (0) code generation for Event Flags"
  1438. #else
  1439.     #ifndef OS_MAX_FLAGS
  1440.     #error  "OS_CFG.H, Missing OS_MAX_FLAGS: Max. number of Event Flag Groups in your application"
  1441.     #else
  1442.         #if     OS_MAX_FLAGS > 65500u
  1443.         #error  "OS_CFG.H, OS_MAX_FLAGS must be <= 65500"
  1444.         #endif
  1445.     #endif
  1447.     #ifndef OS_FLAGS_NBITS
  1448.     #error  "OS_CFG.H, Missing OS_FLAGS_NBITS: Determine #bits used for event flags, MUST be either 8, 16 or 32"
  1449.     #endif
  1451.     #ifndef OS_FLAG_WAIT_CLR_EN
  1452.     #error  "OS_CFG.H, Missing OS_FLAG_WAIT_CLR_EN: Include code for Wait on Clear EVENT FLAGS"
  1453.     #endif
  1455.     #ifndef OS_FLAG_ACCEPT_EN
  1456.     #error  "OS_CFG.H, Missing OS_FLAG_ACCEPT_EN: Include code for OSFlagAccept()"
  1457.     #endif
  1459.     #ifndef OS_FLAG_DEL_EN
  1460.     #error  "OS_CFG.H, Missing OS_FLAG_DEL_EN: Include code for OSFlagDel()"
  1461.     #endif
  1463.     #ifndef OS_FLAG_NAME_SIZE
  1464.     #error  "OS_CFG.H, Missing OS_FLAG_NAME_SIZE: Determines the size of flag group names"
  1465.     #endif
  1467.     #ifndef OS_FLAG_QUERY_EN
  1468.     #error  "OS_CFG.H, Missing OS_FLAG_QUERY_EN: Include code for OSFlagQuery()"
  1469.     #endif
  1470. #endif
  1472. /*
  1473. *********************************************************************************************************
  1474. *                                           MESSAGE MAILBOXES
  1475. *********************************************************************************************************
  1476. */
  1478. #ifndef OS_MBOX_EN
  1479. #error  "OS_CFG.H, Missing OS_MBOX_EN: Enable (1) or Disable (0) code generation for MAILBOXES"
  1480. #else
  1481.     #ifndef OS_MBOX_ACCEPT_EN
  1482.     #error  "OS_CFG.H, Missing OS_MBOX_ACCEPT_EN: Include code for OSMboxAccept()"
  1483.     #endif
  1485.     #ifndef OS_MBOX_DEL_EN
  1486.     #error  "OS_CFG.H, Missing OS_MBOX_DEL_EN: Include code for OSMboxDel()"
  1487.     #endif
  1489.     #ifndef OS_MBOX_PEND_ABORT_EN
  1490.     #error  "OS_CFG.H, Missing OS_MBOX_PEND_ABORT_EN: Include code for OSMboxPendAbort()"
  1491.     #endif
  1493.     #ifndef OS_MBOX_POST_EN
  1494.     #error  "OS_CFG.H, Missing OS_MBOX_POST_EN: Include code for OSMboxPost()"
  1495.     #endif
  1497.     #ifndef OS_MBOX_POST_OPT_EN
  1498.     #error  "OS_CFG.H, Missing OS_MBOX_POST_OPT_EN: Include code for OSMboxPostOpt()"
  1499.     #endif
  1501.     #ifndef OS_MBOX_QUERY_EN
  1502.     #error  "OS_CFG.H, Missing OS_MBOX_QUERY_EN: Include code for OSMboxQuery()"
  1503.     #endif
  1504. #endif
  1506. /*
  1507. *********************************************************************************************************
  1508. *                                           MEMORY MANAGEMENT
  1509. *********************************************************************************************************
  1510. */
  1512. #ifndef OS_MEM_EN
  1513. #error  "OS_CFG.H, Missing OS_MEM_EN: Enable (1) or Disable (0) code generation for MEMORY MANAGER"
  1514. #else
  1515.     #ifndef OS_MAX_MEM_PART
  1516.     #error  "OS_CFG.H, Missing OS_MAX_MEM_PART: Max. number of memory partitions"
  1517.     #else
  1518.         #if     OS_MAX_MEM_PART > 65500u
  1519.         #error  "OS_CFG.H, OS_MAX_MEM_PART must be <= 65500"
  1520.         #endif
  1521.     #endif
  1523.     #ifndef OS_MEM_NAME_SIZE
  1524.     #error  "OS_CFG.H, Missing OS_MEM_NAME_SIZE: Determines the size of memory partition names"
  1525.     #endif
  1527.     #ifndef OS_MEM_QUERY_EN
  1528.     #error  "OS_CFG.H, Missing OS_MEM_QUERY_EN: Include code for OSMemQuery()"
  1529.     #endif
  1530. #endif
  1532. /*
  1533. *********************************************************************************************************
  1534. *                                       MUTUAL EXCLUSION SEMAPHORES
  1535. *********************************************************************************************************
  1536. */
  1538. #ifndef OS_MUTEX_EN
  1539. #error  "OS_CFG.H, Missing OS_MUTEX_EN: Enable (1) or Disable (0) code generation for MUTEX"
  1540. #else
  1541.     #ifndef OS_MUTEX_ACCEPT_EN
  1542.     #error  "OS_CFG.H, Missing OS_MUTEX_ACCEPT_EN: Include code for OSMutexAccept()"
  1543.     #endif
  1545.     #ifndef OS_MUTEX_DEL_EN
  1546.     #error  "OS_CFG.H, Missing OS_MUTEX_DEL_EN: Include code for OSMutexDel()"
  1547.     #endif
  1549.     #ifndef OS_MUTEX_QUERY_EN
  1550.     #error  "OS_CFG.H, Missing OS_MUTEX_QUERY_EN: Include code for OSMutexQuery()"
  1551.     #endif
  1552. #endif
  1554. /*
  1555. *********************************************************************************************************
  1556. *                                              MESSAGE QUEUES
  1557. *********************************************************************************************************
  1558. */
  1560. #ifndef OS_Q_EN
  1561. #error  "OS_CFG.H, Missing OS_Q_EN: Enable (1) or Disable (0) code generation for QUEUES"
  1562. #else
  1563.     #ifndef OS_MAX_QS
  1564.     #error  "OS_CFG.H, Missing OS_MAX_QS: Max. number of queue control blocks"
  1565.     #else
  1566.         #if     OS_MAX_QS > 65500u
  1567.         #error  "OS_CFG.H, OS_MAX_QS must be <= 65500"
  1568.         #endif
  1569.     #endif
  1571.     #ifndef OS_Q_ACCEPT_EN
  1572.     #error  "OS_CFG.H, Missing OS_Q_ACCEPT_EN: Include code for OSQAccept()"
  1573.     #endif
  1575.     #ifndef OS_Q_DEL_EN
  1576.     #error  "OS_CFG.H, Missing OS_Q_DEL_EN: Include code for OSQDel()"
  1577.     #endif
  1579.     #ifndef OS_Q_FLUSH_EN
  1580.     #error  "OS_CFG.H, Missing OS_Q_FLUSH_EN: Include code for OSQFlush()"
  1581.     #endif
  1583.     #ifndef OS_Q_PEND_ABORT_EN
  1584.     #error  "OS_CFG.H, Missing OS_Q_PEND_ABORT_EN: Include code for OSQPendAbort()"
  1585.     #endif
  1587.     #ifndef OS_Q_POST_EN
  1588.     #error  "OS_CFG.H, Missing OS_Q_POST_EN: Include code for OSQPost()"
  1589.     #endif
  1591.     #ifndef OS_Q_POST_FRONT_EN
  1592.     #error  "OS_CFG.H, Missing OS_Q_POST_FRONT_EN: Include code for OSQPostFront()"
  1593.     #endif
  1595.     #ifndef OS_Q_POST_OPT_EN
  1596.     #error  "OS_CFG.H, Missing OS_Q_POST_OPT_EN: Include code for OSQPostOpt()"
  1597.     #endif
  1599.     #ifndef OS_Q_QUERY_EN
  1600.     #error  "OS_CFG.H, Missing OS_Q_QUERY_EN: Include code for OSQQuery()"
  1601.     #endif
  1602. #endif
  1604. /*
  1605. *********************************************************************************************************
  1606. *                                              SEMAPHORES
  1607. *********************************************************************************************************
  1608. */
  1610. #ifndef OS_SEM_EN
  1611. #error  "OS_CFG.H, Missing OS_SEM_EN: Enable (1) or Disable (0) code generation for SEMAPHORES"
  1612. #else
  1613.     #ifndef OS_SEM_ACCEPT_EN
  1614.     #error  "OS_CFG.H, Missing OS_SEM_ACCEPT_EN: Include code for OSSemAccept()"
  1615.     #endif
  1617.     #ifndef OS_SEM_DEL_EN
  1618.     #error  "OS_CFG.H, Missing OS_SEM_DEL_EN: Include code for OSSemDel()"
  1619.     #endif
  1621.     #ifndef OS_SEM_PEND_ABORT_EN
  1622.     #error  "OS_CFG.H, Missing OS_SEM_PEND_ABORT_EN: Include code for OSSemPendAbort()"
  1623.     #endif
  1625.     #ifndef OS_SEM_QUERY_EN
  1626.     #error  "OS_CFG.H, Missing OS_SEM_QUERY_EN: Include code for OSSemQuery()"
  1627.     #endif
  1629.     #ifndef OS_SEM_SET_EN
  1630.     #error  "OS_CFG.H, Missing OS_SEM_SET_EN: Include code for OSSemSet()"
  1631.     #endif
  1632. #endif
  1634. /*
  1635. *********************************************************************************************************
  1636. *                                             TASK MANAGEMENT
  1637. *********************************************************************************************************
  1638. */
  1640. #ifndef OS_MAX_TASKS
  1641. #error  "OS_CFG.H, Missing OS_MAX_TASKS: Max. number of tasks in your application"
  1642. #else
  1643.     #if     OS_MAX_TASKS < 2
  1644.     #error  "OS_CFG.H,         OS_MAX_TASKS must be >= 2"
  1645.     #endif
  1647.     #if     OS_MAX_TASKS >  ((OS_LOWEST_PRIO - OS_N_SYS_TASKS) + 1)
  1648.     #error  "OS_CFG.H,         OS_MAX_TASKS must be <= OS_LOWEST_PRIO - OS_N_SYS_TASKS + 1"
  1649.     #endif
  1651. #endif
  1653. #if     OS_LOWEST_PRIO >  254
  1654. #error  "OS_CFG.H,         OS_LOWEST_PRIO must be <= 254 in V2.8x and higher"
  1655. #endif
  1657. #ifndef OS_TASK_IDLE_STK_SIZE
  1658. #error  "OS_CFG.H, Missing OS_TASK_IDLE_STK_SIZE: Idle task stack size"
  1659. #endif
  1661. #ifndef OS_TASK_STAT_EN
  1662. #error  "OS_CFG.H, Missing OS_TASK_STAT_EN: Enable (1) or Disable(0) the statistics task"
  1663. #endif
  1665. #ifndef OS_TASK_STAT_STK_SIZE
  1666. #error  "OS_CFG.H, Missing OS_TASK_STAT_STK_SIZE: Statistics task stack size"
  1667. #endif
  1669. #ifndef OS_TASK_STAT_STK_CHK_EN
  1670. #error  "OS_CFG.H, Missing OS_TASK_STAT_STK_CHK_EN: Check task stacks from statistics task"
  1671. #endif
  1673. #ifndef OS_TASK_CHANGE_PRIO_EN
  1674. #error  "OS_CFG.H, Missing OS_TASK_CHANGE_PRIO_EN: Include code for OSTaskChangePrio()"
  1675. #endif
  1677. #ifndef OS_TASK_CREATE_EN
  1678. #error  "OS_CFG.H, Missing OS_TASK_CREATE_EN: Include code for OSTaskCreate()"
  1679. #endif
  1681. #ifndef OS_TASK_CREATE_EXT_EN
  1682. #error  "OS_CFG.H, Missing OS_TASK_CREATE_EXT_EN: Include code for OSTaskCreateExt()"
  1683. #endif
  1685. #ifndef OS_TASK_DEL_EN
  1686. #error  "OS_CFG.H, Missing OS_TASK_DEL_EN: Include code for OSTaskDel()"
  1687. #endif
  1689. #ifndef OS_TASK_NAME_SIZE
  1690. #error  "OS_CFG.H, Missing OS_TASK_NAME_SIZE: Determine the size of task names"
  1691. #endif
  1693. #ifndef OS_TASK_SUSPEND_EN
  1694. #error  "OS_CFG.H, Missing OS_TASK_SUSPEND_EN: Include code for OSTaskSuspend() and OSTaskResume()"
  1695. #endif
  1697. #ifndef OS_TASK_QUERY_EN
  1698. #error  "OS_CFG.H, Missing OS_TASK_QUERY_EN: Include code for OSTaskQuery()"
  1699. #endif
  1701. /*
  1702. *********************************************************************************************************
  1703. *                                             TIME MANAGEMENT
  1704. *********************************************************************************************************
  1705. */
  1707. #ifndef OS_TICKS_PER_SEC
  1708. #error  "OS_CFG.H, Missing OS_TICKS_PER_SEC: Sets the number of ticks in one second"
  1709. #endif
  1711. #ifndef OS_TIME_DLY_HMSM_EN
  1712. #error  "OS_CFG.H, Missing OS_TIME_DLY_HMSM_EN: Include code for OSTimeDlyHMSM()"
  1713. #endif
  1715. #ifndef OS_TIME_DLY_RESUME_EN
  1716. #error  "OS_CFG.H, Missing OS_TIME_DLY_RESUME_EN: Include code for OSTimeDlyResume()"
  1717. #endif
  1719. #ifndef OS_TIME_GET_SET_EN
  1720. #error  "OS_CFG.H, Missing OS_TIME_GET_SET_EN: Include code for OSTimeGet() and OSTimeSet()"
  1721. #endif
  1723. /*
  1724. *********************************************************************************************************
  1725. *                                             TIMER MANAGEMENT
  1726. *********************************************************************************************************
  1727. */
  1729. #ifndef OS_TMR_EN
  1730. #error  "OS_CFG.H, Missing OS_TMR_EN: When (1) enables code generation for Timer Management"
  1731. #elif   OS_TMR_EN > 0
  1732.     #if     OS_SEM_EN == 0
  1733.     #error  "OS_CFG.H, Semaphore management is required (set OS_SEM_EN to 1) when enabling Timer Management."
  1734.     #error  "          Timer management require TWO semaphores."
  1735.     #endif
  1737.     #ifndef OS_TMR_CFG_MAX
  1738.     #error  "OS_CFG.H, Missing OS_TMR_CFG_MAX: Determines the total number of timers in an application (2 .. 65500)"
  1739.     #else
  1740.         #if OS_TMR_CFG_MAX < 2
  1741.         #error  "OS_CFG.H, OS_TMR_CFG_MAX should be between 2 and 65500"
  1742.         #endif
  1744.         #if OS_TMR_CFG_MAX > 65500
  1745.         #error  "OS_CFG.H, OS_TMR_CFG_MAX should be between 2 and 65500"
  1746.         #endif
  1747.     #endif
  1749.     #ifndef OS_TMR_CFG_WHEEL_SIZE
  1750.     #error  "OS_CFG.H, Missing OS_TMR_CFG_WHEEL_SIZE: Sets the size of the timer wheel (1 .. 1023)"
  1751.     #else
  1752.         #if OS_TMR_CFG_WHEEL_SIZE < 2
  1753.         #error  "OS_CFG.H, OS_TMR_CFG_WHEEL_SIZE should be between 2 and 1024"
  1754.         #endif
  1756.         #if OS_TMR_CFG_WHEEL_SIZE > 1024
  1757.         #error  "OS_CFG.H, OS_TMR_CFG_WHEEL_SIZE should be between 2 and 1024"
  1758.         #endif
  1759.     #endif
  1761.     #ifndef OS_TMR_CFG_NAME_SIZE
  1762.     #error  "OS_CFG.H, Missing OS_TMR_CFG_NAME_SIZE: Determines the number of characters used for Timer names"
  1763.     #endif
  1765.     #ifndef OS_TMR_CFG_TICKS_PER_SEC
  1766.     #error  "OS_CFG.H, Missing OS_TMR_CFG_TICKS_PER_SEC: Determines the rate at which tiem timer management task will run (Hz)"
  1767.     #endif
  1769.     #ifndef OS_TASK_TMR_STK_SIZE
  1770.     #error  "OS_CFG.H, Missing OS_TASK_TMR_STK_SIZE: Determines the size of the Timer Task's stack"
  1771.     #endif
  1772. #endif
  1775. /*
  1776. *********************************************************************************************************
  1777. *                                            MISCELLANEOUS
  1778. *********************************************************************************************************
  1779. */
  1781. #ifndef OS_ARG_CHK_EN
  1782. #error  "OS_CFG.H, Missing OS_ARG_CHK_EN: Enable (1) or Disable (0) argument checking"
  1783. #endif
  1786. #ifndef OS_CPU_HOOKS_EN
  1787. #error  "OS_CFG.H, Missing OS_CPU_HOOKS_EN: uC/OS-II hooks are found in the processor port files when 1"
  1788. #endif
  1791. #ifndef OS_APP_HOOKS_EN
  1792. #error  "OS_CFG.H, Missing OS_APP_HOOKS_EN: Application-defined hooks are called from the uC/OS-II hooks"
  1793. #endif
  1796. #ifndef OS_DEBUG_EN
  1797. #error  "OS_CFG.H, Missing OS_DEBUG_EN: Allows you to include variables for debugging or not"
  1798. #endif
  1801. #ifndef OS_LOWEST_PRIO
  1802. #error  "OS_CFG.H, Missing OS_LOWEST_PRIO: Defines the lowest priority that can be assigned"
  1803. #endif
  1806. #ifndef OS_MAX_EVENTS
  1807. #error  "OS_CFG.H, Missing OS_MAX_EVENTS: Max. number of event control blocks in your application"
  1808. #else
  1809.     #if     OS_MAX_EVENTS > 65500u
  1810.     #error  "OS_CFG.H, OS_MAX_EVENTS must be <= 65500"
  1811.     #endif
  1812. #endif
  1815. #ifndef OS_SCHED_LOCK_EN
  1816. #error  "OS_CFG.H, Missing OS_SCHED_LOCK_EN: Include code for OSSchedLock() and OSSchedUnlock()"
  1817. #endif
  1820. #ifndef OS_EVENT_MULTI_EN
  1821. #error  "OS_CFG.H, Missing OS_EVENT_MULTI_EN: Include code for OSEventPendMulti()"
  1822. #endif
  1825. #ifndef OS_TASK_PROFILE_EN
  1826. #error  "OS_CFG.H, Missing OS_TASK_PROFILE_EN: Include data structure for run-time task profiling"
  1827. #endif
  1830. #ifndef OS_TASK_SW_HOOK_EN
  1831. #error  "OS_CFG.H, Missing OS_TASK_SW_HOOK_EN: Allows you to include the code for OSTaskSwHook() or not"
  1832. #endif
  1835. #ifndef OS_TICK_STEP_EN
  1836. #error  "OS_CFG.H, Missing OS_TICK_STEP_EN: Allows to 'step' one tick at a time with uC/OS-View"
  1837. #endif
  1840. #ifndef OS_TIME_TICK_HOOK_EN
  1841. #error  "OS_CFG.H, Missing OS_TIME_TICK_HOOK_EN: Allows you to include the code for OSTimeTickHook() or not"
  1842. #endif
  1844. /*
  1845. *********************************************************************************************************
  1846. *                                         SAFETY CRITICAL USE
  1847. *********************************************************************************************************
  1848. */
  1850. #ifdef SAFETY_CRITICAL_RELEASE
  1852. #if    OS_ARG_CHK_EN < 1
  1853. #error "OS_CFG.H, OS_ARG_CHK_EN must be enabled for safety-critical release code"
  1854. #endif
  1856. #if    OS_APP_HOOKS_EN > 0
  1857. #error "OS_CFG.H, OS_APP_HOOKS_EN must be disabled for safety-critical release code"
  1858. #endif
  1860. #if    OS_DEBUG_EN > 0
  1861. #error "OS_CFG.H, OS_DEBUG_EN must be disabled for safety-critical release code"
  1862. #endif
  1864. #ifdef CANTATA
  1865. #error "OS_CFG.H, CANTATA must be disabled for safety-critical release code"
  1866. #endif
  1868. #ifdef OS_SCHED_LOCK_EN
  1869. #error "OS_CFG.H, OS_SCHED_LOCK_EN must be disabled for safety-critical release code"
  1870. #endif
  1872. #ifdef VSC_VALIDATION_MODE
  1873. #error "OS_CFG.H, VSC_VALIDATION_MODE must be disabled for safety-critical release code"
  1874. #endif
  1876. #if    OS_TASK_STAT_EN > 0
  1877. #error "OS_CFG.H, OS_TASK_STAT_EN must be disabled for safety-critical release code"
  1878. #endif
  1880. #if    OS_TICK_STEP_EN > 0
  1881. #error "OS_CFG.H, OS_TICK_STEP_EN must be disabled for safety-critical release code"
  1882. #endif
  1884. #if    OS_FLAG_EN > 0
  1885.     #if    OS_FLAG_DEL_EN > 0
  1886.     #error "OS_CFG.H, OS_FLAG_DEL_EN must be disabled for safety-critical release code"
  1887.     #endif
  1888. #endif
  1890. #if    OS_MBOX_EN > 0
  1891.     #if    OS_MBOX_DEL_EN > 0
  1892.     #error "OS_CFG.H, OS_MBOX_DEL_EN must be disabled for safety-critical release code"
  1893.     #endif
  1894. #endif
  1896. #if    OS_MUTEX_EN > 0
  1897.     #if    OS_MUTEX_DEL_EN > 0
  1898.     #error "OS_CFG.H, OS_MUTEX_DEL_EN must be disabled for safety-critical release code"
  1899.     #endif
  1900. #endif
  1902. #if    OS_Q_EN > 0
  1903.     #if    OS_Q_DEL_EN > 0
  1904.     #error "OS_CFG.H, OS_Q_DEL_EN must be disabled for safety-critical release code"
  1905.     #endif
  1906. #endif
  1908. #if    OS_SEM_EN > 0
  1909.     #if    OS_SEM_DEL_EN > 0
  1910.     #error "OS_CFG.H, OS_SEM_DEL_EN must be disabled for safety-critical release code"
  1911.     #endif
  1912. #endif
  1914. #if    OS_TASK_EN > 0
  1915.     #if    OS_TASK_DEL_EN > 0
  1916.     #error "OS_CFG.H, OS_TASK_DEL_EN must be disabled for safety-critical release code"
  1917.     #endif
  1918. #endif
  1920. #if    OS_CRITICAL_METHOD != 3
  1921. #error "OS_CPU.H, OS_CRITICAL_METHOD must be type 3 for safety-critical release code"
  1922. #endif
  1924. #endif  /* ------------------------ SAFETY_CRITICAL_RELEASE ------------------------ */
  1926. #ifdef __cplusplus
  1927. }
  1928. #endif
  1930. #endif