ICT
GUI 手册 · Chapter 4

title: "Run Module" chapter: 4 source: "Doc/QMachineStudio UserManaul.pdf" images:

  • run-module.png
  • run-module-sequence.png

Run Module

Run Module 是真正驱动设备的脚本集中区。由变量、函数、时序、步骤四个构成要素组织。

Run Module 整体画面
Run Module 整体画面

构成

Variable(变量)

存放设备状态的全局变量:计数、标志、目标坐标等。

int    cycleCount = 0;
bool   initOk = false;
double lastTargetX = 0.0;

变量名在项目内唯一。改名后所有引用会自动更新。

Functions(函数)

在时序中复用的逻辑:硬件检查、通用错误处理、初始化流程等。

bool MoveToLoadPos(void) {
    Motor[X].MoveAbs(100.0, true);
    Motor[Y].MoveAbs(50.0, true);
    return Motor[X].CheckInPosition(100.0)
        && Motor[Y].CheckInPosition(50.0);
}

Sequence(时序)

设备主状态流。运行时各时序按顺序执行,任何时刻只有一个 Step 处于激活状态。

Sequence 编辑画面
Sequence 编辑画面

Step(步骤)

Sequence 内的细分步骤。NextStep("Name") 进入下一步,进入/结束时间会自动记录。

编辑流程

  1. 在 Variable 标签页声明全局变量
  2. 在 Functions 中编写通用函数
  3. 在 Sequence 中创建 Main 时序,逐 Step 描述动作
  4. F6 保存并构建 → F5 运行验证

要点

  • Sequence 保持短小。一个 Step ≈ 一次状态迁移,便于调试。
  • 重复逻辑务必抽入 Functions,避免时序重复。
  • 名称有意义:F12 跳转定义,Shift + F12 查找引用。