Description

Microsecond Delay Timer Driver.

Implements microsecond delays.

The delay is implemented using a hardware timer. USTIMER_Init() must be called prior to using the delay functions. USTIMER_Init() must also be called if HFCORECLK and/or HFPERCLK is changed.

The source files for the USTIMER driver library resides in the emdrv/ustimer folder, and are named ustimer.c and ustimer.h.

• Introduction
• Configuration Options
• The API
• Example

Introduction

The USTIMER driver implements microsecond delay functions. The delay is timed using a hardware TIMER or WTIMER resource. Two delay functions are available, one which uses energy mode EM1 to preserve energy while waiting, and one which performs busy wait.

Note

Due to the overhead of setting up and serving TIMER/WTIMER interrupts, the USTIMER_Delay() function will be inaccurate for delays shorter than 200us. If higher accuracy is needed for short delays, consider using USTIMER_DelayIntSafe() or UDELAY_Delay().

Configuration Options

By default the module use TIMER0. Timer resource selection is stored in a file named ustimer_config.h. A template for this file, containing default value, resides in the emdrv/config folder.

To configure USTIMER, provide your own configuration file. Here is a sample ustimer_config.h file:

The API

This section contain brief descriptions of the functions in the API. You will find detailed information on input and output parameters and return values by clicking on the hyperlinked function names. Most functions return an error code, ECODE_EMDRV_USTIMER_OK is returned on success, see ECODE - Error Codes for other error codes.

Your application code must include one header file: ustimer.h .

USTIMER_Init() , USTIMER_DeInit()
These functions initialize and deinitialize the USTIMER driver. Typically USTIMER_Init() is called once in your startup code.

USTIMER_Delay() Delay a given number of microseconds. The MCU enters EM1 during the delay.

USTIMER_DelayIntSafe() Delay a given number of microseconds. The MCU stays in EM0 during the delay. This function can be called in any context and is also thread safe.

Example

Functions
Ecode_t	USTIMER_Init (void)
	Activate and initialize the hardware timer used to pace the 1 microsecond delay functions.
Ecode_t	USTIMER_DeInit (void)
	Deinitialize USTIMER driver.
Ecode_t	USTIMER_Delay (uint32_t usec)
	Delay a given number of microseconds.
Ecode_t	USTIMER_DelayIntSafe (uint32_t usec)
	Delay a given number of microseconds.

Macros
#define	ECODE_EMDRV_USTIMER_OK ( ECODE_OK )
	Success return value.

Function Documentation

◆ USTIMER_Init()

◆ USTIMER_DeInit()

◆ USTIMER_Delay()

◆ USTIMER_DelayIntSafe()

Macro Definition Documentation

◆ ECODE_EMDRV_USTIMER_OK