物模型是边缘智能中用于描述设备及其功能的一种抽象模型。它定义了设备的属性、服务和事件，便于不同设备的统一接入和管理。本文介绍了如何在边缘智能控制台发布物模型。

前提条件

您已经创建了设备模板。相关操作，请参见创建设备模板。

操作步骤

1. 登录边缘智能控制台。

2. 在左侧导航栏顶部的 我的项目 区域，选择您的项目。

3. 在左侧导航栏，选择 设备管理 > 设备模板。

4. 在设备模板列表，找到您的设备模板，然后单击模板名称。

5. 单击 物模型定义 页签，然后单击 编辑。
   您将会进入 编辑物模型 页面。在该页面，您可以根据现场设备的特征来定义物模型，具体包含以下步骤：

   1. （可选）新建功能模块。
   2. 添加自定义功能。
   3. 发布物模型版本。

（可选）新建功能模块

编辑物模型 页面左侧展示了 模块列表。其中，默认模块（default） 是系统自动创建的。您可以在默认模块下添加自定义功能。如果需要定义不同类别的功能，您也可以新建一个模块，然后在对应模块下添加自定义功能。

1. 在模块列表上方，单击 新建模块。

2. 在 新建模块 对话框，参考下表说明，完成相关参数的配置，然后单击 确定。

   配置项	说明
   名称	为模块设置名称。输入要求如下： 允许使用以下字符：汉字、英文大小写字母、数字、下划线（_）。长度不超过 32 个字符。 开头和结尾不允许使用下划线（_），并且不允许使用连续的下划线（_）
   唯一标识	为模块设置一个标识符。该标识符在当前设备模板下必须唯一。输入要求如下： 允许使用以下字符：英文大小写字母、数字、下划线（_）。长度不超过 32 个字符。 开头和结尾不允许使用下划线（_），并且不允许使用连续的下划线（_）。
   描述	为模块添加描述信息。长度不超过 128 个字符。

   

添加自定义功能

通过添加自定义功能，您可以定义物模型的属性、服务和事件。

1. 在 编辑物模型 页面，从 模块列表 选择一个模块。

2. 单击 添加自定义功能。

3. 在 添加自定义功能 面板，参考下表说明，完成相关参数的设置。

   功能类型	配置项	说明
   属性	功能名称	为属性设置一个名称，例如：开关。 输入要求如下： 允许使用以下字符：汉字、英文大小写字母、数字、下划线（_）、连字符（-）。长度不超过 32 个字符。 开头和结尾不允许使用下划线（_）和连字符（-），并且不允许连续使用这两个字符。 功能名称在当前模块下必须是唯一的。
   	标识符	为属性设置一个标识符。 输入要求如下： 允许使用以下字符：英文大小写字母、数字、下划线（_）。长度不超过 32 个字符。 开头和结尾不允许使用下划线（_），并且不允许使用连续的下划线（_）。 标识符在当前模块下必须是唯一的。
   	读写类型	设置对属性进行读取和写入操作的权限。 只读：表示该属性只能被读取，不能被写入。只允许查询当前属性信息或状态。 读写： 表示该属性可以被读取和写入。允许查询当前属性状态并修改属性的值。
   	数据类型	选择某个数据类型后，与该数据类型相关的配置项将会出现，您可以设置对应取值。详情参见数据类型设置说明。
   	描述	可选。为功能添加描述信息。 允许使用任意字符。长度不超过 128 个字符。
   服务	功能名称	为服务设置一个名称。 输入要求如下： 允许使用以下字符：汉字、英文大小写字母、数字、下划线（_）、连字符（-）。长度不超过 32 个字符。 开头和结尾不允许使用下划线（_）和连字符（-），并且不允许连续使用这两个字符。 功能名称在当前模块下必须是唯一的。
   	标识符	为服务设置一个标识符。 输入要求如下： 允许使用以下字符：英文大小写字母、数字、下划线（_）。长度不超过 32 个字符。 开头和结尾不允许使用下划线（_），并且不允许使用连续的下划线（_）。 标识符在当前模块下必须是唯一的。
   	调用方式	服务为 同步 调用方式。 当设备调用服务时，边缘智能平台会等待设备回复；若设备在 10s 内没有回复，则调用超时。
   	输入参数	设置调用服务的请求参数。 单击 添加参数，然后在 添加参数 对话框设置 参数名称、标识符、数据类型等。关于数据类型的设置方法，请参见数据类型设置说明。
   	输出参数	设置调用服务的返回参数。 单击 添加参数，然后在 添加参数 对话框设置 参数名称、标识符、数据类型 等。关于数据类型的设置方法，请参见数据类型设置说明。
   	描述	可选。为功能添加描述信息。 允许使用任意字符。长度不超过 128 个字符。
   事件	功能名称	为事件设置一个名称。 输入要求如下： 允许使用以下字符：汉字、英文大小写字母、数字、下划线（_）、连字符（-）。长度不超过 32 个字符。 开头和结尾不允许使用下划线（_）和连字符（-），并且不允许连续使用这两个字符。 功能名称在当前模块下必须是唯一的。
   	标识符	为事件设置一个标识符。 输入要求如下： 允许使用以下字符：英文大小写字母、数字、下划线（_）。长度不超过 32 个字符。 开头和结尾不允许使用下划线（_），并且不允许使用连续的下划线（_）。 标识符在当前模块下必须是唯一的。
   	事件类型	定义设备运行过程中所产生的消息类型，您可以针对不同的事件类型进行业务逻辑处理和统计分析。 信息：指设备运行过程中上报的一般性通知。例如设备定时上报当前的温度和湿度数据、设备的启动或关闭等。 告警：指设备运行过程中上报的检测到的潜在问题或异常情况。例如温度传感器检测到温度接近预设的上限或下限、电池电量低于预警阈值等。 故障：指设备运行过程中上报的严重问题或异常情况。例如传感器失效、设备固件崩溃等。
   	输出参数	设置事件的返回参数。 单击 添加参数，然后在 添加参数 对话框设置 参数名称、标识符、数据类型 等。关于数据类型的设置方法，请参见数据类型设置说明。
   	描述	可选。为功能添加描述信息。长度不超过 128 个字符。

4. 配置完成，单击 确定。

数据类型设置说明

在添加自定义功能时，您可以参考以下说明来设置 数据类型：

• int：整型。
  根据需要，定义 取值范围 和 步长 。
• float：浮点型。
  根据需要，定义 取值范围 和 步长 。
• double：双精度浮点型。
  根据需要，定义 取值范围 和 步长 。
• enum：枚举型。
  根据需要，单击 添加枚举对，定义枚举对的 参数值 和 参数描述。例如：1表示加热模式、2表示制冷模式。
• bool：布尔型。
  采用 0 和 1 来定义布尔值。例如：0 表示关、1 表示开。

  说明

  0 和 1 的类型为字符串。

• text：文本型。
  需要定义字符串的 数据长度。
• struct：结构体类型。
  根据需要，单击 添加参数，配置 名称、标识符 和 数据类型，完成 JSON 结构体的定义。
• array：数组类型。
  需要设置数据内的 元素类型 和 最大元素个数。
  元素类型 支持 int（整型）、float（浮点型）、double（双精度浮点型）、text（文本型）和 struct（结构体类型）。

  说明

  元素类型 为 struct 时，需要配置 JSON对象 的 名称、标识符 和 数据类型。

• image：图像类型，用于储存具有图像信息的文件。通过 image 可以将传感器、摄像头或其他图像采集设备捕获的视觉信息转换成图片进行显示。

  说明

  目前只有服务的输出参数支持定义 image 类型。

发布物模型版本

要使物模型生效，您必须为当前物模型发布一个对应的版本。

1. 添加完自定义功能后，单击页面左下角的 保存。

2. 在 发布新版本 对话框，完成相关参数的设置，然后单击 确定。

   配置项	说明
   版本号	设置一个版本号。 版本号必须使用以下格式：x.x.x.x。其中，x 表示一个整数，取值范围为：0~9999。 版本号在一个物模型下必须是唯一的。您可以将版本号视为物模型的唯一 ID。
   描述	为物模型版本添加描述信息。长度不超过128个字符。

   

管理物模型

发布物模型后，您可以执行以下操作：

• 查看物模型配置：在 物模型定义 页签下，您可以查看当前版本对应的物模型配置信息。
• 编辑：单击 编辑，可以管理物模型模块或功能。

  说明

  编辑物模型后，必须为当前物模型发布一个新的版本，才能使其生效。

  • 模块管理
    • 新建模块：单击 新建模块，可以创建新的模块。
    • 修改模块名称：定位到指定模块，单击该模块的修改按钮，可以修改模块名称。
    • 删除模块：单击删除按钮，可以删除该模板。
  • 功能管理
    • 添加功能：单击 添加自定义功能，可以定义物模型的属性、服务和事件。
    • 编辑功能：单击自定义功能 操作 下的 编辑，可以修改该功能包含的属性、服务和事件。
    • 删除功能：单击功能 操作 下的 删除，可以删除该功能。

相关操作

物模型发布后，您在接入设备到节点时，便可以选择对应的设备模板。相关操作，请参见设备接入。