HOWTO · Arduino
Arduino Serial Flush
Se puede comprobar si la transmisión en serie se realiza o no utilizando la función Serial.flush().
En esta página
En Arduino, Serial.flush() espera hasta que terminan de transmitirse los datos seriales salientes. No borra los datos entrantes ni confirma que otro dispositivo haya recibido o procesado el mensaje. Úselo cuando el siguiente paso dependa de que Arduino termine la transmisión en curso.
¿Qué hace Serial.flush() en Arduino?
Serial.flush() bloquea el sketch mientras se envían por la interfaz serie los datos de salida en cola. Cuando la función regresa, Arduino puede continuar con la siguiente operación. Esto resulta útil cuando la transmisión debe terminar antes de realizar otra acción, como cambiar el pin de dirección de un transceptor de transmisión a recepción.
La llamada actúa sobre la ruta de transmisión saliente. No vacía el búfer de recepción ni indica si un sensor o una computadora conectados entendieron los datos. Si necesita confirmación, defina un intercambio de mensajes y espere la respuesta del otro dispositivo.
Cómo usar Serial.flush() en un sketch de Arduino
Esta secuencia de llamadas de Arduino envía una línea, espera a que termine la transmisión saliente y luego continúa. Cambie la velocidad en baudios y el mensaje para adaptarlos al dispositivo conectado a la placa. El programa C++ completo de abajo usa una pequeña implementación local que reemplaza a Serial para mostrar la secuencia en una computadora; al adaptar el sketch, sustitúyala por el núcleo de Arduino de la placa.
#include <iostream>
class SerialPort {
public:
void begin(unsigned long baud) { (void)baud; }
void println(const char* message) { std::cout << message << '\n'; }
void flush() {}
};
SerialPort Serial;
void setup() {
Serial.begin(9600);
Serial.println("Starting transmission...");
Serial.flush();
Serial.println("Transmission finished; continuing.");
}
int main() {
setup();
return 0;
}
Starting transmission...
Transmission finished; continuing.
En una placa, use el objeto Serial proporcionado por Arduino y el núcleo correspondiente a la placa. La implementación de reemplazo para la computadora solo muestra dónde aparece la llamada en la secuencia; no reproduce la transmisión eléctrica ni verifica que un receptor haya procesado la primera línea. Para comprobarlo en hardware, compile y cargue el sketch para su placa y, después, obsérvelo con un monitor serie configurado a 9600 baudios.
En qué se diferencia flush() de PySerial
En un programa Python que usa PySerial, ser.flush() también espera a que se escriban los datos de salida pendientes. Este método pertenece al objeto Serial de PySerial, mientras que Serial.flush() pertenece a una interfaz serie de Arduino. Ambos se refieren a los datos salientes; ninguno espera por sí solo una confirmación a nivel de aplicación ni borra los datos recibidos.
Para obtener una confirmación fiable, haga que Arduino envíe una respuesta después de analizar y procesar un comando. Entonces, el programa Python puede leer esa respuesta y validarla. Mantenga este paso del protocolo separado de ser.flush(): vaciar la salida garantiza que el equipo anfitrión haya terminado de escribir los datos pendientes, mientras que la respuesta comunica lo que hizo Arduino. El nombre de un puerto serie, como COM3, depende del sistema operativo; configure el puerto y la velocidad en baudios según su entorno.
Preguntas frecuentes sobre el vaciado de datos serie
¿Serial.flush() vacía el búfer de recepción? No. Espera a que terminen de transmitirse los datos salientes. Para consumir los bytes entrantes, use la lógica de lectura de recepción adecuada.
¿Que termine el vaciado significa que el otro dispositivo recibió el mensaje? No. Significa que terminó la transmisión desde la interfaz serie local; no demuestra que el dispositivo remoto haya recibido, analizado ni procesado los datos. Para confirmarlo, use una respuesta de confirmación.
¿Cuándo debería llamarlo? Llame a Serial.flush() cuando el código siguiente deba esperar a que termine la transmisión pendiente, por ejemplo, antes de cambiar un transceptor semidúplex al modo de recepción. Por lo general, no es necesario esperar explícitamente después de cada línea de registro.
¿PySerial usa el mismo nombre de método? PySerial ofrece ser.flush() en su objeto de conexión serie. Tiene un propósito similar con los datos salientes, pero es una API distinta de Serial.flush() de Arduino.