====== OSA : OS_Bsem_Wait_TO ======
<color blue>**OS_Bsem_Wait_TO (bsem, timeout)**</color>\\ 
=== ===

{{osa:ref:attr_call_task.png|Разрешен вызов только в контексте задачи}}{{osa:ref:attr_call_ct_sw.png|Переключает контекст}}{{osa:ref:attr_call_to.png|Сервис использует таймаут}}

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






=== Разрешен вызов: ===
Только из задачи


=== Параметры функции: ===
{| class = "fpl"
|-
|//''bsem''//
|ID бинарного семафора. Количество бинарных семафоров задается в файле ##[[osa:ref:appendix:configuration|OSAcfg.h]]## константой ##[[osa:ref:appendix:configuration#Содержание данных|OS_BSEMS]]##
|-
|//''timeout''//
|Время ожидания. Задается в системных тиках - периодах вызова сервиса ##[[osa:ref:allservices:OS_Timer|OS_Timer]]##
|}


=== Возвращаемое значение: ===
{| class = "fpl"
|-
|//''таймаут''//
|Если вышли из ожидания по таймауту, то сервис ##[[osa:ref:allservices:OS_IsTimeout|OS_IsTimeout]]## возвратит **true**
|}


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

#define BS_DATA_RECEIVED     0

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


=== Old style name ===
<color gray>**OS_WaitBSemTimeout**</color>\\ 










=== См. также ===
  * [[osa:ref:allservices:OS_Bsem_Set|OS_Bsem_Set]]
  * [[osa:ref:allservices:OS_Bsem_Reset|OS_Bsem_Reset]]
  * [[osa:ref:allservices:OS_Bsem_Switch|OS_Bsem_Switch]]
  * [[osa:ref:allservices:OS_Bsem_Check|OS_Bsem_Check]]

  * [[osa:ref:allservices:OS_Bsem_Wait|OS_Bsem_Wait]]

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