Ads by ArduinoGetStarted.com
Serial.write()
Description
Writes binary data to the serial port. This data is sent as a byte or series of bytes; to send the characters representing the digits of a number use the print() function instead.
Syntax
Serial.write(val)
Serial.write(str)
Serial.write(buf, len)
Parameter Values
- Serial: serial port object. See the list of available serial ports for each board on the Serial main page.
- val: a value to send as a single byte.
- str: a string to send as a series of bytes.
- buf: an array to send as a series of bytes.
- len: the number of bytes to be sent from the array.
Return Values
- write() will return the number of bytes written, though reading that number is optional. Data type: size_t.
Example Code
void setup() {
Serial.begin(9600);
Serial.write(45); // write a byte with the value 45 => '-' character
Serial.write('\n'); // write a newline character
Serial.write("ArduinoGetStarted.com\n"); // write a string terminated by a newline character
byte buf[] = {'A', 'r', 'd', 'u', 'i', 'n', 'o'};
Serial.write(buf, 7); // write an array
}
void loop() {
}
- The result on Serial Monitor:
COM6
-
ArduinoGetStarted.com
Arduino
Autoscroll
Clear output
9600 baud
Newline
※ NOTES AND WARNINGS:
- As of Arduino IDE 1.0, serial transmission is asynchronous. If there is enough empty space in the transmit buffer, Serial.write() will return before any characters are transmitted over serial. If the transmit buffer is full then Serial.write() will block until there is enough space in the buffer. To avoid blocking calls to Serial.write(), you can first check the amount of free space in the transmit buffer using availableForWrite().
- 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
- 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 : serialEvent()
- Language : Serial.setTimeout()
※ ARDUINO BUY RECOMMENDATION
| Arduino UNO R3 | |
| Arduino Starter Kit |
Disclosure: Some links in this section are Amazon affiliate links. If you make a purchase through these links, we may earn a commission at no extra cost to you.
Additionally, some links direct to products from our own brand, DIYables.
Additionally, some links direct to products from our own brand, DIYables.