Renesas Embedded Application Programming Interface, Reference Manual

Page: 31 / 204

Rev.1.01 2007.02.16
RJJ10J1643-0101
29
__BasicStartSerialReceiving
Synopsis
<Receive 1 data>
Boolean __BasicStartSerialReceiving(unsigned long data)
data Setup data
Description
Starts receiving 1 data of serial communication.
[data]
For data, the following values can be set.
(M16C)
RAPI_COM1 UART0 RAPI_COM2 UART1
RAPI_COM3 UART2 RAPI_COM4 SI/O3
RAPI_COM5 SI/O4
(R8C)
RAPI_COM1 UART0 RAPI_COM2 UART1
(H8/300H)
RAPI_COM1 SCI3 channel 1 RAPI_COM2 SCI3 channel 2
RAPI_COM3 SCI3 channel 3
Return value
If data reception in serial communication was successfully started, RAPI_TRUE is
returned; if failed, RAPI_FALSE is returned.
Functionality
Serial I/O
Reference
__BasicReceivingStatusRead , __BasicStopSerialReceiving
Remark
•
For the H8/300H, wait for at least a 1-bit period before calling this API after
__BasicSetSerialFormat was called.
•
The specifiable serial ports differ with each CPU used.
•
If an undefined value is specified in the argument, operation of the API cannot be
guaranteed.
Program example
#include ”rapi_sif_r8c_13.h”
void func( void )
{
..........
__BasicStartSerialReceiving( RAPI_COM1 );
..........
}