TQMa8MPxL - YOCTO Linux BSP documentation

Setup Qt Creator for STKa8MPxL

Prerequisites

  • BSP built according to quickstart guide, but instead of bitbake tq-image-weston you have to use bitbake tq-image-qt6
  • Build Yocto SDK based on the current RootFS configuration, installed on the development host. See Build Yocto SDK how to build it
  • Configured network connection to the development host
  • Configured SSH login on the target.

Setup Development Host

Set up Qt Creator

Download the Qt online installer from the following link:
https://www.qt.io/development/download-qt-installer-oss

Afterwards make the Qt installer file executable and run the Qt installer. You will need a Qt account for the installation. Follow the installation wizard instructions and install Qt 6.8.3

The next step is to add the environment setup of the Yocto SDK to the qtcreator.sh script.
If the install location has not been changed the qtcreator.sh is located in ~/Qt6/Tools/QtCreator/bin/qtcreator.sh 

 nano ~/Qt6/Tools/QtCreator/bin/qtcreator.sh

In the script, add the following line at the beginning of the file: 

 source /opt/dumpling-wayland/5.0.16/environment-setup-armv8a-tq-linux

Run Qt Creator

Change to the directory where the qtcreator.sh file is located and execute the following command: 

 ./qtcreator.sh

If qtcreator.sh returns source: not found, before “sudo sh qtcreator.sh”, enter sudo dpkg-reconfigure dash and choose no.

If qtcreator.sh returns qt.qpa.plugin: Could not load the Qt platform plugin “xcb” in “” even though it was found.,enter sudo apt-get install –reinstall libxcb-xinerama0.

Configure Qt Creator

First, a connection to the target board needs to be configured:

  1. In the left sidebar, click Preferences > Devices
  2. Click Add > Remote Linux Device > Start Wizard
  3. Change the name to “STKa8MPXL” and configure the target's IP-Adress and the username.
  4. Finish the installation wizard
  5. The final device configuration should look as follows:

Click Apply in the top right corner to save

Add a compiler

  1. In the left sidebar, click Preferences > Kits > Compilers
  2. Click Add and select GCC
  3. Change Name to TQMa8MPXL
  4. Set C Compiler path to /opt/dumpling-wayland/5.0.16/sysroots/x86_64-tqsdk-linux/usr/bin/aarch64-tq-linux/aarch64-tq-linux-gcc
  5. Set Platform codegen flags to --sysroot=/opt/dumpling-wayland/5.0.16/sysroots/armv8a-tq-linux
  6. Set the following values for ABI from the dropdown menus:
processor architecture operating system OS flavor binary format system architecture
arm linux generic elf 64bit

Click Apply in the top right corner to save


Add a crosscompiled version for Qt

  1. Click Qt Versions on the Kits panel
  2. Click Add
  3. Locate the qmake file in /opt/dumpling-wayland/5.0.16/sysroots/x86_64-tqsdk-linux/usr/bin/qmake6
  4. Click Apply in the top right corner to save

Add a new kit

  1. Click on Kits in the Kits panel
  2. Click Add and set the following:
  • Name STKa8MPXL
  • Build Device: Desktop
  • Run Device: STKaMPXL (default for Remote Linux)
  • Compiler: TQMa8MPxL
  • Edit Build Environment: add the following line:
QT_HOST_PATH=/opt/dumpling-wayland/5.0.16/sysroots/x86_64-tqsdk-linux/usr
  • Edit Run Environment: add the following lines:
QT_QPA_PLATFORM=wayland
QT_PLUGIN_PATH=/usr/lib/plugins
LD_LIBRARY_PATH=/usr/lib
XDG_RUNTIME_DIR=/run/user/0
  • Debugger: System GDB at /opt/dumpling-wayland/5.0.16/sysroots/x86_64-tqsdk-linux/usr/bin/aarch64-tq-linux/aarch64-tq-linux-gdb
  • Sysroot: /opt/dumpling-wayland/5.0.16/sysroots/armv8a-tq-linux
  • Qt version Qt 6.8.3 (System)
  • CMake Tool: System CMake at /opt/dumpling-wayland/5.0.16/sysroots/x86_64-tqsdk-linux/usr/bin/cmake

Click Apply in the top right corner to save


Run Example

  • Go to Welcome > Examples
  • Search for Qt Quick Demo - Clocks and select it
  • If it doesnt happen automatically, switch to the Projects section on the left
  • Select the STKa8MPxL in the “Configure Project” Section and click Configure Project in the bottom right

If everything configured correctly, press on the now green play button in the bottom left to build, deploy and run the example.