Skip to content

Latest commit

 

History

History
 
 

microstrain_inertial_examples

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
config
config
 
 
launch
launch
 
 
CHANGELOG.rst
CHANGELOG.rst
 
 
CMakeLists.txt
CMakeLists.txt
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
package.xml
package.xml
 
 

README.md

Description

Collection of simple examples to get started using the microstrain_inertial_driver.

Table of Contents

Common Steps

For all the below examples, you should make sure you take the following steps before running them:

  1. Install the udev rules (This should only be done once and if using the ROS package index, these will be installed automatically)
  2. Connect your device.
  3. Modify the port and baudrate parameters in the .yml file for the example you are running to point to the port your device is connected to. This is especially important if using serial instead of USB.
  4. Install or build the microstrain_inertial_examples and microstrain_inertial_driver packages
  5. Source your setup.bash
    1. If building from source, run: source install/setup.bash after building
    2. If installing from the ROS package index, run: source /opt/ros/<ROS Version>/setup.bash after installing

Device Examples

This package contains some example launch files to show users a simple starting configuration when using different devices.

CV7-INS / GV7-INS

NOTE: This example works for the 3DM-CV7-INS, and 3DM-GV7-INS

The CV7-INS example contains a simple example of outputting relative position data from a CV7-INS and displaying that data in rviz. This example also shows how one would input external position and velocity into the sensor.

To run this example, run the following command after doing the common steps:

roslaunch microstrain_inertial_examples cv7_ins.launch

This example contains the following files:

CV7 / GV7

NOTE: This example works for the 3DM-CV7-AR, 3DM-CV7-AHRS, 3DM-GV7-AR, and 3DM-GV7-AHRS.

The CV7 example contains a simple example of outputting orientation, angular and linear velocity from a CV7 and displaying that data in rviz.

To run this example, run the following command after doing the common steps:

roslaunch microstrain_inertial_examples cv7.launch

This example contains the following files:

GQ7

NOTE: This example works for the 3DM-GQ7

The GQ7 example contains a simple example of outputting global and relative position data from a GQ7 and displaying that data in rviz. This example also assumes that the user will be using a 3DM-RTK connected to the GQ7 aux port, but can be tweaked to not require the 3DM-RTK.

To run this example

  1. Do the common steps
  2. Ensure that your GQ7 has both antennas connected. See the microstrain Antenna Installation page for more help with this.
  3. Update gnss1_antenna_offset and gnss2_antenna_offset in config/gq7/gq7.yml to your antenna offsets
  4. Run the following command:
roslaunch microstrain_inertial_examples gq7.launch

This example contains the following files:

GX5-GNSS / CX5-GNSS

NOTE: This example works for the 3DM-GX5-GNSS (3DM-GX5-45), and 3DM-CX5-45 (3DM-CX5-45)

The GX5-GNSS example contains a simple example of outputting global and relative position data from a GX5-GNSS and displaying that data in rviz.

  1. Do the common steps
  2. Ensure that your GX5-GNSS has it's antenna connected. See the microstrain Antenna Installation page for more help with this.
  3. Update gnss1_antenna_offset in config/gx5_45/gx5_45.yml to your antenna offset
  4. Run the following command:
roslaunch microstrain_inertial_examples gx5_45.launch

GX5-AHRS / CX5-AHRS

NOTE: This example works for the 3DM-GX5-AHRS (3DM-GX5-25), and 3DM-CX5-AHRS (3DM-CX5-25)

The GX5-AHRS example contains a simple example of outputting orientation, angular and linear velocity from a GX5-AHRS and displaying that data in rviz.

To run this example, run the following command after doing the common steps:

roslaunch microstrain_inertial_examples gx5_25.launch

This example contains the following files:

GX5-AR / CX5-AR

NOTE: This example works for the 3DM-GX5-AR (3DM-GX5-15), and 3DM-CX5-AR (3DM-CX5-15)

The GX5-AR example contains a simple example of outputting orientation, angular and linear velocity from a GX5-AR and displaying that data in rviz.

To run this example, run the following command after doing the common steps:

roslaunch microstrain_inertial_examples gx5_15.launch

This example contains the following files:

Other Examples

Other assorted examples users may find useful

CV7-INS / GV7-INS with NMEA over aux port

NOTE: This example works for the 3DM-CV7-INS, and 3DM-GV7-INS and requires an external GNSS receiver such as the SparkFun ZED-F9P

This example is similar to the CV7-INS / GV7-INS, but instead of getting the data over the ROS network, the data will be provided by GPIO pins setup as an "aux" port on the device. This example follows the wiring setup provided in the NMEA Input page on the MicroStrain manual.

To run this example, run the following command after doing the common steps:

roslaunch microstrain_inertial_examples cv7_ins_nmea_aux.launch

This example contains the following files: