HOWTO · Arduino
Arduino Serial Flush
È possibile verificare se la trasmissione seriale è stata eseguita o meno utilizzando la funzione Serial.flush().
In questa pagina
Su Arduino, Serial.flush() attende che la trasmissione dei dati seriali in uscita sia terminata. Non cancella i dati in ingresso e non conferma che un altro dispositivo abbia ricevuto o elaborato il messaggio. Usala quando il passaggio successivo dipende dal completamento della trasmissione corrente da parte di Arduino.
Che cosa fa Serial.flush() su Arduino?
Serial.flush() blocca lo sketch mentre i dati in uscita accodati vengono inviati tramite l’interfaccia seriale. Quando la funzione ritorna, Arduino può proseguire con l’operazione successiva. È utile quando la trasmissione deve terminare prima di un’altra azione, per esempio prima di cambiare il pin di direzione di un ricetrasmettitore dalla modalità di trasmissione a quella di ricezione.
La funzione riguarda il percorso di trasmissione in uscita. Non cancella il buffer di ricezione e non indica se un sensore o un computer collegato ha interpretato i dati. Se ti serve una conferma, definisci uno scambio di messaggi e attendi una risposta dall’altro dispositivo.
Usare Serial.flush() in uno sketch Arduino
Questa sequenza di chiamate Arduino invia una riga, attende il completamento della trasmissione in uscita e poi prosegue. Modifica la velocità di trasmissione e il messaggio in base al dispositivo collegato alla scheda. Il programma C++ completo qui sotto usa una piccola simulazione locale di Serial per mostrare la sequenza su un computer; quando adatti lo sketch, sostituisci la simulazione con il core Arduino della tua scheda.
#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.
Su una scheda, usa l’oggetto Serial fornito da Arduino e il core appropriato. La simulazione sul computer mostra soltanto dove si colloca la chiamata nella sequenza: non riproduce la trasmissione elettrica e non verifica che un ricevitore abbia elaborato la prima riga. Per una prova hardware, compila e carica lo sketch sulla tua scheda, quindi osservalo con un monitor seriale impostato a 9600 baud.
In che modo flush() di PySerial è diverso?
In un programma Python che usa PySerial, anche ser.flush() attende che i dati in uscita in sospeso siano stati scritti. Questa funzione appartiene all’oggetto Serial di PySerial, mentre Serial.flush() appartiene a un’interfaccia seriale Arduino. Entrambe riguardano i dati in uscita; nessuna delle due, da sola, attende una conferma a livello applicativo o cancella i dati ricevuti.
Per avere una conferma affidabile, fai in modo che Arduino invii una risposta dopo aver analizzato ed eseguito un comando. Il programma Python può quindi leggere e convalidare quella risposta. Mantieni questo passaggio del protocollo distinto da ser.flush(): il flush assicura che il computer abbia terminato di scrivere i dati in sospeso, mentre la risposta comunica che cosa ha fatto Arduino. Il nome di una porta seriale, come COM3, dipende dal sistema operativo: configura la porta e la velocità di trasmissione in base alla tua configurazione.
Domande frequenti sulla trasmissione seriale
Serial.flush() cancella il buffer di ricezione? No. Attende che la trasmissione dei dati in uscita sia terminata. Per consumare i byte in ingresso, usa la logica di lettura appropriata.
Quando il flush è terminato, significa che l’altro dispositivo ha ricevuto il messaggio? No. Significa che la trasmissione dall’interfaccia seriale locale è terminata; non dimostra che il dispositivo remoto abbia ricevuto, analizzato o elaborato i dati. Per confermarlo, usa una risposta di conferma.
Quando dovrei chiamarla? Chiama Serial.flush() quando il codice successivo deve attendere il completamento dei dati in uscita, per esempio prima di commutare un ricetrasmettitore half-duplex in modalità di ricezione. In genere, per la normale registrazione dei messaggi non serve attendere esplicitamente dopo ogni riga.
PySerial usa lo stesso nome di metodo? PySerial mette a disposizione ser.flush() sull’oggetto della connessione seriale. Ha uno scopo simile per i dati in uscita, ma è un’API distinta da Serial.flush() di Arduino.