Appearance
开放协议正式 V1.0 接入流程
以正式协议为准;试验版 V1.1 只存档,原试验版 V1.0 已撤下,V2 不继续采用。
- 使用注册平台下发的 MQTT 地址、凭据、上下行 Topic 和加密参数连接,订阅设备上行。监听不应受本地未完成订单限制。
- 发送
#DEVICE-QUERY获取实际端口数,再用#PORT-QUERY核验要操作的端口。NCS10-A 有十个端口。 - 对空闲端口发送
#CHARGE-START,可携带 R 费率编号、E 电费时段、F 服务费功率档,以及 S 配置参数。R、E、F 同时填写或同时省略,S 可独立省略;填写的参数须完整,省略时须有有效默认配置。成功响应回显实际参数,平台保存后核验。工具显示“已发送,等待设备回复”;收到结果 1 才显示设备已开启。超时查询原端口,保留原订单号。 - 同订单、同金额且费率/配置参数一致的重复请求只核验已开启。重试省略的参数沿用原订单值,不重新读取默认配置;任一显式参数冲突就拒绝。进行中订单不修改余额、费率或自停参数。默认配置修改只影响随后省略对应参数的新订单。
- 用户结束时发送
#CHARGE-STOP,自动结束时接收#AUTO-STOP。设备先断电并保留最终结果。 - 平台先可靠保存最终账单,再自动发送
#CHARGE-ACK。此时页面显示“已停止,等待确认”;收到确认结果 1 后显示可以新开订单。 - 断线重连后查询端口。状态 3 表示等待确认,读取并保存结果,再确认。保存失败、设备回复失败或超时必须显示具体状态,不假报成功。
正常用户停止不需要“强制结清”。确认前不能覆盖旧订单;确认后账单由平台保存,设备不保留历史订单。平台生成新订单号,不复用已确认旧号。
本次 R/E/F 费率、S 配置参数及费率查询/设置新格式和实际参数回显已实现到 NCS10-A 源码 000.000.012 和本地 MQTT 工具;设备需刷入新固件后才能测试扩展报文。
本地 MQTT 工具用于联调;账单保存位置和验证结果见仓库本次验证记录。设备端固定文件容量方案尚不能由这次协议更新代替验证。