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

AT 指令 v2.0 连接到 ilop 平台指南


目录

  1. ILOP AT指令列表
  2. ILOP AT指令详细
  3. ILOP 事件通知
  4. 连接ILOP平台步骤

AT 指令格式,请参考:AT v2.0指令格式. AT 固件下载,请点击:AT v2.0固件下载

ILOP AT指令列表

以下指令仅适用于ilop AT固件,该固件支持的基础版AT指令,请参考:基础版AT指令详细

序号 指令 描述
1 AT+ILOPSET 设置/读取ilop参数
2 AT+ILOPDM 设置ilop数据格式
3 AT+ILOPTSLPRE 设置ilop tsl文件的字符长度值和分段传输的id数量
4 AT+ILOPTSL 设置tsl thing
5 AT+ILOPTSLERASE 擦除tsl信息
6 AT+ILOPAWSSTART 启动awss路由配网模式
7 AT+ILOPAWSPRESS 启动awss一键配网模式
8 AT+ILOPSTART 启动ilop服务
9 AT+ILOPSTOP 结束ilop服务
10 AT+ILOPSTATUS ilop服务状态
11 AT+ILOPSENDICA 上报ICA标准数据
12 AT+ILOPSENDRAW 上报透传/自定义协议数据
13 AT+WIFISTATUS 查询wifi连接状态
14 AT+ILOPCONFIG 查询wifi模块进行ilop配置与否
15 AT+ILOPRESET 解绑设备
16 AT+WJAP 查询已连接wifi的信息,包括ssid 和 key

ILOP AT指令详细

AT+ILOPSET

功能:查询/设置 ilop 产品信息(可预先烧录)

查询指令 AT+ILOPSET?
响应 +ILOPSET:<product_key>,<product_secret>,<device_secret>,<device_name>
OK
设置指令 AT+ILOPSET=<product_key>,<product_secret>,<device_secret>,<device_name>
响应 OK
参数 product_key:product key
product_secret:product secret
device_secret:device secret
device_name:device name
说明 创建产品后,会自动生成 product_key 和 product secret。新增测试设后,会生成device secret和device name。

AT+ILOPDM

功能:设置 ilop 数据格式

查询指令 AT+ILOPDM?
响应 +ILOPDEVICE:<mode>
OK
设置指令 AT+ILOPDM=<mode>
响应 OK
参数 mode0,透传/自定义格式(详细内容请参考:https://living.aliyun.com/doc#epgxru.html)。
mode1,ICA标准数据格式,tsl从云端获取(暂不支持,tsl相关请参考 https://living.aliyun.com/doc#fedtrg.html)。
mode2, ICA标准数据格式,tsl从本地获取 - 本例 “设备与APP联调“中会讲解如何使用。

AT+ILOPTSLPRE

功能:设置 ilop tsl thing length and ic_count for TSL things transfer

设置指令 AT+ILOPTSLPRE=<tsl_len>,<id_count>
响应 返回OK;否则,返回ERROR
参数 tsl_len,TSL 字符串长度(最大支持20kb);id_count,last_tsl_len = (tsl_len%4096== 0) ? 0 : 1;id_count = tsl_len/4096 + last_tsl_len

AT+ILOPTSL

功能:transfer ilop tsl thing

设置指令 AT+ILOPTSL=<id>
响应 > 等待输入指定长度的TSL字符串,1 s钟内输入有效。收到正确后,返回OK;否则,返回ERROR
参数 id,当前传输TSL 分段的id
\ 返回 > 后,输入本段id的文件,文件长度除最后一次长度可以小于 4096 bytes,其余都是固定 4096 bytes,
注意 1、TSL是该文件内容是:创建产品并进行功能定义后,打开 “查看JSON”,得到的源代码文件并压缩;
2、id取值范围[0,4],所以TSL 目前支持最大20kb;
3、传送TSL 时,需要依次按照id号递增的方式传送从0到n(最后一个id)
4、每段传送之后模块会返回"OK"还是"ERROR",如果是"OK",可以继续发送下一段,如果"ERROR",支持重传直到成功。
5、若开发调试时,手动分包时,选择格式为:UTF-8 无BOM格式编码 进行保存,建议保存格式为 .bin.

AT+ILOPTSLERASE

功能:擦除TSL

设置指令 AT+ILOPTSLERASE
响应 返回OK;否则,返回ERROR
注意 erase all

AT+ILOPAWSSTART

功能:启动awss路由配网模式

设置指令 AT+ILOPAWSSTART
响应 OK

AT+ILOPAWSPRESS

功能:启动awss一键配网模式

设置指令 AT+ILOPAWSPRESS
响应 OK
注意 先设置AT+ILOPAWSSTART指令

AT+ILOPSTART

功能:启动ilop服务

设置指令 AT+ILOPSTART
响应 OK

AT+ILOPSTOP

功能:关闭ilop服务

设置指令 AT+ILOPSTOP
响应 OK
注意 设备重启后有效,也即重启后必需重新设置tsl文件和APP配网.

AT+ILOPSTATUS

功能:ILOP服务状态查询

查询指令 AT+ILOPSTATUS?
响应 +ILOPSTATUS:<status>
NONE,未启动
INIT,启动ilop服务
CONNECT,ilop服务连接
DISCONNECT,ilop服务断开连接

AT+ILOPSENDICA

功能: 上报ICA标准数据

设置指令 AT+ILOPSENDICA=<method>,<key>,<value>[,<key>,<value>]
响应 OK
参数 method: property,属性; event,事件; service,服务
key: 属性名称 (复合型属性用.表示,如"identifier1.ientifier2")
value: 属性值

AT+ILOPSENDRAW

功能: 上报透传/自定义协议数据

设置指令 AT+ILOPSNDRAW=<data_len>
响应 > 等待输入指定长度的字符串,1s内输入有效。数据上报成功后,返回OK;否则,返回ERROR

AT+WIFISTATUS

功能:查询wifi 状态

设置指令 AT+WIFISTATUS?
响应 NONE STATION_UP STATION_DOWN
|OK
参数说明 status : NONE,未配置; STATION_UPstation up; STATION_DOWN,station down

AT+ILOPCONFIG

功能:查询wifi 模块 是否ilop配置过tsl

设置指令 AT+ILOPCONFIG?
响应 +ILOPCONFIG=<status>
|OK
参数说明 status :NONE,未配置; CONFIGED,配置过

AT+SYSVER

功能:查询 ilop版本

设置指令 AT+SYSVER?
响应 +SYSVER:AOS-R-1.3.1
|OK
参数说明 ilop版本:AOS-R-1.3.1

AT+FWVER

功能:查询固件版本

设置指令 AT+FWVER?
响应 +FWVER:<fwver>
|OK
参数说明 fwver:ilop_AT_v2.1.1, ilop代表飞燕平台,AT代表AT固件,v2.1.1代表固件版本

AT+ILOPRESET

功能:设备端解绑

设置指令 AT+ILOPRESET
响应 OK,现象: APP端 列表中设备消失。

AT+WJAP

功能:查询已设置的,在Station 模式,要接入的 AP 的名称和密码。

查询指令: AT+WJAP=?
响应: +WJAP:<ssid>,<key>
参数: ssid: Station模式要接入的 AP 名称
key:Station模式要接入的 AP 密码

ILOP事件通知

序号 指令 指令说明
1 +ILOPEVENT=ILOP,TSL_THING 当mode=2时,模块请求thing模型
2 +ILOPEVENT=ILOP,<status> 连接服务器状态。status:CLOUD_CONNECT:服务器连接成功;LOCAL_CONNECT:局域网控制住连接 ; CLOUD_DISCONNECT:服务器断开连接; CLOUD_DISCONNECT:局域网控制断开
3 +ILOPEVENT=SETICA,<method>,<key>,<value> 下发ICA标准数据,参数同AT+ILOPSENDICA指令参数
4 +ILOPEVENT=SETRAW,<date_len>,<data> 下发透传/自定义协议数据

连接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固件及指令基本使用方法,可参考:ATv2.0透传固件概述 及其后续一系列文档)。

请先下载格西烽火串口指令工程: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

注意:

  1. 初次配网绑定成功后,设备再次上电时即可自动入网连云进行通信。

  2. 当需切换新的控制用户时,要么设备端主动解绑,要么app端主动解绑,才能再次配网绑定,否则无法实现。

  3. 当设备需切换wifi网络时,必需在APP端解绑设备后,重新配网绑定,具体的执行以下指令:

  4. 1、调用解绑指令:AT+ILOPRESET\r

  5. 2、结束ILOP服务:AT+ILOPSTOP\r
  6. 3、重启:AT+REBOOT\r
  7. 4、开启ilop服务: AT+ILOPAWSSTART\r
  8. 5、启动awss路由配网模式:AT+ILOPAWSSTART\r
  9. 6、启动awss一键配网模式:AT+ILOPAWSPRESS\r。

3.此例提供数据传输方式为 指令模式,若采用透传模式,则无需进行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

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

运维中心

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

固件升级

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

选择固件

确认固件:

固件确认

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

首件确认

文本导读目录