变量与数据类型
变量保存 PLC 程序的输入、状态、参数和计算结果。使用变量表或程序块声明变量,并通过符号名访问;需要与现场 IO、HMI 或外部服务交换时,再配置地址和访问权限。
DarraRT 当前公开产品只有 Windows 硬实时版。项目文件唯一扩展为 .dplc。符号树从 DarraProject 实时派生,七根分组为 DB / Tag / UDT / Global / Code / System / Service。
常用类型
公开类型以 IEC 61131-3 基本类型和派生类型为准:
| 类别 | PLC 类型 | 常见用途 |
|---|---|---|
| 位组 | BOOL,BYTE / WORD / DWORD / LWORD | 开关、状态字、掩码 |
| 有符号整数 | SINT / INT / DINT / LINT | 计数、编号、原始量 |
| 无符号整数 | USINT / UINT / UDINT / ULINT | 计数器、编码器值 |
| 浮点 | REAL / LREAL | 温度、位置、速度、比例量 |
| 时间 | TIME / LTIME | 时长、定时 |
| 日期时间 | DATE、DATE_AND_TIME、TIME_OF_DAY | 时间戳 |
| 字符 | CHAR / WCHAR、STRING / WSTRING | 名称和诊断文字 |
| 派生 | ARRAY[...] OF、STRUCT、ENUM | 通道集合、设备状态、状态机 |
| 引用 | REF_TO <type> | 引用 |
| 指针 | POINTER TO <type> | 仅系统函数,不作为应用层常规写法 |
IEC 61499 的 FunctionBlock / Event / Adapter 属于 P4 骨架,未接入生产运行时,不要按已交付类型使用。
class Main : PlcProgram
{
bool Ready = false;
int PartCount = 0;
double Temperature = 25.0;
int[] SensorValues = new int[8];
void Execute()
{
if (Ready && Temperature < 80.0)
{
PartCount = PartCount + 1;
}
}
}
公开 SCL 使用 C# 风格的类型、字段和方法声明。文档和界面使用 SCL,不要写成 ST、脚本语言或高级语言。
作用域
| 位置 | 生命周期 | 用途 |
|---|---|---|
| 方法内局部变量 | 本次调用 | 临时计算 |
| FB 实例字段 | 实例生命周期 | 跨扫描保存的块状态 |
| 程序块输入/输出 | 调用接口 | 块之间传值 |
| 全局变量或标签 | 项目运行期间 | 多程序块共享 |
| DB 字段 | DB 生命周期 | 结构化共享数据和外部访问 |
| 常量 | 编译期固定 | 限值、模式码和固定参数 |
地址区域
当前项目地址模型使用四个区域:
| 区域 | 用途 | 默认访问方向 |
|---|---|---|
| I | 输入过程映像 | 用户程序读取 |
| Q | 输出过程映像 | 用户程序写入 |
| M | 标志和共享数据 | 读写;系统保留段可能只读 |
| DB | 命名数据块 | 按字段权限读写 |
常见地址形式包括 IX0.0、IW10、QX0.0、MW100 和 DB1.DBW4。地址由变量表、IO 映射或 DB 编辑器配置;不要在两个变量上分配重叠字节。
用户程序不能写 I 区。调试时模拟输入必须走 DarraLink 18821 的 Force,不能走 UDP 18850。
初始值与保持
普通变量在启动时使用项目初始值。需要断电恢复的变量可在项目模型中启用 Retain;运行时会在受控停机或重启路径保存并恢复这类值。
Retain 不是数据库、备份或安全存储:
- 非正常掉电可能发生最后一段数据未落盘;
- 项目结构变化后必须验证旧值能否安全迁移;
- IO 实时值和临时状态不应默认保持;
- 当前公开模型没有独立的
Persistent语言合同,不要写成比 Retain 更强的保证。
不要把 PLC 变量当业务数据库频繁写入。对接 MES / ERP 只经 OPC UA 4840 暴露过程数据,不在变量表里实现工单或物料追溯。
外部访问
| 通道 | 端口 | 用途 |
|---|---|---|
| DarraLink | TCP 18821 | IDE 句柄读写;一次写入和 Force / Unforce |
| DarraIPC | UDP 18850 | 监视样本(含 ForceState),不得强制 |
| HMI | 18823 | 操作员绑定已授权符号 |
| OPC UA | 4840 | 上层系统读过程数据 |
端口硬编码,界面不可改。可写权限应只开放给确需修改的参数;急停、安全门、限位等安全信号不能依赖普通变量权限作为唯一保护。
排错
| 现象 | 检查项 |
|---|---|
| 编译提示变量未声明 | 符号名、作用域和项目索引 |
| 在线值类型不正确 | PLC 类型与地址位宽是否一致 |
| 两个值互相覆盖 | 地址范围是否重叠 |
| 重启后值恢复异常 | Retain 是否启用、保存日志和项目结构是否变化 |
| HMI 无法写入 | DB/变量的外部写权限和用户权限 |
| 强制被拒绝 | 是否误走 18850;Force 必须经 18821 ForceSafetyGate |