www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Fine_TimerP

Install a high resolution timer callback procedure that will be periodically executed by the kernel.

int RTX_Fine_TimerP ( unsigned int far *timerID,
                         RTX_TIMER_CALLBACK proc,
                         unsigned long lParam,
                         unsigned long name,
                         long rti_ticks );

Parameters

timerID

Output parameter, pointer to location to receive new timer ID.

proc

Far vector to timer callback procedure.

lParam

Any 32 bit value you would like to see again on each entry into the timer procedure.

name

Provisional 4 character timer name (little endian order), not of any use in current implementation.

rti_ticks

Interval between calls to timer procedure in Real-Time Interrupt (RTI) ticks.

Return Value

0 on success else error code.

SC1x Comments

For SC1x systems which always operate at 1 kHz RTI rate, this API is mapped to the RTX_Install_TimerP API by a macro defined in the library header file.

SC1x3/SC2x Comments

The RTX_TIMER_CALLBACK prototype has the form:

    void huge RTX_TIMER_CALLBACK(
        unsigned int timer_id, unsigned long lParam )


The timer callback procedure's input parameters may be ignored and the function declared with void parameters.  The timer_id parameter is a copy of the timer ID output by this function.  The lParam input parameter is a copy of the lParam parameter you supplied to RTX_Fine_TimerP .

You must call either the RTX_Start_Timer, RTX_Timer_Delay or RTX_Timer_Delay_RTI API function to get the kernel to start calling your new timer procedure.

Important:   Timer procedures are executed on the stack of the kernel task at a high priority, so they should be as short as possible.   Avoid calling time consuming functions.

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Related Topics

RTX API   Overview

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    n/an/an/aV1.05V1.00

Supported by @CHIP-RTOS C Library since version

    CLIB
    V2.04

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document