Serial.read()

Descripción

Lee o captura un byte (un carácter) desde el puerto serie.

Sintaxis

char variable = Serial.read();

Parametros

variable

variable para capturar char o byte de entrada. Cuidado no es lo mismo ver ejemplos 1 y 2.

Retorno

El valor recuperado según el número de bits de datos configurado, o -1 si el buffer de entrada está vacío (int).

Advertencia

• Si por error no se verifica de antemano si hay datos disponibles, read() retornará 255 para byte en el caso que el valor real sea -1 (nada).
• El buffer en el caso de UNO y NANO es de 64 kB. Aunque esto se puede cambiar con la libreria HardwareSerial.h.
• El monitor serie nunca añade a la cadena escrita CR (\n) ni LF (\n) si haces un simple Enter. No asi si lo escribes en un block de notas y lo copias en la linea de envio.

Ejemplo 1

En este primer ejemplo usamos una variable tipo char para capturar el caracter.

void setup(){
   Serial.begin(9600);
}
void loop(){
   if (Serial.available()){        //Espera carácter
      char car = Serial.read();    //Lee carácter enviado y lo borra del buffer
      Serial.println(car);         //Imprime carácter enviado
   }
}

Ejemplo 2

En este segundo ejemplo usamos una variable tipo byte para capturar carácter.

void setup(){
   Serial.begin(9600);
}
void loop(){
   if (Serial.available()){        //Espera carácter
      byte car = Serial.read();    //Lee carácter enviado y lo borra del buffer
      Serial.write(car);           //Imprime caracter enviado
      Serial.print(" = ");
      Serial.println(car);         //Imprime código ASCII carácter enviado
   }
}

Ejemplo 3

En este ejemplo capturaremos varios caracteres y los almacenamos uno a uno en una variable tipo String.

String frase = "";
 
void setup(){
   Serial.begin(9600);
}
 
void loop(){
   while (Serial.available()){
      char caracter = Serial.read();
      frase.concat(caracter);
      delay(10);
   }
   if (frase != ""){
      Serial.println(frase);
      frase = "";
   }
}

Ejemplo 4

Este ejemplo recibe una matriz de ints.

int datos[10];
 
void setup(){
   Serial.begin(9600);
} 
 
void loop(){   
   if (Serial.available() >= 10 * sizeof(datos[0])){
      Serial.readBytes((byte*)datos, 10 * sizeof(datos[0]));
   }
}

Ejemplo 5

Mucha gente intenta probar este código enviando datos por el monitor serie y no le funciona, porque el Enter del monitor serie ejecuta la accion de enviar sin introducir los códigos ASCII CR (\r) ni LF (\n).

void setup(){
   Serial.begin(9600);
}
 
void loop(){
   if (Serial.available()){
      String data = Serial.readStringUntil('\n');
      Serial.println(data);
   }
}

Nota: Para que te funcione este codigo escribe algo y le das entre en un Notepad++ por ejemplo y luego copia esa cadena completa y la pegas en el monitor serie y envias.

Ejemplo 6

Si leemos el buffer vacio notamos que la respuesta en -1.

void setup(){
   Serial.begin(9600);
   delay(1000);
   Serial.println(Serial.read());
}
void loop(){
   //Nada
}

Vea también

• Serial
• Serial.begin()
• Serial.peek()
• Serial.available()
• Serial.print()
• Serial.println()
• Serial.write()
• Serial.end()

Referencias

• Cadena de texto por puerto serie -Luis Llamas
• Matriz por puerto serie - Luis Llamas