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)

지정된 헬퍼 클래스 serialPortInfo 를 사용하여 지정된 직렬 포트를 나타내는 parent 로 새 직렬 포트 객체를 생성합니다.

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

지정된 name 으로 직렬 포트를 나타내기 위해 지정된 parent 을 사용하여 새 직렬 포트 객체를 생성합니다.

이름은 특정 형식을 가져야 합니다( 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의 상태(높음 또는 낮음)가 변경된 후에 방출됩니다. 회선 신호 DTR의 새로운 상태(높음 또는 낮음)는 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()

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

이 결과에서 마스크 "AND"를 적용하여 원하는 신호의 상태를 할당할 수 있으며, 여기서 마스크는 QSerialPort::PinoutSignals 에서 원하는 열거 값입니다.

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(문자 *데이터, qint64 maxSize).

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

다시 구현합니다: QIODevice::readLineData(문자 *데이터, qint64 maxSize).

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

이 신호는 회선 신호 RTS의 상태(높음 또는 낮음)가 변경된 후에 방출됩니다. 회선 신호 RTS의 새로운 상태(높음 또는 낮음)는 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()도 참조하세요 .

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

이 신호는 프레임의 정지 비트 수가 변경된 후에 방출됩니다. 프레임의 새로운 정지 비트 수는 stopBits 로 전달됩니다.

QSerialPort::stopBits도 참조하세요 .

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

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

이 함수는 직렬 포트에 최소 1바이트가 쓰여지고 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()도 참조하세요 .

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

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