This tutorial presents the steps for adding the Hokuyo laser range finder (LRF) sensor to TurtleBot, and explains how to write URDF description of the Hokuyo LRF, and how to modify the URDF of the Turtlebot robot to account for the addition of the Hokuyo sensor. Before going through this tutorial, it is highly recommended to have a background on URDF, and for this you may need to look at URDF Tutorials.

It is better to create a new package to test the code rather than changing the turtlebot package. Firstly, we must create a new workspace by following Creating a workspace for catkin. First change to the source space directory of the catkin workspace:

# You should have created this in the Creating a Workspace Tutorial
$ cd ~/catkin_ws/src

Clone the turtlebot source into this folder:

git clone

Now, your src dirctory should contain a directory and a file, like this:

turtlebot@turtlebot:~/catkin_ws/src$ ls
CMakeLists.txt  turtlebot

To use that new enviroment, you will need to source the new setup.bash from it. Source that with the following:

source ~/catkin_ws/devel/setup.bash

Actually, we can add it to ~/.bashrc so that we donot have to source it everytime.

We must install hokuyo_node package as

sudo apt-get install ros-indigo-hokuyo-node

More information on hokuyo_node package can be found at hokuyo_node package

Creating the Hokuyo Description

We will be using mesh file hokuyo.dae for a visual representation of Hokuyo Laser Range Finder. First we should add the hokuyo.dae file into ~/catkin_ws/src/turtlebot/ turtlebot_description/meshes/sensors from /opt/ros/indigo/share/gazebo_plugins/ test/multi_robot_scenario/meshes/laser. We’ll start by creating a description of the Hokuyo physical specifications like size and position on our Turtlebot. Create a new file ~/catkin_ws/src/turtlebot/turtlebot_description/urdf/sensors/hokuyo.urdf.xacro and add following to it.

<?xml version="1.0"?>
<robot name="sensor_hokuyo" xmlns:xacro="">
  <xacro:include filename="$(find turtlebot_description)/urdf/turtlebot_gazebo.urdf.xacro"/>
  <xacro:include filename="$(find turtlebot_description)/urdf/turtlebot_properties.urdf.xacro"/>

  <xacro:macro name="sensor_hokuyo" params="parent">
    <link name="hokuyo_link">
        <origin xyz="0 0 0" rpy="0 0 0"/>
          <box size="0.1 0.1 0.1"/>
        <origin xyz="0 0 0" rpy="0 0 0"/>
          <mesh filename="package://turtlebot_description/meshes/sensors/hokuyo.dae"/>
        <mass value="1e-5" />
        <origin xyz="0 0 0" rpy="0 0 0"/>
        <inertia ixx="1e-6" ixy="0" ixz="0" iyy="1e-6" iyz="0" izz="1e-6" />
    <joint name="hokuyo_joint" type="fixed">
      <!--<axis xyz="0 0 1" />-->
      <origin xyz="0.08 0 0.430" rpy="0 0 0"/>
      <parent link="${parent}"/>
      <child link="hokuyo_link"/>
     <!-- Hokuyo sensor for simulation -->

The first elements of this block are an extra link (hokuyo_link) and joint (hokuyo_joint) added to the URDF file that represents the hokuyo position and orientation realtive to turtlebot. In this xacro description sensor_hukoyo, we have passed parameter parent which functions as parent_link for hokuyo links and joints. We create a macro named turtlebot_sim_laser_range_finder that specifies all of the necessary information for the laser joint and link just before the closing tag.

Setting Up the Gazebo Plugin

Next we must define the Gazebo plugin that gives us the laser range finder functionality and publishes the laser scans to a ROS message. Add the following code to your turtlebot_gazebo.urdf.xacro after the </xacro:macro> tag closing the Kinect macro.

<xacro:macro name="turtlebot_sim_laser_range_finder">
  <!-- ULM-30LX Hokuyo Laser Range Finder -->
  <gazebo reference="hokuyo_link">
    <sensor type="gpu_ray" name="head_hokuyo_sensor">
      <pose>0 0 0 0 0 0</pose>
          <!-- Noise parameters based on published spec for Hokuyo laser
               achieving "+-30mm" accuracy at range < 10m.  A mean of 0.0m and
               stddev of 0.01m will put 99.7% of samples within 0.03m of the true
               reading. -->
      <plugin name="gazebo_ros_head_hokuyo_controller" filename="">

We will review some of the properties


When true, a semi-translucent laser ray is visualized within the scanning zone of the gpu laser. This can be an informative visualization to test if Laser Sensor is working. topicname define the ROS topic, laserscans will be published, here /laserscan.

This macro will set up the plugin in Gazebo when expanded from the hokuyo.urdf.xacro file. We now add the Hokuyo urdf to the Turtlebot xacro library file in /turtlebot_description/urdf/turtlebot_library.urdf.xacro. Add the following line to the end of the file before the </robot> tag.

 <!--  Hokuyo Laser Sensor-->
 <xacro:include filename="$(find turtlebot_advanced)/urdf/sensors/hokuyo.urdf.xacro"/>

Creating a Description File for the Hokuyo-equipped Bot

Now that we’ve got our macros defined, we want to create a robot description file that actually uses them to specify the robot as having the Hokuyo equipped. Navigate to the /turtlebot_description/robots folder. Create a copy of whichever file corresponds to your robot’s configuration (ours was create_circles_kinect.urdf.xacro) as < base >_< stack >_hokuyo.urdf.xacro. As an example that left us with a copy named create_circles_hokuyo.urdf.xacro. Now edit that file to add the following line.

<sensor_hokuyo parent="base_link"/>

Now we can use this file to launch our Turtlebot with the Hokuyo equipped and working. To specify you want to use the Hokuyo urdf you just created, run the following in the terminal:

export TURTLEBOT_3D_SENSOR="hokuyo"

Now when roslaunching any of the turtlebot_gazebo launch files, your robot should launch in Gazebo with simulated Hokuyo laser scans. Note that the Kinect will still be equipped and publishing fake laser scans on the /scan topic. To change this, modify the remap section of the launch file to remap the fake laser scans to another topic (/kinect_scan for example).

Testing in Gazebo Simulation

We can launch the gazebo simulation as

roslaunch turtlebot_gazebo turtlebot_world.launch

This should open gazebo as in fig 1. showing Hokuyo Range Finder semi-translucent laser ray in blue color as we have set visualize to true.

Fig 1. Turtlebot Gazebo Simulation with Hokuyo Range Finder

To view actual laserscan readings, we must open rviz and then subscribe to /laserscan topic.

rosrun rviz rviz
Fig 1. Turtlebot Rviz Visualization of Hokuyo Range Finder Data

We can see the location of Hokuyo Range Finder in Rviz model of Turtlebot clearly.