Overview

This package implements MIP protocol used by Microstrain 3DM-GX3-45 sensor which is inertial device fusing IMU and GPS. It contains implementation of driver and ROS node. The driver has been written from scratch using Boost ASIO library.

Installation

Download and compile (rosbuild-based) package.

Supported Hardware

Driver has been tested only with Microstrain 3DM-GX3-45, under ROS Groovy.

API Stability

Driver, node and their API are in experimental phase.

ROS API

imu_driver

imu_driver is a driver for the device. On different topics it provides raw GPS data, AHRS data and fused data. Any topic is advertised only if it's enabled. If enabled and someone is subscribed, node publishes data on that particular topic.

Published Topics

~imu/data (sensor_msgs/Imu)
  • Orientation, angular velocity, linear acceleration and corresponding covariances.
~imu/pose (geometry_msgs/PoseStamped)
  • Orientation from IMU in form of PoseStamped which can be for instance easily visualized in RVIZ.
~gps/fix (sensor_msgs/NavSatFix)
  • Raw GPS data.
~gps/odom (nav_msgs/Odometry)
  • Raw GPS data in form of Odometry (can be used as input for robot_pose_ekf).
~nav/pose (geometry_msgs/PoseStamped)
  • Orientation from fused data.

Services

~reset_kf (std_srvs/Empty)
  • Reset of Kalman filter used in device for sensor fusion.

Parameters

~port (string, default: /dev/ttyACM0)
  • The port the imu is running on.
~baud_rate (integer, default: 115200)
  • Baud rate of the sensor.
~declination (double, default: 3.8)
  • Magnetic declination for given area.
~child_frame_id (string, default: /base_footprint)
  • Odometry data will be published with this child_frame_id.
~publish_pose (bool, default: true)
  • Sets if ~imu/pose should be advertised or not.
~publish_imu (bool, default: true)
  • Sets if ~imu/data should be advertised or not.
~publish_gps (bool, default: true)
  • Sets if ~gps/fix should be advertised or not.
~publish_gps_as_odom (bool, default: true)
  • Sets if ~gps/odom should be advertised or not.
~publish_nav_odom (bool, default: true)
  • Sets if ~nav/odom should be advertised or not.
~publish_nav_pose (bool, default: true)
  • Sets if ~nav/pose should be advertised or not.
~publish_nav_fix (bool, default: true)
  • Sets if ~nav/fix should be advertised or not.
~linear_acceleration_stdev (double, default: 0.098)
  • Standard deviation of linear acceleration. This value is used to calculate covariance matrix.
~orientation_stdev (double, default: 0.035)
  • Standard deviation of orientation. This value is used to calculate covariance matrix.
~angular_velocity_stdev (double, default: 0.012)
  • Standard deviation of angular velocity. This value is used to calculate covariance matrix.

Wiki: microstrain_3dm_gx3_45 (last edited 2013-06-26 14:32:15 by ZdenekMaterna)