Update launch parameters and README

This commit is contained in:
obyalian
2025-09-02 17:09:25 +08:00
committed by xiexun
parent d2cb690b03
commit 3622fbb09f
3 changed files with 22 additions and 15 deletions
+3
View File
@@ -304,6 +304,9 @@ The following are the launch parameters available:
* Interval for synchronizing the camera time with the host system. * Interval for synchronizing the camera time with the host system.
* Unit: seconds. * Unit: seconds.
> **Note** : This parameter only needs to be set when **`enable_sync_host_time = true`** and **`time_domain = device`** .
* **enable_laser** * **enable_laser**
* Enable the laser. The default value is `true` * Enable the laser. The default value is `true`
@@ -35,7 +35,7 @@ Once successfully started, the following menu will appear. Enter the correspondi
Used to manage camera calibration parameters, including: Used to manage camera calibration parameters, including:
* **k**: Camera intrinsic matrix (3×3) * **k**: Camera intrinsic matrix (3×3)
* **d**: Distortion coefficients (radial/tangential) * **d**: Distortion coefficients (1x8)
* **rotation**: Extrinsic rotation matrix (3×3) * **rotation**: Extrinsic rotation matrix (3×3)
* **translation**: Extrinsic translation vector (3×1) * **translation**: Extrinsic translation vector (3×1)
@@ -51,7 +51,8 @@ ros2 service call /camera/set_user_calib_params orbbec_camera_msgs/srv/SetUserCa
0.032955970615148544, 0.032955970615148544,
9.096559369936585e-05, 9.096559369936585e-05,
-0.0003368517500348389, -0.0003368517500348389,
-0.01115430984646082], -0.01115430984646082,
0.0, 0.0, 0.0],
rotation: [0.9999880790710449, 0.0003024190664291382, -0.004874417092651129, rotation: [0.9999880790710449, 0.0003024190664291382, -0.004874417092651129,
-0.0002965621242765337, 0.9999992251396179, 0.001202247804030776, -0.0002965621242765337, 0.9999992251396179, 0.001202247804030776,
0.004874777048826218, -0.0012007878394797444, 0.9999874234199524], 0.004874777048826218, -0.0012007878394797444, 0.9999874234199524],
@@ -121,17 +122,20 @@ ros2 topic echo /camera/device_status
### 3.1 Optimized Color Stream Latency ### 3.1 Optimized Color Stream Latency
In the previous version, enabling the color point cloud caused noticeable latency in color image publishing. In the previous version, enabling the color point cloud caused noticeable latency in color image publishing.
This version optimizes data synchronization and publishing, allowing color images and point clouds to correspond more in real time and eliminating visual delays. In this version, data synchronization and publishing have been optimized so that enabling the color point cloud no longer affects the depth stream publishing latency.
--- ---
### 3.2 Added `time_sync_period` ### 3.2 Added `time_sync_period`
A new parameter **time\_sync\_period** is added to set the time synchronization interval between the camera module and the host. A new parameter **time_sync_period** is introduced to configure the time synchronization interval between the camera module and the host.
* Unit: **seconds** * Unit: **seconds**
* Function: The camera aligns its internal timestamp with the host at the specified interval, ensuring consistent timestamps. * Function: The camera aligns its internal timestamp with the host at the specified interval, ensuring consistent timestamps.
> **Note** : This parameter only needs to be set when **`enable_sync_host_time = true`** and **`time_domain = device`** .
--- ---
### 3.3 Added `camera_info_url` and `ir_info_url` ### 3.3 Added `camera_info_url` and `ir_info_url`
@@ -175,8 +175,8 @@ def generate_launch_description():
DeclareLaunchArgument('angular_vel_cov', default_value='0.01'), DeclareLaunchArgument('angular_vel_cov', default_value='0.01'),
DeclareLaunchArgument('publish_tf', default_value='true'), DeclareLaunchArgument('publish_tf', default_value='true'),
DeclareLaunchArgument('tf_publish_rate', default_value='0.0'), DeclareLaunchArgument('tf_publish_rate', default_value='0.0'),
DeclareLaunchArgument('ir_info_url', default_value=''), DeclareLaunchArgument('ir_info_url', default_value='file:///home/yalian/work/test.yaml'),
DeclareLaunchArgument('color_info_url', default_value=''), DeclareLaunchArgument('color_info_url', default_value='file:///home/yalian/work/test.yaml'),
# Network device settings: default enumerate_net_device is set to true, which will automatically enumerate network devices # Network device settings: default enumerate_net_device is set to true, which will automatically enumerate network devices
# If you do not want to automatically enumerate network devices, # If you do not want to automatically enumerate network devices,
# you can set enumerate_net_device to false, net_device_ip to the device's IP address, and net_device_port to the default value of 8090 # you can set enumerate_net_device to false, net_device_ip to the device's IP address, and net_device_port to the default value of 8090
@@ -240,13 +240,13 @@ def generate_launch_description():
DeclareLaunchArgument('align_mode', default_value='SW'), DeclareLaunchArgument('align_mode', default_value='SW'),
DeclareLaunchArgument('align_target_stream', default_value='COLOR'),# COLOR or DEPTH DeclareLaunchArgument('align_target_stream', default_value='COLOR'),# COLOR or DEPTH
DeclareLaunchArgument('diagnostic_period', default_value='1.0'), # seconds DeclareLaunchArgument('diagnostic_period', default_value='1.0'), # seconds
DeclareLaunchArgument('time_sync_period', default_value='6.0'), # seconds
DeclareLaunchArgument('enable_laser', default_value='true'), DeclareLaunchArgument('enable_laser', default_value='true'),
DeclareLaunchArgument('depth_precision', default_value=''), DeclareLaunchArgument('depth_precision', default_value=''),
DeclareLaunchArgument('device_preset', default_value='Default'), DeclareLaunchArgument('device_preset', default_value='Default'),
DeclareLaunchArgument('retry_on_usb3_detection_failure', default_value='false'), DeclareLaunchArgument('retry_on_usb3_detection_failure', default_value='false'),
DeclareLaunchArgument('laser_energy_level', default_value='-1'), DeclareLaunchArgument('laser_energy_level', default_value='-1'),
DeclareLaunchArgument('enable_sync_host_time', default_value='true'), DeclareLaunchArgument('enable_sync_host_time', default_value='true'),
DeclareLaunchArgument('time_sync_period', default_value='6.0'), # seconds
DeclareLaunchArgument('time_domain', default_value='global'),# global, device, system DeclareLaunchArgument('time_domain', default_value='global'),# global, device, system
DeclareLaunchArgument('enable_color_undistortion', default_value='false'), DeclareLaunchArgument('enable_color_undistortion', default_value='false'),
DeclareLaunchArgument('config_file_path', default_value=''), DeclareLaunchArgument('config_file_path', default_value=''),