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érie industriels, tels que CAN, ModBus et autres.

Pour commencer

Pour utiliser le module avec CMake, utilisez la commande « find_package() » afin de localiser les composants nécessaires du module dans le paquet « Qt6 » :

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

Pour utiliser le module lors de la compilation avec qmake, ajoutez-le en tant que valeur de la variable ` QT ` dans le fichier .pro du projet :

QT += serialbus

Bus et protocoles pris en charge

Référence API

Voici les liens vers la documentation de référence de l'API.

Catégories de journalisation

Le module « QtSerialBus » exporte l’ logging categories suivante :

Catégorie de journalisationDescription
qt.canbusActive la journalisation standard au sein des classes Qt CAN Bus
qt.canbus.pluginsActive la journalisation de bas niveau au sein des classes de plugins Qt CAN Bus. Pour configurer la journalisation d'un plugin spécifique, utilisez « qt.canbus.plugins.pluginname ». Par exemple : « qt.canbus.plugins.socketcan ». « qt.canbus.plugins* » s'applique à tous les plugins.
qt.modbusActive la journalisation standard au sein des classes Qt Modbus
qt.modbus.lowlevelActive la journalisation de bas niveau, y compris le contenu des paquets individuels, au sein des classes Qt Modbus

Les catégories de journalisation peuvent être utilisées pour activer des messages d’avertissement et de débogage supplémentaires pour QtSerialBus. Vous trouverez des informations plus détaillées sur la journalisation à l’adresse QLoggingCategory.

Pour activer rapidement l'ensemble de la journalisation Qt Modbus, ajoutez la ligne suivante à la fonction main() :

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

Exemples

Évolution du module

La section «Modifications apportées à Qt SerialBus » répertorie les changements importants apportés à l'API et aux fonctionnalités du module dans le cadre de la série Qt 6.

Licences

Qt SerialBus est disponible sous licence commerciale auprès de The Qt Company. Il est également disponible sous licence GNU Lesser General Public License, version 3, ou GNU General Public License, version 2. Pour plus d'informations, consultez la page Licences Qt.

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