www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Fine_Timer

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

int RTX_Fine_Timer (
             const TimerProc_Structure far *TProcPtr );

Parameters

TProcPtr

Input parameter, pointer to a TimerProc_Structure type.

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_Timer API by a macro defined in the library header file.

SC1x3/SC2x Comments

A timer ID is output to the 16 bit location referenced by timerID member of your TimerProc_Structure .

Alternate method RTX_Fine_TimerP allows the timer installation to be performed based on direct parameters.

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