QSerialPort Class

qint64 numReadTotal = 0;
char buffer[50];

for (;;) {
    const qint64 numRead  = serial.read(buffer, 50);

    // Do whatever with the array

    numReadTotal += numRead;
    if (numRead == 0 && !serial.waitForReadyRead())
        break;
}

멤버 함수 설명서

[explicit] QSerialPort::QSerialPort(QObject *parent = nullptr)

지정된 parent 를 사용하여 새로운 시리얼 포트 객체를 생성합니다.

[explicit] QSerialPort::QSerialPort(const QSerialPortInfo &serialPortInfo, QObject *parent = nullptr)

지정된 parent 을 사용하여, 지정된 헬퍼 클래스 serialPortInfo 로 표현되는 시리얼 포트를 나타내는 새로운 시리얼 포트 객체를 생성합니다.

[explicit] QSerialPort::QSerialPort(const QString &name, QObject *parent = nullptr)

지정된 ` parent `를 사용하여, 지정된 ` name`를 가진 시리얼 포트를 나타내는 새로운 시리얼 포트 객체를 생성합니다.

이름은 특정 형식을 따라야 합니다. 자세한 내용은 setPort() 메서드를 참조하십시오.

[virtual noexcept] QSerialPort::~QSerialPort()

필요한 경우 시리얼 포트를 닫은 다음, 객체를 소멸시킵니다.

[signal] void QSerialPort::baudRateChanged(qint32 baudRate, QSerialPort::Directions directions)

이 신호는 보드 속도가 변경된 후에 발생합니다. 새로운 보드 속도는 ` baudRate `로, 방향은 ` directions`로 전달됩니다.

QSerialPort::baudRate항목도 참조하십시오 .

[override virtual] qint64 QSerialPort::bytesAvailable() const

QIODevice::bytesAvailable() const를 재구현합니다.

읽히기를 기다리고 있는 수신 바이트의 개수를 반환합니다.

bytesToWrite() 및 read()도 참조하십시오 .

[override virtual] qint64 QSerialPort::bytesToWrite() const

QIODevice::bytesToWrite() const를 재구현합니다.

쓰기 대기 중인 바이트 수를 반환합니다. 이 바이트들은 제어권이 이벤트 루프로 돌아가거나 flush()이 호출될 때 쓰여집니다.

bytesAvailable() 및 flush()도 참조하십시오 .

[override virtual] bool QSerialPort::canReadLine() const

QIODevice::canReadLine() const를 재구현합니다.

직렬 포트에서 데이터 한 줄을 읽을 수 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

readLine()도 참조하십시오 .

bool QSerialPort::clear(QSerialPort::Directions directions = AllDirections)

주어진 방향 directions 에 따라 출력 또는 입력 버퍼의 모든 문자를 삭제합니다. 여기에는 내부 클래스 버퍼와 UART(드라이버) 버퍼의 지우기가 포함됩니다. 또한 진행 중인 읽기 또는 쓰기 작업을 종료합니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

[override virtual] void QSerialPort::close()

QIODevice::close()를 재구현합니다.

QIODevice::close()도 참조하십시오 .

[signal] void QSerialPort::dataBitsChanged(QSerialPort::DataBits dataBits)

이 신호는 프레임 내의 데이터 비트가 변경된 후에 전송됩니다. 프레임의 새로운 데이터 비트는 ` dataBits`로 전달됩니다.

QSerialPort::dataBits항목도 참조하십시오 .

[signal] void QSerialPort::dataTerminalReadyChanged(bool set)

이 신호는 라인 신호 DTR의 상태(High 또는 Low)가 변경된 후에 발신됩니다. 라인 신호 DTR의 새로운 상태(High 또는 Low)는 set 로 전달됩니다.

QSerialPort::dataTerminalReady도 참조하십시오 .

[signal] void QSerialPort::errorOccurred(QSerialPort::SerialPortError error)

이 신호는 직렬 포트에서 오류가 발생했을 때 발신됩니다. 지정된 error 는 발생한 오류의 유형을 나타냅니다.

참조: QSerialPort::error.

[signal] void QSerialPort::flowControlChanged(QSerialPort::FlowControl flow)

이 신호는 유량 제어 모드가 변경된 후에 전송됩니다. 새로운 유량 제어 모드는 ` flow`로 전달됩니다.

QSerialPort::flowControl항목도 참조하십시오 .

bool QSerialPort::flush()

이 함수는 차단 없이 내부 쓰기 버퍼의 데이터를 가능한 한 많이 기본 시리얼 포트에 기록합니다. 데이터가 기록된 경우 이 함수는 ` true`을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.

버퍼된 데이터를 시리얼 포트로 즉시 전송하려면 이 함수를 호출하십시오. 성공적으로 쓰여진 바이트 수는 운영 체제에 따라 다릅니다. 대부분의 경우, 제어권이 이벤트 루프로 반환되면 QSerialPort 클래스가 자동으로 데이터 전송을 시작하므로 이 함수를 호출할 필요가 없습니다. 이벤트 루프가 없는 경우에는 대신 waitForBytesWritten()을 호출하십시오.

write() 및 waitForBytesWritten()도 참조하십시오 .

QSerialPort::Handle QSerialPort::handle() const

플랫폼이 지원되고 시리얼 포트가 열려 있는 경우, 네이티브 시리얼 포트 핸들을 반환합니다. 그렇지 않은 경우 ` -1`를 반환합니다.

[override virtual] bool QSerialPort::isSequential() const

QIODevice::isSequential() const를 재구현합니다.

항상 ` true`를 반환합니다. 시리얼 포트는 순차적 장치입니다.

[override virtual] bool QSerialPort::open(QIODeviceBase::OpenMode mode)

QIODevice::open(QIODeviceBase::OpenMode 모드)를 재구현합니다.

OpenMode mode 를 사용하여 시리얼 포트를 열고, 성공하면 true 를 반환합니다. 그렇지 않으면 false 를 반환하고, error() 메서드를 호출하여 얻을 수 있는 오류 코드를 설정합니다.

포트가 열렸으나 원하는 포트 매개변수 설정에 실패한 경우, 이 메서드는 false 를 반환하고 포트를 자동으로 닫습니다.

QIODeviceBase::OpenMode 및 setPort()도 참조하십시오 .

[signal] void QSerialPort::parityChanged(QSerialPort::Parity parity)

이 신호는 패리티 검사 모드가 변경된 후에 전송됩니다. 새로운 패리티 검사 모드는 ` parity`로 전달됩니다.

QSerialPort::parity도 참조하십시오 .

QSerialPort::PinoutSignals QSerialPort::pinoutSignals()

라인 신호의 상태를 비트맵 형식으로 반환합니다.

이 결과를 바탕으로, QSerialPort::PinoutSignals 에서 원하는 열거형 값을 마스크로 사용하여 "AND" 연산을 적용함으로써 원하는 신호의 상태를 추출할 수 있습니다.

QSerialPort::dataTerminalReady 및 QSerialPort::requestToSend항목도 참조하십시오 .

QString QSerialPort::portName() const

setPort() 함수를 통해 설정되었거나 QSerialPort 생성자에 전달된 이름을 반환합니다. 이 이름은 짧은 형태로, 즉 기기의 내부 변수 시스템 위치에서 추출되어 변환된 것입니다. 변환 알고리즘은 플랫폼에 따라 다릅니다:

setPortName(), setPort(), QSerialPortInfo::portName()도 참조하십시오 .

qint64 QSerialPort::readBufferSize() const

내부 읽기 버퍼의 크기를 반환합니다. 이는 클라이언트가 read() 또는 readAll() 메서드를 호출하기 전에 수신할 수 있는 데이터의 양을 제한합니다.

0 (기본값)의 읽기 버퍼 크기는 버퍼에 크기 제한이 없음을 의미하며, 이를 통해 데이터 손실이 발생하지 않도록 보장합니다.

setReadBufferSize() 및 read()도 참조하십시오 .

[override virtual protected] qint64 QSerialPort::readData(char *data, qint64 maxSize)

QIODevice::readData(char *data, qint64 maxSize) 함수를 재구현합니다.

[override virtual protected] qint64 QSerialPort::readLineData(char *data, qint64 maxSize)

QIODevice::readLineData(char *data, qint64 maxSize)를 재구현합니다.

[signal] void QSerialPort::requestToSendChanged(bool set)

이 신호는 라인 신호 RTS의 상태(High 또는 Low)가 변경된 후에 발신됩니다. 라인 신호 RTS의 새로운 상태(High 또는 Low)는 set 로 전달됩니다.

QSerialPort::requestToSend항목도 참조하십시오 .

void QSerialPort::setPort(const QSerialPortInfo &serialPortInfo)

serialPortInfo 시리얼 포트 정보 인스턴스에 저장된 포트를 설정합니다.

portName() 및 QSerialPortInfo도 참조하십시오 .

void QSerialPort::setPortName(const QString &name)

직렬 포트의 name 를 설정합니다.

시리얼 포트의 이름은 필요한 경우 짧은 이름이나 긴 시스템 위치 중 하나로 전달할 수 있습니다.

portName() 및 QSerialPortInfo도 참조하십시오 .

void QSerialPort::setReadBufferSize(qint64 size)

QSerialPort 의 내부 읽기 버퍼 크기를 size 바이트로 설정합니다.

버퍼 크기가 특정 크기로 제한된 경우, ` QSerialPort `는 이 크기 이상의 데이터를 버퍼링하지 않습니다. 버퍼 크기를 ` 0 `로 설정하는 특수한 경우, 읽기 버퍼에 제한이 없어 들어오는 모든 데이터가 버퍼링됩니다. 이것이 기본값입니다.

이 옵션은 데이터가 특정 시점에만 읽히는 경우(예: 실시간 스트리밍 애플리케이션)나, 시리얼 포트가 과도한 데이터 수신으로 인해 애플리케이션의 메모리가 부족해지는 것을 방지해야 하는 경우에 유용합니다.

음수 값을 전달하면 내부 버퍼가 비활성화되어 사실상 모든 읽기 작업이 차단됩니다.

readBufferSize() 및 read()도 참조하십시오 .

[since 6.10] void QSerialPort::setWriteBufferSize(qint64 size)

QSerialPort 의 내부 쓰기 버퍼 크기를 size 바이트로 설정합니다.

직렬 포트를 통한 데이터 전송은 상대적으로 느리기 때문에, 실제로는 write()가 호출되더라도 데이터가 즉시 전송되지는 않습니다. 데이터는 먼저 중간 버퍼에 저장된 후, 나중에 청크 단위로 기록됩니다.

따라서 데이터를 너무 많이 쓰거나, 기본 시리얼 포트가 처리할 수 있는 속도보다 빠르게 쓰면 내부 버퍼가 커질 수 있습니다. 이는 결국, 특히 메모리 자원이 부족한 장치에서 애플리케이션의 메모리 부족 현상을 유발할 수 있습니다.

이 메서드를 사용하면 내부 버퍼의 크기를 특정 크기로 제한할 수 있습니다. 다음 쓰기 시도가 버퍼 용량을 초과하면, ` write()` 메서드는 버퍼에 실제로 저장된 바이트 수를 반환합니다. ` bytesWritten()` 신호를 수신한 후, 또는 ` waitForBytesWritten()` 메서드가 ` true`를 반환한 후에 나머지 바이트에 대한 쓰기 시도를 반복하는 것은 사용자의 책임입니다.

이 메서드에 ` 0 `를 전달하면 쓰기 버퍼에 제한이 없으며, ` write()`에 전달된 모든 데이터가 버퍼에 저장됨을 의미합니다. 이것이 기본값입니다.

음수 값을 전달하면 0 를 전달한 것과 동일한 효과가 나타납니다.

이 함수는 Qt 6.10에서 도입되었습니다.

writeBufferSize() 및 write()도 참조하십시오 .

[signal, since 6.9] void QSerialPort::settingsRestoredOnCloseChanged(bool restore)

이 신호는 settingsRestoredOnClose 속성이 변경된 후 발생합니다. restore 매개변수에는 해당 속성의 새로운 값이 포함됩니다.

이 함수는 Qt 6.9에서 도입되었습니다.

QSerialPort::settingsRestoredOnClose도 참조하십시오 .

[signal] void QSerialPort::stopBitsChanged(QSerialPort::StopBits stopBits)

이 신호는 프레임의 스톱 비트 수가 변경된 후에 전송됩니다. 프레임의 새로운 스톱 비트 수는 ` stopBits`로 전달됩니다.

QSerialPort::stopBits도 참조하십시오 .

[override virtual] bool QSerialPort::waitForBytesWritten(int msecs = 30000)

QIODevice::waitForBytesWritten(int msecs)를 재구현합니다.

이 함수는 시리얼 포트에 최소 한 바이트가 쓰여지고 bytesWritten() 신호가 발생될 때까지 대기합니다. 이 함수는 msecs 밀리초 후에 타임아웃되며, 기본 타임아웃 시간은 30000 밀리초입니다. msecs 가 -1인 경우, 이 함수는 타임아웃되지 않습니다.

이 함수는 bytesWritten() 신호가 발생하면 true 를 반환하고, 그렇지 않은 경우(오류가 발생했거나 작업이 타임아웃된 경우) false 를 반환합니다.

[override virtual] bool QSerialPort::waitForReadyRead(int msecs = 30000)

QIODevice::waitForReadyRead(int msecs)를 재구현합니다.

이 함수는 읽을 수 있는 새로운 데이터가 준비되고 readyRead() 신호가 발신될 때까지 대기합니다. 이 함수는 msecs 밀리초 후에 타임아웃되며, 기본 타임아웃 시간은 30000 밀리초입니다. msecs 가 -1인 경우, 이 함수는 타임아웃되지 않습니다.

readyRead() 신호가 발신되고 읽을 수 있는 새 데이터가 있는 경우, 이 함수는 true 를 반환합니다. 그렇지 않은 경우(오류가 발생했거나 작업이 타임아웃된 경우) false 를 반환합니다.

waitForBytesWritten()도 참조하십시오 .

[since 6.10] qint64 QSerialPort::writeBufferSize() const

내부 쓰기 버퍼의 크기를 반환합니다.

0 (기본값)의 쓰기 버퍼 크기는 버퍼에 크기 제한이 없음을 의미합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

setWriteBufferSize() 및 write()도 참조하십시오 .

[override virtual protected] qint64 QSerialPort::writeData(const char *data, qint64 maxSize)

QIODevice::writeData(const char *data, qint64 maxSize)를 재구현합니다.