Using SystecCAN Plugin | Qt Serial Bus 6.8.0
Description: Overview of how to use the SystecCAN plugin.

- Qt 6.8
- Qt Serial Bus
- Using SystecCAN Plugin
- Qt 6.8.0 Reference Documentation

# Using SystecCAN Plugin

The SystecCAN plugin encapsulates the low-level API to work with the SYS TEC CAN adapters.

This plugin requires the SYS TEC CAN device drivers and the usbcan32.dll (usbcan64.dll for 64 bit builds).

## Creating CAN Bus Devices

At first it is necessary to check that QCanBus provides the desired plugin:

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

Where systeccan is the plugin name.

Next, a connection to a specific interface can be established:

     QString errorString;
     QCanBusDevice *device = QCanBus::instance()->createDevice(
         QStringLiteral("systeccan"), QStringLiteral("can0.0"), &errorString);
     if (!device) {
         // Error handling goes here
         qDebug << errorString;
     } else {
         device->connectDevice();
     }

Where, can0.0 is the active CAN interface name (interface 0, channel 0). The SystecCAN plugin supports 64 USB interfaces (so called modules) from can0.0 to can63.1. Each module can have one or two channels, they can be accessed by the index canX.0 or canX.1. The availableDevices() method returns a list of currently available devices.

Note: SYS TEC also provides 8 or 16 channel CAN interfaces. These units consist of an USB hub and multiple two-channel modules internally.

The device is now open for writing and reading CAN frames:

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

The reading can be done using the readFrame() method. The framesReceived() signal is emitted when at least one new frame is available for reading:

     QCanBusFrame frame = device->readFrame();

SystecCAN supports the following configurations that can be controlled through setConfigurationParameter():

Configuration parameter key | Description
--- | ---
QCanBusDevice::BitRateKey | Determines the bit rate of the CAN bus connection. The following bit rates are supported: 10000, 20000, 50000, 100000, 125000, 250000, 500000, 800000, and 1000000. Note that this configuration parameter can only be adjusted while the QCanBusDevice is not connected.
QCanBusDevice::ReceiveOwnKey | The reception of CAN frames on the same channel that was sending the CAN frame is disabled by default. If this option is enabled, the therefore received frames are marked with QCanBusFrame::hasLocalEcho()

SystecCAN supports the following additional functions:

- QCanBusDevice::resetController()
- QCanBusDevice::busStatus()