tnkernel:ref:task:tn_task

tn_task_ireference()

Функция предназначена для получения информации о задаче в прерывании. После вызова функции заполняется структура типа TN_TASK_REF, указатель на которую передается в качестве параметра функции:

typedef struct _TN_TASK_REF
{
    TN_TASK_STATE       state;
    TN_TASK_WAIT_REASON wait_reason;
    TN_UWORD            base_priority;
    TN_UWORD            current_priority;
    TN_TIMEOUT          timeout;
} TN_TASK_REF;

В состав структура TN_TASK_REF входят следующие элементы:

state

состояние задачи, может принимать одно из следующих значений:

`TSK_STATE_RUNNABLE`	Задача находится в очереди готовых к выполнению
`TSK_STATE_WAIT`	Задача ожидает событие
`TSK_STATE_SUSPEND`	Задача приостановлена
`TSK_STATE_DORMANT`	Задача создана, но еще не запущена

wait_reason

событие, которого ожидает задача, может принимать одно из следующих значений:

`TSK_WAIT_REASON_SLEEP`	Задача ожидает таймаута, переведена в состояние ожидания функцией `tn_task_sleep()`
`TSK_WAIT_REASON_SEM`	Задача ожидает освобождения семафора
`TSK_WAIT_REASON_EVENT`	Задача ожидает флаг
`TSK_WAIT_REASON_DQUE_WSEND`	Задача ожидает освобождение очереди сообщений
`TSK_WAIT_REASON_DQUE_WRECEIVE`	Задача ожидает сообщения
`TSK_WAIT_REASON_MUTEX_C`	Задача ожидает освобождения ресурса, заблокированного "priority ceiling" мютексом
`TSK_WAIT_REASON_MUTEX_C_BLK`	Задача ожидает освобождения ресурса, заблокированного "priority ceiling" мютексом
`TSK_WAIT_REASON_MUTEX_I`	Задача ожидает освобождения ресурса, заблокированного "priority inheritance" мютексом
`TSK_WAIT_REASON_WFIXMEM`	Задача ожидает освобождения блока памяти фиксированного размера

base_priority

базовый приоритет задачи (назначенный при ее создании)

current_priority

текущий приоритет задачи

timeout

время в системных тиках до момента перевода задачи в состояние TSK_STATE_RUNNABLE (актуально в случае, если задача находится в состоянии ожидания с таймаутом)

Вызов:

TN_RETVAL tn_task_ireference(TN_TCB *task, TN_TASK_REF *ref);

Разрешен вызов:

В прерывании

Параметры функции:

task: указатель на TCB задачи
ref: указатель на структуру информации о задаче

Возвращаемые значения:

TERR_WRONG_PARAM: некорректное значение параметра (замечание: данный код возврата возможен только в случае использования сервисов с проверкой параметров)
TERR_NOEXS: задача не существует (еще не создана)
TERR_WCONTEXT: попытка вызова сервиса в контексте задачи
TERR_NO_ERR: успешное выполнение

Пример вызова:

extern TN_TCB tcb_Task1  TN_DATA;
TN_TASK_REF  task_info;
 
tn_sys_interrupt (_T2Interrupt)        /* прерывание от таймера */
{
    IFS0bits.T2IF = 0;                 /* сброс флага прерывания */
    if (tn_task_ireference(&tcb_Task1, &task_info) == TERR_NO_ERR)
    {
        if (task_info.state == TSK_STATE_SUSPEND)
            tn_task_iresume(&tcb_Task1);
    }
}

К списку сервисов