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;
}

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein neues Objekt für eine serielle Schnittstelle mit der angegebenen parent.

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

Konstruiert ein neues Objekt für die serielle Schnittstelle mit der angegebenen parent, um die serielle Schnittstelle mit der angegebenen Hilfsklasse serialPortInfo zu repräsentieren.

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

Konstruiert ein neues Objekt für eine serielle Schnittstelle mit dem angegebenen parent, um die serielle Schnittstelle mit dem angegebenen name zu repräsentieren.

Der Name sollte ein bestimmtes Format haben; siehe die Methode setPort().

[virtual noexcept] QSerialPort::~QSerialPort()

Schließt die serielle Schnittstelle, falls erforderlich, und zerstört dann das Objekt.

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

Dieses Signal wird ausgegeben, nachdem die Baudrate geändert worden ist. Die neue Baudrate wird als baudRate und die Richtung als directions übergeben.

Siehe auch QSerialPort::baudRate.

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

Reimplements: QIODevice::bytesAvailable() const.

Gibt die Anzahl der eingehenden Bytes zurück, die darauf warten, gelesen zu werden.

Siehe auch bytesToWrite() und read().

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

Reimplements: QIODevice::bytesToWrite() const.

Gibt die Anzahl der Bytes zurück, die darauf warten, geschrieben zu werden. Die Bytes werden geschrieben, wenn die Kontrolle an die Ereignisschleife zurückgeht oder wenn flush() aufgerufen wird.

Siehe auch bytesAvailable() und flush().

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

Reimplements: QIODevice::canReadLine() const.

Gibt true zurück, wenn eine Datenzeile von der seriellen Schnittstelle gelesen werden kann; andernfalls wird false zurückgegeben.

Siehe auch readLine().

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

Verwirft alle Zeichen aus dem Ausgangs- oder Eingangspuffer, je nach gegebener Richtung directions. Dazu gehört auch das Löschen der internen Klassenpuffer und der UART-Puffer (Treiber). Beendet auch anstehende Lese- oder Schreiboperationen. Bei Erfolg wird true zurückgegeben, andernfalls false.

[override virtual] void QSerialPort::close()

Reimplements: QIODevice::close().

Siehe auch QIODevice::close().

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

Dieses Signal wird ausgegeben, nachdem die Datenbits in einem Rahmen geändert wurden. Die neuen Datenbits in einem Rahmen werden als dataBits übergeben.

Siehe auch QSerialPort::dataBits.

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

Dieses Signal wird ausgegeben, nachdem sich der Zustand (high oder low) des Leitungssignals DTR geändert hat. Der neue Zustand (high oder low) des Leitungssignals DTR wird als set übergeben.

Siehe auch QSerialPort::dataTerminalReady.

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

Dieses Signal wird ausgegeben, wenn ein Fehler an der seriellen Schnittstelle auftritt. Die angegebene error beschreibt die Art des aufgetretenen Fehlers.

Siehe auch QSerialPort::error.

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

Dieses Signal wird ausgegeben, nachdem der Flusskontrollmodus geändert wurde. Der neue Flusskontrollmodus wird als flow übergeben.

Siehe auch QSerialPort::flowControl.

bool QSerialPort::flush()

Diese Funktion schreibt so viel wie möglich aus dem internen Schreibpuffer auf die darunterliegende serielle Schnittstelle, ohne zu blockieren. Wenn Daten geschrieben wurden, gibt diese Funktion true zurück; andernfalls false.

Rufen Sie diese Funktion auf, um die gepufferten Daten sofort an die serielle Schnittstelle zu senden. Die Anzahl der erfolgreich geschriebenen Bytes hängt vom Betriebssystem ab. In den meisten Fällen muss diese Funktion nicht aufgerufen werden, da die Klasse QSerialPort automatisch mit dem Senden der Daten beginnt, sobald die Kontrolle an die Ereignisschleife zurückgegeben wird. Falls keine Ereignisschleife vorhanden ist, rufen Sie stattdessen waitForBytesWritten() auf.

Siehe auch write() und waitForBytesWritten().

QSerialPort::Handle QSerialPort::handle() const

Wenn die Plattform unterstützt wird und die serielle Schnittstelle offen ist, wird das native Handle der seriellen Schnittstelle zurückgegeben; andernfalls wird -1 zurückgegeben.

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

Reimplements: QIODevice::isSequential() const.

Gibt immer true zurück. Die serielle Schnittstelle ist ein sequentielles Gerät.

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

Reimplements: QIODevice::open(QIODeviceBase::OpenMode mode).

Öffnet die serielle Schnittstelle im OpenMode mode und gibt bei Erfolg true zurück; andernfalls gibt sie false zurück und setzt einen Fehlercode, der durch Aufruf der Methode error() ermittelt werden kann.

Die Methode gibt false zurück, wenn das Öffnen des Anschlusses erfolgreich war, aber keine der Anschlusseinstellungen erfolgreich gesetzt werden konnte. In diesem Fall wird der Anschluss automatisch geschlossen, um den Anschluss nicht mit falschen Einstellungen zu belassen.

Siehe auch QIODeviceBase::OpenMode und setPort().

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

Dieses Signal wird ausgegeben, nachdem der Paritätsprüfungsmodus geändert wurde. Der neue Paritätsprüfungsmodus wird als parity übergeben.

Siehe auch QSerialPort::parity.

QSerialPort::PinoutSignals QSerialPort::pinoutSignals()

Gibt den Zustand der Leitungssignale in einem Bitmap-Format zurück.

Aus diesem Ergebnis lässt sich der Zustand des gewünschten Signals durch Anwendung einer Maske "AND" zuordnen, wobei die Maske der gewünschte Aufzählungswert aus QSerialPort::PinoutSignals ist.

Siehe auch QSerialPort::dataTerminalReady und QSerialPort::requestToSend.

QString QSerialPort::portName() const

Gibt den Namen zurück, der durch setPort() gesetzt oder an den QSerialPort -Konstruktor übergeben wurde. Dieser Name ist kurz, d.h. er wird aus der internen Variablen des Gerätes extrahiert und konvertiert. Der Konvertierungsalgorithmus ist plattformspezifisch:

Siehe auch setPortName(), setPort(), und QSerialPortInfo::portName().

qint64 QSerialPort::readBufferSize() const

Gibt die Größe des internen Lesepuffers zurück. Dadurch wird die Datenmenge begrenzt, die der Client empfangen kann, bevor er die Methoden read() oder readAll() aufruft.

Eine Lesepuffergröße von 0 (Standardwert) bedeutet, dass der Puffer keine Größenbeschränkung hat, wodurch sichergestellt wird, dass keine Daten verloren gehen.

Siehe auch setReadBufferSize() und read().

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

Reimplements: QIODevice::readData(char *data, qint64 maxSize).

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

Reimplements: QIODevice::readLineData(char *data, qint64 maxSize).

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

Dieses Signal wird ausgegeben, nachdem sich der Zustand (high oder low) des Leitungssignals RTS geändert hat. Der neue Zustand (high oder low) des Leitungssignals RTS wird als set übergeben.

Siehe auch QSerialPort::requestToSend.

void QSerialPort::setPort(const QSerialPortInfo &serialPortInfo)

Setzt den Anschluss, der in der Instanz für serielle Anschlussinformationen serialPortInfo gespeichert ist.

Siehe auch portName() und QSerialPortInfo.

void QSerialPort::setPortName(const QString &name)

Setzt die name der seriellen Schnittstelle.

Der Name der seriellen Schnittstelle kann entweder als Kurzname oder, falls erforderlich, als langer Systemort übergeben werden.

Siehe auch portName() und QSerialPortInfo.

void QSerialPort::setReadBufferSize(qint64 size)

Setzt die Größe des internen Lesepuffers von QSerialPort auf size Bytes.

Wenn die Puffergröße auf eine bestimmte Größe begrenzt ist, puffert QSerialPort nicht mehr als diese Datenmenge. Der Sonderfall einer Puffergröße von 0 bedeutet, dass der Lesepuffer unbegrenzt ist und alle eingehenden Daten gepuffert werden. Dies ist die Standardeinstellung.

Diese Option ist nützlich, wenn die Daten nur zu bestimmten Zeitpunkten gelesen werden (z. B. in einer Echtzeit-Streaming-Anwendung) oder wenn die serielle Schnittstelle davor geschützt werden soll, zu viele Daten zu empfangen, was dazu führen könnte, dass der Anwendung der Speicher ausgeht.

Siehe auch readBufferSize() und read().

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

Dieses Signal wird ausgegeben, nachdem die Anzahl der Stoppbits in einem Frame geändert wurde. Die neue Anzahl der Stopbits in einem Frame wird als stopBits übergeben.

Siehe auch QSerialPort::stopBits.

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

Reimplements: QIODevice::waitForBytesWritten(int msecs).

Diese Funktion blockiert, bis mindestens ein Byte an die serielle Schnittstelle geschrieben wurde und das Signal bytesWritten() ausgegeben wurde. Die Funktion nimmt nach msecs Millisekunden eine Zeitüberschreitung vor; die Standardzeitüberschreitung beträgt 30000 Millisekunden. Wenn msecs -1 ist, wird diese Funktion nicht beendet.

Die Funktion gibt true zurück, wenn das Signal bytesWritten() ausgegeben wurde; andernfalls gibt sie false zurück (wenn ein Fehler aufgetreten ist oder der Vorgang eine Zeitüberschreitung hatte).

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

Reimplements: QIODevice::waitForReadyRead(int msecs).

Diese Funktion blockiert, bis neue Daten zum Lesen verfügbar sind und das Signal readyRead() ausgegeben wurde. Die Funktion nimmt nach msecs Millisekunden eine Zeitüberschreitung vor; die Standardzeitüberschreitung beträgt 30000 Millisekunden. Wenn msecs -1 ist, wird diese Funktion nicht beendet.

Die Funktion gibt true zurück, wenn das Signal readyRead() ausgegeben wird und neue Daten zum Lesen verfügbar sind; andernfalls gibt sie false zurück (wenn ein Fehler aufgetreten ist oder der Vorgang eine Zeitüberschreitung hatte).

Siehe auch waitForBytesWritten().

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

Reimplements: QIODevice::writeData(const char *data, qint64 maxSize).