## For instruction on writing tutorials
## http://www.ros.org/wiki/WritingTutorials
####################################
##FILL ME IN
####################################
## for a custom note with links:
## note =
## for the canned note of "This tutorial assumes that you have completed the previous tutorials:" just add the links 
## note.0= 
## descriptive title for the tutorial
## title = How to install ROS Hydro on Intel Galileo 
## multi-line description to be displayed in search 
## description = This tutorial covers the installation of ROS Hydro on the Intel Galileo development board.
## the next tutorial description (optional)
## next=Start - Choose one:
## links to next tutorial (optional)
## next.0.link=[[IntelGalileo/Debian|The Debian Way]]
## next.1.link=[[IntelGalileo/HydroGalileoInitialInstall|The Yocto Way]]
## what level user is this tutorial for 
## level= IntermediateCategory
## keywords = Galileo Openembedded Yocto
####################################

<<IncludeCSTemplate(TutorialCSHeaderTemplate)>>

= Under construction =
Clearly, this page is still under construction and not ready for use
= Introduction =
This tutorial covers the installation of ROS Hydro on the Intel Galileo development board.  

Note that the Galileo board can also be used as an Arduino, simply running sketches, and communicating over USB to a host computer.  In this mode, the [[http://wiki.ros.org/rosserial_arduino|rosserial_arduino]] stack would be much simpler to use.

= About the board =
There are several ports on the Galileo board:
 * USB Client / Programming port - For interfacing to the Galileo as if it were an Arduino.  You can install sketches, and communicate via the Arduino serial libraries.  This is usb port closest to Ethernet
 * USB Host Port - I assume this acts as a USB port to the Quark processor, but I'm not sure. 
 * Serial port - The 1/8" jack (which looks like a headphone jack) next to the Ethernet port.
 * Ethernet - You should know what this looks like.

Note that you cannot log in to the Linux console via the USB port!  You'll either need to:
 1. Enable networking and SSH or telnet and log in via the Ethernet port (see [[https://communities.intel.com/message/208564#208564|this post]]) *OR*
 2. Buy or make a serial port adapter. (Here's one on amazon: [[http://www.amazon.com/gp/product/B004T9BBJC/ref=oh_details_o00_s00_i00?ie=UTF8&psc=1]], you may also need a serial-to-usb adapter)  This is not completely necessary, but really helps debugging when something goes wrong.

The Intel Galileo board runs Yocto Project Linux, based on the Open Embedded project.  This is more of a framework and collection of recipes for creating a Linux image, than it is a Linux distribution.

= Tutorials =

The following tutorials should be completed in order.  These should allow you to get ROS up and running on the Galileo board, as well as get you started on cross-compiling with the Yocto framework.

== The Debian way ==
This uses bootstrap to create a Debian image.  It's not Intel's supported distribution, but it's easier to use, and much easier to debug when things go wrong:
 * [[IntelGalileo/Debian|Start: The Debian way]]


== The Yocto way ==
This Yocto build is what Intel provides.  These tutorials are not quite as developed and may still have some errors:
 * [[IntelGalileo/HydroGalileoInitialInstall|Start: The Yocto Way - Initial image install]]
 * [[IntelGalileo/IntelGalileoYoctoAddingRos|Adding ROS to the image]]
 * [[IntelGalileo/IntelGalileoYoctoSetupOnGalileo|Setup on the Galileo]]
 * [[IntelGalileo/IntelGalileoYoctoPackages|Adding packages from the host]]
 * [[IntelGalileo/IntelGalileoYoctoAddingCode|Adding your own ROS code to the image]]
 * [[IntelGalileo/IntelGalileoYoctoNewLayer|Create your own layer]]

== GPIO programming ==
  * [[IntelGalileo/IntelGalileoGPIO|GPIO programming]]

= Links =
 * Intel's main Galileo learning page: [[http://www.intel.com/content/www/us/en/do-it-yourself/galileo-maker-quark-board.html]]
 * Intel's Galileo documentation page: https://communities.intel.com/community/makers/documentation/galileodocuments
 * ROS on open embedded: http://wiki.ros.org/hydro/Installation/OpenEmbedded
 * Sergey Kiselev's how-to page: http://www.malinov.com/Home/sergey-s-blog/intelgalileo-buildinglinuximage
 * How to enable telnet post: https://communities.intel.com/message/208564#208564
 * Yocto reference manual: http://www.yoctoproject.org/docs/current/ref-manual/ref-manual.html
 * Yocto project quick start: https://www.yoctoproject.org/docs/current/yocto-project-qs/yocto-project-qs.html



## AUTOGENERATED DO NOT DELETE 
## TutorialCategory
## FILL IN THE STACK TUTORIAL CATEGORY HERE