En esta página

Qt Serial Bus

La API « Qt Serial Bus » proporciona clases y funciones para acceder a los distintos buses y protocolos serie industriales, como CAN, ModBus y otros.

Primeros pasos

Para utilizar el módulo con CMake, utiliza el comando « find_package() » para localizar los componentes necesarios del módulo en el paquete « Qt6 »:

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

Para utilizar el módulo en la compilación con qmake, añade el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:

QT += serialbus

Buses y protocolos compatibles

Referencia de la API

Estos son enlaces a los materiales de referencia de la API.

Categorías de registro

El módulo « QtSerialBus » exporta las siguientes « logging categories »:

Categoría de registroDescripción
qt.canbusHabilita el registro estándar dentro de las clases Qt CAN Bus
qt.canbus.pluginsHabilita el registro de bajo nivel dentro de las clases de complementos de Qt CAN Bus. Para configurar el registro de un complemento específico, utiliza «qt.canbus.plugins.nombre_del_complemento». Por ejemplo: «qt.canbus.plugins.socketcan». «qt.canbus.plugins*» afecta a todos los complementos.
qt.modbusHabilita el registro estándar dentro de las clases de Qt Modbus
qt.modbus.lowlevelHabilita el registro de bajo nivel, incluido el contenido de paquetes individuales, dentro de las clases de Qt Modbus

Las categorías de registro se pueden utilizar para habilitar salidas adicionales de advertencia y depuración en QtSerialBus. Se puede encontrar información más detallada sobre el registro en QLoggingCategory.

Una forma rápida de habilitar todo el registro de Qt Modbus es añadir la siguiente línea a la función main():

QLoggingCategory::setFilterRules(QStringLiteral("qt.modbus* = true"));

Ejemplos

Evolución del módulo

La sección«Cambios en Qt SerialBus» enumera los cambios importantes en la API y la funcionalidad del módulo que se han realizado para la serie Qt 6 de Qt.

Licencias

Qt SerialBus está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt para obtener más detalles.

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