Sur cette page

Qt Serial Bus

L'API Qt Serial Bus fournit des classes et des fonctions permettant d'accéder aux différents bus et protocoles sériels industriels, tels que CAN, ModBus et autres.

Pour commencer

Pour utiliser le module avec CMake, utilisez la commande find_package() pour localiser les composants nécessaires du module dans le paquetage Qt6:

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

Pour utiliser le module pour la construction avec qmake, ajoutez le module comme valeur de la variable QT dans le fichier .pro du projet :

QT += serialbus

Bus et protocoles pris en charge

Référence API

Voici des liens vers les documents de référence de l'API.

Catégories de journalisation

Le module QtSerialBus exporte les catégories suivantes logging categories:

Catégorie de journalisationDescription de la catégorie
qt.canbusActive la journalisation standard dans les classes Qt CAN Bus
qt.canbus.pluginsActive la journalisation de bas niveau dans les classes de plugins Qt CAN Bus. Pour définir la journalisation pour un plugin spécifique, utilisez "qt.canbus.plugins.pluginname", par exemple "qt.canbus.plugins.socketcan". "qt.canbus.plugins*" affecte tous les plugins.
qt.modbusActive la journalisation standard dans les classes Qt Modbus
qt.modbus.lowlevelActive la journalisation de bas niveau, y compris le contenu des paquets individuels, dans les classes Qt Modbus.

Les catégories de journalisation peuvent être utilisées pour activer des sorties d'avertissement et de débogage supplémentaires pour QtSerialBus. Des informations plus détaillées sur la journalisation peuvent être trouvées dans QLoggingCategory.

Une façon rapide d'activer toute la journalisation Qt Modbus est d'ajouter la ligne suivante à la fonction main() :

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

Exemples

Évolution du module

Changes to Qt SerialBus liste les changements importants dans l'API et les fonctionnalités du module qui ont été faits pour la série 6 de Qt.

Licences

Qt SerialBus est disponible sous licence commerciale auprès de The Qt Company. En outre, il est disponible sous la licence GNU Lesser General Public License, version 3, ou la licence GNU General Public License, version 2. Voir Qt Licensing pour plus de détails.

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