Files
OrbbecSDK_ROS2/en/.doctrees/source/camera_devices/8_FAQ/FAQ.doctree
T

35 lines
30 KiB
Plaintext
Raw Normal View History

2026-02-05 06:28:53 +00:00
€•ÚvŒdocutils.nodes”Œdocument”“”)�”}”(Œ rawsource”Œ”Œchildren”]”hŒsection”“”)�”}”(hhh]”(hŒtitle”“”)�”}”(hŒFrequently Asked Questions”h]”hŒText”“”ŒFrequently Asked Questions”…”�”}”(Œparent”hŒ _document”hŒsource”NŒline”NubaŒ
2026-01-13 02:41:46 +00:00
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”uŒtagname”hhKhh hŒZ/home/runner/work/OrbbecSDK_ROS2/OrbbecSDK_ROS2/docs/en/source/camera_devices/8_FAQ/FAQ.md”ubh
)�”}”(hhh]”(h)�”}”(hŒUnexpected Crash”h]”hŒUnexpected Crash”…”�”}”(hh-hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhKhh*hh)ubhŒ paragraph”“”)�”}”(hŒìIf the camera node crashes unexpectedly, it will generate a crash log in the current running directory: Log/camera_crash_stack_trace_xx.log. Please send this log to the support team or submit it to a GitHub issue for further assistance.”h]”(hŒhIf the camera node crashes unexpectedly, it will generate a crash log in the current running directory: ”…”�”}”(hh<hhhNhNubhŒliteral”“”)�”}”(hŒ#Log/camera_crash_stack_trace_xx.log”h]”hŒ#Log/camera_crash_stack_trace_xx.log”…”�”}”(hhFhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhh<hhhh)hKubhŒa. Please send this log to the support team or submit it to a GitHub issue for further assistance.”…”�”}”(hh<hhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKhh*hhhh)ubeh}”(h ]”Œunexpected-crash”ah"]”h$]”Œunexpected crash”ah&]”uh(h hKhh hhhh)ubh
)�”}”(hhh]”(h)�”}”(hŒ$No Data Stream from Multiple Cameras”h]”hŒ$No Data Stream from Multiple Cameras”…”�”}”(hhfhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhKhhchh)ubh;)�”}”(hŒInsufficient Power Supply:”h]”(hŒstrong”“”)�”}”(hŒInsufficient Power Supply”h]”hŒInsufficient Power Supply”…”�”}”(hhyhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhhshhhh)hKubhŒ:”…”�”}”(hhshhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hK hhchhhh)ubhŒ bullet_list”“”)�”}”(hhh]”(hŒ list_item”“”)�”}”(hhh]”h;)�”}”(hŒ7Ensure that each camera is connected to a separate hub.”h]”hŒ7Ensure that each camera is connected to a separate hub.”…”�”}”(hh™hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK hh–hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hK hh‘hhhh)ubh•)�”}”(hhh]”h;)�”}”(hŒ=Use a powered hub to provide sufficient power to each camera.”h]”hŒ=Use a powered hub to provide sufficient power to each camera.”…”�”}”(hh®hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK hh«hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hK hh‘hhhh)ubeh}”(h ]”h"]”h$]”h&]”uh(h�hK hhchhhh)ubh;)�”}”(hŒHigh Resolution:”h]”(hx)�”}”(hŒHigh Resolution”h]”hŒHigh Resolution”…”�”}”(hhÉhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhhÅhhhh)hKubhŒ:”…”�”}”(hhÅhhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKhhchhhh)ubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒ:Try lowering the resolution to resolve data stream issues.”h]”hŒ:Try lowering the resolution to resolve data stream issues.”…”�”}”(hhåhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hKhhâhhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hKhhßhhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h�hKhhchhhh)ubh;)�”}”(hŒIncrease usbfs_memory_mb Value:”h]”(hx)�”}”(hŒIncrease usbfs_memory_mb Value”h]”(hŒIncrease usbfs”…”�”}”(hjhhhNhNubhŒ_”…”�”}”(hjhhhNhNubhŒmemory”…”�”}”(hjhhhNhNubhŒ_”…”�”}”(hjhhhh)hKubhŒmb Value”…”�”}”(hjhhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(hwhhühhhh)hKubhŒ:”…”�”}”(hhühhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKhhchhhh)ubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒœIncrease the usbfs_memory_mb value to 128MB (this is a reference value and can be adjusted based on your system’s needs) by running the following command:”h]”(hŒ
2026-02-05 06:28:53 +00:00
Increase the ”…”�”}”(hj,hhhNhNubhE)�”}”(hŒusbfs_memory_mb”h]”hŒusbfs_memory_mb”…”�”}”(hj4hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj,hhhh)hKubhŒ€ value to 128MB (this is a reference value and can be adjusted based on your system’s needs) by running the following command:”…”�”}”(hj,hhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKhj)hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hKhj&hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h�hKhhchhhh)ubhŒ
literal_block”“”)�”}”(hŒF echo 128 | sudo tee /sys/module/usbcore/parameters/usbfs_memory_mb”h]”hŒF echo 128 | sudo tee /sys/module/usbcore/parameters/usbfs_memory_mb”…”�”}”hjVsbah}”(h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh(jThhchhhh)hKubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒ/To make this change permanent, check this link.”h]”(hŒ%To make this change permanent, check ”…”�”}”(hjkhhhNhNubhŒ reference”“”)�”}”(hŒ this link”h]”hŒ this link”…”�”}”(hjuhhhNhNubah}”(h ]”h"]”h$]”h&]”Œrefuri”Œ5https://github.com/OpenKinect/libfreenect2/issues/807”uh(jshKhjkhhhh)ubhŒ.”…”�”}”(hjkhhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKhjhhhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hKhjehhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h�hKhhchhhh)ubeh}”(h ]”Œ$no-data-stream-from-multiple-cameras”ah"]”h$]”Œ$no data stream from multiple cameras”ah&]”uh(h hKhh hhhh)ubh
)�”}”(hhh]”(h)�”}”(hŒHow to Collect and Save Logs”h]”hŒHow to Collect and Save Logs”…”�”}”(hj¡hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhKhjžhh)ubhŒenumerated_list”“”)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hXSDK debug logs
Set the launch parameter log_level to debug. After running, the SDK will generate log files in the Log/ folder under the current project directory. If you want a more recognizable file name for this test, you can set the parameter log_file_name.”h]”(hx)�”}”(hŒSDK debug logs”h]”hŒSDK debug logs”…”�”}”(hjºhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhj¶hhhh)hKubhŒ
”…”�”}”(hj¶hhhNhNubhŒSet the launch parameter ”…”�”}”(hj¶hhhNhNubhE)�”}”(hŒ log_level”h]”hŒ log_level”…”�”}”(hjÏhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj¶hhhh)hKubhŒ to ”…”�”}”(hj¶hhhNhNubhE)�”}”(hŒdebug”h]”hŒdebug”…”�”}”(hjàhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj¶hhhh)hKubhŒ8. After running, the SDK will generate log files in the ”…”�”}”(hj¶hhhNhNubhE)�”}”(hŒLog/”h]”hŒLog/”…”�”}”(hjñhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj¶hhhh)hKubhŒ€ folder under the current project directory. If you want a more recognizable file name for this test, you can set the parameter ”…”�”}”(hj¶hhhNhNubhE)�”}”(hŒ
log_file_name”h]”hŒ
2026-01-13 11:20:30 +00:00
log_file_name”…”�”}”(hjhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj¶hhhh)hKubhŒ.”…”�”}”(hj¶hhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKhj³hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hKhj°hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(j®hKhjžhhhh)ubhŒ block_quote”“”)�”}”(hhh]”h;)�”}”(hX5SDK logs are appended to the same file: multiple launches will continue writing into the same log file.
2026-02-05 06:28:53 +00:00
Recommendation: before packaging logs to send to technical support, delete old log files, then reproduce the issue and collect new logs. This keeps the logs cleaner and makes troubleshooting more accurate.”h]”(hŒgSDK logs are appended to the same file: multiple launches will continue writing into the same log file.”…”�”}”(hj'hhhNhNubhŒ
”…”�”}”(hj'hhhNhNubhŒÍRecommendation: before packaging logs to send to technical support, delete old log files, then reproduce the issue and collect new logs. This keeps the logs cleaner and makes troubleshooting more accurate.”…”�”}”(hj'hhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hK!hj$hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(j"hK!hjžhhhh)ubj¯)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒ�ROS 2 logs (~/.ros/log)
In the launch file, set the node (or composable node container) parameter output to "log" to save ROS 2 logs locally.”h]”(hx)�”}”(hŒROS 2 logs (~/.ros/log)”h]”(hŒ ROS 2 logs (”…”�”}”(hjKhhhNhNubhE)�”}”(hŒ
~/.ros/log”h]”hŒ
~/.ros/log”…”�”}”(hjShhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhjKhhhh)hKubhŒ)”…”�”}”(hjKhhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(hwhjGhhhh)hKubhŒ
”…”�”}”(hjGhhhNhNubhŒJIn the launch file, set the node (or composable node container) parameter ”…”�”}”(hjGhhhNhNubhE)�”}”(hŒoutput”h]”hŒoutput”…”�”}”(hjqhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhjGhhhh)hKubhŒ to ”…”�”}”(hjGhhhNhNubhE)�”}”(hŒ"log"”h]”hŒ"log"”…”�”}”(hj‚hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhjGhhhh)hKubhŒ to save ROS 2 logs locally.”…”�”}”(hjGhhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hK$hjDhhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hK$hjAhhhh)ubah}”(h ]”h"]”h$]”h&]”uh(j®hK$hjžhhhh)ubj#)�”}”(hhh]”h;)�”}”(hŒôAfter setting output="log", ROS 2 logs will be stored in the ~/.ros/log/ directory.
When submitting an issue, please package both the SDK logs under the Log/ directory and the corresponding ROS 2 logs under ~/.ros/log/ for the same time period.”h]”(hŒAfter setting ”…”�”}”(hj¥hhhNhNubhE)�”}”(hŒ output="log"”h]”hŒ output="log"”…”�”}”(hj­hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj¥hhhh)hKubhŒ#, ROS 2 logs will be stored in the ”…”�”}”(hj¥hhhNhNubhE)�”}”(hŒ ~/.ros/log/”h]”hŒ ~/.ros/log/”…”�”}”(hj¾hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj¥hhhh)hKubhŒ directory.”…”�”}”(hj¥hhhNhNubhŒ
”…”�”}”(hj¥hhhNhNubhŒEWhen submitting an issue, please package both the SDK logs under the ”…”�”}”(hj¥hhhNhNubhE)�”}”(hŒLog/”h]”hŒLog/”…”�”}”(hj×hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj¥hhhh)hKubhŒ2 directory and the corresponding ROS 2 logs under ”…”�”}”(hj¥hhhNhNubhE)�”}”(hŒ ~/.ros/log/”h]”hŒ ~/.ros/log/”…”�”}”(hjèhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj¥hhhh)hKubhŒ for the same time period.”…”�”}”(hj¥hhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hK'hj¢hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(j"hK'hjžhhhh)ubeh}”(h ]”Œhow-to-collect-and-save-logs”ah"]”h$]”Œhow to collect and save logs”ah&]”uh(h hKhh hhhh)ubh
)�”}”(hhh]”(h)�”}”(hŒ#Why Are There So Many Launch Files?”h]”hŒ#Why Are There So Many Launch Files?”…”�”}”(hj
hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhK*hj
hh)ubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒEDifferent cameras have varying default resolutions and image formats.”h]”hŒEDifferent cameras have varying default resolutions and image formats.”…”�”}”(hj hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK,hjhhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hK,hjhhhh)ubh•)�”}”(hhh]”h;)�”}”(hŒ7To simplify usage, each camera has its own launch file.”h]”hŒ7To simplify usage, each camera has its own launch file.”…”�”}”(hj5hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK-hj2hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hK-hjhhhh)ubeh}”(h ]”h"]”h$]”h&]”uh(h�hK,hj
hhhh)ubeh}”(h ]”Œ"why-are-there-so-many-launch-files”ah"]”h$]”Œ#why are there so many launch files?”ah&]”uh(h hK*hh hhhh)ubh
)�”}”(hhh]”(h)�”}”(hŒCHow to Launch a Specific Camera When Multiple Cameras Are Connected”h]”hŒCHow to Launch a Specific Camera When Multiple Cameras Are Connected”…”�”}”(hjVhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhK/hjShh)ubh;)�”}”(hŒ‚While the launch file did not explicitly specify which device to use. In that case, the driver will connect to the default device.”h]”hŒ‚While the launch file did not explicitly specify which device to use. In that case, the driver will connect to the default device.”…”�”}”(hjchhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK1hjShhhh)ubh;)�”}”(hŒ:You can check the serial number of your device by running:”h]”hŒ:You can check the serial number of your device by running:”…”�”}”(hjphhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK3hjShhhh)ubjU)�”}”(hŒ(ros2 run orbbec_camera list_devices_node”h]”hŒ(ros2 run orbbec_camera list_devices_node”…”�”}”hj}sbah}”(h ]”h"]”h$]”h&]”Œlanguage”Œbash”jcjduh(jThjShhhh)hKubh;)�”}”(hŒ?Then launch with the serial number explicitly set, for example:”h]”hŒ?Then launch with the serial number explicitly set, for example:”…”�”}”(hjŒhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK8hjShhhh)ubjU)�”}”(hŒIros2 launch orbbec_camera femto_bolt.launch.py serial_number:=CL8H741005J”h]”hŒIros2 launch orbbec_camera femto_bolt.launch.py serial_number:=CL8H741005J”…”�”}”hj™sbah}”(h ]”h"]”h$]”h&]”Œlanguage”Œbash”jcjduh(jThjShhhh)hKubeh}”(h ]”ŒChow-to-launch-a-specific-camera-when-multiple-cameras-are-connected”ah"]”h$]”ŒChow to launch a specific camera when multiple cameras are connected”ah&]”uh(h hK/hh hhhh)ubh
)�”}”(hhh]”(h)�”}”(hŒVWhy Is It Necessary to Add Delays When Starting Multiple Cameras or Switching Streams?”h]”hŒVWhy Is It Necessary to Add Delays When Starting Multiple Cameras or Switching Streams?”…”�”}”(hj²hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhK=hj¯hh)ubh;)�”}”(hXaMulti-camera systems place high demands on USB bandwidth and device initialization timing. If multiple camera streams are started or switched simultaneously, it may cause temporary bandwidth congestion, leading to device initialization failures, stream startup errors, or frame drops. To ensure system stability, the following practices are recommended:”h]”hXaMulti-camera systems place high demands on USB bandwidth and device initialization timing. If multiple camera streams are started or switched simultaneously, it may cause temporary bandwidth congestion, leading to device initialization failures, stream startup errors, or frame drops. To ensure system stability, the following practices are recommended:”…”�”}”(hj¿hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK?hj¯hhhh)ubh�)�”}”(hhh]”(h•)�”}”(hhh]”(h;)�”}”(hŒMulti-camera startup phase”h]”hx)�”}”(hŒMulti-camera startup phase”h]”hŒMulti-camera startup phase”…”�”}”(hjÖhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhjÒhhhh)hKubah}”(h ]”h"]”h$]”h&]”uh(h:hKAhjÏhhhh)ubh;)�”}”(hŒÙWhen starting multiple cameras, it is recommended to introduce an appropriate delay between each camera startup (e.g., 2 seconds) to avoid instantaneous bandwidth overload or low-level device initialization conflicts.”h]”(hŒwWhen starting multiple cameras, it is recommended to introduce an appropriate delay between each camera startup (e.g., ”…”�”}”(hjèhhhNhNubhx)�”}”(hŒ 2 seconds”h]”hŒ 2 seconds”…”�”}”(hjðhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhjèhhhh)hKubhŒY) to avoid instantaneous bandwidth overload or low-level device initialization conflicts.”…”�”}”(hjèhhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKChjÏhhhh)ubeh}”(h ]”h"]”h$]”h&]”uh(h”hKAhjÌhhhh)ubh•)�”}”(hhh]”(h;)�”}”(hŒ.Stream enable/disable and mode switching phase”h]”hx)�”}”(hŒ.Stream enable/disable and mode switching phase”h]”hŒ.Stream enable/disable and mode switching phase”…”�”}”(hjhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhjhhhh)hKubah}”(h ]”h"]”h$]”h&]”uh(h:hKEhj hhhh)ubh;)�”}”(hXWhen invoking stream control services (such as set_streams_enable, toggle_depth, and toggle_color), avoid triggering multiple service calls at the same time. Instead, introduce a reasonable interval between operations (e.g., 20 ms) to ensure reliable stream state transitions.”h]”(hŒ/When invoking stream control services (such as ”…”�”}”(hj$hhhNhNubhE)�”}”(hŒset_streams_enable”h]”hŒset_streams_enable”…”�”}”(hj,hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj$hhhh)hKubhŒ, ”…”�”}”(hj$hhhNhNubhE)�”}”(hŒ toggle_depth”h]”hŒ toggle_depth”…”�”}”(hj=hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj$hhhh)hKubhŒ, and ”…”�”}”(hj$hhhNhNubhE)�”}”(hŒ toggle_color”h]”hŒ toggle_color”…”�”}”(hjNhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj$hhhh)hKubhŒ€), avoid triggering multiple service calls at the same time. Instead, introduce a reasonable interval between operations (e.g., ”…”�”}”(hj$hhhNhNubhx)�”}”(hŒ20 ms”h]”hŒ20 ms”…”�”}”(hj_hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhj$hhhh)hKubhŒ.) to ensure reliable stream state transitions.”…”�”}”(hj$hhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKGhj hhhh)ubeh}”(h ]”h"]”h$]”h&]”uh(h”hKEhjÌhhhh)ubeh}”(h ]”h"]”h$]”h&]”uh(h�hKAhj¯hhhh)ubh;)�”}”(hŒ®Following these timing control guidelines can significantly improve the stability of multi-camera systems during startup and runtime, reducing errors and unexpected behavior.”h]”hŒ®Following these timing control guidelines can significantly improve the stability of multi-camera systems during startup and runtime, reducing errors and unexpected behavior.”…”�”}”(hjhhhNhNubah}”
2026-01-13 11:20:30 +00:00
)�”}”(hhh]”(h)�”}”(hŒfemto bolt depth stream no data”h]”hŒfemto bolt depth stream no data”…”�”}”(hj–hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhKJhj“hh)ubh;)�”}”(hŒôThis module depends on the OpenGL library at runtime. If OpenGL is not installed or the graphics driver is incomplete, the depth stream may output no data. Please make sure to install the necessary OpenGL libraries first (Ubuntu example below):”h]”hŒôThis module depends on the OpenGL library at runtime. If OpenGL is not installed or the graphics driver is incomplete, the depth stream may output no data. Please make sure to install the necessary OpenGL libraries first (Ubuntu example below):”…”�”}”(hj£hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hKLhj“hhhh)ubjU)�”}”(hŒP sudo apt update && sudo apt install -y mesa-utils libgl1-mesa-glx libglu1-mesa”h]”hŒP sudo apt update && sudo apt install -y mesa-utils libgl1-mesa-glx libglu1-mesa”…”�”}”hj°sbah}”(h ]”h"]”h$]”h&]”Œlanguage”Œbash”jcjduh(jThj“hhhh)hKubh;)�”}”(hŒ\After installation, you can check whether OpenGL is available through the following command:”h]”hŒ\After installation, you can check whether OpenGL is available through the following command:”…”�”}”(hj¿hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hKRhj“hhhh)ubjU)�”}”(hŒ glxinfo -B”h]”hŒ glxinfo -B”…”�”}”hjÌsbah}”(h ]”h"]”h$]”h&]”Œlanguage”Œbash”jcjduh(jThj“hhhh)hKubeh}”(h ]”Œfemto-bolt-depth-stream-no-data”ah"]”h$]”Œfemto bolt depth stream no data”ah&]”uh(h hKJhh hhhh)ubh
2026-02-05 06:28:53 +00:00
)�”}”(hhh]”(h)�”}”(hŒ.The image does not reach the preset frame rate”h]”hŒ.The image does not reach the preset frame rate”…”�”}”(hjåhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhKXhjâhh)ubh;)�”}”(hŒ�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:”h]”hŒ�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:”…”�”}”(hjòhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hKZhjâhhhh)ubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ
ros2 topic hz”h]”hE)�”}”(hŒ
ros2 topic hz”h]”hŒ
2026-01-13 02:41:46 +00:00
ros2 topic hz”…”�”}”(hj hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhjhhhh)hKubah}”(h ]”h"]”h$]”h&]”uh(h:hK\hjhhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hK\hjÿhhhh)ubh•)�”}”(hhh]”h;)�”}”(hŒrqt”h]”hE)�”}”(hŒrqt”h]”hŒrqt”…”�”}”(hj'hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhj#hhhh)hKubah}”(h ]”h"]”h$]”h&]”uh(h:hK]hj hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hK]hjÿhhhh)ubh•)�”}”(hhh]”h;)�”}”(hŒFCustom tools (such as the benchmark tool provided by this ROS package)”h]”(hŒCustom tools (such as the ”…”�”}”(hjAhhhNhNubhE)�”}”(hŒ benchmark”h]”hŒ benchmark”…”�”}”(hjIhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhjAhhhh)hKubhŒ# tool provided by this ROS package)”…”�”}”(hjAhhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hK^hj>hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hK^hjÿhhhh)ubeh}”(h ]”h"]”h$]”h&]”uh(h�hK\hjâhhhh)ubh;)�”}”(hX)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.”h]”hX)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.”…”�”}”(hjihhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hK`hjâhhhh)ubh;)�”}”(hŒzIf you confirm that the image frame rate does not reach the preset value, you can try the following troubleshooting steps:”h]”hŒzIf you confirm that the image frame rate does not reach the preset value, you can try the following troubleshooting steps:”…”�”}”(hjvhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(h:hKbhjâhhhh)ubj¯)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ|Reduce the resolution or frame rate to determine whether the frame rate is reduced due to USB/network bandwidth limitations;”h]”(hx)�”}”(hŒ#Reduce the resolution or frame rate”h]”hŒ#Reduce the resolution or frame rate”…”�”}”(hj�hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhj‰hhhh)hKubhŒY to determine whether the frame rate is reduced due to USB/network bandwidth limitations;”…”�”}”(hj‰hhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKdhj†hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hKdhjƒhhhh)ubh•)�”}”(hhh]”h;)�”}”(hŒ�Confirm whether the camera firmware version and ROS package version are the latest. Older versions may have performance or compatibility issues.”h]”(hx)�”}”(hŒRConfirm whether the camera firmware version and ROS package version are the latest”h]”hŒRConfirm whether the camera firmware version and ROS package version are the latest”…”�”}”(hj¯hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhj«hhhh)hKubhŒ>. Older versions may have performance or compatibility issues.”…”�”}”(hj«hhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKehj¨hhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hKehjƒhhhh)ubeh}”(h ]”h"]”h$]”h&]”uh(j®hKdhjâhhhh)ubh;)�”}”(hŒŒIf the above methods still cannot solve the problem, please contact our company FAE, or submit an issue in GitHub Issue for further support.”h]”(hŒPIf the above methods still cannot solve the problem, please contact our company ”…
2025-09-15 06:27:21 +00:00
)�”}”(hhh]”(h)�”}”(hŒ#Issues related to soft trigger mode”h]”hŒ#Issues related to soft trigger mode”…”�”}”(hjhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hhKjhjhh)ubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hXEach sensor does not flow out at the same time when the signal is triggered
2026-02-05 06:28:53 +00:00
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.”h]”(hx)�”}”(hŒKEach sensor does not flow out at the same time when the signal is triggered”h]”hŒKEach sensor does not flow out at the same time when the signal is triggered”…”�”}”(hjhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hwhjhhhh)hKubhŒ
”…”�”}”(hjhhhNhNubhŒCPlease enable the frame aggregation function and set the parameter ”…”�”}”(hjhhhNhNubhE)�”}”(hŒframe_aggregate_mode”h]”hŒframe_aggregate_mode”…”�”}”(hj4hhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhjhhhh)hKubhŒ to ”…”�”}”(hjhhhNhNubhE)�”}”(hŒ
2025-10-22 03:11:03 +00:00
full_frame”h]”hŒ
2025-09-15 06:27:21 +00:00
full_frame”…”�”}”(hjEhhhNhNubah}”(h ]”h"]”h$]”h&]”uh(hDhjhhhh)hKubhŒU to ensure that multiple sensor data are output synchronously under the same trigger.”…”�”}”(hjhhhNhNubeh}”(h ]”h"]”h$]”h&]”uh(h:hKlhjhhhh)ubah}”(h ]”h"]”h$]”h&]”uh(h”hKlhjhhhh)ubh•)�”}”(hhh]”(h;)�”}”(hX'The preset frame rate cannot be reached in auto trigger mode