Rev.1.00 2007.11.1
REC10B0002-0100
38
__PollingSerialReceiving
Synopsis
<Polling reception>
Boolean __PollingSerialReceiving(unsigned long data)
data Setup data
Description
Performs reception of serial communication by polling. This API gets received data by
an amount specified by __StartSerialReceiving. When acquisition of received data is
complete, it calls a notification function (if a notification function is registered).
[data]
For data, the following values can be set.
RAPI_COM1 UART0 RAPI_COM2 UART1
RAPI_COM3 UART2 RAPI_COM4 SI/O3
RAPI_COM5 SI/O4
Return value
If the serial port specification is incorrect, RAPI_FALSE is returned; otherwise,
RAPI_TRUE is returned.
Functionality
Serial I/O
Reference
__ConfigSerialDriverNotify, __SetSerialInterrupt, __StartSerialReceiving
Remark
•
If an undefined value is specified in the argument, operation of the API cannot be
guaranteed.
Program example
#include ”rapi_sif_m16c_62p”
unsigned int buffer[10];
void func( void )
{
/* Reception interrupt disable */
__SetSerialInterrupt( RAPI_COM1 | RAPI_INT_TX_DIS | RAPI_INT_RX_DIS );
/* Start reception */
__StartSerialReceiving( RAPI_COM1, 5, buffer );
while(1){
__PollingSerialReceiving( RAPI_COM1 );
}
}