帧格式与指令总表
这是 CoreCharge 共享充电宝机柜协议 v1.51（2025-07-30） 的公开对接合同。文档公开了实现兼容设备端或服务端所需的指令语法和字段语义。示例全部使用合成数据；生产连接账号应通过授权的对接渠道获取。
报文语法
{COMMAND,field1,field2,...,fieldN,CRC}
| 规则 | 要求 |
|---|---|
| 编码 | ASCII |
| 分隔符 | 英文逗号 , |
| 起止字符 | 固定为 { 和 } |
| 指令大小写 | 大写 ASCII |
| 字段顺序 | 位置固定，由具体指令定义 |
| CRC | 4 位大写十六进制字符 |
| 密钥 | 只参与 CRC 计算，不作为帧字段发送 |
除非具体指令明确允许，否则不要删除字段内空格、改变大小写、调整字段顺序，或把空字段改成 NULL。应先识别完整帧边界，再按逗号拆分。
通用标识符
| 字段 | 要求 |
|---|---|
| 消息 ID | 单调递增，建议使用 Unix 时间戳。部分设备会丢弃小于或等于最近已接受 ID 的指令；重连后设备侧比较窗口复位。 |
| 设备 ID | 不超过 20 字节。 |
| 订单 ID | 由服务端生成，不超过 32 个字符。幂等重试必须复用相同订单 ID。 |
| 充电宝 ID | 跨固件基线建议不超过 15 个字符。部分 NI 配置支持 16 个字符，使用 16 位前必须确认设备配置。 |
| 槽位 ID | 从 1 开始；最大值由机柜拓扑决定。0 在不同指令中分别表示全部或自动选择。 |
完整指令总表
| 指令 | 主要方向 | 用途 | 详细说明 |
|---|---|---|---|
CN | 设备 -> 服务端 | 身份与上线 | 身份与库存 |
CS | 服务端 -> 设备 | 网络与整机配置 | 身份与库存 |
GN | 服务端 -> 设备 | 网络状态查询 | 身份与库存 |
DS | 设备 -> 服务端 | 整机配置上报 | 身份与库存 |
AC | 设备 -> 服务端 | 全槽位库存上报 | 身份与库存 |
CQ | 双向 | 单槽位上报或槽位查询 | 身份与库存 |
AE | 设备 -> 服务端 | 槽位及电池健康扩展信息 | 身份与库存 |
CM | 双向 | 借还规则配置 | 身份与库存 |
CC | 服务端 -> 设备 | 当前可借数量 | 身份与库存 |
BW | 服务端 -> 设备 | 准备普通/指定类型租借 | 租借与归还 |
KW | 服务端 -> 设备 | 准备快充租借 | 租借与归还 |
FB | 服务端 -> 设备 | 弹出指定或已准备的充电宝 | 租借与归还 |
BR | 服务端 -> 设备 | 确认租借准备/弹出结果 | 租借与归还 |
RS | 设备 -> 服务端 | 成功/离线归还上报 | 租借与归还 |
FR | 设备 -> 服务端 | 异常归还上报 | 租借与归还 |
FA | 服务端 -> 设备 | 维护弹出，不允许放电 | 设备管理 |
FL | 服务端 -> 设备 | 启用/禁用槽位 | 设备管理 |
OT | 服务端 -> 设备 | 固件升级控制 | 设备管理 |
SQ | 服务端 -> 设备 | 叠加子板查询 | 设备管理 |
NI | 服务端 -> 设备 | 重写充电宝 ID | 设备管理 |
KU | 设备 -> 服务端 | 物理按键事件 | 设备管理 |
对接下载
指令目录 JSON 适合直接导入测试工具，读取指令名、方向、字段顺序和结果枚举；涉及固件差异和业务时序时，以本网站的说明页为准。