Table C-17 shows the difference in API for miscellaneous services.
µC/OS-II ( | µC/OS-III ( | Note |
INT8U OSEventNameGet( OS_EVENT *pevent, INT8U **pname, INT8U *perr); | (1) | |
void OSEventNameSet( OS_EVENT *pevent, INT8U *pname, INT8U *perr); | (1) | |
INT16U OSEventPendMulti( OS_EVENT **pevent_pend, OS_EVENT **pevent_rdy, void **pmsgs_rdy, INT32U timeout, INT8U *perr); | OS_OBJ_QTY OSPendMulti( OS_PEND_DATA *p_pend_data_tbl, OS_OBJ_QTY tbl_size, OS_TICK timeout, OS_OPT opt, OS_ERR *p_err); | (2) |
void OSInit(void) | void OSInit( OS_ERR *p_err); | (3) |
void OSIntEnter(void) | void OSIntEnter(void); | |
void OSIntExit(void) | void OSIntExit(void) | |
void OSSched(void); | ||
void OSSchedLock(void) | void OSSchedLock( OS_ERR *p_err); | (4) |
void OSSchedRoundRobinCfg( CPU_BOOLEAN en, OS_TICK dflt_time_quanta, OS_ERR *p_err); | (5)
| |
void OSSchedRoundRobinYield( OS_ERR *p_err); | (6) | |
void OSSchedUnlock(void) | void OSSchedUnlock( OS_ERR *p_err); | (7) |
void OSStart(void) | void OSStart(void); | |
void OSStatInit(void) | void OSStatTaskCPUUsageInit( OS_ERR *p_err); | (8)
|
INT16U OSVersion(void) | CPU_INT16U OSVersion( OS_ERR *p_err); | (9) |
Table C-17 Miscellaneous API
TC-17(1) Objects in µC/OS-III are named when they are created and these functions are not required in µC/OS-III.
TC-17(2) The implementation of the multi-pend functionality is changed from µC/OS-II. However, the purpose of multi-pend is the same, to allow a task to pend (or wait) on multiple objects. In µC/OS-III, however, it is possible to only multi-pend on semaphores and message queues and not event flags and mutexes.
TC-17(3) µC/OS-III returns an error code for this function. Initialization is successful if OS_ERR_NONE is received from OSInit(). In µC/OS-II, there is no way of detecting an error in the configuration that caused OSInit() to fail.
TC-17(4) An error code is returned in µC/OS-III for this function.
TC-17(5) Enable or disable µC/OS-III’s round-robin scheduling at run time, as well as change the default time quanta.
TC-17(6) A task that completes its work before its time quanta expires may yield the CPU to another task at the same priority.
TC-17(7) An error code is returned in µC/OS-III for this function.
TC-17(8) Note the change in name for the function that computes the “capacity” of the CPU for the purpose of computing CPU usage at run-time.
TC-17(9) An error code is returned in µC/OS-III for this function.