Serial.setTimeout()

Description

Cette fonction fixe le délai maximum en millisecondes à attendre pour la lecture de flux de données. La valeur par défaut est 1000 millisecondes (=1 seconde).

En pratique, ce délai est utilisé par les fonctions de la classe Serial suivantes:

Syntaxe

Serial.setTimeout(time)

Paramètres

  • Serial: tout objet d'une classe utilisant la classe Serial
  • time: délai maximum en millisecondes à attendre pour la lecture de flux de données (long)

Valeurs Renvoyées

  • Aucune

Exemple

  • Compile and upload the below code to Arduino
void setup() { Serial.begin(9600); // opens serial port, sets data rate to 9600 bps Serial.setTimeout(100); // set new value to 100 milliseconds Serial.print("Timeout: "); Serial.println(Serial.getTimeout()); // print the new value } void loop() { // check if data is available if (Serial.available() > 0) { // read the incoming string: String incomingString = Serial.readString(); // prints the received data Serial.print("I received: "); Serial.println(incomingString); } }
  • Type "Arduino" on Serial Monitor and click Send button:
COM6
Send
Timeout: 100
Autoscroll Show timestamp
Clear output
9600 baud  
Newline  
  • The result on Serial Monitor:
COM6
Send
Timeout: 100 I received: Arduino
Autoscroll Show timestamp
Clear output
9600 baud  
Newline  
  • Modify the code to change timeout from 100ms to 1ms
void setup() { Serial.begin(9600); // opens serial port, sets data rate to 9600 bps Serial.setTimeout(1); // set new value to 1 milliseconds Serial.print("Timeout: "); Serial.println(Serial.getTimeout()); // print the new value } void loop() { // check if data is available if (Serial.available() > 0) { // read the incoming string: String incomingString = Serial.readString(); // prints the received data Serial.print("I received: "); Serial.println(incomingString); } }
  • Compile and upload the above code to Arduino
  • Type "Arduino" on Serial Monitor and click Send button:
COM6
Send
Timeout: 100 I received: Arduino Timeout: 1
Autoscroll Show timestamp
Clear output
9600 baud  
Newline  
  • The result on Serial Monitor:
COM6
Send
Timeout: 100 I received: Arduino Timeout: 1 I received: A I received: r I received: d I received: u I received: i I received: no
Autoscroll Show timestamp
Clear output
9600 baud  
Newline  

When timeout is small, a single string is read multiple time.

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.

※ OUR MESSAGES