跳到主要内容

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 的用途
DarraLinkTCP 18821IDE 主会话:变量句柄读写、下装、热更新;一次写入和 Force / Unforce 唯一入口(IoLive RPC,统一进入 ForceSafetyGate)
DarraIPCUDP 18850高频监视样本(Value / Quality / Age / Epoch / ForceState)。不得发强制
HMI WebHTTP + WebSocket 18823HMI 页面绑定已授权的项目符号;写请求,不写最终输出
OPC UATCP 4840上层系统只读或按项目开放的变量;不是 MES 业务库

远程读写应使用当前 SDK 文档列出的公开接口,不要自造第二套地址协议。

在线修改​

在线工具区分两种操作,都走 18821,不走 18850:

操作行为通道
写入一次写入当前值,后续可被程序再次覆盖18821
强制Runtime 持续覆盖,直到明确释放或按恢复策略清除18821 ForceSafetyGate
监视只读当前值和 ForceState18850

强制需要工程师或更高角色,经 18821 nonce 校验,并记录操作者和原因。18850 上看到 ForceState 只说明该点是否处于强制,不能当作强制入口。

详见 强制与写入。

多程序块访问​

同一 DB 可以被多个 OB、FB 或 FC 读取。为避免顺序依赖:

  • 每个关键字段尽量只有一个写入者;
  • 其它程序块只读取结果;
  • 需要跨阶段更新时,用状态字段明确提交时机;
  • 不要假设周期 OB 会抢占 OB1,当前调度为同线程排队。

保持数据​

Retain 字段可在受控重启后恢复。它不保证跨任意项目下载或硬件损坏永久保存;重要工艺参数仍应有受控导出、版本管理和恢复校验。当前公开模型没有独立的 Persistent 语言合同。

排错​

现象检查项
HMI 读不到字段符号路径、外部读权限、18823 连接和 Runtime 状态
HMI 无法写入外部写权限、用户权限和类型范围;HMI 不能代替 18821 强制
地址值异常字段类型、偏移和项目是否重新编译
值被程序立即改回是否执行了一次写入而非强制;强制必须走 18821
强制被拒绝角色、nonce、变量可写性;是否误走 18850
多处写入结果不稳定收拢为单一写入者并核对 OB 顺序

相关文档​