Bus CAN de Qt
Una red de área de controlador (CAN) es un estándar de bus para vehículos diseñado para permitir que los microcontroladores y los dispositivos se comuniquen entre sí en aplicaciones sin ordenador central.
Descripción general
Se trata de un protocolo basado en mensajes, diseñado originalmente para el cableado eléctrico multiplexado en automóviles, pero que también se utiliza en muchos otros contextos.
La API del bus CAN proporciona una interfaz de programación de aplicaciones (API) común para acceder a los dispositivos CAN:
- QCanBus proporciona una API para crear un objeto ` QCanBusDevice ` a partir de un complemento elegido.
- QCanBusDeviceInfo proporciona información sobre los dispositivos CAN disponibles.
- QCanBusDevice proporciona una API para acceder directamente al dispositivo CAN.
- QCanBusFrame define una trama CAN que se puede escribir y leer desde un « QCanBusDevice ».
A partir de Qt 6.5, el módulo proporciona API para decodificar los valores reales de las señales a partir de tramas CAN sin procesar y también para codificar datos de usuario en tramas CAN:
- QCanSignalDescription proporciona reglas para procesar señales CAN.
- QCanMessageDescription Proporciona reglas para procesar mensajes CAN. Una descripción de mensaje suele contener varias descripciones de señales.
- QCanUniqueIdDescription proporciona reglas para procesar un identificador único dentro de una trama CAN.
- QCanFrameProcessor utiliza las descripciones proporcionadas por las clases QCanMessageDescription, QCanSignalDescription y QCanUniqueIdDescription para codificar o decodificar tramas CAN.
- QCanDbcFileParser Proporciona una API para extraer descripciones de mensajes de archivos DBC.
Nota: Todas las API para codificar y decodificar tramas CAN son experimentales y están sujetas a cambios.
Complementos para el bus CAN
Varios proveedores ofrecen dispositivos CAN con distintas API de acceso. El módulo QtSerialBus es compatible con los siguientes conjuntos de complementos de bus CAN:
| Proveedor | Complemento (clave) | Breve descripción |
|---|---|---|
| CAN a través de sockets de Linux | SocketCAN (socketcan) | Complemento para el bus CAN que utiliza sockets de Linux y controladores de código abierto. |
| CAN a través de SAE J2534 Pass-Thru | PassThruCAN (passthrucan) | Complemento para el bus CAN que utiliza la interfaz «Pass-Thru» de SAE J2534. |
| SYS TEC electronic | SystecCAN (systeccan) | Backend de bus CAN que utiliza los adaptadores CAN de SYS TEC. |
| PEAK-System | PeakCAN (peakcan) | Módulo de bus CAN que utiliza los adaptadores CAN de PEAK. |
| MHS Elektronik | TinyCAN (tinycan) | Complemento para el bus CAN que utiliza los adaptadores CAN de MHS. |
| Vector Informatik | VectorCAN (vectorcan) | Complemento de bus CAN que utiliza los adaptadores CAN de Vector. |
| Interfaz CAN virtual | VirtualCAN (virtualcan) | Complemento de bus CAN que utiliza una conexión TCP/IP virtual. |
Implementación de un complemento CAN personalizado
Si los complementos proporcionados por Qt no son adecuados para la plataforma de destino requerida, se puede implementar un complemento de bus CAN personalizado. La implementación sigue el procedimiento estándar para implementar complementos de Qt. El complemento personalizado debe publicarse en $QTDIR/plugins/canbus.
Cada complemento debe definir una clave, que se utiliza para cargar el complemento. Esto se realiza mediante un pequeño archivo JSON. Por ejemplo, el complemento socketcan utiliza el siguiente plugin.json:
{
"Key": "socketcan"
}Esta clave debe pasarse a ` QCanBus::createDevice()` junto con el nombre de la interfaz del adaptador de bus CAN. ` QCanBus ` carga e instancia el complemento utilizando la interfaz `QCanBusFactoryV2`, que cada complemento debe implementar como punto de entrada central. La interfaz actúa como una fábrica y su único propósito es devolver una instancia de ` QCanBusDevice `. El nombre de la interfaz mencionado anteriormente se pasa a través del método ` QCanBusFactory::createDevice()` de la fábrica. A continuación se muestra la implementación de la fábrica del complemento `socketcan`:
class SocketCanBusPlugin : public QObject, public QCanBusFactory
{
Q_OBJECT
Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QCanBusFactory" FILE "plugin.json")
Q_INTERFACES(QCanBusFactory)
public:
QList<QCanBusDeviceInfo> availableDevices(QString *errorMessage) const override
{
Q_UNUSED(errorMessage);
return SocketCanBackend::interfaces();
}
QCanBusDevice *createDevice(const QString &interfaceName, QString *errorMessage) const override
{
Q_UNUSED(errorMessage);
auto device = new SocketCanBackend(interfaceName);
return device;
}
};El siguiente paso es proporcionar una implementación de ` QCanBusDevice`. Como mínimo, deben implementarse las siguientes funciones virtuales puras:
- QCanBusDevice::open()
- QCanBusDevice::close()
- QCanBusDevice::writeFrame()
- QCanBusDevice::interpretErrorFrame()
Los métodos ` open()` y ` close()` se utilizan junto con ` QCanBusDevice::connectDevice()` y ` QCanBusDevice::disconnectDevice()`, respectivamente. Consulta la documentación de las funciones para obtener detalles sobre su implementación.
QCanBusDevice::writeFrame() se encarga de realizar comprobaciones de integridad, como la validez de QCanBusFrame y que el dispositivo siga conectado. Si se superan las comprobaciones, escribe la trama en el bus CAN. Si la operación se realiza con éxito, emite la señal QCanBusDevice::framesWritten(); en caso contrario, se llama a QCanBusDevice::setError() con el mensaje de error correspondiente. Esta función también puede utilizarse para implementar una operación de escritura asíncrona. Es responsabilidad de los desarrolladores del complemento emitir las señales adecuadas en el momento oportuno.
Por último, pero no por ello menos importante, QCanBusDevice::interpretErrorFrame ofrece una forma cómoda de traducir el contenido de una trama de error del bus CAN a una cadena de error legible para el usuario.
© 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.