search

SICKAG / sick_safetyscanners

ROS driver for SICK safety laser scanners
https://www.sick.com/de/en/opto-electronic-protective-devices/safety-laser-scanners/c/g187225
Apache License 2.0
61 stars 59 forks source link
driver laserscanner microscan3 nanoscan3 outdoorscan3 ros-api ros-driver rosdistro safety-laser-scanner safety-laserscanner sensor sick-ag sick-safety-scanners sick-safetyscanners

readme

Sick_Safetyscanners ROS Driver

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

The ROS2 Driver can be found here: https://github.com/SICKAG/sick_safetyscanners2

Table of contents

Supported Hardware

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

Getting started

The ROS driver will be released as a debian package, and therefore can be installed from binaries or from source.

Prerequisites

Installation

In the following instructions, replace <rosdistro> with the name of your ROS distro (e.g., kinetic).

From Binaries

The driver is released at longer intervals as a binary package.

sudo apt-get install ros-<rosdistro>-sick-safetyscanners

From Source

source /opt/ros/<rosdistro>/setup.bash
mkdir -p ~/catkin_ws/src/
cd ~/catkin_ws/src/
git clone https://github.com/SICKAG/sick_safetyscanners.git
cd ..
catkin_make install
source ~/catkin_ws/install/setup.bash

Starting

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.

roslaunch sick_safetyscanners sick_safetyscanners.launch sensor_ip:=192.168.1.10 host_ip:=192.168.1.9

This will start the driver and the dynamic reconfigure node. In this you can set different parameters on runtime, especially the angles and the data the sensor should publish. If these parameters should be set on startup they can be loaded to the parameter server beforehand.

To visualize the data start rviz and subscribe to the ~/laser_scan topic.

rosrun rviz rviz

Troubleshooting

ROS API

Advertised ROS Topics

~/laser_scan (type: sensor_msgs/LaserScan)

Publishes a scan from the laserscanner

~/extended_laser_scan (type: sick_safetyscanners/ExtendedLaserScanMsg)

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

~/output_paths (type: sick_safetyscanners/OutputPathMsg)

Gives feedback of the current status of the output paths.

~/raw_data (type: sick_safetyscanners/RawMicroScanDataMsg)

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

~/diagnostics (type: diagnostic_msgs/DiagnosticArray)

Frequency and timestamp diagnostics information.

Advertised ROS Services

~/field_data

Returns all configured protective and warning fields for the sensor

~/config_metadata

Returns the meta data of the current configuration of the sensor

~/status_overview

Returns the status overview of the sensor

ROS parameters

All Parameters can be passed as commandline argument to the launch file. Parameter Name Type Default Required on startup Information
sensor_ip String 192.168.1.11 ✔ IP address of the sensor.
host_ip String 192.168.1.9 ✔ IP address of the receiving host/target computer.
interface_ip String 0.0.0.0 Interface IP address of the receiving host computer, this needs to be set if the host IP is in the multicast IP range. The default is an undefined IP address and will return an error when multicast is used without a correct interface
host_udp_port Integer 0 Host UDP Port. Zero allows system chosen port.
frame_id String scan The frame name of the sensor message
skip Integer 0 The number of scans to skip between each measured scan. For a 25Hz laser, setting 'skip' to 0 makes it publish at 25Hz, 'skip' to 1 makes it publish at 12.5Hz.
angle_start Double 0.0 Start angle of scan in radians, if both start and end angle are equal, all angels are regarded. 0° is at the front of the scanner.
angle_end Double 0.0 End angle of scan in radians, if both start and end angle are equal, all angels are regarded. 0° is at the front of the scanner.
min_intensities Double 0.0 If this parameter is set, all points below the one set in the parameter are set to infinity
channel Integer 0 Which channel should be configured, default is channel 0.
channel_enabled Boolean true If the channel should be enabled
general_system_state Boolean true If the general system state should be published
derived_settings Boolean true If the derived settings should be published
measurement_data Boolean true If the measurement data should be published
intrusion_data Boolean true If the intrusion data should be published
application_io_data Boolean true If the application IO data should be published
use_persistent_config Boolean false If this flag is set, the configured angles from the sensor are loaded and used and the ROS parameters angle_start and angle_end are disregarded
expected_frequency Double 24.0 Expected scanner frequency for diagnostics
frequency_tolerance Double 0.1 Diagnostics tolerance on expected frequency
timestamp_min_acceptable Double -1 Earliest acceptable timestamp delay for diagnostics
timestamp_max_acceptable Double 1 Latest acceptable timestamp delay for diagnostics

Creators

Lennart Puck

FZI Forschungszentrum Informatik

on behalf of SICK AG