PIC24 osa:ref:allservices

OSA : OS_Bsem_Check

2009-12-12T01:03:46+03:00

OSA : OS_Bsem_Check

bool OS_Bsem_Check (bsem)
bool OS_Bsem_Check_I (bsem)

Смотрим, установлен ли конкретный семафор.

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

bsem ID бинарного семафора. Количество бинарных семафоров задается в файле OSAcfg.h константой OS_BSEMS

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

`false`	Семафор сброшен
`true`	Семафор установлен

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

#define BS_DATA_RECEIVED    3
 
void Task (void)
{
    for (;;) {
        /*...*/
        // Проверяем, выставлен ли другой задачей семафор
        if (OS_Bsem_Check (BS_DATA_RECEIVED)) {
            // Обрабатываем принятые данные
            /*...*/
        }
        /*...*/
    }
}

OSA : OS_Bsem_Reset

2009-06-24T15:48:23+03:00

OSA : OS_Bsem_Reset

OS_Bsem_Reset (bsem)

Устанавливает бинарный семафор в "0" (сбрасывает его).

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

bsem ID бинарного семафора. Количество бинарных семафоров задается в файле OSAcfg.h константой OS_BSEMS

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Bsem_Reset (5);
        /*...*/
    }
}

OSA : OS_Bsem_Set

2009-12-11T04:32:33+03:00

OSA : OS_Bsem_Set

OS_Bsem_Set (bsem)

(То же, что и OS_Bsem_Signal))

Устанавливает бинарный семафор в "1".

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

bsem ID бинарного семафора. Количество бинарных семафоров задается в файле OSAcfg.h константой OS_BSEMS

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Bsem_Set (4);
        /*...*/
    }
}

OSA : OS_Bsem_Signal

2009-06-30T18:35:25+03:00

OSA : OS_Bsem_Signal

OS_Bsem_Signal (bsem)

(То же, что и OS_Bsem_Set))

Устанавливает бинарный семафор в "1".

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

bsem ID бинарного семафора. Количество бинарных семафоров задается в файле OSAcfg.h константой OS_BSEMS

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Bsem_Signal (4);
        /*...*/
    }
}

OSA : OS_Bsem_Switch

2010-10-07T13:51:59+03:00

OSA : OS_Bsem_Wait

2009-06-24T16:01:02+03:00

OSA : OS_Bsem_Wait

OS_Bsem_Wait (bsem)

Ожидает установку семафора. После того, как дождется, семафор сбрасывается. Удобно применять при доступе к разделяемому ресурсу.

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

bsem ID бинарного семафора. Количество бинарных семафоров задается в файле OSAcfg.h константой OS_BSEMS

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

const char * Data1 = "This is Task1\n";
const char * Data2 = "This is Task2\n";
 
#define BS_UART_FREE   0
 
void Task1 (void)
{
    const char *str;
    for (;;) {
        OS_Bsem_Wait(BS_UART_FREE);
        // Когда попали сюда, мы уверены, что UART свободен.
        // На данный момент BS_UART_FREE сброшен, что сообщает другим задачам,
        // что UART занят этой задачей
 
        // Отправляем текстовую строку
        str = Data1;
        while (*str) {
           OS_Cond_Wait(TRMT);     // Ждем завершения передачи байта
           TXREG = *str++;
        }
        OS_Bsem_Set(BS_UART_FREE);      // Освобождаем ресурс
    }
}
 
void Task2 (void)
{
    const char *str;
    for (;;) {
        OS_Bsem_Wait(BS_UART_FREE);
        // Когда попали сюда, мы уверены, что UART свободен.
        // На данный момент BS_UART_FREE сброшен, что сообщает другим задачам,
        // что UART занят этой задачей
 
        // Отправляем текстовую строку
        str = Data2;
        while (*str) {
           OS_Cond_Wait(TRMT);     // Ждем завершения передачи байта
           TXREG = *str++;
        }
        OS_Bsem_Set(BS_UART_FREE);      // Освобождаем ресурс
    }
}

OSA : OS_Bsem_Wait_TO

2009-06-24T16:01:09+03:00

OSA : OS_Bsem_Wait_TO

OS_Bsem_Wait_TO (bsem, timeout)

Ожидаем установку семафора с таймаутом. После того, как дождемся, семафор сбрасывается. Если так и не дождались, то выходим из ожидания по таймауту.

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

`bsem`	ID бинарного семафора. Количество бинарных семафоров задается в файле OSAcfg.h константой OS_BSEMS
`timeout`	Время ожидания. Задается в системных тиках - периодах вызова сервиса OS_Timer

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

таймаут Если вышли из ожидания по таймауту, то сервис OS_IsTimeout возвратит true

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

#define BS_DATA_RECEIVED     0
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Bsem_Wait_TO (BS_DATA_RECEIVED, 1000);   // 1000 тиков ждем установки семафора
        if (!OS_IsTimeout()) {
            // Обрабатываем данные
            /*...*/
        }
        /*...*/
    }
}

OSA : OS_Cond_Wait

2009-06-28T23:10:52+03:00

OSA : OS_Cond_Wait

См. OS_Wait

OSA : OS_Cond_Wait_TO

2009-06-28T23:16:29+03:00

OSA : OS_Cond_Wait_TO

OS_Cond_Wait_TO (condition, timeout)

См. OS_Wait_TO

OSA : OS_Csem_Accept

2010-10-07T13:52:04+03:00

OSA : OS_Csem_Check

2010-10-07T13:52:04+03:00

OSA : OS_Csem_Create

2010-10-07T13:52:05+03:00

OSA : OS_Csem_Reset

2010-10-07T13:52:06+03:00

OSA : OS_Csem_Set

2010-10-07T13:52:07+03:00

OSA : OS_Csem_SetValue

2010-10-07T13:52:08+03:00

OSA : OS_Csem_Signal

2009-12-12T02:22:06+03:00

OSA : OS_Csem_Signal

Увеличивает значение семафора на 1. Если увеличивать уже некуда (семафор имеет максимально допустимое значение), то задача переводится в режим ожидания до тех пор, пока какая-нибудь задача не уменьшит значение семафора.

Для использования счетных семафоров в файле OSAcfg.h должна быть определена константа OS_ENABLE_CSEM. Разрядность счетных семафоров задается константой OS_CSEM_SIZE

Для PIC16 переменная csem может размещаться в памяти только в bank0 или bank1

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

Только не из прерывания

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

csem счетный семафор - переменная типа OST_CSEM

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

bEventError Если семафор на момент вызова имел максимальное значение, то функция OS_IsEventError вернет значение true

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

OST_CSME my_csem;
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Csem_Signal(my_csem);
        /*...*/
    }
}

Old style name

OS_SignalCSem

См. также

OS_Csem_Create

OSA : OS_Csem_Signal_Now

2009-12-12T02:42:41+03:00

OSA : OS_Csem_Signal_Now

OS_Csem_Signal_Now (csem)
OS_Csem_Signal_Now_I (csem)

Увеличивает значение семафора на 1. Если увеличивать уже некуда (семафор имеет максимально допустимое значение), то он не будет увеличен, а системный флаг bEventError установится.

Для PIC16 переменная csem может размещаться в памяти только в bank0 или bank1

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

Только не из прерывания

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

csem счетный семафор - переменная типа OST_CSEM

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

bEventError Если семафор на момент вызова имел максимальное значение, то функция OS_IsEventError вернет значение true

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

OST_CSME my_csem;
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Csem_Signal_Now(my_csem);
        if (OS_IsEventError()) {
            // Семафор переполнен
        }
        /*...*/
    }
}

Old style name

См. также

OS_Csem_Create

OSA : OS_Csem_Wait

2010-10-07T13:52:11+03:00

OSA : OS_Csem_Wait_TO

2010-10-07T13:52:12+03:00

OSA : OS_Delay

2010-10-07T13:52:12+03:00

OSA : OS_DI

2010-10-07T13:52:13+03:00

OSA : OS_Dtimer_Add

2010-02-04T03:57:11+03:00

OSA : OS_Dtimer_Add

OS_Dtimer_Add (dtimer, addtime)

Добавить время к таймеру во время счета. Флаг переполнения остается без изменений.

Для использования динамических таймеров в файле OSAcfg.h нужно определить константу OS_ENABLE_DTIMERS. Разрядность динамических таймеров такая же, как и у системного, и задается константой OS_TIMER_SIZE.

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

Везде

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

`dtimer`	Дескриптор динамического таймера типа OST_DTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает, остановлен, активен, переполнение). Для PIC16 может размещаться в памяти только в bank0 или bank1
`addtime`	Время, на которое удлиняется счет таймера. Задается в системных тиках - периодах вызова сервиса OS_Timer. Не должно превышать разрядности таймера

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Dtimer_Add (dtimer, 100); // Добавить 100 тиков ко времени счета
        /*...*/
    }
}

Old style name

OS_AddDTimer

См. также

OSA : OS_Dtimer_Break

2010-02-04T03:55:09+03:00

OSA : OS_Dtimer_Break

OS_Dtimer_Break (dtimer)

Останавливаем таймер. Он остается активным, но не увеличивается при выполнении OS_Timer(), флаг переполнения устанавливается (в отличие от сервиса OS_Dtimer_Pause).

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

Везде

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

dtimer Дескриптор динамического таймера типа OST_DTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает, остановлен, активен, переполнение). Может размещаться в памяти только в bank0 или bank1

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Dtimer_Break (dtimer);
        /*...*/
    }
}

Old style name

См. также

OSA : OS_Dtimer_Check

2010-02-04T03:56:14+03:00

OSA : OS_Dtimer_Check

bool OS_Dtimer_Check (dtimer)

Проверить, произошло ли переполнение.

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

Везде

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

dtimer Дескриптор динамического таймера типа OST_DTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает, остановлен, активен, переполнение). Для PIC16 может размещаться в памяти только в bank0 или bank1

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

`false`	переполнения еще не было
`true`	переполнение произошло

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Dtimer_Check (dtimer)) {
            OS_Dtimer_Update(dtimer, 100);     // Запустить счет еще на 100 тиков
        };
        /*...*/
    }
}

Old style name

OS_CheckDTimer

См. также

OSA : OS_Dtimer_Continue

2010-02-04T03:56:48+03:00

OSA : OS_Dtimer_Continue

OS_Dtimer_Continue (dtimer)

Восстанавливаем счет таймера после остановки (паузы). После вызова этого сервиса таймер снова будет увеличиваться на 1 при каждом вызове OS_Timer.

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

Везде

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

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Dtimer_Continue (dtimer);
        /*...*/
    }
}

Old style name

OS_ContinueDTimer

См. также

OSA : OS_Dtimer_Create

2010-02-04T03:54:26+03:00

OSA : OS_Dtimer_Create

OS_Dtimer_Create (dtimer)

Добавляет dtimer в очередь активных таймеров. После создания таймер обнулен остановлен, флаг переполнения сброшен.

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

Только не из прерывания

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

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

Нет

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

OST_DTIMER dtimer;
 
void main (void)
{
    OS_Init();
    OS_Dtimer_Create(dtimer);  // После вызова этого сервиса аймер можно запускать на отсчет
    /*...*/
}

Old style name

OS_CreateDTimer

См. также

OSA : OS_Dtimer_Delay

2010-02-04T03:55:50+03:00

OSA : OS_Dtimer_Delay

OS_Dtimer_Delay (dtimer, delay)

Выдержать задержку с использованием динамического таймера dtimer

Для использования динамических таймеров в файле OSAcfg.h нужно определить константу OS_ENABLE_DTIMERS. Разрядность динамических таймеров задается константой OS_DTIMER_SIZE.

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

Только из задачи

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

`dtimer`	Дескриптор динамического таймера типа OST_DTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает, остановлен, активен, переполнение). Для PIC16 может размещаться в памяти только в bank0 или bank1
`delay`	Время задержки. Задается в системных тиках - периодах вызова сервиса OS_Timer

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Dtimer_Delay (dtimer, 100);
        /*...*/
    }
}

Old style name

OS_DelayDTimer

См. также

OSA : OS_Dtimer_Delete

2010-02-04T03:54:48+03:00

OSA : OS_Dtimer_Delete

OS_Dtimer_Delete (dtimer)

Удаляет dtimer из очереди активных таймеров.

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

Только не из прерывания

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

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Dtimer_Delete (dtimer);
        /*...*/
    }
}

Old style name

OS_DeleteDTimer

См. также

OSA : OS_Dtimer_Get

2010-02-04T03:56:01+03:00

OSA : OS_Dtimer_Get

OST_TIMER OS_Dtimer_Get (dtimer)

Получить оставшееся время счета. Перед вызовом этого сервиса нужно:

либо запретить прерывания (OS_DI());
либо войти в критическую секцию;
либо остановить таймер сервисом OS_Dtimer_Stop().

В противном случае в момент чтения таймера может произойти прерывание, которое может изменить его значение.

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

Везде

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

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

OST_TIMER Время, оставшееся до переполнения (в системных тиках)

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

OST_DTIMER dtimer;
OST_MSG_CB msg_cb;
 
void Task (void)
{
    OST_TIMER t;
    for (;;) {
        /*...*/
        OS_Dtimer_Pause(dtimer);
        t = OS_Dtimer_Get (dtimer);
        OS_Dtimer_Continue(dtimer);
        OS_Msg_Send(msg_cb, (OST_MSG)&t);   // Отправить сообщение со значением времени до
                                         // окончания счета dtimer'а
 
        /*...*/
    }
}

Old style name

OS_GetDTimer

См. также

OSA : OS_Dtimer_IsActive

2010-02-04T03:57:20+03:00

OSA : OS_Dtimer_IsActive

bool OS_Dtimer_IsActive (dtimer)

Проверить, есть ли таймер в списке активных таймеров (был ли он создан).

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

Везде

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

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

`false`	таймер не создан
`true`	таймер есть в списке активных таймеров

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        if (!OS_Dtimer_IsActive (dtimer))    // Если таймер еще не создан,
            OS_Dtimer_Create(dtimer);        // то создать его
        OS_Dtimer_Run(dtimer, 1000);         // Запустить
        /*...*/
    }
}

Old style name

OS_IsDTimerActive

См. также

OSA : OS_Dtimer_IsRun

2010-02-04T03:56:29+03:00

OSA : OS_Dtimer_IsRun

bool OS_Dtimer_IsRun (dtimer)

Проверить, считает ли таймер

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

Везде

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

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

`false`	таймер остаовлен
`true`	таймер считает

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Dtimer_IsRun (dtimer)) {
            // Таймер считает
        }
        /*...*/
    }
}

Old style name

OS_IsDTimerRun

См. также

OSA : OS_Dtimer_IsStopped

2010-02-04T03:57:30+03:00

OSA : OS_Dtimer_IsStopped

bool OS_Dtimer_IsStopped (dtimer)

Проверить, остановлен ли таймер

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

Везде

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

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

`false`	таймер считает
`true`	таймер остановлен

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Dtimer_IsStopped (dtimer)) {
            OS_Dtimer_Continue(dtimer);
        }
        /*...*/
    }
}

Old style name

OS_IsDTimerStopped

См. также

OSA : OS_Dtimer_Pause

2010-02-04T03:56:38+03:00

OSA : OS_Dtimer_Pause

OS_Dtimer_Pause (dtimer)

Останавливаем таймер. Он остается активным, но не увеличивается при выполнении OS_Timer(). Флаг переполнения остается без изменений (в отличие от сервиса OS_Dtimer_Break).

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

Везде

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

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Dtimer_Pause (dtimer);
        /*...*/
    }
}

Old style name

OS_PauseDTimer

См. также

OSA : OS_Dtimer_Run

2010-02-04T03:54:59+03:00

OSA : OS_Dtimer_Run

OS_Dtimer_Run (dtimer, newtime)

Запустить dtimer на отсчет времени newtime с момента вызова этого сервиса. Флаг переполнения сбрасывается.

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

Везде

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

`dtimer`	Дескриптор динамического таймера типа OST_DTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает, остановлен, активен, переполнение). Может размещаться в памяти только в bank0 или bank1
`newtime`	Время, на которое запускается таймер. Задается в системных тиках - периодах вызова сервиса OS_Timer. Не должно превышать разрядности таймера

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    OS_Dtimer_Create(dtimer);
    for (;;) {
        /*...*/
        // В течение секунды генерируем меандр 100 Гц
        OS_Dtimer_Run (dtimer, 1000);
        do {
            RB1 = 1;
            OS_Delay(5);
            RB1 = 0;
            OS_Delay(5);
        } while (!OS_Dtimer_Check(dtimer));
        /*...*/
    }
}

Old style name

OS_RunDTimer

См. также

OSA : OS_Dtimer_Stop

2009-06-30T18:41:45+03:00

OSA : OS_Dtimer_Stop

OS_Dtimer_Stop (dtimer)

(То же, что и OS_Dtimer_Pause())

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

Везде

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

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Dtimer_Stop (dtimer);
        /*...*/
    }
}

Old style name

OS_StopDTimer

См. также

OSA : OS_Dtimer_Update

2010-02-04T03:57:00+03:00

OSA : OS_Dtimer_Update

OS_Dtimer_Update (dtimer, time)

Запустить таймер на отсчет времени time с момента последнего переполнения. Флаг переполнения сбрасывается.

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

Везде

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

`dtimer`	Дескриптор динамического таймера типа OST_DTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает, остановлен, активен, переполнение). Может размещаться в памяти только в bank0 или bank1
`time`	Время, на которое запускается таймер. Задается в системных тиках - периодах вызова сервиса OS_Timer. Не должно превышать разрядности таймера

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

Нет

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

OST_DTIMER dtimer;
 
void Task_1sec (void)
{
    OS_Dtimer_Create(dtimer);
    for (;;) {
        OS_Dtimer_Update (dtimer, 1000);
        OS_Dtimer_Wait(dtimer);
        // Сюда будем попадать 1 раз в секунду
        /*...*/
    }
}

Old style name

OS_UpdateDTimer

См. также

OSA : OS_Dtimer_Wait

2010-02-04T03:55:28+03:00

OSA : OS_Dtimer_Wait

OS_Dtimer_Wait (dtimer)

Ожидаем завершения счета таймера.

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

Только из задачи

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

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

Нет

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

OST_DTIMER dtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Dtimer_Run(dtimer, 200);
        OS_Dtimer_Wait (dtimer);
        // Сюда попадаем через 200 тиков
        /*...*/
    }
}

Old style name

OS_WaitDTimer

См. также

OSA : OS_EI

2010-10-07T13:52:28+03:00

OSA : OS_EnterCriticalSection

2010-10-07T13:52:29+03:00

OSA : OS_EnterInt

2010-10-07T13:52:30+03:00

OSA : OS_Flag_Check_AllOff

2010-10-07T13:52:30+03:00

OSA : OS_Flag_Check_AllOn

2010-03-18T11:03:43+03:00

OSA : OS_Flag_Check_AllOn

bool OS_Flag_Check_AllOn (flags, mask)
bool OS_Flag_Check_AllOn_I (flags, mask)

Проверить, все ли флаги по маске установлены в "1"

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

Везде

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

`flags`	Переменная типа OST_FLAGx (x = 8, 16, 32)
`mask`	Битовая маска, по которой произваодится операция над флагами

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

`false`
`true`

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

OST_FLAG8 flag;
 
void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Flag_Check_AllOn (flags, 0x21)) {
            // Сюда попадаем, если установлены биты 0 и 5
            /*...*/
        }
        /*...*/
    }
}

Old style name

OS_CheckAllFlag
OS_Flag_Check_11

См. также

OSA : OS_Flag_Check_Off

2010-10-07T13:52:32+03:00

OSA : OS_Flag_Check_On

2010-10-07T13:52:33+03:00

OSA : OS_Flag_Clear

2010-10-07T13:52:34+03:00

OSA : OS_Flag_Create

2010-10-07T13:52:34+03:00

OSA : OS_Flag_Init

2010-10-07T13:52:35+03:00

OSA : OS_Flag_Set

2010-10-07T13:52:36+03:00

OSA : OS_Flag_Wait_AllOff

2010-10-07T13:52:37+03:00

OSA : OS_Flag_Wait_AllOff_TO

2010-10-07T13:52:38+03:00

OSA : OS_Flag_Wait_AllOn

2010-10-07T13:52:39+03:00

OSA : OS_Flag_Wait_AllOn_TO

2010-10-07T13:52:40+03:00

OSA : OS_Flag_Wait_Off

2010-10-07T13:52:41+03:00

OSA : OS_Flag_Wait_Off_TO

2010-10-07T13:52:42+03:00

OSA : OS_Flag_Wait_On

2010-10-07T13:52:43+03:00

OSA : OS_Flag_Wait_On_TO

2010-10-07T13:52:43+03:00

OSA : OS_GetCurTask

2008-12-27T16:43:40+03:00

OSA : OS_GetCurTask

OST_TCB * OS_GetCurTask ()

Получить указатель на TCB текущей задачи. Это указатель используется для управления состоянием задачи из-вне. Обычно этот сервис вызывается в самом начале функции-задачи.

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

Только из задачи

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

Нет

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

OST_TCB_POINTER Указатель на дескриптор текущей задачи

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

OST_TCB_POINTER tp_Task;
void Task (void)
{
    tp_Task = OS_GetCurTask();
    for (;;) {
        /*...*/
    }
}

См. также

OSA : OS_Init

2010-10-07T13:52:45+03:00

OSA : OS_IsError

2010-10-07T13:52:46+03:00

OSA : OS_IsEventError

2010-10-07T13:52:47+03:00

OSA : OS_IsInCriticalSection

2010-10-07T13:52:48+03:00

OSA : OS_IsTimeout

2010-10-07T13:52:49+03:00

OSA : OS_LeaveCriticalSection

2010-10-07T13:52:50+03:00

OSA : OS_LeaveInt

2010-10-07T13:52:50+03:00

OSA : OS_Msg_Accept

2010-05-24T20:20:35+03:00

OSA : OS_Msg_Accept

OS_Msg_Accept (msg_cb, os_msg_type_var)
OS_Msg_Accept_I (msg_cb, os_msg_type_var)

Принять существующее сообщение. Перед вызовом следует быть уверенным в том, что сообщение присутствует (т.е. дескриптор занят, проверяется сервисом OS_Msg_Check). После выполнения сервиса дескриптор освобождается.

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

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

`msg_cb`	Дескриптор указателя на сообщение. Переменная типа OST_MSG_CB
`os_msg_type_var`	Переменная типа OST_MSG; в нее будет помещен указатель на сообщение

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

Нет

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

OST_MSG_CB msg_cb;
 
void Task (void)
{
    OST_MSG msg;
    for (;;) {
        /*...*/
        if (OS_Msg_Check (msg_cb)) {       // Проверяем, есть ли сообщение
             OS_Msg_Accept(msg_cb, msg);   // Принимаем сообщение и обнуляем дескриптор
        }
        /*...*/
    }
}

Old style name

OS_AcceptMsg

См. также

OS_Msg_Create

OS_Msg_Check

OSA : OS_Msg_Check

2010-10-07T13:52:52+03:00

OSA : OS_Msg_Create

2010-10-07T13:52:53+03:00

OSA : OS_Msg_Send

2009-12-04T19:59:11+03:00

OSA : OS_Msg_Send

OS_Msg_Send (msg_cb, message)

Отправляем сообщение msg_cb (тип OST_MSG_CB). Если дескриптор сообщения уже занят, то ждем, когда он освободится (будет обрабтан принимающей задачей).

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

Только из задачи

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

`msg_cb`	Дескриптор указателя на сообщение. Переменная типа OST_MSG_CB
`message`	указатель на тело сообщения (тип OST_MSG

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

Нет

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

OST_MSG_CB msg_cb;
 
void Task (void)
{
    OST_MSG msg;
    static char *Buffer;
    for (;;) {
        /*...*/
        OS_Msg_Send (msg_cb, Buffer);  // Отправляем сообщение
        /*...*/
    }
}

Old style name

OS_SendMsg

См. также

OS_Msg_Create

OSA : OS_Msg_Send_Now

2009-12-04T20:00:58+03:00

OSA : OS_Msg_Send_Now

OS_Msg_Send_Now (msg_cb, message)

Отправляем сообщение msg_cb. Если такое сообщение уже активно, то оно затирается новым.

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

Только не из прерывания

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

`msg_cb`	Дескриптор указателя на сообщение. Переменная типа OST_MSG_CB
`message`	указатель на тело сообщения (тип OST_MSG)

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

bEventError Если дескриптор сообщения не освободился, то сервис OS_IsEventError возвратит true

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

OST_MSG_CB msg_cb;
void Task (void)
{
    static char Buffer[10];
    for (;;) {
        /*...*/
        OS_Msg_Send_Now (msg_cb, Buffer);   // Отправляем новое сообщение, не дожидаясь,
                                            // когда примется предыдущее
        /*...*/
    }
}

Old style name

OS_SendMsgNoWait

См. также

OS_Msg_Create

OSA : OS_Msg_Send_TO

2009-12-04T20:00:01+03:00

OSA : OS_Msg_Send_TO

OS_Msg_Send_TO (msg_cb, message, timeout)

Отправляем сообщение. Если дескриптор сообщения не свободен, то перед отправкой ждем его освобождения в течение указанного времени. Если так и не дождались, то выходим из ожидания по таймауту.

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

Только из задачи

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

`msg_cb`	Дескриптор указателя на сообщение. Переменная типа OST_MSG_CB
`message`	указатель на тело сообщения (тип OST_MSG
`timeout`	Время ожидания. Задается в системных тиках - периодах вызова сервиса OS_Timer

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

таймаут Если вышли из ожидания по таймауту, то сервис OS_IsTimeout возвратит true

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

OST_MSG_CB msg_cb;
 
void Task (void)
{
    OST_MSG msg;
    static char Buffer[10];
    for (;;) {
        /*...*/
        OS_Msg_Send_TO (msg_cb, Buffer, 100);  // Пытаемся отправить сообщение. Если
                                               // дескриптор занят, то в течение 100
                                               // тиков ждем его освобождения.
        if (OS_IsTimeout()) {                  // Если дескриптор так и не освободился,
                                               // то обрабатываем эту ошибку
            /*...*/
        }
        /*...*/
    }
}

Old style name

OS_SendMsgTimeout

См. также

OS_Msg_Create

OSA : OS_Msg_Wait

2010-10-07T13:52:57+03:00

OSA : OS_Msg_Wait_TO

2010-10-07T13:52:58+03:00

OSA : OS_Oldtimer_Check

2010-06-19T11:48:08+03:00

OSA : OS_Oldtimer_Check

bool OS_Oldtimer_Check (timer_id)

Проверить, закончил ли таймер счет.

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

Везде

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

timer_id Идентификатор статического таймера

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

`false`	Таймер еще считает.
`true`	Таймер закончил счет, остановлен или не был запущен

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

void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Oldtimer_Check (3))
        {
            OS_Oldtimer_Run16(3, 1000);
        }
        /*...*/
    }
}

Old style name

OS_CheckTimer

См. также

OS_Oldtimer_Wait

OSA : OS_Oldtimer_Run16

2010-10-07T13:52:59+03:00

OSA : OS_Oldtimer_Run24

2010-10-07T13:53:00+03:00

OSA : OS_Oldtimer_Run32

2010-10-07T13:53:01+03:00

OSA : OS_Oldtimer_Run8

2010-10-07T13:53:02+03:00

OSA : OS_Oldtimer_Stop

2010-10-07T13:53:03+03:00

OSA : OS_Oldtimer_Wait

2010-10-07T13:53:03+03:00

OSA : OS_Qtimer_Break

2010-06-21T17:40:30+03:00

OSA : OS_Qtimer_Break

OS_Qtimer_Break (qtimer)

Останавливает таймер, удаляет его из очереди активных таймеров. Флаг переполнения устанавливается.

Для использования очереди таймеров в файле OSAcfg.h нужно определить константу OS_ENABLE_QTIMERS. Разрядность таймеров в очереди задается константой OS_QTIMER_SIZE.

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

Везде

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

qtimer Дескриптор таймера типа OST_QTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает,активен, переполнение). Может размещаться в памяти только в bank0 или bank1

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

Нет

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

OST_QTIMER qtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Qtimer_Run(qtimer, 10);
        if (RB0) OS_Qtimer_Break (qtimer);
        /*...*/
    }
}

См. также

OSA : OS_Qtimer_Check

2010-10-07T13:53:05+03:00

OSA : OS_Qtimer_Create

2010-02-04T00:49:55+03:00

OSA : OS_Qtimer_Create

OS_Qtimer_Create (qtimer)

Инициализирует дескриптор qtimer. После создания таймер обнулен остановлен, флаг переполнения сброшен.

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

Только не из прерывания

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

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

Нет

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

OST_QTIMER qtimer;
 
void main (void)
{
    OS_Init();
    OS_Qtimer_Create(qtimer);  // После вызова этого сервиса таймер можно запускать на отсчет
    /*...*/
}

См. также

OSA : OS_Qtimer_Delay

2010-02-04T03:52:36+03:00

OSA : OS_Qtimer_Delay

OS_Qtimer_Delay (qtimer, delay)

Выдержать задержку с использованием таймера qtimer

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

Только из задачи

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

`qtimer`	Дескриптор таймера типа OST_QTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает,активен, переполнение). Для PIC16 может размещаться в памяти только в bank0 или bank1
`delay`	Время задержки. Задается в системных тиках - периодах вызова сервиса OS_Timer

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

Нет

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

OST_QTIMER qtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Qtimer_Delay (qtimer, 100);
        /*...*/
    }
}

См. также

OSA : OS_Qtimer_Delete

2012-03-28T16:21:30+03:00

OSA : OS_Qtimer_Delete

OS_Qtimer_Delete (qtimer)

Удаляет qtimer из очереди активных таймеров. Флаг переполнения остается без изменений. После этого сервиса с таймером работать нельзя. Его нужно вновь создать сервисом OS_Qtimer_Create.

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

Только не из прерывания

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

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

Нет

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

OST_QTIMER qtimer;
 
void Task (void)
{
    for (;;) {
        /*...*/
        OS_Qtimer_Delete (qtimer);
        /*...*/
    }
}

См. также

OSA : OS_Qtimer_Get

2010-02-22T14:15:45+03:00

OSA : OS_Qtimer_Get

OST_TIMER OS_Qtimer_Get (qtimer)

Получить оставшееся время счета. Перед вызовом этого сервиса нужно:

либо запретить прерывания (OS_DI());
либо войти в критическую секцию;

В противном случае в момент чтения таймера может произойти прерывание, которое может изменить его значение.

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

Везде

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

qtimer Дескриптор таймера типа OST_QTIMER. Содержит счетчик таймера, а также информацию о состоянии (считает,активен, переполнение). Для PIC16 может размещаться в памяти только в bank0 или bank1

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

OST_TIMER Время, оставшееся до переполнения (в системных тиках)

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

OST_QTIMER qtimer;
 
void Task (void)
{
    char itemp;
    for (;;) {
        /*...*/
        itemp = OS_DI();
        if (OS_Qtimer_Get(qtimer) < 10)   // Зажечь зеленый светодиод, если
            GREEN_LED = 1;                // осталось менее 10 тиков счета
        OS_RI(itemp);
        /*...*/
    }
}

См. также

OSA : OS_Qtimer_IsRun

2010-10-07T13:53:10+03:00

OSA : OS_Qtimer_Run

2010-10-07T13:53:10+03:00

OSA : OS_Qtimer_Wait

2010-10-07T13:53:11+03:00

OSA : OS_Queue_Check

2010-10-07T13:53:12+03:00

OSA : OS_Queue_Create

2010-10-07T13:53:13+03:00

OSA : OS_Queue_IsEmpty

2010-10-07T13:53:14+03:00

См. также

2009-06-30T19:10:54+03:00

OSA : OS_Queue_IsFull

2009-06-30T19:11:37+03:00

OSA : OS_Queue_IsFull

bool OS_Queue_IsFull (queue)

Проверить, есть ли место в очереди для добавления нового сообщения.

Для использования очередей сообщений в файле OSAcfg.h должна быть определена константа OS_ENABLE_QUEUE.

Для PIC16 переменная queue может размещаться в памяти только в bank0 или bank1

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

Везде

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

queue Дескриптор очереди сообщений. Переменная типа OST_QUEUE.

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

`false`	В очереди еще есть место
`true`	Очередь переполнена. Новое сообщение можно добавить, только вытеснив первое сообщение из очереди.

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

OST_QUEUE queue;
 
void Task (void)
{
    static char Data[10];
    for (;;) {
        /*...*/
        if (!OS_Queue_IsFull (queue)) {                // Если в очереди еще есть место,
            OS_Queue_Send_Now(queue, (OST_MSG)Data); // то отправить сообщение
        }
        /*...*/
    }
}

Old style name

OS_IsQMsgFull

См. также

OS_Queue_Create

OSA : OS_Queue_Send

2009-12-04T20:02:29+03:00

OSA : OS_Queue_Send

OS_Queue_Send (queue, message)

Отправляем сообщение с содержимым message в очередь queue. Если очередь переполнена, то ждем, когда появится свободное место.

Для использования очередей сообщений в файле OSAcfg.h должна быть определена константа OS_ENABLE_QUEUE.

Для PIC16 переменная queue может размещаться в памяти только в bank0 или bank1

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

Только из задачи

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

`queue`	Дескриптор очереди сообщений. Переменная типа OST_QUEUE.
`message`	указатель на тело сообщения (тип OST_MSG)

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

Нет

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

OST_QUEUE queue;
 
void Task (void)
{
    static char Data[5];
    for (;;) {
        /*...*/
        OS_Queue_Send (queue, Data);
        /*...*/
    }
}

Old style name

OS_SendQMsg

См. также

OS_Queue_Create

OSA : OS_Queue_Send_Now

2009-12-04T20:03:14+03:00

OSA : OS_Queue_Send_Now

OS_Queue_Send_Now (queue, message)

Отправляем сообщение с содержимым message в очередь queue. Если в очереди нет места, то из нее выталкивается самое старое сообщение.

Для использования очередей сообщений в файле OSAcfg.h должна быть определена константа OS_ENABLE_QUEUE.

Для PIC16 переменная queue может размещаться в памяти только в bank0 или bank1

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

Только не из прерывания

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

`queue`	Дескриптор очереди сообщений. Переменная типа OST_QUEUE.
`message`	указатель на тело сообщения (тип OST_MSG)

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

bEventError Если перед вызовом в очереди не было свободного места, то сервис OS_IsEventError возвратит true

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

OST_QUEUE queue;
 
void Task (void)
{
    static char Data[5];
    for (;;) {
        /*...*/
        OS_Queue_Send_Now (queue, Data);
        /*...*/
    }
}

Old style name

OS_SendQMsgNoWait

См. также

OS_Queue_Create

OSA : OS_Queue_Send_TO

2009-12-04T20:02:53+03:00

OSA : OS_Queue_Send_TO

OS_Queue_Send_TO (queue, message, timeout)

Отправляем сообщение с содержимым message в очередь queue. Если очередь переполнена, то в течение заданного времени ждем, когда появится свободное место. Если так и не дождались, то выходим из ожидания по таймауту.

Для использования очередей сообщений в файле OSAcfg.h должна быть определена константа OS_ENABLE_QUEUE.

Для PIC16 переменная queue может размещаться в памяти только в bank0 или bank1

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

Только из задачи

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

`queue`	Дескриптор очереди сообщений. Переменная типа OST_QUEUE.
`message`	указатель на тело сообщения (тип OST_MSG)
`timeout`	Время ожидания. Задается в системных тиках - периодах вызова сервиса OS_Timer

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

таймаут Если вышли из ожидания по таймауту, то сервис OS_IsTimeout возвратит true

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

OST_QUEUE queue;
 
void Task (void)
{
    static char Data[5];
    for (;;) {
        /*...*/
        // В течение 100 тиков пытаемся отправить сообщение в очередь.
        OS_Queue_Send_TO (queue, Data, 100);
        if (OS_IsTimeout()) {
            // Сообщение не отправлено
            /*...*/
        }
        /*...*/
    }
}

Old style name

OS_SendQMsgTimeout

См. также

OS_Queue_Create

OSA : OS_Queue_Wait

2010-10-07T13:53:19+03:00

OSA : OS_Queue_Wait_TO

2010-10-07T13:53:19+03:00

OSA : OS_RI

2010-10-07T13:53:20+03:00

OSA : OS_Run

2009-06-13T05:31:12+03:00

OSA : OS_Run

OS_Run ()

Основная работа операционки, вызывается в главном цикле функции main(). Перебирает все дескрипторы задач и проверяет их готовность к выполнению, а также выбирает самую высокоприоритетную из готовых и передает ей управление. Этот сервис является макросом, который представляет из себя вечный цикл с вызовом OS_Sched в теле.

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

Только из main()

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

Нет

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

Нет

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

void main (void)
{
    OS_Init();
 
    OS_Run();
}

См. также

OS_Sched

OSA : OS_Sched

2009-06-13T05:31:27+03:00

OSA : OS_Sched

OS_Sched ()

Рекомендуется использовать сервис OS_Run.

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

Только из main()

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

Нет

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

Нет

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

void main (void)
{
    OS_Init();
 
    for (;;) OS_Sched();
}

См. также

OS_Run

OSA : OS_Smsg_Accept

2010-10-07T13:53:23+03:00

OSA : OS_Smsg_Check

2009-04-15T16:35:24+03:00

OSA : OS_SMsg_Check

bool OS_SMsg_Check (smsg)

Проверить, активно ли сообщение (присутствует ли оно).

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

Везде

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

smsg Дескриптор короткого сообщения. Переменная типа OST_SMSG

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

`false`	сообщение не пришло
`true`	сообщение пришло

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

OST_SMSG button_smsg;
 
void Task (void)
{
    OST_SMSG smessage;
    for (;;) {
        /*...*/
        if (OS_SMsg_Check (button_smsg)) {        // Проверяем, пришло ли сообщение от кнопки
            OS_SMsg_Accept(button_smsg, smessage);// Если да, то извлекаем его
            switch (smessage) {                   // и обрабатываем
            /*...*/
            }
        }
        /*...*/
    }
}

Old style name

OS_CheckSMsg

См. также

OS_SMsg_Create

OS_SMsg_Accept

OSA : OS_Smsg_Create

2010-10-07T13:53:24+03:00

OSA : OS_Smsg_Send

2010-10-07T13:53:25+03:00

OSA : OS_Smsg_Send_Now

2010-10-07T13:53:26+03:00

OSA : OS_Smsg_Send_TO

2010-10-07T13:53:27+03:00

OSA : OS_Smsg_Wait

2010-10-07T13:53:28+03:00

OSA : OS_Smsg_Wait_TO

2010-10-07T13:53:29+03:00

OSA : OS_Squeue_Check

2010-10-07T13:53:30+03:00

OSA : OS_Squeue_Create

2010-10-07T13:53:30+03:00

OSA : OS_Squeue_IsEmpty

2010-10-07T13:53:31+03:00

OSA : OS_Squeue_IsFull

2010-10-07T13:53:32+03:00

OSA : OS_Squeue_Send

2010-10-07T13:53:33+03:00

OSA : OS_Squeue_Send_Now

2010-10-07T13:53:34+03:00

OSA : OS_Squeue_Send_TO

2010-10-07T13:53:35+03:00

OSA : OS_Squeue_Wait

2010-10-07T13:53:36+03:00

OSA : OS_Squeue_Wait_TO

2010-10-07T13:53:37+03:00

OSA : OS_Stimer_Alloc

2010-02-05T01:59:17+03:00

OSA : OS_Stimer_Alloc

OS_Stimer_Alloc (var_stimer_id)

Выделяет свободный статический таймер и возвращает номер его ID.

Для использования статических таймеров в файле OSAcfg.h нужно определить константу OS_STIMERS. Разрядность статических таймеров задается константой OS_STIMER_SIZE.

Для использования этого сервиса в файле osacfg.h должна быть определена константа OS_ENABLE_STIMERS_ALLOCATION

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

Только не из прерывания

Параметры сервиса:

var_stimer_id Переменная типа unsigned char, в которую будет сохранен ID свободного таймера. 0xFF, если свободный таймер не был найден

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

OS_IsError() возвращает true, если свободного таймера нет

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

void Task (void)
{
    static char stimer;
    for (;;) {
        /*...*/
        OS_Stimer_Alloc(stimer);   // Выделяем его.
        if (!OS_IsError())
        {
            /* работаем с таймером */
        }
        OS_Stimer_Delete(stimer);   // Освобождаем таймер
        /*...*/
    }
}

См. также

OSA : OS_Stimer_Break

2010-02-04T17:56:08+03:00

OSA : OS_Stimer_Break

OS_Stimer_Break (stimer_id)

Останавливаем таймер. Флаг переполнения утсанавливается, значение таймера обнуляется.

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

Везде

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

stimer_id Идентификатор статического таймера. Количетсво и разрядность статических таймеров задается в файле OSAcfg.h константами OS_STIMERS и OS_STIMER_SIZE

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Stimer_Break (1);
        /*...*/
    }
}

Old style name

OS_StopSTimer

См. также

OSA : OS_Stimer_Check

2010-06-19T11:46:34+03:00

OSA : OS_Stimer_Check

bool OS_Stimer_Check (stimer_id)

Проверить, было ли переполнение.

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

Везде

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

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

`false`	Таймер считает, таймаута не было
`true`	Был таймаут или таймер остановлен

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Stimer_Run(1, 100);
        while (!OS_Stimer_Check (1)) OS_Yield();
        /*...*/
    }
}

Old style name

OS_CheckSTimer

См. также

OSA : OS_Stimer_Continue

2010-02-04T17:57:27+03:00

OSA : OS_Stimer_Continue

OS_Stimer_Continue (stimer_id)

Восстанавливаем счет таймера (после приостановки OS_Stimer_Pause).

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

Везде

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

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_PauseTimer(1);        // Приостановить таймер 1
        /* ... здесь таймер 1 не считает */
        OS_Stimer_Continue (1);   //Продолжить счет таймера
        /*...*/
    }
}

Old style name

OS_ContinueSTimer

См. также

OSA : OS_Stimer_Delay

2010-02-04T17:56:29+03:00

OSA : OS_Stimer_Delay

OS_Stimer_Delay (stimer_id, delay)

Выдержать задержку с применением статического таймера stimer_id

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

Только из задачи

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

`stimer_id`	Идентификатор статического таймера. Количетсво и разрядность статических таймеров задается в файле OSAcfg.h константами OS_STIMERS и OS_STIMER_SIZE
`delay`	Время задержки. Задается в системных тиках - периодах вызова сервиса OS_Timer

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Stimer_Delay (2, 10);   // Выдерживаем паузу в задаче в 10 тиков
        /*...*/
    }
}

Old style name

OS_DelaySTimer

См. также

OSA : OS_Stimer_Found

2010-02-05T02:01:04+03:00

OSA : OS_Stimer_Found

bool OS_Stimer_Found ()

Проверяет, есть ли свободный статический таймер

Для использования этого сервиса в файле osacfg.h должна быть определена константа OS_ENABLE_STIMERS_ALLOCATION

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

Не из прерывания

Параметры сервиса:

нет

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

`true`	Есть свободный статический таймер
`false`	Все таймеры заняты

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

void Task (void)
{
    static unsigned char stimer_id;
    for (;;) {
        /*...*/
        OS_Wait(OS_Stimer_Found());    // Ждем появление свободного таймера
        OS_Stimer_Create(stimer_id);   // Выделяем таймер для работы
        OS_Stimer_Run(stimer_id, 100); // Теперь работаем через переменную
 
        do {
           // ...
        } while (!OS_Stimer_Check(stimer_id));
 
        OS_Stimer_Delete(stimer_id);   // Освобождаем таймер
        /*...*/
    }
}

См. также

OSA : OS_Stimer_Free

2010-02-05T01:59:46+03:00

OSA : OS_Stimer_Free

OS_Stimer_Free (stimer_id)

Освободить ранее выделенный сервисом OS_Stimer_Alloc таймер по его номеру.

Для использования этого сервиса в файле osacfg.h должна быть определена константа OS_ENABLE_STIMERS_ALLOCATION

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

Только не из прерывания

Параметры сервиса:

stimer_id ID освобождаемого таймера

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

нет

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

void Task (void)
{
    static unsigned char stimer_id;
    for (;;) {
        /*...*/
        OS_Wait(OS_Stimer_Found());    // Ждем появление свободного таймера
        OS_Stimer_Alloc(stimer_id);    // Выделяем таймер для работы
        OS_Stimer_Run(stimer_id, 100); // Теперь работаем через переменную
 
        do {
           // ...
        } while (!OS_Stimer_Check(stimer_id));
 
        OS_Stimer_Free(stimer_id);   // Освобождаем таймер
        /*...*/
    }
}

См. также

OSA : OS_Stimer_Get

2010-02-04T17:56:41+03:00

OSA : OS_Stimer_Get

_OST_STIMER OS_Stimer_Get (stimer_id)

Получить оставшееся время счета.

Если обработка таймеров OS_Timer вызывается из функции-прерывания, то перед вызовом этого сервиса нужно либо запретить прерывания (OS_DI()), либо войти в критическую секцию.

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

Везде

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

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

_OST_STIMER Сколько тиков осталось до переполнения

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

void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Stimer_Get (1) < 10) GREEN_LED = 1;   // Зажигаем светодиод, если осталось
                                                    // считать < 10 тиков
        /*...*/
    }
}

Old style name

OS_GetSTimer

См. также

OSA : OS_Stimer_IsRun

2010-02-04T17:57:03+03:00

OSA : OS_Stimer_IsRun

bool OS_Stimer_IsRun (stimer_id)

Проверить, считает ли таймер

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

Везде

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

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

`false`	Таймер остановлен
`true`	Таймер считает

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

void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Stimer_IsRun (0)) OS_Stimer_Stop(0);
        /*...*/
    }
}

Old style name

OS_IsSTimerRun

См. также

OSA : OS_Stimer_Pause

2010-02-04T17:57:15+03:00

OSA : OS_Stimer_Pause

OS_Stimer_Pause (stimer_id)

Приостанавливаем таймер. Флаг переполнения уcтанавливается, значение счетчика запоминается.

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

Везде

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

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Stimer_Pause (1);
        /*...*/
    }
}

Old style name

OS_PauseSTimer

См. также

OSA : OS_Stimer_Run

2010-02-04T17:55:58+03:00

OSA : OS_Stimer_Run

OS_Stimer_Run (stimer_id, time)

Запустить таймер stimer_id на отсчет времени time. Флаг переполнения сбрасывается.

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

Везде

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

`stimer_id`	Идентификатор статического таймера. Количетсво и разрядность статических таймеров задается в файле OSAcfg.h константами OS_STIMERS и OS_STIMER_SIZE
`time`	Время, на которое запускается таймер. Задается в системных тиках - периодах вызова сервиса OS_Timer. Не должно превышать разрядности таймера

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Stimer_Run (2, 100);    // Запустить статический таймер номер 2 на 100 тиков
        /*...*/
    }
}

Old style name

OS_RunSTimer

См. также

OSA : OS_Stimer_Stop

2010-10-07T13:53:48+03:00

OSA : OS_Stimer_Wait

2010-02-04T17:56:20+03:00

OSA : OS_Stimer_Wait

OS_Stimer_Wait (stimer_id)

Ожидаем завершения счета таймера.

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

Только из задачи

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

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Stimer_Run(1, 100);     // Запускаем счет на 100 тиков
        OS_Stimer_Wait (1);        // Ждем завершения счета
        /*...*/
    }
}

Old style name

OS_WaitSTimer

См. также

OSA : OS_Task_Continue

2010-08-11T16:32:56+03:00

OSA : OS_Task_Continue

OS_Task_Continue (OST_TASK_POINTER tp)

Продолжить выполнение ранее приостановленной сервисом OS_Task_Pause() задачи.

Перед вызовом этого сервиса нужно быть уверенным в том, что tp инициализирован сервисом OS_Task_GetCur.

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

Везде

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

tp Указатель на дескиптор задачи (OST_TASK_POINTER)

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Task_Pause(tp);                 // Pause external task
        /*...*/                           // Make time critical operations
        OS_Task_Continue(tp);              // Continue paused task
        /*...*/
    }
}

Old style name

OS_ContinueTask

См. также

OSA : OS_Task_Create

2010-08-11T16:34:38+03:00

OSA : OS_Task_Create

OS_Task_Create (priority, TaskName)

Инициализируем конкретную задачу. Этот сервис ищет в памяти свободный дескриптор задачи и записывает в него адрес создаваемой задачи, приоритет и флаги состояния. Изначально задача считается готовой к выполнению. Как только эта задача станет самой приоритетной из готовых, она получит управление.

При ипользовании CCS: компилятор должен быть проинформирован о том, что функция TaskName будет вызвана планировщиком через указатель, поэтому в функции main нужно вызывать сервис OS_Task_Define.

При использовании mikroC PRO: все фунции-задачи должны быть описаны директивой #pragma fncall, напрмер:

#pragma fncall main MyTask
void MyTask (void)
{
…

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

Только не из прерывания

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

`priority`	Приоритет. Может быть от 0 (высший) до 7 (низший)
`TaskName`	Имя функции, которая будет использоваться как задача.

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

FSR (FSR0) Указывает на дескриптор задачи. Обычно в нем нет необходимости, но если будет нужно изменять приоритет этой задачи из другой, то можно пользоваться этим указателем.

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

void Task1 (void)
{
    for (;;) OS_Yield();
}
 
void Task2 (void)
{
    for (;;) OS_Yield();
}
 
void main (void)
{
    OS_Init();
    OS_Task_Create (1, Task1);    // Создаем задачу Task1 с приоритетом 1
    OS_Task_Create (5, Task2);    // Создаем задачу Task1 с приоритетом 5
    /*...*/
}

Old style name

OS_CreateTask

См. также

OSA : OS_Task_Define

2009-07-25T15:26:23+03:00

OSA : OS_Task_Define

OS_Task_Define (TaskName)

Для пользователей CCS: этот сервис должен вызываться из функции main(); вызовом этого сервиса мы сообщаем компилятору, что функция с именем TaskName будет вызываться планировщиком по указателю.

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

Only from main()

Параметры:

TaskName Имя C-функции, описывающей задачу

Возвращает:

Nothing

Пример:

void Task1 (void)
{
    for (;;) OS_Yield();
}
 
void Task2 (void)
{
    for (;;) OS_Yield();
}
 
void main (void)
{
    OS_Init();
 
    OS_Task_Define(Task1);       // Говорим компилятору, что функции Task1 и
    OS_Task_Define(Task2);       // Task2 вызываются планировщиком по указателю
 
    OS_Task_Create(1, Task1);    // Создаем задачи
    OS_Task_Create(5, Task2);    // 
    /*...*/
}

Old style name

См. также:

OSA : DeleteTask

2010-08-11T16:35:04+03:00

OSA : DeleteTask

OS_Task_Delete (OST_TASK_POINTER tp)

Остановить внешнюю задачу и удалить ее из списка активных задач. С вызовом этого сервиса нужно быть осторожным: следует быть увереным, что останавливаемая задача не занимает какой-нибудь ресурс, которого ждет другая задача. Рекомендуется после выполняния этого сервиса обнулять указатель на дескриптор.

Перед вызовом этого сервиса нужно быть уверенным в том, что tp инициализирован сервисом OS_Task_GetCur.

В качестве tp можно использовать макрос this_task или сервис OS_Task_GetCur().

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

Везде

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

tp Указатель на дескиптор задачи (OST_TASK_POINTER)

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Task_Delete (tp);
        tp = (OST_TASK_POINTER)0;
        /*...*/
    }
}

Old style name

OS_DeleteTask

См. также

OSA : OS_Task_GetCreated

2010-08-11T16:35:37+03:00

OSA : OS_Task_GetCreated

OST_TASK_POINTER OS_Task_GetCreated ()

Этот сервис вызывается сразу за OS_Task_Create() и возвращает указатель на дескриптор только что созданной задачи. Этот указатель может быть использован для управления задачей из другой задачи (удаления, приостановки и т.д.).

Перед вызовом этого сервиса нужно убедиться, что OS_Task_Create() действительно создал задачу (OS_IsError() должен вернуть false)

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

Сразу за вызовом OS_Task_Create

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

нет

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

OST_TASK_POINTER Указатель на дескриптор задачи.

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

OST_TASK_POINTER tp1;
 
void Task1 (void)
{
    for (;;) OS_Yield();
}
 
void Task2 (void)
{
    for (;;)
    {
        OS_Task_Pause(tp1);
        /*...*/
        OS_Task_Continue(tp1);
    }
}
 
void main (void)
{
    OS_Init();
    OS_Task_Create (1, Task1);                     // Создаем задачу Task1 с приоритетом 1
    if (!OS_IsError()) tp1 = OS_Task_GetCreated(); // Получаем дескриптор
 
    OS_Task_Create (5, Task2);    // Создаем задачу Task1 с приоритетом 5
 
    OS_Run();
}

Old style name

См. также

OSA : OS_GetCurTask

2010-08-11T16:35:21+03:00

OSA : OS_GetCurTask

OST_TASK_POINTER OS_Task_GetCur ()

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

Только из задачи

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

Нет

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

OST_TASK_POINTER Указатель на дескриптор текущей задачи

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

OST_TASK_POINTER tp_Task;
void Task (void)
{
    tp_Task = OS_Task_GetCur();
    for (;;) {
        /*...*/
    }
}

См. также

OSA : OS_Task_GetPriority

2010-08-11T16:33:31+03:00

OSA : OS_Task_GetPriority

char OS_Task_GetPriority (OST_TASK_POINTER tp)

Возвращает приоритет задачи.

Перед вызовом этого сервиса нужно быть уверенным в том, что tp инициализирован сервисом OS_Task_GetCur.

В качестве tp можно использовать макрос this task или сервис OS_Task_GetCur().

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

Везде

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

tp Указатель на дескиптор задачи (OST_TASK_POINTER)

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

char Текущий приоритет задачи (от 0 до 7)

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

void Task (void)
{
    static char temp;
    for (;;) {
        /*...*/
        temp = OS_Task_GetPriority(this_task);
        OS_Task_SetPriority(this_task, 0);           // Устанавливаем задаче высший приоритет
        // Здесь выполняем критические ко времени операции
        /*...*/
        OS_Task_SetPriority(this_task, temp);        // Восстанавливаем старый приоритет
        /*...*/
    }
}

Old style name

OS_GetTaskPriority

См. также

OSA : OS_Task_IsEnable

2010-08-11T16:30:53+03:00

OSA : OS_Task_IsEnable

bool OS_Task_IsEnable (tcb)

Проверить, активна ли внешняя задача. Применяется для того, чтобы быть уверенным в том, что операции проводятся с существующей задачей.

Перед вызовом этого сервиса нужно быть уверенным в том, что tcb инициализирован сервисом OS_Task_GetCur.

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

Везде

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

tcb Указатель на дескиптор задачи (OST_TASK_POINTER)

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

Нет

`false`	задача не активна (либо удалена либо не была создана)
`true`	задача присутствует в списке активных задач

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

void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Task_IsEnable (tcb)) {
            /*...*/
        }
        /*...*/
    }
}

Old style name

OS_IsTaskEnable

См. также

OSA : OS_Task_IsPaused

2010-08-11T16:32:18+03:00

OSA : OS_Task_IsPaused

bool OS_Task_IsPaused (OST_TASK_POINTER tp)

Проверить, приостановлена ли внешняя задача

Перед вызовом этого сервиса нужно быть уверенным в том, что tp инициализирован сервисом OS_Task_GetCur.

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

Везде

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

tp Указатель на дескиптор задачи (OST_TASK_POINTER)

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

Нет

`false`	задача не приостановлена
`true`	задача приостановлена

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

OST_MSG_CB msg_cb;
 
void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Task_IsPaused (tp)) {
            OS_Msg_Send(msg_cb, "Paused.");
        };
        /*...*/
    }
}

Old style name

OS_IsTaskPaused

См. также

OSA : OS_Task_Pause

2010-08-11T16:35:51+03:00

OSA : OS_Task_Pause

OS_Task_Pause (OST_TASK_POINTER tp)

Приостановить задачу.

Перед вызовом этого сервиса нужно быть уверенным в том, что tp инициализирован сервисом OS_Task_GetCur.

В качестве tpможно использовать макрос this task или сервис OS_Task_GetCur().

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

Везде

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

tp Указатель на дескиптор задачи (OST_TASK_POINTER)

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Task_Pause(tp);                 // Pause external task
        /*...*/                           // Make time critical operations
        OS_Task_Continue(tp);              // Continue paused task
        /*...*/
    }
}

Old style name

OS_PauseTask

См. также

OSA : OS_Task_Replace

2010-08-11T16:34:51+03:00

OSA : OS_Task_Replace

OS_Task_Replace (priority, TaskName)

Заменить текущую задачу на новую. Задача переводится в состояние "не создана", дескриптор текущей задачи освобождается, а на ее место в дескриптор заносится новая задача, ее приоритет и флаги состояния. Изначально новая задача находится в состоянии готовности.

Допускается перезапуск задачей самой себя. Может оказаться полезным для быстрого перезапуска, когда вечному циклу внутри задачи предшествует секция инициализации.

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

Только из задачи

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

`priority`	Приоритет. Может быть от 0 (высший) до 7 (низший)
`TaskName`	Имя функции, которая будет использоваться как задача.

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

Нет

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

void Task2 (void)
{
    for (;;) {
        OS_Yield();
        /*...*/
    }
}
 
void Task1 (void)
{
    char temp;
    for (;;) {
        /*...*/
        // Удаляем текущую задачу и на ее место создаем Task2() с таким же приоритетом
        temp = OS_Task_GetPriority();
        OS_Task_Replace (temp, Task2);
        /*...*/
    }
}

Old style name

OS_ReplaceTask

См. также

OSA : OS_Task_SetPriority

2010-08-11T16:33:14+03:00

OSA : OS_Task_SetPriority

OS_Task_SetPriority (OST_TASK_POINTER tp, char priority)

Изменить приоритет задачи.

Перед вызовом этого сервиса нужно быть уверенным в том, что tp инициализирован сервисом OS_Task_GetCur.

В качестве tp можно использовать макрос this task или сервис OS_Task_GetCur().

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

Только из задачи

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

`tp`	Указатель на дескиптор задачи (OST_TASK_POINTER)
`priority`	Приоритет. Может быть от 0 (высший) до 7 (низший)

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

Нет

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

void Task (void)
{
    static char temp;
    for (;;) {
        /*...*/
        temp = OS_Task_GetPriority(this_task);
        OS_Task_SetPriority(this_task, 0);           // Устанавливаем задаче высший приоритет
        // Здесь выполняем критические ко времени операции
        /*...*/
        OS_Task_SetPriority(this_task, temp);        // Восстанавливаем старый приоритет
        /*...*/
    }
}

Old style name

OS_SetTaskPriority

См. также

OSA : OS_Task_Stop

2010-10-07T13:54:00+03:00

OSA : OS_Timer

2008-09-13T05:28:59+03:00

OSA : OS_Timer

OS_Timer ()

Обработка всех таймеров (вставляется в периодическое место в программе, например, в прерывание по таймеру). Эта функция должна использоваться, если в программе есть OS_Delay, работа с OS_xxxTimer или ожидание событий с таймаутом.

Увеличивает все активные таймеры на 1. Как только таймер переполняется, выставляется соответствующий ему бит переполнения.

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

В периодическом месте программы.

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

Нет

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

Нет

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

void interrupt isr (void)
{
    if (TMR2IF) {
        TMR2IF = 0;
        OS_Timer();
    }
}

OSA : OS_Ttimer_Break

2010-02-03T18:29:25+03:00

OSA : OS_Ttimer_Break

OS_Ttimer_Break ()

Останавливает счет таймера текущей задачи. Флаг переполнения утсанавливается.

Для использования таймеров задач в файле OSAcfg.h нужно определить константу OS_ENABLE_TTIMERS. Разрядность таймеров задач задается константой OS_TTIMER_SIZE.

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

Только из задачи

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

нет

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Ttimer_Get() < 10) OS_Ttimer_Break (1);
        /*...*/
    }
}

См. также

OSA : OS_Ttimer_Check

2010-06-19T11:46:58+03:00

OSA : OS_Ttimer_Check

bool OS_Ttimer_Check ()

Проверить, закончил ли таймер текущей задачи счет.

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

Разрешается вызов из задачи и функций, вызываемых задачей (любой вложенности)

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

нет

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

`false`	Таймер считает, таймаута не было
`true`	Был таймаут или таймер остановлен

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Ttimer_Run(100);
        while (!OS_Ttimer_Check ()) OS_Yield();
        /*...*/
    }
}

См. также

OSA : OS_Ttimer_Continue

2010-10-07T13:54:04+03:00

OSA : OS_Ttimer_Delay

2010-10-07T13:54:05+03:00

OSA : OS_Ttimer_Get

2010-02-03T18:33:23+03:00

OSA : OS_Ttimer_Get

_OST_TTIMER OS_Ttimer_Get ()

Получить оставшееся время счета.

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

Только из задачи

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

нет

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

_OST_TTIMER Сколько тиков осталось до переполнения

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

void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Ttimer_Get () < 10) GREEN_LED = 1;   // Зажигаем светодиод, если осталось
                                                    // считать < 10 тиков
        /*...*/
    }
}

См. также

OSA : OS_Ttimer_IsRun

2010-02-03T18:33:38+03:00

OSA : OS_Ttimer_IsRun

bool OS_Ttimer_IsRun ()

Проверить, считает ли таймер в данный момент

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

Только из задачи

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

нет

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

`false`	Таймер остановлен
`true`	Таймер считает

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

void Task (void)
{
    for (;;) {
        /*...*/
        if (OS_Ttimer_IsRun ()) OS_Ttimer_Break();
        /*...*/
    }
}

См. также

OSA : OS_Ttimer_Pause

2010-02-03T18:32:41+03:00

OSA : OS_Ttimer_Pause

OS_Ttimer_Pause ()

Приостанавливаем таймер текущей задачи. Флаг переполнения утсанавливается.

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

Только из задачи

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

нет

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Ttimer_Pause (1);
        /*...*/
    }
}

См. также

OSA : OS_Ttimer_Run

2010-02-03T18:26:51+03:00

OSA : OS_Ttimer_Run

OS_Ttimer_Run (time)

Запустить таймер текущей задачи на отсчет времени time. Флаг переполнения сбрасывается.

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

Только из задачи

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

time Время, на которое запускается таймер. Задается в системных тиках - периодах вызова сервиса OS_Timer. Не должно превышать разрядности таймера

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

Нет

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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Ttimer_Run (100);    // Запустить таймер текущей задачи на 100 тиков
        /*...*/
    }
}

См. также

OSA : OS_Ttimer_Wait

2010-10-07T13:54:09+03:00

OSA : OS_Wait

2009-06-28T23:12:34+03:00

OSA : OS_Wait

OS_Wait (condition)

Переводит задачу в режим ожидания до тех пор, пока не будет выполнено заданное условие. Условием condition в данном случае может быть любое выражение перечислимого типа (bool, char, int и т.д.). Как только условие выполняется, задача переходит в состояние готовности и, как только задача становится самой приоритетной из всех готовых, она получает управление. Исключение - состязяние приоритетов.

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Wait (RA0 == 0 && RA1 == 1);
        /*...*/
    }
}

Old style name

OS_WaitCondition
OS_Cond_Wait

См. также

OSA : OS_Wait_TO

2010-10-07T13:54:11+03:00

OSA : OS_Yield

2010-10-07T13:54:12+03:00