QSerialPortInfo Class
Proporciona información sobre los puertos serie existentes. Más...
| Cabecera: | #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
Usa 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 puede ser consultado para los parámetros port name, system location, description, manufacturer, y algunos otros parámetros de hardware. La clase QSerialPortInfo también se puede utilizar 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 e imprime sus parámetros en la consola:
const auto serialPortInfos = QSerialPortInfo::puertosdisponibles(); 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 de 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 librería no está disponible, vuelve a leer archivos en el directorio /sys/class/tty.
Se sabe que algunas versiones de libudev tienen un error e informan incorrectamente del VID y PID de un concentrador USB en lugar del dispositivo real. En tales casos, defina 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()
Construye un objeto QSerialPortInfo vacio.
Véase también isNull().
[explicit] QSerialPortInfo::QSerialPortInfo(const QSerialPort &port)
Construye un objeto QSerialPortInfo a partir del serial port.
[explicit] QSerialPortInfo::QSerialPortInfo(const QString &name)
Construye un objeto QSerialPortInfo a partir del puerto serie name.
Este constructor encuentra el puerto serie relevante entre los disponibles de acuerdo con el nombre del puerto name, y construye la instancia de información del puerto serie para ese puerto.
QSerialPortInfo::QSerialPortInfo(const QSerialPortInfo &other)
Construye una copia de other.
[noexcept] QSerialPortInfo::~QSerialPortInfo()
Destruye el objeto QSerialPortInfo. Las referencias a los valores del 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 hay un número de producto 16-bit válido; 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 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 para el 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 en baudios estándar disponibles que admite la plataforma de destino.
void QSerialPortInfo::swap(QSerialPortInfo &other)
Intercambia QSerialPortInfo other con este QSerialPortInfo. Esta operación es muy rápida y nunca falla.
QString QSerialPortInfo::systemLocation() const
Devuelve la ubicación del sistema del puerto serie.
Véase también portName().
quint16 QSerialPortInfo::vendorIdentifier() const
Devuelve el número de proveedor de 16 bits para el 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.
