跳到主要内容

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。
  • 赋值与比较没有混淆。
  • 循环有上界,最坏执行时间在扫描预算内。
  • 有状态功能块实例每扫描只调用一次。
  • 状态通过监视、强制、趋势、日志和报警验证。不提供断点或单步。