Using VirtualCAN Plugin

Overview of how to use the VirtualCAN plugin.

Article lu fois.

L'auteur

The Qt Company Ltd.

L'article

Publié le 26 janvier 2024 - Mis à jour le 26 janvier 2024

Liens sociaux

Using VirtualCAN Plugin▲

The VirtualCAN plugin allows testing of CAN applications with a local TCP/IP connection without CAN hardware. The TCP server is created, when the first client calls createDevice(). The default TCP port is 35468, which can be changed by giving the fully qualified URL to createDevice(). Once the server is running, no further server is started on the same system.

Afterwards, all clients send their CAN frames to the server, which distributes them to the other clients.

Creating CAN Bus Devices▲

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

Sélectionnez

if (QCanBus::instance()-&gt;plugins().contains(QStringLiteral("virtualcan"))) {
    // plugin available
}

Where virtualcan is the plugin name.

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

Sélectionnez

QCanBusDevice *device = QCanBus::instance()-&gt;createDevice(
    QStringLiteral("virtualcan"), QStringLiteral("can0"));
device-&gt;connectDevice();

Where can0 is the active CAN channel name. The VirtualCAN plugin provides two channels "can0" and "can1". Both can be used as CAN 2.0 or CAN FD channels. All applications connected to one of these channels receive all messages that are sent to this channel.

To connect to a remote server, use the following fully qualified URL as interface name:

Sélectionnez

tcp://server:port/canX

for example:

Sélectionnez

tcp://192.168.1.2:35468/can0

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

Sélectionnez

QCanBusFrame frame;
frame.setFrameId(8);
QByteArray payload("A36E");
frame.setPayload(payload);
device-&gt;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:

Sélectionnez

QCanBusFrame frame = device-&gt;readFrame();

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

Configuration parameter key	Description
QCanBusDevice::CanFdKey	Determines whether the virtual CAN bus operates in CAN FD mode or not. This option is disabled by default.
QCanBusDevice::ReceiveOwnKey	The reception of the CAN frames on the same device that was sending the CAN frame is disabled by default. When enabling this option, all CAN frames sent to the CAN bus immediately appear in the receive buffer. This can be used to check if sending was successful. If this option is enabled, the therefore received frames are marked with QCanBusFrame::hasLocalEcho()

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants :