!

Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags.

Robot bring-up

In this tutorial you will learn the following:

For the following sections we will use the ARMadillo robot for all the examples but the same usage will be the same for other robots, just replace 'armadillo' with your robot name, e.g. 'lizi', 'komodo'.

Bring-up a real robot

Safety first! - Before using your robot please carefully read the safety instructions on your robot manual. You can download a copy of your robot manual under your robot ROS package wiki page. For example, the ARMadillo robot manual can be downloaded from the robotican_armadillo wiki page.

In order to bring up your robot is launch your robot main launch file. Open a new terminal (Ctrl+Alt+t) and run:

$ roslaunch robotican_armadillo armadillo.launch

Thats it, your robot is up!

By default not all sensors and capabilities are initiated with the above launch command. In order to select the sensors and capabilities you want to initiate you can add arguments to the above launch command. The available arguments and their default state for each robot can be found under the robot package wiki page. For example, for the ARMadillo robot, the following arguments can be used for sensors selection:

front_camera – Front color camera

rear_camera – Rear color camera

lidar – Laser scanner

gps – GPS sensor

imu – IMU 9-DOF sensor

urf – Ultrasonic range finders

kinect2 – The Kinect 2 RGB-D camera (mounted on the pan-tilt system on top of the robot)

f200 – The Intel Realsense F200 RGB-D camera (mounted above the arm gripper)

and the following arguments can be used for capabilities selection:

robot_localization - Launch the robot_localization EKF state estimation node. By default, the only input sensor is the robot odometry. If you want to add more sensors or edit the node parameters you can modify the robotican/robotican_common/launch/robot_localization.launch file.

Edit conflict - other version:

moveit - Setting this argument to 'true' will load the robot MoveIt interface. See section Arm manipulation for more details and extra related arguments.

gazebo - Setting this argument to 'true' will load the Gazebo simulation envirement and bring-up the robot. See section Bring-up a robot in the gazebo simulation environment for more details and extra related arguments.

rqt - Setting this argument to 'true' will launch the rqt GUI.

Bring-up a robot in the gazebo simulation environment

x,y,z,R,P,Y - Initial position and orientation of the robot.

world_name - By default, the worlds/empty.world' will be loaded. You can specify a new world file name with respect to GAZEBO_RESOURCE_PATH environmental variabel or a full path to any other world file.

Edit conflict - your version:

moveit - Setting this argument to 'true' will load the robot MoveIt interface. See section Arm manipulation for more details and extra related arguments.

gazebo - Setting this argument to 'true' will load the Gazebo simulation envirement and bring-up the robot. See section Bring-up a robot in the gazebo simulation environment for more details and extra related arguments.

rqt - Setting this argument to 'true' will launch the rqt GUI.

Bring-up a robot in the gazebo simulation environment

x,y,z,R,P,Y - Initial position and orientation of the robot.

world_name - By default, the worlds/empty.world' will be loaded. You can specify a new world file name with respect to GAZEBO_RESOURCE_PATH environmental variable or a full path to any other world file.

End of edit conflict

Read and visualize you robot sensors

Command you robot with simple motion commands