UCOSII时间与任务管理函数详解

"ucosii 函数中文注释" 在嵌入式实时操作系统 ucOSII (uC/OS-II) 中，函数是实现操作系统核心功能的关键元素。以下是对 ucOSII 中时间管理和任务管理函数的详细解释，这些中文注释旨在帮助初学者更好地理解和使用 ucOSII。 ### 时间管理函数 1. `void OSTimeDly(INT16U ticks)`：任务延时函数。它将当前任务挂起指定的时钟节拍数（ticks），直到时钟节拍计数达到设定值后才会自动恢复执行。 2. `INT8U OSTimeDlyHMSM(INT8U hours, INT8U minutes, INT8U seconds, INT16U milli)`：按时、分、秒、毫秒延时函数。此函数允许开发者以更直观的时间单位设置延时，最后会转换为时钟节拍进行内部处理。 3. `INT8U OSTimeDlyResume(INT8U prio)`：让处在延时期的任务结束延时。通过提供任务优先级，可以提前唤醒正在延时的任务。 4. `INT32U OSTimeGet(void)`：系统时间函数。返回 ucOSII 的当前系统时间，通常以时钟节拍为单位。 5. `void OSTimeSet(INT32U ticks)`：设置系统时间。允许开发者直接更改系统时钟的当前值。 6. `void OSTimeTick(void)`：系统时钟节拍。这个函数在每个时钟节拍中断服务例程中被调用，更新 ucOSII 的时间并触发可能的延时结束。 ### 任务管理函数 1. `INT8U OSTaskChangePrio(INT8U oldprio, INT8U newprio)`：优先级变更。将指定任务的优先级从 `oldprio` 更改为 `newprio`。 2. `INT8U OSTaskCreate(void (*task)(void* pd), void* pdata, OS_STK *ptos, INT8U prio)`：任务建立。创建一个新任务，提供任务入口地址、参数、栈顶指针和优先级。 3. `INT8U OSTaskCreateExt(void (*task)(void* pd), void* pdata, OS_STK *ptos, INT8U prio, INT16U id, OS_STK *pbos, INT32U stk_size, void* pext, INT16U opt)`：扩展任务创建。除了基本的任务创建外，还允许指定任务ID、栈底指针、栈大小、用户扩展数据和选项。 4. `INT8U OSTaskDel(INT8U prio)`：删除任务。根据任务的优先级来移除一个任务。 5. `INT8U OSTaskDelReq(INT8U prio)`：请求删除任务。向 ucOSII 发送一个请求来删除指定优先级的任务，任务实际删除会在适当的时候执行。 6. `INT8U OSTaskResume(INT8U prio)`：任务恢复。使处于挂起状态的任务重新开始执行。 7. `INT8U OSTaskStkChk(INT8U prio, OS_STK_DATA *pdata)`：任务恢复。检查指定任务的栈使用情况，并将结果存储在提供的数据结构中。 8. `INT8U OSTaskSuspend(INT8U prio)`：任务挂起。暂停指定优先级的任务，使其等待恢复。 9. `INT8U OSTaskQuery(INT8U prio, OS_TCB *pdata)`：任务查询。获取关于指定优先级任务的信息，如任务状态、栈指针等，并将其存储在提供的 TCB（任务控制块）结构中。 10. 任务控制块（Task Control Block - TCB）：`OS_TCB` 是一个结构体，包含了与任务相关的重要信息，如任务栈指针、优先级、状态等。`OSTCBStkPtr` 指向当前任务栈顶，`OSTCBExtPtr` 用于指向用户自定义的扩展任务控制模块，而 `OSTCBStkBottom` 指向栈底。 理解并熟练运用这些 ucOSII 函数，对于开发基于 ucOSII 的嵌入式应用程序至关重要，它们提供了调度、时间管理和任务交互的核心机制。