文档首页

智能充电桩系列解决方案

前言

针对厂商设备主板与乐摇摇串口联网模组对接,平台提供标准串口数据通讯协议、自动生成参数界面、串口调试工具,简化开发过程,使设备快速联网获得增值功能。本文档基于乐摇摇串口联网模组与设备主板的标准对接流程编写。

协议文档

下载乐摇摇充电桩串口通信协议

下载主板协议对接操作指南

集成芯片对接参考设计资料

若选择串口集成芯片对接方案,请下载相应参考资料

2G&WIFI-集成对接硬件设计资料

4G-集成对接硬件设计资料

SDK

下载串口与函数SDK

串口调测功工具

下载乐摇摇串口调试助手

准备工作

对接前,需要先获取乐摇摇联网芯片或模组,以便后续开发测试。

开发流程

如果您是首次接入乐摇摇联网方案,请按以下流程进行对接。下文将针对各个步骤进行详细描述。

4e21b2376bae43c5a1095d0a2fffb3db.jpg

对接流程 参考文档
1注册开发账号 查看流程文档
2创建产品 查看流程文档
3主板参数配置 查看流程文档
4硬件嵌入式开发 查看流程文档
5硬件联调 查看流程文档
6发布,体验功能 查看流程文档

协议基础

通信配置

通信接口: 串口(RS232)

波特率:9600

停止位:1位

数据位:8位

校验位:0位

数据类型

数据类型 描述
BYTE 无符号单字节整型(字节,8位)
WORD 无符号双字节整型(双字节,16位)
DWORD 无符号四字节整型(四字节,32位)
BYTE[n] N字节

传输规则

协议采用小端模式(little-endian)的网络字节序来传递字和双字。

约定如下:

——字节(BYTE)的传输约定:按照字节流的方式传输;

——字(WORD)的传输约定:先传递低八位,再传递高八位;

——双字(DWORD)的传输约定:先传递低八位,然后传递高八位,再传递高16位,

最后传递高24位。

通信机制

主机查询方式

主机按照一定的时间间隔向终端发送数据帧,终端接收到数据帧后返回应答帧,终端不主动上传数据,若主机在规定时间内未接受到规定的数据帧的应答数据帧,则重发数据帧直到终端返回应答数据帧。

正常通信时序:

654bb817a1334f979b0803416c5746f4.png

异常通信时序:

fe791bdf1ccf444cb996762c0b0a7109.png

终端上传数据帧方式

正常通信时序:

243d45a61d984d6d8545d7967edec4cf.png

异常通信时序:

5b599ca44f654b93bf138e7aef91cb30.png

数据帧格式

帧格式图

832df2472c87452e9d9c7323c3e3d341.png

格式说明

起始字节 名称 定义 数据类型 备注
0 Head(帧头) 固定为0xAA BYTE
1 Length(长度) Index + CMD +Data + Check 数据总长 BYTE
2 Index (索引) 主机:0x01 终端:0x02 BYTE 标识消息发出方 充电桩主板为02
3 CMD(命令) 表明数据帧的类型 BYTE
4 Data(数据) 数据区 BYTE[n] (n<200) 数据区长度可以为0
4+n Check(校验) 校验范围:Length+ Index+ CMD+ Data BYTE 异或校验
5+n End(帧尾) 固定为0xDD BYTE

功能与指令

设备登录

** 登录流程 **

支付盒子

8c5ecc5dbb6b4827ae244062c29cc1d7.png

指令说明——查询链接状态

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0B
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x01 查询链接状态
4 Data(数据) BYTE[8] 8位设备唯一码
12 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
13 End(帧尾) BYTE 0xDD

充电桩主板 -------------> 支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x05
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x01 查询链接状态
4 Data(数据) WORD 登录标识 小端模式传输 获取方式见登录标识
6 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
7 End(帧尾) BYTE 0xDD

登录标识

登录标识是乐摇摇支付盒子用以识别所对接设备主板身份的标识码,每个产品都有且只有一个(请把登录标识烧录到设备中。当设备激活时,会上报到云端鉴权认证设备参数)。

标识码获取流程:

(1)打开乐摇摇后台网站https://open.leyaoyao.com(推荐Chrome浏览器),输入账号密码并登录。若无账号,请先注册开发账号。

(2)登录成功后,即可进入开发者中心。

2ae47381cab54a0d995533d621d4b10b.png

(3)点击创建产品出现弹窗,请按要求完善产品信息。

908ecc04a2a04bfbaf540c0590791732.png

c4b5c8f5875c401785bada15fe4898b3.png

主板信息填写与要求:

1主板名称格式为厂家名称+设备类型,例如:乐摇摇娃娃机

2上传的主板原图与接线方式图片参照上方示例,特别注意拍摄清晰保证主板与支付盒子间的接口电路,以便工作人员审核

(4)主板信息提交成功后,乐摇摇硬件工作人员将在3个工作日内对其进行审核,审核结果会同步以短信形势发送到主板厂商预留的手机号码,请注意查收。

(5)待审核通过后,即可在该页面看到该主板对应登录标识。如未通过,请留意申请反馈并与乐摇摇硬件工作人员进一步沟通。

9531063777914040ae45e578c3601827.png

(6)注意:获取到的登录标识为十进制,通信数据中需转换为16进制,并令低位在前,高位在后,以小端模式传输。如:登录标识为150,则通信中实际需传输的登录标识数据为 0x96 0x00

线上支付启动充电桩

支付启动流程

1707f4d6dc2d4eb290237fea7448f77c.jpg

指令说明——获取通道状态

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x06
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表1 见表1
7 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
8 End(帧尾) BYTE 0xDD

1 获取通道状态指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 获取状态时固定为0x00
Data[1] 子命令 ——获取通道状态 BYTE 0x03
Data[2] 自增码 BYTE 达到上限0xFF后置0

充电桩主板 -------------> 支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 以实际情况为准
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表2 详见表2
4+N Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
5+N End(帧尾) BYTE 0xDD

2 获取通道状态应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 获取通道状态应答时建议固定为0x00
Data[1] 子命令 ——获取通道状态 BYTE 0x03
Data[2] 自增码 BYTE 达到上限0xFF后置0
Data[3] 通道数量 BYTE
Data[4-n] 通道状态 BYTE[n] 从通道1开始,每条通道状态标识占据1位,注意总数与通道数量保持一致 0x01:端口空闲; 0x02:端口正在使用; 0x03:端口故障。 0x04:已被停止使用

指令说明——启动申请

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0B
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表3 见表3
12 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
13 End(帧尾) BYTE 0xDD

表3启动申请指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 获取状态时固定为0x00
Data[1] 子命令 ——启动申请 BYTE 0x14
Data[2-7] 支付唯一码 BYTE[6]

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0C
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表4 详见表4
13 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
14 End(帧尾) BYTE 0xDD

表4启动申请应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 获取通道状态应答时建议固定为0x00
Data[1] 子命令 ——启动申请 BYTE 0x14
Data[2-7] 启动申请码 BYTE[6]
Data[8] 状态码 BYTE 0x00:正常 0x01:正在充电 0x02:其他故障

指令说明——扫码支付启动充电桩

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0D
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表5 见表5
14 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
15 End(帧尾) BYTE 0xDD

表5扫码支付启动充电桩指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 起始通道0x01
Data[1] 子命令 ——扫码支付启动 BYTE 0x01
Data[2-3] 充电时长 WORD 单位:分钟;小端模式传输
Data[4-9] 支付唯一码 BYTE[6]

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0C
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表6 详见表6
13 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
14 End(帧尾) BYTE 0xDD

表6扫码支付启动充电桩应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 起始通道0x01
Data[1] 子命令 ——扫码支付启动 BYTE 0x01
Data[2] 启动结果 BYTE 0x00:失败 0x01:成功
Data[3-8] 支付唯一码 BYTE[6]

指令说明——上报上分结果

**充电桩主板 ------------->**支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0D 以实际情况为准
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表7 详见表7
14 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
15 End(帧尾) BYTE 0xDD

表7上报上分结果指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 起始通道0x01
Data[1] 子命令 ——上报上分结果 BYTE 0x02
Data[2-3] 上分数量 WORD 0x0000表示上分失败;小端模式传输 应答盒子时不含此项
Data[4-9] 支付唯一码 BYTE[6] 应答盒子时不含此项

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0D
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表8 见表8
14 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
15 End(帧尾) BYTE 0xDD

表8上报上分结果应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 起始通道0x01
Data[1] 子命令 ——上报上分结果 BYTE 0x02
Data[2-3] 上分数量 WORD 小端模式传输
Data[4-9] 支付唯一码 BYTE[6]

关闭全体充电通道

指令说明——关闭全体充电通道

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x06
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表11 见表11
7 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
8 End(帧尾) BYTE 0xDD

表11关闭全体充电通道指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 非针对特定通道指令,填充0x00
Data[1] 子命令 ——关闭全体充电通道 BYTE 0x08
Data[2] 自增码 BYTE 达到上限0xFF后置0

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x1A
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表12 详见表12
27 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
28 End(帧尾) BYTE 0xDD

表12关闭全体充电通道应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 非针对特定通道指令,填充0x00
Data[1] 子命令 ——关闭全体充电通道 BYTE 0x08
Data[2] 自增码 BYTE 达到上限0xFF后置0
Data[3-4] 通道1剩余时间 WORD 单位:;小端模式传输
Data[5-6] 通道2剩余时间 WORD 单位:;小端模式传输
Data[7-8] 通道3剩余时间 WORD 单位:;小端模式传输
Data[9-10] 通道4剩余时间 WORD 单位:;小端模式传输
Data[11-12] 通道5剩余时间 WORD 单位:;小端模式传输
Data[13-14] 通道6剩余时间 WORD 单位:;小端模式传输
Data[15-16] 通道7剩余时间 WORD 单位:;小端模式传输
Data[17-18] 通道8剩余时间 WORD 单位:;小端模式传输
Data[19-20] 通道9剩余时间 WORD 单位:;小端模式传输
Data[21-22] 通道10剩余时间 WORD 单位:;小端模式传输

终端参数设置与查询

指令说明——查询终端参数

支付盒子 -------------> 售货机主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x03
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x05 查询终端参数
- Data(数据) - - 不含数据区
4 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
5 End(帧尾) BYTE 0xDD

售货机主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 以自定义情况为准
2 Index (索引) BYTE 0x02 标识售货机主板
3 CMD(命令) BYTE 0x05 查询终端参数
4 Data(数据) BYTE[n] 自定义参数项 自定义方法说明见自定义参数项
4+N Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
5+N End(帧尾) BYTE 0xDD

指令说明——设置终端参数

支付盒子 -------------> 售货机主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 以自定义情况为准
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x15 设置终端参数
4 Data(数据) BYTE[n] 自定义参数项 自定义方法说明见自定义参数项
4+N Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
5+N End(帧尾) BYTE 0xDD

售货机主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 视自定义情况
2 Index (索引) BYTE 0x02 标识售货机主板
3 CMD(命令) BYTE 0x15 设置终端参数
4 Data(数据) BYTE 参数设置结果 0x00:设置失败

0x01:设置成功 | | 5 | Check(校验) | BYTE | 异或校验码 | 校验范围:Length+ Index+ CMD+ Data | | 6 | End(帧尾) | BYTE | 0xDD | |

自定义终端参数项

(1)打开乐摇摇后台网站https://open.leyaoyao.com(推荐Chrome浏览器),输入账号密码并登录开发者中心。若无账号,请先注册开发账号。

(2)在智能化产品列表中,找到需要进行自定义参数项的主板,点击“编辑”。若找不到该主板,请参照登录标识中的说明,添加需要对接的主板。

9531063777914040ae45e578c3601827.png

(3)进入主板参数配置页面,参数配置由3部分组成,包括基础参数、终端参数、故障参数。参数配置是对产品功能的抽象表示,可以通过不同功能类型定义。目前平台提供:布尔型、数值型、枚举型、故障型这四种参数类型。详情设置说明见参数配置。

  1. 点击 “添加”,即可对参数进行配置。此处可根据厂商需求添加各项操作指令。
  2. 若选择终端参数操作不含参,则不含查询功能码;若终端参数操作带参,包含查询功能码,选中设置中的功能码对应数据帧中的CMD项,数值范围0x30-0xC8(48-200),注意不要与协议中已存在指令的功能码重复。然后根据实际需求添加各项子参数,填写参数详情。

5734aa2340b945e894c35100265d7466.png

(5)参数配置以及开发完成后,需要发布主板参数才完成入库对接。发布后,终端参数功能会显示在乐摇摇设备管理系统-设备管理模块中。

5aea59eca0664b70a6765c4bfdced908.png

abb6270dc4e142cca9ac418ab1e3464c.jpg

(6)当主板参数状态变为已发布后,即可进行对应的调试工作。若在此后修改参数项,需在修改完成后再次点击同步更新。

(7)发布后请厂商务必做好主板调试,主板调试完成,发布前请联系乐摇摇对接人员。

充电桩提交充电结束状态

指令说明——提交充电结束状态

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0E
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表9 详见表9
15 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
16 End(帧尾) BYTE 0xDD

表9提交充电结束状态指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 起始通道0x01
Data[1] 子命令

——提交充电结束状态 | BYTE | 0x04 | | Data[2] | 自增码 | BYTE | 达到上限0xFF后置0 | | Data[3-4] | 剩余时间 | WORD | 单位:;小端模式传输 | | Data[5] | 停止原因 | BYTE | 0x00:成功 0x01:用户手动停止(拔去插头或按下停止按钮) 0x02:充电已满,自动停止 0x03:设备或是端口出现问题,被迫停止 0x04:插电瞬间电流检测,因充电器功率超过充电站的单路最大输出功率,切断输出 0x05:开始充电未接充电器 0x06:所购买充电时间或电量耗尽 0x07:机箱内出现烟雾,关闭所有电源输出 0x08:充电过程中出现短路故障 0x09:充电过程中出现过载故障 0x0A:由充电桩设备意外断电或意外复位而导致的停止充电 | | Data[6] | 退费金额 | BYTE | 单位:分 | | Data[7] | 启动模式 | BYTE | 0x01:扫码支付

0x02:投币支付 | | Data[8] | 故障报错 | BYTE | 本代码支持自定义 | | Data[9-10] | 预留 | WORD | |

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x07
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表10 见表10
8 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
9 End(帧尾) BYTE 0xDD

表10提交充电结束状态应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 起始通道0x01
Data[1] 子命令 ——提交充电结束状态 BYTE 0x04
Data[2] 自增码 BYTE 达到上限0xFF后置0
Data[3] 上报结果 BYTE 0x00:失败 0x01:成功

投币增量上报

功能说明

此指令不可去除,后台对投币数的统计基于本指令中数据完成。此外,当发生线下投币时,也需要通过本功能指令上报。

指令说明——投币增量上报

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x0A
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x13 投币增量上报
4 Data(数据) 见表3.6.2.1 详见表12
11 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
12 End(帧尾) BYTE 0xDD

表12投币增量上报指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 自增码 BYTE 避免数据重复处理,新发送的上分数据自增码增加,重发的数据帧自增码不变。 自增码到达0xFF后置0,建议默认0x10
Data[1] 故障代码 BYTE 保留
Data[2] 投币增量 BYTE 设备一段时间投币的增量
Data[3] 退礼增量 BYTE 保留
Data[4] 营收增量 BYTE 保留
Data[5-6] 预留字节 WORD

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x03
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x13 投币增量上报
- Data(数据) - - 数据区无数据
4 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
5 End(帧尾) BYTE 0xDD

查询网络信号

功能说明

此功能可以使充电桩主板主动获取到支付盒子当前的网络状态。需要注意,在开机约10分钟后,才可以正常获取到支付盒子的信号值。

指令说明——查询支付盒子网络状态

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x03
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x19 查询支付盒子网络状态
- Data(数据) - - 不含数据区
4 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
5 End(帧尾) BYTE 0xDD

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x03
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x19 查询支付盒子网络状态
4 Data(数据) 见表13 详见表13
6 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
7 End(帧尾) BYTE 0xDD

13 查询支付盒子网络状态指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 信号值 BYTE 0-31种级别 数字越大,信号越强
Data[1] 链接服务器状态 BYTE 0x00:在线 0x01:离线

远程升级


功能说明

此功能可使主板厂家实现对其充电桩主板的远程升级,通过该指令,服务器将会把固件程序分包下发到主板。

首先进入开放平台开发者中心https://open.leyaoyao.com/factory/motherboard,点击固件远程升级,进入固件升级页面。

点击新增固件,填写各项信息,上传固件程序,点击确定。

在批量升级前,需要先进行验证固件操作,点击验证固件。根据盒子设备编号添加设备,验证固件最多选择两台,点击确定,即开始升级。

升级完成则后台显示升级成功。

此时可以进行批量升级操作,一次最多添加50台设备。

指令说明 —— 数据包下载

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xFF 为0xFF表示超过255个字节
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0xCD 大文件下载指令集
4 frame_length WORD 数据帧中数据长度
6 sub_cmd BYTE 0x01 子命令
7 Name_length BYTE 1-20 文件名的字符串长度
8 File_name String[M] 不包含后缀,只支持字符,不支持中文
9+M File_size WORD 文件大小,单位字节,小端模式
11+M Packet_Sum WORD 分包数量,每包上传数据512字节,小端模式
13+M Packet_Num WORD 当前包的编号 起始包编号为1
15+M Data_length WORD 数据区长度
16+M File_data BYTE[N] 文件数据
16+N+M Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
17+N+M End(帧尾) BYTE 0xDD

充电桩主板 -------------> 支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 以自定义情况为准
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0xCD 自定义指令
4 sub_cmd BYTE 0x01 子命令
5 Name_length BYTE 1-20 文件名的字符串长度,单位是字节
6 File_name String[M] 不包含后缀,只支持字符,不支持中文
6+M File_size WORD 文件大小,单位字节,小端模式
8+M Packet_Sum WORD 分包数量,每包上传数据512字节,小端模式
10+M Packet_Num WORD 当前包的编号
12+M File_result BYTE 0:接受成功
1:续传数据,按照应答中的编号接着往下传。
2:文件命名不一样,直接更新文件。
13+M Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
14+M End(帧尾) BYTE 0xDD

指令说明 —— 上传本地固件信息

充电桩主板------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 为0xff表示超过255个字节
2 Index (索引) BYTE 0x02 标识盒子主机
3 CMD(命令) BYTE 0xCD 大文件下载相关指令
4 sub_cmd BYTE 0x02 子命令
5 Name_length BYTE 1-20 文件名的字符串长度
6 File_name String[M] 不包含后缀,只支持字符,不支持中文
6+M File_size WORD 已保存的文件大小,单位字节
8+M version_length BYTE 软件版本号长度
10+M+N version String[N] 软件版本号
10+N+M Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
10+N+M End(帧尾) BYTE 0xDD

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x05 以自定义情况为准
2 Index (索引) BYTE 0x01 标识充电桩主板
3 CMD(命令) BYTE 0xCD 自定义指令
4 sub_cmd BYTE 0x02 子命令
5 File_result BYTE 预留
6 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
7 End(帧尾) BYTE 0xDD

指令说明 —— 获取本地固件信息

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x05 以自定义情况为准
2 Index (索引) BYTE 0x01 标识充电桩主板
3 CMD(命令) BYTE 0xCD 自定义指令
4 sub_cmd BYTE 0x03 子命令
5 File_result BYTE 预留
6 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
7 End(帧尾) BYTE 0xDD

充电桩主板------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 为0xff表示超过255个字节
2 Index (索引) BYTE 0x02 标识盒子主机
3 CMD(命令) BYTE 0xCD 大文件下载相关指令
4 sub_cmd BYTE 0x03 子命令
5 Name_length BYTE 1-20 文件名的字符串长度
6 File_name String[M] 不包含后缀,只支持字符,不支持中文
6+M File_size WORD 已保存的文件大小,单位字节
8+M version_length BYTE 软件版本号长度
10+M+N version String[N] 软件版本号
10+N+M Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
10+N+M End(帧尾) BYTE 0xDD

充电桩特定指令集中的其他指令

指令综述

充电桩特定指令集CMD皆为0x36,通过对数据区进行定制实现不同命令,利用其首位的子命令标识码区分,前文已经涉及部分,此处补充一些扩展功能将会用到的指令。

指令说明——远程停止指定端口充电

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x07
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表14 见表14
8 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
9 End(帧尾) BYTE 0xDD

14 远程停止指定端口充电指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 起始通道0x01
Data[1] 子命令 ——远程停止指定端口充电 BYTE 0x05
Data[2] 自增码 BYTE 达到上限0xFF后置0
Data[3] 充电端口号 BYTE

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x09
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表15 详见表15
10 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
11 End(帧尾) BYTE 0xDD

15 远程停止指定端口充电应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 起始通道0x01
Data[1] 子命令 ——远程停止指定端口充电 BYTE 0x05
Data[2] 自增码 BYTE 达到上限0xFF后置0
Data[3] 充电端口号 BYTE
Data[4-5] 剩余时间 WORD 单位:;小端模式传输

指令说明——上传控制板状态

本指令用作设备心跳,每5分钟交互一次。

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x07
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表16 详见表16
8 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
9 End(帧尾) BYTE 0xDD

表16上传控制板状态指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 非针对特定通道指令,填充0x00
Data[1] 子命令 ——上传控制板状态 BYTE 0x06
Data[2] 自增码 BYTE 达到上限0xFF后置0
Data[3] 状态标识码 BYTE 0x00:在线 0x01:离线

**充电桩主板 ------------->**支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x06
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表17 详见表17
7 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
8 End(帧尾) BYTE 0xDD

表17上传控制板状态应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 非针对特定通道指令,填充0x00
Data[1] 子命令 ——上传控制板状态 BYTE 0x06
Data[2] 自增码 BYTE 达到上限0xFF后置0

指令说明——查询用户选择通道

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x06
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表18 见表18
7 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
8 End(帧尾) BYTE 0xDD

18 查询用户选择通道指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 非针对特定通道指令,填充0x00
Data[1] 子命令 ——查询用户选择通道 BYTE 0x07
Data[2] 自增码 BYTE 达到上限0xFF后置0

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x07
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表19 详见表19
8 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
9 End(帧尾) BYTE 0xDD

表19查询用户选择通道应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 非针对特定通道指令,填充0x00
Data[1] 子命令 ——查询用户选择通道 BYTE 0x07
Data[2] 自增码 BYTE 达到上限0xFF后置0
Data[3] 充电桩通道状态 BYTE 0x00:未选择通道 0x01:选择通道1 0x02:选择通道2 …… 0x0A:选择通道10

指令说明——停用通道

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x10
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表20 见表20
17 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
18 End(帧尾) BYTE 0xDD

表20停用通道指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 非针对特定通道指令,填充0x00
Data[1] 子命令 ——停用通道 BYTE 0x09
Data[2] 自增码 BYTE 达到上限0xFF后置0
Data[3] 通道1设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[4] 通道2设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[5] 通道3设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[6] 通道4设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[7] 通道5设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[8] 通道6设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[9] 通道7设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[10] 通道8设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[11] 通道9设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态
Data[12] 通道10设置状态 BYTE 0x00: 通道正常使用状态 0x01: 停用通道状态

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0x06
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0x36 充电桩数据通信
4 Data(数据) 见表21 详见表21
7 Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
8 End(帧尾) BYTE 0xDD

21停用通道应答指令数据区说明

数据字段 名称 数据类型 备注
Data[0] 充电桩通道 BYTE 非针对特定通道指令,填充0x00
Data[1] 子命令 ——停用通道 BYTE 0x09
Data[2] 自增码 BYTE 达到上限0xFF后置0

扩展指令

功能说明

厂商可通过此功能根据自身需求定义扩展指令,如清空当前局数,恢复出厂设置等功能。

在乐摇摇后台网站https://open.leyaoyao.com(推荐Chrome浏览器打开)中的主板参数配置(参考终端参数)页面中,新增终端操作。

5e8f637eb3814c2c9107ece3db7c6990.png

根据实际情况填写各项内容。若设置功能不含参,则该指令固定不含数据区;若设置功能含参,则需进一步设置子参数,具体可参考自定义终端参数项。设置中的功能码对应数据帧中的CMD项,数值范围0x30-0xC8(48-200)。

设置完成后,功能会显示在乐摇摇设备管理系统-设备管理模块中,右图4

abb6270dc4e142cca9ac418ab1e3464c.jpg

指令说明——扩展指令

支付盒子 -------------> 充电桩主板

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 以自定义情况为准
2 Index (索引) BYTE 0x01 标识盒子主机
3 CMD(命令) BYTE 0xXX 自定义指令
4 Data(数据) BYTE[n] 自定义参数项 自定义方法说明见3.13.1
4+n Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
5+n End(帧尾) BYTE 0xDD

充电桩主板 ------------->支付盒子

起始字节 名称 数据类型 描述 备注
0 Head(帧头) BYTE 0xAA
1 Length(长度) BYTE 0xXX 以自定义情况为准
2 Index (索引) BYTE 0x02 标识充电桩主板
3 CMD(命令) BYTE 0xXX 自定义指令
4 Data(数据) BYTE[n] 自定义参数项 自定义方法说明见3.13.1
4+n Check(校验) BYTE 异或校验码 校验范围:Length+ Index+ CMD+ Data
5+n End(帧尾) BYTE 0xDD

设备主板接入方案

方案介绍

模组名称:充电桩智能主板

主板图片:

98a1ccdf531249cbb6a204eeb32bbaf4.png

方案概述:通过串口进行数据交互,与设备双向通讯:向设备发送控制指令、接受设备上报数据。不容易受到干扰,传输数据准确率高。方案优点是不受限于SOC片上资源、应用扩展度高;

适用设备:充电桩

联网方式:2G/4G/wifi

连接方式:与设备传感器连接

工厂开发:无需开发,亦可基于业务需求进行二次开发

乐摇摇充电桩方案功能明细

功能类别 编号 需求名称 描述
输出特性 1 充电口路数 10路充电口,单路之间相互隔离
2 单路输出电压要求 220 AC,要求输出电压稳定
3 单路输出电流 4A(按照降额50%设计,最大2A)
4 输出口总峰值电流要求 40A(按照降额50%设计,最大2A)
输入特性 1 输入电压要求 220V ,交变电峰值为312V 。带过压,欠压保护
2 输入电压防雷防浪涌 220V接口处及接地需做防雷防浪涌保护。
功能 1 充电口选择 可以从10路充电口里面任意选择一路或者多路(最大10路)来充电。
2 断电恢复 在断电后,重新来电的时候,可以恢复断电前的记忆状态,保护消费者权益。恢复用电考虑安全问题。
3 自动断电 充电时间到时自动断电,充满自停
4 插座虚接 插座再一分钟内没有链接发生充电动作,自动断开。
5 时间累加及减少 用户使用过程中,需要增加充电时长,系统时间可以垒加;需要减少充电时长,系统时间可以按照步近减少并退款。
6 费率可设置 可设置费用和时间、功率的对应关系。可设置一些优惠套餐。
7 语音提示功能 关键操作流程语音提示
8 输出关断 输出功率可开关控制,充电输出功率过高时可关断。
9 过载关断 可检测输出端是否过载或者短路。进行判断和关断。
10 漏电保护 充电桩支持漏电保护,防止充电者触电
11 烟雾关断 烟雾检测到有浓烟则关断整个设备供电。
12 过零检测 在电压过零点时,继电器开关进行开关动作。
13 拔出告警及恢复 检测充电过程中拔出插头的动作并上报
支付功能 1 移动支付 支持微信/支付宝/银联等支付渠道
2 投币支付 支持人民币投币付费
3 刷卡支付 支持通用的13.4M的卡
通信功能 1 空口无线通信功能 2G/3G/4G/根据信号强弱切换接入模式
2 本地WIFI接入功能 设备可以通过本地WIFI接入公网。
3 蓝牙 手机开启蓝牙进行支付
定制功能 1 自定义开发 基于SAAS架构,可根据用户的需求做定制功能扩展

厂商可基于企业业务需求进行二次开发,具体的开发流程与串口相同,查看开发流程

已有账号,立即登录