本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
产品是设备的集合,通常是一组具有相同功能定义的设备集合。例如,产品指同一个型号的产品,设备就是该型号下的某个设备。使用物联网平台接入设备前,您需在物联网平台控制台创建产品。本文介绍创建产品的具体操作。
前提条件
开通物联网平台服务。
说明免费开通后,您可先试用物联网平台服务,试用流程,请参见阿里云免费试用的物联网平台产品。物联网平台服务的计费标准,请参见计费概述。
若使用企业版实例,需先购买所需的实例。具体操作,请参见购买企业版实例。
实例的详细说明,请参见实例概述。
操作步骤
登录物联网平台控制台。
在控制台左上方,选择物联网平台所在地域。
在实例概览页签的全部环境下,找到对应的实例,单击实例卡片。
在左侧导航栏,选择 ,单击创建产品。
您可单击新建产品页签或从设备中心新建产品页签,选择不同方式创建产品。
重要MQTT型实例仅支持新建产品,不支持从设备中心新建产品。
新建产品
参数
描述
产品名称
为产品命名。产品名称在账号内具有唯一性。例如,可以填写为产品型号。支持中文、英文字母、日文、数字、下划线(_)、短划线(-)、at(@)和英文圆括号(()),长度限制4~30个字符,一个中文或日文占2个字符。
所属品类
相当于产品模板。
标准品类:物联网平台已为标准品类预定义了功能模板。
例如,
品类已预定义烟机电源开关、烟机工作状态、烟机风量档位等电表标准功能。选择该品类,创建的产品具有预定义的功能。您可以在该产品的产品详情页功能定义页签下,编辑、修改、新增功能。单击所属品类右侧帮助按钮,可了解标准品类更多信息,或申请新品类。
自定义品类:产品创建成功后,需根据实际需要,自定义物模型。
说明MQTT型实例下,此处配置仅用于标识产品所属品类。
选择标准品类不会关联预定义了物模型功能。
选择自定义品类,无需自定义物模型功能。
节点类型
产品下设备的类型。
直连设备:具有IP地址,可直接连接物联网平台,且不能挂载子设备,但可作为子设备挂载到网关下的设备。
网关子设备:不直接连接物联网平台,而是通过网关设备接入物联网平台的设备。网关与子设备说明,请参见网关与子设备。
网关设备:可以挂载子设备的直连设备。网关具有子设备管理模块,可以维持子设备的拓扑关系,将与子设备的拓扑关系同步到云端。
说明MQTT型实例下仅支持选择直连设备。
接入网关协议
节点类型选择为网关子设备的参数。表示该产品下的设备作为子设备与网关的通讯协议类型。
自定义:表示子设备和网关之间是其它标准或私有协议。
Modbus:表示子设备和网关之间的通讯协议是Modbus。
OPC UA:表示子设备和网关之间的通讯协议是OPC UA。
ZigBee:表示子设备和网关之间的通讯协议是ZigBee。
BLE:表示子设备和网关之间的通讯协议是BLE。
连网方式
直连设备和网关设备的连网方式。
Wi-Fi
蜂窝(2G/3G/4G/5G)
以太网
LoRaWAN
仅尊享型高可用版的企业版实例,支持该连网方式。MQTT型实例和新版和旧版公共实例不支持该连网方式。
说明首次选择LoRaWAN时,需要单击下方提示中的立即授权,前往RAM控制台授权IoT使用AliyunIOTAccessingLinkWANRole角色访问LinkWAN服务。
其他
入网凭证
当连网方式选择为LoRaWAN时,需提供入网凭证名称。
若无凭证,请单击创建凭证,进入对应页面:
公共实例下,在物联网络管理平台的入网开通。
页面,添加专用凭证,并为凭证授权用户。具体操作,请参见企业版实例下,在该实例的
页面,单击添加入网凭证,添加专用凭证。参数配置说明与物联网络管理平台相同。
使用凭证创建的产品,将作为一个节点分组,自动同步到物联网络管理平台的节点分组列表中。
数据格式
设备上下行的数据格式。
说明MQTT型实例下不显示该参数。
ICA标准数据格式(Alink JSON):是物联网平台为开发者提供的设备与云端的数据交换协议,采用JSON格式。
透传/自定义:如果您希望使用自定义的串口数据格式,可以选择为透传/自定义。
您需在控制台提交数据解析脚本,将上行的自定义格式的数据转换为Alink JSON格式;将下行的Alink JSON格式数据解析为设备自定义格式,设备才能与云端进行通信。
说明使用LoRaWAN接入网关的产品仅支持透传/自定义。
校验类型
设备上报物模型数据时,物联网平台将按设置的数据校验方式,根据物模型定义进行数据校验。
说明MQTT型实例下不显示该参数。
若产品的数据格式为透传/自定义,该产品下设备与物联网平台进行物模型数据通信时,物联网平台会先调用数据解析脚本,将上报的透传或自定义格式数据转换为Alink JSON格式,然后进行数据校验。
认证方式
设备接入物联网平台的安全认证方式。产品创建成功后,认证方式不可变更。可选:
说明MQTT型实例下不显示该参数。
设备密钥:使用物联网平台为设备生成的DeviceSecret进行设备认证签名计算。
使用DeviceSecret签名计算,请参见MQTT-TLS连接通信。
ID²:ID²认证提供设备与物联网平台的双向身份认证能力,通过建立轻量化的安全链路(iTLS)来保障数据的安全性。
重要目前,仅华东2(上海)地域的企业版实例和旧版公共实例下,支持使用ID²证书认证。
选择使用ID²认证,需购买ID²服务。请参见IoT设备身份认证(ID²)用户手册。
连网方式选择为LoRaWAN的产品不支持ID²认证方式。
产品描述
可输入文字,用来描述产品信息。字数限制为100。
从设备中心新建产品
通过AIoT设备中心中认证设备AliThingsCode快速创建对应产品。
说明从AIoT设备中心新建产品,需完成AIoT硬件合作伙伴入驻认证。
物联网平台已为从设备中心新建的产品预定义了功能模板。您可以在该产品的产品详情页功能定义页签下,编辑、修改、新增功能。
参数
描述
产品名称
为产品命名。产品名称在账号内具有唯一性。例如,可以填写为产品型号。支持中文、英文字母、日文、数字、下划线(_)、短划线(-)、at(@)和英文圆括号,长度限制4~30个字符,一个中文或日文占2个字符。
AliThingsCode
认证设备的AliThingsCode。
您可前往AIoT设备中心查找认证设备,获取该设备的AliThingsCode。
执行结果
产品创建成功后,跳转到
页面。您可根据页面提示,进行后续的添加设备、功能定义和设备开发。后续操作
定义产品功能
在产品页面的产品列表,单击产品对应操作列的查看。
在产品详情页面,单击对应功能页签,定义相关功能。
说明MQTT型实例下仅支持展示产品信息和服务端订阅页签。
产品信息
查看产品信息。您可以单击产品信息右侧的编辑,在产品编辑信息对话框,修改产品名称或产品描述。
查看产品标签。默认无标签,您可以添加标签标识产品。具体操作,请参见编辑产品标签。
Topic类列表
查看物联网平台系统预定义的基础通信Topic类、物模型通信Topic类和自定义Topic类。详细说明,请参见Topic类列表。
您也可以添加自定义Topic类。具体操作,请参见自定义Topic类。
功能定义
定义物模型属性、服务和事件,用于物模型通信。具体内容,请参见:
消息解析
产品数据格式为透传/自定义时,需提交数据解析脚本。具体内容,请参见:
服务端订阅
若需订阅产品下设备上报数据,要创建订阅。具体内容,请参见配置AMQP服务端订阅。
文件上传配置
若需设备将文件上传至您自己的OSS空间存储,要完成Bucket授权和配置。具体内容,请参见上传文件配置。
设备开发
根据界面提示进行设备注册、功能接入、连接验证、设备量产,完成设备开发,接入物联网平台。详细信息,请参见设备端开发。
设备注册
单个创建设备:如下图所示。
设备接入
物联网平台提供多种开发语言的Link SDK供您选择。具体内容,请参见设备接入概述。
连接验证
查看并验证设备接入物联网平台的状态。设备在线后,您可以使用物联网平台的消息通信功能,进行设备消息的收发。具体内容,请参见:
设备量产
批量添加设备,然后进行烧录量产。具体内容,请参见:
(可选)发布产品
在对应产品详情页面中,单击右上角发布,发布产品。
发布前需确认:产品各项信息已设置完成、设备开发调试工作已完成、产品已具备上线发布条件。
产品发布后,产品状态变为已发布。
产品发布成功后,不支持修改和删除操作。