/* File: TIMER.H */

/****************************************************************************
*
* STK16XSW.TIMER
* ==============
*
* Timer routines
*                 
* TQ-Systems GmbH                                                         
* ---------------                                                         
* Customer: TQ-Components
* Project : STK16XSW
* Tools   : uVision 2.05
*
* 
* Rev: Date:     Name:            Modification:
* ----+---------+----------------+------------------------------------------
* 100  16.01.01  A. Lichte        taken over from STK16X.506                
*****************************************************************************/

#include "header.h"

/*==========================================================================*
* extern available definitions (#DEFINE):
*===========================================================================*/
#define T3INT_INI     0x0050    /*  interrupt priority 4, group level 0 */

/* timer counter define: */
#ifndef TIMER_COUNTER                    
#define TIMER_COUNTER unsigned long
#endif

/* timer counter range: */
#define TIMER_MIN     0x00000000
#define TIMER_MAX     0xFFFFFFFF

/*--------------------------------------------------------------------------*
* general definitions:
*---------------------------------------------------------------------------*/
/*==========================================================================*
* extern available typ definitions (TYPEDEF):
*===========================================================================*/
typedef void (*t_timer_idle_func) ();

/*==========================================================================*
* extern available constants (CONST):
*===========================================================================*/

/*==========================================================================*
* globale extern available variables (EXTERN):
*===========================================================================*/
                                      
/*==========================================================================*
* extern available functions:                                           
*===========================================================================*/

/*--------------------------------------------------------------------------*
* BOOL timer_init(t_timer_idle_func idle_func)                            
*---------------------------------------------------------------------------*
* FT: init timer 3 time base; calculation refers to CPU frequency (20 MHz)
* EP: idlefunc = pointer to idle function, called  from interrupt service 
*                routine (NULL if not used)
* RW: TRUE = function succesfully; FALSE= function failed
* GP: 
*---------------------------------------------------------------------------*/
BOOL timer_init(t_timer_idle_func idle_func);

/*--------------------------------------------------------------------------*
* void timer_reset(void)
*---------------------------------------------------------------------------*
* FT: reset timer counter
* EP:  -
* RW: -
* GP: -
*---------------------------------------------------------------------------*/
void timer_reset(void);

/*--------------------------------------------------------------------------*
* TIMER_COUNTER timer_get_10ms(TIMER_COUNTER base_time)
*---------------------------------------------------------------------------*
* FT: calculate time difference between parameter t and current time
* EP: base_time = base time for calculate time difference 
* RW: -
* GP: -
*---------------------------------------------------------------------------*/
TIMER_COUNTER timer_get_10ms(TIMER_COUNTER t);

/*--------------------------------------------------------------------------*
* void timer_delay_10ms(TIMER_COUNTER len)
*---------------------------------------------------------------------------*
* FT: generate delay for len x 10 ms 
* EP: len = amount of 10 ms ticks (result of len = 0 may be 0..1)
* RW: -
* GP: -
*---------------------------------------------------------------------------*/
void timer_delay_10ms(TIMER_COUNTER len);

/*--------------------------------------------------------------------------*
* void timer_delay_20us(USHORT len)
*---------------------------------------------------------------------------*
* FT: generate delay for len x 20 us 
* EP: len = amount of 20 us ticks
* RW: -
* GP: -
*---------------------------------------------------------------------------*/
void timer_delay_20us(USHORT len);