TQMa8MPxL - YOCTO Linux BSP documentation

• 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.

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 

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

 ./qtcreator.sh 

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

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:

Click Apply in the top right corner to save

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

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

• 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.