serialEvent()

Description

This function is automatically called when data is available. Use Serial.read(), Serial.readBytes(), Serial.readBytesUntil(), Serial.readString(), or Serial.readStringUntil() to capture this data.

serialEvent() functionality is not available on all Arduino boards or Serial interfaces:

Board Available serialEvent() functions
Uno
Nano
serialEvent()
Mega serialEvent()
serialEvent1()
serialEvent2()
serialEvent3()
Leonardo
Micro
Yún
serialEvent1()
Uno WiFi Rev2
Nano Every
None
MKR boards
Nano 33 IoT
Zero
None
Nano 33 BLE None
Portenta H7 None
Due serialEvent()
serialEvent1()
serialEvent2()
serialEvent3()
101 serialEvent1()

Syntax

void serialEvent() { //statements }

For boards with additional serial ports (see the list of available serial ports for each board on the Serial main page):

void serialEvent1() { //statements } void serialEvent2() { //statements } void serialEvent3() { //statements }

Parameter Values

  • statements: any valid statements

Return Values

  • Nothing

Example Code

void setup() { Serial.begin(9600); } void loop() { } void serialEvent() { int incomingByte = Serial.read(); // prints the received data Serial.print("I received: "); Serial.println((char)incomingByte); }
  • Compile and upload the above code to Arduino
  • Type "Arduino" on Serial Monitor and click Send button:
  • COM6
    Send
    Autoscroll Show timestamp
    Clear output
    9600 baud  
    Newline  
  • The result on Serial Monitor:
  • COM6
    Send
    I received: A I received: r I received: d I received: u I received: i I received: n I received: o I received:
    Autoscroll Show timestamp
    Clear output
    9600 baud  
    Newline  

※ NOTES AND WARNINGS:

Serial functions are not only used for the communication between an Arduino board and Serial Monitor of Arduino IDE but also used for the communication between:

  • An Arduino board and other Arduino board
  • An Arduino board and other sensors/devices
  • An Arduino board and computer (any Serial software on computer)

See Also

ARDUINO BUY RECOMMENDATION

Arduino UNO R3
Arduino Starter Kit
Please note: These are affiliate links. If you buy the components through these links, We may get a commission at no extra cost to you. We appreciate it.

※ OUR MESSAGES