You need to enable JavaScript to run this app.
导航

设备接入

最近更新时间2024.05.09 20:25:10

首次发布时间2022.11.03 20:11:03

本文介绍了在一体机上接入物联网设备的方法。

设备接入流程

要在一体机上接入一款物联网设备,必须先在一体机上部署相应的设备驱动实例,然后基于设备驱动添加设备实例。详细说明参见下表。

步骤

步骤说明及相关准备工作

参考文档

  1. 部署驱动实例

您需要先准备好驱动模板,然后基于驱动模板向一体机部署驱动实例。
边缘智能支持的驱动模板包括:

  • 官方驱动模板:针对常见通信协议(如 Modbus、ONVIF 等),边缘智能提供了官方驱动模板。如果您的设备通信协议与官方驱动模板匹配,推荐您使用官方驱动模板,以减少开发工作。
  • 自定义驱动模板:如果您的设备通信协议与所有官方驱动模板都不匹配,您需要根据边缘智能设备管理模块的规范,为设备开发自定义驱动模板。
  1. 添加设备实例

您需要先准备好设备模板,然后基于设备模板向一体机添加设备实例。
在设备模板中,您需要开发的项目包括:

  • 设备物模型:定义了从设备抽象出的数据模型(支持构建属性、服务、事件三种类型的设备功能)。
  • 设备点表:描述了设备属性数据与设备驱动采集的数据之间的转换关系(如数据采集方式、采集时间间隔、上报逻辑等)。

了解为设备准备设备模板、开发物模型和点表的方法。

前提条件

  • 已将一体机绑定到边缘智能项目。相关操作,请参见绑定一体机
  • 已准备好可用的设备模板和设备点表。更多信息,请参见设备接入流程

    说明

    只有当您在设备模板下发布了物模型版本,设备模板才会变可用;点表一旦创建即可用。

操作步骤

  1. 登录边缘智能控制台

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

  3. 在左侧导航栏,单击 节点管理

  4. 节点管理 标签页,找到您的一体机,单击一体机名称。

  5. 在一体机详情页面,单击 设备接入 页签。

  6. 设备接入 标签页,依次完成以下操作,以将您的设备接入到一体机:

    1. 部署驱动实例
    2. 添加设备实例

部署驱动实例

参照以下步骤,在一体机详情中的 设备接入 标签页,向一体机部署驱动实例:

  1. 根据一体机上是否部署过驱动实例,执行相应操作:
    • 如果一体机上未部署过任何驱动实例,单击页面提示信息中的 立即部署
      图片
    • 如果一体机上部署过驱动实例,请检查 驱动实例 列表是否包含设备所需驱动。
      • 如果设备所需驱动包含在列表中(驱动实例状态运行中),您可跳过部署驱动实例步骤,直接添加设备实例
      • 如果设备所需驱动未包含在列表中,单击 驱动实例 列表右上方的 新建驱动实例
        图片
  2. 新建驱动实例 对话框,选择要使用的驱动模板和对应版本,然后单击 确定

    说明

    驱动 下拉列表包含当前项目下所有驱动模板的可用版本(涵盖官方驱动模板和自定义驱动模板)。

    图片

完成以上操作后,驱动实例部署请求将被提交给一体机执行,且 驱动实例 列表会出现相应驱动。单击驱动名称,可查看驱动的 基本信息。此时,驱动实例状态创建中
驱动实例部署过程涉及到数据传输。根据现场网络环境不同,部署所需时间不同。请确保您的一体机在线,并耐心等待部署完成。当驱动实例在一体机上部署成功时,驱动实例状态 会变为 运行中

说明

如果驱动实例在一体机上部署失败,您可以查询驱动实例日志以排查故障。具体操作,请参见驱动日志查询

图片

添加设备实例

参照以下步骤,在一体机详情的 设备接入 标签页,向一体机添加设备实例:

  1. 驱动实例 列表选中设备所需驱动。

    说明

    只有当 驱动实例状态运行中 时,您可以在一体机上添加兼容相应驱动的设备实例。

  2. 基本信息 标签页,根据添加方式执行相应操作。
    支持的添加方式包括:
    • 逐个添加设备:一次添加一个设备实例。
      1. 单击 添加设备
      2. 添加设备 面板,按照配置说明进行配置,然后单击 确定
        图片
    • 批量添加设备:一次添加一个或多个设备实例。(待添加的设备实例使用相同的 子协议类型设备模板点表。)
      1. 单击 批量添加
      2. 批量添加设备 页面,按照配置说明进行配置,然后单击 确认
        批量添加设备 页面允许您同时添加最多 100 个设备实例,以及同步设置部分设备参数。
      • 添加设备:设置要添加设备的个数,然后单击 添加设备
      • 批量设置设备参数:先勾选 批量编辑参数,然后修改某个参数值,会使所有设备的对应参数值同步被修改。批量编辑参数 被勾选时,如果参数置灰,表示该参数不支持批量设置。
        图片

完成以上操作后,您可以在 设备实例 列表查看新添加的设备实例。此时,设备实例的 状态创建中。当设备实例的状态变为 运行中,表示设备实例添加成功。

配置说明

说明

设备配置分为通用配置项和驱动关联配置项。通用配置项与驱动选择无关,总是可见。驱动关联配置项仅当选择了特定的驱动和子协议时才会显示。
下表仅罗列了通用配置项,而与特定驱动相关的配置项并不包含在内。驱动关联配置项取决于驱动模板的子协议配置。您可以在驱动模板页面查看各驱动模板详情,并通过子协议配置了解对应的驱动关联配置项。

配置项

说明

名称(逐个添加设备)
设备名称(批量添加设备)

为设备实例设置一个名称。
只能使用以下字符:汉字、英文大小写字母、数字、下划线(_)、连字符(-)。长度不超过 32 个字符。特殊字符不能用在开头和结尾,也不能连续使用。

标识符

为设备实例设置一个标识符。
只能使用以下字符:英文大小写字母、数字、下划线(_)、连字符(-)。长度不超过 24 个字符。特殊字符不能用在开头和结尾,也不能连续使用。

设备模板

选择要使用的设备模板。

说明

您必须先创建设备模板,并在设备模板下发布物模型,然后才可以选择相应设备模板。

子协议名称(逐个添加设备)
子协议类型(批量添加设备)

可选择的子协议取决于驱动模板的定义,并且每个子协议都包含特定的驱动关联配置项。
子协议设置后,与该子协议相关的驱动关联配置项才会显示。

点表

选择设备点表。可选择的设备点表与设备模板和驱动都相关。
若无可用点表,您需要先在设备模板下创建针对特定驱动模板的点表。您可以单击 创建点表,以便在当前选择的设备模板下创建点表。具体操作,请参见创建点表

标签

为设备关联标签。一个设备最多能够关联 5 个标签。

  • 关联已有标签:从下拉列表选择当前项目下已有的标签。
  • 关联新标签:输入 key 和 value ,然后单击 创建标签,以添加新的标签。

描述

为设备添加描述。

相关操作

驱动日志查询

设备接入 页面可以查看驱动实例的运行日志。不同驱动实例打印的具体日志内容不同,但都主要包含以下信息:日志级别、时间戳、驱动实例名称、错误来源、错误详情和错误路径等。
参照以下步骤,在一体机详情的 设备接入 标签页,查询驱动实例的日志:

  1. 驱动实例 列表,选择一个驱动实例。
  2. 单击 日志查询 页签,然后完成以下查询设置:
    • 起始时间:选择日志的开始时间。
    • 前序日志:选择是否查询前序日志。默认关闭。
      在容器化环境,前序日志记录了容器创建和启动过程中的关键事件。这些事件可能涉及容器启动期间出现的错误、配置问题、资源不足等情况。例如,如果驱动程序异常终止,您可以通过前序日志来查看详细的错误信息。
    • 自动更新:选择是否使日志实时更新并自动显示最新的日志记录。默认开启。
  3. 单击 查询。
    系统将显示与您选择的条件匹配的驱动运行日志。