Professional Documents
Culture Documents
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
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
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
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
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
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)
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
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.
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.
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
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
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
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
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
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
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.
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
On VirtualBox use CTRL RIGHT+F7 to enter in your host screen or use CTRL RIGHT+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
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)
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:
zypper refresh
To search a package
A list of all new packages available can be obtained with the command
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
zypper help
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
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
To create your own project based on a Yocto template and then display the source code, follow these
steps:
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
Once you have compiled your program, use the following steps to run programs remotely:
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
Once your program can run in your IGEP device you debug your application. Follow these steps to
debug the application.
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
Once the file is downloaded you can create bootable SD-Card, under Linux, untar the IGEP Firmware
cd igep_firmware-yocto-*
Insert a SD-Card media and use the igep-media-create script to copy the firmware to SD-Card media.
--machine <machine>
where,
<image file> - is the file that contains bootloader, kernel and rootfs image.
For example, assuming the SD-card device takes '/dev/sdf' and you have an IGEPv2 board ('igep0020'),
type
--image demo-image-sato-igep00x0.tar.bz2
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:
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:
--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
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