14 · 设备绑定与预警设置
所属板块：项目管理（单项目维度）
功能概述
设备绑定是每个项目的设备台账，以两级树结构管理：
- 顶级设备：直接绑定到项目的设备，如「水位监测设备」「PLC 控制箱」；
- 子设备：挂在顶级设备下的具体设备，如 PLC 控制箱下的「水压计」「流量计」「电动阀」「关联水泵」。
本模块提供：
- 设备列表查询（树形展开、关键字 / 类型 / 状态筛选、序号排序）；
- 绑定 / 编辑 / 解绑设备（含子设备的增删改）；
- 预警值设置（普通预警、强预警、告警间隔）——告警短信的触发依据。
适用角色：
| 操作 | 超级管理员 | 系统管理员 | 项目主管 | 项目员工 |
|---|---|---|---|---|
| 查看设备列表 | ✅ | ✅ | ✅ | ✅ |
| 绑定 / 编辑 / 解绑设备 | ✅ 直接生效 | 申请后待审批 | ✅ 直接生效 | 申请后待项目主管审批 |
| 设置预警值 | ✅ | ✅ 仅改预警值可直接保存 | 查看（只读） | 查看（只读） |
前端规则：预警值弹窗对系统管理员与超级管理员可编辑，项目管理员（主管 / 员工）为只读。
页面入口：项目管理 / 项目列表 → 点击项目进入详情，默认页签即「设备绑定」。
界面示意
图中：① 项目详情页签菜单；② 搜索与筛选区；③ 新增设备按钮；④ 设备列表（顶级设备 + 展开子设备）；⑤ 「设置预警值」按钮。
设备列表
列表结构
顶级设备一行，子设备缩进展示在其下方。每个设备展示：
| 字段 | 说明 |
|---|---|
| 序号 | 顶级设备的显示序号（同项目唯一） |
| 设备名称 / 编号 | 台账名称与设备编号（对接平台的设备 ID） |
| 设备类型 | 顶级类型 / 子类型名称 |
| 最新读数 | 系统自动采集的最新值（带单位）；未启用读取的设备为空 |
| 状态 | 正常 / 禁用 |
| 预警配置 | 预警值、强预警值的配置概况 |
| 操作 | 编辑、预警值、解绑等按钮 |
查询与筛选
- 关键字：按设备名称或编号模糊搜索；
- 设备类型：按顶级设备类型过滤；
- 状态：正常 / 禁用；
- 排序：按序号升序（默认）/ 降序。
绑定设备（新增）
- 在设备绑定页点击 绑定设备。
- 填写顶级设备信息：
| 字段 | 必填 | 说明 |
|---|---|---|
| 设备类型 | ✅ | 只能选择顶级类型（如「水位监测设备」「PLC 控制箱」），下拉来自设备类型管理 |
| 设备编号 | — | 对接平台的设备唯一编号：水位设备填 MQTT 设备 ID（RID）；PLC 控制箱填速控云平台的 deviceId |
| 设备名称 | — | 台账显示名称，建议含位置信息 |
| 序号 | ✅ | 同项目顶级设备之间不允许重复，重复时提示该序号已被哪台设备占用 |
| 状态 | — | 正常（默认）/ 禁用 |
| PLC 变量配置 | — | PLC 控制箱需配置各变量的 ID（见设备控制），通常由实施人员在建设期配置 |
- 如需挂子设备，在子设备区域逐行添加：
| 字段 | 必填 | 说明 |
|---|---|---|
| 子设备类型 | ✅ | 选择该顶级类型下的子类型（如水压计、流量计、电动阀、关联水泵） |
| 子设备编号 | ✅ | 对应速控云平台的变量 ID（variantId 后缀） |
| 子设备名称 | — | 显示名称 |
- 点击 确定 提交。
⚠️ 水压计、水位监测设备这类告警类型设备，绑定后请务必完成预警值设置，否则设备不会触发任何告警。
⚠️ 需要采集读数的子设备应保持「读取数值」为启用状态（默认启用）；关闭后系统不再采集、不写历史数据、不做告警判断。
编辑设备
- 点击设备行 编辑。
- 可修改名称、编号、状态、序号、子设备列表（新增 / 修改 / 删除子设备）。
- 保存规则：
- 未填写的字段保持原值不变（例如只改名称无需重传编号）；
- 序号传了才校验唯一性并更新；
- 删除子设备通过勾选 / 移除后随编辑一并提交。
审批规则：超级管理员、项目主管直接生效；系统管理员 / 项目员工提交后进入待审批（提示「等待管理员审批」/「等待项目主管审批」）。
预警值设置
预警值是设备告警的触发依据，按设备（通常是水压计 / 水位设备）单独配置。
- 在设备行点击 预警值，打开设置弹窗（弹窗回显服务端最新配置）。
- 填写以下参数：
| 字段 | 单位 | 说明 |
|---|---|---|
| 预警值 | 设备类型单位（如 m / MPa） | 读数 ≥ 该值开始进入预警计时 |
| 持续时间 | 秒 | 超限状态持续满该秒数才真正发送预警短信 |
| 强预警值 | 同预警值 | 更高的门槛；读数 ≥ 该值并持续满时长发送语音告警 |
| 强预警持续 | 秒 | 强预警的持续时长要求 |
| 告警间隔 | 秒 | 同一设备同一等级两次通知的最小间隔，必须为正整数，默认 3600（1 小时） |
图中：① 预警值与持续时间；② 强预警设置（强预警值 + 强预警持续）；③ 通知频率（告警间隔）；④ 保存按钮。
- 点击 保存。
权限与审批
- 超级管理员 / 系统管理员：可编辑。系统管理员仅修改预警值时无需审批，直接保存生效（视为日常运维操作）；若同时修改了名称、编号、状态、序号等其他字段，则整单进入审批流。
- 项目管理员（主管 / 员工）：弹窗为只读，仅可查看。
配置示例
某水压计要求「读数 ≥ 1.00 m 持续 3 分钟发短信，≥ 1.50 m 持续 3 分钟打语音电话，两小时内不重复轰炸」：
| 字段 | 填写 |
|---|---|
| 预警值 | 1.00 |
| 持续时间 | 180（秒） |
| 强预警值 | 1.50 |
| 强预警持续 | 180（秒） |
| 告警间隔 | 7200（秒） |
预警值 / 强预警值留空表示关闭该等级告警；告警判断与短信发送的完整规则见告警与短信通知机制。
解绑设备
- 点击设备行 解绑 并确认。
- 解绑顶级设备时，其下全部子设备一并解绑；解绑后设备从台账消失，历史数据保留但不再更新。
- 审批规则与绑定相同。
⚠️ 解绑前请确认现场设备确实已停用 / 迁移。解绑只是解除项目与设备的关联，不会在速控云平台删除设备。
常见问题
Q：绑定设备时提示「只能绑定顶级设备类型」？ 项目下的一行设备只能选顶级类型（pid=0）；水压计、电动阀等属于子类型，应作为 PLC 控制箱的子设备添加。
Q：设备最新读数一直是空的？
依次检查：① 设备「读取数值」是否启用；② PLC 控制箱的编号是否为速控云平台正确的 deviceId；③ 子设备编号（变量 ID）是否正确；④ 系统配置 / 速控云平台配置 是否有效。水位设备则需确认设备已通过 MQTT 在线并上报。
Q：设置了预警值但没收到短信？ 常见原因：① 持续时长未满足（瞬时波动不告警）；② 距上次通知未满「告警间隔」；③ 该项目没有状态正常的项目管理员、也没有开启强制通知的平台管理员；④ 短信模板未配置。详见告警与短信通知机制与FAQ。