os_tsk_create_ex

#include <rtl.h>

OS_TID os_tsk_create_ex (
    void (*task)(void *),    /* Task to create */
    U8    priority,          /* Task priority (1-254) */
    void* argv );            /* Argument to the task */

The os_tsk_create_ex function creates the task identified by the task function pointer argument and adds the task to the ready queue. The function dynamically assigns a task identifier value (TID) to the new task. The os_tsk_create_ex function is an extension to the os_tsk_create function that enables you to pass an argument to the task.

The priority argument specifies the priority for the task. The default task priority is 1. Priority 0 is reserved for the Idle Task. If a value of 0 is specified for the priority, it is automatically replaced with a value of 1. Priority 255 is also reserved. If the new task has a higher priority than the currently executing task, then a task switch occurs immediately to execute the new task.

The argv argument is passed directly to the task when it starts. An argument to a task can be useful to differentiate between multiple instances of the same task.

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

note

• The RTK kernel uses the default stack size, which is defined in rtx_config.c, for the task.

The os_tsk_create_ex function returns the task identifier value (TID) of the new task. If the function fails, for example due to an invalid argument, it returns 0.

os_tsk_create, os_tsk_create_user, os_tsk_create_user_ex

#include <rtl.h>

OS_TID tsk1, tsk2_0, tsk2_1;
int param[2] = {0, 1};

__task void task1 (void) {
   ..
  tsk2_0 = os_tsk_create_ex (task2, 1, &param[0]);
  tsk2_1 = os_tsk_create_ex (task2, 1, &param[1]);
   ..
}

__task void task2 (void *argv) {
   ..
  switch (*(int *)argv) {
    case 0:
      printf("This is a first instance of task2.\n");
      break;
    case 1:
      printf("This is a second instance of task2.\n");
      break;
  }
   ..
}