====== OSA : OS_Stimer_Free ======
<color blue>**OS_Stimer_Free (stimer_id)**</color>\\ 
=== ===

{{osa:ref:attr_call_not_int.png|Not allowed in interrupt}}{{osa:ref:attr_call_to.png|Service uses system timer}}

Free static timer by its ID.

##Number of static timers [[en:osa:ref:appendix:configuration#Timer control|OS_STIMERS]]## (1..32) must be specified in ##[[en:osa:ref:appendix:configuration|OSAcfg.h]]##. Size of static timers is set by ##[[en:osa:ref:appendix:configuration#Data types|OS_STIMER_SIZE]]## constant

Constant ##[[en:osa:ref:appendix:configuration#Timer control|OS_STIMERS_ENABLE_ALLOCATION]]## should be defined in ##[[en:osa:ref:appendix:configuration|OSAcfg.h]]##


=== Call allowed: ===
Not in interrupt

=== Parameters: ===
{| class = "fpl"
|-
|//''stimer_id''//
|##[[en:osa:ref:services:timers#Static timers|Static timer]]## identifier. Number and size of static timers are set in ##[[en:osa:ref:appendix:configuration|OSAcfg.h]]## with ##[[en:osa:ref:appendix:configuration#Timer control|OS_STIMERS]]## and ##[[en:osa:ref:appendix:configuration#Data types|OS_STIMER_SIZE]]## constants
|}

=== Returns: ===
nothing

=== Example: ===
<code cpp>
void Task (void)
{
    static unsigned char stimer_id;
    for (;;) {
        /*...*/
        OS_Wait(OS_Stimer_Found());    // Wait for free timer
        OS_Stimer_Alloc(stimer_id);    // Allocate it for use 
        OS_Stimer_Run(stimer_id, 100); // Now we can use static timer through variable

        do {
           // ...
        } while (!OS_Stimer_Check(stimer_id));

        OS_Stimer_Free(stimer_id);    // Make timer free
        /*...*/
    }
}
</code>



=== See also ===
  * [[en:osa:ref:allservices:OS_Stimer_Alloc|OS_Stimer_Alloc]]
  * [[en:osa:ref:allservices:OS_Stimer_Free|OS_Stimer_Free]]
  * [[en:osa:ref:allservices:OS_Stimer_Found|OS_Stimer_Found]]

  * [[en:osa:ref:allservices:OS_Stimer_Run|OS_Stimer_Run]]
  * [[en:osa:ref:allservices:OS_Stimer_Break|OS_Stimer_Break]]
  * [[en:osa:ref:allservices:OS_Stimer_Wait|OS_Stimer_Wait]]
  * [[en:osa:ref:allservices:OS_Stimer_Delay|OS_Stimer_Delay]]

  * [[en:osa:ref:allservices:OS_Stimer_Get|OS_Stimer_Get]]
  * [[en:osa:ref:allservices:OS_Stimer_Check|OS_Stimer_Check]]
  * [[en:osa:ref:allservices:OS_Stimer_IsRun|OS_Stimer_IsRun]]

  * [[en:osa:ref:allservices:OS_Stimer_Pause|OS_Stimer_Pause]]
  * [[en:osa:ref:allservices:OS_Stimer_Continue|OS_Stimer_Continue]]

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