DB 访问
DB 访问用于在程序块、HMI 和外部服务之间交换结构化数据。日常编程优先使用 DB名称.字段,只有对接固定地址设备时才使用绝对地址。
DarraRT 当前公开产品只有 Windows 硬实时版。IDE 在工程师电脑,现场 Runtime 在工控机。端口全部固定,界面不可改。
程序读写
公开 SCL 使用 C# 风格语法。程序在扫描内读写当前扫描 epoch 的 DB 快照:
class Main : PlcProgram
{
void Execute()
{
double Target = DB_Process.Target;
double Feedback = DB_Process.Feedback;
if (DB_Process.Enable && !DB_Process.Fault)
{
DB_Process.Error = Target - Feedback;
}
}
}
数组和结构体按字段继续访问。写入前应检查范围、机器状态和权限,避免多个 OB 或 FB 同时写同一字段。
视觉作业不得在扫描内逐字段直写 DB、M、I、Q 或过程映像。输入 DB 按同一扫描 epoch 取不可变快照,输出只能在扫描边界整批提交。
绝对地址
DB 编辑器会为字段计算 DBX、DBB、DBW、DBD 或 DBL 地址。绝对地址适合协议映射,不适合在业务逻辑中到处硬编码。字段布局变化后,旧偏移可能指向其它数据。
通道分工
| 通道 | 端口 | 对 DB 的用途 |
|---|---|---|
| DarraLink | TCP 18821 | IDE 主会话:变量句柄读写、下装、热更新;一次写入和 Force / Unforce 唯一入口(IoLive RPC,统一进入 ForceSafetyGate) |
| DarraIPC | UDP 18850 | 高频监视样本(Value / Quality / Age / Epoch / ForceState)。不得发强制 |
| HMI Web | HTTP + WebSocket 18823 | HMI 页面绑定已授权的项目符号;写请求,不写最终输出 |
| OPC UA | TCP 4840 | 上层系统只读或按项目开放的变量;不是 MES 业务库 |
远程读写应使用当前 SDK 文档列出的公开接口,不要自造第二套地址协议。
在线修改
在线工具区分两种操作,都走 18821,不走 18850:
| 操作 | 行为 | 通道 |
|---|---|---|
| 写入一次 | 写入当前值,后续可被程序再次覆盖 | 18821 |
| 强制 | Runtime 持续覆盖,直到明确释放或按恢复策略清除 | 18821 ForceSafetyGate |
| 监视 | 只读当前值和 ForceState | 18850 |
强制需要工程师或更高角色,经 18821 nonce 校验,并记录操作者和原因。18850 上看到 ForceState 只说明该点是否处于强制,不能当作强制入口。
详见 强制与写入。
多程序块访问
同一 DB 可以被多个 OB、FB 或 FC 读取。为避免顺序依赖:
- 每个关键字段尽量只有一个写入者;
- 其它程序块只读取结果;
- 需要跨阶段更新时,用状态字段明确提交时机;
- 不要假设周期 OB 会抢占 OB1,当前调度为同线程排队。
保持数据
Retain 字段可在受控重启后恢复。它不保证跨任意项目下载或硬件损坏永久保存;重要工艺参数仍应有受控导出、版本管理和恢复校验。当前公开模型没有独立的 Persistent 语言合同。
排错
| 现象 | 检查项 |
|---|---|
| HMI 读不到字段 | 符号路径、外部读权限、18823 连接和 Runtime 状态 |
| HMI 无法写入 | 外部写权限、用户权限和类型范围;HMI 不能代替 18821 强制 |
| 地址值异常 | 字段类型、偏移和项目是否重新编译 |
| 值被程序立即改回 | 是否执行了一次写入而非强制;强制必须走 18821 |
| 强制被拒绝 | 角色、nonce、变量可写性;是否误走 18850 |
| 多处写入结果不稳定 | 收拢为单一写入者并核对 OB 顺序 |