跳到主要内容

HMI 诊断

HMI 显示异常、变量不更新、写入失败或页面卡顿时,先看页面可见状态,再查浏览器诊断和现场运行日志。不要凭现象猜原因。

诊断顺序​

  1. 确认页面始终显示当前 Profile 和资源真伪状态。
  2. 现场 WebHMI 确认固定端口 18823 可达且未被占用。
  3. 确认右下角连接状态为“PLC 已连接”。
  4. 检查变量名、数据质量和最后更新时间。
  5. 检查写请求是否收到完整提交回执。
  6. 在 IDE 诊断页或远程管理 18443 中查看 HMI 与现场运行日志。

远程取日志和状态只走 18821 与 18443。不要为了看画面去开 RDP。

浏览器诊断​

IDE 预览和调试版本可使用浏览器开发工具。正式现场模式默认不开放开发工具,维护人员应优先使用产品内置诊断页和日志导出。

只使用公开对象 window.darra:

const stopReady = darra.on('ready', () => console.info('HMI 已连接'));
const stopOffline = darra.on('offline', () => console.warn('HMI 已断线'));
const stopError = darra.on('error', error => console.error('HMI 错误', error));

stopReady();
stopOffline();
stopError();

在 Network 中检查页面资源和 WebSocket。出现 401 或 403 时先检查登录与权限;出现 404 时检查页面路由;连接反复关闭时检查现场服务状态和网络质量。不要直接操作 /ws。

变量与写入​

const unsubscribe = darra.bind('DB1.Temperature', (value, meta) => {
console.log('温度', value, '质量', meta.quality, '时间', meta.timestamp);
});

try {
const receipt = await darra.write('DB1.Setpoint', 65.0);
if (!darra.isCommittedReceipt(receipt)) {
throw new Error('写入尚未完整提交');
}
console.log('写入已提交', receipt.transactionId);
} catch (error) {
console.error('写入失败', error.message);
}

unsubscribe();

不要把“请求已接受”或“仍在等待”显示为写入成功。失败时检查登录状态、角色权限、写入白名单、数值范围和 PLC 联锁。darra.get() 只读缓存,缓存未命中时值为 undefined。

性能检查​

现象优先检查
页面切换慢非活动页是否暂停、页面资源是否过大
图表卡顿采样间隔、可见点数、动画、重复订阅
内存持续增长未清理的订阅、计时器、事件和大数组
手机耗流量高当前页是否订阅了不需要的变量
报警刷屏重复报警规则、通知限频和确认状态

HMI 多页运行时有总内存保护。页面切换应使用现有多页路由,不要重复创建相同页面实例。

常见问题​

症状处理
页面白屏查看首个脚本或资源错误,确认发布版本完整
页面能打开但变量不变检查变量名、订阅回调和 PLC 在线状态
按钮点击无结果检查写入回执、白名单、权限和 PLC 联锁
断线后旧值仍显示显示最后更新时间,并禁用所有写入控件
主题颜色不一致检查是否只传了 modern / industrial,并重新发布项目色板
配方一直等待继续查询同一部署事务,不要重复下发
预览有值、现场无值预览不是现场真值,需按正式发布链验证

相关文档​