无会话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