Difference between revisions of "Fernando-TFM-ROS02"

Revision as of 17:07, 8 February 2012

• Project Name: TFM-ROS02

• Authors: Fernando Casado

• Academic Year: 2011-2012

• Degree: Master

• SVN Repositories:

• Tags: turtlebot

• Technology: ROS, c++

• State: Development

Instalando ROS

Lo primero que necesitamos es un computador con el sistema operativo Ubuntu, que es el único soportado por ROS, o instalarlo; otros sistemas operativos para los que está disponible solo son experimentales. Para instalar Ubuntu en un equipo con sistema operativo windows, podemos optar entre una instalación tradicional desde un CD-ROM o USB, en una partición diferente a la de windows, o la opción más rápida y sencilla , instalarlo desde windows como si se tratara de una aplicación o programa mas.

Provistos ya de un equipo con Ubuntu, para descargar e instalar el sistema ROS simplemente deberemos seguir las indicaciones de instalación. No esta de más el tomarse un tiempo realizando los tutoriales que proponen, son de gran ayuda para conocer la estructura de ficheros y el funcionamiento de Nodes y Topics.

Instalando Turtlebot-desktop

Con el sistema ROS instalado, necesitamos instalar las herramientas para desarrollo del robot Turtlebot en el equipo de trabajo. Ejecutando el siguiente comando en un terminal comenzará la descarga e instalación:

   
     sudo apt-get install ros-electric-turtlebot-desktop

Es importante que el reloj del equipo de trabajo se encuentre sincronizado con el reloj del equipo del Turtlebot, para prevenir las posibles perdidas de red inalámbrica. Para instalar el cliente NTP Chrony se ejecutará el siguiente comando en un terminal:

      sudo apt-get install chrony

Conociendo el Turtlebot

thumb|130px|Fotografía del [http://www.turtlebot.com Turtlebot].

Hardware

• iRobot Create
• ASUS1215N Laptop
• Microsoft Kinect
• Placa de gestión de alimentación y sensores
• Cables USB de comunicaciones y alimentación
• Estructura de soporte de elementos

Software

• Sistema operativo Ubuntu
• ROS con Turtlebot-robot

Conexión estación de trabajo-robot

Configuración de la red

Lo habitual conectar ambos equipos a una red Wi-Fi, pero puede darse que el PC estación de trabajo no disponga de un interfaz de red inalámbrica. En este caso es necesario poder conectarse a un puerto del router que provee la red Wi-Fi, para que exista una ruta de acceso entre el PC estación de trabajo y el PC robot.

En ambos equipos, PC estación de trabajo y PC robot, se añarirá el ROS_MASTER_URI en el archivo de configuración del terminal (.bashrc), que apunta a la dirección IP del PC robot, que es el que ejecuta el servicio maestro. Simplemente se debe escribir el siguiente comando en un terminal, sustituyendo "IP_OF_TURTLEBOT", por la dirección IP asignada en la red al PC robot:

      
      echo export ROS_MASTER_URI=http://IP_OF_TURTLEBOT:11311 >> ~/.bashrc

También se debe asignar un nombre de equipo, tanto al PC estación de trabajo como al PC robot. Este nombre será la dirección IP de cada equipo, que se almacenará en el archivo de configuración del terminal (.bashrc). En un terminal del PC robot de trabajo se ejecutará el siguiente comando, sustituyendo "IP_OF_TURTLEBOT", por la dirección IP asignada en la red al PC robot:

      
      echo export ROS_HOSTNAME=IP_OF_TURTLEBOT >> ~/.bashrc

En un terminal del PC estación de trabajo se ejecutará el siguiente comando, sustituyendo "IP_OF_WORKSTATION", por la dirección IP asignada en la red al PC estación de trabajo:

      
      echo export ROS_HOSTNAME=IP_OF_WORKSTATION >> ~/.bashrc

• Nota: Para conocer la dirección IP, asignada en la red a un equipo, simplemente se debe ejecutar en un terminal:

      
      ifconfig

que mostrará una información similar a esta:

      eth0      Link encap:Ethernet  direcciónHW 00:16:d4:55:85:b4  
                ACTIVO DIFUSIÓN MULTICAST  MTU:1500  Métrica:1
                Paquetes RX:0 errores:0 perdidos:0 overruns:0 frame:0
                Paquetes TX:0 errores:0 perdidos:0 overruns:0 carrier:0
                colisiones:0 long.colaTX:1000 
                Bytes RX:0 (0.0 B)  TX bytes:0 (0.0 B)
                Interrupción:44 

      lo        Link encap:Bucle local  
                Direc. inet:127.0.0.1  Másc:255.0.0.0
                Dirección inet6: ::1/128 Alcance:Anfitrión
                ACTIVO BUCLE FUNCIONANDO  MTU:16436  Métrica:1
                Paquetes RX:64 errores:0 perdidos:0 overruns:0 frame:0
                Paquetes TX:64 errores:0 perdidos:0 overruns:0 carrier:0
                colisiones:0 long.colaTX:0 
                Bytes RX:5184 (5.1 KB)  TX bytes:5184 (5.1 KB)

      wlan0     Link encap:Ethernet  direcciónHW 00:18:de:21:4b:ad  
                Direc. inet:192.168.1.10  Difus.:192.168.1.255  Másc:255.255.255.0
                Dirección inet6: fe80::218:deff:fe21:4bad/64 Alcance:Enlace
                ACTIVO DIFUSIÓN FUNCIONANDO MULTICAST  MTU:1500  Métrica:1
                Paquetes RX:130972 errores:0 perdidos:0 overruns:0 frame:0
                Paquetes TX:87840 errores:0 perdidos:0 overruns:0 carrier:0
                colisiones:0 long.colaTX:1000 
                Bytes RX:169415208 (169.4 MB)  TX bytes:9379691 (9.3 MB)

Puesta en marcha

Con la red configurada, ya se puede proceder a la puesta en marcha del Turtlebot. Se conectarán los cables USB de comunicación y alimentación del robot al PC robot, se encenderá el iRobot Create y se arrancará el PC robot.

Las operaciones sobre el PC robot se pueden hacer directamente sobre él, pero no es la opción recomendable por comodidad de trabajo. Así que se comenzará conectando por ssh, desde el PC estación de trabajo con el PC robot. Se ejecutará el siguiente comando en un terminal en la estación de trabajo, sustituyendo "IP_OF_TURTLEBOT" por la dirección IP asignada en la red al PC robot:

      ssh turtlebot@IP_OF_TURTLEBOT

Pedirá la contraseña asignada al PC robot. Cuando se conecte el prompt del terminal cambiará por el del PC robot. Se puede comprobar el estado del servicio del robot, tecleando el siguiente comando en el terminal:

      sudo service turtlebot status

Devolverá un mensaje diciendo que está iniciado. Es servicio se inicia siempre que encendemos el PC robot, pero se puede detener y poner en marcha desde el terminal con los siguientes comandos:

      sudo service turtlebot stop
      sudo service turtlebot start

En un terminal nuevo, de forma local sin conectar con el PC robot, se ejecutará la aplicación del tablero de instrumentos (dashboard) del robot. Simplemente se debe introducir este comando en el terminal:

      rosrun turtlebot_dashboard turtlebot_dashboard&

Aparecerá una pequeña ventana similar a esta:

center

La ventana del tablero de instrumentos consta de tres zonas bien diferenciadas:

• Diagnóstico del sistema, mensajes del sistema y modo de operación.
• Interruptores de los circuitos de las tres salidas digitales del iRobot Create.
• Niveles de batería de el iRobot Create y el PC robot.

Si todo va bien, como en la imagen, estarán en verde los iconos de diagnostico del sistema (llave inglesa) y mensajes del sistema (nube de llamada). El modo de operación se debe poner poner en Full Mode, para poder operar el robot. En los otros modos no está permitida la operación del robot, son el modo de carga (Passive Mode) y de espera (Safety Mode).

center

También se debe activar al menos el interruptor "1", que es el que controla el circuito de alimentación de la cámara Kinect. Ahora ya esta todo listo para comenzar a operar con el robot. Para verlo en funcionamiento es recomendable probar alguna de las aplicaciones de demostración.

Primer programa

Creando un espacio de trabajo

Lo más cómodo para trabajar es crear un directorio propio para stacks y packages en el PC estación de trabajo, ya que ROS tiene por defecto como directorio para stacks y packages /opt/ros/electric/stacks. Se pueden crear los nuevos stacks o packages en este directorio por defecto, pero queda más organizado y accesible de esta forma.

El directorio se puede situar donde y con el nombre que se quiera. Se comenzará creando un directorio, por ejemplo en la carpeta personal:

      mkdir ~/ros_workspace

Para que el sistema también busque stacks y packages en nuestra carpeta, se debe crear, en la carpeta personal un archivo llamado "setup.sh" con el siguiente contenido:

      #!/bin/sh
      source /opt/ros/electric/setup.bash
      export ROS_ROOT=/opt/ros/electric/ros
      export PATH=$ROS_ROOT/bin:$PATH
      export PYTHONPATH=$ROS_ROOT/core/roslib/src:$PYTHONPATH
      export ROS_PACKAGE_PATH=~/ros_workspace:/opt/ros/electric/stacks:$ROS_PACKAGE_PATH

Se debe añadir este nuevo archivo creado al archivo de configuración del terminal (.bashrc), para hacer efectiva esta modificación. Para ello se debe ejecutar el siguiente comando en un terminal:

      
      echo source  ~/setup.sh >> ~/.bashrc

Creando un package

En el directorio de trabajo creado se creará un package, el cual va a depender de otros packages del sistema. Las dependencias van en función del tipo de mensajes que queremos enviar o recibir, y el lenguaje empleado en los programas. En este primer programa no se necesitan todas las dependencias, pero se usaran en los siguientes programas, por lo que las añadiremos al crear el package que va a contener los programas. Para esto se introducirá la siguiente secuencia de comandos en un terminal:

      cd ~/ros_workspace
      roscreate-pkg turtlebot_fer std_msgs turtlebot_node geometry_msgs nav_msgs rospy roscpp

También se pueden añadir dependencias a un package ya creado, simplemente se debe editar el archivo "manifest.xml" que se encuentra dentro de la carpeta del package creado. El contenido del archivo "manifest.xml" es similar al siguiente, las dependencias se encuentran al final:

      <package>
        <description brief="turtlebot_fer">

           turtlebot_fer

        </description>
        <author>FeR</author>
        <license>BSD</license>
        <review status="unreviewed" notes=""/>
        <url>http://ros.org/wiki/turtlebot_fer</url>
        <depend package="turtlebot_node"/>
        <depend package="geometry_msgs"/>
        <depend package="nav_msgs"/>
        <depend package="std_msgs"/>
        <depend package="rospy"/>
        <depend package="roscpp"/>

      </package>

Una vez creado el package, o modificadas las dependencias de un package existente, se debe compilar para que se hagan efectivas las dependencias. Simplemente se debe ejecutar el siguiente comando en el terminal, indicando el nombre del package:

      rosmake turtlebot_fer

Escribiendo y compilando el programa

los programas se pueden escribir en c++ o python, el escogido ha sido c++. Para la redacción del programa se puede emplear algún editor de código, como Geany. Los archivos de los programas se guardarán en la carpeta "src" del package creado, turtlebot_fer. Este primer programa, simplemente crea el nodo "gira" y publica el topic "turtlebot_node/cmd_vel", que hace mover el robot con una velocidad de avance y de giro, hasta que se reciba la señal de parada "Ctrl+C". El programa es el siguiente:

      #include "ros/ros.h"   //Librería de funciones del sistema ROS
      #include "geometry_msgs/Twist.h"   //Librería "Twist" del package "geometry_msgs"

      int main(int argc, char **argv)
      {

        ros::init(argc, argv, "gira");   //Creación del nodo "gira"

        ros::NodeHandle n;
  
        ros::Publisher vel_pub_=n.advertise<geometry_msgs::Twist>("turtlebot_node/cmd_vel", 1);   //Publicación de topic "turtlebot_node/cmd_vel"

        geometry_msgs::Twist vel;

        ros::Rate loop_rate(10);   //Frecuencia de realización del bucle (10 Hz)
  
        while (ros::ok())
        {
	      vel.linear.x = 0.2;   //velocidad de avance
       	      vel.angular.z = 0.4;   //velocidad de giro
   
	      vel_pub_.publish(vel);
	
              loop_rate.sleep();
         }

      return 0;
      }

Se guardará con el nombre "gira.cpp". Para compilarlo y generar el ejecutable se debe añadir la siguiente línea de código al archivo "CMakeLists.txt" del package creado, donde indicamos el nombre para el ejecutable y la ruta y nombre del archivo a compilar:

      rosbuild_add_executable(gira src/gira.cpp)

Para compilar el programa hay que situarse en el directorio del package. Simplemente con ejecutar la siguiente secuencia de comandos en un terminal se compilará y creará el ejecutable, siempre que no existan errores:

      roscd turtlebot_fer
      make

Ejecutando el programa

Simulador

Se puede ejecutar primero en el simulador para salvaguardar la integridad del robot. Lo primero que se debe hacer para poder arrancar el simulador es comentar las lineas que se han añadido para la comunicación con el PC robot en el archivo ".bashrc", del PC estación de trabajo, tal y como se muestra, añadiendo el símbolo "#" al principio de la línea:

      # export ROS_MASTER_URI=http://IP_OF_TURTLEBOT:11311
      # export ROS_HOSTNAME=IP_OF_WORKSTATION

Se debe reiniciar la sesión de usuario para que surtan efecto los cambios. Para ejecutar el simulador del Turtlebot simplemente se bebe ejecutar el siguiente comando en un terminal:

      roslaunch turtlebot_gazebo turtlebot_empty_world.launch

Terminada la carga aparecerá una ventana gráfica del simulador Gazebo con un escenario vacío y el modelo 3D del robot, como se muestra en la imagen:

center

Se puede cambiar el punto de vista jugando con la rueda del ratón y el botón derecho. Además, se pueden añadir objetos 3D, como esferas, prismas y cilindros. Para ejecutar el programa creado ejecutamos el siguiente comando en un terminal nuevo, indicando el package donde se encuentra y el nombre del ejecutable:

      rosrun turtlebot_fer gira

Si todo ha ido bien, el modelo 3D del robot comenzara a desplazarse formando un circulo, y no se detendrá hasta que reciba la señal de parada el terminal desde el que se ejecuta el programa, "Ctrl+C".