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)* 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 Amazon affiliate links. If you buy the components through these links, We will get a commission at no extra cost to you. We appreciate it.

※ OUR MESSAGES