慢充设备通讯文档-硬件接口

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

描述

杭州东骏科技有限公司的通讯模块和自己研发的慢充的主板以及第三方主板之间串口通讯的定义。

名词定义

  1. 模块 指我们提供的通信模块。
  2. 设备 指调用“模块”的主机设备,一般指充电站、游戏机等自助设备。

通讯数据格式

模块采用UART串口协议与主机进行问答式串行通讯,波特率为9600,8位数据位,1位停止位,无校验位。

命令格式

SOP LEN CMD SESSION_ID DATA SUM

SOP:单字节字头。命令为EE,应答为66 。

LEN:单字节。从CMD到SUM的字节数(含CMD和SUM)

CMD:单字节,命令字节。

SESSION_ID:服务端回话编号,6个字节,用户服务端识别通讯会话。如果服务端发起的会话设备应答服务端需要带上服务端下发的会话ID。如果设备发起会话则会话ID为“000000”

DATA:数据字节,不定长。

SUM:单字节,LEN、CMD、SESSION_ID、DATA的异或值

业务接口

读取设备每个端口的状态

描述:服务器读取设备每个端口当前的状态。

数据方向:设备→模块

命令:0x01

服务器请求命令帧:

查询参数
1byte

查询参数:固定值0x00

示例(下面各服务器发起的SessionId均用"123456"举例):

EE 09 01 31 32 33 34 35 36 00 0F


设备响应命令帧:

PORT_NUM PORT1_STATUS PORT2_STATUS
1byte 1byte 1byte

PORT_NUM:端口数量

PORTx_STATUS:端口状态(0x01-端口空闲;0x02-端口正在使用;0x03-端口禁用;0x04-端口故障)

示例:

返回三个端口, 1端口空闲, 2端口忙, 3端口禁用

66 0C 01 31 32 33 34 35 36 03 01 02 03 09

设备只有一个端口, 1端口空闲

66 0A 01 31 32 33 34 35 36 01 01 0C

用户付款成功,通知主设备(选择端口)

描述:当用户付款以后,通知主设付款的信息。

数据方向:模块→设备

命令:0x02

服务器请求命令帧:

PORT 功率档位、电量选择 TIME/POWER
1byte 2byte 2byte

PORT:用户选择的充电端口号,0x02表示2号端口。

功率档位、电量选择:用户支付的选择的功率档位:0x00,表示不选择,充电站自动判断,0x01=时间计费第一档功率0x02=时间计费第二档功率,0x03=时间计费第三档功率,0x11

TIME/POWER:表示发送给机器当前端口要充电时间或者充电电量:1.如果是充电时间则以分钟为单位,如 0x0064表示100分钟。2.如果是充电电量则以0.01度(千瓦时)为单位,如0x0064表示100个单位=1度电量

示例:

启动1号端口, 自动档位, 运行10分钟

EE 0D 02 31 32 33 34 35 36 01 00 00 00 0A 03

启动2号端口, 自动档位, 运行360分钟

EE 0D 02 31 32 33 34 35 36 02 00 00 01 68 63


设备响应命令帧:

PORT RESULT
1byte 1byte

PORT: 用户选择的充电端口号,0x02表示2号端口。

RESULT: 0x01-成功,0x02-充电站故障,0x03-端口已经被使用

注意:当RESULT=0x02或0x03 的时候,系统会执行退款操作。

示例:

1号端口启动成功

66 0A 02 31 32 33 34 35 36 01 01 0F

2号端口正在使用, 启动失败

66 0A 02 31 32 33 34 35 36 02 03 0E

投币上报

描述:使用投币器方式充电后,设备上报投币相关的信息。

数据方向:设备→模块

命令:0x03

设备请求命令帧:

投币次数 充电端口
1byte 1byte

投币次数:单次充电投币的次数

充电端口:充电的端口


服务器响应命令帧:

RESULT
1byte

RESULT:0x01-表示服务端接收成功

刷卡上报(线下充值卡上报方式)

描述:使用刷卡方式充电后,设备上报刷卡相关信息。

数据方向:设备→模块

命令:0x04

设备请求命令帧:

money
1byte

money:刷卡金额,最小单位为角


服务器响应命令帧:

RESULT
1byte

RESULT:0x01表示服务端接收成功

提交充电结束状态

描述:当某个端口的电动车已经充电结束(不管是已经充满自动停止,或是用户手动拔掉电源),调用该接口通知服务器。注意:调用该接口以后,系统会在后台根据用户的充电实际情况(比如本来可以充电100分钟,用户只用了50分钟)做相应的退款(管理员可以设置到底是退款还是不退款)。调用了该接口,该次交易即已经结束,用户再插上线路,肯定是不能再充电的。

数据方向:设备→模块

命令:0x05

设备请求命令帧:

PORT TIME/POWER REASON 卡号 退费金额 卡类型
1byte 2byte 1byte 4byte 1byte 2byte

PORT:充电端口号,0x02表示2号端口。

TIME/POWER:用户剩余的充电时间或者剩余电量:1.如果是充电时间则以分钟为单位,如 0x0064表示100分钟。2.如果是充电电量则以0.01度(千瓦时)为单位,如0x0064表示100个单位=1度电量,以分钟0.01度。当该值为0xFFFF的时候,系统会全额退款,表示该次交易不成功(一般为设备损坏,或是用户无法正常充电)。

REASON:停止的原因:0x00-购买的充电时间、电量用完了,0x01-用户手动停止(拔插头,或是按了停止按钮), 0x02-充电满了,自动停止,
0x03-设备或是端口出现问题,被迫停止,0x04-因充电器功率超过充电站的单路最大输出功率,切断输出,0x05-刷卡退费结束,
0x06-开始充电未接充电器, 0x07-端口远程停止, 0x08: 烟雾报警停止(主板PCB- DC_Crg_10L_C4.0以上版本)

卡号:如果是刷卡充电则为刷卡卡号(卡号、退款金额、卡类型如果不用刷卡退费完成该三个字段不需要)

退费金额:需要退费的金额

卡类型:刷卡的卡类型

示例:

1号端口使用结束, 剩余0分钟, 停止原因是0x00时间用完, 扫码使用非刷卡

66 13 05 00 00 00 00 00 00 01 00 00 00 00 00 00 00 00 00 00 17

1号端口使用结束, 剩余9分钟, 停止原因是0x07被远程停止, 扫码使用非刷卡

66 13 05 00 00 00 00 00 00 01 00 09 07 00 00 00 00 00 00 00 19


服务器响应命令帧:

RESULT
1byte

RESULT:0x01表示服务器接收成功

示例:

使用完成的上报信息接收成功

EE 09 05 31 32 33 34 35 36 01 0A

查询端口当前的充电状态

描述:服务器会主动查询当前充电端口的充电状态。

数据方向:模块→设备

命令:0x06

服务器请求命令帧:

PORT
1byte

PORT:充电端口号,0x02表示2号端口。

示例:

查询1号端口的使用情况

EE 09 06 31 32 33 34 35 36 01 09


设备响应命令帧:

PORT TIME\POWE INSTANT POWER
1byte 2byte 2byte

PORT:端口号,0x03表示端口3

TIME\POWE:表示这一路充电端口的剩余充电时间或者充电电量:1.如果是充电时间则以分钟为单位,如 0x0064表示100分钟。2.如果是充电电量则以0.01度(千瓦时)为单位,如0x0064表示100个单位=1度电量,以分钟0.01度,0x00表示不在充电(包括空闲、故障)

INSTANT POWER:这一路当前充电的瞬时功率,单位为W。如0x0001表示0.1W(有掩码以掩码为准)。若没有该数据,请填写0xFFFF

示例:

1号端口剩余9分钟, 瞬时功率为33W(0x014A->330->33)

66 0D 06 31 32 33 34 35 36 01 00 09 01 4A 4F

1号端口未在使用或已使用完毕, 剩余时间0分钟, 瞬时功率0

66 0D 06 31 32 33 34 35 36 01 00 00 00 00 0D

查询消费总额数据

描述:服务器会去查询投币、刷卡的消费总额数据。

数据方向:模块→设备

命令:0x07

服务器请求命令帧:

参数
1byte

参数:固定值0x00


设备响应命令帧:

CARD_MONEY COIN_MONEY
2byte 2byte

CARD_MONEY:机器消费刷卡总金额(以角为单位),0x0001表示0.1元

COIN_MONEY:机器消费投币总金额(以元为单位),0x0001表示1元

IC卡、投币、最大功率设置

描述:用户在服务的设置IC卡一次刷卡的金额,不同投币金额的充电时长、充电电量,机器输出最大功率值,并发送给设备端。

数据方向:模块→设备

命令:0x08

服务器请求命令帧:

MAX_POWER IC_MONEY TIME1/POWER1 TIME2/POWER2 TIME3/POWER3
2byte 1byte 2byte 2byte 2byte

MAX_POWER:最大输出功率,以W(瓦)为单位。若该值为0xFFFF,表示不设置这个值

IC_MONEY:用户每次刷IC卡需要消耗的金额,单位为角。如0x01表示0.1元

TIME1/PWOER1:第一个币的充电时间(0-999分钟)或者充电电量(0-9.99度)

TIME2/POWER2:第二个币的充电时间(0-999分钟)或者充电电量(0-9.99度)

TIME3/POWER3:第三个币的充电时间(0-999分钟)或者充电电量(0-9.99度)

设备响应命令帧:

NULL
1byte

NULL:固定为0x01,表示成功

设置IC卡、投币器是否可用

描述:在服务端设置IC卡、投币器是否可用。

数据方向:模块→设备

命令:0x09

服务器请求命令帧:

COIN IC
1byte 1byte

COIN :投币器设置,0x00-不可用;0x01-可用。

IC:刷卡器设置,0x00-不可用;0x01-可用。

设备响应命令帧:

NULL
1byte

NULL :固定为0x01

锁定、解锁某一个端口

描述:当某一个端口外接插座损坏,可以通过后台锁定这个充电端口,不让客户使用。

数据方向:模块→设备

命令:0x0A

服务器请求命令帧:

PORT STATUS
1byte 1byte

PORT :端口号,如0x01

STATUS:表示指令,0x01-解锁(可用),0x00-锁定(不可用)

设备响应命令帧:

null
1byte

null:0x01设置成功

远程停止某个端口的充电

描述:服务器可以远程停止某个端口的充电。

数据方向:模块→设备

命令:0x0B

服务器请求命令帧:

PORT
1byte

PORT :端口号,如0x01,

示例:

停止1号端口

EE 09 0B 31 32 33 34 35 36 01 04

停止2号端口

EE 09 0B 31 32 33 34 35 36 02 07


设备响应命令帧:

PORT TIME/POWER
1byte 2byte

PORT :充电端口号,0x02表示2号端口。

TIME/POWER :用户剩余的充电时间或者充电电量,单位参考第4

示例:

1号端口停止成功, 还剩余10分钟未用

66 0B 0B 31 32 33 34 35 36 01 00 0A 0C

2号端口停止成功, 还剩余360分钟未用

66 0B 0B 31 32 33 34 35 36 02 01 68 6C

读取设备IC卡、投币、最大功率设置

描述:服务器读取设备的IC卡一次刷卡的金额,不同投币金额的充电时长、充电电量,机器输出最大功率值等设置值。

数据方向:设备→模块

命令:0x0C

服务器请求命令帧:

NULL
1byte

查询参数:固定值0x00


设备响应命令帧:

MAX_POWER IC_MONEY TIME1/POWER1 TIME2/POWER2 TIME3/POWER3
2byte 1byte 2byte 2byte 2byte

MAX_POWER:最大输出功率,以W(瓦)为单位。

IC_MONEY:用户每次刷IC卡需要消耗的金额,单位为角。如0x01表示0.1元

TIME1/POWER1:第一个币的充电时间(0-999分钟)或者充电电量(0-9.99度)

TIME2/POWER2:第二个币的充电时间(0-999分钟)或者充电电量(0-9.99度)

TIME3/POWER3:第三个币的充电时间(0-999分钟)或者充电电量(0-9.99度)

上传设备故障

描述:设备上传机器故障码给服务器。

数据方向:设备→模块

命令:0x0D

设备请求命令帧:

PORT ERROR_CODE
1byte 1byte

PORT:充电端口号,0x02表示2号端口。若错误的地方不包括端口号,则填写0xFF。0xff代表整机

ERROR_CODE:错误码,0x01-端口输出故障,0x02-机器整体充电功率过大,0x03-电源故障


服务器响应命令帧:

NULL
1byte

NULL :固定为0x01

关闭或者打开充电站充电

描述:模块向设备发送打开或者关闭充电指令。

数据方向:模块→设备

命令:0x0E

服务器请求命令帧:

null
1byte

null :0x01代表关闭充电,0x00代表打开充电


设备响应命令帧:

NULL
1byte

NULL :固定为0x01

刷卡向模块发送卡号和扣费金额

描述:设备向模块发送IC卡号和扣费金额。

数据方向:设备→模块

命令:0x11

服务器请求命令帧:

卡号 扣费金额 卡余额 卡类型 端口 状态
4byte 1byte 2byte 2byte 1byte 1byte

卡号 :如0x01 0x02 0x03 00x04

扣费金额:0x01,表示0.1元 ,0x00表示不扣费

卡里余额:2个字节,高位在前,最小单位0.1元,余额是未扣费或者退费之前的

卡类型:2个字节,高位在前

端口:1个字节,表示充电的端口

状态:0x01 扣款成功,0x02 扣款失败 余额不足,0x03 退费

充值指令:给卡充值+发送卡余额给后台数据同步

描述:设备向模块发送IC卡号、余额、充值指令。

数据方向:设备→模块

命令:0x12

服务器请求命令帧:

卡号 卡里余额 卡类型
4byte 2byte 2byte

卡号 :如0x01 0x02 0x03 0x04

卡里余额:0x0001,表示0.1元

卡类型:2个字节,高位在前

设备响应命令帧:

卡号 充值金额 卡类型
4byte 2byte 2byte

卡号 :如0x01 0x02 0x03 0x04

充值金额:2个字节,高位在前,最小单位0.1元,如没有充值,发送0x0000,充值金额不是卡里余额

卡类型:2个字节,高位在前

设备再回复数据:

命令:0x16,此应答需要可靠上报

卡号 充值完成余额 卡类型 充值结果
4byte 2byte 2byte 1byte

卡号:如0x01 0x02 0x03 0x04

充值完成余额:2个字节,高位在前,最小单位0.1元

卡类型:2个字节,高位在前

充值结果:0x01 充值成功 0x02 不成功

设置充电站充满自停、刷卡是否退费

描述:在服务端设置充电站是否充满自停、是否刷卡退费。

数据方向:模块→设备

命令:0x13

服务器请求命令帧:

充满自停 刷卡退费
1byte 1byte

充满自停:充满自停设置,0x00-充满不自停;0x01-充满自停。

刷卡退费:0x00-刷卡不退费,0x01-刷卡退费

设备响应命令帧:

NULL
1byte

NULL :固定为0x00

设置充电站3档计费功率、比例

描述:服务器设置充电站5档计费的充电电量功率和相应的比例

数据方向:设备→模块

命令:0x14

服务器请求命令帧:

第一档功率 对应比例 第二档功率 对应比例 第三档功率 对应比例 第四档功率 对应比例 第五档功率 对应比例
2byte 1byte 2byte 1byte 2byte 1byte 2byte 1byte 2byte 1byte

第一档功率:设置第一档的功率范围0-第一档功率

对应比例:电动车在此功率范围内充电时间对应机器设置时间的百分比,充电时间=设置时间*对应比例%

第二档功率:设置第二档的功率范围:第一档功率—第二档功率

对应比例:电动车在此功率范围内充电时间对应机器设置时间的百分比,充电时间=设置时间*对应比例%

第三档的功率:设置第三档的功率范围:第二档功率—第三档功率

电动车在此功率范围内充电时间对应机器设置时间的百分比, 充电时间=设置时间*对应比例%

...


设备响应命令帧:

设置结果
1byte

设置结果 :0x01-成功,0x00-失败(与主板要求的不符,比如功率超出了主板的最大功率,功率大小限制与主板要求不符等)

读取设备3档计费功率、比例

描述:读取设备3档计费功率、比例。

数据方向:设备→模块

命令:0x15

服务器请求命令帧:

NULL
1byte

NULL:固定值0x00


设备响应命令帧:

第一档功率 对应比例 第二档功率 对应比例 第三档功率 对应比例 第四档功率 对应比例 第五档功率 对应比例
2byte 1byte 2byte 1byte 2byte 1byte 2byte 1byte 2byte 1byte

第一档功率:设置第一档的功率范围0-第一档功率

对应比例:电动车在此功率范围内充电时间对应机器设置时间的百分比,充电时间=设置时间*对应比例%

第二档功率:设置第二档的功率范围:第一档功率—第二档功率

对应比例:电动车在此功率范围内充电时间对应机器设置时间的百分比,充电时间=设置时间*对应比例%

第三档的功率:设置第三档的功率范围:第二档功率—第三档功率

电动车在此功率范围内充电时间对应机器设置时间的百分比, 充电时间=设置时间*对应比例%

...

查询整机所有充电端口的充电状态

描述:服务器会主动查询当前充电端口的充电状态。

数据方向:模块->设备

命令:0x24

服务器请求命令帧:

NULL
1byte

NULL:固定值0x00

示例:

EE 09 24 31 32 33 34 35 36 00 2A


设备响应命令帧:

总电流 箱体温度 输出回路继电器状态 第一路充电功率 ... 第十路充电功率 第一路剩余时间 ... 第十路剩余时间
2byte 1byte 2byte 2byte ... 2byte 2byte ... 2byte

总电流:0.1A为单位,表示整机的充电电流

箱体温度:表示现在机箱的温度,如果没接传感器,则传回0xFF

输出回路继电器状态:Bit位 0000000001(表示第一路在充电)0表示无充电,1表示充电。

第一路充电功率:这一路当前充电的瞬时功率,单位为0.1W。如0x0001表示0.1W。

...

第十路充电功率:这一路当前充电的瞬时功率,单位为0.1W。如0x0001表示0.1W。

第一路充电剩余时间:表示这一路充电端口的剩余充电时间,无充电为0,0x0001表示1分钟

...

第十路充电剩余时间:表示这一路充电端口的剩余充电时间,无充电为0,0x0001表示1分钟

示例:

该接口必须把所有数据位都填充完毕

所有端口都未使用, 或采集数据均不支持

66 35 24 31 32 33 34 35 36 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 16

总电流100mA, 1号端口正在使用中, 第一路功率为32.8W(0x0148->328>32.8)

66 35 24 31 32 33 34 35 36 00 01 00 00 01 01 48 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 09 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 56

读取设备版本号

描述:请求设备的硬件版本号,注意硬件的设备版本号不能随便定义,必须和服务器端的人员确认。

数据方向:模块->设备

命令:0x25

服务器请求命令帧:

NULL
1byte

NULL:固定值0x00

设备响应命令帧:

版本号
2byte

版本号:主板的版本号

读取设备功能掩码

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

功能掩码是一个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

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

主板软件更新

描述:服务端下发了主板最新的软件,然后通过该指令升级主板程序

数据方向:模块->设备

命令:0x26

服务器请求命令帧:

NULL
1byte

NULL:固定值0x01

设备响应命令帧:

版本号 状态
2byte 1byte

版本号:主板的版本号

状态:0x01-主板进入升级模式,0x00主板进入升级模式错误

在线更新请参见 XModeom-1K主板升级方式

设置免费充电模式、音量调节

描述:在服务端设置免费充电模式、喇叭音量

数据方向:模块->设备

命令:0x27

服务器请求命令帧:

免费充电模式 喇叭音量
1byte 1byte

免费充电模式:0x00:免费模式关闭;0x01:免费充电模式打开

喇叭音量:喇叭音量调整 范围值0x01-0x08

设备响应命令帧:

状态
1byte

状态:成功0x01,失败0x00

下发广告页面变更

描述:在服务端下发设备广告页面变更请求

数据方向:模块->设备

命令:0x2B

服务器请求命令帧:

广告页面号 参数一 参数二
1byte 1byte 1byte

广告页面号:下发需要变更的广告页面号

参数一:页面的附带参数

参数二:页面的附带参数

示例:

下发变更页面1, 参数一为0x02, 参数二为0x03

EE 0B 2B 31 32 33 34 35 36 01 02 03 27


设备响应命令帧:

状态
1byte

状态:成功0x01,失败0x02,无此页面0x03,参数错误0x04

示例:

下发变更成功

66 09 2B 31 32 33 34 35 36 01 24

设置最低浮充功率、浮充时间

描述:在服务端设置电动车的最低浮充功率与浮充时间

数据方向:模块->设备

命令:0x28

服务器请求命令帧:

浮充功率 浮充时间
2byte 2byte

浮充功率:最低的浮充功率,单位依据功能掩码,没有功能掩码则0x0001=0.1W

浮充时间:到达最低浮充功率进行检测的时间:120秒-999秒, 0x0001=1秒

设备响应命令帧:

状态
1byte

状态:成功0x01,失败0x00

刷卡充电时间设置

描述:用户在每一次刷卡充电时长、充电电量

数据方向:模块->设备

命令:0x29

服务器请求命令帧:

第一次刷卡的充电时间/电量 第二次刷卡的充电时间/电量 第三次刷卡的充电时间/电量
2byte 2byte 2byte

第一次刷卡的充电时间/电量:第一次刷卡的充电时间或电量设置,单位按照功能掩码中充电时间和电量的单位,不存在功能掩码则时间为分钟,电量为0.01度

第二次刷卡的充电时间/电量:第二次刷卡的充电时间或电量设置,单位按照功能掩码中充电时间和电量的单位,不存在功能掩码则时间为分钟,电量为0.01度

第三次刷卡的充电时间/电量:第三次及以上刷卡的充电时间或电量设置,单位按照功能掩码中充电时间和电量的单位,不存在功能掩码则时间为分钟,电量为0.01度

设备响应命令帧:

状态
1byte

状态:成功0x01,失败0x00

读取设备刷卡充电时间、充电模式、语音音量、浮充功率、浮充时间

描述:读取相关参数

数据方向:模块->设备

命令:0x2A

服务器请求命令帧:

查询状态
1byte

查询状态:固定值,0x00

设备响应命令帧:

第一次刷卡的时间/电量 第二次刷卡的时间/电量 第三次刷卡的时间/电量 免费充电模式 语音音量 浮充功率 浮充时间
2byte 2byte 2byte 1byte 1byte 2byte 2byte

第一次刷卡的时间/电量:第一次刷卡的充电时间或电量设置,单位按照功能掩码中充电时间和电量的单位,不存在功能掩码则时间为分钟,电量为0.01度

第二次刷卡的充电时间/电量:第二次刷卡的充电时间或电量设置,单位按照功能掩码中充电时间和电量的单位,不存在功能掩码则时间为分钟,电量为0.01度

第三次刷卡的充电时间/电量:第三次及以上刷卡的充电时间或电量设置,单位按照功能掩码中充电时间和电量的单位,不存在功能掩码则时间为分钟,电量为0.01度

免费充电模式:0x00关闭,0x01打开

语音音量:范围是1—8;8最高

浮充功率:最低的浮充功率,单位依据功能掩码,没有功能掩码则0x0001=0.1W

浮充时间:到达最低浮充功率进行检测的时间:120秒-999秒, 0x0001=1秒

在线卡-刷卡上报卡号金额信息

描述:在线卡刷卡步骤1,用户刷卡,主板上报卡信息给服务端

数据方向:设备→模块

命令:0x22

服务器请求命令帧:

卡号 扣费金额 卡类型 预留额
4byte 1byte 2byte 1byte

卡号 :如0x01 0x02 0x03 00x04

扣费金额:0x01,表示0.1元 ,0x00表示不扣费

卡类型:目前支持在线卡的卡类型为0xAA33

预留:0x00

在线卡-下发服务端卡信息

描述:在线卡刷卡步骤2,服务器收到刷卡信息,下发卡的相关服务端信息给设备

数据方向:模块->设备

命令:0x23

服务器请求命令帧:

卡号 卡余额 卡类型 状态
4byte 2byte 2byte 1byte

卡号 :如0x01 0x02 0x03 00x04

扣费金额:0x01,表示0.1元 ,0x00表示不扣费

卡类型:目前支持在线卡的卡类型为0xAA33

状态:0x01 刷卡成功,0x02 刷卡失败 余额不足,0x03此卡为无效卡,0x04此卡已挂失


设备响应命令帧:

卡号 状态 扣费金额
4byte 1byte 1byte

卡号 :如0x01 0x02 0x03 00x04

状态:0x01-表示确认扣费,0x00-表示否认扣费

扣费金额:0x01,表示0.1元 ,0x00表示不扣费


之后,用户按键启动充电,设备会上报0x11指令,0x11上报的卡类型如果是在线卡,卡号用于生成的订单和刷卡信息对应