文档首页

智能充电桩系列解决方案

产品介绍

什么是智能化充电桩

随着新能源行业的快速发展,智能充电桩迅速走入大众视野当中。乐摇摇针对行业发展需求,提供联网模组和智能板卡,与充电桩进行实时双向通信,向设备发送控制指令、接受设备上报数据,完成对充电业务、充电设备、充电流程的远程控制和管理。厂商只需专注于自身产品硬件研发,减低产品智能化门槛。运营商实现精细化管理,实现增收提效。用户获得便捷的支付方式和更好的体验。

2cf9e50d63214e5a81ea8ca23891c986.png

产品优势

智能化充电桩与传统产品对比的优势

对比项 智能化充电桩 传统充电桩
支付渠道 接入移动支付,同时兼容微信、支付宝、银联等主流支付渠道 资金安全,银行直接清算到账,并提供详细的流水明细 丰富的营销资源补贴 设备无法联网通讯,只能使用现金、投币支付方式,无法满足线上支付行为,导致消费用户流失 现金收益存储在设备内,存在一定的资金风险
管理 通过SaaS后台实时监控设备运营状态,跟踪设备使用分布和故障,及时维护 线上支付收益直接到账,账目清晰 远程设置收费标准 售后维护,提升用户忠诚度 无法知晓设备运行情况,只能通过员工定时维护,人力成本高 需要定期收款,清点金额数量,低效且账目容易出现错乱 出现消费纠纷,无法立刻排查处理
安全 运行过程中,发生故障自动定位问题并上报通知 充电过程中,对电流、电压等关键指标 进行监控,若超过安全规定,立即切断保证安全 当设备出现问题,无法及时知晓维护 安全监测机制不完善,使用过程中存在安全隐患
数据分析 从消费金额、频率、人数等维度出发,实时了解经营状况并进行比对 勾勒用户消费画像,提供运营决策依据 无法系统地收集数据,只能基于经验或片面的认知,做出运营决策
用户体验 精准定位附件充电桩位置、进行预约,充电成功后及时推送消息 基于经验查找,容易出现设备被占用无法充电

用户价值

行业现状

  • 移动支付成为趋势,消费者习惯手机支付,减少现金的使用。支付渠道单一,会导致收益的流失。
  • 市场竞争日益激烈,运营商希望对设备进行精细化管理,及时了解设备运营状态、数据分析科学决策。但是传统的充电桩无法实现数据实时互通反馈,导致管理效率低下。
  • 设备管理成本高,无法实时获取礼品消耗,造成礼品不足影响交易。
  • 厂商/开发者希望满足市场需求,让设备联网智能化,提供更多增值服务。但设备智能化涉及联网芯片、云服务、saas应用,每一个环节都需要专业的技术团队支持,整体研发经费高,时间消耗长。

工厂/开发者价值

  • 一站式的软硬件服务,提供多种硬件联网方案+云平台服务,低成本实现设备智能化
  • 设备售后跟踪,采集设备故障、分布、使用数据,提升客户忠诚度。

商户价值

  • 强大的SAAS服务,让商户实现远程监控,提升管理效率
  • 扩展支付渠道,促进收益

消费者价值

  • 快速扫码启动,无需现金
  • 线上活动,更多优惠
  • 定点搜索、预约、消息推送等功能服务,提升体验

串口板接入方案

什么是充电桩串口对接

乐摇摇提供联网模组/芯片,厂商把模组与设备主板连接,基于标准化的硬件通信协议进行开发,使设备获得联网通讯能力以及一体化的sass服务。智能化的设备上整合了移动支付、远程管理、数据分析、渠道运营、广告投放等能力,让投放商可以在任何时间、地点进行监控管理,提升整体管理效率与渠道收益。

串口方案

乐摇摇提供了两种串口解决方案,分布是:串口版和集成芯片,两者实现的功能一样,只是与主板连接方式、价格上存在差异。厂商可根据自身需求选择。

对比项 串口板 集成芯片
图片 3e85d78f617448cd80ca3b51ba496a16.png 744b4bebcc094abc87207f3056363277.png
数据交互方式 通过串口进行数据交互,与设备双向通讯:向设备发送控制指令、接受设备上报数据 通过串口进行数据交互,与设备双向通讯:向设备发送控制指令、接受设备上报数据
品类通用性
通讯方式 4G 2G/4G/WIFI
安装方式 与主板连接 通过焊接与主板连接
研发能力 嵌入式开发 嵌入式开发
优点 安装方便 应用扩展度高,可基于业务二次开发 应用扩展度高,可基于业务二次开发 价格优惠 尺寸小

前言

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

协议文档

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

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

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

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

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

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

SDK

下载串口与函数SDK

串口调测功工具

下载乐摇摇串口调试助手

准备工作

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

开发流程

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

4e21b2376bae43c5a1095d0a2fffb3db.jpg

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

设备主板接入方案

方案介绍

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

主板图片:

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架构,可根据用户的需求做定制功能扩展

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

开发指南

协议基础

通信配置

通信接口: 串口(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:成功
投币增量上报

功能说明

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

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

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

起始字节 名称 数据类型 描述 备注
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:离线
充电桩特定指令集中的其他指令

指令综述

充电桩特定指令集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

已有账号,立即登录