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

前提条件

操作步骤

  1. 登录物联网平台控制台
  2. 实例概览页面,找到对应的实例,单击实例进入实例详情页面。
    重要 目前华东2(上海)、华北2(北京)、华南1(深圳)地域开通了企业版实例服务。其他地域,请跳过此步骤。
    实例概览
  3. 在左侧导航栏,选择设备管理 > 产品,单击创建产品
  4. 您可选择以下方式创建产品。
    重要 基础型实例仅支持直接创建产品,不支持从设备中心新建产品
    • 根据实际需求直接创建产品。

      新建产品页签,按照页面提示填写信息,然后单击确认

      参数 描述
      产品名称 为产品命名。产品名称在账号内具有唯一性。例如,可以填写为产品型号。支持中文、英文字母、日文、数字、下划线(_)、短划线(-)、at(@)和英文圆括号(()),长度限制4~30个字符,一个中文或日文占2个字符。
      所属品类 相当于产品模板。
      • 标准品类:物联网平台已为标准品类预定义了功能模板。

        例如,能源管理 > 电表品类已预定义用电量、电压、电流、总累积量等电表标准功能。选择该品类,创建的产品具有预定义的功能。您可以在该产品的产品详情功能定义页签下,编辑、修改、新增功能。

        单击所属品类右侧帮助按钮帮助,可了解标准品类更多信息,或申请新品类。

      • 自定义品类:产品创建成功后,需根据实际需要,自定义物模型
      说明 基础型实例下,此处配置仅用于标识产品所属品类。
      • 选择标准品类不会关联预定义了物模型功能。
      • 选择自定义品类,无需自定义物模型功能。
      节点类型

      产品下设备的类型。

      • 直连设备:具有IP地址,可直接连接物联网平台,且不能挂载子设备,但可作为子设备挂载到网关下的设备。
      • 网关子设备:不直接连接物联网平台,而是通过网关设备接入物联网平台的设备。网关与子设备说明,请参见网关与子设备
      • 网关设备:可以挂载子设备的直连设备。网关具有子设备管理模块,可以维持子设备的拓扑关系,将与子设备的拓扑关系同步到云端。
      说明 基础型实例下仅支持选择直连设备
      接入网关协议

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

      • 自定义:表示子设备和网关之间是其它标准或私有协议。
      • Modbus:表示子设备和网关之间的通讯协议是Modbus。
      • OPC UA:表示子设备和网关之间的通讯协议是OPC UA。
      • ZigBee:表示子设备和网关之间的通讯协议是ZigBee。
      • BLE:表示子设备和网关之间的通讯协议是BLE。
      连网方式 直连设备和网关设备的连网方式。
      • Wi-Fi
      • 蜂窝(2G/3G/4G/5G)
      • 以太网
      • LoRaWAN

        仅公共实例和开启了Link WAN的企业版实例,支持该连网方式。基础型实例不支持该连网方式。

        说明 首次选择LoRaWAN时,需要单击下方提示中的立即授权,前往RAM控制台授权IoT使用AliyunIOTAccessingLinkWANRole角色访问LinkWAN服务。
      • 其他
      入网凭证 连网方式选择为LoRaWAN时,需提供入网凭证名称。

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

      • 公共实例下,在物联网络管理平台的网络管理 > 入网开通页面,添加专用凭证,并为凭证授权用户。具体操作,请参见入网开通
      • 企业版实例下,在该实例的Link WAN > 入网凭证页面,单击添加入网凭证,添加专用凭证。参数配置说明与物联网络管理平台相同。

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

      数据格式 设备上下行的数据格式。
      说明 基础型实例下不显示该参数。
      • ICA标准数据格式(Alink JSON):是物联网平台为开发者提供的设备与云端的数据交换协议,采用JSON格式。
      • 透传/自定义:如果您希望使用自定义的串口数据格式,可以选择为透传/自定义。

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

      说明 使用LoRaWAN接入网关的产品仅支持透传/自定义。
      校验类型 设备上报物模型数据时,物联网平台将按设置的数据校验方式,根据物模型定义进行数据校验。
      说明 基础型实例下不显示该参数。

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

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

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

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

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

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

        • 物模型属性上报:属性数据不展示在物联网平台控制台对应设备下设备详情页面的物模型数据 > 运行状态页签中。
        • 物模型服务调用:所有服务都使用异步调用方式。
        • 物模型事件上报:所有事件都使用信息类型。
      认证方式 设备接入物联网平台的安全认证方式。产品创建成功后,认证方式不可变更。可选:
      说明 基础型实例下不显示该参数。
      • 设备密钥:使用物联网平台为设备生成的DeviceSecret进行设备认证签名计算。

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

      • ID²:ID²认证提供设备与物联网平台的双向身份认证能力,通过建立轻量化的安全链路(iTLS)来保障数据的安全性。
        重要
        • 目前,仅华东2(上海)地域的企业版实例和旧版公共实例,支持ID²证书认证。

          实例的详细说明,请参见查看实例终端节点

        • 选择使用ID²认证,需购买ID²服务。请参见IoT设备身份认证(ID²)用户手册
        • 对于企业版实例,请确保已启用ID²设备身份认证。若购买实例时未启用,可通过为实例升配启用该功能。
        • 连网方式选择为LoRaWAN的产品不支持ID²认证方式。
        • 设备身份认证方式设置后,不可更改。
      • X.509证书:使用X.509数字证书进行设备身份认证。
        重要
        • 仅MQTT协议直连的设备可使用X.509证书认证。
        • 目前仅华东2(上海)地域下旧版公共实例支持X.509证书认证。
        • 连网方式为LoRaWAN的产品不支持X.509证书认证。
        • 设备身份认证方式设置后,不可更改。

        在产品下创建设备后,物联网平台为设备生成唯一的X.509证书。您可以在设备的设备详情页,查看和下载该设备的X.509证书。

        使用X.509证书进行设备身份认证的设备端配置说明,请参见使用X.509证书认证

      产品描述 可输入文字,用来描述产品信息。字数限制为100。
    • 通过AIoT设备中心中认证设备的AliThingsCode快速创建对应产品。

      单击从设备中心新建产品页签,按照页面提示填写信息,然后单击确认

      说明
      • 从AIoT设备中心新建产品,需完成AIoT硬件合作伙伴入驻认证。您可单击阿里云IoT认证设备库 ,根据页面提示完成认证。
      • 物联网平台已为从设备中心新建的产品预定义了功能模板。您可以在该产品的产品详情功能定义页签下,编辑、修改、新增功能。
      参数 描述
      产品名称 为产品命名。产品名称在账号内具有唯一性。例如,可以填写为产品型号。支持中文、英文字母、日文、数字、下划线(_)、短划线(-)、at(@)和英文圆括号,长度限制4~30个字符,一个中文或日文占2个字符。
      AliThingsCode 认证设备的AliThingsCode

      您可前往AIoT设备中心查找认证设备,获取该设备的AliThingsCode

后续步骤

  1. 定义产品功能。
    1. 产品页面的产品列表,单击产品对应操作列的查看
    2. 在产品详情页面,单击对应功能页签,定义相关功能。
      说明 基础型实例下仅支持展示产品信息服务端订阅页签。
      功能页签 说明 相关文档
      产品信息 查看产品信息,编辑产品标签。 添加产品标签
      Topic类列表 查看物联网平台系统预定义的基础通信Topic类、物模型通信Topic类和自定义Topic类。您可添加自定义Topic类。
      功能定义 定义物模型属性、服务和事件,用于物模型通信。
      数据解析 产品数据格式为透传/自定义时,需提交数据解析脚本。
      服务端订阅 若需订阅产品下设备上报数据,要创建订阅。 配置AMQP服务端订阅
      文件上传配置 若需设备将文件上传至您自己的OSS空间存储,要完成Bucket授权和配置。 上传文件配置
  2. 开发设备。

    单击产品详情页面的设备开发页签,跟随界面提示进行设备创建、功能开发、证书烧录、连接验证,完成设备开发,接入物联网平台。详细信息,请参见设备接入指南

  3. 在该产品详情页面中,单击右上角发布,发布产品。

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

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

    重要 产品发布成功后,不支持修改和删除操作。
    产品管理
  4. (可选)在该产品详情页面中,单击右上角撤销发布,然后单击确定
    说明 已发布的产品可撤销发布。
  5. (可选)返回产品页面,在产品列表找到对应产品,可执行以下操作。
    操作 步骤
    编辑

    您可修改产品名称和产品描述。

    1. 单击产品对应操作列的查看
    2. 产品信息页签下,单击产品信息右侧的编辑
    3. 产品编辑信息对话框,修改产品名称产品描述
    4. 单击确认
    删除

    未发布的产品支持删除。

    警告 删除产品后,与该产品相关的所有数据都会被清除。如果产品下设备已接入物联网平台使用,会导致物联网平台所有服务不可用、用户业务中断。请谨慎操作。
    1. 删除产品前,必须先删除该产品下的全部设备,具体内容,请参见删除设备
    2. 单击产品对应操作列的删除
    3. 单击确认