Concepts (ROS Guide)

Tabla de Contenidos

• Tabla de Contenidos
• Guía
  • Getting Started
  • Crear un package nuevo
  • Crear un nodo nuevo
  • Leer mensajes de topics
  • Publicar en un topic desde terminal
  • Lanzar un launcher
  • Crear un msg propio
• Recomendaciones

Guía

Getting Started

Una vez tengas un workspace, puedes buildearlo de la siguiente forma:

$ colcon build --symlink-install

Nota: Gracias a --symlink-install, no necesitas recompilar cada vez que hagas una modificación en un archivo de Python. Modificaciones en otros archivos o en C++ requieren recompilar y generalmente volver a hacer el source. Esto creará varios directorios: log, install, build. En caso de que la compilación falle, puedes consultar los logs (log/latest_build).

Ahora, asumiendo que estás utilizando bash, sourcea el setup.bash.

source install/setup.bash

Esto tambien proporcionará autocompletado en la linea de comandos.

Crear un package nuevo

En tu workspace, ejecuta el siguiente comando reemplazando example_package por el nombre del paquete:

$ ros2 pkg create example_package --build-type ament_python --dependencies rlcpy

Si necesitas añadir más dependencias, puedes especificarlas en el package.xml.

Una vez ejecutado el comando, se creará una directorio con el nombre que le has dado con todo lo necesario para empezar a desarrollar en Python con la siguiente estructura.

example_package
├── example_package
│   └── __init__.py
├── package.xml
├── resource
│   └── example_package
├── setup.cfg
├── setup.py
└── test
    ├── test_copyright.py
    ├── test_flake8.py
    └── test_pep257.py

Tus scripts los crearás en el directorio example_package/example_package.

Crear un nodo nuevo

Puedes utilizar los ejemplos que vienen con ROS (talker.py o listener.py) como base:

$ cp /opt/ros/$ROS_DISTRO/share/launch_testing_ros/examples/talker.py example_package/mi_nodo.py

En el caso de que quieras que este script sea ejecutable, marca en el setup.py de tu package el entry_point (es decir, la función main).

from setuptools import setup
package_name = 'example_package'
setup(
    name=package_name,
    # ...
    entry_points={
        'console_scripts': [
            'NOMBRE_SCRIPT = example_package.NOMBRE_SCRIPT:main',
        ],  
    },  
)

Ahora podrás ejecutarlo de la siguiente forma:

$ ros2 run example_package NOMBRE_SCRIPT

Leer mensajes de topics

Saber los topics activos y el tipo de mensajes que mandan (gracias a la opción -t):

$ ros2 topic list -t
/parameter_events [rcl_interfaces/msg/ParameterEvent]
/rosout [rcl_interfaces/msg/Log]
...

Si sabemos el nombre del topic, podemos ver la especificación directamente:

$ ros2 topic info <TOPIC>

Ahora, podemos leer qué mensajes se están publicando a tiempo real usando el siguiente comando:

$ ros2 topic echo <TOPIC>

Como ver la estructura de un mensaje en yaml:

$ ros2 interface show geometry_msgs/msg/Pose
# A representation of pose in free space, composed of position and orientation.
Point position
  float64 x
  float64 y
  float64 z
Quaternion orientation
  float64 x 0
  float64 y 0
  float64 z 0
  float64 w 1

Publicar en un topic desde terminal

$ ros2 topic pub <TOPIC> <MSG_TYPE> '<args>'

Donde los argumentos son los atributos necesarios para construir el mensaje deseado.

Usando como ejemplo el mensaje geometry_msgs/msg/Pose del apartado anterior. Podemos la orientación tiene un valor por defecto, así que no tenemos que especificarlo.

$ ros2 topic pub <TOPIC> <MSG_TYPE> '{ position: { x: 0, y: 0, z: 0 } }'
publisher: beginning loop
...

Lanzar un launcher

Puedes usar tab para autocompletar. Si ROS no encuentra tu paquete, lee la sección de package.

$ ros2 launch PACKAGE LAUNCHER

Crear un msg propio

Antes de crear un msg propio, asegurate de que no existe ninguno que satisfazca tus necesidades. Puedes ver los mensajes que trae ROS por defecto en std_msgs y geometry_msgs, o los mensajes que utiliza la universidad de Edimburgo: eufs_msgs.

Si no hay ninguno que te sirva, puedes crear uno propio.

1. En general, se recomienda almacenar todos los mensajes en un package aparte, que solo tenga los archivos .msg y/o funcionalidad muy especifica relacionada con ellos.

Ten en cuenta que los archivos .msg requieren compilarse a Python/C++, y este proceso requiere de cmake, la herramienta de automaticación de compilado. Esta herramienta no está disponible en los packages de Python así que probablemente necesites crear un paquete nuevo:

$ ros2 pkg create uvigo_msgs --build-type ament_cmake

2. Una vez tengas el package, añade estas lineas al archivo package.xml

  <build_depend>rosidl_default_generators</build_depend>
  <exec_depend>rosidl_default_runtime</exec_depend>
  <member_of_group>rosidl_interface_packages</member_of_group>

Estas líneas especifican las dependencias del package (por ejemplo si quieres que tus mensajes tengan atributos cuyos tipos están definidos en eufs_msgs, std_msgs, o otro package) y el miembro del grupo para generar y usar interfaces ROS2 (mensajes, servicios y acciones) mediante la herramienta rosidl.

3. En el archivo CMakeLists.txt, añade estas lineas:

# find dependencies
find_package(ament_cmake REQUIRED)
+find_package(rosidl_default_generators REQUIRED)

# Al final del archivo
endif()
+rosidl_generate_interfaces(${PROJECT_NAME}
+  "msg/MiMensaje.msg"
+)
ament_package()

4. Ahora ya puedes crear tu directorio msg y añadir ahí tu mensaje propio:

# Descripción de mi mensaje
std_msgs/Header header
float64 x
float64 y

5. Finalmente, comprueba que todo ha ido correcto:

$ colcon build && source install/setup.bash
...
$ ros2 interface show uvigo_msgs/msg/MiMensaje
# Descripción de mi mensaje
std_msgs/Header header
float64 x
float64 y

Recomendaciones

• Puedes ver los nodos y topics que se ejecutan en cada momento ejecutando el programa rqt_graph en la terminal.
• Una vez instalado ROS, tenéis ejemplos de paquetes en /opt/ros/$ROS_DISTRO/share