Skip to content
Switch branches/tags
This branch is 2 commits ahead, 1 commit behind tuw-robotics:indigo-devel.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Official ROS Documentation

A much more extensive and standard ROS-style version of this documentation can be found on the ROS wiki at:

Install and Configure ROS Package

  1. Install dependencies:

    $ sudo apt-get install python-visual

  2. Download code:

    $ cd ~/catkin_workspace/src $ git clone $ cd .. $ catkin_make

Install Arduino firmware

  1. Open src/Razor_AHRS/Razor_AHRS.ino in Arduino IDE. Note: this is a modified version of Peter Bartz' original Arduino code (see Use this version - it emits linear acceleration and angular velocity data required by the ROS Imu message

  2. Select your hardware here by uncommenting the right line in src/Razor_AHRS/Razor_AHRS.ino, e.g.

// Select your hardware here by uncommenting one line!
//#define HW__VERSION_CODE 10125 // SparkFun "9DOF Razor IMU" version "SEN-10125" (HMC5843 magnetometer)
//#define HW__VERSION_CODE 10736 // SparkFun "9DOF Razor IMU" version "SEN-10736" (HMC5883L magnetometer)
//#define HW__VERSION_CODE 10183 // SparkFun "9DOF Sensor Stick" version "SEN-10183" (HMC5843 magnetometer)
//#define HW__VERSION_CODE 10321 // SparkFun "9DOF Sensor Stick" version "SEN-10321" (HMC5843 magnetometer)
#define HW__VERSION_CODE 10724 // SparkFun "9DOF Sensor Stick" version "SEN-10724" (HMC5883L magnetometer)
  1. Upload Arduino sketch to the Sparkfun 9DOF Razor IMU board


In its default configuration, razor_imu_9dof expects a yaml config file my_razor.yaml with:

  • USB port to use
  • Calibration parameters

An examplerazor.yaml file is provided. Copy that file to my_razor.yaml as follows:

$ roscd razor_imu_9dof/config
$ cp razor.yaml my_razor.yaml

Then, edit my_razor.yaml as needed


Publisher and 3D visualization:

$ roslaunch razor_imu_9dof razor-pub-and-display.launch

Publisher only:

$ roslaunch razor_imu_9dof razor-pub.launch

Publisher only with diagnostics:

$ roslaunch razor_imu_9dof razor-pub-diags.launch

3D visualization only:

$ roslaunch razor_imu_9dof razor-display.launch


For best accuracy, follow the tutorial to calibrate the sensors:

A copy of Peter Bartz's magnetometer calibration scripts from is provided in the magnetometer_calibration directory.

Update my_razor.yaml with the new calibration parameters.

Dynamic Reconfigure

After having launched the publisher with one of the launch commands listed above, it is possible to dynamically reconfigure the yaw calibration.

  1. Run:

    $ rosrun rqt_reconfigure rqt_reconfigure

  2. Select imu_node.

  3. Change the slider to move the calibration +/- 10 degrees. If you are running the 3D visualization you'll see the display jump when the new calibration takes effect.

The intent of this feature is to let you tune the alignment of the AHRS to the direction of the robot driving direction, so that if you can determine that, for example, the AHRS reads 30 degrees when the robot is actually going at 35 degrees as shown by e.g. GPS, you can tune the calibration to make it read 35. It's the compass-equivalent of bore-sighting a camera.


A ROS driver and firmware to connect to Razor IMU 9DOF (Degree of Freedom) board. This board consists of 3 sensors: magnetic, gyro and acceleration sensor.



No packages published