写在前面
本例提供通过 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/ , 阿里智能生活开放平台,如有支付宝账号,请直接登陆;若无支付宝账号,请免费注册并登录。
创建项目
登录后,直接跳转 “新建项目” 页面,如下:
项目建成后,可预览如图:
新建产品
点击 “项目名称-庆科智能”,进入项目后,新建产品,如下图:
可从列表中找到相应的产品,选择 并 确认,创建产品,如下图:
预览产品列表,如图,显示状态 “开发中”。
功能定义
点击 产品名称,进入功能定义界面如下图:
功能定义包括标准功能和自定义功能,如下图:
添加 ICA 联盟体提供的标准功能,可从列表中选择:
也可根据用户产品特殊需求,添加自定义功能,需经过1个工作日的平台工作人员审核。
设备调试
选择您所使用的上海庆科模组型号,注意:使用模组需已通过阿里认证,如下图:
选择好模组或芯片类型后,可在测试设备中点击 “新增测试设备”,如下图:
当不填时,由平台自动生成device key和device secret。
添加完成,将自动生成测试设备所需的三元组,如下图:
三元组生成,也即:“设备激活凭证”,请保存,待设备调试时,需连同 “Product Secret”一起,通过 AT 指令烧录至模组中,具体参见指令:AT+ILOPSET
,需要设置的参数依次为:Product Key
, Product Secret
, Device Secret
,Device Name
。
其中,Product Secret 的值在产品基本信息中,点击 “显示”即可。如图:
注意:当批量烧录模组时,不推荐使用 AT 指令烧录(效率低),需用庆科专门开发的 BAT 系统,与固件一同进行自动批量预烧录,当下购买订单时需指定固件版本号及提供三元组参数文件。
点击页面底部“下一步”,进入“人机交互”。
人机交互
“人机交互” 页面中选择 “公版APP”,点击 “公版APP” 下载。 注意:推荐使用 正式版 APP。 请扫码下载,并完成安装注册与登录。
进入“人机交互”页面,选择“使用公版APP控制”,获取公版APP 的配网二维码,并配置界面,如下图:
APP配置界面如下图,请务必保存后,测试。
需要填写部分必填的 APP 配置信息,才能正常测试使用。
批量投产
当产品调试,测试,APP发布后,可填写批量投产信息,购买激活码,进入批量投产阶段。
产品联动
请先下载格西烽火串口指令工程:at_alios_ilop_anan.bsp.zip
飞燕 AT 指令详细,请参考:“ilop AT 指令” 中的 “直连ilop阿里飞燕云平台指令”。
设备端通过 AT 指令,实现连接 liop 平台的主要步骤:
- 进入AT指令模式
- 关闭UART回显
- 设置ilop平台产品参数信息
- 设置ilop服务器站点地址:不设置,默认上海站
- 启动ilop服务
- 启动awss路由配网模式
- 配网成功后,收发数据
具体步骤实现,请参考表中指令:
序号 | 步骤 | 发送指令(或操作) |
---|---|---|
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 |
使用需知:
- 若设备意外掉电,上电重启后,可自动重连路由器和云服务,无需其它操作;
- 若需要“重新配网绑定”,建议:请先解绑,
AT+ILOPRESET
,AT+REBOOT
,重启后,重复步骤4,5开始配网即可(请确保固件版本v2.3.0及以上)。 - 批量生产时,飞燕产品信息的三元组烧录,可向代理商提供固件版本号和三元组文件,让其代为烧录。
所需的 at 指令列表如下图:
at 指令返回情况如下图:
APP端界面如下:
APP解绑界面请点击右上角 …(可在此界面 修改备注名称,更新固件版本等。)
ilop平台查看调试log
此时,可在ilop平台中在线调试设备。具体:
设备调试页面中,点击 “调试”,进入设备log查看页面,可看到设备上报数据信息,如图:
选择添加的测试设备,如图:
基于本例的设备状态信息如下图:
固件OTA
进入阿里飞燕云平台的 产品页面,找到 “运营中心”,如下图:
打开,进入设备运维,找到“固件升级”,如下图:
点击“新增固件”,打开界面如下图:
升级固件上传后,需进行首件确认,点击:“验证固件”。
注意:待升级的版本号应与要升级的版本号不同,请正确填写首件验证的设备deviceName参数信息,然后“添加”,“推送” 即可开始升级过程。
其中:
若选择“APP提醒升级”,请在配网绑定成功后, 进入“智能家居APP端”——> “我的”—>“设置”—->”固件升级”中,手动启动升级过程。
注意:设备端固件升级过程时,请勿断开电源,否则升级失败,需重新启动。
具体的升级结果可在升级详情中查看。
若选择 “静默升级”,推送后,设备在线则立刻ota升级;设备不在线则待设备上线后即时更新。
升级结果,可点击 “验证固件”查看,如图:
或在 “升级详情”中查看:
当 “验证固件” 成功后,可进行”批量升级”操作。