Difference between revisions of "DIVELK-AN-002: Using Qt Creator"

From DAVE Developer's Wiki
Jump to: navigation, search
(History)
(Created page with "{{InfoBoxTop}} {{Applies To Yocto}} {{Applies To Diva}} {{InfoBoxBottom}} =History= {| class="wikitable" border="1" !Version !Date !XELK version !Notes |- |1.0.0 |March 2018...")
(17 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
{{Applies To Diva}}
 
{{Applies To Diva}}
 
{{InfoBoxBottom}}
 
{{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=
 
=History=
  
Line 9: Line 9:
 
!Version
 
!Version
 
!Date
 
!Date
!DIVELK version
+
!XELK version
 
!Notes
 
!Notes
 
|-
 
|-
|{{oldid|8080|4.0.0}}
+
|1.0.0
|April 2018
+
|March 2018
|[[Diva_Embedded_Linux_Kit_(DIVELK)#DIVELK_software_components|DIVELK 4.0.0]]
+
|[[Axel_Embedded_Linux_Kit_(XELK)#XELK_software_components|3.0.0]]
|
+
|First release
|-
 
|4.0.1
 
|March 2019
 
|[[Diva_Embedded_Linux_Kit_(DIVELK)#DIVELK_software_components#DIVELK_4.0.1|DIVELK 4.0.1]]
 
|
 
 
|}
 
|}
  
 
= Introduction =
 
= Introduction =
  
This application note details QT Creator setup and configuration in [[Diva_Embedded_Linux_Kit_(DIVELK)|DIVELK]] [[Managed Virtual Machine (MVM)|MVM]]
+
This application note details QT Creator setup and configuration in [[Axel_Embedded_Linux_Kit_(XELK)|XELK]] [[Managed Virtual Machine (MVM)|MVM]]
  
= Setting up Qt Creator to build for DIVELK =
+
= Setting up Qt Creator to build for XELK =
  
 
== Qt Creator Installation ==
 
== Qt Creator Installation ==
Line 34: Line 29:
  
 
<pre>
 
<pre>
dvdk@vagrant-ubuntu-trusty-64:~$ cd diva/
+
dvdk@vagrant-ubuntu-trusty-64:~$ cd axel/
 
</pre>
 
</pre>
  
 
<pre>
 
<pre>
dvdk@vagrant-ubuntu-trusty-64:~/diva$ ./qt-creator-opensource.run
+
dvdk@vagrant-ubuntu-trusty-64:~/axel$ ./qt-creator-opensource.run
 
</pre>
 
</pre>
  
An installation wizard will appear. Click '''Next''' to proceed with the installation.
+
An installation wizard will appear. Clik '''Next''' to proced with the installation.
[[File:DIVELK 4.0.1 - Qt Creator 01.jpg|center|frameless|438x438px]]
+
 
 +
[[File:QtCreator XELK 3 0 0 01.png|400px|border|center]]
 +
 
 
Select '''Skip'''.
 
Select '''Skip'''.
[[File:DIVELK 4.0.1 - Qt Creator 02.jpg|border|center|437x437px]]
+
 
 +
[[File:QtCreator XELK 3 0 0 02.png|400px|border|center]]
 +
 
 
Select '''Next'''.
 
Select '''Next'''.
[[File:DIVELK 4.0.1 - Qt Creator 03.jpg|border|center|437x437px]]
+
 
 +
[[File:QtCreator XELK 3 0 0 03.png|400px|border|center]]
 +
 
 
Select the install directory or click '''Next'''.
 
Select the install directory or click '''Next'''.
[[File:DIVELK 4.0.1 - Qt Creator 04.jpg|border|center|437x437px]]
+
 
 +
[[File:QtCreator XELK 3 0 0 04.png|400px|border|center]]
 +
 
 
Select '''Next'''.
 
Select '''Next'''.
[[File:DIVELK 4.0.1 - Qt Creator 05.jpg|border|center|437x437px]]
+
 
 +
[[File:QtCreator XELK 3 0 0 05.png|400px|border|center]]
 +
 
 
Click '''Next''' again.
 
Click '''Next''' again.
[[File:DIVELK 4.0.1 - Qt Creator 06.jpg|border|center|437x437px]]
+
 
 +
[[File:QtCreator XELK 3 0 0 06.png|400px|border|center]]
 +
 
 
And then click '''Install''' and complete the installation.
 
And then click '''Install''' and complete the installation.
[[File:DIVELK 4.0.1 - Qt Creator 07.jpg|border|center|436x436px]]
+
 
 +
[[File:QtCreator XELK 3 0 0 07.png|400px|border|center]]
 +
 
 
Then '''Finish''' to exit the setup wizard.
 
Then '''Finish''' to exit the setup wizard.
[[File:DIVELK 4.0.1 - Qt Creator 08.jpg|border|center|437x437px]]
+
 
 +
[[File:QtCreator XELK 3 0 0 08.png|400px|border|center]]
  
 
== Automatic configuration ==
 
== Automatic configuration ==
Line 63: Line 73:
  
 
In order to add the device information automatically, DAVE provides a simple setup script.
 
In order to add the device information automatically, DAVE provides a simple setup script.
 +
 +
TBD
  
 
<!--  
 
<!--  
Line 73: Line 85:
 
</pre>
 
</pre>
  
If the installation process complete successfully, you should see inside the <code>Tools -> Options -> Kits</code> a ''kit'' named DIVELK, as in the following screenshot:
+
If the installation process complete successfully, you should see inside the <code>Tools -> Options -> Kits</code> a ''kit'' named XELK, as in the following screenshot:
  
 
[[File:QtCreator XELK 3 0 0 09.png|400px|border|center]]
 
[[File:QtCreator XELK 3 0 0 09.png|400px|border|center]]
Line 85: Line 97:
 
== Manual configuration ==
 
== Manual configuration ==
  
If you don't want to use the automatic setup or want to customize the configuration, in this section we detail all the step required.
+
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.
=== Linaro Toolchain ===
 
You should be able to find the linaro toolchain already inside the virtual machine at ~/diva, if not the following will download and extract the toolchain.
 
 
 
Download the following [https://releases.linaro.org/components/toolchain/binaries/6.2-2016.11/arm-linux-gnueabihf/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf.tar.xz archive]
 
and extract it
 
 
 
<pre>
 
mkdir -p /home/dvdk/diva
 
tar -xvf gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf.tar.xz -C /home/dvdk/diva
 
</pre>
 
  
 
=== Devices ===
 
=== Devices ===
Line 111: Line 113:
 
[[File:QtCreator XELK 3 0 0 23.png|400px|border|center]]
 
[[File:QtCreator XELK 3 0 0 23.png|400px|border|center]]
  
Insert the IP address of your device, ''root'' as username and leave password empty (this is the default configuration of DIVELK 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).
+
Insert the IP address of your device, ''root'' as username and leave password empty (this is the default configuration of XELK 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).
  
 
Then click '''Next'''.
 
Then click '''Next'''.
Line 121: Line 123:
 
[[File:QtCreator XELK 3 0 0 25.png|400px|border|center]]
 
[[File:QtCreator XELK 3 0 0 25.png|400px|border|center]]
  
And finally, this is how the <code>Devices</code> window should look like.
+
And finally this is how the <code>Devices</code> window should look like.
  
 
[[File:QtCreator XELK 3 0 0 26.png|400px|border|center]]
 
[[File:QtCreator XELK 3 0 0 26.png|400px|border|center]]
Line 134: Line 136:
  
 
<pre>
 
<pre>
/home/dvdk/diva/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gcc
+
/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gcc
 
</pre>
 
</pre>
  
Line 144: Line 146:
  
 
<pre>
 
<pre>
/home/dvdk/diva/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-g++
+
/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-g++
 
</pre>
 
</pre>
  
Line 158: Line 160:
  
 
<pre>
 
<pre>
home/dvdk/diva/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gdb
+
/home/dvdk/axel/sdk/latest/sysroots/x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-gdb
 
</pre>
 
</pre>
  
Line 170: Line 172:
  
 
<pre>
 
<pre>
/home/dvdk/diva/sdk/divelk-4.0.0-qt5/sysroots/x86_64-aragosdk-linux/usr/bin/qt5/qmake
+
/home/dvdk/axel/sdk/xelk-3.0.1/sysroots/x86_64-pokysdk-linux/usr/bin/qt5/qmake
 
</pre>
 
</pre>
  
Line 193: Line 195:
 
== 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
  
In order to debug your application with  QtCreator, it is mandatory to utilize the linaro toolchain [[DIVELK-AN-002:_Using_Qt_Creator#Linaro_Toolchain|Toolchain]]
+
Open a new terminal and source the environment variables with the command.
. Furthermore, if the Weston compositor is active, the debug process is slow. For this reason it is higly recomanded to disable it with 
 
root@diva:~# /etc/init.d/weston stop
 
Now open a new terminal and source the environment variables with the command.
 
  
 
<pre>
 
<pre>
Line 207: Line 206:
  
 
<pre>
 
<pre>
dvdk@vagrant-ubuntu-trusty-64:~$ ./qtcreator-4.5.2/bin/qtcreator
+
dvdk@vagrant-ubuntu-trusty-64:~$ ./qtcreator-4.3.0/bin/qtcreator
 
</pre>
 
</pre>
  
Line 224: Line 223:
 
[[File:QtCreator XELK 3 0 0 13.png|400px|border|center]]
 
[[File:QtCreator XELK 3 0 0 13.png|400px|border|center]]
  
Select the ''DIVELK Kit'' and click '''Next'''.
+
Select the ''XELK Kit'' and click '''Next'''.
  
 
[[File:QtCreator XELK 3 0 0 14.png|400px|border|center]]
 
[[File:QtCreator XELK 3 0 0 14.png|400px|border|center]]
Line 244: Line 243:
 
[[File:QtCreator XELK 3 0 0 18.png|400px|border|center]]
 
[[File:QtCreator XELK 3 0 0 18.png|400px|border|center]]
  
After that, you need to insert the following two lines inside the ''Test.pro'' file
+
After that, you need to insert the following two line inside the ''Test.pro'' file
  
 
<pre>
 
<pre>

Revision as of 10:10, 2 May 2018

Info Box
Yocto-logo.png Applies to Yocto
Diva-am335x-overview.png Applies to Diva

History[edit | edit source]

Version Date XELK version Notes
1.0.0 March 2018 3.0.0 First release

Introduction[edit | edit source]

This application note details QT Creator setup and configuration in XELK MVM

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

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, DAVE provides a simple setup script.

TBD


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 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, root as username and leave password empty (this is the default configuration of XELK 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 XELK 3 0 0 24.png

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

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 for 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 debugger. 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 device. 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 shown below.

QtCreator XELK 3 0 0 33.png

Pay attention that in Qt mkspec you need to write

linux-oe-g++
QtCreator XELK 3 0 0 34.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-ubuntu-trusty-64:~/diva/sdk/divelk-4.0.0-qt5$ source environment-setup

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

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


200px-Emblem-important.svg.png

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

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 press 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 window view. In order to edit the text displayed by the label, double click it and write "Hello World!".

QtCreator XELK 3 0 0 18.png

After that, you need to insert the following two 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 downloaded inside the device.

QtCreator XELK 3 0 0 19.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 XELK 3 0 0 20.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 XELK 3 0 0 21.png