针对厂商设备主板与乐摇摇串口联网模组对接,平台提供标准串口数据通讯协议、自动生成参数界面、串口调试工具,简化开发过程,使设备快速联网获得增值功能。本文档基于乐摇摇串口联网模组与设备主板的标准对接流程编写。
协议文档
集成芯片对接参考设计资料
若选择串口集成芯片对接方案,请下载相应参考资料
SDK
串口调测功工具
准备工作
对接前,需要先获取乐摇摇联网芯片或模组,以便后续开发测试。
如果您是首次接入乐摇摇联网方案,请按以下流程进行对接。下文将针对各个步骤进行详细描述。
通信接口:串口(RS232)
波特率:9600
停止位:1位
数据位:8位
校验位:0位
协议采用小端模式(little-endian)的网络字节序来传递字和双字。
约定如下:
——字节(BYTE)的传输约定:按照字节流的方式传输;
——字(WORD)的传输约定:先传递低八位,再传递高八位;
——双字(DWORD)的传输约定:先传递低八位,然后传递高八位,再传递高16位,
最后传递高24位。
主机查询方式
正常通信时序:
异常通信时序:
终端上传数据帧方式
帧格式图
格式说明
支付盒子
指令说明——查询链接状态
支付盒子------------->洗衣机主板
洗衣机主板------------->支付盒子
标识码获取流程:
(3)点击创建产品出现弹窗,请按要求完善产品信息。
主板信息填写与要求:
1主板名称格式为厂家名称+设备类型,例如:乐摇摇娃娃机
2上传的主板原图与接线方式图片参照上方示例,特别注意拍摄清晰保证主板与支付盒子间的接口电路,以便工作人员审核
(4)主板信息提交成功后,乐摇摇硬件工作人员将在3个工作日内对其进行审核,审核结果会同步以短信形势发送到主板厂商预留的手机号码,请注意查收。
支付流程
指令说明——启动申请
表1启动申请指令数据区说明
表2启动申请应答指令数据区说明
指令说明——扫码支付启动
表3扫码支付启动指令数据区说明
表4扫码支付启动应答指令数据区说明
指令说明——查询终端参数
指令说明——设置终端参数
开发建议与示例
表3.3.3参数查询/设置指令数据区说明
自定义终端参数项
(3)进入主板参数配置页面,参数配置由3部分组成,包括基础参数、终端参数、故障参数。参数配置是对产品功能的抽象表示,可以通过不同功能类型定义。目前平台提供:布尔型、数值型、枚举型、故障型这四种参数类型。详情设置说明见参数配置。
(4)参数配置以及开发完成后,需要发布主板参数才完成入库对接。发布后,终端参数功能会显示在乐摇摇设备管理系统-设备管理模块中。
(5)当主板参数状态变为已发布后,即可进行对应的调试工作。若在此后修改参数项,需在修改完成后再次点击同步更新。
(6)发布后请厂商务必做好主板调试,主板调试完成,发布前请联系乐摇摇对接人员。
功能说明
每当洗衣机的工作状态发生变化时,要求洗衣机主板主动上报其当前状态。也支持后台主动获取当前洗衣机的状态,根据数据方向字段判断指令是否需要应答,若是应答帧则不需要再应答。
指令说明
洗衣机主板<------------->支付盒子
表3.5.2.1主动上报工作状态指令数据区说明
支付盒子<------------->洗衣机主板
表3.5.2.2主动上报工作状态应答指令数据区说明
指令说明——暂停洗衣流程
指令说明——继续洗衣流程
指令说明——终止洗衣流程
指令说明——一键清洁洗衣机
此功能可以使洗衣机主板主动获取到支付盒子当前的网络状态。需要注意,在开机约10分钟后,才可以正常获取到支付盒子的信号值。
指令说明——查询支付盒子网络状态
表7查询支付盒子网络状态应答指令数据区说明
点击新增固件,填写各项信息,上传固件程序,点击确定。
在批量升级前,需要先进行验证固件操作,点击验证固件。根据盒子设备编号添加设备,验证固件最多选择两台,点击确定,即开始升级。
升级完成则后台显示升级成功。
此时可以进行批量升级操作,一次最多添加50台设备。
指令说明——数据包下载
指令说明——上传本地固件信息
指令说明——获取本地固件信息
厂商可通过此功能根据自身需求定义扩展指令,如清空当前局数,恢复出厂设置等功能。
根据实际情况填写各项内容。若设置功能不含参,则该指令固定不含数据区;若设置功能含参,则需进一步设置子参数,具体可参考自定义终端参数项。设置中的功能码对应数据帧中的CMD项,数值范围0x30-0xC8(48-200)。
设置完成后,功能会显示在乐摇摇设备管理系统-设备管理模块中,右图4