En esta página

Uso del complemento PeakCAN

El complemento PeakCAN encapsula la API de bajo nivel para trabajar con los adaptadores CAN de PEAK-System.

Este complemento requiere los controladores de dispositivo PCAN y la biblioteca PCAN-Basic, versión 4.4.0 o superior en Windows (pcanbasic.dll) o 4.0.0 en Linux (libpcanbasic.so). En macOS, el complemento requiere la biblioteca PCBUSB de UV Software, versión 0.9 o superior.

Nota: Las versiones de Qt 5.14 a 6.4 solo son compatibles con la versión 0.8.1 de la biblioteca PCBUSB, pero las versiones de Qt 6.5 y superiores requieren una versión de PCBUSB 0.9 o superior.

Nota: « QCanBusDeviceInfo::alias» () solo es compatible con Windows y con PCAN-Basic 4.4.0 o superior.

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("peakcan"))) {
    // plugin available
}

Donde «peakcan» 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("peakcan"), QStringLiteral("usb0"), &errorString);
if (!device) {
    // Aquí va el manejo de errores
    qDebug << errorString;
} else {
    device->connectDevice();
}

Donde usb0 es el nombre de la interfaz CAN activa. El complemento PeakCAN admite 16 interfaces USB, desde usb0 hasta usb15, y 16 interfaces PCI, desde pci0 hasta pci15. El método availableDevices() devuelve una lista de los dispositivos disponibles en ese momento.

Nota: Actualmente, este complementosolo es compatible con los adaptadores USB y PCI.

Nota: En macOS, este complemento solo admite adaptadores USB por el momento.

El dispositivo ya está listo para leer y escribir 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();

PeakCAN admite las siguientes configuraciones, que pueden controlarse mediante setConfigurationParameter():

Clave del parámetro de configuraciónDescripción
QCanBusDevice::CanFdKeyEsta opción de configuración determina si se pueden enviar o recibir tramas CAN FD. Por defecto, esta opción está desactivada. Para activar esta opción se necesita hardware compatible con CAN FD.
QCanBusDevice::BitRateKeyDetermina la velocidad de transmisión de la conexión del bus CAN. Se admiten las siguientes velocidades de transmisión: 5000, 10000, 20000, 33000, 47000, 50000, 83000, 95000, 100000, 125 000, 250 000, 500 000, 800 000, 1 000 000. Si la opción « QCanBusDevice::CanFdKey » está activada, las velocidades de transmisión se limitan a 125 000, 250 000, 500 000 o 1 000 000. Ten en cuenta que este parámetro de configuración solo se puede ajustar mientras el « QCanBusDevice » no esté conectado.
QCanBusDevice::DataBitRateKeyDetermina la velocidad de transmisión de datos de la conexión del bus CAN FD. La opción « QCanBusDevice::CanFdKey » debe estar activada para poder configurar esta opción. Las velocidades de transmisión de datos posibles son 2 000 000, 4 000 000, 8 000 000 o 10 000 000. Ten en cuenta que este parámetro de configuración solo se puede ajustar mientras el « QCanBusDevice » no esté conectado.

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