---

layout: default title: BACnet 前端 Web UI 对应需求说明书 description: EdgeX BACnet 前端 UI 需求说明书 —

BACnet 前端 Web UI 对应需求说明书（PRD）

本系统必须满足本文档中定义的全部功能性要求，作为软件开发、测试验收与项目交付的依据。

---

2. 功能需求

---

2.1 设备管理模块（Device Management）

2.1.1 设备发现与注册

功能描述

系统应支持通过 BACnet 标准协议自动发现网络中的设备，并将其纳入管理系统。

功能要求

• 支持一键扫描 BACnet 设备（Who-Is / I-Am）

• 系统必须展示以下设备字段：

  • DeviceInstance
  • 设备名称
  • Vendor / Model
  • IP 地址 / 网络号
  • 在线状态

• 系统必须支持：

  • 自动注册发现的设备
  • 手动添加设备
  • 编辑设备信息
  • 删除设备

验收标准

• 扫描操作后，设备列表实时更新
• 重复扫描不产生重复设备
• 设备状态变化（上线/离线）可实时反映在 UI 中

---

2.2 对象与点位管理模块（Object & Point Management）

2.2.1 对象浏览（Object Explorer）

功能描述

系统应支持查看 BACnet 设备的对象结构及点位信息。

功能要求

• 系统应支持以下层级展示结构：

  • Device → Object Type → Object Instance
• 支持树形视图或表格视图切换

• 支持筛选条件：

  • 按对象类型（AI / AO / AV / BI / BO / BV）
  • 按点位名称
  • 按单位
  • 按描述字段

验收标准

• objectList 加载完整，无丢失、无重复
• 大量对象场景下支持分页、搜索与排序

---

2.2.2 点位详情页（Point Detail View）

功能描述

系统应提供点位级别的详细信息展示与编辑能力。

功能要求

点位详情页必须展示并支持编辑以下属性：

• Object Identifier
• Object Name
• Present Value（实时刷新）
• Units
• Status Flags
• Description
• Reliability
• Priority Array（如支持写入）

验收标准

• Present Value 实时刷新稳定
• 属性编辑后立即生效并持久化

---

2.3 点位读写与控制模块（Read / Write / Control）

2.3.1 点位控制能力

功能描述

系统应支持对 BACnet 可写点位进行远程控制。

功能要求

• 支持以下对象类型写入：

  • AO（Analog Output）
  • BO（Binary Output）
  • AV（Analog Value）
  • BV（Binary Value）

• 支持写入模式：

  • 普通写入
  • 优先级写入（Priority 1~16）
  • 释放写入（NULL 写入）

• 写入结果必须即时反馈：

  • 成功
  • 失败
  • 无权限

验收标准

• 写入后应自动回读并验证写入结果
• 写入失败需给出明确错误提示

---

2.4 网络与通信状态可视化模块

2.4.1 BACnet 通信状态面板

功能描述

系统应提供 BACnet 网络运行状态的整体可视化界面。

功能要求

• 系统必须展示以下统计信息：

  • 在线设备数
  • 离线设备数
  • 当前通信速率
  • 错误统计（超时、拒绝、无响应）

• 系统必须支持在网络异常时：

  • 定位到具体设备
  • 显示对应错误类型

验收标准

• 网络异常发生后 5 秒内 UI 反映状态变化
• 错误统计数据准确、可追溯

---

2.5 自动建模与配置管理模块

2.5.1 自动点位建模管理

功能描述

系统应支持基于 BACnet 对象自动生成点位模型，并支持后续编辑与维护。

功能要求

• 从 objectList 自动生成点位模型

• 支持以下模型管理能力：

  • 点位重命名
  • 标签管理
  • 分组管理
  • 区域归属配置
  • 模型编辑
  • 模型重生成

验收标准

• 自动建模完成后无需人工配置即可开始采集
• 模型变更后可立即生效并持久化

---

2.5.2 批量操作能力

功能描述

系统应支持对设备与点位进行批量化操作，以提升工程配置效率。

功能要求

• 支持：

  • 批量启停采集
  • 批量修改采集周期
  • 批量点位写入（可选项）

验收标准

• 批量操作过程可视化进度与结果反馈
• 单个失败不影响整体任务执行

---

2.6 系统运维与诊断模块

2.6.1 通信日志查看

功能描述

系统应提供 BACnet 通信日志的可视化查询能力。

功能要求

• 支持查看 BACnet 请求/响应摘要日志

• 支持日志筛选条件：

  • DeviceID
  • ObjectID
  • 错误类型
• 支持日志下载功能

验收标准

• 日志查询响应时间 ≤ 2 秒（常规规模）
• 下载日志格式规范、内容完整

---

2.6.2 设备调试工具（推荐功能）

功能描述

系统应内置 BACnet 调试工具，用于工程调试与问题排查。

功能要求

• 支持：

  • 单点 ReadProperty 测试
  • 单点 WriteProperty 测试
  • Who-Is / I-Am 手动触发
  • objectList 重新拉取

验收标准

• 调试工具操作结果可即时反馈
• 调试过程不影响正常采集流程

---

3. 最小可交付功能集（MVP）

系统交付时必须至少包含以下功能模块：

模块	必须具备功能
设备管理	扫描、注册、状态显示
点位管理	objectList 浏览、点位详情
实时数据	Present_Value 实时显示
点位控制	AO / BO / AV / BV 写入
日志	通信与操作日志

---

4. 验收说明

• 本文档为 BACnet Web UI 产品功能验收的唯一功能基线文档。
• 未满足任一强制功能要求，视为产品未通过验收。
• 推荐将本文档拆解为：