Ads by ArduinoGetStarted.com
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
Autoscroll
Clear output
9600 baud
Newline
- The result on Serial Monitor:
COM6
I received: A
I received: r
I received: d
I received: u
I received: i
I received: n
I received: o
I received:
Autoscroll
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
- Language : Arduino - Serial
- Language : Serial.available()
- Language : Serial.availableForWrite()
- Language : Serial.begin()
- Language : Serial.end()
- Language : Serial.find()
- Language : Serial.findUntil()
- Language : Serial.flush()
- Language : Serial.getTimeout()
- Language : if(Serial)
- Language : Serial.parseFloat()
- Language : Serial.parseInt()
- Language : Serial.peek()
- Language : Serial.print()
- Language : Serial.println()
- Language : Serial.read()
- Language : Serial.readBytes()
- Language : Serial.readBytesUntil()
- Language : Serial.readString()
- Language : Serial.readStringUntil()
- Language : Serial.setTimeout()
- Language : Serial.write()
※ 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.