====== OSA : OS_Ttimer_Get ======
<color blue>**_OST_TTIMER OS_Ttimer_Get ()**</color>\\ 
=== ===

{{osa:ref:attr_call_to.png|Service uses system timer}}{{osa:ref:attr_call_task_plus.png|Allowed only in task and functions called by task}}

Get task timer's remaining time. Before calling this service you should to do one of these things:
  * disable interrupts
  * enter critical section

Otherwise the timer's value can be changed in interrupt while reading.

To use task timers you need to define  ##[[en:osa:ref:appendix:configuration#Timer control|OS_ENABLE_TTIMERS]]## in ##[[en:osa:ref:appendix:configuration|OSAcfg.h]]##. Size of current task's timers is set by ##[[en:osa:ref:appendix:configuration#Data types|OS_TTIMER_SIZE]]## constant

=== Call allowed: ===
Allowed only in task and functions called by task (any depth)


=== Parameters: ===
no

=== Returns: ===
{| class = "fpl"
|-
|//''[[en:osa:ref:description:data_types#_OST_TTIMER|_OST_TTIMER]]''//
| integer value of remaining time (in system ticks)
|}


=== Example: ===
<code cpp>
void Task (void)
{
    for (;;) {
        /*...*/
        OS_DI();
        if (OS_Ttimer_Get () < 10)   // Flash red led if 
            RED_LED = 1;             // less than 10 ticks remains
        OS_EI();
        /*...*/
    }
}
</code>


=== See also ===

  * [[en:osa:ref:allservices:OS_Ttimer_Run|OS_Ttimer_Run]]
  * [[en:osa:ref:allservices:OS_Ttimer_Break|OS_Ttimer_Break]]
  * [[en:osa:ref:allservices:OS_Ttimer_Wait|OS_Ttimer_Wait]]
  * [[en:osa:ref:allservices:OS_Ttimer_Delay|OS_Ttimer_Delay]]

  * [[en:osa:ref:allservices:OS_Ttimer_Get|OS_Ttimer_Get]]
  * [[en:osa:ref:allservices:OS_Ttimer_Check|OS_Ttimer_Check]]
  * [[en:osa:ref:allservices:OS_Ttimer_IsRun|OS_Ttimer_IsRun]]

  * [[en:osa:ref:allservices:OS_Ttimer_Pause|OS_Ttimer_Pause]]
  * [[en:osa:ref:allservices:OS_Ttimer_Continue|OS_Ttimer_Continue]]

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