Serial.read()

[Serial]

Description

Reads incoming serial data. read() inherits from the Stream utility class.

Syntax

All boards:

• Serial.read()
• Serial1.read()

86Duino One specific:

• Serial2.read()
• Serial3.read()
• Serial485.read()

86Duino EduCake specific:

• Serial2.read()
• Serial3.read()
• Serial232.read()

Parameters

None

Returns

the first byte of incoming serial data available (or -1 if no data is available) – int

Example

int incomingByte = 0;   // for incoming serial data
 
void setup() {
        Serial.begin(9600);     // opens serial port, sets data rate to 9600 bps
}
 
void loop() {
 
        // send data only when you receive data:
        if (Serial.available() > 0) {
                // read the incoming byte:
                incomingByte = Serial.read();
 
                // say what you got:
                Serial.print("I received: ");
                Serial.println(incomingByte, DEC);
        }
}

See also

• if (Serial)
• available()
• begin()
• end()
• find()
• findUntil()
• flush()
• parseFloat()
• parseInt()
• peek()
• print()
• println()
• readBytes()
• readBytesUntil()
• setTimeout()
• write()
• serialEvent()

Language Reference Home

The text of the 86Duino reference is a modification of the Arduino reference and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.