Revision as of 13:15, 8 August 2012

Overview

This tutorial guide shows the steps for setup the IGEP SDK Virtual Machine (VM) in your computer, which includes a software development kit with all its software completely installed and ready to use.

It also shows how to connect the VM to an IGEP Processor Board, to test your applications directly into your board.

Requirements

• a computer with Linux, Mac or Windows

This is a work in progress article. Help other developers like you in the IGEP Community by improving it!

Download the IGEP SDK Virtual Machine

First of all, download the Virtual Machine:

http://isee.biz/component/zoo/item/igep-virtual-machine-sdk-yocto

You can also download the Virtual Machine manual:

http://isee.biz/component/zoo/item/igep-sdk-software-user-manual

.. or you can:

1. Open a web browser and go to www.isee.biz, the main page from ISEE.
2. In the product section, go to the page of the product you have, for example, IGEPv2.
3. Select the "IGEP SDK Virtual Machine" and downloaded it into your PC.

Install and configure the Virtual Machine

The IGEP SDK Virtual Machine can be used with:

1. Virtualbox [1], a multiplatorm application for Linux, Mac or Windows
2. VMWare Player [2], which can be downloaded for Windows or Linux.

VirtualBox

Go to file / import ampliance, select the downloaded .ova file and click next.

Continue with the installation, leave the default configuration of the Virtual Machine and finally click to import.

If you edit the default configuration, ensure to set bridge mode to the network adapter

VMWare

Open a new virtual machine and select the .ova downloaded file.

Install additional features to the VM

VirtualBox

If you want to add some functionalities to the virtual machine install the guest additions.

1. Select guest additions.
2. Run the autorun application.
3. Remember that the root user has the password: letmein

VMWare

1. At the top of the application, go to Virtual Machine menu and select "Install VMWare tools"
2. Select "Download and install"
3. Extract the downloaded file
4. Open a terminal session and go to the extracted folder.
5. Run the vmware-install.pl
6. Press return key and continue with the installation at all the installation prompts

When finnishing the installation, restart the VM and you will be able to switch to full screen, copy/paste between OS's, etc.

Connect your board to the Virtual Machine

In this tutorial we are going to connect IGEPv2 via ethernet to your computer, but you can use other boards and interfaces, such USB-Ethernet Gadget.

First of all, connect IGEPv2 to your computer via the Ethernet interface and power it up.

ASSUMING THE DEFAULT CONFIGURATION of the pre-installed software

In the Virtual Machine, open a terminal session and check that appears a network interface called eth0:0

If it does not mount it, check the connections and reconnect the wired connection of the Virtual machine.

Compile an run and debug a 'C' application using Eclipse IDE

You can use any of the preinstalled IDE's in the IGEP SDK Virtual Machine. The VM has many installed and configured IDE's such Eclipse and Qt creator ready to develop your applications.

In this tutorial, let's try Eclipse IDE and compile one of the available examples.

1. Start Eclipse from the Desktop of the VM and open a C application example, such C_Example.
2. If you right click the project and select "build project", it will cross compile your project for ARM architecture, suitable to run in your IGEP Processor Board.
3. Go to the Run menu and select Run Configurations.
4. Select your project and click RUN.
5. When the system prompts for a user, use: root and empty password and click OK

At the console tab you will see the remote program execution.

Debugging your applications

You can also debug your applications:

1. At the Ecplise menu, select the debug configurations and click Debug.
2. Click the Step Over option to debug your source code.
3. Close the communication with the stop button.