ifm3d-ros2 overview

This documentation is formatted to be read on www.ros2.ifm3d.com.

Note

This release is intended to be used with the O3R camera platform ONLY. For other ifm cameras (e.g. O3D3xx and O3X1xx) please see the tagged releases 0.3.0 and 0.7.0 respectively.

ifm3d-ros2 is a wrapper around ifm3d enabling the usage of ifm O3R camera platform from within ROS 2 software systems.

As of version 1.2.0, ifm3d_ros2 also supports the Obstacle Detection Solution (ODS). Refer to the ODS documentation for more details on this application.

Software Compatibility Matrix

Releases versions

ifm3d_ros2 version	ifm3d version	O3R firmware version	ROS 2 distribution	Comment
1.2.0	1.4.3 to 1.5.3	1.4.30	Jazzy, Humble	Added support for ODS applications
1.1.0	1.2.6	1.0.14	Humble
1.0.1	0.93.0	0.14.23	Foxy

Note: The version numbers listed above for the ifm3d API or the O3R firmware versions are the ones explicitly tested. Any other version might work but is not officially supported.

Known Issues

For a complete list of changes, refer to the changelog.

Below is a list of all known issues with the latest released version:

• There is an issue in how the intrinsic parameters are calculated: see issue 18.

• The camera_info topic does not work for rectification: see issue 24.

Deprecated ifm3d-ros2 versions

The following versions are deprecated and no longer supported.

ifm3d_ros2 version	ifm3d version	ROS 2 distribution
1.0.1 DEPRECATED	0.93.0	Galactic
1.0.0 DEPRECATED	0.92.0	Galactic
0.3.0 DEPRECATED	0.17.0	Dashing, Eloquent
0.2.0 DEPRECATED	0.12.0	Dashing
0.1.1 DEPRECATED	0.12.0	Dashing
0.1.0 DEPRECATED	0.12.0	Dashing

LICENSE

Please see the file called LICENSE.