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.
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.
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_infotopic does not work for rectification: see issue 24.
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 |
Please see the file called LICENSE.