云桩通

Appearance

云快充协议 ​

云快充1.6协议 ​

报文帧格式定义 ​

应用层数据结构 ​

字段数据类型长度(Byte)备注
起始标志BIN1固定为 0x68
数据长度BIN1数据域长度不超过200字节（含序列号域、加密标志、帧类型标志、消息体）
序列号域BIN2数据包发送顺序号，从0递增；应答包序号与询问包一致
加密标志BIN10x00：不加密；0x01：3DES加密（仅消息体）
帧类型标志BIN1定义上下行数据帧类型
消息体-N数据单元内容
帧校验域BIN2CRC16校验（从序列号域到数据域），低字节在前，多项式 0x180D

数据格式定义 ​

  • 数据格式类型：
    • BCD码：十进制数编码（如卡号）
    • BIN码：二进制码，低位在前高位在后
    • ASCII码：字符编码（如VIN码）
  • 小数值处理：
    实际值 = 传输值 × 倍率（保留小数点位数）
    示例：电压值 225.1（保留1位小数） → 传输值 2251（即 0x8CB）
  • CP56Time2a时间格式（7字节）：
    字节位置内容说明
    1-2毫秒 (D0-D15)低字节在前
    3IV(D7)+分钟(D0-D5)IV：无效位；分钟：0-59
    4SU(D7)+小时(D0-D4)SU：夏令时；小时：0-23
    5星期(D0-D2)+日(D0-D4)星期：1-7；日：1-31
    6RES3+月(D0-D3)RES3：预留；月：1-12
    7RES4+年(D0-D6)RES4：预留；年：0-127（偏移2000年）

名词解释 ​

  • 充电卡：
    • 物理卡号：读卡器读取的卡号（储存在第0扇区0块），用于桩与服务器交互
    • 逻辑卡号：卡面印刷的卡号，用于桩屏幕显示
  • 交易流水号：
    一次充电的唯一标识（平台生成，离线模式由桩生成）
    格式：桩号(7B) + 枪号(1B) + 年月日时分秒(6B) + 自增序号(2B)
    示例：32010600019236012001061803423060
  • 计损比例：
    非零时，充电量需按比例上送（如计损电量 = 电量 × (1 + 计损比例)）
  • 桩编号：
    平台生成的7字节编码（示例：3201060001923601）
  • 枪号：
    由桩编号（7字节） + 枪号（1字节）组成（示例：3201060001923601 / 3201060001923602）

注册心跳帧类型码数据定义 ​

0x01 充电桩登录认证 ​

参数类型长度(Byte)备注
桩编码BCD码7不足7位补0
桩类型BIN码10：直流桩；1：交流桩
充电枪数量BIN码1
通信协议版本BIN码1版本号×10（如v1.0为0x0A）
程序版本ASCII8不足8位补零（如v4.1.50）
网络链接类型BIN码10x00：SIM卡；0x01：LAN等
Sim卡BCD码10不足10位补零
运营商BIN码10x00：移动；0x02：电信等

功能：充电桩每次复位或通信离线后需重新登录
样例报文：
68 0D 0000 00 01 3201020 00 02 0A 76342E312E353000 01 01010101010101010101 04 675A

0x02 登录认证应答 ​

参数类型长度(Byte)备注
桩编码BCD码7不足7位补0
登陆结果BIN码10x00：成功；0x01：失败

功能：回复电桩登陆结果
样例报文：
68 0C 0000 00 02 55031412782305 00 DA4C

0x03 充电桩心跳包 ​

参数类型长度(Byte)备注
桩编码BCD码7不足7位补0
枪号BCD码1
枪状态BIN码10x00：正常；0x01：故障

功能：10秒周期上送，用于链路状态判断（3次未收到视为网络异常）
样例报文：
68 0D 0001 00 03 32010200000001 01 00 6890

0x04 心跳包应答 ​

参数类型长度(Byte)备注
桩编码BCD码7不足7位补0
枪号BCD码1
心跳应答BIN码1固定置0

功能：用于链路状态判断
样例报文：
68 0D 3600 00 04 55031412782305 01 00 65B2

0x05 计费模型验证请求 ​

参数类型长度(Byte)备注
桩编号BCD码7不足7位补0
计费模型编号BCD码2首次连接时置零

功能：充电桩登陆成功后需校验当前计费模型
样例报文：
68 0D 0002 00 05 32010200000001 0001 9C00

0x06 计费模型验证请求应答 ​

参数类型长度(Byte)备注
桩编号BCD码7不足7位补0
计费模型编号BCD码2
验证结果BIN码10x00：一致；0x01：不一致

功能：平台判断计费模型是否最新
样例报文：
68 0E CE04 00 06 55031412782305 0000 00 8E2F

0x09 充电桩计费模型请求 ​

参数类型长度(Byte)备注
桩编号BCD码7不足7位补0

功能：计费模型不一致时主动请求（失败则禁止充电）
样例报文：
68 0B 0200 00 09 55031412782305 DD25

0x0A 计费模型请求应答 ​

参数类型长度(Byte)备注
桩编号BCD码7不足7位补0
计费模型编号BCD码2
尖电费费率BIN码4精确到小数点后五位
尖服务费费率BIN码4精确到小数点后五位
峰电费费率BIN码4精确到小数点后五位
峰服务费费率BIN码4精确到小数点后五位
平电费费率BIN码4精确到小数点后五位
平服务费费率BIN码4精确到小数点后五位
谷电费费率BIN码4精确到小数点后五位
谷服务费费率BIN码4精确到小数点后五位
计损比例BIN码1
时段费率号（48个）BIN码48对应48个半小时时段

功能：下发计费模型（每半小时为一个费率段）
样例报文（部分）：
68 5E 0200 00 0A 55031412782305 0100 400D0300 9C400000 E0930400...

实时数据帧类型码数据定义 ​

0x12 读取实时监测数据 ​

参数类型长度(Byte)备注
桩编号BCD码7不足7位补0
枪号BCD码1

功能：运营平台主动请求实时数据
样例报文：
68 0C 0000 00 12 32010200000001 01 0069

0x13 上传实时监测数据 ​

参数类型长度(Byte)备注
桩编号BCD码7不足7位补0
枪号BCD码1
充电状态BIN码10x00：待机；0x01：充电中
故障状态BIN码10x00：正常；0x01：故障
是否插枪BIN码10x00：否；0x01：是（变位上送）
输出电压BIN码2精确到0.1V；待机置0
输出电流BIN码2精确到0.1A；待机置0
枪线温度BIN码1整形，偏移量-50℃；待机置0
枪线编码BIN码8无则置0
SOCBIN码1待机/交流桩置0
电池组最高温度BIN码1整形，偏移量-50℃；待机/交流桩置0
累计充电时间BIN码2单位：min；待机置0
剩余时间BIN码2单位：min；待机/交流桩置0
充电度数BIN码4精确到0.0001kWh；待机置0
计损充电度数BIN码4精确到0.0001kWh；待机置0
已充金额BIN码4精确到0.0001元；待机置0
硬件故障标志BIN码2Bit位表示故障类型（详见协议）

功能：周期/变位上送充电枪实时数据
传输间隔：待机5分钟/充电15秒

0x15 充电握手 ​

参数类型长度(Byte)备注
交易流水号BCD码16见名词解释
桩编号BCD码7不足7位补0
枪号BCD码1
BMS通信协议版本BIN码3
BMS电池类型BIN码1
BMS额定容量BIN码2单位：Ah
BMS额定总电压BIN码2单位：V
BMS电池生产商名称ASCII8
BMS电池组序号ASCII8
BMS生产日期（年/月/日）BIN码3
BMS充电次数BIN码3
BMS产权标识BIN码1

功能：GBT-27930充电握手阶段报文
样例报文：
68 4D 0015 00 15 320102000000011151116155535026...

0x17 参数配置 ​

参数类型长度(Byte)备注
交易流水号BCD码16
桩编号BCD码7
枪号BCD码1
BMS最高允许充电电压BIN码2单位：V
BMS最高允许充电电流BIN码2单位：A
BMS标称总能量BIN码2单位：kWh
BMS最高允许充电总电压BIN码2单位：V
BMS最高允许温度BIN码1单位：℃
BMS当前SOCBIN码2百分比
BMS当前电池电压BIN码2单位：V
BMS当前电池温度BIN码1单位：℃

功能：GBT-27930参数配置阶段报文

0x19 充电结束 ​

参数类型长度(Byte)备注
交易流水号BCD码16
桩编号BCD码7
枪号BCD码1
BMS中止SOCBIN码1百分比
BMS单体最低电压BIN码2单位：V
BMS单体最高电压BIN码2单位：V
BMS最低温度BIN码1单位：℃
BMS最高温度BIN码1单位：℃
累计充电时间BIN码2单位：min
输出能量BIN码2单位：kWh
充电机编号BIN码4

功能：GBT-27930充电结束阶段报文

0x1B 错误报文 ​

参数类型长度(Byte)备注
交易流水号BCD码16
桩编号BCD码7
枪号BCD码1
超时错误标志BIN码25包含12类超时错误（详见协议）
BMS其他错误BIN码6
充电机其他错误BIN码6

功能：GBT-27930充电错误报文

0x1D 充电阶段BMS中止 ​

参数类型长度(Byte)备注
交易流水号BCD码16
桩编号BCD码7
枪号BCD码1
BMS中止原因BIN码1编码见协议
BMS中止故障原因BIN码2编码见协议
BMS中止错误原因BIN码1编码见协议

功能：BMS主动中止充电报文

0x21 充电阶段充电机中止 ​

参数类型长度(Byte)备注
交易流水号BCD码16
桩编号BCD码7
枪号BCD码1
充电机中止原因BIN码1编码见协议
充电机中止故障原因BIN码2编码见协议
充电机中止错误原因BIN码1编码见协议

功能：充电机主动中止充电报文

0x23 充电过程BMS需求与充电机输出 ​

参数类型长度(Byte)备注
交易流水号BCD码16
桩编号BCD码7
枪号BCD码1
BMS电压需求BIN码2单位：V
BMS电流需求BIN码2单位：A
BMS充电模式BIN码10x01：恒压；0x02：恒流
BMS电压测量值BIN码2单位：V
BMS电流测量值BIN码2单位：A
BMS最高单体电压及组号BIN码2
BMS当前SOCBIN码1百分比
BMS估算剩余时间BIN码2单位：min
电桩电压输出值BIN码2单位：V
电桩电流输出值BIN码2单位：A
累计充电时间BIN码2单位：min

功能：周期上送BMS需求与充电机输出（15秒间隔）

0x25 充电过程BMS信息 ​

参数类型长度(Byte)备注
交易流水号BCD码16
桩编号BCD码7
枪号BCD码1
BMS最高单体电压编号BIN码1
BMS最高温度BIN码1单位：℃
最高温度检测点编号BIN码1
BMS最低温度BIN码1单位：℃
最低温度检测点编号BIN码1
电压异常标志BIN码2Bit位表示异常类型
SOC异常标志BIN码2Bit位表示异常类型
过流标志BIN码2Bit位表示异常类型
温度过高标志BIN码2Bit位表示异常类型
绝缘状态标志BIN码2Bit位表示异常类型
连接器状态标志BIN码2Bit位表示异常类型
充电禁止标志BIN码20x00：禁止；0x01：允许

功能：周期上送BMS信息（15秒间隔）

运营交互帧类型码数据定义 ​

0x31 充电桩主动申请启动充电（0x31） ​

参数类型长度(Byte)备注
桩编号BCD码7不足7位补0
枪号BCD码1
启动方式BIN码10x01：刷卡启动；0x02：账号启动（暂不支持）；0x03：VIN码启动
是否需要密码BIN码10x00：不需要；0x01：需要
账号/物理卡号BIN码8不足8位补零
输入密码BIN码1616位MD5加密（小写）
VIN码ASCII码17VIN码需反序上送

功能：用户通过账号密码或刷卡在充电桩操作请求充电
传输间隔：按需发送

0x32 运营平台确认启动充电（0x32） ​

参数类型长度(Byte)备注
交易流水号BCD码16见名词解释
桩编号BCD码7不足7位补0
枪号BCD码1
逻辑卡号BCD码8显示在屏幕上，不足8位补零
账户余额BIN码4保留两位小数
鉴权成功标志BIN码10x00：失败；0x01：成功
失败原因BCD码10x01：账户不存在；0x02：账户冻结；0x03：余额不足等

功能：启动充电鉴权结果
传输间隔：应答发送

0x34 运营平台远程控制启机（0x34） ​

参数类型长度(Byte)备注
交易流水号BCD码16见名词解释
桩编号BCD码7不足7位补0
枪号BCD码1
逻辑卡号BCD码8卡面印刷卡号，不足补零
物理卡号BIN码8桩与平台交互使用的物理卡号
账户余额BIN码4保留到小数点两位

功能：用户远程启动充电时发送
传输间隔：按需发送

0x33 远程启动充电命令回复（0x33） ​

参数类型长度(Byte)备注
交易流水号BCD码16
桩编号BCD码7不足7位补0
枪号BCD码1
启动结果BCD码10x00：失败；0x01：成功
失败原因BIN码10x01：设备编号不匹配；0x02：枪已在充电等

功能：回复远程启动结果
传输间隔：应答

0x36 运营平台远程停机（0x36） ​

参数类型长度(Byte)备注
桩编号BCD码7不足7位补0
枪号BCD码1

功能：用户通过远程停止充电时发送
传输间隔：按需发送

0x35 远程停机命令回复（0x35） ​

参数类型长度(Byte)备注
桩编号BCD码7
枪号BCD码1
停止结果BCD码10x00：失败；0x01：成功
失败原因BIN码10x00：无；0x01：设备编号错误等

功能：回复停机指令结果
传输间隔：应答

0x3B 交易记录（0x3B） ​

参数类型长度(Byte)备注
交易流水号BCD码16见名词解释
桩编号BCD码7不足7位补0
枪号BCD码1
开始时间BIN码7CP56Time2a格式
结束时间BIN码7CP56Time2a格式
尖单价BIN码4精确到小数点后五位（尖电费+尖服务费）
尖电量BIN码4精确到小数点后四位
............（完整参数见协议）
VIN码ASCII码17正序直接上传
启动方式BIN码10x01：APP启动；0x02：卡启动等
启动时间BIN码7CP56Time2a格式
停止原因BIN码1见附录充电停止原因代码表
物理卡号BIN码8

功能：充电结束后上送结算账单
传输间隔：主动上送（最多重试3次）

0x40 交易记录确认（0x40） ​

参数类型长度(Byte)备注
交易流水号BCD码16
确认结果BIN码10x00：上传成功；0x01：非法账单

功能：平台确认收到交易记录
传输间隔：应答发送

0x42 远程账户余额更新（0x42） ​

参数类型长度(Byte)备注
桩编号BCD码7
枪号BCD码1
物理卡号BIN码8不足8位补零
修改后账户金额BIN码4保留两位小数

功能：用户充值后更新桩端余额
传输间隔：按需发送

0x41 余额更新应答（0x41） ​

参数类型长度(Byte)备注
桩编号BCD码7
物理卡号BIN码8
修改结果BIN码10x00：修改成功；0x01：设备编号错误；0x02：卡号错误

功能：回复余额更新结果
传输间隔：应答

0x44 离线卡数据同步（0x44） ​

参数类型长度(Byte)备注
桩编号BCD码7
下发卡个数BIN码1最大15个
第1个卡逻辑卡号BCD码8离线卡逻辑卡号
第1个卡物理卡号BIN码8离线卡物理卡号
............（循环至第N个卡）

功能：平台同步离线卡数据至充电桩
传输间隔：按需下发

0x43 离线卡数据同步应答（0x43） ​

参数类型长度(Byte)备注
桩编号BCD码7
保存结果BIN码10x00：失败；0x01：成功
失败原因BIN码10x01：卡号格式错误；0x02：储存空间不足

功能：回复离线卡同步结果
传输间隔：应答

0x46 离线卡数据清除（0x46） ​

参数类型长度(Byte)备注
桩编号BCD码7
清除离线卡的个数BIN码1最大24个
第1个卡物理卡号BIN码8离线卡物理卡号
............（循环至第N个卡）

功能：平台清除桩端离线卡数据
传输间隔：按需下发

0x45 离线卡数据清除应答（0x45） ​

参数类型长度(Byte)备注
桩编号BCD码7
第1个卡物理卡号BIN码8
清除标记BIN码10x00：清除失败；0x01：清除成功
失败原因BCD码10x00：清除成功；0x01：卡号格式错误
............（循环至第N个卡）

功能：回复清除结果
传输间隔：应答

0x48 离线卡数据查询（0x48） ​

参数类型长度(Byte)备注
桩编号BCD码7
查询的离线卡个数BIN码1最大26个
第1个卡物理卡号BIN码8离线卡物理卡号
............（循环至第N个卡）

功能：平台查询桩端离线卡状态
传输间隔：按需下发

0x47 离线卡数据查询应答（0x47） ​

参数类型长度(Byte)备注
桩编号BCD码7
第1个卡物理卡号BIN码8
查询结果BIN码10x00：不存在；0x01：存在
............（循环至第N个卡）

功能：回复离线卡查询结果
传输间隔：应答

停止原因码表 ​

停止编码停止原因
0x40结束充电，手动停止充电
0x41结束充电，SOC 达到 100%
0x42结束充电，充电电量满足设定条件
0x43结束充电，充电金额满足设定条件
0x44结束充电，充电时间满足设定条件
0x45结束充电，车端正常主动停止
0x46结束充电，APP 远程停止
0x4A充电启动失败，充电桩控制系统故障(需要重启或自动恢复)
0x4B充电启动失败，控制导引断开
0x4C充电启动失败，断路器跳位
0x4D充电启动失败，电表通信中断
0x4E充电启动失败，余额不足
0x4F充电启动失败，充电模块故障
0x50充电启动失败，急停开入
0x51充电启动失败，防雷器异常
0x52充电启动失败，BMS 未就绪
0x53充电启动失败，温度异常
0x54充电启动失败，电池反接故障
0x55充电启动失败，电子锁异常
0x56充电启动失败，合闸失败
0x57充电启动失败，绝缘异常
0x58充电启动失败，枪故障
0x59充电启动失败，接收 BMS 握手报文 BH 超时
0x5A充电启动失败，接收 BMS 和车辆的辨识报文超时 BRM
0x5B充电启动失败，接收电池充电参数报文超时 BCP
0x5C充电启动失败，接收 BMS 完成充电准备报文超时 BRO AA
0x5D充电启动失败，接收电池充电总状态报文超时 BCS
0x5E充电启动失败，接收电池充电要求报文超时 BCI.
0x5F充电启动失败，接收电池状态信息报文超时 BSM
0x60充电启动失败，GB2015 电池在 BHM 阶段有电压不允许充电
0x61充电启动失败，GB2015 辨识阶段在 BRO_AA 时候电池实际电压与 BCP 报文电池电压差距大于 5%
0x62充电启动失败，B2015 充电机在预充电阶段从 BRO_AA 变成BRO_00 状态
0x63充电启动失败，接收主机配置报文超时
0x64充电启动失败，充电机未准备就绪,我们没有回 CRO AA，对应老国标
0x65充电启动失败，车端启动异常
0x66充电启动失败，计费模型异常
0x6A充电异常中止，系统闭锁
0x6B充电异常中止，导引断开
0x6C充电异常中止，断路器跳位
0x6D充电异常中止，电表通信中断
0x6E充电异常中止，余额不足
0x6F充电异常中止，交流保护动作
0x70充电异常中止，直流保护动作
0x71充电异常中止，充电模块故障
0x72充电异常中止，急停开入
0x73充电异常中止，防雷器异常
0x74充电异常中止，温度异常
0x75充电异常中止，输出异常
0x76充电异常中止，充电无流
0x77充电异常中止，电子锁异常
0x78预留
0x79充电异常中止，总充电电压异常
0x7A充电异常中止，总充电电流异常
0x7B充电异常中止，单体充电电压异常
0x7C充电异常中止，电池组过温
0x7D充电异常中止，最高单体充电电压异常
0x7E充电异常中止，最高电池组过温
0x7F充电异常中止，BMV 单体充电电压异常
0x80充电异常中止，BMT 电池组过温
0x81充电异常中止，电池状态异常停止充电
0x83充电异常中止，充电桩断电
0x84充电异常中止，接收电池充电总状态报文超时
0x85充电异常中止，接收电池充电要求报文超时
0x86充电异常中止，接收电池状态信息报文超时
0x8A充电异常中止，设备故障
0x8B充电异常中止，其他传感器检测异常
0x8C充电异常中止，主柜故障
0x8D充电异常中止，枪故障
0x8E充电异常中止，充电数据异常停止
0x90未知原因停止