本文介绍了在边缘一体机节点上接入物联网设备的方法。
设备接入流程
要在节点上接入一款物联网设备，必须先在节点上部署相应的设备驱动实例，然后基于设备驱动添加设备实例。详细说明参见下表。
步骤 | 步骤说明及相关准备工作 | 参考文档 |
|---|---|---|
您需要先准备好驱动模板，然后基于驱动模板向节点部署驱动实例。
| ||
您需要先准备好设备模板，然后基于设备模板向节点添加设备实例。
| 了解为设备准备设备模板、开发物模型和点表的方法。 |
前提条件
- 已将节点绑定到边缘智能项目。相关操作，请参见绑定节点。
- 已准备好可用的设备模板和设备点表。更多信息，请参见设备接入流程。
说明
只有当您在设备模板下发布了物模型版本，设备模板才会变可用；点表一旦创建即可用。
操作步骤
登录边缘智能控制台。
在左侧导航栏顶部的 我的项目 区域，选择您的项目。
在左侧导航栏，单击 节点管理。
在 节点管理 标签页，找到您的节点，单击节点名称。
在节点详情页面，单击 设备接入 页签。
在 设备接入 标签页，依次完成以下操作，以将您的设备接入到节点：
部署驱动实例
参照以下步骤，在节点详情中的 设备接入 标签页，向节点部署驱动实例：
- 根据节点上是否部署过驱动实例，执行相应操作：
- 如果节点上未部署过任何驱动实例，单击页面提示信息中的 立即部署。
- 如果节点上部署过驱动实例，请检查 驱动实例 列表是否包含设备所需驱动以及对应驱动的版本。
- 如果设备所需驱动包含在列表中（驱动实例状态 是 运行中），并且驱动 版本 为所需版本，您可跳过部署驱动实例步骤，直接添加设备实例。
说明
如果需要更换驱动版本，单击对应驱动实例后的编辑按钮，在 编辑驱动实例 对话框，从 版本 下拉列表选择所需的驱动版本。驱动版本切换完成后，驱动实例状态 会重新变为 运行中。
- 如果设备所需驱动未包含在列表中，单击 驱动实例 列表右上方的 新建驱动实例。
- 如果设备所需驱动包含在列表中（驱动实例状态 是 运行中），并且驱动 版本 为所需版本，您可跳过部署驱动实例步骤，直接添加设备实例。
- 如果节点上未部署过任何驱动实例，单击页面提示信息中的 立即部署。
- 在 新建驱动实例 对话框，选择要使用的驱动模板和对应版本，然后单击 确定。
说明
驱动 下拉列表包含当前项目下所有驱动模板的可用版本（涵盖官方驱动模板和自定义驱动模板）。
完成以上操作后，驱动实例部署请求将被提交给节点执行，且 驱动实例 列表会出现相应驱动。单击驱动名称，可查看驱动的 基本信息。此时，驱动实例状态 为 创建中。
驱动实例部署过程涉及到数据传输。根据现场网络环境不同，部署所需时间不同。请确保您的节点在线，并耐心等待部署完成。当驱动实例在节点上部署成功时，驱动实例状态 会变为 运行中。
说明
如果驱动实例在节点上部署失败，您可以查询驱动实例日志以排查故障。具体操作，请参见驱动日志查询。
添加设备实例
参照以下步骤，在节点详情的 设备接入 标签页，向节点添加设备实例：
- 在 驱动实例 列表选中设备所需驱动。
说明
只有当 驱动实例状态 是 运行中 时，您可以在节点上添加兼容相应驱动的设备实例。
- 在 基本信息 标签页，根据添加方式执行相应操作。
支持的添加方式包括：
完成以上操作后，您可以在 设备实例 列表查看新添加的设备实例。此时，设备实例的 状态 为 创建中。当设备实例的状态变为 运行中，表示设备实例添加成功。
配置说明
说明
设备配置分为通用配置项和驱动关联配置项。通用配置项与驱动选择无关，总是可见。驱动关联配置项仅当选择了特定的驱动和子协议时才会显示。
下表仅罗列了通用配置项，而与特定驱动相关的配置项并不包含在内。驱动关联配置项取决于驱动模板的子协议配置。您可以在驱动模板页面查看各驱动模板详情，并通过子协议配置了解对应的驱动关联配置项。
配置项 | 说明 |
|---|---|
名称（逐个添加设备） | 为设备实例设置一个名称。 |
标识符 | 为设备实例设置一个标识符。 |
设备模板 | 选择要使用的设备模板。 说明 您必须先创建设备模板，并在设备模板下发布物模型，然后才可以选择相应设备模板。 |
子协议名称（逐个添加设备） | 可选择的子协议取决于驱动模板的定义，并且每个子协议都包含特定的驱动关联配置项。 |
点表 | 选择设备点表。可选择的设备点表与设备模板和驱动都相关。 |
标签 | 为设备关联标签。一个设备最多能够关联 5 个标签。
|
描述 | 为设备添加描述。 |
相关操作
驱动日志查询
在 设备接入 页面可以查看驱动实例的运行日志。不同驱动实例打印的具体日志内容不同，但都主要包含以下信息：日志级别、时间戳、驱动实例名称、错误来源、错误详情和错误路径等。
参照以下步骤，在节点详情的 设备接入 标签页，查询驱动实例的日志：
- 从 驱动实例 列表，选择一个驱动实例。
- 单击 日志查询 页签，然后完成以下查询设置：
- 起始时间：选择日志的开始时间。
- 前序日志：选择是否查询前序日志。默认关闭。
在容器化环境，前序日志记录了容器创建和启动过程中的关键事件。这些事件可能涉及容器启动期间出现的错误、配置问题、资源不足等情况。例如，如果驱动程序异常终止，您可以通过前序日志来查看详细的错误信息。 - 自动更新：选择是否使日志实时更新并自动显示最新的日志记录。默认开启。
- 单击 查询。
系统将显示与您选择的条件匹配的驱动运行日志。