GUI 手册 · Chapter 16

Run Module

Run Module 是承载驱动实际设备动作逻辑的模块。在 Solution Explorer 中展开 Run 模块后,由 Variable(模块变量)· Functions(各个函数)· Sequence(序列中的各个 Step)构成。代码并非一次性编辑整个文件,而是在树中添加函数、步骤节点后,只在编辑选项卡中编写所选节点的代码

构成要素

Variable(变量)

声明模块中使用的变量的节点。汇集计数、标志、目标坐标等设备状态值。打开 Variable 节点,按如下方式声明。

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

变量名在模块内必须唯一。改名后,该模块的函数、步骤中的引用也会一并管理。

Functions(函数)

承载可复用逻辑的各个函数节点的文件夹。硬件检查、通用错误处理、初始化流程等是典型示例。通过右键单击 FunctionsAdd Function 添加函数后,会生成一个函数节点并打开该函数的编辑选项卡。在打开的选项卡中编写该函数的代码。

xscript
// MoveToLoadPos 函数节点的内容示例
MOTOR["X"].MoveAbs(100.0, true);
MOTOR["Y"].MoveAbs(50.0, true);
return true;

Sequence(序列)

承载设备主状态流的文件夹。运行期间,序列的步骤按顺序执行,任何时刻只有一个步骤处于激活状态。通过右键单击 SequenceAdd Step 添加步骤。

Step(步骤)

Sequence 内的细分步骤节点。每个步骤负责一次状态迁移,选中某个步骤后,只编辑该步骤的代码。步骤节点可通过右键进行 Rename · Move Up/Down · Delete,因此可在树中直接重新排列动作顺序。

编辑流程

  1. 打开 Variable 节点,声明模块变量。
  2. 右键单击 FunctionsAdd Function 添加通用函数并编写代码。
  3. 右键单击 SequenceAdd Step 逐个添加步骤并描述动作。
  4. F6Save All & Make)保存并构建后,用 F5Run)运行运行时进行验证。

要点

  • 将一个步骤细分到大约"一次状态迁移"的程度,调试会更容易。
  • 将可复用的逻辑分离为函数,避免步骤重复。
  • 函数、步骤节点可在树中重命名、移动、删除,因此使用含义明确的名称便于把握结构和重新排列。

相关条目