上位机Qnbot Studio

日志与标定文件

配置 Debug 记录、管理历史日志,并维护标定文件。

最新文档

日志与标定文件

Debug 参数与日志

Debug 用于定位设备串口、手套数据、标定、动作重定向、算法输出和缓冲区问题。建议只在需要复现问题时开启,并在结束后恢复常规配置。

图 8-1 Debug 参数配置

记录模块

模块标识建议用途
串口serial设备发现、断连、串口收发异常
手套glove解析后的手套数据、输入稳定性
标定calibration标定步骤、标定结果与复现
重定向retargeting手部动作到目标模型的映射过程
输出output算法结果、模型驱动输出
缓冲区buffer积压、延迟、吞吐和数据节奏问题

级别与采样间隔

  • Summary:适合日常排查,信息量与文件体积相对平衡。
  • Full:记录更完整的上下文,用于难复现或多模块关联问题。
  • Raw:保留原始级数据,文件增长最快,仅在技术支持明确要求时使用。
  • 采样间隔:参数配置页示例单位为 ms。数值越小记录越密;具体语义与有效范围以交付版本为准。
  1. 勾选与问题相关的模块,避免无目的全部开启。
  2. 选择 Summary / Full / Raw,并设置采样间隔。
  3. 确认保存目录,必要时点击“选择”更改位置。
  4. 点击“确认”保存配置,再复现问题。
  5. 复现结束后停止任务并关闭高明细 Debug。

图 8-2 Debug 历史文件列表

历史文件管理

  • 列表包含文件名称、创建时间、文件大小和操作。
  • 点击“下载”导出诊断文件;提交技术支持时同时说明问题时间、设备 SN、左右手、模型名称与复现步骤。
  • 点击“删除”前确认文件已备份且不再用于问题分析。
  • 使用分页控件浏览较早记录;定期清理可避免磁盘空间持续下降。

数据保护:日志可能包含设备序列号、账号环境、原始传感数据或路径信息。只向获得授权的人员传输,并遵守项目的数据保留要求。

标定文件管理

图 9-1 标定文件列表

列表字段

  • 设备名称:标定所对应的手套型号。
  • SN:唯一识别设备,应与当前连接设备一致。
  • 左右手:标定数据所属手侧。
  • 标定时间:用于判断记录是否为最新。
  • 操作:重新标定、删除标定。

重新标定

  1. 定位与当前设备 SN 和手侧一致的记录。
  2. 点击“重新标定”。如已有相同手势数据,系统会提示覆盖。
  3. 确认当前任务已停止,确需覆盖时点击“确认覆盖”。
  4. 重新完成 8 步向导,并在仿真页验证结果。

不可撤销操作:系统明确提示:重新录制将彻底覆盖原有手势数据,且操作无法撤销。若项目要求保留历史,请先按交付机制备份或导出。

删除标定

删除后,该设备和手侧可能无法获得正确的动作映射,必须重新标定才能恢复。删除前应再次核对设备 SN 与左右手,避免误删其他操作员或其他设备的记录。