无会话ID的慢充-系统接口
文档说明
该文档应该遵循慢充设备通讯文档-系统接口的接口,再此基础上进行补充。 该协议的功能掩码扩展
bit位 | 定义 | 默认值 |
31 | 保留位 | 0 |
30 | 1表示用户自己主板,0东骏合作主板 | 0 |
29 | 00:计时主板,01:计电量主板,10:支持计时也支持计电量主板,使用哪种计费方式由命令决定,11:查询计费主板,服务端通过接口获取主板运行时间或电量并直接确定开启还是关闭,模块定时查询服务端计算的主板运行状态 | 0 |
28 | 0 | |
27 | 0表示不支持动态二维码下发,1表示支持动态二维码下发 | 0 |
26 | 000:主板功率等级<=500W,001:主板功率等级500W-1000W(包含),010:主板功率等级1000W-2000W(包含),011:主板功率等级2000W-10KW,100:主板功率等级10kW-50kW,101:主板功率等级50kW-150kW,110:主板功率等级150kW-500kW,111:主板功率等级>500kW(建议2000W以上的主板功率计量为0.1kW) | 0 |
25 | 0 | |
24 | 0 | |
23 | 0、支持功率电流获取,1、不支持功率电流获取(如果不支持功率电流获取22、21、20设置无效) | 0 |
22 | 00、电量计费数值精度0.01千万时,01、电量计费数值精度0.1千瓦时,10、电量计费数值为1千瓦时,11、电量计费数值为瓦时 | 0 |
21 | 0 | |
20 | 0、功率计量单位0.1W,1、功率计量单位0.1kW | 0 |
19 | 0、刷卡数值“角”为单位,1、刷卡数值“元”为单位 | 0 |
18 | 0、计时以“分”为单位,1、计时以“秒”为单位 | 0 |
17 | 00:交流桩,01:低压直流桩,10:高压直流桩,11:交直流桩 | 0 |
16 | 0 | |
15 | 0、不支持整机开启关闭,1、支持整机开启关闭 | 0 |
14 | 0、支持投币器远程开关,1、不支持投币器远程开关 | 0 |
13 | 0、支持刷卡器远程开关,1、不支持刷卡器远程开关 | 0 |
12 | 0、不支持退币器,1、支持退币器 | 0 |
11 | 0、支持端口锁定功能,1、不支持端口锁定功能 | 0 |
10 | 0、支持分档计费功能,1、不支持分档计费功能 | 0 |
9 | 0、不支持烟感报警器,1、支持烟感报警器 | 0 |
8 | 00:不支持远程升级,01:支持远程升级方法一(Xmodeom-1k),10:支持远程升级方法二(暂时不支持) | 0 |
7 | 0 | |
6 | 0、支持剩余时间获取,1、不支持剩余时间获取(不支持剩余时间获取,上报的所有命令中剩余时间的值均无效) | 0 |
5 | 0、DCA命令可用,1、DCA命令不可用(不可用服务端应不查询DCA,同时界面上有关DCA的数据将无效) | 0 |
4 | 0表示5档电量计费比例按照10%计算,1表示5当电量计费比例按1%计算 | 0 |
3 | 0表示不支持音量调节,1表示支持音量调节 | 0 |
2 | 获取整机信息命令:000、不支持整机信息获取,001:支持固定10路电流获取(电川专用),010:支持不定路数电流获取(最多80路,慢充主板),011:汽车单多路充电桩信息获取(包括电力部分信息,5路以内) | 0 |
1 | 0 | |
0 | 0 |
扩展掩码1,如果主板不支持任何扩展掩码的功能,则掩码只需要普通掩码,如果需要支持扩展掩码的功能,则上报掩码为普通掩码+扩展掩码1,一共40位,服务端会根据掩码计算业务类型
bit位 | 定义 | 默认值 |
7 | 0表示不支持时间单位设置,1表示支持时间单位设置,当此掩码为1,普通掩码18位设置无效,而是时间单位以设置值为准 | 0 |
6 | 0表示不支持断电存储功能设置,1表示支持断电存储功能设置 | 0 |
5 | 0表示浮充功率以0.1W为单位,1表示浮充功率以W为单位 | 0 |
4 | 0表示浮充时间以秒为单位,1表示浮充时间以分钟为单位 | 0 |
3 | 0-不支持久恒当前电量获取,1-支持久恒当前电量获取 | 0 |
2 | 0-无此设置,1-使用久恒主板设置 | 0 |
1 | 00-使用RUN作为执行指令,01-使用RNK作为执行指令 | 0 |
0 | 0 |
业务接口
付款成功,通知充电
下发充电数据
服务端:
发送方 | 服务器 |
说明 | 支付完成后,启动设备,开始充电 |
开始标志 | 1byte,“_” |
报文长度 | 3byte,表示整个报文的总长度,ASCII数字表示 |
命令 | 3byte,RNK |
会话ID | 6byte,服务器生成 |
分隔符 | 1byte,“/” |
参数 |
端口号(2byte) 金额(5byte), 单位分 时间(5字节), 根据掩码为分钟 电量(5byte), 根据掩码为0.01度 |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
设备启动响应
发送方 | 通信模块 |
说明 | 响应服务端启动情况 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RS |
命令 | 3byte,RNK |
会话ID | 6byte,服务器生成 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 端口(#/#分割)
结果(0x01-成功,0x0B-充电站故障,0x0C-端口已被使用) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
提交充电结束状态
发送方 | 通信模块 |
说明 | 设备充电完成后,上报服务端 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RP |
命令 | 3byte,UTP |
会话ID | 6byte,A80019 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 充电端口#/#
充电剩余时间以分钟为单位(0xFFFF表示全部退款,此次交易不成功) #/# 充电电量(0.01度为单位) #/# 停止原因(0x00-购买的时间或电量已经用完了,0x01-用户手动停止,0x02-充电满了,自动停止,0x03-超功率自停,0x04-远程断电,0x0B-设备或端口出现问题,被迫停止) #/# 重传序号(通讯模块生成,该参数是后面DLB命令的参数,获取到充电完成就必须要发送DLB回应设备已经接收到,如果不回应,设备为了保证服务端收到该条消息会每隔一分钟重新发送) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
删除重传队列
发送方 | 服务器 |
说明 | 服务端收到设备充电完成上报后,回应设备让设备删除重传列表中的该条数据。 |
开始标志 | 1byte,“_” |
报文长度 | 3byte,表示整个报文的总长度,ASCII数字表示 |
命令 | 3byte,DLB |
会话ID | 6byte,服务器生成 |
分隔符 | 1byte,“/” |
参数 | 重传序号(通讯模块生成) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
示例:
_ 018 DLB 123456 / 56 <0x0D> <0x0A>
宝佳主板型提交充电结束状态
发送方 | 通信模块 |
说明 | 设备充电完成后,上报服务端 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RP |
命令 | 3byte,UTQ |
会话ID | 6byte,A80027 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 充电端口#/#
退费金额(正常结束为0, 表示无需退款), 单位角 #/# 充电剩余时间(0xFFFF表示全部退款), 单位分钟 #/# 充电电量, 单位0.01度 #/# 停止原因(0x00-购买的时间或电量已经用完了,0x01-用户手动停止,0x02-充电满了,自动停止,0x03-超功率自停,0x04-远程断电,0x0B-设备或端口出现问题,被迫停止) #/# 重传序号(通讯模块生成,该参数是后面DLB命令的参数,获取到充电完成就必须要发送DLB回应设备已经接收到,如果不回应,设备为了保证服务端收到该条消息会每隔一分钟重新发送) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
删除重传队列
发送方 | 服务器 |
说明 | 服务端收到设备充电完成上报后,回应设备让设备删除重传列表中的该条数据。 |
开始标志 | 1byte,“_” |
报文长度 | 3byte,表示整个报文的总长度,ASCII数字表示 |
命令 | 3byte,DLB |
会话ID | 6byte,服务器生成 |
分隔符 | 1byte,“/” |
参数 | 重传序号(通讯模块生成) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
示例:
_ 018 DLB 123456 / 56 <0x0D> <0x0A>
配置久恒主板参数
下发久恒主板参数
发送方 | 服务器 |
说明 | 设置设备的参数 |
开始标志 | 1byte,“_” |
报文长度 | 3byte,表示整个报文的总长度,ASCII数字表示 |
命令 | 3byte,DJH |
会话ID | 6byte,服务器生成 |
分隔符 | 1byte,“/” |
参数 | 设置投币充电时间(5byte)
设置刷卡充电时间(5byte) 设置单次投币最大用电量,0.1度(3byte) 设置单次刷卡最大用电量,单位0.1度(3byte) 设置刷卡扣费金额,0.1元(3byte) 设置第一档最大充电功率,单位为瓦(5byte) 设置第二档最大充电功率,单位为瓦(5byte) 设置第三档最大充电功率,单位为瓦(5byte) 设置第四档最大充电功率,单位为瓦(5byte) 设置第二档充电百分比(3byte) 设置第三档充电百分比(3byte) 设置第四档充电百分比(3byte) 是否支余额回收(1-支持,0-不支持) 是否支持断电自停(1-支持,0-不支持) 设置充电器最大浮充功率(3byte) 设置浮充时间(3byte) 是否初始显示电量(1-屏幕显示剩余电量,0-表示初始时间,0xFF表示不支持) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
响应下发结果
发送方 | 通信模块 |
说明 | 返回服务端设置情况 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RS |
命令 | 3byte,DJH |
会话ID | 6byte,服务器生成 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 1byte 1-成功,0-失败 |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
读取久恒主板设置
发送方 | 服务器 |
说明 | 查询设备设置的参数 |
开始标志 | 1byte,“_” |
报文长度 | 3byte,表示整个报文的总长度,ASCII数字表示 |
命令 | 3byte,CJH |
会话ID | 6byte,服务器生成 |
分隔符 | 1byte,“/” |
参数 | |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
响应久恒主板设置
发送方 | 通讯模块 |
说明 | 返回服务端设置情况 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RS |
命令 | 3byte,CJH |
会话ID | 6byte,服务器生成 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 设置投币充电时间 #/#
设置刷卡充电时间 #/# 设置单次投币最大用电量,0.1度 #/# 设置单次刷卡最大用电量,单位0.1度 #/# 设置刷卡扣费金额,0.1元 #/# 设置第一档最大充电功率,单位为瓦 #/# 设置第二档最大充电功率,单位为瓦 #/# 设置第三档最大充电功率,单位为瓦 #/# 设置第四档最大充电功率,单位为瓦 #/# 设置第二档充电百分比 #/# 设置第三档充电百分比 #/# 设置第四档充电百分比 #/# 是否支余额回收(1-支持,0-不支持) #/# 是否支持断电自停(1-支持,0-不支持) #/# 设置充电器最大浮充功率 #/# 设置浮充时间 #/# 是否初始显示电量(1-屏幕显示剩余电量,0-表示初始时间,0xFF表示不支持) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
整机状态上报
发送方 | 通信模块 |
说明 | 应答查询整机充电状态 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RP |
命令 | 3byte,CKS |
会话ID | 6byte,A80021 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 端口号 - 端口状态(0x01-空闲,0x02-使用,0x03-禁用,0x04-故障) - 剩余时间 - 实时功率 - 剩余电量 (每个端口以#/#分割) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
线上卡刷卡
刷卡上报
发送方 | 通信模块 |
说明 | 在线卡刷卡上报平台, 此接口业务对应有刷卡启动/查询余额/结束使用/刷卡退费,
除了查询余额, 其他流程在上报刷卡(FE)后必须要再次上报刷卡完成(FF类型,金额0)或退费(FF类型,金额可全部和部分)来实现流程闭环, 平台处理后会用SKB接口回复主板 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RP |
命令 | 3byte,SKD |
会话ID | 6byte,A80025 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 卡号, 十进制数值字符串(#/#分割)
刷卡金额, 单位角(#/#分割) 卡类型: 0-离线卡, 1-在线卡(#/#分割) 业务类型: "FE"表示扣费, "FF"表示退费(准确的退款金额)或使用结束(金额必须为0), "EE"表示查余额(金额必须为0) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
示例:
刷卡启动: _ RP SKC A80025 024 1234567890#/#10#/#1#/#FE \r\n
正常充电结束: _ RP SKC A80025 023 1234567890#/#0#/#1#/#FF \r\n
查余额: _ RP SKC A80025 023 1234567890#/#0#/#1#/#EE \r\n
下发服务端卡信息
发送方 | 服务器 |
说明 | 服务器下发在线卡鉴权结果 |
开始标志 | 1byte,“_” |
报文长度 | 3byte,表示整个报文的总长度,ASCII数字表示 |
命令 | 3byte,SKB |
会话ID | 6byte,服务器下发 |
分隔符 | 1byte,“/” |
参数 | 卡号:10byte
卡余额:5byte 卡类型:5byte 状态:1byte,1-刷卡成功,2-刷卡失败 余额不足,3-此卡为无效卡,4-此卡已挂失,5-退费成功, 6-查询余额 |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
示例:
_ 037 SKB 123456 / 5827364923 00100 43571 1 0x0D 0x0A
上报刷卡结果
发送方 | 通信模块 |
说明 | 上报刷卡结果 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RS |
命令 | 3byte,SKB |
会话ID | 6byte,服务器生成 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | S-成功,F-失败 |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
示例:
_ RS SKB 123456 001 S <0x0D> <0x0A>
注意:
用户在设备上真正按键才是启动充电,启动成功必须上报刷卡启动确认,用于生成的订单
久恒主板型刷卡/投币启动上报
发送方 | 通信模块 |
说明 | 只适用与久恒型主板(掩码38bit为1),线上/下刷卡或投币成功后, 上报启动信息 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RP |
命令 | 3byte,SKC |
会话ID | 6byte,A80022 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 启动充电的端口(#/#分割)
增加的充电时间,分钟(#/#分割) 增加的充电电量, 0.01度(#/#分割) 充电原因: 0-投币, 1-刷卡, 3-远程启动, 4-其他原因(#/#分割) 付费金额, 角 |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
示例:
_ RP SKC A80022 022 2 #/# 360 #/# 100 #/# 1 #/# 20 0x0D 0x0A
宝佳主板型刷卡启动上报
发送方 | 通信模块 |
说明 | 刷卡有效并选择端口启动成功后, 上报启动信息 |
开始标志 | 1byte,“_” |
响应类型 | 2byte,RP |
命令 | 3byte,SKE |
会话ID | 6byte,A80026 |
内容长度 | 3byte,表示内容长度,ASCII数字表示 |
内容 | 启动充电的端口(#/#分割)
卡号(#/#分割) 扣费金额, 角(#/#分割) 增加的充电时间,分钟(#/#分割) 增加的充电电量, 0.01度(#/#分割) 重传序号:DLB重传序号,服务端接收到该指令以后必须立刻返回DLB通知设备收到此条数据,否则设备会一直发送直到服务端确认收到。该序号在返回DLB通知的时候需要带回来的序号 |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
示例:
_ RP SKE A80026 035 2 #/# 1234567890 #/# 10 #/# 360 #/# 100 #/# 1 \r\n
删除重传队列-宝佳主板型刷卡启动上报
发送方 | 服务器 |
说明 | 服务端收到设备投币订单上报后,回应设备让设备删除重传列表中的该条数据。 |
开始标志 | 1byte,“_” |
报文长度 | 3byte,表示整个报文的总长度,ASCII数字表示 |
命令 | 3byte,DLB |
会话ID | 6byte,服务器生成 |
分隔符 | 1byte,“/” |
参数 | 重传序号(通讯模块生成) |
结束标志 | 2byte,\r\n(0x0D 0x0A) |
示例:
_ 017 DLB 123456 / 1 \r\n