慢充设备硬件接口电量收费支持说明

来自东骏科技波塞冬平台开发者文档
跳转至: 导航搜索

首先电量主板必须实现功能掩码的上报,功能掩码,模块在联网成功之后会向设备询问3次,每次间隔5s,只要有一次成功就会停止询问,并将掩码上报给服务器,如果获取掩码失败,服务器就会认为主板不支持掩码功能,如果服务端设置为电量主板但是没有获取到掩码则会认为设备故障。


具体文档:慢充设备通讯文档-硬件接口 4.22 读取设备功能掩码

主板设置

功能掩码设置

其中掩码和电量收费相关的bit位有:29-28、26-20、17-16。


首先29-28位:目前系统支持00、01两种主板,如果上报为01则系统认为是电量收费主板,00则为时间收费主板,所以电量收费主板的此字段必须配置为01

其中26-24位是主板支持的功率,这个和后面的页面和计算相关,也请按实际配置

其中23-20位是电量换算单位,服务端会根据此单位设置进行单位换算

其中17-16是电桩类型的说明,直流桩后期均需要上报电压等级,实时电压等参数,目前服务端尚未实现,功能将在上半年实现

充电命令下发

充电依然是通过命令 慢充设备通讯文档-硬件接口 4.2 用户付款成功,通知主设备(选择端口) 进行充电,只是TIME/POWER字段下发的是电量,单位为掩码设置的单位

充电结束上报

充电完成上报依然是通过 慢充设备通讯文档-硬件接口 4.5 提交充电结束状态 进行的,支持其中TIME/POWER上报的是剩余的充电电量,单位为掩码设置的单位

充电状态的查询

充电状态查询依然是通过 慢充设备通讯文档-硬件接口 4.6 查询端口当前的充电状态 进行的,其中TIME\POWE是当前剩余的充电电量,单位为掩码设置的单位

服务端设置

设置好掩码之后,服务端获取充电桩为电量计费,并检验相关参数正确之后,则业务上会按照电流进行计费,服务端相关设置请咨询凌志

读取设备功能掩码

功能掩码是为了解决平台日益增加的慢充主板种类(每种主板之间功能存在差异),使得服务器方便对于不同的主板的差别做出不同的处理,而设计的功能。主板必须实现功能掩码,以免出现不可知的问题,早期没有实现功能掩码上报的主板我们按照默认设置进行处理。

功能掩码是一个32bit的数字,其中每一个位或多个位对应一个存在差别(平台允许存在的差别)的功能硬件的实现方式。

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
2 预留 0
1 预留 0
0 预留 0


数据方向:模块->设备

命令:0x32

服务器请求命令帧:

NULL
1byte

NULL:固定值0x00

设备响应命令帧:

功能掩码
4-5byte

功能掩码:主板功能的相关设置信息