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

阿里云Alink产品创建指南

写在前面

本文主要讲述: 企业用户如何在 “阿里智能生活开放平台” 中创建产品,配置APP,设备开发与调试,产品发布上架的全流程。其中的设备,使用了烧录有alink_AT_v2.0.x固件的庆科Wi-Fi模块,与阿里云进行直连通信。

目录

  1. 签约入住
  2. 创建产品
    1. 填写产品基本信息
    2. 选择产品功能
    3. 产品确认提交
  3. 产品配网说明
  4. 界面配置
  5. 设备开发与调试
    1. 准备工作
    2. 设备发AT指令配置产品和设备信息
    3. 配网与绑定及通信
    4. 在线调试
    5. 独立使用测试APP配网绑定通信
  6. 申请发布上架

签约入住

1.登录 阿里云IoT 网站,点击右上角“登录”,进入登录页面,使用已注册认证的支付宝个人账号登录,如下图。

登录阿里云iot

2.登录后 ,点击右上角,进入“智能生活开放平台控制台”界面,如下图:

进入控制平台

3.打开“帮助中心”,按照“签约流程”指示过程,完成企业用户认证。

签约流程

4.待7个工作日内,智能云审核成功后,使用企业账户重新登录 阿里云IoT,可看到左侧功能栏中出现如下图所示。

产品功能

创建产品

填写产品基本信息

1.点击左侧任务栏中“产品管理”–>“产品信息注册",进入填写产品基本信息,如下图:

创建产品

提示: 此页面内容一经提交,不可更改。

注意:

  • 1.产品唯一标识必须是 “SN”;
  • 2.协议解析模式推荐选“默认”,若为“透传”,需用户自己提供协议文件。
  • 3.请根据具体情况选择入网方式,这里AT固件应用于“Wi-Fi”,无线模组厂商为“庆科”,请根据具体模块型号自行选择。

确认后,点击“保存并下一步”,即可跳转“产品属性信息”页面。

选择产品功能

产品基本信息确认后,跳转至“产品属性信息”页面,如下图,点击“编辑功能”。

编辑功能

根据您的产品定义,选择产品的相应属性,如下图:

确认属性

若用户需添加自定义属性,可点击下图:

添加自定义

自定义属性有两种添加方式:

  1. 从已有属性模型中选择即可,如搜索:工作时间,便可选中。
  2. 用户自定义,根据功能属性,定义,如下图“自定义属性”所示。

自定义选择

完全自定义属性

注意:

自定义属性需由阿里官网审核通过,方可顺利使用,此时显示为:

自定义属性待审核

确认后,点击“保存并下一步”,即可跳转“产品确认提交”。

产品确认提交

可在 “产品确认提交” 页面查看:产品基本信息和产品属性信息,具体如下图:

产品确认页面

至此,产品创建完成,可至“产品管理列表”中,查看产品“详情”。

产品管理列表

产品详情页如下图。

产品详情

注意:

本页下方会自动生成产品文档&开发辅助,请厂商自行 “下载 TRD 文档”,内含的产品设备信息会在设备端发 AT 指令配置时使用,具体使用方法将在 设备发AT指令直连aliink 中介绍。

产品配网说明

进入产品管理列表,点击相应产品的“产品配网说明”进入。

产品配网说明

在图中页面输入相应的产品配网选项:

设置产品配网选项

界面配置

在产品管理列表中,点击相应产品的 “界面配置”,进入 APP 界面配置 页面。

APP界面配置

需要使用淘宝账号登录,如下图:

登录APP界面配置

APP基本信息

登录后,即跳转至“界面配置”页面,如下图。

APP基本信息

可在上图中修改主题颜色,编辑视觉组件,并点击右上角“预览界面”,可跳出:

APP基本信息

根据提示下载安装阿里智能App厂测包,并用认证的淘宝账户登录,切换至自主调试。

APP 测试模式请按下图进行配置。

APP配置信息 APP配置信息

并点击“扫码打开WebView”,可预览 app 界面效果。 (注意:如果您有自定义属性未审核通过,可能会出现属性自定义警告,待审核通过后即可消失。)

保存并下一步,即可进入“设备调试”阶段。

APP配置信息

设备开发与调试

准备工作

在“硬件开发”页面中,下载TRD文档,设备端需要的产品及设备配置参数如下图红色标出。

AT指令配置信息

在 TRD 中,具体参数为:

产品配置信息

首先,设备中模块需烧录 直连Alink的AT固件,具体下载地址:AT2.0固件下载地址

具体指令详细可参考:直连阿里云的AT指令说明 中的 #11与alink连接与通信的指令。

具体指令使用方法可参考:AT 指令 v2.0 连接 Alink (阿里云) - 使用指南

本例中给设备发AT指令的 “格西烽火”指令bsp工程下载:at_alink_airbox_demo.zip

设备发AT指令配置产品和设备信息

基于本例,通过格西烽火串口调试软件,进行指令发送的示范如下:

  1. 重启设备,发:AT+REBOOT\r, 待返回 OK

  2. 设置产品,发:AT+ALINKPRODUCT=MXCHIP_AIRBOX_001,MXCHIP_LIVING_AIRBOX_MXCHIP_AIRBOX_001,34AYUZZtS3RHohzRT2mO,lqed9hDI1WupsQsvA7B9C2jCFBrn3WuGJTCsC0r1,JSON\r, 待返回:OK

  3. 设置设备,发:AT+ALINKDEV=AIRBOX,LIVING,MxChip\r,待返回:OK

配网与绑定及通信

点击下一步,可跳转至 配网,绑定,通信 调试页面,如下图:

产品配网绑定

1.APP端: 根据上图中的APP配网步骤,进行操作,扫一扫后,出现下图配网界面, 输入路由器的ssid和key。(请确保手机已连接到该路由器。)

APP配网

2.设备端: 启动 Alink AWS 配网,发:AT+ALINKAWSSTART\r,待返回:OK

3.APP端: 点击 “搜索设备”,即开始配网,等待设备端返回:+WEVENT:STATION_UP

4.设备端:启动 Alink 服务,发:AT+ALINKSTART\r,待返回:+ALINKEVENT:ALINK,CONNECT。此时,APP端提示 “等待设备激活”,即:产品配网设置时的激活属性信息,

等待激活

5.此例中,设备端:发开关属性值: 1,进行激活。即发: AT+ALINKSEND=24\r,,待返回:>后,发送:{“Switch”:{“value”:“1”}}

注意:由于云端具有数据过滤作用,可交替发送值,0 和 1。即:

  • 发: AT+ALINKSEND=24\r,,待返回:>后,发送:{“Switch”:{“value”:“0”}}

  • 发: AT+ALINKSEND=24\r,,待返回:>后,发送:{“Switch”:{“value”:“1”}}

6.APP端:激活成功后,跳转设备控制界面,如下图。此时,可通过设备上报数据,或通过APP下发数据了。

设备控制页面

在线调试

1.查看设备日志

此时可通过绑定账号,选择该账号下绑定设备的uuid,查看设备上报的日志,如下图。

设备上报: 通过对产品的属性进行json字符串组包,发送AT指令数据如下:

  • 上报全部属性值:AT+ALINKSEND=240\r,待返回:> , 发:{“ErrorCode”:{“value”:“0”},“BatteryPercentage”:{“value”:“30”},“CurrentHumidity”:{“value”:“80”},“CurrentTemperature”:{“value”:“30”},“Play”:{“value”:“1”},“PM25”:{“value”:“30”},“CO2”:{“value”:“30”},“TVOC”:{“value”:“10”},“Switch”:{“value”:“0”}}

  • 上报单个属性值:AT+ALINKSEND=36\r,待返回:> , 发:{“BatteryPercentage”:{“value”:“80”}}

APP下发:

  • 点击开关按钮,打开。

打开开关

注意:此例的自定义数据属性暂未审核通过,若通过后,将不在提示出错信息。

通过查看设备实时日志即可查看设备上报信息:

设备全部数据 设备变更数据

2.在线设备调试工具

也可以通过 “在线设备调试工具”,在线下发数据到设备。

打开设备在线调试

这里提供两种下发方式:

  • 一种是可视化下发,如下图:

可视化下发

对应的设备端指令接收,如图:

可视化下发

  • 一种是自定义下发,如下图:

自定义下发

对应的设备端指令接收,如图:

自定义下发

至此,阿里alink产品创建,APP创建,及设备端调试整个流程已打通,但还仅为测试版本,不可对外发布,若要产品化,需申请发布上架。

独立使用测试APP配网绑定通信

通过上一小节内容,已经通过配合云端指引,和在线调试的方法, 帮助您打通了产品的设备端,云端与APP端的通路。

接下来可以通过阿里小智测试APP进行配网,绑定和通信全流程了。

准备工作

首先必须先在设备端解绑刚刚在线调试时的绑定关系,即: 设备端发指令: AT+ALINKUNBIND\r,待返回:OK 即可。此时APP端的设备列表中“空气盒子”将消失。

进入配网页面

打开阿里小智APP,登录后,点击右上角 + 号,找到下拉列表中“添加设备”,如下图:

添加设备

点击“分类查找”,如下图:

分类查找

通过上拉产品种类列表,找到相应的产品种类,“空气盒子”,如下图:

查找产品

进入空气盒子后,上拉找到您的产品,如本例:“庆科空气盒子1号”,如下图:

查找具体产品

点击产品进入,配网页面,输入您手机连接的正确的路由器名称和密码,如下图:

配网页面

开始配网,激活

此时,设备端向Wi-Fi模块发送配网AT指令,AT+ALINKAWSSTART\r,待返回:OK, APP端点击“搜索设备”,即开始配网。

配网页面

待设备返回 “+WEVENT:STATION_UP”,代表配网成功, 此时设备端发送启动alink服务指令:AT+ALINKSTART\r,待返回:+ALINKEVENT:ALINK,CONNECT

等待激活页面

此时APP提示等待设备发激活指令,设备端发:AT+ALINKSEND=24\r,待返回>,发数据:{“Switch”:{“value”:“1”}}即可。

激活成功

可自定义设备名称,点击开启设备即可进入控制页面,如下图,

app页面预览

数据通信

设备上报状态数据: 通过对产品的属性进行json字符串组包,发送AT指令数据如下:

  • 上报全部属性值:AT+ALINKSEND=240\r,待返回:> , 发:{“ErrorCode”:{“value”:“0”},“BatteryPercentage”:{“value”:“30”},“CurrentHumidity”:{“value”:“80”},“CurrentTemperature”:{“value”:“30”},“Play”:{“value”:“1”},“PM25”:{“value”:“30”},“CO2”:{“value”:“30”},“TVOC”:{“value”:“10”},“Switch”:{“value”:“0”}}

  • 上报单个属性值:AT+ALINKSEND=36\r,待返回:> , 发:{“BatteryPercentage”:{“value”:“80”}}

app页面预览状态数据

APP下发控制命令:

APP打开开关,设备端收到json字符串,如下图:

app下发开关命令

设备端返回状态:

下发数据

申请发布上架

返回产品管理列表,可以看到,产品信息中出现“申请发布上架”。

申请发布

具体的申请发布材料,请查看下图,根据实际情况填写。

申请材料

文本导读目录