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ón | Descripción |
|---|---|
| QCanBusDevice::CanFdKey | Esta 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::BitRateKey | Determina 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::DataBitRateKey | Determina 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:
- QCanBusDevice::resetController()
- QCanBusDevice::busStatus()
- QCanBusDeviceInfo::alias() (solo en Windows y PCAN-Basic >= 4.4.0): Devuelve el PCAN_DEVICE_ID, que puede configurarse con un valor definido por el usuario entre 0 y 255 o entre 0 y 4294967295 (dependiendo del dispositivo) mediante PCAN-View. El valor por defecto es 255 o 4294967295.
© 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.