@CHIP-RTOS C Library - RTOS API
Initialize data required by
void RTX_FineTickInit (void);
- -- none --
- This function is implicitly called by the
API if it has not already been called explicitly by the
Interrupts are enabled within the @Chip-RTOS API
call made here. Consequently, it may be advisable
to call this function from your application program's initialization
area to avoid this action during your real-time operation.
After a single call here, this one-shot function performs no
operation on subsequent calls since its job is already done
power mode has been adjusted).
Some global constants are initialized by this API.
This data is used internally by the other
C-library functions, but may also be of general use to the
application. (The names given these have been preceded
with an underscore to avoid name space conflicts.)
These constants are listed here.
unsigned long far *_pRti_Tick ;
This pointer references the 32 bit Real-Time Interrupt
up counter internal to the @Chip-RTOS. This location
should never be written to from outside the @Chip-RTOS!
Note that for reliable reads, interrupts must be momentarily
masked if both 16 bit halves are sampled.
unsigned int _RTI_kHz ;
The Real-Time Interrupt
in kHz. (For SC1x systems this value will always be 1.)
unsigned int _us_per_RTI ;
Number of microseconds per Real-Time Interrupt.
(For SC1x systems this value will always be 1000.)
unsigned int _Timer2_Limit ;
Hardware TIMER2 ticks per Real-Time Interrupt.
unsigned int _Timer2Tick_per_us ;
Number of hardware TIMER2 ticks per microsecond.
- For some selected Real-Time Interrupt rates,
the _us_per_RTI and _Timer2Tick_per_us
values computed here will not be accurate. This is the case
rates which do not divide 1000 an integral number of times,
e.g. 15 kHz. Consequently the
should not be used for such configurations, since the computation
done within that API relies on the accuracy of these constants.
- This library function invokes a RTOS software interrupt.
Refer to this RTOS API function's
for more details.
- RTX API Overview
Supported since or modified in @CHIP-RTOS version
Supported by @CHIP-RTOS C Library since version
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document