开放协议接入流程

适用版本：开放协议 V1.1

1 参数准备

接入开放协议前，注册平台需要为设备准备以下业务参数：

• 业务 MQTT 服务器地址和端口。
• 业务 MQTT 用户名和密码。
• 设备上行 Topic 和平台下行 Topic。
• productCategory = 5。
• 商户编号、充电桩编号和 16 字节业务密钥来源。
• testMode：0 为普通 AES 业务链路；1 为开放协议测试模式，业务链路明文传输。

2 注册与协议选择

1. 设备连接注册平台。
2. 设备发送 #LOGIN,0,PROJECT,VERSION,IMEI,IMSI,ICCID,PROJECT_SUB。
3. 注册平台返回注册状态。
4. 注册平台通过 #LOGIN-RETURN 下发业务 MQTT 参数，完整字段必须包含 testMode。
5. 设备保存参数并连接业务 MQTT。
6. 当 productCategory = 5 时，设备启用开放协议适配器；当 testMode = 1 时，开放协议业务链路使用明文收发。

3 业务上线

1. 设备在业务 MQTT 就绪后发送 #REGISTER。
2. 设备空闲时每 4 分钟发送 #HEARTBEAT，充电中按 1 分钟调度；MQTT 重连后会立即发送一次心跳。
3. 平台可用 #DEVICE-QUERY 查询端口状态和计费模型，也可从 #HEARTBEAT 端口数据组尾部读取 orderId。
4. 平台可用 #RATE-QUERY/#RATE-SET 同步计费模型。
5. 平台可用 #PARAM-QUERY/#PARAM-SET 查询或设置工作参数。

4 充电流程

1. 平台发送 #CHARGE-START,idx,chn,orderId,amount。
2. 设备返回 #CHARGE-START,idx,chn,orderId,result。
3. 充电过程中平台可用 #PORT-QUERY 查询订单和费用。
4. 平台主动结束时发送 #CHARGE-STOP,idx,chn,orderId。
5. 设备自停时主动上报 #AUTO-STOP，平台返回确认报文。

5 联调验收建议

• 覆盖注册平台 #LOGIN/#LOGIN-RETURN，确认 productCategory = 5 和 testMode 生效。
• 覆盖 testMode = 0 的 AES 收发和 testMode = 1 的明文收发。
• 覆盖业务 #REGISTER/#HEARTBEAT。
• 覆盖 #CHARGE-START 成功、金额无效、端口忙、orderId 无效场景。
• 覆盖 #CHARGE-STOP 成功和 orderId 不匹配场景。
• 覆盖 #RATE-SET/#RATE-QUERY 和 #PARAM-SET/#PARAM-QUERY。
• 覆盖自停上报和平台确认。
• 覆盖 MQTT 重连后的注册、立即心跳和自停补发。