![]() |
CETONI SDK
20220623
The software libraries for integration of all CETONI devices.
|
The CETONI SDK for Linux is available as tar archive (i.e. QmixSDK_Linux_v20200506.tar.gz
) or as a debian package (i.e. qmix-sdk_2020.7.1-x86_64_ubuntu18.04.deb
). The recommended installation method is the debian package because it will ship less libraries (uses system libraries) and it properly installs the required CAN interface drivers. Depending on the installation package you choose, continue reading with the documentation section for your package:
Install the debian package from the command line with the following command:
The debian package installs the following components:
qmix-sdk.conf
for adding the path of the CETONI SDK libraries to the library search path/usr/bin/configure_qmix_device.sh
to start drivers if a device is plugged inconfigure_qmix_device.sh
for starting the required drivers if a USB-CAN interface is plugged inTo link against the SDK's shared libraries and to use the SDK's shared libraries you just need to add the library path /usr/lib/qmix-sdk
to your linker search path. Here is the command line for compilation of a small test.cpp
app that uses the labbCAN_Bus_API
:
With the test cases you can check, if the SDK runs properly on your Linux system. To run a test case, you should open a terminal and change into the /usr/share/qmix-sdk
directory. Now you can execute the test cases
If you would like to run all tests that do not require user interaction, then you can simply run the script run_all_tests.sh
:
You can test the Python integration by running the test cases in /usr/share/qmix-sdk
. If you run the test cases, then use the script run_pytest.sh
to start a test case. This script ensures, that the device configuration path is set properly.
The CETONI SDK tar archive extracts a number of files into the final SDK folder. The following overview shows which files are available in which directories:
The CETONI SDK depends on the following libraries:
You need to ensure that these libraries are properly installed on your Linux system.
To link against the SDK's shared libraries and to use the SDK's shared libraries you need to ensure, that the lib folder of the SDK is the first folder in the library search paths. You can do this by prepending the lib folder to the LD_LIBRARY_PATH
environment variable.
With the test cases you can check, if the SDK runs properly on your Linux system. To run a test case, you should open a terminal and change into the root SDK directory. Now you can execute the test cases
The CETONI SDK for Linux supports the Linux SocketCAN driver. That means, all CAN devices that support the SocketCAN layer are supported by the SDK. The SDK folder device_driver contains the SocketCAN drivers for the following devices:
Follow the instructions in the device driver archives to build and install the device driver for your USB-CAN hardware.
After disconnecting and plugging in the USB cable or after each restart/hibernation the correct CAN bitrate must be set and the CAN interface needs to get started. This can be done with:
If necessary, the interface can also be restarted:
For more information please use the included Readme files from SysTec or IXXAT (e.g. to use candump).