Utilisation du plugin PeakCAN

Le plugin PeakCAN encapsule l'API de bas niveau pour travailler avec les adaptateurs CAN du système PEAK.

Ce plugin nécessite les pilotes de périphériques PCAN et la bibliothèque PCAN-Basic version 4.4.0 ou supérieure sous Windows (pcanbasic.dll) ou 4.0.0 sous Linux (libpcanbasic.so). Sur macOS, le plugin nécessite la bibliothèque PCBUSB d'UV Software, version 0.9 ou supérieure.

Création de périphériques de bus CAN

Tout d'abord, il est nécessaire de vérifier que QCanBus fournit le plugin souhaité :

if (QCanBus::instance()->plugins().contains(QStringLiteral("peakcan"))) {
    // plugin available
}

où peakcan est le nom du plugin.

Ensuite, une connexion à une interface spécifique peut être établie :

QString errorString ;QCanBusDevice *device = QCanBus::instance()->createDevice( QStringLiteral("peakcan"), QStringLiteral("usb0"), &errorString) ;if (!device) { // La gestion des erreurs se fait ici    qDebug << errorString;
} else {  device->connectDevice() ; }

Où usb0 est le nom de l'interface CAN active. Le plugin PeakCAN supporte 16 interfaces USB de usb0 à usb15 et 16 interfaces PCI de pci0 à pci15. La méthode availableDevices() renvoie une liste des périphériques actuellement disponibles.

L'appareil est maintenant ouvert à l'écriture et à la lecture de trames CAN :

QCanBusFrame frame;
frame.setFrameId(8);
QByteArray payload("A36E");
frame.setPayload(payload);
device->writeFrame(frame);

La lecture peut être effectuée à l'aide de la méthode readFrame(). Le signal framesReceived() est émis lorsqu'au moins une nouvelle trame est disponible pour la lecture :

QCanBusFrame frame = device->readFrame();

PeakCAN prend en charge les configurations suivantes qui peuvent être contrôlées par setConfigurationParameter() :

PeakCAN prend en charge les fonctions supplémentaires suivantes :

• QCanBusDevice::resetController()
• QCanBusDevice::busStatus()
• QCanBusDeviceInfo::alias() (Windows et PCAN-Basic >= 4.4.0 uniquement) : Renvoie le PCAN_DEVICE_ID qui peut être réglé sur une valeur définie par l'utilisateur entre 0..255 resp. 0..4294967295 (en fonction de l'appareil) avec PCAN-View. La valeur par défaut est 255 resp. 4294967295.