Difference between revisions of "Getting Started With Qt Creator"

From wiki.emacinc.com
Jump to: navigation, search
Line 35: Line 35:
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*********************************************************************************************************/ -->
 
{{:Templateimpl:using | initials=BS | title=Getting Started with Qt Creator | desc=The following page can be used to get familiarized with EMAC Qt Creator. | project=OE 5.0 }}
 
{{:Templateimpl:using | initials=BS | title=Getting Started with Qt Creator | desc=The following page can be used to get familiarized with EMAC Qt Creator. | project=OE 5.0 }}
{{note|Until there is a working desktop icon to use, the user should still do steps 1 and 2 to run Qt Creator.}}
 
1. Change directory to ''/opt/emac/5.0/EMAC-Qt-Creator/bin'', enter the following command into terminal.
 
{{cli | cd /opt/emac/5.0/EMAC-Qt-Creator/bin | username=developer | hostname=ldc}}
 
  
2. To initiate the Qt Creator GUI as shown in Figure 1 below, run the application with the following command.
+
After installing EMAC SDK, launch the EMAC Qt Creator desktop icon.
{{cli | ./qtcreator | username=developer | hostname=ldc | pwd=home/user/opt/emac/5.0/EMAC-QtCreator/bin}}
 
  
[[File:qtcreator_gui.png|600px|left|thumb|Figure 1: Qt Splash Window]]
+
1. Press the Windows key and search for "Qt Creator EMAC"
 +
 
 +
2. Put the Qt Creator EMAC icon on the Launcher for easy access.
 +
 
 +
[[File:Qt_Creator_Icon.jpg|600px|left|thumb|Figure 1: Qt Launcher Icon]]
 
<br clear=all>
 
<br clear=all>
  
Line 72: Line 72:
 
<br clear=all
 
<br clear=all
  
>9. Once the Desktop Kit is configured, the hardware architecture kit needs to be installed. Navigate to "Add Kit" in the "Projects" tab. Under "Add Kit" select the architecture for the board being used. Click "EMAC OE 5.0 armv5te".   
+
>9. Once the Desktop Kit is configured, the hardware architecture kit needs to be installed. Navigate to "Add Kit" in the "Projects" tab. Under "Add Kit" select the architecture for the board being used. Click "EMAC OE 5.0 arm".   
 
{{note|The board being used will be the iPac-9x25. The iPac-9x25 is a 32-bit architecture armv5te. }}
 
{{note|The board being used will be the iPac-9x25. The iPac-9x25 is a 32-bit architecture armv5te. }}
  
[[File:Add_kit_armv5.png|600px|left|thumb|Figure 7: Qt Creator Add Kit]]
+
[[File:Add_kit_arm.jpg|600px|left|thumb|Figure 7: Qt Creator Add Kit]]
 
<br clear=all>
 
<br clear=all>
  
 
10. As previously stated in step 7 it will prompt you to the "CMake Wizard Build Location". Click "Next" to continue. Note: It is '''highly recommended''' to use the default build directory as stated below in Figure 8.
 
10. As previously stated in step 7 it will prompt you to the "CMake Wizard Build Location". Click "Next" to continue. Note: It is '''highly recommended''' to use the default build directory as stated below in Figure 8.
  
[[File:Build_location_arm5v.png|600px|left|thumb|Figure 8: Qt Creator Add Kit Build Location]]
+
[[File:Add_arm.png|600px|left|thumb|Figure 8: Qt Creator Add Kit Build Location]]
 
<br clear=all>
 
<br clear=all>
  
11. "CMake Wizard" will then prompt you to "Run CMake". For setting up the iPac-9x25 armv5 kit, click the box next to "Arguments". Copy and paste the string below:   
+
11. "CMake Wizard" will then prompt you to "Run CMake". For setting up the iPac-9x25 arm kit, click the box next to "Arguments". Copy and paste the string below:   
  ''-DARCH:STRING=armv5''
+
  ''-DARCH:STRING=arm''
  
[[File:Argument_string.png|600px|left|thumb|Figure 9: Qt Creator Argument String]]
+
[[File:Arm_argument_string.png|600px|left|thumb|Figure 9: Qt Creator Argument String]]
 
<br clear=all>
 
<br clear=all>
  
EMAC SDK provides three other architectural kits. If using one of these other architectures below, Copy and paste the argument string in the "Arguments" box.   
+
EMAC SDK provides another architectural kit for x86 hardware. If using an x86 architecture, copy and paste the argument string below in the "Arguments" box.   
  ''-DARCH:STRING=armv7''   
+
  ''-DARCH:STRING=x86''   
''-DARCH:STRING=core2'' 
 
''-DARCH:STRING=i586''
 
  
12. Once the arguments string is pasted in the box, click "Run CMake" and the output should be similar to Figure 10 below. Click "Finish" to add the armv5 kit to the current project.
+
12. Once the arguments string is pasted in the box, click "Run CMake" and the output should be similar to Figure 10 below. Click "Finish" to add the arm kit to the current project.
  
[[File:Run_cmake_arm5v.png|600px|left|thumb|Figure 10: Qt Creator Run CMake]]
+
[[File:Run_arm_cmake.png|600px|left|thumb|Figure 10: Qt Creator Run CMake]]
 
<br clear=all>
 
<br clear=all>
  
13. To confirm if the kits installed correctly, click on the "All" tab on the left hand side of the Qt Creator window as shown in Figure 11. Both "Desktop" and "EMAC OE 5.0 armv5te" kit will be present.
+
13. To confirm if the kits installed correctly, click on the "All" tab (Monitor symbol) on the left hand side of the Qt Creator window as shown in Figure 11. Both "Desktop" and "OE 5.0 arm" kit will be present.
  
[[File:Armv5_kit.png|600px|left|thumb|Figure 11: Qt Creator Kits Installed]]
+
[[File:Arm_kit.jpg|600px|left|thumb|Figure 11: Qt Creator Kits Installed]]
 
<br clear=all>
 
<br clear=all>
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*********************************************************************************************************/ -->

Revision as of 15:22, 23 February 2015

TODO: {{#todo: NotStarted (02.03.2015-10:42->BS+)|Brian Serrano|OE 5.0,BS}}

The following page describes the process of getting familiar with EMAC Qt Creator.

Background

Qt Creator is a cross-platform Open Source Integrated Development Environment (IDE) that can be used to develop software for many different languages. It includes a visual debugger and an integrated GUI layout and forms designer. See the Qt Project site for more information http://qt-project.org/wiki/Category:Tools::QtCreator.

General Information

Tools Required

  • EMAC OE SDK 5.0
  • EMAC Qt Creator
  • GNU make
  • cmake

Setup

  1. Make sure the system is configured for the correct target machine and that the IP and user/password are set.
  2. Launch EMAC Qt Creator.

Getting Started with Qt Creator

After installing EMAC SDK, launch the EMAC Qt Creator desktop icon.

1. Press the Windows key and search for "Qt Creator EMAC"

2. Put the Qt Creator EMAC icon on the Launcher for easy access.

Figure 1: Qt Launcher Icon


3. To generate a new project from Qt Creator, select "New Project" on the opening splash window. The examples being used are all written in C programming language.

4. After selecting "New Project" a new window will pop up. To run a C programming example using EMAC hardware, select "EMAC Project" under the Projects tab. Then select "EMAC C Project (CMake Build)". Click the "Choose" button on the bottom right of window to continue to the next page as shown in Figure 2.

Figure 2: Qt Creator EMAC Project


5. The next page will be "Introduction and Project Location". Select a name for the C project. Once the project name is given, choose a a directory to store the project. Note: It is highly recommended to store your project other than the default location. For this example, we used /home/developer/Projects.

Figure 3: Qt Creator Project Location


6. The next page summarizes the EMAC C Project. Click "Finish" to continue.

Figure 4: Qt Creator Project Summary


7. Next, it will prompt you to the "CMake Wizard Build Location". Click "Next" to continue. Note: It is highly recommended to use the default build directory as stated below in Figure 5.

Figure 5: Qt Creator Build Location


8. "CMake Wizard" will then prompt you to "Run CMake". For setting up the Desktop Kit, click "Run CMake" and the output should be similar to Figure 6 below. Click "Finish" to start new project.

Figure 6: Qt Creator Run CMake


9. Once the Desktop Kit is configured, the hardware architecture kit needs to be installed. Navigate to "Add Kit" in the "Projects" tab. Under "Add Kit" select the architecture for the board being used. Click "EMAC OE 5.0 arm".



NOTE
The board being used will be the iPac-9x25. The iPac-9x25 is a 32-bit architecture armv5te.


Figure 7: Qt Creator Add Kit


10. As previously stated in step 7 it will prompt you to the "CMake Wizard Build Location". Click "Next" to continue. Note: It is highly recommended to use the default build directory as stated below in Figure 8.

Figure 8: Qt Creator Add Kit Build Location


11. "CMake Wizard" will then prompt you to "Run CMake". For setting up the iPac-9x25 arm kit, click the box next to "Arguments". Copy and paste the string below:

-DARCH:STRING=arm
Figure 9: Qt Creator Argument String


EMAC SDK provides another architectural kit for x86 hardware. If using an x86 architecture, copy and paste the argument string below in the "Arguments" box.

-DARCH:STRING=x86  

12. Once the arguments string is pasted in the box, click "Run CMake" and the output should be similar to Figure 10 below. Click "Finish" to add the arm kit to the current project.

Figure 10: Qt Creator Run CMake


13. To confirm if the kits installed correctly, click on the "All" tab (Monitor symbol) on the left hand side of the Qt Creator window as shown in Figure 11. Both "Desktop" and "OE 5.0 arm" kit will be present.

Figure 11: Qt Creator Kits Installed


Examples

This section will show how to run C programming examples through the Qt Creator IDE. The example board will be the iPac-9x25.

The first example is a basic hello c example project.

1. After creating a new project and installing the necessary kits for the target board, navigate to the "Edit" tab on Qt Creator. Qt Creator will automatically have the hello c example uploaded as shown in Figure 12.

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char * argv[])
{
    printf("Hello EMAC OE!\n");
   
    exit(EXIT_SUCCESS);
}
Figure 12: Qt Creator Edit Window


2. Before executing the example, you must build the program first. Click on the build icon (hammer symbol) on the bottom left of the Qt Creator. If the build was successful, a green bar will fill on the bottom right of the Qt Creator.

3. Once the program successfully builds, you can now run the program. Click on the run icon (green arrow symbol) on the left hand side of Qt Creator. The program prints Hello EMAC OE! in the "Application Output" terminal.

Figure 13: Qt Creator Edit Window


The second example will show how to run a c programming project on a target board. This example will show all prime numbers from 1 - 100 and output it on Qt Creator remote terminal.

1. Create a new project and install the necessary kits for the target board just as shown before. Call this project Prime_Numbers . Then Navigate to the "Edit" tab on Qt Creator. Copy and paste the following code below to the Qt Creator terminal.

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char * argv[])
{ 
  int i;
  int j;

  for (i = 2; i <= 100; i++)
  {
    for (j = 2; j <= i; j++)
    {
      if (i%j==0)
      {
        break;
      }
    }
    if (i == j)
    {
      printf ("%d is a prime number. \n", i);
    }
  }
  return 0;
}
Figure 14: Qt Creator Edit Window


2. Click on the build icon (hammer symbol) on the bottom left of the Qt Creator. If the build was successful, a green bar will fill on the bottom right of the Qt Creator.

3. Click on the run icon (green arrow symbol) on the left hand side of Qt Creator. The program prints all prime numbers from 1 - 100 in the "Application Output" terminal.

Figure 14: Qt Creator Edit Window


Conclusion

This page is a quick getting started tutorial on how to use EMAC Qt Creator for the first time. It shows you how to create an EMAC C Project, set up the necessary kits for your target board, and how to build and run example projects.

Further Information

Where to Go Next
  • TBD
Pages with Related Content
  • TBD