主题
设备与数据
本文汇总 设备离线、数据不可见、数值异常、控制失败 等跨 Web 与 APP 的设备数据问题。
网关或设备显示离线？
排查顺序
- 先查网关：网关离线会导致其下 所有设备 显示离线
- 再查设备：确认设备所属网关在线、设备心跳正常
- 南向与现场：南向下发后需等待驱动加载与设备发现；核对 RS485 接线、从站地址、波特率
- 网络与时间：检查网关供电、SIM/网线；确认系统与设备时间同步
Web 端补充说明
- 设备心跳超时：等待设备重新上报
- 网关离线：在「网关管理」确认网关状态
详见 Web FAQ Q6、Q27 · 网关与南向接入。
APP 端补充说明
- 添加设备前，设备通常已由管理员/安装人员接入平台
- 若设备在列表中显示异常，联系管理员确认网关与权限
看不到设备数据？
| 可能原因 | 处理 |
|---|---|
| 设备 / 网关离线 | 仅在线设备可查看实时数据；等待上线 |
| 权限不足（Web） | 需设备级权限如 device:datapoint:realtime；联系管理员分配设备角色 |
| 部门负责人看下属设备 | 默认仅看自己绑定的设备；需租户开启子树可见，见 下文 |
| 设备未上报 | 检查南向配置、现场接线与仪表是否正常 |
| APP 未添加设备 | 终端用户需先将设备添加到个人账号 |
详见 Web FAQ Q8 · APP 添加设备。
部门负责人看不到下属设备？
若你是 部门负责人（组织主管），在设备列表中只能看到自己绑定的设备、看不到下属员工的设备，通常是因为租户未开启 部门子树设备可见 配置。
| 配置项 | authorization.department.subtree-device-access |
|---|---|
| 含义 | 部门负责人可查看所管部门及 所有子部门 下用户绑定的设备 |
| 谁可开启 | 租户管理员（系统设置 → 全局配置，需 system:globalConfig:edit）。详见 常用租户配置项 |
| 默认 | 关闭 — 部门负责人与普通用户一样，仅看自己绑定的设备 |
| 角色 | 配置关闭（默认） | 配置开启 |
|---|---|---|
| 租户管理员 | 租户全部设备 | 租户全部设备 |
| 部门负责人 | 仅自己绑定的设备 | 管辖子树内用户的设备 |
| 普通用户 | 仅自己的设备 | 仅自己的设备 |
还需确认：
- 该账号已在部门管理中 设为主管
- 下属员工已挂到你所管部门（或子部门）下
- 下属设备已绑定到对应员工账号
完整组织配置见 多级组织与账号管理 · 步骤 6。
数据不准确或有延迟？
- 刷新页面：可能存在缓存延迟
- 权限范围：只能看到有权限的数据
- 统计延迟：部分汇总数据需等待片刻后刷新
详见 Web FAQ Q10。
Modbus 数值异常
数据能上报但数值不对时，依次检查：
- 寄存器地址是否正确
- 读功能码（03 / 04）是否匹配
- 字节顺序（ABCD / CDAB 等）
- 数据类型是否匹配
- 数据转换表达式是否正确
常用转换表达式
| 场景 | 表达式示例 |
|---|---|
| 寄存器放大 10 倍存温度 | MUL(0.1) |
| 线性标定 y = ax + b | LINEAR(a, b) |
| 取某一位开关量 | BIT(位号, 位号) |
| 取位后再缩放 | BIT_MUL(起始, 结束, 系数) |
完整语法见 南向配置 4.3 · Modbus 示例见 5.3 节 · Web FAQ Q26、Q28。
无法执行设备控制？
| 可能原因 | 处理 |
|---|---|
| 设备离线 | 等待设备上线 |
| 权限不足 | Web 需 device:control:command 等设备级权限 |
| 物模型不支持 | 确认设备物模型中定义了该控制服务 |
| APP 面板无入口 | 需租户配置 app.device-panel 且 enable 为 true |
| APP 列表无关键指标 | 需租户配置 app.device-list.key-data；见 APP 常见问题 |
详见 Web FAQ Q9 · APP 常见问题 · 设备面板。
Web：无法新增设备？
常见原因：无 device:info:create 权限、必填项未填、设备标识符重复、所选网关离线。详见 Web FAQ Q7。