主题
A. 常见问题与排查
按现象逐条对照，从上往下查。若还没有明确线索，先按这张图的顺序排查一遍 —— 它按「最可能的原因」排序：
通用
| 现象 | 先查什么 |
|---|---|
| 配完没有任何反应 | 没点「重启生效」。写入只是把配置存进设备，运行中的任务仍按旧配置跑 |
| 界面上没有某个子标签 | 该机型固件不支持，对照 总览 · 支持哪些设备与能力 |
| 改错了想回退 | 点「重新读取」，会丢弃界面改动、从设备读回当前配置 |
上云
| 现象 | 先查什么 |
|---|---|
| 云端查不到这个点 | 「云平台」页是否启用、账号密码对不对、server/online/PLC/<设备ID> 是否为 1 |
| 点出现了但值一直不变 | 同步方向是否配成「仅下发」；寄存器地址写错（尤其 X/Y 是八进制） |
| 云端改了值 PLC 没动 | 该点配成了「仅上传」，改成「仅下发」或「双向」 |
| 浮点数值乱跳 | 两个点的地址重叠（浮点占 2 个 D） |
| 值没变化云端就没新数据 | 这是设计行为：仅在值变化时上报。要固定周期留记录，给该点设存盘方式 |
串口采集
| 现象 | 先查什么 |
|---|---|
| 一个数据都采不上 | 波特率 / 校验 / 站号与仪表是否一致；485 的 A/B 是否接反 |
| 采上来数值不对 | 浮点字节序（多数国产仪表是 CDAB）；数据类型与仪表实际格式是否一致 |
| 采集很慢或时断时续 | 轮询时间是否短于 从机数 × 接收超时 |
协议（BACnet / OPC UA / 水务遥测）
| 现象 | 先查什么 |
|---|---|
| 机型上看不到这一页 | 仅 ESP32-S3 机型与软 PLC 模拟器支持 |
| BMS 读得到但写不下来 | 对象类型用了 AI / BI / MSI，要能写必须用 AV / BV / MSV |
| OPC UA 客户端连不上 | 端口与服务器名称；是否关掉了匿名登录却没配用户名密码 |
| 水务配置一帧都不上报 | 顶部红色问题清单没清空，整段配置被设备拒绝 |
MQTT
| 现象 | 先查什么 |
|---|---|
| 配置一点就报红（顶部错误清单） | 错误提示已经写明：Broker 地址 / 端口格式、topic 字符（+ # 只允许在订阅里）、占位符花括号是否闭合 |
| ESP32-S3 设备配了不生效、也不报错 | 设备固件是 2026 年 9 月之前的老版本（没编 MQTT 模块），写进去的配置会被直接忽略、连接状态区不出现——升级固件后生效 |
| Broker 看不到设备上线 | link_flag 默认 M200，看它有没有变成 1；上位机的「运行状态」色块不绿就先看这一项；再看 Broker 地址能不能从设备端 ping 通 |
| 上行流量异常大 | 模板里带了 {ts} / {ms} / {datetime} 同时又开了「仅变化时发送」 —— 每次渲染结果都不同，相当于未启用 |
报文内容是 {ts,1234,...} 原样发出 | 占位符大小写错或花括号没闭合；改完看输入框下方的实时预览是不是已经替换成数字 |
| 平台下发了命令但寄存器没变 | 响应点位的 path 写错（大小写或层级对不上）；先在「解析」处粘贴回放的 JSON 看能不能列出字段 |
| 收到命令但梯形图收不到信号 | recv_flag 填成了 D 区而不是位软元件（M / S / X / Y / TS / CS），固件会照写但梯形图那边永远等不到 |
HTTP
| 现象 | 先查什么 |
|---|---|
| 配置一点就报红（顶部错误清单） | 错误提示已经写明：服务器地址必须以 http:// 开头；请求路径必须以 / 开头；占位符花括号是否闭合 |
| 服务器日志完全收不到请求 | 服务器地址写成了 https://（不支持，会在连接阶段失败）；端口错；服务端防火墙拦截 |
URL 拼出来是 http://hostapi/data（少了个 /） | 请求路径漏了开头的 / —— 这一条最容易被漏掉，请求会打到错误地址、服务端返回 404 |
| 「已发请求」涨但「收到响应」不动 | 看面板底部「最近错误」具体原因；常见是返回不是合法 JSON、超时、服务器返回 4xx/5xx |
| 「仅变化时发送」开了流量没省 | 模板里有 {ts} / {ms} / {datetime}（每次都不同）或方法是 GET（GET 没有请求体可比，本就对 GET 无效） |
配了 recv_flag 永远不亮 | 该请求组没有任何启用的响应点位；response_points 为空时固件不发起该请求 |
| 配置改了但请求周期没变 | 整个周期低于 1000ms 时校验会拦住；HTTPS 改成 HTTP，否则连接阶段直接失败 |