Uso del complemento VectorCAN
El complemento VectorCAN encapsula la API de bajo nivel para trabajar con los adaptadores CAN de Vector Informatik.
Este complemento requiere los controladores de dispositivos CAN de Vector y el archivo vxlapi.dll (vxlapi64.dll para compilaciones de 64 bits).
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("vectorcan"))) {
// plugin available
}Donde «vectorcan» es el nombre del complemento.
A continuación, se puede establecer una conexión con una interfaz específica:
QString errorString;
QCanBusDevice*device = QCanBus::instance()->createDevice(
QStringLiteral("vectorcan"), QStringLiteral("can0"), &errorString);
if (!device) {
// Aquí va el tratamiento de errores
qDebug << errorString;
} else {
device->connectDevice();
}Donde can0 es el nombre del canal CAN activo. El complemento VectorCAN proporciona 64 canales (definidos por XL_CONFIG_MAX_CHANNELS en la API de Vector) desde can0 hasta can63. Algunos de estos canales pueden ser virtuales y, por lo tanto, pueden utilizarse sin necesidad de disponer de hardware CAN real. Para conocer los canales virtuales, se puede utilizar el programa «Vector Hardware Config» (vcanconf.exe), incluido en el paquete de controladores de Vector. El método availableDevices() devuelve una lista de los dispositivos disponibles en ese momento.
El dispositivo ya está abierto para escribir y leer tramas CAN:
QCanBusFrame frame;
frame.setFrameId(8);
QByteArray payload("A36E");
frame.setPayload(payload);
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();VectorCAN admite las siguientes configuraciones, que se pueden controlar mediante setConfigurationParameter():
| Clave del parámetro de configuración | Descripción |
|---|---|
| QCanBusDevice::BitRateKey | Determina la velocidad de transmisión de la conexión del bus CAN. |
| QCanBusDevice::ReceiveOwnKey | La recepción de tramas CAN en el mismo dispositivo que las ha enviado está desactivada por defecto. Al activar esta opción, todas las tramas CAN enviadas al bus CAN aparecen inmediatamente en el búfer de recepción. Esto puede utilizarse para comprobar si el envío se ha realizado correctamente. Si se activa esta opción, las tramas recibidas se marcan con QCanBusFrame::hasLocalEcho() |
| QCanBusDevice::CanFdKey | Habilita el uso de CAN FD en la conexión del bus CAN. Si se habilita esta opción, no es posible recibir las propias tramas CAN que se están enviando, por lo que establecer « QCanBusDevice::ReceiveOwnKey » en «true» no tiene ningún efecto. A partir de Qt 5.15. |
| QCanBusDevice::DataBitRateKey | Determina la velocidad de transmisión de datos de la conexión del bus CAN. Solo está disponible cuando « QCanBusDevice::CanFdKey » está establecido en «true». A partir de Qt 5.15. |
VectorCAN admite las siguientes funciones adicionales:
© 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.