BACnet 驱动采集测试与验收标准清单
基于配置修改 D:\code\edgex\conf\channels.yaml 使用最新配置文件来实现设备读取bacnet点位 比如 D:\code\edgex\conf\devices\bacnet-ip\bacnet-2228316.yaml 严格按照配置文件中的点位进行读取 配置文件不可修改的原则进行代码调整 特别注意：
- DeviceID：系统内唯一标识（Edge/平台侧）
- Instance ID：BACnet 网络唯一标识
- ObjectID：对象标识（Type + Instance）
- Property：对象属性标识
当前设备清单（验收范围 ：设备点位不可串流到一起）：
- bacnet-18 → Instance ID 2228318 ->Setpoint.1 AnalogValue 1 318.00 验证点不得出现在其他设备点位中
- bacnet-16 → Instance ID 2228316
- bacnet-17 → Instance ID 2228317
- Room_FC_2014_19 → Instance ID 2228319
⚠ 验收前提：已确认所有设备物理运行正常，网络正常 ⚠ 最终要求：全部设备质量等级必须为 Good（≥85分）
如果使用token 可以利用下面的例子 (当前token为有效token) curl ^”http://127.0.0.1:8082/api/channels/jxy3kvpohmetzct0^” ^ -H ^”Accept: application/json, text/plain, /^” ^ -H ^”Accept-Language: zh,zh-CN;q=0.9,en;q=0.8^” ^ -H ^”Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiYWRtaW4iLCJlbWFpbCI6IiIsImlzcyI6IkluZHVzdHJpYWxFZGdlR2F0ZXdheSIsImV4cCI6MTc3Mjg2NDA3NywibmJmIjoxNzcyMjU5Mjc3fQ.m0k3SQ-B9n7sfSSYnzXjT0X0Vmq_cxjqNM1jw0w03vg^” ^ -H ^”Connection: keep-alive^” ^ -H ^”DNT: 1^” ^ -H ^”Referer: http://127.0.0.1:8082/^” ^ -H ^”Sec-Fetch-Dest: empty^” ^ -H ^”Sec-Fetch-Mode: cors^” ^ -H ^”Sec-Fetch-Site: same-origin^” ^ -H ^”User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36^” ^ -H ^”sec-ch-ua: ^\^”Not:A-Brand^\^”;v=^\^”99^\^”, ^\^”Google Chrome^\^”;v=^\^”145^\^”, ^\^”Chromium^\^”;v=^\^”145^\^”^” ^ -H ^”sec-ch-ua-mobile: ?0^” ^ -H ^”sec-ch-ua-platform: ^\^”Windows^\^”^” ^ -H ^”sec-gpc: 1^” ^ -H ^”token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiYWRtaW4iLCJlbWFpbCI6IiIsImlzcyI6IkluZHVzdHJpYWxFZGdlR2F0ZXdheSIsImV4cCI6MTc3Mjg2NDA3NywibmJmIjoxNzcyMjU5Mjc3fQ.m0k3SQ-B9n7sfSSYnzXjT0X0Vmq_cxjqNM1jw0w03vg^”
《BACnet 驱动采集测试与验收标准清单》
一、点位读取（ReadProperty）验收标准
3.1 基础属性支持范围
必须支持对象
| 类型 | 必须属性 |
|---|---|
| AI | Present_Value, Units, Status_Flags |
| AO | Present_Value, Units, Status_Flags |
| AV | Present_Value, Units |
| BI | Present_Value, Status_Flags |
| BO | Present_Value, Polarity |
| Device | Object_Name, Vendor_Name, System_Status |
3.2 读取性能要求
- 成功率 ≥ 99%
- 单次读取 RTT ≤ 500ms（局域网）
- 连续采集周期支持 5~30 秒
- 非法点位读取不得影响其他点位
3.3 多设备隔离要求（关键）
- 单设备异常不影响其他设备轮询
- 设备级调度线程独立
- 超时仅影响当前设备
五、COV 订阅机制验收标准
5.1 功能要求
- 支持 SubscribeCOV
- 支持订阅过期自动重订
- 支持设备重启后自动恢复
- 订阅失败自动回退轮询
- 轮询周期默认 10s 可配置
5.2 验收判定
- 数据变化实时上报
- 不出现重复订阅
- 网络恢复后自动重建订阅
- COV 与轮询互不干扰
六、异常与健壮性验收标准（必须达标）
6.1 必测异常场景
- 设备断电
- 设备重启
- 网络抖动
- UDP 丢包
- 单对象错误
- Abort / Reject 报文
6.2 判定标准
- 单设备离线不影响其他设备
- 设备进入 DEGRADED 状态后质量下降
- 恢复后自动回到 ONLINE
- 连续失败达到阈值自动冻结
- 恢复成功后自动解冻
七、质量等级验收标准（必须全部 Good）
7.1 设备级质量评分规则
| 指标 | 要求 |
|---|---|
| SuccessRate | ≥ 98% |
| TimeoutRate | ≤ 1% |
| AvgRTT | ≤ 200ms |
| 连续失败 | ≤ 3 次 |
| Flap | 0 |
最终等级必须：
QualityScore ≥ 85
QualityLevel = Good
7.2 通道级要求
- 所有设备 Quality = Good
- 无设备 Offline
- 无设备 Degraded
- WorstDeviceQuality ≥ 85
八、性能与压力测试验收标准
8.1 基准指标
- 支持 ≥ 256 设备
- 每设备 ≥ 500 点
- 采集周期 10 秒
- 连续运行 72 小时
8.2 判定标准
- CPU 无异常飙升
- 内存无泄漏
- Goroutine 不增长
- 无死锁
- 平均延迟稳定
九、自动建模与持久化验收
9.1 必须支持
- 自动注册设备
- 自动生成点位模型
- 模型持久化 JSON/DB
- 重启自动恢复
十、完整验收表（Markdown 模板）
# BACnet 驱动功能验收表
## 一、设备发现
| 项目 | 标准 | 结果 | 是否通过 |
|------|------|------|----------|
| Who-Is 广播 | 正常 | | ☐ |
| I-Am 解析 | 100%成功 | | ☐ |
| 自动注册 | 正常 | | ☐ |
## 二、对象发现
| 项目 | 标准 | 结果 | 是否通过 |
|------|------|------|----------|
| objectList 完整性 | 无丢失 | | ☐ |
| 分段支持 | 正常 | | ☐ |
## 三、点位读取
| 设备 | SuccessRate | AvgRTT | Quality | 是否Good |
|------|------------|--------|---------|----------|
| bacnet-16 | | | | ☐ |
| bacnet-17 | | | | ☐ |
| bacnet-18 | | | | ☐ |
| Room_FC_2014_19 | | | | ☐ |
## 四、写入控制
| 测试项 | 结果 | 是否通过 |
|--------|------|----------|
| AV写入 | | ☐ |
| BO写入 | | ☐ |
| 优先级释放 | | ☐ |
## 五、稳定性测试
| 项目 | 标准 | 是否通过 |
|------|------|----------|
| 72小时运行 | 无异常 | ☐ |
| 断网恢复 | 自动恢复 | ☐ |
| 单设备异常隔离 | 正常 | ☐ |
十一、Go 驱动自测 Checklist
- Who-Is 解析正确
- objectList 分段正确
- ReadProperty 并发安全
- WriteProperty 优先级支持
- COV 自动重订
- 设备级 metrics 正确更新
- 状态机融合质量算法
- 单设备异常不影响全局
- 自动建模恢复
十二、自动化测试结构建议
/test
bacnet_discovery_test.go
bacnet_objectlist_test.go
bacnet_read_test.go
bacnet_write_test.go
bacnet_cov_test.go
bacnet_stability_test.go
bacnet_performance_test.go
每个测试应包含：
- 正常场景
- 异常场景
- 恢复场景
- 压测场景
最终验收判定条件（签字级）
✔ 设备发现率 100% ✔ 对象完整率 100% ✔ 点位成功率 ≥ 99% ✔ 全部设备 Quality ≥ Good ✔ 单设备异常不影响其他设备 ✔ 72 小时稳定运行无异常 ✔ 自动恢复能力验证通过