XELK-AN-004: Getting Started With QT Creator
|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[edit | edit source]
|1.0.0||March 2018||XELK 3.0.0||First release|
|1.0.0||August 2019||XELK 4.0.0||Updated XELK version|
Introduction[edit | edit source]
Setting up Qt Creator to build for XELK[edit | edit source]
|Note: The version of Qt Creator may differ from images below. The version provided from XELK 4.0.0 release is 4.5.2|
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/
An installation wizard will appear. Clik Next to proced with the installation.
Select the install directory or click Next.
Click Next again.
And then click Install and complete the installation.
Then Finish to exit the setup wizard.
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]
Tools -> Options menu
Devices and click Add
Choose the Generic Linux device
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.
If everything went ok you should see a dialog like the image below.
And finally this is how the
Devices window should look like.
GCC & Cross Compilation[edit | edit source]
Next you need to configure the cross compilation tool inside
Build & Run -> Compiler.
Add -> GCC and add the compiler path.
And click Apply.
Do the same for the C++ cross compilation tool.
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
and click Apply.
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.
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
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:~$ source env.sh
In the same terminal type the following command (we assume you didn't change the default installation directory)
|It is important to repeat the previous two step every time you start QTCreator|
Now click on
Select Application Qt Widgets Application and click Choose...
Now call the Project Test and press Next.
Select the XELK Kit and click Next.
Choose the class name for your application.
Click Finish to conclude the setup.
To add a clickable button to your application, select the
Edit window and select
Test -> Forms -> mainwindow.ui
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!".
After that, you need to insert the following two line inside the Test.pro file
target.path = /tmp/Test # path on device
INSTALLS += target
/temp/Test is the path in which your application will be downloaded inside the device.
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