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.