En esta página

QSerialPortInfo Class

Ofrece información sobre los puertos serie existentes. Más...

Encabezado: #include <QSerialPortInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS SerialPort)
target_link_libraries(mytarget PRIVATE Qt6::SerialPort)
qmake: QT += serialport

Funciones públicas

QSerialPortInfo()
QSerialPortInfo(const QSerialPort &port)
QSerialPortInfo(const QString &name)
QSerialPortInfo(const QSerialPortInfo &other)
~QSerialPortInfo()
QString description() const
bool hasProductIdentifier() const
bool hasVendorIdentifier() const
bool isNull() const
QString manufacturer() const
QString portName() const
quint16 productIdentifier() const
QString serialNumber() const
void swap(QSerialPortInfo &other)
QString systemLocation() const
quint16 vendorIdentifier() const
QSerialPortInfo &operator=(const QSerialPortInfo &other)

Miembros públicos estáticos

QList<QSerialPortInfo> availablePorts()
QList<qint32> standardBaudRates()

Descripción detallada

Utilice la función estática ` availablePorts()` para generar una lista de objetos `QSerialPortInfo`. Cada objeto `QSerialPortInfo` de la lista representa un único puerto serie y permite consultar los parámetros ` port name`, ` system location`, ` description`, ` manufacturer` y algunos otros parámetros de hardware. La clase `QSerialPortInfo` también puede utilizarse como parámetro de entrada para el método ` setPort()` de la clase ` QSerialPort `.

Ejemplo de uso

El código de ejemplo enumera todos los puertos serie disponibles y muestra sus parámetros en la consola:

   const auto serialPortInfos = QSerialPortInfo::availablePorts();
    for (const QSerialPortInfo&portInfo: serialPortInfos) {
        qDebug() << "\n"
                << "Puerto:" << portInfo.portName() << "\n"
                 << "Ubicación:" << portInfo.systemLocation() << "\ n "
                 << "Descripción:" << portInfo.description() << "\n"
                << "Fabricante:" << portInfo.manufacturer() << "\n"
                 << "Número de serie:" << portInfo.serialNumber() << "\n"
                 << "Identificador del proveedor:"
                << (portInfo.hasVendorIdentifier()
                     ? QByteArray::number(portInfo.vendorIdentifier(), 16)
                     : QByteArray()) << "\n"
                 << "Identificador del producto:"
                 << (portInfo.hasProductIdentifier()
                     ? QByteArray::number(portInfo.productIdentifier(), 16)
                     : QByteArray());
    }

Enumeración de puertos en Linux

Por defecto, Linux utiliza libudev para enumerar los puertos serie disponibles. Si la biblioteca no está disponible, recurre a la lectura de archivos en el directorio /sys/class/tty.

Se sabe que algunas versiones de libudev tienen un error y muestran incorrectamente el VID y el PID de un concentrador USB en lugar de los del dispositivo real. En tales casos, define la variable de entorno QT_SERIALPORT_SKIP_UDEV_LOOKUP para omitir la búsqueda en libudev y utilizar únicamente la información del directorio /sys/class/tty.

Véase también QSerialPort.

Documentación de las funciones miembro

QSerialPortInfo::QSerialPortInfo()

Crea un objeto QSerialPortInfo vacío.

Véase también isNull().

[explicit] QSerialPortInfo::QSerialPortInfo(const QSerialPort &port)

Crea un objeto `QSerialPortInfo` a partir de un puerto serie ` port`.

[explicit] QSerialPortInfo::QSerialPortInfo(const QString &name)

Crea un objeto `QSerialPortInfo` a partir del puerto serie name.

Este constructor busca el puerto serie correspondiente entre los disponibles según el nombre del puerto name y crea la instancia de información del puerto serie para dicho puerto.

QSerialPortInfo::QSerialPortInfo(const QSerialPortInfo &other)

Crea una copia de other.

[noexcept] QSerialPortInfo::~QSerialPortInfo()

Elimina el objeto « QSerialPortInfo ». Las referencias a los valores de dicho objeto dejan de ser válidas.

[static] QList<QSerialPortInfo> QSerialPortInfo::availablePorts()

Devuelve una lista de los puertos serie disponibles en el sistema.

Véase también Port enumeration on Linux.

QString QSerialPortInfo::description() const

Devuelve la cadena de descripción del puerto serie, si está disponible; en caso contrario, devuelve una cadena vacía.

Véase también manufacturer() y serialNumber().

bool QSerialPortInfo::hasProductIdentifier() const

Devuelve « true » si existe un número de producto válido de 16-bit; en caso contrario, devuelve « false ».

Véase también productIdentifier(), vendorIdentifier() y hasVendorIdentifier().

bool QSerialPortInfo::hasVendorIdentifier() const

Devuelve « true » si existe un número de proveedor válido de 16-bit; en caso contrario, devuelve « false ».

Véase también vendorIdentifier(), productIdentifier() y hasProductIdentifier().

bool QSerialPortInfo::isNull() const

Devuelve si este objeto ` QSerialPortInfo ` contiene una definición de puerto serie.

QString QSerialPortInfo::manufacturer() const

Devuelve la cadena del fabricante del puerto serie, si está disponible; en caso contrario, devuelve una cadena vacía.

Véase también description() y serialNumber().

QString QSerialPortInfo::portName() const

Devuelve el nombre del puerto serie.

Véase también systemLocation().

quint16 QSerialPortInfo::productIdentifier() const

Devuelve el número de producto de 16 bits correspondiente al puerto serie, si está disponible; en caso contrario, devuelve cero.

Véase también hasProductIdentifier(), vendorIdentifier() y hasVendorIdentifier().

QString QSerialPortInfo::serialNumber() const

Devuelve la cadena del número de serie del puerto serie, si está disponible; en caso contrario, devuelve una cadena vacía.

Nota: El número de serie puede incluir letras.

Véase también description() y manufacturer().

[static] QList<qint32> QSerialPortInfo::standardBaudRates()

Devuelve una lista de las velocidades de transmisión estándar disponibles que admite la plataforma de destino.

void QSerialPortInfo::swap(QSerialPortInfo &other)

Cambia QSerialPortInfo other por este QSerialPortInfo. Esta operación es muy rápida y nunca falla.

QString QSerialPortInfo::systemLocation() const

Devuelve la ubicación del puerto serie en el sistema.

Véase también portName().

quint16 QSerialPortInfo::vendorIdentifier() const

Devuelve el número de fabricante de 16 bits correspondiente al puerto serie, si está disponible; en caso contrario, devuelve cero.

Véase también hasVendorIdentifier(), productIdentifier() y hasProductIdentifier().

QSerialPortInfo &QSerialPortInfo::operator=(const QSerialPortInfo &other)

Establece el objeto ` QSerialPortInfo ` para que sea igual a ` other`.

© 2026 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.