Serial.read()

Description

Reads incoming serial data.

Serial.read() inherits from Stream utility class.

Syntax

Serial .read()

Parameters

Serial : serial port object. See list of available serial ports for each board on Serial main page .

Returns

The first byte of incoming serial data available (or -1 if no data is available). Data type: int .

Example Code

/*H********************************************************************
* for incoming serial data
**********************************************************************/

/*F********************************************************************
*
**********************************************************************/
void 
setup() 
{
	Serial.begin( 9600 );   // OPENS SERIAL PORT, SETS DATA RATE TO 9600 BPS
}
/*F********************************************************************
*
**********************************************************************/
void 
loop() 
{
	if( Serial.available() > 0)   // SEND DATA ONLY WHEN YOU RECEIVE DATA
	{
		incomingByte = Serial.read();                  // READ INCOMING BYTE
		Serial.print( "I received: ");                   // SAY WHAT YOU GOT
		Serial.println( incomingByte, DEC);
	}
}