Renesas RJJ10J1643-0101 - Manual (Page 47)

Rev.1.01 2007.02.16
RJJ10J1643-0101 45
__StartSerialReceiving
Synopsis
Boolean __StartSerialReceiving(unsigned long data, unsigned char wordNum,
unsigned int *RcvDtBuf)
data Setup data
wordNum Number of words received
RcvDtBuf Pointer to the buffer in which received data is stored
Description Starts reception of serial communication and gets received data by a specified number
of words. When acquisition of received data is complete, this API calls a notification
function (if a notification function is registered).
[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 reception of serial communication was successfully started, RAPI_TRUE is returned;
if failed, RAPI_FALSE is returned.
Functionality Serial I/O
Reference __ConfigSerialDriverNotify , __StopSerialReceiving
Remark
• For the H8/300H, wait for at least a 1-bit period before calling this API after
__SetSerialFormat was called.
• The specifiable serial ports differ with each CPU used.
• If an undefined value is specified in the first argument, operation of the API cannot
be guaranteed.
• For the H8/300H, the following values are stored in the receive buffer.
High-order 8 bits: The value read from the serial status register.
Low-order 8 bits: The value read from the receive data register.
(Not read if an error occurred.)
Program example
#include ”rapi_sif_r8c_13.h”