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 逻辑编辑器不在当前交付范围内。