为产品定义物模型

更新时间:
复制 MD 格式

物联网平台支持为产品定义物模型,将实际产品抽象成由属性、服务、事件所组成的数据模型,便于物联网平台管理和数据交互。产品创建完成后,您可以为它定义物模型,产品下的设备将自动继承物模型内容。

前提条件

已完成产品创建。具体操作,请参见创建产品与设备

背景信息

本文介绍为路灯所属的产品,定义工作电流、主灯开关的物模型属性。定义完物模型,您可以接入更多路灯到该产品下,自动继承已定义的物模型。物模型相关介绍,请参见什么是物模型

操作步骤

  1. 登录物联网平台控制台

  2. 实例概览页签,单击公共实例

  3. 在左侧导航栏,选择设备管理 > 产品。在产品列表中,找到已创建的路灯产品,单击操作栏的查看

  4. 在产品详情页,单击功能定义页签,然后单击编辑草稿

  5. 编辑草稿页面的默认模块,单击添加自定义功能,进行物模型配置,然后单击确认

    按照如下参数设置路灯产品的主灯开关工作电流属性。

    • 主灯开关属性的配置:功能类型选择属性功能名称填写主灯开关标识符填写 LightSwitch数据类型选择 bool(0 表示关闭,1 表示开启),读写类型选择读写

    • 工作电流属性的配置:功能类型选择属性功能名称填写工作电流,标识符填写 LightCurrent,数据类型选择 float,取值范围设置为 0~9,步长设置为 0.1,单位选择安培 / A,读写类型选择只读,描述填写"电参数采用4个字节浮点型数据"。

  6. (可选)单击物模型TSL,在完整物模型页签下,可看到该产品的完整物模型JSON文件。

    JSON 文件中包含 schema、profile 及 properties 数组,例如属性 LightSwitch(主灯开关),数据类型为 bool,读写模式为 rw,属性值 0 表示关闭、1 表示开启。弹窗右下角可单击 导出模型文件 将物模型导出为本地文件。

  7. 发布物模型。

    重要

    物模型发布后,才会正式生效。

    1. 单击功能定义编辑草稿页面左下方的发布上线。控制台页面会弹出发布物模型上线?对话框。

    2. 单击添加发布备注,输入版本号和版本描述。

      参数

      说明

      版本号

      设置当前物模型版本号。后期可根据版本号管理物模型。

      版本号支持英文字母、数字和英文句号(.),长度限制1~16个字符。

      版本描述

      描述当前版本物模型。支持中文汉字、英文字母、日文、数字和特殊符号。长度限制为100个字符。一个中文汉字算一个字符;一个日文算一个字符。

    3. 如果存在已上线的版本,则需要进行比对,确认新版本的修改点。

      单击比对结果,在比对结果对话框中查看修改点。确认无误后,单击确认查阅,回到发布物模型上线对话框,自动选中“确认已查看当前版本与线上版本的比对结果”前的复选框。

      如果不需要比对,您可直接手动选中“确认已查看当前版本与线上版本的比对结果”前的复选框。

    4. 单击确定,完成物模型的发布。

后续步骤

建立设备与平台的连接