产品和设备在同一个项目内是共享的,在不同项目之间是隔离的。本文档介绍项目下的产品列表、产品创建、产品基本信息编辑、产品详情查看、删除产品等功能的使用方法。

背景信息

为了IoT Studio项目中的应用具有访问产品/设备的权限,需将物联网平台的设备管理中的产品关联到项目中,或直接在项目下创建产品和设备。在项目下创建的产品和设备,将直接显示在物联网平台的设备管理模块中。

查看项目产品列表

  1. 物联网平台控制台左侧导航栏,单击IoT Studio > 开发服务
  2. 在项目列表中,定位到目标项目,单击项目右侧操作栏的进入
  3. 在项目页面,单击左侧导航栏的设备管理 > 产品
    • 如果您尚未创建任何产品,将提示您首先创建产品。
    • 如果您已创建了产品或关联了物联网平台控制台设备管理中的产品,产品管理页将以列表形式显示产品信息,包括产品的名称、描述信息、创建时间和可操作功能项。
    产品列表

创建产品

  1. 设备管理 > 产品页面,单击新建产品
    新建产品
  2. 新建产品的对话框中配置产品信息(见下表)。
    配置产品
    参数 描述
    产品名称 为产品命名。产品名称在项目内具有唯一性。例如,可以填写为产品型号。支持中文、英文字母、数字、下划线(_)、连接号(-)、@符号和英文圆括号,长度限制4~30,一个中文汉字算2位。
    所属分类 选择产品分类。如该产品是一款电表,系统将为您自动推荐该电表的标准功能定义,您可以单击功能定义查看产品的标准功能定义。

    若列表中没有您所需的设备类型,您可选择自定义品类。完成产品创建后,在产品详情页对您的新类型设备进行功能描述,您将有机会成为该品类的标准定义者。

    节点类型
    • 产品下设备的类型:
      • 设备:直连物联网平台,且不能挂载子设备,也不能作为子设备挂载到网关下的设备。
      • 网关:可以挂载子设备的直连设备。网关具有子设备管理模块,可以维持子设备的拓扑关系,将与子设备的拓扑关系同步到云端。
    • 选择是否接入网关:默认选择即可,一般无需改动。
    连网与数据
    • 连网方式:直连设备和网关设备的连网方式。
      • WiFi
      • 蜂窝(2G/3G/4G)
      • 以太网
      • 其他
    • 数据格式:设备上下行的数据格式。
      • ICA标准数据格式(Alink JSON):是物联网平台为开发者提供的设备与云端的数据交换协议,采用JSON格式。
      • 透传/自定义:如果您希望使用自定义的串口数据格式,可以选择为透传/自定义。

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

    • 认证方式:设备接入物联网平台的安全认证方式。产品创建成功后,认证方式不可变更。
      • 设备密钥:使用物联网平台为设备生成的DeviceSecret进行设备认证签名计算。

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

      • ID²:ID²认证提供设备与物联网平台的双向身份认证能力,通过建立轻量化的安全链路(iTLS)来保障数据的安全性。
        说明
        • 仅华东2(上海)地域支持ID²认证方式。
        • 连网方式选择为LoRaWAN的产品不支持ID²认证方式。
        • 选择使用ID²认证,需购买ID²服务。请参见IoT设备身份认证(ID²)用户手册
      • X.509证书:使用X.509数字证书进行设备身份认证。
        说明
        • 仅华东2(上海)地域支持X.509证书。
        • 连网方式选择为LoRaWAN的产品不支持X.509证书。

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

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

    产品描述 可输入文字,用来描述产品信息。字数限制为100。
  3. 单击完成
    产品创建成功,单击产品右侧操作栏的查看,进入产品详情页面开始设备模型定义。

    定义各功能的具体参数,请参见单个添加物模型中定义属性、事件和服务的参数说明表。

    产品创建完成后,系统将自动颁发产品的唯一标识,ProductKey,您可以在产品的详情页面查看到该信息。

    有关产品创建的更多详细内容,请参见创建产品

关联产品至项目

如果您已经在物联网平台的设备管理模块中创建产品,单击关联物联网平台产品,将物联网平台中的产品导入项目,以方便项目中开发的应用访问产品。

  1. 设备管理 > 产品页面,单击关联物联网平台产品
  2. 关联产品对话框的产品列表中,勾选待关联的产品。
    说明 已经导入产品的会以灰色钩显示,不再可选。
    选择产品
    注意 产品库列表包含了物联网平台的所有产品;每个产品可关联多个项目;每个产品最多关联100个项目。
  3. (可选步骤)勾选关联产品同时关联其下所有设备
    说明 如果您不需要同时关联该产品下的所有设备,跳过此步骤。
  4. 单击确定
    您可在该项目的设备管理 > 产品页的产品列表中查看到关联的产品。关联的产品列表

查看产品详情

单击目标产品右侧操作栏的查看,查看该产品的详情。

产品的基本信息包括您在创建产品时填写的信息,及系统为该产品颁发的全局唯一标识(ProductKey)。产品详情页面提供产品的功能定义、服务端订阅、在线调试、日志服务等功能。

产品详情

编辑产品信息

在产品详情页面的产品信息页签单击编辑,可在弹窗中修改产品的基本信息:产品的名称和产品描述。

编辑

产品信息 > 标签信息模块,单击立即添加(未添加过标签)或右侧的编辑(已有标签)。在添加标签对话框设置标签信息。

添加标签
注意 编辑产品信息仅面向开发中的产品,如果该产品已发布,产品的所有信息将冻结,包括基本信息、功能(属性、服务、事件)、扩展信息。即产品已经进入正式生产或销售阶段,您将无法再做修改。

解除产品与项目的关联

单击目标产品右侧操作栏的解除关联,解除项目与该产品的关联。

说明 目前,项目内的产品解除与设备解除是独立关系,互不影响。
解除产品关联

删除产品

单击目标产品右侧操作栏的删除,直接删除物联网平台的产品数据。

注意
  • 删除前需要删除产品下所有设备,物联网平台上的数据也将删除。即如果删除了产品会导致物联网平台下的产品也被删除,而且已发布的应用会出现数据错误,请谨慎操作。
  • 产品删除后将不可再恢复,请谨慎操作。
删除产品

发布产品

  1. 在产品的详情页面,单击右上角发布
  2. 确认发布产品对话框中确认该产品的信息和各项功能已完成开发,并逐一单击确认相关步骤。
    发布
  3. 单击发布
    发布完成后,重新进入产品详情页面,状态会更新为已发布,单击撤销发布可以取消发布。发布完成

后续步骤

产品发布后,您将能够在项目页面的设备管理 > 设备页面中为该产品批量添加设备,并生成设备的激活凭证,进行产线烧录和量产。详细内容请参见设备