Phytec PhyBOARD-WEGA-AM335 SERIES User manual

PhyBOARD-WEGA-AM335x
Single Board Compu er
QT Manual
Product No : PCL-051/PBA-CD-02
SOM PCB No : 1397.0
CB PCB No : 1405.0
Edition : May, 2014
© PHYTEC Embedded Pvt. Ltd 2014 1 Revision no. 1.0

In this manual cop righted products are not explicitl indicated. The absence of the trademark (™)
and cop right (©) s mbols does not impl that a product is not protected. Additionall , registered
patents and trademarks are similarl not expressl indicated in this manual.
The information in this document has been carefull checked and is believed to be entirel reliable.
However, PHYTEC Embedded Pvt. Ltd. assumes no responsibilit for an inaccuracies. PHYTEC
Embedded Pvt. Ltd neither gives an guarantee nor accepts an liabilit whatsoever for
consequential damages resulting from the use of this manual or its associated product. PHYTEC
Embedded Pvt. Ltd reserves the right to alter the information contained here in without prior
notification and accepts no responsibilit for an damages that might result.
Additionall , PHYTEC Embedded Pvt. Ltd offers no guarantee nor accepts an liabilit for
damages arising from the improper usage or improper installation of the hardware or software.
PHYTEC Embedded Pvt. Ltd further reserves the right to alter the la out and/or design of the
hardware without prior notification and accepts no liabilit for doing so.
© Cop right 2014 PHYTEC Embedded Pvt. Ltd, Koramangala, Bangalore, India.
Rights - including those of translation, reprint, broadcast, photomechanical or similar reproduction
and storage or processing in computer s stems, in whole or in part - are reserved. No reproduction
ma be made without the explicit written consent from PHYTEC Embedded Pvt. Ltd.
India Europe North America
Address: PHYTEC Embedded
Pvt. Ltd.
#16/9C, 3rd Floor, 3rd
Main, Opp. Police
Station Koramangala,
8thblock, Bangalore
-560095
India
PHYTEC Technologie
Holding AG
Robert-Koch-Str. 39
55129 Mainz
GERMANY
PHYTEC America LLC
203 Parfitt Wa SW,
Suite G100 Bainbridge
Island, WA 98110 USA
Ordering Information: [phone]
Sales@ph tec.in
[phone]
order@ph tec.de
1 [phone]
sales@ph tec.com
Web Site: http://www.ph tec.in http://www.ph tec.de http://www.ph tec.com
© PHYTEC Embedded Pvt. Ltd 2014 2 Revision no. 1.0

Table of Content
.............................................................................................................................................................4
1. Application development usin Qt Creator:.....................................................................................4
2. QT Creator Confi uration for phyBOARD-WEGA-AM335x.........................................................8
3. Application development................................................................................................................19
© PHYTEC Embedded Pvt. Ltd 2014 3 Revision no. 1.0

QT Application Development for phyBOARD-WEGA-AM335x:
In this Manual, we are going to describe how to use Qt application for development.
1. First chapter – Deals with the installation of Qt Creator.
2. Second chapter – Explains how to configure QT creator for cross compilation.
3. Third chapter – Describes how to write an application using Qt Creator and
4. Fourth chapter – Describes Qt Creator with UART Demo application.
1. Application development u ing Qt Creator:
With the help of example projects, we will teach ou how to work with Qt.
Explain how to run Qt application on target (ARM architecture), in Linux (Ubuntu) environment.
1.1. Qt Creator In tallation
Qt in linux
First of all install Qt Creator with the help of Ubuntu Software Center
Enter Qt Creator in the search box in the right top corner (in Ubuntu Software Center).
Install it (see the below image)
Figure 1.1
© PHYTEC Embedded Pvt. Ltd 2014 4 Revision no. 1.0

1.2. Network Setting (Ho t and Target)
In Hos :
Click on Dash Home and enter as Network Connections and click.
Fi ure 1.2.1
Here click on Add label and give a connection name as shown below.
Fi ure 1.2.2
© PHYTEC Embedded Pvt. Ltd 2014 5 Revision no. 1.0

Here ou need to select Method as Manual and click Add label again do ip settings then Save as
shown below.
Figure 1.2.3
Then finall ou will get successfull as below if our Connection Established correctl .
Figure 1.2.4
© PHYTEC Embedded Pvt. Ltd 2014 6 Revision no. 1.0

In Target :
Do the ip settings in our target as shown below figures.
Figure 1.2.5
Now set ip usig ifconfig eth0 192.168.1.196 up shown in below figure
Figure 1.2.6
© PHYTEC Embedded Pvt. Ltd 2014 7 Revision no. 1.0

Figure 1.2.7
2. QT Creator Configuration for phyBOARD-WEGA-AM335x
2.1. Configuring QT Creator for Cro Compilation
Now let’s setup QT creator to configure qmake. From the QT creator main menu shown below:
Select the following:
Tool -> Option ...
On the left side vertical menubar click Build & Run
Click the Qt Ver ion tab under Build & Run
Remove an versions that ma alread exist to make sure ou start with a clean configuration
Click Add... on the right
Note: Here navi ate to the path of qmake in our PC (refer section 2.3.2).
Select qmake then click on Open
Double click on Ver ion Name and give the Qt Version a descriptive name in below image .
© PHYTEC Embedded Pvt. Ltd 2014 8 Revision no. 1.0

Figure 2.1.1
Export the Tool chain Path (refer 2.2.3)
Click the Tool Chain tab under Build & Run
Click Add in the top right and add a GCC
For Compiler Path select Browse
Navigate to /home/<u er>/work/phytec/ rc/arm-cortexa8-linux-gnueabihf/bin
Note: Here navigate to the path where you have exported the tool chain
Select Compiler Path: Click on Browse and select path of compiler
/home/<u er>/work/phytec/ rc/arm-cortexa8-linux-gnueabihf/bin/arm-cortexa8-linux-
gnueabihf-gcc.
Debugger: Click on Browse & select path of Debugger home/<u er>/work/phytec/ rc/arm-
cortexa8-linux-gnueabihf/bin/arm-cortexa8-linux-gnueabihf-gdb, as shown below.
© PHYTEC Embedded Pvt. Ltd 2014 9 Revision no. 1.0

Figure 2.1.2
Now let’s setup our Target. While still in the Tool -> Option menu
On the left side of the window, select the Linux Device tab
Figure 2.1.3
In Linux Devices: click the Device Configuration tab.
Click Add... in the top right and select Generic Linux device and click on Start Wizard
© PHYTEC Embedded Pvt. Ltd 2014 10 Revision no. 1.0

Figure 2.1.4
The Device Configuration Wizard Selection Dialog box comes up,
Change the name Generic Linux Device to give the device a unique name: AM335x,
T pe in the IP address Box as – 192.168.1.196 (For our target),
In the Box - The U ername to log into device, write entr as root,
Make sure Authentication t pe is Password, but leave the pa word field blank.
Click next and click Fini h
Figure 2.1.5
Now ou should see Device test finished successfull , so ou can close the window
© PHYTEC Embedded Pvt. Ltd 2014 11 Revision no. 1.0

.
Figure 2.1.6
Now we need to setup an SSH ke so that the host can communicate with the target
Still under the Device Configurations tab click "Generate SSH Ke ...”
Select Key ize: 1024
Key algorithm RSA
Then click Generate SSH Key in the SSH Ke Configuration dialog box
Figure 2.1.7
Click Do not Encrypt key file
© PHYTEC Embedded Pvt. Ltd 2014 12 Revision no. 1.0

Figure 2.1.8
Then click Save Public Key...
Figure 2.1.9
Just use the default name id_rsa.pub and Click Save and Click Clo e to close the Generate SSH
Ke window.
© PHYTEC Embedded Pvt. Ltd 2014 13 Revision no. 1.0

Figure 2.1.10
Under the Device Configurations tab now click Deploy Public Key...
Figurer 2.1.11
Select the file just generated (should be under /home/<user>/.ssh)
IMPORTANT : You ma need to right click and select how hidden file or Ctrl+h
© PHYTEC Embedded Pvt. Ltd 2014 14 Revision no. 1.0

Figure 2.1.12
Select the file id_r a.pub and click on Open, shortl a window should show up sa ing
"Sucessfull "
Figure 2.1.13
© PHYTEC Embedded Pvt. Ltd 2014 15 Revision no. 1.0

Figure 2.1.14
Close the window and Click OK to exit the Linux Devices Window.
2.2. Target Setup
Ho t Setup - First open the terminal (ALT+CTRL+T).
2.2.1. Toolchain In tallation:
This section explains how to Install prebuilt toolchain binaries on the Host. Where as, building
of Toolchain is explained in build s stem section.
2.2.2. Downloading the Toolchain:
Download the toolchain from the public ftp of PHYTEC from the link below.
ftp://ftp.ph tec.de/pub/Products/India/ph BOARD-WEGA-
AM335x/Linux/PD14.0.0/tools/toolchain/arm-cortexa8-linux-gnueabihf.tar.bz2
2.2.3. Export the Toolchain to Shell Path:
Extract the toolchain that has downloaded, from terminal issue the following commands:
$ mkdir ~/work
$ cp arm-cortex8-linux-gnueabihf.tar.bz2 ~/work
$ cd ~/work
$ tar –xvf arm-cortex8-linux-gnueabihf.tar.bz2
Now write a script that export the target Architecture and toolchain prefix as below.
$ vim env.sh
#!/bin/sh
export PATH=$PATH:/home/<user>/<path to toolchain bin>
export ARCH=arm
export CROSS_COMPILE=arm-cortexa8-linux-gnueabihf-
Save and exit from the editor. Execute the script b issuing
$ . env.sh
© PHYTEC Embedded Pvt. Ltd 2014 16 Revision no. 1.0

Note: The command is “dot space env.sh”. Execute the above command for shell where ou are
tr ing to start compilation of Qt.
Check whether the toolchain path is set or not b issuing
$ echo $PATH
Above command displa s the entire paths that are added to Shell PATH variable separated b
colon ‘:’. See if our path is printed on the terminal. If ou are not able to see our toolchain path
repeat the steps from the beginning of this section.
2.3. Building qmake u ing QT:
Me hod:1
Download QT version from the following link
http://download.qt-project.org/official_releases/qt/4.8/4.8.5/qt-ever where-opensource-src-
4.8.5.tar.gz
Compile the qt-ever where-opensource-src-4.8.5 source file
$ cp qt-ever where-opensource-src-4.8.5.tar.gz ~/work
$ cd ~/work
$ tar -xvf qt-ever where-opensource-src-4.8.5.tar.gz
$ cd qt-ever where-opensource-src-4.8.5
$ vim mkspecs/qws/linux-arm-gnueabi-g++/qmake.conf
change arm-none-linux-gnueabi to arm-cortexa8-linux-gnueabihf
save and exit
Execute the following configuration command
$./configure -opensource -confirm-license -release -rpath -no-fast -no-sql-ibase -no-sql-m sql -no-
sql-odbc -no-sql-psql -no-sql-sqlite2 -no-qt3support -no-mmx -no-3dnow -no-sse -no-sse2 -no-
sse3 -no-ssse3 -no-sse4.1 -no-sse4.2 -no-avx -no-optimized-qmake -no-nis -no-cups -no-pch-
reduce-relocations -force-pkg-config -prefix /opt/qt-cross -no-armfpa -make libs -nomake docs-ittle-
endian -embedded arm -qt-decoration-st led -depths all -xplatform qws/linux-arm-gnueabi-g++
$ make
$ sudo make install
check the binar file in /opt/qt-cross
$ ls /opt/qt-cross/bin
Method-2:
use prebuilt qt-cross provided b Ph tec
$ sudo cp qt-cross-hf.tar.bz2 /opt
$ cp /opt
$ sudo tar -xvf qt-cross-hf.tar.bz2
$ ls /opt/qt-cross/bin
Completed , Now use the qmake path for cross-compiling ou application in QT-Creator.
© PHYTEC Embedded Pvt. Ltd 2014 17 Revision no. 1.0

2.4. Setting Serial Con ole (Minicom)
$ sudo minicom -s
Select the option serial port setup from menu on terminal and press 'Enter'
Figure 2.4.1
Using the options at left; make the setting as shown in the figure 2.4.2
For ex: Serial device – dev/tt S0, first press ‘A’ the cursor blinks at the particular line then
change the device name to /dev/ttyS0 and press ‘ENTER’.
Figure 2.4.2
After making all changes like baud rate - 115200, hardware flow control - No etc., press
‘ENTER’ to come out from the screen.Now, select the ‘Save setup as dfl’ it saves the setting as
default. Have a look at the Screenshot below:
Figure 2.4.3
© PHYTEC Embedded Pvt. Ltd 2014 18 Revision no. 1.0

Now select ‘Exit’ a below:
Figure 2.4.4
Now minicom terminal is read to be used.
3. Application development
3.1. Simple Demo Application:
Open a New Project
Under Form , double click on phytec.ui - this will bring up the widget editor.
Figure 3.1.1
Find the label widget in the categor of display widgets, left click and drag it on to the U er
Interface (UI).
© PHYTEC Embedded Pvt. Ltd 2014 19 Revision no. 1.0

Figure 3.1.2
T pe an name such as “Ph tecIndia” into the label widget and stretch out the borders so ou can
see all the letters
Figure 3.1.3
File->Save phytec.ui
Now we need to check and update the build and run settings:
On the left side vertical menubar select Project
Select the Build Setting tab and select ''Qt 4.8.5( y root-cro ) Relea e'' in Edit build
configuration.
© PHYTEC Embedded Pvt. Ltd 2014 20 Revision no. 1.0