pub enum Stall {
None,
NoReadyTask,
ListError,
EmptyRotation,
UnknownTask,
}Expand description
A trace line owed by a task that was switched out before it could
emit one. Only the queue failure paths can owe one: they are the only
places FreeRTOS traces after leaving a critical section.
Why vTaskSwitchContext could not choose a task to run.
§Law 3: no silent failures
Every variant here was, until 2026-09-11, a bare return — the scheduler
declining to switch and saying nothing. Three of them are impossible in a
healthy kernel and the fourth is what the C asserts on
(configASSERT( uxTopPriority )), so reaching any of them means an
invariant has already broken somewhere else.
They cost a multi-flash hardware hunt on the day the Xtensa port first ran a stacked task: every ready list had emptied, the kernel kept quietly running whoever was current, and nothing said so. A counter and a reason turn that into one printed line.
Variants§
None
The scheduler chose normally.
NoReadyTask
No ready task at ANY priority. The idle task keeps priority 0
non-empty, so reaching this means the idle task is gone — which is
exactly what configASSERT( uxTopPriority ) fires on.
ListError
A ready list refused to answer at all.
EmptyRotation
The chosen priority’s list had nothing to rotate to, having just reported itself non-empty.
UnknownTask
The chosen list item named no live task.