Renesas RJJ10J1643-0101

Rev.1.01 2007.02.16

RJJ10J1643-0101

__StartSerialReceiving

Synopsis <Start reception>

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”