Gumstix User Wiki - User contributions [en]

User:Chris Whittenburg

2015-04-06T15:39:57Z

IanPhillips: Creating user page with biography of new user.

Gumstix developer for about the last five years or so... Built several commercial products with Overos inside them. Work with a team of hardware engineers who have designed several different carrier boards. Lots of interest in gstreamer and various video interfaces to the omap.

User talk:Chris Whittenburg

2015-04-06T15:39:57Z

IanPhillips: Welcome!

'''Welcome to ''Gumstix User Wiki''!'''
We hope you will contribute much and well.
You will probably want to read the [[Help:Contents|help pages]].
Again, welcome and have fun! [[User:IanPhillips|IanPhillips]] 08:39, 6 April 2015 (PDT)

User talk:Joel Skaliotis

2015-04-06T15:39:45Z

IanPhillips: Welcome!

User:Joel Skaliotis

2015-04-06T15:39:44Z

IanPhillips: Creating user page with biography of new user.

Customer Engineer, Gumstix, Inc.
Now in charge of organizing the knowledge base for Gumstix COMs and Gumstix Expansion Boards for users.

User:Jacob Gustafson

2015-02-19T21:13:26Z

IanPhillips: Creating user page with biography of new user.

My name is Jacob Gustafson. I am currently going to school for a degree in Aerospace engineering. I want to try and emulate gumsticks on unbutnu

User talk:Jacob Gustafson

2015-02-19T21:13:26Z

IanPhillips: Welcome!

User talk:Pascal

2014-11-17T16:39:56Z

IanPhillips: Welcome!

User:Pascal

2014-11-17T16:39:55Z

IanPhillips: Creating user page with biography of new user.

Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.Your biography must be at least 20 words long.

User talk:DavidCary

2014-11-12T16:18:15Z

IanPhillips: Welcome!

User:DavidCary

2014-11-12T16:18:14Z

IanPhillips: Creating user page with biography of new user.

David Cary has diverse interests:

* wearable medical electronics.
* PCB layout.
* quadcopters, hexcopters, octocopters, and other [[:Category:Projects - robotics | robotics]].
* live video.
* Open hardware. (I'm a sysop at [http://www.opencircuits.com/User:DavidCary | the Open Circuits wiki]).
* wiki. (I'm a sysop at [http://wikiindex.org/DavidCary | the wiki index]).

Tiny Gumstix-based systems have advantages in most of these areas.

User talk:Andrew Somerville

2014-07-30T20:36:39Z

IanPhillips: Welcome!

User:Andrew Somerville

2014-07-30T20:36:38Z

IanPhillips: Creating user page with biography of new user.

I am a 32 year old software engineer in Pittsburgh, Pennsylvania. I'm working on doing embedded software development on a gumstix overo.

User talk:Joran

2014-07-14T15:37:34Z

IanPhillips: Welcome!

User:Joran

2014-07-14T15:37:33Z

IanPhillips: Creating user page with biography of new user.

working on a pepper sbc to create an alitmeter app. currently struggling to install the android image from https://www.gumstix.com/software/software-downloads/?selection=eyJzb2Z0d2FyZSI6ImFuZHJvaWQiLCJidWlsZCI6ImZhY3RvcnkiLCJoYXJkd2FyZSI6InBlcHBlciJ9

User talk:BallCam

2014-04-21T15:48:16Z

IanPhillips: Welcome!

User:BallCam

2014-04-21T15:48:10Z

IanPhillips: Creating user page with biography of new user.

BallCam Technologies Incorporated Is Located In Florida USA.

It has been formed to produce the "BallCam", a product that uses
embedded video technology to capture images from inside a spinning football.

User talk:Ben Stromberg

2014-03-04T16:46:55Z

IanPhillips: Welcome!

User:Ben Stromberg

2014-03-04T16:46:48Z

IanPhillips: Creating user page with biography of new user.

University of New Mexico student majoring in Electrical Engineering (Bachelor of Science). Very few credentials worth mentioning with a lot of miscellaneous experience from many internships and research projects.

User talk:Alison Benson

2013-11-26T19:27:19Z

IanPhillips: Welcome!

User:Alison Benson

2013-11-26T19:27:16Z

IanPhillips: Creating user page with biography of new user.

I am Alison Benson. I am working for Parallel Branch.Parallel Branch is an online education portal offering courses that are self-paced, flexible, industry focused and modestly priced. Our courses are designed for anyone who has a desire to learn, develop and grow. Whether it’s the fresh graduates, who wish to add an extra skill to their profile, or students currently in college and aspire to give their career a new direction, or working professionals who are looking out for new avenues to develop their skills, Parallel Branch caters to all.

User talk:Conor O'Rourke

2013-11-18T16:59:49Z

IanPhillips: Welcome!

User:Conor O'Rourke

2013-11-18T16:59:48Z

IanPhillips: Creating user page with biography of new user.

I'm currently working as an Embedded design engineer for Scorpion Border Networks Ireland Ltd on a sensor processing platform (Framework 7 funded). This platform currently uses the Duovero Dual Core A9 device.

User talk:Russell Maxfield

2013-08-16T20:26:34Z

IanPhillips: Welcome!

User:Russell Maxfield

2013-08-16T20:26:28Z

IanPhillips: Creating user page with biography of new user.

I am a Computer Science major at Utah State University. I started a network security company to help protect homes and small businesses from network intrusions. I am currently helping my uncle with a project which is how i have become connected with the Gumstix COM.

User talk:Gary Anderson

2013-05-24T15:50:52Z

IanPhillips: Welcome!

User:Gary Anderson

2013-05-24T15:50:44Z

IanPhillips: Creating user page with biography of new user.

Math Department Chair at Seattle Academy. Currently using Gumstix in his Software Development class to control the iRobot Create using WiFi and Python.

User talk:RHofmeister

2013-04-22T15:49:18Z

IanPhillips: Welcome!

User:RHofmeister

2013-04-22T15:49:06Z

IanPhillips: Creating user page with biography of new user.

Developing optical systems at the limits of speed, miniaturization, and performance for over 20 years. Look us up at Optotechconsulting.com for more information.

User talk:Amaury

2013-04-11T16:35:29Z

IanPhillips: Welcome!

User:Amaury

2013-04-11T16:35:25Z

IanPhillips: Creating user page with biography of new user.

Je me nomme Amaury Mortier, né à Calais(62) et détenteur d'un baccalauréat scientifique obtenu au Lycée Léonard de Vinci de Calais.
Mes études post bac se sont dans un premier temps orientées vers une préparation aux grandes écoles d'ingénieur au lycée Jean Bart de Dunkerque(59).
Malgré une année riche en expériences et apprentissages, j'ai décidé de ne pas poursuivre cet enseignement afin de rejoindre l'université Claude Bernard de Lyon(69) et commencer une Licence de Physique que j'ai obtenue, avec mention bien, trois ans plus tard, ayant rejoint entre temps les bancs de l'Université Jean Monnet de Saint-Étienne(42).
Fort de ce diplôme, j'ai alors choisi de rejoindre les effectifs de l'école d'ingénieur Télécom Saint-Étienne, école dans laquelle je suis actuellement entrain de poursuivre une formation pour devenir ingénieur en développement d'applications liées à l'imagerie.
Durant cette formation, j'ai eu la chance de réaliser un stage au bout du monde, à Taiwan, dans un laboratoire de recherche, mais surtout, cela m'a permis de commencer un carrière professionnelle à Thalès Angénieux, entreprise mondialement connue pour la fabrication d'objectifs optiques.

User talk:Greg Sterijevski

2013-04-11T16:34:41Z

IanPhillips: Welcome!

User:Greg Sterijevski

2013-04-11T16:34:36Z

IanPhillips: Creating user page with biography of new user.

My name is Greg Sterijevski. I am interested in low power devices both as a hobby and as means to understand what effect differing chip and system environments have on analytic code. I look forward to working with the Gumstix DSP.

Category:Projects - competitions

2010-08-06T20:06:34Z

IanPhillips: Undo revision 4551 by 203.110.240.131 (Talk)

This webpage is provided so that users of the Gumstix OpenEmbedded build system can share their Gumstix based projects, and pass on links to other sources of information and materials. This information is entirely user generated and supported.

'''Customer additions are encouraged, but please read the help page before you make any major edits.'''
''Note: you will need to create a new user account if you would like to contribute or edit content on this site.''

==2009==

===(USA) Trossen Robotics' Hagetaka in Mech Warfare Competition at RoboGames 2009===

"Meet [http://blog.trossenrobotics.com/index.php/2009/04/16/hagetaka-a-bipedal-combat-robot/ Hagetaka]; a 7DOF per leg biped built around the powerful RX-64 servo from Robotis. This robot boasts 14 RX-64s, 2 RX-28s, a custom aluminum chassis machined by sponsor Big Blue Saw, an on-board Linux based Gumstix computer with a PS3 Sixaxis controller, a WiFi video server using a Headplay Personal Cinema System for remote piloting, and of course dual automatic airsoft guns".

Youtube video of Hagetaka [http://www.youtube.com/watch?v=CAjYA2xum9c here].

RoboGames runs June 12-14, 2009 in San Francisco. Check [http://mech-warfare.com/default.aspx here] for Mech Warfare!

==2008==

===(Canada) McGill University's LunarEx team in NASA’s centennial 2008 Regolith Excavation Challenge===

The McGill LunarEx Team is a group of undergraduate engineering students from McGill University collaborating to construct a fully automated lunar excavator for this [http://regolith.csewi.org/mcgilllunarexteam NASA Regolith Challenge].

The team is composed of students from different branches of engineering and includes mechanical, electrical, computer engineers. With this diverse mix of students we have a wealth of innovative ideas and the engineering know-how to create the simplest working solution to the challenge.

Team Leader: Stephen Hopkins

===(USA) Michigan Technological University in SAE's Supermileage(R)===

A team of twelve students building a prototype car for a collegiate competition. This competition is called [http://students.sae.org/competitions/supermileage/teamsites/ Supermileage] and is hosted by the Society of Automotive Engineers. The goal of the competition is to build a super efficient car in terms of fuel consumption. This year is the first year our team is going to participate in this international competition.

Contact: Alexey Morozov

===(Canada) Robotics Team, University of Waterloo in ION Robotic Lawnmower competition in Ohio, USA===

"U of Waterloo is the largest (and arguably best) engineering school in Canada, and the Robotics Team is the largest student team on campus. We compete in several national and international competitions. We have successfully used the Connex-400xm motherboard to place second in the national RobotRacing competition hosted annually here at UW; we plan to enter this racer again in the 2008 race.

Our Autonomous Lawnmower named'TronMower' will compete in the ION Robotic Lawnmower competition in Ohio in June, 2008".

Products: Gumstix verdex motherboard with the Robostix expansion board to power all of the intelligence, sensors and DC-motors.

Contact: Rehman Merali

===(UK) Strathclyde University ESCO-UAS team===

Strathclyde University [http://www.hertfordshire-connect.com/default.asp?ContentID=1234 ESCO-UAS] team constructed an autonomous UAV with autopilot system and real time telemetry over a range of approximately 5km.

Products: verdex

Contact: Dr Tiberious J Scanlon

[[Category: Projects]]

Category:Projects - competitions

2010-08-06T20:05:41Z

IanPhillips: Undo revision 4552 by 64.180.61.141 (Talk)

This webpage is provided so that users of the Gumstix OpenEmbedded build system can share their Gumstix based projects, and pass on links to other sources of information and materials. This information is entirely user generated and supported.

'''Customer additions are encouraged, but please read the help page before you make any major edits.'''
''Note: you will need to create a new user account if you would like to contribute or edit content on this site.''

Spybot - Search & Destroy, http://mitglied.multimania.de/mipevovo/bc-amateur-hockey-association.html Bc Amateur Hockey Association, :-[, http://ogilviedesdemona1966.atspace.com/oral-surgeon-practice-managment.html Oral Surgeon Practice Managment, 1382, http://mitglied.multimania.de/mipevovo/boat-group-sex.html Boat Group Sex, tokj, http://fdiana1961.ibelgique.com/bunny-lesbians.html Bunny Lesbians, 4529, http://quvukanu.tripod.com/gay-peniss-in-water.html Gay Peniss In Water, 98687, http://fdiana1961.ibelgique.com/doubled-sided-id-holders.html Doubled Sided Id Holders, >:-], http://fdiana1961.ibelgique.com/robo-suck.html Robo Suck, 704177, http://xagived.digitalzones.com/cartoons-on-sociology.html Cartoons On Sociology, ceubqg, http://ogilviedesdemona1966.atspace.com/xxx-bittorrent.html Xxx Bittorrent, %-(((, http://quvukanu.tripod.com/is-will-shortz-gay.html Is Will Shortz Gay, 1678, http://ogilviedesdemona1966.atspace.com/aunt-ass.html Aunt Ass, 65050, http://quvukanu.tripod.com/gay-black-guys-masturbating.html Gay Black Guys Masturbating, >:[, http://fdiana1961.ibelgique.com/couples-group-therapy-research.html Couples Group Therapy Research, 18112, http://fdiana1961.ibelgique.com/nude-cartoon-video-clips.html Nude Cartoon Video Clips, %OOO,

==2008==

===(Canada) McGill University's LunarEx team in NASA’s centennial 2008 Regolith Excavation Challenge===

The McGill LunarEx Team is a group of undergraduate engineering students from McGill University collaborating to construct a fully automated lunar excavator for this [http://regolith.csewi.org/mcgilllunarexteam NASA Regolith Challenge].

The team is composed of students from different branches of engineering and includes mechanical, electrical, computer engineers. With this diverse mix of students we have a wealth of innovative ideas and the engineering know-how to create the simplest working solution to the challenge.

Team Leader: Stephen Hopkins

===(USA) Michigan Technological University in SAE's Supermileage(R)===

A team of twelve students building a prototype car for a collegiate competition. This competition is called [http://students.sae.org/competitions/supermileage/teamsites/ Supermileage] and is hosted by the Society of Automotive Engineers. The goal of the competition is to build a super efficient car in terms of fuel consumption. This year is the first year our team is going to participate in this international competition.

Contact: Alexey Morozov

===(Canada) Robotics Team, University of Waterloo in ION Robotic Lawnmower competition in Ohio, USA===

"U of Waterloo is the largest (and arguably best) engineering school in Canada, and the Robotics Team is the largest student team on campus. We compete in several national and international competitions. We have successfully used the Connex-400xm motherboard to place second in the national RobotRacing competition hosted annually here at UW; we plan to enter this racer again in the 2008 race.

Our Autonomous Lawnmower named'TronMower' will compete in the ION Robotic Lawnmower competition in Ohio in June, 2008".

Products: Gumstix verdex motherboard with the Robostix expansion board to power all of the intelligence, sensors and DC-motors.

Contact: Rehman Merali

===(UK) Strathclyde University ESCO-UAS team===

Strathclyde University [http://www.hertfordshire-connect.com/default.asp?ContentID=1234 ESCO-UAS] team constructed an autonomous UAV with autopilot system and real time telemetry over a range of approximately 5km.

Products: verdex

Contact: Dr Tiberious J Scanlon

[[Category: Projects]]

File:GumstixEclipse1.jpg

2010-08-03T19:15:37Z

IanPhillips: uploaded a new version of "File:GumstixEclipse1.jpg"

File:GumstixEclipse1.jpg

2010-08-03T17:58:49Z

IanPhillips: uploaded a new version of "File:GumstixEclipse1.jpg"

File:GumstixEclipse1.jpg

2010-08-03T17:54:19Z

IanPhillips: uploaded a new version of "File:GumstixEclipse1.jpg"

File:GumstixEclipse1.jpg

2010-08-03T17:51:45Z

IanPhillips: uploaded a new version of "File:GumstixEclipse1.jpg"

File:GumstixEclipse1.jpg

2010-07-29T22:32:50Z

IanPhillips: uploaded a new version of "File:GumstixEclipse1.jpg": Re-uploaded to see if it will appear.

Eclipse on Gumstix for new users

2010-07-20T16:59:59Z

IanPhillips:

This guide provides step-by-step instructions for using the Eclipse Integrated Development Environment (IDE) to develop applications for the Gumstix COMs.

We'll walk through these tasks:
:* setting up Eclipse
:* connection to your Gumstix system
:* creating a simple "Hello, World!" Python program
:* running a web server
:* installing new packages on your Gumstix
:* creating a small graphical Java application
:* remote debugging of your Java application
:* natively-compiling C/C++ code on your Gumstix
:* remote debugging C/C++ using the GDB server interface

We will also explain how to set up a cross-compilation toolchain so you can develop C/C++ applications on your development computer and upload them to your Gumstix.

Remember, Gumstix COMs are fully-fledged, albeit tiny, Linux systems so there are many tools we don't cover here. For example, [http://wiki.openembedded.net/index.php/OpenEmbedded_Tools_for_Eclipse_(OTE) this document] explains how to use the powerful OpenEmbedded build system within Eclipse.

Required Tools:
:* any Windows, Apple or Linux computer with a USB port
:* recent version of the Java Runtime Environment (available [http://java.sun.com/javase/downloads/index.jsp here])
:* a Gumstix COM running [http://www.gumstix.net/Setup-and-Programming/view/Overo-Setup-and-Programming/Downloading-pre-built-images/111.html up-to-date software]
:* any expansion board of the Gumstix Overo series, such as Chestnut or Tobi, that has both a USB console port and a 10/100
:* Ethernet jack
:* a 5V power supply
:* an ethernet cable and internet connection
:* a mini-A to Standard-A USB cable
:* a [http://www.gumstix.net/Setup-and-Programming/view/Overo-Setup-and-Programming/Creating-a-bootable-microSD-card/111.html bootable microSD card] (only needed for native C/C++ compilation)

==Download Eclipse==
[http://www.eclipse.org/downloads/ Download] the Eclipse IDE for Java Developers for your Operating System: www.eclipse.org

[[File:GumstixEclipse1.jpg|thumb]]

:* it is ''not'' necessary to install the Eclipse software; just double-click on the application once it has finished downloading
:* when prompted, choose a workspace folder in which you want to store your projects and your configuration information
:* then click through to the Eclipse workbench itself

==Install Plugins==
For developers, a great variety of additional features can be added to Eclipse from various repositories of plug-ins known as ''Update Sites''.
To install a new plugin in Eclipse, first select the ''Update Site''.
:* navigate to '''Help->Install New Software...'''
:* select the update site for your version of Eclipse from the "Work with"dropdown menu

[[Image: GumstixEclipse2.jpg | thumb | left]]

----
Hint:
If the update site is not available, you can add it by clicking the 'Add...' button on the right. For the Galileo release, you can use the URL http://dowload.eclipse.org/releases/galileo
----

As we are working with a remote system, we'll install the Remote System Explorer plugin.
:* search for the ''Remote System Explorer End-User Runtime'' plugin
:* select it for installation

[[File:GumstixEclipse3.jpg]]

Still in Eclipse,
:* select "Next".... twice
:* select the radio button to "ACCEPT" the terms of the license agreement
:* choose "Yes" to restart Eclipse for the changes to take effect

Once Eclipse has restarted, let's add two other useful plugins that allow connection to the console port of our Gumstix without needing a terminal emulator program such as kermit or TeraTerm.
From within Eclipse,
:* navigate to '''Help->Install New Software'''
:* search on "Target" to find the ''Target Manager Terminal''

[[File:GumstixEclipse4.jpg]]

:* select the ''Target Manager Terminal''
:* click "Next"
:* click "Finish" to complete installation
:* choose "Yes" to restart Eclipse for the changes to take effect

We'll also need to add a new update site by doing these steps in Eclipse:
:* navigate to '''Help->Install New Software...'''
:* click the "Add..." button
:* type ''http://rxtx.qbang.org/eclipse'' into the ''Location'' field and create a name

[[File:GumstixEclipse5.jpg]]

:* Click the "OK" button
Go into the sub-directory as shown below to select the ''RXTX End-User Runtime'' plugin that this site provides.

[[File:GumstixEclipse6.jpg]]

:* click "Next" twice
:* select the radio button to "ACCEPT" the terms of the license agreement
:* click "OK" at the security warning window
:* click "Finish" to complete installation
:* choose the "Yes" button to restart Eclipse for the changes to take effect

==Connect Your Gumstix==
Now it is time to connect your Gumstix---let's get started by establishing a console connection.
:* mount your Gumstix COM down on to your expansion board
:* plug the mini-A USB plug into the port marked CONSOLE and end of the cable into a standard USB port on your computer

----
Hint:
Your computer should detect your Gumstix system when you first connect the USB cable, even though the power is not yet turned on. On Macintosh and Windows systems, a pop-up window should appear instructing you to download a new driver (do so) or notifying you that a USBserial device has been detected. If not, you can download drivers from [http://www.ftdichip.com/FTDrivers.htm this site]. Choose the "VCP" driver.
Once you have downloaded this driver, make sure to unplug and then replug the USB cable running from your computer to your Gumstix expansion board so the Gumstix will be recognized by your computer.
----

:* connect your Gumstix to the internet using an ethernet cable
NOTE: You still have NOT plugged the power cable in to the Gumstix expansion board! This diagram shows the locations
of the USB 'CONSOLE' port and the 'POWER' input port on a Summit board on which an Overo COM has been mounted.

[[File:GumstixEclipse7.jpg]]

:* if you are booting from a microSD card, insert this card now until you hear it click in place.
Before applying power to the board, let's open up a connection to the console port.
In Eclipse,
:* navigate to '''Window->Show View->Other->Terminal->Terminal'''
:* click on the 'N' connection icon in the window that appears

[[File:GumstixEclipse8.jpg]]

:* make the connection using the following settings:
Connection Type: Serial
Port: <port to which your Gumstix is connected>
Baud Rate: 115200
Data Bits: 8
Stop Bits: 1
Parity: none
Flow Control: none
Timeout: 5

----
Hint:
The port to which your Gumstix is connected will have a different name depending on your Host operating system.
:* On Windows, it should be ''USB-COM''
:* On Macintosh, it should be ''/dev/cu.usbserial-xxxxxxxx'' where ''xxxxxxxx'' is an arbitrary string of characters
:* On Linux, it should be ''/dev/ttyUSBx'' where ''x'' is a number.
----

[[File:GumstixEclipse9.jpg]]

Now, it's time to apply power to the Gumstix expansion board so plug the 5V wall adapter into the power input jack on the Gumstix.
You should see text appear in this window; for now, just let the Gumstix boot. When prompted, you can log in to the root account. The default credentials are:

'''Overo'''

username: root

password: <leave blank>

'''VerdexPro'''

username: root

password: gumstix

==Write 'Hello, World' à la Python==

You are going to write a basic Python program for the Gumstix directly on the Gumstix; this is known as native development. Also, Python is an interpreted language which means you can run your programs directly without any compilation.

Once you have logged into your Gumstix, do these steps in the terminal window within Eclipse:
:* open an editor on the Gumstix by typing: 'nano hello.py'
:* type out this simple Python program: ''print "Hello, Gumstix!"''
:* press Ctrl+O, <Enter>
:* then press Ctrl+X to save and exit.
:* run your program by typing: ''python hello.py''
:* check that you see the words "Hello, Gumstix!" appear

If you see the words "Hello Gumstix", then you have just written your first program on a Gumstix Overo computer.

==Create a Web Site==
Each Gumstix comes with a built-in package manager called opkg. A package manager is a useful tool for installing software; you can install everything from media players to GPS mapping tools to the Firefox web browser. In this example, you'll use opkg tool to install a new application for your Gumstix: the Apache web server.

To make your own Gumstix web site, type the following in the terminal window:
opkg update <Enter>
opkg install apache2 <Enter>
Before you start using Apache, which is now running, you'll need to find the IP address (internet address) of your Gumstix COM. To do this, type the following command into the terminal window:
ifconfig | grep 'inet addr' <Enter>
You should see something like this appear on your screen.
inet addr: 10.0.1.73 Bcast: 192.168.0.255 Mask: 255.255.255.0
The IP address of your Gumstix is the first address shown: ''10.0.1.73'' in this case.
Now,
:* open up a web browser on your host computer
:* type that IP address of your Gumstix into the address bar
You should see something like this which is the default web site for Apache running on your Gumstix.

[[File:GumstixEclipse10.jpg]]

To make your web site say something more interesting, do the follow in your terminal window:
:* type: ''nano /usr/share/apache2/htdocs/index.html''
:* replace the words at the top of the screen "It Works" with the words "Gumstix Rocks!"
:* press 'Ctrl+O' <Enter>
:* press 'Ctrl+X' to save and exit
:* refresh your web browser

==Write a Java Application==
So far, you haven't actually used Eclipse other than as a console interface for your Gumstix. It is time to harness the power of Eclipse to write a small graphical Java application.
In Eclipse.
:* Navigate to '''File-> New-> Java Project''',
:* Name the project ''gumstix-java''
:* Select "Finish"
Once the project is created,
:* Select '''File->New->Class'''
:* Name your class ''Hello''
:* click "FINISH"

Add the following code to your class:

import javax.swing.JFrame;
import javax.swing.JLabel;
public class Hello {
public static void main(String [] args) {
JFrame frame = new JFrame("hello");
final JLabel label = new JLabel("hello from Gumstix");
frame.getContentPane().add(label);
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.pack();
frame.setVisible(true);
}
}

You should get something that looks like this:

[[File:GumstixEclipse11.jpg]]

Press the green run button to test drive our application on our host machine.

----
Hint:
Eclipse has many auto-completion features. Simply typing /:*<Enter> before a class creates a standard documentation block. Likewise, pressing <Ctrl>+<Space> provides context specific auto-completion options. Many other hints for speedy development are explained in the tutorials [http://www.eclipse.org/resources/?category=Getting%20Started here].
----

==Upload Code==
In Step 5 we discovered the IP address of our Gumstix. With this, we can connect to our Gumstix using the SSH protocol which allows us to rapidly transfer files. For this step, navigate to '''Window->Open Perspective->Other->Remote System Explorer''' and click on the connection icon in the ''Remote Systems'' panel on the left. Select ''SSH without shells'' as the connection type and press Next. Put the internet address you found in Step 5 into the field marked ''Host Name'' and hit finish. To test that everything is working correctly, right-click on the terminal item list under your new connection and select ''Launch Terminal''. A console interface exactly like the USB console interface we set up in Step 3 should pop up.

----
Hint:
A 'Perspective' is an arrangement of windows and widgets, that is a specific view of the Eclipse workspace, designed for a particular task. If you wish to focus on any particular widget, double click the tab in Eclipse; return to the previous view by double-clicking again.
----

By installing the VNC viewer plugin, we can get a graphical interface to our Gumstix system. Do this by adding the ''Tools for mobile linux runtime'' plugin ('''Help->Install New Software''') from the main update site. To use, select the VNC viewer widget from '''Window->Show View->Other->VNC Category->VNC''' and click on the ''New Connection'' icon in the VNC Viewer panel. Again, the ''Host'' is the internet address of your Gumstix board.

[[File:GumstixEclipse12.jpg]]

Finally, we need to upload our java code before we can run it. Switch back to the Java Perspective ('''Window->Open Perspective->Java''') and right-click on our Java file and selecting Export. Choose the option to export file to a remote file system and choose to upload your ''Hello.class'' file.

[[File:GumstixEclipse13.jpg]]

You will need to ''Browse'' to find your Gumstix board; you should upload this code to your home directory on the Gumstix.

==Debug a Java Application==
We can debug our java application remotely from Eclipse. To do this, we need a Java Virtual Machine capable of doing debugging. This time, the package we need isn't available in our package sources however we can fetch the package directly from a web site and install it using the same opkg package management tool.
wget http://bugcommunity.com/downloads/files/phonemeadvanced- personal-debug_mr2-r1_armv6.ipk <Enter>
opkg install -force-depends phoneme-advanced-personaldebug_mr2-r1_armv6.ipk <Enter>
Let's also update our Java libraries so we have access to the standard graphical libraries.
opkg install classpath-gtk <Enter>
Next, let's start our Java code in debugging mode on the Overo:
java-cdc -Xdebug -Xrunjwdp:transport=dHt_socket,server=y,suspend=y,address=1234 Hello <Enter>
Finally, let's connect to our debugging session by navigating in Eclipse to '''Run->Debug Configurations''' and double-clicking on Remote Java Application to create a new configuration. Fill in the form as shown below using the internet address found in the previous step.

==Install a native C/C++ SDK==
When we discussed Python and Java we noted that both are interpreted languages--- neither needs to be compiled. C and C++ code requires compilation which can be done natively---on the Gumstix itself---or on a development machine using a cross-compiler. To do native compilation, you need to install a compiler as well as any required libraries. You'll need to be booting from a microSD card as this installation takes approximately 75MB of space.
$ echo 'src/gz angstrom-base http://www.angstromdistribution.org/feeds/unstable/ipk/glibc/armv7a/base' > /etc/opkg/angstrom-base.conf
$ opkg update
$ opkg install task-native-sdk
Firstly, we are adding a new package repository to our package manager and updating our list of available packages before actually installing the complete package needed to do native development.

Let's create either of the following files in Eclipse, upload the code and then compile on the Gumstix using our newly installed compiler.

===C++: HelloWorld.cpp===
#include <iostream>
using namespace std;
int main () {
cout << "Gumstix runs on C++" << endl;
return 0;
}

Save the file and issue the following commands to compile and run HelloWorld.cpp
g++ -o hello hello.cpp <enter>
Gumstix runs on C++ <enter>

===C: HelloWorld.c===
#include <stdio.h>
int main () {
printf("Gumstix runs on C\n");
return 0;
}

Save the file and issue the following commands to compile and run HelloWorld.c
gcc -o hello hello.c
Gumstix runs on C

<TODO: More exciting examples using on-board LEDs.>

==Use a C/C++ cross-compiler and debugger==
In order to do C/C++ development on our host machine, we need to add in a plugin to Eclipse. Also, we need to download an appropriate cross-compilation toolchain. For now, I recommend the lovely instructions from

http://www.designarm.com/quickstart-guide/linux-software/eclipse.html &

http://www.bugcommunity.com/wiki/index.php/BUG_Kernel_Development_with_Eclipse

===Further Reading===
:* Tutorials built into Eclipse
:* Bitbake commander
:* OpenEmebedded|Poky docs + Bitbake docs
:* Eclipse Plugin Tutorial

[[Category:How_to_-_eclipse]]

Eclipse on Gumstix for new users

2010-07-20T16:42:17Z

IanPhillips:

This guide provides step-by-step instructions for using the Eclipse Integrated Development Environment (IDE) to develop applications for the Gumstix COMs.

We'll walk through these tasks:
:* setting up Eclipse
:* connection to your Gumstix system
:* creating a simple "Hello, World!" Python program
:* running a web server
:* installing new packages on your Gumstix
:* creating a small graphical Java application
:* remote debugging of your Java application
:* natively-compiling C/C++ code on your Gumstix
:* remote debugging C/C++ using the GDB server interface

We will also explain how to set up a cross-compilation toolchain so you can develop C/C++ applications on your development computer and upload them to your Gumstix.

Remember, Gumstix COMs are fully-fledged, albeit tiny, Linux systems so there are many tools we don't cover here. For example, [http://wiki.openembedded.net/index.php/OpenEmbedded_Tools_for_Eclipse_(OTE) this document] explains how to use the powerful OpenEmbedded build system within Eclipse.

Required Tools:
:* any Windows, Apple or Linux computer with a USB port
:* recent version of the Java Runtime Environment (available [http://java.sun.com/javase/downloads/index.jsp here])
:* a Gumstix COM running [http://www.gumstix.net/Setup-and-Programming/view/Overo-Setup-and-Programming/Downloading-pre-built-images/111.html up-to-date software]
:* any expansion board of the Gumstix Overo series, such as Chestnut or Tobi, that has both a USB console port and a 10/100
:* Ethernet jack
:* a 5V power supply
:* an ethernet cable and internet connection
:* a mini-A to Standard-A USB cable
:* a [http://www.gumstix.net/Setup-and-Programming/view/Overo-Setup-and-Programming/Creating-a-bootable-microSD-card/111.html bootable microSD card] (only needed for native C/C++ compilation)

==Download Eclipse==
[http://www.eclipse.org/downloads/ Download] the Eclipse IDE for Java Developers for your Operating System: www.eclipse.org

[[image:GumstixEclipse1.jpg | thumb]]

:* it is ''not'' necessary to install the Eclipse software; just double-click on the application once it has finished downloading
:* when prompted, choose a workspace folder in which you want to store your projects and your configuration information
:* then click through to the Eclipse workbench itself

==Install Plugins==
For developers, a great variety of additional features can be added to Eclipse from various repositories of plug-ins known as ''Update Sites''.
To install a new plugin in Eclipse, first select the ''Update Site''.
:* navigate to '''Help->Install New Software...'''
:* select the update site for your version of Eclipse from the "Work with"dropdown menu

[[Image: GumstixEclipse2.jpg | thumb | left]]

----
Hint:
If the update site is not available, you can add it by clicking the 'Add...' button on the right. For the Galileo release, you can use the URL http://dowload.eclipse.org/releases/galileo
----

As we are working with a remote system, we'll install the Remote System Explorer plugin.
:* search for the ''Remote System Explorer End-User Runtime'' plugin
:* select it for installation

[[File:GumstixEclipse3.jpg]]

Still in Eclipse,
:* select "Next".... twice
:* select the radio button to "ACCEPT" the terms of the license agreement
:* choose "Yes" to restart Eclipse for the changes to take effect

Once Eclipse has restarted, let's add two other useful plugins that allow connection to the console port of our Gumstix without needing a terminal emulator program such as kermit or TeraTerm.
From within Eclipse,
:* navigate to '''Help->Install New Software'''
:* search on "Target" to find the ''Target Manager Terminal''

[[File:GumstixEclipse4.jpg]]

:* select the ''Target Manager Terminal''
:* click "Next"
:* click "Finish" to complete installation
:* choose "Yes" to restart Eclipse for the changes to take effect

We'll also need to add a new update site by doing these steps in Eclipse:
:* navigate to '''Help->Install New Software...'''
:* click the "Add..." button
:* type ''http://rxtx.qbang.org/eclipse'' into the ''Location'' field and create a name

[[File:GumstixEclipse5.jpg]]

:* Click the "OK" button
Go into the sub-directory as shown below to select the ''RXTX End-User Runtime'' plugin that this site provides.

[[File:GumstixEclipse6.jpg]]

:* click "Next" twice
:* select the radio button to "ACCEPT" the terms of the license agreement
:* click "OK" at the security warning window
:* click "Finish" to complete installation
:* choose the "Yes" button to restart Eclipse for the changes to take effect

==Connect Your Gumstix==
Now it is time to connect your Gumstix---let's get started by establishing a console connection.
:* mount your Gumstix COM down on to your expansion board
:* plug the mini-A USB plug into the port marked CONSOLE and end of the cable into a standard USB port on your computer

----
Hint:
Your computer should detect your Gumstix system when you first connect the USB cable, even though the power is not yet turned on. On Macintosh and Windows systems, a pop-up window should appear instructing you to download a new driver (do so) or notifying you that a USBserial device has been detected. If not, you can download drivers from [http://www.ftdichip.com/FTDrivers.htm this site]. Choose the "VCP" driver.
Once you have downloaded this driver, make sure to unplug and then replug the USB cable running from your computer to your Gumstix expansion board so the Gumstix will be recognized by your computer.
----

:* connect your Gumstix to the internet using an ethernet cable
NOTE: You still have NOT plugged the power cable in to the Gumstix expansion board! This diagram shows the locations
of the USB 'CONSOLE' port and the 'POWER' input port on a Summit board on which an Overo COM has been mounted.

[[File:GumstixEclipse7.jpg]]

:* if you are booting from a microSD card, insert this card now until you hear it click in place.
Before applying power to the board, let's open up a connection to the console port.
In Eclipse,
:* navigate to '''Window->Show View->Other->Terminal->Terminal'''
:* click on the 'N' connection icon in the window that appears

[[File:GumstixEclipse8.jpg]]

:* make the connection using the following settings:
Connection Type: Serial
Port: <port to which your Gumstix is connected>
Baud Rate: 115200
Data Bits: 8
Stop Bits: 1
Parity: none
Flow Control: none
Timeout: 5

----
Hint:
The port to which your Gumstix is connected will have a different name depending on your Host operating system.
:* On Windows, it should be ''USB-COM''
:* On Macintosh, it should be ''/dev/cu.usbserial-xxxxxxxx'' where ''xxxxxxxx'' is an arbitrary string of characters
:* On Linux, it should be ''/dev/ttyUSBx'' where ''x'' is a number.
----

[[File:GumstixEclipse9.jpg]]

Now, it's time to apply power to the Gumstix expansion board so plug the 5V wall adapter into the power input jack on the Gumstix.
You should see text appear in this window; for now, just let the Gumstix boot. When prompted, you can log in to the root account. The default credentials are:

'''Overo'''

username: root

password: <leave blank>

'''VerdexPro'''

username: root

password: gumstix

==Write 'Hello, World' à la Python==

You are going to write a basic Python program for the Gumstix directly on the Gumstix; this is known as native development. Also, Python is an interpreted language which means you can run your programs directly without any compilation.

Once you have logged into your Gumstix, do these steps in the terminal window within Eclipse:
:* open an editor on the Gumstix by typing: 'nano hello.py'
:* type out this simple Python program: ''print "Hello, Gumstix!"''
:* press Ctrl+O, <Enter>
:* then press Ctrl+X to save and exit.
:* run your program by typing: ''python hello.py''
:* check that you see the words "Hello, Gumstix!" appear

If you see the words "Hello Gumstix", then you have just written your first program on a Gumstix Overo computer.

==Create a Web Site==
Each Gumstix comes with a built-in package manager called opkg. A package manager is a useful tool for installing software; you can install everything from media players to GPS mapping tools to the Firefox web browser. In this example, you'll use opkg tool to install a new application for your Gumstix: the Apache web server.

To make your own Gumstix web site, type the following in the terminal window:
opkg update <Enter>
opkg install apache2 <Enter>
Before you start using Apache, which is now running, you'll need to find the IP address (internet address) of your Gumstix COM. To do this, type the following command into the terminal window:
ifconfig | grep 'inet addr' <Enter>
You should see something like this appear on your screen.
inet addr: 10.0.1.73 Bcast: 192.168.0.255 Mask: 255.255.255.0
The IP address of your Gumstix is the first address shown: ''10.0.1.73'' in this case.
Now,
:* open up a web browser on your host computer
:* type that IP address of your Gumstix into the address bar
You should see something like this which is the default web site for Apache running on your Gumstix.

[[File:GumstixEclipse10.jpg]]

To make your web site say something more interesting, do the follow in your terminal window:
:* type: ''nano /usr/share/apache2/htdocs/index.html''
:* replace the words at the top of the screen "It Works" with the words "Gumstix Rocks!"
:* press 'Ctrl+O' <Enter>
:* press 'Ctrl+X' to save and exit
:* refresh your web browser

==Write a Java Application==
So far, you haven't actually used Eclipse other than as a console interface for your Gumstix. It is time to harness the power of Eclipse to write a small graphical Java application.
In Eclipse.
:* Navigate to '''File-> New-> Java Project''',
:* Name the project ''gumstix-java''
:* Select "Finish"
Once the project is created,
:* Select '''File->New->Class'''
:* Name your class ''Hello''
:* click "FINISH"

Add the following code to your class:

import javax.swing.JFrame;
import javax.swing.JLabel;
public class Hello {
public static void main(String [] args) {
JFrame frame = new JFrame("hello");
final JLabel label = new JLabel("hello from Gumstix");
frame.getContentPane().add(label);
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.pack();
frame.setVisible(true);
}
}

You should get something that looks like this:

[[File:GumstixEclipse11.jpg]]

Press the green run button to test drive our application on our host machine.

----
Hint:
Eclipse has many auto-completion features. Simply typing /:*<Enter> before a class creates a standard documentation block. Likewise, pressing <Ctrl>+<Space> provides context specific auto-completion options. Many other hints for speedy development are explained in the tutorials [http://www.eclipse.org/resources/?category=Getting%20Started here].
----

==Upload Code==
In Step 5 we discovered the IP address of our Gumstix. With this, we can connect to our Gumstix using the SSH protocol which allows us to rapidly transfer files. For this step, navigate to '''Window->Open Perspective->Other->Remote System Explorer''' and click on the connection icon in the ''Remote Systems'' panel on the left. Select ''SSH without shells'' as the connection type and press Next. Put the internet address you found in Step 5 into the field marked ''Host Name'' and hit finish. To test that everything is working correctly, right-click on the terminal item list under your new connection and select ''Launch Terminal''. A console interface exactly like the USB console interface we set up in Step 3 should pop up.

----
Hint:
A 'Perspective' is an arrangement of windows and widgets, that is a specific view of the Eclipse workspace, designed for a particular task. If you wish to focus on any particular widget, double click the tab in Eclipse; return to the previous view by double-clicking again.
----

By installing the VNC viewer plugin, we can get a graphical interface to our Gumstix system. Do this by adding the ''Tools for mobile linux runtime'' plugin ('''Help->Install New Software''') from the main update site. To use, select the VNC viewer widget from '''Window->Show View->Other->VNC Category->VNC''' and click on the ''New Connection'' icon in the VNC Viewer panel. Again, the ''Host'' is the internet address of your Gumstix board.

[[File:GumstixEclipse12.jpg]]

Finally, we need to upload our java code before we can run it. Switch back to the Java Perspective ('''Window->Open Perspective->Java''') and right-click on our Java file and selecting Export. Choose the option to export file to a remote file system and choose to upload your ''Hello.class'' file.

[[File:GumstixEclipse13.jpg]]

You will need to ''Browse'' to find your Gumstix board; you should upload this code to your home directory on the Gumstix.

==Debug a Java Application==
We can debug our java application remotely from Eclipse. To do this, we need a Java Virtual Machine capable of doing debugging. This time, the package we need isn't available in our package sources however we can fetch the package directly from a web site and install it using the same opkg package management tool.
wget http://bugcommunity.com/downloads/files/phonemeadvanced- personal-debug_mr2-r1_armv6.ipk <Enter>
opkg install -force-depends phoneme-advanced-personaldebug_mr2-r1_armv6.ipk <Enter>
Let's also update our Java libraries so we have access to the standard graphical libraries.
opkg install classpath-gtk <Enter>
Next, let's start our Java code in debugging mode on the Overo:
java-cdc -Xdebug -Xrunjwdp:transport=dHt_socket,server=y,suspend=y,address=1234 Hello <Enter>
Finally, let's connect to our debugging session by navigating in Eclipse to '''Run->Debug Configurations''' and double-clicking on Remote Java Application to create a new configuration. Fill in the form as shown below using the internet address found in the previous step.

==Install a native C/C++ SDK==
When we discussed Python and Java we noted that both are interpreted languages--- neither needs to be compiled. C and C++ code requires compilation which can be done natively---on the Gumstix itself---or on a development machine using a cross-compiler. To do native compilation, you need to install a compiler as well as any required libraries. You'll need to be booting from a microSD card as this installation takes approximately 75MB of space.
$ echo 'src/gz angstrom-base http://www.angstromdistribution.org/feeds/unstable/ipk/glibc/armv7a/base' > /etc/opkg/angstrom-base.conf
$ opkg update
$ opkg install task-native-sdk
Firstly, we are adding a new package repository to our package manager and updating our list of available packages before actually installing the complete package needed to do native development.

Let's create either of the following files in Eclipse, upload the code and then compile on the Gumstix using our newly installed compiler.

===C++: HelloWorld.cpp===
#include <iostream>
using namespace std;
int main () {
cout << "Gumstix runs on C++" << endl;
return 0;
}

Save the file and issue the following commands to compile and run HelloWorld.cpp
g++ -o hello hello.cpp <enter>
Gumstix runs on C++ <enter>

===C: HelloWorld.c===
#include <stdio.h>
int main () {
printf("Gumstix runs on C\n");
return 0;
}

Save the file and issue the following commands to compile and run HelloWorld.c
gcc -o hello hello.c
Gumstix runs on C

<TODO: More exciting examples using on-board LEDs.>

==Use a C/C++ cross-compiler and debugger==
In order to do C/C++ development on our host machine, we need to add in a plugin to Eclipse. Also, we need to download an appropriate cross-compilation toolchain. For now, I recommend the lovely instructions from

http://www.designarm.com/quickstart-guide/linux-software/eclipse.html &

http://www.bugcommunity.com/wiki/index.php/BUG_Kernel_Development_with_Eclipse

===Further Reading===
:* Tutorials built into Eclipse
:* Bitbake commander
:* OpenEmebedded|Poky docs + Bitbake docs
:* Eclipse Plugin Tutorial

[[Category:How_to_-_eclipse]]

Eclipse on Gumstix for new users

2010-07-20T16:41:00Z

IanPhillips:

This guide provides step-by-step instructions for using the Eclipse Integrated Development Environment (IDE) to develop applications for the Gumstix COMs.

We'll walk through these tasks:
:* setting up Eclipse
:* connection to your Gumstix system
:* creating a simple "Hello, World!" Python program
:* running a web server
:* installing new packages on your Gumstix
:* creating a small graphical Java application
:* remote debugging of your Java application
:* natively-compiling C/C++ code on your Gumstix
:* remote debugging C/C++ using the GDB server interface

We will also explain how to set up a cross-compilation toolchain so you can develop C/C++ applications on your development computer and upload them to your Gumstix.

Remember, Gumstix COMs are fully-fledged, albeit tiny, Linux systems so there are many tools we don't cover here. For example, [http://wiki.openembedded.net/index.php/OpenEmbedded_Tools_for_Eclipse_(OTE) this document] explains how to use the powerful OpenEmbedded build system within Eclipse.

Required Tools:
:* any Windows, Apple or Linux computer with a USB port
:* recent version of the Java Runtime Environment (available [http://java.sun.com/javase/downloads/index.jsp here])
:* a Gumstix COM running [http://www.gumstix.net/Setup-and-Programming/view/Overo-Setup-and-Programming/Downloading-pre-built-images/111.html up-to-date software]
:* any expansion board of the Gumstix Overo series, such as Chestnut or Tobi, that has both a USB console port and a 10/100
:* Ethernet jack
:* a 5V power supply
:* an ethernet cable and internet connection
:* a mini-A to Standard-A USB cable
:* a [http://www.gumstix.net/Setup-and-Programming/view/Overo-Setup-and-Programming/Creating-a-bootable-microSD-card/111.html bootable microSD card] (only needed for native C/C++ compilation)

==Download Eclipse==
[http://www.eclipse.org/downloads/ Download] the Eclipse IDE for Java Developers for your Operating System: www.eclipse.org

[[File:GumstixEclipse1.jpg | thumb]]

:* it is ''not'' necessary to install the Eclipse software; just double-click on the application once it has finished downloading
:* when prompted, choose a workspace folder in which you want to store your projects and your configuration information
:* then click through to the Eclipse workbench itself

==Install Plugins==
For developers, a great variety of additional features can be added to Eclipse from various repositories of plug-ins known as ''Update Sites''.
To install a new plugin in Eclipse, first select the ''Update Site''.
:* navigate to '''Help->Install New Software...'''
:* select the update site for your version of Eclipse from the "Work with"dropdown menu

[[Image: GumstixEclipse2.jpg | thumb | left]]

----
Hint:
If the update site is not available, you can add it by clicking the 'Add...' button on the right. For the Galileo release, you can use the URL http://dowload.eclipse.org/releases/galileo
----

As we are working with a remote system, we'll install the Remote System Explorer plugin.
:* search for the ''Remote System Explorer End-User Runtime'' plugin
:* select it for installation

[[File:GumstixEclipse3.jpg]]

Still in Eclipse,
:* select "Next".... twice
:* select the radio button to "ACCEPT" the terms of the license agreement
:* choose "Yes" to restart Eclipse for the changes to take effect

Once Eclipse has restarted, let's add two other useful plugins that allow connection to the console port of our Gumstix without needing a terminal emulator program such as kermit or TeraTerm.
From within Eclipse,
:* navigate to '''Help->Install New Software'''
:* search on "Target" to find the ''Target Manager Terminal''

[[File:GumstixEclipse4.jpg]]

:* select the ''Target Manager Terminal''
:* click "Next"
:* click "Finish" to complete installation
:* choose "Yes" to restart Eclipse for the changes to take effect

We'll also need to add a new update site by doing these steps in Eclipse:
:* navigate to '''Help->Install New Software...'''
:* click the "Add..." button
:* type ''http://rxtx.qbang.org/eclipse'' into the ''Location'' field and create a name

[[File:GumstixEclipse5.jpg]]

:* Click the "OK" button
Go into the sub-directory as shown below to select the ''RXTX End-User Runtime'' plugin that this site provides.

[[File:GumstixEclipse6.jpg]]

:* click "Next" twice
:* select the radio button to "ACCEPT" the terms of the license agreement
:* click "OK" at the security warning window
:* click "Finish" to complete installation
:* choose the "Yes" button to restart Eclipse for the changes to take effect

==Connect Your Gumstix==
Now it is time to connect your Gumstix---let's get started by establishing a console connection.
:* mount your Gumstix COM down on to your expansion board
:* plug the mini-A USB plug into the port marked CONSOLE and end of the cable into a standard USB port on your computer

----
Hint:
Your computer should detect your Gumstix system when you first connect the USB cable, even though the power is not yet turned on. On Macintosh and Windows systems, a pop-up window should appear instructing you to download a new driver (do so) or notifying you that a USBserial device has been detected. If not, you can download drivers from [http://www.ftdichip.com/FTDrivers.htm this site]. Choose the "VCP" driver.
Once you have downloaded this driver, make sure to unplug and then replug the USB cable running from your computer to your Gumstix expansion board so the Gumstix will be recognized by your computer.
----

:* connect your Gumstix to the internet using an ethernet cable
NOTE: You still have NOT plugged the power cable in to the Gumstix expansion board! This diagram shows the locations
of the USB 'CONSOLE' port and the 'POWER' input port on a Summit board on which an Overo COM has been mounted.

[[File:GumstixEclipse7.jpg]]

:* if you are booting from a microSD card, insert this card now until you hear it click in place.
Before applying power to the board, let's open up a connection to the console port.
In Eclipse,
:* navigate to '''Window->Show View->Other->Terminal->Terminal'''
:* click on the 'N' connection icon in the window that appears

[[File:GumstixEclipse8.jpg]]

:* make the connection using the following settings:
Connection Type: Serial
Port: <port to which your Gumstix is connected>
Baud Rate: 115200
Data Bits: 8
Stop Bits: 1
Parity: none
Flow Control: none
Timeout: 5

----
Hint:
The port to which your Gumstix is connected will have a different name depending on your Host operating system.
:* On Windows, it should be ''USB-COM''
:* On Macintosh, it should be ''/dev/cu.usbserial-xxxxxxxx'' where ''xxxxxxxx'' is an arbitrary string of characters
:* On Linux, it should be ''/dev/ttyUSBx'' where ''x'' is a number.
----

[[File:GumstixEclipse9.jpg]]

Now, it's time to apply power to the Gumstix expansion board so plug the 5V wall adapter into the power input jack on the Gumstix.
You should see text appear in this window; for now, just let the Gumstix boot. When prompted, you can log in to the root account. The default credentials are:

'''Overo'''

username: root

password: <leave blank>

'''VerdexPro'''

username: root

password: gumstix

==Write 'Hello, World' à la Python==

You are going to write a basic Python program for the Gumstix directly on the Gumstix; this is known as native development. Also, Python is an interpreted language which means you can run your programs directly without any compilation.

Once you have logged into your Gumstix, do these steps in the terminal window within Eclipse:
:* open an editor on the Gumstix by typing: 'nano hello.py'
:* type out this simple Python program: ''print "Hello, Gumstix!"''
:* press Ctrl+O, <Enter>
:* then press Ctrl+X to save and exit.
:* run your program by typing: ''python hello.py''
:* check that you see the words "Hello, Gumstix!" appear

If you see the words "Hello Gumstix", then you have just written your first program on a Gumstix Overo computer.

==Create a Web Site==
Each Gumstix comes with a built-in package manager called opkg. A package manager is a useful tool for installing software; you can install everything from media players to GPS mapping tools to the Firefox web browser. In this example, you'll use opkg tool to install a new application for your Gumstix: the Apache web server.

To make your own Gumstix web site, type the following in the terminal window:
opkg update <Enter>
opkg install apache2 <Enter>
Before you start using Apache, which is now running, you'll need to find the IP address (internet address) of your Gumstix COM. To do this, type the following command into the terminal window:
ifconfig | grep 'inet addr' <Enter>
You should see something like this appear on your screen.
inet addr: 10.0.1.73 Bcast: 192.168.0.255 Mask: 255.255.255.0
The IP address of your Gumstix is the first address shown: ''10.0.1.73'' in this case.
Now,
:* open up a web browser on your host computer
:* type that IP address of your Gumstix into the address bar
You should see something like this which is the default web site for Apache running on your Gumstix.

[[File:GumstixEclipse10.jpg]]

To make your web site say something more interesting, do the follow in your terminal window:
:* type: ''nano /usr/share/apache2/htdocs/index.html''
:* replace the words at the top of the screen "It Works" with the words "Gumstix Rocks!"
:* press 'Ctrl+O' <Enter>
:* press 'Ctrl+X' to save and exit
:* refresh your web browser

==Write a Java Application==
So far, you haven't actually used Eclipse other than as a console interface for your Gumstix. It is time to harness the power of Eclipse to write a small graphical Java application.
In Eclipse.
:* Navigate to '''File-> New-> Java Project''',
:* Name the project ''gumstix-java''
:* Select "Finish"
Once the project is created,
:* Select '''File->New->Class'''
:* Name your class ''Hello''
:* click "FINISH"

Add the following code to your class:

import javax.swing.JFrame;
import javax.swing.JLabel;
public class Hello {
public static void main(String [] args) {
JFrame frame = new JFrame("hello");
final JLabel label = new JLabel("hello from Gumstix");
frame.getContentPane().add(label);
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.pack();
frame.setVisible(true);
}
}

You should get something that looks like this:

[[File:GumstixEclipse11.jpg]]

Press the green run button to test drive our application on our host machine.

----
Hint:
Eclipse has many auto-completion features. Simply typing /:*<Enter> before a class creates a standard documentation block. Likewise, pressing <Ctrl>+<Space> provides context specific auto-completion options. Many other hints for speedy development are explained in the tutorials [http://www.eclipse.org/resources/?category=Getting%20Started here].
----

==Upload Code==
In Step 5 we discovered the IP address of our Gumstix. With this, we can connect to our Gumstix using the SSH protocol which allows us to rapidly transfer files. For this step, navigate to '''Window->Open Perspective->Other->Remote System Explorer''' and click on the connection icon in the ''Remote Systems'' panel on the left. Select ''SSH without shells'' as the connection type and press Next. Put the internet address you found in Step 5 into the field marked ''Host Name'' and hit finish. To test that everything is working correctly, right-click on the terminal item list under your new connection and select ''Launch Terminal''. A console interface exactly like the USB console interface we set up in Step 3 should pop up.

----
Hint:
A 'Perspective' is an arrangement of windows and widgets, that is a specific view of the Eclipse workspace, designed for a particular task. If you wish to focus on any particular widget, double click the tab in Eclipse; return to the previous view by double-clicking again.
----

By installing the VNC viewer plugin, we can get a graphical interface to our Gumstix system. Do this by adding the ''Tools for mobile linux runtime'' plugin ('''Help->Install New Software''') from the main update site. To use, select the VNC viewer widget from '''Window->Show View->Other->VNC Category->VNC''' and click on the ''New Connection'' icon in the VNC Viewer panel. Again, the ''Host'' is the internet address of your Gumstix board.

[[File:GumstixEclipse12.jpg]]

Finally, we need to upload our java code before we can run it. Switch back to the Java Perspective ('''Window->Open Perspective->Java''') and right-click on our Java file and selecting Export. Choose the option to export file to a remote file system and choose to upload your ''Hello.class'' file.

[[File:GumstixEclipse13.jpg]]

You will need to ''Browse'' to find your Gumstix board; you should upload this code to your home directory on the Gumstix.

==Debug a Java Application==
We can debug our java application remotely from Eclipse. To do this, we need a Java Virtual Machine capable of doing debugging. This time, the package we need isn't available in our package sources however we can fetch the package directly from a web site and install it using the same opkg package management tool.
wget http://bugcommunity.com/downloads/files/phonemeadvanced- personal-debug_mr2-r1_armv6.ipk <Enter>
opkg install -force-depends phoneme-advanced-personaldebug_mr2-r1_armv6.ipk <Enter>
Let's also update our Java libraries so we have access to the standard graphical libraries.
opkg install classpath-gtk <Enter>
Next, let's start our Java code in debugging mode on the Overo:
java-cdc -Xdebug -Xrunjwdp:transport=dHt_socket,server=y,suspend=y,address=1234 Hello <Enter>
Finally, let's connect to our debugging session by navigating in Eclipse to '''Run->Debug Configurations''' and double-clicking on Remote Java Application to create a new configuration. Fill in the form as shown below using the internet address found in the previous step.

==Install a native C/C++ SDK==
When we discussed Python and Java we noted that both are interpreted languages--- neither needs to be compiled. C and C++ code requires compilation which can be done natively---on the Gumstix itself---or on a development machine using a cross-compiler. To do native compilation, you need to install a compiler as well as any required libraries. You'll need to be booting from a microSD card as this installation takes approximately 75MB of space.
$ echo 'src/gz angstrom-base http://www.angstromdistribution.org/feeds/unstable/ipk/glibc/armv7a/base' > /etc/opkg/angstrom-base.conf
$ opkg update
$ opkg install task-native-sdk
Firstly, we are adding a new package repository to our package manager and updating our list of available packages before actually installing the complete package needed to do native development.

Let's create either of the following files in Eclipse, upload the code and then compile on the Gumstix using our newly installed compiler.

===C++: HelloWorld.cpp===
#include <iostream>
using namespace std;
int main () {
cout << "Gumstix runs on C++" << endl;
return 0;
}

Save the file and issue the following commands to compile and run HelloWorld.cpp
g++ -o hello hello.cpp <enter>
Gumstix runs on C++ <enter>

===C: HelloWorld.c===
#include <stdio.h>
int main () {
printf("Gumstix runs on C\n");
return 0;
}

Save the file and issue the following commands to compile and run HelloWorld.c
gcc -o hello hello.c
Gumstix runs on C

<TODO: More exciting examples using on-board LEDs.>

==Use a C/C++ cross-compiler and debugger==
In order to do C/C++ development on our host machine, we need to add in a plugin to Eclipse. Also, we need to download an appropriate cross-compilation toolchain. For now, I recommend the lovely instructions from

http://www.designarm.com/quickstart-guide/linux-software/eclipse.html &

http://www.bugcommunity.com/wiki/index.php/BUG_Kernel_Development_with_Eclipse

===Further Reading===
:* Tutorials built into Eclipse
:* Bitbake commander
:* OpenEmebedded|Poky docs + Bitbake docs
:* Eclipse Plugin Tutorial

[[Category:How_to_-_eclipse]]