硬件对接流程

乐摇摇串口板协议对接流程

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

串口方案

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

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

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

操作指南

下载串口协议对接操作指南

开发流程

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

在厂商使用乐摇摇串口方案前，需要先注册乐摇摇开发者账号。

操作步骤：

1电脑打开乐摇摇开放平台网址：https://open.leyaoyao.com

2点击注册右上角，完善册信息，提交即可。

注：开发者账号与设备管理账号不互通，需要重新注册

注册成功后，即可进入开发者中心。

点击创建产品出现弹窗，请按要求完善产品信息。

主板信息填写与要求

名称	详情
设备类型	支持娃娃机、兑币机、售货机、按摩椅、洗衣机、充电桩、高尔夫出球机
主板名称	填写格式：公司名称+设备类型，如乐摇摇娃娃机
接口类型	接口类型支持RS232、TTL_3V3、TTL_5V
波特率	38400（推荐）
主板原图	提供清晰的主板图片，以便硬件人员后续提供技术支持

| | 主板接线方式 | 提供清晰的主板接线图片，以便硬件人员后续提供技术支持

| | 联系人手机号 | 审核通过后，短信通知会发生至该手机号 |

提交成功后，请等待乐摇摇工作人员审核。审核时间大约需要3个工作日。

1审核通过后会有短信通知发送至您的手机；

2若审核失败，请重新编辑产品信息，提交审核。

产品信息审核通过后，系统为产品生成对应的登录标识。

登录标识：用以识别对接主板身份的标识码，每个产品都有且只有一个（请把登录标识烧录到设备中。当设备激活时，会上报到云端鉴权认证设备参数）。

进入主板参数配置页面，参数配置由3部分组成，包括基础参数、终端参数、故障参数。参数配置是对产品功能的抽象表示，可以通过不同功能类型定义。目前平台提供：布尔型、数值型、枚举型、故障型这四种参数类型。对于如何定义功能点，下文将有详细介绍。

基础参数

适用功能：用于扩展功能，查询指令和设置指令固定，分别是0x05/0x06

功能案例：几币一局、背景音乐、游戏时间……

数据传输类型：可下发可上报

终端参数

适用功能：用于扩展功能，查询指令和设置指令可自定义

功能案例：

数据传输类型：可下发可上报

故障参数

适用功能：专门用于上报和统计故障的功能点

功能案例：光眼传感器故障、电机故障、高温故障……

注意：故障型的数据格式为bitmap型，可支持多故障定义。故障型功能只支持数据上报，当设备状态改变（正常→故障或故障→正常），即上报数据

参数相关概念

功能名称	即具体智能设备功能的抽象，用于描述产品功能及其参数
参数长度	串口协议数据区字段的字节数，范围1-4
查询指令
设置指令	串口协议的CMD码
参数类型	布尔型（bool）：非真即假的二值型变量。如：开关功能，开/关
枚举型（enum）：自定义的有限集合值。如：工作档位，低档/中档/高档
整数型（integer）：可线性调节数值型的功能，仅限整数，如电压调整，电压范围0-40V
浮点型（floating）：适用于可线性调节类型的数据。如：温度调节，温度范围20-40℃
数据传输类型	可下发可上报：指令数据可以下发给设备，设备数据可以上报给云端；
只上报：数据只支持从设备上报；
只下发：数据只支持从云端下发；