针对厂商设备主板与乐摇摇串口联网模组对接，平台提供标准串口数据通讯协议、自动生成参数界面、串口调试工具，简化开发过程，使设备快速联网获得增值功能。本文档基于乐摇摇串口联网模组与设备主板的标准对接流程编写
适用范围：方案适用于无屏售货机、口红机、福袋机等自助零售设备
协议文档
集成芯片对接参考设计资料
若选择串口集成芯片对接方案，请下载相应参考资料
SDK
串口调测功工具
准备工作：对接前，需要先获取乐摇摇联网芯片或模组，以便后续开发测试。
如果您是首次接入乐摇摇联网方案，请按以下流程进行对接。下文将针对各个步骤进行详细描述。
| 对接流程 | 参考文档 |
|---|---|
| 1注册开发账号 | 查看流程文档 |
| 2创建产品 | 查看流程文档 |
| 3主板参数配置 | 查看流程文档 |
| 4硬件嵌入式开发 | 查看流程文档 |
| 5硬件联调 | 查看流程文档 |
| 6发布，体验功能 | 查看流程文档 |
通信接口：串口（RS485/RS232/TTL）
波特率：38400
停止位：1位
数据位：8位
校验位：0位
| 数据类型 | 描述 |
|---|---|
| BYTE | 无符号单字节整型（字节，8位） |
| WORD | 无符号双字节整型（双字节，16位） |
| DWORD | 无符号四字节整型（四字节，32位） |
| BYTE[n] | N字节 |
协议采用小端模式(little-endian)的网络字节序来传递字和双字。
约定如下：
——字节(BYTE)的传输约定：按照字节流的方式传输；
——字(WORD)的传输约定：先传递低八位，再传递高八位；
——双字(DWORD)的传输约定：先传递低八位，然后传递高八位，再传递高16位，
最后传递高24位。
主机查询方式
主机按照一定的时间间隔向终端发送数据帧，终端接收到数据帧后返回应答帧，终端不主动上传数据，若主机在规定时间内未接受到规定的数据帧的应答数据帧，则重发数据帧直到终端返回应答数据帧。
正常通信时序：
异常通信时序：
终端上传数据帧方式
正常通信时序：
异常通信时序：
帧格式图
格式说明
| 起始字节 | 名称 | 定义 | 数据类型 | 备注 |
|---|---|---|---|---|
| 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 |
进行无屏售货机/零售机串口协议对接之前，您需要先了解娃娃机的串口功能指令。
| 功能指令 | 参考文档 |
|---|---|
| 设备登录 | 查看设备登录指令文档 |
| 终端参数 | 查看终端参数指令文档 |
| 无屏售货机支付 | 查看无屏售货机支付指令文档 |
| 远程上分 | 查看远程上分指令文档 |
| 上传账面增量 | 查看上传账面增量指令文档 |
| 查询网络信号 | 查看查询网络信号指令文档 |
| 扩展指令 | 查看查看扩展指令文档 |
登录流程
指令说明——查询链接状态
支付盒子 -------------> 售货机主板
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 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 |
指令说明——同步本地通道信息
售货机主板 ------------->支付盒子
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 0 | Head(帧头) | BYTE | 0xAA | |
| 1 | Length(长度) | BYTE | 0xXX | 以实际情况为准 |
| 2 | Index (索引) | BYTE | 0x02 | 标识售货机主板 |
| 3 | CMD(命令) | BYTE | 0xC9 | 售货机特定指令 |
| 4 | Data(数据) | 见表1 | 见表1 | |
| 4+n | Check(校验) | BYTE | 异或校验码 | 校验范围：Length+ Index+ CMD+ Data |
| 14 | End(帧尾) | BYTE | 0xDD |
表1支付盒子获取设备状态指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——同步本地通道信息 | BYTE | 0x02 |
| Data[1-2] | 通道总数 | WORD | 0x0000-0xFFFF；小端模式传输 |
| Data[3-4] | 通道序号 | WORD | 0x0000-0xFFFF；小端模式传输 |
| Data[5-8] | 购买价格 | DWORD | 单位：分；游戏出礼模式下置0 |
| Data[9-12] | 游戏价格 | DWORD | 单位：分；购买出礼模式下置0 |
| Data[13-14] | 通道货品数量 | WORD | 0x0000-0xFFFF；小端模式传输 |
| Data[15-16] | 通道货品容量 | WORD | 0x0000-0xFFFF；小端模式传输 |
| Data[17] | 通道名称字段长度 | BYTE | |
| Data[18-n] | 通道名称 | BYTE[n] | 支持GB18030，ASCII编码 注意：本字段长度需与Data[17]中数值保持一致 |
支付盒子 -------------> 售货机主板
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 0 | Head(帧头) | BYTE | 0xAA | |
| 1 | Length(长度) | BYTE | 0x0C | |
| 2 | Index (索引) | BYTE | 0x01 | 标识盒子主机 |
| 3 | CMD(命令) | BYTE | 0xC9 | 售货机特定指令 |
| 4 | Data(数据) | 见表2 | 详见表2 | |
| 13 | Check(校验) | BYTE | 异或校验码 | 校验范围：Length+ Index+ CMD+ Data |
| 14 | End(帧尾) | BYTE | 0xDD |
表2支付盒子获取设备状态指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——获取设备状态 | BYTE | 0x01 |
| Data[1-6] | 支付唯一码 | BYTE[6] | 每个支付流程的支付唯一码不改变 |
| Data[7-8] | 预留 | WORD | 取值0x00-0xFFFF；小端模式传输 |
登录标识
登录标识是乐摇摇支付盒子用以识别所对接设备主板身份的标识码，每个产品都有且只有一个（请把登录标识烧录到设备中。当设备激活时，会上报到云端鉴权认证设备参数）。
标识码获取流程
（1）打开乐摇摇后台网站https://open.leyaoyao.com（推荐Chrome浏览器），输入账号密码并登录。若无账号，请先注册开发账号。
（2）登录成功后，即可进入开发者中心。
（3）点击创建产品出现弹窗，请按要求完善产品信息。
主板信息填写与要求：
1主板名称格式为厂家名称+设备类型，例如：乐摇摇无屏售货机
2上传的主板原图与接线方式图片参照上方示例，特别注意拍摄清晰保证主板与支付盒子间的接口电路，以便工作人员审核
（4）主板信息提交成功后，乐摇摇硬件工作人员将在3个工作日内对其进行审核，审核结果会同步以短信形势发送到主板厂商预留的手机号码，请注意查收。
（5）待审核通过后，即可在该页面看到该主板对应登录标识。如未通过，请留意申请反馈并与乐摇摇硬件工作人员进一步沟通。
（6）注意：获取到的登录标识为十进制，通信数据中需转换为16进制，并令低位在前，高位在后，以小端模式传输。如：登录标识为150，则通信中实际需传输的登录标识数据为 0x96 0x00
指令说明——查询终端参数
支付盒子 -------------> 售货机主板
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 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）在智能化产品列表中，找到需要进行自定义参数项的主板，点击“编辑”。若找不到该主板，请参照登录标识中的说明，添加需要对接的主板。
（3）进入主板参数配置页面，参数配置由3部分组成，包括基础参数、终端参数、故障参数。参数配置是对产品功能的抽象表示，可以通过不同功能类型定义。目前平台提供：布尔型、数值型、枚举型、故障型这四种参数类型。详情设置说明见参数配置
（4）界面预览
配置完成后，点击写一步，系统根据你配置的参数，自动生成设备参数管理界面，通过微信扫码二维码即可查看。确定功能、界面是否符合，若符合点击下一步即可，若不符合，返回参数配置界面调整。
（5）参数配置以及开发完成后，需要发布主板参数才完成入库对接。发布后，终端参数功能会显示在乐摇摇设备管理系统-设备管理模块中。
（6）当主板参数状态变为已发布后，即可进行对应的调试工作。若在此后修改参数项，需在修改完成后再次点击同步更新。
（7）发布后请厂商务必做好主板调试，主板调试完成，发布前请联系乐摇摇对接人员
无屏售货机指令集中指令CMD皆为0xC9，通过对数据区进行定制实现不同命令，其首位的子命令标识码皆为0x0E，以Data[9]的控制板命令位区分，详情见下文
通用框架
支付盒子 -------------> 售货机主板
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 0 | Head(帧头) | BYTE | 0xAA | |
| 1 | Length(长度) | BYTE | 0xXX | 以实际情况为准 |
| 2 | Index(索引) | BYTE | 0x01 | 标识盒子主机 |
| 3 | CMD(命令) | BYTE | 0xC9 | 售货机特定指令 |
| 4 | Data(数据) | 详见后文 | 详见后文 | |
| 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 | 0xC9 | 售货机特定指令 |
| 4 | Data(数据) | 详见后文 | 详见后文 | |
| 4+N | Check(校验) | BYTE | 异或校验码 | 校验范围：Length+ Index+ CMD+ Data |
| 5+N | End(帧尾) | BYTE | 0xDD |
支付流程
支付盒子 -------------> 售货机主板 子设备状态查询指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——子设备状态查询 | BYTE | 0x01 |
售货机主板 -------------> 支付盒子 子设备状态查询应答指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——子设备状态查询 | BYTE | 0x01 |
| Data[10] | 状态 | BYTE | 0x00：离线 0x01：在线 |
支付盒子 -------------> 售货机主板 控制仓位指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——控制仓位 | BYTE | 0x02 |
| Data[10-15] | 指令唯一码 | BYTE[6] | |
| Data[16] | 控制仓位总数 | BYTE | |
| Data[17] | 仓位行参数 | BYTE | 当控制多个仓位时，需在末尾额外添加这些参数，注意与控制仓位总数对应 |
| Data[18] | 仓位列参数 | BYTE | |
| Data[19-20] | 仓位控制次数 | WORD |
售货机主板 -------------> 支付盒子 控制仓位应答指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——控制仓位 | BYTE | 0x02 |
| Data[10-15] | 指令唯一码 | BYTE[6] | |
| Data[16] | 执行结果 | BYTE | 0x00：执行成功 0x01：执行失败 |
需要返回的指令条数，应当等同控制仓位指令（子CMD 0x0E-0x02）中的控制仓位总数。
售货机主板 -------------> 支付盒子 控制板出货上传指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——控制板出货上传 | BYTE | 0x03 |
| Data[10-15] | 指令唯一码 | BYTE[6] | |
| Data[16] | 仓位行参数 | BYTE | |
| Data[17] | 仓位列参数 | BYTE | |
| Data[18] | 出货结果 | BYTE | 0x00：出货成功 0x01：出货失败 |
支付盒子 -------------> 售货机主板 控制板出货上传应答指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——控制板出货上传 | BYTE | 0x03 |
| Data[10-15] | 指令唯一码 | BYTE[6] | 与控制仓下发码保持一致 |
仓位测试指令（0x04）对应设备管理后台，货道管理中的电机测试功能，可供商户用于测试售货机电机是否能够正常运作。
在出货过后，主板需要上报仓位测试结果（0x05），指令条数应当等同于仓位测试指令（0x04）中的控制仓位总数。
支付盒子 -------------> 售货机主板 仓位测试指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——仓位测试 | BYTE | 0x04 |
| Data[10-15] | 指令唯一码 | BYTE[6] | |
| Data[16] | 控制仓位总数 | BYTE | 对应后续仓位参数组数量 |
| Data[17] | 仓位1行参数 | BYTE | 第一组仓位控制参数 |
| Data[18] | 仓位1列参数 | BYTE | |
| Data[19-20] | 仓位1控制次数 | WORD | |
| Data[21] | 仓位2行参数 | BYTE | 第二组仓位控制参数 |
| Data[22] | 仓位2列参数 | BYTE | |
| Data[23-24] | 仓位2控制次数 | WORD | |
| …… |
售货机主板 -------------> 支付盒子 仓位测试应答指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——仓位测试 | BYTE | 0x04 |
| Data[10-15] | 指令唯一码 | BYTE[6] | |
| Data[16] | 执行结果 | BYTE | 0x00：成功 0x01：失败 |
售货机主板 -------------> 支付盒子 仓位测试结果上报指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——仓位测试结果上报 | BYTE | 0x05 |
| Data[10-15] | 指令唯一码 | BYTE[6] | |
| Data[16] | 仓位行参数 | BYTE | |
| Data[17] | 仓位列参数 | BYTE | |
| Data[18] | 测试结果 | BYTE | 0x00：成功 0x01：失败 |
支付盒子 -------------> 售货机主板 仓位测试结果上报应答指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——子设备控制 | BYTE | 0x0E |
| Data[1-8] | 控制板子设备唯一码 | BYTE[8] | 区分一拖多子控制机地址，若未操作从机则为主机唯一码 |
| Data[9] | 控制板命令 ——仓位测试结果上报 | BYTE | 0x05 |
| Data[10-15] | 指令唯一码 | BYTE[6] | 与测试仓位指令下发码保持一致 |
功能说明
本功能用以实现由商户直接控制售货机出货，日常交易中不会涉及。有屏售货机点击货道测试时，盒子会向主板下发此指令消息。
指令说明——远程上分
支付盒子 -------------> 售货机主板
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 0 | Head(帧头) | BYTE | 0xAA | |
| 1 | Length(长度) | BYTE | 0xXX | 以实际情况为准 |
| 2 | Index(索引) | BYTE | 0x01 | 标识盒子主机 |
| 3 | CMD(命令) | BYTE | 0xC9 | 售货机特定指令 |
| 4 | Data(数据) | 见表3.6.2.1 | 见表3.6.2.1 | |
| 14 | Check(校验) | BYTE | 异或校验码 | 校验范围：Length+ Index+ CMD+ Data |
| 15 | End(帧尾) | BYTE | 0xDD |
表3.6.2.1 远程上分指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——远程上分 | BYTE | 0x0D |
| Data[1-6] | 订单号 | BYTE[6] | |
| Data[7-8] | 通道号 | WORD | 小端模式传输 |
| Data[9] | 上分模式 | BYTE | 0x00：游戏启动 0x01：商品出货 |
售货机主板 -------------> 支付盒子
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 0 | Head(帧头) | BYTE | 0xAA | |
| 1 | Length(长度) | BYTE | 0xXX | 以实际情况为准 |
| 2 | Index(索引) | BYTE | 0x02 | 标识售货机主板 |
| 3 | CMD(命令) | BYTE | 0xC9 | 售货机特定指令 |
| 4 | Data(数据) | 见表3.6.2.2 | 见表3.6.2.2 | |
| 11 | Check(校验) | BYTE | 异或校验码 | 校验范围：Length+ Index+ CMD+ Data |
| 12 | End(帧尾) | BYTE | 0xDD |
表3.6.2.2 远程上分应答指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 子命令 ——远程上分 | BYTE | 0x0D |
| Data[1-6] | 订单号 | BYTE[6] |
功能说明
1此功能不可去除，后台关于售货机的收益、出礼等各项经营统计，皆基于本指令中数据完成。
2其中，故障代码可根据厂商需求，在乐摇摇后台网站https://open.leyaoyao.com（推荐Chrome浏览器打开）中的主板参数配置（参考设置终端参数）页面中最下方一栏自行定义。
创建故障参数
1点击添加，然后根据实际需求填写故障情况
2编写完成提交后，点击同步主板参数，即可进行调试。
3无屏售货机（售货机、礼品机）主板上报故障代码后，可以在乐摇摇手机后台的消息通知中接收到对应的故障信息，如下图所示
指令说明——终端主动上传账目增量
售货机主板 ------------->支付盒子
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 0 | Head(帧头) | BYTE | 0xAA | |
| 1 | Length(长度) | BYTE | 0x0A | |
| 2 | Index (索引) | BYTE | 0x02 | 标识售货机主板 |
| 3 | CMD(命令) | BYTE | 0x13 | 终端主动上传账目增量 |
| 4 | Data(数据) | 见表3 | 详见表3 | |
| 11 | Check(校验) | BYTE | 异或校验码 | 校验范围：Length+ Index+ CMD+ Data |
| 12 | End(帧尾) | BYTE | 0xDD |
表3终端主动上传账目增量指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| 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(数据) | 见表4 | 详见表4 | |
| 6 | Check(校验) | BYTE | 异或校验码 | 校验范围：Length+ Index+ CMD+ Data |
| 7 | End(帧尾) | BYTE | 0xDD |
表4查询支付盒子网络状态指令数据区说明
| 数据字段 | 名称 | 数据类型 | 备注 |
|---|---|---|---|
| Data[0] | 信号值 | BYTE | 0-31种级别 数字越大，信号越强 |
| Data[1] | 链接服务器状态 | BYTE | 0x00：在线 0x01：离线 |
功能说明
厂商可通过此功能根据自身需求定义扩展指令，如清空当前局数，恢复出厂设置等功能。
在乐摇摇后台网站https://open.leyaoyao.com（推荐Chrome浏览器打开）中的主板参数配置（参考终端参数）页面中，新增终端操作。
根据实际情况填写各项内容。若设置功能不含参，则该指令固定不含数据区；若设置功能含参，则需进一步设置子参数，具体可参考自定义终端参数项。设置中的功能码对应数据帧中的CMD项，数值范围0x30-0xC8（48-200）。
设置完成后，功能会显示在乐摇摇设备管理系统-设备管理模块中，右图4
指令说明——扩展指令
支付盒子 ------------->售货机主板
| 起始字节 | 名称 | 数据类型 | 描述 | 备注 |
|---|---|---|---|---|
| 0 | Head(帧头) | BYTE | 0xAA | |
| 1 | Length(长度) | BYTE | 0xXX | 以自定义情况为准 |
| 2 | Index (索引) | BYTE | 0x01 | 标识盒子主机 |
| 3 | CMD(命令) | BYTE | 0xXX | 自定义指令 |
| 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 | 0xXX | 自定义指令 |
| 4 | Data(数据) | BYTE[n] | 自定义参数项 | 自定义方法说明见扩展指令-功能说明 |
| 4+n | Check(校验) | BYTE | 异或校验码 | 校验范围：Length+ Index+ CMD+ Data |
| 5+n | End(帧尾) | BYTE | 0xDD |
