HOWTO · Arduino
Arduino 직렬 플러시
Serial.flush() 함수를 사용하여 직렬 전송이 완료되었는지 여부를 확인할 수 있습니다.
이 페이지의 내용
Arduino에서 Serial.flush()는 송신 중인 직렬 데이터의 전송이 끝날 때까지 기다립니다. 수신 데이터를 지우거나 다른 장치가 메시지를 받았거나 처리했음을 확인해 주지는 않습니다. Arduino의 현재 전송이 끝난 뒤에 다음 작업을 진행해야 할 때 사용하세요.
Arduino에서 Serial.flush()는 무엇을 할까요?
Serial.flush()는 대기 중인 출력이 직렬 인터페이스를 통해 전송되는 동안 스케치의 실행을 멈춥니다. 함수가 반환되면 Arduino는 다음 작업을 계속할 수 있습니다. 출력이 끝난 뒤 트랜시버의 방향 핀을 송신 모드에서 수신 모드로 바꾸는 경우처럼, 후속 작업 전에 전송을 마쳐야 할 때 유용합니다.
이 함수는 송신 경로에만 적용됩니다. 수신 버퍼를 비우지 않으며, 연결된 센서나 컴퓨터가 데이터를 이해했는지도 알려주지 않습니다. 확인이 필요하다면 메시지 교환 규칙을 정하고 상대 장치가 보내는 확인 응답을 기다리세요.
Arduino 스케치에서 Serial.flush() 사용하기
다음 Arduino 호출 순서는 한 줄을 전송하고, 송신이 끝날 때까지 기다린 다음 계속 진행합니다. 보드에 연결된 장치에 맞게 전송 속도와 메시지를 바꾸세요. 아래의 완전한 C++ 프로그램은 Serial을 간단히 흉내 내는 로컬 대체 객체를 사용하므로 컴퓨터에서 호출 순서를 보여줄 수 있습니다. 스케치에 적용할 때는 이 대체 객체를 보드의 Arduino 코어가 제공하는 객체로 바꾸세요.
#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.
보드에서는 Arduino가 제공하는 Serial 객체와 해당 보드에 맞는 코어를 사용하세요. 컴퓨터용 대체 객체는 호출 순서에서 함수가 어디에 놓이는지만 보여줍니다. 실제 전기 신호 전송을 모델링하거나 수신기가 첫 번째 줄을 처리했는지 확인하지는 않습니다. 하드웨어에서 확인하려면 보드용으로 스케치를 컴파일해 업로드한 뒤, 9600 baud로 설정한 직렬 모니터에서 관찰하세요.
PySerial의 flush()는 어떻게 다를까요?
PySerial을 사용하는 Python 프로그램에서도 ser.flush()는 대기 중인 출력이 기록될 때까지 기다립니다. 이 함수는 PySerial의 Serial 객체에 속하고, Serial.flush()는 Arduino 직렬 인터페이스에 속합니다. 둘 다 송신 데이터에 관한 함수이며, 어느 쪽도 그 자체로 애플리케이션 수준의 확인 응답을 기다리거나 수신 데이터를 지우지는 않습니다.
확실한 확인이 필요하다면 Arduino가 명령을 파싱하고 처리한 뒤 응답을 보내도록 하세요. 그러면 Python 프로그램에서 응답을 읽고 유효성을 확인할 수 있습니다. 이 프로토콜 단계는 ser.flush()와 구분해야 합니다. 출력 플러시는 호스트가 대기 중인 데이터를 모두 쓰도록 하고, 응답은 Arduino가 무엇을 했는지 알려줍니다. COM3 같은 직렬 포트 이름은 운영 체제에 따라 다르므로, 사용하는 환경에 맞게 포트와 전송 속도를 설정하세요.
직렬 플러시에 관한 자주 묻는 질문
Serial.flush()는 수신 버퍼를 비우나요? 아니요. 송신 데이터의 전송이 끝날 때까지 기다립니다. 들어온 바이트를 읽으려면 적절한 수신 처리 로직을 사용하세요.
플러시가 끝나면 다른 장치가 메시지를 받은 건가요? 아니요. 로컬 직렬 인터페이스의 전송이 완료되었다는 뜻일 뿐, 원격 장치가 데이터를 받거나 파싱하거나 처리했는지는 확인할 수 없습니다. 확인하려면 확인 응답을 사용하세요.
언제 호출해야 하나요? 후속 코드가 대기 중인 출력의 전송 완료를 기다려야 할 때 Serial.flush()를 호출하세요. 예를 들어 반이중 트랜시버를 수신 모드로 전환하기 전에 사용할 수 있습니다. 일반적인 로그 출력에서는 보통 매 줄 뒤에 명시적으로 기다릴 필요가 없습니다.
PySerial도 같은 이름의 함수를 사용하나요? PySerial은 직렬 연결 객체에 ser.flush()를 제공합니다. 송신 대기 데이터를 처리한다는 점은 비슷하지만, Arduino의 Serial.flush()와는 별개의 API입니다.