====== OSA : OS_Csem_Wait ======
<color blue>**OS_Csem_Wait (csem)**</color>\\ 
=== ===

{{osa:ref:attr_call_task.png|Allowed only in task}}{{osa:ref:attr_call_ct_sw.png|Switches context}}

Wait for counting semaphore. Decrease //csem// by 1.

##[[en:osa:ref:appendix:configuration|OS_ENABLE_CSEM]]## constant must be defined in ##[[en:osa:ref:appendix:configuration|OSAcfg.h]]##. Size of counting semaphores is defined by ##[[en:osa:ref:appendix:configuration#Data types|OS_CSEM_SIZE]]## constant

<note>
For PIC16, counting semaphores can only be allocated in **bank0** or **bank1**
</note>


=== Call allowed: ===
Only in task


=== Parameters: ===
{| class = "fpl"
|-
|//''csem''//
|Counting semaphore. Variable of ##[[en:osa:ref:description:data_types#OST_CSEM|OST_CSEM]]## type
|}


=== Returns: ===
nothing

=== Example: ===
<code cpp>
OST_CSEM csem;

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Csem_Wait(csem);
        /*...*/
    }
}
</code>


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








=== See also ===
  * [[en:osa:ref:allservices:OS_Csem_Create|OS_Csem_Create]]

  * [[en:osa:ref:allservices:OS_Csem_Signal|OS_Csem_Signal]]
  * [[en:osa:ref:allservices:OS_Csem_Set|OS_Csem_Set]]
  * [[en:osa:ref:allservices:OS_Csem_SetValue|OS_Csem_SetValue]]
  * [[en:osa:ref:allservices:OS_Csem_Reset|OS_Csem_Reset]]
  * [[en:osa:ref:allservices:OS_Csem_Accept|OS_Csem_Accept]]







  * [[en:osa:ref:allservices:OS_Csem_Check|OS_Csem_Check]]


  * [[en:osa:ref:allservices:OS_Csem_Wait_TO|OS_Csem_Wait_TO]]

----
  * [[en:osa:ref:services:alphabetical|Alphabetical]]
  * [[en:osa:ref:services:brieflist|All services]]
~~UP~~