os_tsk_prio

#include <rtl.h>

OS_RESULT os_tsk_prio (
    OS_TID task_id,       /* ID of the task */
    U8     new_prio );    /* New priority of the task (1-254) */

The os_tsk_prio function changes the execution priority of the task identified by the argument task_id.

If the value of new_prio is higher than the priority of the currently executing task, a task switch occurs to enable the task identified by task_id to run. If the value of new_prio is lower than the priority of the currently executing task, then the currently executing task resumes its execution.

If the value of task_id is 0, the priority of the currently running task is changed to new_prio.

The os_tsk_prio function is in the RL-RTX library. The prototype is defined in rtl.h.

Note

• The value of new_prio can be anything from 1 to 254.
• The new priority stays in effect until you change it.
• Priority 0 is reserved for the idle task. If priority 0 is specified to the function, it is automatically replaced with the value of 1 by the RTX kernel. Priority 255 is also reserved.
• A higher value for new_prio indicates a higher priority.

The os_tsk_prio function returns one of these values:

os_tsk_pass, os_tsk_prio_self

#include <RTL.h>

OS_TID tsk1,tsk2;

__task void task1 (void) {
   ..
  os_tsk_prio_self (5);

  /* Changing the priority of task2 will cause a task switch. */
  os_tsk_prio(tsk2, 10);
   ..
}

__task void task2 (void) {
   ..
  /* Change priority of this task will cause task switch. */
  os_tsk_prio_self (1);
   ..
}