====== OSA : OS_Qtimer_Run ======
<color blue>**OS_Qtimer_Run (qtimer, newtime)**</color>\\ 
=== ===

{{osa:ref:attr_call_to.png|Сервис использует таймаут}}

Запустить //qtimer// на отсчет времени //newtime//, таймер добавляется в очередь активных таймеров. Флаг переполнения сбрасывается.

Для использования очереди таймеров в файле ##[[osa:ref:appendix:configuration|OSAcfg.h]]## нужно определить константу ##[[osa:ref:appendix:configuration#Системные константы|OS_ENABLE_QTIMERS]]##. Разрядность таймеров в очереди задается константой ##[[osa:ref:appendix:configuration#Типы данных|OS_QTIMER_SIZE]]##.
=== Разрешен вызов: ===
Везде


=== Параметры функции: ===
{| class = "fpl"
|-
|//''qtimer''//
|Дескриптор таймера типа ##[[osa:ref:description:data_types#OST_QTIMER|OST_QTIMER]]##. Содержит счетчик таймера, а также информацию о состоянии (считает,активен, переполнение). Может размещаться в памяти только в **bank0** или **bank1**
|-
|//''newtime''//
|Время, на которое запускается таймер. Задается в системных тиках - периодах вызова сервиса ##[[osa:ref:allservices:OS_Timer|OS_Timer]]##. Не должно превышать разрядности таймера
|}


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

=== Пример вызова: ===
<code cpp>
OST_QTIMER qtimer;

void Task (void)
{
    OS_Qtimer_Create(qtimer);
    for (;;) {
        /*...*/
        // В течение секунды генерируем меандр 100 Гц
        OS_Qtimer_Run (qtimer, 1000);
        do {
            RB1 = 1;
            OS_Delay(5);
            RB1 = 0;
            OS_Delay(5);
        } while (!OS_Qtimer_Check(qtimer));
        /*...*/
    }
}
</code>


=== См. также ===

  * [[osa:ref:allservices:OS_Qtimer_Create|OS_Qtimer_Create]]
  * [[osa:ref:allservices:OS_Qtimer_Delete|OS_Qtimer_Delete]]

  * [[osa:ref:allservices:OS_Qtimer_Run|OS_Qtimer_Run]]
  * [[osa:ref:allservices:OS_Qtimer_Break|OS_Qtimer_Break]]
  * [[osa:ref:allservices:OS_Qtimer_Delay|OS_Qtimer_Delay]]
  * [[osa:ref:allservices:OS_Qtimer_Wait|OS_Qtimer_Wait]]

  * [[osa:ref:allservices:OS_Qtimer_Get|OS_Qtimer_Get]]
  * [[osa:ref:allservices:OS_Qtimer_Check|OS_Qtimer_Check]]
  * [[osa:ref:allservices:OS_Qtimer_IsRun|OS_Qtimer_IsRun]]


----
  * [[osa:ref:services:alphabetical|Алфавитный указатель]]
  * [[osa:ref:services:brieflist|Все сервисы]]
~~UP~~