GMOCCAPY 仿真使用说明

从首次启动提示、进入 AUTO、选择 G-code，到确认程序已加载。红色箭头表示需要点击的位置；本手册基于当前工作区的实际 GMOCCAPY 截图和源码分析。

快速流程

  1. 启动项目快捷方式：./run-gmoccapy.sh。
  2. 首次弹窗出现时，点击右侧 X；可选中“Don't show this again”。
  3. 确认机器上电并完成 homing，然后点击右侧第三个模式按钮进入 AUTO。
  4. 进入 AUTO 后，在 AUTO 按钮组中点击“打开文件”图标，选择 .ngc 文件。
  5. 点击文件选择页底部的绿色对勾确认，检查顶部文件路径和刀具轨迹。
  6. 加载不会自动运行；确认安全后再点击 Run，或使用 R 快捷键。

2. 进入 AUTO 模式

关键点：你要找的“加载程序”按钮不在当前 MANUAL/JOG 页面。它只有在切换到 AUTO 后，才会被放入 AUTO 专用按钮组。

关闭提示后的 GMOCCAPY 主界面
箭头指向右侧竖向模式按钮中的 AUTO 图标。若该按钮灰色，先处理“急停、上电、homing”状态。

具体点击顺序

  1. 先看右侧竖条。从上到下通常是急停、上电、AUTO、MDI 等图标。点击第三个“彩色小方块/机床箭头”图标，不要点击 MDI 计算器图标。
  2. 等待页面切换。右侧或底部按钮区域会从手动点动按钮切换为 AUTO 按钮组。窗口大小、主题和侧面板会改变图标的排列，但按钮的 tooltip 仍是 Load a new program。
  3. 再点打开文件按钮。在 AUTO 按钮组中寻找文件夹/打开文件图标。它的源码 ID 是 btn_load，不是文件选择页里的绿色对勾。
  4. 看到文件网格才算进入选择界面。点击 btn_load 后，GMOCCAPY 才会打开“选择 G-code 程序”界面；源码函数是 on_btn_load_clicked()，它把按钮页切换到文件选择页。
A
右侧第三个 AUTO 图标rbt_auto：先切换按钮组。
B
AUTO 页面中的打开文件图标btn_load，tooltip 为 Load a new program；点击它才打开文件选择界面。
C
文件网格和底部绿色对勾btn_select：选择文件后确认返回路径。

在 AUTO 页面里，具体就是这个打开文件图标

下图不是另一个入口，而是从 GMOCCAPY Glade 的 hbtb_auto 按钮组和当前 icon theme 放大的控件图。红框和箭头明确标出 btn_load；鼠标悬停时 tooltip 是 Load a new program。

如果你只看到右侧 AUTO 图标而没有这排按钮：你还没有完成 AUTO 页面切换，或者 AUTO 被急停/未上电/未 homing 状态门控。先点击上面的 AUTO 入口，等按钮组切换完成，再寻找红框位置。
不要把两个按钮混淆：btn_load 负责“打开文件选择界面”；文件界面底部的绿色对勾 btn_select 负责“确认当前选中的文件”。
当前仿真配置的共享 home switch 曾报告 Cannot home while shared home switch is closed j=2。这会让 AUTO 保持门控；它是仿真 HAL 状态问题，不是加载按钮消失。

3. 选择 G-code 程序

只有完成上一节的 AUTO → 打开文件图标 两次点击后，才会出现下面这个文件界面。进入文件页后，GMOCCAPY 会按配置中的 PROGRAM_PREFIX = ../../nc_files/ 显示程序。当前配置解析到：

/home/mes006/linuxcncWebWASM/linuxcnc/nc_files/
GMOCCAPY 文件选择页
示例中可以看到 3dtest.ngc。底部右侧绿色对勾用于返回选中的路径；黄色弯箭头用于返回上一页。文件网格不会在 MANUAL/JOG 页面直接出现。

界面出现后的点击顺序

  1. 在文件网格中单击目标文件，例如 3dtest.ngc；选中项会出现高亮。
  2. 点击底部右侧绿色对勾（btn_select）。它会返回文件路径并关闭文件选择页。
  3. 回到主界面后，顶部标题应显示完整路径，预览区应显示刀具轨迹。

4. 确认程序已经加载

加载成功后，顶部标题不再是 No Program loaded，而会显示完整文件路径；左侧预览区会出现刀具轨迹。加载本身不会启动运动。

3dtest.ngc 已加载并显示刀具轨迹
本次测试加载的文件是 3dtest.ngc；LinuxCNC 状态接口返回该路径，解释器保持空闲。

常见问题

看不到加载按钮按“关闭首次提示 → 右侧第三个 AUTO 图标 → AUTO 按钮组中的打开文件图标”顺序操作。文件网格本身不是入口，它是点击 btn_load 之后才出现的。
AUTO 图标是灰色检查急停复位、机器上电和 homing。GMOCCAPY 会在状态不满足时禁用模式切换。
加载后没有运动这是正常的。加载只生成程序和预览；要执行必须点击 Run 或按 R。
启动日志提示 POSIX non-realtime当前环境没有实时内核。可用于仿真界面和加载检查，但不能作为实时硬件性能证明。

源码、配置与证据

项目位置用途
AUTO 入口rbt_auto / on_rbt_auto_pressed右侧第三个模式按钮；先进入 AUTO，加载按钮才可见。
AUTO 按钮组hbtb_autoGMOCCAPY Glade 中承载打开、重载、运行、停止、暂停和单步按钮。
加载按钮gmoccapy.py:5046、btn_load切换到文件选择页。
文件确认gmoccapy.py:5116、btn_select将选中的文件交给 hal_action_open.load_file(path)。
程序目录configs/sim/gmoccapy/gmoccapy.iniPROGRAM_PREFIX = ../../nc_files/。
逐文件分析gmoccapy-file-inventory.md1,233 个配置、实现、资源、图标、翻译和文档文件的哈希清单。
完整分析gmoccapy-analysis.md本次提示、界面、加载测试和限制的详细记录。

本页是静态 HTML，不依赖网络。复制整个 doc-g 目录后，直接用浏览器打开本文件即可。

GMOCCAPY 仿真使用说明 · 证据和后续文档统一保存在 ./doc-g