KrzysztofChojnowski at 19:31, 22 December 2019

2019-12-22T19:31:02Z

← Older revision		Revision as of 19:31, 22 December 2019
Line 25:		Line 25:
	== Configuring the host system ==		== Configuring the host system ==

	First of all we need to install some packages required for the QT library compilation:		First of all we need to install some packages required for the Qt library compilation:

	<pre>		<pre>

KrzysztofChojnowski at 19:24, 22 December 2019

2019-12-22T19:24:29Z

← Older revision		Revision as of 19:24, 22 December 2019
Line 29:		Line 29:
	<pre>		<pre>
	sudo apt-get install make gcc g++ git pkg-config rsync python		sudo apt-get install make gcc g++ git pkg-config rsync python
			</pre>

			and add a i386 architecture:

			<pre>
			sudo dpkg --add-architecture i386
			sudo apt-get update
			sudo apt-get upgrade
	</pre>		</pre>

KrzysztofChojnowski at 19:03, 22 December 2019

2019-12-22T19:03:43Z

← Older revision		Revision as of 19:03, 22 December 2019
Line 25:		Line 25:
	== Configuring the host system ==		== Configuring the host system ==

	First of all we need to generate a sysroot - a directory containing all required libraries from the target system. We will be using it during the project compilation. This step requires the network access to the VisionSOM-6ULL target. The IP address in the example as well as the user name need to be changed according to the current configuration.		First of all we need to install some packages required for the QT library compilation:

			<pre>
			sudo apt-get install make gcc g++ git pkg-config rsync python
			</pre>

			Next we need to generate a sysroot - a directory containing all required libraries from the target system. We will be using it during the project compilation. This step requires the network access to the VisionSOM-6ULL target. The IP address in the example as well as the user name need to be changed according to the current configuration.

	<pre>mkdir sysroot sysroot/usr sysroot/opt		<pre>mkdir sysroot sysroot/usr sysroot/opt

KrzysztofChojnowski at 22:30, 21 December 2019

2019-12-21T22:30:05Z

← Older revision		Revision as of 22:30, 21 December 2019
Line 38:		Line 38:
	./sysroot-relativelinks.py sysroot</pre>		./sysroot-relativelinks.py sysroot</pre>

	The sysroot is ready, so we can build the Qt library. The version used in the tutorial is 5.13 but may be changed if needed. First let's download the Qt sources from the repository:		The sysroot is ready, so we can build the Qt library. The version used in the tutorial is 5.12 but may be changed if needed. First let's download the Qt sources from the repository:
	<pre>git clone git://code.qt.io/qt/qtbase.git -b 5.13</pre>		<pre>git clone git://code.qt.io/qt/qtbase.git -b 5.12</pre>

	and the toolchain (we will use the one provided by Linaro):		and the toolchain (we will use the one provided by Linaro):

KrzysztofChojnowski at 12:29, 21 November 2019

2019-11-21T12:29:01Z

← Older revision		Revision as of 12:29, 21 November 2019
Line 70:		Line 70:
	<pre>rsync -avz <LIB_INSTALLATION_PATH> som@10.71.161.96:/usr/local</pre>		<pre>rsync -avz <LIB_INSTALLATION_PATH> som@10.71.161.96:/usr/local</pre>

	== Configuring QT creator ==		== Configuring Qt creator ==

	Now, we can configure the programming environment for the Qt applications. We will use the Qt Creator IDE - the official tool for the Qt framework. It can be installed on the host system from the distribution package:		Now, we can configure the programming environment for the Qt applications. We will use the Qt Creator IDE - the official tool for the Qt framework. It can be installed on the host system from the distribution package:

KrzysztofChojnowski: Created page with "{{PageHeader|Building simple QT application}} toc This article explains how to configure tools and build a simple example for VisionSOM-6ULL target using the Qt library...."

2019-11-21T12:28:29Z

Created page with "{{PageHeader|Building simple QT application}} __toc__ This article explains how to configure tools and build a simple example for VisionSOM-6ULL target using the Qt library...."

New page

{{PageHeader|Building simple QT application}} __toc__

This article explains how to configure tools and build a simple example for VisionSOM-6ULL target using the Qt library. The target user name in this article is som - change it according to your target system configuration.

The whole tutorial was prepared for the PC with Ubuntu 18.04 as the host system and Debian 10 Buster target system.

== Configuring the VisionSOM-6ULL target ==

First we need to configure the target and install all required libraries. The target rootfs needs also to be resized to at least 2 GB, as it is described in the article: [[Extending rootfs partition]]

Edit ''/etc/apt/sources.list'' and add a line:
<pre>deb-src http://deb.debian.org/debian buster main</pre>

Update available software list and install the following packages:
<pre>apt-get update
apt-get build-dep qt4-x11
apt-get build-dep libqt5gui5
apt-get install libudev-dev libinput-dev libts-dev libxcb-xinerama0-dev libxcb-xinerama0</pre>

Create the following directory - we will use it to install the Qt library. It needs to be accessible by the user that has the SSH access to target system.

<pre>mkdir /usr/local/qt5som
chown som:som /usr/local/qt5som</pre>

== Configuring the host system ==

First of all we need to generate a sysroot - a directory containing all required libraries from the target system. We will be using it during the project compilation. This step requires the network access to the VisionSOM-6ULL target. The IP address in the example as well as the user name need to be changed according to the current configuration.

<pre>mkdir sysroot sysroot/usr sysroot/opt
rsync -avz som@10.71.161.96:/lib sysroot
rsync -avz som@10.71.161.96:/usr/include sysroot/usr
rsync -avz som@10.71.161.96:/usr/lib sysroot/usr</pre>

After downloading the files from the target we need to fix the links by changing them from absolute to relative paths. We can use the following script:

<pre>wget https://raw.githubusercontent.com/Kukkimonsuta/rpi-buildqt/master/scripts/utils/sysroot-relativelinks.py
chmod +x sysroot-relativelinks.py
./sysroot-relativelinks.py sysroot</pre>

The sysroot is ready, so we can build the Qt library. The version used in the tutorial is 5.13 but may be changed if needed. First let's download the Qt sources from the repository:
<pre>git clone git://code.qt.io/qt/qtbase.git -b 5.13</pre>

and the toolchain (we will use the one provided by Linaro):

<pre>wget https://releases.linaro.org/components/toolchain/binaries/7.4-2019.02/arm-linux-gnueabihf/gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabihf.tar.xz
tar -xf gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabihf.tar.xz</pre>

Now we can configure and build the library. The configure script requires a few arguments explained below:
*-device linux-imx6-g++ cross compile for iMX6 target platform
*-release turn off debugging
*-opengl es2 enable OpenGL ES2 API
*-device-option CROSS_COMPILE=<PATH_TO_THE_TOOLCHAIN>/gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf- path to the downloaded Linaro toolchain
*-sysroot <PATH_TO_THE_SYSROOT>/sysroot path to the sysroot built in the previous step
*-opensource we will use the opensource lince
*-confirm-license automatically confirm all licenses
*-make libs build only libraries without examples
*-prefix /usr/local/qt5som library path prefix on the target
*-extprefix <LIB_INSTALLATION_PATH> path on the host machine to install the built libraries
*-hostprefix <HOST_INSTALLATION_PATH> path on the host machine to install the libraties and tools used by the host
*-v print additional messages during compilation

All paths in the brackets <> need to be set according to the local environment configuration. The complete configure and make commands look like this:

<pre>cd qtbase
./configure -release -opengl es2 -device linux-imx6-g++ -device-option CROSS_COMPILE=<PATH_TO_THE_TOOLCHAIN>/gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf- -sysroot <PATH_TO_THE_SYSROOT>/sysroot -opensource -confirm-license -make libs -prefix /usr/local/qt5som -extprefix <LIB_INSTALLATION_PATH> -hostprefix <HOST_INSTALLATION_PATH> -v
make -j4
make install</pre>

After the libraries compilation and installation, we can upload the built libraries to the VisionSOM-6ULL target:
<pre>rsync -avz <LIB_INSTALLATION_PATH> som@10.71.161.96:/usr/local</pre>

== Configuring QT creator ==

Now, we can configure the programming environment for the Qt applications. We will use the Qt Creator IDE - the official tool for the Qt framework. It can be installed on the host system from the distribution package:

<pre>sudo apt-get install qtcreator</pre>

This tutorial is based on the Qt Creator 4.5.2.

After running the IDE we need to configure our device and toolchain. Let's open the ''Device'' options by selecting the ''Tools->Options'' menu and add a new ''Generic Linux Device'':
[[File:qt_intro_6ull_1.png|center|700px]]
[[File:qt_intro_6ull_2.png|center|300px]]

In the wizard window we need to specify the device name, the IP address, username and password in order to allow Qt Creator the SSH access to our target system:
[[File:qt_intro_6ull_3.png|center|700px]]

Our configuration will be automatically verified after we finish the setup:

[[File:qt_intro_6ull_4.png|center|400px]]

Our device is ready, so let's move on to the toolchain configuration in the ''Tools->Options Build&Run'' menu. First, in the Qt Versions tab, we need to add the Qt version that we have just built - the location of qmake tool (''<HOST_INSTALLATION_PATH>/bin/qmake''):

[[File:qt_intro_6ull_5.png|center|700px]]

Next is the compiler (C and C++) in the ''Compilers'' tab - we need to specify the same path as in the Qt configuration parameters: ''<PATH_TO_THE_TOOLCHAIN>/gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gcc and <PATH_TO_THE_TOOLCHAIN>/gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-g++''. We also need to set the ABI (''arm-linux-generic-elf-32bit'') and any name that will help us to recognize it later:

[[File:qt_intro_6ull_6.png|center|700px]]
[[File:qt_intro_6ull_7.png|center|700px]]

It is not required but we may also need to configure the GDB in the ''Debuggers'' tab. It has the same path as the compilers from the previous step:

[[File:qt_intro_6ull_8.png|center|700px]]

Finally, we are ready to configure a new Kit for our device. Let's add it in the ''Kits'' tab, assign a name, device and its type, sysroot directory (''<PATH_TO_THE_SYSROOT>/sysroot''), compilers, debugger and Qt version:

[[File:qt_intro_6ull_9.png|center|700px]]

== Simple Qt application ==

We are now ready to build the application for our device. Let's create a new Qt Widgets application project (''File->New File or Project''):

[[File:qt_intro_6ull_10.png|center|700px]]

The project generator will create a new ''MainWindow'' class, ''main.cpp'' and a ''*.pro file'' (''QtExample.pro'' in this case). The last one contains the project configuration and we need to modify it in order to add the paths with the libraries required for compilation by adding ''QMAKE_RPATHDIR'' variable:

<pre>QMAKE_RPATHDIR += $$[QT_SYSROOT]/usr/lib/arm-linux-gnueabihf $$[QT_SYSROOT]/lib/arm-linux-gnueabihf</pre>

We can now open the ''Forms/mainwindow.ui'' file in the GUI designer. This tool will help us to build the graphical interface. In this example we will simply add a text label in the middle of the window:
[[File:qt_intro_6ull_11.png|center|800px]]

Now we are ready to compile our project by clicking the build button. In case of multiple kits we can select them also i the bottom left corner of the screen:

[[File:qt_intro_6ull_12.png|center|300px]]

We can now run the application on the VisionSOM-6ULL target. We can simply copy it from the build directory specified during project creation using SCP:
<pre>scp build-QtExample-VisionSOM_6ULL-Release/QtExample som@10.71.161.106:Desktop/</pre>
[[File:qt_intro_6ull_13.png|center|600px]]