Getting Started With Qt Creator

TODO: {{#todo: Complete (02.03.2015-10:42->BS+);(06.18.2015-14:25->BS+);(06.18.2015-15:48->KY+);(11.16.2015-11:35->MD+);(11.16.2015-12:15->MG+);(11.16.2015-12:20->KY+)|Brian Serrano|OE 5.0,BS,KY,MD,MG,Complete}}

The following page demonstrates the process of getting familiar with EMAC Qt Creator and running it on the target machine.

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.

For more information visit the Qt Project site http://qt-project.org/wiki/Category:Tools::QtCreator.

General Information

Tools Required

• EMAC OE 5.X SDK
• EMAC Qt Creator
• GNU make
• CMake

Setup

1. Make sure the system has the EMAC OE 5.X SDK and tools installed.
2. Launch EMAC Qt Creator.

Getting Started with Qt Creator

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

1. Press the Start key or Alt + F2 and search for Qt Creator EMAC

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

Figure 1: Qt Creator 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 the C programming language.

Figure 2: Qt Creator GUI

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 the window to continue to the next page as shown in Figure 3.

Figure 3: 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 directory to store the project. Note: It is highly recommended to store your project somewhere other than the default location. For this example, we used /home/developer/Projects.

Figure 4: Qt Creator Project Location

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

Figure 5: Qt Creator Project Summary

7. Next, it will prompt you to enter 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 6.

Figure 6: Qt Creator Build Location

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

Figure 7: Qt Creator Run CMake

9. The next step is to set up the device you will be using for the Qt Creator examples. Click Tools -> Options

NOTE

The board used for this example is the iPac-9x25. The iPac-9x25 is a 32-bit ARM architecture. Make sure to connect power, Ethernet, and serial to the board.

10. Select Devices from the left pane.

Figure 8: Qt Creator Device Option

11. Click the Add button

12. Select Generic Linux Device, then click Start Wizard.

Figure 9: Qt Creator Wizard Selection

13. Type in a name, the IP address, the user name, and the password for the device. Use the credentials below to sign in.

Table 4: Default Login Credentials
Username	Password
root	emac_inc

Figure 10: Qt Creator Configuration Setup

14. Click Next.

15. Click Finish.

16. A connection will be established with the target device.

Figure 11: Qt Creator Device Test

17. Click Close.

18. Click Apply.

19. Navigate to Add Kit in the Projects tab. Under Add Kit, select the architecture for the board being used. Click EMAC OE 5.X arm.

Figure 12: Qt Creator Add Kit

20. As previously stated in step 7, it will prompt you to enter 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 13.

Figure 13: Qt Creator Add Kit Build Location

21. The 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

NOTE

By default, CMake will build the project using the Debug build configuration. If a Release build is needed, see this page.

Figure 14: Qt Creator Argument String

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

-DARCH:STRING=x86  

22. Once the arguments string is pasted into the box, click Run CMake, and the output should be similar to Figure 15 below. Click Finish to add the kit to the current project.

Figure 15: Qt Creator Run CMake

23. To confirm the kit installed correctly, click on the Kit Selector tab (Monitor symbol) on the left hand side of the Qt Creator window as shown in Figure 16. Both Desktop and OE 5.X arm kit should be present.

Figure 16: Qt Creator Kits Installed

24. To run the example project on the target board remotely, you will need to add it to the Run Configuration. Click on Projects.

25. Select Run under the OE 5.X arm tab.

26. To Run Configuration, click on Add and select your project name (on Remote Generic Linux Host). In this case, our project name is Prime_Numbers (on Remote Generic Linux Host).

Figure 17: Qt Creator Run Configuration

You are now ready to run the examples below using Qt Creator.

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 18.

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

int main(int argc, char * argv[])
{
    printf("Hello EMAC OE!\n");
   
    exit(EXIT_SUCCESS);
}

Figure 18: Qt Creator Edit Window

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

3. Once the program successfully builds, you may 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 19: 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 through 100 on the Qt Creator remote terminal.

1. Create a new project and install the necessary kits for the target board 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 210: Qt Creator Edit Window

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

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 through 100 in the Application Output terminal.

Figure 21: 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, how to set up the necessary kits for your target board, how to set up your target board, and how to build and run example projects.

Pages with Related Content

• Getting Started with the EMAC OE SDK