void OSIdleTaskHook (void);File | Called from | Code enabled by |
|---|---|---|
|
| N/A |
Description
This function is called by by OS_IdleTask().
OSIdleTaskHook() is is part of the CPU port code and this function function must not be be called by the application code. OSIdleTaskHook() is is used by the µC/OS-III port developer.
OSIdleTaskHook() runs runs in the context of the idle task and thus it is important to make sure there is sufficient stack space in the idle task. OSIdleTaskHook() must not make any make any OS???Pend() calls calls, call call OSTaskSuspend() or or OSTimeDly???(). In other words, this function must never be allowed to make a blocking call.
Files
os.h/os_cpu_c.c and os_app_hooks.c
Prototype
Arguments
None
Returned Value
None
Required Configuration
OS_CFG_APP_HOOKS_EN must be enabled in os_cfg.h. Refer to µC-OS-III Configuration Manual.
Callers
OS_IdleTask().
Notes/Warnings
- Never make blocking calls from
OSIdleTaskHook(). - Do not call this function from you application.
Example Usage
The code below calls an application-specific hook that the application programmer can define. The user can simply set the value of OS_AppIdleTaskHookPtr to point to the desired hook function which in this case is assumed to be defined in os_app_hooks.c. The idle task calls OSIdleTaskHook() which in turns calls App_OS_IdleTaskHook() through OS_AppIdleTaskHookPtr.
...