文档首页 > > 用户指南> 产品模型(联通用户专用)

产品模型(联通用户专用)

分享
更新时间:2020/08/13 GMT+08:00

非联通用户请查看设备接入服务

概述

产品模型(也称Profile)用于描述设备具备的能力和特性。开发者通过定义Profile,在物联网平台构建一款设备的抽象模型,使平台理解该款设备支持的服务、属性、命令等信息,如颜色、开关等。当定义完一款产品模型后,在进行设备注册时,就可以选择已在控制台上导入的产品模型。

Profile包括产品信息、服务能力、维护能力三部分:

  • 产品信息

    描述一款设备的基本信息,包括厂商ID、厂商名称、设备类型、型号、协议类型。其中厂商ID和型号唯一标识一款产品。

    例如:水表的厂商名称为“HZYB”,厂商ID为“TestUtf8ManuId”,设备类型为“WaterMeter”,型号为“NBIoTDevice”,协议类型为“CoAP”。

  • 服务能力

    描述设备具备的业务能力。将设备业务能力拆分成若干个服务后,再定义每个服务具备的属性、命令以及命令的参数。

    以水表为例,水表具有多种能力,如上报水流、告警、电量、连接等各种数据,并且能够接受服务器下发的各种命令。Profile文件在描述水表的能力时,可以将水表的能力划分五个服务,每个服务都需要定义各自的上报属性或命令。说明如下:

    服务名

    描述

    基础(WaterMeterBasic)

    用于定义水表上报的水流量、水温、水压等参数,如果需要命令控制或修改这些参数,还需要定义命令的参数。

    告警(WaterMeterAlarm)

    用于定义水表需要上报的各种告警场景的数据,必要的话需要定义命令。

    电池(Battery)

    定义水表的电压、电流强度等数据。

    传输规则(DeliverySchedule)

    定义水表的一些传输规则,必要的话需要定义命令。

    连接(Connectivity)

    定义水表连接参数。

    :具体定义几个服务是非常灵活的,如上面的例子可以将告警服务拆分成水压告警服务和流量告警服务,也可以将告警服务合入到水表基础服务中。

  • 维护能力

    描述设备具备的维护能力,包括固件升级、软件升级、配置更新。

关于Profile文件的规范、含义和样例等,可参考如何离线开发?

开发产品模型

Profile的开发手段有在线开发和离线开发两种,我们推荐使用开发中心在线开发。

  • 在线开发:即在开发中心上,通过界面操作进行开发Profile,开发完成后可以下载,并发布到产品中心。如何在线开发?
  • 离线开发:是指开发者通过了解Profile格式规范,在本地进行开发、打包。如何离线开发?

新增产品模型

Profile开发完成并测试验证后,可以将profile文件导入到控制台上使用,有三种导入方式:

  • 产品中心导入:在开发中心上完成profile的定义并发布到产品中心。
  • 本地导入:指线下完成profile的开发,通过上传profile包的方式导入。

    注:通过本地导入的profile不含编解码插件,如果设备上报采用的是二进制码流,请使用产品中心导入的方式。

  • 手动创建:手动创建一个产品(支持CoAP/LWM2M、MQTT或LoRaWAN),不定义设备属性(不需要开发profile及编解码插件),仅透传数据,不解析数据(透传模式具体请参考数据上报(联通用户专用))。如使用手动创建的产品模型,建议仅开通设备接入服务即可。
  • 当协议类型选择LoRaWAN时,无法注册为普通设备,仅能注册为LoRaServer的子设备。
  • 导入产品模型后,就无法对已导入产品模型的产品信息和服务能力进行修改,例如修改协议类型、新增一个服务等。可以通过设备配置更新设备影子对设备服务属性值进行修改,通过界面修改OM维护能力。
  1. 登录物联网平台控制台,点击右上角“进入设备管理服务”。
  2. 单击左下角,选择产品模型,单击“新增产品模型”
  3. 产品模型可通过从产品中心导入和从本地导入两种方式。

    • 从产品中心导入:
      1. 选择“从产品中心导入”,进入到产品中心页面。
        • 导入自有产品:产品中心默认显示自有产品列表,可通过产品名称或者设备类型搜索产品。
        • 导入第三方公开产品:“产品范围”选择“第三方公开”,可通过产品名称、设备类型或者厂商名称搜索产品。
        • 导入第三方私有产品:单击页面右上角“第三方私有产品”,在弹出的窗口中输入产品验证码,该验证码由设备厂商提供。
      2. 在搜索的产品模型列表中单击需要导入的产品名称。
    • 从本地导入:
      1. 选择“本地导入”进入到本地导入产品的页面。
      2. 在弹出的窗口中输入产品名称,并上传资源文件。
      3. 单击“确定”,等待导入完成。

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

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

  5. 用户可以在产品列表中删除不再使用的产品,单击“删除”即可。

    单击“详情”,用户可查看产品模型详细信息,包括查看该产品模型具备的服务列表,产品维护能力配置,以及自定义topic。

    关于自定义topic,每个产品模型最多可以自定义10个,只有MQTT协议接入的设备支持自定义,参数信息配置如下:

    • 设备操作权限:
      • 发布: 设备侧消息上报时,可按配置中自定义的topic进行消息上报;数据流转时,设备消息中会携带topic参数标识该消息从哪个topic上报。
      • 订阅:设备侧消息下发时,可在消息内容中指定此消息下发使用哪个topic;消息发往设备时,可以根据指定的topic下发。
      • 发布和订阅:同时具备发布和订阅的权限。
    • topic名称:自定义即可。支持英文字母、数字、下划线,+和#(仅权限是订阅时支持),长度限制64。
    • 描述:关于该topic的描述。
      • 如果还未使用该产品模型注册设备,则可以删除该产品模型。
      • 如果已使用该产品模型注册过设备,则无法删除该产品模型。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问