乐摇摇提供了两种串口解决方案,分布是:串口版和集成芯片,两者实现的功能一样,只是与主板连接方式、价格上存在差异。厂商可根据自身需求选择。
针对厂商设备主板与乐摇摇串口联网模组对接,平台提供标准串口数据通讯协议、自动生成参数界面、串口调试工具,简化开发过程,使设备快速联网获得增值功能。本文档基于乐摇摇串口联网模组与设备主板的标准对接流程编写。
操作指南
开发流程
如果您是首次接入乐摇摇联网方案,请按以下流程进行对接。下文将针对各个步骤进行详细描述。
在厂商使用乐摇摇串口方案前,需要先注册乐摇摇开发者账号。
操作步骤:
2点击注册右上角,完善册信息,提交即可。
注:开发者账号与设备管理账号不互通,需要重新注册
注册成功后,即可进入开发者中心。
点击创建产品出现弹窗,请按要求完善产品信息。
主板信息填写与要求
1审核通过后会有短信通知发送至您的手机;
2若审核失败,请重新编辑产品信息,提交审核。
进入主板参数配置页面,参数配置由3部分组成,包括基础参数、终端参数、故障参数。参数配置是对产品功能的抽象表示,可以通过不同功能类型定义。目前平台提供:布尔型、数值型、枚举型、故障型这四种参数类型。对于如何定义功能点,下文将有详细介绍。
基础参数
适用功能:用于扩展功能,查询指令和设置指令固定,分别是0x05/0x06
数据传输类型:可下发可上报
终端参数
适用功能:用于扩展功能,查询指令和设置指令可自定义
功能案例:
故障参数
适用功能:专门用于上报和统计故障的功能点
功能案例:光眼传感器故障、电机故障、高温故障……
注意:故障型的数据格式为bitmap型,可支持多故障定义。故障型功能只支持数据上报,当设备状态改变(正常→故障或故障→正常),即上报数据
功能类型详解
布尔型
适用功能:非真即假的二值型变量功能。
功能案例:设备的开关、背景音乐播放等功能,均可采用布尔型表示。
整数****型
适用功能:适用于可线性调节类型的数据,仅限整数
功能案例:电压调节,电压范围0-40,单位为V,表达含义为该产品可调节温度0-40V。数据传输类型:可下发可上报
浮点****型
适用功能:适用于可线性调节类型的数据,分为float(高低位方式)和float(乘10方式),仅限小数
枚举型
适用功能:该功能下有有限的自定义值集合。
产品开发完成,进入试产/量产环节,确认产品功能将不会更改后,可申请将产品发布上线。
发布、同步须知:
通讯协议
根据对接的设备类型生成串口通讯协议,可下载参考。
SDK
为了让嵌入式工程师更快、更稳定完成MCU程序,乐摇摇已经将《乐摇摇串口通讯协议》进行解析,并提供基础框架代码。在此基础上进行修改、补充,可快速完成MCU程序。您可以点击下载SDK。
SDK包含串口协议和公用函数两部分:
虚拟参数测试
通过虚拟设备模拟真实设备上报数据的行为,可以快速验证接口功能的开发。
串口调试助手
1把对接主板与电脑通过usb接口连接,保持主板处于通电状态。
3检验数据是否发送正常、格式是否正确。
2进入设备管理后台,注册账号
注册绑定支付盒子
2按照需求编辑各项信息,提交注册。
(1)扫描乐摇摇盒子支付二维码,模拟线上支付启动。
(2)点击进入设备管理,点选设备,调试参数设置功能。
待各项功能调试无误后,在产品正式投入使用前,请联系乐摇摇工作人员将产品发布上线。