DESK-MX-L-AN-0007: Getting Started With QT Creator

From DAVE Developer's Wiki
Jump to: navigation, search
Info Box
200px-Emblem-important.svg.png

This application note has been validated using the kit version in the History table.

History
Issue Date Notes

2018/03/26

XELK 3.0.0

2019/08/30

XELK 4.0.0
2022/08/26 DESK-MX6-L 1.0.0


Introduction[edit | edit source]

This application note details QT Creator setup and configuration in DESK-MX6-L MVM

Setting up Qt Creator to build for DESK-MX6-L[edit | edit source]

200px-Emblem-important.svg.png

Note: The version of Qt Creator may differ from images below. The version used is the release is 4.4.1 which can be downloaded form Qt archive server

Qt Creator Installation[edit | edit source]

To install Qt Creator inside your toolchain launch a terminal emulator and run

dvdk@vagrant:~$ cd desk-mx-l/
dvdk@vagrant:~/desk-mx-l$ ./qt-creator-opensource-linux-x86_64-4.4.1.run 

An installation wizard will appear. Clik Next to proced with the installation.

QtCreator-4.4.1 setup.png

Select Skip.

QtCreator-4.4.1 skip.png

Select Next.

QtCreator-4.4.1 next.png

Select the install directory or click Next.

QtCreator-4.4.1 folder.png

Select Next.

QtCreator-4.4.1 components.png

Click Next again.

QtCreator-4.4.1 license.png

And then click Install and complete the installation.

QtCreator-4.4.1 install.png

Then Finish to exit the setup wizard.

QtCreator-4.4.1 finish.png

Manual configuration[edit | edit source]

If you don't want to use the automatic setup or want to customize the configuration, in this section we details all the step required.

Devices[edit | edit source]

Go to Tools -> Options menu:

QtCreator-4.4.1 tools-options.png

Select Devices and click Add:

QtCreator-4.4.1 devices-add.png

Choose the Generic Linux device:

QtCreator-4.4.1 devices-linux-device.png

Insert the IP address of your device, root as username and leave password empty (this is the default configuration of DESK-MX6-L root file systems). Make sure that the device is connected to the network and your virtual machine networking is correctly configured (see this article for more details).

Then click Next:

QtCreator-4.4.1 devices-linux-device-EVK.png

The device will be created and the connectivity will be tested:

QtCreator-4.4.1 devices-linux-device-EVK-connect.png

If everything went ok you should see a dialog like the image below.

QtCreator-4.4.1 devices-linux-device-EVK-test.png

And finally, this is what the Devices window should look like.

QtCreator-4.4.1 devices-linux-device-EVK-configured.png

GCC & Cross Compilation[edit | edit source]

Next you need to configure the cross compilation tool inside Build & Run -> Compiler.

QtCreator-4.4.1 devices-linux-build-and-run.png

Click Add -> GCC and add the compiler path.

/home/dvdk/desk-mx-l/sdk/latest_desk-mx6-l/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gcc

And click Apply.

QtCreator-4.4.1 devices-linux-build-and-run-gcc.png

Do the same for the C++ cross compilation tool.

/home/dvdk/desk-mx-l/sdk/latest_desk-mx6-l/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-g++
QtCreator-4.4.1 devices-linux-build-and-run-g++.png

Debugger GDB[edit | edit source]

Now it is necessary to add a debugger. In order to do this go to the Debuggers tab and click Add and then select the GDB debugger at the location

/home/dvdk/desk-mx-l/sdk/latest_desk-mx6-l/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gdb

and click Apply.

QtCreator-4.4.1 devices-linux-build-and-run-gdb.png

Qt Version[edit | edit source]

Next you need to add the Qt Version installed on your device. Go to Qt Version click Add and select the following qmake file.

/home/dvdk/desk-mx-l/sdk/latest_desk-mx6-l/sysroots/x86_64-pokysdk-linux/usr/bin/qt5/qmake
QtCreator-4.4.1 devices-linux-build-and-run-qmake.png

Kits[edit | edit source]

The last step is to add a new kit. Go to Kits and click Add and complete the information as shown below. Pay attention that in Qt mkspec you need to write

linux-oe-g++
QtCreator-4.4.1 devices-linux-build-and-run-EVK.png

After this your setup is complete and you can proceed and create your Qt applications.

Qt application example[edit | edit source]

Now that the setup is finished, you can create your first application

Open a new terminal and source the environment variables with the command.

dvdk@vagrant:~/desk-mx-l$ source desk-mx6-l-1.0.0_env.sh

In the same terminal type the following command (we assume you didn't change the default installation directory)

dvdk@vagrant:~$ ./qtcreator-4.4.1/bin/qtcreator


200px-Emblem-important.svg.png

It is important to repeat the previous two steps every time you start QTCreator

Now click on New Project

QtCreator-4.4.1 project.png

Select Application Qt Widgets Application and click Choose...

QtCreator-4.4.1 new-project.png

Now call the Project Test and press Next.

QtCreator-4.4.1 new-project-test.png

Select the SBC AXEL EVK and click Next.

QtCreator-4.4.1 new-project-SBC-AXEL-EVK.png

Choose the class name for your application.

QtCreator-4.4.1 new-project-SBC-AXEL-EVK-class.png

Click Finish to conclude the setup.

QtCreator-4.4.1 new-project-SBC-AXEL-EVK-finish.png

To add a clickable button to your application, select the Edit window and select Test -> Forms -> mainwindow.ui

QtCreator-4.4.1 project-Test-MainWindow.png

Click on Push Button in the Buttons tab and drag it to the main window view. In order to edit the text displayed by the label, double click it and write "Hello World!".

QtCreator-4.4.1 project-Test-MainWindow-Pushbutton.png

After that, you need to insert the following two line inside the Test.pro file

target.path = /home/root/Test # path on device
INSTALLS += target

Where /home/root/Test is the path in which your application will be downloaded inside the device.

QtCreator-4.4.1 project-Test-MainWindow-TestPro.png

Build the project in order to complete the configuration and set the overall vars:

QtCreator-4.4.1 project-Test-MainWindow-Build.png

The last step before running the application inside the device is to configure Qt backend into application command line arguments: open the Project window and select the Run configuration, then type -platform eglfs into Arguments

QtCreator-4.4.1 project-Test-MainWindow-eglfs.png

After these changes you are ready to debug your application inside your board with the Run/Debug command QtCreator XELK 3 0 0 35.png

QtCreator-4.4.1 project-Test-MainWindow-debug.png

The debugger (via gdb server) will be activated and the debug window will be ready:

QtCreator-4.4.1 project-Test-MainWindow-debug-running.png