写在前面

本例提供通过 Wi-Fi 模组的 AT 指令直连阿里飞燕云平台的方法( 适用 飞燕 AT 固件v2.3.0 版本及以上)。 具体的,在阿里飞燕ilop云平台创建产品和公版APP后,基于 AT 指令,通过公版APP,对设备进行在线调试的步骤。适用于已通过阿里飞燕云平台认证的上海庆科模组。

语音控制功能:
自 v2.3.0 版本开始,支持 “天猫精灵” 发现设备功能。

  • 即:当设备进入“配网模式” 时, 对已联网的 “天猫精灵” 说:发现设备,可将设备配网,并与天猫精灵绑定,绑定后即可通过语音控制设备。
  • 具体语音控制指令可参考天猫精灵APP的设备信息。(注意:只支持控制 “天猫精灵已适配的产品种类”,详细参考飞燕云平台,用户自己产品下“人机交互”—“天猫精灵”页面的“支持品类”详情)。

了解ilop平台

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

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

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

注册用户账号

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

image.png

创建项目

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

image.png

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

image.png

新建产品

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

image.png

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

image.png

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

image.png

功能定义

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

image.png

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

image.png

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

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

image.png

设备调试

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

image.png

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

image.png

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

image.png

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

image.png

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

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

image.png

注意:当批量烧录模组时,不推荐使用 AT 指令烧录(效率低),需用庆科专门开发的 BAT 系统,与固件一同进行自动批量预烧录,当下购买订单时需指定固件版本号及提供三元组参数文件。

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

人机交互

“人机交互” 页面中选择 “公版APP”,点击 “公版APP” 下载。 注意:推荐使用 正式版 APP。 请扫码下载,并完成安装注册与登录。

进入“人机交互”页面,选择“使用公版APP控制”,获取公版APP 的配网二维码,并配置界面,如下图:

image.png

APP配置界面如下图,请务必保存后,测试。

image.png

需要填写部分必填的 APP 配置信息,才能正常测试使用。

批量投产

当产品调试,测试,APP发布后,可填写批量投产信息,购买激活码,进入批量投产阶段。

image.png

产品联动

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

飞燕 AT 指令详细,请参考:“ilop AT 指令” 中的 “直连ilop阿里飞燕云平台指令”。

设备端通过 AT 指令,实现连接 liop 平台的主要步骤:

  1. 进入AT指令模式
  2. 关闭UART回显
  3. 设置ilop平台产品参数信息
  4. 设置ilop服务器站点地址:不设置,默认上海站
  5. 启动ilop服务
  6. 启动awss路由配网模式
  7. 配网成功后,收发数据

具体步骤实现,请参考表中指令:

序号 步骤 发送指令(或操作)
0 确认AT指令模式 AT
返回 OK
1 关闭串口回显功能 AT+UARTE=OFF\r
返回 OK
2 设置 ilop 产品信息 AT+ILOPSET=a1uJx2vJwDT,a1xLah5cMhK,rdZ5XpH8NSKKLVS1oGMGEXpcu5pZbSxD,xwlXjTpLqYVr6MxWycYd\r
返回 OK
3 设置 ilop 服务器站点位置-上海 AT+ILOPDOMAIN=0\r
返回 OK
4 启动 ilop 服务 AT+ILOPSTART\r
返回 OK
5 启动ilop aws路由器配网模式 AT+ILOPAWSSTART\r
返回 OK
6 打开公版APP, 扫描云端产品“人机交互页面”的配网二维码 开始为设备配网
返回 +WEVENT:STATION_UP,+ILOPEVENT=ILOP,CONNECTED
7 向ilop平台上报JSON数据,单个属性 AT+ILOPSENDJSON=property,17\r{"PauseSwitch":1}
返回 OK
8 向ilop平台上报JSON数据,多个属性 AT+ILOPSENDJSON=property,86\r{"PowerSwitch":0,"PauseSwitch":0,"LocalMassage":2,"GasbagPosition":4,"MassageSpeed":5}
返回 OK
9 向ilop平台上报JSON数据,单个事件 AT+ILOPSENDJSON=event,Error,15\r{"ErrorCode":0}
返回 OK
10 停止ilop服务 AT+ILOPSTOP\r
返回 OK

使用需知:

  1. 若设备意外掉电,上电重启后,可自动重连路由器和云服务,无需其它操作;
  2. 若需要“重新配网绑定”,建议:请先解绑,AT+ILOPRESET, AT+REBOOT,重启后,重复步骤4,5开始配网即可(请确保固件版本v2.3.0及以上)。
  3. 批量生产时,飞燕产品信息的三元组烧录,可向代理商提供固件版本号和三元组文件,让其代为烧录。

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

image.png

at 指令返回情况如下图:

image.png

APP端界面如下:

image.png

APP解绑界面请点击右上角 …(可在此界面 修改备注名称,更新固件版本等。)

ilop平台查看调试log

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

设备调试页面中,点击 “调试”,进入设备log查看页面,可看到设备上报数据信息,如图:

image.png

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

image.png

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

image.png

固件OTA

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

image.png

打开,进入设备运维,找到“固件升级”,如下图:

image.png

点击“新增固件”,打开界面如下图:

image.png

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

image.png

注意:待升级的版本号应与要升级的版本号不同,请正确填写首件验证的设备deviceName参数信息,然后“添加”,“推送” 即可开始升级过程。

image.png

其中:

若选择“APP提醒升级”,请在配网绑定成功后, 进入“智能家居APP端”——> “我的”—>“设置”—->”固件升级”中,手动启动升级过程。

image.png

注意:设备端固件升级过程时,请勿断开电源,否则升级失败,需重新启动。
具体的升级结果可在升级详情中查看。

若选择 “静默升级”,推送后,设备在线则立刻ota升级;设备不在线则待设备上线后即时更新。

image.png

升级结果,可点击 “验证固件”查看,如图:

image.png

或在 “升级详情”中查看:

image.png

当 “验证固件” 成功后,可进行”批量升级”操作。

image.png

image.png