Sick_Safetyscanners ROS2 Driver

A ROS2 Driver which reads the raw data from the SICK Safety Scanners and publishes the data as a laser_scan msg.

The ROS1 Driver can be found here: https://github.com/SICKAG/sick_safetyscanners

Table of contents

• Supported Hardware
• Getting started
• ROS API
• Creators

Supported Hardware

Supported are all microScan3, nanoScan3 and outdoorScan3 variants with Ethernet connection.

Getting started

In the future the ROS2 driver will be released as a debian package, currently only build from source is supported.

Prerequisites

• Linux
• Working ROS-Distro
• Correctly setup SICK Safety Scanner
• Connected SICK Safety Scanner and a correctly setup ethernet network. Both the host and the sensor have to be in the same network.

Installation

Dependencies

Dependencies can be installed via

sudo apt-get install ros-<rosdistro>-sick-safetyscanners2-interfaces
sudo apt-get install ros-<rosdistro>-sick-safetyscanners-base

The sources can be found here:

• sick_safetyscanners_base (https://github.com/SICKAG/sick_safetyscanners_base)
• sick_safetyscanners2_interfaces (https://github.com/SICKAG/sick_safetyscanners2_interfaces)

From Source

source /opt/ros/<rosdistro>/setup.bash
mkdir -p ~/colcon_ws/src/
cd ~/colcon_ws/src/
git clone https://github.com/SICKAG/sick_safetyscanners2.git
cd ..
colcon build --symlink-install
source ~/colcon_ws/install/setup.sh

Starting

Classic Node

To start the driver the launch file has to be started. For the driver to work correctly, the sensor ip and host ip have to be defined. These parameters can be passed to the sensor as arguments via launch file.

ros2 launch sick_safetyscanners2 sick_safetyscanners2_launch.py

This will start the driver with the in launch file defined parameters.

Lifecycle Node

To start the driver within a lifecycle the launch file has to be started. For the driver to work correctly, the sensor ip and host ip have to be defined. These parameters can be passed to the sensor as arguments via launch file.

ros2 launch sick_safetyscanners2 sick_safetyscanners2_lifecycle_launch.py

This will start the driver with the in launch file defined parameters.

To configure and activate the lifecycle node the following commands have to be issued:

// Configure
ros2 lifecycle set /sick_safetyscanners2_lifecycle_node configure

//Activate
ros2 lifecycle set /sick_safetyscanners2_lifecycle_node activate

Visualization

To visualize the data start rviz2 and subscribe to the ~/scan topic. By default the frame_id is “scan” however this can be customized in the launch file

rviz2

Troubleshooting

• Check if the sensor has power and is connected to the host.
• Check if both sensor and host are in the same subnet e.g. 192.168.1
• Check if the launch file is called with the correct parameters for IP-addresses and ports.

ROS2 API

Advertised ROS2 Topics

` ~/scan (type: sensor_msgs/msg/LaserScan) `

Publishes a scan from the laserscanner

` ~/extended_laser_scan (type: sick_safetyscanners2_interfaces/msg/ExtendedLaserScan) `

Extends the basic laser scan message by reflector data and intrusion data.

` ~/output_paths (type: sick_safetyscanners2_interfaces/msg/OutputPath) `

Gives feedback of the current status of the output paths.

` ~/raw_data (type: sick_safetyscanners2_interfaces/msg/RawMicroScanData) `

Publishes the raw data from the sensor as a ROS2 message.

` ~/diagnostics (type: diagnostic_msgs/msg/DiagnosticArray) `

Frequency and sensor diagnostics

Advertised ROS2 Services

` ~/field_data `

Returns all configured protective and warning fields for the sensor

ROS2 parameters

Creators

Lennart Puck

FZI Forschungszentrum Informatik

• http://www.fzi.de

on behalf of SICK AG

• http://www.sick.com

\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^ Changelog for package sick_safetyscanners2 \^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^

1.0.4 (2024-09-24)

• possible fix for out of range
• Add material for correct representation in Gazebo Sim.
• Enable workin in Gazebo under humble.
• enabled gazebo integration in urdf
• generated description folder using RTW
• diagnostics for lifecycle node aswell
• refactor: combine Node and LifeCycle node implementations
• Contributors: Dr. Denis Štogl, Lennart Puck, Nibanovic, Rein Appeldoorn

1.0.3 (2021-12-22)

• Fixes unsafe pointer access in UDP callback
• Implement lifecycle node
• Added functionality to allow multicast
• set not using the default sick angles as default
• moved changeSensor settings to be always be invoked
• fixed typo in launch file
• Contributors: Brice, Erwin Lejeune, Soma Gallai, Lennart Puck, Tanmay

1.0.2 (2021-03-15)

• added missing dependencies to package xml
• Contributors: Lennart Puck

1.0.1 (2021-03-05)

• changed the parameter callback interface so its only triggered when the parameters of this node are called
• Contributors: Lennart Puck

1.0.0 (2021-01-11)

• Initial Release