Open main menu

DAVE Developer's Wiki β

Changes

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

5,544 bytes added, 14:23, 26 August 2022
m
{{InfoBoxTop}}{{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]] = Installing 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 == To add this new install Qt Creator inside your toolchain to QTCreator, launch a terminal emulator and run it <pre>dvdk@vagrant:~$ cd desk-mx-l/</pre>
<pre>
dvdk@vagrant-ubuntu-trusty-64:~$ cd axel/dvdk@vagrantdesk-ubuntumx-trusty-64:~/axell$ ./qt-creator-opensource-linux-x86_64-4.4.1.run
</pre>
An installation wizard will appear
An installation wizard will appear. Clik '''Next''' to proced with the installation. [[File:QtCreator-4.4.1_setup.png|400px|border|center]] Select '''Skip'''. [[File:QtCreator-4.4.1_skip.png|400px|border|center]] Select '''Next'''. [[File:QtCreator-4.4.1_next.png|400px|border|center]] Select the install directory or click '''Next'''. [[File:QtCreator XELK 3 0 0 01-4.4.1_folder.png|400px|border|center]] Select '''Next'''. [[File:QtCreator-4.4.1_components.png|400px|border|center]] Click '''Next''' again. [[File:QtCreator-4.4.1_license.png|400px|border|center]] And then click '''Install''' and complete the installation. [[File:QtCreator-4.4.1_install.png|400px|border|center]] Then '''Finish''' to exit the setup wizard. [[File:QtCreator-4.4.1_finish.png|200px400px|leftborder|alt textcenter]]
Clik Next to proced the installation.== Manual configuration ==
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 === Go to <code>Tools -> Options</code> menu: [[File:QtCreator-4.4.1_tools-options.png|1000px|border|center]] Select <code>Devices</code> and click '''Add''': [[File:QtCreator XELK 3 0 0 02-4.4.1_devices-add.png|200px700px|leftborder|alt textcenter]] Choose the ''Generic Linux device'': [[File:QtCreator-4.4.1_devices-linux-device.png|500px|border|center]] 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). Then click '''Next''': [[File:QtCreator-4.4.1_devices-linux-device-EVK.png|600px|border|center]] The device will be created and the connectivity will be tested: [[File:QtCreator-4.4.1_devices-linux-device-EVK-connect.png|600px|border|center]] If everything went ok you should see a dialog like the image below. [[File:QtCreator-4.4.1_devices-linux-device-EVK-test.png|500px|border|center]] And finally, this is what the <code>Devices</code> window should look like. [[File:QtCreator-4.4.1_devices-linux-device-EVK-configured.png|800px|border|center]] === GCC & Cross Compilation === Next you need to configure the cross compilation tool inside <code>Build & Run -> Compiler</code>. [[File:QtCreator-4.4.1_devices-linux-build-and-run.png|800px|border|center]] Click <code>Add -> GCC</code> and add the compiler path.
Select Skip
[[File:QtCreator XELK 3 0 0 03.png|200px|left|alt text]]
Select Next
[[File:QtCreator XELK 3 0 0 04.png|200px|left|alt text]]
Select the install directory or click Next
[[File:QtCreator XELK 3 0 0 05.png|200px|left|alt text]]
Select Next
[[File:QtCreator XELK 3 0 0 06.png|200px|left|alt text]]
[[File:QtCreator XELK 3 0 0 07.png|200px|left|alt text]]
[[File:QtCreator XELK 3 0 0 08.png|200px|left|alt text]]
Now it is necessary to add the definition of your board before proceding developing your first application.
For adding the board definition run
<pre>
/home/dvdk@vagrant/desk-mx-l/sdk/latest_desk-mx6-ubuntul/sysroots/x86_64-trustypokysdk-64:~$ cd axellinux/usr/bin/dvdk@vagrantarm-ubuntupoky-trustylinux-64:~gnueabi/axel$ ./qtarm-poky-linux-postgnueabi-install.shgcc
</pre>
 
And click '''Apply'''.
 
[[File:QtCreator-4.4.1_devices-linux-build-and-run-gcc.png|1200px|border|center]]
 
Do the same for the C++ cross compilation tool.
 
<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++
</pre>
 
[[File:QtCreator-4.4.1_devices-linux-build-and-run-g++.png|1200px|border|center]]
 
=== 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
 
<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
</pre>
 
and click '''Apply'''.
 
[[File:QtCreator-4.4.1_devices-linux-build-and-run-gdb.png|1200px|border|center]]
 
=== 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.
 
<pre>
/home/dvdk/desk-mx-l/sdk/latest_desk-mx6-l/sysroots/x86_64-pokysdk-linux/usr/bin/qt5/qmake
</pre>
 
[[File:QtCreator-4.4.1_devices-linux-build-and-run-qmake.png|1200px|border|center]]
 
=== 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
 
<pre>
linux-oe-g++
</pre>
 
[[File:QtCreator-4.4.1_devices-linux-build-and-run-EVK.png|1200px|border|center]]
 
After this your setup is complete and you can proceed and create your Qt applications.
 
== Qt application example ==
 
Now that the setup is finished, you can create your first application
 Open a new terminal and source the enviroment environment variables with the command. 
<pre>
dvdk@vagrant:~/desk-mx-ubuntul$ source desk-trustymx6-64:~$ l-1.0./env0_env.sh
</pre>
 In the same terminal digit type the following command if (we assume you didendidn't change the default installation directory) <pre>dvdk@vagrant:~$ ./qtcreator-4.4.1/bin/qtcreator</pre> {{ImportantMessage|text=It is important to repeat the previous two steps every time you start QTCreator}} Now click on <code>New Project</code> [[File:QtCreator-4.4.1_project.png|1200px|border|center]] Select Application Qt Widgets Application and click '''Choose...''' [[File:QtCreator-4.4.1_new-project.png|800px|border|center]] Now call the Project ''Test'' and press '''Next'''. [[File:QtCreator-4.4.1_new-project-test.png|800px|border|center]] Select the ''SBC AXEL EVK'' and click '''Next'''. [[File:QtCreator-4.4.1_new-project-SBC-AXEL-EVK.png|800px|border|center]] Choose the ''class'' name for your application. [[File:QtCreator-4.4.1_new-project-SBC-AXEL-EVK-class.png|800px|border|center]] Click '''Finish''' to conclude the setup. [[File:QtCreator-4.4.1_new-project-SBC-AXEL-EVK-finish.png|800px|border|center]] To add a clickable button to your application, select the <code>Edit</code> window and select <code>Test -> Forms -> mainwindow.ui</code> [[File:QtCreator-4.4.1_project-Test-MainWindow.png|1200px|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!"''. [[File:QtCreator-4.4.1_project-Test-MainWindow-Pushbutton.png|1200px|border|center]] After that, you need to insert the following two line inside the ''Test.pro'' file 
<pre>
dvdk@vagrant-ubuntu-trusty-64:~$ target.path = /qtcreator-4.3.0home/binroot/qtcreatorTest # path on device
</pre>
If the installation process went ok you should see inside the Tools->Options menu a Kits named XELK[[File:QtCreator XELK 3 0 0 09.png|200px|left|alt text]]Select the Kits tab and make sure that your configurations mateches the one displayed [[File:QtCreator XELK 3 0 0 10.png|200px|left|alt text]]Close the tab and create a new project[[File:QtCreator XELK 3 0 0 11.png|200px|left|alt text]]Select Application Qt Widgets Application and click Choose...[[File:QtCreator XELK 3 0 0 12.png|200px|left|alt text]]Now call the name Test and pres Next[[File:QtCreator XELK 3 0 0 13.png|200px|left|alt text]]Select the XELK Kit and click Next[[File:QtCreator XELK 3 0 0 14.png|200px|left|alt text]]Choose the class name for your application[[File:QtCreator XELK 3 0 0 15.png|200px|left|alt text]]Click finish and conclude the setup[[File:QtCreator XELK 3 0 0 16.png|200px|left|alt text]]Now you will add a button to your application. In order to do this, select from the Edit window and select Test->Forms->mainwindow.ui[[File:QtCreator XELK 3 0 0 17.png|200px|left|alt text]]To add a Push Button 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 XELK 3 0 0 18.png|200px|left|alt text]]After that, you need to insert the following line inside the Test.pro file<propre>target.path = /tmp/Test # path on device
INSTALLS += target
</propre> Where <code>/temphome/root/Test </code> is the path in which your application will be dowloaded downloaded inside the device . [[File:QtCreator-4.4.1_project-Test-MainWindow-TestPro.png|1200px|border|center]] Build the project in order to complete the configuration and set the overall vars: [[File:QtCreator-4.4.1_project-Test-MainWindow-Build.png|1200px|border|center]] 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> [[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 1935.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-4.4.1_project-Test-MainWindow-debug-running.png|200px1200px|leftborder|alt textcenter]]
8,226
edits