)�”}”(hhh]”(h)�”}”(hŒUnexpected Crash”h]”hŒUnexpected Crash”…”�”}”(hh/hhhNhNubah}”(h ]”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”…”�”}”(hhIhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhh?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&]”h(]”uh*h=hKhh,hhhh+ubeh}”(h ]”Œunexpected-crash”ah"]”h$]”Œunexpected crash”ah&]”h(]”uh*h hKhhhhhh+ubh
)�”}”(hhh]”(h)�”}”(hŒ$No Data Stream from Multiple Cameras”h]”hŒ$No Data Stream from Multiple Cameras”…”�”}”(hhlhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhKhhihh+ubh>)�”}”(hŒInsufficient Power Supply:”h]”(hŒstrong”“”)�”}”(hŒInsufficient Power Supply”h]”hŒInsufficient Power Supply”…”�”}”(hh€hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h~hhzhhhh+hKubhŒ:”…”�”}”(hhzhhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hK hhihhhh+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&]”h(]”uh*h=hKhhŸhhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hKhhš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&]”h(]”uh*h=hKhh¶hhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hKhhšhhhh+ubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h˜hKhhihhhh+ubh>)�”}”(hŒHigh Resolution:”h]”(h)�”}”(hŒHigh Resolution”h]”hŒHigh Resolution”…”�”}”(hh×hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h~hhÓhhhh+hKubhŒ:”…”�”}”(hhÓhhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hKhhihhhh+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&]”h(]”uh*h=hKhhòhhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hKhhïhhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h˜hKhhihhhh+ubh>)�”}”(hŒIncrease usbfs_memory_mb Value:”h]”(h)�”}”(hŒIncrease usbfs_memory_mb Value”h]”(hŒIncrease usbfs”…”�”}”(hjhhhNhNubhŒ_”…”�”}”(hjhhhNhNubhŒmemory”…”�”}”(hjhhhNhNubhŒ_”…”�”}”(hjhhhh+hKubhŒmb Value”…”�”}”(hjhhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h~hjhhhh+hKubhŒ:”…”�”}”(hjhhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hKhhihhhh+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Œ
Increase the ”…”�”}”(hjAhhhNhNubhH)�”}”(hŒusbfs_memory_mb”h]”hŒusbfs_memory_mb”…”�”}”(hjIhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhjAhhhh+hKubhŒ€ value to 128MB (this is a reference value and can be adjusted based on your system’s needs) by running the following command:”…”�”}”(hjAhhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hKhj>hhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hKhj;hhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h˜hKhhihhhh+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”…”�”}”hjosbah}”(h ]”h"]”h$]”h&]”h(]”Œ xml:space”Œpreserve”uh*jmhhihhhh+hKubh™)�”}”(hhh]”hž)�”}”(hhh]”h>)�”}”(hŒ/To make this change permanent, check this link.”h]”(hŒ%To make this change permanent, check ”…”�”}”(hj…hhhNhNubhŒ reference”“”)�”}”(hŒ this link”h]”hŒ this link”…”�”}”(hj�hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”Œrefuri”Œ5https://github.com/OpenKinect/libfreenect2/issues/807”uh*j�hKhj…hhhh+ubhŒ.”…”�”}”(hj…hhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hKhj‚hhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hKhjhhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h˜hKhhihhhh+ubeh}”(h ]”Œ$no-data-stream-from-multiple-cameras”ah"]”h$]”Œ$no data stream from multiple cameras”ah&]”h(]”uh*h hKhhhhhh+ubh
)�”}”(hhh]”(h)�”}”(hŒAdditional Troubleshooting”h]”hŒAdditional Troubleshooting”…”�”}”(hjÀhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhKhj½hh+ubh™)�”}”(hhh]”(hž)�”}”(hhh]”h>)�”}”(hŒÝ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.”h]”(hŒ'If you encounter other issues, set the ”…”�”}”(hjÔhhhNhNubhH)�”}”(hŒ log_level”h]”hŒ log_level”…”�”}”(hjÜhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhjÔhhhh+hKubhŒ parameter to ”…”�”}”(hjÔhhhNhNubhH)�”}”(hŒdebug”h]”hŒdebug”…”�”}”(hjîhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhjÔhhhh+hKubhŒ?. This will generate an SDK log file in the running directory: ”…”�”}”(hjÔhhhNhNubhH)�”}”(hŒLog/OrbbecSDK.log.txt”h]”hŒLog/OrbbecSDK.log.txt”…”�”}”(hjhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhjÔhhhh+hKubhŒF. Please provide this file to the support team for further assistance.”…”�”}”(hjÔhhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hKhjÑhhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hKhjÎhhhh+ubhž)�”}”(hhh]”h>)�”}”(hŒUIf firmware logs are required, set enable_heartbeat to true to activate this feature.”h]”(hŒ#If firmware logs are required, set ”…”�”}”(hj!hhhNhNubhH)�”}”(hŒenable_heartbeat”h]”hŒenable_heartbeat”…”�”}”(hj)hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhj!hhhh+hKubhŒ to ”…”�”}”(hj!hhhNhNubhH)�”}”(hŒtrue”h]”hŒtrue”…”�”}”(hj;hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhj!hhhh+hKubhŒ to activate this feature.”…”�”}”(hj!hhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hKhjhhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hKhjÎhhhh+ubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h˜hKhj½hhhh+ubeh}”(h ]”Œadditional-troubleshooting”ah"]”h$]”Œadditional troubleshooting”ah&]”h(]”uh*h hKhhhhhh+ubh
)�”}”(hhh]”(h)�”}”(hŒ#Why Are There So Many Launch Files?”h]”hŒ#Why Are There So Many Launch Files?”…”�”}”(hjjhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhK!hjghh+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&]”h(]”uh*h=hK#hj{hhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hK#hjxhhhh+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.”…”�”}”(hj•hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hK$hj’hhhh+ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h�hK$hjxhhhh+ubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h˜hK#hjghhhh+ubeh}”(h ]”Œ"why-are-there-so-many-launch-files”ah"]”h$]”Œ#why are there so many launch files?”ah&]”h(]”uh*h hK!hhhhhh+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”…”�”}”(hjºhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhK&hj·hh+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.”…”�”}”(hjÈhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hK(hj·hhhh+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:”…”�”}”(hjÖhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hK*hj·hhhh+ubjn)�”}”(hŒ(ros2 run orbbec_camera list_devices_node”h]”hŒ(ros2 run orbbec_camera list_devices_node”…”�”}”hjäsbah}”(h ]”h"]”h$]”h&]”h(]”Œlanguage”Œbash”j}j~uh*jmhj·hhhh+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&]”h(]”uh*h=hK/hj·hhhh+ubjn)�”}”(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”…”�”}”hjsbah}”(h ]”h"]”h$]”h&]”h(]”Œlanguage”Œbash”j}j~uh*jmhj·hhhh+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&]”h(]”uh*h hK&hhhhhh+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?”…”�”}”(hjhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhK4hjhh+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&]”h(]”uh*h=hK6hjhhhh+ubh™)�”}”(hhh]”(hž)�”}”(hhh]”(h>)�”}”(hŒMulti-camera startup phase”h]”h)�”}”(hŒMulti-camera startup phase”h]”hŒMulti-camera startup phase”…”�”}”(hjChhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h~hj?hhhh+hKubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hK8hj<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., ”…”�”}”(hjWhhhNhNubh)�”}”(hŒ 2 seconds”h]”hŒ 2 seconds”…”�”}”(hj_hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h~hjWhhhh+hKubhŒY) to avoid instantaneous bandwidth overload or low-level device initialization conflicts.”…”�”}”(hjWhhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hK:hj<hhhh+ubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h�hK8hj9hhhh+ubhž)�”}”(hhh]”(h>)�”}”(hŒ.Stream enable/disable and mode switching phase”h]”h)�”}”(hŒ.Stream enable/disable and mode switching phase”h]”hŒ.Stream enable/disable and mode switching phase”…”�”}”(hj„hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h~hj€hhhh+hKubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hK<hj}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˜hhhNhNubhH)�”}”(hŒset_streams_enable”h]”hŒset_streams_enable”…”�”}”(hjhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhj˜hhhh+hKubhŒ, ”…”�”}”(hj˜hhhNhNubhH)�”}”(hŒtoggle_depth”h]”hŒtoggle_depth”…”�”}”(hj²hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhj˜hhhh+hKubhŒ, and ”…”�”}”(hj˜hhhNhNubhH)�”}”(hŒtoggle_color”h]”hŒtoggle_color”…”�”}”(hjÄhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hGhj˜hhhh+hKubhŒ€), avoid triggering multiple service calls at the same time. Instead, introduce a reasonable interval between operations (e.g., ”…”�”}”(hj˜hhhNhNubh)�”}”(hŒ20 ms”h]”hŒ20 ms”…”�”}”(hjÖhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h~hj˜hhhh+hKubhŒ.) to ensure reliable stream state transitions.”…”�”}”(hj˜hhhNhNubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h=hK>hj}hhhh+ubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h�hK<hj9hhhh+ubeh}”(h ]”h"]”h$]”h&]”h(]”uh*h˜hK8hjhhhh+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
