Current Handoff

Goal: 完成综合平台编程器的结构化梯形图、HMI、离线仿真和 Modbus RTU 真机链路
Branch: main
Current status: 第 1~10 步的软件实现与自动化测试已完成，待连接 XDH-60T4-E 进行真机安全验证和整理最终交付资料

当前能力

梯形图条件使用递归 Node / Series / Parallel 表达式树，可表示 A OR (B AND C) 和嵌套串并联
编辑器使用固定行列网格和正交连线，支持当前节点后串联、单节点并联、连续节点范围并联、删除节点或网络以及设置输出线圈
画布只选择可见节点，不暴露内部表达式容器；橡皮框或多选连续节点后可直接建立并联支路
执行器递归求值并生成节点、表达式、网络轨迹，离线运行时画布显示导通路径和故障位置
HMI 和梯形图直接配置 M/D 地址，不依赖预先创建的数据点
ActiveRegisterRepository 在离线虚拟仓库与 PLC 缓存仓库之间切换
PlcCommunicationService 使用 Qt SerialBus 异步连接、轮询和单点写入，UI 不阻塞
真机连接收集 HMI 和梯形图实际引用地址，按 M/D 分区并合并相邻地址读取
真机模式要求首次读取完成，不复制离线值，不运行 PC 软件逻辑执行器
通信错误停止轮询并保留最后一次有效缓存，状态栏和日志显示错误
主窗口静态控件已迁入 main_window.ui，PLC 参数由独立配置对话框收集后再发起连接
已在真实 COM3 / 9600 / 8E1 / 站号 1 上完成只读联机验证，项目通信服务可完成 M/D 首次读取并进入真机运行前置状态

关键决策

工程格式继续使用 1.0，当前文件只保存 HMI 和梯形图表达式树，不保留 dataPoints 结构及兼容代码
不读取旧的 stages/branches 结构，不添加旧格式迁移和兼容层
梯形图编辑结构而不是自由线段，避免悬空线、环路和多个输出路径
网格仅作为编辑投影，不进入工程格式；服务层把连续范围操作转换为规范化表达式树
条件节点继续使用 std::variant 的独立配置类型，不向通用节点添加无关字段
HMI、梯形图和通信共享 M0~M4000、D0~D4000 地址范围
已删除统一数据点表、主窗口数据点 Dock 和属性区数据点下拉框；软元件注释功能待后续按信捷业务单独设计
PLC 读写使用从 0 开始的原始 Modbus 地址
HMI 写请求不乐观修改 PLC 缓存，由下一次轮询确认真实值
真机运行时 PLC 内部程序是控制源，软件逻辑执行器保持停止

自动化验证

以下测试均已完成干净构建并通过：

domain_tests
logic_editor_service_tests
offline_simulation_service_tests
project_management_tests
hmi_editor_service_tests
runtime_mode_service_tests
plc_runtime_tests
main_window_tests

main_window_tests 还覆盖 PLC 配置参数往返、独立配置弹窗入口，以及主窗口不再内嵌串口参数控件。

2026-08-13 真机排查发现 QModbusRtuSerialMaster::connectDevice() 在当前 Windows
串口驱动上会同步触发 ConnectedState。旧实现随后再次写入 Connecting，导致已经发出的
读取响应因服务状态不是 Connected 而被丢弃，首次读取标志永远不能完成。现已把
Connecting 状态设置移动到 Qt 连接调用之前，并在真实 PLC 上验证首轮 M0~M2、D0
读取约 288 ms 完成，缓存值为 M0=1、M1=1、M2=0、D0=0。主窗口现在会显示
连接、首读完成和具体中文通信故障，生产代码中的业务错误提示已统一为中文，JSON 字段和协议标记保持不变。

PLC 连接初始化会连续通知首读重置、正在连接和已连接。旧主窗口把每次通知都排队处理，
队列执行时读取到的已经是同一个最终状态，因此输出区会连续追加三条相同的“正在首读”。
现已在主窗口合并同一事件循环内的 PLC 状态刷新，并拒绝连续追加完全相同的输出消息。
真实 COM3 主窗口联调确认“正在首读”和“首次读取完成”各输出一次。

本轮已完整删除统一数据点业务，包括领域模型、服务、主窗口 Dock、属性区下拉框、JSON 字段和独立测试工程。当前开发阶段不保留 dataPoints 旧结构的迁移或兼容逻辑。主窗口测试明确验证已删除控件不存在，PLC 轮询测试改为验证从 HMI 实际绑定收集地址。

本轮梯形图编辑重构还验证了：固定网格渲染、水平/垂直正交布线、工具栏直接建立并联支路，以及连续范围 A AND ((B AND C) OR D) 的结构变换和非连续范围拒绝。

Qt Release 应用已完成干净构建，并执行了启动与正常退出冒烟验证。git diff --check 无空白错误。

待完成事项

在 PLC STOP 状态确认 COM2 参数和 RS-485 A/B 接线
用安全测试地址读取 M0、D0
写入 M0、D0 并由 PLC 监控和下一次轮询确认
验证断线、超时和重新连接流程
PLC 切换 RUN 后执行完整 HMI 与设备联动测试
整理测试记录、构建说明和演示工程

建议下一步

运行 Release 应用，配置实际 COM 口、站号、波特率和校验方式，在 PLC STOP 状态完成 M0、D0 首次安全读写。未确认设备程序与负载安全前不要在 RUN 状态写控制地址。

5.4 KiB Исходник Вина История