diff --git a/en/.doctrees/environment.pickle b/en/.doctrees/environment.pickle index 45d09673..f9a61303 100644 Binary files a/en/.doctrees/environment.pickle and b/en/.doctrees/environment.pickle differ diff --git a/en/.doctrees/source/camera_devices/1_overview/introduction.doctree b/en/.doctrees/source/camera_devices/1_overview/introduction.doctree index ec988879..5bdf43c7 100644 Binary files a/en/.doctrees/source/camera_devices/1_overview/introduction.doctree and b/en/.doctrees/source/camera_devices/1_overview/introduction.doctree differ diff --git a/en/.doctrees/source/camera_devices/2_installation/build_the_package.doctree b/en/.doctrees/source/camera_devices/2_installation/build_the_package.doctree index 7cdd1d55..81beeac6 100644 Binary files a/en/.doctrees/source/camera_devices/2_installation/build_the_package.doctree and b/en/.doctrees/source/camera_devices/2_installation/build_the_package.doctree differ diff --git a/en/.doctrees/source/camera_devices/8_FAQ/FAQ.doctree b/en/.doctrees/source/camera_devices/8_FAQ/FAQ.doctree index d9a6eb37..fe6e78a1 100644 Binary files a/en/.doctrees/source/camera_devices/8_FAQ/FAQ.doctree and b/en/.doctrees/source/camera_devices/8_FAQ/FAQ.doctree differ diff --git a/en/_sources/source/camera_devices/1_overview/introduction.md.txt b/en/_sources/source/camera_devices/1_overview/introduction.md.txt index 8f5c6f12..24590672 100644 --- a/en/_sources/source/camera_devices/1_overview/introduction.md.txt +++ b/en/_sources/source/camera_devices/1_overview/introduction.md.txt @@ -186,6 +186,8 @@ To learn how to obtain and upgrade the latest firmware, [please click here](../3 | Femto Mega | [1.3.1](https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Mega-Firmware) | femto_mega.launch.py | | Femto Mega I | [2.0.4](https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Mega-I-Firmware) | femto_mega.launch.py | | Astra 2 | [2.8.20](https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Astra2_Release_2.8.20.zip) | astra2.launch.py | +| Gemini 345 | 1.7.12 | gemini345.launch.py | +| Gemini 345Lg | 1.7.12 | gemini345_lg.launch.py | | Pulsar SL450 | 2.2.4.5 | lidar.launch.py | | Pulsar ME450 | 1.0.0.6 | lidar.launch.py | diff --git a/en/_sources/source/camera_devices/2_installation/build_the_package.md.txt b/en/_sources/source/camera_devices/2_installation/build_the_package.md.txt index 8db9a820..660e8ec4 100644 --- a/en/_sources/source/camera_devices/2_installation/build_the_package.md.txt +++ b/en/_sources/source/camera_devices/2_installation/build_the_package.md.txt @@ -12,7 +12,7 @@ sudo apt install libgflags-dev nlohmann-json3-dev \ ros-$ROS_DISTRO-image-transport ros-${ROS_DISTRO}-image-transport-plugins ros-${ROS_DISTRO}-compressed-image-transport \ ros-$ROS_DISTRO-image-publisher ros-$ROS_DISTRO-camera-info-manager \ ros-$ROS_DISTRO-diagnostic-updater ros-$ROS_DISTRO-diagnostic-msgs ros-$ROS_DISTRO-statistics-msgs ros-$ROS_DISTRO-xacro \ -ros-$ROS_DISTRO-backward-ros libdw-dev libssl-dev +ros-$ROS_DISTRO-backward-ros libdw-dev libssl-dev mesa-utils libgl1 libgoogle-glog-dev ``` Enable ROS 2 auto-completion: diff --git a/en/_sources/source/camera_devices/8_FAQ/FAQ.md.txt b/en/_sources/source/camera_devices/8_FAQ/FAQ.md.txt index acaafb81..dbfe94b6 100644 --- a/en/_sources/source/camera_devices/8_FAQ/FAQ.md.txt +++ b/en/_sources/source/camera_devices/8_FAQ/FAQ.md.txt @@ -28,7 +28,8 @@ If the camera node crashes unexpectedly, it will generate a crash log in the cur ### Additional Troubleshooting - If you encounter other issues, set the `log_level` parameter to `debug`. This will generate an SDK log file in the running directory: `Log/OrbbecSDK.log.txt`. Please provide this file to the support team for further assistance. -- If firmware logs are required, set `enable_heartbeat` to `true` to activate this feature. +- If firmware logs are required, set the `log_level` parameter to `debug` and set `enable_heartbeat` to `true` to activate this feature. +- If you set the `log_level` parameter to `debug` and do not want the terminal to refresh too many logs, you can change `output="screen"` to `output="log"` in `launch`, and the logs will be saved in the `~/.ros/log` directory. ### Why Are There So Many Launch Files? @@ -75,3 +76,44 @@ This module depends on the OpenGL library at runtime. If OpenGL is not installed ```bash glxinfo -B ``` + +### The image does not reach the preset frame rate + +First you need to confirm whether the image does not reach the preset frame rate. There are several ways to view framerate in ROS 2, such as: + +* `ros2 topic hz` +* `rqt` +* Custom tools (such as the `benchmark` tool provided by this ROS package) + +It should be noted that different tools have different statistical methods and QoS configurations, so the frame rate results obtained may be different. When you find that the frame rate is lower than expected, please prioritize whether the error is caused by the frame rate statistics tool itself. + +If you confirm that the image frame rate does not reach the preset value, you can try the following troubleshooting steps: + +1. **Reduce the resolution or frame rate** to determine whether the frame rate is reduced due to USB/network bandwidth limitations; +2. **Confirm whether the camera firmware version and ROS package version are the latest**. Older versions may have performance or compatibility issues. + +If the above methods still cannot solve the problem, please contact our company **FAE**, or submit an issue in **GitHub Issue** for further support. + + +### Issues related to soft trigger mode + +* **Each sensor does not flow out at the same time when the signal is triggered** + Please enable the frame aggregation function and set the parameter `frame_aggregate_mode` to `full_frame` to ensure that multiple sensor data are output synchronously under the same trigger. + +* **The preset frame rate cannot be reached in auto trigger mode** + When setting `software_trigger_period`, you need to consider the actual open stream frame rate and exposure time. For example, when `color_fps` is set to 10 FPS, `software_trigger_period` cannot be lower than the following calculated value: + + ``` + software_trigger_period ≥ 1000000 / fps × N + 2 × expo + ``` + + Among them: + + * `fps`: sensor frame rate + * `N`: The number of frames collected in a single trigger + * `expo`: exposure time + * `Unit`: µs + + If `software_trigger_period` is set too small, the trigger frequency will be limited, resulting in frame loss. + + diff --git a/en/genindex.html b/en/genindex.html index 484918d6..0cfe5f18 100644 --- a/en/genindex.html +++ b/en/genindex.html @@ -333,6 +333,8 @@
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
Enable ROS 2 auto-completion:
@@ -466,7 +468,7 @@ colcon build --event-handlers© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
diff --git a/en/source/camera_devices/2_installation/installation.html b/en/source/camera_devices/2_installation/installation.html index 98658aa1..704e427c 100644 --- a/en/source/camera_devices/2_installation/installation.html +++ b/en/source/camera_devices/2_installation/installation.html @@ -336,6 +336,8 @@© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
diff --git a/en/source/camera_devices/3_quickstarts/orbbecviewer.html b/en/source/camera_devices/3_quickstarts/orbbecviewer.html index f329a69c..0fdf96ea 100644 --- a/en/source/camera_devices/3_quickstarts/orbbecviewer.html +++ b/en/source/camera_devices/3_quickstarts/orbbecviewer.html @@ -336,6 +336,8 @@© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
diff --git a/en/source/camera_devices/5_advanced_guide/performance/efficient_intra_process_communication.html b/en/source/camera_devices/5_advanced_guide/performance/efficient_intra_process_communication.html index 9e1f1049..5a18af57 100644 --- a/en/source/camera_devices/5_advanced_guide/performance/efficient_intra_process_communication.html +++ b/en/source/camera_devices/5_advanced_guide/performance/efficient_intra_process_communication.html @@ -336,6 +336,8 @@© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
diff --git a/en/source/camera_devices/7_developer_guide/building_a_Debian_Package.html b/en/source/camera_devices/7_developer_guide/building_a_Debian_Package.html index b19fe10e..14126788 100644 --- a/en/source/camera_devices/7_developer_guide/building_a_Debian_Package.html +++ b/en/source/camera_devices/7_developer_guide/building_a_Debian_Package.html @@ -336,6 +336,8 @@© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
If you encounter other issues, set the log_level parameter to debug. This will generate an SDK log file in the running directory: Log/OrbbecSDK.log.txt. Please provide this file to the support team for further assistance.
If firmware logs are required, set enable_heartbeat to true to activate this feature.
If firmware logs are required, set the log_level parameter to debug and set enable_heartbeat to true to activate this feature.
If you set the log_level parameter to debug and do not want the terminal to refresh too many logs, you can change output="screen" to output="log" in launch, and the logs will be saved in the ~/.ros/log directory.
First you need to confirm whether the image does not reach the preset frame rate. There are several ways to view framerate in ROS 2, such as:
+ros2 topic hz
rqt
Custom tools (such as the benchmark tool provided by this ROS package)
It should be noted that different tools have different statistical methods and QoS configurations, so the frame rate results obtained may be different. When you find that the frame rate is lower than expected, please prioritize whether the error is caused by the frame rate statistics tool itself.
+If you confirm that the image frame rate does not reach the preset value, you can try the following troubleshooting steps:
+Reduce the resolution or frame rate to determine whether the frame rate is reduced due to USB/network bandwidth limitations;
Confirm whether the camera firmware version and ROS package version are the latest. Older versions may have performance or compatibility issues.
If the above methods still cannot solve the problem, please contact our company FAE, or submit an issue in GitHub Issue for further support.
+© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© Copyright 2025, ORBBEC INC. www.orbbec.com.. - Last updated on 2026-01-13 02:41:39. + Last updated on 2026-01-13 11:20:23.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
启用 ROS 2 自动补全:
@@ -467,7 +469,7 @@ colcon build --event-handlers© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
diff --git a/zh/source/camera_devices/2_installation/installation.html b/zh/source/camera_devices/2_installation/installation.html index 7f11fca3..71bc3b2d 100644 --- a/zh/source/camera_devices/2_installation/installation.html +++ b/zh/source/camera_devices/2_installation/installation.html @@ -337,6 +337,8 @@© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
diff --git a/zh/source/camera_devices/3_quickstarts/orbbecviewer.html b/zh/source/camera_devices/3_quickstarts/orbbecviewer.html index 4106dd56..389af8a3 100644 --- a/zh/source/camera_devices/3_quickstarts/orbbecviewer.html +++ b/zh/source/camera_devices/3_quickstarts/orbbecviewer.html @@ -337,6 +337,8 @@© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
diff --git a/zh/source/camera_devices/7_developer_guide/building_a_Debian_Package.html b/zh/source/camera_devices/7_developer_guide/building_a_Debian_Package.html index 66ce19bc..3892eb52 100644 --- a/zh/source/camera_devices/7_developer_guide/building_a_Debian_Package.html +++ b/zh/source/camera_devices/7_developer_guide/building_a_Debian_Package.html @@ -337,6 +337,8 @@© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
如果遇到其他问题,将 log_level 参数设置为 debug。这将在运行目录中生成SDK日志文件:Log/OrbbecSDK.log.txt。请将此文件提供给支持团队以获得进一步帮助。
如果需要固件日志,将 enable_heartbeat 设置为 true 以激活此功能。
如果需要固件日志,将log_level 参数设置为 debug的同时,将 enable_heartbeat 设置为 true 以激活此功能。
若将log_level 参数设置为 debug的同时,又不想终端刷新太多日志,可以在launch中将output="screen"改为output="log",日志会被保存在~/.ros/log目录下。
首先需要确认图像是否确实未达到预设帧率。在 ROS 2 中可通过多种方式查看帧率,例如:
+ros2 topic hz
rqt
自定义工具(如本 ROS 包提供的 benchmark 工具)
需要注意的是,不同工具的统计方式和 QoS 配置不同,因此得到的帧率结果可能存在差异。当发现帧率低于预期时,请优先排查是否为帧率统计工具本身导致的误差。
+若确认图像帧率确实未达到预设值,可尝试以下排查步骤:
+降低分辨率或帧率,判断是否由于 USB / 网络带宽受限导致帧率下降;
确认相机固件版本及 ROS 包版本是否为最新,旧版本可能存在性能或兼容性问题。
若以上方法仍无法解决问题,请联系我司 FAE,或在 GitHub Issue 中提交问题以获得进一步支持。
+信号触发时各传感器未同时出流
+请开启帧汇聚功能,将参数frame_aggregate_mode设置为full_frame,以保证多传感器数据在同一次触发下同步输出。
自动触发模式下无法达到预设帧率
+设置 software_trigger_period 时,需要综合考虑实际开流帧率与曝光时间。例如,当 color_fps 设置为 10 FPS 时,software_trigger_period 不能低于以下计算值:
software_trigger_period ≥ 1000000 / fps × N + 2 × expo
+其中:
+fps:传感器帧率
N:单次触发采集的帧数量
expo:曝光时间
单位:µs
若 software_trigger_period 设置过小,将导致触发频率受限,从而丢帧。
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.
© 版权所有 2025, 奥比中光科技集团股份有限公司 www.orbbec.com.。 - 最后更新于 2026年01月13日 02:41:42. + 最后更新于 2026年01月13日 11:20:26.