[Documentation] [TitleIndex] [WordIndex

  Show EOL distros: 

Package Summary

ROS driver package for communication with the SBG navigation systems.

Package Summary

The SBG ROS Driver package

Package Summary

ROS driver package for communication with the SBG navigation systems.

Overview

ROS package for SBG Systems IMU.

The driver allows the user to configure the IMU (if possible, according to the device), to receive messages from the Sbg message protocol, publish ROS standard messages , and to calibrate the magnetometers.

Installation

Installation from packages

User can install the sbg_ros_driver through the standard ROS installation system.

sudo apt-get install ros-$ROS_DISTRO-sbg-driver

Installation from sources

  1. Clone the repository (use a Release version) https://github.com/SBG-Systems/sbg_ros_driver

  2. Build using the normal ROS catkin build system

Usage

Enable communication with the SBG device

To be able to communicate with the device, be sure that your user is part of the dialout group. Once added, restart your machine to save and apply the changes.

sudo adduser $USER dialout

Afterwards, detect the port where your SBG device is connected (e.g. /dev/ttyUSB0) using

dmesg | grep tty

and edit sbg_device_uart_default.yaml accordingly or (recommended) define a udev rule (e.g. pointing to /dev/sbg)

Ros node for IMUs data

Run the ros node to receive messages from the SBG IMU.

Config files are available for uart or udp connection. Users should properly define the device parameters.

roslaunch sbg_driver sbg_device.launch

Ros node for magnetometers calibration

roslaunch sbg_driver sbg_device_mag_calibration.launch

Configuration files

Default config files

sbg_device_uart_default.yaml

This config file is the default one for Uart connection with the device. It does not configure the device through the ROS node, so it has to be previously configured (manually or with the ROS node).

It define a few outputs for the device :

sbg_device_udp_default.yaml

This config file is the default one for an Udp connection with the device. It does not configure the device through the ROS node, so it has to be previously configured (manually or with the ROS node).

It defines a few outputs for the device :

Example config files

Messages publishing

SBG custom messages

The sbg_driver defines some custom ROS messages, corresponding to the SBG message protocol.

ROS standard messages

In order to define ROS standard topics, it requires sometimes several SBG messages to be merged. You have to active the needed SBG outputs.

Services

The sbg_device_mag node handles the magnetic calibration for suitable devices. It uses services to control the calibration process.

HowTo

Configure the SBG device

For compatible devices, the SBG ROS driver allows the user to configure the device before starting the data handling.

To do so, the configuration yaml file should be modified.

# Configuration of the device with ROS.
confWithRos: true

Calibrate the magnetometers

$ roslaunch sbg_driver sbg_device_mag_calibration.launch
$ rosservice call /sbg/mag_calibration
// Proceed rotations on the IMU
$ rosservice call /sbg/mag_calibration
// If the magnetic calibration results are satisfaying, it could be uploaded
$ rosserive call /sbg/mag_calibration_save

Contributing

Bugs, issues, or features additions should be done on the Github repository.


2024-10-05 16:52