全部产品
  • 首页 > 
  • 创建WiFi产品示例

创建WiFi产品示例

本文描述在生活物联网平台创建一款使用WiFi接入的产品的过程,让客户熟悉如何在生活物联网平台创建使用WiFi接入的产品

> 注:生活物联网平台的页面样式可能随着迭代发生变化,请以平台最新的页面显示为准。

登录生活物联网平台

访问生活物联网平台进行用户登录,将会出现如下所示的登录页面,提示输入用户名以及密码即可:

若用户没有阿里云账号,也可以免费注册一个阿里云账号。当用户登录通过之后,将会显示用户创建的项目,如下图所示:

注:

  • 上图中显示的“testGW”和“ysong_test”是测试账号创建的两个项目,客户登录后将会显示客户自己创建的项目;
  • 若客户还未创建项目,可以点击页面右边的“创建项目”按钮来创建一个新的项目

创建产品

选择已创建的某个项目之后,可以显示该项目中的产品列表,下面是选择“ysong_test”项目后的显示示例:

上图中左上角的方框中是项目的名称,让用户知道当前自己位于哪个项目中。

点击上图中的“创建新产品”按钮,可以创建新的产品

填写产品信息页面

点击“创建新产品”按钮之后,将会出现“新建产品”页面,本示例将创建一个具有以下配置的产品:

  • 产品名称:演示灯2
  • 所属分类:电工照明/灯
  • 节点类型:设备
  • 是否接入网关:否
  • 连网方式:WiFi
  • 数据格式:ICA格式

如下图所示:

重要配置项说明:

  • 所属分类

    用户可以选择产品的类型,阿里已经为常见的设备定义了物模型,厂商可以基于该物模型进行设备开发,避免每个功能都需要厂商自己进行定义。

  • 节点类型:

    指产品是一个独立的设备,还是一个网关,网关设备可以代理其它设备接入阿里云,本例中的产品使用WiFi接入生活阿里云IoT,无需通过网关,因此选择“设备”

  • 是否接入网关:

    因为WiFi设备可以获取IP地址并直接与物联网平台通信,因此选项选“否”

  • 连网方式

    指设备连接网络的类型,本例选择“WiFi”

  • 数据格式:

    可以选择“ICA”或者“透传”,使用ICA格式表示设备与物联网平台之间的交互是基于阿里云IoT定义的ICA格式进行的,建议选择“ICA”;而“透传”模式指设备与云之间的通信格式是用户自己定义的,那么用户需要在云端编写脚本完成私有格式与阿里云IoT的ICA格式的转换。

  • 使用ID2认证:

    指设备认证是否使用ID2认证,本例选择“否”。如果设备需要非常强的安全,可以选择ID2认证,使能ID2前并请先阅读ID2开发文档

    当产品信息都填写完毕之后,点击“完成”按钮创建该以太网产品。

功能定义

点击创建的产品,将会显示如下图所示的“功能定义”页面:

其中:

  • “标准功能”是阿里已经定义的功能。比如对于灯来说,定义了属性“LightSwitch”表示灯当前是打开还是关闭状态,该属性是一个“可读可写”属性,意味着用户还可以通过云端打开或者关闭这个灯
  • “自定义功能”指厂商的设备特有的功能,比如如果一个厂商的灯上还可以检测环境的温度,那么可以定义一个属性来表示环境温度

灯的“故障上报”事件默认只有一个枚举值0,表示设备“恢复正常”;本例中增加一个枚举值1,表示“灯的温度超过80度”,用于报警。 点击上图中事件“故障上报”右侧的“编辑”按钮,将会跳出如下所示的编辑窗口:

点击上图中“故障代码”右侧圈选的“编辑”按钮,将会打开如下所示的“编辑输出参数”页面:

从上图可以看见目前ErrorCode只有一个枚举值0,表示“恢复正常”,接下来点击“+添加枚举项”来增加一个枚举值1表示“灯泡温度超过80度”,如下图所示:

点击“确定”按钮完成ErrorCode中枚举值的添加,添加完成之后的页面如下所示:

设备调试设置

产品在开发过程中需要调试设备用于验证产品的功能是否运行正常,在此页面中可以创建调试设备,对于WiFi设备来说,还需要指定使用的模组或者芯片。

该页面内容如下:

在上面的页面中需要选择产品使用的模组或者芯片,本例中选择了乐鑫的ESP32,页面的内容变化为:


点击上图中的“新增测试设备”,跳出如下所示的页面:

厂商可以在DeviceName对应的输入框中输入设备的标识,也可以不输入让平台自动为测试设备生成DeviceName,本例中不输入DeviceName,直接点击“确认”按钮生成测试设备。如下图所示:

人机交互配置

点击“人机交互”,将会显示如下图所示的“人机交互”页面:

配置项说明

配置项 说明
使用公版APP控制产品 - 该选项使能,表示可以通过阿里云IoT提供的“云智能”手机APP对产品进行控制;
- 该选项失效,厂商需要自己开发手机APP对该产品进行控制
分享方式 - 抢占式:用户A绑定设备后,A成为管理员可以对设备进行控制;用户B再来绑定设备时允许该用户对设备进行绑定并成为管理员,用户A自动和该设备解绑,无法继续使用。
- 授权式:用户A绑定设备后,A成为管理员;用户B再来绑定时,无法绑定,APP提示:“该设备已被用户“18411123442”绑定,如果您也想绑定该设备,需要他/她解除绑定,或将设备分享给您”。
- 共享式:用户A绑定设备后,A成为管理员;用户B再来绑定时,绑定成功,成为子成员,用户A还是管理员,A和B都可以对设备进行控制。子成员数量无上限。
多语言管理 输入产品的厂商名称、产品名称、型号等信息
配网引导页面 对于如何启动WiFI配网的说明页面
设备告警 让厂商配置当某个属性出现某些数值、或者设备离线等情况发生时,是否通知用户
自动化和定时 选择智能场景、自动化、云端定时、本地定时和本地倒计时中可用的设备功能
天猫精灵控制 该选项配置是否允许天猫精灵对该产品进行控制

多语言管理

开发者点击“多语言管理”右侧的按钮“未设置”之后,可以输入产品的“品牌”、“产品名称”、“型号”,本例中将品牌设置为“产品演示”,将产品名称设置为“演示灯2”,将型号设置为“TL-300”,如下图所示:

配网引导

“配网”是指将WiFi热点的SSID/密码发送给WiFi设备的过程,“配网引导”是指如何提示和告知使用者如何启动WiFi设备的配网功能。

点击“配网引导”右边的按钮“未设置”,将会打开配网引导页面,如下图所示:

设备厂商可以在这里指定产品默认配置方式(优选方案)、备选配网方式(优选方案失败后的备选方案),并编辑如何启动设备配网的“引导页面”,在引导页面中需要详细的告诉使用者如何启动配网。

启动配网有几种场景:

  • 用户新购设备

    当用户新购买一个设备时,需要将WiFi热点的SSID/密码发送给这个设备,从而让设备可以连网。

  • 用户重新发起配网

    比如WiFi热点的SSID/密码发生了变化,需要重新将新热点的SSID/密码发送给设备。

设备厂商在设计如何启动WiFi配网时通用的做法有以下几种,可供厂商选择:

  • 设备无热点信息记录则进入配网

    当用户新购买一个设备时,如果让用户按键再进入配网对于使用者来说就显得有些多余,因此很多厂商在设计时发现设备上没有WiFi热点的记录时,就让设备进入配网;

  • 提供按键让用户触按该按键让设备进入配网

    当设备从一个地方换到另外一个地方时,WiFi热点的SSID/密码发生了变化,而此时WiFi设备仍然使用以前记录的SSID/密码去连接WiFi热点,这样设备将无法连接成功,此时就需要用户通过触按设备上的一个按键让设备重新进入配网。

    对于使用者来说,触按配网按键后希望知道设备是否进入配网状态,因此设备在进入配网状态时建议设备播放提示音、或者让某个LED灯进行闪烁来进行提示,设备厂商需要在配网引导页面里面详细描述如何启动配网、以及配网启动之后设备的表现。


    在飞燕的手机APP页面中会将配网引导中的图片、文案、按钮以及配网进入不正常时的原因进行显示,手机APP的UI布局如下:
    image.png

    设备商可以在“配网引导编辑页面”中添加如何启动设备配网的图片,以及配网启动之后设备表现描述,如下图所示:

配网引导页面对于如何让设备进行正确的配网至关重要,请设备厂商确保描述准确无误,以避免使用者不知道如何配网而导致设备无法连网。

批量投产

产品开发完成后,可以对产品进行“发布”,发布之后的产品不能对产品的功能进行修改,因此请确认产品开发完成之后再将产品进行发布。 “批量投产”的页面如下图所示:

厂商可以选中“发布产品”下的复选框,并点击“开发完成”。之后可以批量购买“激活码”,并将激活码烧写到设备中。