跳到主要内容

SCL 快速入门

SCL(Structured Control Language)是 Darra PLC 的规范文本编程语言,仓内源码使用 C# 风格写法。需要编写计算、条件判断、状态机或有界循环时使用。本页适合第一次打开 SCL 编辑器时快速了解写法。

编辑器基于 Monaco Editor,提供语法高亮、代码补全、语法检查和符号导航。编译路径为 SCL 源码 → 中间表示 (IR) → 169 操作码 bytecode,由现场 Service 内的 PLC VM 执行。不提供断点或单步;调试使用监视、强制、趋势、日志和报警。

第一个程序​

// 停止优先的电机启停逻辑
bool startButton = false;
bool stopButton = false;
bool motorRun = false;

if (stopButton)
{
motorRun = false;
}
else if (startButton)
{
motorRun = true;
}

代码要点:

  • 变量先写类型,再写名称。
  • = 用于赋值,== 用于比较。
  • 条件和循环体使用 { }。
  • 每条声明、赋值和调用以 ; 结束。
  • 布尔运算使用 &&、||、!。
  • 注释以 // 开头。

扫描周期​

PLC 周期性执行“读取输入、运行程序、刷新输出”。扫描周期可配置为 1 ms、2 ms、5 ms 或 10 ms,默认 5 ms;实际周期由项目配置决定。变量的本周期输入值来自扫描开始时的输入快照,输出在程序执行完成后刷新。

// 每次扫描更新一次状态
int scanCount = 0;
bool enabled = true;
string stateText = "Stopped";

if (enabled)
{
scanCount = scanCount + 1;
stateText = "Running";
}
else
{
stateText = "Stopped";
}
循环必须有界

不要用长循环等待时间。循环超出扫描预算会触发看门狗,PLC 随后进入安全态:Q 区清零、写日志并报警。延时逻辑应使用定时功能块。

当前编辑方式​

Darra IDE 当前只提供两种 PLC 逻辑编辑器:

语言类别访问适用
SCL文本编辑器读写源码计算、状态判断、有界循环和封装逻辑
LAD图形编辑器读写图形触点、线圈、启停和互锁逻辑

LAD 可转为 SCL 文本,SCL 可转为 LAD 图形(子集)。其它 PLC 逻辑编辑器不在当前交付范围内。

学习顺序​

  1. 基本语法
  2. 数据类型
  3. 变量与作用域
  4. 运算符
  5. 判断与循环
  6. 函数与功能块