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(函数)
承载可复用逻辑的各个函数节点的文件夹。硬件检查、通用错误处理、初始化流程等是典型示例。通过右键单击 Functions → Add Function 添加函数后,会生成一个函数节点并打开该函数的编辑选项卡。在打开的选项卡中编写该函数的代码。
xscript
// MoveToLoadPos 函数节点的内容示例
MOTOR["X"].MoveAbs(100.0, true);
MOTOR["Y"].MoveAbs(50.0, true);
return true;Sequence(序列)
承载设备主状态流的文件夹。运行期间,序列的步骤按顺序执行,任何时刻只有一个步骤处于激活状态。通过右键单击 Sequence → Add Step 添加步骤。
Step(步骤)
Sequence 内的细分步骤节点。每个步骤负责一次状态迁移,选中某个步骤后,只编辑该步骤的代码。步骤节点可通过右键进行 Rename · Move Up/Down · Delete,因此可在树中直接重新排列动作顺序。
编辑流程
- 打开
Variable节点,声明模块变量。 - 右键单击
Functions→Add Function添加通用函数并编写代码。 - 右键单击
Sequence→Add Step逐个添加步骤并描述动作。 - 用
F6(Save All & Make)保存并构建后,用F5(Run)运行运行时进行验证。
要点
- 将一个步骤细分到大约"一次状态迁移"的程度,调试会更容易。
- 将可复用的逻辑分离为函数,避免步骤重复。
- 函数、步骤节点可在树中重命名、移动、删除,因此使用含义明确的名称便于把握结构和重新排列。