cloud
82 lines
2.1 KiB
Markdown
82 lines
2.1 KiB
Markdown
---
|
|
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 路径、库文件细节。
|