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

前提条件

操作步骤

  1. 登录物联网平台控制台
  2. 实例概览页面,找到对应的实例,单击实例进入实例详情页面。
    重要 目前华东2(上海)、日本(东京)地域开通了企业版实例服务。其他地域,请跳过此步骤。
    实例概览
  3. 在左侧导航栏,选择设备管理 > 产品,单击创建产品
  4. 按照页面提示填写信息,然后单击确认
    参数 描述
    产品名称 为产品命名。产品名称在账号内具有唯一性。例如,可以填写为产品型号。支持中文、英文字母、日文、数字、下划线(_)、短划线(-)、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进行设备认证签名计算。详细说明,请参见MQTT-TCP连接通信

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

后续步骤

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

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

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

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

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

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

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

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

    未发布的产品支持删除。

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