SCL 核心教程
SCL 是 Darra PLC 的规范文本编程语言,仓内源码使用 C# 风格写法;需要编写计算、状态判断、状态机或有界循环时使用。本页汇总日常编程最常用的语法。
编辑器基于 Monaco Editor。编译结果是 169 操作码 bytecode,由 PLC VM 在扫描循环中执行。不提供断点或单步;状态通过监视、强制、趋势、日志和报警验证。
基本写法
// 声明变量
bool startButton = false;
bool stopButton = false;
bool motorRun = false;
int cycleCount = 0;
string stateText = "Stopped";
// 停止优先
if (stopButton)
{
motorRun = false;
stateText = "Stopped";
}
else if (startButton)
{
motorRun = true;
stateText = "Running";
}
cycleCount = cycleCount + 1;
核心规则:
- 类型写在变量名前面。
=是赋值,==是相等比较。- 语句以
;结束。 - 条件与循环体使用
{ }。 - 布尔运算使用
&&、||、!。 - 行注释使用
//。 - 关键字和变量名区分大小写。
扫描周期
PLC 周期性执行“读取输入、运行程序、刷新输出”。扫描周期可配置为 1 ms、2 ms、5 ms 或 10 ms,默认 5 ms,实际值由项目配置决定。程序不应在一次扫描中等待外部事件,也不应使用长循环制造延时。超扫描预算会触发看门狗并进入安全态(Q 区清零、日志、报警)。
// 每次扫描只执行一次判断
bool sensorReady = true;
bool guardClosed = true;
bool permit = false;
bool motorRun = false;
permit = sensorReady && guardClosed;
if (!permit)
{
motorRun = false;
}
安全边界
软件条件不能替代急停、安全门、安全继电器或驱动 STO。危险输出必须先完成硬件安全回路和现场风险评估。
常用数据类型
| 类型 | 类别 | 访问 | 用途 | 示例值 |
|---|---|---|---|---|
bool | 布尔 | 读写 | 开关、允许、报警 | true、false |
int | 有符号整数 | 读写 | 小范围整数、模式、计数 | 0、100、-1 |
string | 字符串 | 读写 | 状态文本、设备代码 | "Ready" |
当前 int 声明映射到 16 位有符号整数,范围为 -32768 到 32767。较大计数应选择数据类型页列出的更宽整数类型。
运算符
int total = 10;
int count = 3;
int quotient = total / count; // 整数结果为 3
int remainder = total % count; // 余数为 1
bool stopButton = false;
bool inRange = count >= 0 && count <= 10;
bool alarm = !inRange || stopButton;
常用运算符:
| 运算符 | 类别 | 访问 | 说明 |
|---|---|---|---|
+ - * / % | 算术 | 求值 | 整数除法向零截断 |
== != < <= > >= | 比较 | 求值 | 结果为 bool |
&& || ! | 逻辑 | 求值 | 两侧都会求值 |
= += -= *= /= %= | 赋值 | 写入 | 左侧必须可写 |
&& 和 || 的两侧都会求值。右侧含调用或状态修改时,应改写成嵌套 if,不要依赖普通 C# 的短路行为。
条件判断
int level = 50;
string levelState = "Normal";
if (level < 20)
{
levelState = "Low";
}
else if (level > 80)
{
levelState = "High";
}
else
{
levelState = "Normal";
}
多分支可使用 switch:
int mode = 1;
string modeText = "Unknown";
switch (mode)
{
case 0:
modeText = "Stopped";
break;
case 1:
modeText = "Automatic";
break;
case 2:
modeText = "Manual";
break;
default:
modeText = "Unknown";
break;
}
有界循环
int sum = 0;
for (int i = 1; i <= 10; i++)
{
sum = sum + i;
}
循环必须有明确上界或退出条件。for (;;) 会被拒绝;长时间等待应交给定时功能块并跨扫描完成。
方法
方法用于复用无状态计算。当前稳定写法是把返回值汇合到方法末尾。
class LimitTools
{
public int Clamp(int value, int low, int high)
{
int result = value;
if (value < low)
{
result = low;
}
else if (value > high)
{
result = high;
}
return result;
}
}
LimitTools tools = new LimitTools();
int safeSpeed = tools.Clamp(120, 0, 100);
有状态功能块
有状态逻辑需要稳定实例,并在固定位置每个扫描周期调用一次。C# 风格调用以表达式结果取得主输出。
TON startDelay = new TON();
bool startCommand = false;
bool startReady = false;
// PT 使用毫秒
startReady = startDelay(IN: startCommand, PT: 2000);
当前基础功能块包括定时器、计数器、边沿检测和置位/复位块。完整参数见函数与功能块。
编译前检查
- 每条语句都有分号。
- 每个条件都明确产生
bool。 - 赋值与比较没有混淆。
- 循环有上界,最坏执行时间在扫描预算内。
- 有状态功能块实例每扫描只调用一次。
- 状态通过监视、强制、趋势、日志和报警验证。不提供断点或单步。