• 物联网工程师开发服务平台

直连阿里ilop飞燕云平台指南


写在前面

本例提供基于 AT 指令的,通过ilop平台的公版APP,对设备进行在线调试的方法。

本例中使用的 Wi-Fi 模块为 EMW3080(已通过阿里认证)。

1.了解ilop平台

关于 ilop 平台相关文档内容,请点击查看:生活物联网平台2.0

如您已经 掌握ilop平台使用方法,可直接进入产品联动,通过发AT指令 实现APP为设备配网,ilop平台查看数据通信log信息。

提示:请仔细阅读该文档中心的所有文档内容,对该生活物联网平台的工作框架有清晰认知后,再着手下面的操作,否则会影响后续的功能理解。

2.注册用户账号

登陆:https://living.aliyun.com/ , 阿里智能生活开放平台,如有支付宝账号,请直接登陆;若无支付宝账号,请免费注册并登录。

登录或免费注册用户账号

3.创建项目

登录后,直接跳转 “新建项目” 页面,如下:

新建项目页面

项目建成后,可预览如图:

项目建成显示页面

4.新建产品

点击 “项目名称-庆科智能”,进入项目后,新建产品,如下图:

进入新建产品

可从列表中找到相应的产品,选择 并 确认,创建产品,如下图:

新建产品信息

预览产品列表,如图,显示状态 “开发中”。

预览产品信息

5.功能定义

点击 产品名称,进入功能定义界面如下图:

功能定义页面

功能定义包括标准功能和自定义功能,如下图:

添加功能

添加 ICA 联盟体提供的标准功能,可从列表中选择:

添加标准功能属性

也可根据用户产品特殊需求,添加自定义功能,需经过1个工作日的平台工作人员审核。

添加自定义功能属性

功能定义完成,需要获取到产品的tsl文件,即点击下图中的 ”查看JSON“ ,

查看json

并拷贝文件内容,进行在线json压缩处理:json在线压缩工具地址

压缩前,显示如图:

压缩前

压缩后,显示如图:

压缩前

拷贝压缩后的文本,并保存至PC某路径下txt文件中,如:\Mac\Home\Desktop\txt\tsl-alarm.txt。

tsl文本

并通过 “串口调试软件” 发送该文件的方式,获取该txt文件的字符总数。

注意:不要使用网上提供的字符统计软件,统计结果不准确。

本例tsl_alarm.txt的字符总数为:5483(该参数将在后续的 AT 指令中使用)。

点击“下一步”,进入 “设备调试” 阶段。

6.设备调试

选择您所使用的模组型号,注意:该模组需已通过阿里认证,如下图:

选择认证的模组 或 芯片

您也可以选择 使用的芯片,如下图:

选择认证的模组 或 芯片

选择好模组或芯片类型后,可在测试设备中点击 “新增测试设备”,如下图:

新增测试设备

当不填时,由平台自动生成device key和device secret。

设置 设备名称

添加完成,将自动生成测试设备所需的三元组,如下图:

三元组

三元组生成,也即:“设备激活凭证”,请保存,待设备调试时,需连同 “Product Secret”一起,通过 AT 指令烧录至模组中,具体参见指令:AT+ILOPSET,需要设置的参数包括:Product Key, Product Secret, Device Key, Device Secret。

其中,Product Secret 的值在产品基本信息中,点击 “显示”即可。如图:

四元组

注意:当批量烧录模组时,不推荐使用 AT 指令烧录,需用庆科专门开发的 BAT 系统,与固件一同进行自动批量预烧录。

点击页面底部“下一步”,进入“人机交互”。

7.人机交互

“人机交互” 页面中选择 “公版APP”,点击“公版APP”, 查看测试版。

请扫码下载,并完成安装注册,登录。

本例仅提供在线调试指导,不做发布操作,此步骤可直接点击 “下一步” 即可。 (注意:如需产品发布,请对公版APP进行必选项进行填写。 )

人机交互-选择公版APP

8.产品发布

进入“产品发布”页,获取公版APP 的配网二维码,如下图:

公版APP配网二维码

9.产品联动

设备端通过 AT 指令,实现连接 liop 平台的操作步骤如下表。(

请先下载格西烽火串口指令工程:at_ilop.bsp指令工程.

测试步骤: 1. 进入AT指令模式 2. 关闭UART回显 3. 设置ilop参数 4. 设置ilop数据格式,如果是透传模式直接到7 ,ICA本地格式接下一步 5. 设置TSL tsl_len id_count 6. 发送id && 文件 7. 启动ilop服务 8. 启动awss路由配网模式 9. 启动awss一键配网模式

序号 步骤 发送指令(或操作)
1 确认AT指令模式 AT
返回 OK
2 关闭串口回显功能 AT+UARTE=OFF\r
返回 OK
3 设置 ilop 产品信息 AT+ILOPSET=a1uJx2vJwDT,a1xLah5cMhK,rdZ5XpH8NSKKLVS1oGMGEXpcu5pZbSxD,xwlXjTpLqYVr6MxWycYd\r注意:这里是调试阶段,可采用AT指令写入的方式进行设置产品信息,若批量生产烧录时,推荐采用高效的 BAT 自动烧录系统
返回 OK
4 设置 ilop 数据格式 AT+ILOPDM=2\r
返回 OK
5 设置 tsl 长度和分包数量 AT+ILOPTSLPRE=5483,2\r
返回 OK
6 发送tsl文件 AT+ILOPTSL=0\r
返回 >
发送tsl文件 tsl-alarm-0.bin文件
7 发送tsl文件 AT+ILOPTSL=1\r
返回 >
8 发送tsl文件 tsl-alarm-1.bin文件
返回 OK
9 启动 ilop 服务 AT+ILOPSTART\r
返回 OK
10 启动ilop aws路由器配网模式 AT+ILOPAWSSTART\r
返回 OK
11 启动 ilop aws一键配网模式 AT+ILOPAWSPRESS\r
返回 OK
12 打开公版APP, 扫描配网二维码 开始为设备配网
返回 +ILOPEVENT:ILOP,LOCAL_CONNECT
13 向ilop平台上报ICA标准格式数据,属性:错误代码,值为1 AT+ILOPSENDICA=property,WIFI_Channel,22\r
14 向ilop平台上报ICA标准格式数据,事件:WIFI_Channel,值为1 AT+ILOPSENDICA=event,Error.ErrorCode,0\r
返回 OK
15 向ilop平台上报ICA标准格式数据,多个数据。 AT+ILOPSENDICA=property,WIFI_Channel,22,GasSensorState,1,LelPercentage,20\r
返回 OK
16 停止ilop服务 AT+ILOPSTOP\r
返回 OK

注意: 此例提供数据传输方式为 指令模式,若采用透传模式,则无需进行tsl文件的传输,可直接执行 4步骤 后到,步骤9 即可,配网绑定成功后,直接发送数据即可。


所需的 at 指令列表如下图:

at指令列表

at 指令返回情况如下图:

at指令返回-产品信息配置

at指令返回-链接到ilop

at指令返回-上报数据

APP端界面如下:

APP控制界面

APP解绑界面请点击右上角 。。。, 如下图:

解绑界面

10.ilop平台查看调试log

此时,可在ilop平台中在线调试设备。具体:

设备调试页面中,点击 “调试”进入设备log查看页面,如图:

进入调试界面

选择添加的测试设备,如图:

选择设备key

此时,通过串口发数据给 app,可查看到平台上的 实时log信息,如图:

查看log信息

同时,可以通过点击“查看”进入设备状态实时查看页面如下图:

进入查看设备页面

基于本例的设备状态信息如下图:

状态列表

11.产品发布的公版APP

若需发布产品,需完成"人机交互"步骤中的必填选项,如下图,以公版APP为例,标准功能各项需设置。

设置app参数

进入“产品发布”页面,如下图,选择相应选项,下载物料包,可进行发布。

发布页面

产品发布后,使用的正式公版APP 信息,可参考:“ilop 平台app介绍”页面。

12.固件OTA

进入阿里飞燕云平台的 产品页面,找到 “运维中心”,如下图:

运维中心

打开,进入设备运维 - 固件升级,如下图:

固件升级

选择要升级的固件文件,如下图:

选择固件

确认固件:

固件确认

升级固件上传后,需进行首件确认,点击:“验证固件”。

首件确认

文本导读目录