文档

创建产品

更新时间:
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

产品是设备的集合,通常是一组具有相同功能定义的设备集合。例如,产品指同一个型号的产品,设备就是该型号下的某个设备。使用物联网平台接入设备前,您需在物联网平台控制台创建产品。本文介绍创建产品的具体操作。

前提条件

操作步骤

  1. 登录物联网平台控制台

  2. 在控制台左上方,选择物联网平台所在地域。

  3. 实例概览页签的全部环境下,找到对应的实例,单击实例卡片。

  4. 在左侧导航栏,选择设备管理 > 产品,单击创建产品

  5. 您可单击新建产品页签或从设备中心新建产品页签,选择不同方式创建产品。

    重要

    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时,需提供入网凭证名称。

    若无凭证,请单击创建凭证,进入对应页面:

    • 公共实例下,在物联网络管理平台的网络管理 > 入网开通页面,添加专用凭证,并为凭证授权用户。具体操作,请参见入网开通

    • 企业版实例下,在该实例的Link WAN > 入网凭证页面,单击添加入网凭证,添加专用凭证。参数配置说明与物联网络管理平台相同。

    使用凭证创建的产品,将作为一个节点分组,自动同步到物联网络管理平台的节点分组列表中。

    数据格式

    设备上下行的数据格式。

    说明

    MQTT型实例下不显示该参数。

    • ICA标准数据格式(Alink JSON):是物联网平台为开发者提供的设备与云端的数据交换协议,采用JSON格式。

    • 透传/自定义:如果您希望使用自定义的串口数据格式,可以选择为透传/自定义。

      您需在控制台提交数据解析脚本,将上行的自定义格式的数据转换为Alink JSON格式;将下行的Alink JSON格式数据解析为设备自定义格式,设备才能与云端进行通信。

    说明

    使用LoRaWAN接入网关的产品仅支持透传/自定义。

    校验类型

    设备上报物模型数据时,物联网平台将按设置的数据校验方式,根据物模型定义进行数据校验。

    说明

    MQTT型实例下不显示该参数。

    若产品的数据格式透传/自定义,该产品下设备与物联网平台进行物模型数据通信时,物联网平台会先调用数据解析脚本,将上报的透传或自定义格式数据转换为Alink JSON格式,然后进行数据校验。

    • 弱校验仅校验设备上报数据中的identifier和dataType字段,不校验其他字段,流转全量数据。

      校验通过的数据展示在物联网平台控制台对应设备的设备详情物模型数据页签。校验不通过的数据则不展示。

      通过流转数据中的参数checkFailedData,可查看校验不通过的数据。更多信息,请参见数据格式

    • 免校验不校验设备上报数据,流转全量数据。对上报的数据不进行校验,流转全量数据。

      物模型数据使用说明如下:

      • 物模型属性上报:属性数据不展示在物联网平台控制台对应设备下设备详情页面的物模型数据 > 运行状态页签中。
      • 物模型服务调用:所有服务都使用异步调用方式。
      • 物模型事件上报:所有事件都使用信息类型。

    认证方式

    设备接入物联网平台的安全认证方式。产品创建成功后,认证方式不可变更。可选:

    说明

    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

执行结果

产品创建成功后,跳转到产品管理 > 创建产品页面。您可根据页面提示,进行后续的添加设备功能定义设备开发

后续操作

定义产品功能

  1. 产品页面的产品列表,单击产品对应操作列的查看

  2. 在产品详情页面,单击对应功能页签,定义相关功能。

    说明

    MQTT型实例下仅支持展示产品信息服务端订阅页签。

    产品信息

    • 查看产品信息。您可以单击产品信息右侧的编辑,在产品编辑信息对话框,修改产品名称产品描述

    • 查看产品标签。默认无标签,您可以添加标签标识产品。具体操作,请参见编辑产品标签

    image.png

    Topic类列表

    查看物联网平台系统预定义的基础通信Topic类、物模型通信Topic类和自定义Topic类。详细说明,请参见Topic类列表

    您也可以添加自定义Topic类。具体操作,请参见自定义Topic类

    image.png

    功能定义

    定义物模型属性、服务和事件,用于物模型通信。具体内容,请参见:

    消息解析

    产品数据格式为透传/自定义时,需提交数据解析脚本。具体内容,请参见:

    服务端订阅

    若需订阅产品下设备上报数据,要创建订阅。具体内容,请参见配置AMQP服务端订阅

    文件上传配置

    若需设备将文件上传至您自己的OSS空间存储,要完成Bucket授权和配置。具体内容,请参见上传文件配置

设备开发

根据界面提示进行设备注册功能接入连接验证设备量产,完成设备开发,接入物联网平台。详细信息,请参见设备端开发

设备注册

单个创建设备:如下图所示。

image.png

设备接入

物联网平台提供多种开发语言的Link SDK供您选择。具体内容,请参见设备接入概述

image.png

连接验证

查看并验证设备接入物联网平台的状态。设备在线后,您可以使用物联网平台的消息通信功能,进行设备消息的收发。具体内容,请参见:

image.png

设备量产

批量添加设备,然后进行烧录量产。具体内容,请参见:

image.png

(可选)发布产品

在对应产品详情页面中,单击右上角发布,发布产品。

发布前需确认:产品各项信息已设置完成、设备开发调试工作已完成、产品已具备上线发布条件。

产品发布后,产品状态变为已发布

重要

产品发布成功后,不支持修改和删除操作。

产品管理

其他操作

  • 撤销已发布的产品。在该产品详情页面中,单击右上角撤销发布,然后单击确定

  • 删除未发布的产品。返回产品页面,在产品列表找到目标产品,单击产品对应操作列的删除,然后单击确定

    警告
    • 删除产品后,与该产品相关的所有数据都会被清除。如果产品下设备已接入物联网平台使用,会导致物联网平台所有服务不可用、用户业务中断。请谨慎操作。

    • 删除产品前,必须先删除该产品下的全部设备,具体内容,请参见删除设备

  • 备份产品数据。返回产品页面,在产品列表上方,单击备份产品数据,跳转到数据服务 > 数据接入 > 产品列表页面,可选择目标产品开启数据备份。具体操作,请参见备份产品

    数据备份