Uso del complemento PassThruCAN
El complemento Pass-Thru CAN accede a los adaptadores CAN a través de la API Pass-Thru de SAE J2534. SAE J2534 es un estándar para acceder a los buses de los vehículos desde un PC con Windows x86. Aunque la API está especificada únicamente para Windows de 32 bits, algunos proveedores también ofrecen implementaciones para Windows de 64 bits y otros sistemas operativos, como Linux.
Uso de PassThruCAN
Para utilizar PassThruCAN, deben instalarse los controladores del fabricante correspondientes al adaptador CAN. El fabricante también debe proporcionar una implementación de la API J2534 mediante una biblioteca compartida. Actualmente, solo se admite la versión 04.04 de la API Pass-Thru.
Al utilizar una versión x64 de Qt, este complemento solo funciona si el fabricante del dispositivo CAN también proporciona una versión de 64 bits de la biblioteca de la interfaz J2534 Pass-Thru. Si el fabricante solo proporciona una interfaz J2534 de 32 bits, se requiere una versión de Qt de 32 bits para poder utilizarla.
Para la detección automática de dispositivos, el software del fabricante también debe enumerar y describir los adaptadores disponibles en el Registro de Windows. En sistemas distintos de Windows, la detección automática no está compatible actualmente.
Creación de dispositivos de bus CAN
En primer lugar, es necesario comprobar que QCanBus ofrece el complemento deseado:
if (QCanBus::instance()->plugins().contains(QStringLiteral("passthrucan"))) {
// plugin available
}Donde «passthrucan » es el nombre del complemento.
En Windows, se debe utilizar la detección automática de dispositivos para enumerar los adaptadores CAN disponibles a los que se puede acceder a través de la API Pass-Thru:
const auto adapters = QCanBus::instance()->
availableDevices(QStringLiteral("passthrucan"));
for (const QCanBusDeviceInfo &info : adapters) {
// List available adapter in the user interface.
uiListBox->addItem(info.name());
}En otros sistemas operativos, la lista de adaptadores detectados estará vacía. En su lugar, se debe proporcionar la ruta completa a la biblioteca de la interfaz J2534 proporcionada por el fabricante, en lugar del nombre del dispositivo:
QCanBusDevice *device = QCanBus::instance()->createDevice(
QStringLiteral("passthrucan"), QStringLiteral("/path/to/libj2534-vendor.so"));Para necesidades especiales, también es posible pasar un argumento de nombre de dispositivo específico del fabricante al abrir el adaptador Pass-Thru:
QCanBusDevice *device = QCanBus::instance()->createDevice(
QStringLiteral("passthrucan"), info.name() + QChar::fromLatin1('%') + deviceName);Todas las operaciones en el dispositivo de bus CAN «Pass-Thru» se ejecutan de forma asíncrona, incluidas la conexión y la desconexión. Para recibir una notificación cuando el dispositivo esté listo para leer y escribir tramas CAN, conéctate a la señal « stateChanged » (QCanBusDevice::CanBusDeviceState state):
if (!device) {
// Error handling goes here
} else {
connect(device, &QCanBusDevice::stateChanged,
this, &MyClass::canStateChanged);
device->connectDevice();
}state() devolverá « ConnectedState » una vez que el adaptador CAN se haya conectado correctamente. A continuación, el dispositivo estará disponible para escribir y leer tramas CAN:
QCanBusFrame frame;
frame.setFrameId(8);
frame.setPayload(QByteArray("\xA3\x6E\x74\x9C", 4));
device->writeFrame(frame);La lectura se puede realizar mediante el método ` readFrame()`. La señal ` framesReceived()` se emite cuando hay al menos una nueva trama disponible para su lectura:
QCanBusFrame frame = device->readFrame();El complemento Pass-Thru CAN admite las siguientes opciones de configuración, que se pueden controlar mediante setConfigurationParameter():
| Clave del parámetro de configuración | Descripción |
|---|---|
| QCanBusDevice::LoopbackKey | Cuando está activado, si se transmite una trama CAN por el bus CAN, el adaptador CAN recibirá un eco local de dicha trama. Las tramas de eco se marcan con QCanBusFrame::hasLocalEcho(). Por defecto, el modo de bucle cerrado está desactivado. |
| QCanBusDevice::RawFilterKey | Esta opción permite configurar filtros para los mensajes entrantes del bus CAN. Si se especifica, el valor debe ser un QList<QCanBusDevice::Filter>. Solo se admiten filtros de ID de tramas de datos. Por defecto, se aceptan tramas de datos con cualquier ID. |
| QCanBusDevice::BitRateKey | La velocidad de transmisión del bus CAN como un entero sin signo, en bits/s. La velocidad de transmisión por defecto es 500000 (500 kbit/s). Establecer la velocidad de transmisión después de que el dispositivo ya se haya conectado puede provocar una reinicialización implícita de la interfaz CAN. |
El complemento Pass-Thru CAN admite el formato de trama ampliado (ID de 29 bits), pero no la velocidad de datos flexible (CAN FD).
© 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.