Parameters

Name

Data Type

Default Value

Description

~/buffer_id_list

string array

{"CONFIDENCE_IMAGE", "EXTRINSIC_CALIB", "NORM_AMPLITUDE_IMAGE", "RADIAL_DISTANCE_IMAGE", "RADIAL_DISTANCE_NOISE", "REFLECTIVITY", "TOF_INFO", "XYZ"} for the TOF cameras and {"JPEG_IMAGE", "RGB_INFO"} for the RGB cameras.

List of buffer_id strings denoting the wanted buffers.

~/config_file

string

""

Path to a JSON configuration file to be used when configuring the node. Absolute path to a file, or relative path from a package’s share directory possible, if prefixed by package://<my_package>/path/to/config.json. Relative path without package:// prefix is assumed to be relative to ifm3d_ros2 share directory. Parameter is ignored if "" is provided.

~/ip

string

"192.168.0.69"

The ip address of the camera.

~/pcic_port

int

50010

PCIC port corresponding to the targeted camera port.

~/publish_uncompressed

bool

false

If true, most sensor messages will be published best_effort instead of reliable.

~/tf.base_frame_name

string

"ifm_base_link"

Name for ifm reference frame.

~/tf.mounting_frame_name

string

"<node_name>_mounting_link"

Name for the mounting point frame.

~/tf.optical_frame_name

string

"<node_name>_optical_link"

Name for the optical frame.

~/tf.publish_base_to_mounting

bool

true

Whether the transform from the ifm base link to the camera mounting point should be published.

~/tf.publish_mounting_to_optical

bool

true

Whether the transform from the cameras mounting point to the optical center should be published.

~/xmlrpc_port

uint

80

TCP port the on-camera xmlrpc server is listening on.

~/use_timestamp_from_device

bool

true

Uses timestamp from VPU for messages if true; uses ROS time if false;

Transform Parameters

The camera node publishes transforms between coordinate frames. For detailed information about the O3R transform system, calibration process, and frame relationships, see Camera Transforms and Calibration.

Quick Reference:

  • ifm_base_link: Reference frame after calibration (your coordinate system)

  • mounting_link: Physical mounting point at the back of camera housing

  • optical_link: Optical center of the camera sensor

Description of the base, mounting and optical frames

The reference of the mounting frame is at the back of the O3R camera head housing (scale drawings can be found on ifm.com in the download section of the specific article). The reference for the ifm base frame is defined by the extrinsic parameters set in the JSON configuration of the O3R platform (extrinsicHeadToUser). Generally, the ifm base frame is configured to have for origin the center of the robot coordinate system, but this is not required. When no extrinsic parameter is set, the ifm base frame and the mounting frame are the same.

Focused description of the optical and mounting frames

The optical frame refers to the reference point of the optical system (lens, chip, etc). A static transform is published between the mounting link and the optical link, that corresponds to the intrinsic calibration parameters of the camera. Each set of intrinsic parameters is unique to a specific camera head and set in production. These parameters are not expected to change over time.