全部产品
Search
文档中心

阿里云物联网平台:创建产品

更新时间:Nov 15, 2023

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

前提条件

操作步骤

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

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

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

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

  5. 按照页面提示填写信息,然后单击确认

    参数

    描述

    产品名称

    为产品命名。产品名称在账号内具有唯一性。例如,可以填写为产品型号。支持中文、英文字母、日文、数字、下划线(_)、短划线(-)、at(@)和英文圆括号(()),长度限制4~30个字符,一个中文或日文占2个字符。

    节点类型

    产品下设备的类型。

    • 直连设备:直连物联网平台,且不能挂载子设备,但能作为子设备挂载到网关下的设备。

    • 网关子设备:不直接连接物联网平台,而是通过网关设备接入物联网平台的设备。网关与子设备说明,请参见网关与子设备

    • 网关设备:可以挂载子设备的直连设备。网关具有子设备管理模块,可以维持子设备的拓扑关系,将与子设备的拓扑关系同步到云端。

    接入网关协议

    节点类型选择为网关子设备的参数。表示该产品下的设备作为子设备与网关的通讯协议类型。

    • 自定义:表示子设备和网关之间是其它标准或私有协议。

    • Modbus:表示子设备和网关之间的通讯协议是Modbus。

    • OPC UA:表示子设备和网关之间的通讯协议是OPC UA。

    • ZigBee:表示子设备和网关之间的通讯协议是ZigBee。

    • BLE:表示子设备和网关之间的通讯协议是BLE。

    连网方式

    直连设备和网关设备的连网方式。

    • Wi-Fi

    • 蜂窝(2G/3G/4G/5G

    • 以太网

    • 其他

    数据格式

    设备上下行的数据格式。

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

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

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

    校验类型

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

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

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

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

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

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

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

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

    认证方式

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

    • 设备密钥:使用物联网平台为设备生成的DeviceSecret进行设备认证签名计算。

      使用DeviceSecret签名计算,请参见MQTT-TCP/TLS连接通信

    • ID²:ID²认证提供设备与物联网平台的双向身份认证能力,通过建立轻量化的安全链路(iTLS)来保障数据的安全性。

      重要
      • 目前,仅日本(东京)地域的企业版实例下,支持使用ID²证书认证。

      • 选择使用ID²认证,需购买ID²服务。

      • 连网方式选择为LoRaWAN的产品不支持ID²认证方式。

    产品描述

    可输入文字,用来描述产品信息。字数限制为100。

执行结果

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

后续操作

定义产品功能

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

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

    产品信息

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

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

    image.png

    Topic类列表

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

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

    image.png

    功能定义

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

    消息解析

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

    服务端订阅

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

设备开发

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

设备注册

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

image.png

设备接入

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

image.png

连接验证

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

image.png

设备量产

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

image.png

(可选)发布产品

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

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

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

重要

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

产品管理

其他操作

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

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

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

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

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

    数据备份