sicks300_ros2

Overview

This package implements a driver for the Sick S300 Safety laser scanners with an interface for ROS 2 using a lifecycle node. It provides an implementation for both, the old (1.40) and the new (2.10) protocol. Thus, the old Sick S300 Professional CMS as well as the new Sick S300 Expert are supported.

However, it does not cover the full functionality of the protocol:

• It only handles distance measurements properly
• It only handles no or only one configured measurement range field properly
• It does not handle I/O-data or reflector data (though it reads the reflector marker field in the distance measurements)

Keywords: ROS2, laser, driver, sick s300, lifecycle

The sicks300_ros2 package has been tested under [ROS2] Humble on [Ubuntu] 22.04. but ported to ROS2. This is research code, expect that it changes often and any fitness for a particular purpose is disclaimed.

S300 Configuration

Here are a few notes about how to best configure the S300:

• Configure the RS422 output to 500kBaud (otherwise, the scanner only provides a lower frequency)
• Configure the scanner to Continuous Data Output
• Send data via one telegram
• Only configure distances, no I/O or reflector data (otherwise, the scanner only provides a lower frequency).
• Configuration of the measurement ranges
  • For protocol 1.40: only configure one measurement range field with the full range (-45° to 225°) with all values.
  • For protocol 2.10: do not configure a measurement range field (otherwise, the scanner only provides a lower frequency).
• If you want to only use certain measurement ranges, do this on the ROS side using e.g. the laser_filters package.

Installation

Building from Source

Dependencies

• Robot Operating System (ROS) 2 (middleware for robotics),

Building

To build from source, clone the latest version from this repository into your colcon workspace and compile the package using

cd colcon_workspace/src
git clone https://github.com/ajtudela/sicks300_ros2.git
cd ../
rosdep install -i --from-path src --rosdistro humble -y
colcon build

Usage

Add the user to the dialout group to access the USB port:

sudo usermod -a -G dialout $USER

Run the sicks300_ros2 node with:

ros2 run sicks300_ros2 sicks300_ros2

Optionally, you can launch this node with an angulor bound filter:

ros2 launch sicks300_ros2 scan_with_filter.launch.py

Nodes

sicks300_ros2

Driver for the Sick S300 Safety laser scanners.

Published Topics

• scan ([sensor_msgs/LaserScan])

  The laserscan data.

• scan/standby ([std_msgs/Bool])

  True if the scanner is in standby mode, false otherwise.

• /diagnostics ([diagnostic_msgs/DiagnosticArray])

  Diagnostic about the laser scan.

Parameters

• port (string, default: “/dev/ttyUSB0”)

  USB port of the scanner.

• baud (int, default: 500000)

  Baudrate to communicate with the laser scanner.

File truncated at 100 lines see the full file