简短回答
建议准备厂商与型号、固件版本、完整协议及修订记录、测试设备、连接配置方式,以及要验收的业务功能清单。
一份协议PDF不是完整的接入包
设备接入需要同时掌握“纸面约定”和“实机行为”。同品牌不同批次可能使用不同固件或扩展字段;同一版协议也可能只实现部分功能。应把型号和固件作为适配对象,而不是一次联调后笼统宣布整个品牌全部兼容。
OCA 的测试说明强调按实现进行符合性验证;Modbus 的规范入口也区分不同通信方式。下面的材料清单是通用联调建议,不代表任何厂商的强制提交流程。
接入前建议收齐的材料
| 类别 | 需要的内容 |
|---|---|
| 设备档案 | 厂商、型号、功率、枪口数量、固件与通信模块版本 |
| 通信说明 | 完整协议、修订记录、扩展字段、加密与认证方式 |
| 配置和样例 | 服务器地址设置方法、脱敏报文、编号及枪口映射 |
| 交易规则 | 电量/金额单位、价格下发、停止原因、断网补传能力 |
| 测试条件 | 实机、测试车辆或合适负载、厂商联调人和固件回退方案 |
场景示例:看似成功,电量却错了一百倍
假设设备上传数值1234,文档约定单位为0.01 kWh,真实应解释为12.34 kWh。如果平台按1 kWh保存,通信仍然正常,订单却完全错误。因此字段验证应同时核对原始报文、转换结果与现场计量记录。类似问题也会发生在金额分/元、秒/分钟、枪号从0还是从1开始。
从联调通过到正式支持
先跑登录、心跳、状态与启停,再跑计费、订单和异常恢复;记录未支持项,明确版本变更是否需复测。交付时保留样例、字段映射和测试报告,生产环境的密钥与个人信息不要混入公开文档。模拟器可以加快开发,但不能替代真实设备与车辆组合下的执行验证。
适用条件与边界
协议文档只是输入,不能代替实机联调;同一品牌的不同固件也可能有差异。
阅凛编辑整理。文中的流程、清单和假设算例为通用设计建议;涉及标准与政策的依据列于文末,不代表已交付能力或特定项目收益。