Appearance
版本变更记录
记录协议文档版本变化、影响范围与验证状态,便于研发、测试、实施统一对齐。
记录
| 日期 | 版本 | 变更摘要 | 影响协议 | 影响项目 | 兼容性 | 验证状态 | 责任人 |
|---|---|---|---|---|---|---|---|
| 2026-09-21 | 私有 V2.10 | 增加设备MAC寻址及组网回复;扩展#0/#4/#5/#A;保留订单号位置与旧结果码 | 私有 | 组网网关及从机 | 旧非组网格式保留;平台和固件需适配新增字段 | 文档构建校验;固件完整适配待完成 | 项目维护 |
| 2026-09-07 | 正式开放 V1.0 | 取消结束确认指令;停止直接释放端口,允许复用编号,工具逐次保存结算消息 | 开放 | NCS10-A、MQTT工具 | 须同步升级;停止后不再提供历史账单补查 | 主机回归通过,待实机停止联调 | 项目维护 |
| 2026-09-07 | 正式开放 V1.0 文档设计 | 开启新增可选 R 费率组、S 自停组;省略时固定有效默认值;重复请求比较完整订单参数;成功及端口查询回显实际参数 | 开放 | NCS10-A 接入设计 | 扩展成功响应及有订单查询增加尾部,旧解析器须配套修改;不能把旧固件视为已支持 | 仅 Markdown 设计检查,未修改固件、工具或文件系统实现 | 项目维护 |
| 2026-09-07 | 正式开放 V1.0 | 重新编号正式首版;原试验 V1.0 撤下,V1.1 仅存档;同订单开始不重复计费,增加 CHARGE-ACK 和结束待确认状态,工具先保存账单再确认 | 开放 | NCS10-A、本地 MQTT 工具 | 平台须配套结束确认,不兼容试验版自停确认和 V2 JSON 流程 | 主机验证,待刷机和断电联调 | 项目维护 |
| 2026-07-25 | v2.0.0-docs | 开放协议升至 V2.0:服务端计费重构(删除设备端费率/金额字段与 #RATE-* 指令)、报文 JSON 化、指令收敛为 12 个、新增订单护栏(maxEnergyWh/maxMinutes)与 quota 自停原因、ts 必填、心跳合并实时计量;V1.1 归档(未量产) | 开放 | NCS01-C 为首批实现产品;其余分层模板的 V1.1 open_adapter.lua 冻结为参考实现 | 不兼容:报文格式与计费模型全面重构 | 协议定稿评审通过;固件实现待启动(方案 E) | AI/待指定 |
| 2026-05-08 | v1.1.2-docs | 注册平台业务参数新增 testMode;#LOGIN-RETURN 完整下发新增第 12 字段;NCS02-C 开放协议 productCategory = 5 且 testMode = 1 时业务 MQTT 改为明文收发,普通模式继续使用 AES | 注册平台+开放 | NCS02-C | 部分兼容:旧完整业务参数需追加 testMode;testMode = 0 继续 AES | 已按 NCS02-C 代码对照;MQTTools 静态检查和实机联调通过 | AI/待指定 |
| 2026-04-28 | v1.1.1-docs | NCS20 纳入双协议支持矩阵;补充 Air8000T、20 路继电器、TM1650、RC522、10 颗 BL0939、掉电检测等硬件参数与外设能力文档 | 私有+开放 | NCS20 | 向后兼容,协议字段不变 | 初次下载测试完成,待外设逐项联调 | AI/待指定 |
| 2026-04-25 | v1.1.0-docs | 私有协议升至 V2.0.8、开放协议升至 V1.1;补齐设备生成 orderId、rateModelId 闭环、心跳/掉电摘要追加订单和费率模型、#7 迁移期尾部字段、#RATE_SET 活跃充电数、自停队列重试与恢复会话超时策略 | 私有+开放 | NCS01/NCS02/NCS06/NCS10/NCS12 | 尾部追加字段,向后兼容旧解析;旧版保留归档 | 实机测试完成,暂未发现问题;静态回归通过 | AI/待指定 |
| 2026-04-21 | v1.0.0-docs | 开放协议升至 V1.0,私有协议升至 V2.0.7;旧版全文归档;按 NCS 模板代码修正 #REGISTER、#RATE-*、私有 orderId、#1/#2/#7/#B/#REBOOT 字段 | 私有+开放 | NCS01/NCS02/NCS06/NCS10/NCS12 | 向后兼容,旧版保留归档 | 已完成代码对照,待联调验证 | AI/待指定 |
| 2026-04-21 | v1.0.0-code | 新增 core/proto_ops.lua,收敛开放/私有适配器的协议无关业务动作;同步 11 个 NCS 模板共享协议主干 | 私有+开放 | NCS01/NCS02/NCS06/NCS10/NCS12 | 向后兼容,报文格式保持当前代码行为 | 已完成静态同步检查,待设备验证 | AI/待指定 |
| 2026-04-20 | v0.5.0-docs | 新增协议同步自动化检查脚本,检测“改代码未改协议文档”场景 | 私有+开放 | NCS全系 | 向后兼容 | 已完成脚本落地+文档构建 | AI/待指定 |
| 2026-04-20 | v0.4.0-docs | 新增仓库级 PR 模板,固化代码/协议双向同步检查流程 | 私有+开放 | NCS全系 | 向后兼容 | 已完成模板落地+文档构建 | AI/待指定 |
| 2026-04-20 | v0.3.0-docs | 完整化指令索引,补充开放协议和私有高频指令映射 | 私有+开放 | NCS01/NCS02/NCS06/NCS10/NCS12 | 向后兼容 | 已完成文档核对+构建 | AI/待指定 |
| 2026-04-20 | v0.2.0-docs | 回填 NCS 协议支持矩阵,按主线代码确认双协议覆盖与待纳入项目 | 私有+开放 | NCS01/NCS02/NCS06/NCS10/NCS12/NCS20/NDSK | 向后兼容 | 已完成代码路径核验+文档构建 | AI/待指定 |
| 2026-04-20 | v0.1.0-docs | 初始化内部全量协议站点与协作文档 | 私有+开放 | NCS全系 | 向后兼容 | 已通过文档构建 | AI/待指定 |