Creating New Projects with Eclipse

TODO: {{#todo:Port this and finish it.|Michael Gloff|oe 4,InProgress,mg}}

The purpose of this guide is to demonstrate how to create a new project in Eclipse using the EMAC Open Embedded SDK. This will include a step-by-step procedure which assumes that the SDK has already been imported .
Since this guide is specific to the EMAC OE SDK, it is not interchangeable with a general guide on creating a new Eclipse project.

Required Tools

• GNU Make
• EMAC Eclipse 3.6
• EMAC OE SDK

New Project Setup

Before getting started creating a new project, the following setup must be performed. It is up to the application developer whether the new project will be placed in the EMAC-OE-arm-linux-gnueabi-SDK_XX.YY/projects project folder in the Eclipse Project Explorer View or within its own project folder. The latter does involve more complexity during setup, though it is a bit neater to work with since it does not require the developer to navigate the SDK directory tree to get to the new project. Note that only one of the following subsections is necessary to move on to the General Setup Section.

Creating a New SDK C Project

1. Make sure that the SDK has been configured according to Configuring the SDK

2. Start Eclipse.

   

   Figure 1: Select Eclipse Workspace

   
   

3. From the Eclipse menubar, select File->New->Project

4. Under C/C++, select C Project then next

   

   Figure 2. Open C Project

   
   

5. Enter “hello” in the Project name: field.

6. Scroll down and choose Makefile Project -> Empty Project in the Project type: list.

7. Ensure that – Other Toolchain – is selected in the Toolchains: list.

8. Click the Finish button.

9. Select Yes to open the C/C++ perspective if prompted

   

   Figure 3: New Eclipse Project

   
   

10. The workbench should look similar to Figure 4 below.

    

    Figure 3: New Eclipse Project

    
    

    
    

Creating a New SDK QT Project

The process for creating a new QT project is similar to creating a new C project with some minor differences.

1. Make sure that the SDK has been configured according to Configuring the SDK

2. Start Eclipse.

3. From the Eclipse menubar, select File->New->Project

4. Under Qt, select Qt Gui Project or Qt Console Project then click Next

   

   Figure 4: New Qt Project

   
   

5. Enter myproject in the Project Name: field and click Finish.

   

   Figure 5: New Qt Project

   
   

6. Accept the default file names for the project and click Next

   

   Figure 6: New Qt Project

   
   

7. Select any additional Qt modules that are required for the project, then click Finish

   

   Figure 7: New Qt Project

   
   

   
   

The project is now set up and ready to begin coding an application. For more information on creating Qt applications see [ http://qt-project.org/doc/qt-4.8/gettingstartedqt.html Getting Started Programming with Qt ] on the Qt website.

General Setup

Generate Eclipse Make Targets

The following will demonstrate how to add the all, clean and upload targets for make

1. Click on the Make Target view tab in the right hand pane.

2. Right click on hello to bring up the context menu.

3. Select New...

   

   Figure 4: Make Target context menu

   
   

4. Create the make targets all, clean and upload as in figures 5,6 and 7.

   • 

     Figure 5: Make New All Target

   • 

     Figure 6: Make New Clean Target

   • 

     Figure 7: Make New Upload Target

Modify the Makefile

Once the Make Targets have been created, a Makefile needs to be created that contains the same targets so that GNU make knows how to compile and link the source into a binary that will run on the target machine. See the Makefile modification section of the EMAC OE SKE New Project guide for more explanation.

Alternate Project Locations

If the project is created outside of the /path/to/sdk/projects directory, the paths present in the make file and path to the SDK and global.properties files will need to be modified as below.

1. Copy the correct global.properties file from the SDK/projects directory to the current project directory

   cp -L /path/to/sdk/projects/global.properties /path/to/project/hello
   

2. Modify the include line at the top of the make file to refer to the new global.properties file

   include global.properties
   

3. Change the value of SDKBASE in global.properties to point to the location of the SDK installation.

   
   

Using the New Project

The next step is to write some example C code for the project. See Write the C Code section of the EMAC OE SKE New Project guide for more explanation.

1. Open the C/C++ Perspective if it is not open already.

   1. From the Eclipse menubar, select Window -> Open Perspective -> Other...

   2. Select C/C++ and click OK

2. Create a new C file using the Eclipse New Source Wizard.

   1. From the Eclipse menubar, select File-> New-> Source File.

   2. Set the Source File: field to hello.c

   3. Set the value of Template: to <None>

   4. Click Finish

3. If the new C file did not open automatically, open it by double clicking hello.c the the left pane

4. Copy the code from Listing 1. in the C code writing section of the EMAC OE SKE New Project guide.

5. Save the file by selecting File->Save from the Eclipse menubar. See figure 8 for how Eclipse should look.

   

   Figure 8: Eclipse Workspace

   
   

Cross-Compile

To build the project, ensure the project is highlighted in the Project Explorer treeview in the left pane, then select Project->Build Project. For a Qt project first run Project->Run qmake. The project will now build, and your window should appear similar to figure 9.

Figure 9: Eclipse Workspace

If there are any build errors, they will be shown in the Console and/or Problems tabs on the bottom.

see http://wiki.emacinc.com/doku.php?id=linux:eclipse:newsdkproject

See Also

Compile and Run procedure from the Eclipse Example Project Guide to compile the project. Note: There may be differences between