产品模型(联通用户专用)
概述
产品模型(也称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不含编解码插件,如果设备上报采用的是二进制码流,请使用产品中心导入的方式。
- 手动创建:手动创建一个产品(支持CoAP/LWM2M、MQTT或LoRaWAN),不定义设备属性(不需要开发profile及编解码插件),仅透传数据,不解析数据(透传模式具体请参考数据上报(联通用户专用))。如使用手动创建的产品模型,建议仅开通设备接入服务即可。
- 登录物联网平台控制台,点击右上角“进入设备管理服务”。
- 单击左下角,选择“新增产品模型”。 ,单击
- 产品模型可通过从产品中心导入和从本地导入两种方式。
- 从产品中心导入:
- 选择“从产品中心导入”,进入到产品中心页面。
- 导入自有产品:产品中心默认显示自有产品列表,可通过产品名称或者设备类型搜索产品。
- 导入第三方公开产品:“产品范围”选择“第三方公开”,可通过产品名称、设备类型或者厂商名称搜索产品。
- 导入第三方私有产品:单击页面右上角“第三方私有产品”,在弹出的窗口中输入产品验证码,该验证码由设备厂商提供。
- 在搜索的产品模型列表中单击需要导入的产品名称。
- 选择“从产品中心导入”,进入到产品中心页面。
- 从本地导入:
- 选择“本地导入”进入到本地导入产品的页面。
- 在弹出的窗口中输入产品名称,并上传资源文件。
- 单击“确定”,等待导入完成。
- 从产品中心导入:
- 在“产品模型”页面查看导入结果。
- 导入失败:可在“失败原因”中查看导入失败的原因,用户可根据失败原因定位错误。
- 导入成功:可单击“详情”,查看产品模型详情。
- 用户可以在产品列表中删除不再使用的产品,单击“删除”即可。
单击“详情”,用户可查看产品模型详细信息,包括查看该产品模型具备的服务列表,产品维护能力配置,以及自定义topic。
关于自定义topic,每个产品模型最多可以自定义10个,只有MQTT协议接入的设备支持自定义,参数信息配置如下:
- 设备操作权限:
- 发布: 设备侧消息上报时,可按配置中自定义的topic进行消息上报;数据流转时,设备消息中会携带topic参数标识该消息从哪个topic上报。
- 订阅:设备侧消息下发时,可在消息内容中指定此消息下发使用哪个topic;消息发往设备时,可以根据指定的topic下发。
- 发布和订阅:同时具备发布和订阅的权限。
- topic名称:自定义即可。支持英文字母、数字、下划线,+和#(仅权限是订阅时支持),长度限制64。
- 描述:关于该topic的描述。
- 如果还未使用该产品模型注册设备,则可以删除该产品模型。
- 如果已使用该产品模型注册过设备,则无法删除该产品模型。
- 设备操作权限: