====== Robotino API2 Setup ======

This tutorial is based on the [[http://wiki.openrobotino.org/index.php?title=API2_quickstart|API2 quickstart tutorial]] in the Robotino wiki. Several discrepancies were discovered with Robotino OS 2.4 so this tutorial updates and further details the procedure.

NOTE:  This tutorial was done using MacOs 10.8

===== Tutorial prerequisites =====

This tutorial assumes you are running Robotino os 2.4.  

It is recommended that you start with a fresh disk image.  Follow the instructions on the [[http://wiki.openrobotino.org/index.php?title=CF_card|Robotino Wiki]] to re image your CF card.


===== Setting Up =====

Connect your PC and your robotino via ethernet to the same network.

Open a new terminal window and enter

  ssh robotino@<your robotino ip>

where <your robotino ip> is the ip of your robotino found on the robotino built in display.

You will be prompted for a password for robotino.  It is: **robotino**

Open ANOTHER terminal window and enter

  ssh root@<your robotino ip>

the password this time is: **dorp6**


===== Installing API2 =====

Begin by adding the following source to your sources.list file.

In your **root terminal** window enter

  echo "deb http://doc.openrobotino.org/download/packages/i386 ./" >> /etc/apt/sources.list

check to see that it was added by entering 

  vim /etc/apt/sources.list

quit vim by pressing 
  <esc>    :q!
to quit without saving.

Still in the **root terminal** enter

  apt-get update
  
  apt-get install robotino-api2 robotino-examples


===== A quick test =====

In the **robotino user terminal**

  mkdir -p build/circle
  cd build/circle

to create a directory and then make it your operating directory

  ccmake /usr/local/robotino/examples/src/c++/circle/

If ccmake fails you need to run

  apt-get install ccmake 

In your **root terminal**  and try the previous command again  in your **robotino user terminal**

if ccmake runs press the c key twice and then the g key

finally run

  make

To run your program go back to your **root terminal** and enter 

  target/example_circle 127.0.0.1

Your robotino should move in a circle

{{dylanw:run_in_termina.png }}


{{youtube>1yFzO5TuZCs?large }}