更新时间:2022-02-21 GMT+08:00

产品模型

功能介绍

产品模型(也称Profile)用于描述设备具备的能力和特性。开发者通过定义Profile,在IoT平台构建一款设备的抽象模型,使平台理解该款设备支持的服务、属性、命令等信息,如颜色、开关等。

Profile包括产品信息、服务能力、维护能力三部分,其中产品信息的五元组唯一定义一款设备。当定义完一款产品模型后,在进行设备注册时,就可以选择已导入的产品。

图1 Profile文件结构
用户导入产品模型有三种方式:
  • 产品中心导入。在开发中心上完成产品模型的定义并发布到产品中心。
    说明:

    在开发中心定义一款Profile过程中,如果“数据格式”选择的是“二进制码流”,则需要在线进行编解码插件开发才能完成产品发布。

  • 本地导入:指线下完成产品模型的开发,通过上传产品包的方式导入。
    说明:

    通过本地导入的产品模型不含编解码插件,如果设备上报采用的是二进制码流,则需要联系IoT平台运营管理员上传编解码插件。

  • 手工创建:手工创建一个产品,该产品不包含设备的Profile文件。该操作用于支持LWM2M标准协议接入的场景,IoT平台根据设备携带的ObjectID和ResourceID自动生成产品模型(Profile文件)。
    说明:

    需提前联系IoT平台管理员上传LWM2M标准协议定义的ObjectID文件。

前提条件

  • 产品中心导入方式:已完成产品模型定义并发布到产品中心。
  • 本地导入方式:已完成Profile文件制作,请提前获取。

操作步骤

  1. 选择产品模型,单击“新增产品模型”
  2. 产品模型可通过从产品中心导入和从本地导入两种方式。

    • 从产品中心导入:
      1. 选择“从产品中心导入”,进入到产品中心页面。
      2. 通过产品名称、设备类型或者厂商名称搜索产品,在搜索结果中单击需要导入的产品名称。
      3. 查看产品是否为公开产品。
        • 公开产品,单击“导入该产品”,即可启动从产品中心导入产品到平台。
        • 非公开产品,需要用户输入验证码校验(验证码请前往产品中心获取)。校验通过后,则可以查看产品详情和导入产品到平台。
    • 从本地导入:
      1. 选择“本地导入”进入到本地导入产品的页面。
      2. 在弹出的窗口中输入产品名称,并上传资源文件。
      3. 单击“确定”,等待导入完成。
      说明:

      产品ID和产品密钥用于设备注册,请单击“保存密钥至本地”,以保存产品密钥信息,密钥信息在产品模型详情里不可见,请妥善保管。

  3. “产品模型”页面查看导入结果。

    • 导入失败:可在“失败原因”中查看导入失败的原因,用户可根据失败原因定位错误。
    • 导入成功:可单击“详情”,查看产品模型详情。

      说明:

      用户可以在产品列表中删除不再使用的产品,单击“删除”即可,删除该产品后会导致该产品下的设备功能无法使用,在产品中心重新导入该产品后,该产品下的设备功能恢复正常。