OrbbecSDK_ROS2/zh/.doctrees/source/camera_devices/8_FAQ/FAQ.doctree

€•	lŒdocutils.nodes”Œdocument”“”)�”}”(Œ	rawsource”Œ”Œchildren”]”hŒsection”“”)�”}”(hhh]”(hŒtitle”“”)�”}”(hŒ常è§�问题”h]”hŒText”“”Œ常è§�问题”…”�”}”(Œparent”hŒ	_document”hŒsource”ŒZ/home/runner/work/OrbbecSDK_ROS2/OrbbecSDK_ROS2/docs/zh/source/camera_devices/8_FAQ/FAQ.md”Œline”KubaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”uŒtagname”hhK
hhhhubh
)�”}”(hhh]”(h)�”}”(hŒæ„�外崩溃”h]”hŒæ„�外崩溃”…”�”}”(hh-hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKhh*hhubhŒ	paragraph”“”)�”}”(hŒÑ如果相机节点æ„�外崩溃，它将在当å‰�è¿�行目录中生æˆ�崩溃日志：Log/camera_crash_stack_trace_xx.log。请将此日志å�‘é€�给支æŒ�团队或æ��交到GitHub issue以获得进一步帮助。”h]”(hŒT如果相机节点æ„�外崩溃，它将在当å‰�è¿�行目录中生æˆ�崩溃日志：”…”�”}”(hh<hhhhhKubhŒliteral”“”)�”}”(hŒ#Log/camera_crash_stack_trace_xx.log”h]”hŒ#Log/camera_crash_stack_trace_xx.log”…”�”}”hhFsbah}”(h!]”h#]”h%]”h']”uh)hDhh<hhhhhKubhŒZ。请将此日志å�‘é€�给支æŒ�团队或æ��交到GitHub issue以获得进一步帮助。”…”�”}”(hh<hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhh*hhhhubeh}”(h!]”Œid2”ah#]”h%]”Œæ„�外崩溃”ah']”uh)h	hKhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ多相机无数æ�®æµ�”h]”hŒ多相机无数æ�®æµ�”…”�”}”(hhfhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKhhchhubh;)�”}”(hŒ电æº�供应ä¸�足：”h]”(hŒstrong”“”)�”}”(hŒ电æº�供应ä¸�足”h]”hŒ电æº�供应ä¸�足”…”�”}”(hhyhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhhshhhhhKubhŒ：”…”�”}”(hhshhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK	hhchhhhubhŒbullet_list”“”)�”}”(hhh]”(hŒ	list_item”“”)�”}”(hhh]”h;)�”}”(hŒ0ç¡®ä¿�æ¯�个相机连接到å�•ç‹¬çš„集线器。”h]”hŒ0ç¡®ä¿�æ¯�个相机连接到å�•ç‹¬çš„集线器。”…”�”}”(hh™hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKhh–hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhh‘hhhhubh•)�”}”(hhh]”h;)�”}”(hŒ<使用有æº�集线器为æ¯�个相机æ��供足够的电力。”h]”hŒ<使用有æº�集线器为æ¯�个相机æ��供足够的电力。”…”�”}”(hh®hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKhh«hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhh‘hhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hKhhchhhhubh;)�”}”(hŒ高分辨率：”h]”(hx)�”}”(hŒ高分辨率”h]”hŒ高分辨率”…”�”}”(hhÉhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhhÅhhhhhKubhŒ：”…”�”}”(hhÅhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhhchhhhubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒ0å°�试é™�低分辨率以解决数æ�®æµ�问题。”h]”hŒ0å°�试é™�低分辨率以解决数æ�®æµ�问题。”…”�”}”(hhåhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKhhâhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhhßhhhhubah}”(h!]”h#]”h%]”h']”uh)h�hKhhchhhhubh;)�”}”(hŒ增加usbfs_memory_mb值：”h]”(hx)�”}”(hŒ增加usbfs_memory_mb值”h]”(hŒ增加usbfs”…”�”}”(hj
hhhhhKubhŒ
_”…”�”}”(hj
hhhhhKubhŒmemory”…”�”}”(hj
hhhhhKubhŒ
_”…”�”}”(hj
hhhhhKubhŒmb值”…”�”}”(hj
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)hwhhühhhhhKubhŒ：”…”�”}”(hhühhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhhchhhhubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒs通过è¿�行以下命令将 usbfs_memory_mb 值增加到128MB（这是å�‚考值，å�¯æ ¹æ�®ç³»ç»Ÿéœ€æ±‚调整）：”h]”(hŒ通过è¿�行以下命令将 ”…”�”}”(hj,
hhhhhKubhE)�”}”(hŒusbfs_memory_mb”h]”hŒusbfs_memory_mb”…”�”}”hj4
sbah}”(h!]”h#]”h%]”h']”uh)hDhj,
hhhhhKubhŒH 值增加到128MB（这是å�‚考值，å�¯æ ¹æ�®ç³»ç»Ÿéœ€æ±‚调整）：”…”�”}”(hj,
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhj)
hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhj&
hhhhubah}”(h!]”h#]”h%]”h']”uh)h�hKhhchhhhubhŒ
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”…”�”}”hjV
sbah}”(h!]”h#]”h%]”h']”Œ	xml:space”Œpreserve”uh)jT
hhchhhhhKubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒ3è¦�使此更改永久生效，请查看此链接。”h]”(hŒ'è¦�使此更改永久生效，请查看”…”�”}”(hjk
hhhhhKubhŒ	reference”“”)�”}”(hŒ	此链接”h]”hŒ	此链接”…”�”}”(hju
hhhhhKubah}”(h!]”h#]”h%]”h']”Œrefuri”Œ5https://github.com/OpenKinect/libfreenect2/issues/807”uh)js
hKhjk
hhhhubhŒ。”…”�”}”(hjk
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhjh
hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhje
hhhhubah}”(h!]”h#]”h%]”h']”uh)h�hKhhchhhhubeh}”(h!]”Œid3”ah#]”h%]”Œ多相机无数æ�®æµ�”ah']”uh)h	hKhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ如何采集和ä¿�存日志”h]”hŒ如何采集和ä¿�存日志”…”�”}”(hj¡
hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKhjž
hhubh;)�”}”(hŒ1. SDK debug 日志”h]”hx)�”}”(hŒ1. SDK debug 日志”h]”hŒ1. SDK debug 日志”…”�”}”(hj²
hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj®
hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKhjž
hhhhubh;)�”}”(hŒêå°† launch å�‚æ•° log_level 设为 debug è¿�è¡Œå�Žï¼Œä¼šåœ¨å½“å‰�工程目录下的 Log/ 文件夹中生æˆ� SDK 日志文件。如果需è¦�为本次测试指定一个更易识别的日志文件å��，å�¯ä»¥ä¿®æ”¹å�‚æ•° log_file_name。”h]”(hŒå°† launch å�‚æ•° ”…”�”}”(hjÄ
hhhhhKubhE)�”}”(hŒ	log_level”h]”hŒ	log_level”…”�”}”hjÌ
sbah}”(h!]”h#]”h%]”h']”uh)hDhjÄ
hhhhhKubhŒ 设为 ”…”�”}”(hjÄ
hhhhhKubhE)�”}”(hŒdebug”h]”hŒdebug”…”�”}”hjÝ
sbah}”(h!]”h#]”h%]”h']”uh)hDhjÄ
hhhhhKubhŒ, è¿�è¡Œå�Žï¼Œä¼šåœ¨å½“å‰�工程目录下的 ”…”�”}”(hjÄ
hhhhhKubhE)�”}”(hŒLog/”h]”hŒLog/”…”�”}”hjî
sbah}”(h!]”h#]”h%]”h']”uh)hDhjÄ
hhhhhKubhŒ‚ 文件夹中生æˆ� SDK 日志文件。如果需è¦�为本次测试指定一个更易识别的日志文件å��，å�¯ä»¥ä¿®æ”¹å�‚æ•° ”…”�”}”(hjÄ
hhhhhKubhE)�”}”(hŒ
log_file_name”h]”hŒ
log_file_name”…”�”}”hjÿ
sbah}”(h!]”h#]”h%]”h']”uh)hDhjÄ
hhhhhKubhŒ。”…”�”}”(hjÄ
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK hjž
hhhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒXSDK 日志是追加写入的：多次å�¯åŠ¨ä¼šåœ¨å�Œä¸€ä¸ªæ–‡ä»¶é‡Œä¸�断累积日志。”h]”hŒXSDK 日志是追加写入的：多次å�¯åŠ¨ä¼šåœ¨å�Œä¸€ä¸ªæ–‡ä»¶é‡Œä¸�断累积日志。”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK"hjhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK"hjhhhhubh•)�”}”(hhh]”h;)�”}”(hŒ®å»ºè®®ï¼šåœ¨å‡†å¤‡æ‰“包日志å�‘给技术支æŒ�å‰�，先删除旧的日志文件，然å�Žé‡�æ–°å¤�现问题并采集新的日志，这样日志更干净ã€�定ä½�更准确。”h]”hŒ®å»ºè®®ï¼šåœ¨å‡†å¤‡æ‰“包日志å�‘给技术支æŒ�å‰�，先删除旧的日志文件，然å�Žé‡�æ–°å¤�现问题并采集新的日志，这样日志更干净ã€�定ä½�更准确。”…”�”}”(hj0hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK#hj-hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK#hjhhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hK"hjž
hhhhubh;)�”}”(hŒ2. ROS2 日志（~/.ros/log）”h]”hx)�”}”(hŒ2. ROS2 日志（~/.ros/log）”h]”hŒ2. ROS2 日志（~/.ros/log）”…”�”}”(hjKhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjGhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK%hjž
hhhhubh;)�”}”(hŒ…在 launch 文件中，将节点（或å�¯ç»„å�ˆèŠ‚点容器）的 output å�‚数设为 "log"，å�³å�¯å°† ROS2 日志ä¿�存到本地：”h]”(hŒB在 launch 文件中，将节点（或å�¯ç»„å�ˆèŠ‚点容器）的 ”…”�”}”(hj]hhhhhKubhE)�”}”(hŒoutput”h]”hŒoutput”…”�”}”hjesbah}”(h!]”h#]”h%]”h']”uh)hDhj]hhhhhKubhŒ å�‚数设为 ”…”�”}”(hj]hhhhhKubhE)�”}”(hŒ"log"”h]”hŒ"log"”…”�”}”hjvsbah}”(h!]”h#]”h%]”h']”uh)hDhj]hhhhhKubhŒ*，å�³å�¯å°† ROS2 日志ä¿�存到本地：”…”�”}”(hj]hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK'hjž
hhhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒM设置为 output="log" å�Žï¼ŒROS2 日志将ä¿�存在 ~/.ros/log/ 目录下。”h]”(hŒ
设置为 ”…”�”}”(hj’hhhhhKubhE)�”}”(hŒoutput="log"”h]”hŒoutput="log"”…”�”}”hjšsbah}”(h!]”h#]”h%]”h']”uh)hDhj’hhhhhKubhŒ å�Žï¼ŒROS2 日志将ä¿�存在 ”…”�”}”(hj’hhhhhKubhE)�”}”(hŒ~/.ros/log/”h]”hŒ~/.ros/log/”…”�”}”hj«sbah}”(h!]”h#]”h%]”h']”uh)hDhj’hhhhhKubhŒ
 目录下。”…”�”}”(hj’hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK)hj�hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK)hjŒhhhhubh•)�”}”(hhh]”h;)�”}”(hŒ�如需æ��交问题，请å�Œæ—¶æ‰“包 Log/ 目录下的 SDK 日志和 ~/.ros/log/ 下对应时间的 ROS2 日志，一并æ��供。”h]”(hŒ%如需æ��交问题，请å�Œæ—¶æ‰“包 ”…”�”}”(hjÉhhhhhKubhE)�”}”(hŒLog/”h]”hŒLog/”…”�”}”hjÑsbah}”(h!]”h#]”h%]”h']”uh)hDhjÉhhhhhKubhŒ 目录下的 SDK 日志和 ”…”�”}”(hjÉhhhhhKubhE)�”}”(hŒ~/.ros/log/”h]”hŒ~/.ros/log/”…”�”}”hjâsbah}”(h!]”h#]”h%]”h']”uh)hDhjÉhhhhhKubhŒ1 下对应时间的 ROS2 日志，一并æ��供。”…”�”}”(hjÉhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK*hjÆhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK*hjŒhhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hK)hjž
hhhhubeh}”(h!]”Œid4”ah#]”h%]”Œ如何采集和ä¿�存日志”ah']”uh)h	hKhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ$为什么有这么多å�¯åŠ¨æ–‡ä»¶ï¼Ÿ”h]”hŒ$为什么有这么多å�¯åŠ¨æ–‡ä»¶ï¼Ÿ”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhK,hj	hhubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ?ä¸�å�Œçš„相机具有ä¸�å�Œçš„默认分辨率和图åƒ�æ ¼å¼�。”h]”hŒ?ä¸�å�Œçš„相机具有ä¸�å�Œçš„默认分辨率和图åƒ�æ ¼å¼�。”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK.hjhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK.hjhhhhubh•)�”}”(hhh]”h;)�”}”(hŒ<为简化使用，æ¯�个相机都有自己的å�¯åŠ¨æ–‡ä»¶ã€‚”h]”hŒ<为简化使用，æ¯�个相机都有自己的å�¯åŠ¨æ–‡ä»¶ã€‚”…”�”}”(hj4hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK/hj1hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK/hjhhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hK.hj	hhhhubeh}”(h!]”Œid5”ah#]”h%]”Œ$为什么有这么多å�¯åŠ¨æ–‡ä»¶ï¼Ÿ”ah']”uh)h	hK,hhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ3多相机连接时如何指定å�¯åŠ¨æŸ�一个相机”h]”hŒ3多相机连接时如何指定å�¯åŠ¨æŸ�一个相机”…”�”}”(hjUhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhK1hjRhhubh;)�”}”(hŒ�如果å�¯åŠ¨æ–‡ä»¶æœªæ˜¾å¼�指定è¦�使用的设备，在å�Œæ—¶è¿žæŽ¥å¤šå�°ç›¸æœºæ—¶ï¼Œé©±åŠ¨ä¼šé»˜è®¤è¿žæŽ¥åˆ°å…¶ä¸­ä¸€ä¸ªï¼ˆé»˜è®¤è®¾å¤‡ï¼‰ã€‚”h]”hŒ�如果å�¯åŠ¨æ–‡ä»¶æœªæ˜¾å¼�指定è¦�使用的设备，在å�Œæ—¶è¿žæŽ¥å¤šå�°ç›¸æœºæ—¶ï¼Œé©±åŠ¨ä¼šé»˜è®¤è¿žæŽ¥åˆ°å…¶ä¸­ä¸€ä¸ªï¼ˆé»˜è®¤è®¾å¤‡ï¼‰ã€‚”…”�”}”(hjbhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK3hjRhhhhubh;)�”}”(hŒ3å�¯ä»¥å…ˆé€šè¿‡ä»¥ä¸‹å‘½ä»¤æŸ¥çœ‹è®¾å¤‡åº�列å�·ï¼š”h]”hŒ3å�¯ä»¥å…ˆé€šè¿‡ä»¥ä¸‹å‘½ä»¤æŸ¥çœ‹è®¾å¤‡åº�列å�·ï¼š”…”�”}”(hjohhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK5hjRhhhhubjU
)�”}”(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”jc
jd
uh)jT
hjRhhhhhKubh;)�”}”(hŒ3然å�Žåœ¨å�¯åŠ¨æ—¶æ˜¾å¼�指定åº�列å�·ï¼Œä¾‹å¦‚：”h]”hŒ3然å�Žåœ¨å�¯åŠ¨æ—¶æ˜¾å¼�指定åº�列å�·ï¼Œä¾‹å¦‚：”…”�”}”(hj‹hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK;hjRhhhhubjU
)�”}”(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”jc
jd
uh)jT
hjRhhhhhKubeh}”(h!]”Œid6”ah#]”h%]”Œ3多相机连接时如何指定å�¯åŠ¨æŸ�一个相机”ah']”uh)h	hK1hhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ<多相机å�¯åŠ¨æˆ–切æ�¢æµ�时为什么需è¦�设置延迟？”h]”hŒ<多相机å�¯åŠ¨æˆ–切æ�¢æµ�时为什么需è¦�设置延迟？”…”�”}”(hj±hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKAhj®hhubh;)�”}”(hX
多相机系统对带宽和设备åˆ�始化时åº�è¦�求较高。如果在å�Œä¸€æ—¶é—´å�¯åŠ¨æˆ–切æ�¢å¤šä¸ªç›¸æœºæµ�，å�¯èƒ½ä¼šå¼•å�‘带宽瞬时拥塞，进而导致设备åˆ�始化失败ã€�æµ�å�¯åŠ¨å¼‚常或丢帧等问题。为确ä¿�系统稳定性，建议注æ„�以下几点：”h]”hX
多相机系统对带宽和设备åˆ�始化时åº�è¦�求较高。如果在å�Œä¸€æ—¶é—´å�¯åŠ¨æˆ–切æ�¢å¤šä¸ªç›¸æœºæµ�，å�¯èƒ½ä¼šå¼•å�‘带宽瞬时拥塞，进而导致设备åˆ�始化失败ã€�æµ�å�¯åŠ¨å¼‚常或丢帧等问题。为确ä¿�系统稳定性，建议注æ„�以下几点：”…”�”}”(hj¾hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKChj®hhhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”(h;)�”}”(hŒ多相机å�¯åŠ¨é˜¶æ®µ”h]”hx)�”}”(hŒ多相机å�¯åŠ¨é˜¶æ®µ”h]”hŒ多相机å�¯åŠ¨é˜¶æ®µ”…”�”}”(hjÕhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjÑhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKEhjÎhhhhubh;)�”}”(hŒŸåœ¨å�¯åŠ¨å¤šä¸ªç›¸æœºæ—¶ï¼Œå»ºè®®åœ¨æ¯�个相机å�¯åŠ¨ä¹‹é—´å¢žåŠ é€‚当的延迟（例如 2s），以é�¿å…�瞬时带宽过载或底层设备åˆ�始化冲çª�。”h]”(hŒ[在å�¯åŠ¨å¤šä¸ªç›¸æœºæ—¶ï¼Œå»ºè®®åœ¨æ¯�个相机å�¯åŠ¨ä¹‹é—´å¢žåŠ é€‚当的延迟（例如 ”…”�”}”(hjçhhhhhKubhx)�”}”(hŒ2s”h]”hŒ2s”…”�”}”(hjïhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjçhhhhhKubhŒB），以é�¿å…�瞬时带宽过载或底层设备åˆ�始化冲çª�。”…”�”}”(hjçhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKGhjÎhhhhubeh}”(h!]”h#]”h%]”h']”uh)h”hKEhjËhhhhubh•)�”}”(hhh]”(h;)�”}”(hŒæµ�开关与模å¼�切æ�¢é˜¶æ®µ”h]”hx)�”}”(hŒæµ�开关与模å¼�切æ�¢é˜¶æ®µ”h]”hŒæµ�开关与模å¼�切æ�¢é˜¶æ®µ”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj
hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKIhj
hhhhubh;)�”}”(hŒô在调用开关æµ�相关æœ�务（如 set_streams_enableã€�toggle_depthã€�toggle_color）时，ä¸�建议å�Œæ—¶è§¦å�‘多个接å�£è°ƒç”¨ï¼Œåº”在å�„æ“�作之间设置å�ˆç�†çš„时间间隔（例如 20 ms），以ä¿�è¯�æµ�状æ€�切æ�¢çš„å�¯é� æ€§ã€‚”h]”(hŒ%在调用开关æµ�相关æœ�务（如 ”…”�”}”(hj#hhhhhKubhE)�”}”(hŒset_streams_enable”h]”hŒset_streams_enable”…”�”}”hj+sbah}”(h!]”h#]”h%]”h']”uh)hDhj#hhhhhKubhŒã€�”…”�”}”(hj#hhhhhKubhE)�”}”(hŒtoggle_depth”h]”hŒtoggle_depth”…”�”}”hj<sbah}”(h!]”h#]”h%]”h']”uh)hDhj#hhhhhKubhŒã€�”…”�”}”(hj#hhhhhKubhE)�”}”(hŒtoggle_color”h]”hŒtoggle_color”…”�”}”hjMsbah}”(h!]”h#]”h%]”h']”uh)hDhj#hhhhhKubhŒm）时，ä¸�建议å�Œæ—¶è§¦å�‘多个接å�£è°ƒç”¨ï¼Œåº”在å�„æ“�作之间设置å�ˆç�†çš„时间间隔（例如 ”…”�”}”(hj#hhhhhKubhx)�”}”(hŒ20 ms”h]”hŒ20 ms”…”�”}”(hj^hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj#hhhhhKubhŒ-），以ä¿�è¯�æµ�状æ€�切æ�¢çš„å�¯é� æ€§ã€‚”…”�”}”(hj#hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKKhj
hhhhubeh}”(h!]”h#]”h%]”h']”uh)h”hKIhjËhhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hKEhj®hhhhubh;)�”}”(hŒ–é�µå¾ªä¸Šè¿°æ—¶åº�控制原则，有助于æ��å�‡å¤šç›¸æœºç³»ç»Ÿåœ¨å�¯åŠ¨å’Œè¿�行过程中的稳定性，å‡�少异常和ä¸�å�¯é¢„期行为的å�‘生。”h]”hŒ–é�µå¾ªä¸Šè¿°æ—¶åº�控制原则，有助于æ��å�‡å¤šç›¸æœºç³»ç»Ÿåœ¨å�¯åŠ¨å’Œè¿�行过程中的稳定性，å‡�少异常和ä¸�å�¯é¢„期行为的å�‘生。”…”�”}”(hj~hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKMhj®hhhhubeh}”(h!]”Œid7”ah#]”h%]”Œ<多相机å�¯åŠ¨æˆ–切æ�¢æµ�时为什么需è¦�设置延迟？”ah']”uh)h	hKAhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒfemto bolt 深度æµ�æ— æ•°æ�®”h]”hŒfemto bolt 深度æµ�æ— æ•°æ�®”…”�”}”(hj•hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKNhj’hhubh;)�”}”(hŒ¢è¯¥æ¨¡ç»„è¿�行时ä¾�èµ– OpenGL 库，若系统未安装或驱动ä¸�完整，将导致深度æµ�æ— æ•°æ�®ã€‚请先安装 OpenGL 相关库（以 Ubuntu 为例）：”h]”hŒ¢è¯¥æ¨¡ç»„è¿�行时ä¾�èµ– OpenGL 库，若系统未安装或驱动ä¸�完整，将导致深度æµ�æ— æ•°æ�®ã€‚请先安装 OpenGL 相关库（以 Ubuntu 为例）：”…”�”}”(hj¢hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKPhj’hhhhubjU
)�”}”(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”jc
jd
uh)jT
hj’hhhhhKubh;)�”}”(hŒ;安装å�Žå�¯é€šè¿‡ä»¥ä¸‹å‘½ä»¤æ£€æŸ¥ OpenGL 是å�¦å�¯ç”¨ï¼š”h]”hŒ;安装å�Žå�¯é€šè¿‡ä»¥ä¸‹å‘½ä»¤æ£€æŸ¥ OpenGL 是å�¦å�¯ç”¨ï¼š”…”�”}”(hj¾hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKVhj’hhhhubjU
)�”}”(hŒ  glxinfo -B”h]”hŒ  glxinfo -B”…”�”}”hjËsbah}”(h!]”h#]”h%]”h']”Œlanguage”Œbash”jc
jd
uh)jT
hj’hhhhhKubeh}”(h!]”Œ
femto-bolt”ah#]”h%]”Œfemto bolt 深度æµ�æ— æ•°æ�®”ah']”uh)h	hKNhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ图åƒ�未达到预设帧率”h]”hŒ图åƒ�未达到预设帧率”…”�”}”(hjähhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhK\hjáhhubh;)�”}”(hŒv首先需è¦�确认图åƒ�是å�¦ç¡®å®žæœªè¾¾åˆ°é¢„设帧率。在 ROS 2 中å�¯é€šè¿‡å¤šç§�æ–¹å¼�查看帧率，例如：”h]”hŒv首先需è¦�确认图åƒ�是å�¦ç¡®å®žæœªè¾¾åˆ°é¢„设帧率。在 ROS 2 中å�¯é€šè¿‡å¤šç§�æ–¹å¼�查看帧率，例如：”…”�”}”(hjñhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK^hjáhhhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ
ros2 topic hz”h]”hE)�”}”(hŒ
ros2 topic hz”h]”hŒ
ros2 topic hz”…”�”}”hjsbah}”(h!]”h#]”h%]”h']”uh)hDhjhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK`hj
hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK`hjþhhhhubh•)�”}”(hhh]”h;)�”}”(hŒrqt”h]”hE)�”}”(hŒrqt”h]”hŒrqt”…”�”}”hj&sbah}”(h!]”h#]”h%]”h']”uh)hDhj"hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKahjhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKahjþhhhhubh•)�”}”(hhh]”h;)�”}”(hŒ=自定义工具（如本 ROS 包æ��供的 benchmark 工具）”h]”(hŒ*自定义工具（如本 ROS 包æ��供的 ”…”�”}”(hj@hhhhhKubhE)�”}”(hŒ	benchmark”h]”hŒ	benchmark”…”�”}”hjHsbah}”(h!]”h#]”h%]”h']”uh)hDhj@hhhhhKubhŒ
 工具）”…”�”}”(hj@hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKbhj=hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKbhjþhhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hK`hjáhhhhubh;)�”}”(hŒÚ需è¦�注æ„�的是，ä¸�å�Œå·¥å…·çš„统计方å¼�å’Œ QoS é…�ç½®ä¸�å�Œï¼Œå› æ­¤å¾—到的帧率结果å�¯èƒ½å­˜åœ¨å·®å¼‚。当å�‘现帧率低于预期时，请优先排查是å�¦ä¸ºå¸§çŽ‡ç»Ÿè®¡å·¥å…·æœ¬èº«å¯¼è‡´çš„误差。”h]”hŒÚ需è¦�注æ„�的是，ä¸�å�Œå·¥å…·çš„统计方å¼�å’Œ QoS é…�ç½®ä¸�å�Œï¼Œå› æ­¤å¾—到的帧率结果å�¯èƒ½å­˜åœ¨å·®å¼‚。当å�‘现帧率低于预期时，请优先排查是å�¦ä¸ºå¸§çŽ‡ç»Ÿè®¡å·¥å…·æœ¬èº«å¯¼è‡´çš„误差。”…”�”}”(hjhhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKdhjáhhhhubh;)�”}”(hŒN若确认图åƒ�帧率确实未达到预设值，å�¯å°�试以下排查步骤：”h]”hŒN若确认图åƒ�帧率确实未达到预设值，å�¯å°�试以下排查步骤：”…”�”}”(hjuhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKfhjáhhhhubhŒenumerated_list”“”)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ[é™�低分辨率或帧率，判断是å�¦ç”±äºŽ USB / 网络带宽å�—é™�导致帧率下é™�ï¼›”h]”(hx)�”}”(hŒé™�低分辨率或帧率”h]”hŒé™�低分辨率或帧率”…”�”}”(hjŽhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjŠhhhhhKubhŒC，判断是å�¦ç”±äºŽ USB / 网络带宽å�—é™�导致帧率下é™�ï¼›”…”�”}”(hjŠhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhhj‡hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhhj„hhhhubh•)�”}”(hhh]”h;)�”}”(hŒk确认相机固件版本å�Š ROS 包版本是å�¦ä¸ºæœ€æ–°ï¼Œæ—§ç‰ˆæœ¬å�¯èƒ½å­˜åœ¨æ€§èƒ½æˆ–兼容性问题。”h]”(hx)�”}”(hŒ8确认相机固件版本å�Š ROS 包版本是å�¦ä¸ºæœ€æ–°”h]”hŒ8确认相机固件版本å�Š ROS 包版本是å�¦ä¸ºæœ€æ–°”…”�”}”(hj°hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj¬hhhhhKubhŒ3，旧版本å�¯èƒ½å­˜åœ¨æ€§èƒ½æˆ–兼容性问题。”…”�”}”(hj¬hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKihj©hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKihj„hhhhubeh}”(h!]”h#]”h%]”h']”uh)j‚hKhhjáhhhhubh;)�”}”(hŒ{若以上方法ä»�无法解决问题，请è�”系我å�¸ FAE，或在 GitHub Issue 中æ��交问题以获得进一步支æŒ�。”h]”(hŒ7若以上方法ä»�无法解决问题，请è�”系我å�¸ ”…”�”}”(hjÐhhhhhKubhx)�”}”(hŒFAE”h]”hŒFAE”…”�”}”(hjØhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjÐhhhhhKubhŒ
，或在 ”…”�”}”(hjÐhhhhhKubhx)�”}”(hŒGitHub Issue”h]”hŒGitHub Issue”…”�”}”(hjéhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjÐhhhhhKubhŒ+ 中æ��交问题以获得进一步支æŒ�。”…”�”}”(hjÐhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKkhjáhhhhubeh}”(h!]”Œid8”ah#]”h%]”Œ图åƒ�未达到预设帧率”ah']”uh)h	hK\hhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ软触å�‘模å¼�相关问题”h]”hŒ软触å�‘模å¼�相关问题”…”�”}”(hj	hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKnhjhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ¸ä¿¡å�·è§¦å�‘æ—¶å�„传感器未å�Œæ—¶å‡ºæµ�
请开å�¯å¸§æ±‡è�šåŠŸèƒ½ï¼Œå°†å�‚æ•°frame_aggregate_mode设置为full_frame，以ä¿�è¯�多传感器数æ�®åœ¨å�Œä¸€æ¬¡è§¦å�‘下å�Œæ­¥è¾“出。”h]”(hx)�”}”(hŒ*ä¿¡å�·è§¦å�‘æ—¶å�„传感器未å�Œæ—¶å‡ºæµ�”h]”hŒ*ä¿¡å�·è§¦å�‘æ—¶å�„传感器未å�Œæ—¶å‡ºæµ�”…”�”}”(hj hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjhhhhhKubhŒ

”…”�”}”(hjhhhhhKubhŒ$请开å�¯å¸§æ±‡è�šåŠŸèƒ½ï¼Œå°†å�‚æ•°”…”�”}”(hjhhhhhKubhE)�”}”(hŒframe_aggregate_mode”h]”hŒframe_aggregate_mode”…”�”}”hj5sbah}”(h!]”h#]”h%]”h']”uh)hDhjhhhhhKubhŒ	设置为”…”�”}”(hjhhhhhKubhE)�”}”(hŒ
full_frame”h]”hŒ