Qt Serial Port

Qt Serial Port provides the basic functionality, which includes configuring, I/O operations, getting and setting the control signals of the RS-232 pinouts.

The following items are not supported by this module:

  • Terminal features, such as echo, control CR/LF, and so on.
  • Text mode.
  • Configuring timeouts and delays while reading or writing.
  • Pinout signal change notification.

To use the serial port in your application, add the following include statement:

#include <QSerialPort>

For information about available serial ports, use the following include statement:

#include <QSerialPortInfo>

To use the module with cmake, use the find_package() command to locate the needed module components in the Qt6 package:

find_package(Qt6 COMPONENTS SerialPort REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::SerialPort)

To use the module for building with qmake, add the module as a value of the QT variable in the project's .pro file:

QT += serialport

Module Evolution

Changes to Qt SerialPort lists important changes in the module API and functionality that were done for the Qt 6 series of Qt.

© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.