Difference between revisions of "DESK-MX-L-AN-0007: Getting Started With QT Creator"

From DAVE Developer's Wiki
Jump to: navigation, search
(23 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{InfoBoxTop}}
+
= Setting up Qt Creator to build for XELK =
{{AppliesToAXEL Lite AN}}
 
{{InfoBoxBottom}}
 
{{WarningMessage|text=This application note was validated against specific versions of the kit only. It may not work with other versions. Supported versions are listed in the ''History'' section.}}
 
=History=
 
 
 
{| class="wikitable" border="1"
 
!Page version
 
!Date
 
!XELK version
 
!Notes
 
|-
 
|1.0.0
 
|March 2018
 
|[[Axel_Embedded_Linux_Kit_(XELK)#XELK_software_components|XELK 3.0.0]]
 
|First release
 
|-
 
|{{oldid|8847|2.0.0}}
 
|August 2019
 
|[[Axel_Embedded_Linux_Kit_(XELK)#XELK_software_components|XELK 4.0.0]]
 
|Updated XELK version
 
|-
 
|3.0.0
 
|August 2022
 
|{{pageoldid|DESK-MX6-L|15794|DESK-MX6-L 1.0.0}}
 
|DESK-MX6-L version
 
|}
 
 
 
= Introduction =
 
 
 
This application note details QT Creator setup and configuration in [[DESK-MX6-L|DESK-MX6-L]] [[Managed Virtual Machine (MVM)|MVM]]
 
 
 
= Setting up Qt Creator to build for DESK-MX6-L =
 
{{ImportantMessage|text=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 [https://download.qt.io/archive/qtcreator/4.4/4.4.1/ Qt archive server]}}
 
 
 
 
== Qt Creator Installation ==
 
== Qt Creator Installation ==
 
 
To install Qt Creator inside your toolchain launch a terminal emulator and run  
 
To install Qt Creator inside your toolchain launch a terminal emulator and run  
 
 
<pre>
 
<pre>
dvdk@vagrant:~$ cd desk-mx-l/
+
dvdk@vagrant-ubuntu-trusty-64:~$ cd axel/
 
</pre>
 
</pre>
 
<pre>
 
<pre>
dvdk@vagrant:~/desk-mx-l$ ./qt-creator-opensource-linux-x86_64-4.4.1.run  
+
dvdk@vagrant-ubuntu-trusty-64:~/axel$ ./qt-creator-opensource.run
 
</pre>
 
</pre>
 
 
An installation wizard will appear. Clik '''Next''' to proced with the installation.
 
An installation wizard will appear. Clik '''Next''' to proced with the installation.
  
[[File:QtCreator-4.4.1_setup.png|400px|border|center]]
+
[[File:QtCreator XELK 3 0 0 01.png|200px|border|center]]
  
 
Select '''Skip'''.
 
Select '''Skip'''.
  
[[File:QtCreator-4.4.1_skip.png|400px|border|center]]
+
[[File:QtCreator XELK 3 0 0 02.png|200px|border|center]]
  
 
Select '''Next'''.
 
Select '''Next'''.
  
[[File:QtCreator-4.4.1_next.png|400px|border|center]]
+
[[File:QtCreator XELK 3 0 0 03.png|200px|border|center]]
  
 
Select the install directory or click '''Next'''.
 
Select the install directory or click '''Next'''.
  
[[File:QtCreator-4.4.1_folder.png|400px|border|center]]
+
[[File:QtCreator XELK 3 0 0 04.png|200px|border|center]]
  
 
Select '''Next'''.
 
Select '''Next'''.
  
[[File:QtCreator-4.4.1_components.png|400px|border|center]]
+
[[File:QtCreator XELK 3 0 0 05.png|200px|border|center]]
  
 
Click '''Next''' again.
 
Click '''Next''' again.
  
[[File:QtCreator-4.4.1_license.png|400px|border|center]]
+
[[File:QtCreator XELK 3 0 0 06.png|200px|border|center]]
  
 
And then click '''Install''' and complete the installation.
 
And then click '''Install''' and complete the installation.
  
[[File:QtCreator-4.4.1_install.png|400px|border|center]]
+
[[File:QtCreator XELK 3 0 0 07.png|200px|border|center]]
  
Then '''Finish''' to exit the setup wizard.
+
And then '''Finish''' to exit the setup wizard.
  
[[File:QtCreator-4.4.1_finish.png|400px|border|center]]
+
[[File:QtCreator XELK 3 0 0 08.png|200px|border|center]]
  
== Manual configuration ==
+
== Automatic configuration ==
 +
 
 +
Now it is necessary to add the definition of your board before developing and compiling your applications.
  
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.
+
In order to add the device information automatically, run the following commands inside your terminal emulator.
  
=== Devices ===
+
<pre>
 +
dvdk@vagrant-ubuntu-trusty-64:~$ cd axel/
 +
</pre>
 +
<pre>
 +
dvdk@vagrant-ubuntu-trusty-64:~/axel$ ./qt-post-install.sh
 +
</pre>
  
Go to <code>Tools -> Options</code> menu:
+
If the installation process went ok, you should see inside the <code>Tools</code>-><code>Options</code> -> <code>Kits</code> a kit named XELK.
  
[[File:QtCreator-4.4.1_tools-options.png|1000px|border|center]]
+
[[File:QtCreator XELK 3 0 0 09.png|400px|border|center]]
  
Select <code>Devices</code> and click '''Add''':
+
Select the Kits tab and make sure that your configurations mateches the one displayed.
 +
 +
[[File:QtCreator XELK 3 0 0 10.png|400px|border|center]]
  
[[File:QtCreator-4.4.1_devices-add.png|700px|border|center]]
+
== Manual configuration ==
  
Choose the ''Generic Linux device'':
+
=== Devices ===
 +
Go to <code>Tools</code>-><code>Options</code> menu
 +
[[File:QtCreator XELK 3 0 0 09.png|400px|border|center]]
  
[[File:QtCreator-4.4.1_devices-linux-device.png|500px|border|center]]
+
select <code>Devices</code> and click '''Add'''
  
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 [[VirtualBox Network Configuration|this]] article for more details).
+
[[File:QtCreator XELK 3 0 0 22.png|400px|border|center]]
  
Then click '''Next''':
+
Choose the generic linux device
  
[[File:QtCreator-4.4.1_devices-linux-device-EVK.png|600px|border|center]]
+
[[File:QtCreator XELK 3 0 0 23.png|400px|border|center]]
  
The device will be created and the connectivity will be tested:
+
Insert the ip address of your device and the username and password of the root account. Make sure that the device is connected to the network and your virtual machine is configured to use a bridge connection and click '''Next'''.
  
[[File:QtCreator-4.4.1_devices-linux-device-EVK-connect.png|600px|border|center]]
+
[[File:QtCreator XELK 3 0 0 24.png|400px|border|center]]
  
If everything went ok you should see a dialog like the image below.
+
If everithing went ok you should see a dialog like the next one
  
[[File:QtCreator-4.4.1_devices-linux-device-EVK-test.png|500px|border|center]]
+
[[File:QtCreator XELK 3 0 0 25.png|400px|border|center]]
  
And finally, this is what the <code>Devices</code> window should look like.
+
And finally this is how the <code>Devices</code> window should look like
  
[[File:QtCreator-4.4.1_devices-linux-device-EVK-configured.png|800px|border|center]]
+
[[File:QtCreator XELK 3 0 0 26.png|400px|border|center]]
  
 
=== GCC & Cross Compilation ===
 
=== GCC & Cross Compilation ===
  
Next you need to configure the cross compilation tool inside <code>Build & Run -> Compiler</code>.
+
Next you need to configure the cross compilation tool inside <code>Build & Run</code> -> <code>Compiler</code>.
  
[[File:QtCreator-4.4.1_devices-linux-build-and-run.png|800px|border|center]]
+
[[File:QtCreator XELK 3 0 0 27.png|400px|border|center]]
  
Click <code>Add -> GCC</code> and add the compiler path.
+
Click <code>Add</code> -> <code>GCC</code> and add the compiler path.
  
 
<pre>
 
<pre>
/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
+
/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gcc
 
</pre>
 
</pre>
  
 
And click '''Apply'''.
 
And click '''Apply'''.
  
[[File:QtCreator-4.4.1_devices-linux-build-and-run-gcc.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 29.png|400px|border|center]]
  
Do the same for the C++ cross compilation tool.
+
Do the same fort the C++ cross compilation tool.
  
 
<pre>
 
<pre>
/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++
+
/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-g++
 
</pre>
 
</pre>
  
[[File:QtCreator-4.4.1_devices-linux-build-and-run-g++.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 28.png|400px|border|center]]
  
 
=== Debugger GDB ===
 
=== Debugger GDB ===
  
Now it is necessary to add a debugger. In order to do this go to the <code>Debuggers</code> tab and click '''Add''' and then select the GDB debugger at the location
+
Now it is necessary to add a debuger. In order to do this go to the <code>Debuggers</code> tab and click '''Add'''
 +
 
 +
[[File:QtCreator XELK 3 0 0 30.png|400px|border|center]]
 +
 
 +
And then select the GDB debugger at the location
  
 
<pre>
 
<pre>
/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
+
/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gdb
 
</pre>
 
</pre>
  
 
and click '''Apply'''.  
 
and click '''Apply'''.  
  
[[File:QtCreator-4.4.1_devices-linux-build-and-run-gdb.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 31.png|400px|border|center]]
  
 
=== Qt Version ===
 
=== Qt Version ===
  
Next you need to add the Qt Version installed on your device. Go to <code>Qt Version</code> click '''Add''' and select the following qmake file.
+
Next you need to add the Qt Version installed on your devices. Go to <code>Qt Version</code> click '''Add''' and select the following qmake file.
  
 
<pre>
 
<pre>
/home/dvdk/desk-mx-l/sdk/latest_desk-mx6-l/sysroots/x86_64-pokysdk-linux/usr/bin/qt5/qmake
+
/home/dvdk/axel/sdk/xelk-3.0.1/sysroots/x86_64-pokysdk-linux/usr/bin/qt5/qmake
 
</pre>
 
</pre>
  
[[File:QtCreator-4.4.1_devices-linux-build-and-run-qmake.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 32.png|400px|border|center]]
  
 
=== Kits ===
 
=== Kits ===
  
The last step is to add a new kit. Go to <code>Kits</code> and click '''Add''' and complete the information as shown below. Pay attention that in <code>Qt mkspec</code> you need to write  
+
The last step is to add a new kit. Go to <code>Kits</code> and click '''Add''' and complete the information as showed below.
 +
 
 +
[[File:QtCreator XELK 3 0 0 33.png|400px|border|center]]
 +
 
 +
Pay attention that in <code>Qt mkspec</code> you should write  
  
 
<pre>
 
<pre>
Line 167: Line 149:
 
</pre>
 
</pre>
  
[[File:QtCreator-4.4.1_devices-linux-build-and-run-EVK.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 34.png|400px|border|center]]
  
After this your setup is complete and you can proceed and create your Qt applications.
+
After this your setup is complete and you can procede and create your Qt applications.
  
 
== Qt application example ==
 
== Qt application example ==
  
 
Now that the setup is finished, you can create your first application
 
Now that the setup is finished, you can create your first application
 
+
Open a new terminal and source the enviroment variables with the command.
Open a new terminal and source the environment variables with the command.
 
  
 
<pre>
 
<pre>
dvdk@vagrant:~/desk-mx-l$ source desk-mx6-l-1.0.0_env.sh
+
dvdk@vagrant-ubuntu-trusty-64:~$ ./env.sh
 
</pre>
 
</pre>
  
In the same terminal type the following command (we assume you didn't change the default installation directory)
+
In the same terminal digit the following command if you diden't change the installation directory.
  
 
<pre>
 
<pre>
dvdk@vagrant:~$ ./qtcreator-4.4.1/bin/qtcreator
+
dvdk@vagrant-ubuntu-trusty-64:~$ ./qtcreator-4.3.0/bin/qtcreator
 
</pre>
 
</pre>
  
{{ImportantMessage|text=It is important to repeat the previous two steps every time you start QTCreator}}
+
<span style="color:#ff0000"> It is important to repeat the previous two step each time you close the Qt Creator application </span>
  
 
Now click on <code>New Project</code>
 
Now click on <code>New Project</code>
  
[[File:QtCreator-4.4.1_project.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 11.png|400px|border|center]]
  
Select Application Qt Widgets Application and click '''Choose...'''
+
Select Application Qt Widgets Application and click Choose...
 +
[[File:QtCreator XELK 3 0 0 12.png|400px|border|center]]
  
[[File:QtCreator-4.4.1_new-project.png|800px|border|center]]
+
Now call the Project Test and pres Next.
  
Now call the Project ''Test'' and press '''Next'''.
+
[[File:QtCreator XELK 3 0 0 13.png|400px|border|center]]
  
[[File:QtCreator-4.4.1_new-project-test.png|800px|border|center]]
+
Select the XELK Kit and click '''Next'''.
  
Select the ''SBC AXEL EVK'' and click '''Next'''.
+
[[File:QtCreator XELK 3 0 0 14.png|400px|border|center]]
 
 
[[File:QtCreator-4.4.1_new-project-SBC-AXEL-EVK.png|800px|border|center]]
 
  
 
Choose the ''class'' name for your application.
 
Choose the ''class'' name for your application.
  
[[File:QtCreator-4.4.1_new-project-SBC-AXEL-EVK-class.png|800px|border|center]]
+
[[File:QtCreator XELK 3 0 0 15.png|400px|border|center]]
  
 
Click '''Finish''' to conclude the setup.
 
Click '''Finish''' to conclude the setup.
  
[[File:QtCreator-4.4.1_new-project-SBC-AXEL-EVK-finish.png|800px|border|center]]
+
[[File:QtCreator XELK 3 0 0 16.png|400px|border|center]]
  
To add a clickable button to your application, select  the <code>Edit</code> window and select <code>Test -> Forms -> mainwindow.ui</code>
+
To add a clickable button to your application, select  the <code>Edit</code> window and select <code>Test</code>-><code>Forms</code>-><code>mainwindow.ui</code>
  
[[File:QtCreator-4.4.1_project-Test-MainWindow.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 17.png|400px|border|center]]
  
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!"''.
+
Click on Push Button in the Buttons tab and drag it to the main widown view. In order to edit the text displayed by the label, dubble click it and write ''"Hello World!"''.
  
[[File:QtCreator-4.4.1_project-Test-MainWindow-Pushbutton.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 18.png|400px|border|center]]
  
After that, you need to insert the following two line inside the ''Test.pro'' file
+
After that, you need to insert the following line inside the ''Test.pro'' file
  
 
<pre>
 
<pre>
target.path = /home/root/Test # path on device
+
target.path = /tmp/Test # path on device
 
</pre>
 
</pre>
 
<pre>
 
<pre>
Line 230: Line 210:
 
</pre>
 
</pre>
  
Where <code>/home/root/Test</code> is the path in which your application will be downloaded inside the device.
+
Where <code>/temp/Test</code> is the path in which your application will be dowloaded inside the device.
 
   
 
   
[[File:QtCreator-4.4.1_project-Test-MainWindow-TestPro.png|1200px|border|center]]
+
[[File:QtCreator XELK 3 0 0 19.png|400px|border|center]]
  
Build the project in order to complete the configuration and set the overall vars:
+
The last step before running the application inside the device is to select the Project window select the Run configuration and as Arguments.
  
[[File:QtCreator-4.4.1_project-Test-MainWindow-Build.png|1200px|border|center]]
+
<pre>
 
+
-platform eglfs
The last step before running the application inside the device is to configure Qt backend into application command line arguments: open the <code>Project</code> window and select the <code>Run</code> configuration, then type <code>-platform eglfs</code> into <code>Arguments</code>
+
</pre>
 
 
[[File:QtCreator-4.4.1_project-Test-MainWindow-eglfs.png|1200px|border|center]]
 
 
 
After these changes you are ready to debug your application inside your board with the <code>Run/Debug</code> command [[File:QtCreator XELK 3 0 0 35.png|30px]]
 
 
 
[[File:QtCreator-4.4.1_project-Test-MainWindow-debug.png|1200px|border|center]]
 
  
The debugger (via <code>gdb server</code>) will be activated and the debug window will be ready:
+
[[File:QtCreator XELK 3 0 0 20.png|400px|border|center]]
  
[[File:QtCreator-4.4.1_project-Test-MainWindow-debug-running.png|1200px|border|center]]
+
After these changes you are ready to debug your application inside your board with the Run/Debug command[[File:QtCreator XELK 3 0 0 35.png|30px]]
 +
[[File:QtCreator XELK 3 0 0 21.png|400px|border|center]]

Revision as of 10:37, 22 February 2018

Setting up Qt Creator to build for XELK[edit | edit source]

Qt Creator Installation[edit | edit source]

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

dvdk@vagrant-ubuntu-trusty-64:~$ cd axel/
dvdk@vagrant-ubuntu-trusty-64:~/axel$ ./qt-creator-opensource.run

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

QtCreator XELK 3 0 0 01.png

Select Skip.

QtCreator XELK 3 0 0 02.png

Select Next.

QtCreator XELK 3 0 0 03.png

Select the install directory or click Next.

QtCreator XELK 3 0 0 04.png

Select Next.

QtCreator XELK 3 0 0 05.png

Click Next again.

QtCreator XELK 3 0 0 06.png

And then click Install and complete the installation.

QtCreator XELK 3 0 0 07.png

And then Finish to exit the setup wizard.

QtCreator XELK 3 0 0 08.png

Automatic configuration[edit | edit source]

Now it is necessary to add the definition of your board before developing and compiling your applications.

In order to add the device information automatically, run the following commands inside your terminal emulator.

dvdk@vagrant-ubuntu-trusty-64:~$ cd axel/
dvdk@vagrant-ubuntu-trusty-64:~/axel$ ./qt-post-install.sh

If the installation process went ok, you should see inside the Tools->Options -> Kits a kit named XELK.

QtCreator XELK 3 0 0 09.png

Select the Kits tab and make sure that your configurations mateches the one displayed.

QtCreator XELK 3 0 0 10.png

Manual configuration[edit | edit source]

Devices[edit | edit source]

Go to Tools->Options menu

QtCreator XELK 3 0 0 09.png

select Devices and click Add

QtCreator XELK 3 0 0 22.png

Choose the generic linux device

QtCreator XELK 3 0 0 23.png

Insert the ip address of your device and the username and password of the root account. Make sure that the device is connected to the network and your virtual machine is configured to use a bridge connection and click Next.

QtCreator XELK 3 0 0 24.png

If everithing went ok you should see a dialog like the next one

QtCreator XELK 3 0 0 25.png

And finally this is how the Devices window should look like

QtCreator XELK 3 0 0 26.png

GCC & Cross Compilation[edit | edit source]

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

QtCreator XELK 3 0 0 27.png

Click Add -> GCC and add the compiler path.

/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gcc

And click Apply.

QtCreator XELK 3 0 0 29.png

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

/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-g++
QtCreator XELK 3 0 0 28.png

Debugger GDB[edit | edit source]

Now it is necessary to add a debuger. In order to do this go to the Debuggers tab and click Add

QtCreator XELK 3 0 0 30.png

And then select the GDB debugger at the location

/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gdb

and click Apply.

QtCreator XELK 3 0 0 31.png

Qt Version[edit | edit source]

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

/home/dvdk/axel/sdk/xelk-3.0.1/sysroots/x86_64-pokysdk-linux/usr/bin/qt5/qmake
QtCreator XELK 3 0 0 32.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 showed below.

QtCreator XELK 3 0 0 33.png

Pay attention that in Qt mkspec you should write

linux-oe-g++
QtCreator XELK 3 0 0 34.png

After this your setup is complete and you can procede 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 enviroment variables with the command.

dvdk@vagrant-ubuntu-trusty-64:~$ ./env.sh

In the same terminal digit the following command if you diden't change the installation directory.

dvdk@vagrant-ubuntu-trusty-64:~$ ./qtcreator-4.3.0/bin/qtcreator

It is important to repeat the previous two step each time you close the Qt Creator application

Now click on New Project

QtCreator XELK 3 0 0 11.png

Select Application Qt Widgets Application and click Choose...

QtCreator XELK 3 0 0 12.png

Now call the Project Test and pres Next.

QtCreator XELK 3 0 0 13.png

Select the XELK Kit and click Next.

QtCreator XELK 3 0 0 14.png

Choose the class name for your application.

QtCreator XELK 3 0 0 15.png

Click Finish to conclude the setup.

QtCreator XELK 3 0 0 16.png

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

QtCreator XELK 3 0 0 17.png

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

QtCreator XELK 3 0 0 18.png

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

target.path = /tmp/Test # path on device
INSTALLS += target

Where /temp/Test is the path in which your application will be dowloaded inside the device.

QtCreator XELK 3 0 0 19.png

The last step before running the application inside the device is to select the Project window select the Run configuration and as Arguments.

-platform eglfs
QtCreator XELK 3 0 0 20.png

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

QtCreator XELK 3 0 0 21.png