故障信息收集

当您的故障无法自行解决时，请参照本章节收集故障相关信息，然后联系梅卡曼德技术支持定位和解决故障。

故障相关信息

在处理故障时，提供准确和丰富的故障信息有助于提升故障定位效率，加快故障的解决。

故障现象

出现故障时，请准确地描述故障的现象和发生的条件，并提供告警或者异常窗口的截图。

软件的运行环境及其配置

出现故障时，还应提供出现故障时软件的运行环境及其配置：

  • 软件名称和版本：提供故障相关软件的名称及其版本。软件版本号可以通过选择 帮助 > 关于 获取。

  • 相机型号、编号、固件版本、安装方式：提供故障相关相机的型号、编号、固件版本以及安装方式。

  • 工控机规格：如果故障与工控机相关，提供工控机的硬件配置。

  • 工控机系统语言和区域设置：如果故障与工控机相关，提供工控机的系统版本。针对多语言显示相关的问题，提供工控机的当前系统语言和区域设置。

  • 软件语言：针对多语言显示相关的问题，提供软件的语言设置。

  • 工程：如果工程无法正常运行或者未达到预期效果，请提供可进行仿真运行的工程（包含工程数据和深度学习相关数据）。

日志

梅卡曼德软件系统针对软件运行和工程运行状态进行实时监控，并记录详细的运行日志。当软件出现故障时，请 收集软件运行日志 。

如果梅卡曼德视觉系统与机器人或周边设备通信出现问题，或者机器人未按照预期作业，除了软件运行日志外，您还需要收集机器人日志。

调试文件（.dmp）

调试文件即内存转储文件，用于存储软件崩溃、内存错误等问题，可以帮助了解故障发生的原因、找到合适的解决途径。

在如下情况下，梅卡曼德软件系统将产生调试文件：

  • 软件崩溃后闪退。

  • 软件捕获到异常后，用户点击 重试 。

在部分情况下（如严重的内存错误），软件无法捕获到异常，而系统可以捕获到异常，并生成调试文件。

此外，在软件卡死无法继续操作时，您可以手动创建转储文件。

关于如何收集调试文件，请参考 收集调试文件 章节。

收集故障信息

本节提供常见故障信息的收集方法。

收集软件运行日志

收集 Mech-Vision 日志

方法一：打开 Mech-Vision 软件，在 日志 区，单击 打开日志文件夹，找到出现故障当日的日志文件（后缀名为 .log）。

方法二：在文件资源管理器中，打开 Mech-Vision 软件安装目录下的 \logs 文件夹，找到出现故障当日的日志文件（后缀名为 .log）。

收集 Mech-Viz 日志

方法一：打开 Mech-Viz 软件，在 日志 功能面板，单击 打开日志文件夹，找到出现故障当日的日志文件（后缀名为 .log）。

方法二：在文件资源管理器中，打开 Mech-Viz 软件安装目录下的 \logs 文件夹，找到出现故障当日的日志文件（后缀名为 .log）。

收集 Mech-Center 日志

方法一：打开 Mech-Center 软件，在 日志 栏中，单击 打开文件夹，找到出现故障当日的日志文件（后缀名为 .html）。

方法二：在文件资源管理器中，打开 Mech-Center 软件安装目录下的 \logs 文件夹，找到出现故障当日的日志文件（后缀名为 .html）。

收集深度学习日志

当 Mech-Vision 使用后缀名为 .dlkpack 或 .dlkpackC 的深度学习模型包，并且单独启动 Mech-Vision 软件时，通过如下方法收集深度学习日志：

在文件资源管理器中，打开 Mech-Vision 软件安装目录下的 \dl_sdk_log 文件夹，找到出现故障当日的日志文件（后缀名为 .log）。

当 Mech-Vision 使用后缀名为 .dlkpack 或 .dlkpackC 的深度学习模型包，并且通过 Mech-Center 启动 Mech-Vision 软件时，通过如下方法收集深度学习日志：

在文件资源管理器中，打开 Mech-Center 软件安装目录下的 \src\dl_sdk_log 文件夹，找到出现故障当日的日志文件（后缀名为 .log）。

当 Mech-Vision 使用旧版本的深度学习模型包（后缀名为 pth 或 dlkmp）时，通过如下方法收集深度学习日志：

在文件资源管理器中，打开 Mech-Vision 软件安装目录下的 \resource\deeplearning_server\logs 文件夹，找到出现故障当日的日志文件（后缀名为 .log）。

收集调试文件（.dmp）

如果出现软件闪退问题，或软件弹出异常告警（Exception）并点击了 重试 按钮，可以通过如下方法收集 .dmp 文件：

在文件资源管理器中，打开 Mech-Vision/Mech-Viz/Mech-Center 软件安装目录，并查找后缀名为 .dmp 的调试文件，例如 mmind_vision_76f5af345b_202xxxxx_145339.dmp。

如果出现软件卡死（hang）问题，可以通过如下方法收集 .dmp 文件：

  1. 在工控机上，打开任务管理器，找到软件应用。

    注解

    Mech-Vision 的应用名称为 mmind_vision.exe；Mech-Viz 的应用名称为 mmind_viz.exe；Mech-Center 软件应用名称为 Python。

  2. 右键单击软件应用，然后从快捷菜单中单击 创建转储文件。

  3. 等待转储文件创建。

  4. 转储文件创建成功后，在弹出的转储进程对话框，点击 打开文件位置 按钮找到创建的 .dmp 文件。

如果软件出现异常，并且仅系统检测到异常，可以通过如下方法收集 .dmp 文件：

  1. 在工控机上，点击 开始 ，在搜索框中输入 “事件查看器”，然后选择它。

  2. 选择 Windows 日志 > 应用程序 ，在应用程序的事件列表中找到异常相关的事件并选中。

  3. 在下方的 常规 选项卡下，找到附件文件区域的 .dmp 文件路径。

收集机器人故障信息

当机器人与梅卡曼德视觉系统通信异常时，除了收集梅卡曼德软件系统的日志外，还应收集机器人侧的通信程序（或备份）以及日志。请参考机器人的操作手册收集上述信息。

当机器人未按照视觉结果或者规划路径进行移动或抓取，除了收集梅卡曼德软件系统的日志外，还应收集机器人侧的通信程序（或备份）、日志、程序错误位置截图、现场照片以及寄存器数据截图等。请参考机器人的操作手册收集上述信息。