HMI 诊断
HMI 显示异常、变量不更新、写入失败或页面卡顿时,先看页面可见状态,再查浏览器诊断和现场运行日志。不要凭现象猜原因。
诊断顺序
- 确认页面始终显示当前 Profile 和资源真伪状态。
- 现场 WebHMI 确认固定端口
18823可达且未被占用。 - 确认右下角连接状态为“PLC 已连接”。
- 检查变量名、数据质量和最后更新时间。
- 检查写请求是否收到完整提交回执。
- 在 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,并重新发布项目色板 |
| 配方一直等待 | 继续查询同一部署事务,不要重复下发 |
| 预览有值、现场无值 | 预览不是现场真值,需按正式发布链验证 |