Renesas RJJ10J1643-0101 Manual de usuario

www.renesas.comREJ10J1502-0101Renesas Embedded Application Programming InterfaceReference manualRev.1.01Feb 16, 2007

Rev.1.01 2007.02.16 RJJ10J1643-0101 10 2.2 Driver Features The library described herein has the following features available as a peripheral driver

Rev.1.01 2007.02.16 RJJ10J1643-0101 100Return value If the timer specification is incorrect, RAPI_FALSE is returned; otherwise, RAPI_TRUE is retu

Rev.1.01 2007.02.16 RJJ10J1643-0101 101 __DestroyPulseWidthMeasurementMode Synopsis <Discard settings of pulse width measurement mode> Bo

Rev.1.01 2007.02.16 RJJ10J1643-0101 102Program example #include "rapi_timer_r8c_13.h" void func( void ) { /* Destroy the setting

Rev.1.01 2007.02.16 RJJ10J1643-0101 103 __GetPulseWidthMeasurementMode Synopsis <Get measured value in pulse width measurement mode> Bool

Rev.1.01 2007.02.16 RJJ10J1643-0101 104 [0]: The value of timer RA prescaler register is stored. [1]: The value of timer RA register is stored.

Rev.1.01 2007.02.16 RJJ10J1643-0101 105 __CreateInputCapture Synopsis <Set input capture mode> Boolean __CreateInputCapture(unsigned long

Rev.1.01 2007.02.16 RJJ10J1643-0101 106 RAPI_FALLING Selects the falling edge of measurement pulse as active edge. RAPI_BOTH Selects both risi

Rev.1.01 2007.02.16 RJJ10J1643-0101 107 (Interrupt) If overflow interrupt requests are enabled, specify RAPI_OVERFLOW. If input capture A, inpu

Rev.1.01 2007.02.16 RJJ10J1643-0101 108 RAPI_TRD_F4 Timer RD counts with internal clockφ/4. RAPI_TRD_F8 Timer RD counts with internal clock φ/8.

Rev.1.01 2007.02.16 RJJ10J1643-0101 109 (Counter clear) To specify GRA, GRB, GRC, or GRD input capture for the cause for which the counter is clea

Rev.1.01 2007.02.16 RJJ10J1643-0101 112.3 Serial Interface Driver The serial interface driver sets serial communication, clears settings, transmit/

Rev.1.01 2007.02.16 RJJ10J1643-0101 110 (Operating states set) Specify one from [RAPI_TIMER_ON, RAPI_TIMER_OFF]. The default is RAPI_TIMER_OFF.

Rev.1.01 2007.02.16 RJJ10J1643-0101 111 [2]: Specify the set value for time measurement control register 2. [3]: Specify the set value for time

Rev.1.01 2007.02.16 RJJ10J1643-0101 112 RAPI_TRD_RISING Selects the rising edge of measurement pulse as active edge. RAPI_TRD_FALLING Selects t

Rev.1.01 2007.02.16 RJJ10J1643-0101 113 RAPI_CHANNEL1 Selects channel 1. RAPI_CHANNEL2 Selects channel 2. RAPI_CHANNEL3 Selects channel 3. R

Rev.1.01 2007.02.16 RJJ10J1643-0101 114 void func( void ) { /* Set up timer C as imput capture mode */ __CreateInputCapture( RAPI_T

Rev.1.01 2007.02.16 RJJ10J1643-0101 115 __EnableInputCapture Synopsis <Control operation of input capture mode> Boolean __EnableInputCaptu

Rev.1.01 2007.02.16 RJJ10J1643-0101 116 • The specifiable timers differ with each CPU used. Program example #include "rapi_timer_r8c_13.h&q

Rev.1.01 2007.02.16 RJJ10J1643-0101 117 __DestroyInputCapture Synopsis <Discard settings of input capture mode> Boolean __DestroyInputCap

Rev.1.01 2007.02.16 RJJ10J1643-0101 118 void func( void ) { /* Destroy the setting of timer C as input capture mode */ __DestroyInputCaptur

Rev.1.01 2007.02.16 RJJ10J1643-0101 119 __GetInputCapture Synopsis <Get input capture mode counter value> Boolean __GetInputCapture(unsign

Rev.1.01 2007.02.16 RJJ10J1643-0101 122.4 Timer Driver The timer driver sets the timer, clears timer settings, controls timer operation, and acquir

Rev.1.01 2007.02.16 RJJ10J1643-0101 120 • When timer RD is used (RAPI_TIMER_RD0- RAPI_TIMER_RD1 specified) [0]: Stores the value of timer count

Rev.1.01 2007.02.16 RJJ10J1643-0101 121 __CreateOutputCompare Synopsis <Set output compare mode> Boolean __CreateOutputCompare(unsigned l

Rev.1.01 2007.02.16 RJJ10J1643-0101 122 RAPI_TRD_F32 Selects f32 for the timer RD count source. RAPI_TRD_F40M Selects fOCO40M for the timer RD c

Rev.1.01 2007.02.16 RJJ10J1643-0101 123 RAPI_UNCHANGE_0 Leaves CMP0 output unchanged even when matched in compare 0. RAPI_REVERSE_0 Inverts CM

Rev.1.01 2007.02.16 RJJ10J1643-0101 124 (TC reload) To reload TC register, specify RAPID_RELOAD. If RAPID_RELOAD is not specified, “No reload” is

Rev.1.01 2007.02.16 RJJ10J1643-0101 125 RAPI_TIMER_W Uses timer W. RAPI_TIMER_Z0 Uses timer Z channel 0. RAPI_TIMER_Z1 Uses timer Z channel

Rev.1.01 2007.02.16 RJJ10J1643-0101 126 RAPI_COUNT_CLEAR_SYNC Clear counter in sync with the synchronized other timer counter RAPI_TIMER_SYNC Sy

Rev.1.01 2007.02.16 RJJ10J1643-0101 127 (Interrupt) If overflow interrupt requests are enabled, specify RAPI_OVERFLOW. If compare match A, compar

Rev.1.01 2007.02.16 RJJ10J1643-0101 128 (M16C) Specify a pointer to the array in which the set value for the waveform generation control registe

Rev.1.01 2007.02.16 RJJ10J1643-0101 129 (Output mode) Specify one from { RAPI_SINGLE, RAPI_SR, RAPI_PHASE_DELAYED }. The default value is RAPI_SI

Rev.1.01 2007.02.16 RJJ10J1643-0101 132.4.7 Output Compare Mode In this mode, the timer generates an interrupt request when the timer counter and a

Rev.1.01 2007.02.16 RJJ10J1643-0101 130 [6]: Specify the comparison value of general register C in 16 bits. [7]: Specify the comparison value of

Rev.1.01 2007.02.16 RJJ10J1643-0101 131 [1]: Specify a pointer to the callback function for IC/OC interrupt 0. If this pointer is not specifie

Rev.1.01 2007.02.16 RJJ10J1643-0101 132 #include "rapi_timer_r8c_13.h" void TimerIntFunc0( void ){} void TimerIntFunc1( void ){} voi

Rev.1.01 2007.02.16 RJJ10J1643-0101 133 __EnableOutputCompare Synopsis <Control operation of output compare mode> Boolean __EnableOutputCo

Rev.1.01 2007.02.16 RJJ10J1643-0101 134 guaranteed. • The specifiable timers differ with each CPU used. Program example #include "rapi_ti

Rev.1.01 2007.02.16 RJJ10J1643-0101 135 __DestroyOutputCompare Synopsis <Discard settings of output compare mode> Boolean __DestroyOutputC

Rev.1.01 2007.02.16 RJJ10J1643-0101 136 void func( void ) { /* Destroy the setting of timer C as output compare mode */ __DestroyOutputComp

Rev.1.01 2007.02.16 RJJ10J1643-0101 137 __SetTimerRegister Synopsis <Set timer register> Boolean __SetTimerRegister(unsigned long data1,

Rev.1.01 2007.02.16 RJJ10J1643-0101 138 [data2] The content of a pointer to the buffer in which the register value is stored must be specified as

Rev.1.01 2007.02.16 RJJ10J1643-0101 139 [27]: Specify the set value for waveform generation register 4. [28]: Specify the set value for wave

Rev.1.01 2007.02.16 RJJ10J1643-0101 142.5 I/O Port Driver The I/O port driver sets the I/O port for input or output, writes data to the I/O port, a

Rev.1.01 2007.02.16 RJJ10J1643-0101 140 [1]: Specify the set value for the timer RB I/O control register. [2]: Specify the set value for the

Rev.1.01 2007.02.16 RJJ10J1643-0101 141 [3]: Specify the set value for timer control register V0. [4]: Specify the set value for timer contr

Rev.1.01 2007.02.16 RJJ10J1643-0101 142 [11]: Specify the set value for general register C. [12]: Specify the set value for general register

Rev.1.01 2007.02.16 RJJ10J1643-0101 143 __EnableTimerRegister Synopsis <Control operation of timer register> Boolean __EnableTimerRegister

Rev.1.01 2007.02.16 RJJ10J1643-0101 144 RAPI_TIMER_RD2 Selects timer RD channel 2. RAPI_TIMER_RD3 Selects timer RD channel 3. RAPI_TIMER_ON

Rev.1.01 2007.02.16 RJJ10J1643-0101 145 __ClearTimerRegister Synopsis <Clear timer register> Boolean __ClearTimerRegister(unsigned long da

Rev.1.01 2007.02.16 RJJ10J1643-0101 146Return value If the timer specification is incorrect, RAPI_FALSE is returned; otherwise, RAPI_TRUE is retu

Rev.1.01 2007.02.16 RJJ10J1643-0101 147 __GetTimerRegister Synopsis <Get timer register value> Boolean __GetTimerRegister(unsigned long da

Rev.1.01 2007.02.16 RJJ10J1643-0101 148 [data2] Specify a pointer to the array in which the acquired register value is stored. The content of t

Rev.1.01 2007.02.16 RJJ10J1643-0101 149 [26]: Store the value of time measurement register 3/waveform generation register 3. [27]: Store the val

Rev.1.01 2007.02.16 RJJ10J1643-0101 152.6 External Interrupt Driver The external interrupt driver sets external interrupts, controls external inter

Rev.1.01 2007.02.16 RJJ10J1643-0101 150 • When using timer RB (RAPI_TIMER_RB specified) [0]: Specify the set value for the timer RB one shot co

Rev.1.01 2007.02.16 RJJ10J1643-0101 151 [1]: Store the value of time constant register A. [2]: Store the value of time constant register B. [3

Rev.1.01 2007.02.16 RJJ10J1643-0101 152 [9]: Specify the set value for general register A. [10]: Specify the set value for general register B.

Rev.1.01 2007.02.16 RJJ10J1643-0101 1534.2.3 I/O Port __SetIOPort Synopsis <Set I/O port> Boolean __SetIOPort(unsigned long data1, unsigne

Rev.1.01 2007.02.16 RJJ10J1643-0101 154 RAPI_PORT_9_0 Port P90 RAPI_PORT_9_1 Port P91 RAPI_PORT_9_2 Port P92 RAPI_PORT_9_3 Port P93 RAPI_PORT_

Rev.1.01 2007.02.16 RJJ10J1643-0101 155 RAPI_NOT_PULLED_HIGH Sets a selected port not to be pulled high. RAPI_DRIVE_CAPACITY_H Sets the N-channe

Rev.1.01 2007.02.16 RJJ10J1643-0101 156 RAPI_PORT_D_6 PortPD6 RAPI_PORT_D_7 PortPD7 RAPI_PORT_E_0 PortPE0 RAPI_PORT_E_1 PortPE1 RAPI_PORT_E_2

Rev.1.01 2007.02.16 RJJ10J1643-0101 157Program example #include " rapi_io_port_r8c_13.h void func( void ) { /* Set up port P03 as inp

Rev.1.01 2007.02.16 RJJ10J1643-0101 158 __ReadIOPort Synopsis <Read from I/O port> Boolean __ReadIOPort(unsigned long data1, unsigned int

Rev.1.01 2007.02.16 RJJ10J1643-0101 159 RAPI_PORT_9_5 Port P95 RAPI_PORT_9_6 Port P96 RAPI_PORT_9_7 Port P97 RAPI_PORT_10_0 Port P100 RAPI_POR

Rev.1.01 2007.02.16 RJJ10J1643-0101 162.7 A/D Converter Driver The A/D converter driver sets the A/D converter, controls the A/D converter, clears

Rev.1.01 2007.02.16 RJJ10J1643-0101 160 RAPI_PORT_5_1 PortP51 RAPI_PORT_5_2 PortP52 RAPI_PORT_5_3 PortP53 RAPI_PORT_5_4 PortP54 RAPI_PORT

Rev.1.01 2007.02.16 RJJ10J1643-0101 161 RAPI_PORT_H_4 PortPH4 RAPI_PORT_H_5 PortPH5 RAPI_PORT_H_6 PortPH6 RAPI_PORT_H_7 PortPH7 RAPI_PORT

Rev.1.01 2007.02.16 RJJ10J1643-0101 162 __WriteIOPort Synopsis <Write to I/O port> Boolean __WriteIOPort(unsigned long data1, unsigned int

Rev.1.01 2007.02.16 RJJ10J1643-0101 163 RAPI_PORT_9_5 Port P95 RAPI_PORT_9_6 Port P96 RAPI_PORT_9_7 Port P97 RAPI_PORT_10_0 Port P100 RAPI_POR

Rev.1.01 2007.02.16 RJJ10J1643-0101 164 RAPI_PORT_5_5 PortP55 RAPI_PORT_5_6 PortP56 RAPI_PORT_5_7 PortP57 RAPI_PORT_6_0 PortP60 RAPI_PORT

Rev.1.01 2007.02.16 RJJ10J1643-0101 165 __WriteIOPortRegister Remark • If an undefined value is specified in the first argument, operation of th

Rev.1.01 2007.02.16 RJJ10J1643-0101 166 __SetIOPortRegister Synopsis <Set I/O port register> Boolean __SetIOPortRegister(unsigned long dat

Rev.1.01 2007.02.16 RJJ10J1643-0101 167 Specify the set value for the port control register corresponding to a selected port. [data3] (M16C)

Rev.1.01 2007.02.16 RJJ10J1643-0101 168 __ReadIOPortRegister Synopsis <Read from I/O port register> Boolean __ReadIOPortRegister(unsigned

Rev.1.01 2007.02.16 RJJ10J1643-0101 169 • Ports in port B of the H8/300H that are used as analog input pins cannot be used as input ports. Program

Rev.1.01 2007.02.16 RJJ10J1643-0101 17 Program example #include "rapi_ad_r8c_13.h" void main( void ) { unsigned int status, dat

Rev.1.01 2007.02.16 RJJ10J1643-0101 170 __WriteIOPortRegister Synopsis <Write to I/O port register> Boolean __WriteIOPortRegister(unsigne

Rev.1.01 2007.02.16 RJJ10J1643-0101 171 Program example #include " rapi_io_port_r8c_13.h" void func( void ) { /* Set the data to

Rev.1.01 2007.02.16 RJJ10J1643-0101 1724.2.4 External interrupt __SetInterrupt Synopsis <Set external interrupt> Boolean __SetInterrupt(un

Rev.1.01 2007.02.16 RJJ10J1643-0101 173 RAPI_INT2 Uses _INT2 interrupt. RAPI_INT3 Uses _INT3 interrupt. RAPI_KEY Uses key input interrupt.

Rev.1.01 2007.02.16 RJJ10J1643-0101 174 RAPI_INT_RISING Specifies a rising edge for the active edge of a selected external interrupt. RAPI_INT_

Rev.1.01 2007.02.16 RJJ10J1643-0101 175 RAPI_TRUE is returned. Functionality External interrupt Reference __EnableInterrupt, __GetInterruptFl

Rev.1.01 2007.02.16 RJJ10J1643-0101 176 __EnableInterrupt Synopsis <Control external interrupt> Boolean __EnableInterrupt(unsigned long da

Rev.1.01 2007.02.16 RJJ10J1643-0101 177Return value If the external interrupt specification is incorrect, RAPI_FALSE is returned; otherwise, RAPI

Rev.1.01 2007.02.16 RJJ10J1643-0101 178 __GetInterruptFlag Synopsis <Get the status of external interrupt flag> Boolean __GetInterruptFlag

Rev.1.01 2007.02.16 RJJ10J1643-0101 179 Functionality External interrupt Reference __SetInterrupt, __EnableInterrupt, __ClearInterruptFlag R

Rev.1.01 2007.02.16 RJJ10J1643-0101 183. Standard Types This section describes the standard types defined in the library. For details about the set

Rev.1.01 2007.02.16 RJJ10J1643-0101 180 __ClearInterruptFlag Synopsis <Clear external interrupt flag> Boolean __ClearInterruptFlag(unsign

Rev.1.01 2007.02.16 RJJ10J1643-0101 181 be guaranteed. • The specifiable external interrupts differ with each CPU used. Program example #inclu

Rev.1.01 2007.02.16 RJJ10J1643-0101 1824.2.5 A/D converter __CreateADC Synopsis <Set A/D converter> Boolean __CreateADC(unsigned long data

Rev.1.01 2007.02.16 RJJ10J1643-0101 183 RAPI_AN22 Uses AN22 pin for the analog input pin. RAPI_AN23 Uses AN23 pin for the analog input pin. RA

Rev.1.01 2007.02.16 RJJ10J1643-0101 184 (Conversion method) Specify one from { RAPI_WITH_SAMPLE_HOLD, RAPI_WITHOUT_SAMPLE_HOLD }. The default va

Rev.1.01 2007.02.16 RJJ10J1643-0101 185 (Resolution) Specify one from { RAPI_10BIT, RAPI_8BIT }. The default value is RAPI_8BIT. (Operating sta

Rev.1.01 2007.02.16 RJJ10J1643-0101 186 (Resolution) Specify one from { RAPI_10BIT, RAPI_8BIT }. The default value is RAPI_8BIT. (Conversion me

Rev.1.01 2007.02.16 RJJ10J1643-0101 187 RAPI_SOFTWARE_TRIGGER Selects software trigger. RAPI_TIMER_RD_TRIGGER Selects timer RD as trigger. • S

Rev.1.01 2007.02.16 RJJ10J1643-0101 188 RAPI_AN4 Uses AN4 pin for the analog input pin. RAPI_AN5 Uses AN5 pin for the analog input pin. RAPI

Rev.1.01 2007.02.16 RJJ10J1643-0101 189 (Input pin) Specify one from { RAPI_AN0, RAPI_AN1, RAPI_AN2, RAPI_AN3, RAPI_AN4, RAPI_AN5, RAPI_AN6, RAPI_

Rev.1.01 2007.02.16 RJJ10J1643-0101 194. Library Reference 4.1 API List by Peripheral Facility The table below lists the Renesas Embedded APIs clas

Rev.1.01 2007.02.16 RJJ10J1643-0101 190 Delayed trigger mode 1 Repeat sweep mode Specify 1, 2, 3, or 4. (R8C) Specify 1. (H8/300H) One-

Rev.1.01 2007.02.16 RJJ10J1643-0101 191 __EnableADC Synopsis <Control operation of A/D converter> Boolean __EnableADC (unsigned long data1

Rev.1.01 2007.02.16 RJJ10J1643-0101 192 Selectable only when one-shot mode or repeat mode is used. RAPI_AN21 Uses AN21 pin for the analog inpu

Rev.1.01 2007.02.16 RJJ10J1643-0101 193 RAPI_AN4 Uses AN4 pin for the analog input pin. RAPI_AN5 Uses AN5 pin for the analog input pin. RAPI_A

Rev.1.01 2007.02.16 RJJ10J1643-0101 194 Selectable only when sweep mode or repeat sweep mode 0 is used. RAPI_AN4_GROUP Uses AN4-AN7 pins group

Rev.1.01 2007.02.16 RJJ10J1643-0101 195 void func( void ) { /* Disable A/D converter */ __EnableADC( RAPI_AN0|RAPI_AD_OFF, 1 ); }

Rev.1.01 2007.02.16 RJJ10J1643-0101 196 __DestroyADC Synopsis <Discard settings of A/D converter> Boolean __DestroyADC(void) Description

Rev.1.01 2007.02.16 RJJ10J1643-0101 197 __GetADC Synopsis <Get A/D converted value (register specified)> Boolean __GetADC(unsigned long da

Rev.1.01 2007.02.16 RJJ10J1643-0101 198 __GetADCAll Synopsis <Get A/D converted value (all registers)> Boolean __GetADCAll(unsigned int *d

Rev.1.01 2007.02.16 RJJ10J1643-0101 199 __GetADCStatus Synopsis <Get the status of A/D converter> Boolean __GetADCStatus(unsigned int *sta

Rev.1.01 2007.02.16 RJJ10J1643-0101 2REVISION HISTORY Rev. Summary Date 1.00 06.04.07 1.01 ・ Additions and corrections made for support of libr

Rev.1.01 2007.02.16 RJJ10J1643-0101 2035 __CreatePulseWidthMeasurementMode Sets pulse width measurement mode 36 __EnablePulseWidthMeasurementMode

Rev.1.01 2007.02.16 RJJ10J1643-0101 200 __ClearADCStatus Synopsis <Clear the status of A/D converter> Boolean __ClearADCStatus(unsigned in

Rev.1.01 2007.02.16 RJJ10J1643-0101 201 Renesas Embedded Application Programming Interface Reference Manual Rev. 1.01

2-6-2, Ote-machi, Chiyoda-ku, Tokyo, 100-0004, JapanRenesas EmbeddedApplication Programming InterfaceReference manual

Rev.1.01 2007.02.16 RJJ10J1643-0101 214.2 Description of Each API This section describes each API and explains how to use them, showing a program e

Rev.1.01 2007.02.16 RJJ10J1643-0101 224.2.1 Serial I/O __BasicOpenSerialDriver Synopsis <Open a serial port> Boolean __BasicOpenSerialDri

Rev.1.01 2007.02.16 RJJ10J1643-0101 23 __BasicCloseSerialDriver Synopsis <Close a serial port> Boolean __BasicCloseSerialDriver(unsigned l

Rev.1.01 2007.02.16 RJJ10J1643-0101 24 __BasicSetSerialFormat Synopsis <Set serial communication> Boolean __BasicSetSerialFormat(unsigned

Rev.1.01 2007.02.16 RJJ10J1643-0101 25 If the API is used in clock synchronous serial communication mode, do not set these values. (M16C) (UART0,

Rev.1.01 2007.02.16 RJJ10J1643-0101 26 (R8C) (UART0, UART1) RAPI_SM_SYNC Clock synchronous serial communication mode RAPI_SM_ASYNC Clock asynch

Rev.1.01 2007.02.16 RJJ10J1643-0101 27 RAPI_COM3 SCI3 channel 3 For serial communication mode, the following values can be set. (H8/300H) (

Rev.1.01 2007.02.16 RJJ10J1643-0101 28Functionality Serial I/O Remark • The specifiable serial ports differ with each CPU used. • If an undefi

Rev.1.01 2007.02.16 RJJ10J1643-0101 29 __BasicStartSerialReceiving Synopsis <Receive 1 data> Boolean __BasicStartSerialReceiving(unsigned

Rev.1.01 2007.02.16 RJJ10J1643-0101 3 ・ Description of third argument in __CreateInputCapture corrected ・ Wording “specified” unified to “specif

Rev.1.01 2007.02.16 RJJ10J1643-0101 30 __BasicStartSerialSending Synopsis <Transmit 1 data> Boolean _BasicStartSerialSending(unsigned lon

Rev.1.01 2007.02.16 RJJ10J1643-0101 31 __BasicReceivingStatusRead Synopsis <Read receive status> unsigned int __BasicReceivingStatusRead(u

Rev.1.01 2007.02.16 RJJ10J1643-0101 32 Remark • The specifiable serial ports differ with each CPU used. • If an undefined value is specified in

Rev.1.01 2007.02.16 RJJ10J1643-0101 33 __BasicSendingStatusRead Synopsis <Read transmit status> Boolean __BasicSendingStatusRead(unsigned

Rev.1.01 2007.02.16 RJJ10J1643-0101 34 __BasicStopSerialReceiving Synopsis <Stop reception> Boolean Rapi_BasicStopSerialReceiving(unsigned

Rev.1.01 2007.02.16 RJJ10J1643-0101 35 __BasicStopSerialSending Synopsis <Stop transmission> Boolean __BasicStopSerialSending(unsigned lon

Rev.1.01 2007.02.16 RJJ10J1643-0101 36 __OpenSerialDriver Synopsis <Open a serial port> Boolean __OpenSerialDriver(unsigned long data) d

Rev.1.01 2007.02.16 RJJ10J1643-0101 37 __CloseSerialDriver Synopsis <Close a serial port> Boolean __CloseSerialDriver(unsigned long data)

Rev.1.01 2007.02.16 RJJ10J1643-0101 38 __ConfigSerialDriverNotify Synopsis <Register a notification function> Boolean __ConfigSerialDrive

Rev.1.01 2007.02.16 RJJ10J1643-0101 39 (R8C) (H8/300H) Return value If the serial port specification is incorrect, RAPI_FALSE is returne

Rev.1.01 2007.02.16 RJJ10J1643-0101 4 ・ RAPI_AN30, RAPI_AN31, RAPI_AN32, and RAPI_P9_GROUP added to the item for data1 of M16C in __CreateADC ・

Rev.1.01 2007.02.16 RJJ10J1643-0101 40 Program example #include ”rapi_sif_r8c_13.h” void Notify(unsigned char result) { if ((result&R

Rev.1.01 2007.02.16 RJJ10J1643-0101 41 __SetSerialFormat Synopsis <Set serial communication> Boolean __SetSerialFormat(unsigned long data

Rev.1.01 2007.02.16 RJJ10J1643-0101 42 __SetSerialInterrupt Synopsis <Set serial interrupts> Boolean __SetSerialInterrupt(unsigned long da

Rev.1.01 2007.02.16 RJJ10J1643-0101 43 RAPI_COM1 UART0 RAPI_COM2 UART1 For interrupt settings, the following values can set. RAPI_INT_TX_DIS

Rev.1.01 2007.02.16 RJJ10J1643-0101 44 Boolean func( void ) { ……………… /* Set interrupt of RAPI_COM1 to serial driver */ return __SetSeri

Rev.1.01 2007.02.16 RJJ10J1643-0101 45 __StartSerialReceiving Synopsis <Start reception> Boolean __StartSerialReceiving(unsigned long data

Rev.1.01 2007.02.16 RJJ10J1643-0101 46 unsigned int buffer[10]; void func( void ) { ……………… /* Get 5 word data received in serial communicat

Rev.1.01 2007.02.16 RJJ10J1643-0101 47 __StartSerialSending Synopsis <Start transmission> Boolean __StartSerialSending(unsigned long data,

Rev.1.01 2007.02.16 RJJ10J1643-0101 48 unsigned int buffer[10]; void func( void ) { ……………… /* Set 5 word data to transmit buffer of serial

Rev.1.01 2007.02.16 RJJ10J1643-0101 49 __StopSerialReceiving Synopsis <Stop reception> Boolean __StopSerialReceiving(unsigned long data)

Rev.1.01 2007.02.16 RJJ10J1643-0101 5 Table of Contents Table of Contents ...5 1. Intr

Rev.1.01 2007.02.16 RJJ10J1643-0101 50 __StopSerialSending Synopsis <Stop transmission> Boolean __StopSerialSending(unsigned long data)

Rev.1.01 2007.02.16 RJJ10J1643-0101 51 __PollingSerialReceiving Synopsis <Polling reception> unsigned int __PollingSerialReceiving(unsigne

Rev.1.01 2007.02.16 RJJ10J1643-0101 52 __PollingSerialSending Synopsis <Polling transmission> Unsigned __PollingSerialSending(unsigned lon

Rev.1.01 2007.02.16 RJJ10J1643-0101 53 unsigned int buffer[10],count; void func( void ) { ……………… /* Transmission interrupt disable */

Rev.1.01 2007.02.16 RJJ10J1643-0101 544.2.2 Timer __CreateTimer Synopsis <Set timer mode> Boolean __CreateTimer(unsigned long data1, unsig

Rev.1.01 2007.02.16 RJJ10J1643-0101 55 (Operating states set) Specify one from { RAPI_TIMER_ON, RAPI_TIMER_OFF }. The default value is RAPI_TIMER

Rev.1.01 2007.02.16 RJJ10J1643-0101 56 (Count source) Specify one from { RAPI_F1, RAPI_F8, RAPI_FRING }. The default value is RAPI_F1. (Operati

Rev.1.01 2007.02.16 RJJ10J1643-0101 57 RAPI_TB1_F256 Timer B1 counts with internal clock φ/256. RAPI_TB1_F512 Timer B1 counts with internal cl

Rev.1.01 2007.02.16 RJJ10J1643-0101 58 (Interrupt) If overflow interrupt requests are enabled, specify RAPI_OVERFLOW. If no interrupts are specif

Rev.1.01 2007.02.16 RJJ10J1643-0101 59 void func( void ) { /* Set up timer X as timer mode */ __CreateTimer( RAPI_TIMER_X|RAPI_TIMER_ON|RA

Rev.1.01 2007.02.16 RJJ10J1643-0101 6__CreateTimer ... 54 __EnableTimer ...

Rev.1.01 2007.02.16 RJJ10J1643-0101 60 __EnableTimer Synopsis <Control operation of timer mode> Boolean __EnableTimer(unsigned long data)

Rev.1.01 2007.02.16 RJJ10J1643-0101 61Remark • If an undefined value is specified in the argument, operation of the API cannot be guaranteed.

Rev.1.01 2007.02.16 RJJ10J1643-0101 62 __DestroyTimer Synopsis <Discard settings of timer mode> Boolean __DestroyTimer(unsigned long data)

Rev.1.01 2007.02.16 RJJ10J1643-0101 63 void func( void ) { /* Destroy the setting of timer Z as timer mode */ __DestroyTimer( RAPI_TIMER_

Rev.1.01 2007.02.16 RJJ10J1643-0101 64 __CreateEventCounter Synopsis <Set event counter mode> Boolean __CreateEventCounter(unsigned long d

Rev.1.01 2007.02.16 RJJ10J1643-0101 65 RAPI_UDF_REGISTER Selects the UDF register for the cause of up/down switching. RAPI_TAIOUT Selects the i

Rev.1.01 2007.02.16 RJJ10J1643-0101 66 RAPI_WRITE_ RELOAD_ BOTH Selects operation mode in which writing to the primary register and prescaler caus

Rev.1.01 2007.02.16 RJJ10J1643-0101 67 RAPI_RISING Selects the rising edge of count source as active edge. RAPI_FALLING Selects the falling ed

Rev.1.01 2007.02.16 RJJ10J1643-0101 68 [data4] (M16C) (H8/300H) Specify 0. (R8C) Specify the set value for the prescaler register in 8 bi

Rev.1.01 2007.02.16 RJJ10J1643-0101 69 __EnableEventCounter Synopsis <Control operation of event counter mode> Boolean __EnableEventCount

Rev.1.01 2007.02.16 RJJ10J1643-0101 7__GetADC ... 197 __GetADCAll ...

Rev.1.01 2007.02.16 RJJ10J1643-0101 70Functionality Timer (event counter mode) Reference __CreateEventCounter, __DestroyEventCounter, __GetEv

Rev.1.01 2007.02.16 RJJ10J1643-0101 71 __DestroyEventCounter Synopsis <Discard settings of event counter mode> Boolean __DestroyEventCount

Rev.1.01 2007.02.16 RJJ10J1643-0101 72 void func( void ) { /* Destroy the setting of timer Y as event counter mode */ __DestroyEventCounter

Rev.1.01 2007.02.16 RJJ10J1643-0101 73 __GetEventCounter Synopsis <Get event counter mode counter value> Boolean __GetEventCounter(unsign

Rev.1.01 2007.02.16 RJJ10J1643-0101 74 [1]: The value of timer RA register is stored. (H8/300H) • When using timer B1 (RAPI_TIMER_B1 specified)

Rev.1.01 2007.02.16 RJJ10J1643-0101 75 __CreatePulseWidthModulationMode Synopsis <Set pulse width modulation mode> Boolean __CreatePulseWi

Rev.1.01 2007.02.16 RJJ10J1643-0101 76 RAPI_RISING Selects the rising edge of TAiIN pin input signal as active edge. RAPI_FALLING Selects the

Rev.1.01 2007.02.16 RJJ10J1643-0101 77 (Count source) Specify one from { RAPI_F1, RAPI_F2, RAPI_F8, RAPI_TIMER_Y_UNDERFLOW}. The default value is

Rev.1.01 2007.02.16 RJJ10J1643-0101 78 • Specifiable definition values when timer V is used (RAPI_TIMER_V specified) (Clock) Specify one from {

Rev.1.01 2007.02.16 RJJ10J1643-0101 79Reference __EnablePulseWidthModulationMode, __DestroyPulseWidthModulationMode Remark • If an undefined

Rev.1.01 2007.02.16 RJJ10J1643-0101 81. Introduction The Renesas Embedded Application Programming Interface (API) is a unified API for the microcom

Rev.1.01 2007.02.16 RJJ10J1643-0101 80 __EnablePulseWidthModulationMode Synopsis <Control operation of pulse width modulation mode> Boolea

Rev.1.01 2007.02.16 RJJ10J1643-0101 81 Remark • If an undefined value is specified in the argument, operation of the API cannot be guaranteed.

Rev.1.01 2007.02.16 RJJ10J1643-0101 82 __DestroyPulseWidthModulationMode Synopsis <Discard settings of pulse width modulation mode> Boolea

Rev.1.01 2007.02.16 RJJ10J1643-0101 83 __CreatePulsePeriodMeasurementMode Synopsis <Set pulse period measurement mode> Boolean __CreatePul

Rev.1.01 2007.02.16 RJJ10J1643-0101 84 RAPI_TIMER_RA Uses timer RA. RAPI_F1 Selects f1 for the count source. RAPI_F2 Selects f2 for the count

Rev.1.01 2007.02.16 RJJ10J1643-0101 85 RAPI_TIMER_RD3 Uses timer RD0 channel 3. RAPI_TW_F1 Timer W counts with internal clock φ. RAPI_TW_F2

Rev.1.01 2007.02.16 RJJ10J1643-0101 86 RAPI_FTIOB Use FTIOB pin as input pin. • Specifiable definition values when timer W is used (RAPI_TIMER_

Rev.1.01 2007.02.16 RJJ10J1643-0101 87 (Interrupt) If overflow interrupt requests are enabled, specify RAPI_OVERFLOW. If no interrupts are specif

Rev.1.01 2007.02.16 RJJ10J1643-0101 88 __EnablePulsePeriodMeasurementMode Synopsis <Control operation of pulse period measurement mode> Bo

Rev.1.01 2007.02.16 RJJ10J1643-0101 89 RAPI_TIMER_ OFF Sets the timer that is set to pulse period measurement mode to stop operating. Return val

Rev.1.01 2007.02.16 RJJ10J1643-0101 92. Driver 2.1 Overview The library described herein provides a peripheral facility control program (peripheral

Rev.1.01 2007.02.16 RJJ10J1643-0101 90 __DestroyPulsePeriodMeasurementMode Synopsis <Discard settings of pulse period measurement mode> Bo

Rev.1.01 2007.02.16 RJJ10J1643-0101 91 • When used for the H8/300H, this API places a specified timer into module stanby state after discarding it.

Rev.1.01 2007.02.16 RJJ10J1643-0101 92 __GetPulsePeriodMeasurementMode Synopsis <Get measured value in pulse period measurement mode> Bool

Rev.1.01 2007.02.16 RJJ10J1643-0101 93 [0]: The value of timer RA prescaler register is stored. [1]: The value of timer RA register is stored.

Rev.1.01 2007.02.16 RJJ10J1643-0101 94 __CreatePulseWidthMeasurementMode Synopsis <Set pulse width measurement mode> Boolean __CreatePulse

Rev.1.01 2007.02.16 RJJ10J1643-0101 95 RAPI_FOCO Selects fOCO for the count source. RAPI_TIMER_ONSets the timer to start operating in __CreatePu

Rev.1.01 2007.02.16 RJJ10J1643-0101 96 RAPI_TW_F8 Timer W counts with internal clock φ/8. RAPI_TZ_F1 Timer Z counts with internal clock φ. R

Rev.1.01 2007.02.16 RJJ10J1643-0101 97 (Count source) Specify one from { RAPI_TW_F1, RAPI_TW_F2, RAPI_TW_F4, RAPI_TW_F8 }. The default value is R

Rev.1.01 2007.02.16 RJJ10J1643-0101 98 Specify the interrupt priority level (0–7) to be set in the interrupt control register. (H8/300H) Specif

Rev.1.01 2007.02.16 RJJ10J1643-0101 99 __EnablePulseWidthMeasurementMode Synopsis <Control operation of pulse width measurement mode> Bool