Femto Bolt 故障排除
本文内容
● 已知问题
● 网络日志
● 设备未列在设备治理器中
● k4aviewer无法打开相机
● 设备固件更新问题
● 图像质量问题
● 不一致或意表的功夫戳
● 将人体跟踪 SDK 与 Unreal 共同使用
● 在无表设 Linux 系统上使用 Femto Bolt
本文蕴含在 Femto Bolt 中使用 Orbbec SDK K4A Wrapper 时可能会遇到的已知问题及其故障排除提醒。。。。。 。 。
已知问题
● Linux平台下，，，，，，，，深度引擎库必要使用OpenGL，，，，，，，，若是利用层也使用OpenGL、且跨线程挪用OpenGL事俘，，，，，，，，可能会造成高低文矛盾，，，，，，，，导致深度引擎在初始化时出现问题，，，，，，，，以及无法正常启动深度数据流。。。。。 。 。
若是利用层使用了OpenGL渲染，，，，，，，，要在利用层参考OpenGL下面链接切换Context：
(https://www.khronos.org/opengl/wiki/OpenGL_and_multithreading)
以下是我们使用glfw库的解决步骤：
a. 在开流之前，，，，，，，，挪用glfwMakeContextCurrent(NULL) 。。。。。 。 。
b. 而后再开流。。。。。 。 。
c. 开流实现后，，，，，，，，挪用glfwMakeContextCurrent(currentContext)。。。。。 。 。
// 参考github： file: tools/k4aviewer/k4adevicedockcontrol.cpp GLFWwindow *currentContext = glfwGetCurrentContext(); // store the current context glfwMakeContextCurrent(NULL); // make current context to NULL StartCameras(); // will initialize the DepthEngine glfwMakeContextCurrent(currentContext); // restore the current context
● 有关其他有关问题，，，，，，，，请查看 GitHub Issues
网络日志
Orbbec SDK K4A Wrapper 的日志由底层 Orbbec SDK 输出，，，，，，，，默认输出到利用法式工作目录下的 目录下。。。。。 。 。日志以循环覆盖的方式输出到固定 4 个文件中，，，，，，，，默认单个文件最大 100 MB。。。。。 。 。建议用户反馈问题时能够将日志文件一并打包发送。。。。。 。 。
设备未列在设备治理器中
● 请查看后面批示灯，，，，，，，，若是闪橙黄色，，，，，，，，暗示供电不及，，，，，，，，请用电源适配器供电再试，，，，，，，，若是此时闪白灯，，，，，，，，暗示USB衔接异常，，，，，，，，请找其他原因。。。。。 。 。
● 查抄是否已衔接电源线并使用 USB3 端口来传输数据。。。。。 。 。
● 尝试改用 USB3 端口来成立数据衔接（建议使用靠近主板的 USB 端口，，，，，，，，例如，，，，，，，，电脑背面的 USB 端口）。。。。。 。 。
● 查抄线缆的状态，，，，，，，，受损或劣质的线缆会导致列出的信息不成靠（设备在设备治理器中不休“闪动”）。。。。。 。 。
● 若是已衔接到笔记本电脑并且该电脑以电池运行，，，，，，，，则端口的电量可能会受到限度。。。。。 。 。
● 沉新启动主机电脑。。。。。 。 。
● 若是问题依然存在，，，，，，，，则可能是存在兼容性问题。。。。。 。 。
k4aviewer 无法打开相机
● 先查抄设备是否列在 Windows 设备治理器钟祝。。。。 。 。
● 查抄是否有任何其他利用法式在使用该设备（例如 Windows 相机利用法式）。。。。。 。 。 每次只能有一个利用法式接见该设备。。。。。 。 。
● 查抄日志中的谬误新闻。。。。。 。 。
● 打开 Windows 相机利用法式，，，，，，，，查抄它是否可正常工作。。。。。 。 。
● 关关再打开设备的电源，，，，，，，，期待流 LED 熄灭，，，，，，，，而后再使用设备。。。。。 。 。
● 沉新启动主机电脑。。。。。 。 。
● 确保在电脑上使用最新的图形驱动法式。。。。。 。 。
● 若是你使用自己的 SDK 版本，，，，，，，，请尝试使用正式颁布的版本（若是能够解决问题）。。。。。 。 。
设备固件更新问题
● 若是更新后未汇报正确的版本号，，，，，，，，则可能必要关关再打开设备；；；；；
● 设备固件更新过程被打断，，，，，，，，能够沉新给设备上电后再执行更新。。。。。 。 。
图像质量问题
● 启动 Femto Bolt 查看器，，，，，，，，查抄设备的地位，，，，，，，，以确定是否存在滋扰、传感器被遮挡，，，，，，，，或者镜头脏污。。。。。 。 。
● 若是问题在特定的模式下产生，，，，，，，，请尝试分歧的运行模式，，，，，，，，以缩幼问题的查抄领域。。。。。 。 。
● 若要与团队共同解决图像质量问题，，，，，，，，能够：
1. 抓取Femto Bolt 查看器的暂停视图并抓取屏幕截图，，，，，，，，或
2. 使用Femto Bolt 查看器录造，，，，，，，，例如 k4arecorder.exe -l 5 -r 5 output.mkv
不一致或意表的设备功夫戳
挪用 k4a_device_set_color_control 可能会临时引发设备的计时更改，，，，，，，，这些更改可能必要几个捕获能力不变。。。。。 。 。 预防在图像捕获循环中挪用 API，，，，，，，，以免沉置每个新图像的内部计时推算。。。。。 。 。 能够改为在启动相机之前或必要更改图像捕获循环内的值时挪用 API。。。。。 。 。 具体而言，，，，，，，，请预防挪用 k4a_device_set_color_control(K4A_COLOR_CONTROL_AUTO_EXPOSURE_PRIORITY)。。。。。 。 。
将人体跟踪 SDK 与 Unreal 共同使用
若要将人体跟踪 SDK 与 Unreal 共同使用，，，，，，，，请确保已将 <SDK Installation Path>\tools 增长到环境变量 PATH，，，，，，，，并已将 dnn_model_2_0.onnx 和 cudnn64_7.dll 复造到 Program Files/Epic Games/UE_4.23/Engine/Binaries/Win64。。。。。 。 。
在无表设 Linux 系统上使用 Femto Bolt
Linux 上的 Femto Bolt 深度引擎使用 OpenGL。。。。。 。 。 OpenGL 必要一个窗口事俘，，，，，，，，该事俘必要将监督器衔接到系统。。。。。 。 。 此问题的解决步骤是：
1. 为打算使用的用户帐户启用自动登录。。。。。 。 。 有关若何启用自动登录的注明，，，，，，，，请参阅此文。。。。。 。 。
2. 关关系统电源，，，，，，，，断开显示器的衔接，，，，，，，，而后打开系统电源。。。。。 。 。 自动登录会强造创建 x-server 会话。。。。。 。 。
3. 通过 ssh 进行衔接，，，，，，，，并设置 DISPLAY 环境变量 export DISPLAY=:0
4. 启动 Femto Bolt 利用法式。。。。。 。 。
xtrlock 实用工具可用于在自动登录后立即锁定屏幕。。。。。 。 。 增长以下号令以启动利用法式或 systemd 服务：
bash -c “xtrlock -b”