You are on page 1of 22

IGEP TM SDK

SOFTWARE USER
MANUAL
http://www.isee.biz/
Document: MAN-PR-INTR0010-001
Revision: 2.0
Date: February 12, 2013
IGEPTM SDK Software User Manual

Table of Contents
0. COPYRIGHT NOTICE ................................................................................................................................ 3
1. PREFACE ................................................................................................................................................. 3
1.1 ORGANITZATION OF THE MANUAL .................................................................................................. 3
1.2 IGEP ECOSYSTEM .............................................................................................................................. 4
1.3 USER REGISTRATION ........................................................................................................................ 5
2. IGEP SDK VIRTUAL MACHINE ................................................................................................................. 6
2.1 UNDERSTANDING AND USING THE VM ........................................................................................... 6
2.2 FEATURES ......................................................................................................................................... 6
2.3 SETTING UP AND RUNNING THE VM................................................................................................ 8
2.3.1 ADVANCED SETTING UP OF VM ................................................................................................ 8
3. CONNECTING TO IGEP DEVICES ........................................................................................................... 10
3.1 USING SERIAL MODE ...................................................................................................................... 10
3.2 USING NETWORK MODE ................................................................................................................ 10
3.2.1 VIA ETHERNET ......................................................................................................................... 10
3.2.2 VIA USB ETHERNET GADGET ................................................................................................... 11
3.2.3 VIA WIFI ................................................................................................................................... 11
3.3 REMOTE X ....................................................................................................................................... 11
4. IGEP FIRMWARE ................................................................................................................................... 13
4.1 INTRODUCTION .............................................................................................................................. 13
4.2 FEATURES ....................................................................................................................................... 13
4.3 EXTENDING THE IGEP FIRMWARE .................................................................................................. 14
5. APLICATION DEVELOPMENT WITH ECLIPSE ......................................................................................... 15
5.1 CREATE AND BUILD THE PROJECT .................................................................................................. 15
5.1.1 BUILD AN AUTOTOOLS-BASED PROJECT ................................................................................. 17
5.2 RUN PROGRAMS REMOTELY .......................................................................................................... 18
5.3 DEBUG PROGRAMS REMOTELY...................................................................................................... 19
6. ANNEX. UPDATING TO THE LATEST IGEP FIRMWARE .......................................................................... 20
6.1 CREATE IGEP FIRMWARE BOOTABLE MICRO-SD CARD.................................................................. 20
6.2 FLASH IGEP DEVICE WITH IGEP FIRMWARE BOOTABLE MICRO-SD CARD ..................................... 21
7. ANNEX. USEFUL REFERENCES............................................................................................................... 22

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
2
IGEPTM SDK Software User Manual

0. COPYRIGHT NOTICE
This document is copyrighted, 2012, by ISEE 2007 SL. All rights are reserved. ISEE reserves the right to
make improvements to the products described in this manual at any time without notice. No part of
this manual may be reproduced, copied, translated or transmitted in any form or by any means
without the prior written permission of the original manufacturer.

Information provided in this manual is intended to be accurate and reliable. However, the original
manufacturer assumes no responsibility for its use, or for any infringements upon the rights of third
parties which may result from its use.

1. PREFACE

1.1 ORGANITZATION OF THE MANUAL


This manual is divided into:

This first chapter describes this document and general information about how develop in.
The chapter 2 introduces to the basic concepts of the IGEP SDK Virtual Machine.
The chapter 3 describes different ways to get access to shell prompt on IGEP devices.
The chapter 4 introduces to the IGEP Firmware provided by default in any IGEP device.
The chapter 5 is useful information about developing applications for IGEP devices using the
Eclipse IDE.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
3
IGEPTM SDK Software User Manual

1.2 IGEP ECOSYSTEM

The ISEE website (http://www.isee.biz) is the Official website to get


in touch with latest engineering products from ISEE.

The IGEP Technology is the ISEE Generic Enhanced Platform based on


very small processor boards that can run many Operating Systems.

The IGEP COMMUNITY is an active community made up of all of the


people who collectively work on or with IGEP Technology devices.

The IGEP Wiki (http://labs.isee.biz) is where the community members can contribute and
collaborate on documentation. Here you can found a lot of IGEP Technology knowledge, FAQs,
HOWTOs, software recipes, hacking and technical tricks.
The IGEP Forum (http://forum.isee.biz) is where people asks and answers questions. More
than 3000 users share their experiences and knowledge.
The IGEP GIT repositories (http://git.isee.biz) is where you can find all the software revisions
supported by ISEE and all the updates related to the IGEP Technology.
We use the IGEP IRC for a variety of real-time conversations: discussion, troubleshooting,
collaboration, chatting with other contributors, and more. Visit our #igep channel at
irc.freenode.net

And  don’t  forget  to  visit  or  follow  us  at:

To enhance your IGEP experience. Enjoy it!

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
4
IGEPTM SDK Software User Manual

1.3 USER REGISTRATION


Users who want to have full access into ISEE web services, they have to be registered (free
registration). Go to official ISEE website: http://www.isee.biz and "create an account" yourself:

After that, you will receive the password account in a short time by email. This login account allow you
to access a public forum, writeable wiki website access, e-shop, downloads.

See http://labs.isee.biz wiki website where users can learn and contribute about the IGEP Technology.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
5
IGEPTM SDK Software User Manual

2. IGEP SDK VIRTUAL MACHINE

2.1 UNDERSTANDING AND USING THE VM


The IGEP SDK Virtual Machine allows you to boot a custom Linux distribution image using a non-Linux
development system. We don't recommend that you use the virtual machine as a day-to-day
production development environment. You should limit the virtual machine to testing out and
experiencing with the IGEP Technology.

We use a virtual machine (VM) to make an easy way to introduce quickly to a complete development
environment for IGEP Technology based devices.

To understand the virtual machine, you need to be familiar with some terms and concepts:

Host Computer: The system on which you are running the virtual machine. For example, the
host computer could be your laptop computer running the Windows operating system.
Virtualization infrastructure
o VirtualBox: An Oracle product that lets you run multiple operating systems at the same
time on your PC. It allows you to create isolated virtual machines to try things out. See
https://www.virtualbox.org for more information.
o VMware Player: A VMware product that lets you run multiple operating systems at the
same time on your PC. It allows you to create isolated virtual machines to try things
out. See http://www.vmware.com/products/player for more information.
OVA File: Is a TAR file with the OVF directory inside. The Open Virtual Machine Format file
defines the Virtual Machine, including which disk image (vmdk) to use. The disk image contains
a Linux distribution build by ISEE. For information on the Open Virtual Machine Format file, see
http://en.wikipedia.org/wiki/Open_Virtualization_Format.

2.2 FEATURES
IGEP SDK Virtual Machine includes Software Development Kit (SDK) from ISEE. All components are
installed and configured to speed up getting started with IGEP Technology. It is based in Linux Mint
distribution (Ubuntu/Debian variant)

Distribution based on:


o Release: Linux Mint 12 (Lisa)
o Edition: Gnome Desktop, x86
Software included:
o IGEP SDK Yocto Toolchain
o Eclipse IDE with Yocto Plug-in and Linux Tools.
o Qt creator IDE

The IGEP SDK Virtual Machine image can be used with Virtual Box or VMware Player.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
6
IGEPTM SDK Software User Manual

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
7
IGEPTM SDK Software User Manual

Other useful information about VM is:

Account information
o Username: jdoe
o Password: letmein
Network configuration (IP addresses)
o eth0 − assigned via dhcp.
o eth0:0 − static ip address 192.168.5.10
o usb0 − assigned via dhcp.

2.3 SETTING UP AND RUNNING THE VM


To get going with the virtual machine you need to download the OVA file, decide which virtualization
product is best for you (VirtualBox or VMware), install and configure that product, and boot the image.
Follow these steps:

1. Download the IGEP SDK Virtual Machine (OVA file) from the ISEE website (www.isee.biz) by
clicking on the download link of your IGEP product.
2. Follow the instructions from the VirtualBox site for installing the VirtualBox product or the
VMware site for installing either VMware Player product.
3. Launch your virtualization product.
4. Go to the File menu and select "Import Appliance".
5. Navigate to where you downloaded the virtual machine OVA file.
6. Select the Open Virtual Machine Format file and  click  “Open”.
7. Accept the name and location for your new virtual machine and click "Import" to import the
appliance. Once the appliance (OVA file) is imported it appears in the left panel as a virtual
machine.
8. Use your virtualization product to boot the image. For VMware Player, choose "Play" the
virtual machine. For VirtualBox, choose "Start". After a moderate wait while the image boots.

2.3.1 ADVANCED SETTING UP OF VM


1. Select your new virtual machine from the list in the main screen of your virtualization product.
2. Click on "Edit virtual machine settings".
3. From the "Virtual Machine Settings" screen select "Memory".
4. Move the slider control up to the maximum recommended memory.
5. Select "Processors".
6. Use the dropdown control and choose the number of processors to match your host machine.
7. Be sure the rest of your devices are appropriately set for your host.
8. Click "Save" to return to the VirtualBox or VMware Player main screen.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
8
IGEPTM SDK Software User Manual

The IGEP SDK Virtual Machine screen in VirtualBox looks like:

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
9
IGEPTM SDK Software User Manual

3. CONNECTING TO IGEP DEVICES


This chapter describes different ways to get access to shell prompt on IGEP devices.

3.1 USING SERIAL MODE


The IGEP Firmware opens a shell prompt on the serial debug console. The debug console is available
on IGEP v2, IGEP PARIS and IGEP BERLIN. Follow these steps to connect to your IGEP device:

1. Connect a cross-wired cable between the COM port of your host PC and your IGEP device.
2. Open Applications / IGEP development / Putty
3. Select Serial mode for IGEP
4. Click Open

Make sure you   have   selected   the   corrected   serial   device   (ttySx,   ttyUSBx   …)   and   is   configured as
follows:

Baudrate : 115200
Data bits: 8
Stop bits: 1
Parity: none
Flow control: none

3.2 USING NETWORK MODE


Network communication uses SSH protocol to get a shell prompt. This protocol can be used on IGEP
devices via Ethernet, USB Ethernet gadget or WIFI.

3.2.1 VIA ETHERNET


Network via Ethernet is available on IGEPv2, IGEP BERLIN and IGEP PARIS. Follow these steps to
connect to your IGEP device:

1. Connect the Ethernet cable between your host PC and the IGEP device or through a router.
2. Open Applications / IGEP development / Terminal
3. Use ssh-client to connect to the IGEP device using an empty password

ssh –l root 192.168.5.1

Note that an Ethernet alias (192.168.5.10) is configured by default in the IGEP SDK Virtual Machine.
The IGEP device should have IP address 192.168.5.1. If you have problems connecting to the IGEP
device make sure that your host PC IP address is in the range 192.168.5.2-192.168.5.254.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
10
IGEPTM SDK Software User Manual

3.2.2 VIA USB ETHERNET GADGET


The Linux kernel has a class of drivers called USB Gadgets that allow you to use USB as a transport for a
number of different protocols like serial, virtual file systems and Ethernet devices.

The USB OTG connector supports using the Ethernet Gadget to create a networking device over USB.
From the client's (and host's) perspective this driver simply appears as another Ethernet device,
enabling us to have Ethernet access on the board by hooking them up to a desktop, so this USB slave
device can communicate with a properly configured USB host.

Network via USB Ethernet Gadget is available at IGEPv2, IGEP COM MODULE and IGEP COM PROTON.
Follow the next instructions to use it:

1. Plug an USB Type-A to USB Type-A mini cable between your host PC and the USB OTG from the
IGEP device.
2. Open Applications / IGEP development / Terminal
3. Use ssh-client to connect to the IGEP device using an empty password

ssh –l root 192.168.7.1

Note that a DHCP IP address in range 192.168.7.10-192.168.7.254 should be given to your host PC. The
IGEP device should have IP address 192.168.7.1.

3.2.3 VIA WIFI


Network via WIFI is available at IGEPv2 and IGEP COM MODULE. Follow these steps to connect to your
IGEP device:

1. Click on the Network Manager Tray icon.


2. Select IGEP_<xx> network, where <xx> is different for every IGEP device, to connect.
3. Open Applications / IGEP development / Terminal
4. Use ssh-client to connect to the IGEP device using an empty password

ssh –l root 192.168.6.1

Note that a DHCP IP address in range 192.168.6.10-192.168.6.254 should be given to your host PC. The
IGEP device should have IP address 192.168.6.1.

3.3 REMOTE X
This method lets you switch between Virtual Machine Screen and IGEP Desktop Screen using the same
display. Useful for debug or check your programs.

The IGEP SDK Virtual Machine has a bash script that allows you to run this feature easily, follow these
steps to see the IGEP desktop in your host PC

cd ~/bin

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
11
IGEPTM SDK Software User Manual

./igep-remote-x --igepip 192.168.5.1 --hostip 192.168.5.10

On VirtualBox use CTRL RIGHT+F7 to enter in your host screen or use CTRL RIGHT+F8 to enter in
the IGEP device screen.

On VMware use CTRL+ALT+SPACE+F7 to enter in your host screen or use CTRL+ALT+SPACE+F8 to


enter in the IGEP device screen.

You should see something like this on your "IGEP device screen".

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
12
IGEPTM SDK Software User Manual

4. IGEP FIRMWARE
IMPORTANT NOTE: This software is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. This software is provided entirely and is not licensed for any use other than
EVALUATION PURPOSES of the IGEP Technology based devices.

4.1 INTRODUCTION
The IGEP Firmware could be built from scratch using a tool from the Yocto Project called Poky. The
Poky build system allows developers to create their own complete Linux Distribution for their
embedded systems.

The firmware that runs on every IGEP Technology device is created in the hope to introduce you
quickly to the IGEP Technology. The IGEP Firmware provides a preconfigured Linux system allowing
communicating and experiencing easily with IGEP devices.

The image is built using the GNOME Mobile software stack, providing a well defined user experience.
The user interface environment used is SATO, it is designed to work well with screens at very high DPI
and restricted size. It is coded with focus on efficiency and speed so that it works smoothly on hand-
held and other embedded hardware.

4.2 FEATURES
Software included:
o GNU/Linux system.
 Linux kernel.
 Root filesystem (initscripts, X11-based, EXT3, JFFS2, UBIFS, VFAT, NTFS, NFS...)
 Drivers (USB,SPI,I2C,CAN,Ethernet,GPRS,...)
 Network protocols (TCP/IP, UDP/IP, ARP, ICMP, SNMP, TFTP, TELNET, DHCP,
BOOTP, SSH-SSL, HTTP, HTTP-SSL, NAT, NTP, PPP,...)
 RPM package system.
o GNOME Mobile software stack
 GTK toolkit for interface construction.
 GConf application configuration service which leverages XML for data
persistence.
 GnomeVFS file access abstraction layer which provides support for network
transparent file manipulation.
 GStreamer multimedia framework which supports dynamic media editing as
well as playback.
 D-Bus interprocess communication system.
 BlueZ Bluetooth stack.
 Avahi service for Zeroconf service discovery.
Software public repositories (RPM-based) at http://downloads.isee.biz/denzil/rpm/
ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
13
IGEPTM SDK Software User Manual

Other useful information about IGEP Firmware is:

Account information
o Username: root
o Password: <empty>
Network configuration (IP addresses)
o eth0 − 192.168.5.1
o eth0:0 − assigned via dhcp.
o wlan0 − 192.168.6.1 (with dhcp server)
o usb0 − 192.168.7.1 (with dhcp server)

4.3 EXTENDING THE IGEP FIRMWARE


The IGEP Firmware is based on RPM packages. The RPM Package Manager is a package management
system that automates the process of installing, upgrading and removing software packages. If you
also need some software that is typically not found in the IGEP Firmware, you can search if this
software  it’s  available  in  the  ISEE  repositories.

You can manage packages from the IGEP Firmware using "zypper". Zypper is the command line
package manager installed on the IGEP Firmware for installing, removing, updating and querying
software packages of local or remote repositories.

To manage packages connect to your IGEP device as explained in chapter “3. CONNECTING TO IGEP
DEVICES”  and use following commands:

To get the package list from the repository, use

zypper refresh

To search a package

zypper search package_name

To install a package from registered repositories, use

zypper install package_name

To remove an installed package, use

zypper remove package_name

A list of all new packages available can be obtained with the command

zypper list-updates -t package

To update your system, just run the

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
14
IGEPTM SDK Software User Manual

zypper update

Other useful zypper commands :

zypper help

zypper help command

5. APLICATION DEVELOPMENT WITH ECLIPSE


As the IGEP Firmware is built using the Yocto Project you can take advantage of the different tools
provided by this project. One of these interesting tools is the Yocto Eclipse IDE Plug-in.

The Yocto Eclipse IDE Plug-in integrates the functionality of the Yocto Project Application Development
Toolkit (ADT) and toolchain into the Eclipse IDE. This allows its users direct access to deploy, build, run
and debug your own project.

The Eclipse IDE is a popular environment and it fully supports development for IGEP Technology based
devices.

The VM provides a pre-configured Eclipse IDE to let you more easily develop software. The Yocto
Eclipse Plug-in allows you for cross-compilation, deployment, and execution of your program into any
IGEP Technology based devices.

For  more  information,  see  the  official  “Yocto  Application  Development  Toolkit  User’s  Guide”  at:

http://www.yoctoproject.org/docs/current/adt-manual/adt-manual.html

To open the Eclipse IDE go to Applications / IGEP development / Eclipse IDE

5.1 CREATE AND BUILD THE PROJECT


You can create two types of projects on Yocto Eclipse IDE Plug-in: Autotools-based, or Makefile-based.
The IGEP SDK Virtual Machine provides already some examples that can be used as a template for your
project. The examples are:

C_example, autotools-based  “Hello  World”  program  written  in  C.


Cairo_example, generates a png file named hello.png.
Cpp_example, autotools-based “Hello  World”  program  written  in  C++
Dbus_example, sends "Hello Wolrd!" using D-Bus message system.
Glib_example, simple  “Hello World" written using Glib library.
Gstreamer_example, ogg audio player using Gstreamer.
Gtk_example, Hello World in GTK.
C_example_without_autotools, makefile-base  “Hello  World”  program  written  in  C.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
15
IGEPTM SDK Software User Manual

To build any project, select Project -> Build Project. The console should update and you
can note the cross-compiler that you are using.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
16
IGEPTM SDK Software User Manual

5.1.1 BUILD AN AUTOTOOLS-BASED PROJECT

To create your own project based on a Yocto template and then display the source code, follow these
steps:

1. Open the ECLIPSE IDE


2. Select File -> New -> Project.
3. Double click C/C++.
4. Double click C Project or C++ Project to create the project.
5. Expand Yocto ADT Project.
6. Select a template
7. Select Hello World ANSI C Autotools Project or Hello World C++
Autotools Project. This is an Autotools-based project based on a Yocto Project
template.
8. Put a name in the Project name: field. Do not use hyphens as part of the name.
9. Click Next.
10. Add information in the Author and Copyright notice fields.
11. Be sure the License field is correct.
12. Click Finish.
13. If the "open perspective" prompt appears, click "Yes" so that you in the C/C++ perspective.
14. The left-hand navigation pane shows your project. You can display your source by double
clicking the project's source file.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
17
IGEPTM SDK Software User Manual

5.2 RUN PROGRAMS REMOTELY


Note that the Eclipse IDE is configured by default using the Ethernet address 192.168.5.1. If you want
use another interface (like usb gadget or wifi) you should do a new connection configuration.

Once you have compiled your program, use the following steps to run programs remotely:

1. Select Run -> Run Configurations...


2. In the left area, expand C/C++Remote Application.
3. Locate your project and select it to bring up a new tabbed view in the Run Configurations
Dialog.
4. Enter the absolute path into which you want to deploy the application. Use the Remote
Absolute File Path for C/C++Application: field. For example, enter
/usr/bin/<program name>.
5. Select Remote Connection
6. If field is empty search your C/C++ Application
7. Use other option as you want like program arguments or commands to execute before
application run
8. Finally run your program

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
18
IGEPTM SDK Software User Manual

5.3 DEBUG PROGRAMS REMOTELY


Note that the Eclipse IDE is configured by default using the Ethernet address 192.168.5.1. If you want
use another interface (like usb gadget or wifi) you should do a new connection configuration.

Once your program can run in your IGEP device you debug your application. Follow these steps to
debug the application.

1. Select Run -> Debug Configurations...


2. In the left area, expand C/C++Remote Application.
3. Locate your project and select it to bring up a new tabbed view in the Debug
Configurations Dialog.
4. Enter the absolute path into which you want to deploy the application. Use the Remote
Absolute File Path for C/C++Application: field. For example, enter
/usr/bin/<program name>.
5. Select Remote Connection
6. If field is empty search your C/C++ Application
7. Use other option as you want like program arguments or commands to execute before
application run.
8. Click Debug
9. Accept the debug perspective if  it’s  not  the  default  perspective.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
19
IGEPTM SDK Software User Manual

6. ANNEX. UPDATING TO THE LATEST IGEP FIRMWARE

6.1 CREATE IGEP FIRMWARE BOOTABLE MICRO-SD CARD


The latest firmware can be downloaded from ISEE website, www.isee.biz.

1. Select Products -> Processor Boards


2. Click on your processor board product.
3. Click on Software tab
4. Click on IGEP Firmware
5. Select Download icon.

Once the file is downloaded you can create bootable SD-Card, under Linux, untar the IGEP Firmware

tar jxf igep_firmware-yocto-*.tar.bz2

cd igep_firmware-yocto-*

Insert a SD-Card media and use the igep-media-create script to copy the firmware to SD-Card media.

./igep-media-create -–mmc <mmc> --image <image file> \

--machine <machine>

where,

<mmc> - is the SD-Card device of your computer.

<image file> - is the file that contains bootloader, kernel and rootfs image.

<machine> - is the IGEP Processor Board. Available options are:

igep0020 - For IGEP v2 Processor Board

igep0030 - For IGEP COM MODULE Processor Board

igep0032 - For IGEP COM PROTON Processor Board

For example, assuming the SD-card device takes '/dev/sdf' and you have an IGEPv2 board ('igep0020'),
type

./igep-media-create --mmc /dev/sdf --machine igep0020 \

--image demo-image-sato-igep00x0.tar.bz2

This should give you a bootable SD-card.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
20
IGEPTM SDK Software User Manual

6.2 FLASH IGEP DEVICE WITH IGEP FIRMWARE BOOTABLE MICRO-SD CARD
Insert the SD-card media into the micro-SD card socket of IGEP device and power on it. This should
result in a running system with Sato graphical desktop root file system built by Yocto.

Refer to section  “3. CONNECTING TO IGEP DEVICES”  to login in/connect to the system.

Once your booted IGEP from the SD-card, you can write the firmware into the flash. Enter into an IGEP
root terminal an run:

igep-flash --image /opt/firmware/demo-image-sato-igep00x0.tar.bz

When finish, power off your board, unplug the micro-SD card and power on the board. That's all, enjoy
the new firmware running from the flash memory.

NOTE: You can speed up flash procedure. By default the flash script runs the nandtest command to
mark bad blocks, this can take a long time and in most cases is not necessary, you can speed up the
flash procedure running the script as follows:

igep-flash --image /opt/firmware/demo-image-sato-igep00x0.tar.bz \

--skip-nandtest

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
21
IGEPTM SDK Software User Manual

7. ANNEX. USEFUL REFERENCES


1. http://www.isee.biz – The main ISEE website.
2. http://www.isee.biz/products – ISEE products information.
3. http://labs.isee.biz/index.php/gettingstarted – Start learning about IGEP Technology.
4. http://www.virtualbox.com – The virtualization product VirtualBox.
5. http://vmware.com – The virtualization product VMware.
6. http://www.yoctoproject.com – The Yocto Project website.
7. http://www.yoctoproject.org/docs/current/adt-manual/adt-manual.html – “Yocto  Application  
Development  Toolkit  User’s  Guide”
8. http://www.linaro.org/ - "LINARO: Open source software for ARM SoCs"
9. http://labs.isee.biz – IGEP Community Wiki.
10. http://forum.isee.biz – IGEP Community Forum.
11. http://git.isee.biz – IGEP Software repositories.

ISEE 2007 S.L. All rights reserved, IGEP is a registered trademark from ISEE 2007 S.L. The following is provided for informational purposes only.
DOCUMENT FROM ISEE 2007 S.L. Ref: MAN-PR-INTR0010-001
22

You might also like