openzen_driver package from openzen_driver repo

openzen_driver

Package Summary

Tags No category tags.
Version 1.2.0
License MIT
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Checkout URI https://bitbucket.org/lpresearch/openzenros2.git
VCS Type git
VCS Version master
Last Updated 2023-03-14
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

ROS 2 Driver for LP-Research inertial measurement units and satellite navigation senors

Additional Links

No additional links.

Maintainers

  • Thomas Hauth
  • Feng
  • H.E. YAP

Authors

No additional authors.

OpenZen Node for ROS 2

This software allows to forward sensor data from sensor connected via OpenZen to ROS version 2.

OpenZen is a library for high performance sensor data streaming and processing and supports multiple sensor models: https://bitbucket.org/lpresearch/openzen/

Requirements

Serial Port Access Rights

After this call, you should logout and login with this user to ensure the changed permissions are in effect.

To allow access to sensors connected via USB, you need to ensure that the user running the ROS sensor node has access to the /dev/ttyUSB devices. You can do this by adding the user to the dialout group.

sudo adduser <username> dialout

Compilation

To compile this driver in your ROS2 setup, follow these steps:

mkdir -p ros_ws/src
cd ros_ws/src

git clone --recurse-submodules https://bitbucket.org/lpresearch/openzenros2.git

# get your ROS2 environment going
source /opt/ros/foxy/setup.bash
cd ..
colcon build
source ./install/setup.bash

Running the Driver

You can now run the OpenZen ROS2 driver with this command in the window you used to compile the software:

ros2 run openzen_driver openzen_node --ros-args --remap __ns:=/openzen

By default, it will connect to the first available sensor. If you want to connect to a specific sensor, you can use the serial name of the sensor as parameter, for example:

ros2 run openzen_driver openzen_node -r __ns:=/openzen/ --ros-args --remap __ns:=/openzen -p sensor_name:="LPMSCU2000573"

If your sensor is configured for a different baud rate, you can use the baudrate parameter to give a specfic baud rate setting:

ros2 run openzen_driver openzen_node -r __ns:=/openzen/ --ros-args --remap __ns:=/openzen -p sensor_name:="LPMSCU2000573" -p baudrate:=115200

Now you can print the IMU values from ROS with:

ros2 topic echo /openzen/data

To output the values of a GPS unit (if available) use this command:

ros2 topic echo /openzen/nav

Or plot some values (for example linear acceleration) with

ros2 run rqt_plot rqt_plot /openzen/data/angular_velocity

We have prepared a sample launch file openzen_lpms.launch to demonstrate data acquisition and plotting using openzen_sensor_node:

ros2 launch openzen_sensor openzen_lpms_ig1.launch

To change to autocalibration setting via the command line:

ros2 service call /enable_gyro_autocalibration std_srvs/SetBool "{data: true}"

To trigger an gyroscope calibration:

ros2 service call /calibrate_gyroscope std_srvs/Trigger

CHANGELOG

Changelog for package openzen_driver

1.2.0 (2021-04-20)

  • init version

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged openzen_driver at Robotics Stack Exchange