---
name: edge-protocol-research
description: edge_collector 协议调研与适配评估规范。用于调研 FANUC、西门子 CNC、PLC、传感器、第三方 SDK 或参考仓实现时，按当前协议模板、驱动代码、参考实现、官方资料和验证计划输出适配差异、点位补充和实现建议。
---

# edge_collector 协议调研

## 适用场景

- 新增协议驱动。
- 完善 FANUC/西门子 CNC 点位。
- 参考外部仓采集程序。
- 判断第三方 SDK 架构和库是否可用。
- 协议模板是否合理、是否缺常用点位。

## 调研顺序

1. 读取当前协议模板和用户可见描述。
2. 读取当前驱动实现和文档。
3. 对比参考仓或历史实现。
4. 拿不准的协议语义联网查官方资料或 SDK 文档。
5. 输出差异、风险、实施建议和验证计划。

## 当前项目路径

优先查看：

- `configurator/config/templates/`
- `configurator/config/protocols/`
- `collector/src/driver/`
- `collector/docs/protocols/`
- `third_party/`
- `collector/CMakeLists.txt`

## 对比重点

- 连接参数是否够用。
- 点位名称、类型、单位、默认采集周期是否合理。
- 模板点位和驱动读取逻辑是否一致。
- 是否保留现有 `PointData::UpdateValue` 行为。
- 用户可见协议介绍是否隐藏内部技术细节。
- 第三方库是否按架构分层放置。
- ARM64/ARM32/x64 构建模式是否明确。

## 联网规则

遇到以下情况必须联网查证：

- 协议函数含义不确定。
- SDK 架构、库名、系统依赖不确定。
- 西门子/FANUC 指标语义不确定。
- 第三方资料可能过期。

优先官方文档、SDK 手册、厂商资料；社区资料只能作为补充。

## 输出格式

```markdown
## 当前现状

## 参考实现差异

## 点位/参数建议

## 驱动实现建议

## 构建与第三方库影响

## 用户文档影响

## 验证计划

## 风险与待确认
```

## 禁止事项

- 不凭猜测写协议语义。
- 不提交未知来源二进制库。
- 不把参考仓问题照搬进当前工程。
- 不在用户可见协议介绍中写 helper、SDK 路径、库文件细节。