Renesas Embedded Application Programming Interface, Reference Manual

Page: 60 / 204

Rev.1.01 2007.02.16
RJJ10J1643-0101
58
(Interrupt) If overflow interrupt requests are enabled, specify RAPI_OVERFLOW. If
no interrupts are specified, “No interrupt request” is set.
(Operating
states set)
Specify one from { RAPI_TIMER_ON, RAPI_TIMER_OFF }. The default
value is RAPI_TIMER_OFF.
[data2]
(M16C) (R8C)
Specify the interrupt priority level (0 – 7) to be set in the interrupt control register.
(H8/300H)
Specify the interrupt priority level (0–1) to be set in the interrupt control register.
For the CPUs that do not have an interrupt control register, specify 0.
[data3]
(M16C)
Specify the value to be set in the timer register in 16 bits.
(R8C)
When using timer X, specify the set value for the timer register; when using timer Y
or timer Z, specify the set value for the primary register in 8 bits.
(H8/300H)
Specify the set value for the timer reload register in 8 bits. This setting is effective
only when timer B1 is used. If any timer other than B1 is used, specify 0.
[data4]
(M16C) (H8/300H)
Specify 0.
(R8C)
Specify the set value for the prescaler register in 8 bits.
Return value
If the timer specification is incorrect, RAPI_FALSE is returned; otherwise, RAPI_TRUE
is returned.
Functionality
Timer (timer mode)
Reference
__EnableTimer , __DestroyTimer
Remark
•
If an undefined value is specified in the first argument, operation of the API cannot
be guaranteed.
•
The specifiable timers differ with each CPU used.
•
When used for the H8/300H, this API specify when freeing it from module stanby.
Program example
#include "rapi_timer_r8c_13.h"
void TimerIntFunc( void ){}