跳到主要内容

结构化文本(ST)开发

创建ST文件​

在创建文件时，选择ST，然后输入ST文件名，将新建一个ST文件。用户可以从编辑区编码ST源程序。

创建ST文件
图1 - 创建ST文件

声明变量​

在ST编辑器中，您需要使用IEC61131-3标准语法来声明变量。

在变量声明区添加变量​

变量声明区添加变量
图2 - 变量声明区添加变量

修改变量类型​

修改类型
图3 - 修改变量类型

修改数据类型​

修改数据类型
图4 - 修改数据类型

打开类型选择器​

打开类型选择器
图5 - 打开类型选择器

选择数据类型​

选择数据类型
图6 - 选择数据类型

设置数组​

数组设置
图7 - 数组设置
提示

IDE不提供单独的ST程序变量的图形编辑操作，用户需要使用IEC61131-3中ST的标准语法来定义变量，具体编程参考《WasomeCodeX_AI编程指南》

程序控制结构​

(* IF语句 *)
IF condition THEN
    (* 执行语句 *)
ELSIF anotherCondition THEN
    (* 执行语句 *)
ELSE
    (* 执行语句 *)
END_IF

(* FOR循环 *)
FOR i := 0 TO 10 DO
    (* 循环体 *)
END_FOR

全ST语言基础语法​

变量声明示例​

PROGRAM MainProgram
    VAR
        (* 布尔型变量 *)
        bFlag: BOOL := TRUE;
        
        (* 整型变量 *)
        nCounter: INT := 0;
        
        (* 实型变量 *)
        rValue: REAL := 3.14;
        
        (* 数组变量 *)
        arrData: ARRAY[0..9] OF INT;
    END_VAR
    
    (* 程序逻辑 *)
    nCounter := nCounter + 1;
END_PROGRAM

在全 ST 文件中定义 CLASS​

编译器支持在“全ST文件”中使用 CLASS 定义类，并支持成员变量、方法、访问控制、继承、方法重写、类实例和类指针等语法。

CLASS cCounter
    VAR PUBLIC
        Value : DINT;
    END_VAR

    METHOD PUBLIC Add : DINT
        Value := Value + 1;
        Add := Value;
    END_METHOD
END_CLASS

CLASS 类必须写在全 ST 文件中。保存代码后重新编译项目，编译器会统一解析同一工程内多个全 ST 文件中的类定义和引用。

详细语法请参见 CLASS 类语法。

结构化视图与文本文件互转​

WasomeCodeX_AI 支持在结构化工程对象和文本文件之间进行转换，便于批量编辑、版本管理和跨项目复用。转换包含两个方向：

  • 结构化文本转文本：将项目树中的结构化对象导出为文本文件。
  • 文本转结构化文本：将文本文件解析并导入为项目树中的结构化对象。
结构化视图与文本文件互转

当前支持转换的对象包括：

对象类型说明
全局变量组支持将全局变量组转换为文本文件，也支持从文本文件恢复为全局变量组。
任务支持任务配置的文本化导出和导入。
数据类型支持自定义数据类型的文本化导出和导入。
ST 语言 POU支持 程序组织单元（POU） 下的 ST 语言 POU 与文本文件互转。

结构化文本转文本​

在项目树中选择支持转换的对象，执行 结构化文本转文本 操作后，IDE 会在 全ST文件 节点下生成对应的 .st 文本文件。生成的文本文件可直接打开查看和编辑，也可用于版本管理或在其他项目中复用。

常见使用场景：

  • 将全局变量组、任务、数据类型或 ST POU 统一导出为文本。
  • 对导出的 .st 文件进行集中查看、复制或归档。
  • 将结构化配置纳入外部版本管理流程。

文本转结构化文本​

在 全ST文件 节点下选择已有 .st 文本文件，执行 文本转结构化文本 操作后，IDE 会解析文本内容，并在项目树中生成或更新对应的结构化对象。

使用时请注意：

  • 文本内容需要符合 IDE 支持的 ST/IEC 61131-3 语法和对象定义格式。
  • 导入前建议确认对象名称，避免与现有全局变量组、任务、数据类型或 POU 发生冲突。
  • 转换完成后请重新编译项目，确认变量、任务、数据类型和 POU 调用关系正确。
提示

目前该互转功能仅支持 全局变量组、任务、数据类型、以及 程序组织单元（POU）下的 ST 语言 POU。其他语言类型的 POU 或其他项目节点暂不支持该转换。